@codefast/cli 0.8.0 → 0.9.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 CodeFast Labs
+Copyright (c) 2024 Codefast Labs
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,19 +1,31 @@
 # @codefast/cli
 
-Developer CLI for the [Codefast monorepo](https://github.com/codefastlabs/codefast) — `arrange` Tailwind class strings,
-`audit` source conventions (RTL, markdown links, comment dividers, React imports), `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` slims the publish artifact down to what a consumer reads, 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.js first
@@ -32,8 +44,11 @@ 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 cli:audit:display-names    # codefast audit display-names
 ```
 
+`pnpm run version-packages` runs `changeset version` and then `codefast tag`, so published APIs are stamped at release.
+
 Standalone install (Node >= 24):
 
 ```bash
@@ -42,15 +57,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
@@ -58,8 +76,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                                                                   |
 | -------------------- | ----------------------------------------------------------------------------- |
@@ -68,6 +87,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`.
@@ -94,9 +115,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
@@ -112,6 +134,36 @@ codefast mirror --dry-run       # report changes without writing
 
 Exits `1` when any package fails, `0` otherwise.
 
+## `pack-slim`
+
+Slims published packages down to what a consumer's `tsc` and Node read, so the npm tarball ships `dist` runtime and
+types only and its `package.json` describes nothing else. Where `mirror` writes the full exports — including the
+`source` condition — for repo dev, `pack-slim` removes the development lane for publish: it drops `src` from `files`,
+every `source` condition from `exports`/`imports`, every `imports` entry left pointing outside `files` (the `#/tests/*`
+and `#/examples/*` aliases), every script that is not an install or publish lifecycle hook, `devDependencies`, 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
@@ -128,16 +180,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
@@ -149,14 +202,16 @@ 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
+## `audit comments`
 
-Scans source doc comments for the repo's comment conventions — chiefly section dividers that are not in the one allowed
-form. Everything it reports is mechanical, so `--fix` rewrites every fixable divider in place and a red run is one
-`--fix` from green. Exits non-zero when unfixable issues remain so it can gate CI.
+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
@@ -165,21 +220,24 @@ 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 (suppresses human progress). |
+| 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 the sneakiest variant — an implicit `React.*` UMD-global type
-reference (`e: React.FormEvent` with no import), which both `tsc` and the linter accept silently through the
-`export as namespace React` declaration in `@types/react`. Exits non-zero when violations remain so it can gate CI.
+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 apps/web/src           # explicit target
 codefast audit react --json                # machine-readable summary
 ```
 
@@ -187,14 +245,37 @@ codefast audit react --json                # machine-readable summary
 | -------- | --------------------------------- |
 | `--json` | Print one JSON summary on stdout. |
 
-Configure intentional exceptions via `audit.react.allowlist` in `codefast.config` — each entry is the offending source
-text as written or `repo/relative/path.tsx:<text>`.
+Configure intentional exceptions via `audit.react.allowlist` — each entry is the offending source text as written or
+`repo/relative/path.tsx:<text>`.
+
+## `audit display-names`
+
+Read-only scan enforcing the display-name convention for every string a `token()`, `tag()` or module factory takes: a
+name is spelled like the TS symbol it stands for, under its owner's namespace — `<namespace>:<Name>`. The namespace is a
+kebab-case package, app or feature slug (or a scoped package name); a token or module name is PascalCase, because it
+stands for a type or a unit of composition; a tag key is camelCase, because it names an attribute. Scans TypeScript and
+markdown alike, since a doc sample is what a reader copies; skips `tests/`, `benchmarks/`, `.changeset/` and
+`CHANGELOG.md`, where a name is scoped by its file or quoted as it was. Exits non-zero when violations remain so it can
+gate CI.
+
+```bash
+codefast audit display-names                      # whole repo
+codefast audit display-names packages/di/examples  # explicit target
+codefast audit display-names --json               # machine-readable summary
+```
+
+| Flag     | Description                       |
+| -------- | --------------------------------- |
+| `--json` | Print one JSON summary on stdout. |
+
+Configure intentional exceptions via `audit.displayNames.allowlist` — each entry is the call as written, through its
+closing quote (or parenthesis when the name is the only argument), or `repo/relative/path.ts:<call>`.
 
 ## `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
@@ -207,15 +288,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
@@ -226,8 +309,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 }
@@ -236,7 +320,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: {
@@ -250,12 +334,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
 
@@ -263,8 +350,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

@@ -23,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

@@ -31,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

@@ -168,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

@@ -120,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

@@ -270,5 +270,4 @@ export function lineOfSourcePosition(sourceText, pos) {
         }
     }
     return line;
-}
-//# sourceMappingURL=ast-node.js.map
+}

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

@@ -85,5 +85,4 @@ export function collectUnconditionalTailwindLiteralsFromCnArguments(args) {
         }
     }
     return staticLits;
-}
-//# sourceMappingURL=collectors-cn.js.map
+}

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

@@ -22,5 +22,4 @@ export function jsxClassNameStaticLiteral(jsxClassNameAttribute) {
         }
     }
     return undefined;
-}
-//# sourceMappingURL=collectors-jsx.js.map
+}

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

@@ -325,5 +325,4 @@ export function collectGroupableStringNodes(sourceFile) {
         visitTypeScriptSubtree(stmt);
     }
     return results;
-}
-//# sourceMappingURL=collectors-tv.js.map
+}

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

@@ -151,5 +151,4 @@ export function unwrapCnInsideTvCallReplacement(call, sourceText) {
     }
     lines.push(`${baseIndent}]`);
     return lines.join("\n");
-}
-//# sourceMappingURL=helpers.js.map
+}

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

@@ -153,5 +153,4 @@ export function collectSimplifyTargets(sourceFile) {
         visitNode(stmt);
     }
     return results;
-}
-//# sourceMappingURL=simplify-targets.js.map
+}

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

@@ -184,5 +184,4 @@ export function planGroupEditForTarget(target, textAfterUnwrap, withClassName) {
         reportNode: target.item.primaryClassLiteral,
         label: target.item.isTvContext ? "tv" : "cn",
     };
-}
-//# sourceMappingURL=targets.js.map
+}

package/dist/arrange/domain/constants.js

@@ -221,5 +221,4 @@ export const STATE_PREFIXES = new Set([
     "backdrop",
     "details-content",
     "popover-open",
-]);
-//# sourceMappingURL=constants.js.map
+]);

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

@@ -138,5 +138,4 @@ export function countPersistedGroupFileEdits(work) {
  */
 export function groupFileWorkHasNothingToReport(work) {
     return work.editSitesCount === 0 && work.cnInTvNoReplacement === 0;
-}
-//# sourceMappingURL=grouping-service.js.map
+}

package/dist/arrange/domain/grouping.js

@@ -433,5 +433,4 @@ export function summarizeGroupBucketLabels(groups) {
         }
         return onlyBucket;
     });
-}
-//# sourceMappingURL=grouping.js.map
+}

package/dist/arrange/domain/imports.js

@@ -158,5 +158,4 @@ export function ensureCnImport(sourceFile, cnImportOverride) {
         insertAt = 0;
     }
     return `${sourceText.slice(0, insertAt)}${importLine}\n${sourceText.slice(insertAt)}`;
-}
-//# sourceMappingURL=imports.js.map
+}

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

@@ -104,5 +104,4 @@ export function formatJsxCnAttributeValue(groups, source, valueNodeStart) {
         commaAfterLastGroup: groups.length > 1,
     });
     return `{cn(\n${cnArgumentsBlock}\n${baseIndent})}`;
-}
-//# sourceMappingURL=source-text-formatters.js.map
+}

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

@@ -50,5 +50,4 @@ export function stripVariants(token) {
         withoutVariants = withoutVariants.slice(colonIdx + 1);
     }
     return withoutVariants;
-}
-//# sourceMappingURL=tailwind-token.js.map
+}

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

@@ -448,5 +448,4 @@ export function bucketsMergeCompatible(a, b) {
         return false;
     }
     return bucketsCompatible(a, b);
-}
-//# sourceMappingURL=token-classifier.js.map
+}

package/dist/arrange/domain/types.js

@@ -7,5 +7,4 @@
  *
  * `arbitrary` and `other` are non-pipeline tails for `[prop:value]` syntax and unknown utilities.
  */
-export {};
-//# sourceMappingURL=types.js.map
+export {};

package/dist/arrange/output.js

@@ -124,5 +124,4 @@ function printGroupFilePreviewBody(args) {
         logger.out(`  ${plan.replacement.split("\n").join("\n  ")}`);
         logger.out(`  // Buckets: ${JSON.stringify(plan.bucketSummary)}`);
     }
-}
-//# sourceMappingURL=output.js.map
+}

package/dist/arrange/process-file.js

@@ -42,5 +42,4 @@ export function processArrangeGroupFile(fs, args) {
         totalFound: persistedEditCount + work.cnInTvNoReplacement,
         changed: persistedEditCount,
     };
-}
-//# sourceMappingURL=process-file.js.map
+}

package/dist/arrange/resolve-target.js

@@ -31,5 +31,4 @@ function findNearestPackageDirectory(fs, currentWorkingDirectory) {
         }
         currentDir = parentDirectory;
     }
-}
-//# sourceMappingURL=resolve-target.js.map
+}

package/dist/arrange/scan-target.js

@@ -28,5 +28,4 @@ export function scanArrangeTargets(fs, targetPath) {
         }
     }
     return [resolvedTargetPath];
-}
-//# sourceMappingURL=scan-target.js.map
+}

package/dist/arrange/simplify-process-file.js

@@ -27,5 +27,4 @@ export function processArrangeSimplifyFile(fs, args) {
     }
     fs.writeFileSync(filePath, textAfterImportDrop, "utf8");
     return { filePath, totalFound, changed: totalFound };
-}
-//# sourceMappingURL=simplify-process-file.js.map
+}

package/dist/arrange/simplify-sync.js

@@ -27,5 +27,4 @@ export async function runArrangeSimplify(fs, args) {
         hookError: null,
         previewPlans: [],
     });
-}
-//# sourceMappingURL=simplify-sync.js.map
+}

package/dist/arrange/source-parse.js

@@ -15,5 +15,4 @@ export function parseDomainSourceFile(filePath, sourceText) {
         logger.err(`[domain-source-parser] ${messageFrom(caughtError)}`);
         throw caughtError;
     }
-}
-//# sourceMappingURL=source-parse.js.map
+}

package/dist/arrange/suggest.js

@@ -12,5 +12,4 @@ export function suggestCnGroupsFromCli(request) {
         : formatCnCall(groups, { trailingClassName: request.trailingClassName });
     const bucketsCommentLine = `// Buckets: ${JSON.stringify(summarizeGroupBucketLabels(groups))}`;
     return { primaryLine, bucketsCommentLine };
-}
-//# sourceMappingURL=suggest.js.map
+}

package/dist/arrange/sync.js

@@ -46,5 +46,4 @@ export async function runArrangeSync(fs, request) {
         ? await runOnAfterWriteHook(arrangeConfig?.onAfterWrite, modifiedFiles)
         : null;
     return ok({ filePaths, modifiedFiles, totalFound, totalChanged, hookError, previewPlans });
-}
-//# sourceMappingURL=sync.js.map
+}

package/dist/arrange/typescript-ast-translator.js

@@ -453,5 +453,4 @@ export class TypeScriptAstTranslator {
             statements,
         };
     }
-}
-//# sourceMappingURL=typescript-ast-translator.js.map
+}

package/dist/arrange/workspace.js

@@ -29,5 +29,4 @@ export async function prepareArrangeWorkspace(fs, args) {
         return loadedOutcome;
     }
     return ok({ resolvedTarget, rootDir, config: loadedOutcome.value.config });
-}
-//# sourceMappingURL=workspace.js.map
+}

package/dist/audit/cli-schema.js

@@ -45,6 +45,17 @@ export const reactAuditRunRequestSchema = z.object({
     allowlist: z.array(z.string()).optional(),
     json: z.boolean(),
 });
+/**
+ * Zod schema for {@link DisplayNameAuditRunRequest}.
+ *
+ * @since 0.9.0
+ */
+export const displayNameAuditRunRequestSchema = z.object({
+    rootDir: z.string().min(1),
+    targetPath: z.string().min(1),
+    allowlist: z.array(z.string()).optional(),
+    json: z.boolean(),
+});
 /**
  * Resolves a path that may be absolute or relative to `rootDir`.
  *
@@ -52,5 +63,4 @@ export const reactAuditRunRequestSchema = z.object({
  */
 export function resolveRepoRelativePath(rootDir, maybeRelative) {
     return path.isAbsolute(maybeRelative) ? path.resolve(maybeRelative) : path.resolve(rootDir, maybeRelative);
-}
-//# sourceMappingURL=cli-schema.js.map
+}