figma-inspect-cli 0.1.0

package/dist/inspect/errors.js

@@ -0,0 +1,7 @@
+export class FigmaInspectError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "FigmaInspectError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/inspect/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/inspect/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}

package/dist/inspect/export/assert-asset-exportable.d.ts

@@ -0,0 +1,3 @@
+export declare function assertComponentSetSupportsAssetExport(componentSet: Record<string, unknown>): void;
+export declare function assertExportedSvgBytes(bytes: Uint8Array, context: string): void;
+//# sourceMappingURL=assert-asset-exportable.d.ts.map

package/dist/inspect/export/assert-asset-exportable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-asset-exportable.d.ts","sourceRoot":"","sources":["../../../src/inspect/export/assert-asset-exportable.ts"],"names":[],"mappings":"AAkCA,wBAAgB,qCAAqC,CACnD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,IAAI,CAoBN;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,GACd,IAAI,CAKN"}

package/dist/inspect/export/assert-asset-exportable.js

@@ -0,0 +1,45 @@
+import { readChildren, readString } from "../component-set-spec/figma-node.js";
+import { parseComponentSetProps } from "../component-set-spec/parse-props.js";
+import { FigmaInspectError } from "../errors.js";
+function variantTreesContainTextNodes(componentSet) {
+    for (const variant of readChildren(componentSet)) {
+        if (readString(variant, "type") !== "COMPONENT") {
+            continue;
+        }
+        if (treeContainsTextNode(variant)) {
+            return true;
+        }
+    }
+    return false;
+}
+function treeContainsTextNode(node) {
+    if (readString(node, "type") === "TEXT") {
+        return true;
+    }
+    for (const child of readChildren(node)) {
+        if (treeContainsTextNode(child)) {
+            return true;
+        }
+    }
+    return false;
+}
+export function assertComponentSetSupportsAssetExport(componentSet) {
+    const { props } = parseComponentSetProps(componentSet);
+    const nonVariantProps = Object.entries(props).filter(([, definition]) => definition.type !== "variant");
+    if (nonVariantProps.length > 0) {
+        const summary = nonVariantProps
+            .map(([name, definition]) => `${name} (${definition.type})`)
+            .join(", ");
+        throw new FigmaInspectError(`Component set is not asset-exportable: ${summary}. --export-assets supports component sets with variant props only.`);
+    }
+    if (variantTreesContainTextNodes(componentSet)) {
+        throw new FigmaInspectError("Component set is not asset-exportable: variant trees contain TEXT nodes. Render labels in app code instead of baking them into exported SVG assets.");
+    }
+}
+export function assertExportedSvgBytes(bytes, context) {
+    const text = new TextDecoder().decode(bytes).trimStart();
+    if (!text.startsWith("<svg")) {
+        throw new FigmaInspectError(`Exported asset for ${context} is not SVG.`);
+    }
+}
+//# sourceMappingURL=assert-asset-exportable.js.map

package/dist/inspect/export/assert-asset-exportable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-asset-exportable.js","sourceRoot":"","sources":["../../../src/inspect/export/assert-asset-exportable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,SAAS,4BAA4B,CACnC,YAAqC;IAErC,KAAK,MAAM,OAAO,IAAI,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;QACjD,IAAI,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,WAAW,EAAE,CAAC;YAChD,SAAS;QACX,CAAC;QAED,IAAI,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAAC,IAA6B;IACzD,IAAI,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,YAAqC;IAErC,MAAM,EAAE,KAAK,EAAE,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAClD,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,CAClD,CAAC;IAEF,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,eAAe;aAC5B,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,UAAU,CAAC,IAAI,GAAG,CAAC;aAC3D,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,iBAAiB,CACzB,0CAA0C,OAAO,oEAAoE,CACtH,CAAC;IACJ,CAAC;IAED,IAAI,4BAA4B,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,iBAAiB,CACzB,qJAAqJ,CACtJ,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAiB,EACjB,OAAe;IAEf,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC;IACzD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,iBAAiB,CAAC,sBAAsB,OAAO,cAAc,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC"}

package/dist/inspect/export/export-nested-assets.d.ts

@@ -0,0 +1,94 @@
+import type { NodeContractKind } from "../node-contract/types.js";
+import type { DocumentNode } from "../schemas.js";
+import { type RenderedImageFormat } from "./rendered-image-bytes.js";
+export declare const DEFAULT_NESTED_ASSET_SCALE = 2;
+export type NestedAssetFormat = RenderedImageFormat;
+declare const NESTED_ASSET_NODE_TYPES: readonly ["BOOLEAN_OPERATION", "COMPONENT", "COMPONENT_SET", "FRAME", "GROUP", "INSTANCE", "VECTOR"];
+export type NestedAssetNodeType = (typeof NESTED_ASSET_NODE_TYPES)[number];
+type NestedAssetTypeReason = (typeof NESTED_ASSET_TYPE_REASONS)[NestedAssetNodeType];
+type NestedAssetReason = NestedAssetTypeReason | "name:visual-keyword" | "selection:explicit-node-id" | "selection:include-regex";
+declare const NESTED_ASSET_TYPE_REASONS: {
+    readonly BOOLEAN_OPERATION: "type:boolean_operation";
+    readonly COMPONENT: "type:component";
+    readonly COMPONENT_SET: "type:component_set";
+    readonly FRAME: "type:frame";
+    readonly GROUP: "type:group";
+    readonly INSTANCE: "type:instance";
+    readonly VECTOR: "type:vector";
+};
+export declare function isNestedAssetNodeType(value: string): value is NestedAssetNodeType;
+export declare function supportedNestedAssetNodeTypes(): readonly NestedAssetNodeType[];
+export interface NestedAssetsOptions {
+    nodeIds: readonly string[];
+    includeRegex?: string;
+    nodeTypes?: readonly NestedAssetNodeType[];
+    maxAssets?: number;
+    formats: readonly NestedAssetFormat[];
+    scale: number;
+}
+export interface ExportNestedAssetsOptions {
+    token: string;
+    fileKey: string;
+    root: DocumentNode;
+    baseName: string;
+    kind: "component-set" | NodeContractKind;
+    outputDir: string;
+    nestedAssets: NestedAssetsOptions;
+    fetchImpl?: typeof fetch;
+}
+export interface ExportNestedAssetsResult {
+    nestedAssetsDir: string;
+    nestedAssetsManifestPath: string;
+    manifest: NestedAssetsManifest;
+}
+interface NestedAssetCandidate {
+    nodeId: string;
+    name: string;
+    type: string;
+    nodePath: string;
+    reasons: NestedAssetReason[];
+    selected: boolean;
+}
+interface NestedAssetFile {
+    format: NestedAssetFormat;
+    path: string;
+    scale?: number;
+}
+interface NestedAssetExport {
+    nodeId: string;
+    name: string;
+    type: string;
+    nodePath: string;
+    reasons: NestedAssetReason[];
+    files: NestedAssetFile[];
+}
+interface NestedAssetWarning {
+    nodeId?: string;
+    message: string;
+}
+interface NestedAssetsManifest {
+    version: 1;
+    kind: "nested-assets";
+    source: {
+        fileKey: string;
+        nodeId: string;
+        nodeName: string;
+        nodeType: string;
+        nodePath: string;
+        contractKind: "component-set" | NodeContractKind;
+    };
+    criteria: {
+        explicitNodeIds: string[];
+        includeRegex?: string;
+        nodeTypes: NestedAssetNodeType[];
+        formats: NestedAssetFormat[];
+        scale: number;
+        maxAssets?: number;
+    };
+    candidates: NestedAssetCandidate[];
+    exports: NestedAssetExport[];
+    warnings: NestedAssetWarning[];
+}
+export declare function exportNestedAssets(options: ExportNestedAssetsOptions): Promise<ExportNestedAssetsResult>;
+export {};
+//# sourceMappingURL=export-nested-assets.d.ts.map

package/dist/inspect/export/export-nested-assets.d.ts.map

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

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

@@ -0,0 +1,333 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { downloadRenderedImage, getFileImageUrls, } from "../../figma-api/get-file-images.js";
+import { readString } from "../component-set-spec/figma-node.js";
+import { serializeContractData } from "../contract/contract-format.js";
+import { FigmaInspectError } from "../errors.js";
+import { assertPositiveScale, normalizeRenderedImageBytes, } from "./rendered-image-bytes.js";
+export const DEFAULT_NESTED_ASSET_SCALE = 2;
+const NESTED_ASSET_NODE_TYPES = [
+    "BOOLEAN_OPERATION",
+    "COMPONENT",
+    "COMPONENT_SET",
+    "FRAME",
+    "GROUP",
+    "INSTANCE",
+    "VECTOR",
+];
+const NESTED_ASSET_NODE_TYPE_VALUES = new Set(NESTED_ASSET_NODE_TYPES);
+const NESTED_ASSET_TYPE_REASONS = {
+    BOOLEAN_OPERATION: "type:boolean_operation",
+    COMPONENT: "type:component",
+    COMPONENT_SET: "type:component_set",
+    FRAME: "type:frame",
+    GROUP: "type:group",
+    INSTANCE: "type:instance",
+    VECTOR: "type:vector",
+};
+export function isNestedAssetNodeType(value) {
+    return NESTED_ASSET_NODE_TYPE_VALUES.has(value);
+}
+export function supportedNestedAssetNodeTypes() {
+    return NESTED_ASSET_NODE_TYPES;
+}
+const VISUAL_NAME_PATTERN = /\b(icon|logo|asset|image|illustration|avatar|photo|thumb|thumbnail|badge|mark|glyph|symbol|spinner|loader)\b/i;
+const GENERIC_NAME_PATTERN = /^(vector|rectangle|ellipse|line|path|group|frame|mask|union|subtract|intersect|exclude|boolean|shape)(\s*\d+)?$/i;
+function normalizeFormats(formats) {
+    return [...new Set(formats)];
+}
+function normalizeNodeTypes(nodeTypes) {
+    const values = nodeTypes?.length ? nodeTypes : NESTED_ASSET_NODE_TYPES;
+    return [...new Set(values)].sort();
+}
+function compileIncludeRegex(pattern) {
+    if (!pattern) {
+        return undefined;
+    }
+    try {
+        return new RegExp(pattern, "i");
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new FigmaInspectError(`Invalid nested asset include regex: ${error.message}`);
+        }
+        throw error;
+    }
+}
+function addReason(reasons, reason) {
+    if (!reasons.includes(reason)) {
+        reasons.push(reason);
+    }
+}
+function addReasons(reasons, next) {
+    for (const reason of next) {
+        addReason(reasons, reason);
+    }
+}
+function collectNodeRecords(root) {
+    const records = [];
+    let order = 0;
+    function visit(node, pathSegments) {
+        const name = readString(node, "name") ?? "Untitled";
+        const type = readString(node, "type") ?? "UNKNOWN";
+        const nodeId = readString(node, "id");
+        const nextPath = [...pathSegments, name];
+        if (nodeId) {
+            records.push({
+                nodeId,
+                name,
+                type,
+                nodePath: nextPath.join(" / "),
+                order,
+            });
+            order += 1;
+        }
+        for (const child of node.children ?? []) {
+            visit(child, nextPath);
+        }
+    }
+    visit(root, []);
+    return records;
+}
+function heuristicReasons(record, allowedTypes) {
+    if (!isNestedAssetNodeType(record.type) || !allowedTypes.has(record.type)) {
+        return [];
+    }
+    const reasons = [];
+    if (record.type === "INSTANCE" ||
+        record.type === "COMPONENT" ||
+        record.type === "COMPONENT_SET") {
+        reasons.push(NESTED_ASSET_TYPE_REASONS[record.type]);
+    }
+    else if (!GENERIC_NAME_PATTERN.test(record.name)) {
+        reasons.push(NESTED_ASSET_TYPE_REASONS[record.type]);
+    }
+    if (VISUAL_NAME_PATTERN.test(record.name) ||
+        VISUAL_NAME_PATTERN.test(record.nodePath)) {
+        reasons.push("name:visual-keyword");
+    }
+    return reasons;
+}
+function regexMatches(record, regex) {
+    return regex.test(record.name) || regex.test(record.nodePath);
+}
+function selectRecords(options) {
+    const byId = new Map(options.records.map((record) => [record.nodeId, record]));
+    const selected = new Map();
+    const candidateReasons = new Map();
+    const warnings = [];
+    function reasonsForCandidate(record) {
+        const existing = candidateReasons.get(record.nodeId);
+        if (existing) {
+            return existing;
+        }
+        const reasons = [];
+        candidateReasons.set(record.nodeId, reasons);
+        return reasons;
+    }
+    function addCandidate(record, reasons) {
+        addReasons(reasonsForCandidate(record), reasons);
+    }
+    function addSelected(record, reasons) {
+        const existing = selected.get(record.nodeId);
+        if (existing) {
+            addReasons(existing.reasons, reasons);
+            return;
+        }
+        selected.set(record.nodeId, { ...record, reasons: [...reasons] });
+    }
+    for (const record of options.records) {
+        if (record.nodeId === options.rootNodeId) {
+            continue;
+        }
+        const reasons = heuristicReasons(record, options.allowedTypes);
+        if (reasons.length > 0) {
+            addCandidate(record, reasons);
+        }
+        if (options.includeRegex &&
+            isNestedAssetNodeType(record.type) &&
+            options.allowedTypes.has(record.type) &&
+            regexMatches(record, options.includeRegex)) {
+            const selectionReasons = ["selection:include-regex"];
+            addCandidate(record, selectionReasons);
+            addSelected(record, selectionReasons);
+        }
+    }
+    for (const nodeId of options.nestedAssets.nodeIds) {
+        const record = byId.get(nodeId);
+        if (!record) {
+            throw new FigmaInspectError(`Nested asset node ${nodeId} was not found under the exported node.`);
+        }
+        const reasons = ["selection:explicit-node-id"];
+        addCandidate(record, reasons);
+        addSelected(record, reasons);
+    }
+    let selectedRecords = [...selected.values()].sort((left, right) => left.order - right.order);
+    const maxAssets = options.nestedAssets.maxAssets;
+    if (maxAssets !== undefined && selectedRecords.length > maxAssets) {
+        const omitted = selectedRecords.slice(maxAssets);
+        selectedRecords = selectedRecords.slice(0, maxAssets);
+        for (const record of omitted) {
+            warnings.push({
+                nodeId: record.nodeId,
+                message: `Skipped by --asset-max ${maxAssets}.`,
+            });
+        }
+    }
+    const selectedIds = new Set(selectedRecords.map((record) => record.nodeId));
+    const candidates = [...candidateReasons.entries()]
+        .map(([nodeId, reasons]) => {
+        const record = byId.get(nodeId);
+        if (!record) {
+            throw new FigmaInspectError(`Nested asset candidate ${nodeId} disappeared during selection.`);
+        }
+        return {
+            nodeId,
+            name: record.name,
+            type: record.type,
+            nodePath: record.nodePath,
+            reasons,
+            selected: selectedIds.has(nodeId),
+            order: record.order,
+        };
+    })
+        .sort((left, right) => left.order - right.order)
+        .map(({ order: _order, ...candidate }) => candidate);
+    return { selected: selectedRecords, candidates, warnings };
+}
+function slug(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80);
+}
+function assetFileName(record, index, format) {
+    const order = String(index + 1).padStart(3, "0");
+    const pathSlug = slug(record.nodePath);
+    const idSlug = slug(record.nodeId) || "node";
+    return `${order}-${pathSlug || "asset"}-${idSlug}.${format}`;
+}
+function nestedAssetsManifestPath(outputDir, baseName, kind) {
+    return path.join(outputDir, `${baseName}.${kind}.nested-assets.yaml`);
+}
+async function exportFiles(options) {
+    const assetsDir = path.join(options.outputDir, `${options.baseName}.assets`);
+    await mkdir(assetsDir, { recursive: true });
+    const exported = options.selected.map((record) => ({
+        nodeId: record.nodeId,
+        name: record.name,
+        type: record.type,
+        nodePath: record.nodePath,
+        reasons: record.reasons,
+        files: [],
+    }));
+    for (const format of options.formats) {
+        const imageUrls = await getFileImageUrls({
+            token: options.token,
+            fileKey: options.fileKey,
+            nodeIds: options.selected.map((record) => record.nodeId),
+            format,
+            scale: format === "png" ? options.scale : undefined,
+            fetchImpl: options.fetchImpl,
+        });
+        for (let index = 0; index < options.selected.length; index += 1) {
+            const record = options.selected[index];
+            const entry = exported[index];
+            const fileName = assetFileName(record, index, format);
+            const relativePath = path.posix.join(`${options.baseName}.assets`, fileName);
+            const absolutePath = path.join(options.outputDir, relativePath);
+            const rawBytes = await downloadRenderedImage(imageUrls[record.nodeId], options.fetchImpl);
+            await writeFile(absolutePath, normalizeRenderedImageBytes(rawBytes, format, record.nodeId, "nested asset"));
+            entry.files.push({
+                format,
+                path: relativePath,
+                ...(format === "png" ? { scale: options.scale } : {}),
+            });
+        }
+    }
+    return exported;
+}
+export async function exportNestedAssets(options) {
+    const formats = normalizeFormats(options.nestedAssets.formats);
+    if (formats.length === 0) {
+        throw new FigmaInspectError("Nested asset export requires at least one format.");
+    }
+    if (formats.includes("png")) {
+        assertPositiveScale(options.nestedAssets.scale, "Nested asset scale");
+    }
+    if (options.nestedAssets.nodeIds.length === 0 &&
+        !options.nestedAssets.includeRegex) {
+        throw new FigmaInspectError("Nested asset export requires --asset-node-id or --asset-include-regex.");
+    }
+    const rootNodeId = readString(options.root, "id");
+    const rootNodeName = readString(options.root, "name") ?? options.baseName;
+    const rootNodeType = readString(options.root, "type") ?? "UNKNOWN";
+    if (!rootNodeId) {
+        throw new FigmaInspectError("Exported node has no Figma node id.");
+    }
+    const records = collectNodeRecords(options.root);
+    const rootRecord = records.find((record) => record.nodeId === rootNodeId);
+    if (!rootRecord) {
+        throw new FigmaInspectError("Exported node was not collected for export.");
+    }
+    const nodeTypes = normalizeNodeTypes(options.nestedAssets.nodeTypes);
+    const allowedTypes = new Set(nodeTypes);
+    const includeRegex = compileIncludeRegex(options.nestedAssets.includeRegex);
+    const { selected, candidates, warnings } = selectRecords({
+        records,
+        nestedAssets: options.nestedAssets,
+        rootNodeId,
+        allowedTypes,
+        includeRegex,
+    });
+    if (selected.length === 0) {
+        throw new FigmaInspectError("Nested asset selection matched no nodes under the exported node.");
+    }
+    const exported = await exportFiles({
+        token: options.token,
+        fileKey: options.fileKey,
+        outputDir: options.outputDir,
+        baseName: options.baseName,
+        selected,
+        formats,
+        scale: options.nestedAssets.scale,
+        fetchImpl: options.fetchImpl,
+    });
+    const manifest = {
+        version: 1,
+        kind: "nested-assets",
+        source: {
+            fileKey: options.fileKey,
+            nodeId: rootNodeId,
+            nodeName: rootNodeName,
+            nodeType: rootNodeType,
+            nodePath: rootRecord.nodePath,
+            contractKind: options.kind,
+        },
+        criteria: {
+            explicitNodeIds: [...options.nestedAssets.nodeIds],
+            ...(options.nestedAssets.includeRegex
+                ? { includeRegex: options.nestedAssets.includeRegex }
+                : {}),
+            nodeTypes,
+            formats,
+            scale: options.nestedAssets.scale,
+            ...(options.nestedAssets.maxAssets !== undefined
+                ? { maxAssets: options.nestedAssets.maxAssets }
+                : {}),
+        },
+        candidates,
+        exports: exported,
+        warnings,
+    };
+    const manifestPath = nestedAssetsManifestPath(options.outputDir, options.baseName, options.kind);
+    await writeFile(manifestPath, serializeContractData(manifest, "yaml"), "utf8");
+    return {
+        nestedAssetsDir: path.join(options.outputDir, `${options.baseName}.assets`),
+        nestedAssetsManifestPath: manifestPath,
+        manifest,
+    };
+}
+//# sourceMappingURL=export-nested-assets.js.map

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

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

package/dist/inspect/export/export-node-preview.d.ts

@@ -0,0 +1,24 @@
+import type { NodeContractKind } from "../node-contract/types.js";
+export declare const DEFAULT_PREVIEW_SCALE = 2;
+export type PreviewFormat = "png" | "svg";
+export type ExportPreviewOptions = {
+    format: "png";
+    scale: number;
+} | {
+    format: "svg";
+};
+export interface ExportNodePreviewOptions {
+    token: string;
+    fileKey: string;
+    nodeId: string;
+    baseName: string;
+    kind: "component-set" | NodeContractKind;
+    outputDir: string;
+    preview: ExportPreviewOptions;
+    fetchImpl?: typeof fetch;
+}
+export interface ExportNodePreviewResult {
+    previewPath: string;
+}
+export declare function exportNodePreview(options: ExportNodePreviewOptions): Promise<ExportNodePreviewResult>;
+//# sourceMappingURL=export-node-preview.d.ts.map

package/dist/inspect/export/export-node-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-node-preview.d.ts","sourceRoot":"","sources":["../../../src/inspect/export/export-node-preview.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAMlE,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,CAAC;AAE1C,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,CAAC;AAEtB,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,eAAe,GAAG,gBAAgB,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;CACrB;AAiCD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CA2BlC"}

package/dist/inspect/export/export-node-preview.js

@@ -0,0 +1,34 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { downloadRenderedImage, getFileImageUrls, } from "../../figma-api/get-file-images.js";
+import { assertPositiveScale, normalizeRenderedImageBytes, } from "./rendered-image-bytes.js";
+export const DEFAULT_PREVIEW_SCALE = 2;
+function previewScale(preview) {
+    if (preview.format === "png") {
+        assertPositiveScale(preview.scale, "Preview scale");
+        return preview.scale;
+    }
+    return undefined;
+}
+function resolveNodePreviewPath(directory, baseName, kind, format) {
+    return path.join(directory, `${baseName}.${kind}.preview.${format}`);
+}
+function normalizePreviewBytes(bytes, preview, nodeId) {
+    return normalizeRenderedImageBytes(bytes, preview.format, preview.format === "svg" ? `preview ${nodeId}` : nodeId, "preview");
+}
+export async function exportNodePreview(options) {
+    const imageUrls = await getFileImageUrls({
+        token: options.token,
+        fileKey: options.fileKey,
+        nodeIds: [options.nodeId],
+        format: options.preview.format,
+        scale: previewScale(options.preview),
+        fetchImpl: options.fetchImpl,
+    });
+    const rawBytes = await downloadRenderedImage(imageUrls[options.nodeId], options.fetchImpl);
+    const previewPath = resolveNodePreviewPath(options.outputDir, options.baseName, options.kind, options.preview.format);
+    await mkdir(options.outputDir, { recursive: true });
+    await writeFile(previewPath, normalizePreviewBytes(rawBytes, options.preview, options.nodeId));
+    return { previewPath };
+}
+//# sourceMappingURL=export-node-preview.js.map

package/dist/inspect/export/export-node-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-node-preview.js","sourceRoot":"","sources":["../../../src/inspect/export/export-node-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAuBvC,SAAS,YAAY,CAAC,OAA6B;IACjD,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC7B,mBAAmB,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,KAAK,CAAC;IACvB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,sBAAsB,CAC7B,SAAiB,EACjB,QAAgB,EAChB,IAAwC,EACxC,MAAqB;IAErB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,QAAQ,IAAI,IAAI,YAAY,MAAM,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAiB,EACjB,OAA6B,EAC7B,MAAc;IAEd,OAAO,2BAA2B,CAChC,KAAK,EACL,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,EACvD,SAAS,CACV,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAiC;IAEjC,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC;QACvC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QACzB,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;QAC9B,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAC1C,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EACzB,OAAO,CAAC,SAAS,CAClB,CAAC;IACF,MAAM,WAAW,GAAG,sBAAsB,CACxC,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,OAAO,CAAC,MAAM,CACvB,CAAC;IAEF,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,SAAS,CACb,WAAW,EACX,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CACjE,CAAC;IAEF,OAAO,EAAE,WAAW,EAAE,CAAC;AACzB,CAAC"}

package/dist/inspect/export/export-variant-assets.d.ts

@@ -0,0 +1,18 @@
+import type { AssetContractMap } from "../component-set-pseudocode/assets-contract.js";
+export interface ExportVariantAssetsOptions {
+    token: string;
+    fileKey: string;
+    componentSet: Record<string, unknown>;
+    baseName: string;
+    outputDir: string;
+    format: "svg";
+    skipNodeIds?: ReadonlySet<string>;
+    fetchImpl?: typeof fetch;
+}
+export interface ExportVariantAssetsResult {
+    assetsDir: string;
+    assets: AssetContractMap;
+    assetSlugs: string[];
+}
+export declare function exportVariantAssets(options: ExportVariantAssetsOptions): Promise<ExportVariantAssetsResult>;
+//# sourceMappingURL=export-variant-assets.d.ts.map

package/dist/inspect/export/export-variant-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-variant-assets.d.ts","sourceRoot":"","sources":["../../../src/inspect/export/export-variant-assets.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,gBAAgB,EACjB,MAAM,gDAAgD,CAAC;AAqBxD,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;IACd,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAmGD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAkEpC"}