@cronus-ui/stack 0.6.0

package/dist/schema.js

@@ -0,0 +1,133 @@
+import { catalog } from "./catalog.js";
+import { STACK_BUILDER_GENERATOR, STACK_CREATE_ALIAS, STACK_CREATE_PACKAGE } from "./constants.js";
+export const STACK_SCHEMA_VERSION = 1;
+export const STACK_SCHEMA_ID = "https://cronus.dev/schema/stack-1.json";
+export const STACK_GENERATOR_PACKAGE = STACK_CREATE_PACKAGE;
+export const STACK_BUILDER_METADATA = {
+    name: "Cronus Stack Builder",
+    statusLabel: "Stable",
+    route: "/stack",
+    docsRoute: "/docs/stack-builder",
+    schemaId: STACK_SCHEMA_ID,
+    schemaVersion: STACK_SCHEMA_VERSION,
+    generatorPackage: STACK_GENERATOR_PACKAGE,
+    generatorCreateAlias: STACK_CREATE_ALIAS,
+    generatorPackageExistsInRepo: true,
+    generatorTruth: "This repository ships create-cronus-stack; bun create cronus-stack@latest resolves to that generator package after publish.",
+    artifacts: ["Scaffolding command", "KICKOFF.md", "stack.json"],
+};
+function categorySchema(category) {
+    if (category.kind === "toggle") {
+        return {
+            type: "boolean",
+            description: category.description ?? category.title,
+        };
+    }
+    const optionIds = category.options.map((option) => option.id);
+    if (category.kind === "multi") {
+        return {
+            type: "array",
+            description: category.description ?? category.title,
+            uniqueItems: true,
+            items: {
+                type: "string",
+                enum: optionIds,
+            },
+        };
+    }
+    return {
+        type: "string",
+        description: category.description ?? category.title,
+        enum: optionIds,
+    };
+}
+const stackProperties = Object.fromEntries(catalog.map((category) => [category.id, categorySchema(category)]));
+export const STACK_SCHEMA = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: STACK_SCHEMA_ID,
+    title: "Cronus Stack Builder snapshot",
+    description: "A machine-readable snapshot emitted by the Cronus Stack Builder.",
+    type: "object",
+    additionalProperties: false,
+    required: ["$schema", "version", "name", "generator", "stack"],
+    properties: {
+        $schema: {
+            const: STACK_SCHEMA_ID,
+            description: "Schema identifier for this Stack Builder snapshot.",
+        },
+        version: {
+            const: STACK_SCHEMA_VERSION,
+            description: "Schema version for the emitted stack.json file.",
+        },
+        name: {
+            type: "string",
+            pattern: "^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$",
+            description: "Sanitized project slug.",
+        },
+        generator: {
+            const: STACK_BUILDER_GENERATOR,
+            description: "The product surface that emitted this snapshot.",
+        },
+        stack: {
+            type: "object",
+            additionalProperties: false,
+            required: catalog.map((category) => category.id),
+            properties: stackProperties,
+        },
+    },
+};
+export const STACK_SCHEMA_EXAMPLE = {
+    $schema: STACK_SCHEMA_ID,
+    version: STACK_SCHEMA_VERSION,
+    name: "my-cronus-app",
+    generator: STACK_BUILDER_GENERATOR,
+    stack: {
+        web: "web-next",
+        backend: "backend-none",
+        runtime: "runtime-bun",
+        api: "api-none",
+        database: "db-none",
+        orm: "orm-none",
+        dbSetup: "dbsetup-basic",
+        auth: "auth-none",
+        payments: "pay-none",
+        ui: "ui-cronus",
+        assistants: ["ai-claude-code"],
+        mcp: [],
+        skills: [],
+        vibe: false,
+        deploy: "deploy-none",
+        packageManager: "pm-bun",
+        addons: [],
+        naming: "naming-kebab",
+        structure: "structure-src",
+        importAlias: "import-alias",
+        commitStyle: "commit-conventional",
+        tsStrict: "ts-strict",
+        git: true,
+        install: true,
+    },
+};
+export const STACK_SCHEMA_FIELD_SUMMARY = [
+    {
+        field: "$schema",
+        description: "Pins the snapshot to the current Stack Builder schema.",
+    },
+    {
+        field: "version",
+        description: "Version number for migrations when the snapshot contract changes.",
+    },
+    {
+        field: "name",
+        description: "Sanitized project slug used by the preview command and kickoff docs.",
+    },
+    {
+        field: "generator",
+        description: `Always ${STACK_BUILDER_GENERATOR} for artifacts emitted by this builder.`,
+    },
+    {
+        field: "stack",
+        description: "Resolved category selections after all requires, conflicts, and defaults apply.",
+    },
+];
+//# sourceMappingURL=schema.js.map

package/dist/types.d.ts

@@ -0,0 +1,128 @@
+/**
+ * The Cronus Stack Builder model — a Better-T-Stack-class stack configurator.
+ *
+ * The whole builder is driven by a single declarative {@link Catalog}: a list of
+ * {@link Category}, each holding {@link Option}s that wire up to each other via
+ * `requires` / `conflicts` / `implies` / `recommends`. The pure resolver in
+ * `engine.ts` turns a {@link Selection} (what the user picked) into a fully
+ * resolved, valid {@link StackConfig} plus per-option availability.
+ *
+ * Option ids are GLOBALLY UNIQUE (e.g. "db-none", "orm-drizzle", "web-next") so
+ * cross-category constraints can reference them directly.
+ */
+/** A short status flag rendered as a pill on an option. */
+export type Badge = "beta" | "new" | "experimental" | "gated";
+/**
+ * How a category is selected:
+ *  - "single": exactly one option id (radio).
+ *  - "multi":  zero or more option ids (checkboxes).
+ *  - "toggle": a boolean (on/off switch).
+ */
+export type CategoryKind = "single" | "multi" | "toggle";
+/** A single choice inside a category. */
+export interface Option {
+    /** Globally unique id, e.g. "orm-drizzle". */
+    id: string;
+    /** Human label, e.g. "Drizzle". */
+    name: string;
+    /** One-line description shown under the label. */
+    description: string;
+    /** Optional lucide-react icon name, e.g. "database". */
+    icon?: string;
+    /** Optional status pill. */
+    badge?: Badge;
+    /** Option ids that must ALL be selected for this option to be available. */
+    requires?: string[];
+    /** Option ids that, if any is selected, make this option unavailable. */
+    conflicts?: string[];
+    /** Option ids auto-selected when this option is selected. */
+    implies?: string[];
+    /** Option ids surfaced as soft suggestions (no hard effect on validity). */
+    recommends?: string[];
+}
+/** A group of related options (one builder row / column). */
+export interface Category {
+    /** Stable category id, e.g. "orm". Also the {@link Selection} key. */
+    id: string;
+    /** Human title, e.g. "ORM". */
+    title: string;
+    /** One-line description of what the category controls. */
+    description?: string;
+    /** Selection semantics. */
+    kind: CategoryKind;
+    /** The options (for "toggle" categories this is empty / ignored). */
+    options: Option[];
+    /**
+     * When true a "single" category may resolve to no selection (rare). Most
+     * single categories always hold a value (their default).
+     */
+    optional?: boolean;
+    /**
+     * The builder section this category is displayed under, e.g. "Framework",
+     * "Data", "Conventions". Categories with the same group render together beneath
+     * one section header, in catalog order.
+     */
+    group?: string;
+    /**
+     * Render style for a "single" category:
+     *  - "cards" (default): the icon-card grid — for choices that benefit from an
+     *    icon + description (frameworks, databases, …).
+     *  - "segmented": a compact inline pill row — for simple, self-evident choices
+     *    (naming convention, directory layout, …) where a big card would be noise.
+     */
+    layout?: "cards" | "segmented";
+}
+/** The full, ordered taxonomy. */
+export type Catalog = Category[];
+/**
+ * Raw user selection keyed by category id.
+ *  - "single" -> option id string.
+ *  - "multi"  -> array of option ids.
+ *  - "toggle" -> boolean.
+ */
+export type Selection = Record<string, string | string[] | boolean>;
+/**
+ * A fully resolved stack — the canonical config consumed by `kickoff.ts`.
+ * Same shape as {@link Selection} but guaranteed valid and complete (every
+ * single/toggle category present, every value available).
+ */
+export type StackConfig = Selection;
+/** Resolution metadata for one option in one category. */
+export interface ResolvedOption {
+    /** The underlying option definition. */
+    option: Option;
+    /** Whether the option may currently be selected. */
+    available: boolean;
+    /** Short, human reason it is unavailable (only set when `available` is false). */
+    reason?: string;
+    /** Whether this option is currently selected. */
+    selected: boolean;
+}
+/** Resolved state for one category. */
+export interface ResolvedCategory {
+    category: Category;
+    options: ResolvedOption[];
+    /** The resolved value (string | string[] | boolean) for this category. */
+    value: string | string[] | boolean;
+}
+/** A validation note attached to the resolved stack. */
+export interface ResolutionIssue {
+    /** Category the issue belongs to. */
+    categoryId: string;
+    /** Severity: "error" blocks validity; "info" is advisory. */
+    level: "error" | "info";
+    /** Human message. */
+    message: string;
+}
+/** The complete output of `resolve()`. */
+export interface Resolution {
+    /** The (auto-corrected) selection used to produce this resolution. */
+    selection: Selection;
+    /** Per-category resolved state, keyed by category id. */
+    categories: Record<string, ResolvedCategory>;
+    /** True when there are no "error"-level issues. */
+    valid: boolean;
+    /** All issues found during resolution. */
+    issues: ResolutionIssue[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -0,0 +1,14 @@
+/**
+ * The Cronus Stack Builder model — a Better-T-Stack-class stack configurator.
+ *
+ * The whole builder is driven by a single declarative {@link Catalog}: a list of
+ * {@link Category}, each holding {@link Option}s that wire up to each other via
+ * `requires` / `conflicts` / `implies` / `recommends`. The pure resolver in
+ * `engine.ts` turns a {@link Selection} (what the user picked) into a fully
+ * resolved, valid {@link StackConfig} plus per-option availability.
+ *
+ * Option ids are GLOBALLY UNIQUE (e.g. "db-none", "orm-drizzle", "web-next") so
+ * cross-category constraints can reference them directly.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@cronus-ui/stack",
+  "version": "0.6.0",
+  "description": "Cronus Stack Builder core — catalog, resolver, CLI flags, KICKOFF.md and stack.json artifacts.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Cronus",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pedrogbraz/cronus-ui.git",
+    "directory": "packages/stack"
+  },
+  "homepage": "https://aicronus.com",
+  "bugs": {
+    "url": "https://github.com/pedrogbraz/cronus-ui/issues"
+  },
+  "keywords": [
+    "cronus",
+    "stack",
+    "scaffold",
+    "kickoff",
+    "design-system",
+    "typescript"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./catalog": {
+      "types": "./dist/catalog.d.ts",
+      "import": "./dist/catalog.js"
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js"
+    },
+    "./constants": {
+      "types": "./dist/constants.d.ts",
+      "import": "./dist/constants.js"
+    },
+    "./engine": {
+      "types": "./dist/engine.d.ts",
+      "import": "./dist/engine.js"
+    },
+    "./kickoff": {
+      "types": "./dist/kickoff.d.ts",
+      "import": "./dist/kickoff.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "import": "./dist/schema.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "!dist/**/*.map"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --config vitest.config.ts",
+    "prepublishOnly": "tsc -p tsconfig.json"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}