@codefast/cli 0.11.0 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,56 @@
 # @codefast/cli
 
+## 0.12.0
+
+### Minor Changes
+
+- [#892](https://github.com/codefastlabs/codefast/pull/892) [`4c97c5b`](https://github.com/codefastlabs/codefast/commit/4c97c5b8c2314f25ee9df7eac5a4b5dd723d6d90) Thanks [@thevuong](https://github.com/thevuong)! - Add `codefast audit publish`, a static publish-surface check. It flags `#/`-prefixed internal import specifiers — valid
+  to the in-repo runners but rejected by Node's ESM resolver on the supported floor, so they break the published package —
+  and any `exports`/`imports` target the slimmed publish manifest would not ship. It joins the `audit` family and gates
+  CI, replacing an external `publint` step.
+
+### Patch Changes
+
+- [#885](https://github.com/codefastlabs/codefast/pull/885) [`8580a2b`](https://github.com/codefastlabs/codefast/commit/8580a2b2dd9f502d7c330e5a2f0a3942041633b6) Thanks [@thevuong](https://github.com/thevuong)! - Match GitHub's heading-slug algorithm in `audit links`, so a cross-reference that resolves on GitHub resolves in the
+  audit.
+
+  Heading anchors are now slugged the way GitHub does: each space becomes its own hyphen with runs left intact,
+  underscores are kept as slug characters, and repeated headings gain `-1`, `-2`, … suffixes in heading order. The
+  previous slugger collapsed whitespace, dropped underscores, and offered only the base slug for duplicates, so a link a
+  browser lands on could be reported as dangling — the `@remarks` already claimed GitHub parity the code did not deliver.
+
+- [#892](https://github.com/codefastlabs/codefast/pull/892) [`4c97c5b`](https://github.com/codefastlabs/codefast/commit/4c97c5b8c2314f25ee9df7eac5a4b5dd723d6d90) Thanks [@thevuong](https://github.com/thevuong)! - Lower the monorepo's Node floor from 24 to 22.12, so the packages install and run on the active Node 22 LTS line.
+
+  `engines.node` becomes `>=22.12.0` across every package — the floor the shared toolchain (oxlint, Vite, Vitest, TanStack
+  Start) already requires. Development stays on the latest Node (`.node-version`) for speed, and a CI matrix exercises the
+  floor and the active LTS directly, so the floor is a contract CI proves rather than one everyone has to run.
+  `@types/node` is pinned to the floor's major (`^22`), with a workspace override holding the whole tree there so a dev
+  tool's `@types/node: "*"` peer can no longer pull a newer major and mask an API the floor lacks. The floor stays
+  mechanical, not advisory: `@codefast/di` keeps its own `Map` upsert helpers rather than the ES2025
+  `Map.prototype.getOrInsert` (which would raise the floor to 26) and its `lib` stays `ES2024`. `@codefast/cli`'s mirror
+  step now calls the `node:path` functions directly instead of aliasing them, which the floor's types correctly flag as
+  unbound methods.
+
+  The shared `@codefast/typescript-config` presets pin `lib` and `target` to `ES2024` (was `ESNext`) so the compiler's
+  ECMAScript surface matches the Node floor: an ES2025 builtin such as `Map.prototype.getOrInsert` now fails to type-check
+  rather than compiling and crashing on Node 22.12. `@codefast/di` and `@codefast/di-testing` already pinned `lib` and are
+  unchanged.
+
+  Internal subpath imports move from a `#/` prefix to a bare `#` (`#core/token`, not `#/core/token`), and the
+  `package.json#imports` keys become `#*`/`#tests/*`/`#examples/*` to match. Node's native ESM resolver rejects a
+  `#/`-prefixed specifier with `ERR_INVALID_MODULE_SPECIFIER` on the whole Node 22 line (and on Node 24 before 24.14), and
+  each package ships those specifiers verbatim inside its published `dist/*.js` for a consumer's Node to resolve — so this
+  rename is what actually lets the packages import on the new floor. Purely internal: a consumer's own import paths are
+  unchanged.
+
+- [#892](https://github.com/codefastlabs/codefast/pull/892) [`4c97c5b`](https://github.com/codefastlabs/codefast/commit/4c97c5b8c2314f25ee9df7eac5a4b5dd723d6d90) Thanks [@thevuong](https://github.com/thevuong)! - Fix `pack-slim` stripping the stylesheet source of packages that export CSS.
+
+  `codefast pack-slim` removed the whole `src` directory from a package's published `files`, but `@codefast/ui` and
+  `@codefast/tracking` ship Tailwind source through `./css/*` → `./src/css/*`, so their published tarballs went out with
+  no CSS at all and the `./css/*` export resolved to nothing. pack-slim now keeps the `src` subtrees a surviving
+  `exports`/`imports` target still points into (e.g. `src/css`) and drops the rest of `src`, so the stylesheets ship while
+  the TypeScript source stays out. Surfaced and now guarded by the new `codefast audit publish` check.
+
 ## 0.11.0
 
 ### Minor Changes

package/README.md

@@ -16,13 +16,13 @@ encode an opinionated house style (called out below) that you can adopt, ignore,
 
 - **Safe by default.** Every writing command supports `--dry-run`, and every audit is read-only except
   `audit comments --fix`.
-- **Scriptable.** `--json` prints one JSON object on stdout and suppresses the human progress output.
+- **Scriptable.** `--json` prints one JSON object on stdout instead of the human-readable output.
 - **CI-ready.** Audits exit non-zero when findings remain, so they gate a pipeline with no extra glue.
 - **Configurable.** An optional `codefast.config.*` file, validated by a strict schema, adjusts every command.
 
 ## Requirements
 
-- **Node.js ≥ 24** (the CLI is published as ESM).
+- **Node.js ≥ 22.12** (the CLI is published as ESM).
 - **A project root — workspace or single package.** Commands resolve their root by walking up from the current
   directory: the nearest `pnpm-workspace.yaml` marks a **workspace** (every package under it is in scope), and with no
   workspace file the nearest `package.json` marks a **single package** (that one package is the whole scope). Only
@@ -75,22 +75,72 @@ codefast audit links                               # find broken markdown cross-
   `codefast mirror --no-color`.
 - **Writing commands write by default; pass `--dry-run` to preview.** The audits are read-only — the one exception is
   `audit comments --fix`, which repairs section dividers in place.
-- **`--json` prints a single JSON object on stdout** and suppresses the human-readable progress output, so any command
-  can gate a script or a CI job.
+- **`--json` prints a single JSON object on stdout** instead of the human-readable output, so any command can gate a
+  script or a CI job.
+- **Set `CODEFAST_VERBOSE=1` (or `true`) for verbose error diagnostics.** On an unexpected infrastructure failure the
+  CLI also prints the underlying stack trace. This is distinct from `mirror --verbose`, which adds per-package progress
+  detail to that one command.
 
 ## Commands at a glance
 
+```text
+codefast                              # Codefast monorepo developer CLI
+│  ├─ --no-color                      # disable ANSI color output
+│  └─ --version
+│
+├─ arrange [target]                   # regroup Tailwind classes in cn()/tv() in render-pipeline order
+│  │   ├─ --dry-run                   # preview, without writing files
+│  │   ├─ --with-class-name           # append className as the final cn() argument (alias: --with-classname)
+│  │   ├─ --cn-import <spec>          # override the module specifier when adding a cn import
+│  │   └─ --json
+│  │
+│  ├─ inspect [target]                # report long strings, cn nested in tv() (read-only)
+│  │   └─ --json
+│  ├─ simplify [target]               # flatten grouped arrays & static cn() to plain strings in tv() slots
+│  │   ├─ --dry-run
+│  │   └─ --fold-variant-class-name   # fold cn() overrides into the variant's className option (uses the TS type server)
+│  └─ group <tokens...>               # group a pasted class string (stdout: cn(...) or a tv() array with --tv)
+│      ├─ --tv                        # emit a tv()-style array instead of a cn() call
+│      ├─ --with-class-name
+│      └─ --json
+│
+├─ audit                              # source audits (read-only source scans)
+│  ├─ rtl [target]                    # physical-direction Tailwind classes to make logical / rtl:-paired
+│  ├─ links [target]                  # markdown links pointing at a missing path/anchor
+│  ├─ imports [target]                # banned import forms (React by-name, Zod namespace in front-end, …)
+│  ├─ display-names [target]          # token()/tag()/module names breaking the <namespace>:<Name> convention
+│  └─ comments [target]               # section dividers not in the one allowed form
+│      └─ --fix                       # rewrite every fixable divider in place (the only audit that writes)
+│      (each audit also takes [target] + --json)
+│
+├─ mirror [package]                   # write package.json#exports from dist/ for workspace packages
+│  ├─ --dry-run
+│  ├─ -v, --verbose
+│  └─ --json
+│
+├─ pack-slim [package]                # strip src, source conditions, dev-only scripts/devDeps, source maps before publish
+│  ├─ --dry-run
+│  ├─ --force                         # run even if the git working tree has uncommitted changes
+│  └─ --json
+│
+└─ tag [target]                       # add @since <version> to exported declarations
+   ├─ --dry-run
+   └─ --json
+```
+
+Every command also responds to `--help`; each command's section below explains what its flags do.
+
 | Command               | What it does                                                               | Writes?           |
 | --------------------- | -------------------------------------------------------------------------- | ----------------- |
 | `arrange`             | Regroup Tailwind classes in `cn()` / `tv()` calls in render-pipeline order | yes (`--dry-run`) |
 | `mirror`              | Write each package's `package.json#exports` from its built `dist/`         | yes (`--dry-run`) |
 | `pack-slim`           | Strip the dev-only surface from a package right before publish             | yes (`--dry-run`) |
 | `tag`                 | Stamp `@since <version>` on exported declarations that lack one            | yes (`--dry-run`) |
-| `audit links`         | Report markdown cross-references that resolve to nothing                   | no                |
 | `audit rtl`           | Report physical-direction Tailwind classes that should be logical          | no                |
+| `audit links`         | Report markdown cross-references that resolve to nothing                   | no                |
 | `audit imports`       | Enforce the import policy (React by-name, Zod namespace in front-end)      | no (report only)  |
-| `audit comments`      | Check doc-comment conventions; repair section dividers                     | `--fix` only      |
 | `audit display-names` | Enforce the `namespace:Name` display-name convention                       | no                |
+| `audit comments`      | Check doc-comment conventions; repair section dividers                     | `--fix` only      |
 
 **Which of these are for you?** `arrange`, `mirror`, `pack-slim`, `tag`, and `audit links` are general-purpose — they
 work for any pnpm workspace or single package that builds with `tsc`. The other four audits encode codefast's own house
@@ -120,13 +170,6 @@ intentional; pass such a file explicitly to process it.
 `#lib/utils` re-export, any `…/utils` path, or a dedicated `cn.ts` module — so an unrelated local `cn` is left alone.
 Long static JSX `className` strings are regrouped regardless of where `cn` comes from.
 
-| Flag                 | Description                                                                   |
-| -------------------- | ----------------------------------------------------------------------------- |
-| `--dry-run`          | Preview suggested replacements without writing files.                         |
-| `--with-classname`   | Append `className` as the final `cn()` argument (alias: `--with-class-name`). |
-| `--cn-import <spec>` | Override the module specifier used when a missing `cn` import is added.       |
-| `--json`             | Print one JSON summary on stdout (suppresses human progress).                 |
-
 Exits `1` when the `arrange.onAfterWrite` hook fails, `0` otherwise.
 
 ### `arrange inspect [target]`
@@ -139,12 +182,6 @@ Flattens grouped arrays and static-only `cn()` calls back to plain strings in `t
 In a mixed `cn()` call it coalesces only _adjacent_ static literals and keeps argument order, so tailwind-merge
 precedence is unchanged (a later argument still overrides an earlier one).
 
-| Flag                       | Description                                                                                              |
-| -------------------------- | -------------------------------------------------------------------------------------------------------- |
-| `--dry-run`                | Show what simplify would change without writing files.                                                   |
-| `--fold-variant-classname` | Fold `cn()` overrides into a variant function's `className` option (alias: `--fold-variant-class-name`). |
-| `--json`                   | Print one JSON summary on stdout.                                                                        |
-
 With `--fold-variant-classname`, `cn(buttonVariants({ size: "sm" }), "flex-1")` becomes
 `buttonVariants({ size: "sm", className: "flex-1" })`, and a dynamic or multi-part override folds into a `className`
 array. The fold fires only when the native TypeScript type server confirms the callee's options accept a `className` (or
@@ -162,11 +199,7 @@ codefast arrange group "relative flex h-10 w-full items-center rounded-md bg-pri
 codefast arrange group --tv "flex items-center gap-2"
 ```
 
-| Flag               | Description                                                                   |
-| ------------------ | ----------------------------------------------------------------------------- |
-| `--tv`             | Emit a `tv()`-style array instead of a `cn()` call.                           |
-| `--with-classname` | Append `className` as the final `cn()` argument (alias: `--with-class-name`). |
-| `--json`           | Emit `{ schemaVersion, primaryLine, bucketsCommentLine }` on stdout.          |
+With `--json`, that object is `{ schemaVersion, primaryLine, bucketsCommentLine }`.
 
 ## `mirror`
 
@@ -181,12 +214,6 @@ codefast mirror packages/ui     # one package (path relative to repo root)
 codefast mirror --dry-run       # report changes without writing
 ```
 
-| Flag              | Description                                                   |
-| ----------------- | ------------------------------------------------------------- |
-| `--dry-run`       | Report what would change without writing any `package.json`.  |
-| `-v`, `--verbose` | Print extra diagnostics.                                      |
-| `--json`          | Print one JSON summary on stdout (suppresses human progress). |
-
 Exits `1` when any package fails, `0` otherwise.
 
 ### Per-package `mirror` configuration
@@ -235,12 +262,6 @@ codefast pack-slim packages/ui     # one package (path relative to repo root)
 codefast pack-slim --dry-run       # report what would be stripped without touching a file
 ```
 
-| Flag        | Description                                                       |
-| ----------- | ----------------------------------------------------------------- |
-| `--dry-run` | Report what would be stripped without touching any file.          |
-| `--force`   | Run even if the git working tree has uncommitted tracked changes. |
-| `--json`    | Print one JSON summary on stdout (suppresses human progress).     |
-
 Exits `1` when any package fails, `0` otherwise.
 
 ## `tag`
@@ -256,11 +277,6 @@ codefast tag packages/ui/src   # tag one directory or file
 codefast tag --dry-run         # summary only, no writes
 ```
 
-| Flag        | Description                                                   |
-| ----------- | ------------------------------------------------------------- |
-| `--dry-run` | Show summary without writing files.                           |
-| `--json`    | Print one JSON summary on stdout (suppresses human progress). |
-
 Exits `1` when no target is selected, when any target fails, or when the `tag.onAfterWrite` hook fails.
 
 ## `audit`
@@ -331,11 +347,6 @@ codefast audit comments --fix              # rewrite fixable dividers in place
 codefast audit comments --json             # machine-readable summary
 ```
 
-| Flag     | Description                                          |
-| -------- | ---------------------------------------------------- |
-| `--fix`  | Rewrite every mechanically fixable divider in place. |
-| `--json` | Print one JSON summary on stdout.                    |
-
 Configure exceptions via `audit.comments.allowlist` — each entry is a divider line as written or
 `repo/relative/path.ts:<divider>`.
 

package/dist/arrange/command.js

@@ -1,27 +1,27 @@
 import { Command } from "commander";
-import { formatArrangeGroupJsonOutput } from "#/arrange/group/cli-result";
-import { arrangeSuggestGroupsRequestSchema } from "#/arrange/group/cli-schema";
-import { presentArrangeGroupResult } from "#/arrange/group/output";
-import { suggestCnGroupsFromCli } from "#/arrange/group/suggest";
-import { formatArrangeAnalyzeJsonOutput } from "#/arrange/inspect/cli-result";
-import { arrangeAnalyzeDirectoryRequestSchema } from "#/arrange/inspect/cli-schema";
-import { presentAnalyzeReport } from "#/arrange/inspect/output";
-import { runArrangeInspect } from "#/arrange/inspect/run";
-import { prepareArrangeWorkspace } from "#/arrange/prepare";
-import { exitCodeForArrangeResult, formatArrangeJsonOutput } from "#/arrange/regroup/cli-result";
-import { arrangeRunRequestSchema } from "#/arrange/regroup/cli-schema";
-import { presentArrangeResult, presentGroupFilePreviewFromWork } from "#/arrange/regroup/output";
-import { runArrange } from "#/arrange/regroup/run";
-import { formatArrangeSimplifyJsonOutput } from "#/arrange/simplify/cli-result";
-import { arrangeSimplifyRunRequestSchema } from "#/arrange/simplify/cli-schema";
-import { presentSimplifyResult } from "#/arrange/simplify/output";
-import { runArrangeSimplify } from "#/arrange/simplify/run";
-import { applyCommandPipeline, registerPipelineSubcommand } from "#/core/cli/command-pipeline";
-import { consumeCliAppError } from "#/core/cli/result-handle";
-import { CLI_EXIT_SUCCESS } from "#/core/exit-codes";
-import { nodeFilesystem } from "#/core/filesystem/node";
-import { logger } from "#/core/logger";
-import { parseWithSchema } from "#/core/schema-parse";
+import { formatArrangeGroupJsonOutput } from "#arrange/group/cli-result";
+import { arrangeSuggestGroupsRequestSchema } from "#arrange/group/cli-schema";
+import { presentArrangeGroupResult } from "#arrange/group/output";
+import { suggestCnGroupsFromCli } from "#arrange/group/suggest";
+import { formatArrangeAnalyzeJsonOutput } from "#arrange/inspect/cli-result";
+import { arrangeAnalyzeDirectoryRequestSchema } from "#arrange/inspect/cli-schema";
+import { presentAnalyzeReport } from "#arrange/inspect/output";
+import { runArrangeInspect } from "#arrange/inspect/run";
+import { prepareArrangeWorkspace } from "#arrange/prepare";
+import { exitCodeForArrangeResult, formatArrangeJsonOutput } from "#arrange/regroup/cli-result";
+import { arrangeRunRequestSchema } from "#arrange/regroup/cli-schema";
+import { presentArrangeResult, presentGroupFilePreviewFromWork } from "#arrange/regroup/output";
+import { runArrange } from "#arrange/regroup/run";
+import { formatArrangeSimplifyJsonOutput } from "#arrange/simplify/cli-result";
+import { arrangeSimplifyRunRequestSchema } from "#arrange/simplify/cli-schema";
+import { presentSimplifyResult } from "#arrange/simplify/output";
+import { runArrangeSimplify } from "#arrange/simplify/run";
+import { applyCommandPipeline, registerPipelineSubcommand } from "#core/cli/command-pipeline";
+import { consumeCliAppError } from "#core/cli/result-handle";
+import { CLI_EXIT_SUCCESS } from "#core/exit-codes";
+import { nodeFilesystem } from "#core/filesystem/node";
+import { logger } from "#core/logger";
+import { parseWithSchema } from "#core/schema-parse";
 const targetHelp = "Directory or file (default: nearest package directory from cwd)";
 const prepareWorkspace = (fs, input) => prepareArrangeWorkspace(fs, { currentWorkingDirectory: input.currentWorkingDirectory, rawTarget: input.rawArg });
 const regroupPipeline = {
@@ -58,7 +58,6 @@ const inspectPipeline = {
     name: "inspect",
     description: "Report long strings, nested cn in tv(), and related findings (read-only)",
     positional: { name: "[target]", help: targetHelp },
-    jsonHelp: "Print one JSON object on stdout instead of a human report",
     schema: arrangeAnalyzeDirectoryRequestSchema,
     prepare: prepareWorkspace,
     buildRequest: ({ prelude }) => ({ analyzeRootPath: prelude.resolvedTarget }),
@@ -113,7 +112,7 @@ export function createArrangeCommand() {
         .argument("<tokens...>", "Class tokens (quote a single string if it contains spaces)")
         .option("--tv", "Emit tv()-style array instead of cn() call", false)
         .option("--with-classname, --with-class-name", "Append className as final cn() argument", false)
-        .option("--json", "Print one JSON object on stdout instead of plain lines", false)
+        .option("--json", "Print one JSON object on stdout instead of the human-readable output", false)
         .action(async (classTokenSeries, opts) => {
         const parsed = parseWithSchema(arrangeSuggestGroupsRequestSchema, {
             inlineClasses: classTokenSeries.join(" ").trim(),

package/dist/arrange/domain/ast/collectors-cn.d.ts

@@ -1,5 +1,5 @@
-import type { DomainAstNode } from "#/arrange/domain/ast/ast-node";
-import type { ForEachStringLiteralInClassExpressionOptions, TailwindClassLiteral } from "#/arrange/domain/types";
+import type { DomainAstNode } from "#arrange/domain/ast/ast-node";
+import type { ForEachStringLiteralInClassExpressionOptions, TailwindClassLiteral } from "#arrange/domain/types";
 /**
  * Visits every static class literal reachable inside a class expression.
  *

package/dist/arrange/domain/ast/collectors-cn.js

@@ -1,5 +1,5 @@
-import { DomainBinaryOperator, DomainSyntaxKind, isDomainArrayLiteralExpression, isDomainTailwindClassLiteral, } from "#/arrange/domain/ast/ast-node";
-import { MAX_CLASS_EXPR_DEPTH } from "#/arrange/domain/constants";
+import { DomainBinaryOperator, DomainSyntaxKind, isDomainArrayLiteralExpression, isDomainTailwindClassLiteral, } from "#arrange/domain/ast/ast-node";
+import { MAX_CLASS_EXPR_DEPTH } from "#arrange/domain/constants";
 /**
  * Visits every static class literal reachable inside a class expression.
  *

package/dist/arrange/domain/ast/collectors-jsx.d.ts

@@ -1,5 +1,5 @@
-import type { DomainJsxAttribute } from "#/arrange/domain/ast/ast-node";
-import type { JsxClassNameStatic } from "#/arrange/domain/types";
+import type { DomainJsxAttribute } from "#arrange/domain/ast/ast-node";
+import type { JsxClassNameStatic } from "#arrange/domain/types";
 /**
  * Extracts the static literal of a JSX `className` attribute, or `undefined` when it is not static.
  *

package/dist/arrange/domain/ast/collectors-jsx.js

@@ -1,4 +1,4 @@
-import { isDomainIdentifier, isDomainJsxExpression, isDomainTailwindClassLiteral } from "#/arrange/domain/ast/ast-node";
+import { isDomainIdentifier, isDomainJsxExpression, isDomainTailwindClassLiteral } from "#arrange/domain/ast/ast-node";
 /**
  * Extracts the static literal of a JSX `className` attribute, or `undefined` when it is not static.
  *

package/dist/arrange/domain/ast/collectors-tv.d.ts

@@ -1,5 +1,5 @@
-import type { DomainCallExpression, DomainObjectLiteralExpression, DomainSourceFile } from "#/arrange/domain/ast/ast-node";
-import type { StringNode, TailwindClassLiteral } from "#/arrange/domain/types";
+import type { DomainCallExpression, DomainObjectLiteralExpression, DomainSourceFile } from "#arrange/domain/ast/ast-node";
+import type { StringNode, TailwindClassLiteral } from "#arrange/domain/types";
 type StringNodeVisitor = (classLiteral: TailwindClassLiteral, sourceFile: DomainSourceFile, cnCall?: DomainCallExpression) => void;
 /**
  * Visits every class literal reachable inside a `tv({ ... })` object, including `cn()` arguments.

package/dist/arrange/domain/ast/collectors-tv.js

@@ -1,8 +1,8 @@
-import { isDomainArrayLiteralExpression, isDomainCallExpression, isDomainObjectLiteralExpression, isDomainPropertyAssignment, isDomainSpreadElement, isDomainTailwindClassLiteral, forEachDomainChild, } from "#/arrange/domain/ast/ast-node";
-import { CN_APPLY_LITERAL_WALK_OPTS, collectUnconditionalTailwindLiteralsFromCnArguments, forEachStringLiteralInClassExpression, isUnsafeLiteralForCnStyleApplySplit, } from "#/arrange/domain/ast/collectors-cn";
-import { buildKnownCnTvBindings, isCnOrTvIdentifier, propertyAssignmentNameText } from "#/arrange/domain/ast/helpers";
-import { APPLY_MIN_TOKENS, MAX_OBJECT_DEPTH } from "#/arrange/domain/constants";
-import { tokenizeClassString } from "#/arrange/domain/tailwind-token";
+import { isDomainArrayLiteralExpression, isDomainCallExpression, isDomainObjectLiteralExpression, isDomainPropertyAssignment, isDomainSpreadElement, isDomainTailwindClassLiteral, forEachDomainChild, } from "#arrange/domain/ast/ast-node";
+import { CN_APPLY_LITERAL_WALK_OPTS, collectUnconditionalTailwindLiteralsFromCnArguments, forEachStringLiteralInClassExpression, isUnsafeLiteralForCnStyleApplySplit, } from "#arrange/domain/ast/collectors-cn";
+import { buildKnownCnTvBindings, isCnOrTvIdentifier, propertyAssignmentNameText } from "#arrange/domain/ast/helpers";
+import { APPLY_MIN_TOKENS, MAX_OBJECT_DEPTH } from "#arrange/domain/constants";
+import { tokenizeClassString } from "#arrange/domain/tailwind-token";
 /**
  * Visits every class literal reachable inside a `tv({ ... })` object, including `cn()` arguments.
  *

package/dist/arrange/domain/ast/helpers.d.ts

@@ -1,5 +1,5 @@
-import type { DomainAstNode, DomainCallExpression, DomainPropertyAssignment, DomainSourceFile } from "#/arrange/domain/ast/ast-node";
-import { applyEditsDescending } from "#/core/source-text-edit";
+import type { DomainAstNode, DomainCallExpression, DomainPropertyAssignment, DomainSourceFile } from "#arrange/domain/ast/ast-node";
+import { applyEditsDescending } from "#core/source-text-edit";
 /**
  * Builds a set of local binding names that are imported from a known cn/tv
  * module in `sourceFile`.

package/dist/arrange/domain/ast/helpers.js

@@ -1,6 +1,6 @@
-import { isDomainIdentifier, isDomainImportDeclaration, isDomainNamedImports, isDomainNamespaceImport, isDomainPropertyAccessExpression, isDomainStringLiteral, lineOfSourcePosition, } from "#/arrange/domain/ast/ast-node";
-import { EMPTY_CN_TV_BINDINGS } from "#/arrange/domain/constants";
-import { applyEditsDescending, indentOfLineContaining } from "#/core/source-text-edit";
+import { isDomainIdentifier, isDomainImportDeclaration, isDomainNamedImports, isDomainNamespaceImport, isDomainPropertyAccessExpression, isDomainStringLiteral, lineOfSourcePosition, } from "#arrange/domain/ast/ast-node";
+import { EMPTY_CN_TV_BINDINGS } from "#arrange/domain/constants";
+import { applyEditsDescending, indentOfLineContaining } from "#core/source-text-edit";
 /**
  * Known module specifiers that export `cn` / `tv`.
  */
@@ -12,7 +12,6 @@ const KNOWN_CN_TV_MODULES = new Set([
     // from "tailwind-variants"; new code should prefer "@codefast/tailwind-variants".
     "tailwind-variants",
     "#lib/utils",
-    "#/lib/utils",
     "~/lib/utils",
     "@/lib/utils",
 ]);

package/dist/arrange/domain/ast/simplify-targets.d.ts

@@ -1,4 +1,4 @@
-import type { DomainSourceFile } from "#/arrange/domain/ast/ast-node";
+import type { DomainSourceFile } from "#arrange/domain/ast/ast-node";
 /**
  * A planned text replacement produced by the simplify pass.
  *

package/dist/arrange/domain/ast/simplify-targets.js

@@ -1,8 +1,8 @@
-import { forEachDomainChild, isDomainArrayLiteralExpression, isDomainCallExpression, isDomainJsxAttribute, isDomainJsxExpression, isDomainObjectLiteralExpression, isDomainPropertyAssignment, isDomainSpreadElement, isDomainTailwindClassLiteral, } from "#/arrange/domain/ast/ast-node";
-import { buildKnownCnTvBindings, isCnOrTvIdentifier } from "#/arrange/domain/ast/helpers";
-import { MAX_OBJECT_DEPTH } from "#/arrange/domain/constants";
-import { escapeTsStringLiteralContent } from "#/arrange/domain/source-text-formatters";
-import { indentOfLineContaining } from "#/core/source-text-edit";
+import { forEachDomainChild, isDomainArrayLiteralExpression, isDomainCallExpression, isDomainJsxAttribute, isDomainJsxExpression, isDomainObjectLiteralExpression, isDomainPropertyAssignment, isDomainSpreadElement, isDomainTailwindClassLiteral, } from "#arrange/domain/ast/ast-node";
+import { buildKnownCnTvBindings, isCnOrTvIdentifier } from "#arrange/domain/ast/helpers";
+import { MAX_OBJECT_DEPTH } from "#arrange/domain/constants";
+import { escapeTsStringLiteralContent } from "#arrange/domain/source-text-formatters";
+import { indentOfLineContaining } from "#core/source-text-edit";
 function toFlatString(text) {
     return `"${escapeTsStringLiteralContent(text.trim())}"`;
 }

package/dist/arrange/domain/ast/targets.d.ts

@@ -1,5 +1,5 @@
-import type { DomainSourceFile } from "#/arrange/domain/ast/ast-node";
-import type { GroupTarget, PlannedGroupEdit } from "#/arrange/domain/types";
+import type { DomainSourceFile } from "#arrange/domain/ast/ast-node";
+import type { GroupTarget, PlannedGroupEdit } from "#arrange/domain/types";
 /**
  * Resolves the source position where a group target's replacement begins.
  *

package/dist/arrange/domain/ast/targets.js

@@ -1,12 +1,12 @@
-import { isDomainArrayLiteralExpression, isDomainJsxAttribute, isDomainPropertyAssignment, isDomainTailwindClassLiteral, forEachDomainChild, } from "#/arrange/domain/ast/ast-node";
-import { isUnsafeLiteralForCnStyleApplySplit } from "#/arrange/domain/ast/collectors-cn";
-import { jsxClassNameStaticLiteral } from "#/arrange/domain/ast/collectors-jsx";
-import { collectGroupableStringNodes, slotClassString } from "#/arrange/domain/ast/collectors-tv";
-import { APPLY_MIN_TOKENS } from "#/arrange/domain/constants";
-import { areCnTailwindPartitionsEquivalent, suggestCnGroups, summarizeGroupBucketLabels, } from "#/arrange/domain/grouping";
-import { escapeTsStringLiteralContent, formatArray, formatArrayElementsAsSiblingLines, formatJsxCnAttributeValue, } from "#/arrange/domain/source-text-formatters";
-import { tokenizeClassString } from "#/arrange/domain/tailwind-token";
-import { endAfterOptionalCommaFollowingInSource, indentOfLineContaining, textPrefixFromLineStartToPosition, } from "#/core/source-text-edit";
+import { isDomainArrayLiteralExpression, isDomainJsxAttribute, isDomainPropertyAssignment, isDomainTailwindClassLiteral, forEachDomainChild, } from "#arrange/domain/ast/ast-node";
+import { isUnsafeLiteralForCnStyleApplySplit } from "#arrange/domain/ast/collectors-cn";
+import { jsxClassNameStaticLiteral } from "#arrange/domain/ast/collectors-jsx";
+import { collectGroupableStringNodes, slotClassString } from "#arrange/domain/ast/collectors-tv";
+import { APPLY_MIN_TOKENS } from "#arrange/domain/constants";
+import { areCnTailwindPartitionsEquivalent, suggestCnGroups, summarizeGroupBucketLabels, } from "#arrange/domain/grouping";
+import { escapeTsStringLiteralContent, formatArray, formatArrayElementsAsSiblingLines, formatJsxCnAttributeValue, } from "#arrange/domain/source-text-formatters";
+import { tokenizeClassString } from "#arrange/domain/tailwind-token";
+import { endAfterOptionalCommaFollowingInSource, indentOfLineContaining, textPrefixFromLineStartToPosition, } from "#core/source-text-edit";
 /**
  * Resolves the source position where a group target's replacement begins.
  *

package/dist/arrange/domain/ast/translator.d.ts

@@ -2,7 +2,7 @@
  * Anti-corruption layer: maps the oxc-parser ESTree AST to the arrange domain AST.
  * This is the only place that parses TypeScript source for arrange AST translation.
  */
-import type { DomainSourceFile } from "#/arrange/domain/ast/ast-node";
+import type { DomainSourceFile } from "#arrange/domain/ast/ast-node";
 /**
  * The translator mapping the `oxc-parser` ESTree AST to the arrange domain AST.
  *

package/dist/arrange/domain/ast/translator.js

@@ -3,7 +3,7 @@
  * This is the only place that parses TypeScript source for arrange AST translation.
  */
 import { parseSync } from "oxc-parser";
-import { DomainBinaryOperator, DomainSyntaxKind } from "#/arrange/domain/ast/ast-node";
+import { DomainBinaryOperator, DomainSyntaxKind } from "#arrange/domain/ast/ast-node";
 function isOxcNode(value) {
     return typeof value === "object" && value !== null && typeof value.type === "string";
 }

package/dist/arrange/domain/constants.d.ts

@@ -1,4 +1,4 @@
-import type { Bucket } from "#/arrange/domain/types";
+import type { Bucket } from "#arrange/domain/types";
 /**
  * Analyze report: long literal threshold (token count).
  *

package/dist/arrange/domain/grouping-service.d.ts

@@ -2,8 +2,8 @@
  * Rich domain: plan Tailwind class grouping / cn-in-tv unwrap for a single file.
  * Pure: only DomainSourceFile, source strings, and options — no I/O.
  */
-import type { DomainCallExpression, DomainSourceFile } from "#/arrange/domain/ast/ast-node";
-import type { GroupFileResult, PlannedGroupEdit } from "#/arrange/domain/types";
+import type { DomainCallExpression, DomainSourceFile } from "#arrange/domain/ast/ast-node";
+import type { GroupFileResult, PlannedGroupEdit } from "#arrange/domain/types";
 /**
  * A planned replacement unwrapping one `cn()` call nested in `tv({ ... })`.
  *

package/dist/arrange/domain/grouping-service.js

@@ -2,9 +2,9 @@
  * Rich domain: plan Tailwind class grouping / cn-in-tv unwrap for a single file.
  * Pure: only DomainSourceFile, source strings, and options — no I/O.
  */
-import { listAllCnCallsInsideTvInSourceFile } from "#/arrange/domain/ast/collectors-tv";
-import { applyEditsDescending, buildKnownCnTvBindings, unwrapCnInsideTvCallReplacement, } from "#/arrange/domain/ast/helpers";
-import { collectGroupTargets, planGroupEditForTarget, targetReplaceStart } from "#/arrange/domain/ast/targets";
+import { listAllCnCallsInsideTvInSourceFile } from "#arrange/domain/ast/collectors-tv";
+import { applyEditsDescending, buildKnownCnTvBindings, unwrapCnInsideTvCallReplacement, } from "#arrange/domain/ast/helpers";
+import { collectGroupTargets, planGroupEditForTarget, targetReplaceStart } from "#arrange/domain/ast/targets";
 function toUnwrapPlans(cnInTvCalls, sourceText) {
     return cnInTvCalls
         .map((call) => {

package/dist/arrange/domain/grouping.js

@@ -1,6 +1,6 @@
-import { BUCKET_ORDER, MAX_GROUPS_BASE, MAX_GROUPS_CAP, MAX_GROUPS_HEADROOM, MIN_GROUP_TOKENS, } from "#/arrange/domain/constants";
-import { stripVariants, tokenizeClassString } from "#/arrange/domain/tailwind-token";
-import { bucketsCompatible, bucketsMergeCompatible, classifyToken, compositeSecondaryOrder, selectorKey, stateKey, } from "#/arrange/domain/token-classifier";
+import { BUCKET_ORDER, MAX_GROUPS_BASE, MAX_GROUPS_CAP, MAX_GROUPS_HEADROOM, MIN_GROUP_TOKENS, } from "#arrange/domain/constants";
+import { stripVariants, tokenizeClassString } from "#arrange/domain/tailwind-token";
+import { bucketsCompatible, bucketsMergeCompatible, classifyToken, compositeSecondaryOrder, selectorKey, stateKey, } from "#arrange/domain/token-classifier";
 /**
  * `cn()` grouping: bucket sequence is {@link BUCKET_ORDER} only; tokens are classified with
  * {@link classifyToken}. Comparators here (`compareClassifiedTailwindTokensForCnGrouping`, …)

package/dist/arrange/domain/imports.d.ts

@@ -1,4 +1,4 @@
-import type { DomainSourceFile } from "#/arrange/domain/ast/ast-node";
+import type { DomainSourceFile } from "#arrange/domain/ast/ast-node";
 /**
  * After simplify rewrites, drop the `cn` import specifier when `cn` is no
  * longer referenced anywhere outside the import declarations.

package/dist/arrange/domain/imports.js

@@ -1,5 +1,5 @@
-import { forEachDomainChild, isDomainIdentifier, isDomainImportDeclaration, isDomainNamedImports, isDomainStringLiteral, } from "#/arrange/domain/ast/ast-node";
-import { endAfterOptionalCommaFollowingInSource } from "#/core/source-text-edit";
+import { forEachDomainChild, isDomainIdentifier, isDomainImportDeclaration, isDomainNamedImports, isDomainStringLiteral, } from "#arrange/domain/ast/ast-node";
+import { endAfterOptionalCommaFollowingInSource } from "#core/source-text-edit";
 function sourceFileImportsCn(sourceFile) {
     for (const statement of sourceFile.statements) {
         if (!isDomainImportDeclaration(statement) || !statement.importClause) {

package/dist/arrange/domain/source-text-formatters.js

@@ -1,4 +1,4 @@
-import { indentOfLineContaining } from "#/core/source-text-edit";
+import { indentOfLineContaining } from "#core/source-text-edit";
 /**
  * Escapes backslashes and double quotes for embedding in a double-quoted TypeScript string literal.
  *

package/dist/arrange/domain/tailwind-token.js

@@ -1,4 +1,4 @@
-import { MAX_STRIP_VARIANT_PASSES } from "#/arrange/domain/constants";
+import { MAX_STRIP_VARIANT_PASSES } from "#arrange/domain/constants";
 /**
  * Splits a class string into its whitespace-separated tokens.
  *

package/dist/arrange/domain/token-classifier.d.ts

@@ -1,4 +1,4 @@
-import type { Bucket } from "#/arrange/domain/types";
+import type { Bucket } from "#arrange/domain/types";
 /**
  * Secondary sort inside the **composite** bucket: opacity / blend / isolation →
  * 3D context → 3D transforms → 2D transforms → filters → will-change.

package/dist/arrange/domain/token-classifier.js

@@ -1,5 +1,5 @@
-import { COMPATIBLE_BUCKET_SETS, RESPONSIVE_PREFIX, STATE_PREFIXES } from "#/arrange/domain/constants";
-import { indexOfFirstVariantColon, stripVariants } from "#/arrange/domain/tailwind-token";
+import { COMPATIBLE_BUCKET_SETS, RESPONSIVE_PREFIX, STATE_PREFIXES } from "#arrange/domain/constants";
+import { indexOfFirstVariantColon, stripVariants } from "#arrange/domain/tailwind-token";
 /**
  * Bare-token classification is **total** (always returns a {@link Bucket}). The `Result` pattern
  * (`isOk` / `isErr`) belongs at arrange use-case / I/O boundaries, not on this hot path.

package/dist/arrange/domain/types.d.ts

@@ -7,9 +7,9 @@
  *
  * `arbitrary` and `other` are non-pipeline tails for `[prop:value]` syntax and unknown utilities.
  */
-import type { DomainAstNode, DomainCallExpression, DomainSourceFile, DomainTailwindClassLiteral } from "#/arrange/domain/ast/ast-node";
-import type { GroupFileWorkPlan } from "#/arrange/domain/grouping-service";
-import type { CodefastConfig } from "#/core/config/schema";
+import type { DomainAstNode, DomainCallExpression, DomainSourceFile, DomainTailwindClassLiteral } from "#arrange/domain/ast/ast-node";
+import type { GroupFileWorkPlan } from "#arrange/domain/grouping-service";
+import type { CodefastConfig } from "#core/config/schema";
 /**
  * The render-pipeline bucket a Tailwind token classifies into.
  *

package/dist/arrange/group/cli-result.d.ts

@@ -1,4 +1,4 @@
-import type { ArrangeSuggestGroupsOutput } from "#/arrange/domain/types";
+import type { ArrangeSuggestGroupsOutput } from "#arrange/domain/types";
 /**
  * Machine-readable `arrange group` suggestion for `--json`.
  *

package/dist/arrange/group/output.d.ts

@@ -1,4 +1,4 @@
-import type { ArrangeSuggestGroupsOutput } from "#/arrange/domain/types";
+import type { ArrangeSuggestGroupsOutput } from "#arrange/domain/types";
 /**
  * Presents the suggested grouping lines for an `arrange group` run.
  *

package/dist/arrange/group/output.js

@@ -1,4 +1,4 @@
-import { logger } from "#/core/logger";
+import { logger } from "#core/logger";
 /**
  * Presents the suggested grouping lines for an `arrange group` run.
  *