@calibrate-ds/core 0.1.0

package/dist/scanner/collect-components.js

@@ -0,0 +1,103 @@
+import { traverseNodes } from "./traverse-nodes.js";
+/**
+ * Scans a document tree and extracts all standalone and set-child COMPONENT nodes.
+ */
+export function collectComponents(documentNode) {
+    const components = [];
+    const pages = documentNode.children || [];
+    for (const page of pages) {
+        if (page.type !== "CANVAS")
+            continue;
+        const pageContext = { id: page.id, name: page.name };
+        for (const child of page.children || []) {
+            traverseNodes(child, { page: pageContext, ancestors: [] }, (node, context) => {
+                if (node.type === "COMPONENT") {
+                    // Natively secure componentSets even if REST misses the field on the variant node directly
+                    let computedSetId = node.componentSetId;
+                    if (!computedSetId) {
+                        const setAncestor = context.ancestors.find(a => a.type === "COMPONENT_SET");
+                        if (setAncestor) {
+                            computedSetId = setAncestor.id;
+                        }
+                    }
+                    components.push({
+                        id: node.id,
+                        name: node.name,
+                        type: "COMPONENT",
+                        componentSetId: computedSetId,
+                        context,
+                        children: node.children || [],
+                        layoutMode: node.layoutMode,
+                        primaryAxisAlignItems: node.primaryAxisAlignItems,
+                        counterAxisAlignItems: node.counterAxisAlignItems,
+                        itemSpacing: node.itemSpacing,
+                        paddingLeft: node.paddingLeft,
+                        paddingRight: node.paddingRight,
+                        paddingTop: node.paddingTop,
+                        paddingBottom: node.paddingBottom,
+                        width: node.width ?? node.absoluteBoundingBox?.width ?? node.absoluteRenderBounds?.width,
+                        height: node.height ?? node.absoluteBoundingBox?.height ?? node.absoluteRenderBounds?.height,
+                        primaryAxisSizingMode: node.primaryAxisSizingMode,
+                        counterAxisSizingMode: node.counterAxisSizingMode,
+                        layoutAlign: node.layoutAlign,
+                        layoutGrow: node.layoutGrow,
+                        fills: node.fills,
+                        strokes: node.strokes,
+                        styles: node.styles,
+                        boundVariables: node.boundVariables,
+                        componentPropertyDefinitions: node.componentPropertyDefinitions,
+                        reactions: node.reactions,
+                    });
+                }
+            });
+        }
+    }
+    return components;
+}
+/**
+ * Scans a document tree and extracts all COMPONENT_SET nodes.
+ */
+export function collectComponentSets(documentNode) {
+    const componentSets = [];
+    const pages = documentNode.children || [];
+    for (const page of pages) {
+        if (page.type !== "CANVAS")
+            continue;
+        const pageContext = { id: page.id, name: page.name };
+        for (const child of page.children || []) {
+            traverseNodes(child, { page: pageContext, ancestors: [] }, (node, context) => {
+                if (node.type === "COMPONENT_SET") {
+                    componentSets.push({
+                        id: node.id,
+                        name: node.name,
+                        type: "COMPONENT_SET",
+                        context,
+                        children: node.children || [],
+                        layoutMode: node.layoutMode,
+                        primaryAxisAlignItems: node.primaryAxisAlignItems,
+                        counterAxisAlignItems: node.counterAxisAlignItems,
+                        itemSpacing: node.itemSpacing,
+                        paddingLeft: node.paddingLeft,
+                        paddingRight: node.paddingRight,
+                        paddingTop: node.paddingTop,
+                        paddingBottom: node.paddingBottom,
+                        width: node.width ?? node.absoluteBoundingBox?.width ?? node.absoluteRenderBounds?.width,
+                        height: node.height ?? node.absoluteBoundingBox?.height ?? node.absoluteRenderBounds?.height,
+                        primaryAxisSizingMode: node.primaryAxisSizingMode,
+                        counterAxisSizingMode: node.counterAxisSizingMode,
+                        layoutAlign: node.layoutAlign,
+                        layoutGrow: node.layoutGrow,
+                        fills: node.fills,
+                        strokes: node.strokes,
+                        styles: node.styles,
+                        boundVariables: node.boundVariables,
+                        componentPropertyDefinitions: node.componentPropertyDefinitions,
+                        reactions: node.reactions,
+                    });
+                }
+            });
+        }
+    }
+    return componentSets;
+}
+//# sourceMappingURL=collect-components.js.map

package/dist/scanner/collect-components.js.map

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

package/dist/scanner/collect-instances.d.ts

@@ -0,0 +1,6 @@
+import type { RawInstanceNode } from "./types.js";
+/**
+ * Scans a document tree and extracts all INSTANCE nodes.
+ */
+export declare function collectInstances(documentNode: any): RawInstanceNode[];
+//# sourceMappingURL=collect-instances.d.ts.map

package/dist/scanner/collect-instances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-instances.d.ts","sourceRoot":"","sources":["../../src/scanner/collect-instances.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,YAAY,CAAC;AAGlE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,GAAG,GAAG,eAAe,EAAE,CA4BrE"}

package/dist/scanner/collect-instances.js

@@ -0,0 +1,31 @@
+import { traverseNodes } from "./traverse-nodes.js";
+/**
+ * Scans a document tree and extracts all INSTANCE nodes.
+ */
+export function collectInstances(documentNode) {
+    const instances = [];
+    const pages = documentNode.children || [];
+    for (const page of pages) {
+        if (page.type !== "CANVAS")
+            continue;
+        const pageContext = { id: page.id, name: page.name };
+        for (const child of page.children || []) {
+            traverseNodes(child, { page: pageContext, ancestors: [] }, (node, context) => {
+                if (node.type === "INSTANCE") {
+                    instances.push({
+                        id: node.id,
+                        name: node.name,
+                        type: "INSTANCE",
+                        componentId: node.componentId,
+                        context,
+                        styles: node.styles,
+                        children: node.children || [],
+                        reactions: node.reactions,
+                    });
+                }
+            });
+        }
+    }
+    return instances;
+}
+//# sourceMappingURL=collect-instances.js.map

package/dist/scanner/collect-instances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-instances.js","sourceRoot":"","sources":["../../src/scanner/collect-instances.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAiB;IAC9C,MAAM,SAAS,GAAsB,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,IAAI,EAAE,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAS;QAErC,MAAM,WAAW,GAAmB,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAErE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YACtC,aAAa,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;gBACzE,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBAC3B,SAAS,CAAC,IAAI,CAAC;wBACX,EAAE,EAAE,IAAI,CAAC,EAAE;wBACX,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,IAAI,EAAE,UAAU;wBAChB,WAAW,EAAE,IAAI,CAAC,WAAW;wBAC7B,OAAO;wBACP,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;wBAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;qBAC5B,CAAC,CAAC;gBACP,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC"}

package/dist/scanner/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./traverse-nodes.js";
+export * from "./collect-components.js";
+export * from "./collect-instances.js";
+export * from "./scan-file.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scanner/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC"}

package/dist/scanner/index.js

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./traverse-nodes.js";
+export * from "./collect-components.js";
+export * from "./collect-instances.js";
+export * from "./scan-file.js";
+//# sourceMappingURL=index.js.map

package/dist/scanner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scanner/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC"}

package/dist/scanner/scan-file.d.ts

@@ -0,0 +1,6 @@
+import type { RawScanResult } from "./types.js";
+/**
+ * Processes a raw Figma API /files response and groups nodes into generic collections.
+ */
+export declare function scanFigmaFile(fileKey: string, figmaFileResponse: any): RawScanResult;
+//# sourceMappingURL=scan-file.d.ts.map

package/dist/scanner/scan-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-file.d.ts","sourceRoot":"","sources":["../../src/scanner/scan-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,YAAY,CAAC;AAIhE;;GAEG;AACH,wBAAgB,aAAa,CACzB,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,GAAG,GACvB,aAAa,CAwBf"}

package/dist/scanner/scan-file.js

@@ -0,0 +1,28 @@
+import { collectComponentSets, collectComponents } from "./collect-components.js";
+import { collectInstances } from "./collect-instances.js";
+/**
+ * Processes a raw Figma API /files response and groups nodes into generic collections.
+ */
+export function scanFigmaFile(fileKey, figmaFileResponse) {
+    const document = figmaFileResponse.document;
+    const pages = (document.children || [])
+        .filter((child) => child.type === "CANVAS")
+        .map((page) => ({
+        id: page.id,
+        name: page.name,
+    }));
+    const componentSets = collectComponentSets(document);
+    const components = collectComponents(document);
+    const instances = collectInstances(document);
+    return {
+        fileKey,
+        fileName: figmaFileResponse.name || "Unknown File",
+        scannedAt: new Date().toISOString(),
+        pages,
+        componentSets,
+        components,
+        instances,
+        styles: figmaFileResponse.styles,
+    };
+}
+//# sourceMappingURL=scan-file.js.map

package/dist/scanner/scan-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-file.js","sourceRoot":"","sources":["../../src/scanner/scan-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;GAEG;AACH,MAAM,UAAU,aAAa,CACzB,OAAe,EACf,iBAAsB;IAEtB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC;IAE5C,MAAM,KAAK,GAAqB,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;SACpD,MAAM,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;SAC/C,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,CAAC;QACjB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;KAClB,CAAC,CAAC,CAAC;IAER,MAAM,aAAa,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE7C,OAAO;QACH,OAAO;QACP,QAAQ,EAAE,iBAAiB,CAAC,IAAI,IAAI,cAAc;QAClD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,KAAK;QACL,aAAa;QACb,UAAU;QACV,SAAS;QACT,MAAM,EAAE,iBAAiB,CAAC,MAAM;KACnC,CAAC;AACN,CAAC"}

package/dist/scanner/traverse-nodes.d.ts

@@ -0,0 +1,15 @@
+import type { RawPageContext } from "./types.js";
+export type VisitorContext = {
+    page: RawPageContext;
+    ancestors: {
+        id: string;
+        name: string;
+        type: string;
+    }[];
+};
+export type VisitorCallback = (node: any, context: VisitorContext) => void;
+/**
+ * Perform a depth-first traversal of a Figma node tree.
+ */
+export declare function traverseNodes(node: any, context: VisitorContext, visitor: VisitorCallback): void;
+//# sourceMappingURL=traverse-nodes.d.ts.map

package/dist/scanner/traverse-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse-nodes.d.ts","sourceRoot":"","sources":["../../src/scanner/traverse-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,MAAM,cAAc,GAAG;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAE3E;;GAEG;AACH,wBAAgB,aAAa,CACzB,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,eAAe,QAgB3B"}

package/dist/scanner/traverse-nodes.js

@@ -0,0 +1,18 @@
+/**
+ * Perform a depth-first traversal of a Figma node tree.
+ */
+export function traverseNodes(node, context, visitor) {
+    // Visit current node
+    visitor(node, context);
+    // Traverse children
+    if (node.children && Array.isArray(node.children)) {
+        const nextContext = {
+            page: context.page,
+            ancestors: [...context.ancestors, { id: node.id, name: node.name, type: node.type }],
+        };
+        for (const child of node.children) {
+            traverseNodes(child, nextContext, visitor);
+        }
+    }
+}
+//# sourceMappingURL=traverse-nodes.js.map

package/dist/scanner/traverse-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse-nodes.js","sourceRoot":"","sources":["../../src/scanner/traverse-nodes.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,UAAU,aAAa,CACzB,IAAS,EACT,OAAuB,EACvB,OAAwB;IAExB,qBAAqB;IACrB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEvB,oBAAoB;IACpB,IAAI,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChD,MAAM,WAAW,GAAmB;YAChC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,CAAC,GAAG,OAAO,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;SACvF,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/scanner/types.d.ts

@@ -0,0 +1,89 @@
+export type RawPageContext = {
+    id: string;
+    name: string;
+};
+export type RawNodeContext = {
+    page: RawPageContext;
+    ancestors: {
+        id: string;
+        name: string;
+        type: string;
+    }[];
+};
+export type RawComponentSet = {
+    id: string;
+    name: string;
+    type: "COMPONENT_SET";
+    context: RawNodeContext;
+    children: any[];
+    layoutMode?: "NONE" | "HORIZONTAL" | "VERTICAL";
+    primaryAxisAlignItems?: string;
+    counterAxisAlignItems?: string;
+    itemSpacing?: number;
+    paddingLeft?: number;
+    paddingRight?: number;
+    paddingTop?: number;
+    paddingBottom?: number;
+    width?: number;
+    height?: number;
+    primaryAxisSizingMode?: "FIXED" | "AUTO";
+    counterAxisSizingMode?: "FIXED" | "AUTO";
+    layoutAlign?: "MIN" | "CENTER" | "MAX" | "STRETCH" | "INHERIT";
+    layoutGrow?: number;
+    fills?: any[];
+    strokes?: any[];
+    styles?: Record<string, string>;
+    boundVariables?: any;
+    componentPropertyDefinitions?: any;
+    reactions?: any[];
+};
+export type RawComponentNode = {
+    id: string;
+    name: string;
+    type: "COMPONENT";
+    componentSetId?: string;
+    context: RawNodeContext;
+    children: any[];
+    layoutMode?: "NONE" | "HORIZONTAL" | "VERTICAL";
+    primaryAxisAlignItems?: string;
+    counterAxisAlignItems?: string;
+    itemSpacing?: number;
+    paddingLeft?: number;
+    paddingRight?: number;
+    paddingTop?: number;
+    paddingBottom?: number;
+    width?: number;
+    height?: number;
+    primaryAxisSizingMode?: "FIXED" | "AUTO";
+    counterAxisSizingMode?: "FIXED" | "AUTO";
+    layoutAlign?: "MIN" | "CENTER" | "MAX" | "STRETCH" | "INHERIT";
+    layoutGrow?: number;
+    fills?: any[];
+    strokes?: any[];
+    styles?: Record<string, string>;
+    boundVariables?: any;
+    constraints?: any;
+    componentPropertyDefinitions?: any;
+    reactions?: any[];
+};
+export type RawInstanceNode = {
+    id: string;
+    name: string;
+    type: "INSTANCE";
+    componentId: string;
+    context: RawNodeContext;
+    styles?: Record<string, string>;
+    children?: any[];
+    reactions?: any[];
+};
+export type RawScanResult = {
+    fileKey: string;
+    fileName: string;
+    scannedAt: string;
+    pages: RawPageContext[];
+    componentSets: RawComponentSet[];
+    components: RawComponentNode[];
+    instances: RawInstanceNode[];
+    styles?: Record<string, any>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/scanner/types.d.ts.map

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

package/dist/scanner/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/scanner/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scanner/types.ts"],"names":[],"mappings":""}

package/dist/snapshots/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./save-snapshot.js";
+export * from "./load-latest-snapshot.js";
+export * from "./load-previous-snapshot.js";
+export * from "./save-imported-tokens.js";
+export * from "./load-imported-tokens.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/snapshots/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC"}

package/dist/snapshots/index.js

@@ -0,0 +1,6 @@
+export * from "./save-snapshot.js";
+export * from "./load-latest-snapshot.js";
+export * from "./load-previous-snapshot.js";
+export * from "./save-imported-tokens.js";
+export * from "./load-imported-tokens.js";
+//# sourceMappingURL=index.js.map

package/dist/snapshots/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/snapshots/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC"}

package/dist/snapshots/load-imported-tokens.d.ts

@@ -0,0 +1,8 @@
+import type { PTBConfig } from "@calibrate-ds/shared-types";
+import type { CanonicalTokenExport } from "../tokens/import-schema.js";
+/**
+ * Safely loads and validates an imported token export from the local .ptb metadata dir.
+ * If the file doesn't exist or doesn't match the strict format, returns null.
+ */
+export declare function loadImportedTokens(config: PTBConfig): Promise<CanonicalTokenExport | null>;
+//# sourceMappingURL=load-imported-tokens.d.ts.map

package/dist/snapshots/load-imported-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-imported-tokens.d.ts","sourceRoot":"","sources":["../../src/snapshots/load-imported-tokens.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAqBhG"}

package/dist/snapshots/load-imported-tokens.js

@@ -0,0 +1,27 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { CanonicalTokenExportSchema } from "../tokens/import-schema.js";
+/**
+ * Safely loads and validates an imported token export from the local .ptb metadata dir.
+ * If the file doesn't exist or doesn't match the strict format, returns null.
+ */
+export async function loadImportedTokens(config) {
+    const rootDir = config.project.rootDir || process.cwd();
+    const metadataDir = path.resolve(rootDir, config.output.metadataDir);
+    const tokensFile = path.join(metadataDir, "imported-tokens.json");
+    try {
+        const rawContent = await fs.readFile(tokensFile, "utf-8");
+        const parsedJson = JSON.parse(rawContent);
+        // Natively parse directly through Canonical boundaries checking to prevent
+        // corrupted files from breaking down-stream logic.
+        const validation = CanonicalTokenExportSchema.safeParse(parsedJson);
+        if (!validation.success) {
+            return null;
+        }
+        return validation.data;
+    }
+    catch {
+        return null; // Gracefully mask ENOENT or invalid JSON errors.
+    }
+}
+//# sourceMappingURL=load-imported-tokens.js.map

package/dist/snapshots/load-imported-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-imported-tokens.js","sourceRoot":"","sources":["../../src/snapshots/load-imported-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAGxE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAiB;IACtD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACxD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAC;IAElE,IAAI,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE1C,2EAA2E;QAC3E,mDAAmD;QACnD,MAAM,UAAU,GAAG,0BAA0B,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAEpE,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,UAAU,CAAC,IAAI,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC,CAAC,iDAAiD;IAClE,CAAC;AACL,CAAC"}

package/dist/snapshots/load-latest-snapshot.d.ts

@@ -0,0 +1,3 @@
+import type { DesignSystemModel, PTBConfig } from "@calibrate-ds/shared-types";
+export declare function loadLatestSnapshot(config: PTBConfig): Promise<DesignSystemModel | null>;
+//# sourceMappingURL=load-latest-snapshot.d.ts.map

package/dist/snapshots/load-latest-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-latest-snapshot.d.ts","sourceRoot":"","sources":["../../src/snapshots/load-latest-snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE/E,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAY7F"}

package/dist/snapshots/load-latest-snapshot.js

@@ -0,0 +1,16 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+export async function loadLatestSnapshot(config) {
+    const rootDir = config.project.rootDir || process.cwd();
+    const metadataDir = path.resolve(rootDir, config.output.metadataDir);
+    const latestPath = path.join(metadataDir, "latest.json");
+    try {
+        const content = await fs.readFile(latestPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        // File does not exist or cannot be parsed
+        return null;
+    }
+}
+//# sourceMappingURL=load-latest-snapshot.js.map

package/dist/snapshots/load-latest-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-latest-snapshot.js","sourceRoot":"","sources":["../../src/snapshots/load-latest-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAiB;IACtD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACxD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAEzD,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAsB,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACL,0CAA0C;QAC1C,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC"}

package/dist/snapshots/load-previous-snapshot.d.ts

@@ -0,0 +1,7 @@
+import type { DesignSystemModel, PTBConfig } from "@calibrate-ds/shared-types";
+export type PriorSnapshotData = {
+    model: DesignSystemModel;
+    filename: string;
+};
+export declare function loadPreviousSnapshot(config: PTBConfig, latestContentStr?: string): Promise<PriorSnapshotData | null>;
+//# sourceMappingURL=load-previous-snapshot.d.ts.map

package/dist/snapshots/load-previous-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-previous-snapshot.d.ts","sourceRoot":"","sources":["../../src/snapshots/load-previous-snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE/E,MAAM,MAAM,iBAAiB,GAAG;IAC5B,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,SAAS,EACjB,gBAAgB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAuCnC"}

package/dist/snapshots/load-previous-snapshot.js

@@ -0,0 +1,39 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+export async function loadPreviousSnapshot(config, latestContentStr) {
+    const rootDir = config.project.rootDir || process.cwd();
+    const metadataDir = path.resolve(rootDir, config.output.metadataDir);
+    const historyDir = path.join(metadataDir, "history");
+    const latestPath = path.join(metadataDir, "latest.json");
+    let referenceContent = latestContentStr;
+    try {
+        if (!referenceContent) {
+            referenceContent = await fs.readFile(latestPath, "utf-8");
+        }
+    }
+    catch {
+        // If there's no latest.json, we technically can't compare
+    }
+    try {
+        const files = await fs.readdir(historyDir);
+        const jsonFiles = files.filter(f => f.endsWith(".json")).sort().reverse();
+        // Find the absolute first structural snapshot file in history that strictly does NOT identically match the reference.
+        for (const file of jsonFiles) {
+            const historicalPath = path.join(historyDir, file);
+            const historicalContent = await fs.readFile(historicalPath, "utf-8");
+            // If the raw strings aren't identical (fast structural checking without deep parsing) or no reference existed
+            if (!referenceContent || historicalContent !== referenceContent) {
+                return {
+                    model: JSON.parse(historicalContent),
+                    filename: file
+                };
+            }
+        }
+        // If we exhausted all files and ALL identically match `latest.json` (unlikely but safe fallback), return null.
+        return null;
+    }
+    catch {
+        return null; // history folder might not exist yet
+    }
+}
+//# sourceMappingURL=load-previous-snapshot.js.map

package/dist/snapshots/load-previous-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-previous-snapshot.js","sourceRoot":"","sources":["../../src/snapshots/load-previous-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAQlC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACtC,MAAiB,EACjB,gBAAyB;IAEzB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACxD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAEzD,IAAI,gBAAgB,GAAG,gBAAgB,CAAC;IAExC,IAAI,CAAC;QACD,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACpB,gBAAgB,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC9D,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,0DAA0D;IAC9D,CAAC;IAED,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;QAE1E,sHAAsH;QACtH,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC3B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACnD,MAAM,iBAAiB,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YAErE,8GAA8G;YAC9G,IAAI,CAAC,gBAAgB,IAAI,iBAAiB,KAAK,gBAAgB,EAAE,CAAC;gBAC9D,OAAO;oBACH,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAsB;oBACzD,QAAQ,EAAE,IAAI;iBACjB,CAAC;YACN,CAAC;QACL,CAAC;QAED,+GAA+G;QAC/G,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC,CAAC,qCAAqC;IACtD,CAAC;AACL,CAAC"}

package/dist/snapshots/save-imported-tokens.d.ts

@@ -0,0 +1,4 @@
+import type { CanonicalTokenExport } from "../tokens/import-schema.js";
+import type { PTBConfig } from "@calibrate-ds/shared-types";
+export declare function saveImportedTokens(data: CanonicalTokenExport, config: PTBConfig): Promise<void>;
+//# sourceMappingURL=save-imported-tokens.d.ts.map

package/dist/snapshots/save-imported-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-imported-tokens.d.ts","sourceRoot":"","sources":["../../src/snapshots/save-imported-tokens.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBrG"}

package/dist/snapshots/save-imported-tokens.js

@@ -0,0 +1,16 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+export async function saveImportedTokens(data, config) {
+    const rootDir = config.project.rootDir || process.cwd();
+    const metadataDir = path.resolve(rootDir, config.output.metadataDir);
+    const historyDir = path.join(metadataDir, "history");
+    // Ensure the metadata directories exist first
+    await fs.mkdir(historyDir, { recursive: true });
+    const content = JSON.stringify(data, null, 2) + "\n";
+    // Save imported tokens
+    await fs.writeFile(path.join(metadataDir, "imported-tokens.json"), content, "utf-8");
+    // Save history snapshot 
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    await fs.writeFile(path.join(historyDir, `imported-tokens-${timestamp}.json`), content, "utf-8");
+}
+//# sourceMappingURL=save-imported-tokens.js.map

package/dist/snapshots/save-imported-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-imported-tokens.js","sourceRoot":"","sources":["../../src/snapshots/save-imported-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAIlC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAA0B,EAAE,MAAiB;IAClF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACxD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAErD,8CAA8C;IAC9C,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IAErD,uBAAuB;IACvB,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,sBAAsB,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAErF,yBAAyB;IACzB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,SAAS,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACrG,CAAC"}

package/dist/snapshots/save-snapshot.d.ts

@@ -0,0 +1,3 @@
+import type { DesignSystemModel, PTBConfig } from "@calibrate-ds/shared-types";
+export declare function saveSnapshot(model: DesignSystemModel, config: PTBConfig): Promise<void>;
+//# sourceMappingURL=save-snapshot.d.ts.map

package/dist/snapshots/save-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-snapshot.d.ts","sourceRoot":"","sources":["../../src/snapshots/save-snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAoC/E,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB7F"}

package/dist/snapshots/save-snapshot.js

@@ -0,0 +1,49 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+const HISTORY_KEEP = 20;
+async function pruneHistory(historyDir, workspaceRoot) {
+    let files;
+    try {
+        files = (await fs.readdir(historyDir)).filter(f => f.endsWith(".json")).sort();
+    }
+    catch {
+        return;
+    }
+    if (files.length <= HISTORY_KEEP)
+        return;
+    // Collect any snapshot filenames referenced in ptb.lock — must never delete these
+    const pinned = new Set();
+    try {
+        const lock = JSON.parse(await fs.readFile(path.join(workspaceRoot, "ptb.lock"), "utf-8"));
+        for (const entry of Object.values(lock.components ?? {})) {
+            const f = entry.stampedSnapshotFile;
+            if (f)
+                pinned.add(f);
+        }
+    }
+    catch (err) {
+        if (err.code !== "ENOENT") {
+            console.warn(`[PTB] Could not read ptb.lock (${err.code ?? err.message}) — stamped snapshots will not be pinned during history pruning.`);
+        }
+    }
+    // Oldest files first; keep the newest HISTORY_KEEP and all pinned ones
+    const candidates = files.slice(0, files.length - HISTORY_KEEP);
+    for (const file of candidates) {
+        if (pinned.has(file))
+            continue;
+        await fs.unlink(path.join(historyDir, file)).catch(() => { });
+    }
+}
+export async function saveSnapshot(model, config) {
+    const rootDir = config.project.rootDir || process.cwd();
+    const metadataDir = path.resolve(rootDir, config.output.metadataDir);
+    const historyDir = path.join(metadataDir, "history");
+    await fs.mkdir(historyDir, { recursive: true });
+    const content = JSON.stringify(model, null, 2) + "\n";
+    await fs.writeFile(path.join(metadataDir, "design-system.model.json"), content, "utf-8");
+    await fs.writeFile(path.join(metadataDir, "latest.json"), content, "utf-8");
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    await fs.writeFile(path.join(historyDir, `${timestamp}.json`), content, "utf-8");
+    await pruneHistory(historyDir, rootDir);
+}
+//# sourceMappingURL=save-snapshot.js.map