figma-inspect-cli 0.1.0

package/dist/inspect/schemas.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+declare const figmaComponentSetFieldsSchema: z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+export type FigmaComponentSet = z.infer<typeof figmaComponentSetFieldsSchema> & {
+    id: string;
+};
+declare const componentEntrySchema: z.ZodObject<{
+    key: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    componentSetId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ComponentEntry = z.infer<typeof componentEntrySchema>;
+export interface DocumentNode {
+    id?: string;
+    name?: string;
+    type?: string;
+    componentId?: string;
+    isExposedInstance: boolean;
+    children?: DocumentNode[];
+    [key: string]: unknown;
+}
+declare const fileNodeEntrySchema: z.ZodObject<{
+    document: z.ZodOptional<z.ZodType<DocumentNode, unknown, z.core.$ZodTypeInternals<DocumentNode, unknown>>>;
+    componentSets: z.ZodPipe<z.ZodUnknown, z.ZodTransform<Record<string, FigmaComponentSet>, unknown>>;
+    components: z.ZodPipe<z.ZodUnknown, z.ZodTransform<Record<string, {
+        key?: string | undefined;
+        name?: string | undefined;
+        componentSetId?: string | undefined;
+    }>, unknown>>;
+}, z.core.$strip>;
+export type FileNodeEntry = z.infer<typeof fileNodeEntrySchema>;
+export declare function parseFileNodeEntry(payload: unknown, nodeId: string): FileNodeEntry;
+export declare function parseFileEntry(payload: unknown): FileNodeEntry;
+export {};
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/inspect/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,6BAA6B;;;iBAGjC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CACrC,OAAO,6BAA6B,CACrC,GAAG;IACF,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAaF,QAAA,MAAM,oBAAoB;;;;iBAIxB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAkCD,QAAA,MAAM,mBAAmB;;;;;;;;iBAMvB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GACb,aAAa,CAiBf;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAO9D"}

package/dist/inspect/schemas.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+import { parseValidRecord } from "../zod/parse-valid-entries.js";
+import { FigmaInspectError } from "./errors.js";
+const figmaComponentSetFieldsSchema = z.object({
+    key: z.string(),
+    name: z.string(),
+});
+function parseComponentSets(value) {
+    const entries = parseValidRecord(figmaComponentSetFieldsSchema, value);
+    const componentSets = {};
+    for (const [id, fields] of Object.entries(entries)) {
+        componentSets[id] = { id, ...fields };
+    }
+    return componentSets;
+}
+const componentEntrySchema = z.object({
+    key: z.string().optional(),
+    name: z.string().optional(),
+    componentSetId: z.string().optional(),
+});
+const documentNodeFieldsSchema = z
+    .object({
+    id: z.string().optional(),
+    name: z.string().optional(),
+    type: z.string().optional(),
+    componentId: z.string().optional(),
+    isExposedInstance: z
+        .unknown()
+        .optional()
+        .transform((value) => value === true),
+    children: z.array(z.unknown()).optional(),
+})
+    .passthrough();
+const documentNodeSchema = z.lazy(() => documentNodeFieldsSchema.transform((node) => {
+    const { children, ...rest } = node;
+    const parsed = {
+        ...rest,
+        isExposedInstance: node.isExposedInstance,
+    };
+    if (children) {
+        parsed.children = children
+            .map((child) => documentNodeSchema.safeParse(child))
+            .flatMap((result) => (result.success ? [result.data] : []));
+    }
+    return parsed;
+}));
+const fileNodeEntrySchema = z.object({
+    document: documentNodeSchema.optional(),
+    componentSets: z.unknown().transform(parseComponentSets),
+    components: z
+        .unknown()
+        .transform((value) => parseValidRecord(componentEntrySchema, value)),
+});
+const fileNodesResponseSchema = z.object({
+    nodes: z.record(z.string(), z.unknown()),
+});
+export function parseFileNodeEntry(payload, nodeId) {
+    const response = fileNodesResponseSchema.safeParse(payload);
+    if (!response.success) {
+        throw new FigmaInspectError("Invalid Figma file nodes response.");
+    }
+    const nodeEntry = response.data.nodes[nodeId];
+    if (typeof nodeEntry !== "object" || nodeEntry === null) {
+        throw new FigmaInspectError(`Node ${nodeId} not found in Figma response.`);
+    }
+    const parsed = fileNodeEntrySchema.safeParse(nodeEntry);
+    if (!parsed.success) {
+        throw new FigmaInspectError("Invalid Figma file nodes response.");
+    }
+    return parsed.data;
+}
+export function parseFileEntry(payload) {
+    const parsed = fileNodeEntrySchema.safeParse(payload);
+    if (!parsed.success) {
+        throw new FigmaInspectError("Invalid Figma file response.");
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=schemas.js.map

package/dist/inspect/schemas.js.map

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

package/dist/inspect/team-index.d.ts

@@ -0,0 +1,76 @@
+import type { FigmaTeamProjectFile } from "../figma-api/schemas.js";
+import type { FileNodeEntry } from "./schemas.js";
+export interface BuildTeamIndexFileInput {
+    metadata: FigmaTeamProjectFile;
+    entry: FileNodeEntry;
+}
+export interface BuildTeamIndexOptions {
+    teamId: string;
+    files: readonly BuildTeamIndexFileInput[];
+    screenSimilarityThreshold?: number;
+    screenSizeTolerance?: number;
+}
+interface TeamIndexFileSummary {
+    key: string;
+    name: string;
+    lastModified: string;
+    projectId: string;
+    projectName: string;
+    componentSets: number;
+    components: number;
+    screens: number;
+}
+interface TeamIndexNode {
+    id: string;
+    name: string;
+    lastModified: string;
+    url: string;
+}
+interface TeamIndexScreen {
+    id: string;
+    name: string;
+    size: string;
+    group: string | null;
+    lastModified: string;
+    url: string;
+}
+interface TeamIndexScreenGroup {
+    id: string;
+    screens: TeamIndexScreenGroupScreen[];
+}
+interface TeamIndexScreenGroupScreen {
+    id: string;
+    name: string;
+    size: string;
+    lastModified: string;
+    url: string;
+}
+interface TeamIndexFileRef {
+    key: string;
+    name: string;
+    lastModified: string;
+    projectId: string;
+    projectName: string;
+}
+export interface TeamIndexFile {
+    version: 1;
+    kind: "figma-file-index";
+    file: TeamIndexFileRef;
+    componentSets: TeamIndexNode[];
+    components: TeamIndexNode[];
+    screens: TeamIndexScreen[];
+    screenGroups: TeamIndexScreenGroup[];
+}
+export interface TeamIndex {
+    version: 1;
+    kind: "figma-team-index";
+    team: string;
+    files: TeamIndexFileSummary[];
+}
+export interface TeamIndexBundle {
+    team: TeamIndex;
+    files: TeamIndexFile[];
+}
+export declare function buildTeamIndex(options: BuildTeamIndexOptions): TeamIndexBundle;
+export {};
+//# sourceMappingURL=team-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"team-index.d.ts","sourceRoot":"","sources":["../../src/inspect/team-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAOpE,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,cAAc,CAAC;AAgBhE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC1C,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,UAAU,oBAAoB;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,aAAa;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,oBAAoB;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,0BAA0B,EAAE,CAAC;CACvC;AAED,UAAU,0BAA0B;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,gBAAgB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,gBAAgB,CAAC;IACvB,aAAa,EAAE,aAAa,EAAE,CAAC;IAC/B,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,YAAY,EAAE,oBAAoB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAsdD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,qBAAqB,GAC7B,eAAe,CAsBjB"}

package/dist/inspect/team-index.js

@@ -0,0 +1,361 @@
+import { readNumber, readRecord, readString, } from "./component-set-spec/figma-node.js";
+import { FigmaInspectError } from "./errors.js";
+const DEFAULT_SCREEN_SIMILARITY_THRESHOLD = 0.9;
+const DEFAULT_SCREEN_SIZE_TOLERANCE = 2;
+const SCREEN_SIZE_PRESETS = [
+    [375, 916],
+    [375, 854],
+    [375, 812],
+    [375, 667],
+    [390, 844],
+    [428, 926],
+    [834, 1194],
+    [1194, 834],
+];
+function assertTeamIndexOptions(threshold, sizeTolerance) {
+    if (!Number.isFinite(threshold) || threshold < 0 || threshold > 1) {
+        throw new FigmaInspectError("Screen similarity threshold must be a number between 0 and 1.");
+    }
+    if (!Number.isFinite(sizeTolerance) || sizeTolerance < 0) {
+        throw new FigmaInspectError("Screen size tolerance must be a non-negative number.");
+    }
+}
+function figmaNodeUrl(fileKey, fileName, nodeId) {
+    const url = new URL(`https://www.figma.com/design/${encodeURIComponent(fileKey)}/${encodeURIComponent(fileName)}`);
+    url.searchParams.set("node-id", nodeId.replace(/:/g, "-"));
+    url.searchParams.set("m", "dev");
+    return url.toString();
+}
+function nodeName(node) {
+    return readString(node, "name") ?? "Untitled";
+}
+function nodeType(node) {
+    return readString(node, "type") ?? "UNKNOWN";
+}
+function nodeId(node) {
+    return readString(node, "id");
+}
+function foundNode(file, node) {
+    const id = nodeId(node);
+    if (!id) {
+        return undefined;
+    }
+    return {
+        fileKey: file.key,
+        fileName: file.name,
+        lastModified: file.last_modified,
+        projectId: file.project_id,
+        projectName: file.project_name,
+        nodeId: id,
+        name: nodeName(node),
+        url: figmaNodeUrl(file.key, file.name, id),
+    };
+}
+function screenSize(node) {
+    const box = readRecord(node, "absoluteBoundingBox");
+    if (!box) {
+        return undefined;
+    }
+    const width = readNumber(box, "width");
+    const height = readNumber(box, "height");
+    if (width === undefined || height === undefined) {
+        return undefined;
+    }
+    return `${Math.round(width)}x${Math.round(height)}`;
+}
+function isScreenSize(node, tolerance) {
+    const box = readRecord(node, "absoluteBoundingBox");
+    if (!box) {
+        return undefined;
+    }
+    const width = readNumber(box, "width");
+    const height = readNumber(box, "height");
+    if (width === undefined || height === undefined) {
+        return undefined;
+    }
+    const preset = SCREEN_SIZE_PRESETS.find(([presetWidth, presetHeight]) => Math.abs(presetWidth - width) <= tolerance &&
+        Math.abs(presetHeight - height) <= tolerance);
+    return preset ? screenSize(node) : undefined;
+}
+function instanceIdentity(node, entry) {
+    const componentId = readString(node, "componentId");
+    if (!componentId) {
+        return undefined;
+    }
+    const component = entry.components[componentId];
+    const componentSet = component?.componentSetId
+        ? entry.componentSets[component.componentSetId]
+        : undefined;
+    return (componentSet?.key ??
+        componentSet?.name ??
+        component?.key ??
+        component?.name ??
+        componentId);
+}
+function structureToken(node, entry) {
+    const type = nodeType(node);
+    if (type !== "INSTANCE") {
+        return type;
+    }
+    const identity = instanceIdentity(node, entry);
+    return identity ? `INSTANCE:${identity}` : "INSTANCE";
+}
+function structureTokens(node, entry) {
+    return [
+        structureToken(node, entry),
+        ...(node.children ?? []).flatMap((child) => structureTokens(child, entry)),
+    ];
+}
+function componentTokens(node, entry) {
+    const current = nodeType(node) === "INSTANCE" ? [structureToken(node, entry)] : [];
+    return [
+        ...current,
+        ...(node.children ?? []).flatMap((child) => componentTokens(child, entry)),
+    ];
+}
+function buildDraftFile(input, sizeTolerance) {
+    const { metadata: file, entry } = input;
+    const root = entry.document;
+    if (!root) {
+        throw new FigmaInspectError(`Figma file ${file.key} has no document.`);
+    }
+    const componentSets = [];
+    const components = [];
+    const screens = [];
+    function visit(node, context) {
+        const type = nodeType(node);
+        const base = foundNode(file, node);
+        if (base && type === "COMPONENT_SET") {
+            componentSets.push(base);
+        }
+        if (base &&
+            type === "COMPONENT" &&
+            context.parentComponentSetId === undefined) {
+            components.push(base);
+        }
+        const size = base && type === "FRAME" && !context.insideScreen
+            ? isScreenSize(node, sizeTolerance)
+            : undefined;
+        if (base && size) {
+            screens.push({
+                ...base,
+                size,
+                structureTokens: structureTokens(node, entry),
+                componentTokens: componentTokens(node, entry),
+            });
+        }
+        const childContext = {
+            parentComponentSetId: type === "COMPONENT_SET" && base
+                ? base.nodeId
+                : context.parentComponentSetId,
+            insideScreen: context.insideScreen || size !== undefined,
+        };
+        for (const child of node.children ?? []) {
+            visit(child, childContext);
+        }
+    }
+    for (const page of root.children ?? []) {
+        for (const child of page.children ?? []) {
+            visit(child, { insideScreen: false });
+        }
+    }
+    return {
+        metadata: file,
+        componentSets: sortNodesById(componentSets),
+        components: sortNodesById(components),
+        screens: sortNodesById(screens),
+    };
+}
+function sortNodesById(records) {
+    return [...records].sort((left, right) => left.nodeId.localeCompare(right.nodeId));
+}
+function multisetSimilarity(left, right) {
+    if (left.length === 0 && right.length === 0) {
+        return 1;
+    }
+    const leftCounts = new Map();
+    const rightCounts = new Map();
+    for (const token of left) {
+        leftCounts.set(token, (leftCounts.get(token) ?? 0) + 1);
+    }
+    for (const token of right) {
+        rightCounts.set(token, (rightCounts.get(token) ?? 0) + 1);
+    }
+    const tokens = new Set([...leftCounts.keys(), ...rightCounts.keys()]);
+    let intersection = 0;
+    let union = 0;
+    for (const token of tokens) {
+        const leftCount = leftCounts.get(token) ?? 0;
+        const rightCount = rightCounts.get(token) ?? 0;
+        intersection += Math.min(leftCount, rightCount);
+        union += Math.max(leftCount, rightCount);
+    }
+    return union === 0 ? 1 : intersection / union;
+}
+function sequenceSimilarity(left, right) {
+    if (left.length === 0 && right.length === 0) {
+        return 1;
+    }
+    const maxLength = Math.max(left.length, right.length);
+    let matches = 0;
+    for (let index = 0; index < Math.min(left.length, right.length); index += 1) {
+        if (left[index] === right[index]) {
+            matches += 1;
+        }
+    }
+    return matches / maxLength;
+}
+function countSimilarity(left, right) {
+    if (left === 0 && right === 0) {
+        return 1;
+    }
+    return Math.min(left, right) / Math.max(left, right);
+}
+function screenSimilarity(left, right) {
+    return (multisetSimilarity(left.structureTokens, right.structureTokens) * 0.45 +
+        sequenceSimilarity(left.structureTokens, right.structureTokens) * 0.25 +
+        multisetSimilarity(left.componentTokens, right.componentTokens) * 0.2 +
+        countSimilarity(left.structureTokens.length, right.structureTokens.length) *
+            0.1);
+}
+function screenRef(screen) {
+    return `${screen.fileKey}#${screen.nodeId}`;
+}
+function screenGroupId(screens) {
+    const first = screens[0];
+    if (!first) {
+        throw new FigmaInspectError("Cannot build an empty screen group id.");
+    }
+    const nodeIds = screens.map((screen) => screen.nodeId).sort();
+    return `${first.fileKey}#${nodeIds.join(",")}`;
+}
+function assignFileScreenGroups(file, threshold) {
+    const screens = file.screens;
+    const parent = new Map(screens.map((screen) => [screenRef(screen), screenRef(screen)]));
+    function find(key) {
+        const current = parent.get(key);
+        if (!current || current === key) {
+            return key;
+        }
+        const root = find(current);
+        parent.set(key, root);
+        return root;
+    }
+    function union(left, right) {
+        const leftRoot = find(screenRef(left));
+        const rightRoot = find(screenRef(right));
+        if (leftRoot !== rightRoot) {
+            parent.set(rightRoot, leftRoot);
+        }
+    }
+    for (let leftIndex = 0; leftIndex < screens.length; leftIndex += 1) {
+        for (let rightIndex = leftIndex + 1; rightIndex < screens.length; rightIndex += 1) {
+            const left = screens[leftIndex];
+            const right = screens[rightIndex];
+            if (screenSimilarity(left, right) >= threshold) {
+                union(left, right);
+            }
+        }
+    }
+    const groupsByRoot = new Map();
+    for (const screen of screens) {
+        const root = find(screenRef(screen));
+        const members = groupsByRoot.get(root) ?? [];
+        members.push(screen);
+        groupsByRoot.set(root, members);
+    }
+    const groups = [...groupsByRoot.values()]
+        .filter((members) => members.length > 1)
+        .map((members) => sortNodesById(members))
+        .sort((left, right) => screenGroupId(left).localeCompare(screenGroupId(right)));
+    return groups.map((members) => {
+        const id = screenGroupId(members);
+        for (const member of members) {
+            member.groupId = id;
+        }
+        return {
+            id,
+            screens: members.map(screenGroupScreen),
+        };
+    });
+}
+function indexNode(node) {
+    return {
+        id: node.nodeId,
+        name: node.name,
+        lastModified: node.lastModified,
+        url: node.url,
+    };
+}
+function indexScreen(screen) {
+    return {
+        id: screen.nodeId,
+        name: screen.name,
+        size: screen.size,
+        group: screen.groupId ?? null,
+        lastModified: screen.lastModified,
+        url: screen.url,
+    };
+}
+function screenGroupScreen(screen) {
+    return {
+        id: screen.nodeId,
+        name: screen.name,
+        size: screen.size,
+        lastModified: screen.lastModified,
+        url: screen.url,
+    };
+}
+function teamFileSummary(file) {
+    return {
+        key: file.metadata.key,
+        name: file.metadata.name,
+        lastModified: file.metadata.last_modified,
+        projectId: file.metadata.project_id,
+        projectName: file.metadata.project_name,
+        componentSets: file.componentSets.length,
+        components: file.components.length,
+        screens: file.screens.length,
+    };
+}
+function fileRef(file) {
+    return {
+        key: file.metadata.key,
+        name: file.metadata.name,
+        lastModified: file.metadata.last_modified,
+        projectId: file.metadata.project_id,
+        projectName: file.metadata.project_name,
+    };
+}
+function fileIndex(file, threshold) {
+    const groups = assignFileScreenGroups(file, threshold);
+    return {
+        version: 1,
+        kind: "figma-file-index",
+        file: fileRef(file),
+        componentSets: file.componentSets.map(indexNode),
+        components: file.components.map(indexNode),
+        screens: file.screens.map(indexScreen),
+        screenGroups: groups,
+    };
+}
+export function buildTeamIndex(options) {
+    const threshold = options.screenSimilarityThreshold ?? DEFAULT_SCREEN_SIMILARITY_THRESHOLD;
+    const sizeTolerance = options.screenSizeTolerance ?? DEFAULT_SCREEN_SIZE_TOLERANCE;
+    assertTeamIndexOptions(threshold, sizeTolerance);
+    const draftFiles = [...options.files]
+        .sort((left, right) => {
+        return left.metadata.key.localeCompare(right.metadata.key);
+    })
+        .map((file) => buildDraftFile(file, sizeTolerance));
+    return {
+        team: {
+            version: 1,
+            kind: "figma-team-index",
+            team: options.teamId,
+            files: draftFiles.map(teamFileSummary),
+        },
+        files: draftFiles.map((file) => fileIndex(file, threshold)),
+    };
+}
+//# sourceMappingURL=team-index.js.map

package/dist/inspect/team-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-index.js","sourceRoot":"","sources":["../../src/inspect/team-index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,mCAAmC,GAAG,GAAG,CAAC;AAChD,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAExC,MAAM,mBAAmB,GAAG;IAC1B,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,IAAI,CAAC;IACX,CAAC,IAAI,EAAE,GAAG,CAAC;CACH,CAAC;AAkHX,SAAS,sBAAsB,CAC7B,SAAiB,EACjB,aAAqB;IAErB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,iBAAiB,CACzB,+DAA+D,CAChE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,iBAAiB,CACzB,sDAAsD,CACvD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CACnB,OAAe,EACf,QAAgB,EAChB,MAAc;IAEd,MAAM,GAAG,GAAG,IAAI,GAAG,CACjB,gCAAgC,kBAAkB,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAC9F,CAAC;IACF,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3D,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACjC,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAkB;IAClC,OAAO,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,UAAU,CAAC;AAChD,CAAC;AAED,SAAS,QAAQ,CAAC,IAAkB;IAClC,OAAO,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,SAAS,CAAC;AAC/C,CAAC;AAED,SAAS,MAAM,CAAC,IAAkB;IAChC,OAAO,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,SAAS,CAChB,IAA0B,EAC1B,IAAkB;IAElB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,GAAG;QACjB,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,YAAY,EAAE,IAAI,CAAC,aAAa;QAChC,SAAS,EAAE,IAAI,CAAC,UAAU;QAC1B,WAAW,EAAE,IAAI,CAAC,YAAY;QAC9B,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;QACpB,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAAkB;IACpC,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IACpD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACzC,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,YAAY,CACnB,IAAkB,EAClB,SAAiB;IAEjB,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IACpD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACzC,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CACrC,CAAC,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,EAAE,CAC9B,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,IAAI,SAAS;QAC1C,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,MAAM,CAAC,IAAI,SAAS,CAC/C,CAAC;IAEF,OAAO,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC;AAED,SAAS,gBAAgB,CACvB,IAAkB,EAClB,KAAoB;IAEpB,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACpD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,SAAS,EAAE,cAAc;QAC5C,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,cAAc,CAAC;QAC/C,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO,CACL,YAAY,EAAE,GAAG;QACjB,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,IAAI;QACf,WAAW,CACZ,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,IAAkB,EAAE,KAAoB;IAC9D,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,QAAQ,CAAC,CAAC,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;AACxD,CAAC;AAED,SAAS,eAAe,CAAC,IAAkB,EAAE,KAAoB;IAC/D,OAAO;QACL,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IAAkB,EAAE,KAAoB;IAC/D,MAAM,OAAO,GACX,QAAQ,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,OAAO;QACL,GAAG,OAAO;QACV,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,KAA8B,EAC9B,aAAqB;IAErB,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,iBAAiB,CAAC,cAAc,IAAI,CAAC,GAAG,mBAAmB,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,aAAa,GAAgB,EAAE,CAAC;IACtC,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,SAAS,KAAK,CAAC,IAAkB,EAAE,OAAyB;QAC1D,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAEnC,IAAI,IAAI,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;YACrC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAED,IACE,IAAI;YACJ,IAAI,KAAK,WAAW;YACpB,OAAO,CAAC,oBAAoB,KAAK,SAAS,EAC1C,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QAED,MAAM,IAAI,GACR,IAAI,IAAI,IAAI,KAAK,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY;YAC/C,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC;YACnC,CAAC,CAAC,SAAS,CAAC;QAChB,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC;gBACX,GAAG,IAAI;gBACP,IAAI;gBACJ,eAAe,EAAE,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC;gBAC7C,eAAe,EAAE,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC;aAC9C,CAAC,CAAC;QACL,CAAC;QAED,MAAM,YAAY,GAAqB;YACrC,oBAAoB,EAClB,IAAI,KAAK,eAAe,IAAI,IAAI;gBAC9B,CAAC,CAAC,IAAI,CAAC,MAAM;gBACb,CAAC,CAAC,OAAO,CAAC,oBAAoB;YAClC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI,KAAK,SAAS;SACzD,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YACxC,KAAK,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YACxC,KAAK,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,aAAa,EAAE,aAAa,CAAC,aAAa,CAAC;QAC3C,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC;QACrC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAsB,OAAY;IACtD,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACvC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CACxC,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAuB,EAAE,KAAwB;IAC3E,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACtE,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,YAAY,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAChD,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC;AAChD,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAuB,EAAE,KAAwB;IAC3E,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5E,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,OAAO,GAAG,SAAS,CAAC;AAC7B,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,KAAa;IAClD,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAiB,EAAE,KAAkB;IAC7D,OAAO,CACL,kBAAkB,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,IAAI;QACtE,kBAAkB,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,IAAI;QACtE,kBAAkB,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,GAAG;QACrE,eAAe,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC;YACxE,GAAG,CACN,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,MAA+C;IAChE,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,aAAa,CAAC,OAA+B;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,iBAAiB,CAAC,wCAAwC,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,SAAS,sBAAsB,CAC7B,IAAe,EACf,SAAiB;IAEjB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAChE,CAAC;IAEF,SAAS,IAAI,CAAC,GAAW;QACvB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YAChC,OAAO,GAAG,CAAC;QACb,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,KAAK,CAAC,IAAiB,EAAE,KAAkB;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC;QACnE,KACE,IAAI,UAAU,GAAG,SAAS,GAAG,CAAC,EAC9B,UAAU,GAAG,OAAO,CAAC,MAAM,EAC3B,UAAU,IAAI,CAAC,EACf,CAAC;YACD,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;YAChC,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;YAClC,IAAI,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC/C,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,GAAG,EAAyB,CAAC;IACtD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;SACtC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;SACvC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;SACxC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACpB,aAAa,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CACxD,CAAC;IAEJ,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC5B,MAAM,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QAClC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC;QACtB,CAAC;QAED,OAAO;YACL,EAAE;YACF,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;SACxC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,IAAe;IAChC,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,MAAM;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,MAAmB;IACtC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,MAAM;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;QAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,GAAG,EAAE,MAAM,CAAC,GAAG;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAmB;IAC5C,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,MAAM;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,GAAG,EAAE,MAAM,CAAC,GAAG;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IAAe;IACtC,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG;QACtB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;QACxB,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa;QACzC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU;QACnC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY;QACvC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM;QACxC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM;QAClC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,IAAe;IAC9B,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG;QACtB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;QACxB,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa;QACzC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU;QACnC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY;KACxC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAe,EAAE,SAAiB;IACnD,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACvD,OAAO;QACL,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC;QACnB,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC;QAChD,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC;QAC1C,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QACtC,YAAY,EAAE,MAAM;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAA8B;IAE9B,MAAM,SAAS,GACb,OAAO,CAAC,yBAAyB,IAAI,mCAAmC,CAAC;IAC3E,MAAM,aAAa,GACjB,OAAO,CAAC,mBAAmB,IAAI,6BAA6B,CAAC;IAC/D,sBAAsB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAEjD,MAAM,UAAU,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;SAClC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7D,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;IAEtD,OAAO;QACL,IAAI,EAAE;YACJ,OAAO,EAAE,CAAC;YACV,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,OAAO,CAAC,MAAM;YACpB,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,eAAe,CAAC;SACvC;QACD,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;KAC5D,CAAC;AACJ,CAAC"}

package/dist/inspect/types.d.ts

@@ -0,0 +1,46 @@
+import type { FigmaComponentSet } from "./schemas.js";
+export interface FigmaNodeRef {
+    fileKey: string;
+    nodeId: string;
+}
+export type FigmaTeamComponentSet = FigmaComponentSet & {
+    fileKey: string;
+    fileName: string;
+    projectId: string;
+    projectName: string;
+};
+export interface ListAllComponentSetsOptions {
+    token: string;
+    teamId: string;
+    fetchImpl?: typeof fetch;
+}
+export interface FigmaComponentSetProperty {
+    id: string;
+    name: string;
+    isExposedInstance: boolean;
+}
+export type ComponentSetLookup = {
+    kind: "key";
+    value: string;
+} | {
+    kind: "name";
+    value: string;
+};
+export type ComponentSetTarget = ComponentSetLookup | ({
+    kind: "node";
+} & FigmaNodeRef);
+export type ExportContractTarget = ({
+    kind: "component-set";
+} & FigmaNodeRef) | ({
+    kind: "node";
+} & FigmaNodeRef);
+export interface ComponentSetScopeOptions extends FigmaNodeRef {
+    token: string;
+    componentSet: ComponentSetLookup;
+    fetchImpl?: typeof fetch;
+}
+export interface ComponentSetNodeRefOptions extends FigmaNodeRef {
+    token: string;
+    fetchImpl?: typeof fetch;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/inspect/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,MAAM,MAAM,kBAAkB,GAC1B,kBAAkB,GAClB,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAAC,CAAC;AAEtC,MAAM,MAAM,oBAAoB,GAC5B,CAAC;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GAAG,YAAY,CAAC,GAC1C,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAAC,CAAC;AAEtC,MAAM,WAAW,wBAAyB,SAAQ,YAAY;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,kBAAkB,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA2B,SAAQ,YAAY;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B"}

package/dist/inspect/types.js

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

package/dist/inspect/types.js.map

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

package/dist/test/fixtures.d.ts

@@ -0,0 +1,3 @@
+export declare const contractFixturesDir: string;
+export declare const variablesFixturePath: string;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/test/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/test/fixtures.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,mBAAmB,QAG/B,CAAC;AAEF,eAAO,MAAM,oBAAoB,QAGhC,CAAC"}

package/dist/test/fixtures.js

@@ -0,0 +1,6 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const repoRoot = path.join(path.dirname(fileURLToPath(import.meta.url)), "../..");
+export const contractFixturesDir = path.join(repoRoot, "test/fixtures/contracts");
+export const variablesFixturePath = path.join(repoRoot, "test/fixtures/variables-minimal.json");
+//# sourceMappingURL=fixtures.js.map