@layoutdesign/context 0.4.0 → 0.6.0

package/dist/src/integrations/codebase-scan.d.ts

@@ -0,0 +1,46 @@
+import { type StoryComponentMeta } from "./storybook.js";
+export interface ScannedProp {
+    name: string;
+    type?: string;
+    optional?: boolean;
+}
+export interface ScannedComponent {
+    /** PascalCase component name */
+    name: string;
+    /** File path relative to the scan root */
+    filePath: string;
+    /** How the component is exported */
+    exportType: "named" | "default";
+    /** Props interface/type name if detected */
+    propsInterfaceName?: string;
+    /** Individual prop keys extracted from the interface */
+    props: ScannedProp[];
+    /** Whether the component uses forwardRef */
+    usesForwardRef: boolean;
+    /** Storybook metadata if a matching .stories file was found */
+    storybook?: StoryComponentMeta;
+}
+export interface ScanResult {
+    /** Root directory that was scanned */
+    rootPath: string;
+    /** All detected React components */
+    components: ScannedComponent[];
+    /** Storybook stories that matched a component */
+    storybookStories: StoryComponentMeta[];
+    /** Stories that did not match any scanned component */
+    unmatchedStories: StoryComponentMeta[];
+    /** Total files scanned */
+    filesScanned: number;
+    /** Scan duration in milliseconds */
+    durationMs: number;
+}
+/**
+ * Scan a directory for React components and Storybook stories.
+ * Returns structured results with component metadata and story associations.
+ */
+export declare function scanCodebase(rootPath: string): Promise<ScanResult>;
+/**
+ * Scan for Storybook stories only.
+ */
+export declare function scanStorybook(rootPath: string): Promise<StoryComponentMeta[]>;
+//# sourceMappingURL=codebase-scan.d.ts.map

package/dist/src/integrations/codebase-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-scan.d.ts","sourceRoot":"","sources":["../../../src/integrations/codebase-scan.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAIxB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,UAAU,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wDAAwD;IACxD,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,4CAA4C;IAC5C,cAAc,EAAE,OAAO,CAAC;IACxB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,iDAAiD;IACjD,gBAAgB,EAAE,kBAAkB,EAAE,CAAC;IACvC,uDAAuD;IACvD,gBAAgB,EAAE,kBAAkB,EAAE,CAAC;IACvC,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAqLD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAuExE;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAkB/B"}

package/dist/src/integrations/codebase-scan.js

@@ -0,0 +1,231 @@
+import { readFile, readdir } from "node:fs/promises";
+import { join, relative, extname } from "node:path";
+import { parseStoryFromPath, } from "./storybook.js";
+// ── Constants ──────────────────────────────────────────────────────────────
+const SKIP_DIRS = new Set([
+    "node_modules",
+    ".next",
+    ".nuxt",
+    "dist",
+    "build",
+    "out",
+    ".git",
+    ".layout",
+    ".superduper",
+    "coverage",
+    "__tests__",
+    "__mocks__",
+    ".turbo",
+    ".cache",
+    ".vercel",
+    ".output",
+]);
+const COMPONENT_EXTENSIONS = new Set([".tsx", ".jsx"]);
+const STORY_SUFFIXES = [".stories.ts", ".stories.tsx", ".stories.js", ".stories.jsx"];
+// ── Regex patterns ─────────────────────────────────────────────────────────
+// Named export: `export function Button(` or `export const Button =` or `export const Button: FC`
+const NAMED_FUNCTION_RE = /export\s+function\s+([A-Z]\w+)\s*(?:<[^>]*>)?\s*\(/g;
+const NAMED_CONST_RE = /export\s+const\s+([A-Z]\w+)\s*(?::\s*(?:React\.)?(?:FC|FunctionComponent|ComponentType)(?:<[^>]*>)?\s*)?=\s*/g;
+// Default export: `export default function Button(`
+const DEFAULT_FUNCTION_RE = /export\s+default\s+function\s+([A-Z]\w+)\s*(?:<[^>]*>)?\s*\(/g;
+// forwardRef: `export const Button = forwardRef<` or `React.forwardRef<`
+const FORWARD_REF_RE = /export\s+const\s+([A-Z]\w+)\s*=\s*(?:React\.)?forwardRef/g;
+// Grouped export: `export { Button, Card, buttonVariants }` — capture PascalCase names only
+const GROUPED_EXPORT_RE = /export\s*\{([^}]+)\}/g;
+// Props interface: `interface ButtonProps {` or `type ButtonProps = {`
+const PROPS_INTERFACE_RE = /(?:interface|type)\s+(\w+Props)\s*(?:=\s*)?\{([\s\S]*?)\n\}/g;
+// Individual prop from interface body: `  label: string;` or `  disabled?: boolean;`
+const PROP_LINE_RE = /^\s+(\w+)(\?)?\s*:\s*([^;]+)/gm;
+// ── File discovery ─────────────────────────────────────────────────────────
+function isStoryFile(filePath) {
+    return STORY_SUFFIXES.some((suffix) => filePath.endsWith(suffix));
+}
+/**
+ * Recursively walk a directory, yielding file paths.
+ * Skips directories in the SKIP_DIRS set.
+ */
+async function* walkDir(dir) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (!SKIP_DIRS.has(entry.name) && !entry.name.startsWith(".")) {
+                yield* walkDir(fullPath);
+            }
+        }
+        else if (entry.isFile()) {
+            yield fullPath;
+        }
+    }
+}
+// ── Component extraction ───────────────────────────────────────────────────
+function extractComponents(content, filePath) {
+    const components = [];
+    const seen = new Set();
+    // Extract all props interfaces/types from the file
+    const propsMap = new Map();
+    let propsMatch;
+    PROPS_INTERFACE_RE.lastIndex = 0;
+    while ((propsMatch = PROPS_INTERFACE_RE.exec(content)) !== null) {
+        const interfaceName = propsMatch[1];
+        const body = propsMatch[2] ?? "";
+        const props = [];
+        let propLineMatch;
+        PROP_LINE_RE.lastIndex = 0;
+        while ((propLineMatch = PROP_LINE_RE.exec(body)) !== null) {
+            props.push({
+                name: propLineMatch[1],
+                optional: propLineMatch[2] === "?",
+                type: propLineMatch[3]?.trim(),
+            });
+        }
+        propsMap.set(interfaceName, props);
+    }
+    function addComponent(name, exportType, usesForwardRef) {
+        if (seen.has(name))
+            return;
+        seen.add(name);
+        // Try to find a matching props interface
+        const propsInterfaceName = `${name}Props`;
+        const props = propsMap.get(propsInterfaceName) ?? [];
+        components.push({
+            name,
+            filePath,
+            exportType,
+            propsInterfaceName: propsMap.has(propsInterfaceName)
+                ? propsInterfaceName
+                : undefined,
+            props,
+            usesForwardRef,
+        });
+    }
+    // Named function exports
+    let match;
+    NAMED_FUNCTION_RE.lastIndex = 0;
+    while ((match = NAMED_FUNCTION_RE.exec(content)) !== null) {
+        addComponent(match[1], "named", false);
+    }
+    // Named const exports (FC, arrow functions)
+    NAMED_CONST_RE.lastIndex = 0;
+    while ((match = NAMED_CONST_RE.exec(content)) !== null) {
+        addComponent(match[1], "named", false);
+    }
+    // Default function exports
+    DEFAULT_FUNCTION_RE.lastIndex = 0;
+    while ((match = DEFAULT_FUNCTION_RE.exec(content)) !== null) {
+        addComponent(match[1], "default", false);
+    }
+    // forwardRef exports
+    FORWARD_REF_RE.lastIndex = 0;
+    while ((match = FORWARD_REF_RE.exec(content)) !== null) {
+        addComponent(match[1], "named", true);
+    }
+    // Grouped exports: `export { Button, Card, buttonVariants }`
+    // Only pick PascalCase names (components), skip camelCase (utilities)
+    GROUPED_EXPORT_RE.lastIndex = 0;
+    while ((match = GROUPED_EXPORT_RE.exec(content)) !== null) {
+        const names = match[1].split(",").map((n) => n.trim().split(/\s+as\s+/).pop().trim());
+        for (const name of names) {
+            if (/^[A-Z][a-zA-Z0-9]+$/.test(name)) {
+                addComponent(name, "named", false);
+            }
+        }
+    }
+    return components;
+}
+// ── Main scanner ───────────────────────────────────────────────────────────
+/**
+ * Scan a directory for React components and Storybook stories.
+ * Returns structured results with component metadata and story associations.
+ */
+export async function scanCodebase(rootPath) {
+    const startTime = Date.now();
+    const componentFiles = [];
+    const storyFiles = [];
+    let filesScanned = 0;
+    // Collect all relevant files
+    for await (const filePath of walkDir(rootPath)) {
+        filesScanned++;
+        const ext = extname(filePath);
+        if (isStoryFile(filePath)) {
+            storyFiles.push(filePath);
+        }
+        else if (COMPONENT_EXTENSIONS.has(ext)) {
+            componentFiles.push(filePath);
+        }
+    }
+    // Parse all component files
+    const allComponents = [];
+    for (const filePath of componentFiles) {
+        try {
+            const content = await readFile(filePath, "utf-8");
+            const relPath = relative(rootPath, filePath);
+            const found = extractComponents(content, relPath);
+            allComponents.push(...found);
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    // Parse all story files
+    const allStories = [];
+    for (const filePath of storyFiles) {
+        try {
+            const relPath = relative(rootPath, filePath);
+            const story = await parseStoryFromPath(filePath);
+            if (story) {
+                // Use relative path in the result
+                allStories.push({ ...story, filePath: relPath });
+            }
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    // Match stories to components
+    const matchedStoryNames = new Set();
+    for (const component of allComponents) {
+        const matchingStory = allStories.find((s) => s.componentName === component.name);
+        if (matchingStory) {
+            component.storybook = matchingStory;
+            matchedStoryNames.add(matchingStory.componentName);
+        }
+    }
+    const unmatchedStories = allStories.filter((s) => !matchedStoryNames.has(s.componentName));
+    return {
+        rootPath,
+        components: allComponents,
+        storybookStories: allStories,
+        unmatchedStories,
+        filesScanned,
+        durationMs: Date.now() - startTime,
+    };
+}
+/**
+ * Scan for Storybook stories only.
+ */
+export async function scanStorybook(rootPath) {
+    const stories = [];
+    for await (const filePath of walkDir(rootPath)) {
+        if (isStoryFile(filePath)) {
+            try {
+                const relPath = relative(rootPath, filePath);
+                const story = await parseStoryFromPath(filePath);
+                if (story) {
+                    stories.push({ ...story, filePath: relPath });
+                }
+            }
+            catch {
+                // Skip unreadable files
+            }
+        }
+    }
+    return stories;
+}
+//# sourceMappingURL=codebase-scan.js.map

package/dist/src/integrations/codebase-scan.js.map

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

package/dist/src/integrations/storybook.d.ts

@@ -0,0 +1,36 @@
+export interface StoryArg {
+    name: string;
+    type?: string;
+    defaultValue?: string;
+    description?: string;
+    control?: string;
+    options?: string[];
+}
+export interface StoryEntry {
+    name: string;
+    tags?: string[];
+}
+export interface StoryComponentMeta {
+    /** Component name derived from the story title (e.g. "Button" from "Components/Button") */
+    componentName: string;
+    /** Full title as declared in the story meta */
+    title: string;
+    /** File path relative to the scan root */
+    filePath: string;
+    /** Args and argTypes extracted from the default export */
+    args: StoryArg[];
+    /** Individual stories (named exports) */
+    stories: StoryEntry[];
+    /** Tags declared on the meta object */
+    tags?: string[];
+}
+/**
+ * Parse a single Storybook story file and extract component metadata.
+ * Uses regex-based extraction (no AST required).
+ */
+export declare function parseStoryFile(content: string, filePath: string): StoryComponentMeta | null;
+/**
+ * Parse a story file from disk.
+ */
+export declare function parseStoryFromPath(filePath: string): Promise<StoryComponentMeta | null>;
+//# sourceMappingURL=storybook.d.ts.map

package/dist/src/integrations/storybook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storybook.d.ts","sourceRoot":"","sources":["../../../src/integrations/storybook.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,2FAA2F;IAC3F,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAmCD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,kBAAkB,GAAG,IAAI,CAkG3B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAGpC"}

package/dist/src/integrations/storybook.js

@@ -0,0 +1,124 @@
+import { readFile } from "node:fs/promises";
+// ── Regex patterns ─────────────────────────────────────────────────────────
+// Match `title: "Components/Button"` or `title: 'Components/Button'`
+const TITLE_RE = /title\s*:\s*["'`]([^"'`]+)["'`]/;
+// Match `component: Button` or `component: "Button"`
+const COMPONENT_RE = /component\s*:\s*["'`]?(\w+)["'`]?/;
+// Match individual argTypes entries like:  size: { control: "select", options: ["sm", "md", "lg"] }
+const ARG_TYPE_RE = /(\w+)\s*:\s*\{([^}]*)\}/g;
+// Match `control:` value inside an argType block
+const CONTROL_RE = /control\s*:\s*["'`](\w+)["'`]/;
+// Match `options:` array inside an argType block
+const OPTIONS_RE = /options\s*:\s*\[([^\]]*)\]/;
+// Match `type:` value inside an argType block
+const TYPE_RE = /type\s*:\s*["'`](\w+)["'`]/;
+// Match named exports like `export const Primary: Story = ...`
+const STORY_EXPORT_RE = /export\s+const\s+(\w+)\s*(?::\s*\w+(?:<[^>]*>)?\s*)?=/g;
+// Match `tags: ["autodocs", ...]` on the meta object
+const TAGS_RE = /tags\s*:\s*\[([^\]]*)\]/;
+// Match `args: { ... }` on the meta object (top-level default args)
+const DEFAULT_ARGS_RE = /args\s*:\s*\{([^}]*)\}/;
+// ── Parser ─────────────────────────────────────────────────────────────────
+/**
+ * Parse a single Storybook story file and extract component metadata.
+ * Uses regex-based extraction (no AST required).
+ */
+export function parseStoryFile(content, filePath) {
+    // Must have a default export (the meta object)
+    if (!content.includes("export default") &&
+        !content.includes("satisfies Meta")) {
+        return null;
+    }
+    // Extract title — required
+    const titleMatch = TITLE_RE.exec(content);
+    const componentMatch = COMPONENT_RE.exec(content);
+    // Derive component name from title or component field
+    let componentName;
+    if (titleMatch?.[1]) {
+        const parts = titleMatch[1].split("/");
+        componentName = parts[parts.length - 1];
+    }
+    else if (componentMatch?.[1]) {
+        componentName = componentMatch[1];
+    }
+    if (!componentName)
+        return null;
+    const title = titleMatch?.[1] ?? componentName;
+    // Extract args from argTypes
+    const args = [];
+    const argTypesSection = content.match(/argTypes\s*:\s*\{([\s\S]*?)\n\s*\}/);
+    if (argTypesSection?.[1]) {
+        let match;
+        ARG_TYPE_RE.lastIndex = 0;
+        while ((match = ARG_TYPE_RE.exec(argTypesSection[1])) !== null) {
+            const name = match[1];
+            const block = match[2] ?? "";
+            const controlMatch = CONTROL_RE.exec(block);
+            const optionsMatch = OPTIONS_RE.exec(block);
+            const typeMatch = TYPE_RE.exec(block);
+            const arg = { name };
+            if (typeMatch?.[1])
+                arg.type = typeMatch[1];
+            if (controlMatch?.[1])
+                arg.control = controlMatch[1];
+            if (optionsMatch?.[1]) {
+                arg.options = optionsMatch[1]
+                    .split(",")
+                    .map((s) => s.trim().replace(/["'`]/g, ""))
+                    .filter(Boolean);
+            }
+            args.push(arg);
+        }
+    }
+    // Also extract from top-level `args: { ... }` if argTypes is empty
+    if (args.length === 0) {
+        const defaultArgsMatch = DEFAULT_ARGS_RE.exec(content);
+        if (defaultArgsMatch?.[1]) {
+            const entries = defaultArgsMatch[1].split(",");
+            for (const entry of entries) {
+                const [key, value] = entry.split(":").map((s) => s.trim());
+                if (key) {
+                    args.push({
+                        name: key,
+                        defaultValue: value?.replace(/["'`]/g, ""),
+                    });
+                }
+            }
+        }
+    }
+    // Extract story names from named exports
+    const stories = [];
+    let storyMatch;
+    STORY_EXPORT_RE.lastIndex = 0;
+    while ((storyMatch = STORY_EXPORT_RE.exec(content)) !== null) {
+        const name = storyMatch[1];
+        // Skip common non-story exports
+        if (name === "default" || name === "meta" || name === "Meta")
+            continue;
+        stories.push({ name });
+    }
+    // Extract tags
+    const tagsMatch = TAGS_RE.exec(content);
+    const tags = tagsMatch?.[1]
+        ? tagsMatch[1]
+            .split(",")
+            .map((s) => s.trim().replace(/["'`]/g, ""))
+            .filter(Boolean)
+        : undefined;
+    return {
+        componentName,
+        title,
+        filePath,
+        args,
+        stories,
+        tags,
+    };
+}
+/**
+ * Parse a story file from disk.
+ */
+export async function parseStoryFromPath(filePath) {
+    const content = await readFile(filePath, "utf-8");
+    return parseStoryFile(content, filePath);
+}
+//# sourceMappingURL=storybook.js.map

package/dist/src/integrations/storybook.js.map

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

package/dist/src/kit/stage.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resolve a user-supplied kit reference into a directory that the loader can
+ * read. Accepts:
+ *   1. A path to a directory containing a .layout/ subfolder (default for
+ *      consumer projects).
+ *   2. A path to a directory with layout.md at its root (a bundled kit or
+ *      an unzipped export). Staged into a temp dir that wraps it in .layout/.
+ *   3. A bundled kit name (linear-lite, stripe-lite, notion-lite). Likewise
+ *      staged.
+ *
+ * The caller MUST invoke the returned cleanup() when done to remove any temp
+ * directory the function created.
+ */
+export interface StagedKit {
+    path: string;
+    cleanup: () => void;
+}
+export declare function stageKitReference(input: string | undefined): StagedKit;
+//# sourceMappingURL=stage.d.ts.map

package/dist/src/kit/stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../../src/kit/stage.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAUtE"}

package/dist/src/kit/stage.js

@@ -0,0 +1,30 @@
+import { existsSync, mkdtempSync, writeFileSync, mkdirSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import { LAYOUT_DIR, LAYOUT_MD_FILE, TOKENS_CSS_FILE, TOKENS_JSON_FILE, KIT_MANIFEST_FILE, } from "./types.js";
+import { getBundledKitPath } from "./loader.js";
+export function stageKitReference(input) {
+    if (!input)
+        return { path: process.cwd(), cleanup: () => { } };
+    const abs = resolve(input);
+    if (existsSync(join(abs, LAYOUT_DIR)))
+        return { path: abs, cleanup: () => { } };
+    if (existsSync(join(abs, LAYOUT_MD_FILE)))
+        return stageDirAsKit(abs);
+    const bundled = getBundledKitPath(input);
+    if (bundled)
+        return stageDirAsKit(bundled);
+    return { path: abs, cleanup: () => { } };
+}
+function stageDirAsKit(kitDir) {
+    const tmp = mkdtempSync(join(tmpdir(), "layout-stage-"));
+    const layoutDir = join(tmp, LAYOUT_DIR);
+    mkdirSync(layoutDir, { recursive: true });
+    for (const f of [LAYOUT_MD_FILE, TOKENS_CSS_FILE, TOKENS_JSON_FILE, KIT_MANIFEST_FILE]) {
+        const src = join(kitDir, f);
+        if (existsSync(src))
+            writeFileSync(join(layoutDir, f), readFileSync(src));
+    }
+    return { path: tmp, cleanup: () => rmSync(tmp, { recursive: true, force: true }) };
+}
+//# sourceMappingURL=stage.js.map

package/dist/src/kit/stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.js","sourceRoot":"","sources":["../../../src/kit/stage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAClG,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,UAAU,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoBhD,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAC/E,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAAE,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;IAErE,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,OAAO;QAAE,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;IAE3C,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACxC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,EAAE,CAAC;QACvF,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC5B,IAAI,UAAU,CAAC,GAAG,CAAC;YAAE,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACrF,CAAC"}

package/dist/src/lint/diff.d.ts

@@ -0,0 +1,23 @@
+import type { Kit } from "../kit/types.js";
+export interface TokenChange {
+    name: string;
+    before?: string;
+    after?: string;
+}
+export interface KitDiff {
+    tokens: {
+        added: TokenChange[];
+        removed: TokenChange[];
+        modified: TokenChange[];
+    };
+    sections: {
+        added: string[];
+        removed: string[];
+    };
+    summary: {
+        totalChanges: number;
+        breakingChanges: number;
+    };
+}
+export declare function diffKits(base: Kit, head: Kit): KitDiff;
+//# sourceMappingURL=diff.d.ts.map

package/dist/src/lint/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/lint/diff.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE;QACN,KAAK,EAAE,WAAW,EAAE,CAAC;QACrB,OAAO,EAAE,WAAW,EAAE,CAAC;QACvB,QAAQ,EAAE,WAAW,EAAE,CAAC;KACzB,CAAC;IACF,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAqBD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAoCtD"}

package/dist/src/lint/diff.js

@@ -0,0 +1,62 @@
+// Token-level diff engine for two layout kits. Mirrors the shape of the
+// extraction-diff UI in Studio so outputs are recognisable to anyone who
+// has used re-extract.
+function parseCssTokens(css) {
+    const map = new Map();
+    if (!css)
+        return map;
+    for (const match of css.matchAll(/^\s*(--[a-zA-Z0-9_-]+)\s*:\s*([^;\n]+);/gm)) {
+        const name = match[1];
+        const value = match[2];
+        if (name && value)
+            map.set(name, value.trim());
+    }
+    return map;
+}
+function parseSections(layoutMd) {
+    const out = new Set();
+    for (const match of layoutMd.matchAll(/^##\s+(.+)$/gm)) {
+        if (match[1])
+            out.add(match[1].trim());
+    }
+    return out;
+}
+export function diffKits(base, head) {
+    const baseTokens = parseCssTokens(base.tokensCss);
+    const headTokens = parseCssTokens(head.tokensCss);
+    const added = [];
+    const removed = [];
+    const modified = [];
+    for (const [name, value] of headTokens) {
+        if (!baseTokens.has(name)) {
+            added.push({ name, after: value });
+        }
+        else if (baseTokens.get(name) !== value) {
+            modified.push({ name, before: baseTokens.get(name), after: value });
+        }
+    }
+    for (const [name, value] of baseTokens) {
+        if (!headTokens.has(name))
+            removed.push({ name, before: value });
+    }
+    const baseSections = parseSections(base.layoutMd);
+    const headSections = parseSections(head.layoutMd);
+    const sectionsAdded = [];
+    const sectionsRemoved = [];
+    for (const s of headSections)
+        if (!baseSections.has(s))
+            sectionsAdded.push(s);
+    for (const s of baseSections)
+        if (!headSections.has(s))
+            sectionsRemoved.push(s);
+    const totalChanges = added.length + removed.length + modified.length + sectionsAdded.length + sectionsRemoved.length;
+    // Breaking: removed tokens + removed sections (references in downstream code
+    // may now fail).
+    const breakingChanges = removed.length + sectionsRemoved.length;
+    return {
+        tokens: { added, removed, modified },
+        sections: { added: sectionsAdded, removed: sectionsRemoved },
+        summary: { totalChanges, breakingChanges },
+    };
+}
+//# sourceMappingURL=diff.js.map

package/dist/src/lint/diff.js.map

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

package/dist/src/lint/layout-md.d.ts

@@ -0,0 +1,21 @@
+import type { Kit } from "../kit/types.js";
+export type LintSeverity = "error" | "warning" | "info";
+export interface LintIssue {
+    ruleId: string;
+    severity: LintSeverity;
+    message: string;
+    file?: "layout.md" | "tokens.css" | "tokens.json";
+    line?: number;
+    detail?: Record<string, unknown>;
+}
+export interface LintResult {
+    issues: LintIssue[];
+    summary: {
+        errors: number;
+        warnings: number;
+        info: number;
+        passed: boolean;
+    };
+}
+export declare function lintKit(kit: Kit): LintResult;
+//# sourceMappingURL=layout-md.d.ts.map

package/dist/src/lint/layout-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-md.d.ts","sourceRoot":"","sources":["../../../src/lint/layout-md.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,GAAG,YAAY,GAAG,aAAa,CAAC;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAqWD,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU,CAkB5C"}