figma-inspect-cli 0.1.0

package/dist/inspect/component-set-spec/types.d.ts

@@ -0,0 +1,127 @@
+export interface ComponentSetPropDefinition {
+    type: "boolean" | "text" | "instance" | "variant";
+    default?: boolean | string;
+    options?: string[];
+    swapSet?: string;
+}
+export interface ComponentSetSpec {
+    name: string;
+    props: Record<string, ComponentSetPropDefinition>;
+    baseVariant: Record<string, string>;
+    variantAxes: Record<string, string[]>;
+    variants: ComponentSetVariant[];
+}
+export interface ComponentSetVariant {
+    when: Record<string, string>;
+    layout: SlimNode;
+}
+export interface SlimNode {
+    name?: string;
+    type: string;
+    prop?: string;
+    visible?: string;
+    layout?: SlimLayout;
+    style?: SlimStyle;
+    text?: SlimText;
+    component?: string | SlimComponentRef;
+    slots?: Record<string, string>;
+    icon?: SlimIcon;
+    children?: SlimNode[];
+}
+export interface SlimDimension {
+    value?: number | string;
+    variable?: string;
+    token?: string;
+}
+export interface SlimLayout {
+    mode?: "row" | "column";
+    gap?: number | SlimDimension;
+    padding?: SlimPadding;
+    align?: SlimAlign;
+    wrap?: boolean;
+    sizing?: SlimSizing;
+    width?: number | SlimDimension;
+    height?: number | SlimDimension;
+    grow?: number;
+    alignSelf?: string;
+    maxWidth?: number | SlimDimension;
+    minWidth?: number | SlimDimension;
+    maxHeight?: number | SlimDimension;
+    minHeight?: number | SlimDimension;
+    clip?: boolean;
+}
+export interface SlimPadding {
+    top?: number | SlimDimension;
+    right?: number | SlimDimension;
+    bottom?: number | SlimDimension;
+    left?: number | SlimDimension;
+}
+export interface SlimAlign {
+    main?: string;
+    cross?: string;
+}
+export interface SlimSizing {
+    horizontal?: string;
+    vertical?: string;
+    main?: string;
+    cross?: string;
+}
+export interface SlimStyle {
+    background?: SlimFill;
+    fills?: SlimFill[];
+    border?: SlimBorder;
+    radius?: number | SlimDimension | SlimRadius;
+    effects?: SlimEffect[];
+    opacity?: number;
+}
+export interface SlimFill {
+    type: "solid" | "gradient" | "image";
+    color?: string;
+    opacity?: number;
+    variable?: string;
+    token?: string;
+}
+export interface SlimBorder {
+    color?: string;
+    width?: number;
+    align?: string;
+    variable?: string;
+    token?: string;
+}
+export interface SlimRadius {
+    topLeft?: number | SlimDimension;
+    topRight?: number | SlimDimension;
+    bottomLeft?: number | SlimDimension;
+    bottomRight?: number | SlimDimension;
+    smoothing?: number;
+    variable?: string;
+    token?: string;
+}
+export interface SlimEffect {
+    type: string;
+    [key: string]: unknown;
+}
+export interface SlimText {
+    content?: string;
+    fontFamily?: string | SlimDimension;
+    fontSize?: number | SlimDimension;
+    fontWeight?: number | SlimDimension;
+    fontStyle?: string | SlimDimension;
+    align?: string;
+    verticalAlign?: string;
+    lineHeight?: number | SlimDimension;
+    letterSpacing?: number | SlimDimension;
+    autoResize?: string;
+    color?: SlimFill;
+}
+export interface SlimComponentRef {
+    id?: string;
+    name?: string;
+    props?: Record<string, string>;
+    swap?: string;
+}
+export interface SlimIcon {
+    size?: number;
+    color?: SlimFill;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/inspect/component-set-spec/types.d.ts.map

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

package/dist/inspect/component-set-spec/types.js

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

package/dist/inspect/component-set-spec/types.js.map

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

package/dist/inspect/component-set-spec/variable-registry.d.ts

@@ -0,0 +1,8 @@
+export declare class VariableRegistry {
+    private readonly byKey;
+    private readonly byId;
+    resolve(alias: string): string | undefined;
+    static fromExport(payload: Record<string, unknown>): VariableRegistry;
+}
+export declare function loadVariableRegistry(variablesPath: string): Promise<VariableRegistry>;
+//# sourceMappingURL=variable-registry.d.ts.map

package/dist/inspect/component-set-spec/variable-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-registry.d.ts","sourceRoot":"","sources":["../../../src/inspect/component-set-spec/variable-registry.ts"],"names":[],"mappings":"AAIA,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAElD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAgB1C,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;CA2BtE;AAcD,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,CAAC,CA6B3B"}

package/dist/inspect/component-set-spec/variable-registry.js

@@ -0,0 +1,74 @@
+import { readFile } from "node:fs/promises";
+import { FigmaInspectError } from "../errors.js";
+import { isRecord, readRecord, readString } from "./figma-node.js";
+export class VariableRegistry {
+    byKey = new Map();
+    byId = new Map();
+    resolve(alias) {
+        const normalized = alias.replace(/^VariableID:/, "");
+        const byId = this.byId.get(normalized);
+        if (byId) {
+            return byId;
+        }
+        const key = normalized.split("/")[0];
+        if (key) {
+            return this.byKey.get(key);
+        }
+        return undefined;
+    }
+    static fromExport(payload) {
+        const registry = new VariableRegistry();
+        const variables = readVariablesRecord(payload);
+        for (const variable of Object.values(variables)) {
+            if (!isRecord(variable)) {
+                continue;
+            }
+            const name = readString(variable, "name");
+            if (!name) {
+                continue;
+            }
+            const id = readString(variable, "id");
+            if (id) {
+                registry.byId.set(id.replace(/^VariableID:/, ""), name);
+            }
+            const key = readString(variable, "key");
+            if (key) {
+                registry.byKey.set(key, name);
+            }
+        }
+        return registry;
+    }
+}
+function readVariablesRecord(payload) {
+    const meta = readRecord(payload, "meta");
+    const fromMeta = meta ? readRecord(meta, "variables") : undefined;
+    if (fromMeta) {
+        return fromMeta;
+    }
+    return readRecord(payload, "variables") ?? {};
+}
+export async function loadVariableRegistry(variablesPath) {
+    let rawText;
+    try {
+        rawText = await readFile(variablesPath, "utf8");
+    }
+    catch {
+        throw new FigmaInspectError(`Cannot read variables file: ${variablesPath}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(rawText);
+    }
+    catch {
+        throw new FigmaInspectError(`Invalid JSON in variables file: ${variablesPath}`);
+    }
+    if (!isRecord(parsed)) {
+        throw new FigmaInspectError("Variables JSON must be an object.");
+    }
+    const variables = readVariablesRecord(parsed);
+    if (Object.keys(variables).length === 0) {
+        throw new FigmaInspectError("Variables JSON does not contain a variables map.");
+    }
+    return VariableRegistry.fromExport(parsed);
+}
+//# sourceMappingURL=variable-registry.js.map

package/dist/inspect/component-set-spec/variable-registry.js.map

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

package/dist/inspect/component-set-spec/variant-axes.d.ts

@@ -0,0 +1,2 @@
+export declare function collectVariantAxes(allVariants: Record<string, string>[]): Record<string, string[]>;
+//# sourceMappingURL=variant-axes.d.ts.map

package/dist/inspect/component-set-spec/variant-axes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant-axes.d.ts","sourceRoot":"","sources":["../../../src/inspect/component-set-spec/variant-axes.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GACpC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAgB1B"}

package/dist/inspect/component-set-spec/variant-axes.js

@@ -0,0 +1,14 @@
+export function collectVariantAxes(allVariants) {
+    const axes = new Map();
+    for (const variant of allVariants) {
+        for (const [key, value] of Object.entries(variant)) {
+            const values = axes.get(key) ?? new Set();
+            values.add(value);
+            axes.set(key, values);
+        }
+    }
+    return Object.fromEntries([...axes.entries()]
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, values]) => [key, [...values].sort()]));
+}
+//# sourceMappingURL=variant-axes.js.map

package/dist/inspect/component-set-spec/variant-axes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant-axes.js","sourceRoot":"","sources":["../../../src/inspect/component-set-spec/variant-axes.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB,CAChC,WAAqC;IAErC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE5C,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;QAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;YAClD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,WAAW,CACvB,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;SAChB,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;SACpD,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CACrD,CAAC;AACJ,CAAC"}

package/dist/inspect/contract/contract-format.d.ts

@@ -0,0 +1,5 @@
+export type ContractFormat = "json" | "yaml";
+export declare function contractArtifactFileName(componentName: string, artifact: "visuals" | "geometry" | "meta", format?: ContractFormat): string;
+export declare function serializeContractData(value: unknown, format: ContractFormat): string;
+export declare function detectContractFormat(contractDir: string, componentName: string): Promise<ContractFormat>;
+//# sourceMappingURL=contract-format.d.ts.map

package/dist/inspect/contract/contract-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-format.d.ts","sourceRoot":"","sources":["../../../src/inspect/contract/contract-format.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;AAM7C,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,EACzC,MAAM,GAAE,cAAuB,GAC9B,MAAM,CAGR;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,cAAc,GACrB,MAAM,CAMR;AAED,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,cAAc,CAAC,CAYzB"}

package/dist/inspect/contract/contract-format.js

@@ -0,0 +1,26 @@
+import { access } from "node:fs/promises";
+import path from "node:path";
+import { stringify } from "yaml";
+function dataFileExtension(format) {
+    return format === "yaml" ? ".yaml" : ".json";
+}
+export function contractArtifactFileName(componentName, artifact, format = "yaml") {
+    const extension = dataFileExtension(format);
+    return `${componentName}.component-set.${artifact}${extension}`;
+}
+export function serializeContractData(value, format) {
+    if (format === "yaml") {
+        return stringify(value);
+    }
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+export async function detectContractFormat(contractDir, componentName) {
+    try {
+        await access(path.join(contractDir, contractArtifactFileName(componentName, "meta", "json")));
+        return "json";
+    }
+    catch {
+        return "yaml";
+    }
+}
+//# sourceMappingURL=contract-format.js.map

package/dist/inspect/contract/contract-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-format.js","sourceRoot":"","sources":["../../../src/inspect/contract/contract-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAIjC,SAAS,iBAAiB,CAAC,MAAsB;IAC/C,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,aAAqB,EACrB,QAAyC,EACzC,SAAyB,MAAM;IAE/B,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO,GAAG,aAAa,kBAAkB,QAAQ,GAAG,SAAS,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAc,EACd,MAAsB;IAEtB,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAAmB,EACnB,aAAqB;IAErB,IAAI,CAAC;QACH,MAAM,MAAM,CACV,IAAI,CAAC,IAAI,CACP,WAAW,EACX,wBAAwB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,CACxD,CACF,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/inspect/contract/contract-lock.d.ts

@@ -0,0 +1,75 @@
+import { type LockApproval, type LockDrift, type LockFingerprintsV1, type LockFingerprintsV2 } from "./lock-metadata.js";
+export interface ContractLockSource {
+    fileKey: string;
+    nodeId: string;
+    nodeType?: "COMPONENT_SET";
+    sourceUrl?: string;
+    componentSetKey: string;
+    componentSetUpdatedAt: string;
+}
+export interface ContractLockVariant {
+    key: string;
+    nodeId: string;
+    name: string;
+    updatedAt: string;
+}
+interface ContractLockFingerprintsV1 extends LockFingerprintsV1 {
+    assets?: Record<string, string>;
+}
+export interface ContractLockFingerprintsV2 extends LockFingerprintsV2 {
+    assets?: Record<string, string>;
+}
+type ContractLockFingerprints = ContractLockFingerprintsV1 | ContractLockFingerprintsV2;
+interface ContractLockBase {
+    kind: "component-set";
+    source: ContractLockSource;
+    variants: ContractLockVariant[];
+    fingerprints: ContractLockFingerprints;
+    approval: LockApproval;
+    drift: LockDrift;
+}
+interface ContractLockV1 extends ContractLockBase {
+    version: 1;
+    fingerprints: ContractLockFingerprintsV1;
+}
+interface ContractLockV2 extends ContractLockBase {
+    version: 2;
+    source: ContractLockSource & {
+        nodeType: "COMPONENT_SET";
+    };
+    fingerprints: ContractLockFingerprintsV2;
+}
+export type ContractLock = ContractLockV1 | ContractLockV2;
+export declare function resolveContractLockPath(directory: string, componentName: string): string;
+export declare function buildContractLock(input: {
+    source: ContractLockSource;
+    variants: ContractLockVariant[];
+    fingerprints: ContractLockFingerprintsV2;
+}): ContractLockV2;
+export declare function readContractLock(lockPath: string): Promise<ContractLock | undefined>;
+export declare function toLockVariants(components: ReadonlyArray<{
+    key: string;
+    node_id: string;
+    name: string;
+    updated_at: string;
+}>): ContractLockVariant[];
+export interface ContractLockDiff {
+    source: boolean;
+    tree: boolean;
+    contractSurface: boolean;
+    variants: string[];
+    addedVariants: string[];
+    removedVariants: string[];
+}
+export declare function diffContractLock(lock: ContractLock, live: {
+    source: ContractLockSource;
+    variants: ContractLockVariant[];
+    treeFingerprint: string;
+    contractSurfaceFingerprint?: string;
+}): ContractLockDiff;
+export declare function isContractLockDiffEmpty(diff: ContractLockDiff): boolean;
+export declare function writeContractLock(lockPath: string, lock: ContractLock): Promise<void>;
+export declare function collectUnchangedVariantNodeIds(previousLock: ContractLock | undefined, variants: ContractLockVariant[], currentTreeFingerprint?: string, currentContractSurfaceFingerprint?: string): Set<string>;
+export declare function stabilizeContractLockDates(previousLock: ContractLock | undefined, lock: ContractLock): ContractLock;
+export {};
+//# sourceMappingURL=contract-lock.d.ts.map

package/dist/inspect/contract/contract-lock.d.ts.map

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