@chiralkit/cli 0.1.0-alpha.0

package/dist/generator/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/generator/agent.ts"],"names":[],"mappings":"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"}

package/dist/generator/api.d.ts

@@ -0,0 +1,7 @@
+import type { GenerationRequest } from "./request.js";
+export interface ApiMessage {
+    role: "system" | "user";
+    content: string;
+}
+export declare function serializeForApi(req: GenerationRequest): ApiMessage[];
+export declare function runApi(model: unknown, req: GenerationRequest): Promise<string>;

package/dist/generator/api.js

@@ -0,0 +1,42 @@
+import { renderFewShotsBlock } from "./request.js";
+export function serializeForApi(req) {
+    const userContent = [
+        "## Component spec (spec.json)",
+        "",
+        "```json\n" + req.spec + "\n```",
+        "",
+        "## Verifiable output requirements",
+        "",
+        req.derivedRequirements,
+        "",
+        "## Reference implementations",
+        "",
+        renderFewShotsBlock(req.fewShots),
+        "",
+        "## Output format",
+        "",
+        req.outputFormat,
+        "",
+        `Generate the ${req.targetStack} implementation of ${req.targetComponent}.`,
+    ].join("\n");
+    return [
+        { role: "system", content: req.preamble },
+        { role: "user", content: userContent },
+    ];
+}
+// runApi wraps the AI SDK generateText call. `ai` is imported dynamically
+// so agent-mode invocations do not pay its module-load cost. `model` is
+// unknown for the same reason described in config.ts:resolveModel — staying
+// decoupled from a specific @ai-sdk major.
+export async function runApi(model, req) {
+    const messages = serializeForApi(req);
+    const { generateText } = await import("ai");
+    const response = await generateText({
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        model: model,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        messages: messages,
+    });
+    return response.text;
+}
+//# sourceMappingURL=api.js.map

package/dist/generator/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/generator/api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAOnD,MAAM,UAAU,eAAe,CAAC,GAAsB;IACpD,MAAM,WAAW,GAAG;QAClB,+BAA+B;QAC/B,EAAE;QACF,WAAW,GAAG,GAAG,CAAC,IAAI,GAAG,OAAO;QAChC,EAAE;QACF,mCAAmC;QACnC,EAAE;QACF,GAAG,CAAC,mBAAmB;QACvB,EAAE;QACF,8BAA8B;QAC9B,EAAE;QACF,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC;QACjC,EAAE;QACF,kBAAkB;QAClB,EAAE;QACF,GAAG,CAAC,YAAY;QAChB,EAAE;QACF,gBAAgB,GAAG,CAAC,WAAW,sBAAsB,GAAG,CAAC,eAAe,GAAG;KAC5E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO;QACL,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE;QACzC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE;KACvC,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,wEAAwE;AACxE,4EAA4E;AAC5E,2CAA2C;AAC3C,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,KAAc,EACd,GAAsB;IAEtB,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC;QAClC,8DAA8D;QAC9D,KAAK,EAAE,KAAY;QACnB,8DAA8D;QAC9D,QAAQ,EAAE,QAAe;KAC1B,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC"}

package/dist/generator/config.d.ts

@@ -0,0 +1,23 @@
+declare const SUPPORTED_AGENTS: readonly ["claude-code"];
+export type GeneratorConfig = {
+    generator: {
+        agent: (typeof SUPPORTED_AGENTS)[number];
+    };
+} | {
+    generator: {
+        model: string;
+    };
+};
+export declare function isAgentConfig(c: GeneratorConfig): c is {
+    generator: {
+        agent: (typeof SUPPORTED_AGENTS)[number];
+    };
+};
+export declare function parseGeneratorConfigForTest(raw: unknown): GeneratorConfig;
+export declare function loadGeneratorConfig(): Promise<GeneratorConfig>;
+export declare function resolveModel(config: {
+    generator: {
+        model: string;
+    };
+}): Promise<unknown>;
+export {};

package/dist/generator/config.js

@@ -0,0 +1,121 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { z } from "zod";
+import { resolveKitsRoot } from "@chiralkit/kits";
+const registryRoot = join(resolveKitsRoot(), "ui", "registry");
+const CONFIG_PATH = join(registryRoot, "generator.config.json");
+const PROVIDER_DOCS_URL = "https://sdk.vercel.ai/providers/";
+const SUPPORTED_AGENTS = ["claude-code"];
+const agentBlockSchema = z
+    .object({
+    agent: z.enum(SUPPORTED_AGENTS, {
+        errorMap: () => ({
+            message: `generator.agent must be one of: ${SUPPORTED_AGENTS.join(", ")}`,
+        }),
+    }),
+})
+    .strict();
+const apiBlockSchema = z
+    .object({
+    model: z
+        .string()
+        .min(1)
+        .regex(/^[a-z0-9-]+\/.+$/, {
+        message: "generator.model must be '<provider>/<model-id>' (e.g. 'anthropic/claude-opus-4-8')",
+    }),
+})
+    .strict();
+export function isAgentConfig(c) {
+    return "agent" in c.generator;
+}
+// Exposed for unit tests — same validation as loadGeneratorConfig without I/O.
+export function parseGeneratorConfigForTest(raw) {
+    return validate(raw);
+}
+function validate(raw) {
+    if (typeof raw !== "object" || raw === null || !("generator" in raw)) {
+        throw new Error("generator: config is missing the top-level `generator` block. Expected " +
+            '`{ "generator": { "agent": "claude-code" } }` or ' +
+            '`{ "generator": { "model": "<provider>/<model-id>" } }`.');
+    }
+    const gen = raw.generator;
+    if (typeof gen !== "object" || gen === null) {
+        throw new Error("generator: `generator` must be an object.");
+    }
+    const hasAgent = "agent" in gen;
+    const hasModel = "model" in gen;
+    if (hasAgent === hasModel) {
+        // both present or both absent
+        throw new Error("generator: exactly one of `generator.agent` or `generator.model` must be set.\n" +
+            "  Agent mode: { \"generator\": { \"agent\": \"claude-code\" } }\n" +
+            "  API mode:   { \"generator\": { \"model\": \"anthropic/claude-opus-4-8\" } }\n" +
+            `See ${PROVIDER_DOCS_URL} for available API providers.`);
+    }
+    if (hasAgent) {
+        const parsed = agentBlockSchema.safeParse(gen);
+        if (!parsed.success)
+            throw new Error(zodMessage(parsed.error));
+        return { generator: parsed.data };
+    }
+    const parsed = apiBlockSchema.safeParse(gen);
+    if (!parsed.success)
+        throw new Error(zodMessage(parsed.error));
+    return { generator: parsed.data };
+}
+function zodMessage(err) {
+    return err.issues.map((i) => i.message).join("; ");
+}
+export async function loadGeneratorConfig() {
+    let raw;
+    try {
+        raw = await readFile(CONFIG_PATH, "utf8");
+    }
+    catch {
+        throw new Error(`generator: no config found at ${CONFIG_PATH}.\n` +
+            `Create it with ONE of:\n` +
+            `  { "generator": { "agent": "claude-code" } }              # uses your local Claude Code CLI\n` +
+            `  { "generator": { "model": "anthropic/claude-opus-4-8" } } # requires ANTHROPIC_API_KEY`);
+    }
+    let parsedJson;
+    try {
+        parsedJson = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`generator: ${CONFIG_PATH} is not valid JSON: ${e.message}`);
+    }
+    try {
+        return validate(parsedJson);
+    }
+    catch (e) {
+        throw new Error(`generator: ${CONFIG_PATH} failed validation:\n${e.message}`);
+    }
+}
+// Resolves the configured model into an AI SDK LanguageModel instance.
+// Return type is `unknown` because the AI SDK's LanguageModel type is
+// versioned per major; typing this precisely would couple the CLI to a
+// specific @ai-sdk major and defeat the "swap the provider without
+// touching this file" property. The caller passes it straight to
+// generateText({ model }), which enforces the contract at the call site.
+export async function resolveModel(config) {
+    const [provider, ...idParts] = config.generator.model.split("/");
+    const modelId = idParts.join("/");
+    if (!provider || !modelId) {
+        throw new Error(`generator: model '${config.generator.model}' is malformed. Expected '<provider>/<model-id>'.`);
+    }
+    switch (provider) {
+        case "anthropic": {
+            const mod = await import("@ai-sdk/anthropic");
+            const factory = mod.anthropic;
+            if (typeof factory !== "function") {
+                throw new Error(`generator: @ai-sdk/anthropic does not export the expected 'anthropic' factory. This is likely a version mismatch — reinstall matching versions of 'ai' and '@ai-sdk/anthropic'.`);
+            }
+            return factory(modelId);
+        }
+        default:
+            throw new Error(`generator: provider '${provider}' is not installed.\n` +
+                `Add it with: pnpm --filter @chiralkit/cli add @ai-sdk/${provider}\n` +
+                `Then wire it into resolveModel() in packages/cli/src/generator/config.ts.\n` +
+                `See ${PROVIDER_DOCS_URL} for the list of supported providers.`);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/generator/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/generator/config.ts"],"names":[],"mappings":"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"}

package/dist/generator/parse-response.d.ts

@@ -0,0 +1,5 @@
+export interface ParsedFile {
+    path: string;
+    content: string;
+}
+export declare function parseResponse(text: string): ParsedFile[];

package/dist/generator/parse-response.js

@@ -0,0 +1,58 @@
+// Response format the prompt template mandates:
+//
+//   === FILE: <relative-path> ===
+//   ```<lang>
+//   <content>
+//   ```
+//
+// Any content outside these blocks is ignored — LLMs sometimes wrap their
+// output in surrounding prose, and being lenient about it is cheap and
+// improves resilience. Any content INSIDE a fenced block after a FILE
+// marker is captured verbatim, with the leading/trailing newline stripped.
+//
+const FORBIDDEN_BASENAMES = new Set(["generation.json"]);
+export function parseResponse(text) {
+    // Constructed per-call so the /g flag's mutable `lastIndex` cannot leak
+    // between invocations (a rejection path throwing mid-loop would otherwise
+    // leave state on a shared regex object). Regex captures:
+    //   1: file path (letters, digits, dot, dash, underscore, slash)
+    //   2: language hint after the opening fence (may be empty)
+    //   3: the file content
+    const fileBlockRe = /^===\s*FILE:\s*([A-Za-z0-9._\-/]+)\s*===\s*\r?\n```([A-Za-z0-9._+-]*)\r?\n([\s\S]*?)\r?\n```/gm;
+    const files = [];
+    const seenPaths = new Set();
+    let m;
+    while ((m = fileBlockRe.exec(text)) !== null) {
+        const path = m[1];
+        const content = m[3];
+        validatePath(path);
+        if (seenPaths.has(path)) {
+            throw new Error(`generator: response contains duplicate file '${path}'. The LLM emitted the same file twice; refusing to guess which is authoritative.`);
+        }
+        seenPaths.add(path);
+        files.push({ path, content });
+    }
+    if (files.length === 0) {
+        throw new Error(`generator: response contained no '=== FILE: ... ===' blocks. The LLM did not follow the required output format. Re-run with --dry-run to inspect the raw response.`);
+    }
+    return files;
+}
+function validatePath(path) {
+    if (path.length === 0) {
+        throw new Error(`generator: response contains an empty file path.`);
+    }
+    if (path.startsWith("/")) {
+        throw new Error(`generator: response contains absolute path '${path}'. Only paths relative to implementations/<stack>/ are permitted.`);
+    }
+    if (path.includes("..")) {
+        throw new Error(`generator: response contains parent-directory reference in path '${path}'. Rejected as a safety measure.`);
+    }
+    if (path.includes("\0")) {
+        throw new Error(`generator: response contains null byte in path '${path}'. Rejected.`);
+    }
+    const basename = path.split("/").pop();
+    if (FORBIDDEN_BASENAMES.has(basename)) {
+        throw new Error(`generator: response tries to write '${basename}', which is managed by the CLI. Refusing.`);
+    }
+}
+//# sourceMappingURL=parse-response.js.map

package/dist/generator/parse-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-response.js","sourceRoot":"","sources":["../../src/generator/parse-response.ts"],"names":[],"mappings":"AAKA,gDAAgD;AAChD,EAAE;AACF,kCAAkC;AAClC,cAAc;AACd,cAAc;AACd,QAAQ;AACR,EAAE;AACF,0EAA0E;AAC1E,uEAAuE;AACvE,sEAAsE;AACtE,2EAA2E;AAC3E,EAAE;AACF,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAEzD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,wEAAwE;IACxE,0EAA0E;IAC1E,yDAAyD;IACzD,iEAAiE;IACjE,4DAA4D;IAC5D,wBAAwB;IACxB,MAAM,WAAW,GACf,gGAAgG,CAAC;IACnG,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACnB,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACtB,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,gDAAgD,IAAI,mFAAmF,CACxI,CAAC;QACJ,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,oKAAoK,CACrK,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,+CAA+C,IAAI,mEAAmE,CACvH,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,oEAAoE,IAAI,kCAAkC,CAC3G,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,mDAAmD,IAAI,cAAc,CACtE,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC;IACxC,IAAI,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,uCAAuC,QAAQ,2CAA2C,CAC3F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/generator/prompt.d.ts

@@ -0,0 +1,9 @@
+import type { ComponentContract } from "@chiralkit/registry-schema";
+import type { GenerationRequest } from "./request.js";
+export interface ComposeRequestInput {
+    spec: ComponentContract;
+    stack: string;
+    targetComponent: string;
+    fewShotPaths: string[];
+}
+export declare function composeRequest(input: ComposeRequestInput): Promise<GenerationRequest>;

package/dist/generator/prompt.js

@@ -0,0 +1,166 @@
+import { readFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const here = dirname(fileURLToPath(import.meta.url));
+const PROMPTS_DIR = join(here, "..", "generators", "prompts");
+export async function composeRequest(input) {
+    const { preamble, outputFormat } = await loadTemplate(input.stack);
+    return {
+        preamble,
+        outputFormat,
+        spec: JSON.stringify(input.spec, null, 2),
+        derivedRequirements: renderRequirements(input.spec),
+        fewShots: await loadFewShots(input.fewShotPaths),
+        targetComponent: input.targetComponent,
+        targetStack: input.stack,
+    };
+}
+// Splits the stack template into named sections keyed by their `## `
+// heading text. Requires exactly `## Preamble` and `## OutputFormat`.
+async function loadTemplate(stack) {
+    const path = join(PROMPTS_DIR, `${stack}.md`);
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        throw new Error(`generator: no prompt template for stack '${stack}' at ${path}. ` +
+            `Add packages/cli/src/generators/prompts/${stack}.md and rebuild.`);
+    }
+    const sections = splitByH2(raw);
+    const preamble = sections.get("Preamble");
+    const outputFormat = sections.get("OutputFormat");
+    if (!preamble) {
+        throw new Error(`generator: template ${path} is missing required '## Preamble' section.`);
+    }
+    if (!outputFormat) {
+        throw new Error(`generator: template ${path} is missing required '## OutputFormat' section.`);
+    }
+    return { preamble: preamble.trim(), outputFormat: outputFormat.trim() };
+}
+// Section split: iterates lines, treats each `## <name>` as a new bucket.
+// Lines before the first `## ` heading are dropped (they belong to `# `
+// title and its explanatory prose, which is not part of the request).
+function splitByH2(md) {
+    const out = new Map();
+    let current = null;
+    let buf = [];
+    for (const line of md.split(/\r?\n/)) {
+        const m = /^##\s+(.+?)\s*$/.exec(line);
+        if (m && !line.startsWith("### ")) {
+            if (current !== null)
+                out.set(current, buf.join("\n"));
+            current = m[1];
+            buf = [];
+        }
+        else if (current !== null) {
+            buf.push(line);
+        }
+    }
+    if (current !== null)
+        out.set(current, buf.join("\n"));
+    return out;
+}
+async function loadFewShots(paths) {
+    const byComponent = new Map();
+    for (const abs of paths) {
+        // absolute path shape: .../registry/<component>/implementations/<stack>/<file>
+        const file = basename(abs);
+        const stackDir = dirname(abs);
+        const implDir = dirname(stackDir);
+        const componentDir = dirname(implDir);
+        const componentName = basename(componentDir);
+        const content = await readFile(abs, "utf8");
+        const existing = byComponent.get(componentName);
+        if (existing) {
+            existing.files.push({ path: file, content });
+        }
+        else {
+            byComponent.set(componentName, {
+                componentName,
+                files: [{ path: file, content }],
+            });
+        }
+    }
+    return Array.from(byComponent.values());
+}
+// Turns the spec's abstract fields into explicit testable statements the
+// LLM can check its own output against.
+function renderRequirements(spec) {
+    const lines = [];
+    if (spec.props) {
+        for (const [name, prop] of Object.entries(spec.props)) {
+            if (prop.type === "enum") {
+                const values = prop.values.map((v) => `"${v}"`).join(", ");
+                const dflt = prop.default !== undefined ? `, default "${prop.default}"` : "";
+                lines.push(`- Prop \`${name}\` is an enum with values [${values}]${dflt}.`);
+            }
+            else {
+                const dflt = "default" in prop && prop.default !== undefined
+                    ? `, default ${JSON.stringify(prop.default)}`
+                    : "";
+                lines.push(`- Prop \`${name}\` is of type \`${prop.type}\`${dflt}.`);
+            }
+        }
+    }
+    if (spec.events) {
+        for (const [name, evt] of Object.entries(spec.events)) {
+            const payload = typeof evt.payload === "string"
+                ? evt.payload
+                : evt.payload
+                    ? "structured (see spec)"
+                    : "void";
+            const cond = evt.condition ? ` when \`${evt.condition}\`` : "";
+            lines.push(`- Event \`${name}\` emits payload \`${payload}\`${cond}.`);
+        }
+    }
+    if (spec.slot) {
+        lines.push(`- Component renders a \`<slot>\` for: ${spec.slot.purpose}.`);
+    }
+    if (spec.tokens_used) {
+        for (const [bucket, values] of Object.entries(spec.tokens_used)) {
+            if (!values || values.length === 0)
+                continue;
+            const stems = values
+                .map((v) => `--ds-${singular(bucket)}-${v}`)
+                .join(", ");
+            lines.push(`- Consumes only these CSS tokens from bucket \`${bucket}\`: ${stems}.`);
+        }
+    }
+    if (spec.state_machine) {
+        const sm = spec.state_machine;
+        lines.push(`- State machine has initial state \`${sm.initial}\`.`);
+        for (const [state, def] of Object.entries(sm.states)) {
+            if (!def.on)
+                continue;
+            for (const [event, transition] of Object.entries(def.on)) {
+                const emit = transition.emit
+                    ? ` and emits \`${transition.emit.event}\``
+                    : "";
+                lines.push(`- In state \`${state}\`, event \`${event}\` transitions to \`${transition.target}\`${emit}.`);
+            }
+        }
+    }
+    if (spec.a11y && typeof spec.a11y === "object") {
+        for (const [key, value] of Object.entries(spec.a11y)) {
+            const val = Array.isArray(value)
+                ? value.map(String).join("; ")
+                : typeof value === "string"
+                    ? value
+                    : JSON.stringify(value);
+            lines.push(`- A11y (\`${key}\`): ${val}.`);
+        }
+    }
+    return lines.length > 0
+        ? lines.join("\n")
+        : "- (no verifiable requirements derived from spec)";
+}
+function singular(bucket) {
+    switch (bucket) {
+        case "colors":
+            return "color";
+        default:
+            return bucket;
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/dist/generator/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/generator/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;AAS9D,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAA0B;IAE1B,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnE,OAAO;QACL,QAAQ;QACR,YAAY;QACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,mBAAmB,EAAE,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC;QACnD,QAAQ,EAAE,MAAM,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC;QAChD,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,WAAW,EAAE,KAAK,CAAC,KAAK;KACzB,CAAC;AACJ,CAAC;AAOD,qEAAqE;AACrE,sEAAsE;AACtE,KAAK,UAAU,YAAY,CAAC,KAAa;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,KAAK,KAAK,CAAC,CAAC;IAC9C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,4CAA4C,KAAK,QAAQ,IAAI,IAAI;YAC/D,2CAA2C,KAAK,kBAAkB,CACrE,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,uBAAuB,IAAI,6CAA6C,CACzE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,uBAAuB,IAAI,iDAAiD,CAC7E,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;AAC1E,CAAC;AAED,0EAA0E;AAC1E,wEAAwE;AACxE,sEAAsE;AACtE,SAAS,SAAS,CAAC,EAAU;IAC3B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,GAAG,GAAa,EAAE,CAAC;IACvB,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,IAAI,OAAO,KAAK,IAAI;gBAAE,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACvD,OAAO,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;YAChB,GAAG,GAAG,EAAE,CAAC;QACX,CAAC;aAAM,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YAC5B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,KAAK,IAAI;QAAE,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,KAAe;IACzC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC/C,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,+EAA+E;QAC/E,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,aAAa,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAChD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,GAAG,CAAC,aAAa,EAAE;gBAC7B,aAAa;gBACb,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;aACjC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,yEAAyE;AACzE,wCAAwC;AACxC,SAAS,kBAAkB,CAAC,IAAuB;IACjD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACzB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC3D,MAAM,IAAI,GACR,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,KAAK,CAAC,IAAI,CACR,YAAY,IAAI,8BAA8B,MAAM,IAAI,IAAI,GAAG,CAChE,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GACR,SAAS,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;oBAC7C,CAAC,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;oBAC7C,CAAC,CAAC,EAAE,CAAC;gBACT,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,mBAAmB,IAAI,CAAC,IAAI,KAAK,IAAI,GAAG,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtD,MAAM,OAAO,GACX,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;gBAC7B,CAAC,CAAC,GAAG,CAAC,OAAO;gBACb,CAAC,CAAC,GAAG,CAAC,OAAO;oBACX,CAAC,CAAC,uBAAuB;oBACzB,CAAC,CAAC,MAAM,CAAC;YACf,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,sBAAsB,OAAO,KAAK,IAAI,GAAG,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CACR,yCAAyC,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,CAC9D,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAChE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAC7C,MAAM,KAAK,GAAG,MAAM;iBACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;iBAC3C,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,KAAK,CAAC,IAAI,CACR,kDAAkD,MAAM,OAAO,KAAK,GAAG,CACxE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,uCAAuC,EAAE,CAAC,OAAO,KAAK,CAAC,CAAC;QACnE,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,SAAS;YACtB,KAAK,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI;oBAC1B,CAAC,CAAC,gBAAgB,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI;oBAC3C,CAAC,CAAC,EAAE,CAAC;gBACP,KAAK,CAAC,IAAI,CACR,gBAAgB,KAAK,eAAe,KAAK,uBAAuB,UAAU,CAAC,MAAM,KAAK,IAAI,GAAG,CAC9F,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CACvC,IAAI,CAAC,IAA+B,CACrC,EAAE,CAAC;YACF,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC9B,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC9B,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;oBACzB,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,QAAQ,GAAG,GAAG,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC;QACrB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAClB,CAAC,CAAC,kDAAkD,CAAC;AACzD,CAAC;AAED,SAAS,QAAQ,CAAC,MAAc;IAC9B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC;QACjB;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/generator/request.d.ts

@@ -0,0 +1,17 @@
+export interface FewShot {
+    componentName: string;
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+}
+export interface GenerationRequest {
+    preamble: string;
+    spec: string;
+    derivedRequirements: string;
+    fewShots: FewShot[];
+    outputFormat: string;
+    targetComponent: string;
+    targetStack: string;
+}
+export declare function renderFewShotsBlock(fewShots: FewShot[]): string;

package/dist/generator/request.js

@@ -0,0 +1,15 @@
+// Renders few-shot files as markdown fenced blocks, keeping the section
+// empty-friendly (no examples on the first component per stack).
+export function renderFewShotsBlock(fewShots) {
+    if (fewShots.length === 0) {
+        return "_(No prior implementations for this stack yet.)_";
+    }
+    const blocks = [];
+    for (const fs of fewShots) {
+        for (const f of fs.files) {
+            blocks.push(`### ${fs.componentName}/${f.path}\n\n\`\`\`\n${f.content}\n\`\`\``);
+        }
+    }
+    return blocks.join("\n\n");
+}
+//# sourceMappingURL=request.js.map

package/dist/generator/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/generator/request.ts"],"names":[],"mappings":"AAeA,wEAAwE;AACxE,iEAAiE;AACjE,MAAM,UAAU,mBAAmB,CAAC,QAAmB;IACrD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,kDAAkD,CAAC;IAC5D,CAAC;IACD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CACT,OAAO,EAAE,CAAC,aAAa,IAAI,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,OAAO,UAAU,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/generators/prompts/stencil.md

@@ -0,0 +1,45 @@
+# Stack: Stencil (Web Components via @stencil/core)
+
+## Preamble
+
+You are generating source code for a Stencil component. Follow these conventions strictly.
+
+### File shape
+
+Emit exactly one `.tsx` file and one `.css` file. Do NOT emit a `readme.md`, a `generation.json`, a test file, or any other file. The tsx file exports a class decorated with `@Component({ tag, styleUrl, shadow: true })` where `tag` matches the value in the spec's `name` prefixed with `ds-` (`spec.name = "button"` → `tag: "ds-button"`).
+
+### Class shape
+
+- One `class Ds<PascalName>` per file (e.g. `class DsButton`).
+- Every prop from `spec.props` becomes `@Prop() <name>: <type> = <default>;` — use TypeScript primitive types (`boolean`, `string`, `number`) for the corresponding spec types; use string-literal unions for enums (`"a" | "b" | "c"`). Optional props (no default in the spec) get a trailing `?` on the name: `@Prop() href?: string;`.
+- Every event from `spec.events` becomes `@Event() <name>!: EventEmitter<<Payload>>;` where `<Payload>` is the spec's `payload` type string (or an inline object type when the spec's payload is structured).
+- The render method returns `<Host>...</Host>` with a `<slot />` when the spec declares a default slot.
+
+### Styling
+
+- Import nothing from the CSS file — `styleUrl` handles the wiring.
+- Reference tokens via `var(--ds-<category>-<leaf>)`, where `<category>` matches the bucket in `spec.tokens_used` (colors → `--ds-color-*`, spacing → `--ds-spacing-*`, radius → `--ds-radius-*`, font → `--ds-font-*`, shadow → `--ds-shadow-*`).
+- Do NOT reference any token NOT listed in `spec.tokens_used`. Doing so breaks the cross-stack vocabulary contract.
+- Do NOT invent component-local `--ds-<name>-*` custom properties unless the spec's a11y or notes section explicitly says the component should expose overridable defaults; the shared token vocabulary is the contract, component-local props are the exception.
+
+### Accessibility
+
+- Use the native element named by `spec.a11y.native_element` as the outermost host child.
+- Respect `spec.a11y.disabled_semantics` (typically `native_disabled_attribute` — use the native `disabled` attribute, do not fake it with a class).
+- If the spec defines `spec.a11y.keyboard`, ensure the native element handles those keys without adding custom keydown handlers (Enter and Space on `<button>` are native).
+
+## OutputFormat
+
+Return ONLY the file contents, using this exact format for each file:
+
+    === FILE: ds-<name>.tsx ===
+    ```tsx
+    <file contents>
+    ```
+
+    === FILE: ds-<name>.css ===
+    ```css
+    <file contents>
+    ```
+
+Every file MUST be preceded by a `=== FILE: <relative-path> ===` marker on its own line. Paths are relative to `registry/<name>/implementations/stencil/`. Do NOT use absolute paths, `..`, or subdirectories. Do NOT emit any prose outside the fenced code blocks.

package/dist/generators/prompts/vue.md

@@ -0,0 +1,54 @@
+# Stack: Vue 3 (Single-File Components)
+
+## Preamble
+
+You are generating source code for a Vue 3 component. Follow these conventions strictly.
+
+### File shape
+
+Emit exactly one `.vue` Single-File Component per component, named `<PascalName>.vue` where `PascalName` is the spec's `name` in PascalCase (`spec.name = "button"` → `Button.vue`, `spec.name = "code-block"` → `CodeBlock.vue`). The file has three sections in this order: `<script setup lang="ts">`, `<template>`, `<style scoped>`. Do NOT emit a `readme.md`, a `generation.json`, a test file, or any other file.
+
+### Script shape
+
+- Use the Composition API via `<script setup lang="ts">`. Do NOT use the Options API or export a default component.
+- Map `spec.props` to a `defineProps<{ ... }>()` type argument:
+  - `boolean` → `boolean`
+  - `string` → `string`
+  - `number` → `number`
+  - `enum` → string-literal union (`'a' | 'b' | 'c'`)
+  - Optional props (no `default` in the spec) get `?` in the type argument: `href?: string`.
+- When any prop declares a `default`, wrap with `withDefaults`: `const props = withDefaults(defineProps<{ ... }>(), { <name>: <default>, ... })`. When no prop has a default, use plain `defineProps<{ ... }>()` and do NOT import `withDefaults`.
+- Map `spec.events` to `defineEmits<{ (e: '<name>', payload: <Payload>): void }>()`. Use the spec's `payload` string verbatim as `<Payload>` when it names a known DOM/JS type (e.g. `MouseEvent`, `string`), or emit an inline object type when the payload is structured. If `spec.events` is empty or missing, omit `defineEmits` entirely.
+- Only import from `vue` what is actually used. Do NOT pull in `ref`, `reactive`, or `computed` unless the spec's `state_machine` or event handling requires reactive local state.
+
+### Template shape
+
+- The outermost element is the native element named by `spec.a11y.native_element`.
+- When `native_element` names two elements with a conditional (e.g. `"button or a (when href is set)"`), branch with `v-if` / `v-else` at the template root so exactly one native element renders per state. Do NOT wrap the conditional in an extra `<div>` — the root must BE the native element.
+- Render `<slot />` inside the native element when the spec declares a default slot.
+- Bind class names using an object or array binding when they depend on props: `:class="['button', ` `` `button--${props.variant}` `` `]"`. Do NOT use inline styles unless a token cannot express the constraint.
+
+### Styling
+
+- Use `<style scoped>` — no unscoped globals.
+- Reference tokens via `var(--ds-<category>-<leaf>)`, where `<category>` matches the bucket in `spec.tokens_used` (colors → `--ds-color-*`, spacing → `--ds-spacing-*`, radius → `--ds-radius-*`, font → `--ds-font-*`, shadow → `--ds-shadow-*`).
+- Do NOT reference any token NOT listed in `spec.tokens_used`. Doing so breaks the cross-stack vocabulary contract.
+- Use component-local class names WITHOUT the `ds-` prefix (e.g. `.button`, `.button--primary`) — Vue's `scoped` styles handle isolation. The `ds-` prefix is a Web Component tag convention that does not apply here.
+- Do NOT invent component-local `--ds-<name>-*` custom properties unless the spec's a11y or notes section explicitly says the component should expose overridable defaults; the shared token vocabulary is the contract, component-local props are the exception.
+
+### Accessibility
+
+- Use the native element named by `spec.a11y.native_element` as the outermost template child.
+- Respect `spec.a11y.disabled_semantics` (typically `native_disabled_attribute` — bind the native `disabled` attribute directly, do not fake it with a class).
+- If the spec defines `spec.a11y.keyboard`, ensure the native element handles those keys without adding custom `@keydown` handlers (Enter and Space on `<button>` are native).
+
+## OutputFormat
+
+Return ONLY the file contents, using this exact format for each file:
+
+    === FILE: <PascalName>.vue ===
+    ```vue
+    <file contents>
+    ```
+
+Every file MUST be preceded by a `=== FILE: <relative-path> ===` marker on its own line. Paths are relative to `registry/<name>/implementations/vue/`. Do NOT use absolute paths, `..`, or subdirectories. Do NOT emit any prose outside the fenced code blocks.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function main(argv?: string[]): Promise<number>;