@craft-ts/dev-tools 0.7.0-beta.13 → 0.7.0-beta.15

package/README.md

@@ -15,20 +15,67 @@ For coding agents, also install
 
 ## Create a project
 
-Create a framework-independent CraftTS application from scratch. The command
-asks for the Effect v4 choice first in interactive mode because it changes the
-dependencies, generated API boundary, and agent skills:
+Create a framework-independent CraftTS application from scratch. Runtime axes,
+i18n, design-system, typed-CSS, server-function, workspace and reference
+choices are normalized into one effective configuration:
 
 ```bash
-npx craft create my-app
-npx craft create my-app --effect=v4 --agents=codex,cursor,cloud-code
-npx craft create my-app --effect=none --agents=none
+npx --yes --package @craft-ts/dev-tools@beta craft create my-app
+npx --yes --package @craft-ts/dev-tools@beta craft create my-app --effect=v4 --agents=codex,cursor,gemini
+npx --yes --package @craft-ts/dev-tools@beta craft create my-app --effect=none --agents=none
+npx --yes --package @craft-ts/dev-tools@beta craft create my-app --effect=none --i18n=none --design-system=none --no-typed-css
+npx --yes --package @craft-ts/dev-tools@beta craft create my-app --frontend-runtime=effect --backend-runtime=effect --i18n=strict
+npx --yes --package @craft-ts/dev-tools@beta craft create my-app --frontend-runtime=plain --backend-runtime=effect
+npx --yes --package @craft-ts/dev-tools@beta craft create apps/my-app --workspace=nx --references=craft-ts --reference-mode=context
+npx --yes --package @craft-ts/dev-tools@beta craft create apps/my-app --references=craft-ts --reference-mode=source
 ```
 
+In a terminal, creation is interactive by default. The frontend and backend
+runtimes are selected independently, so `plain` frontend + `effect` backend is
+available for server functions. The prompts also cover i18n locales, the
+workspace, CraftTS/EffectTS source references, and their resolution
+mode. All closed configuration values use keyboard menus: `↑`/`↓` to move
+and `Enter` to confirm; locales and agent integrations additionally use
+`Space` for multi-selection. Codex is selected by default. Pass
+`--yes` after `create` to disable all prompts, or pass
+`--agents=codex,cursor` / `--agents=none` for scripted agent selection.
+
+In interactive mode, reference sources are cloned by default; answer `n` to
+opt out. In non-interactive mode, request them explicitly with
+`--references=craft-ts` or `--references=all`.
+
+New standalone projects are initialized with Git (without an initial commit)
+and receive a `.gitignore` covering `node_modules/`, build outputs, test
+reports, and local references. If the destination is already inside another
+Git repository, no nested repository is created.
+
+Canonical options include `--frontend-runtime=plain|effect`,
+`--backend-runtime=none|promise|effect`, `--effect-scope=none|frontend|backend|both`,
+`--i18n=strict|loose|none`, `--design-system=basic|none`,
+`--typed-css`/`--no-typed-css`, `--workspace=standalone|nx`, and
+`--references=none|craft-ts|all` with `--reference-mode=context|local|source`.
+`--effect=v4|none`, `--locales` and `--default-locale` remain compatible aliases.
+`--json` includes the complete effective configuration.
+
+With references enabled, `.references/manifest.json` records the requested ref
+and resolved SHA. `context` keeps npm dependencies portable; `local` is for
+build artifacts from the checked-out references. `source` keeps the scoped
+`@craft-ts/...` imports but resolves them directly to the cloned CraftTS source
+through TypeScript paths and Vite aliases; the CraftTS clone itself does not
+get a `node_modules`. Refresh clones with
+`npm run update:references` (or the generated `update:craft-ts`/
+`update:effect-ts` scripts).
+
+`local` builds CraftTS with its Nx library targets and builds the MCP/log
+workspaces individually; CraftTS has no root `npm run build` script.
+
 The starter includes a routed page, a typed API call, flat-config ESLint, unit
-tests, a graph-wide `architecture/` suite, Playwright E2E tests, and README
-commands for every quality gate. `codex`, `cursor`, `claude-code`, and the
-`cloud-code`/`gemini` aliases install the corresponding project instructions.
+tests, a graph-wide `architecture/` suite, Playwright E2E tests, development
+logs forwarded to a local JSONL server, `.mcp.json` for Craft/log/page MCP
+servers, a browser type-check indicator, and a GitHub Actions workflow with an
+explicit `npm run typecheck` gate. `codex`, `cursor`, `claude-code`, and the
+`gemini` (with `cloud-code` kept as a compatibility alias) installs the
+corresponding Gemini project instructions.
 
 ## Project configuration
 
@@ -137,7 +184,14 @@ The rules cover, among other things:
 - yieldable reads, writes, methods, and resource triggers;
 - transport access through `CraftHttpClient`;
 - typed route loading, dependency proofs, and exception handling;
-- pure computed values, browser boundaries, and accessibility contracts.
+- pure computed values, browser boundaries, and accessibility contracts;
+- the security preset, included in `recommended` and `effect`: unchecked DOM
+  URLs, raw HTML, dynamic code, implicit SSR transfer, server functions
+  without limits or explicit per-function error exposure, forwarded headers, and
+  authentication material in browser storage.
+
+Apply the preset alone — on a library or a tooling folder that does not take
+`recommended` — with `craftRules.configs.security`.
 
 Run `eslint --fix` after changing generated dependency aliases or route
 metadata. Keep the generated aliases and proofs in the source file so the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craft-ts/dev-tools",
-  "version": "0.7.0-beta.13",
+  "version": "0.7.0-beta.15",
   "description": "Development tools for craft-ts: ESLint configs, ESLint rules, and codemods",
   "author": "Romain Geffrault",
   "license": "MIT",
@@ -24,6 +24,10 @@
       "types": "./src/eslint-rules/index.d.cts",
       "default": "./src/eslint-rules/index.cjs"
     },
+    "./style-report": {
+      "types": "./src/scripts/style-report.d.ts",
+      "default": "./src/scripts/style-report.js"
+    },
     "./template-migration": {
       "types": "./src/template-migration.d.ts",
       "default": "./src/template-migration.js"
@@ -60,6 +64,8 @@
   "files": [
     "generators.json",
     "src/**/*",
+    "!src/**/*.ts",
+    "src/**/*.d.ts",
     "README.md",
     "!src/**/*.spec.ts",
     "!src/**/*.spec.js",
@@ -74,7 +80,7 @@
     "tslib": "^2.3.0",
     "ts-morph": "^24.0.0",
     "ts-node": "^10.9.2",
-    "typescript": "6.0.3"
+    "typescript": "7.0.2"
   },
   "peerDependencies": {
     "@angular-eslint/eslint-plugin": ">=21.0.0",

package/src/bin/agent-selector.d.ts

@@ -0,0 +1,22 @@
+import type { CreateAgent } from '../scripts/create/create-project.js';
+export declare const CREATE_AGENT_OPTIONS: readonly {
+    readonly value: CreateAgent;
+    readonly label: string;
+}[];
+export type InteractiveOption<Value extends string> = {
+    readonly value: Value;
+    readonly label: string;
+};
+export type AgentSelectorInput = NodeJS.ReadStream & {
+    setRawMode(mode: boolean): NodeJS.ReadStream;
+};
+type AgentSelectorOutput = Pick<NodeJS.WriteStream, 'write'>;
+export declare function selectOptionInteractively<Value extends string>(options: readonly InteractiveOption<Value>[], title: string, initialValue: Value, input?: AgentSelectorInput, output?: AgentSelectorOutput): Promise<Value>;
+export declare function selectOptionsInteractively<Value extends string>(options: readonly InteractiveOption<Value>[], title: string, initialSelection: readonly Value[], input?: AgentSelectorInput, output?: AgentSelectorOutput, minimumSelection?: number): Promise<readonly Value[]>;
+/**
+ * Let a user select the integrations for which project skills are generated.
+ * The input is deliberately kept injectable so the keyboard state machine can
+ * be exercised without spawning a terminal in tests.
+ */
+export declare function selectAgentsInteractively(input?: AgentSelectorInput, output?: AgentSelectorOutput, initialSelection?: readonly CreateAgent[]): Promise<readonly CreateAgent[]>;
+export {};

package/src/bin/agent-selector.js

@@ -0,0 +1,100 @@
+import { emitKeypressEvents } from 'node:readline';
+export const CREATE_AGENT_OPTIONS = [
+    { value: 'codex', label: 'Codex' },
+    { value: 'cursor', label: 'Cursor' },
+    { value: 'claude-code', label: 'Claude Code' },
+    { value: 'cloud-code', label: 'Gemini CLI' },
+];
+function selectValuesInteractively(options, title, initialSelection, multiple, input, output, minimumSelection = 0) {
+    const selected = new Set(initialSelection);
+    let cursor = Math.max(0, options.findIndex((option) => selected.has(option.value)));
+    let rendered = false;
+    const render = () => {
+        if (rendered)
+            output.write(`\u001b[${options.length + 1}A`);
+        output.write(`${title}\n`);
+        for (const [index, option] of options.entries()) {
+            const pointer = index === cursor ? '❯' : ' ';
+            const marker = multiple ? `${selected.has(option.value) ? '[x]' : '[ ]'} ` : '';
+            output.write(`${pointer} ${marker}${option.label}\n`);
+        }
+        rendered = true;
+    };
+    return new Promise((resolve, reject) => {
+        const wasRaw = input.isRaw ?? false;
+        const finish = (result) => {
+            input.removeListener('keypress', onKeypress);
+            input.setRawMode(wasRaw);
+            input.pause();
+            output.write('\n');
+            resolve(result);
+        };
+        const cancel = () => {
+            input.removeListener('keypress', onKeypress);
+            input.setRawMode(wasRaw);
+            input.pause();
+            output.write('\n');
+            reject(new Error('Interactive selection cancelled.'));
+        };
+        const onKeypress = (_input, key) => {
+            if (key.ctrl && key.name === 'c') {
+                cancel();
+                return;
+            }
+            if (key.name === 'up') {
+                cursor = (cursor - 1 + options.length) % options.length;
+                render();
+                return;
+            }
+            if (key.name === 'down') {
+                cursor = (cursor + 1) % options.length;
+                render();
+                return;
+            }
+            if (multiple && key.name === 'space') {
+                const value = options[cursor].value;
+                if (selected.has(value)) {
+                    if (selected.size > minimumSelection)
+                        selected.delete(value);
+                }
+                else
+                    selected.add(value);
+                render();
+                return;
+            }
+            if (key.name === 'return' || key.name === 'enter') {
+                finish(multiple
+                    ? options.map((option) => option.value).filter((value) => selected.has(value))
+                    : [options[cursor].value]);
+            }
+        };
+        try {
+            emitKeypressEvents(input);
+            input.setRawMode(true);
+            input.setEncoding('utf8');
+            input.resume();
+            input.on('keypress', onKeypress);
+            render();
+        }
+        catch (error) {
+            cancel();
+            reject(error);
+        }
+    });
+}
+export function selectOptionInteractively(options, title, initialValue, input = process.stdin, output = process.stdout) {
+    return selectValuesInteractively(options, title, [initialValue], false, input, output)
+        .then(([value]) => value);
+}
+export function selectOptionsInteractively(options, title, initialSelection, input = process.stdin, output = process.stdout, minimumSelection = 0) {
+    return selectValuesInteractively(options, title, initialSelection, true, input, output, minimumSelection);
+}
+/**
+ * Let a user select the integrations for which project skills are generated.
+ * The input is deliberately kept injectable so the keyboard state machine can
+ * be exercised without spawning a terminal in tests.
+ */
+export function selectAgentsInteractively(input = process.stdin, output = process.stdout, initialSelection = ['codex']) {
+    return selectOptionsInteractively(CREATE_AGENT_OPTIONS, 'Select agent skills (↑/↓ move, Space toggle, Enter confirm):', initialSelection, input, output);
+}
+//# sourceMappingURL=agent-selector.js.map

package/src/bin/agent-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-selector.js","sourceRoot":"","sources":["../../../../../libs/dev-tools/src/bin/agent-selector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAInD,MAAM,CAAC,MAAM,oBAAoB,GAG3B;IACJ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAClC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;IACpC,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;IAC9C,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;CAC7C,CAAC;AAoBF,SAAS,yBAAyB,CAChC,OAA4C,EAC5C,KAAa,EACb,gBAAkC,EAClC,QAAiB,EACjB,KAAoB,EACpB,MAA2B,EAC3B,gBAAgB,GAAG,CAAC;IAEpB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAQ,gBAAgB,CAAC,CAAC;IAClD,IAAI,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpF,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,IAAI,QAAQ;YAAE,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;QAC3B,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,MAAM,OAAO,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;QACxD,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,IAAI,OAAO,CAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACvD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC;QACpC,MAAM,MAAM,GAAG,CAAC,MAAwB,EAAQ,EAAE;YAChD,KAAK,CAAC,cAAc,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAC7C,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACzB,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,KAAK,CAAC,cAAc,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAC7C,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACzB,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnB,MAAM,CAAC,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC,CAAC;QACxD,CAAC,CAAC;QACF,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,GAAQ,EAAQ,EAAE;YACpD,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjC,MAAM,EAAE,CAAC;gBACT,OAAO;YACT,CAAC;YACD,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACtB,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;gBACxD,MAAM,EAAE,CAAC;gBACT,OAAO;YACT,CAAC;YACD,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACxB,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;gBACvC,MAAM,EAAE,CAAC;gBACT,OAAO;YACT,CAAC;YACD,IAAI,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC;gBACpC,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBACxB,IAAI,QAAQ,CAAC,IAAI,GAAG,gBAAgB;wBAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC/D,CAAC;;oBACI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACzB,MAAM,EAAE,CAAC;gBACT,OAAO;YACT,CAAC;YACD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAClD,MAAM,CACJ,QAAQ;oBACN,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;oBAC9E,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAC5B,CAAC;YACJ,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC;YACH,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAC1B,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACvB,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC1B,KAAK,CAAC,MAAM,EAAE,CAAC;YACf,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YACjC,MAAM,EAAE,CAAC;QACX,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,EAAE,CAAC;YACT,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAA4C,EAC5C,KAAa,EACb,YAAmB,EACnB,QAA4B,OAAO,CAAC,KAA2B,EAC/D,SAA8B,OAAO,CAAC,MAAM;IAE5C,OAAO,yBAAyB,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC;SACnF,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,OAA4C,EAC5C,KAAa,EACb,gBAAkC,EAClC,QAA4B,OAAO,CAAC,KAA2B,EAC/D,SAA8B,OAAO,CAAC,MAAM,EAC5C,gBAAgB,GAAG,CAAC;IAEpB,OAAO,yBAAyB,CAC9B,OAAO,EACP,KAAK,EACL,gBAAgB,EAChB,IAAI,EACJ,KAAK,EACL,MAAM,EACN,gBAAgB,CACjB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAA4B,OAAO,CAAC,KAA2B,EAC/D,SAA8B,OAAO,CAAC,MAAM,EAC5C,mBAA2C,CAAC,OAAO,CAAC;IAEpD,OAAO,0BAA0B,CAC/B,oBAAoB,EACpB,8DAA8D,EAC9D,gBAAgB,EAChB,KAAK,EACL,MAAM,CACP,CAAC;AACJ,CAAC"}

package/src/bin/craft-graph.js

@@ -1,5 +1,56 @@
 #!/usr/bin/env node
+import { readFileSync } from 'node:fs';
 import { writeDependencyGraph, } from '../scripts/dependency-graph.js';
+import { styleDebt, styleImpact, styleMatrix, } from '../scripts/style-report.js';
+const DEFAULT_STYLE_DUMP = 'tmp/craft-style-graph.json';
+/**
+ * The style questions answer from the dump alone.
+ *
+ * They deliberately do **not** build the TypeScript program: the whole point of
+ * asking "what does this token change affect?" is to answer it in the time it
+ * takes to decide whether to run the visual suite. A question that costs a full
+ * typecheck gets asked once and then never again.
+ */
+function runStyleQuery(argv) {
+    const impacted = [];
+    let dumpPath = DEFAULT_STYLE_DUMP;
+    let mode;
+    for (let index = 0; index < argv.length; index += 1) {
+        switch (argv[index]) {
+            case '--impacted':
+                mode = 'impacted';
+                impacted.push(argv[++index]);
+                break;
+            case '--style-matrix':
+                mode = 'matrix';
+                break;
+            case '--style-debt':
+                mode = 'debt';
+                break;
+            case '--style-dump':
+                dumpPath = argv[++index];
+                break;
+            default:
+                break;
+        }
+    }
+    if (!mode)
+        return false;
+    let dump;
+    try {
+        dump = JSON.parse(readFileSync(dumpPath, 'utf8'));
+    }
+    catch {
+        throw new Error(`craft-graph: no style dump at '${dumpPath}'. It is written by the build plugin — give craftStyle({ dumpPath }) a path, run a build, or point at it with --style-dump.`);
+    }
+    const report = mode === 'impacted'
+        ? styleImpact(dump, impacted)
+        : mode === 'matrix'
+            ? styleMatrix(dump)
+            : styleDebt(dump);
+    console.log(JSON.stringify(report, null, 2));
+    return true;
+}
 function parseArgs(argv) {
     const options = {
         rootDir: process.cwd(),
@@ -34,6 +85,9 @@ function parseArgs(argv) {
             case '--include':
                 options.include = [...(options.include ?? []), argv[++index]];
                 break;
+            case '--style-dump':
+                index += 1;
+                break;
             case '--help':
             case '-h':
                 printHelp();
@@ -59,14 +113,26 @@ Options:
                                json/both/all also write a .architecture.ts catalog.
                                html creates one self-contained visualizer file.
   --include <text>             Restrict analysis to source paths containing text.
+
+Style queries, answered from the emitted dump without building the program:
+  --impacted <--x>             Sheet classes a change to that custom property
+                               can be seen in. Repeatable. Falls back to "all"
+                               — and says so — for a name the graph does not know.
+  --style-matrix               What the application costs to capture.
+  --style-debt                 Escape hatches, unmet obligations, dangling
+                               variables, and the components nobody styles.
+  --style-dump <path>          Defaults to ${DEFAULT_STYLE_DUMP}.
 `);
 }
-writeDependencyGraph(parseArgs(process.argv.slice(2)))
-    .then((graph) => {
-    console.log(`Craft graph written: ${graph.nodes.length} nodes, ${graph.edges.length} edges.`);
-})
-    .catch((error) => {
-    console.error(error instanceof Error ? error.message : error);
-    process.exitCode = 1;
-});
+const argv = process.argv.slice(2);
+if (!runStyleQuery(argv)) {
+    writeDependencyGraph(parseArgs(argv))
+        .then((graph) => {
+        console.log(`Craft graph written: ${graph.nodes.length} nodes, ${graph.edges.length} edges.`);
+    })
+        .catch((error) => {
+        console.error(error instanceof Error ? error.message : error);
+        process.exitCode = 1;
+    });
+}
 //# sourceMappingURL=craft-graph.js.map

package/src/bin/craft-graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"craft-graph.js","sourceRoot":"","sources":["../../../../../libs/dev-tools/src/bin/craft-graph.ts"],"names":[],"mappings":";AAEA,OAAO,EACL,oBAAoB,GAErB,MAAM,gCAAgC,CAAC;AAExC,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,OAAO,GAAgC;QAC3C,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE;QACtB,UAAU,EAAE,wBAAwB;QACpC,MAAM,EAAE,MAAM;KACf,CAAC;IACF,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,WAAW,CAAC;YACjB,KAAK,YAAY;gBACf,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBACzC,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBAChC,MAAM;YACR,KAAK,OAAO;gBACV,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBACnC,MAAM;YACR,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBAC7B,IACE,MAAM,KAAK,MAAM;oBACjB,MAAM,KAAK,SAAS;oBACpB,MAAM,KAAK,MAAM;oBACjB,MAAM,KAAK,MAAM;oBACjB,MAAM,KAAK,KAAK,EAChB,CAAC;oBACD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;gBACzE,CAAC;gBACD,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;gBACxB,MAAM;YACR,CAAC;YACD,KAAK,WAAW;gBACd,OAAO,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC9D,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,SAAS,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;CAab,CAAC,CAAC;AACH,CAAC;AAED,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KACnD,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;IACd,OAAO,CAAC,GAAG,CACT,wBAAwB,KAAK,CAAC,KAAK,CAAC,MAAM,WAAW,KAAK,CAAC,KAAK,CAAC,MAAM,SAAS,CACjF,CAAC;AACJ,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"craft-graph.js","sourceRoot":"","sources":["../../../../../libs/dev-tools/src/bin/craft-graph.ts"],"names":[],"mappings":"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"}

package/src/bin/craft.d.ts

@@ -1,2 +1,25 @@
 #!/usr/bin/env node
+type CreateArgs = {
+    directory?: string;
+    effect?: string;
+    frontendRuntime?: 'plain' | 'effect';
+    backendRuntime?: 'none' | 'promise' | 'effect';
+    effectScope?: 'none' | 'frontend' | 'backend' | 'both';
+    agents?: string;
+    locales?: string;
+    defaultLocale?: string;
+    i18n?: 'strict' | 'loose' | 'none';
+    designSystem?: 'basic' | 'none';
+    typedCss?: boolean;
+    workspace?: 'standalone' | 'nx';
+    references?: 'none' | 'craft-ts' | 'all';
+    referenceMode?: 'context' | 'local' | 'source';
+    craftTsRef?: string;
+    effectTsRef?: string;
+    cloneCraftTs?: boolean;
+    cloneEffectTs?: boolean;
+    flags: Set<string>;
+    help: boolean;
+};
+export declare function parseCreateArgs(argv: string[]): CreateArgs;
 export {};