@codefast/cli 0.7.0 → 0.8.1

package/README.md

@@ -1,23 +1,36 @@
 # @codefast/cli
 
-Developer CLI for the [Codefast monorepo](https://github.com/codefastlabs/codefast) — `arrange` Tailwind class strings,
-`audit` source conventions (RTL), `mirror` export maps from `dist/`, and `tag` exported APIs with `@since`.
+The `codefast` command line for the [codefast monorepo](https://github.com/codefastlabs/codefast): `arrange` Tailwind
+class strings, `audit` source conventions, `mirror` export maps from `dist/`, `pack-slim` the publish artifact, and
+`tag` exported APIs with `@since`.
 
 [![npm version](https://img.shields.io/npm/v/@codefast/cli)](https://www.npmjs.com/package/@codefast/cli)
-[![license](https://img.shields.io/npm/l/@codefast/cli)](https://github.com/codefastlabs/codefast/blob/main/LICENSE)
+[![license](https://img.shields.io/npm/l/@codefast/cli)](./LICENSE)
 
-This package exists to maintain the Codefast repository itself. It is published to npm and works in any pnpm workspace
-with a similar layout, but its flags and defaults follow Codefast's conventions — treat it as repo tooling, not a
-general-purpose product.
+## Overview
+
+`codefast` is the command line for the [codefast monorepo](https://github.com/codefastlabs/codefast). It has five
+commands: `arrange` regroups Tailwind class strings, `audit` checks source conventions, `mirror` writes
+`package.json#exports` from `dist/`, `pack-slim` strips the source lane from the publish artifact, and `tag` stamps
+exported APIs with `@since`.
+
+This is repo tooling, published to npm. It runs in any pnpm workspace with a similar layout, but its flags and defaults
+follow the codefast conventions rather than aiming to be a general-purpose product.
+
+- **Safe by default.** Every writing command has `--dry-run`, and every audit is read-only except
+  `audit comments --fix`.
+- **Scriptable.** `--json` prints one JSON object on stdout and suppresses human progress output.
+- **CI-ready.** Audits exit non-zero when findings remain, so they gate a pipeline without extra glue.
+- **Configurable.** An optional `codefast.config.*` file, validated by a strict schema, adjusts every command.
 
 ## Installation and usage
 
-Inside the Codefast monorepo, the CLI runs from its built output via root `package.json` scripts:
+Inside the codefast monorepo, the CLI runs from its built output via root `package.json` scripts:
 
 ```bash
-pnpm --filter @codefast/cli build   # produce dist/bin.mjs first
+pnpm --filter @codefast/cli build   # produce dist/bin.js first
 
-pnpm run codefast <command>         # generic entry: node ./packages/cli/dist/bin.mjs
+pnpm run codefast <command>         # generic entry: node ./packages/cli/dist/bin.js
 
 # Convenience wrappers
 pnpm run cli:arrange                # codefast arrange
@@ -29,8 +42,12 @@ pnpm run cli:mirror                 # codefast mirror
 pnpm run cli:mirror:preview         # codefast mirror --dry-run
 pnpm run cli:audit:rtl              # codefast audit rtl
 pnpm run cli:audit:links            # codefast audit links
+pnpm run cli:audit:comments         # codefast audit comments
+pnpm run cli:audit:react            # codefast audit react
 ```
 
+`pnpm run version-packages` runs `changeset version` and then `codefast tag`, so published APIs are stamped at release.
+
 Standalone install (Node >= 24):
 
 ```bash
@@ -39,15 +56,18 @@ pnpm add -g @codefast/cli
 pnpm dlx @codefast/cli --help
 ```
 
-Every command writes by default; pass `--dry-run` to preview. The global `--no-color` flag must come before the command
-name (`codefast --no-color mirror`). Commands that accept `--json` print a single JSON object on stdout and suppress
-human progress output.
+The package is published on 0.x and versioned on its own track: breaking changes ship as minor versions, so pin the
+minor version when you need stability.
+
+Every writing command writes by default; pass `--dry-run` to preview. The global `--no-color` flag must come before the
+command name (`codefast --no-color mirror`). Commands that accept `--json` print a single JSON object on stdout and
+suppress human progress output.
 
 ## `arrange`
 
-Rewrites Tailwind class strings inside `cn()` and `tv()` calls, regrouping utilities in render-pipeline order
-(existence, position, layout, sizing, spacing, shape, background, shadow, typography, composite, motion, behavior,
-state, selector) instead of alphabetically.
+Rewrites Tailwind class strings inside `cn()` and `tv()` calls, regrouping utilities in render-pipeline order —
+existence, position, layout, sizing, spacing, shape, background, shadow, typography, composite, motion, starting,
+behavior, state, selector — instead of alphabetically.
 
 ```bash
 codefast arrange inspect packages/ui/src          # read-only report
@@ -55,8 +75,9 @@ codefast arrange --dry-run packages/ui/src        # preview the rewrite
 codefast arrange packages/ui/src                  # write
 ```
 
-When `[target]` is omitted, `arrange` uses the nearest package directory found by walking up from the current working
-directory. Directory scans skip test files (`*.test.*` / `*.spec.*`); pass such a file explicitly to process it.
+When `[target]` is omitted, `arrange` uses the nearest directory with a `package.json` found by walking up from the
+current working directory. Directory scans skip test files (`*.test.*` / `*.spec.*`), because a `cn()` inside an
+assertion is intentional; pass such a file explicitly to process it.
 
 | Flag                 | Description                                                                   |
 | -------------------- | ----------------------------------------------------------------------------- |
@@ -65,6 +86,8 @@ directory. Directory scans skip test files (`*.test.*` / `*.spec.*`); pass such
 | `--cn-import <spec>` | Override the module specifier used when a missing `cn` import is added.       |
 | `--json`             | Print one JSON object on stdout (suppresses human progress).                  |
 
+Exits `1` when the `arrange.onAfterWrite` hook fails, `0` otherwise.
+
 ### `arrange inspect [target]`
 
 Read-only report of long strings, nested `cn` inside `tv()`, and related findings. Accepts `--json`.
@@ -91,9 +114,10 @@ codefast arrange group --tv "flex items-center gap-2"
 
 ## `mirror`
 
-Scans each workspace package's built `dist/` tree and writes its `package.json#exports` map (plus top-level `main`,
-`module`, `types`, and a `files` entry for `dist`). The workspace root is discovered via `pnpm-workspace.yaml`, so it
-runs from anywhere inside the repo. Build first — `mirror` reads `dist/`, and stale output produces stale exports.
+Scans each workspace package's built `dist/` tree and writes its `package.json#exports` map, plus top-level `main`,
+`module`, and `types` mirrored from the root export and a `files` entry for `dist`. The workspace root is the directory
+holding `pnpm-workspace.yaml`, so it runs from anywhere inside the repo. Build first — `mirror` reads `dist/`, and stale
+output produces stale exports.
 
 ```bash
 codefast mirror                 # all workspace packages
@@ -109,6 +133,34 @@ codefast mirror --dry-run       # report changes without writing
 
 Exits `1` when any package fails, `0` otherwise.
 
+## `pack-slim`
+
+Strips the source lane from published packages so the npm tarball ships `dist` runtime and types only. Where `mirror`
+writes the full exports — including the `source` condition — for repo dev, `pack-slim` removes it for publish: it drops
+`src` from `files`, every `source` condition from `exports`/`imports`, and the `dist` source maps plus their dangling
+`sourceMappingURL` directives. Private packages are skipped, since `changeset publish` never publishes them. It is meant
+to run on an ephemeral CI checkout right before publish (the release workflow runs it as its publish step), so it is
+never committed.
+
+Because its result must never be committed, `pack-slim` refuses to write when the git working tree has uncommitted
+tracked changes — guarding against an accidental local run landing on real work. `--dry-run` is exempt (it writes
+nothing) and `--force` overrides the guard. In CI the check is transparent: `dist` is gitignored, so the tree is clean
+when the release workflow runs it.
+
+```bash
+codefast pack-slim                 # every published package
+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.
+
 ## `audit rtl`
 
 Read-only scan for physical-direction Tailwind classes (e.g. `ml-*`, `left-*`, `text-left`) that should use logical
@@ -125,16 +177,17 @@ codefast audit rtl --json                  # machine-readable summary
 | -------- | --------------------------------- |
 | `--json` | Print one JSON summary on stdout. |
 
-Configure intentional exceptions via `audit.rtl.allowlist` in `codefast.config` — each entry is a bare class token or
+With no `[target]`, the scan root is `audit.rtl.target` from the config; when neither is set the command fails.
+Configure intentional exceptions via `audit.rtl.allowlist` — each entry is a bare class token or
 `repo/relative/path.tsx:token`.
 
 ## `audit links`
 
 Read-only scan for markdown cross-references that point at nothing: a relative path that does not exist, an in-document
 anchor with no matching heading or `<a id>`, and an anchor into another document that the target does not offer. That
-last one is the reason this exists — it fails silently in a browser by scrolling to the top, so nothing else notices.
-External URLs are somebody else's to check and are skipped, as are links inside fenced code, which are examples rather
-than references. Exits non-zero when breakages remain so it can gate CI.
+last one is the reason this exists — a browser fails it silently by scrolling to the top. External URLs are not checked,
+and links inside fenced code are treated as examples rather than references. Exits non-zero when breakages remain so it
+can gate CI.
 
 ```bash
 codefast audit links                       # whole repo
@@ -146,14 +199,57 @@ codefast audit links --json                # machine-readable summary
 | -------- | --------------------------------- |
 | `--json` | Print one JSON summary on stdout. |
 
-Configure intentional exceptions via `audit.links.allowlist` in `codefast.config` — each entry is a bare link target or
+Configure intentional exceptions via `audit.links.allowlist` — each entry is a bare link target or
 `repo/relative/doc.md:target`.
 
+## `audit comments`
+
+Scans source comments for the repo's comment conventions. Section dividers that are not in the one allowed form are
+mechanical, so `--fix` rewrites them in place. The rest is reported for a person to fix: TSDoc grammar errors, JSDoc
+`{type}` payloads, comments pointing at repo documents, `@param` lists that name some parameters but not all, `@param`
+descriptions without the `-` separator, `@since` tags out of position or naming a version the package has not reached,
+and comment links to missing paths. Exits non-zero when unfixed findings remain so it can gate CI.
+
+```bash
+codefast audit comments                    # whole repo
+codefast audit comments packages/di/src    # explicit target
+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 intentional exceptions via `audit.comments.allowlist` — each entry is a divider line as written or
+`repo/relative/path.ts:<divider>`.
+
+## `audit react`
+
+Read-only scan enforcing the repo's React import policy: members are imported by name. Flags `import * as React` and
+default `React` imports (type-only included), plus an implicit `React.*` UMD-global type reference (`e: React.FormEvent`
+with no import), which `tsc` accepts silently through the `export as namespace React` declaration in `@types/react`.
+Exits non-zero when violations remain so it can gate CI.
+
+```bash
+codefast audit react                       # whole repo
+codefast audit react apps/ui/src           # explicit target
+codefast audit react --json                # machine-readable summary
+```
+
+| Flag     | Description                       |
+| -------- | --------------------------------- |
+| `--json` | Print one JSON summary on stdout. |
+
+Configure intentional exceptions via `audit.react.allowlist` — each entry is the offending source text as written or
+`repo/relative/path.tsx:<text>`.
+
 ## `tag`
 
-Adds `@since <version>` tags to doc comments of exported declarations that lack one, creating the doc block when
-missing. The version comes from the nearest `package.json` walking up from each target file. Declarations that already
-carry `@since` are left alone.
+Adds `@since <version>` tags to the doc comments of exported declarations that lack one, creating the doc block when
+there is none. The version comes from the nearest `package.json` above each target file. Declarations that already carry
+`@since` are left alone.
 
 ```bash
 codefast tag                   # auto-discover workspace packages from cwd
@@ -166,15 +262,17 @@ codefast tag --dry-run         # summary only, no writes
 | `--dry-run` | Show summary without writing files.                           |
 | `--json`    | Print one JSON summary on stdout (suppresses human progress). |
 
-In this repo, `tag` runs as part of the release workflow so published APIs carry accurate version metadata — never
-hand-write `@since` tags.
+Exits `1` when no target is selected, when any target fails, or when the `tag.onAfterWrite` hook fails. In this repo,
+`tag` runs inside `pnpm run version-packages` so published APIs carry accurate version metadata — never hand-write
+`@since` tags.
 
 ## Configuration
 
 An optional `codefast.config.*` file adjusts `mirror`, `tag`, `arrange`, and `audit`. The CLI walks up from the working
 directory and uses the first match, checking `codefast.config.mjs`, `codefast.config.js`, `codefast.config.cjs`, then
 `codefast.config.json` in each directory. JS configs are loaded via [jiti](https://github.com/unjs/jiti), so only run
-the CLI in repositories you trust; JSON configs cannot define hooks.
+the CLI in repositories you trust; JSON configs cannot define hooks. The schema is strict: an unknown key is a
+configuration error.
 
 ```js
 // codefast.config.js
@@ -185,8 +283,9 @@ export default {
   mirror: {
     "@acme/ui": {
       strip: "./components/", // flatten a dist/ prefix out of public specifiers
+      exclude: ["./internal/*"], // specifiers to leave out of the generated map
       exports: { "./css/*": "./src/css/*" }, // extra or overriding entries
-      source: true, // add a `source` condition (string overrides the root path)
+      source: true, // add a `source` condition (a string overrides the root path)
       types: true, // add `types` when a .d.ts exists
       import: true, // add the `import` condition
       css: true, // boolean or { enabled, forceExportFiles, customExports }
@@ -195,7 +294,7 @@ export default {
     "@acme/internal": false,
   },
   tag: {
-    skipPackages: ["@acme/internal"],
+    skipPackages: ["@acme/internal", "@apps/*"], // glob patterns matched against package names
     onAfterWrite: ({ files }) => execSync(`oxfmt ${files.join(" ")}`, { stdio: "inherit" }),
   },
   arrange: {
@@ -209,12 +308,15 @@ export default {
         "packages/ui/src/variants/sheet.ts:data-open:slide-in-from-left-10",
       ],
     },
+    links: { allowlist: [] }, // bare link target, or `repo/relative/doc.md:target`
+    comments: { allowlist: [] }, // divider as written, or `repo/relative/path.ts:<divider>`
+    react: { allowlist: [] }, // offending text as written, or `repo/relative/path.tsx:<text>`
   },
 };
 ```
 
-The `onAfterWrite` hooks (sync or async) run only when files were actually written — never on `--dry-run`. A hook
-failure is reported on stderr and the command exits `1`.
+`source`, `types`, and `import` default to `true`. The `onAfterWrite` hooks (sync or async) run only when files were
+actually written — never on `--dry-run`. A hook failure is reported on stderr and the command exits `1`.
 
 ## Exit codes
 
@@ -222,8 +324,21 @@ failure is reported on stderr and the command exits `1`.
 | ---- | --------------------------------------------------------------- |
 | `0`  | Success.                                                        |
 | `1`  | General failure (missing paths, failed packages, failed hooks). |
-| `2`  | Invalid invocation or input.                                    |
+| `2`  | Invalid arguments or configuration.                             |
+
+## Documentation
+
+- [codefastlabs.com/docs/cli](https://codefastlabs.com/docs/cli) — this document, rendered.
+- [`ARCHITECTURE.md`](./ARCHITECTURE.md) — how the package is laid out: command wiring, the `Result` type, and the
+  filesystem port.
+- [`DECISIONS.md`](./DECISIONS.md) — the design decisions that shape the package and the reasons behind them.
+- [`CHANGELOG.md`](./CHANGELOG.md) — release notes for every published version.
+
+## Contributing
+
+The package is developed in the [codefast monorepo](https://github.com/codefastlabs/codefast); the repo-wide
+[contributing guide](../../CONTRIBUTING.md) covers setup, the test taxonomy, and the release flow.
 
 ## License
 
-[MIT](https://github.com/codefastlabs/codefast/blob/main/LICENSE)
+Released under the [MIT License](./LICENSE).

package/dist/arrange/analyze.js

@@ -5,6 +5,8 @@ import { AppError } from "#/core/errors";
 import { messageFrom } from "#/core/errors";
 import { err, ok } from "#/core/result";
 /**
+ * Scans a directory's arrange targets and returns the accumulated analyze report.
+ *
  * @since 0.3.16-canary.0
  */
 export function analyzeDirectory(fs, analyzeRootPath) {
@@ -21,5 +23,4 @@ export function analyzeDirectory(fs, analyzeRootPath) {
     catch (caughtError) {
         return err(new AppError("INFRA_FAILURE", messageFrom(caughtError), caughtError));
     }
-}
-//# sourceMappingURL=analyze.js.map
+}

package/dist/arrange/cli-schema.js

@@ -1,11 +1,15 @@
 import { z } from "zod";
 /**
+ * The `zod` schema validating an `arrange analyze` request.
+ *
  * @since 0.3.16-canary.0
  */
 export const arrangeAnalyzeDirectoryRequestSchema = z.object({
     analyzeRootPath: z.string().min(1, "analyzeRootPath is required"),
 });
 /**
+ * The `zod` schema validating an `arrange` run request.
+ *
  * @since 0.3.16-canary.0
  */
 export const arrangeSyncRunRequestSchema = z.object({
@@ -17,6 +21,8 @@ export const arrangeSyncRunRequestSchema = z.object({
     config: z.unknown().optional(),
 });
 /**
+ * The `zod` schema validating an `arrange group` request.
+ *
  * @since 0.3.16-canary.0
  */
 export const arrangeSuggestGroupsRequestSchema = z.object({
@@ -25,5 +31,4 @@ export const arrangeSuggestGroupsRequestSchema = z.object({
         .min(1, 'Pass a class string. Example: codefast arrange group "flex gap-2 text-sm rounded-md"'),
     emitTvStyleArray: z.boolean(),
     trailingClassName: z.boolean(),
-});
-//# sourceMappingURL=cli-schema.js.map
+});

package/dist/arrange/command.js

@@ -14,6 +14,8 @@ import { nodeFilesystem } from "#/core/filesystem/node";
 import { logger } from "#/core/logger";
 import { parseWithSchema } from "#/core/schema-parse";
 /**
+ * Creates the `arrange` command and its subcommands.
+ *
  * @since 0.3.16-canary.0
  */
 export function createArrangeCommand() {
@@ -166,5 +168,4 @@ function formatArrangeGroupJsonOutput(output) {
 }
 function exitCodeForArrangeSyncResult(result) {
     return result.hookError !== null ? CLI_EXIT_GENERAL_ERROR : CLI_EXIT_SUCCESS;
-}
-//# sourceMappingURL=command.js.map
+}

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

@@ -14,6 +14,8 @@ function previewText(text) {
     return text.length > PREVIEW_MAX_LENGTH ? `${text.slice(0, PREVIEW_MAX_LENGTH)}…` : text;
 }
 /**
+ * Creates a zeroed analyze report ready for accumulation.
+ *
  * @since 0.3.16-canary.0
  */
 export function createEmptyAnalyzeReport() {
@@ -118,5 +120,4 @@ export function accumulateAnalyzeReportForSourceFile(report, domainSf, sourceTex
     for (const stmt of domainSf.statements) {
         visitTypeScriptSubtree(stmt);
     }
-}
-//# sourceMappingURL=analyze-service.js.map
+}

package/dist/arrange/domain/ast/ast-node.js

@@ -32,6 +32,8 @@ export var DomainSyntaxKind;
     DomainSyntaxKind[DomainSyntaxKind["JsxExpression"] = 24] = "JsxExpression";
 })(DomainSyntaxKind || (DomainSyntaxKind = {}));
 /**
+ * The binary operators the domain AST distinguishes.
+ *
  * @since 0.3.16-canary.0
  */
 export var DomainBinaryOperator;
@@ -40,12 +42,16 @@ export var DomainBinaryOperator;
     DomainBinaryOperator[DomainBinaryOperator["Other"] = 1] = "Other";
 })(DomainBinaryOperator || (DomainBinaryOperator = {}));
 /**
+ * Narrows a node to `DomainIdentifier`.
+ *
  * @since 0.3.16-canary.0
  */
 export function isDomainIdentifier(node) {
     return node.kind === DomainSyntaxKind.Identifier;
 }
 /**
+ * Narrows a node to `DomainStringLiteral`.
+ *
  * @since 0.3.16-canary.0
  */
 export function isDomainStringLiteral(node) {
@@ -55,78 +61,104 @@ function isDomainNoSubstitutionTemplateLiteral(node) {
     return node.kind === DomainSyntaxKind.NoSubstitutionTemplateLiteral;
 }
 /**
+ * Narrows a node to a literal that can carry Tailwind classes.
+ *
  * @since 0.3.16-canary.0
  */
 export function isDomainTailwindClassLiteral(node) {
     return isDomainStringLiteral(node) || isDomainNoSubstitutionTemplateLiteral(node);
 }
 /**
+ * Narrows a node to `DomainImportDeclaration`.
+ *
  * @since 0.3.16-canary.0
  */
 export function isDomainImportDeclaration(node) {
     return node.kind === DomainSyntaxKind.ImportDeclaration;
 }
 /**
+ * Narrows a node to `DomainNamedImports`.
+ *
  * @since 0.3.16-canary.0
  */
 export function isDomainNamedImports(node) {
     return node.kind === DomainSyntaxKind.NamedImports;
 }
 /**
+ * Narrows a node to `DomainNamespaceImport`.
+ *
  * @since 0.3.16-canary.0
  */
 export function isDomainNamespaceImport(node) {
     return node.kind === DomainSyntaxKind.NamespaceImport;
 }
 /**
+ * Narrows a node to `DomainCallExpression`.
+ *
  * @since 0.3.16-canary.0
  */
 export function isDomainCallExpression(node) {
     return node.kind === DomainSyntaxKind.CallExpression;
 }
 /**
+ * Narrows a node to `DomainObjectLiteralExpression`.
+ *
  * @since 0.3.16-canary.0
  */
 export function isDomainObjectLiteralExpression(node) {
     return node.kind === DomainSyntaxKind.ObjectLiteralExpression;
 }
 /**
+ * Narrows a node to `DomainPropertyAssignment`.
+ *
  * @since 0.3.16-canary.0
  */
 export function isDomainPropertyAssignment(node) {
     return node.kind === DomainSyntaxKind.PropertyAssignment;
 }
 /**
+ * Narrows a node to `DomainArrayLiteralExpression`.
+ *
  * @since 0.3.16-canary.0
  */
 export function isDomainArrayLiteralExpression(node) {
     return node.kind === DomainSyntaxKind.ArrayLiteralExpression;
 }
 /**
+ * Narrows a node to `DomainSpreadElement`.
+ *
  * @since 0.3.16-canary.0
  */
 export function isDomainSpreadElement(node) {
     return node.kind === DomainSyntaxKind.SpreadElement;
 }
 /**
+ * Narrows a node to `DomainPropertyAccessExpression`.
+ *
  * @since 0.3.16-canary.0
  */
 export function isDomainPropertyAccessExpression(node) {
     return node.kind === DomainSyntaxKind.PropertyAccessExpression;
 }
 /**
+ * Narrows a node to `DomainJsxAttribute`.
+ *
  * @since 0.3.16-canary.0
  */
 export function isDomainJsxAttribute(node) {
     return node.kind === DomainSyntaxKind.JsxAttribute;
 }
 /**
+ * Narrows a node to `DomainJsxExpression`.
+ *
  * @since 0.3.16-canary.0
  */
 export function isDomainJsxExpression(node) {
     return node.kind === DomainSyntaxKind.JsxExpression;
 }
 /**
+ * Visits each direct child of a domain node.
+ *
  * @since 0.3.16-canary.0
  */
 export function forEachDomainChild(node, visit) {
@@ -225,6 +257,8 @@ export function forEachDomainChild(node, visit) {
     }
 }
 /**
+ * Resolves the one-based line number of a position in source text.
+ *
  * @since 0.3.16-canary.0
  */
 export function lineOfSourcePosition(sourceText, pos) {
@@ -236,5 +270,4 @@ export function lineOfSourcePosition(sourceText, pos) {
         }
     }
     return line;
-}
-//# sourceMappingURL=ast-node.js.map
+}

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

@@ -1,6 +1,8 @@
 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.
+ *
  * @since 0.3.16-canary.0
  */
 export function forEachStringLiteralInClassExpression(expr, sink, depth = 0, options) {
@@ -46,18 +48,24 @@ export function forEachStringLiteralInClassExpression(expr, sink, depth = 0, opt
     }
 }
 /**
+ * Checks whether a literal sits directly inside an array literal, where splitting it apart is unsafe.
+ *
  * @since 0.3.16-canary.0
  */
 export function isUnsafeLiteralForCnStyleApplySplit(classLiteral) {
     return classLiteral.parent !== null && isDomainArrayLiteralExpression(classLiteral.parent);
 }
 /**
+ * The walk options for building the `cn` apply pool — conditional branches are never descended into.
+ *
  * @since 0.3.16-canary.0
  */
 export const CN_APPLY_LITERAL_WALK_OPTS = {
     descendIntoConditional: false,
 };
 /**
+ * Collects the static class literals in `cn()` arguments that are safe to regroup.
+ *
  * @since 0.3.16-canary.0
  */
 export function collectUnconditionalTailwindLiteralsFromCnArguments(args) {
@@ -77,5 +85,4 @@ export function collectUnconditionalTailwindLiteralsFromCnArguments(args) {
         }
     }
     return staticLits;
-}
-//# sourceMappingURL=collectors-cn.js.map
+}

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

@@ -1,5 +1,7 @@
 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.
+ *
  * @since 0.3.16-canary.0
  */
 export function jsxClassNameStaticLiteral(jsxClassNameAttribute) {
@@ -20,5 +22,4 @@ export function jsxClassNameStaticLiteral(jsxClassNameAttribute) {
         }
     }
     return undefined;
-}
-//# sourceMappingURL=collectors-jsx.js.map
+}

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

@@ -4,6 +4,8 @@ import { buildKnownCnTvBindings, isCnOrTvIdentifier, propertyAssignmentNameText
 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.
+ *
  * @since 0.3.16-canary.0
  */
 export function traverseTvObject(sourceFile, obj, visitor, depth = 0, knownBindings) {
@@ -82,6 +84,8 @@ export function traverseTvObject(sourceFile, obj, visitor, depth = 0, knownBindi
     }
 }
 /**
+ * Collects the `cn()` calls nested inside a `tv({ ... })` object.
+ *
  * @since 0.3.16-canary.0
  */
 export function collectCnCallsInsideTv(sourceFile, obj, knownBindings, depth = 0) {
@@ -129,6 +133,8 @@ export function collectCnCallsInsideTv(sourceFile, obj, knownBindings, depth = 0
     return calls;
 }
 /**
+ * Collects every `cn()` call nested inside any `tv()` call in a source file.
+ *
  * @since 0.3.16-canary.0
  */
 export function listAllCnCallsInsideTvInSourceFile(sourceFile, knownBindings) {
@@ -163,6 +169,8 @@ function makeStringNode(nodes, sourceFile, isTvContext, cnCall) {
     };
 }
 /**
+ * Joins a slot's literals into one space-separated class string.
+ *
  * @since 0.3.16-canary.0
  */
 export function slotClassString(stringNode) {
@@ -281,6 +289,8 @@ function collectTvSlots(sourceFile, obj, knownBindings, results, seenNodePos, de
     }
 }
 /**
+ * Collects every groupable `cn()` / `tv()` string slot in a source file.
+ *
  * @since 0.3.16-canary.0
  */
 export function collectGroupableStringNodes(sourceFile) {
@@ -315,5 +325,4 @@ export function collectGroupableStringNodes(sourceFile) {
         visitTypeScriptSubtree(stmt);
     }
     return results;
-}
-//# sourceMappingURL=collectors-tv.js.map
+}