Efficiently support --det=git

.github/actions/setup-env/action.yml

@@ -37,3 +37,19 @@ runs:
         key:
           ${{ runner.os }}-${{ inputs.rust_cache_key }}-${{
           hashFiles('**/Cargo.lock') }}
+
+    - name: Enable Corepack
+      shell: bash
+      run: corepack enable pnpm
+
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        cache: pnpm
+        node-version-file: .nvmrc
+      env:
+        COREPACK_INTEGRITY_KEYS: '{"npm":[{"expires":"2025-01-29T00:00:00.000Z","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","keytype":"ecdsa-sha2-nistp256","scheme":"ecdsa-sha2-nistp256","key":"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE1Olb3zMAFFxXKHiIkQO5cJ3Yhl5i6UPp+IhuteBJbuHcA5UogKo0EWtlWwW6KSaKoTNEYL7JlCQiVnkhBktUgg=="},{"expires":null,"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","keytype":"ecdsa-sha2-nistp256","scheme":"ecdsa-sha2-nistp256","key":"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEY6Ya7W++7aUPzvMTrezH6Ycx3c+HOKYCcNGybJZSCJq/fd7Qa8uuAKtdIkUQtQiEKERhAmE5lMMJhP8OkDOa2g=="}]}'
+
+    - name: Install Node.js dependencies
+      shell: bash
+      run: pnpm install

.github/workflows/ci.yml

@@ -41,6 +41,7 @@ jobs:
   unit:
     name: Run unit test
     strategy:
+      fail-fast: false
       matrix:
         os:
           - ubuntu-latest
@@ -64,6 +65,7 @@ jobs:
       - lint
       - unit
     strategy:
+      fail-fast: false
       matrix:
         build:
           - linux
@@ -134,22 +136,11 @@ jobs:
           python-version-file: examples/pyproject.toml
           cache-dependency-path: examples/pdm.lock
 
-      - name: Enable Corepack
-        run: corepack enable pnpm
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          cache: pnpm
-          node-version-file: docs/package.json
-          cache-dependency-path: docs/pnpm-lock.yaml
-
-      - name: Install all dependencies
-        run: just install
-
       - name: Generate examples
         working-directory: examples/
-        run: just all
+        run: |
+          just install
+          just all
 
       - name: Build docs
         working-directory: docs/

.gitignore

@@ -2,8 +2,12 @@
 .vscode
 .idea
 
+# Node.js modules
+node_modules
+
 # Build artifacts
 target
+bin
 
 # Profiling artifacts
 flamegraph.svg
@@ -12,3 +16,12 @@ report.html
 
 # pre-commit executable
 pre-commit.pyz
+ignored_file
+test_mixed/ignored.txt
+test_ignored/
+
+# Test scenarios
+test_scenarios/fully_ignored/
+test_scenarios/partially_ignored/ignored.txt
+test_scenarios/nested_ignored/sub1/
+*.log

.nvmrc

@@ -0,0 +1 @@
+22

.pre-commit-config.yaml

@@ -75,25 +75,33 @@ repos:
   # Python
   # ======
 
-  # Runs before Black because fixed code might need to be formatted.
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.9.1
     hooks:
-      # Replaces flake8, isort and pyupgrade
-      - id: ruff
+      - id: ruff # replaces Flake8, isort, pydocstyle, pyupgrade
         args:
           - --fix
           - --exit-non-zero-on-fix
-
-  - repo: https://github.com/psf/black
-    rev: 24.10.0
-    hooks:
-      - id: black
+      - id: ruff-format # replaces Black
 
   # JavaScript
   # ==========
 
-  - repo: https://github.com/pre-commit/mirrors-prettier
-    rev: v4.0.0-alpha.8
+  - repo: local
     hooks:
       - id: prettier
+        name: prettier
+        "types": [text]
+        language: system
+        pass_filenames: true
+        # Set log-level to error to prevent prettier printing every single file it checks
+        # when running pre-commit with --all-files
+        entry: pnpm exec prettier --write --ignore-unknown --log-level error
+
+      - id: eslint
+        name: eslint
+        files: (frontend|automations|packages/js).*?\.(js|ts|mjs|vue|json5?)$
+        "types": [file] # ESLint only accepts [javascript] by default.
+        language: system
+        pass_filenames: false
+        entry: pnpm exec eslint --max-warnings=0 --no-warn-ignored --fix

.prettierignore

@@ -1,2 +1,5 @@
-# pnpm lockfile
+# Autogenerated
+.astro
+
+# Lockfiles
 pnpm-lock.yaml

CLAUDE.md

@@ -0,0 +1,63 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+`pls` is a prettier and powerful `ls(1)` replacement written in Rust. It's designed to be a modern, fast, and feature-rich directory listing tool with extensive customization options.
+
+## Architecture
+
+The codebase is organized into several key modules:
+
+- **Core**: `src/main.rs` contains the application entry point with a global `PLS` instance
+- **Models**: `src/models/` contains core data structures including `Pls` (main application state), `Node` (file system entries), and `Window` (terminal info)
+- **Configuration**: `src/config/` handles YAML configuration files and command-line argument parsing
+- **Arguments**: `src/args/` manages command-line input processing and grouping
+- **Output**: `src/output/` handles different display formats (grid, table, etc.)
+- **Formatting**: `src/fmt/` provides text rendering and markup processing
+- **Graphics**: `src/gfx/` handles terminal graphics protocol support (Kitty, SVG)
+- **Enums**: `src/enums/` contains various enumeration types for appearance, sorting, etc.
+- **Traits**: `src/traits/` defines common behaviors across different components
+- **Utils**: `src/utils/` provides utility functions for paths, URLs, and vectors
+
+## Development Commands
+
+### Rust (Core Application)
+- **Build**: `cargo build`
+- **Run**: `cargo run -- [args]` or `just run [args]`
+- **Test**: `cargo test` or `just test`
+- **Debug**: `RUST_LOG=debug cargo run -- [args]` or `just debug [args]`
+- **Release**: `cargo build --release` or `just release`
+
+### Frontend/Documentation (JavaScript/TypeScript)
+- **Lint**: `pnpm lint` (ESLint)
+- **Format**: `pnpm format` (Prettier)
+- **Check formatting**: `pnpm format:check`
+- **All checks**: `pnpm checks` (lint + format check)
+- **Fix linting**: `pnpm lint:fix`
+
+### Project Management
+- **Install dependencies**: `just install` (installs for all sub-projects)
+- **Pre-commit setup**: `just pre-commit` (installs Git hooks)
+- **Lint all**: `just lint` (runs pre-commit on all files)
+
+## Key Configuration
+
+The application uses:
+- **Configuration files**: `.pls.yml` files for customization (handled by `ConfMan`)
+- **Command-line args**: Parsed via `clap` crate
+- **Environment**: `RUST_LOG` for debug logging
+- **Package manager**: `pnpm` for JavaScript dependencies
+
+## Multi-Language Setup
+
+This is a polyglot project with:
+- **Rust**: Main application (`src/`, `Cargo.toml`)
+- **JavaScript/TypeScript**: Documentation site (`docs/`, Astro-based)
+- **Python**: Examples and utilities (`examples/`, PDM-managed)
+- **Just**: Task runner (`justfile` for automation)
+
+## Terminal Graphics
+
+The application detects and supports Kitty's terminal graphics protocol for enhanced visual output. This is handled in `src/gfx/` with runtime detection.