@calibrate-ds/core 0.1.0

package/dist/docs/generate-component-stories.js

@@ -0,0 +1,116 @@
+function toPropName(name) {
+    return name
+        .replace(/[-_]/g, " ")
+        .replace(/[^a-zA-Z0-9 ]/g, "")
+        .split(/\s+/)
+        .filter(Boolean)
+        .map((w, i) => i === 0
+        ? w.charAt(0).toLowerCase() + w.slice(1)
+        : w.charAt(0).toUpperCase() + w.slice(1))
+        .join("");
+}
+function toStoryName(value) {
+    return value
+        .replace(/[-_]/g, " ")
+        .replace(/[^a-zA-Z0-9 ]/g, "")
+        .split(/\s+/)
+        .filter(Boolean)
+        .map(w => w.charAt(0).toUpperCase() + w.slice(1))
+        .join("");
+}
+function buildFigmaUrl(fileKey, nodeId) {
+    const encoded = nodeId.replace(/:/g, "%3A");
+    return `https://www.figma.com/design/${fileKey}?node-id=${encoded}`;
+}
+export function generateComponentStories(context, componentName, fileKey) {
+    const lines = [];
+    const designToolNodeId = context.component.designToolNodeId;
+    const figmaUrl = designToolNodeId ? buildFigmaUrl(fileKey, designToolNodeId) : null;
+    const description = context.component.description || "";
+    const category = context.component.categoryPath
+        ? `${context.component.categoryPath}/${componentName}`
+        : `Components/${componentName}`;
+    // ── Imports ───────────────────────────────────────────────────────────────
+    lines.push(`import type { Meta, StoryObj } from "@storybook/react";`);
+    lines.push(`import { ${componentName} } from "./${componentName}";`);
+    lines.push("");
+    // ── Meta ──────────────────────────────────────────────────────────────────
+    if (description) {
+        lines.push(`/**`);
+        lines.push(` * ${description}`);
+        if (figmaUrl)
+            lines.push(` * @figma ${figmaUrl}`);
+        lines.push(` */`);
+    }
+    lines.push(`const meta: Meta<typeof ${componentName}> = {`);
+    lines.push(`    title: "${category}",`);
+    lines.push(`    component: ${componentName},`);
+    lines.push(`    tags: ["autodocs"],`);
+    if (figmaUrl) {
+        lines.push(`    parameters: {`);
+        lines.push(`        design: {`);
+        lines.push(`            type: "figma",`);
+        lines.push(`            url: "${figmaUrl}",`);
+        lines.push(`        },`);
+        lines.push(`    },`);
+    }
+    lines.push(`};`);
+    lines.push("");
+    lines.push(`export default meta;`);
+    lines.push(`type Story = StoryObj<typeof ${componentName}>;`);
+    lines.push("");
+    // ── Default story — uses defaultValues from all axes ──────────────────────
+    const defaultArgs = {};
+    for (const axis of (context.variantAxes ?? [])) {
+        if (axis.defaultValue !== undefined) {
+            defaultArgs[toPropName(axis.name)] = String(axis.defaultValue);
+        }
+    }
+    lines.push(`export const Default: Story = {`);
+    if (Object.keys(defaultArgs).length > 0) {
+        lines.push(`    args: {`);
+        for (const [k, v] of Object.entries(defaultArgs)) {
+            lines.push(`        ${k}: "${v}",`);
+        }
+        lines.push(`    },`);
+    }
+    lines.push(`};`);
+    lines.push("");
+    const usedNames = new Set(["Default"]);
+    // ── One story per option on the primary axis (first non-state axis) ───────
+    const primaryAxis = (context.variantAxes ?? []).find(ax => {
+        const n = ax.name.toLowerCase();
+        return n !== "state" && n !== "status" && n !== "disabled";
+    });
+    if (primaryAxis && primaryAxis.options.length > 1) {
+        const propName = toPropName(primaryAxis.name);
+        for (const option of primaryAxis.options) {
+            const storyName = toStoryName(option);
+            if (!storyName || storyName.toLowerCase() === "default")
+                continue;
+            if (usedNames.has(storyName))
+                continue;
+            usedNames.add(storyName);
+            lines.push(`export const ${storyName}: Story = {`);
+            lines.push(`    args: { ...Default.args, ${propName}: "${option}" },`);
+            lines.push(`};`);
+            lines.push("");
+        }
+    }
+    // ── Boolean props as dedicated stories (skip names already used above) ────
+    for (const prop of (context.properties ?? [])) {
+        if (prop.type !== "boolean")
+            continue;
+        const propName = toPropName(prop.name);
+        const storyName = toStoryName(prop.name);
+        if (!storyName || usedNames.has(storyName))
+            continue;
+        usedNames.add(storyName);
+        lines.push(`export const ${storyName}: Story = {`);
+        lines.push(`    args: { ...Default.args, ${propName}: true },`);
+        lines.push(`};`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=generate-component-stories.js.map

package/dist/docs/generate-component-stories.js.map

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

package/dist/docs/generate-system-doc.d.ts

@@ -0,0 +1,23 @@
+import type { DesignSystemModel, ComponentDefinition } from "@calibrate-ds/shared-types";
+import type { PTBConfig } from "@calibrate-ds/shared-types";
+export type IntentEntry = {
+    intent: string;
+    component: string;
+    importPath: string;
+    note?: string;
+};
+export declare function buildImportPathMap(snapshot: DesignSystemModel, config: PTBConfig): Map<string, string>;
+export declare function generateDeterministicIntentTable(components: ComponentDefinition[], config: PTBConfig): IntentEntry[];
+/**
+ * Builds a reverse dependency map: componentId → names of components that depend on it.
+ */
+export declare function buildReverseDepsMap(snapshot: DesignSystemModel): Map<string, string[]>;
+/**
+ * Generates an AI.md file for the design system package root.
+ */
+export declare function generateSystemClaude(snapshot: DesignSystemModel, config: PTBConfig, scannedAt?: string): string;
+/**
+ * Generates a components.md intent index — maps user intent to component.
+ */
+export declare function generateComponentIndex(snapshot: DesignSystemModel, config: PTBConfig): string;
+//# sourceMappingURL=generate-system-doc.d.ts.map

package/dist/docs/generate-system-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-system-doc.d.ts","sourceRoot":"","sources":["../../src/docs/generate-system-doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACzF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAgH5D,MAAM,MAAM,WAAW,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,kBAAkB,CAC9B,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,SAAS,GAClB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAKrB;AAID,wBAAgB,gCAAgC,CAC5C,UAAU,EAAE,mBAAmB,EAAE,EACjC,MAAM,EAAE,SAAS,GAClB,WAAW,EAAE,CAkCf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAStF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,SAAS,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,MAAM,CA2JR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,SAAS,GAClB,MAAM,CAyCR"}

package/dist/docs/generate-system-doc.js

@@ -0,0 +1,337 @@
+import { createNamingStrategy } from "../mappings/naming-strategy.js";
+function safeComponents(snapshot) {
+    return (snapshot.components ?? []);
+}
+function getComponentKind(comp) {
+    return comp.kind?.value
+        ?? comp.kind?.primary
+        ?? comp.kind?.classification
+        ?? "";
+}
+function deduplicateComponents(components) {
+    const seen = new Set();
+    return components.filter(c => {
+        const key = c.name.toLowerCase().trim();
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+function toCamelCase(name) {
+    return name
+        .replace(/[-_]/g, " ")
+        .replace(/[^a-zA-Z0-9 ]/g, "")
+        .split(/\s+/)
+        .filter(Boolean)
+        .map((w, i) => i === 0
+        ? w.charAt(0).toLowerCase() + w.slice(1)
+        : w.charAt(0).toUpperCase() + w.slice(1))
+        .join("");
+}
+function toPascalCase(name) {
+    return name
+        .replace(/[-_\.]/g, " ")
+        .replace(/[^a-zA-Z0-9 ]/g, "")
+        .split(/\s+/)
+        .filter(Boolean)
+        .map(w => w.charAt(0).toUpperCase() + w.slice(1))
+        .join("") || name;
+}
+function buildPatternExamples(comp) {
+    const name = toPascalCase(comp.name);
+    const props = comp.properties ?? [];
+    const enumProps = props.filter((p) => p.type === "enum" && p.options?.length > 0);
+    if (enumProps.length >= 2) {
+        const p1 = enumProps[0];
+        const p2 = enumProps[1];
+        return [
+            `<${name} ${toCamelCase(p1.name)}="${p1.options[0]}" ${toCamelCase(p2.name)}="${p2.options[0]}" />`,
+            `<${name} ${toCamelCase(p1.name)}="${p1.options[1] ?? p1.options[0]}" ${toCamelCase(p2.name)}="${p2.options[1] ?? p2.options[0]}" />`,
+        ];
+    }
+    if (enumProps.length === 1) {
+        const p1 = enumProps[0];
+        const k1 = toCamelCase(p1.name);
+        return [
+            `<${name} ${k1}="${p1.options[0]}" />`,
+            `<${name} ${k1}="${p1.options[1] ?? p1.options[0]}" />`,
+        ];
+    }
+    // Fall back to boolean props when no enum props exist
+    const boolProps = props.filter((p) => p.type === "boolean");
+    if (boolProps.length > 0) {
+        const bp = boolProps[0];
+        return [`<${name} />`, `<${name} ${toCamelCase(bp.name)} />`];
+    }
+    return [`<${name} />`, `<${name} />`];
+}
+function isLikelyPlaceholder(name) {
+    if (/^Component\s+\d+$/i.test(name.trim()))
+        return true;
+    if (/[^\x20-\x7E]/.test(name))
+        return true; // non-ASCII (SF Symbols, etc.)
+    if (/\.\d+$/.test(name))
+        return true; // ends with .N like slider.hotizonal.3
+    return false;
+}
+function buildComponentImportPath(comp, config) {
+    const naming = createNamingStrategy(config.naming);
+    const cat = comp.categoryPath;
+    const catFolder = cat ? naming.formatFolderName(cat) : "";
+    const nameFolder = naming.formatFolderName(comp.name);
+    const compDir = config.output.componentsDir.replace(/^\.\//, "").replace(/\/$/, "");
+    return catFolder
+        ? `${compDir}/${catFolder}/${nameFolder}`
+        : `${compDir}/${nameFolder}`;
+}
+// Keyword rules for deterministic intent → component mapping
+const INTENT_RULES = [
+    { pattern: /\bbtn\b|^button$/i, intents: ["Submit a form", "Trigger a primary action", "Call-to-action"] },
+    { pattern: /text.?field|input.?field/i, intents: ["Collect text from user", "Capture email or password", "Single-line text input"] },
+    { pattern: /search/i, intents: ["Search content", "Filter a list by query"] },
+    { pattern: /checkbox/i, intents: ["Multi-select options", "Toggle a boolean setting"] },
+    { pattern: /dropdown|select/i, intents: ["Single-select from a list", "Show a menu of options"] },
+    { pattern: /chip/i, intents: ["Filter with tags", "Multi-select using chips"] },
+    { pattern: /\bnav\b|navigation|tab.?bar/i, intents: ["Primary page navigation", "Switch between top-level sections"] },
+    { pattern: /alert|modal|dialog/i, intents: ["Confirm a destructive action", "Show an error or warning"] },
+    { pattern: /notification.?item/i, intents: ["Display a single notification", "Show activity feed entry"] },
+    { pattern: /notification.?popup/i, intents: ["Show notification panel", "Overlay notification tray"] },
+    { pattern: /notification.*setting/i, intents: ["Manage notification preferences"] },
+    { pattern: /image|empty.*img/i, intents: ["Empty state with illustration", "Placeholder image"] },
+    { pattern: /page.?control|pagination/i, intents: ["Navigate carousel pages", "Indicate position in a sequence"] },
+    { pattern: /menu.?item/i, intents: ["Option in a dropdown menu", "Multi-select menu row"] },
+];
+export function buildImportPathMap(snapshot, config) {
+    const components = deduplicateComponents(safeComponents(snapshot).filter(c => !isLikelyPlaceholder(c.name)));
+    return new Map(components.map(c => [c.name, buildComponentImportPath(c, config)]));
+}
+const UTILITY_CATEGORIES = new Set(["utilities", "utility", "internals", "internal"]);
+export function generateDeterministicIntentTable(components, config) {
+    const cleaned = deduplicateComponents(components.filter(c => !isLikelyPlaceholder(c.name)));
+    const entries = [];
+    const nonIconComps = cleaned.filter(c => {
+        const cat = (c.categoryPath ?? "").toLowerCase();
+        return cat !== "icons" && !cat.startsWith("icon") && !UTILITY_CATEGORIES.has(cat);
+    });
+    for (const rule of INTENT_RULES) {
+        // Match ALL components that fit this rule (e.g. both text-field-mobile and text-field-web)
+        const matches = nonIconComps.filter(c => rule.pattern.test(c.name));
+        for (const match of matches) {
+            const importPath = buildComponentImportPath(match, config);
+            for (const intent of rule.intents) {
+                if (!entries.some(e => e.intent === intent && e.component === match.name)) {
+                    entries.push({ intent, component: match.name, importPath });
+                }
+            }
+        }
+    }
+    // Catch-all: add remaining components with a simple "Use <Name>" intent
+    const covered = new Set(entries.map(e => e.component));
+    for (const comp of nonIconComps) {
+        if (!covered.has(comp.name)) {
+            const importPath = buildComponentImportPath(comp, config);
+            entries.push({ intent: `Use ${comp.name}`, component: comp.name, importPath });
+            covered.add(comp.name);
+        }
+    }
+    return entries;
+}
+/**
+ * Builds a reverse dependency map: componentId → names of components that depend on it.
+ */
+export function buildReverseDepsMap(snapshot) {
+    const map = new Map();
+    for (const comp of safeComponents(snapshot)) {
+        for (const depId of (comp.dependencies ?? [])) {
+            if (!map.has(depId))
+                map.set(depId, []);
+            map.get(depId).push(comp.name);
+        }
+    }
+    return map;
+}
+/**
+ * Generates an AI.md file for the design system package root.
+ */
+export function generateSystemClaude(snapshot, config, scannedAt) {
+    const rawComponents = safeComponents(snapshot);
+    const components = deduplicateComponents(rawComponents.filter(c => !isLikelyPlaceholder(c.name)));
+    const dsName = config.name || "Design System";
+    // Group by category
+    const byCategory = new Map();
+    for (const comp of components) {
+        const cat = comp.categoryPath || "Components";
+        if (!byCategory.has(cat))
+            byCategory.set(cat, []);
+        byCategory.get(cat).push(comp);
+    }
+    // Find most-referenced non-composite components
+    const refCounts = new Map();
+    for (const comp of components) {
+        for (const depId of (comp.dependencies ?? [])) {
+            refCounts.set(depId, (refCounts.get(depId) ?? 0) + 1);
+        }
+    }
+    const keyAtomics = components
+        .filter(c => getComponentKind(c) !== "composite" && (refCounts.get(c.id) ?? 0) > 0)
+        .sort((a, b) => (refCounts.get(b.id) ?? 0) - (refCounts.get(a.id) ?? 0))
+        .slice(0, 5);
+    // Build real pattern examples from most-referenced component's actual props
+    const [patternExample1, patternExample2] = keyAtomics[0]
+        ? buildPatternExamples(keyAtomics[0])
+        : [`<Button variant="primary" size="sm" />`, `<Button variant="secondary" size="lg" />`];
+    // Find a real composite with boolean props for the slot visibility example
+    const slotComp = components.find(c => getComponentKind(c) === "composite" &&
+        (c.properties ?? []).some((p) => p.type === "boolean"));
+    let slotExample = `<Card showIcon showBadge={false} />`;
+    if (slotComp) {
+        const boolProps = (slotComp.properties ?? [])
+            .filter((p) => p.type === "boolean")
+            .slice(0, 2)
+            .map((p) => toCamelCase(p.name));
+        const name = toPascalCase(slotComp.name);
+        slotExample = boolProps.length >= 2
+            ? `<${name} ${boolProps[0]} ${boolProps[1]}={false} />`
+            : `<${name} ${boolProps[0]} />`;
+    }
+    const lines = [];
+    lines.push(`# ${dsName} — AI.md`);
+    lines.push("");
+    lines.push(`PTB-managed design system generated from Figma.${scannedAt ? ` Last scan: \`${scannedAt}\`.` : ""}`);
+    lines.push("");
+    // ── What's here ──────────────────────────────────────────────────────────
+    lines.push("## What's here");
+    lines.push("");
+    lines.push(`- \`${config.output.componentsDir}/\` — Generated React components (TypeScript + CSS Modules)`);
+    lines.push(`- \`.ptb/context/components/\` — Rich per-component context JSON (props, states, tokens, slots, interactions)`);
+    lines.push(`- \`.ptb/latest.json\` — Full design system model snapshot`);
+    lines.push(`- \`.ptb/manifest.json\` — Which component files PTB manages`);
+    lines.push("");
+    // ── How to use with your AI IDE ──────────────────────────────────────────
+    lines.push("## How to use with your AI IDE");
+    lines.push("");
+    lines.push("This file is read automatically by Claude Code, Cursor, GitHub Copilot, and Gemini Code Assist.");
+    lines.push("");
+    lines.push("When prompting your AI IDE to build a feature:");
+    lines.push(`1. Say which components you want to use (e.g. "use Button and Card from the design system")`);
+    lines.push(`2. The AI will read \`.ptb/context/components/{slug}.json\` for full prop contracts`);
+    lines.push(`3. Run \`ptb context component <name>\` to print a component's context to stdout if the IDE needs it`);
+    lines.push("");
+    lines.push("To regenerate this file after a Figma update:");
+    lines.push("```sh");
+    lines.push("ptb scan && ptb document system");
+    lines.push("```");
+    lines.push("");
+    // ── Core patterns ────────────────────────────────────────────────────────
+    lines.push("## Core patterns");
+    lines.push("");
+    lines.push("### Variants → props");
+    lines.push("Variant axes from Figma become typed props. Pass them directly:");
+    lines.push("```tsx");
+    lines.push(patternExample1);
+    lines.push(patternExample2);
+    lines.push("```");
+    lines.push("");
+    lines.push("### Slot visibility → boolean props");
+    lines.push("Figma boolean layers (show/hide sub-components) become boolean props:");
+    lines.push("```tsx");
+    lines.push(slotExample);
+    lines.push("```");
+    lines.push("");
+    lines.push("### Tokens → CSS variables");
+    lines.push("All design tokens are in `tokens.css` as `--ptb-*` custom properties:");
+    lines.push("```css");
+    lines.push("color: var(--ptb-colors-brand-500);");
+    lines.push("gap: var(--ptb-spacing-4);");
+    lines.push("border-radius: var(--ptb-radius-md);");
+    lines.push("```");
+    lines.push("");
+    lines.push("### Reading context JSON");
+    lines.push("Every component has a machine-readable context file:");
+    lines.push("```");
+    lines.push(".ptb/context/components/{component-slug}.json");
+    lines.push("```");
+    lines.push("Key fields:");
+    lines.push("- `invocationHint` — ready-to-use JSX snippet with correct props");
+    lines.push("- `variantAxes` — all prop names, types, and valid values");
+    lines.push("- `slots` — sub-components and their visibility props");
+    lines.push("- `stateContract` — interactive states (hover, pressed, disabled)");
+    lines.push("- `tokenBindings` — which CSS variables map to which design tokens");
+    lines.push("");
+    // ── Key building blocks ──────────────────────────────────────────────────
+    if (keyAtomics.length > 0) {
+        lines.push("## Key building blocks");
+        lines.push("");
+        lines.push("Most-referenced components — import these first when composing UIs.");
+        lines.push("");
+        for (const comp of keyAtomics) {
+            const usedBy = refCounts.get(comp.id) ?? 0;
+            lines.push(`### ${comp.name}`);
+            if (comp.description)
+                lines.push(`${comp.description}`);
+            lines.push(`Used by **${usedBy}** other components.`);
+            const hint = comp.invocationHint;
+            const [ex1] = buildPatternExamples(comp);
+            lines.push("```tsx");
+            lines.push(hint ?? ex1);
+            lines.push("```");
+            lines.push("");
+        }
+    }
+    // ── Component table by category ──────────────────────────────────────────
+    lines.push("## All components");
+    lines.push("");
+    for (const [cat, comps] of byCategory) {
+        lines.push(`### ${cat}`);
+        lines.push("");
+        lines.push("| Component | Dependencies |");
+        lines.push("| --- | --- |");
+        for (const comp of comps) {
+            const depCount = comp.dependencies?.length ?? 0;
+            lines.push(`| ${comp.name} | ${depCount > 0 ? depCount : "—"} |`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Generates a components.md intent index — maps user intent to component.
+ */
+export function generateComponentIndex(snapshot, config) {
+    const rawComponents = safeComponents(snapshot);
+    const components = deduplicateComponents(rawComponents.filter(c => !isLikelyPlaceholder(c.name)));
+    const lines = [];
+    lines.push("# Component Index");
+    lines.push("");
+    lines.push("A quick-reference guide to finding the right component for a use case.");
+    lines.push("");
+    // Group by category (mirrors AI.md structure)
+    const byCategory = new Map();
+    for (const comp of components) {
+        const cat = comp.categoryPath || "Other";
+        if (!byCategory.has(cat))
+            byCategory.set(cat, []);
+        byCategory.get(cat).push(comp);
+    }
+    for (const [cat, comps] of byCategory) {
+        lines.push(`## ${cat}`);
+        lines.push("");
+        for (const comp of comps) {
+            const kind = getComponentKind(comp);
+            const kindBadge = kind ? ` _(${kind})_` : "";
+            const deps = (comp.dependencies ?? []).length;
+            const depsNote = deps > 0 ? ` _(uses ${deps} components)_` : "";
+            const importPath = buildComponentImportPath(comp, config);
+            lines.push(`- **${comp.name}**${kindBadge}${depsNote} \`${importPath}\``);
+        }
+        lines.push("");
+    }
+    // Deterministic intent table (AI_INTENT_MAP replaced by caller when AI is available)
+    lines.push("## Intent → Component");
+    lines.push("");
+    lines.push("<!-- AI_INTENT_MAP -->");
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=generate-system-doc.js.map

package/dist/docs/generate-system-doc.js.map

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

package/dist/docs/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./generate-component-doc.js";
+export * from "./generate-component-stories.js";
+export * from "./generate-system-doc.js";
+export * from "./setup-storybook.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC"}

package/dist/docs/index.js

@@ -0,0 +1,5 @@
+export * from "./generate-component-doc.js";
+export * from "./generate-component-stories.js";
+export * from "./generate-system-doc.js";
+export * from "./setup-storybook.js";
+//# sourceMappingURL=index.js.map

package/dist/docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC"}

package/dist/docs/setup-storybook.d.ts

@@ -0,0 +1,26 @@
+export type StorybookSetupResult = {
+    created: string[];
+    skipped: string[];
+    installHint: string;
+};
+export type PackageManager = "pnpm" | "yarn" | "npm";
+export type StorybookReadiness = {
+    nodeModulesExist: boolean;
+    reactInstalled: boolean;
+    storybookInstalled: boolean;
+};
+/** Walk up from dir to find a lockfile, then return the matching package manager. */
+export declare function detectPackageManager(dir: string): Promise<PackageManager>;
+/** Check which Storybook prerequisites are satisfied in a package directory.
+ *  Walks up the directory tree so monorepos with hoisted node_modules are handled correctly. */
+export declare function checkStorybookReadiness(packageRoot: string): Promise<StorybookReadiness>;
+export declare function detectBundler(projectRoot: string): Promise<"vite" | "webpack">;
+/**
+ * After `storybook@latest init`, patch only the stories glob in the generated main.ts/main.js.
+ * Avoids overwriting Storybook's auto-detected framework and builder.
+ */
+export declare function patchStorybookStories(projectRoot: string, componentsDir: string): Promise<boolean>;
+export declare function setupStorybook(projectRoot: string, componentsDir: string, force?: boolean, 
+/** Override the Storybook framework package (e.g. "@storybook/vue3-vite"). Defaults to react-vite/react-webpack5. */
+frameworkPkg?: string): Promise<StorybookSetupResult>;
+//# sourceMappingURL=setup-storybook.d.ts.map

package/dist/docs/setup-storybook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-storybook.d.ts","sourceRoot":"","sources":["../../src/docs/setup-storybook.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,oBAAoB,GAAG;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAErD,MAAM,MAAM,kBAAkB,GAAG;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,qFAAqF;AACrF,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAW/E;AAED;gGACgG;AAChG,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiC9F;AAED,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA4DpF;AAkDD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA2BxG;AAED,wBAAsB,cAAc,CAChC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,KAAK,UAAQ;AACb,qHAAqH;AACrH,YAAY,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,CAAC,CAmC/B"}