figma-json-tree 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,1138 @@
+#!/usr/bin/env node
+import { parseArgs as e } from "node:util";
+import { readFile as t, writeFile as n } from "node:fs/promises";
+//#region src/figma-json-fetch/endpoints.ts
+var r = "https://api.figma.com/v1";
+function i(e) {
+	if (!/^[a-zA-Z0-9_-]+$/.test(e)) throw TypeError("Expected a non-empty Figma file key");
+	return new URL(`${r}/files/${encodeURIComponent(e)}`);
+}
+function a(e, t) {
+	if (!t.length || t.some((e) => !/^I?\d+:\d+(?:;I?\d+:\d+)*$/.test(e))) throw TypeError("Expected API node IDs such as 49:7390 or I49:7403;38:5243");
+	let n = i(e);
+	return n.pathname += "/nodes", n.searchParams.set("ids", [...new Set(t)].join(",")), n;
+}
+//#endregion
+//#region src/figma-json-fetch/errors.ts
+var o = class extends Error {
+	status;
+	retryAfter;
+	name = "FigmaHTTPError";
+	constructor(e, t) {
+		super(`Figma API request failed (HTTP ${e})${t ? `; Retry-After: ${t}` : ""}`), this.status = e, this.retryAfter = t;
+	}
+};
+//#endregion
+//#region src/figma-json-fetch/request.ts
+async function s(e, t, n, r) {
+	let i = await e(t, {
+		headers: {
+			"X-Figma-Token": n,
+			Accept: "application/json"
+		},
+		signal: r.signal,
+		redirect: "error"
+	});
+	if (!i.ok) throw new o(i.status, i.headers.get("retry-after"));
+	return await i.json();
+}
+//#endregion
+//#region src/figma-json-fetch/client.ts
+var c = class {
+	#e;
+	#t;
+	constructor(e) {
+		if (typeof e.token != "string" || !e.token.trim()) throw TypeError("A Figma token is required");
+		this.#e = e.token, this.#t = e.fetch ?? globalThis.fetch.bind(globalThis);
+	}
+	getFile(e, t = {}) {
+		return s(this.#t, i(e), this.#e, t);
+	}
+	getNodes(e, t, n = {}) {
+		return s(this.#t, a(e, t), this.#e, n);
+	}
+}, l = "Usage:\n  figma-json-tree download --file FILE_KEY [--nodes 49:7390,49:7391] [--out file.json] [--force]\n  figma-json-tree query --input file.json --selector 'FRAME[name=\"Hover Card\"]' [--out node.json] [--force]\n  figma-json-tree queryAll --input file.json --selector '[name=\"Hover Card\"]' [--out nodes.json] [--force]\n  figma-json-tree queryAll --input file.json --name-regex '^ToBe' [--regex-flags i]\n  figma-json-tree export --input file.json --selector 'FRAME[name=\"Hover Card\"]' --format html [--styles inline|tailwind] [--out page.html] [--force]\n  figma-json-tree export --input design.ir.json --format html [--styles tailwind]\n\nUse either --selector or --name-regex. --regex-flags applies only to --name-regex.\nquery returns the first original subtree or null; queryAll returns an array (possibly empty).\nInputs: parsed file/node API responses or a single subtree saved as JSON.\nAuthentication: FIGMA_TOKEN is required only for download. Queries and exports read local files.\nexport accepts original Figma JSON, standard IR or Tailwind IR and exports one root.\nFor export, --format defaults to html. Styles default to inline (Tailwind for Tailwind IR).\nexport returns body contents only: no doctype, html, head, body, style or script tags.\nTailwind exports contain classes and residual inline styles; the host project builds the CSS.\nWithout --out, JSON or exported HTML is written to stdout. Existing files require --force.\n", u = {
+	out: { type: "string" },
+	force: {
+		type: "boolean",
+		default: !1
+	},
+	help: {
+		type: "boolean",
+		short: "h"
+	}
+};
+function d(e) {
+	if (e !== void 0 && !e.trim()) throw Error("--out must be a non-empty path");
+}
+function ee(t) {
+	let { values: n } = e({
+		args: t,
+		strict: !0,
+		options: {
+			...u,
+			file: { type: "string" },
+			nodes: { type: "string" }
+		}
+	});
+	if (n.help) return "help";
+	if (!n.file) throw Error("--file FILE_KEY is required");
+	if (n.nodes !== void 0 && !n.nodes.trim()) throw Error("--nodes must contain at least one node ID");
+	return d(n.out), {
+		command: "download",
+		fileKey: n.file,
+		nodeIds: n.nodes?.split(",").map((e) => e.trim()),
+		out: n.out,
+		force: n.force
+	};
+}
+function te(e, t, n) {
+	if (e !== void 0 == (t !== void 0)) throw Error("Provide exactly one of --selector or --name-regex");
+	if (e !== void 0) {
+		if (n !== void 0) throw Error("--regex-flags requires --name-regex");
+		if (!e.trim()) throw Error("--selector must be non-empty");
+		return e;
+	}
+	return { name: new RegExp(t, n) };
+}
+function f(t, n) {
+	let { values: r } = e({
+		args: n,
+		strict: !0,
+		options: {
+			...u,
+			input: { type: "string" },
+			selector: { type: "string" },
+			"name-regex": { type: "string" },
+			"regex-flags": { type: "string" }
+		}
+	});
+	if (r.help) return "help";
+	if (!r.input?.trim()) throw Error("--input must specify a local JSON file");
+	return d(r.out), {
+		command: t,
+		input: r.input,
+		selector: te(r.selector, r["name-regex"], r["regex-flags"]),
+		out: r.out,
+		force: r.force
+	};
+}
+function ne(t) {
+	let { values: n } = e({
+		args: t,
+		strict: !0,
+		options: {
+			...u,
+			input: { type: "string" },
+			selector: { type: "string" },
+			format: {
+				type: "string",
+				default: "html"
+			},
+			styles: { type: "string" }
+		}
+	});
+	if (n.help) return "help";
+	if (!n.input?.trim()) throw Error("--input must specify a local JSON file");
+	if (n.format !== "html") throw Error("--format currently supports only html");
+	if (n.styles !== void 0 && n.styles !== "inline" && n.styles !== "tailwind") throw Error("--styles must be inline or tailwind");
+	if (n.selector !== void 0 && !n.selector.trim()) throw Error("--selector must be non-empty");
+	return d(n.out), {
+		command: "export",
+		input: n.input,
+		selector: n.selector,
+		styles: n.styles,
+		out: n.out,
+		force: n.force
+	};
+}
+function re(e) {
+	let [t, ...n] = e;
+	if (e.length === 1 && (t === "--help" || t === "-h")) return "help";
+	if (t === "download") return ee(n);
+	if (t === "query" || t === "queryAll") return f(t, n);
+	if (t === "export") return ne(n);
+	throw Error("Expected download, query, queryAll or export; use --help");
+}
+//#endregion
+//#region src/cli/output.ts
+async function p(e, t, n, r) {
+	await m(`${JSON.stringify(e, null, 2)}\n`, t, n, r);
+}
+async function m(e, t, r, i) {
+	t ? await n(t, e, { flag: r ? "w" : "wx" }) : i(e);
+}
+function ie(e, t) {
+	let n = e instanceof Error ? e.message : "Unknown error";
+	return t ? n.split(t).join("[redacted]") : n;
+}
+//#endregion
+//#region src/cli/commands/download.ts
+async function ae(e, t, n) {
+	await p(e.nodeIds ? await t.getNodes(e.fileKey, e.nodeIds) : await t.getFile(e.fileKey), e.out, e.force, n);
+}
+//#endregion
+//#region src/figma-html/classes.ts
+function oe(e) {
+	return e.replace(/\[((?:[a-z-]+:)?)([+-]?(?:\d+\.\d+|\.\d+))([a-z%]*)\]/gi, (e, t, n, r) => `[${t}${Number(Number(n).toFixed(2))}${r}]`);
+}
+//#endregion
+//#region src/figma-html/escape.ts
+var h = {
+	"&": "&",
+	"<": "&lt;",
+	">": "&gt;",
+	"\"": "&quot;",
+	"'": "&#39;"
+};
+function g(e) {
+	return e.replace(/[&<>"']/g, (e) => h[e]);
+}
+//#endregion
+//#region src/figma-html/attributes.ts
+function _(e) {
+	if (e.startsWith("--")) return e;
+	let t = e.replace(/[A-Z]/g, (e) => `-${e.toLowerCase()}`);
+	return t.startsWith("ms-") ? `-${t}` : t;
+}
+function v(e) {
+	return Object.entries(e).map(([e, t]) => `${_(e)}:${t}`).join(";");
+}
+function y(e, t) {
+	let n = [
+		["data-figma-id", e.source.id],
+		["data-figma-name", e.source.name],
+		["data-figma-type", e.source.type]
+	];
+	t && "className" in e && e.className && n.push(["class", oe(e.className)]);
+	let r = v(e.visible ? e.style : {
+		...e.style,
+		display: "none"
+	});
+	r && n.push(["style", r]);
+	let i = n.map(([e, t]) => ` ${e}="${g(t)}"`).join("");
+	return e.visible ? i : `${i} hidden`;
+}
+//#endregion
+//#region src/figma-html/validate.ts
+function b(e) {
+	return typeof e == "object" && !!e && !Array.isArray(e);
+}
+function se(e, t) {
+	if (!b(e) || !b(e.source) || typeof e.source.id != "string" || typeof e.source.name != "string" || typeof e.source.type != "string" || typeof e.visible != "boolean" || !b(e.style) || !Array.isArray(e.children)) throw TypeError("Expected an IR node with source, visible, style and children");
+	if (e.text !== void 0 && (!b(e.text) || typeof e.text.characters != "string")) throw TypeError(`Invalid text in IR node ${e.source.id}`);
+	if (t && typeof e.className != "string") throw TypeError(`Missing className in Tailwind node ${e.source.id}`);
+	for (let [t, n] of Object.entries(e.style)) {
+		if (!/^(?:--[\w-]+|[a-zA-Z][a-zA-Z0-9-]*)$/.test(t)) throw TypeError(`Invalid CSS property in IR node ${e.source.id}`);
+		if (typeof n != "string" && (typeof n != "number" || !Number.isFinite(n))) throw TypeError(`Invalid CSS value in IR node ${e.source.id}`);
+	}
+}
+function x(e) {
+	if (!b(e) || e.schemaVersion !== 1 || !Array.isArray(e.diagnostics) || e.target !== void 0 && e.target !== "tailwind-v4") throw TypeError("Expected a standard IR document or Tailwind v4 IR (schemaVersion 1)");
+	let t = e.target === "tailwind-v4", n = [e.root], r = /* @__PURE__ */ new Set();
+	for (; n.length;) {
+		let e = n.pop();
+		if (r.has(e)) throw TypeError("IR children must be an acyclic tree");
+		r.add(e), se(e, t);
+		for (let t of e.children) n.push(t);
+	}
+}
+//#endregion
+//#region src/figma-html/renderer.ts
+function ce(e) {
+	x(e);
+	let t = "target" in e && e.target === "tailwind-v4", n = [], r = [e.root];
+	for (; r.length;) {
+		let e = r.pop();
+		if (typeof e == "string") {
+			n.push(e);
+			continue;
+		}
+		n.push(`<div${y(e, t)}>`), e.text && n.push(g(e.text.characters)), r.push("</div>");
+		for (let t = e.children.length - 1; t >= 0; t--) r.push(e.children[t]);
+	}
+	return n.join("");
+}
+//#endregion
+//#region src/figma-tree/model/value.ts
+function S(e) {
+	return typeof e == "object" && !!e && !Array.isArray(e);
+}
+function C(e) {
+	let t = [e], n = /* @__PURE__ */ new WeakSet();
+	for (; t.length;) {
+		let e = t.pop();
+		if (typeof e == "object" && e && !n.has(e)) {
+			n.add(e);
+			for (let n of Object.values(e)) t.push(n);
+			Object.freeze(e);
+		}
+	}
+	return e;
+}
+function w(e) {
+	return typeof e == "number" && Number.isFinite(e) ? e : void 0;
+}
+//#endregion
+//#region src/figma-tree/input/normalize.ts
+var T = class extends Error {
+	name = "FigmaInputError";
+};
+function E(e, t) {
+	if (S(t)) for (let [n, r] of Object.entries(t)) S(r) && e.set(n, r);
+}
+function le(e) {
+	let t = [...e], n = /* @__PURE__ */ new WeakSet();
+	for (; t.length;) {
+		let e = t.pop();
+		if (!S(e) || typeof e.id != "string" || typeof e.name != "string" || typeof e.type != "string") throw new T("Each node must contain string id, name and type fields");
+		if (n.has(e)) throw new T("Input must be a JSON tree without cyclic or shared node objects");
+		if (n.add(e), e.children !== void 0) {
+			if (!Array.isArray(e.children)) throw new T(`Invalid children for node ${e.id}`);
+			for (let n of e.children) t.push(n);
+		}
+	}
+}
+function D(e) {
+	if (!S(e)) throw new T("Expected a parsed Figma response or node object");
+	let t = /* @__PURE__ */ new Map(), n = [], r = [];
+	if (E(t, e.components), typeof e.type == "string") r.push(e);
+	else if (S(e.document)) r.push(e.document);
+	else if (S(e.nodes)) for (let [i, a] of Object.entries(e.nodes)) if (a === null) n.push({
+		code: "missing-node",
+		nodeId: i,
+		message: "Figma returned null for this node"
+	});
+	else if (S(a) && S(a.document)) r.push(a.document), E(t, a.components);
+	else throw new T(`Invalid node response entry: ${i}`);
+	else throw new T("Expected document, nodes, or a single node");
+	le(r);
+	try {
+		let e = structuredClone({
+			roots: r,
+			components: t,
+			diagnostics: n
+		});
+		C(e.roots);
+		for (let t of e.components.values()) C(t);
+		return e;
+	} catch (e) {
+		throw new T(`Input must be structured-cloneable JSON: ${e instanceof Error ? e.message : "invalid value"}`);
+	}
+}
+//#endregion
+//#region src/figma-tree/tailwind/style.ts
+var O = {
+	display: {
+		flex: "flex",
+		none: "hidden"
+	},
+	position: {
+		relative: "relative",
+		absolute: "absolute"
+	},
+	boxSizing: { "border-box": "box-border" },
+	flexDirection: {
+		row: "flex-row",
+		column: "flex-col"
+	},
+	flexWrap: { wrap: "flex-wrap" },
+	justifyContent: {
+		"flex-start": "justify-start",
+		"flex-end": "justify-end",
+		center: "justify-center",
+		"space-between": "justify-between"
+	},
+	alignItems: {
+		"flex-start": "items-start",
+		"flex-end": "items-end",
+		center: "items-center",
+		baseline: "items-baseline"
+	},
+	alignContent: { "space-between": "content-between" },
+	alignSelf: { stretch: "self-stretch" },
+	overflow: { hidden: "overflow-hidden" },
+	borderStyle: { solid: "border-solid" },
+	textAlign: {
+		left: "text-left",
+		right: "text-right",
+		center: "text-center",
+		justify: "text-justify"
+	},
+	fontStyle: { italic: "italic" },
+	textDecorationLine: {
+		underline: "underline",
+		"line-through": "line-through"
+	},
+	textTransform: {
+		uppercase: "uppercase",
+		lowercase: "lowercase",
+		capitalize: "capitalize"
+	},
+	whiteSpace: { "pre-wrap": "whitespace-pre-wrap" },
+	flexGrow: { 1: "grow" },
+	flexShrink: { 0: "shrink-0" },
+	width: {
+		"100%": "w-full",
+		"fit-content": "w-fit"
+	},
+	height: {
+		"100%": "h-full",
+		"fit-content": "h-fit"
+	}
+}, k = {
+	width: "w",
+	height: "h",
+	minWidth: "min-w",
+	maxWidth: "max-w",
+	minHeight: "min-h",
+	maxHeight: "max-h",
+	left: "left",
+	top: "top",
+	gap: "gap",
+	rowGap: "gap-y",
+	columnGap: "gap-x",
+	paddingTop: "pt",
+	paddingRight: "pr",
+	paddingBottom: "pb",
+	paddingLeft: "pl",
+	borderRadius: "rounded",
+	borderTopLeftRadius: "rounded-tl",
+	borderTopRightRadius: "rounded-tr",
+	borderBottomLeftRadius: "rounded-bl",
+	borderBottomRightRadius: "rounded-br",
+	borderWidth: "border",
+	borderTopWidth: "border-t",
+	borderRightWidth: "border-r",
+	borderBottomWidth: "border-b",
+	borderLeftWidth: "border-l",
+	backgroundColor: "bg",
+	color: "text",
+	borderColor: "border",
+	fontSize: "text",
+	fontWeight: "font",
+	lineHeight: "leading",
+	letterSpacing: "tracking",
+	opacity: "opacity",
+	flexBasis: "basis"
+};
+function A(e, t) {
+	let n = k[e], r = String(t);
+	if (n && !/[\s[\]_'"\\;]/.test(r)) return `${n}-[${e === "fontSize" ? "length:" : e === "fontWeight" ? "number:" : ""}${r}]`;
+}
+function j(e) {
+	let t = [], n = {};
+	for (let [r, i] of Object.entries(e)) {
+		let e = O[r]?.[String(i)] ?? A(r, i);
+		e ? t.push(e) : n[r] = i;
+	}
+	return {
+		className: [...new Set(t)].join(" "),
+		style: n
+	};
+}
+//#endregion
+//#region src/figma-tree/tailwind/convert.ts
+function M(e) {
+	let t = structuredClone(e), n = [], r = [t.root];
+	for (; r.length;) {
+		let e = r.pop();
+		n.push(e);
+		for (let t of e.children) r.push(t);
+	}
+	let i = /* @__PURE__ */ new Map();
+	for (let e of n.reverse()) i.set(e, {
+		...e,
+		...j(e.style),
+		children: e.children.map((e) => i.get(e))
+	});
+	return {
+		schemaVersion: 1,
+		target: "tailwind-v4",
+		root: i.get(t.root),
+		diagnostics: t.diagnostics
+	};
+}
+//#endregion
+//#region src/figma-tree/ir/model/document.ts
+var N = class {
+	#e;
+	constructor(e) {
+		this.#e = C(structuredClone(e));
+	}
+	get schemaVersion() {
+		return 1;
+	}
+	get root() {
+		return this.#e.root;
+	}
+	get diagnostics() {
+		return this.#e.diagnostics;
+	}
+	toJSON() {
+		return structuredClone(this.#e);
+	}
+	toTailwind() {
+		return M(this.#e);
+	}
+}, P = class extends Error {
+	pluginName;
+	nodeId;
+	name = "IRPluginError";
+	constructor(e, t, n) {
+		super(`IR plugin "${e}" failed for node ${t}`, { cause: n }), this.pluginName = e, this.nodeId = t;
+	}
+};
+function F(e) {
+	if (!S(e) || !S(e.source) || typeof e.source.id != "string" || typeof e.source.name != "string" || typeof e.source.type != "string" || ![
+		"container",
+		"text",
+		"shape",
+		"instance",
+		"unknown"
+	].includes(String(e.kind)) || typeof e.visible != "boolean" || !Array.isArray(e.children) || !S(e.layout) || ![
+		"none",
+		"horizontal",
+		"vertical"
+	].includes(String(e.layout.mode)) || typeof e.layout.wrap != "boolean" || !S(e.size) || ![
+		"FIXED",
+		"HUG",
+		"FILL"
+	].includes(String(e.size.widthMode)) || ![
+		"FIXED",
+		"HUG",
+		"FILL"
+	].includes(String(e.size.heightMode)) || !S(e.style) || !S(e.extensions)) throw TypeError("Plugin must return a standard IRNode");
+	for (let t of Object.values(e.style)) if (typeof t != "string" && (typeof t != "number" || !Number.isFinite(t))) throw TypeError("Invalid IR style value");
+	for (let t of ["width", "height"]) {
+		let n = e.size[t];
+		if (n !== void 0 && (typeof n != "number" || !Number.isFinite(n))) throw TypeError("Invalid IR size");
+	}
+	if (e.text !== void 0 && (!S(e.text) || typeof e.text.characters != "string")) throw TypeError("Invalid IR text");
+}
+function I(e, t = /* @__PURE__ */ new Set()) {
+	if (e !== null && typeof e != "string" && typeof e != "boolean" && !(typeof e == "number" && Number.isFinite(e))) {
+		if (typeof e != "object" || !Array.isArray(e) && Object.getPrototypeOf(e) !== Object.prototype && Object.getPrototypeOf(e) !== null) throw TypeError("Extensions must contain JSON values");
+		if (t.has(e)) throw TypeError("Cyclic extension value");
+		t.add(e);
+		for (let n of Object.values(e)) I(n, t);
+		t.delete(e);
+	}
+}
+function L(e) {
+	let t = [e], n = /* @__PURE__ */ new Set();
+	for (; t.length;) {
+		let e = t.pop();
+		if (n.has(e)) throw TypeError("IR children must form a tree");
+		n.add(e), F(e), I(e.extensions);
+		for (let n of e.children) t.push(n);
+	}
+}
+function R(e, t, n) {
+	let r = Object.freeze({
+		source: t.source,
+		parent: t.parent?.source,
+		component: t.component
+	});
+	return n.reduce((e, n) => {
+		try {
+			let t = n.transform(C(e), r);
+			return L(t), structuredClone(t);
+		} catch (e) {
+			throw new P(n.name, t.source.id, e);
+		}
+	}, e);
+}
+//#endregion
+//#region src/figma-tree/selector/types.ts
+var z = [
+	"id",
+	"name",
+	"type",
+	"visible",
+	"componentName"
+], B = class extends Error {
+	name = "SelectorSyntaxError";
+};
+//#endregion
+//#region src/figma-tree/tree/records.ts
+function* V(e) {
+	let t = [...e].reverse();
+	for (; t.length;) {
+		let e = t.pop();
+		yield e;
+		for (let n = e.children.length - 1; n >= 0; n--) t.push(e.children[n]);
+	}
+}
+function H(e) {
+	let t = /* @__PURE__ */ new Map(), n = [...e];
+	for (; n.length;) {
+		let e = n.pop();
+		e.type === "COMPONENT" && t.set(e.id, e.name);
+		for (let t of e.children ?? []) n.push(t);
+	}
+	return t;
+}
+function U(e) {
+	let t = H(e.roots), n = [], r = e.roots.map((e) => ({
+		source: e,
+		parent: void 0
+	})).reverse();
+	for (; r.length;) {
+		let { source: i, parent: a } = r.pop(), o = typeof i.componentId == "string" ? i.componentId : void 0, s = o ? e.components.get(o) : void 0, c = {
+			source: i,
+			parent: a,
+			children: [],
+			componentName: s?.name ?? (o ? t.get(o) : void 0),
+			component: s
+		};
+		a ? a.children.push(c) : n.push(c);
+		let l = i.children ?? [];
+		for (let e = l.length - 1; e >= 0; e--) r.push({
+			source: l[e],
+			parent: c
+		});
+	}
+	return n;
+}
+//#endregion
+//#region src/figma-tree/ir/converters/style.ts
+function W(e) {
+	return Math.round(Math.max(0, Math.min(1, w(e) ?? 0)) * 255);
+}
+function G(e) {
+	if (!S(e) || e.type !== "SOLID" || !S(e.color)) return;
+	let { color: t } = e, n = Math.max(0, Math.min(1, (w(t.a) ?? 1) * (w(e.opacity) ?? 1)));
+	return `rgba(${W(t.r)},${W(t.g)},${W(t.b)},${Number(n.toFixed(6))})`;
+}
+function K(e) {
+	return Array.isArray(e) ? e.filter((e) => S(e) && e.visible !== !1) : [];
+}
+function ue(e) {
+	let t = {}, n = K(e.fills), r = n.length === 1 ? G(n[0]) : void 0;
+	r && (t[e.type === "TEXT" ? "color" : "backgroundColor"] = r);
+	let i = K(e.strokes), a = i.length === 1 ? G(i[0]) : void 0;
+	if (a) {
+		t.borderColor = a, t.borderStyle = "solid";
+		let n = w(e.strokeWeight);
+		if (n !== void 0 && (t.borderWidth = `${n}px`), S(e.individualStrokeWeights)) for (let [n, r] of Object.entries({
+			top: "borderTopWidth",
+			right: "borderRightWidth",
+			bottom: "borderBottomWidth",
+			left: "borderLeftWidth"
+		})) {
+			let i = w(e.individualStrokeWeights[n]);
+			i !== void 0 && (t[r] = `${i}px`);
+		}
+	}
+	let o = w(e.cornerRadius);
+	if (o !== void 0 && (t.borderRadius = `${o}px`), Array.isArray(e.rectangleCornerRadii)) {
+		let n = [
+			"borderTopLeftRadius",
+			"borderTopRightRadius",
+			"borderBottomRightRadius",
+			"borderBottomLeftRadius"
+		];
+		e.rectangleCornerRadii.forEach((e, r) => {
+			n[r] && w(e) !== void 0 && (t[n[r]] = `${e}px`);
+		});
+	}
+	e.type === "ELLIPSE" && (t.borderRadius = "50%");
+	let s = w(e.opacity);
+	return s !== void 0 && (t.opacity = s), e.visible === !1 && (t.display = "none"), t;
+}
+//#endregion
+//#region src/figma-tree/ir/converters/diagnostics.ts
+function de(e, t) {
+	let n = e.source, r = [];
+	t && r.push("type");
+	for (let e of ["fills", "strokes"]) {
+		let t = K(n[e]);
+		(t.length > 1 || t.some((e) => e.type !== "SOLID")) && r.push(e);
+	}
+	return Array.isArray(n.effects) && n.effects.some((e) => S(e) && e.visible !== !1) && r.push("effects"), S(n.styleOverrideTable) && Object.keys(n.styleOverrideTable).length && r.push("styleOverrideTable"), (n.type === "VECTOR" || n.type === "BOOLEAN_OPERATION" || n.type === "STAR" || n.type === "REGULAR_POLYGON" || n.type === "LINE") && r.push("vectorGeometry"), n.layoutMode === "GRID" && r.push("layoutMode"), typeof n.rotation == "number" && n.rotation !== 0 && r.push("rotation"), typeof n.itemSpacing == "number" && n.itemSpacing < 0 && r.push("itemSpacing"), K(n.strokes).length && n.strokeAlign && n.strokeAlign !== "INSIDE" && r.push("strokeAlign"), n.isMask === !0 && r.push("isMask"), typeof n.cornerSmoothing == "number" && n.cornerSmoothing > 0 && r.push("cornerSmoothing"), r.map((e) => ({
+		code: "unsupported-property",
+		nodeId: n.id,
+		property: e,
+		message: `${e} is not fully represented in the basic IR`
+	}));
+}
+//#endregion
+//#region src/figma-tree/ir/converters/layout.ts
+function q(e, t) {
+	return e === "FIXED" || e === "HUG" || e === "FILL" ? e : t;
+}
+function J(e, t) {
+	let n = e.source.layoutMode === "HORIZONTAL", r = t === "width" === n ? e.source.primaryAxisSizingMode : e.source.counterAxisSizingMode, i = e.parent?.source.layoutMode === "HORIZONTAL", a = t === "width" === i;
+	return (e.parent?.source.layoutMode === "HORIZONTAL" || e.parent?.source.layoutMode === "VERTICAL") && (a && e.source.layoutGrow === 1 || !a && e.source.layoutAlign === "STRETCH") ? "FILL" : r === "AUTO" ? "HUG" : "FIXED";
+}
+function fe(e) {
+	let t = S(e.source.absoluteBoundingBox) ? e.source.absoluteBoundingBox : {}, n = S(e.source.size) ? e.source.size : {};
+	return {
+		width: w(n.x) ?? w(t.width),
+		height: w(n.y) ?? w(t.height),
+		widthMode: q(e.source.layoutSizingHorizontal, J(e, "width")),
+		heightMode: q(e.source.layoutSizingVertical, J(e, "height"))
+	};
+}
+function Y(e, t, n, r, i, a) {
+	if (r === "FIXED") n !== void 0 && (e[t] = `${n}px`);
+	else if (r === "HUG") e[t] = "fit-content";
+	else {
+		let n = i.parent?.source.layoutMode === "HORIZONTAL" ? "width" : "height", r = ["HORIZONTAL", "VERTICAL"].includes(String(i.parent?.source.layoutMode));
+		!a && r && n === t ? (e.flexGrow = 1, e.flexBasis = "0px", e[t === "width" ? "minWidth" : "minHeight"] = "0px") : !a && r ? e.alignSelf = "stretch" : e[t] = "100%";
+	}
+}
+function pe(e) {
+	let t = e.source;
+	if (t.layoutMode !== "HORIZONTAL" && t.layoutMode !== "VERTICAL") return {};
+	let n = {
+		display: "flex",
+		flexDirection: t.layoutMode === "HORIZONTAL" ? "row" : "column"
+	};
+	typeof t.primaryAxisAlignItems == "string" && (n.justifyContent = {
+		MIN: "flex-start",
+		MAX: "flex-end",
+		CENTER: "center",
+		SPACE_BETWEEN: "space-between"
+	}[t.primaryAxisAlignItems] ?? "flex-start"), n.alignItems = typeof t.counterAxisAlignItems == "string" ? {
+		MIN: "flex-start",
+		MAX: "flex-end",
+		CENTER: "center",
+		BASELINE: "baseline"
+	}[t.counterAxisAlignItems] ?? "flex-start" : "flex-start";
+	let r = w(t.itemSpacing);
+	r !== void 0 && r >= 0 && (n.gap = `${r}px`);
+	for (let e of [
+		"paddingTop",
+		"paddingRight",
+		"paddingBottom",
+		"paddingLeft"
+	]) {
+		let r = w(t[e]);
+		r !== void 0 && (n[e] = `${r}px`);
+	}
+	if (t.layoutWrap === "WRAP") {
+		n.flexWrap = "wrap";
+		let e = w(t.counterAxisSpacing);
+		e !== void 0 && e >= 0 && (n[t.layoutMode === "HORIZONTAL" ? "rowGap" : "columnGap"] = `${e}px`), t.counterAxisAlignContent === "SPACE_BETWEEN" && (n.alignContent = "space-between");
+	}
+	return n;
+}
+function me(e, t) {
+	if (t) return { position: "relative" };
+	let n = e.parent?.source;
+	if (!(e.source.layoutPositioning === "ABSOLUTE" || n && n.layoutMode !== "HORIZONTAL" && n.layoutMode !== "VERTICAL")) return {
+		position: "relative",
+		flexShrink: 0
+	};
+	let r = S(e.source.absoluteBoundingBox) ? e.source.absoluteBoundingBox : {}, i = S(n?.absoluteBoundingBox) ? n.absoluteBoundingBox : {}, a = w(r.x), o = w(r.y);
+	return {
+		position: "absolute",
+		...a === void 0 ? {} : { left: `${a - (w(i.x) ?? 0)}px` },
+		...o === void 0 ? {} : { top: `${o - (w(i.y) ?? 0)}px` }
+	};
+}
+function he(e, t) {
+	let n = fe(e), r = {
+		boxSizing: "border-box",
+		...me(e, t),
+		...pe(e)
+	};
+	Y(r, "width", n.width, n.widthMode, e, t), Y(r, "height", n.height, n.heightMode, e, t);
+	for (let t of [
+		"minWidth",
+		"maxWidth",
+		"minHeight",
+		"maxHeight"
+	]) {
+		let n = w(e.source[t]);
+		n !== void 0 && (r[t] = `${n}px`);
+	}
+	return e.source.clipsContent === !0 && (r.overflow = "hidden"), {
+		size: n,
+		layout: {
+			mode: e.source.layoutMode === "HORIZONTAL" ? "horizontal" : e.source.layoutMode === "VERTICAL" ? "vertical" : "none",
+			wrap: e.source.layoutWrap === "WRAP"
+		},
+		style: r
+	};
+}
+//#endregion
+//#region src/figma-tree/ir/converters/text.ts
+function ge(e) {
+	if (e.type !== "TEXT") return {};
+	let t = S(e.style) ? e.style : {}, n = { whiteSpace: "pre-wrap" };
+	typeof t.fontFamily == "string" && (n.fontFamily = t.fontFamily);
+	let r = w(t.fontSize), i = w(t.fontWeight);
+	if (r !== void 0 && (n.fontSize = `${r}px`), i !== void 0 && (n.fontWeight = i), t.italic === !0 && (n.fontStyle = "italic"), typeof t.textAlignHorizontal == "string") {
+		let e = {
+			LEFT: "left",
+			RIGHT: "right",
+			CENTER: "center",
+			JUSTIFIED: "justify"
+		};
+		e[t.textAlignHorizontal] && (n.textAlign = e[t.textAlignHorizontal]);
+	}
+	let a = w(t.lineHeightPx);
+	t.lineHeightUnit === "FONT_SIZE_%" && w(t.lineHeightPercentFontSize) !== void 0 ? n.lineHeight = `${t.lineHeightPercentFontSize}%` : a !== void 0 && (n.lineHeight = `${a}px`);
+	let o = w(t.letterSpacing);
+	o !== void 0 && (n.letterSpacing = `${o}px`), t.textDecoration === "UNDERLINE" && (n.textDecorationLine = "underline"), t.textDecoration === "STRIKETHROUGH" && (n.textDecorationLine = "line-through");
+	let s = {
+		UPPER: "uppercase",
+		LOWER: "lowercase",
+		TITLE: "capitalize"
+	};
+	return typeof t.textCase == "string" && s[t.textCase] && (n.textTransform = s[t.textCase]), n;
+}
+//#endregion
+//#region src/figma-tree/ir/pipeline.ts
+function X(e) {
+	return e === "TEXT" ? "text" : e === "INSTANCE" ? "instance" : [
+		"DOCUMENT",
+		"CANVAS",
+		"FRAME",
+		"GROUP",
+		"COMPONENT",
+		"COMPONENT_SET",
+		"SECTION"
+	].includes(e) ? "container" : [
+		"RECTANGLE",
+		"ELLIPSE",
+		"LINE",
+		"VECTOR",
+		"BOOLEAN_OPERATION",
+		"STAR",
+		"REGULAR_POLYGON"
+	].includes(e) ? "shape" : "unknown";
+}
+function _e(e, t, n) {
+	let r = e.source, i = he(e, n);
+	return {
+		source: {
+			id: r.id,
+			name: r.name,
+			type: r.type,
+			...e.componentName ? { componentName: e.componentName } : {}
+		},
+		kind: X(r.type),
+		visible: r.visible !== !1,
+		...i,
+		style: {
+			...i.style,
+			...ge(r),
+			...ue(r)
+		},
+		...r.type === "TEXT" ? { text: { characters: typeof r.characters == "string" ? r.characters : "" } } : {},
+		children: t,
+		extensions: {}
+	};
+}
+function ve(e, t) {
+	let n = [...V([e])], r = /* @__PURE__ */ new Map(), i = [];
+	for (let i of [...n].reverse()) {
+		let n = _e(i, i.children.map((e) => r.get(e)), i === e);
+		r.set(i, R(n, i, t));
+	}
+	for (let e of n) i.push(...de(e, X(e.source.type) === "unknown"));
+	return new N({
+		schemaVersion: 1,
+		root: r.get(e),
+		diagnostics: i
+	});
+}
+//#endregion
+//#region src/figma-tree/selector/match.ts
+function ye(e, t) {
+	return t === "componentName" ? e.componentName : t === "visible" ? e.source.visible ?? !0 : e.source[t];
+}
+function be(e, t) {
+	let n = ye(e, t.key);
+	if (t.operator === "exists") return n !== void 0;
+	if (t.operator === "=") return n === t.value;
+	if (typeof n != "string") return !1;
+	if (t.operator === "regex") {
+		let e = t.value;
+		return new RegExp(e.source, e.flags).test(n);
+	}
+	let r = t.value;
+	return t.operator === "*=" ? n.includes(r) : t.operator === "^=" ? n.startsWith(r) : n.endsWith(r);
+}
+function xe(e, t) {
+	return (!t.type || e.source.type === t.type) && t.tests.every((t) => be(e, t));
+}
+function Se(e, t, n) {
+	let r = [{
+		node: e,
+		index: t.length - 1
+	}];
+	for (; r.length;) {
+		let e = r.pop(), i = t[e.index];
+		if (e.node === n || !xe(e.node, i)) continue;
+		if (e.index === 0) return !0;
+		let a = e.node.parent;
+		for (; a && a !== n && (r.push({
+			node: a,
+			index: e.index - 1
+		}), i.relation !== "child");) a = a.parent;
+	}
+	return !1;
+}
+//#endregion
+//#region src/figma-tree/selector/parser.ts
+function Ce(e) {
+	let t = [], n = 0, r;
+	for (; n < e.length;) {
+		for (; /\s/.test(e[n] ?? "") && n < e.length;) n++;
+		let i = n, a = !1, o = "";
+		for (; n < e.length;) {
+			let t = e[n];
+			if (o) t === "\\" ? n++ : t === o && (o = "");
+			else if (t === "\"" || t === "'") o = t;
+			else if (t === "[") {
+				if (a) throw new B("Nested brackets are not supported");
+				a = !0;
+			} else if (t === "]") {
+				if (!a) throw new B("Unexpected closing bracket");
+				a = !1;
+			} else if (!a && (t === ">" || /\s/.test(t))) break;
+			n++;
+		}
+		if (o || a) throw new B("Unclosed attribute or quoted value");
+		if (n === i) throw new B("Expected a selector before combinator");
+		for (t.push({
+			text: e.slice(i, n),
+			relation: r
+		}); n < e.length && /\s/.test(e[n]);) n++;
+		if (n === e.length) break;
+		if (r = e[n] === ">" ? "child" : "descendant", r === "child") {
+			for (n++; n < e.length && /\s/.test(e[n]);) n++;
+			if (n === e.length) throw new B("Expected selector after >");
+		}
+	}
+	return t;
+}
+function Z(e) {
+	if (!z.includes(e)) throw new B(`Unsupported attribute: ${e}`);
+}
+function we(e) {
+	let t = /^\s*([A-Za-z][A-Za-z0-9]*)\s*(?:(\*=|\^=|\$=|=)\s*(.*?)\s*)?$/.exec(e);
+	if (!t) throw new B(`Invalid attribute: [${e}]`);
+	let n = t[1];
+	Z(n);
+	let r = t[2];
+	if (!r) return {
+		key: n,
+		operator: "exists"
+	};
+	let i = t[3];
+	if (n === "visible") {
+		if (r !== "=" || !/^(true|false)$/.test(i)) throw new B("visible requires an unquoted boolean equality");
+		return {
+			key: n,
+			operator: r,
+			value: i === "true"
+		};
+	}
+	let a = /^(["'])([\s\S]*)\1$/.exec(i);
+	if (!a) throw new B("String attribute values must be quoted");
+	let o = a[2], s = "";
+	for (let e = 0; e < o.length; e++) if (o[e] === "\\") {
+		if (e + 1 === o.length) throw new B("Incomplete escape");
+		s += o[++e];
+	} else {
+		if (o[e] === a[1]) throw new B("Unescaped quote in attribute");
+		s += o[e];
+	}
+	return {
+		key: n,
+		operator: r,
+		value: s
+	};
+}
+function Te(e) {
+	let t = /^(\*|[A-Z][A-Z0-9_]*)/.exec(e)?.[1], n = t?.length ?? 0, r = [];
+	for (; n < e.length;) {
+		if (e[n] !== "[") throw new B(`Unsupported selector near: ${e.slice(n)}`);
+		let t = ++n, i = "";
+		for (; n < e.length;) {
+			let t = e[n];
+			if (i) t === "\\" ? n++ : t === i && (i = "");
+			else if (t === "\"" || t === "'") i = t;
+			else if (t === "]") break;
+			n++;
+		}
+		r.push(we(e.slice(t, n))), n++;
+	}
+	if (!t && !r.length) throw new B("Empty selector");
+	return {
+		type: t === "*" ? void 0 : t,
+		tests: r
+	};
+}
+function Ee(e) {
+	if (typeof e == "string") {
+		if (!e.trim()) throw new B("Empty selector");
+		return Ce(e.trim()).map(({ text: e, relation: t }) => ({
+			...Te(e),
+			relation: t
+		}));
+	}
+	if (!e || typeof e != "object" || Array.isArray(e)) throw new B("Expected a string or condition object");
+	return [{ tests: Object.entries(e).map(([e, t]) => {
+		if (Z(e), e === "visible" ? typeof t != "boolean" : typeof t != "string" && !(t instanceof RegExp)) throw new B(`Invalid condition for ${e}`);
+		return {
+			key: e,
+			operator: t instanceof RegExp ? "regex" : "=",
+			value: t
+		};
+	}) }];
+}
+//#endregion
+//#region src/figma-tree/tree/figma-tree.ts
+var De = class {
+	plugins;
+	#e = /* @__PURE__ */ new WeakMap();
+	constructor(e) {
+		this.plugins = e;
+	}
+	wrap(e) {
+		let t = this.#e.get(e);
+		return t || (t = new Oe(e, this), this.#e.set(e, t)), t;
+	}
+	*search(e, t, n) {
+		let r = Ee(t), i = /* @__PURE__ */ new Set();
+		for (let t of V(e)) !i.has(t.source.id) && Se(t, r, n) && (i.add(t.source.id), yield this.wrap(t));
+	}
+}, Oe = class {
+	#e;
+	#t;
+	constructor(e, t) {
+		this.#e = e, this.#t = t;
+	}
+	get id() {
+		return this.#e.source.id;
+	}
+	get name() {
+		return this.#e.source.name;
+	}
+	get type() {
+		return this.#e.source.type;
+	}
+	get componentName() {
+		return this.#e.componentName;
+	}
+	get children() {
+		return Object.freeze(this.#e.children.map((e) => this.#t.wrap(e)));
+	}
+	query(e) {
+		return this.#t.search(this.#e.children, e, this.#e).next().value;
+	}
+	queryAll(e) {
+		return [...this.#t.search(this.#e.children, e, this.#e)];
+	}
+	toJSON() {
+		return structuredClone(this.#e.source);
+	}
+	toIR(e = {}) {
+		return ve(this.#e, [...this.#t.plugins, ...e.plugins ?? []]);
+	}
+}, Q = class e {
+	#e;
+	#t;
+	diagnostics;
+	constructor(e, t) {
+		let n = D(e);
+		this.#e = U(n), this.#t = new De(Object.freeze([...t.irPlugins ?? []])), this.diagnostics = C(n.diagnostics);
+	}
+	static fromJson(t, n = {}) {
+		return new e(t, n);
+	}
+	get roots() {
+		return Object.freeze(this.#e.map((e) => this.#t.wrap(e)));
+	}
+	query(e) {
+		return this.#t.search(this.#e, e).next().value;
+	}
+	queryAll(e) {
+		return [...this.#t.search(this.#e, e)];
+	}
+};
+//#endregion
+//#region src/cli/html/input.ts
+function ke(e) {
+	return typeof e == "object" && !!e && "root" in e;
+}
+function Ae(e, t) {
+	if (ke(e)) {
+		if (t !== void 0) throw Error("--selector is only supported for original Figma JSON");
+		return x(e), e;
+	}
+	let n = Q.fromJson(e);
+	if (t === void 0 && n.roots.length !== 1) throw Error("Specify --selector when the Figma input does not have exactly one root");
+	let r = t === void 0 ? n.roots[0] : n.query(t);
+	if (!r) throw Error("No Figma node matched the export selector");
+	return r.toIR();
+}
+function $(e, t, n) {
+	let r = Ae(e, t);
+	if ("target" in r && r.target === "tailwind-v4") {
+		if (n === "inline") throw Error("Tailwind IR has no original inline styles; use standard IR for --styles inline");
+		return r;
+	}
+	if (n === "tailwind") {
+		let e = {
+			schemaVersion: r.schemaVersion,
+			root: r.root,
+			diagnostics: r.diagnostics
+		};
+		return new N(structuredClone(e)).toTailwind();
+	}
+	return r;
+}
+//#endregion
+//#region src/cli/commands/export.ts
+async function je(e, n, r) {
+	let i = $(JSON.parse(await t(e.input, "utf8")), e.selector, e.styles);
+	await m(ce(i), e.out, e.force, n), i.diagnostics.length && r(`HTML exported with ${i.diagnostics.length} IR diagnostics; unsupported design features may be omitted.\n`);
+}
+//#endregion
+//#region src/cli/commands/query.ts
+async function Me(e, n) {
+	let r = Q.fromJson(JSON.parse(await t(e.input, "utf8")));
+	await p(e.command === "query" ? r.query(e.selector)?.toJSON() ?? null : r.queryAll(e.selector).map((e) => e.toJSON()), e.out, e.force, n);
+}
+//#endregion
+//#region src/cli/env.ts
+function Ne(e) {
+	let t = e.FIGMA_TOKEN;
+	if (!t?.trim()) throw Error("FIGMA_TOKEN environment variable is required");
+	return t;
+}
+//#endregion
+//#region src/cli/run.ts
+async function Pe(e, t) {
+	try {
+		let n = re(e);
+		return n === "help" ? (t.stdout(l), 0) : (n.command === "download" ? await ae(n, new c({
+			token: Ne(t.env),
+			fetch: t.fetch
+		}), t.stdout) : n.command === "export" ? await je(n, t.stdout, t.stderr) : await Me(n, t.stdout), 0);
+	} catch (e) {
+		return t.stderr(`${ie(e, t.env.FIGMA_TOKEN)}\n`), 1;
+	}
+}
+//#endregion
+//#region src/cli/index.ts
+process.exitCode = await Pe(process.argv.slice(2), {
+	env: process.env,
+	stdout: (e) => {
+		process.stdout.write(e);
+	},
+	stderr: (e) => {
+		process.stderr.write(e);
+	}
+});
+//#endregion
+
+//# sourceMappingURL=index.js.map