figma-inspect-cli 0.1.0

package/dist/inspect/node-contract/node-schema.js

@@ -0,0 +1,137 @@
+import { access, readFile } from "node:fs/promises";
+import { parse } from "yaml";
+import { z } from "zod";
+import { FigmaInspectError } from "../errors.js";
+import { nodeContractArtifactFileName, resolveNodeGeometryContractPath, resolveNodeMetaContractPath, resolveNodeStructureDslPath, resolveNodeVisualsContractPath, } from "./paths.js";
+const dependencySchema = z.object({
+    nodeId: z.string().min(1),
+    name: z.string().min(1).optional(),
+    key: z.string().min(1).optional(),
+    fileKey: z.string().min(1).optional(),
+    componentSetId: z.string().min(1).optional(),
+    componentSetName: z.string().min(1).optional(),
+    componentSetKey: z.string().min(1).optional(),
+});
+const metaContractSchema = z.object({
+    version: z.literal(1),
+    kind: z.enum(["component", "frame"]),
+    node: z.object({
+        id: z.string().min(1),
+        name: z.string().min(1),
+        type: z.enum(["COMPONENT", "FRAME"]),
+    }),
+    componentProperties: z
+        .record(z.string(), z.object({
+        type: z.string().min(1).optional(),
+        default: z.union([z.boolean(), z.string()]).optional(),
+        options: z.array(z.string()).optional(),
+    }))
+        .optional(),
+    dependencies: z.object({
+        componentSets: z.array(dependencySchema),
+        components: z.array(dependencySchema),
+    }),
+});
+const contractTreeSchema = z.lazy(() => z.record(z.string(), z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.array(z.unknown()),
+    contractTreeSchema,
+])));
+function formatSchemaIssues(error) {
+    return error.issues.map((issue) => {
+        const pathLabel = issue.path.length > 0 ? issue.path.join(".") : "(root)";
+        return `${pathLabel}: ${issue.message}`;
+    });
+}
+function parseRecord(raw, label, format) {
+    if (format === "json") {
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            throw new FigmaInspectError(`Invalid JSON in ${label}.`);
+        }
+        if (typeof parsed !== "object" ||
+            parsed === null ||
+            Array.isArray(parsed)) {
+            throw new FigmaInspectError(`${label} must be a JSON object.`);
+        }
+        return parsed;
+    }
+    const parsed = parse(raw);
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw new FigmaInspectError(`${label} must be a YAML mapping.`);
+    }
+    return parsed;
+}
+function validateRecord(schema, value, label) {
+    const result = schema.safeParse(value);
+    if (!result.success) {
+        throw new FigmaInspectError(`Invalid ${label}:\n${formatSchemaIssues(result.error).join("\n")}`);
+    }
+    return result.data;
+}
+function validateStructureDsl(options) {
+    const header = options.structureDsl.split("\n")[0]?.trim();
+    const expectedHeader = `node ${options.kind} ${JSON.stringify(options.nodeName)}`;
+    if (header !== expectedHeader) {
+        throw new FigmaInspectError(`Invalid node structure DSL: expected first line ${JSON.stringify(expectedHeader)}.`);
+    }
+    const requiredSnippets = [
+        "contracts {",
+        nodeContractArtifactFileName(options.nodeName, options.kind, "visuals", options.format),
+        nodeContractArtifactFileName(options.nodeName, options.kind, "geometry", options.format),
+        nodeContractArtifactFileName(options.nodeName, options.kind, "meta", options.format),
+        "resolve {",
+        "tree {",
+    ];
+    for (const snippet of requiredSnippets) {
+        if (!options.structureDsl.includes(snippet)) {
+            throw new FigmaInspectError(`Invalid node structure DSL: missing ${JSON.stringify(snippet)}.`);
+        }
+    }
+}
+export async function detectNodeContractFormat(contractDir, nodeName, kind) {
+    try {
+        await access(resolveNodeMetaContractPath(contractDir, nodeName, kind, "json"));
+        return "json";
+    }
+    catch {
+        return "yaml";
+    }
+}
+export async function readNodeContractArtifacts(contractDir, nodeName, kind, format = "yaml") {
+    const [metaRaw, geometryRaw, visualsRaw, structureDsl] = await Promise.all([
+        readFile(resolveNodeMetaContractPath(contractDir, nodeName, kind, format), "utf8"),
+        readFile(resolveNodeGeometryContractPath(contractDir, nodeName, kind, format), "utf8"),
+        readFile(resolveNodeVisualsContractPath(contractDir, nodeName, kind, format), "utf8"),
+        readFile(resolveNodeStructureDslPath(contractDir, nodeName, kind), "utf8"),
+    ]);
+    const meta = validateRecord(metaContractSchema, parseRecord(metaRaw, "node meta contract", format), "node meta contract");
+    const geometry = validateRecord(contractTreeSchema, parseRecord(geometryRaw, "node geometry contract", format), "node geometry contract");
+    const visuals = validateRecord(contractTreeSchema, parseRecord(visualsRaw, "node visuals contract", format), "node visuals contract");
+    validateStructureDsl({ structureDsl, nodeName, kind, format });
+    return {
+        nodeName,
+        kind,
+        meta,
+        geometry,
+        visuals,
+        structureDsl,
+    };
+}
+export function validateNodeContractArtifacts(artifacts, format = "yaml") {
+    validateRecord(metaContractSchema, artifacts.meta, "node meta contract");
+    validateRecord(contractTreeSchema, artifacts.geometry, "node geometry contract");
+    validateRecord(contractTreeSchema, artifacts.visuals, "node visuals contract");
+    validateStructureDsl({
+        structureDsl: artifacts.structureDsl,
+        nodeName: artifacts.nodeName,
+        kind: artifacts.kind,
+        format,
+    });
+}
+//# sourceMappingURL=node-schema.js.map

package/dist/inspect/node-contract/node-schema.js.map

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

package/dist/inspect/node-contract/paths.d.ts

@@ -0,0 +1,10 @@
+import type { ContractFormat } from "../contract/contract-format.js";
+import type { NodeContractKind } from "./types.js";
+export type NodeContractArtifact = "geometry" | "meta" | "visuals";
+export declare function nodeContractArtifactFileName(nodeName: string, kind: NodeContractKind, artifact: NodeContractArtifact, format?: ContractFormat): string;
+export declare function resolveNodeMetaContractPath(directory: string, nodeName: string, kind: NodeContractKind, format?: ContractFormat): string;
+export declare function resolveNodeGeometryContractPath(directory: string, nodeName: string, kind: NodeContractKind, format?: ContractFormat): string;
+export declare function resolveNodeVisualsContractPath(directory: string, nodeName: string, kind: NodeContractKind, format?: ContractFormat): string;
+export declare function resolveNodeStructureDslPath(directory: string, nodeName: string, kind: NodeContractKind): string;
+export declare function resolveNodeContractLockPath(directory: string, nodeName: string, kind: NodeContractKind): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/inspect/node-contract/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/inspect/node-contract/paths.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAMnE,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,GAAE,cAAuB,GAC9B,MAAM,CAER;AAgBD,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,gBAAgB,EACtB,MAAM,GAAE,cAAuB,GAC9B,MAAM,CAKR;AAED,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,gBAAgB,EACtB,MAAM,GAAE,cAAuB,GAC9B,MAAM,CAKR;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,gBAAgB,EACtB,MAAM,GAAE,cAAuB,GAC9B,MAAM,CAKR;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,gBAAgB,GACrB,MAAM,CAER;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,gBAAgB,GACrB,MAAM,CAER"}

package/dist/inspect/node-contract/paths.js

@@ -0,0 +1,29 @@
+import path from "node:path";
+function dataFileExtension(format) {
+    return format === "yaml" ? ".yaml" : ".json";
+}
+export function nodeContractArtifactFileName(nodeName, kind, artifact, format = "yaml") {
+    return `${nodeName}.${kind}.${artifact}${dataFileExtension(format)}`;
+}
+function nodeContractStructureFileName(nodeName, kind) {
+    return `${nodeName}.${kind}.structure.dsl`;
+}
+function nodeContractLockFileName(nodeName, kind) {
+    return `${nodeName}.${kind}.lock.yaml`;
+}
+export function resolveNodeMetaContractPath(directory, nodeName, kind, format = "yaml") {
+    return path.join(directory, nodeContractArtifactFileName(nodeName, kind, "meta", format));
+}
+export function resolveNodeGeometryContractPath(directory, nodeName, kind, format = "yaml") {
+    return path.join(directory, nodeContractArtifactFileName(nodeName, kind, "geometry", format));
+}
+export function resolveNodeVisualsContractPath(directory, nodeName, kind, format = "yaml") {
+    return path.join(directory, nodeContractArtifactFileName(nodeName, kind, "visuals", format));
+}
+export function resolveNodeStructureDslPath(directory, nodeName, kind) {
+    return path.join(directory, nodeContractStructureFileName(nodeName, kind));
+}
+export function resolveNodeContractLockPath(directory, nodeName, kind) {
+    return path.join(directory, nodeContractLockFileName(nodeName, kind));
+}
+//# sourceMappingURL=paths.js.map

package/dist/inspect/node-contract/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/inspect/node-contract/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B,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,4BAA4B,CAC1C,QAAgB,EAChB,IAAsB,EACtB,QAA8B,EAC9B,SAAyB,MAAM;IAE/B,OAAO,GAAG,QAAQ,IAAI,IAAI,IAAI,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,SAAS,6BAA6B,CACpC,QAAgB,EAChB,IAAsB;IAEtB,OAAO,GAAG,QAAQ,IAAI,IAAI,gBAAgB,CAAC;AAC7C,CAAC;AAED,SAAS,wBAAwB,CAC/B,QAAgB,EAChB,IAAsB;IAEtB,OAAO,GAAG,QAAQ,IAAI,IAAI,YAAY,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,SAAiB,EACjB,QAAgB,EAChB,IAAsB,EACtB,SAAyB,MAAM;IAE/B,OAAO,IAAI,CAAC,IAAI,CACd,SAAS,EACT,4BAA4B,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,SAAiB,EACjB,QAAgB,EAChB,IAAsB,EACtB,SAAyB,MAAM;IAE/B,OAAO,IAAI,CAAC,IAAI,CACd,SAAS,EACT,4BAA4B,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CACjE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,SAAiB,EACjB,QAAgB,EAChB,IAAsB,EACtB,SAAyB,MAAM;IAE/B,OAAO,IAAI,CAAC,IAAI,CACd,SAAS,EACT,4BAA4B,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAChE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,SAAiB,EACjB,QAAgB,EAChB,IAAsB;IAEtB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,6BAA6B,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,SAAiB,EACjB,QAAgB,EAChB,IAAsB;IAEtB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AACxE,CAAC"}

package/dist/inspect/node-contract/tokens.d.ts

@@ -0,0 +1,4 @@
+import type { SlimNode } from "../component-set-spec/types.js";
+import type { VariableRegistry } from "../component-set-spec/variable-registry.js";
+export declare function resolveSlimNodeTokens(node: SlimNode, registry: VariableRegistry): SlimNode;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/inspect/node-contract/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/inspect/node-contract/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAyCnF,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,gBAAgB,GACzB,QAAQ,CAEV"}

package/dist/inspect/node-contract/tokens.js

@@ -0,0 +1,30 @@
+function resolveVariableField(value, registry) {
+    const variable = value.variable;
+    if (typeof variable !== "string") {
+        return value;
+    }
+    const token = registry.resolve(variable);
+    if (!token) {
+        return value;
+    }
+    const { variable: _removed, ...rest } = value;
+    return { ...rest, token };
+}
+function resolveValue(value, registry) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => resolveValue(entry, registry));
+    }
+    if (typeof value !== "object" || value === null) {
+        return value;
+    }
+    const resolved = resolveVariableField(value, registry);
+    const output = {};
+    for (const [key, entry] of Object.entries(resolved)) {
+        output[key] = resolveValue(entry, registry);
+    }
+    return output;
+}
+export function resolveSlimNodeTokens(node, registry) {
+    return resolveValue(node, registry);
+}
+//# sourceMappingURL=tokens.js.map

package/dist/inspect/node-contract/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../src/inspect/node-contract/tokens.ts"],"names":[],"mappings":"AAGA,SAAS,oBAAoB,CAC3B,KAA8B,EAC9B,QAA0B;IAE1B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAChC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAC9C,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,YAAY,CAAC,KAAc,EAAE,QAA0B;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,oBAAoB,CACnC,KAAgC,EAChC,QAAQ,CACT,CAAC;IACF,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAAc,EACd,QAA0B;IAE1B,OAAO,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAa,CAAC;AAClD,CAAC"}

package/dist/inspect/node-contract/types.d.ts

@@ -0,0 +1,84 @@
+import type { ContractFormat } from "../contract/contract-format.js";
+import type { LockApproval, LockDrift, LockFingerprintsV1, LockFingerprintsV2 } from "../contract/lock-metadata.js";
+import type { DocumentNode } from "../schemas.js";
+export type NodeContractKind = "component" | "frame";
+export type NodeContractFigmaType = "COMPONENT" | "FRAME";
+export interface NodeContractSource {
+    fileKey: string;
+    nodeId: string;
+    nodeType: NodeContractFigmaType;
+    name: string;
+    sourceUrl?: string;
+}
+export interface NodeContractDependency {
+    nodeId: string;
+    name?: string;
+    key?: string;
+    fileKey?: string;
+    componentSetId?: string;
+    componentSetName?: string;
+    componentSetKey?: string;
+}
+export interface NodeContractDependencies {
+    componentSets: NodeContractDependency[];
+    components: NodeContractDependency[];
+}
+export interface NodeContractMeta {
+    version: 1;
+    kind: NodeContractKind;
+    node: {
+        id: string;
+        name: string;
+        type: NodeContractFigmaType;
+    };
+    componentProperties?: Record<string, {
+        type?: string;
+        default?: boolean | string;
+        options?: string[];
+    }>;
+    dependencies: NodeContractDependencies;
+}
+export interface NodeContractResult {
+    nodeName: string;
+    kind: NodeContractKind;
+    source: NodeContractSource;
+    rawNode: DocumentNode;
+    visuals: Record<string, unknown>;
+    geometry: Record<string, unknown>;
+    meta: NodeContractMeta;
+    structureDsl: string;
+    lock: NodeContractLock;
+}
+interface NodeContractLockBase {
+    kind: NodeContractKind;
+    source: NodeContractSource;
+    dependencies: NodeContractDependencies;
+    approval: LockApproval;
+    drift: LockDrift;
+}
+interface NodeContractLockV1 extends NodeContractLockBase {
+    version: 1;
+    fingerprints: LockFingerprintsV1;
+}
+interface NodeContractLockV2 extends NodeContractLockBase {
+    version: 2;
+    fingerprints: LockFingerprintsV2;
+}
+export type NodeContractLock = NodeContractLockV1 | NodeContractLockV2;
+export interface NodeContractLockDiff {
+    source: boolean;
+    tree: boolean;
+    contractSurface: boolean;
+    kind: boolean;
+}
+export interface BuildNodeContractOptions {
+    token: string;
+    fileKey: string;
+    nodeId: string;
+    sourceUrl?: string;
+    variablesPath: string;
+    format?: ContractFormat;
+    fetchImpl?: typeof fetch;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/inspect/node-contract/types.d.ts.map

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

package/dist/inspect/node-contract/types.js

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

package/dist/inspect/node-contract/types.js.map

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

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

@@ -0,0 +1,20 @@
+import type { ContractFormat } from "../contract/contract-format.js";
+import type { NodeContractKind, NodeContractLockDiff } from "./types.js";
+type NodeContractVerifyStatus = "changed" | "error" | "ok";
+export interface NodeContractVerifyResult {
+    nodeName: string;
+    kind: NodeContractKind;
+    status: NodeContractVerifyStatus;
+    errors: string[];
+    changed: NodeContractLockDiff;
+}
+export interface VerifyNodeContractsOptions {
+    token: string;
+    contractDir: string;
+    nodeName?: string;
+    contractFormat?: ContractFormat;
+    fetchImpl?: typeof fetch;
+}
+export declare function verifyNodeContracts(options: VerifyNodeContractsOptions): Promise<NodeContractVerifyResult[]>;
+export {};
+//# sourceMappingURL=verify-node-contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify-node-contract.d.ts","sourceRoot":"","sources":["../../../src/inspect/node-contract/verify-node-contract.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAmBrE,OAAO,KAAK,EACV,gBAAgB,EAEhB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,KAAK,wBAAwB,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC;AAE3D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAmJD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAmBrC"}

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

@@ -0,0 +1,131 @@
+import { readdir } from "node:fs/promises";
+import path from "node:path";
+import { fingerprintContractSurface, fingerprintTree, } from "../contract/fingerprint.js";
+import { FigmaInspectError } from "../errors.js";
+import { fetchFileNodeEntry } from "../fetch-file-node-entry.js";
+import { collectNodeContractDependencies } from "./dependencies.js";
+import { assertNodeContractRoot } from "./node-kind.js";
+import { diffNodeContractLock, isNodeContractLockDiffEmpty, readNodeContractLock, } from "./node-lock.js";
+import { detectNodeContractFormat, readNodeContractArtifacts, validateNodeContractArtifacts, } from "./node-schema.js";
+function emptyDiff() {
+    return {
+        source: false,
+        tree: false,
+        contractSurface: false,
+        kind: false,
+    };
+}
+function lockFileNamePattern() {
+    return /^(.+)\.(frame|component)\.lock\.yaml$/;
+}
+async function discoverNodeLocks(contractDir, nodeName) {
+    const entries = await readdir(contractDir, { withFileTypes: true });
+    const locks = [];
+    for (const entry of entries) {
+        if (!entry.isFile()) {
+            continue;
+        }
+        const match = entry.name.match(lockFileNamePattern());
+        const matchedNodeName = match?.[1];
+        const matchedKind = match?.[2];
+        if (!matchedNodeName || !matchedKind) {
+            continue;
+        }
+        if (nodeName && matchedNodeName !== nodeName) {
+            continue;
+        }
+        locks.push({
+            nodeName: matchedNodeName,
+            kind: matchedKind,
+            lockPath: path.join(contractDir, entry.name),
+        });
+    }
+    return locks.sort((left, right) => {
+        const byName = left.nodeName.localeCompare(right.nodeName);
+        return byName === 0 ? left.kind.localeCompare(right.kind) : byName;
+    });
+}
+async function verifySingleNodeContract(options, discovered) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    try {
+        const lock = await readNodeContractLock(discovered.lockPath);
+        if (!lock) {
+            return {
+                nodeName: discovered.nodeName,
+                kind: discovered.kind,
+                status: "error",
+                errors: [`Missing lock file: ${discovered.lockPath}`],
+                changed: emptyDiff(),
+            };
+        }
+        const contractFormat = options.contractFormat ??
+            (await detectNodeContractFormat(options.contractDir, discovered.nodeName, discovered.kind));
+        const artifacts = await readNodeContractArtifacts(options.contractDir, discovered.nodeName, discovered.kind, contractFormat);
+        validateNodeContractArtifacts(artifacts, contractFormat);
+        const entry = await fetchFileNodeEntry({
+            token: options.token,
+            fileKey: lock.source.fileKey,
+            nodeId: lock.source.nodeId,
+            fetchImpl,
+        });
+        const { node, kind } = assertNodeContractRoot(entry, lock.source.nodeId);
+        const live = {
+            version: 2,
+            kind,
+            source: {
+                fileKey: lock.source.fileKey,
+                nodeId: node.id ?? lock.source.nodeId,
+                nodeType: node.type,
+                name: typeof node.name === "string" && node.name.length > 0
+                    ? node.name
+                    : lock.source.nodeId,
+                ...(lock.source.sourceUrl ? { sourceUrl: lock.source.sourceUrl } : {}),
+            },
+            fingerprints: {
+                tree: fingerprintTree(node),
+                contractSurface: fingerprintContractSurface(node),
+                contracts: lock.fingerprints.contracts,
+            },
+            dependencies: collectNodeContractDependencies(entry, node, lock.source.fileKey),
+            approval: lock.approval,
+            drift: lock.drift,
+        };
+        const changed = diffNodeContractLock(lock, live);
+        const status = isNodeContractLockDiffEmpty(changed) ? "ok" : "changed";
+        return {
+            nodeName: discovered.nodeName,
+            kind: discovered.kind,
+            status,
+            errors: [],
+            changed,
+        };
+    }
+    catch (error) {
+        const message = error instanceof FigmaInspectError
+            ? error.message
+            : error instanceof Error
+                ? error.message
+                : String(error);
+        return {
+            nodeName: discovered.nodeName,
+            kind: discovered.kind,
+            status: "error",
+            errors: [message],
+            changed: emptyDiff(),
+        };
+    }
+}
+export async function verifyNodeContracts(options) {
+    const discoveredLocks = await discoverNodeLocks(options.contractDir, options.nodeName);
+    if (discoveredLocks.length === 0) {
+        throw new FigmaInspectError(options.nodeName
+            ? `No node lock files found for ${options.nodeName} in ${options.contractDir}.`
+            : `No *.frame.lock.yaml or *.component.lock.yaml files found in ${options.contractDir}.`);
+    }
+    const results = [];
+    for (const lock of discoveredLocks) {
+        results.push(await verifySingleNodeContract(options, lock));
+    }
+    return results;
+}
+//# sourceMappingURL=verify-node-contract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify-node-contract.js","sourceRoot":"","sources":["../../../src/inspect/node-contract/verify-node-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,0BAA0B,EAC1B,eAAe,GAChB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AA+B1B,SAAS,SAAS;IAChB,OAAO;QACL,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,KAAK;QACX,eAAe,EAAE,KAAK;QACtB,IAAI,EAAE,KAAK;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB;IAC1B,OAAO,uCAAuC,CAAC;AACjD,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,WAAmB,EACnB,QAAiB;IAEjB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,MAAM,KAAK,GAAyB,EAAE,CAAC;IAEvC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACpB,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE,CAAC,CAAC;QACtD,MAAM,eAAe,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,WAAW,GAAG,KAAK,EAAE,CAAC,CAAC,CAAiC,CAAC;QAC/D,IAAI,CAAC,eAAe,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,IAAI,eAAe,KAAK,QAAQ,EAAE,CAAC;YAC7C,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC;YACT,QAAQ,EAAE,eAAe;YACzB,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC;SAC7C,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3D,OAAO,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,OAAmC,EACnC,UAA8B;IAE9B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,MAAM,EAAE,OAAO;gBACf,MAAM,EAAE,CAAC,sBAAsB,UAAU,CAAC,QAAQ,EAAE,CAAC;gBACrD,OAAO,EAAE,SAAS,EAAE;aACrB,CAAC;QACJ,CAAC;QAED,MAAM,cAAc,GAClB,OAAO,CAAC,cAAc;YACtB,CAAC,MAAM,wBAAwB,CAC7B,OAAO,CAAC,WAAW,EACnB,UAAU,CAAC,QAAQ,EACnB,UAAU,CAAC,IAAI,CAChB,CAAC,CAAC;QACL,MAAM,SAAS,GAAG,MAAM,yBAAyB,CAC/C,OAAO,CAAC,WAAW,EACnB,UAAU,CAAC,QAAQ,EACnB,UAAU,CAAC,IAAI,EACf,cAAc,CACf,CAAC;QACF,6BAA6B,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAEzD,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC;YACrC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC1B,SAAS;SACV,CAAC,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzE,MAAM,IAAI,GAAqB;YAC7B,OAAO,EAAE,CAAC;YACV,IAAI;YACJ,MAAM,EAAE;gBACN,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;gBAC5B,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM;gBACrC,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,IAAI,EACF,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;oBACnD,CAAC,CAAC,IAAI,CAAC,IAAI;oBACX,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;gBACxB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvE;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;gBAC3B,eAAe,EAAE,0BAA0B,CAAC,IAAI,CAAC;gBACjD,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,SAAS;aACvC;YACD,YAAY,EAAE,+BAA+B,CAC3C,KAAK,EACL,IAAI,EACJ,IAAI,CAAC,MAAM,CAAC,OAAO,CACpB;YACD,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QACF,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAEvE,OAAO;YACL,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,MAAM;YACN,MAAM,EAAE,EAAE;YACV,OAAO;SACR,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GACX,KAAK,YAAY,iBAAiB;YAChC,CAAC,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAC,KAAK,YAAY,KAAK;gBACtB,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtB,OAAO;YACL,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,MAAM,EAAE,OAAO;YACf,MAAM,EAAE,CAAC,OAAO,CAAC;YACjB,OAAO,EAAE,SAAS,EAAE;SACrB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAmC;IAEnC,MAAM,eAAe,GAAG,MAAM,iBAAiB,CAC7C,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,QAAQ,CACjB,CAAC;IACF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,iBAAiB,CACzB,OAAO,CAAC,QAAQ;YACd,CAAC,CAAC,gCAAgC,OAAO,CAAC,QAAQ,OAAO,OAAO,CAAC,WAAW,GAAG;YAC/E,CAAC,CAAC,gEAAgE,OAAO,CAAC,WAAW,GAAG,CAC3F,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAA+B,EAAE,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,MAAM,wBAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/inspect/resolve-team-component-set.d.ts

@@ -0,0 +1,14 @@
+import { TeamComponentRegistry } from "./component-set-spec/team-component-registry.js";
+import type { ComponentSetScopeOptions, ComponentSetTarget, FigmaTeamComponentSet } from "./types.js";
+export interface ResolveTeamComponentSetScopeResult extends Pick<ComponentSetScopeOptions, "fileKey" | "nodeId" | "componentSet"> {
+    publishedSet: FigmaTeamComponentSet;
+    teamComponents: TeamComponentRegistry;
+}
+export interface ResolveTeamComponentSetOptions {
+    token: string;
+    teamId: string;
+    componentSet: ComponentSetTarget;
+    fetchImpl?: typeof fetch;
+}
+export declare function resolveTeamComponentSetScope({ token, teamId, componentSet, fetchImpl, }: ResolveTeamComponentSetOptions): Promise<ResolveTeamComponentSetScopeResult>;
+//# sourceMappingURL=resolve-team-component-set.d.ts.map

package/dist/inspect/resolve-team-component-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-team-component-set.d.ts","sourceRoot":"","sources":["../../src/inspect/resolve-team-component-set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAIxF,OAAO,KAAK,EAEV,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,kCACf,SAAQ,IAAI,CACV,wBAAwB,EACxB,SAAS,GAAG,QAAQ,GAAG,cAAc,CACtC;IACD,YAAY,EAAE,qBAAqB,CAAC;IACpC,cAAc,EAAE,qBAAqB,CAAC;CACvC;AAgBD,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,kBAAkB,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAqED,wBAAsB,4BAA4B,CAAC,EACjD,KAAK,EACL,MAAM,EACN,YAAY,EACZ,SAAS,GACV,EAAE,8BAA8B,GAAG,OAAO,CAAC,kCAAkC,CAAC,CAkC9E"}

package/dist/inspect/resolve-team-component-set.js

@@ -0,0 +1,77 @@
+import { TeamComponentRegistry } from "./component-set-spec/team-component-registry.js";
+import { FigmaInspectError } from "./errors.js";
+import { fetchFileNodeEntry } from "./fetch-file-node-entry.js";
+import { listAllComponentSets } from "./list-all-component-sets.js";
+function teamComponentRegistryFromPublishedSets(publishedSets) {
+    return TeamComponentRegistry.fromEntries(publishedSets.map((set) => ({
+        id: set.id,
+        key: set.key,
+        name: set.name,
+        fileKey: set.fileKey,
+        projectId: set.projectId,
+    })));
+}
+function matchesLookup(componentSet, lookup) {
+    return lookup.kind === "name"
+        ? componentSet.name === lookup.value
+        : componentSet.key === lookup.value;
+}
+function formatTeamComponentSetLocation(componentSet) {
+    return `${componentSet.name} (${componentSet.fileName}, ${componentSet.projectName})`;
+}
+async function assertComponentSetNodeTarget({ token, componentSet, fetchImpl, }) {
+    if (componentSet.kind !== "node") {
+        return;
+    }
+    const nodeEntry = await fetchFileNodeEntry({
+        token,
+        fileKey: componentSet.fileKey,
+        nodeId: componentSet.nodeId,
+        fetchImpl,
+    });
+    if (nodeEntry.document?.type !== "COMPONENT_SET") {
+        const type = nodeEntry.document?.type ?? "UNKNOWN";
+        throw new FigmaInspectError(`Figma node ${componentSet.nodeId} is ${type}; expected COMPONENT_SET.`);
+    }
+}
+function matchesTarget(componentSet, target) {
+    if (target.kind === "node") {
+        return (componentSet.fileKey === target.fileKey &&
+            componentSet.id === target.nodeId);
+    }
+    return matchesLookup(componentSet, target);
+}
+function targetLabel(componentSet) {
+    if (componentSet.kind === "name") {
+        return `name "${componentSet.value}"`;
+    }
+    if (componentSet.kind === "key") {
+        return `key ${componentSet.value}`;
+    }
+    return `node ${componentSet.nodeId} in file ${componentSet.fileKey}`;
+}
+export async function resolveTeamComponentSetScope({ token, teamId, componentSet, fetchImpl, }) {
+    await assertComponentSetNodeTarget({ token, componentSet, fetchImpl });
+    const publishedSets = await listAllComponentSets({
+        token,
+        teamId,
+        fetchImpl,
+    });
+    const matches = publishedSets.filter((entry) => matchesTarget(entry, componentSet));
+    if (matches.length === 0) {
+        throw new FigmaInspectError(`No published component set with ${targetLabel(componentSet)} found in team.`);
+    }
+    if (matches.length > 1) {
+        const locations = matches.map(formatTeamComponentSetLocation).join("; ");
+        throw new FigmaInspectError(`Multiple published component sets match: ${locations}. Use --inspect-component-set with --file-key and --node-id.`);
+    }
+    const match = matches[0];
+    return {
+        fileKey: match.fileKey,
+        nodeId: match.id,
+        componentSet: { kind: "key", value: match.key },
+        publishedSet: match,
+        teamComponents: teamComponentRegistryFromPublishedSets(publishedSets),
+    };
+}
+//# sourceMappingURL=resolve-team-component-set.js.map

package/dist/inspect/resolve-team-component-set.js.map

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