@rozie/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dan Krieger and Rozie.js contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# @rozie/cli
+
+The Rozie codegen CLI. Compiles `.rozie` files to per-framework source artifacts (plus `.d.ts` sidecars and optional `.map` files) for libraries that prefer to ship pre-compiled per-framework npm packages rather than rely on a consumer-side build plugin.
+
+## Status
+
+Shipped. The `rozie` binary exposes `build` and `watch` commands across all six targets (`vue`, `react`, `svelte`, `angular`, `solid`, `lit`). Output is byte-identical to the `@rozie/unplugin` and `@rozie/babel-plugin` entrypoints (gated by the `dist-parity` suite). Marked `@experimental` until v1.0.
+
+## Install
+
+Not yet published to npm (current version `0.1.0`; publishing is gated on the public release workflow). Inside the monorepo it is available as the `rozie` bin.
+
+## Usage
+
+```bash
+# Compile a directory to React + Vue, emitting to dist/
+rozie build src/components/ \
+  --target react,vue \
+  --out dist/
+
+# Single file, single target (stdout when --out is omitted and only one of each)
+rozie build src/Counter.rozie --target svelte
+
+# Watch mode (long-running; --out is required)
+rozie watch src/components/ --target react --out dist/
+```
+
+### Flags (`build` and `watch`)
+
+| Flag | Notes |
+| --- | --- |
+| `-t, --target <names>` | Comma-separated list of `vue\|react\|svelte\|angular\|solid\|lit` (default `vue`). |
+| `-o, --out <path>` | Output directory. Required when compiling multiple files or multiple targets (`ROZ852`); required for `target=react` because it emits sidecars (`ROZ855`); always required for `watch` (`ROZ856`). |
+| `--source-map` | Emit `.map` sidecars (off by default). |
+| `--no-types` | Skip `.d.ts` emission (React-only — inline-typed for Vue/Svelte/Angular). |
+| `--pretty` | Format emitted artefacts with Prettier before write (off by default). |
+| `--no-cva` | Angular-only: suppress the auto `ControlValueAccessor` emit on single-`model` components. No-op for other targets. |
+| `--no-safe-interpolation` | Suppress the safe-interpolation `rozieDisplay` wrap (raw per-target emit; re-exposes the React object-child crash on non-primitive interpolation). No-op for Vue. |
+
+## Public exports
+
+- `rozie` binary (`build`, `watch`)
+- Programmatic entry from the package root for embedding the CLI in another tool.
+
+For the build-plugin path (HMR, no pre-compile step), see [`@rozie/unplugin`](../unplugin). For Babel pipelines, see [`@rozie/babel-plugin`](../babel-plugin).
+
+## Links
+
+- Project orientation: [`CLAUDE.md`](../../CLAUDE.md)
+- Feature reference: [`docs/guide/features.md`](../../docs/guide/features.md)
+- Roadmap: [`.planning/ROADMAP.md`](../../.planning/ROADMAP.md)

package/dist/bin.cjs

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+//#region src/bin.ts
+require("./src-CIv3UOaa.cjs").runCli(process.argv).catch((err) => {
+	console.error(err instanceof Error ? err.stack ?? err.message : String(err));
+	process.exit(1);
+});
+//#endregion

package/dist/bin.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { t as runCli } from "./src-WZKv4m5y.mjs";
+//#region src/bin.ts
+runCli(process.argv).catch((err) => {
+	console.error(err instanceof Error ? err.stack ?? err.message : String(err));
+	process.exit(1);
+});
+//#endregion
+export {};

package/dist/index.cjs

@@ -0,0 +1,7 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_src = require("./src-CIv3UOaa.cjs");
+exports.runBuild = require_src.runBuild;
+exports.runBuildMany = require_src.runBuildMany;
+exports.runBuildMatrix = require_src.runBuildMatrix;
+exports.runCli = require_src.runCli;
+exports.runWatch = require_src.runWatch;

package/dist/index.d.cts

@@ -0,0 +1,141 @@
+//#region src/utils/parseTargets.d.ts
+type Target = 'vue' | 'react' | 'svelte' | 'angular' | 'solid' | 'lit';
+//#endregion
+//#region src/commands/build.d.ts
+/**
+ * Legacy single-target options shape — preserved for `runBuild` /
+ * `runBuildMany` backward-compat. New code should use `BuildOptionsExt`.
+ */
+interface BuildOptions {
+  target?: string;
+  out?: string;
+  sourceMap?: boolean;
+}
+/**
+ * Phase 6 multi-target options shape consumed by `runBuildMatrix`.
+ * Commander's `parseTargets` produces `target: Target[]`; programmatic callers
+ * may pass either a single `Target` (e.g., from `runBuild`) or `Target[]`.
+ */
+interface BuildOptionsExt {
+  target?: Target | Target[];
+  out?: string;
+  /** D-91 default false — emit .map sidecars only when explicitly opted in. */
+  sourceMap?: boolean;
+  /** D-90 default true — emit .d.ts sidecars; --no-types maps to false. */
+  types?: boolean;
+  /** Project root used for source-rel-path computation; defaults to process.cwd(). */
+  root?: string;
+  /**
+   * Opt-in: format emitted artefacts through prettier before write.
+   * Off by default per PROJECT.md "Out of Scope" — v1's bar is "just
+   * works", not "pretty output". When ON, applies prettier core to .tsx /
+   * .ts / .d.ts / .vue / .css sidecars, and prettier-plugin-svelte to
+   * .svelte. Source-map sidecars (.map) are never reformatted (spec-
+   * required field ordering). Prettier failures degrade gracefully:
+   * raw output is written and a warning prints to stderr.
+   */
+  pretty?: boolean;
+  /**
+   * Phase 23 — Angular-only opt-out for the auto `ControlValueAccessor` emit.
+   * Default ON (undefined/true): single-model Angular components auto-emit the
+   * CVA shape. `false` maps to `compile({ angular: { cva: false } })` and
+   * suppresses ALL CVA emit. Omitting it entirely exercises the emitter-side
+   * `opts.cva ?? true` default — byte-identical to the unplugin/babel-plugin
+   * default-ON path (dist-parity contract). No-op for non-Angular targets.
+   */
+  cva?: boolean;
+  /**
+   * Phase 26 (D-11) — the GLOBAL safe-interpolation opt-out. Default ON
+   * (undefined/true): non-provably-primitive interpolations are wrapped in the
+   * injected `rozieDisplay` helper on the five non-Vue targets. `false` maps to
+   * `compile({ safeInterpolation: false })` and reverts to raw per-target emit.
+   * Omitting it entirely exercises the lowerer-side `?? true` default —
+   * byte-identical to the unplugin/babel-plugin default-ON path. No-op for Vue.
+   */
+  safeInterpolation?: boolean;
+}
+interface RunBuildContext {
+  /** When 'throw', exits become thrown BuildExit instead of process.exit. */
+  exit?: 'process' | 'throw';
+  /** stderr sink override — defaults to process.stderr.write. */
+  stderrWrite?: (chunk: string) => void;
+  /** stdout sink override — defaults to process.stdout.write. */
+  stdoutWrite?: (chunk: string) => void;
+}
+/**
+ * Phase 6 D-87/D-88/D-89/D-90/D-91/D-93 — the canonical build coordinator.
+ *
+ * @param inputArgs  positional args (files, directories, or globs)
+ * @param opts       parsed options (target list, out, sourceMap, types, root)
+ * @param ctx        test-injection sinks + exit-mode toggle
+ */
+declare function runBuildMatrix(inputArgs: string[], opts?: BuildOptionsExt, ctx?: RunBuildContext): Promise<void>;
+/**
+ * Single-input single-target build — backward-compat thin wrapper around
+ * `runBuildMatrix`. Kept stable for the existing test suite + CLI tests
+ * predating Phase 6.
+ */
+declare function runBuild(input: string, opts?: BuildOptions, ctx?: RunBuildContext): Promise<void>;
+/**
+ * Multi-input single-target build — backward-compat thin wrapper around
+ * `runBuildMatrix`. The original semantics required `--out <dir>` for
+ * multi-input invocations; runBuildMatrix preserves that via the D-89 guard.
+ */
+declare function runBuildMany(inputs: string[], opts?: BuildOptions, ctx?: RunBuildContext): Promise<void>;
+//#endregion
+//#region src/commands/watch.d.ts
+interface WatchOptions {
+  target?: Target | Target[];
+  out?: string;
+  /** D-91 default false. */
+  sourceMap?: boolean;
+  /** D-90 default true. */
+  types?: boolean;
+  /** Project root for source-rel-path computation; defaults to process.cwd(). */
+  root?: string;
+  /**
+   * Off by default per PROJECT.md "Out of Scope" carve-out. Pipes the
+   * per-change emit through prettier before write. Failures degrade
+   * gracefully — raw output still lands on disk + a stderr warning fires.
+   */
+  pretty?: boolean;
+  /**
+   * Phase 23 — Angular-only opt-out for the auto `ControlValueAccessor` emit.
+   * Default ON; `false` maps to `compile({ angular: { cva: false } })`.
+   * Mirrors the `rozie build` flag. No-op for non-Angular targets.
+   */
+  cva?: boolean;
+  /**
+   * Phase 26 (D-11) — the GLOBAL safe-interpolation opt-out. Default ON;
+   * `false` maps to `compile({ safeInterpolation: false })`. Mirrors the
+   * `rozie build` flag. No-op for the Vue target.
+   */
+  safeInterpolation?: boolean;
+}
+interface RunWatchContext {
+  /** When 'throw', invalid-arg exits become thrown errors (vitest-friendly). */
+  exit?: 'process' | 'throw';
+  stderrWrite?: (chunk: string) => void;
+  stdoutWrite?: (chunk: string) => void;
+  /**
+   * Test injection — when this AbortSignal fires, the watcher closes and
+   * runWatch() resolves. Lets vitest drive the lifecycle without sending
+   * real OS signals to the test process.
+   */
+  signal?: AbortSignal;
+}
+/**
+ * `rozie watch <inputs...>` entry point. Performs one initial build of
+ * the matched input set, then watches for changes and recompiles per
+ * file. Resolves on graceful shutdown (SIGINT/SIGTERM or ctx.signal).
+ */
+declare function runWatch(inputArgs: string[], opts?: WatchOptions, ctx?: RunWatchContext): Promise<void>;
+//#endregion
+//#region src/index.d.ts
+/**
+ * Programmatic entry — constructs the commander program and parses argv.
+ * `argv` follows Node's `process.argv` shape (argv[0]=node, argv[1]=script).
+ */
+declare function runCli(argv: readonly string[]): Promise<void>;
+//#endregion
+export { type BuildOptions, type BuildOptionsExt, type WatchOptions, runBuild, runBuildMany, runBuildMatrix, runCli, runWatch };

package/dist/index.d.mts

@@ -0,0 +1,141 @@
+//#region src/utils/parseTargets.d.ts
+type Target = 'vue' | 'react' | 'svelte' | 'angular' | 'solid' | 'lit';
+//#endregion
+//#region src/commands/build.d.ts
+/**
+ * Legacy single-target options shape — preserved for `runBuild` /
+ * `runBuildMany` backward-compat. New code should use `BuildOptionsExt`.
+ */
+interface BuildOptions {
+  target?: string;
+  out?: string;
+  sourceMap?: boolean;
+}
+/**
+ * Phase 6 multi-target options shape consumed by `runBuildMatrix`.
+ * Commander's `parseTargets` produces `target: Target[]`; programmatic callers
+ * may pass either a single `Target` (e.g., from `runBuild`) or `Target[]`.
+ */
+interface BuildOptionsExt {
+  target?: Target | Target[];
+  out?: string;
+  /** D-91 default false — emit .map sidecars only when explicitly opted in. */
+  sourceMap?: boolean;
+  /** D-90 default true — emit .d.ts sidecars; --no-types maps to false. */
+  types?: boolean;
+  /** Project root used for source-rel-path computation; defaults to process.cwd(). */
+  root?: string;
+  /**
+   * Opt-in: format emitted artefacts through prettier before write.
+   * Off by default per PROJECT.md "Out of Scope" — v1's bar is "just
+   * works", not "pretty output". When ON, applies prettier core to .tsx /
+   * .ts / .d.ts / .vue / .css sidecars, and prettier-plugin-svelte to
+   * .svelte. Source-map sidecars (.map) are never reformatted (spec-
+   * required field ordering). Prettier failures degrade gracefully:
+   * raw output is written and a warning prints to stderr.
+   */
+  pretty?: boolean;
+  /**
+   * Phase 23 — Angular-only opt-out for the auto `ControlValueAccessor` emit.
+   * Default ON (undefined/true): single-model Angular components auto-emit the
+   * CVA shape. `false` maps to `compile({ angular: { cva: false } })` and
+   * suppresses ALL CVA emit. Omitting it entirely exercises the emitter-side
+   * `opts.cva ?? true` default — byte-identical to the unplugin/babel-plugin
+   * default-ON path (dist-parity contract). No-op for non-Angular targets.
+   */
+  cva?: boolean;
+  /**
+   * Phase 26 (D-11) — the GLOBAL safe-interpolation opt-out. Default ON
+   * (undefined/true): non-provably-primitive interpolations are wrapped in the
+   * injected `rozieDisplay` helper on the five non-Vue targets. `false` maps to
+   * `compile({ safeInterpolation: false })` and reverts to raw per-target emit.
+   * Omitting it entirely exercises the lowerer-side `?? true` default —
+   * byte-identical to the unplugin/babel-plugin default-ON path. No-op for Vue.
+   */
+  safeInterpolation?: boolean;
+}
+interface RunBuildContext {
+  /** When 'throw', exits become thrown BuildExit instead of process.exit. */
+  exit?: 'process' | 'throw';
+  /** stderr sink override — defaults to process.stderr.write. */
+  stderrWrite?: (chunk: string) => void;
+  /** stdout sink override — defaults to process.stdout.write. */
+  stdoutWrite?: (chunk: string) => void;
+}
+/**
+ * Phase 6 D-87/D-88/D-89/D-90/D-91/D-93 — the canonical build coordinator.
+ *
+ * @param inputArgs  positional args (files, directories, or globs)
+ * @param opts       parsed options (target list, out, sourceMap, types, root)
+ * @param ctx        test-injection sinks + exit-mode toggle
+ */
+declare function runBuildMatrix(inputArgs: string[], opts?: BuildOptionsExt, ctx?: RunBuildContext): Promise<void>;
+/**
+ * Single-input single-target build — backward-compat thin wrapper around
+ * `runBuildMatrix`. Kept stable for the existing test suite + CLI tests
+ * predating Phase 6.
+ */
+declare function runBuild(input: string, opts?: BuildOptions, ctx?: RunBuildContext): Promise<void>;
+/**
+ * Multi-input single-target build — backward-compat thin wrapper around
+ * `runBuildMatrix`. The original semantics required `--out <dir>` for
+ * multi-input invocations; runBuildMatrix preserves that via the D-89 guard.
+ */
+declare function runBuildMany(inputs: string[], opts?: BuildOptions, ctx?: RunBuildContext): Promise<void>;
+//#endregion
+//#region src/commands/watch.d.ts
+interface WatchOptions {
+  target?: Target | Target[];
+  out?: string;
+  /** D-91 default false. */
+  sourceMap?: boolean;
+  /** D-90 default true. */
+  types?: boolean;
+  /** Project root for source-rel-path computation; defaults to process.cwd(). */
+  root?: string;
+  /**
+   * Off by default per PROJECT.md "Out of Scope" carve-out. Pipes the
+   * per-change emit through prettier before write. Failures degrade
+   * gracefully — raw output still lands on disk + a stderr warning fires.
+   */
+  pretty?: boolean;
+  /**
+   * Phase 23 — Angular-only opt-out for the auto `ControlValueAccessor` emit.
+   * Default ON; `false` maps to `compile({ angular: { cva: false } })`.
+   * Mirrors the `rozie build` flag. No-op for non-Angular targets.
+   */
+  cva?: boolean;
+  /**
+   * Phase 26 (D-11) — the GLOBAL safe-interpolation opt-out. Default ON;
+   * `false` maps to `compile({ safeInterpolation: false })`. Mirrors the
+   * `rozie build` flag. No-op for the Vue target.
+   */
+  safeInterpolation?: boolean;
+}
+interface RunWatchContext {
+  /** When 'throw', invalid-arg exits become thrown errors (vitest-friendly). */
+  exit?: 'process' | 'throw';
+  stderrWrite?: (chunk: string) => void;
+  stdoutWrite?: (chunk: string) => void;
+  /**
+   * Test injection — when this AbortSignal fires, the watcher closes and
+   * runWatch() resolves. Lets vitest drive the lifecycle without sending
+   * real OS signals to the test process.
+   */
+  signal?: AbortSignal;
+}
+/**
+ * `rozie watch <inputs...>` entry point. Performs one initial build of
+ * the matched input set, then watches for changes and recompiles per
+ * file. Resolves on graceful shutdown (SIGINT/SIGTERM or ctx.signal).
+ */
+declare function runWatch(inputArgs: string[], opts?: WatchOptions, ctx?: RunWatchContext): Promise<void>;
+//#endregion
+//#region src/index.d.ts
+/**
+ * Programmatic entry — constructs the commander program and parses argv.
+ * `argv` follows Node's `process.argv` shape (argv[0]=node, argv[1]=script).
+ */
+declare function runCli(argv: readonly string[]): Promise<void>;
+//#endregion
+export { type BuildOptions, type BuildOptionsExt, type WatchOptions, runBuild, runBuildMany, runBuildMatrix, runCli, runWatch };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { a as runBuildMatrix, i as runBuildMany, n as runWatch, r as runBuild, t as runCli } from "./src-WZKv4m5y.mjs";
+export { runBuild, runBuildMany, runBuildMatrix, runCli, runWatch };