@calibrate-ds/core 0.1.0

package/dist/tokens/import-schema.d.ts

@@ -0,0 +1,111 @@
+import { z } from "zod";
+export declare const TokenModeSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+export declare const TokenValueSchema: z.ZodObject<{
+    type: z.ZodString;
+    value: z.ZodAny;
+}, z.core.$strip>;
+export declare const ImportedTokenSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    codeName: z.ZodOptional<z.ZodString>;
+    resolvedType: z.ZodString;
+    valuesByMode: z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodString;
+        value: z.ZodAny;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const ImportedCollectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    kind: z.ZodOptional<z.ZodString>;
+    modes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    tokens: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        codeName: z.ZodOptional<z.ZodString>;
+        resolvedType: z.ZodString;
+        valuesByMode: z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodString;
+            value: z.ZodAny;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const TokenExportSourceSchema: z.ZodObject<{
+    tool: z.ZodString;
+    fileName: z.ZodOptional<z.ZodString>;
+    exportedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const PTBTokenExportSchema: z.ZodObject<{
+    version: z.ZodString;
+    source: z.ZodObject<{
+        tool: z.ZodString;
+        fileName: z.ZodOptional<z.ZodString>;
+        exportedAt: z.ZodString;
+    }, z.core.$strip>;
+    collections: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        modes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        tokens: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            codeName: z.ZodOptional<z.ZodString>;
+            resolvedType: z.ZodString;
+            valuesByMode: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodString;
+                value: z.ZodAny;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const GenericTokenExportSchema: z.ZodObject<{
+    collections: z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        modes: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+        tokens: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+        variables: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export declare const CanonicalTokenExportSchema: z.ZodObject<{
+    version: z.ZodString;
+    source: z.ZodObject<{
+        tool: z.ZodString;
+        fileName: z.ZodOptional<z.ZodString>;
+        exportedAt: z.ZodString;
+    }, z.core.$strip>;
+    collections: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        modes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        tokens: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            codeName: z.ZodOptional<z.ZodString>;
+            resolvedType: z.ZodString;
+            valuesByMode: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodString;
+                value: z.ZodAny;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PTBTokenExport = z.infer<typeof PTBTokenExportSchema>;
+export type GenericTokenExport = z.infer<typeof GenericTokenExportSchema>;
+export type CanonicalTokenExport = z.infer<typeof CanonicalTokenExportSchema>;
+export type ImportedCollection = z.infer<typeof ImportedCollectionSchema>;
+export type ImportedToken = z.infer<typeof ImportedTokenSchema>;
+//# sourceMappingURL=import-schema.d.ts.map

package/dist/tokens/import-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-schema.d.ts","sourceRoot":"","sources":["../../src/tokens/import-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;iBAG3B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;iBAM9B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;iBAMnC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;iBAIlC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI/B,CAAC;AAGH,eAAO,MAAM,wBAAwB;;;;;;;iBASrB,CAAC;AAGjB,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAuB,CAAC;AAE/D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/tokens/import-schema.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+export const TokenModeSchema = z.object({
+    id: z.string(),
+    name: z.string()
+});
+export const TokenValueSchema = z.object({
+    type: z.string(),
+    value: z.any() // Intentionally loose for mixed shape support (e.g. RGBA structs vs "string")
+});
+export const ImportedTokenSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    codeName: z.string().optional(),
+    resolvedType: z.string(),
+    valuesByMode: z.record(z.string(), TokenValueSchema)
+});
+export const ImportedCollectionSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    kind: z.string().optional(),
+    modes: z.array(TokenModeSchema),
+    tokens: z.array(ImportedTokenSchema)
+});
+export const TokenExportSourceSchema = z.object({
+    tool: z.string(),
+    fileName: z.string().optional(),
+    exportedAt: z.string()
+});
+export const PTBTokenExportSchema = z.object({
+    version: z.string(),
+    source: TokenExportSourceSchema,
+    collections: z.array(ImportedCollectionSchema)
+});
+// Generic fall-back matching any root object containing a `collections` array
+export const GenericTokenExportSchema = z.object({
+    collections: z.array(z.object({
+        name: z.string().optional(),
+        modes: z.array(z.any()).optional(),
+        tokens: z.array(z.any()).optional(),
+        variables: z.array(z.any()).optional()
+    }).passthrough())
+}).passthrough();
+// Canonical format PTB utilizes internally (Mirroring PTBTokenExport exactly)
+export const CanonicalTokenExportSchema = PTBTokenExportSchema;
+//# sourceMappingURL=import-schema.js.map

package/dist/tokens/import-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-schema.js","sourceRoot":"","sources":["../../src/tokens/import-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,8EAA8E;CAChG,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC;CACvD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC;CACvC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACzB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,uBAAuB;IAC/B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;CACjD,CAAC,CAAC;AAEH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,WAAW,EAAE,CAAC,CAAC,KAAK,CAChB,CAAC,CAAC,MAAM,CAAC;QACL,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;QAClC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;QACnC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;KACzC,CAAC,CAAC,WAAW,EAAE,CACnB;CACJ,CAAC,CAAC,WAAW,EAAE,CAAC;AAEjB,8EAA8E;AAC9E,MAAM,CAAC,MAAM,0BAA0B,GAAG,oBAAoB,CAAC"}

package/dist/tokens/import-tokens.d.ts

@@ -0,0 +1,16 @@
+import type { CanonicalTokenExport } from "./import-schema.js";
+type ImportResult = {
+    success: true;
+    data: CanonicalTokenExport;
+    format: "ptb" | "generic";
+} | {
+    success: false;
+    errorType: "not_found" | "invalid_json" | "unknown_format" | "schema_mismatch";
+    details?: any;
+};
+/**
+ * Validates, reads, and maps varying structural Token Export JSON files safely mapping it into Canonical TS structs.
+ */
+export declare function importTokenFile(filePath: string): Promise<ImportResult>;
+export {};
+//# sourceMappingURL=import-tokens.d.ts.map

package/dist/tokens/import-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-tokens.d.ts","sourceRoot":"","sources":["../../src/tokens/import-tokens.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,KAAK,YAAY,GACX;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,KAAK,GAAG,SAAS,CAAA;CAAE,GACxE;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,WAAW,GAAG,cAAc,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;IAAC,OAAO,CAAC,EAAE,GAAG,CAAA;CAAE,CAAC;AAExH;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAoC7E"}

package/dist/tokens/import-tokens.js

@@ -0,0 +1,40 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { detectImportFormat } from "./detect-format.js";
+import { adaptPTBTokenExportToCanonical, adaptGenericTokenExportToCanonical } from "./adapters/index.js";
+/**
+ * Validates, reads, and maps varying structural Token Export JSON files safely mapping it into Canonical TS structs.
+ */
+export async function importTokenFile(filePath) {
+    const resolvedPath = path.resolve(process.cwd(), filePath);
+    let rawContent;
+    try {
+        rawContent = await fs.readFile(resolvedPath, "utf-8");
+    }
+    catch {
+        return { success: false, errorType: "not_found" };
+    }
+    let parsedJson;
+    try {
+        parsedJson = JSON.parse(rawContent);
+    }
+    catch {
+        return { success: false, errorType: "invalid_json" };
+    }
+    const format = detectImportFormat(parsedJson);
+    if (format === "unknown") {
+        return { success: false, errorType: "unknown_format" };
+    }
+    const adapterResult = format === "ptb"
+        ? adaptPTBTokenExportToCanonical(parsedJson)
+        : adaptGenericTokenExportToCanonical(parsedJson);
+    if (!adapterResult.success) {
+        return {
+            success: false,
+            errorType: "schema_mismatch",
+            details: adapterResult.issues
+        };
+    }
+    return { success: true, data: adapterResult.data, format };
+}
+//# sourceMappingURL=import-tokens.js.map

package/dist/tokens/import-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-tokens.js","sourceRoot":"","sources":["../../src/tokens/import-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,8BAA8B,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC;AAOzG;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IAClD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAE3D,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACD,UAAU,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;IACtD,CAAC;IAED,IAAI,UAAe,CAAC;IACpB,IAAI,CAAC;QACD,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,KAAK,KAAK;QAClC,CAAC,CAAC,8BAA8B,CAAC,UAAU,CAAC;QAC5C,CAAC,CAAC,kCAAkC,CAAC,UAAU,CAAC,CAAC;IAErD,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO;YACH,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,iBAAiB;YAC5B,OAAO,EAAE,aAAa,CAAC,MAAM;SAChC,CAAC;IACN,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;AAC/D,CAAC"}

package/dist/tokens/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./build-token-model.js";
+export * from "./types.js";
+export * from "./naming.js";
+export * from "./classify-token-kind.js";
+export * from "./normalize-token-collections.js";
+export * from "./import-schema.js";
+export * from "./detect-format.js";
+export * from "./adapters/index.js";
+export * from "./import-tokens.js";
+export * from "./resolve-token-source.js";
+export * from "./resolution.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tokens/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC"}

package/dist/tokens/index.js

@@ -0,0 +1,12 @@
+export * from "./build-token-model.js";
+export * from "./types.js";
+export * from "./naming.js";
+export * from "./classify-token-kind.js";
+export * from "./normalize-token-collections.js";
+export * from "./import-schema.js";
+export * from "./detect-format.js";
+export * from "./adapters/index.js";
+export * from "./import-tokens.js";
+export * from "./resolve-token-source.js";
+export * from "./resolution.js";
+//# sourceMappingURL=index.js.map

package/dist/tokens/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tokens/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC"}

package/dist/tokens/naming.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Normalizes a Figma token name into a safe, source-faithful CSS Custom Property segment.
+ *
+ * Rule: SOURCE IS TRUTH.
+ * - preserve characters like numbers and hyphens
+ * - replace illegal CSS variable characters with hyphens
+ * - collapse multiple hyphens
+ * - trim leading/trailing hyphens
+ *
+ * Example: "scale / 300 (12px)" -> "scale-300-12px"
+ */
+export declare function normalizeTokenVariablePart(name: string): string;
+/**
+ * Generates the full PTB-standard CSS variable name for a token.
+ *
+ * Example: collection="Colors", token="Brand / 900" -> "--ptb-colors-brand-900"
+ */
+export declare function getPTBTokenVariableName(collectionName: string, tokenName: string): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/tokens/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../src/tokens/naming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAIzF"}

package/dist/tokens/naming.js

@@ -0,0 +1,27 @@
+/**
+ * Normalizes a Figma token name into a safe, source-faithful CSS Custom Property segment.
+ *
+ * Rule: SOURCE IS TRUTH.
+ * - preserve characters like numbers and hyphens
+ * - replace illegal CSS variable characters with hyphens
+ * - collapse multiple hyphens
+ * - trim leading/trailing hyphens
+ *
+ * Example: "scale / 300 (12px)" -> "scale-300-12px"
+ */
+export function normalizeTokenVariablePart(name) {
+    return name.toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/(^-|-$)/g, "");
+}
+/**
+ * Generates the full PTB-standard CSS variable name for a token.
+ *
+ * Example: collection="Colors", token="Brand / 900" -> "--ptb-colors-brand-900"
+ */
+export function getPTBTokenVariableName(collectionName, tokenName) {
+    const category = normalizeTokenVariablePart(collectionName);
+    const token = normalizeTokenVariablePart(tokenName);
+    return `--ptb-${category}-${token}`;
+}
+//# sourceMappingURL=naming.js.map

package/dist/tokens/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../src/tokens/naming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACnD,OAAO,IAAI,CAAC,WAAW,EAAE;SACpB,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,cAAsB,EAAE,SAAiB;IAC7E,MAAM,QAAQ,GAAG,0BAA0B,CAAC,cAAc,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,0BAA0B,CAAC,SAAS,CAAC,CAAC;IACpD,OAAO,SAAS,QAAQ,IAAI,KAAK,EAAE,CAAC;AACxC,CAAC"}

package/dist/tokens/normalize-token-collections.d.ts

@@ -0,0 +1,7 @@
+import type { TokenCollection } from "@calibrate-ds/shared-types";
+import type { FigmaVariablesMap } from "./types.js";
+/**
+ * Normalizes Figma Variable API response data into the generic DesignSystemModel TokenCollections format.
+ */
+export declare function normalizeTokenCollections(variablesMeta: FigmaVariablesMap): TokenCollection[];
+//# sourceMappingURL=normalize-token-collections.d.ts.map

package/dist/tokens/normalize-token-collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-token-collections.d.ts","sourceRoot":"","sources":["../../src/tokens/normalize-token-collections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,4BAA4B,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAqC,MAAM,YAAY,CAAC;AAGvF;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,iBAAiB,GAAG,eAAe,EAAE,CA+D7F"}

package/dist/tokens/normalize-token-collections.js

@@ -0,0 +1,68 @@
+import { classifyTokenKind } from "./classify-token-kind.js";
+/**
+ * Normalizes Figma Variable API response data into the generic DesignSystemModel TokenCollections format.
+ */
+export function normalizeTokenCollections(variablesMeta) {
+    const { variableCollections, variables } = variablesMeta || { variableCollections: {}, variables: {} };
+    const collections = [];
+    for (const [collectionId, rawCollection] of Object.entries(variableCollections)) {
+        if (rawCollection.hiddenFromPublishing) {
+            continue; // Skip collections explicitly hidden from consumers
+        }
+        const defaultModeId = rawCollection.defaultModeId;
+        const tokens = [];
+        for (const variableId of rawCollection.variableIds) {
+            const rawVar = variables[variableId];
+            if (!rawVar || rawVar.hiddenFromPublishing) {
+                continue;
+            }
+            // Simple heuristic to get a "safe" codename from the raw figma variable name.
+            const safeName = rawVar.name.replace(/\//g, "-").replace(/\s+/g, "-");
+            // Extract the value for the primary mode. If a collection has no modes
+            // for some reason, we fallback to the first object key value.
+            const valueForMode = rawVar.valuesByMode[defaultModeId] ?? Object.values(rawVar.valuesByMode)[0];
+            let normalizedValue = "";
+            let resolvedType = rawVar.resolvedType;
+            if (typeof valueForMode === "object" && valueForMode !== null) {
+                if ("type" in valueForMode && valueForMode.type === "VARIABLE_ALIAS") {
+                    // Try to resolve alias at a basic string level
+                    const aliasedVar = variables[valueForMode.id];
+                    normalizedValue = aliasedVar ? `{${aliasedVar.name.replace(/\//g, "-").replace(/\s+/g, "-")}}` : "[Unknown Alias]";
+                }
+                else if ("r" in valueForMode) {
+                    // It's a color
+                    normalizedValue = rgbaToHex(valueForMode);
+                }
+            }
+            else {
+                // Number, String, Boolean
+                normalizedValue = valueForMode;
+            }
+            tokens.push({
+                id: rawVar.id,
+                key: rawVar.key,
+                name: safeName,
+                value: String(normalizedValue), // Store as string for flexibility inside model for now
+                type: classifyTokenKind(rawCollection.name), // Base type heavily off the parent classification collection
+                description: rawVar.description || undefined,
+            });
+        }
+        if (tokens.length > 0) {
+            collections.push({
+                id: collectionId,
+                name: rawCollection.name,
+                tokens,
+            });
+        }
+    }
+    return collections;
+}
+// Convert 0-1 RGBA channels to Hex string
+function rgbaToHex(color) {
+    const r = Math.round(color.r * 255).toString(16).padStart(2, "0");
+    const g = Math.round(color.g * 255).toString(16).padStart(2, "0");
+    const b = Math.round(color.b * 255).toString(16).padStart(2, "0");
+    const a = Math.round(color.a * 255).toString(16).padStart(2, "0");
+    return color.a === 1 ? `#${r}${g}${b}` : `#${r}${g}${b}${a}`;
+}
+//# sourceMappingURL=normalize-token-collections.js.map

package/dist/tokens/normalize-token-collections.js.map

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

package/dist/tokens/resolution.d.ts

@@ -0,0 +1,7 @@
+import type { TokenCollection, ResolvedBinding } from "@calibrate-ds/shared-types";
+/**
+ * Resolves a token binding fully through its alias chain.
+ */
+export declare function resolveTokenBinding(sourceVariableId: string | undefined, collections: TokenCollection[]): ResolvedBinding | undefined;
+export declare function resolveTokenBindingFromIndex(sourceVariableId: string | undefined, tokenIndex: Map<string, any>): ResolvedBinding | undefined;
+//# sourceMappingURL=resolution.d.ts.map

package/dist/tokens/resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution.d.ts","sourceRoot":"","sources":["../../src/tokens/resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAe,eAAe,EAAE,MAAM,4BAA4B,CAAC;AA+BhG;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,WAAW,EAAE,eAAe,EAAE,GAC/B,eAAe,GAAG,SAAS,CAoE7B;AAED,wBAAgB,4BAA4B,CACxC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,eAAe,GAAG,SAAS,CA2D7B"}

package/dist/tokens/resolution.js

@@ -0,0 +1,223 @@
+import { getPTBTokenVariableName } from "./naming.js";
+/**
+ * Normalizes a variable ID by stripping the prefix.
+ */
+function normalizeTokenId(id) {
+    if (!id)
+        return "";
+    return id.replace(/^VariableID:/i, "");
+}
+/**
+ * Builds a lookup map for tokens from all collections.
+ */
+function buildTokenMap(collections) {
+    const map = new Map();
+    for (const col of collections) {
+        for (const token of col.tokens) {
+            const id = normalizeTokenId(token.id);
+            if (id)
+                map.set(id, { token, collection: col });
+            // Also index by persistent key if available (crucial for library resolution)
+            if (token.key) {
+                const key = normalizeTokenId(token.key);
+                if (key)
+                    map.set(key, { token, collection: col });
+            }
+        }
+    }
+    return map;
+}
+/**
+ * Resolves a token binding fully through its alias chain.
+ */
+export function resolveTokenBinding(sourceVariableId, collections) {
+    if (!sourceVariableId)
+        return undefined;
+    const tokenMap = buildTokenMap(collections);
+    const normalizedId = normalizeTokenId(sourceVariableId);
+    // Attempt 1: Direct match (ID or Key)
+    let current = tokenMap.get(normalizedId);
+    // Attempt 2: Compound ID match (Key/SessionID format common in Figma libraries)
+    if (!current && normalizedId.includes("/")) {
+        const keyPart = normalizedId.split("/")[0];
+        current = tokenMap.get(keyPart);
+    }
+    if (!current)
+        return undefined;
+    const sourceToken = current.token;
+    const sourceCollection = current.collection;
+    const resolutionPath = [sourceToken.name];
+    let resolved = current;
+    // Follow aliasTargetId chain (populated when loaded via adaptCanonicalToTokenCollections)
+    let depth = 0;
+    while (resolved.token.aliasTargetId && depth < 10) {
+        const nextId = normalizeTokenId(resolved.token.aliasTargetId);
+        const next = tokenMap.get(nextId);
+        if (!next)
+            break;
+        resolved = next;
+        resolutionPath.push(resolved.token.name);
+        depth++;
+    }
+    // Belt-and-suspenders: also follow value-string alias references for tokens loaded
+    // from sources that don't populate aliasTargetId (e.g. direct REST normalisation)
+    let valueDepth = 0;
+    while (valueDepth < 10) {
+        const rawVal = resolved.token.value;
+        if (typeof rawVal !== "string" || !rawVal.includes("VariableID:"))
+            break;
+        const nextId = normalizeTokenId(rawVal);
+        const next = tokenMap.get(nextId) ?? tokenMap.get(rawVal);
+        if (!next)
+            break;
+        resolved = next;
+        resolutionPath.push(resolved.token.name);
+        valueDepth++;
+    }
+    // cssVar = the CSS variable the component is *directly bound to* in Figma (the source token).
+    // This is what the component's CSS should reference (e.g. --ptb-mapped-button-btn-primary).
+    // canonicalCssVar = the terminal resolved token's variable (for reference/documentation).
+    const cssVar = getPTBTokenVariableName(sourceCollection.name, sourceToken.name);
+    const canonicalCssVar = getPTBTokenVariableName(resolved.collection.name, resolved.token.name);
+    return {
+        sourceVariableId,
+        sourceTokenName: sourceToken.name,
+        sourceCodeName: sourceToken.codeName || sourceToken.name,
+        resolvedTokenId: resolved.token.id,
+        resolvedTokenName: resolved.token.name,
+        resolvedCodeName: resolved.token.codeName || resolved.token.name,
+        cssVar,
+        canonicalCssVar,
+        cssValue: formatCSSValue(resolved.token.value, resolved.token.type),
+        valueType: mapValueType(resolved.token.value, resolved.token.type),
+        resolutionPath: resolutionPath.length > 0 ? resolutionPath : [sourceToken.name]
+    };
+}
+export function resolveTokenBindingFromIndex(sourceVariableId, tokenIndex) {
+    if (!sourceVariableId)
+        return undefined;
+    const normalizedId = normalizeTokenId(sourceVariableId);
+    let current = tokenIndex.get(normalizedId);
+    if (!current && normalizedId.includes("/")) {
+        const keyPart = normalizedId.split("/")[0];
+        current = tokenIndex.get(keyPart);
+    }
+    if (!current)
+        return undefined;
+    const sourceToken = current.token;
+    const sourceCollection = current.collection;
+    const resolutionPath = [sourceToken.name];
+    let resolved = current;
+    let depth = 0;
+    while (resolved.token.aliasTargetId && depth < 10) {
+        const nextId = normalizeTokenId(resolved.token.aliasTargetId);
+        const next = tokenIndex.get(nextId);
+        if (!next)
+            break;
+        resolved = next;
+        resolutionPath.push(resolved.token.name);
+        depth++;
+    }
+    let valueDepth = 0;
+    while (valueDepth < 10) {
+        const rawVal = resolved.token.value;
+        if (typeof rawVal !== "string" || !rawVal.includes("VariableID:"))
+            break;
+        const nextId = normalizeTokenId(rawVal);
+        const next = tokenIndex.get(nextId) ?? tokenIndex.get(rawVal);
+        if (!next)
+            break;
+        resolved = next;
+        resolutionPath.push(resolved.token.name);
+        valueDepth++;
+    }
+    const cssVar = getPTBTokenVariableName(sourceCollection.name, sourceToken.name);
+    const canonicalCssVar = getPTBTokenVariableName(resolved.collection.name, resolved.token.name);
+    return {
+        sourceVariableId,
+        sourceTokenName: sourceToken.name,
+        sourceCodeName: sourceToken.codeName || sourceToken.name,
+        resolvedTokenId: resolved.token.id,
+        resolvedTokenName: resolved.token.name,
+        resolvedCodeName: resolved.token.codeName || resolved.token.name,
+        cssVar,
+        canonicalCssVar,
+        cssValue: formatCSSValue(resolved.token.value, resolved.token.type),
+        valueType: mapValueType(resolved.token.value, resolved.token.type),
+        resolutionPath: resolutionPath.length > 0 ? resolutionPath : [sourceToken.name]
+    };
+}
+function getActiveValue(value) {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value !== "object")
+        return value;
+    if ('value' in value)
+        return getActiveValue(value.value);
+    if ('r' in value && 'g' in value && 'b' in value)
+        return value;
+    const keys = Object.keys(value);
+    if (keys.length > 0) {
+        for (const key of keys) {
+            if (key.toLowerCase().includes("default") || key === "0") {
+                return getActiveValue(value[key]);
+            }
+        }
+        return getActiveValue(value[keys[0]]);
+    }
+    return value;
+}
+function extractScalarValue(value) {
+    const raw = getActiveValue(value);
+    if (typeof raw === "number")
+        return raw;
+    return null;
+}
+function mapValueType(value, type) {
+    if (type === "color")
+        return "COLOR";
+    const scalar = extractScalarValue(value);
+    if (scalar !== null) {
+        if (type === "spacing" || type === "radius" || type === "typography" || type === "dimension" || type === "other") {
+            return "DIMENSION";
+        }
+        return "NUMBER";
+    }
+    return "STRING";
+}
+function formatCSSValue(rawValue, type) {
+    const value = getActiveValue(rawValue);
+    if (type === "color") {
+        if (typeof value === "string")
+            return value;
+        if (typeof value === "object" && value !== null) {
+            const r = typeof value.r === 'number' ? Math.round(value.r * 255) : 0;
+            const g = typeof value.g === 'number' ? Math.round(value.g * 255) : 0;
+            const b = typeof value.b === 'number' ? Math.round(value.b * 255) : 0;
+            const a = typeof value.a === 'number' ? value.a : 1;
+            if (a < 1) {
+                return `rgba(${r}, ${g}, ${b}, ${a})`;
+            }
+            else {
+                const toHex = (c) => {
+                    const hex = c.toString(16);
+                    return hex.length === 1 ? "0" + hex : hex;
+                };
+                return `#${toHex(r)}${toHex(g)}${toHex(b)}`.toUpperCase();
+            }
+        }
+        return String(value);
+    }
+    const scalar = extractScalarValue(rawValue);
+    if (scalar !== null) {
+        if (type === "spacing" || type === "radius" || type === "typography" || type === "dimension" || type === "other") {
+            return `${scalar}px`;
+        }
+        return String(scalar);
+    }
+    // Never surface unresolvable Figma variable IDs as CSS fallback values
+    if (typeof value === "string" && value.includes("VariableID:"))
+        return "";
+    return String(value);
+}
+//# sourceMappingURL=resolution.js.map