@calibrate-ds/generator-react 0.1.0

package/dist/components/helpers.d.ts

@@ -0,0 +1,33 @@
+import type { ComponentDefinition } from "@calibrate-ds/shared-types";
+/**
+ * Converts a raw generic Figma property name into a safe camelCase TypeScript prop name.
+ * Exampe: "Property 1" -> "property1", "State" -> "state"
+ */
+export declare function normalizePropName(rawName: string): string;
+/**
+ * Strips quotes from variant option values to keep types clean.
+ */
+export declare function sanitizeOptionName(option: string): string;
+/**
+ * Ensures a consistent `./ComponentName.module.css` relative import path.
+ */
+export declare function getCssModuleImportPath(componentName: string): string;
+export type BaseElementInfo = {
+    tag: string;
+    interfaceName: string;
+};
+/**
+ * Infers the most logical HTML base element from the component's name and category.
+ * Provides a sensible fallback mapping to React HTMLAttributes.
+ */
+export declare function inferBaseElement(componentName: string, categoryPath: string): BaseElementInfo;
+/**
+ * Derives the exact canonical subfolder path to resolve imports predictably securely.
+ */
+export declare function resolveRelativeImportTarget(sourceComponent: ComponentDefinition, targetComponent: ComponentDefinition, namingStrategy: any): string;
+/**
+ * Derives the exact canonical path relative to a component backwards dynamically
+ * towards `../../layout/<Primitive>` flawlessly structurally!
+ */
+export declare function resolveRelativeLayoutImport(sourceComponent: ComponentDefinition, primitiveName: "Row" | "Stack" | "Grid", namingStrategy: any): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/components/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/components/helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAwBzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,MAAM,MAAM,eAAe,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,eAAe,CAsC7F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACvC,eAAe,EAAE,mBAAmB,EACpC,eAAe,EAAE,mBAAmB,EACpC,cAAc,EAAE,GAAG,GACpB,MAAM,CAuBR;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACvC,eAAe,EAAE,mBAAmB,EACpC,aAAa,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,EACvC,cAAc,EAAE,GAAG,GACpB,MAAM,CAmBR"}

package/dist/components/helpers.js

@@ -0,0 +1,124 @@
+import * as path from "node:path";
+/**
+ * Converts a raw generic Figma property name into a safe camelCase TypeScript prop name.
+ * Exampe: "Property 1" -> "property1", "State" -> "state"
+ */
+export function normalizePropName(rawName) {
+    if (!rawName)
+        return "unknownProp";
+    const cleanStr = rawName
+        .replace(/([A-Z])/g, " $1") // Insert space before uppercase letters safely
+        .replace(/[^a-zA-Z0-9]+/g, " ") // Replace non-alphanumeric with space cleanly
+        .trim();
+    const camelCase = cleanStr
+        .split(/\s+/)
+        .map((word, index) => {
+        if (index === 0) {
+            return word.toLowerCase();
+        }
+        return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+    })
+        .join("");
+    // Ensure it doesn't start with a number
+    if (/^[0-9]/.test(camelCase)) {
+        return `prop${camelCase}`;
+    }
+    return camelCase || "unknownProp";
+}
+/**
+ * Strips quotes from variant option values to keep types clean.
+ */
+export function sanitizeOptionName(option) {
+    return option.replace(/["']/g, "");
+}
+/**
+ * Ensures a consistent `./ComponentName.module.css` relative import path.
+ */
+export function getCssModuleImportPath(componentName) {
+    return `./${componentName}.module.css`;
+}
+/**
+ * Infers the most logical HTML base element from the component's name and category.
+ * Provides a sensible fallback mapping to React HTMLAttributes.
+ */
+export function inferBaseElement(componentName, categoryPath) {
+    const searchString = `${componentName.toLowerCase()} ${categoryPath.toLowerCase()}`;
+    // Form elements
+    if (searchString.includes("button") || searchString.includes("btn")) {
+        return { tag: "button", interfaceName: "React.ButtonHTMLAttributes<HTMLButtonElement>" };
+    }
+    if (searchString.includes("input") || searchString.includes("textfield") || searchString.includes("search")) {
+        return { tag: "input", interfaceName: "React.InputHTMLAttributes<HTMLInputElement>" };
+    }
+    if (searchString.includes("checkbox") || searchString.includes("radio") || searchString.includes("switch") || searchString.includes("toggle")) {
+        // Typically a wrapper around an input, but for simple skeleton keeping it generic wrapper or input depending on pattern.
+        // Usually, a checkbox is a label + input wrapper. A `div` wrapper is safest for a skeletal React component structure.
+        return { tag: "div", interfaceName: "React.HTMLAttributes<HTMLDivElement>" };
+    }
+    if (searchString.includes("select") || searchString.includes("dropdown")) {
+        return { tag: "select", interfaceName: "React.SelectHTMLAttributes<HTMLSelectElement>" };
+    }
+    if (searchString.includes("form")) {
+        return { tag: "form", interfaceName: "React.FormHTMLAttributes<HTMLFormElement>" };
+    }
+    // Media
+    if (searchString.includes("image") || searchString.includes("img") || searchString.includes("avatar")) {
+        return { tag: "img", interfaceName: "React.ImgHTMLAttributes<HTMLImageElement>" };
+    }
+    // Text / Typography
+    if (searchString.includes("text") || searchString.includes("typography") || searchString.includes("heading") || searchString.includes("title") || searchString.includes("paragraph")) {
+        return { tag: "span", interfaceName: "React.HTMLAttributes<HTMLSpanElement>" };
+    }
+    if (searchString.includes("icon")) {
+        // Icons are often SVG or span wrappers
+        return { tag: "span", interfaceName: "React.HTMLAttributes<HTMLSpanElement>" };
+    }
+    // Default Fallback
+    return { tag: "div", interfaceName: "React.HTMLAttributes<HTMLDivElement>" };
+}
+/**
+ * Derives the exact canonical subfolder path to resolve imports predictably securely.
+ */
+export function resolveRelativeImportTarget(sourceComponent, targetComponent, namingStrategy) {
+    const sourceFolder = namingStrategy.formatFolderName(sourceComponent.name);
+    let sourcePath = sourceFolder;
+    if (sourceComponent.categoryPath) {
+        const sourceCategory = namingStrategy.formatFolderName(sourceComponent.categoryPath);
+        sourcePath = path.posix.join(sourceCategory, sourceFolder);
+    }
+    const targetFolder = namingStrategy.formatFolderName(targetComponent.name);
+    let targetPath = targetFolder;
+    if (targetComponent.categoryPath) {
+        const targetCategory = namingStrategy.formatFolderName(targetComponent.categoryPath);
+        targetPath = path.posix.join(targetCategory, targetFolder);
+    }
+    // Since both start relative to `packages/ui/src/components/`, find relative distance natively!
+    // path.posix to enforce forward slashes in compiled code cleanly
+    let relativeStr = path.posix.relative(sourcePath, targetPath);
+    if (!relativeStr.startsWith(".")) {
+        relativeStr = `./${relativeStr}`;
+    }
+    return `${relativeStr}/${targetFolder}`;
+}
+/**
+ * Derives the exact canonical path relative to a component backwards dynamically
+ * towards `../../layout/<Primitive>` flawlessly structurally!
+ */
+export function resolveRelativeLayoutImport(sourceComponent, primitiveName, namingStrategy) {
+    const sourceFolder = namingStrategy.formatFolderName(sourceComponent.name);
+    let sourcePath = sourceFolder;
+    if (sourceComponent.categoryPath) {
+        const sourceCategory = namingStrategy.formatFolderName(sourceComponent.categoryPath);
+        sourcePath = path.posix.join(sourceCategory, sourceFolder);
+    }
+    // `packages/ui/src/components` vs `packages/ui/src/layout` -> we go up one level from `components/`
+    // SourcePath represents distance *inside* `components/`. We must escape components natively!
+    let pathAcc = ".."; // Escaping the 'components' folder boundary logically 
+    // Each level deep inside components adds another `../`
+    const depth = sourcePath.split("/").length;
+    for (let i = 0; i < depth; i++) {
+        pathAcc = path.posix.join("..", pathAcc);
+    }
+    return path.posix.join(pathAcc, "layout", primitiveName);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/components/helpers.js.map

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

package/dist/components/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./generate-types-file.js";
+export * from "./generate-component-file.js";
+export * from "./write-components.js";
+export * from "./prune-components.js";
+export * from "./helpers.js";
+export * from "./token-helpers.js";
+export * from "./generate-composite-types.js";
+export * from "./generate-composite-file.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC"}

package/dist/components/index.js

@@ -0,0 +1,10 @@
+export * from "./generate-types-file.js";
+export * from "./generate-component-file.js";
+export * from "./write-components.js";
+export * from "./prune-components.js";
+export * from "./helpers.js";
+export * from "./token-helpers.js";
+// Merged Composite Generators
+export * from "./generate-composite-types.js";
+export * from "./generate-composite-file.js";
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AAEnC,8BAA8B;AAC9B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC"}

package/dist/components/layout-jsx.d.ts

@@ -0,0 +1,14 @@
+import type { LayoutTreeNode, ComponentDefinition, DesignSystemModel } from "@calibrate-ds/shared-types";
+export interface LayoutJSXResult {
+    jsx: string;
+    dependencies: Map<string, string>;
+}
+/**
+ * Generates recursive Flexbox JSX structure from a normalized LayoutTreeNode.
+ *
+ * @param node The layout tree node to process
+ * @param indentLevel The current string indentation for pretty printing
+ * @returns Formatted JSX string containing structural <div> instances and leaf implementations
+ */
+export declare function generateLayoutJSX(node: LayoutTreeNode, sourceComponent: ComponentDefinition, model: DesignSystemModel, namingStrategy: any, indentLevel?: number): LayoutJSXResult;
+//# sourceMappingURL=layout-jsx.d.ts.map

package/dist/components/layout-jsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-jsx.d.ts","sourceRoot":"","sources":["../../src/components/layout-jsx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAkB,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAIzH,MAAM,WAAW,eAAe;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,cAAc,EACpB,eAAe,EAAE,mBAAmB,EACpC,KAAK,EAAE,iBAAiB,EACxB,cAAc,EAAE,GAAG,EACnB,WAAW,GAAE,MAAU,GACxB,eAAe,CA2EjB"}

package/dist/components/layout-jsx.js

@@ -0,0 +1,265 @@
+import { normalizeFigmaName } from "@calibrate-ds/core";
+import { resolveRelativeImportTarget, resolveRelativeLayoutImport } from "./helpers.js";
+/**
+ * Generates recursive Flexbox JSX structure from a normalized LayoutTreeNode.
+ *
+ * @param node The layout tree node to process
+ * @param indentLevel The current string indentation for pretty printing
+ * @returns Formatted JSX string containing structural <div> instances and leaf implementations
+ */
+export function generateLayoutJSX(node, sourceComponent, model, namingStrategy, indentLevel = 2) {
+    const dependencies = new Map();
+    const indent = "    ".repeat(indentLevel);
+    const innerIndent = "    ".repeat(indentLevel + 1);
+    // 1. First try to resolve if it represents an instance (even if it has children in the LayoutTree)
+    if (node.role === "instance") {
+        const { targetComponent, targetName, importPath } = tryResolveInstance(node, sourceComponent, model, namingStrategy);
+        if (targetComponent && targetName && importPath) {
+            dependencies.set(importPath, targetName);
+            return { jsx: `${indent}<${targetName} />`, dependencies };
+        }
+    }
+    if (node.type === "leaf") {
+        return renderLeafNode(node, sourceComponent, model, namingStrategy, indent);
+    }
+    // It is a container
+    const isRoot = indentLevel === 2; // Typically the outermost wrapper of the component
+    let tagName = "div";
+    let isPrimitive = false;
+    if (node.layout) {
+        if (node.layout.direction === "row") {
+            tagName = "Row";
+            isPrimitive = true;
+        }
+        else if (node.layout.direction === "column") {
+            tagName = "Stack";
+            isPrimitive = true;
+        }
+    }
+    if (isPrimitive) {
+        const importPath = resolveRelativeLayoutImport(sourceComponent, tagName, namingStrategy);
+        dependencies.set(importPath, tagName);
+    }
+    // Base attributes string
+    let propsStr = "";
+    if (isPrimitive) {
+        const primitiveProps = generatePrimitivePropsString(node.layout);
+        if (primitiveProps) {
+            propsStr += primitiveProps;
+        }
+    }
+    else {
+        // Generate inline style mapping Auto Layout Flexbox semantics securely
+        const styleObj = generateFlexStyleString(node.layout);
+        if (styleObj) {
+            propsStr += `style={{ ${styleObj} }}`;
+        }
+    }
+    propsStr = propsStr ? ` ${propsStr}` : ""; // Ensure leading space if properties exist
+    // Format recursively printed children seamlessly traversing the DOM map
+    let childrenJSX = "";
+    if (node.children && node.children.length > 0) {
+        const childStrings = node.children.map(child => {
+            const childResult = generateLayoutJSX(child, sourceComponent, model, namingStrategy, indentLevel + 1);
+            for (const [path, name] of childResult.dependencies.entries()) {
+                dependencies.set(path, name);
+            }
+            return childResult.jsx;
+        });
+        childrenJSX = `\n${childStrings.join("\n")}\n${indent}`;
+    }
+    // Return the physically assembled container tag string!
+    return {
+        jsx: `${indent}<${tagName}${propsStr}>${childrenJSX}</${tagName}>`,
+        dependencies
+    };
+}
+/**
+ * Formats canonical proprietary layout primitives mapping natively onto React components.
+ */
+function generatePrimitivePropsString(layout) {
+    if (!layout)
+        return "";
+    const props = [];
+    if (layout.gap) {
+        const gapVal = typeof layout.gap === "object" ? (layout.gap.resolvedToken?.name || layout.gap.rawValue) : layout.gap;
+        if (gapVal !== 0 && gapVal !== undefined) {
+            props.push(`gap={${typeof gapVal === "number" ? gapVal : `"${gapVal}"`}}`);
+        }
+    }
+    if (layout.padding) {
+        const { top, right, bottom, left } = layout.padding;
+        const t = (top.resolvedToken?.name || top.rawValue);
+        const r = (right.resolvedToken?.name || right.rawValue);
+        const b = (bottom.resolvedToken?.name || bottom.rawValue);
+        const l = (left.resolvedToken?.name || left.rawValue);
+        if (t === b && l === r) {
+            if (t === l) {
+                if (t !== 0)
+                    props.push(`padding="${typeof t === "number" ? t + "px" : t}"`);
+            }
+            else {
+                props.push(`padding="${typeof t === "number" ? t + "px" : t} ${typeof r === "number" ? r + "px" : r}"`);
+            }
+        }
+        else {
+            props.push(`padding="${typeof t === "number" ? t + "px" : t} ${typeof r === "number" ? r + "px" : r} ${typeof b === "number" ? b + "px" : b} ${typeof l === "number" ? l + "px" : l}"`);
+        }
+    }
+    if (layout.mainAlignment) {
+        switch (layout.mainAlignment) {
+            case "center":
+                props.push('justify="center"');
+                break;
+            case "space-between":
+                props.push('justify="space-between"');
+                break;
+            case "start":
+                props.push('justify="flex-start"');
+                break;
+            case "end":
+                props.push('justify="flex-end"');
+                break;
+        }
+    }
+    if (layout.crossAlignment) {
+        switch (layout.crossAlignment) {
+            case "center":
+                props.push('align="center"');
+                break;
+            case "start":
+                props.push('align="flex-start"');
+                break;
+            case "end":
+                props.push('align="flex-end"');
+                break;
+            case "baseline":
+                props.push('align="baseline"');
+                break;
+        }
+    }
+    return props.join(" ");
+}
+/**
+ * Formats standard inline Flexbox CSS rules mimicking Figma Auto Layout primitives dynamically.
+ */
+function generateFlexStyleString(layout) {
+    if (!layout)
+        return null;
+    const styles = ['display: "flex"'];
+    if (layout.direction === "row") {
+        styles.push('flexDirection: "row"');
+    }
+    else if (layout.direction === "column") {
+        styles.push('flexDirection: "column"');
+    }
+    if (layout.gap) {
+        const gapVal = typeof layout.gap === "object" ? (layout.gap.resolvedToken?.name || layout.gap.rawValue) : layout.gap;
+        styles.push(`gap: ${typeof gapVal === "number" ? gapVal + "px" : gapVal}`);
+    }
+    if (layout.padding) {
+        const { top, right, bottom, left } = layout.padding;
+        const t = (top.resolvedToken?.name || top.rawValue);
+        const r = (right.resolvedToken?.name || right.rawValue);
+        const b = (bottom.resolvedToken?.name || bottom.rawValue);
+        const l = (left.resolvedToken?.name || left.rawValue);
+        // Optimize formatting shorthand natively if symmetric!
+        if (t === b && l === r) {
+            if (t === l) {
+                styles.push(`padding: ${typeof t === "number" ? t + "px" : t}`);
+            }
+            else {
+                styles.push(`padding: "${typeof t === "number" ? t + "px" : t} ${typeof r === "number" ? r + "px" : r}"`);
+            }
+        }
+        else {
+            styles.push(`padding: "${typeof t === "number" ? t + "px" : t} ${typeof r === "number" ? r + "px" : r} ${typeof b === "number" ? b + "px" : b} ${typeof l === "number" ? l + "px" : l}"`);
+        }
+    }
+    // Alignment mappings bridging Axis heuristics to CSS
+    if (layout.mainAlignment) {
+        switch (layout.mainAlignment) {
+            case "center":
+                styles.push('justifyContent: "center"');
+                break;
+            case "space-between":
+                styles.push('justifyContent: "space-between"');
+                break;
+            case "start":
+                styles.push('justifyContent: "flex-start"');
+                break;
+            case "end":
+                styles.push('justifyContent: "flex-end"');
+                break;
+        }
+    }
+    if (layout.crossAlignment) {
+        switch (layout.crossAlignment) {
+            case "center":
+                styles.push('alignItems: "center"');
+                break;
+            case "start":
+                styles.push('alignItems: "flex-start"');
+                break;
+            case "end":
+                styles.push('alignItems: "flex-end"');
+                break;
+            case "baseline":
+                styles.push('alignItems: "baseline"');
+                break;
+        }
+    }
+    return styles.join(", ");
+}
+function tryResolveInstance(node, sourceComponent, model, namingStrategy) {
+    if (node.role !== "instance")
+        return {};
+    let targetComponent;
+    // 1. Resolve securely by exact ID Mapping (Safest Signal natively)
+    if (node.componentId) {
+        targetComponent = model.components.find(c => c.id === node.componentId);
+    }
+    // 2. Fallback matching structural Figma Names heuristics organically
+    if (!targetComponent) {
+        const { baseName: instanceBaseName } = normalizeFigmaName(node.name || "");
+        const cleanInstanceName = instanceBaseName.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
+        if (cleanInstanceName) {
+            targetComponent = model.components.find(c => {
+                const { baseName: cBaseName } = normalizeFigmaName(c.name);
+                const cleanCanonicalName = cBaseName.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
+                return cleanCanonicalName === cleanInstanceName;
+            });
+        }
+    }
+    // 3. Bind the deterministic Export Mapping predictably
+    if (targetComponent && targetComponent.id !== sourceComponent.id) {
+        const targetName = namingStrategy.formatComponentName(targetComponent.name);
+        const importPath = resolveRelativeImportTarget(sourceComponent, targetComponent, namingStrategy);
+        return { targetComponent, targetName, importPath };
+    }
+    return {};
+}
+/**
+ * Predicts and maps correct component primitives securely targeting React native elements implicitly.
+ */
+function renderLeafNode(node, sourceComponent, model, namingStrategy, indent) {
+    const dependencies = new Map();
+    if (node.role === "instance") {
+        // Instance couldn't be resolved to a known component — emit a placeholder.
+        // Use the naming strategy so the identifier is valid and matches any future resolution.
+        const { baseName } = normalizeFigmaName(node.name || "Unknown");
+        const instanceName = namingStrategy.formatComponentName(baseName);
+        return { jsx: `${indent}{/* ptb: unresolved instance — ${instanceName} */}`, dependencies };
+    }
+    if (node.role === "text") {
+        // Fallback explicit text placeholders organically matching HTML structural primitives
+        return { jsx: `${indent}<span>${node.name || "Text"}</span>`, dependencies };
+    }
+    if (node.role === "icon") {
+        // Fallback explicit abstract vector placeholders organically
+        return { jsx: `${indent}<svg aria-label="${node.name || "icon"}" />`, dependencies };
+    }
+    // Generic fallback visually preserving space safely
+    return { jsx: `${indent}<div data-role="${node.role || "unknown"}" />`, dependencies };
+}
+//# sourceMappingURL=layout-jsx.js.map

package/dist/components/layout-jsx.js.map

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

package/dist/components/prune-components.d.ts

@@ -0,0 +1,10 @@
+import type { PTBConfig, PruneResult, ComponentArtifacts } from "@calibrate-ds/shared-types";
+/**
+ * Safely removes generated artifacts based on tracked paths in the manifest.
+ * Only deletes if the folder contains exactly the expected files.
+ */
+export declare function pruneComponents(config: PTBConfig, staleEntries: {
+    id: string;
+    data: ComponentArtifacts;
+}[]): Promise<PruneResult>;
+//# sourceMappingURL=prune-components.d.ts.map

package/dist/components/prune-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune-components.d.ts","sourceRoot":"","sources":["../../src/components/prune-components.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAG7F;;;GAGG;AACH,wBAAsB,eAAe,CACjC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,EAAE,GACzD,OAAO,CAAC,WAAW,CAAC,CAmEtB"}

package/dist/components/prune-components.js

@@ -0,0 +1,69 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { resolveDSPaths } from "@calibrate-ds/core";
+/**
+ * Safely removes generated artifacts based on tracked paths in the manifest.
+ * Only deletes if the folder contains exactly the expected files.
+ */
+export async function pruneComponents(config, staleEntries) {
+    const { packageRoot } = resolveDSPaths(config);
+    const result = {
+        deleted: [],
+        skipped: [],
+        errors: []
+    };
+    for (const { id, data } of staleEntries) {
+        // Find the folder from the artifacts. 
+        if (!data.artifacts || data.artifacts.length === 0)
+            continue;
+        if (!data.folder) {
+            result.skipped.push(`${data.name} (missing folder path in manifest)`);
+            continue;
+        }
+        const folderPath = path.join(packageRoot, data.folder);
+        try {
+            const stats = await fs.stat(folderPath);
+            if (!stats.isDirectory()) {
+                result.errors.push(`Artifact path ${folderPath} is not a directory.`);
+                continue;
+            }
+            const filesInDir = await fs.readdir(folderPath);
+            const expectedBasenames = new Set(data.artifacts.map((f) => path.basename(f)));
+            let hasUnexpectedFiles = false;
+            for (const file of filesInDir) {
+                if (!expectedBasenames.has(file)) {
+                    hasUnexpectedFiles = true;
+                    break;
+                }
+            }
+            if (hasUnexpectedFiles) {
+                result.skipped.push(`${data.name} (unexpected files in ${folderPath})`);
+                continue;
+            }
+            // Safe to delete files
+            for (const artifact of data.artifacts) {
+                const fullPath = path.join(packageRoot, artifact);
+                try {
+                    const artifactStats = await fs.stat(fullPath);
+                    if (artifactStats.isFile()) {
+                        await fs.unlink(fullPath);
+                    }
+                }
+                catch {
+                }
+            }
+            await fs.rm(folderPath, { recursive: true, force: true });
+            result.deleted.push(data.name);
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                result.deleted.push(data.name);
+            }
+            else {
+                result.errors.push(`Error pruning ${data.name}: ${err.message}`);
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=prune-components.js.map

package/dist/components/prune-components.js.map

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

package/dist/components/token-helpers.d.ts

@@ -0,0 +1,32 @@
+import type { TokenCollection } from "@calibrate-ds/shared-types";
+/**
+ * Heuristically infers which token collections are likely relevant to a component
+ * based on its name and category path.
+ */
+export declare function inferRelevantTokenCollections(componentName: string, categoryPath: string, availableCollections: TokenCollection[]): TokenCollection[];
+/**
+ * Computes a simple relative path from inside a component directory back to the tokens directory.
+ * Assumes component generation is at `src/components/<category>/<name>/`
+ * Assumes token generation is at `src/tokens/`
+ */
+export declare function resolveRelativeTokenImport(collectionName: string): string;
+/**
+ * Formats a clean variable name from a collection name to import.
+ * E.g. "Brand Colors" -> "brandColors"
+ */
+export declare function formatCollectionImportName(collectionName: string): string;
+/**
+ * Valid Style Intents
+ */
+export type StyleSlot = "background" | "text" | "border" | "radius" | "spacingX" | "spacingY" | "iconColor" | "placeholder" | "focusRing" | "opacity";
+/**
+ * Predicts the essential structural intent attributes a given component typically uses.
+ */
+export declare function inferStyleSlots(componentName: string, categoryPath: string): StyleSlot[];
+/**
+ * Guesses the most reasonable literal exact Token per requested slot locally spanning the Collections mapped.
+ * Returns a Record of strictly typed token literal bindings representing Figma stylistic intent physically mapped!
+ * If a token is NOT found, it maps directly against the physical `styleMetadata` literals available avoiding empty refs.
+ */
+export declare function selectTokensForSlots(slots: StyleSlot[], availableCollections: TokenCollection[], styleMetadata?: Record<string, string | number>): Record<string, string>;
+//# sourceMappingURL=token-helpers.d.ts.map

package/dist/components/token-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-helpers.d.ts","sourceRoot":"","sources":["../../src/components/token-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;GAGG;AACH,wBAAgB,6BAA6B,CACzC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,oBAAoB,EAAE,eAAe,EAAE,GACxC,eAAe,EAAE,CA4BnB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAQzE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GACf,YAAY,GACZ,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,UAAU,GACV,WAAW,GACX,aAAa,GACb,WAAW,GACX,SAAS,CAAC;AAEhB;;GAEG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,CAqCxF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAChC,KAAK,EAAE,SAAS,EAAE,EAClB,oBAAoB,EAAE,eAAe,EAAE,EACvC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAChD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkGxB"}