@calibrate-ds/cli 0.1.0

package/dist/index.js

@@ -0,0 +1,303 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { createRequire } from "node:module";
+import { registerGenerator, registerAIProvider, MockImplementationProvider, registerDesignToolAdapter, figmaAdapter } from "@calibrate-ds/core";
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
+import { ptbReactGenerator } from "@calibrate-ds/generator-react";
+import { createInitCommand } from "./commands/init.js";
+import { scanCommand } from "./commands/scan.js";
+import { diffCommand } from "./commands/diff.js";
+import { importTokensCommand } from "./commands/import-tokens.js";
+import { generateTokensCommand } from "./commands/generate-tokens.js";
+import { generateComponentsCommand } from "./commands/generate-components.js";
+import { contextComponentCommand, contextListCommand, contextResolveCommand, contextOpenCommand } from "./commands/context.js";
+import { planCommand, planImplementCommand } from "./commands/plan.js";
+import { applyCommand } from "./commands/apply.js";
+import { pruneCommand } from "./commands/prune.js";
+import { promptComponentCommand } from "./commands/prompt.js";
+import { implementComponentCommand } from "./commands/implement.js";
+import { exportContextCommand, exportContextComponentCommand } from "./commands/export.js";
+import { learnCommand, flowCommand } from "./commands/onboarding.js";
+import { statusCommand } from "./commands/status.js";
+import { stampComponentCommand } from "./commands/stamp.js";
+import { assignCommand } from "./commands/assign.js";
+import { logCommand } from "./commands/log.js";
+import { joinCommand, teamCommand, teamRoleCommand } from "./commands/team.js";
+import { doctorCommand, doctorComponentCommand, doctorTokensCommand, doctorContextCommand } from "./commands/doctor.js";
+import { aiStatusCommand, aiProvidersCommand, aiListCommand, aiSetupCommand, aiUseCommand, aiRemoveCommand, aiModelCommand } from "./commands/ai.js";
+import { documentComponentCommand } from "./commands/document.js";
+import { documentSystemCommand } from "./commands/document-system.js";
+import { ciSetupCommand } from "./commands/ci.js";
+import { removeCommand } from "./commands/remove.js";
+import { helpCommand } from "./commands/help-topics.js";
+import { ClaudeProvider } from "./ai/claude-provider.js";
+import { OpenAIProvider } from "./ai/openai-provider.js";
+// Register default design tool adapters
+registerDesignToolAdapter(figmaAdapter);
+// Register default generators
+registerGenerator("react", ptbReactGenerator);
+// Register built-in AI providers
+registerAIProvider("mock", () => new MockImplementationProvider());
+registerAIProvider("claude", (apiKey, model) => new ClaudeProvider(apiKey, model));
+registerAIProvider("openai", (apiKey, model) => new OpenAIProvider(apiKey, model));
+const program = new Command();
+program
+    .name("ptb")
+    .description("Calibrate: Local-first Design System Compiler")
+    .version(version)
+    .addHelpText("after", `
+Quick Start:
+  ptb init                              Set up ptb.config.json in your project
+  ptb scan                              Fetch the design system snapshot from Figma
+  ptb generate-components               Scaffold typed React shells from the snapshot
+  ptb generate-tokens                   Generate CSS design tokens
+  ptb export context                    Write .ptb/context/ files for AI IDEs (commit these)
+  ptb context component <name>          View rich design context for a component
+  ptb implement component <name>        AI-write a component using design context
+  ptb document component <name>         Generate MDX docs for a component
+  ptb ai setup                          Connect an AI provider (claude / openai)
+  ptb status                            Check component freshness vs. latest design
+  ptb doctor component .                Audit health of all components
+
+Run 'ptb <command> --help' for sub-command details.
+Run 'ptb guide <topic>' for a focused workflow reference.  Topics: setup · context · implement · document · status · team · ai · doctor · ci`);
+program.addCommand(createInitCommand());
+program
+    .command("status")
+    .description("Check the freshness of implemented components against the latest design context")
+    .option("--fail-on-stale", "Exit with code 1 if any component is stale or has errors (for CI)")
+    .option("--json", "Output results as JSON")
+    .option("--mine", "Show only components assigned to you")
+    .option("--team", "Show workload distribution grouped by assignee")
+    .action((opts) => statusCommand({ failOnStale: opts.failOnStale, json: opts.json, mine: opts.mine, team: opts.team }));
+const stampProgram = program
+    .command("stamp")
+    .description("Record that a component has been implemented to match the current design");
+stampProgram
+    .command("component <name>")
+    .description("Stamp a component as implemented. Use '.' for all components.")
+    .option("-m <message>", "Note describing what was implemented or changed")
+    .action((name, opts) => stampComponentCommand(name, { m: opts.m }));
+program
+    .command("assign <name> [person]")
+    .description("Assign a component to a developer. Use '.' for all pending. Defaults to current git user.")
+    .option("--clear", "Remove the assignment")
+    .action((name, person, opts) => assignCommand(name, { to: person, clear: opts.clear }));
+program
+    .command("log")
+    .description("Show history of design changes and stamps from git")
+    .option("-n <number>", "Number of entries to show (default 30)", parseInt)
+    .action((opts) => logCommand({ n: opts.n }));
+program
+    .command("join")
+    .description("Register yourself in the team roster (ptb-team.json) so others can assign work to you")
+    .action(joinCommand);
+const teamProgram = program
+    .command("team")
+    .description("Show the team roster with stamp counts and assigned workload")
+    .action(teamCommand);
+teamProgram
+    .command("role <handle> <role>")
+    .description("Set a team member's role: lead or member. Only leads can run this.")
+    .action(teamRoleCommand);
+program
+    .command("learn")
+    .description("Rich onboarding walkthrough and troubleshooting for PTB")
+    .action(learnCommand);
+const flowProgram = program
+    .command("flow")
+    .description("Step-by-step action guides for different PTB workflows");
+flowProgram
+    .command("direct")
+    .description("Checklist for the Direct Fetch workflow (Organization / Enterprise)")
+    .action(() => flowCommand("direct"));
+flowProgram
+    .command("plugin")
+    .description("Checklist for the Plugin Export workflow (Figma Pro — requires Calibrate plugin)")
+    .action(() => flowCommand("plugin"));
+program
+    .command("import-tokens <path>")
+    .description("Import a PTB-friendly token JSON export into the local project")
+    .action(importTokensCommand);
+program
+    .command("diff")
+    .description("Show design changes not yet stamped. Uses stamp baseline when available so changes are never lost across multiple scans.")
+    .action(diffCommand);
+const planProgram = program
+    .command("plan")
+    .description("Plan likely affected generated files based on design changes from the previous snapshot")
+    .action(planCommand);
+planProgram
+    .command("implement <name>")
+    .description("Plan the implementation order and readiness for a specific component")
+    .action(planImplementCommand);
+program
+    .command("apply")
+    .description("Safely regenerate only the generated files affected by design changes")
+    .option("-p, --prune", "Remove stale generated component folders during apply")
+    .action(applyCommand);
+program
+    .command("prune")
+    .description("Remove stale generated component folders that are no longer in the design system")
+    .action(pruneCommand);
+const ciProgram = program
+    .command("ci")
+    .description("CI/CD integration utilities");
+ciProgram
+    .command("setup")
+    .description("Generate a GitHub Actions workflow that checks PTB component freshness on every PR")
+    .option("--force", "Overwrite an existing ptb.yml workflow file")
+    .action((opts) => ciSetupCommand({ force: opts.force }));
+program
+    .command("scan")
+    .description("Scan the Figma design system and save the raw model")
+    .action(scanCommand);
+program
+    .command("generate-tokens")
+    .description("Deterministically scaffold design system tokens based on current snapshot model variables")
+    .action(generateTokensCommand);
+program
+    .command("generate-components [name]")
+    .description("Scaffold typed React components. Use '.' for all, or provide a component name.")
+    .option("--force", "Overwrite existing files")
+    .action(generateComponentsCommand);
+// Clean subcommand aliases: ptb generate components / ptb generate tokens
+const generateProgram = program
+    .command("generate")
+    .description("Generate design system artifacts from the latest snapshot");
+generateProgram
+    .command("components [name]")
+    .description("Scaffold typed components (alias for generate-components). Use '.' for all.")
+    .option("--force", "Overwrite existing files")
+    .action(generateComponentsCommand);
+generateProgram
+    .command("tokens")
+    .description("Scaffold design tokens (alias for generate-tokens)")
+    .action(generateTokensCommand);
+// NEW: Context Command
+const contextProgram = program
+    .command("context")
+    .description("Query design system context  e.g. ptb context component Button  or  ptb context component .");
+contextProgram
+    .command("component <name>")
+    .description("Retrieve rich context for a component. Use '.' for a summary of all components.  e.g. ptb context component Button")
+    .option("--json", "Output results in clean, structured JSON")
+    .action(contextComponentCommand);
+contextProgram
+    .command("list")
+    .description("List all exported component context files")
+    .action(contextListCommand);
+contextProgram
+    .command("resolve <query>")
+    .description("Resolve a component query to its context file")
+    .action(contextResolveCommand);
+contextProgram
+    .command("open <query>")
+    .description("Resolve a component and print ONLY the context file path")
+    .action(contextOpenCommand);
+// NEW: Prompt Command
+const promptProgram = program
+    .command("prompt")
+    .description("Generate AI implementation prompts from design context");
+promptProgram
+    .command("component <name>")
+    .description("Generate an AI-ready implementation prompt for a specific component")
+    .option("-f, --framework <name>", "Target framework for the prompt (e.g. react, vue, flutter)")
+    .option("--format <format>", "Output format: text (default) or json")
+    .action(promptComponentCommand);
+// NEW: Implement Command
+const implementProgram = program
+    .command("implement")
+    .description("AI-write components from design context  e.g. ptb implement component Button");
+implementProgram
+    .command("component <name>")
+    .description("Implement a component using AI. Use '.' for all.  e.g. ptb implement component Button")
+    .option("-f, --framework <name>", "Target framework (e.g. react, vue, flutter)")
+    .option("--force", "Overwrite existing files")
+    .action(implementComponentCommand);
+// NEW: Export Command
+const exportProgram = program
+    .command("export")
+    .description("Export design system artifacts for external tools");
+const exportContextProgram = exportProgram
+    .command("context")
+    .description("Write .ptb/context/ files for AI IDEs — run this after scan so AI can read component intent  e.g. ptb export context")
+    .action(exportContextCommand);
+exportContextProgram
+    .command("component <name>")
+    .description("Export context for a specific component")
+    .action(exportContextComponentCommand);
+// Doctor Command
+const doctorProgram = program
+    .command("doctor")
+    .description("Audit the health of your design system and component context richness")
+    .action(doctorCommand);
+doctorProgram
+    .command("component <name>")
+    .description("Deep health audit for a component. Use '.' for all components scorecard.")
+    .action(doctorComponentCommand);
+doctorProgram
+    .command("context <name>")
+    .description("Score context quality for AI IDEs. Use '.' for all components.")
+    .action(doctorContextCommand);
+doctorProgram
+    .command("tokens")
+    .description("Check token coverage and resolution across the design system")
+    .action(doctorTokensCommand);
+// AI Command
+const aiProgram = program
+    .command("ai")
+    .description("Manage AI provider configuration and verify setup")
+    .action(aiStatusCommand);
+aiProgram
+    .command("list")
+    .description("List all saved AI providers and which is active")
+    .action(aiListCommand);
+aiProgram
+    .command("providers")
+    .description("Alias for 'ai list'")
+    .action(aiProvidersCommand);
+aiProgram
+    .command("use <provider>")
+    .description("Switch the active AI provider")
+    .action(aiUseCommand);
+aiProgram
+    .command("setup")
+    .description("Add or reconfigure an AI provider interactively")
+    .action(aiSetupCommand);
+aiProgram
+    .command("remove <provider>")
+    .description("Remove a saved AI provider config")
+    .action(aiRemoveCommand);
+aiProgram
+    .command("model [model-id]")
+    .description("Change the model for the active provider (interactive if no model-id given)")
+    .action(aiModelCommand);
+// Document Command
+const documentProgram = program
+    .command("document")
+    .description("Generate MDX docs and Storybook stories  e.g. ptb document component Button  or  ptb document system");
+documentProgram
+    .command("component <name>")
+    .description("Generate docs for a component. Use '.' for all components.")
+    .option("--force", "Overwrite existing docs")
+    .option("--no-ai", "Skip AI prose enhancement, output deterministic tables only")
+    .option("--format <format>", "Skip prompt: mdx | stories | both")
+    .action(documentComponentCommand);
+documentProgram
+    .command("system")
+    .description("Generate CLAUDE.md and components.md at the DS package root")
+    .option("--force", "Overwrite existing files")
+    .option("--no-ai", "Skip AI intent map generation")
+    .action(documentSystemCommand);
+program
+    .command("remove")
+    .description("Remove all PTB configuration and metadata from this project")
+    .action(removeCommand);
+program
+    .command("guide [topic]")
+    .description("Detailed workflow guide for a feature area. Topics: setup, context, implement, document, status, team, ai, doctor, ci")
+    .action((topic) => helpCommand(topic));
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/onboarding/content.d.ts

@@ -0,0 +1,39 @@
+export declare const LEARN_CONTENT: {
+    intro: {
+        title: string;
+        description: string;
+    };
+    prerequisites: {
+        item: string;
+        detail: string;
+    }[];
+    workflowOverview: string[];
+    pluginWorkflow: string[];
+    directWorkflow: string[];
+    tokenImport: {
+        description: string;
+        manualCommand: string;
+        pluginPath: string;
+    };
+};
+export declare const FLOW_DIRECT: {
+    before: string;
+    steps: {
+        step: number;
+        action: string;
+        command: string;
+    }[];
+};
+export declare const FLOW_PLUGIN: {
+    before: string;
+    steps: {
+        step: number;
+        action: string;
+        command: string;
+    }[];
+};
+export declare const TROUBLESHOOTING: {
+    issue: string;
+    fix: string;
+}[];
+//# sourceMappingURL=content.d.ts.map

package/dist/onboarding/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/onboarding/content.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;CAqCzB,CAAC;AAEF,eAAO,MAAM,WAAW;;;;;;;CASvB,CAAC;AAEF,eAAO,MAAM,WAAW;;;;;;;CAUvB,CAAC;AAEF,eAAO,MAAM,eAAe;;;GAqB3B,CAAC"}

package/dist/onboarding/content.js

@@ -0,0 +1,82 @@
+export const LEARN_CONTENT = {
+    intro: {
+        title: "Welcome to Calibrate",
+        description: "PTB is a local-first design system compiler that bridges the gap between Figma and your codebase. It scans your Figma designs, builds a rich design system model, and exports AI-ready context for seamless implementation."
+    },
+    prerequisites: [
+        { item: "PTB CLI", detail: "Installed and linked globally" },
+        { item: "Figma Personal Access Token", detail: "Generate one in your Figma Account Settings" },
+        { item: "Figma File Key", detail: "In a URL like figma.com/design/\x1b[1m<FILE_KEY>\x1b[0m/..., use the \x1b[1m<FILE_KEY>\x1b[0m part" },
+        { item: "Calibrate (Figma plugin)", detail: "Required for the Plugin Export Workflow (Figma Pro). Install from the Figma plugin marketplace." }
+    ],
+    workflowOverview: [
+        "Initialize your project: \x1b[1mptb init\x1b[0m",
+        "Scan your Figma design: \x1b[1mptb scan\x1b[0m",
+        "Export AI-ready context: \x1b[1mptb export context\x1b[0m",
+        "List available components: \x1b[1mptb context list\x1b[0m",
+        "Resolve a specific component: \x1b[1mptb context resolve <component>\x1b[0m"
+    ],
+    pluginWorkflow: [
+        "Use the Calibrate Figma plugin to export variables/tokens.",
+        "Save the export to: \x1b[1m.ptb/imported-tokens.json\x1b[0m",
+        "Or use: \x1b[1mptb import-tokens <path>\x1b[0m",
+        "Run \x1b[1mptb scan\x1b[0m to sync design changes.",
+        "Run \x1b[1mptb apply\x1b[0m to regenerate affected code."
+    ],
+    directWorkflow: [
+        "Note: No Figma plugin is required for this mode.",
+        "PTB fetches the needed design/token data directly from the Figma API.",
+        "Run \x1b[1mptb scan\x1b[0m to fetch and sync Figma state.",
+        "Run \x1b[1mptb apply\x1b[0m to update your local UI library.",
+        "Use \x1b[1mptb diff\x1b[0m to inspect incoming design changes."
+    ],
+    tokenImport: {
+        description: "PTB favors a deterministic token pipeline. Use the Calibrate Figma plugin to export design tokens directly if you are on Figma Pro.",
+        manualCommand: "ptb import-tokens <path/to/tokens.json>",
+        pluginPath: ".ptb/imported-tokens.json"
+    }
+};
+export const FLOW_DIRECT = {
+    before: "Setup: Direct Fetch Workflow (Organization / Enterprise). No plugin required.",
+    steps: [
+        { step: 1, action: "Run \x1b[1mptb init\x1b[0m to set up your configuration.", command: "ptb init" },
+        { step: 2, action: "Run \x1b[1mptb scan\x1b[0m to fetch design data via API.", command: "ptb scan" },
+        { step: 3, action: "Run \x1b[1mptb export context\x1b[0m to generate AI-ready JSON files.", command: "ptb export context" },
+        { step: 4, action: "Use \x1b[1mptb context list\x1b[0m to see what was exported.", command: "ptb context list" },
+        { step: 5, action: "Feed context files to your AI IDE for implementation.", command: "ptb context resolve <name>" }
+    ]
+};
+export const FLOW_PLUGIN = {
+    before: "Setup: Plugin Export Workflow (Figma Pro). Requires the Calibrate Figma plugin.",
+    steps: [
+        { step: 1, action: "Install the \x1b[1mCalibrate\x1b[0m plugin from the Figma marketplace.", command: "Figma Plugin Marketplace" },
+        { step: 2, action: "Export tokens from Figma using Calibrate.", command: "Figma → Calibrate → Export" },
+        { step: 3, action: "Place the export at \x1b[1m.ptb/imported-tokens.json\x1b[0m.", command: "ptb import-tokens <path>" },
+        { step: 4, action: "Run \x1b[1mptb scan\x1b[0m to sync Figma state.", command: "ptb scan" },
+        { step: 5, action: "Run \x1b[1mptb apply\x1b[0m to update your local UI library.", command: "ptb apply" },
+        { step: 6, action: "Use \x1b[1mptb diff\x1b[0m to inspect incoming design changes.", command: "ptb diff" }
+    ]
+};
+export const TROUBLESHOOTING = [
+    {
+        issue: "ptb.config.json missing",
+        fix: "Run \x1b[1mptb init\x1b[0m to generate a base configuration."
+    },
+    {
+        issue: "imported tokens missing",
+        fix: "Ensure tokens are at \x1b[1m.ptb/imported-tokens.json\x1b[0m or run \x1b[1mptb import-tokens <path>\x1b[0m."
+    },
+    {
+        issue: "latest snapshot missing",
+        fix: "You need to run \x1b[1mptb scan\x1b[0m at least once to create a local design snapshot."
+    },
+    {
+        issue: "context files not exported yet",
+        fix: "Run \x1b[1mptb export context\x1b[0m to generate the JSON files used by list/resolve commands."
+    },
+    {
+        issue: "CLI command not found",
+        fix: "Ensure you have the latest version installed and linked:\n    \x1b[1mpnpm --filter @calibrate-ds/cli link --global\x1b[0m"
+    }
+];
+//# sourceMappingURL=content.js.map

package/dist/onboarding/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/onboarding/content.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,KAAK,EAAE;QACH,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,6NAA6N;KAC7O;IACD,aAAa,EAAE;QACX,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,+BAA+B,EAAE;QAC5D,EAAE,IAAI,EAAE,6BAA6B,EAAE,MAAM,EAAE,6CAA6C,EAAE;QAC9F,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,oGAAoG,EAAE;QACxI,EAAE,IAAI,EAAE,0BAA0B,EAAE,MAAM,EAAE,iGAAiG,EAAE;KAClJ;IACD,gBAAgB,EAAE;QACd,iDAAiD;QACjD,gDAAgD;QAChD,2DAA2D;QAC3D,2DAA2D;QAC3D,6EAA6E;KAChF;IACD,cAAc,EAAE;QACZ,4DAA4D;QAC5D,6DAA6D;QAC7D,gDAAgD;QAChD,oDAAoD;QACpD,0DAA0D;KAC7D;IACD,cAAc,EAAE;QACZ,kDAAkD;QAClD,uEAAuE;QACvE,2DAA2D;QAC3D,8DAA8D;QAC9D,gEAAgE;KACnE;IACD,WAAW,EAAE;QACT,WAAW,EAAE,qIAAqI;QAClJ,aAAa,EAAE,yCAAyC;QACxD,UAAU,EAAE,2BAA2B;KAC1C;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,MAAM,EAAE,+EAA+E;IACvF,KAAK,EAAE;QACH,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,0DAA0D,EAAE,OAAO,EAAE,UAAU,EAAE;QACpG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,0DAA0D,EAAE,OAAO,EAAE,UAAU,EAAE;QACpG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,uEAAuE,EAAE,OAAO,EAAE,oBAAoB,EAAE;QAC3H,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,8DAA8D,EAAE,OAAO,EAAE,kBAAkB,EAAE;QAChH,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,uDAAuD,EAAE,OAAO,EAAE,4BAA4B,EAAE;KACtH;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,MAAM,EAAE,iFAAiF;IACzF,KAAK,EAAE;QACH,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,wEAAwE,EAAE,OAAO,EAAE,0BAA0B,EAAE;QAClI,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,2CAA2C,EAAE,OAAO,EAAE,4BAA4B,EAAE;QACvG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,8DAA8D,EAAE,OAAO,EAAE,0BAA0B,EAAE;QACxH,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,iDAAiD,EAAE,OAAO,EAAE,UAAU,EAAE;QAC3F,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,8DAA8D,EAAE,OAAO,EAAE,WAAW,EAAE;QACzG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,gEAAgE,EAAE,OAAO,EAAE,UAAU,EAAE;KAC7G;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B;QACI,KAAK,EAAE,yBAAyB;QAChC,GAAG,EAAE,8DAA8D;KACtE;IACD;QACI,KAAK,EAAE,yBAAyB;QAChC,GAAG,EAAE,6GAA6G;KACrH;IACD;QACI,KAAK,EAAE,yBAAyB;QAChC,GAAG,EAAE,yFAAyF;KACjG;IACD;QACI,KAAK,EAAE,gCAAgC;QACvC,GAAG,EAAE,gGAAgG;KACxG;IACD;QACI,KAAK,EAAE,uBAAuB;QAC9B,GAAG,EAAE,2HAA2H;KACnI;CACJ,CAAC"}

package/dist/utils/component-slug.d.ts

@@ -0,0 +1,10 @@
+/** Normalize a component name or display name into a ptb.lock slug. */
+export declare function toComponentSlug(name: string): string;
+/**
+ * Find the ptb.lock key matching a name (by slug or display name).
+ * Returns undefined when no component matches.
+ */
+export declare function findComponentSlug(name: string, components: Record<string, {
+    displayName: string;
+}>): string | undefined;
+//# sourceMappingURL=component-slug.d.ts.map

package/dist/utils/component-slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-slug.d.ts","sourceRoot":"","sources":["../../src/utils/component-slug.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GACpD,MAAM,GAAG,SAAS,CAKpB"}

package/dist/utils/component-slug.js

@@ -0,0 +1,13 @@
+/** Normalize a component name or display name into a ptb.lock slug. */
+export function toComponentSlug(name) {
+    return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+/**
+ * Find the ptb.lock key matching a name (by slug or display name).
+ * Returns undefined when no component matches.
+ */
+export function findComponentSlug(name, components) {
+    const slug = toComponentSlug(name);
+    return Object.keys(components).find(k => k === slug || components[k].displayName.toLowerCase() === name.toLowerCase());
+}
+//# sourceMappingURL=component-slug.js.map

package/dist/utils/component-slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-slug.js","sourceRoot":"","sources":["../../src/utils/component-slug.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC7B,IAAY,EACZ,UAAmD;IAEnD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAC/B,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CACpF,CAAC;AACN,CAAC"}

package/dist/utils/framework-registry.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Framework registry — single source of truth for every framework PTB knows about.
+ * Adding a new framework: add one entry to FRAMEWORKS, everything else adapts.
+ */
+export type FrameworkId = "react" | "vue" | "svelte" | "react-native";
+export type FrameworkDefinition = {
+    /** Stable identifier used in ptb.config.json */
+    id: FrameworkId;
+    displayName: string;
+    /** Any of these deps in a package.json → this framework is detected */
+    detectionDeps: string[];
+    /** Runtime deps for a new component library package */
+    runtimeDeps: string[];
+    /** Dev deps for a new component library package */
+    devDeps: string[];
+    /** Peer deps to declare in the library's package.json */
+    peerDeps: string[];
+    /** Storybook framework packages — null means no web Storybook support */
+    storybookVite: string | null;
+    storybookWebpack: string | null;
+    /** Source file extension for generated components */
+    fileExtension: string;
+    /** tsconfig jsx setting — undefined means no jsx needed */
+    tsconfigJsx?: string;
+    /** Whether a PTB code generator exists for this framework */
+    hasGenerator: boolean;
+};
+export declare const FRAMEWORKS: Record<FrameworkId, FrameworkDefinition>;
+export declare const FRAMEWORK_LIST: FrameworkDefinition[];
+export declare function getFramework(id: string): FrameworkDefinition | undefined;
+/**
+ * Detect framework from a merged deps object.
+ * react-native is checked first because RN packages also include "react".
+ */
+export declare function detectFrameworkFromDeps(deps: Record<string, string>): FrameworkDefinition | undefined;
+/**
+ * Return the right Storybook framework package given a bundler.
+ * Returns null if the framework has no web Storybook support (e.g. React Native).
+ */
+export declare function storybookPackageFor(fw: FrameworkDefinition, bundler: "vite" | "webpack"): string | null;
+//# sourceMappingURL=framework-registry.d.ts.map

package/dist/utils/framework-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-registry.d.ts","sourceRoot":"","sources":["../../src/utils/framework-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,cAAc,CAAC;AAEtE,MAAM,MAAM,mBAAmB,GAAG;IAC9B,gDAAgD;IAChD,EAAE,EAAE,WAAW,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,uDAAuD;IACvD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mDAAmD;IACnD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yEAAyE;IACzE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,YAAY,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,WAAW,EAAE,mBAAmB,CAoD/D,CAAC;AAEF,eAAO,MAAM,cAAc,uBAA4B,CAAC;AAExD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAExE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,mBAAmB,GAAG,SAAS,CAOjC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAC/B,EAAE,EAAE,mBAAmB,EACvB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,GAAG,IAAI,CAEf"}

package/dist/utils/framework-registry.js

@@ -0,0 +1,82 @@
+/**
+ * Framework registry — single source of truth for every framework PTB knows about.
+ * Adding a new framework: add one entry to FRAMEWORKS, everything else adapts.
+ */
+export const FRAMEWORKS = {
+    react: {
+        id: "react",
+        displayName: "React",
+        detectionDeps: ["react"],
+        runtimeDeps: ["react", "react-dom"],
+        devDeps: ["@types/react", "@types/react-dom", "typescript"],
+        peerDeps: ["react", "react-dom"],
+        storybookVite: "@storybook/react-vite",
+        storybookWebpack: "@storybook/react-webpack5",
+        fileExtension: "tsx",
+        tsconfigJsx: "react-jsx",
+        hasGenerator: true,
+    },
+    vue: {
+        id: "vue",
+        displayName: "Vue 3",
+        detectionDeps: ["vue"],
+        runtimeDeps: ["vue"],
+        devDeps: ["@vue/tsconfig", "typescript", "vue-tsc"],
+        peerDeps: ["vue"],
+        storybookVite: "@storybook/vue3-vite",
+        storybookWebpack: null,
+        fileExtension: "vue",
+        hasGenerator: false,
+    },
+    svelte: {
+        id: "svelte",
+        displayName: "Svelte",
+        detectionDeps: ["svelte"],
+        runtimeDeps: ["svelte"],
+        devDeps: ["@sveltejs/vite-plugin-svelte", "svelte-check", "typescript"],
+        peerDeps: ["svelte"],
+        storybookVite: "@storybook/svelte-vite",
+        storybookWebpack: null,
+        fileExtension: "svelte",
+        hasGenerator: false,
+    },
+    "react-native": {
+        id: "react-native",
+        displayName: "React Native",
+        // Check react-native before react since RN projects also have "react"
+        detectionDeps: ["react-native"],
+        runtimeDeps: ["react", "react-native"],
+        devDeps: ["@types/react", "@types/react-native", "typescript"],
+        peerDeps: ["react", "react-native"],
+        storybookVite: null,
+        storybookWebpack: null,
+        fileExtension: "tsx",
+        tsconfigJsx: "react-native",
+        hasGenerator: false,
+    },
+};
+export const FRAMEWORK_LIST = Object.values(FRAMEWORKS);
+export function getFramework(id) {
+    return FRAMEWORKS[id];
+}
+/**
+ * Detect framework from a merged deps object.
+ * react-native is checked first because RN packages also include "react".
+ */
+export function detectFrameworkFromDeps(deps) {
+    const order = ["react-native", "react", "vue", "svelte"];
+    for (const id of order) {
+        const fw = FRAMEWORKS[id];
+        if (fw.detectionDeps.some(dep => dep in deps))
+            return fw;
+    }
+    return undefined;
+}
+/**
+ * Return the right Storybook framework package given a bundler.
+ * Returns null if the framework has no web Storybook support (e.g. React Native).
+ */
+export function storybookPackageFor(fw, bundler) {
+    return bundler === "vite" ? fw.storybookVite : fw.storybookWebpack;
+}
+//# sourceMappingURL=framework-registry.js.map

package/dist/utils/framework-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-registry.js","sourceRoot":"","sources":["../../src/utils/framework-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2BH,MAAM,CAAC,MAAM,UAAU,GAA6C;IAChE,KAAK,EAAE;QACH,EAAE,EAAE,OAAO;QACX,WAAW,EAAE,OAAO;QACpB,aAAa,EAAE,CAAC,OAAO,CAAC;QACxB,WAAW,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;QACnC,OAAO,EAAE,CAAC,cAAc,EAAE,kBAAkB,EAAE,YAAY,CAAC;QAC3D,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;QAChC,aAAa,EAAE,uBAAuB;QACtC,gBAAgB,EAAE,2BAA2B;QAC7C,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,WAAW;QACxB,YAAY,EAAE,IAAI;KACrB;IACD,GAAG,EAAE;QACD,EAAE,EAAE,KAAK;QACT,WAAW,EAAE,OAAO;QACpB,aAAa,EAAE,CAAC,KAAK,CAAC;QACtB,WAAW,EAAE,CAAC,KAAK,CAAC;QACpB,OAAO,EAAE,CAAC,eAAe,EAAE,YAAY,EAAE,SAAS,CAAC;QACnD,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,aAAa,EAAE,sBAAsB;QACrC,gBAAgB,EAAE,IAAI;QACtB,aAAa,EAAE,KAAK;QACpB,YAAY,EAAE,KAAK;KACtB;IACD,MAAM,EAAE;QACJ,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,QAAQ;QACrB,aAAa,EAAE,CAAC,QAAQ,CAAC;QACzB,WAAW,EAAE,CAAC,QAAQ,CAAC;QACvB,OAAO,EAAE,CAAC,8BAA8B,EAAE,cAAc,EAAE,YAAY,CAAC;QACvE,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,aAAa,EAAE,wBAAwB;QACvC,gBAAgB,EAAE,IAAI;QACtB,aAAa,EAAE,QAAQ;QACvB,YAAY,EAAE,KAAK;KACtB;IACD,cAAc,EAAE;QACZ,EAAE,EAAE,cAAc;QAClB,WAAW,EAAE,cAAc;QAC3B,sEAAsE;QACtE,aAAa,EAAE,CAAC,cAAc,CAAC;QAC/B,WAAW,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC;QACtC,OAAO,EAAE,CAAC,cAAc,EAAE,qBAAqB,EAAE,YAAY,CAAC;QAC9D,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC;QACnC,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,IAAI;QACtB,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,cAAc;QAC3B,YAAY,EAAE,KAAK;KACtB;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAExD,MAAM,UAAU,YAAY,CAAC,EAAU;IACnC,OAAO,UAAU,CAAC,EAAiB,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACnC,IAA4B;IAE5B,MAAM,KAAK,GAAkB,CAAC,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACxE,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACrB,MAAM,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAC/B,EAAuB,EACvB,OAA2B;IAE3B,OAAO,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC;AACvE,CAAC"}

package/dist/utils/gitignore.d.ts

@@ -0,0 +1,4 @@
+/** Remove PTB-added entries from .gitignore (used by ptb remove). */
+export declare function removePtbGitignoreEntries(cwd: string): Promise<void>;
+export declare function ensureGitignore(cwd: string): Promise<void>;
+//# sourceMappingURL=gitignore.d.ts.map

package/dist/utils/gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/utils/gitignore.ts"],"names":[],"mappings":"AAkCA,qEAAqE;AACrE,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU1E;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhE"}