figma-inspect-cli 0.1.0

package/dist/inspect/export/export-variant-assets.js

@@ -0,0 +1,127 @@
+import { access, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { downloadRenderedImage, getFileImageUrls, } from "../../figma-api/get-file-images.js";
+import { readChildren, readString } from "../component-set-spec/figma-node.js";
+import { parseVariantName } from "../component-set-spec/parse-props.js";
+import { collectVariantAxes } from "../component-set-spec/variant-axes.js";
+import { variantAssetSlug } from "../contract/fingerprint.js";
+import { FigmaInspectError } from "../errors.js";
+import { assertComponentSetSupportsAssetExport, assertExportedSvgBytes, } from "./assert-asset-exportable.js";
+import { normalizeExportedSvgBytes } from "./normalize-exported-svg.js";
+function assetFileName(when, variantAxes) {
+    const slug = variantAssetSlug(when, variantAxes);
+    if (slug.length === 0) {
+        throw new FigmaInspectError("Variant asset name has no axis values.");
+    }
+    return `${slug}.svg`;
+}
+async function assetFileExists(absolutePath) {
+    try {
+        await access(absolutePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function collectVariantNodeRefs(componentSet) {
+    const variantNodes = readChildren(componentSet).filter((child) => readString(child, "type") === "COMPONENT");
+    const refs = [];
+    for (const variantNode of variantNodes) {
+        const nodeId = readString(variantNode, "id");
+        const variantName = readString(variantNode, "name");
+        if (!nodeId || !variantName) {
+            continue;
+        }
+        const when = parseVariantName(variantName);
+        if (Object.keys(when).length === 0) {
+            continue;
+        }
+        refs.push({ nodeId, when });
+    }
+    if (refs.length === 0) {
+        throw new FigmaInspectError("COMPONENT_SET has no exportable variants.");
+    }
+    return refs.sort((left, right) => JSON.stringify(left.when).localeCompare(JSON.stringify(right.when)));
+}
+function setNestedAsset(root, when, axes, entry) {
+    if (axes.length === 0) {
+        return;
+    }
+    const [axis, ...rest] = axes;
+    const value = when[axis ?? ""];
+    if (!value) {
+        return;
+    }
+    if (rest.length === 0) {
+        root[value] = entry;
+        return;
+    }
+    const current = root[value];
+    if (typeof current !== "object" || current === null || "path" in current) {
+        root[value] = {};
+    }
+    setNestedAsset(root[value], when, rest, entry);
+}
+function buildNestedAssetMap(entries, variantAxes) {
+    const axes = Object.keys(variantAxes);
+    const root = {};
+    for (const entry of entries) {
+        const { when, ...asset } = entry;
+        setNestedAsset(root, when, axes, asset);
+    }
+    return root;
+}
+export async function exportVariantAssets(options) {
+    assertComponentSetSupportsAssetExport(options.componentSet);
+    const variantRefs = collectVariantNodeRefs(options.componentSet);
+    const variantAxes = collectVariantAxes(variantRefs.map((ref) => ref.when));
+    const assetsDir = path.join(options.outputDir, `${options.baseName}.assets`);
+    await mkdir(assetsDir, { recursive: true });
+    const nodeIdsToExport = [];
+    for (const ref of variantRefs) {
+        if (!options.skipNodeIds?.has(ref.nodeId)) {
+            nodeIdsToExport.push(ref.nodeId);
+            continue;
+        }
+        const fileName = assetFileName(ref.when, variantAxes);
+        const absolutePath = path.join(assetsDir, fileName);
+        if (!(await assetFileExists(absolutePath))) {
+            nodeIdsToExport.push(ref.nodeId);
+        }
+    }
+    const imageUrls = nodeIdsToExport.length === 0
+        ? {}
+        : await getFileImageUrls({
+            token: options.token,
+            fileKey: options.fileKey,
+            nodeIds: nodeIdsToExport,
+            format: options.format,
+            fetchImpl: options.fetchImpl,
+        });
+    const entries = [];
+    const assetSlugs = [];
+    for (const ref of variantRefs) {
+        const fileName = assetFileName(ref.when, variantAxes);
+        assetSlugs.push(fileName.slice(0, -".svg".length));
+        const relativePath = path.posix.join(`${options.baseName}.assets`, fileName);
+        const absolutePath = path.join(options.outputDir, relativePath);
+        if (nodeIdsToExport.includes(ref.nodeId)) {
+            const rawBytes = await downloadRenderedImage(imageUrls[ref.nodeId], options.fetchImpl);
+            assertExportedSvgBytes(rawBytes, ref.nodeId);
+            const bytes = normalizeExportedSvgBytes(rawBytes);
+            await writeFile(absolutePath, bytes);
+        }
+        entries.push({
+            when: ref.when,
+            format: options.format,
+            path: relativePath,
+        });
+    }
+    return {
+        assetsDir,
+        assets: buildNestedAssetMap(entries, variantAxes),
+        assetSlugs,
+    };
+}
+//# sourceMappingURL=export-variant-assets.js.map

package/dist/inspect/export/export-variant-assets.js.map

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

package/dist/inspect/export/normalize-exported-svg.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeExportedSvgBytes(bytes: Uint8Array): Uint8Array;
+//# sourceMappingURL=normalize-exported-svg.d.ts.map

package/dist/inspect/export/normalize-exported-svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-exported-svg.d.ts","sourceRoot":"","sources":["../../../src/inspect/export/normalize-exported-svg.ts"],"names":[],"mappings":"AAYA,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAGvE"}

package/dist/inspect/export/normalize-exported-svg.js

@@ -0,0 +1,15 @@
+function stripRootSvgDimensions(attrs) {
+    return attrs
+        .replace(/\s+width=["'][^"']*["']/gi, "")
+        .replace(/\s+height=["'][^"']*["']/gi, "");
+}
+function normalizeExportedSvg(source) {
+    return source.replace(/<svg\b([^>]*)>/i, (_match, attrs) => {
+        return `<svg${stripRootSvgDimensions(attrs)}>`;
+    });
+}
+export function normalizeExportedSvgBytes(bytes) {
+    const text = new TextDecoder().decode(bytes);
+    return new TextEncoder().encode(normalizeExportedSvg(text));
+}
+//# sourceMappingURL=normalize-exported-svg.js.map

package/dist/inspect/export/normalize-exported-svg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-exported-svg.js","sourceRoot":"","sources":["../../../src/inspect/export/normalize-exported-svg.ts"],"names":[],"mappings":"AAAA,SAAS,sBAAsB,CAAC,KAAa;IAC3C,OAAO,KAAK;SACT,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC;SACxC,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAc;IAC1C,OAAO,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,KAAa,EAAE,EAAE;QACjE,OAAO,OAAO,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAiB;IACzD,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/inspect/export/rendered-image-bytes.d.ts

@@ -0,0 +1,4 @@
+export type RenderedImageFormat = "png" | "svg";
+export declare function assertPositiveScale(scale: number, label: string): void;
+export declare function normalizeRenderedImageBytes(bytes: Uint8Array, format: RenderedImageFormat, context: string, artifact: string): Uint8Array;
+//# sourceMappingURL=rendered-image-bytes.d.ts.map

package/dist/inspect/export/rendered-image-bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendered-image-bytes.d.ts","sourceRoot":"","sources":["../../../src/inspect/export/rendered-image-bytes.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,KAAK,CAAC;AAIhD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAItE;AAkBD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,UAAU,CAQZ"}

package/dist/inspect/export/rendered-image-bytes.js

@@ -0,0 +1,24 @@
+import { FigmaInspectError } from "../errors.js";
+import { assertExportedSvgBytes } from "./assert-asset-exportable.js";
+import { normalizeExportedSvgBytes } from "./normalize-exported-svg.js";
+const PNG_SIGNATURE = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
+export function assertPositiveScale(scale, label) {
+    if (!Number.isFinite(scale) || scale <= 0) {
+        throw new FigmaInspectError(`${label} must be a positive number.`);
+    }
+}
+function assertExportedPngBytes(bytes, context, artifact) {
+    const hasPngSignature = PNG_SIGNATURE.every((value, index) => bytes[index] === value);
+    if (!hasPngSignature) {
+        throw new FigmaInspectError(`Exported ${artifact} for ${context} is not PNG.`);
+    }
+}
+export function normalizeRenderedImageBytes(bytes, format, context, artifact) {
+    if (format === "svg") {
+        assertExportedSvgBytes(bytes, context);
+        return normalizeExportedSvgBytes(bytes);
+    }
+    assertExportedPngBytes(bytes, context, artifact);
+    return bytes;
+}
+//# sourceMappingURL=rendered-image-bytes.js.map

package/dist/inspect/export/rendered-image-bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendered-image-bytes.js","sourceRoot":"","sources":["../../../src/inspect/export/rendered-image-bytes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAIxE,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEvE,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,KAAa;IAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,iBAAiB,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAC7B,KAAiB,EACjB,OAAe,EACf,QAAgB;IAEhB,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,CACzC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,CACzC,CAAC;IAEF,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,IAAI,iBAAiB,CACzB,YAAY,QAAQ,QAAQ,OAAO,cAAc,CAClD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,KAAiB,EACjB,MAA2B,EAC3B,OAAe,EACf,QAAgB;IAEhB,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACvC,OAAO,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/inspect/export-contract-target.d.ts

@@ -0,0 +1,7 @@
+import type { ExportContractTarget, FigmaNodeRef } from "./types.js";
+export interface ResolveExportContractTargetOptions extends FigmaNodeRef {
+    token: string;
+    fetchImpl?: typeof fetch;
+}
+export declare function resolveExportContractTarget(options: ResolveExportContractTargetOptions): Promise<ExportContractTarget>;
+//# sourceMappingURL=export-contract-target.d.ts.map

package/dist/inspect/export-contract-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-contract-target.d.ts","sourceRoot":"","sources":["../../src/inspect/export-contract-target.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,WAAW,kCAAmC,SAAQ,YAAY;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,oBAAoB,CAAC,CAuC/B"}

package/dist/inspect/export-contract-target.js

@@ -0,0 +1,33 @@
+import { FigmaInspectError } from "./errors.js";
+import { fetchFileNodeEntry } from "./fetch-file-node-entry.js";
+import { assertNodeContractRoot } from "./node-contract/node-kind.js";
+export async function resolveExportContractTarget(options) {
+    const entry = await fetchFileNodeEntry({
+        token: options.token,
+        fileKey: options.fileKey,
+        nodeId: options.nodeId,
+        fetchImpl: options.fetchImpl,
+    });
+    const node = entry.document;
+    const nodeType = node?.type;
+    if (!node) {
+        throw new FigmaInspectError(`Node ${options.nodeId} has no document payload.`);
+    }
+    if (nodeType === "COMPONENT_SET") {
+        return {
+            kind: "component-set",
+            fileKey: options.fileKey,
+            nodeId: node.id ?? options.nodeId,
+        };
+    }
+    if (nodeType === "FRAME" || nodeType === "COMPONENT") {
+        const { node: nodeContractRoot } = assertNodeContractRoot(entry, options.nodeId);
+        return {
+            kind: "node",
+            fileKey: options.fileKey,
+            nodeId: nodeContractRoot.id ?? options.nodeId,
+        };
+    }
+    throw new FigmaInspectError(`Figma node ${options.nodeId} is ${nodeType ?? "UNKNOWN"}; --export-contract supports COMPONENT_SET, FRAME, or standalone COMPONENT.`);
+}
+//# sourceMappingURL=export-contract-target.js.map

package/dist/inspect/export-contract-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-contract-target.js","sourceRoot":"","sources":["../../src/inspect/export-contract-target.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAQtE,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAA2C;IAE3C,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC;QACrC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;IAC5B,MAAM,QAAQ,GAAG,IAAI,EAAE,IAAI,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,iBAAiB,CACzB,QAAQ,OAAO,CAAC,MAAM,2BAA2B,CAClD,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;QACjC,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,OAAO,CAAC,MAAM;SAClC,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QACrD,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,sBAAsB,CACvD,KAAK,EACL,OAAO,CAAC,MAAM,CACf,CAAC;QACF,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,gBAAgB,CAAC,EAAE,IAAI,OAAO,CAAC,MAAM;SAC9C,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,iBAAiB,CACzB,cAAc,OAAO,CAAC,MAAM,OAAO,QAAQ,IAAI,SAAS,6EAA6E,CACtI,CAAC;AACJ,CAAC"}

package/dist/inspect/fetch-file-entry.d.ts

@@ -0,0 +1,4 @@
+import type { GetFileOptions } from "../figma-api/types.js";
+import { type FileNodeEntry } from "./schemas.js";
+export declare function fetchFileEntry(options: GetFileOptions): Promise<FileNodeEntry>;
+//# sourceMappingURL=fetch-file-entry.d.ts.map

package/dist/inspect/fetch-file-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-file-entry.d.ts","sourceRoot":"","sources":["../../src/inspect/fetch-file-entry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,cAAc,CAAC;AAElE,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CAGxB"}

package/dist/inspect/fetch-file-entry.js

@@ -0,0 +1,7 @@
+import { getFile } from "../figma-api/get-file.js";
+import { parseFileEntry } from "./schemas.js";
+export async function fetchFileEntry(options) {
+    const payload = await getFile(options);
+    return parseFileEntry(payload);
+}
+//# sourceMappingURL=fetch-file-entry.js.map

package/dist/inspect/fetch-file-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-file-entry.js","sourceRoot":"","sources":["../../src/inspect/fetch-file-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEnD,OAAO,EAAsB,cAAc,EAAE,MAAM,cAAc,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC"}

package/dist/inspect/fetch-file-node-entry.d.ts

@@ -0,0 +1,4 @@
+import type { GetFileNodeOptions } from "../figma-api/types.js";
+import { type FileNodeEntry } from "./schemas.js";
+export declare function fetchFileNodeEntry(options: GetFileNodeOptions): Promise<FileNodeEntry>;
+//# sourceMappingURL=fetch-file-node-entry.d.ts.map

package/dist/inspect/fetch-file-node-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-file-node-entry.d.ts","sourceRoot":"","sources":["../../src/inspect/fetch-file-node-entry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,cAAc,CAAC;AAEtE,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAGxB"}

package/dist/inspect/fetch-file-node-entry.js

@@ -0,0 +1,7 @@
+import { getFileNode } from "../figma-api/get-file-node.js";
+import { parseFileNodeEntry } from "./schemas.js";
+export async function fetchFileNodeEntry(options) {
+    const payload = await getFileNode(options);
+    return parseFileNodeEntry(payload, options.nodeId);
+}
+//# sourceMappingURL=fetch-file-node-entry.js.map

package/dist/inspect/fetch-file-node-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-file-node-entry.js","sourceRoot":"","sources":["../../src/inspect/fetch-file-node-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE5D,OAAO,EAAsB,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEtE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAA2B;IAE3B,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;AACrD,CAAC"}

package/dist/inspect/figma-node-url.d.ts

@@ -0,0 +1,3 @@
+import type { FigmaNodeRef } from "./types.js";
+export declare function parseFigmaNodeUrl(rawUrl: string): FigmaNodeRef;
+//# sourceMappingURL=figma-node-url.d.ts.map

package/dist/inspect/figma-node-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-node-url.d.ts","sourceRoot":"","sources":["../../src/inspect/figma-node-url.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ/C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CA4B9D"}

package/dist/inspect/figma-node-url.js

@@ -0,0 +1,30 @@
+import { FigmaInspectError } from "./errors.js";
+const supportedFilePathKinds = new Set(["design", "file"]);
+function normalizeNodeId(nodeId) {
+    return nodeId.includes(":") ? nodeId : nodeId.replace(/-/g, ":");
+}
+export function parseFigmaNodeUrl(rawUrl) {
+    let url;
+    try {
+        url = new URL(rawUrl);
+    }
+    catch {
+        throw new FigmaInspectError(`Invalid Figma URL: ${rawUrl}`);
+    }
+    if (url.hostname !== "figma.com" && url.hostname !== "www.figma.com") {
+        throw new FigmaInspectError(`Invalid Figma URL host: ${url.hostname}`);
+    }
+    const [, pathKind, fileKey] = url.pathname.split("/");
+    if (!supportedFilePathKinds.has(pathKind) || !fileKey) {
+        throw new FigmaInspectError("Figma URL must use /design/<fileKey>/... or /file/<fileKey>/...");
+    }
+    const rawNodeId = url.searchParams.get("node-id");
+    if (!rawNodeId) {
+        throw new FigmaInspectError("Figma URL is missing node-id.");
+    }
+    return {
+        fileKey,
+        nodeId: normalizeNodeId(rawNodeId),
+    };
+}
+//# sourceMappingURL=figma-node-url.js.map

package/dist/inspect/figma-node-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-node-url.js","sourceRoot":"","sources":["../../src/inspect/figma-node-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAE3D,SAAS,eAAe,CAAC,MAAc;IACrC,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,iBAAiB,CAAC,sBAAsB,MAAM,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG,CAAC,QAAQ,KAAK,eAAe,EAAE,CAAC;QACrE,MAAM,IAAI,iBAAiB,CAAC,2BAA2B,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACtD,MAAM,IAAI,iBAAiB,CACzB,iEAAiE,CAClE,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,iBAAiB,CAAC,+BAA+B,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO;QACL,OAAO;QACP,MAAM,EAAE,eAAe,CAAC,SAAS,CAAC;KACnC,CAAC;AACJ,CAAC"}

package/dist/inspect/get-node-component-set.d.ts

@@ -0,0 +1,5 @@
+import type { DocumentNode } from "./schemas.js";
+import type { ComponentSetNodeRefOptions, ComponentSetScopeOptions } from "./types.js";
+export declare function getNodeComponentSet(options: ComponentSetScopeOptions): Promise<DocumentNode>;
+export declare function getNodeComponentSetByRef(options: ComponentSetNodeRefOptions): Promise<DocumentNode>;
+//# sourceMappingURL=get-node-component-set.d.ts.map

package/dist/inspect/get-node-component-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-node-component-set.d.ts","sourceRoot":"","sources":["../../src/inspect/get-node-component-set.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAEpB,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC,CAGvB;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,YAAY,CAAC,CAGvB"}

package/dist/inspect/get-node-component-set.js

@@ -0,0 +1,10 @@
+import { loadComponentSetContext, loadComponentSetContextByNodeRef, } from "./component-set-context.js";
+export async function getNodeComponentSet(options) {
+    const { tree } = await loadComponentSetContext(options);
+    return tree;
+}
+export async function getNodeComponentSetByRef(options) {
+    const { tree } = await loadComponentSetContextByNodeRef(options);
+    return tree;
+}
+//# sourceMappingURL=get-node-component-set.js.map

package/dist/inspect/get-node-component-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-node-component-set.js","sourceRoot":"","sources":["../../src/inspect/get-node-component-set.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,gCAAgC,GACjC,MAAM,4BAA4B,CAAC;AAOpC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAiC;IAEjC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAmC;IAEnC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,gCAAgC,CAAC,OAAO,CAAC,CAAC;IACjE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/inspect/index.d.ts

@@ -0,0 +1,17 @@
+export { loadComponentSetContext } from "./component-set-context.js";
+export { buildComponentSetPseudocodeFromFile, buildComponentSetPseudocodeFromRaw, resolveGeometryContractPath, resolveMetaContractPath, resolveStructureDslPath, resolveVisualsContractPath, } from "./component-set-pseudocode/index.js";
+export { buildComponentSetSpecFromFile } from "./component-set-spec/index.js";
+export { verifyComponentContracts } from "./contract/verify-component-contract.js";
+export { FigmaInspectError } from "./errors.js";
+export { DEFAULT_NESTED_ASSET_SCALE, exportNestedAssets, isNestedAssetNodeType, type NestedAssetFormat, type NestedAssetNodeType, type NestedAssetsOptions, supportedNestedAssetNodeTypes, } from "./export/export-nested-assets.js";
+export { DEFAULT_PREVIEW_SCALE, type ExportPreviewOptions, exportNodePreview, type PreviewFormat, } from "./export/export-node-preview.js";
+export { exportVariantAssets } from "./export/export-variant-assets.js";
+export { resolveExportContractTarget } from "./export-contract-target.js";
+export { parseFigmaNodeUrl } from "./figma-node-url.js";
+export { getNodeComponentSet, getNodeComponentSetByRef, } from "./get-node-component-set.js";
+export { listAllComponentSets } from "./list-all-component-sets.js";
+export { listComponentSetProperties, listComponentSetPropertiesByRef, } from "./list-component-set-properties.js";
+export { buildNodeContractFromRef, readNodeContractArtifacts, resolveNodeContractLockPath, resolveNodeGeometryContractPath, resolveNodeMetaContractPath, resolveNodeStructureDslPath, resolveNodeVisualsContractPath, validateNodeContractArtifacts, verifyNodeContracts, writeNodeContractLock, } from "./node-contract/index.js";
+export { resolveTeamComponentSetScope } from "./resolve-team-component-set.js";
+export { type BuildTeamIndexFileInput, buildTeamIndex, type TeamIndex, type TeamIndexFile, } from "./team-index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inspect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EACL,mCAAmC,EACnC,kCAAkC,EAClC,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,6BAA6B,GAC9B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,iBAAiB,EACjB,KAAK,aAAa,GACnB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,+BAA+B,EAC/B,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EACL,KAAK,uBAAuB,EAC5B,cAAc,EACd,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/inspect/index.js

@@ -0,0 +1,17 @@
+export { loadComponentSetContext } from "./component-set-context.js";
+export { buildComponentSetPseudocodeFromFile, buildComponentSetPseudocodeFromRaw, resolveGeometryContractPath, resolveMetaContractPath, resolveStructureDslPath, resolveVisualsContractPath, } from "./component-set-pseudocode/index.js";
+export { buildComponentSetSpecFromFile } from "./component-set-spec/index.js";
+export { verifyComponentContracts } from "./contract/verify-component-contract.js";
+export { FigmaInspectError } from "./errors.js";
+export { DEFAULT_NESTED_ASSET_SCALE, exportNestedAssets, isNestedAssetNodeType, supportedNestedAssetNodeTypes, } from "./export/export-nested-assets.js";
+export { DEFAULT_PREVIEW_SCALE, exportNodePreview, } from "./export/export-node-preview.js";
+export { exportVariantAssets } from "./export/export-variant-assets.js";
+export { resolveExportContractTarget } from "./export-contract-target.js";
+export { parseFigmaNodeUrl } from "./figma-node-url.js";
+export { getNodeComponentSet, getNodeComponentSetByRef, } from "./get-node-component-set.js";
+export { listAllComponentSets } from "./list-all-component-sets.js";
+export { listComponentSetProperties, listComponentSetPropertiesByRef, } from "./list-component-set-properties.js";
+export { buildNodeContractFromRef, readNodeContractArtifacts, resolveNodeContractLockPath, resolveNodeGeometryContractPath, resolveNodeMetaContractPath, resolveNodeStructureDslPath, resolveNodeVisualsContractPath, validateNodeContractArtifacts, verifyNodeContracts, writeNodeContractLock, } from "./node-contract/index.js";
+export { resolveTeamComponentSetScope } from "./resolve-team-component-set.js";
+export { buildTeamIndex, } from "./team-index.js";
+//# sourceMappingURL=index.js.map

package/dist/inspect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/inspect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EACL,mCAAmC,EACnC,kCAAkC,EAClC,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,EAIrB,6BAA6B,GAC9B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,qBAAqB,EAErB,iBAAiB,GAElB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,+BAA+B,EAC/B,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAEL,cAAc,GAGf,MAAM,iBAAiB,CAAC"}

package/dist/inspect/list-all-component-sets.d.ts

@@ -0,0 +1,3 @@
+import type { FigmaTeamComponentSet, ListAllComponentSetsOptions } from "./types.js";
+export declare function listAllComponentSets({ token, teamId, fetchImpl, }: ListAllComponentSetsOptions): Promise<FigmaTeamComponentSet[]>;
+//# sourceMappingURL=list-all-component-sets.d.ts.map

package/dist/inspect/list-all-component-sets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-all-component-sets.d.ts","sourceRoot":"","sources":["../../src/inspect/list-all-component-sets.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,qBAAqB,EACrB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAEpB,wBAAsB,oBAAoB,CAAC,EACzC,KAAK,EACL,MAAM,EACN,SAAiB,GAClB,EAAE,2BAA2B,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA6BhE"}

package/dist/inspect/list-all-component-sets.js

@@ -0,0 +1,27 @@
+import { listTeamComponentSets, listTeamProjectFiles, } from "../figma-api/index.js";
+export async function listAllComponentSets({ token, teamId, fetchImpl = fetch, }) {
+    const [publishedSets, files] = await Promise.all([
+        listTeamComponentSets({ token, teamId, fetchImpl }),
+        listTeamProjectFiles({ token, teamId, fetchImpl }),
+    ]);
+    const filesByKey = new Map(files.map((file) => [file.key, file]));
+    return publishedSets
+        .map((componentSet) => {
+        const file = filesByKey.get(componentSet.file_key);
+        return {
+            id: componentSet.node_id,
+            key: componentSet.key,
+            name: componentSet.name,
+            fileKey: componentSet.file_key,
+            fileName: file?.name ?? "",
+            projectId: file?.project_id ?? "",
+            projectName: file?.project_name ?? "",
+        };
+    })
+        .sort((left, right) => left.projectName !== right.projectName
+        ? left.projectName.localeCompare(right.projectName)
+        : left.fileName !== right.fileName
+            ? left.fileName.localeCompare(right.fileName)
+            : left.name.localeCompare(right.name));
+}
+//# sourceMappingURL=list-all-component-sets.js.map

package/dist/inspect/list-all-component-sets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-all-component-sets.js","sourceRoot":"","sources":["../../src/inspect/list-all-component-sets.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAM/B,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,EACzC,KAAK,EACL,MAAM,EACN,SAAS,GAAG,KAAK,GACW;IAC5B,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/C,qBAAqB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACnD,oBAAoB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;KACnD,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAElE,OAAO,aAAa;SACjB,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAEnD,OAAO;YACL,EAAE,EAAE,YAAY,CAAC,OAAO;YACxB,GAAG,EAAE,YAAY,CAAC,GAAG;YACrB,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,OAAO,EAAE,YAAY,CAAC,QAAQ;YAC9B,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE;YAC1B,SAAS,EAAE,IAAI,EAAE,UAAU,IAAI,EAAE;YACjC,WAAW,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE;SACtC,CAAC;IACJ,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACpB,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW;QACpC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC;QACnD,CAAC,CAAC,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;YAChC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC7C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAC1C,CAAC;AACN,CAAC"}

package/dist/inspect/list-component-set-properties.d.ts

@@ -0,0 +1,4 @@
+import type { ComponentSetNodeRefOptions, ComponentSetScopeOptions, FigmaComponentSetProperty } from "./types.js";
+export declare function listComponentSetProperties(options: ComponentSetScopeOptions): Promise<FigmaComponentSetProperty[]>;
+export declare function listComponentSetPropertiesByRef(options: ComponentSetNodeRefOptions): Promise<FigmaComponentSetProperty[]>;
+//# sourceMappingURL=list-component-set-properties.d.ts.map

package/dist/inspect/list-component-set-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-component-set-properties.d.ts","sourceRoot":"","sources":["../../src/inspect/list-component-set-properties.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAsGpB,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAItC;AAED,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAItC"}

package/dist/inspect/list-component-set-properties.js

@@ -0,0 +1,73 @@
+import { loadComponentSetContext, loadComponentSetContextByNodeRef, } from "./component-set-context.js";
+function addNestedComponent(seen, nested) {
+    const existing = seen.get(nested.id);
+    if (!existing) {
+        seen.set(nested.id, nested);
+        return;
+    }
+    if (nested.isExposedInstance) {
+        existing.isExposedInstance = true;
+    }
+}
+function resolveNestedComponentFromInstance(root, componentSetIdsByName, componentSets, components) {
+    if (root.type !== "INSTANCE" || !root.name) {
+        return undefined;
+    }
+    const isExposedInstance = root.isExposedInstance;
+    if (isExposedInstance) {
+        const componentSetId = componentSetIdsByName.get(root.name);
+        if (componentSetId) {
+            return { id: componentSetId, name: root.name, isExposedInstance };
+        }
+    }
+    if (!root.componentId) {
+        return undefined;
+    }
+    const component = components[root.componentId];
+    if (!component) {
+        return undefined;
+    }
+    if (component.componentSetId) {
+        const componentSet = componentSets[component.componentSetId];
+        if (componentSet !== undefined && componentSet.name === root.name) {
+            return {
+                id: component.componentSetId,
+                name: componentSet.name,
+                isExposedInstance,
+            };
+        }
+        return undefined;
+    }
+    if (component.name && component.name === root.name) {
+        return {
+            id: root.componentId,
+            name: component.name,
+            isExposedInstance,
+        };
+    }
+    return undefined;
+}
+function collectNestedComponents(root, componentSetIdsByName, componentSets, components, seen) {
+    const nested = resolveNestedComponentFromInstance(root, componentSetIdsByName, componentSets, components);
+    if (nested) {
+        addNestedComponent(seen, nested);
+    }
+    if (!root.children) {
+        return;
+    }
+    for (const child of root.children) {
+        collectNestedComponents(child, componentSetIdsByName, componentSets, components, seen);
+    }
+}
+export async function listComponentSetProperties(options) {
+    return listComponentSetPropertiesFromContext(await loadComponentSetContext(options));
+}
+export async function listComponentSetPropertiesByRef(options) {
+    return listComponentSetPropertiesFromContext(await loadComponentSetContextByNodeRef(options));
+}
+function listComponentSetPropertiesFromContext({ tree, componentSets, components, nameIndex, }) {
+    const seen = new Map();
+    collectNestedComponents(tree, nameIndex, componentSets, components, seen);
+    return [...seen.values()].sort((left, right) => left.name.localeCompare(right.name));
+}
+//# sourceMappingURL=list-component-set-properties.js.map

package/dist/inspect/list-component-set-properties.js.map

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

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

@@ -0,0 +1,12 @@
+import type { FileNodeEntry } from "../schemas.js";
+import type { BuildNodeContractOptions, NodeContractResult } from "./types.js";
+export declare function buildNodeContractFromEntry(options: {
+    entry: FileNodeEntry;
+    fileKey: string;
+    nodeId: string;
+    sourceUrl?: string;
+    variablesPath: string;
+    format?: "json" | "yaml";
+}): Promise<NodeContractResult>;
+export declare function buildNodeContractFromRef(options: BuildNodeContractOptions): Promise<NodeContractResult>;
+//# sourceMappingURL=build-node-contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-node-contract.d.ts","sourceRoot":"","sources":["../../../src/inspect/node-contract/build-node-contract.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,eAAe,CAAC;AAQjE,OAAO,KAAK,EACV,wBAAwB,EAGxB,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AA0LpB,wBAAsB,0BAA0B,CAAC,OAAO,EAAE;IACxD,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkE9B;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAgB7B"}