cronus-ui 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cronus
+
+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,90 @@
+# cronus-ui (CLI)
+
+Add Cronus UI to a project: copy components in, compose an app from validated
+blocks, switch theme, and upgrade without losing local edits.
+
+```sh
+npx cronus-ui init
+npx cronus-ui add button card
+npx cronus-ui compose saas --brand Acme
+npx cronus-ui add-page --route /faq --blocks faq,cta --nav FAQ
+npx cronus-ui theme set aurora --mode dark
+npx cronus-ui upgrade --all --dry-run
+npx cronus-ui list
+npx cronus-ui diff
+npx cronus-ui ai
+```
+
+The canonical product start is `npx create-cronus-app my-app --template saas`,
+which scaffolds and then composes. This CLI is what that path calls, and what
+you keep using after.
+
+## Commands & flags
+
+| Command | Args | Flags |
+| --- | --- | --- |
+| `init` | — | `-c, --cwd <dir>` · `-r, --registry <source>` · `-y, --yes` · `--skip-install` |
+| `add` | `[components...]` | `-c, --cwd <dir>` · `-r, --registry <source>` · `-o, --overwrite` · `--skip-install` |
+| `compose` | `[template]` | `-c, --cwd <dir>` · `-r, --registry <source>` · `-m, --manifest <file>` · `--pages <list>` · `--variant <pair...>` · `-b, --brand <name>` · `-s, --seed <n>` · `-o, --overwrite` · `--skip-install` · `--dry-run` · `-y, --yes` |
+| `add-page` | — | `--route <route>` (required) · `--blocks <list>` (required) · `-c, --cwd <dir>` · `-r, --registry <source>` · `--chrome <group>` · `--title <title>` · `--nav <label>` · `--app <name>` · `-m, --manifest <file>` · `-o, --overwrite` · `--skip-install` · `--dry-run` |
+| `list` (`ls`) | — | `-c, --cwd <dir>` · `-r, --registry <source>` |
+| `diff` | `[components...]` | `-c, --cwd <dir>` · `-r, --registry <source>` |
+| `upgrade` | `[components...]` | `-c, --cwd <dir>` · `-r, --registry <source>` · `-a, --all` · `--dry-run` · `-y, --yes` · `-o, --overwrite` |
+| `theme set` | `<name>` | `-m, --mode <mode>` · `-c, --cwd <dir>` |
+| `theme add` | `<source>` | `-c, --cwd <dir>` · `--css <file>` · `--dry-run` |
+| `ai` | — | `-c, --cwd <dir>` · `-a, --assistants <list>` · `-p, --preset <name>` · `-s, --skills <list>` |
+
+Notes that match the commander surface:
+
+- `compose [template]` — bundled names include `store`, `landing`, `saas`. `--pages` is a comma-separated route subset (e.g. `/,products,login`). `--variant` is repeatable (`login=split`). `--dry-run` prints the validated plan and writes nothing. `-y` picks the first template when none is given.
+- `add-page` grows an already-composed app. `--blocks` is comma-separated (`faq,cta` or `login=split`). `--app` is required when the project has more than one composed app.
+- `theme set <name>` — `aurora`, `neutral`, `midnight`, `sunset`, `emerald`. `--mode` is `dark` or `light`.
+- `theme add <source>` — a Create Studio permalink, a bare `c=` payload, or a path to an exported theme JSON file.
+- `upgrade` 3-way merges each installed file against the release recorded in `cronus-ui.json`. `-a, --all` upgrades every recorded component and 3-way-merges composed pages/layouts against `.cronus-ui/base`. `-o, --overwrite` replaces files installed before the manifest existed. Unresolved files get a prompt in `CRONUS-UPGRADE.md`.
+- `ai --assistants` is comma-separated `claude`, `cursor`, `copilot`, `windsurf`, `gemini` (or `all` / `none`). `--preset` is `standard` (default), `fintech`, `saas`, `oss`, `agency`, or `none`. `--skills` is comma-separated Claude Code skills (or `all` / `none`).
+
+## How it works
+
+- The registry (`registry/*.json`) is generated from the real `@cronus-ui/ui` sources by
+  `packages/cli/scripts/build-registry.ts` — each item carries its source, its npm
+  `dependencies`, and its `registryDependencies` (other components it imports),
+  derived by parsing imports.
+- The default registry is pinned to the CLI package version (`v0.6.0` here), not
+  mutable `main`, so a published CLI reads the registry snapshot it was released
+  with. Use `-r, --registry ./registry` when testing local registry changes before
+  a release tag exists.
+- `init` installs only the base copy dependencies used by generated components
+  (`clsx`, `tailwind-merge`, `class-variance-authority`, and Radix Slot). It does
+  not install the public Cronus token and theme packages unless you add them
+  separately for runtime theming.
+- `add` resolves the transitive closure of `registryDependencies`, writes the files
+  into your project, and **rewrites imports to your aliases**:
+  `../lib/cn.js → @/lib/cn`, `./button.js → @/components/ui/button`.
+- It then installs the collected npm dependencies with your package manager
+  (bun / pnpm / yarn / npm, auto-detected).
+- `compose` generates pages that are only imports of installed blocks plus a
+  `<main>` that stacks them. Visible UI comes from registry items, not from
+  composer-emitted JSX.
+
+## Config (`cronus-ui.json`)
+
+```json
+{
+  "aliases": {
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "blocks": "@/components/blocks"
+  },
+  "paths": {
+    "ui": "components/ui",
+    "lib": "lib",
+    "blocks": "components/blocks"
+  },
+  "registry": "https://raw.githubusercontent.com/pedrogbraz/cronus-ui/v0.6.0/registry"
+}
+```
+
+Point `-r, --registry <path-or-url>` at a local `registry/` directory for offline use
+or testing. Regenerate the registry after changing components:
+`bun run -F cronus-ui registry`. Verify it is in sync locally with
+`bun run -F cronus-ui registry:check`.

package/dist/commands/add-page.d.ts

@@ -0,0 +1,108 @@
+/**
+ * `cronus-ui add-page` — incrementally add ONE page to an already-composed app
+ * (D3 graft, F2). It reuses the exact compose plan/render/install core: it
+ * reconstructs the app's manifest (chrome + already-composed pages), appends the
+ * new page, re-plans + re-validates the WHOLE app (so the new page's chrome ref,
+ * route uniqueness, and block kinds are checked against the real chrome and its
+ * siblings), then applies ONLY the incremental delta:
+ *   - install any new blocks the page needs (unchanged install core);
+ *   - write the new page.tsx (+ its layout/chrome wrappers when the page uses a
+ *     chrome group the app did not have yet);
+ *   - RE-INJECT the affected chrome block's nav data-slot so the new `--nav`
+ *     entry appears in the navbar/footer/sidebar;
+ *   - grow `composed{}.choices.pages` + `composed{}.files` (union) + the base
+ *     snapshot for the new/rewritten files.
+ *
+ * It never re-writes untouched sibling pages (their bytes are unchanged), and it
+ * fails loud when there is no composed app, the app cannot be reloaded, or the
+ * route collides (unless `--overwrite`). Determinism + the golden rule are
+ * inherited wholesale from the shared renderer.
+ */
+import { type BlockRef } from "../compose/manifest.js";
+/** Options accepted by the addPage library entry + the CLI command. */
+export interface AddPageOptions {
+    /** Project root (must contain cronus-ui.json with a composed app). */
+    targetDir: string;
+    /** New route to add, e.g. "/faq". */
+    route: string;
+    /** Block refs stacked in the page (strings or `{ block, variant }`). */
+    blocks: BlockRef[];
+    /** Chrome group key for the page; defaults to the app's first chrome group. */
+    chrome?: string;
+    /** <title> for the page; defaults to a Title-Cased slug from the route. */
+    title?: string;
+    /** Nav label; when set the page joins the chrome nav (data-slot re-injected). */
+    nav?: string;
+    /** Which composed app to extend (its `composed{}` key); required if >1 exists. */
+    app?: string;
+    /** Reload the manifest from this file instead of a bundled template. */
+    manifestPath?: string;
+    /** Overwrite an existing page file at the route (default false). */
+    overwrite?: boolean;
+    /** Skip the npm install step (default false). */
+    skipInstall?: boolean;
+    /** Override the registry source (else the project config's). */
+    registry?: string;
+}
+/** Result of a successful add-page (for programmatic callers / tests). */
+export interface AddPageResult {
+    /** The composed app the page was added to (the `composed{}` key). */
+    appName: string;
+    /** The added route. */
+    route: string;
+    /** Files freshly written (new page, any new layout/wrapper, rewritten chrome). */
+    generatedFiles: string[];
+    /** Files skipped (already existed, no --overwrite). */
+    skippedFiles: string[];
+    /** Registry block items newly installed for the page. */
+    installedBlocks: string[];
+}
+/**
+ * Add one page to an already-composed app. Reloads the manifest, appends the new
+ * page, re-plans + re-validates the whole app, then writes ONLY the incremental
+ * delta (new page + any new layout/wrapper + the re-injected chrome nav) and
+ * grows `composed{}` + the base snapshot. Throws {@link ComposePlanError} /
+ * {@link Error} on invalid input.
+ */
+export declare function addPage(options: AddPageOptions): Promise<AddPageResult>;
+/** CLI-facing options (flags parsed by commander in index.ts). */
+export interface AddPageCommandOptions {
+    cwd: string;
+    route?: string;
+    blocks?: string;
+    chrome?: string;
+    title?: string;
+    nav?: string;
+    app?: string;
+    manifest?: string;
+    overwrite?: boolean;
+    skipInstall?: boolean;
+    dryRun?: boolean;
+    registry?: string;
+}
+/**
+ * Parse the `--blocks hero,cta` / `--blocks login=split,cta` spec into block refs.
+ * A `slug=variant` token becomes `{ block, variant }`; a bare token stays a string
+ * (default variant). Empty tokens are dropped; an empty spec throws.
+ */
+export declare function parseBlockRefs(spec: string | undefined): BlockRef[];
+/**
+ * The `cronus-ui add-page` command: adds ONE page to a composed app, or previews
+ * it with `--dry-run` (writes nothing). Aggregated plan errors are printed as a
+ * list, like `compose`.
+ */
+export declare function addPageCommand(options: AddPageCommandOptions): Promise<void>;
+/** A dry-run preview of an add-page: the files it would write + blocks it would install. */
+export interface AddPagePreview {
+    appName: string;
+    route: string;
+    wouldWrite: string[];
+    wouldInstall: string[];
+}
+/**
+ * Plan the add-page (validating everything) and return the files it WOULD write
+ * and blocks it WOULD install, without touching the filesystem. Reuses the same
+ * reload + synthesize + plan path as {@link addPage}.
+ */
+export declare function previewAddPage(options: Omit<AddPageOptions, "skipInstall">): Promise<AddPagePreview>;
+//# sourceMappingURL=add-page.d.ts.map