figma-inspect-cli 0.1.0

package/dist/inspect/contract/fingerprint.js

@@ -0,0 +1,301 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { isRecord, readBoolean, readChildren, readNumber, readRecord, readString, } from "../component-set-spec/figma-node.js";
+import { parseComponentSetProps, parseVariantName, } from "../component-set-spec/parse-props.js";
+import { stableStringify } from "./stable-stringify.js";
+function sha256Hex(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+export function fingerprintTree(tree) {
+    return sha256Hex(stableStringify(tree));
+}
+const layoutKeys = [
+    "layoutMode",
+    "layoutWrap",
+    "layoutPositioning",
+    "layoutSizingHorizontal",
+    "layoutSizingVertical",
+    "primaryAxisSizingMode",
+    "counterAxisSizingMode",
+    "primaryAxisAlignItems",
+    "counterAxisAlignItems",
+    "itemSpacing",
+    "counterAxisSpacing",
+    "layoutGrow",
+    "layoutAlign",
+    "minWidth",
+    "maxWidth",
+    "minHeight",
+    "maxHeight",
+    "paddingTop",
+    "paddingRight",
+    "paddingBottom",
+    "paddingLeft",
+    "clipsContent",
+];
+const textStyleKeys = [
+    "fontFamily",
+    "fontPostScriptName",
+    "fontSize",
+    "fontWeight",
+    "fontStyle",
+    "textAlignHorizontal",
+    "textAlignVertical",
+    "textAutoResize",
+    "lineHeightPx",
+    "lineHeightPercent",
+    "lineHeightUnit",
+    "letterSpacing",
+    "paragraphSpacing",
+    "paragraphIndent",
+    "listSpacing",
+];
+const paintKeys = [
+    "type",
+    "visible",
+    "opacity",
+    "blendMode",
+    "color",
+    "boundVariables",
+    "gradientStops",
+    "imageRef",
+    "scaleMode",
+    "scalingFactor",
+];
+const effectKeys = [
+    "type",
+    "visible",
+    "radius",
+    "spread",
+    "offset",
+    "color",
+    "blendMode",
+    "showShadowBehindNode",
+];
+function pruneSurfaceRecord(value) {
+    const entries = Object.entries(value).filter(([, entry]) => {
+        if (entry === undefined) {
+            return false;
+        }
+        if (Array.isArray(entry)) {
+            return entry.length > 0;
+        }
+        if (isRecord(entry)) {
+            return Object.keys(entry).length > 0;
+        }
+        return true;
+    });
+    return entries.length > 0 ? Object.fromEntries(entries) : undefined;
+}
+function variableAliasId(value) {
+    if (!isRecord(value) || readString(value, "type") !== "VARIABLE_ALIAS") {
+        return undefined;
+    }
+    return readString(value, "id")?.replace(/^VariableID:/, "");
+}
+function normalizeSurfaceValue(value, variables) {
+    const variable = variableAliasId(value);
+    if (variable) {
+        const token = variables?.resolve(variable);
+        return token ? { token } : { variable };
+    }
+    if (typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean") {
+        return value;
+    }
+    if (value === null) {
+        return null;
+    }
+    if (Array.isArray(value)) {
+        const normalized = value
+            .map((entry) => normalizeSurfaceValue(entry, variables))
+            .filter((entry) => entry !== undefined);
+        return normalized.length > 0 ? normalized : undefined;
+    }
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const normalized = {};
+    for (const [key, entry] of Object.entries(value)) {
+        normalized[key] = normalizeSurfaceValue(entry, variables);
+    }
+    return pruneSurfaceRecord(normalized);
+}
+function normalizePickedRecord(value, keys, variables) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const normalized = {};
+    for (const key of keys) {
+        if (key in value) {
+            normalized[key] = normalizeSurfaceValue(value[key], variables);
+        }
+    }
+    return pruneSurfaceRecord(normalized);
+}
+function normalizePaintList(value, variables) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const paints = value
+        .map((paint) => normalizePickedRecord(paint, paintKeys, variables))
+        .filter((paint) => paint !== undefined);
+    return paints.length > 0 ? paints : undefined;
+}
+function normalizeEffects(value, variables) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const effects = value
+        .map((effect) => normalizePickedRecord(effect, effectKeys, variables))
+        .filter((effect) => effect !== undefined);
+    return effects.length > 0 ? effects : undefined;
+}
+function normalizeDimensions(node) {
+    const box = readRecord(node, "absoluteBoundingBox");
+    if (!box) {
+        return undefined;
+    }
+    return pruneSurfaceRecord({
+        width: readNumber(box, "width"),
+        height: readNumber(box, "height"),
+    });
+}
+function normalizeComponentIdentity(node, teamComponents) {
+    const componentId = readString(node, "componentId");
+    if (!componentId) {
+        return undefined;
+    }
+    const teamComponent = teamComponents?.findById(componentId) ??
+        (node.name ? teamComponents?.findByName(node.name) : undefined);
+    return pruneSurfaceRecord({
+        id: componentId,
+        key: teamComponent?.key,
+        name: teamComponent?.name ?? readString(node, "name"),
+        fileKey: teamComponent?.fileKey,
+    });
+}
+function normalizeComponentProperties(value, variables) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const properties = {};
+    for (const [key, rawProperty] of Object.entries(value)) {
+        properties[key] = normalizePickedRecord(rawProperty, ["type", "value", "boundVariables"], variables);
+    }
+    return pruneSurfaceRecord(properties);
+}
+function normalizeComponentDefinitions(node, variables) {
+    if (node.type === "COMPONENT_SET") {
+        const { props, baseVariant } = parseComponentSetProps(node);
+        const variantNames = readChildren(node)
+            .filter((child) => readString(child, "type") === "COMPONENT")
+            .map((child) => readString(child, "name"))
+            .filter((name) => name !== undefined);
+        const variants = variantNames.map((name) => ({
+            name,
+            when: parseVariantName(name),
+        }));
+        return pruneSurfaceRecord({
+            props: normalizeSurfaceValue(props, variables),
+            baseVariant: normalizeSurfaceValue(baseVariant, variables),
+            variants: normalizeSurfaceValue(variants, variables),
+        });
+    }
+    const definitions = readRecord(node, "componentPropertyDefinitions");
+    if (!definitions) {
+        return undefined;
+    }
+    const normalized = {};
+    for (const [key, definition] of Object.entries(definitions)) {
+        normalized[key] = normalizePickedRecord(definition, [
+            "type",
+            "defaultValue",
+            "variantOptions",
+            "preferredValues",
+            "boundVariables",
+        ], variables);
+    }
+    return pruneSurfaceRecord(normalized);
+}
+function normalizeSurfaceNode(node, variables, teamComponents) {
+    const visible = readBoolean(node, "visible");
+    const variant = node.type === "COMPONENT" && node.name
+        ? pruneSurfaceRecord(parseVariantName(node.name))
+        : undefined;
+    const children = readChildren(node)
+        .map((child) => normalizeSurfaceNode(child, variables, teamComponents))
+        .filter((child) => child !== undefined);
+    return pruneSurfaceRecord({
+        type: readString(node, "type"),
+        name: readString(node, "name"),
+        hidden: visible === false ? true : undefined,
+        component: normalizeComponentIdentity(node, teamComponents),
+        componentProperties: normalizeComponentProperties(readRecord(node, "componentProperties"), variables),
+        componentPropertyReferences: normalizeSurfaceValue(readRecord(node, "componentPropertyReferences"), variables),
+        componentDefinitions: normalizeComponentDefinitions(node, variables),
+        variant,
+        layout: normalizePickedRecord(node, layoutKeys, variables),
+        constraints: normalizePickedRecord(readRecord(node, "constraints"), ["horizontal", "vertical"], variables),
+        dimensions: normalizeDimensions(node),
+        style: pruneSurfaceRecord({
+            fills: normalizePaintList(node.fills, variables),
+            strokes: normalizePaintList(node.strokes, variables),
+            effects: normalizeEffects(node.effects, variables),
+            opacity: readNumber(node, "opacity"),
+            blendMode: readString(node, "blendMode"),
+            strokeWeight: normalizeSurfaceValue(node.strokeWeight, variables),
+            strokeAlign: readString(node, "strokeAlign"),
+            strokeDashes: normalizeSurfaceValue(node.strokeDashes, variables),
+            individualStrokeWeights: normalizeSurfaceValue(node.individualStrokeWeights, variables),
+            cornerRadius: normalizeSurfaceValue(node.cornerRadius, variables),
+            rectangleCornerRadii: normalizeSurfaceValue(node.rectangleCornerRadii, variables),
+            cornerSmoothing: readNumber(node, "cornerSmoothing"),
+        }),
+        text: pruneSurfaceRecord({
+            characters: readString(node, "characters"),
+            style: normalizePickedRecord(readRecord(node, "style"), textStyleKeys),
+        }),
+        boundVariables: normalizeSurfaceValue(readRecord(node, "boundVariables"), variables),
+        children,
+    });
+}
+export function fingerprintContractSurface(tree, variables, teamComponents) {
+    return sha256Hex(stableStringify(normalizeSurfaceNode(tree, variables, teamComponents)));
+}
+export function fingerprintContracts(visuals, geometry, meta, structureDsl) {
+    return sha256Hex(stableStringify({
+        visuals,
+        geometry,
+        meta,
+        structureDsl,
+    }));
+}
+export function variantAssetSlug(when, variantAxes) {
+    const orderedAxes = Object.keys(variantAxes).sort((left, right) => {
+        if (left === "Size") {
+            return 1;
+        }
+        if (right === "Size") {
+            return -1;
+        }
+        return left.localeCompare(right);
+    });
+    const parts = orderedAxes
+        .map((axis) => when[axis])
+        .filter((value) => typeof value === "string")
+        .map((value) => value.toLowerCase());
+    return parts.join("-");
+}
+export async function fingerprintAssetFiles(assetsDir, slugs) {
+    const fingerprints = {};
+    for (const slug of slugs.sort()) {
+        const absolutePath = path.join(assetsDir, `${slug}.svg`);
+        const bytes = await readFile(absolutePath);
+        fingerprints[slug] = sha256Hex(bytes);
+    }
+    return fingerprints;
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/inspect/contract/fingerprint.js.map

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

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

@@ -0,0 +1,30 @@
+export interface LockApproval {
+    status: "unverified" | "verified" | "deprecated";
+    verifiedAt: string | null;
+    verifiedBy: string | null;
+    baselineRevision: string | null;
+}
+export interface LockDrift {
+    lastCheckedAt: string | null;
+    metadataChanged: boolean;
+    sourceChanged: boolean;
+    structureChanged: boolean;
+    visualsChanged: boolean;
+}
+export interface LockFingerprintsV1 {
+    tree: string;
+    contracts: string;
+}
+export interface LockFingerprintsV2 extends LockFingerprintsV1 {
+    contractSurface: string;
+}
+export type LockFingerprints = LockFingerprintsV1 | LockFingerprintsV2;
+export declare function hasContractSurfaceFingerprint(fingerprints: LockFingerprints): fingerprints is LockFingerprintsV2;
+export declare function defaultLockApproval(): LockApproval;
+export declare function defaultLockDrift(): LockDrift;
+export declare function normalizeLockVersion(value: unknown): 1 | 2 | undefined;
+export declare function normalizeVersionedLockMetadata(record: Record<string, unknown>, version: 1 | 2): {
+    approval: LockApproval;
+    drift: LockDrift;
+} | undefined;
+//# sourceMappingURL=lock-metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lock-metadata.d.ts","sourceRoot":"","sources":["../../../src/inspect/contract/lock-metadata.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,GAAG,UAAU,GAAG,YAAY,CAAC;IACjD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAEvE,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,gBAAgB,GAC7B,YAAY,IAAI,kBAAkB,CAEpC;AAED,wBAAgB,mBAAmB,IAAI,YAAY,CAOlD;AAED,wBAAgB,gBAAgB,IAAI,SAAS,CAQ5C;AAmBD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAKtE;AA+DD,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,CAAC,GAAG,CAAC,GACb;IAAE,QAAQ,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG,SAAS,CAe1D"}

package/dist/inspect/contract/lock-metadata.js

@@ -0,0 +1,101 @@
+export function hasContractSurfaceFingerprint(fingerprints) {
+    return "contractSurface" in fingerprints;
+}
+export function defaultLockApproval() {
+    return {
+        status: "unverified",
+        verifiedAt: null,
+        verifiedBy: null,
+        baselineRevision: null,
+    };
+}
+export function defaultLockDrift() {
+    return {
+        lastCheckedAt: null,
+        metadataChanged: false,
+        sourceChanged: false,
+        structureChanged: false,
+        visualsChanged: false,
+    };
+}
+function readRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function readNullableString(record, key) {
+    const field = record[key];
+    if (field === null) {
+        return null;
+    }
+    return typeof field === "string" ? field : undefined;
+}
+export function normalizeLockVersion(value) {
+    const record = readRecord(value);
+    return record?.version === 1 || record?.version === 2
+        ? record.version
+        : undefined;
+}
+function normalizeLockApproval(value) {
+    const record = readRecord(value);
+    if (!record) {
+        return undefined;
+    }
+    const status = record.status;
+    if (status !== "unverified" &&
+        status !== "verified" &&
+        status !== "deprecated") {
+        return undefined;
+    }
+    const verifiedAt = readNullableString(record, "verifiedAt");
+    const verifiedBy = readNullableString(record, "verifiedBy");
+    const baselineRevision = readNullableString(record, "baselineRevision");
+    if (verifiedAt === undefined ||
+        verifiedBy === undefined ||
+        baselineRevision === undefined) {
+        return undefined;
+    }
+    return { status, verifiedAt, verifiedBy, baselineRevision };
+}
+function normalizeLockDrift(value) {
+    const record = readRecord(value);
+    if (!record) {
+        return undefined;
+    }
+    const lastCheckedAt = record.lastCheckedAt;
+    const metadataChanged = record.metadataChanged;
+    const sourceChanged = record.sourceChanged;
+    const structureChanged = record.structureChanged;
+    const visualsChanged = record.visualsChanged;
+    if (lastCheckedAt !== null && typeof lastCheckedAt !== "string") {
+        return undefined;
+    }
+    if (typeof metadataChanged !== "boolean" ||
+        typeof sourceChanged !== "boolean" ||
+        typeof structureChanged !== "boolean" ||
+        typeof visualsChanged !== "boolean") {
+        return undefined;
+    }
+    return {
+        lastCheckedAt,
+        metadataChanged,
+        sourceChanged,
+        structureChanged,
+        visualsChanged,
+    };
+}
+export function normalizeVersionedLockMetadata(record, version) {
+    if (version === 1) {
+        return {
+            approval: defaultLockApproval(),
+            drift: defaultLockDrift(),
+        };
+    }
+    const approval = normalizeLockApproval(record.approval);
+    const drift = normalizeLockDrift(record.drift);
+    if (!approval || !drift) {
+        return undefined;
+    }
+    return { approval, drift };
+}
+//# sourceMappingURL=lock-metadata.js.map

package/dist/inspect/contract/lock-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-metadata.js","sourceRoot":"","sources":["../../../src/inspect/contract/lock-metadata.ts"],"names":[],"mappings":"AA0BA,MAAM,UAAU,6BAA6B,CAC3C,YAA8B;IAE9B,OAAO,iBAAiB,IAAI,YAAY,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,IAAI;QAChB,gBAAgB,EAAE,IAAI;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,KAAK;QACtB,aAAa,EAAE,KAAK;QACpB,gBAAgB,EAAE,KAAK;QACvB,cAAc,EAAE,KAAK;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CACzB,MAA+B,EAC/B,GAAW;IAEX,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,MAAM,EAAE,OAAO,KAAK,CAAC,IAAI,MAAM,EAAE,OAAO,KAAK,CAAC;QACnD,CAAC,CAAC,MAAM,CAAC,OAAO;QAChB,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,IACE,MAAM,KAAK,YAAY;QACvB,MAAM,KAAK,UAAU;QACrB,MAAM,KAAK,YAAY,EACvB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC5D,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACxE,IACE,UAAU,KAAK,SAAS;QACxB,UAAU,KAAK,SAAS;QACxB,gBAAgB,KAAK,SAAS,EAC9B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IAC3C,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;IAC/C,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IAC3C,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;IACjD,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;IAC7C,IAAI,aAAa,KAAK,IAAI,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QAChE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IACE,OAAO,eAAe,KAAK,SAAS;QACpC,OAAO,aAAa,KAAK,SAAS;QAClC,OAAO,gBAAgB,KAAK,SAAS;QACrC,OAAO,cAAc,KAAK,SAAS,EACnC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,aAAa;QACb,eAAe;QACf,aAAa;QACb,gBAAgB;QAChB,cAAc;KACf,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,MAA+B,EAC/B,OAAc;IAEd,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO;YACL,QAAQ,EAAE,mBAAmB,EAAE;YAC/B,KAAK,EAAE,gBAAgB,EAAE;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC"}

package/dist/inspect/contract/stable-stringify.d.ts

@@ -0,0 +1,2 @@
+export declare function stableStringify(value: unknown): string;
+//# sourceMappingURL=stable-stringify.d.ts.map

package/dist/inspect/contract/stable-stringify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-stringify.d.ts","sourceRoot":"","sources":["../../../src/inspect/contract/stable-stringify.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWtD"}

package/dist/inspect/contract/stable-stringify.js

@@ -0,0 +1,14 @@
+import { isRecord } from "../component-set-spec/figma-node.js";
+export function stableStringify(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map((entry) => stableStringify(entry)).join(",")}]`;
+    }
+    if (isRecord(value)) {
+        return `{${Object.keys(value)
+            .sort()
+            .map((key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value) ?? "undefined";
+}
+//# sourceMappingURL=stable-stringify.js.map

package/dist/inspect/contract/stable-stringify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-stringify.js","sourceRoot":"","sources":["../../../src/inspect/contract/stable-stringify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAE/D,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACvE,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;aAC1B,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;aACrE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC;AAC9C,CAAC"}

package/dist/inspect/contract/verify-component-contract.d.ts

@@ -0,0 +1,19 @@
+import { type ContractFormat } from "./contract-format.js";
+import { type ContractLockDiff } from "./contract-lock.js";
+type ComponentContractVerifyStatus = "ok" | "changed" | "error";
+export interface ComponentContractVerifyResult {
+    componentName: string;
+    status: ComponentContractVerifyStatus;
+    errors: string[];
+    changed: ContractLockDiff;
+}
+export interface VerifyComponentContractsOptions {
+    token: string;
+    contractDir: string;
+    componentName?: string;
+    contractFormat?: ContractFormat;
+    fetchImpl?: typeof fetch;
+}
+export declare function verifyComponentContracts(options: VerifyComponentContractsOptions): Promise<ComponentContractVerifyResult[]>;
+export {};
+//# sourceMappingURL=verify-component-contract.d.ts.map

package/dist/inspect/contract/verify-component-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-component-contract.d.ts","sourceRoot":"","sources":["../../../src/inspect/contract/verify-component-contract.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,gBAAgB,EAQtB,MAAM,oBAAoB,CAAC;AAO5B,KAAK,6BAA6B,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;AAEhE,MAAM,WAAW,6BAA6B;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,6BAA6B,CAAC;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAiJD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,6BAA6B,EAAE,CAAC,CAiB1C"}

package/dist/inspect/contract/verify-component-contract.js

@@ -0,0 +1,126 @@
+import { readdir } from "node:fs/promises";
+import { filterFileComponentsForComponentSet, getComponentSetByKey, listFileComponents, } from "../../figma-api/index.js";
+import { loadComponentSetContext } from "../component-set-context.js";
+import { FigmaInspectError } from "../errors.js";
+import { detectContractFormat, } from "./contract-format.js";
+import { diffContractLock, isContractLockDiffEmpty, readContractLock, resolveContractLockPath, toLockVariants, } from "./contract-lock.js";
+import { readComponentContractArtifacts, validateComponentContractArtifacts, } from "./contract-schema.js";
+import { fingerprintContractSurface, fingerprintTree } from "./fingerprint.js";
+function lockFileNamePattern() {
+    return /^(.+)\.component-set\.lock\.yaml$/;
+}
+async function discoverLockedComponentNames(contractDir) {
+    const entries = await readdir(contractDir, { withFileTypes: true });
+    const names = [];
+    for (const entry of entries) {
+        if (!entry.isFile()) {
+            continue;
+        }
+        const match = entry.name.match(lockFileNamePattern());
+        if (match?.[1]) {
+            names.push(match[1]);
+        }
+    }
+    return names.sort((left, right) => left.localeCompare(right));
+}
+async function fetchLiveLockSnapshot(token, lock, fetchImpl = fetch) {
+    const [componentSetMeta, fileComponents, context] = await Promise.all([
+        getComponentSetByKey({
+            token,
+            componentSetKey: lock.source.componentSetKey,
+            fetchImpl,
+        }),
+        listFileComponents({
+            token,
+            fileKey: lock.source.fileKey,
+            fetchImpl,
+        }),
+        loadComponentSetContext({
+            token,
+            fileKey: lock.source.fileKey,
+            nodeId: lock.source.nodeId,
+            componentSet: { kind: "key", value: lock.source.componentSetKey },
+            fetchImpl,
+        }),
+    ]);
+    return {
+        source: {
+            fileKey: componentSetMeta.file_key,
+            nodeId: componentSetMeta.node_id,
+            nodeType: "COMPONENT_SET",
+            ...(lock.source.sourceUrl ? { sourceUrl: lock.source.sourceUrl } : {}),
+            componentSetKey: componentSetMeta.key,
+            componentSetUpdatedAt: componentSetMeta.updated_at,
+        },
+        variants: toLockVariants(filterFileComponentsForComponentSet(fileComponents, lock.source.nodeId)),
+        treeFingerprint: fingerprintTree(context.tree),
+        contractSurfaceFingerprint: fingerprintContractSurface(context.tree),
+    };
+}
+async function verifySingleComponentContract(options, componentName) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const errors = [];
+    const emptyDiff = {
+        source: false,
+        tree: false,
+        contractSurface: false,
+        variants: [],
+        addedVariants: [],
+        removedVariants: [],
+    };
+    try {
+        const lockPath = resolveContractLockPath(options.contractDir, componentName);
+        const lock = await readContractLock(lockPath);
+        if (!lock) {
+            return {
+                componentName,
+                status: "error",
+                errors: [`Missing lock file: ${lockPath}`],
+                changed: emptyDiff,
+            };
+        }
+        const contractFormat = options.contractFormat ??
+            (await detectContractFormat(options.contractDir, componentName));
+        const artifacts = await readComponentContractArtifacts(options.contractDir, componentName, contractFormat);
+        validateComponentContractArtifacts(artifacts, contractFormat);
+        const live = await fetchLiveLockSnapshot(options.token, lock, fetchImpl);
+        const changed = diffContractLock(lock, live);
+        const status = isContractLockDiffEmpty(changed)
+            ? "ok"
+            : "changed";
+        return {
+            componentName,
+            status,
+            errors: [],
+            changed,
+        };
+    }
+    catch (error) {
+        const message = error instanceof FigmaInspectError
+            ? error.message
+            : error instanceof Error
+                ? error.message
+                : String(error);
+        errors.push(message);
+        return {
+            componentName,
+            status: "error",
+            errors,
+            changed: emptyDiff,
+        };
+    }
+}
+export async function verifyComponentContracts(options) {
+    const componentNames = options.componentName
+        ? [options.componentName]
+        : await discoverLockedComponentNames(options.contractDir);
+    if (componentNames.length === 0) {
+        throw new FigmaInspectError(`No *.component-set.lock.yaml files found in ${options.contractDir}.`);
+    }
+    const results = [];
+    for (const componentName of componentNames) {
+        results.push(await verifySingleComponentContract(options, componentName));
+    }
+    return results;
+}
+//# sourceMappingURL=verify-component-contract.js.map

package/dist/inspect/contract/verify-component-contract.js.map

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

package/dist/inspect/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class FigmaInspectError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/inspect/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/inspect/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B"}