@enadhq/enad-react-sdk 1.0.0 → 1.1.0

package/dist/client/theme/cli.mjs

@@ -0,0 +1,472 @@
+#!/usr/bin/env node
+import { readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { argv, exit, stderr, stdout } from "node:process";
+import { decode } from "@msgpack/msgpack";
+//#region src/client/theme/codec.ts
+const FORMAT_VERSION = "1";
+/** Short key -> full key */
+const KEY_MAP = {
+	c: "colorize",
+	i: "intensity",
+	d: "delight",
+	r: "radius",
+	bf: "fontBody",
+	hf: "fontHeading",
+	ic: "iconSet",
+	cs: "colorSpace",
+	dm: "darkMode",
+	lc: "lightColors",
+	dc: "darkColors",
+	br: "buttonRadius",
+	cr: "cardRadius",
+	ir: "inputRadius",
+	mr: "imageRadius",
+	sp: "shadowPreset",
+	sc: "shadowColor",
+	hw: "headingWeight",
+	ht: "headingTracking",
+	bw: "bodyWeight",
+	hx: "headingTransform",
+	bdr: "borderWidth",
+	oc: "overlayColor",
+	of: "overlayFromOpacity",
+	ot: "overlayToOpacity",
+	hs: "imageHoverScale",
+	hd: "imageHoverDuration",
+	v: "variants",
+	xs: "componentSet"
+};
+Object.fromEntries(Object.entries(KEY_MAP).map(([short, full]) => [full, short]));
+function fromBase64url(str) {
+	const base64 = str.replace(/-/g, "+").replace(/_/g, "/");
+	const padded = base64 + "=".repeat((4 - base64.length % 4) % 4);
+	const binary = atob(padded);
+	const bytes = new Uint8Array(binary.length);
+	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+	return bytes;
+}
+/**
+* Decode a hash string back into a key-value bag with full key names.
+*
+* Returns partial data -- the consumer is responsible for merging onto
+* its own defaults. Unknown keys are preserved for forward compatibility.
+* Returns an empty object on invalid input (never throws).
+*/
+function decodeThemeHash(hash) {
+	try {
+		if (!hash || hash.length < 2) return {};
+		if (hash[0] !== FORMAT_VERSION) return {};
+		const compact = decode(fromBase64url(hash.slice(1)));
+		if (typeof compact !== "object" || compact === null) return {};
+		const result = {};
+		for (const [key, value] of Object.entries(compact)) {
+			const fullKey = KEY_MAP[key] ?? key;
+			result[fullKey] = value;
+		}
+		return result;
+	} catch {
+		return {};
+	}
+}
+//#endregion
+//#region src/client/theme/defaults.ts
+/**
+* SDK default color tokens. These are the canonical defaults used by
+* the theme codec to compute diffs (only non-default values are encoded).
+*/
+const SDK_DEFAULTS = {
+	light: {
+		"--background": "#ffffff",
+		"--foreground": "#111827",
+		"--card": "#ffffff",
+		"--card-foreground": "#111827",
+		"--popover": "#ffffff",
+		"--popover-foreground": "#111827",
+		"--primary": "#2563eb",
+		"--primary-foreground": "#ffffff",
+		"--secondary": "#f1f5f9",
+		"--secondary-foreground": "#0f172a",
+		"--muted": "#f3f4f6",
+		"--muted-foreground": "#636b78",
+		"--accent": "#dbeafe",
+		"--accent-foreground": "#1e3a8a",
+		"--accent-muted": "#eff6ff",
+		"--accent-muted-foreground": "#1e40af",
+		"--destructive": "#dc2626",
+		"--destructive-foreground": "#ffffff",
+		"--border": "#e5e7eb",
+		"--input": "#e5e7eb",
+		"--ring": "#2563eb"
+	},
+	dark: {
+		"--background": "#111827",
+		"--foreground": "#f9fafb",
+		"--card": "#1f2937",
+		"--card-foreground": "#f9fafb",
+		"--popover": "#1f2937",
+		"--popover-foreground": "#f9fafb",
+		"--primary": "#2563eb",
+		"--primary-foreground": "#ffffff",
+		"--secondary": "#1e293b",
+		"--secondary-foreground": "#e2e8f0",
+		"--muted": "#374151",
+		"--muted-foreground": "#b0b8c4",
+		"--accent": "#1e3a5f",
+		"--accent-foreground": "#bfdbfe",
+		"--accent-muted": "#172554",
+		"--accent-muted-foreground": "#93c5fd",
+		"--destructive": "#dc2626",
+		"--destructive-foreground": "#ffffff",
+		"--border": "#374151",
+		"--input": "#374151",
+		"--ring": "#2563eb"
+	}
+};
+/** Default values for design tokens (non-color). */
+const TOKEN_DEFAULTS = {
+	colorize: 50,
+	intensity: 50,
+	delight: 50,
+	radius: .75,
+	fontBody: "Inter",
+	fontHeading: "Inter",
+	iconSet: "Phosphor",
+	colorSpace: "hsl",
+	darkMode: false,
+	componentSet: "default",
+	buttonRadius: "9999px",
+	cardRadius: "var(--radius)",
+	inputRadius: "var(--radius)",
+	imageRadius: "0px",
+	shadowPreset: "none",
+	shadowColor: "oklch(0 0 0 / 0.1)",
+	headingWeight: "600",
+	headingTracking: "0em",
+	bodyWeight: "400",
+	headingTransform: "none",
+	borderWidth: "1px",
+	overlayColor: "black",
+	overlayFromOpacity: "0.5",
+	overlayToOpacity: "0",
+	imageHoverScale: "1.05",
+	imageHoverDuration: "300ms",
+	variants: {
+		hero: "overlay",
+		linkBlock: "overlay",
+		productCard: "gallery",
+		contentWithImage: "side-by-side",
+		gallery: "grid",
+		textContent: "default"
+	}
+};
+//#endregion
+//#region src/client/theme/apply.ts
+function buildLightColorDiffs(hash) {
+	const lightOverrides = hash.lightColors ?? {};
+	const diffs = [];
+	for (const [token, value] of Object.entries(lightOverrides)) if (value !== SDK_DEFAULTS.light[token]) diffs.push(`  ${token}: ${value};`);
+	return diffs;
+}
+function buildBaseTokenDiffs(hash) {
+	const diffs = [];
+	const radius = hash.radius;
+	if (radius != null && radius !== .75) diffs.push(`  --radius: ${radius}rem;`);
+	const fontBody = hash.fontBody;
+	if (fontBody && fontBody !== "Inter") diffs.push(`  --font-sans: "${fontBody}", sans-serif;`);
+	const fontHeading = hash.fontHeading;
+	if (fontHeading && fontHeading !== fontBody && fontHeading !== "Inter") diffs.push(`  --font-heading: "${fontHeading}", sans-serif;`);
+	return diffs;
+}
+function buildDarkColorDiffs(hash) {
+	const darkOverrides = hash.darkColors ?? {};
+	const diffs = [];
+	for (const [token, value] of Object.entries(darkOverrides)) if (value !== SDK_DEFAULTS.dark[token]) diffs.push(`  ${token}: ${value};`);
+	return diffs;
+}
+function buildTokenSections(hash) {
+	const lines = [];
+	const tokenSections = [
+		{
+			comment: "Shape",
+			entries: [
+				[
+					"--enad-button-radius",
+					hash.buttonRadius,
+					TOKEN_DEFAULTS.buttonRadius
+				],
+				[
+					"--enad-card-radius",
+					hash.cardRadius,
+					TOKEN_DEFAULTS.cardRadius
+				],
+				[
+					"--enad-input-radius",
+					hash.inputRadius,
+					TOKEN_DEFAULTS.inputRadius
+				],
+				[
+					"--enad-image-radius",
+					hash.imageRadius,
+					TOKEN_DEFAULTS.imageRadius
+				]
+			]
+		},
+		{
+			comment: "Depth",
+			entries: [[
+				"--enad-shadow-color",
+				hash.shadowColor,
+				TOKEN_DEFAULTS.shadowColor
+			]]
+		},
+		{
+			comment: "Typography",
+			entries: [
+				[
+					"--enad-heading-weight",
+					hash.headingWeight,
+					TOKEN_DEFAULTS.headingWeight
+				],
+				[
+					"--enad-heading-tracking",
+					hash.headingTracking,
+					TOKEN_DEFAULTS.headingTracking
+				],
+				[
+					"--enad-body-weight",
+					hash.bodyWeight,
+					TOKEN_DEFAULTS.bodyWeight
+				],
+				[
+					"--enad-heading-transform",
+					hash.headingTransform,
+					TOKEN_DEFAULTS.headingTransform
+				]
+			]
+		},
+		{
+			comment: "Borders",
+			entries: [[
+				"--enad-border-width",
+				hash.borderWidth,
+				TOKEN_DEFAULTS.borderWidth
+			]]
+		},
+		{
+			comment: "Overlay",
+			entries: [
+				[
+					"--enad-overlay-color",
+					hash.overlayColor,
+					TOKEN_DEFAULTS.overlayColor
+				],
+				[
+					"--enad-overlay-from-opacity",
+					hash.overlayFromOpacity,
+					TOKEN_DEFAULTS.overlayFromOpacity
+				],
+				[
+					"--enad-overlay-to-opacity",
+					hash.overlayToOpacity,
+					TOKEN_DEFAULTS.overlayToOpacity
+				]
+			]
+		},
+		{
+			comment: "Motion",
+			entries: [[
+				"--enad-image-hover-scale",
+				hash.imageHoverScale,
+				TOKEN_DEFAULTS.imageHoverScale
+			], [
+				"--enad-image-hover-duration",
+				hash.imageHoverDuration,
+				TOKEN_DEFAULTS.imageHoverDuration
+			]]
+		}
+	];
+	for (const section of tokenSections) {
+		const sectionLines = [];
+		for (const [varName, value, defaultValue] of section.entries) if (value != null && value !== defaultValue) sectionLines.push(`  ${varName}: ${value};`);
+		if (sectionLines.length > 0) lines.push("", `/* ${section.comment} */`, ":root {", ...sectionLines, "}");
+	}
+	return lines;
+}
+/**
+* Generate CSS variable declarations from a decoded theme hash.
+* Merges the hash onto SDK defaults and only emits values that differ.
+*/
+function generateThemeCSS(hash, _options = {}) {
+	const lines = ["/* Generated by enad-theme */"];
+	const lightDiffs = [...buildLightColorDiffs(hash), ...buildBaseTokenDiffs(hash)];
+	if (lightDiffs.length > 0) lines.push("", ":root {", ...lightDiffs, "}");
+	const darkDiffs = buildDarkColorDiffs(hash);
+	if (darkDiffs.length > 0) lines.push("", ".dark {", ...darkDiffs, "}");
+	lines.push(...buildTokenSections(hash));
+	return lines.join("\n");
+}
+const MARKER_START = "/* === enad-theme:start === */";
+const MARKER_END = "/* === enad-theme:end === */";
+/**
+* Insert or replace a theme block in a CSS file's content.
+* Returns the updated file content.
+*/
+function applyThemeBlock(fileContent, cssBlock) {
+	const startIdx = fileContent.indexOf(MARKER_START);
+	const endIdx = fileContent.indexOf(MARKER_END);
+	const block = `${MARKER_START}\n${cssBlock}\n${MARKER_END}`;
+	if (startIdx !== -1 && endIdx !== -1) return fileContent.slice(0, startIdx) + block + fileContent.slice(endIdx + 28);
+	return fileContent + (fileContent.length > 0 && !fileContent.endsWith("\n") ? "\n" : "") + "\n" + block + "\n";
+}
+//#endregion
+//#region src/client/theme/scan.ts
+/**
+* Scan CSS file contents for existing declarations of the given custom properties.
+* Uses simple regex matching -- no CSS parser needed since custom property
+* declarations have unambiguous syntax.
+*/
+function scanConflicts(files, variables) {
+	if (variables.length === 0) return [];
+	const warnings = [];
+	const varSet = new Set(variables);
+	for (const file of files) {
+		const lines = file.content.split("\n");
+		for (let i = 0; i < lines.length; i++) {
+			const match = lines[i].match(/^\s*(--[\w-]+)\s*:\s*(.+?)\s*;?\s*$/);
+			if (match && varSet.has(match[1])) warnings.push({
+				file: file.path,
+				line: i + 1,
+				variable: match[1],
+				existingValue: match[2]
+			});
+		}
+	}
+	return warnings;
+}
+//#endregion
+//#region src/client/theme/cli.ts
+function printUsage() {
+	stderr.write(`
+Usage: enad-theme apply <hash> [options]
+
+Options:
+  --target <file>       Target CSS file (default: src/globals.css)
+  --color-space <cs>    Color space: hsl | oklch (default: hsl)
+  --scan <dir>          Directory to scan for conflicts (default: src)
+  --dry-run             Print CSS to stdout without writing
+  --help                Show this help message
+
+Examples:
+  enad-theme apply 1k5YWJj...
+  enad-theme apply 1k5YWJj... --target app/globals.css --color-space oklch
+  enad-theme apply 1k5YWJj... --dry-run
+`);
+}
+function parseArgs(args) {
+	if (args.length === 0 || args.includes("--help")) {
+		printUsage();
+		exit(0);
+	}
+	const command = args[0];
+	if (command !== "apply") {
+		stderr.write(`Unknown command: ${command}\nRun enad-theme --help for usage.\n`);
+		exit(1);
+	}
+	const hash = args[1];
+	if (!hash) {
+		stderr.write("Error: missing theme hash argument.\n");
+		exit(1);
+	}
+	let target = "src/globals.css";
+	let colorSpace = "hsl";
+	let scanDir = "src";
+	let dryRun = false;
+	for (let i = 2; i < args.length; i++) switch (args[i]) {
+		case "--target":
+			target = args[++i] ?? target;
+			break;
+		case "--color-space":
+			colorSpace = args[++i] ?? colorSpace;
+			break;
+		case "--scan":
+			scanDir = args[++i] ?? scanDir;
+			break;
+		case "--dry-run":
+			dryRun = true;
+			break;
+	}
+	return {
+		command,
+		hash,
+		target,
+		colorSpace,
+		scanDir,
+		dryRun
+	};
+}
+function readExistingFile(targetPath) {
+	try {
+		return readFileSync(targetPath, "utf-8");
+	} catch {
+		return "";
+	}
+}
+function writeOutput(targetPath, target, existing, css) {
+	writeFileSync(targetPath, applyThemeBlock(existing, css), "utf-8");
+	const isUpdate = existing.includes(MARKER_START);
+	stderr.write(isUpdate ? `Updated theme block in ${target}\n` : `Wrote theme block to ${target}\n`);
+}
+function scanForConflicts(scanDir, targetPath, css) {
+	const varPattern = /^\s*(--[\w-]+)\s*:/gm;
+	const variables = [];
+	let match;
+	while ((match = varPattern.exec(css)) !== null) variables.push(match[1]);
+	if (variables.length === 0) return;
+	const cssFiles = [];
+	function walk(dir) {
+		try {
+			for (const entry of readdirSync(dir)) {
+				const full = join(dir, entry);
+				try {
+					const stat = statSync(full);
+					if (stat.isDirectory() && !entry.startsWith(".") && entry !== "node_modules") walk(full);
+					else if (stat.isFile() && full.endsWith(".css") && resolve(full) !== targetPath) cssFiles.push({
+						path: full,
+						content: readFileSync(full, "utf-8")
+					});
+				} catch {}
+			}
+		} catch {}
+	}
+	walk(resolve(scanDir));
+	const warnings = scanConflicts(cssFiles, variables);
+	if (warnings.length > 0) {
+		stderr.write(`\nConflicting declarations found:\n`);
+		for (const w of warnings) stderr.write(`  ${w.file}:${w.line}  ${w.variable}: ${w.existingValue}\n`);
+		stderr.write(`\nThese existing declarations may override or conflict with the theme.\n`);
+	}
+}
+function main() {
+	const parsed = parseArgs(argv.slice(2));
+	if (!parsed) return;
+	const { hash, target, colorSpace, scanDir, dryRun } = parsed;
+	const decoded = decodeThemeHash(hash);
+	if (Object.keys(decoded).length === 0) {
+		stderr.write("Error: failed to decode theme hash. Check that the hash is valid.\n");
+		exit(1);
+	}
+	const css = generateThemeCSS(decoded, { colorSpace });
+	if (dryRun) {
+		stdout.write(css + "\n");
+		exit(0);
+	}
+	const targetPath = resolve(target);
+	writeOutput(targetPath, target, readExistingFile(targetPath), css);
+	scanForConflicts(scanDir, targetPath, css);
+}
+main();
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/client/theme/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":["msgpackDecode"],"sources":["../../../src/client/theme/codec.ts","../../../src/client/theme/defaults.ts","../../../src/client/theme/apply.ts","../../../src/client/theme/scan.ts","../../../src/client/theme/cli.ts"],"sourcesContent":["import { decode as msgpackDecode, encode as msgpackEncode } from \"@msgpack/msgpack\";\n\n/**\n * Loose bag of theme values. The decoder returns whatever keys are present;\n * the consumer merges onto its own defaults. This keeps the format\n * forward/backward compatible: new keys are silently ignored by old decoders,\n * and removed keys are filled from defaults by the consumer.\n */\nexport type ThemeHash = Record<string, unknown>;\n\n// Current format version. Prepended as a single ASCII char before the base64url payload.\nconst FORMAT_VERSION = \"1\";\n\n// ---------------------------------------------------------------------------\n// Short key mapping\n// ---------------------------------------------------------------------------\n\n/** Short key -> full key */\nexport const KEY_MAP: Record<string, string> = {\n  c: \"colorize\",\n  i: \"intensity\",\n  d: \"delight\",\n  r: \"radius\",\n  bf: \"fontBody\",\n  hf: \"fontHeading\",\n  ic: \"iconSet\",\n  cs: \"colorSpace\",\n  dm: \"darkMode\",\n  lc: \"lightColors\",\n  dc: \"darkColors\",\n  br: \"buttonRadius\",\n  cr: \"cardRadius\",\n  ir: \"inputRadius\",\n  mr: \"imageRadius\",\n  sp: \"shadowPreset\",\n  sc: \"shadowColor\",\n  hw: \"headingWeight\",\n  ht: \"headingTracking\",\n  bw: \"bodyWeight\",\n  hx: \"headingTransform\",\n  bdr: \"borderWidth\",\n  oc: \"overlayColor\",\n  of: \"overlayFromOpacity\",\n  ot: \"overlayToOpacity\",\n  hs: \"imageHoverScale\",\n  hd: \"imageHoverDuration\",\n  v: \"variants\",\n  xs: \"componentSet\",\n};\n\n/** Full key -> short key (inverse of KEY_MAP) */\nexport const KEY_MAP_REVERSE: Record<string, string> = Object.fromEntries(\n  Object.entries(KEY_MAP).map(([short, full]) => [full, short]),\n);\n\n// ---------------------------------------------------------------------------\n// Base64url helpers (RFC 4648 §5, no padding)\n// ---------------------------------------------------------------------------\n\nfunction toBase64url(buf: Uint8Array): string {\n  let binary = \"\";\n  for (let i = 0; i < buf.length; i++) {\n    binary += String.fromCharCode(buf[i]!);\n  }\n  return btoa(binary).replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=+$/, \"\");\n}\n\nfunction fromBase64url(str: string): Uint8Array {\n  const base64 = str.replace(/-/g, \"+\").replace(/_/g, \"/\");\n  const padded = base64 + \"=\".repeat((4 - (base64.length % 4)) % 4);\n  const binary = atob(padded);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  return bytes;\n}\n\n// ---------------------------------------------------------------------------\n// Encode / Decode\n// ---------------------------------------------------------------------------\n\n/**\n * Encode a theme state diff into a portable hash string.\n *\n * The input should only contain non-default values. The encoder maps\n * full keys to short keys, packs with MessagePack, and encodes as\n * `<version><base64url>`.\n */\nexport function encodeThemeHash(diff: ThemeHash): string {\n  const compact: Record<string, unknown> = {};\n  for (const [fullKey, value] of Object.entries(diff)) {\n    const shortKey = KEY_MAP_REVERSE[fullKey] ?? fullKey;\n    compact[shortKey] = value;\n  }\n  const packed = msgpackEncode(compact);\n  return FORMAT_VERSION + toBase64url(packed);\n}\n\n/**\n * Decode a hash string back into a key-value bag with full key names.\n *\n * Returns partial data -- the consumer is responsible for merging onto\n * its own defaults. Unknown keys are preserved for forward compatibility.\n * Returns an empty object on invalid input (never throws).\n */\nexport function decodeThemeHash(hash: string): ThemeHash {\n  try {\n    if (!hash || hash.length < 2) return {};\n\n    const version = hash[0];\n    if (version !== FORMAT_VERSION) return {};\n\n    const payload = hash.slice(1);\n    const bytes = fromBase64url(payload);\n    const compact = msgpackDecode(bytes) as Record<string, unknown>;\n\n    if (typeof compact !== \"object\" || compact === null) return {};\n\n    const result: ThemeHash = {};\n    for (const [key, value] of Object.entries(compact)) {\n      const fullKey = KEY_MAP[key] ?? key;\n      result[fullKey] = value;\n    }\n    return result;\n  } catch {\n    return {};\n  }\n}\n","/**\n * SDK default color tokens. These are the canonical defaults used by\n * the theme codec to compute diffs (only non-default values are encoded).\n */\nexport const SDK_DEFAULTS = {\n  light: {\n    \"--background\": \"#ffffff\",\n    \"--foreground\": \"#111827\",\n    \"--card\": \"#ffffff\",\n    \"--card-foreground\": \"#111827\",\n    \"--popover\": \"#ffffff\",\n    \"--popover-foreground\": \"#111827\",\n    \"--primary\": \"#2563eb\",\n    \"--primary-foreground\": \"#ffffff\",\n    \"--secondary\": \"#f1f5f9\",\n    \"--secondary-foreground\": \"#0f172a\",\n    \"--muted\": \"#f3f4f6\",\n    \"--muted-foreground\": \"#636b78\",\n    \"--accent\": \"#dbeafe\",\n    \"--accent-foreground\": \"#1e3a8a\",\n    \"--accent-muted\": \"#eff6ff\",\n    \"--accent-muted-foreground\": \"#1e40af\",\n    \"--destructive\": \"#dc2626\",\n    \"--destructive-foreground\": \"#ffffff\",\n    \"--border\": \"#e5e7eb\",\n    \"--input\": \"#e5e7eb\",\n    \"--ring\": \"#2563eb\",\n  } as Record<string, string>,\n  dark: {\n    \"--background\": \"#111827\",\n    \"--foreground\": \"#f9fafb\",\n    \"--card\": \"#1f2937\",\n    \"--card-foreground\": \"#f9fafb\",\n    \"--popover\": \"#1f2937\",\n    \"--popover-foreground\": \"#f9fafb\",\n    \"--primary\": \"#2563eb\",\n    \"--primary-foreground\": \"#ffffff\",\n    \"--secondary\": \"#1e293b\",\n    \"--secondary-foreground\": \"#e2e8f0\",\n    \"--muted\": \"#374151\",\n    \"--muted-foreground\": \"#b0b8c4\",\n    \"--accent\": \"#1e3a5f\",\n    \"--accent-foreground\": \"#bfdbfe\",\n    \"--accent-muted\": \"#172554\",\n    \"--accent-muted-foreground\": \"#93c5fd\",\n    \"--destructive\": \"#dc2626\",\n    \"--destructive-foreground\": \"#ffffff\",\n    \"--border\": \"#374151\",\n    \"--input\": \"#374151\",\n    \"--ring\": \"#2563eb\",\n  } as Record<string, string>,\n};\n\n/** Default values for design tokens (non-color). */\nexport const TOKEN_DEFAULTS = {\n  colorize: 50,\n  intensity: 50,\n  delight: 50,\n  radius: 0.75,\n  fontBody: \"Inter\",\n  fontHeading: \"Inter\",\n  iconSet: \"Phosphor\",\n  colorSpace: \"hsl\",\n  darkMode: false,\n  componentSet: \"default\" as const,\n\n  // Shape\n  buttonRadius: \"9999px\",\n  cardRadius: \"var(--radius)\",\n  inputRadius: \"var(--radius)\",\n  imageRadius: \"0px\",\n\n  // Depth\n  shadowPreset: \"none\",\n  shadowColor: \"oklch(0 0 0 / 0.1)\",\n\n  // Typography\n  headingWeight: \"600\",\n  headingTracking: \"0em\",\n  bodyWeight: \"400\",\n  headingTransform: \"none\",\n\n  // Border\n  borderWidth: \"1px\",\n\n  // Overlay\n  overlayColor: \"black\",\n  overlayFromOpacity: \"0.5\",\n  overlayToOpacity: \"0\",\n\n  // Motion\n  imageHoverScale: \"1.05\",\n  imageHoverDuration: \"300ms\",\n\n  // Variants\n  variants: {\n    hero: \"overlay\",\n    linkBlock: \"overlay\",\n    productCard: \"gallery\",\n    contentWithImage: \"side-by-side\",\n    gallery: \"grid\",\n    textContent: \"default\",\n  },\n} as const;\n","import type { ThemeHash } from './codec';\nimport { SDK_DEFAULTS, TOKEN_DEFAULTS } from './defaults';\n\nexport interface GenerateOptions {\n  colorSpace?: 'hsl' | 'oklch';\n}\n\nfunction buildLightColorDiffs(hash: ThemeHash): string[] {\n  const lightOverrides = (hash.lightColors ?? {}) as Record<string, string>;\n  const diffs: string[] = [];\n  for (const [token, value] of Object.entries(lightOverrides)) {\n    if (value !== SDK_DEFAULTS.light[token]) {\n      diffs.push(`  ${token}: ${value};`);\n    }\n  }\n  return diffs;\n}\n\nfunction buildBaseTokenDiffs(hash: ThemeHash): string[] {\n  const diffs: string[] = [];\n\n  const radius = hash.radius as number | undefined;\n  if (radius != null && radius !== 0.75) {\n    diffs.push(`  --radius: ${radius}rem;`);\n  }\n\n  const fontBody = hash.fontBody as string | undefined;\n  if (fontBody && fontBody !== 'Inter') {\n    diffs.push(`  --font-sans: \"${fontBody}\", sans-serif;`);\n  }\n\n  const fontHeading = hash.fontHeading as string | undefined;\n  if (fontHeading && fontHeading !== fontBody && fontHeading !== 'Inter') {\n    diffs.push(`  --font-heading: \"${fontHeading}\", sans-serif;`);\n  }\n\n  return diffs;\n}\n\nfunction buildDarkColorDiffs(hash: ThemeHash): string[] {\n  const darkOverrides = (hash.darkColors ?? {}) as Record<string, string>;\n  const diffs: string[] = [];\n  for (const [token, value] of Object.entries(darkOverrides)) {\n    if (value !== SDK_DEFAULTS.dark[token]) {\n      diffs.push(`  ${token}: ${value};`);\n    }\n  }\n  return diffs;\n}\n\nfunction buildTokenSections(hash: ThemeHash): string[] {\n  const lines: string[] = [];\n\n  const tokenSections: Array<{ comment: string; entries: Array<[string, string, string]> }> = [\n    {\n      comment: 'Shape',\n      entries: [\n        ['--enad-button-radius', hash.buttonRadius as string, TOKEN_DEFAULTS.buttonRadius],\n        ['--enad-card-radius', hash.cardRadius as string, TOKEN_DEFAULTS.cardRadius],\n        ['--enad-input-radius', hash.inputRadius as string, TOKEN_DEFAULTS.inputRadius],\n        ['--enad-image-radius', hash.imageRadius as string, TOKEN_DEFAULTS.imageRadius],\n      ],\n    },\n    {\n      comment: 'Depth',\n      entries: [\n        ['--enad-shadow-color', hash.shadowColor as string, TOKEN_DEFAULTS.shadowColor],\n      ],\n    },\n    {\n      comment: 'Typography',\n      entries: [\n        ['--enad-heading-weight', hash.headingWeight as string, TOKEN_DEFAULTS.headingWeight],\n        ['--enad-heading-tracking', hash.headingTracking as string, TOKEN_DEFAULTS.headingTracking],\n        ['--enad-body-weight', hash.bodyWeight as string, TOKEN_DEFAULTS.bodyWeight],\n        ['--enad-heading-transform', hash.headingTransform as string, TOKEN_DEFAULTS.headingTransform],\n      ],\n    },\n    {\n      comment: 'Borders',\n      entries: [\n        ['--enad-border-width', hash.borderWidth as string, TOKEN_DEFAULTS.borderWidth],\n      ],\n    },\n    {\n      comment: 'Overlay',\n      entries: [\n        ['--enad-overlay-color', hash.overlayColor as string, TOKEN_DEFAULTS.overlayColor],\n        ['--enad-overlay-from-opacity', hash.overlayFromOpacity as string, TOKEN_DEFAULTS.overlayFromOpacity],\n        ['--enad-overlay-to-opacity', hash.overlayToOpacity as string, TOKEN_DEFAULTS.overlayToOpacity],\n      ],\n    },\n    {\n      comment: 'Motion',\n      entries: [\n        ['--enad-image-hover-scale', hash.imageHoverScale as string, TOKEN_DEFAULTS.imageHoverScale],\n        ['--enad-image-hover-duration', hash.imageHoverDuration as string, TOKEN_DEFAULTS.imageHoverDuration],\n      ],\n    },\n  ];\n\n  for (const section of tokenSections) {\n    const sectionLines: string[] = [];\n    for (const [varName, value, defaultValue] of section.entries) {\n      if (value != null && value !== defaultValue) {\n        sectionLines.push(`  ${varName}: ${value};`);\n      }\n    }\n    if (sectionLines.length > 0) {\n      lines.push('', `/* ${section.comment} */`, ':root {', ...sectionLines, '}');\n    }\n  }\n\n  return lines;\n}\n\n/**\n * Generate CSS variable declarations from a decoded theme hash.\n * Merges the hash onto SDK defaults and only emits values that differ.\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport function generateThemeCSS(hash: ThemeHash, _options: GenerateOptions = {}): string {\n  const lines: string[] = ['/* Generated by enad-theme */'];\n\n  // --- Light color diffs + base tokens ---\n  const lightDiffs = [...buildLightColorDiffs(hash), ...buildBaseTokenDiffs(hash)];\n  if (lightDiffs.length > 0) {\n    lines.push('', ':root {', ...lightDiffs, '}');\n  }\n\n  // --- Dark color diffs ---\n  const darkDiffs = buildDarkColorDiffs(hash);\n  if (darkDiffs.length > 0) {\n    lines.push('', '.dark {', ...darkDiffs, '}');\n  }\n\n  // --- Token sections ---\n  lines.push(...buildTokenSections(hash));\n\n  return lines.join('\\n');\n}\n\n// Sentinel markers for idempotent file writes\nexport const MARKER_START = '/* === enad-theme:start === */';\nexport const MARKER_END = '/* === enad-theme:end === */';\n\n/**\n * Insert or replace a theme block in a CSS file's content.\n * Returns the updated file content.\n */\nexport function applyThemeBlock(fileContent: string, cssBlock: string): string {\n  const startIdx = fileContent.indexOf(MARKER_START);\n  const endIdx = fileContent.indexOf(MARKER_END);\n\n  const block = `${MARKER_START}\\n${cssBlock}\\n${MARKER_END}`;\n\n  if (startIdx !== -1 && endIdx !== -1) {\n    return fileContent.slice(0, startIdx) + block + fileContent.slice(endIdx + MARKER_END.length);\n  }\n\n  // Append with a blank line separator\n  const separator = fileContent.length > 0 && !fileContent.endsWith('\\n') ? '\\n' : '';\n  return fileContent + separator + '\\n' + block + '\\n';\n}\n","export interface ConflictWarning {\n  file: string;\n  line: number;\n  variable: string;\n  existingValue: string;\n}\n\n/**\n * Scan CSS file contents for existing declarations of the given custom properties.\n * Uses simple regex matching -- no CSS parser needed since custom property\n * declarations have unambiguous syntax.\n */\nexport function scanConflicts(\n  files: Array<{ path: string; content: string }>,\n  variables: string[],\n): ConflictWarning[] {\n  if (variables.length === 0) return [];\n\n  const warnings: ConflictWarning[] = [];\n  // Match lines like `  --variable-name: value;` or `--variable-name: value`\n  const varSet = new Set(variables);\n\n  for (const file of files) {\n    const lines = file.content.split('\\n');\n    for (let i = 0; i < lines.length; i++) {\n      const line = lines[i]!;\n      const match = line.match(/^\\s*(--[\\w-]+)\\s*:\\s*(.+?)\\s*;?\\s*$/);\n      if (match && varSet.has(match[1]!)) {\n        warnings.push({\n          file: file.path,\n          line: i + 1,\n          variable: match[1]!,\n          existingValue: match[2]!,\n        });\n      }\n    }\n  }\n\n  return warnings;\n}\n","import { readFileSync, writeFileSync, readdirSync, statSync } from 'node:fs';\nimport { resolve, join } from 'node:path';\nimport { argv, exit, stderr, stdout } from 'node:process';\n\nimport { decodeThemeHash } from './codec';\nimport { applyThemeBlock, generateThemeCSS, MARKER_START } from './apply';\nimport { scanConflicts } from './scan';\n\ninterface ParsedArgs {\n  command: string;\n  hash: string;\n  target: string;\n  colorSpace: 'hsl' | 'oklch';\n  scanDir: string;\n  dryRun: boolean;\n}\n\nfunction printUsage() {\n  stderr.write(`\nUsage: enad-theme apply <hash> [options]\n\nOptions:\n  --target <file>       Target CSS file (default: src/globals.css)\n  --color-space <cs>    Color space: hsl | oklch (default: hsl)\n  --scan <dir>          Directory to scan for conflicts (default: src)\n  --dry-run             Print CSS to stdout without writing\n  --help                Show this help message\n\nExamples:\n  enad-theme apply 1k5YWJj...\n  enad-theme apply 1k5YWJj... --target app/globals.css --color-space oklch\n  enad-theme apply 1k5YWJj... --dry-run\n`);\n}\n\nfunction parseArgs(args: string[]): ParsedArgs | null {\n  if (args.length === 0 || args.includes('--help')) {\n    printUsage();\n    exit(0);\n  }\n\n  const command = args[0]!;\n  if (command !== 'apply') {\n    stderr.write(`Unknown command: ${command}\\nRun enad-theme --help for usage.\\n`);\n    exit(1);\n  }\n\n  const hash = args[1];\n  if (!hash) {\n    stderr.write('Error: missing theme hash argument.\\n');\n    exit(1);\n  }\n\n  let target = 'src/globals.css';\n  let colorSpace: 'hsl' | 'oklch' = 'hsl';\n  let scanDir = 'src';\n  let dryRun = false;\n\n  for (let i = 2; i < args.length; i++) {\n    switch (args[i]) {\n      case '--target':\n        target = args[++i] ?? target;\n        break;\n      case '--color-space':\n        colorSpace = (args[++i] as 'hsl' | 'oklch') ?? colorSpace;\n        break;\n      case '--scan':\n        scanDir = args[++i] ?? scanDir;\n        break;\n      case '--dry-run':\n        dryRun = true;\n        break;\n    }\n  }\n\n  return { command, hash, target, colorSpace, scanDir, dryRun };\n}\n\nfunction readExistingFile(targetPath: string): string {\n  try {\n    return readFileSync(targetPath, 'utf-8');\n  } catch {\n    // File doesn't exist yet, we'll create it\n    return '';\n  }\n}\n\nfunction writeOutput(targetPath: string, target: string, existing: string, css: string) {\n  const updated = applyThemeBlock(existing, css);\n  writeFileSync(targetPath, updated, 'utf-8');\n\n  const isUpdate = existing.includes(MARKER_START);\n  stderr.write(\n    isUpdate\n      ? `Updated theme block in ${target}\\n`\n      : `Wrote theme block to ${target}\\n`,\n  );\n}\n\nfunction scanForConflicts(scanDir: string, targetPath: string, css: string) {\n  // Extract variable names from the generated CSS\n  const varPattern = /^\\s*(--[\\w-]+)\\s*:/gm;\n  const variables: string[] = [];\n  let match: RegExpExecArray | null;\n  while ((match = varPattern.exec(css)) !== null) {\n    variables.push(match[1]!);\n  }\n\n  if (variables.length === 0) return;\n\n  // Simple recursive CSS file scan\n  const cssFiles: Array<{ path: string; content: string }> = [];\n\n  function walk(dir: string) {\n    try {\n      for (const entry of readdirSync(dir)) {\n        const full = join(dir, entry);\n        try {\n          const stat = statSync(full);\n          if (stat.isDirectory() && !entry.startsWith('.') && entry !== 'node_modules') {\n            walk(full);\n          } else if (stat.isFile() && full.endsWith('.css') && resolve(full) !== targetPath) {\n            cssFiles.push({ path: full, content: readFileSync(full, 'utf-8') });\n          }\n        } catch {\n          // Skip inaccessible files\n        }\n      }\n    } catch {\n      // Skip inaccessible directories\n    }\n  }\n\n  walk(resolve(scanDir));\n\n  const warnings = scanConflicts(cssFiles, variables);\n  if (warnings.length > 0) {\n    stderr.write(`\\nConflicting declarations found:\\n`);\n    for (const w of warnings) {\n      stderr.write(`  ${w.file}:${w.line}  ${w.variable}: ${w.existingValue}\\n`);\n    }\n    stderr.write(`\\nThese existing declarations may override or conflict with the theme.\\n`);\n  }\n}\n\nfunction main() {\n  const parsed = parseArgs(argv.slice(2));\n  if (!parsed) return;\n\n  const { hash, target, colorSpace, scanDir, dryRun } = parsed;\n\n  // Decode\n  const decoded = decodeThemeHash(hash);\n  if (Object.keys(decoded).length === 0) {\n    stderr.write('Error: failed to decode theme hash. Check that the hash is valid.\\n');\n    exit(1);\n  }\n\n  // Generate CSS\n  const css = generateThemeCSS(decoded, { colorSpace });\n\n  if (dryRun) {\n    stdout.write(css + '\\n');\n    exit(0);\n  }\n\n  // Write to target file\n  const targetPath = resolve(target);\n  const existing = readExistingFile(targetPath);\n  writeOutput(targetPath, target, existing, css);\n\n  scanForConflicts(scanDir, targetPath, css);\n}\n\nmain();\n"],"mappings":"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"}

package/dist/client/theme/codec.d.ts

@@ -0,0 +1,31 @@
+//#region src/client/theme/codec.d.ts
+/**
+ * Loose bag of theme values. The decoder returns whatever keys are present;
+ * the consumer merges onto its own defaults. This keeps the format
+ * forward/backward compatible: new keys are silently ignored by old decoders,
+ * and removed keys are filled from defaults by the consumer.
+ */
+type ThemeHash = Record<string, unknown>;
+/** Short key -> full key */
+declare const KEY_MAP: Record<string, string>;
+/** Full key -> short key (inverse of KEY_MAP) */
+declare const KEY_MAP_REVERSE: Record<string, string>;
+/**
+ * Encode a theme state diff into a portable hash string.
+ *
+ * The input should only contain non-default values. The encoder maps
+ * full keys to short keys, packs with MessagePack, and encodes as
+ * `<version><base64url>`.
+ */
+declare function encodeThemeHash(diff: ThemeHash): string;
+/**
+ * Decode a hash string back into a key-value bag with full key names.
+ *
+ * Returns partial data -- the consumer is responsible for merging onto
+ * its own defaults. Unknown keys are preserved for forward compatibility.
+ * Returns an empty object on invalid input (never throws).
+ */
+declare function decodeThemeHash(hash: string): ThemeHash;
+//#endregion
+export { KEY_MAP, KEY_MAP_REVERSE, ThemeHash, decodeThemeHash, encodeThemeHash };
+//# sourceMappingURL=codec.d.ts.map

package/dist/client/theme/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","names":[],"sources":["../../../src/client/theme/codec.ts"],"mappings":";;AAQA;;;;;KAAY,SAAA,GAAY,MAAA;;cAUX,OAAA,EAAS,MAAA;;cAiCT,eAAA,EAAiB,MAAA;AAA9B;;;;;AAsCA;;AAtCA,iBAsCgB,eAAA,CAAgB,IAAA,EAAM,SAAA;;;AAiBtC;;;;;iBAAgB,eAAA,CAAgB,IAAA,WAAe,SAAA"}

package/dist/client/theme/codec.mjs

@@ -0,0 +1,92 @@
+import { decode, encode } from "@msgpack/msgpack";
+//#region src/client/theme/codec.ts
+const FORMAT_VERSION = "1";
+/** Short key -> full key */
+const KEY_MAP = {
+	c: "colorize",
+	i: "intensity",
+	d: "delight",
+	r: "radius",
+	bf: "fontBody",
+	hf: "fontHeading",
+	ic: "iconSet",
+	cs: "colorSpace",
+	dm: "darkMode",
+	lc: "lightColors",
+	dc: "darkColors",
+	br: "buttonRadius",
+	cr: "cardRadius",
+	ir: "inputRadius",
+	mr: "imageRadius",
+	sp: "shadowPreset",
+	sc: "shadowColor",
+	hw: "headingWeight",
+	ht: "headingTracking",
+	bw: "bodyWeight",
+	hx: "headingTransform",
+	bdr: "borderWidth",
+	oc: "overlayColor",
+	of: "overlayFromOpacity",
+	ot: "overlayToOpacity",
+	hs: "imageHoverScale",
+	hd: "imageHoverDuration",
+	v: "variants",
+	xs: "componentSet"
+};
+/** Full key -> short key (inverse of KEY_MAP) */
+const KEY_MAP_REVERSE = Object.fromEntries(Object.entries(KEY_MAP).map(([short, full]) => [full, short]));
+function toBase64url(buf) {
+	let binary = "";
+	for (let i = 0; i < buf.length; i++) binary += String.fromCharCode(buf[i]);
+	return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function fromBase64url(str) {
+	const base64 = str.replace(/-/g, "+").replace(/_/g, "/");
+	const padded = base64 + "=".repeat((4 - base64.length % 4) % 4);
+	const binary = atob(padded);
+	const bytes = new Uint8Array(binary.length);
+	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+	return bytes;
+}
+/**
+* Encode a theme state diff into a portable hash string.
+*
+* The input should only contain non-default values. The encoder maps
+* full keys to short keys, packs with MessagePack, and encodes as
+* `<version><base64url>`.
+*/
+function encodeThemeHash(diff) {
+	const compact = {};
+	for (const [fullKey, value] of Object.entries(diff)) {
+		const shortKey = KEY_MAP_REVERSE[fullKey] ?? fullKey;
+		compact[shortKey] = value;
+	}
+	return FORMAT_VERSION + toBase64url(encode(compact));
+}
+/**
+* Decode a hash string back into a key-value bag with full key names.
+*
+* Returns partial data -- the consumer is responsible for merging onto
+* its own defaults. Unknown keys are preserved for forward compatibility.
+* Returns an empty object on invalid input (never throws).
+*/
+function decodeThemeHash(hash) {
+	try {
+		if (!hash || hash.length < 2) return {};
+		if (hash[0] !== FORMAT_VERSION) return {};
+		const compact = decode(fromBase64url(hash.slice(1)));
+		if (typeof compact !== "object" || compact === null) return {};
+		const result = {};
+		for (const [key, value] of Object.entries(compact)) {
+			const fullKey = KEY_MAP[key] ?? key;
+			result[fullKey] = value;
+		}
+		return result;
+	} catch {
+		return {};
+	}
+}
+//#endregion
+export { KEY_MAP, KEY_MAP_REVERSE, decodeThemeHash, encodeThemeHash };
+
+//# sourceMappingURL=codec.mjs.map

package/dist/client/theme/codec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.mjs","names":["msgpackEncode","msgpackDecode"],"sources":["../../../src/client/theme/codec.ts"],"sourcesContent":["import { decode as msgpackDecode, encode as msgpackEncode } from \"@msgpack/msgpack\";\n\n/**\n * Loose bag of theme values. The decoder returns whatever keys are present;\n * the consumer merges onto its own defaults. This keeps the format\n * forward/backward compatible: new keys are silently ignored by old decoders,\n * and removed keys are filled from defaults by the consumer.\n */\nexport type ThemeHash = Record<string, unknown>;\n\n// Current format version. Prepended as a single ASCII char before the base64url payload.\nconst FORMAT_VERSION = \"1\";\n\n// ---------------------------------------------------------------------------\n// Short key mapping\n// ---------------------------------------------------------------------------\n\n/** Short key -> full key */\nexport const KEY_MAP: Record<string, string> = {\n  c: \"colorize\",\n  i: \"intensity\",\n  d: \"delight\",\n  r: \"radius\",\n  bf: \"fontBody\",\n  hf: \"fontHeading\",\n  ic: \"iconSet\",\n  cs: \"colorSpace\",\n  dm: \"darkMode\",\n  lc: \"lightColors\",\n  dc: \"darkColors\",\n  br: \"buttonRadius\",\n  cr: \"cardRadius\",\n  ir: \"inputRadius\",\n  mr: \"imageRadius\",\n  sp: \"shadowPreset\",\n  sc: \"shadowColor\",\n  hw: \"headingWeight\",\n  ht: \"headingTracking\",\n  bw: \"bodyWeight\",\n  hx: \"headingTransform\",\n  bdr: \"borderWidth\",\n  oc: \"overlayColor\",\n  of: \"overlayFromOpacity\",\n  ot: \"overlayToOpacity\",\n  hs: \"imageHoverScale\",\n  hd: \"imageHoverDuration\",\n  v: \"variants\",\n  xs: \"componentSet\",\n};\n\n/** Full key -> short key (inverse of KEY_MAP) */\nexport const KEY_MAP_REVERSE: Record<string, string> = Object.fromEntries(\n  Object.entries(KEY_MAP).map(([short, full]) => [full, short]),\n);\n\n// ---------------------------------------------------------------------------\n// Base64url helpers (RFC 4648 §5, no padding)\n// ---------------------------------------------------------------------------\n\nfunction toBase64url(buf: Uint8Array): string {\n  let binary = \"\";\n  for (let i = 0; i < buf.length; i++) {\n    binary += String.fromCharCode(buf[i]!);\n  }\n  return btoa(binary).replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=+$/, \"\");\n}\n\nfunction fromBase64url(str: string): Uint8Array {\n  const base64 = str.replace(/-/g, \"+\").replace(/_/g, \"/\");\n  const padded = base64 + \"=\".repeat((4 - (base64.length % 4)) % 4);\n  const binary = atob(padded);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  return bytes;\n}\n\n// ---------------------------------------------------------------------------\n// Encode / Decode\n// ---------------------------------------------------------------------------\n\n/**\n * Encode a theme state diff into a portable hash string.\n *\n * The input should only contain non-default values. The encoder maps\n * full keys to short keys, packs with MessagePack, and encodes as\n * `<version><base64url>`.\n */\nexport function encodeThemeHash(diff: ThemeHash): string {\n  const compact: Record<string, unknown> = {};\n  for (const [fullKey, value] of Object.entries(diff)) {\n    const shortKey = KEY_MAP_REVERSE[fullKey] ?? fullKey;\n    compact[shortKey] = value;\n  }\n  const packed = msgpackEncode(compact);\n  return FORMAT_VERSION + toBase64url(packed);\n}\n\n/**\n * Decode a hash string back into a key-value bag with full key names.\n *\n * Returns partial data -- the consumer is responsible for merging onto\n * its own defaults. Unknown keys are preserved for forward compatibility.\n * Returns an empty object on invalid input (never throws).\n */\nexport function decodeThemeHash(hash: string): ThemeHash {\n  try {\n    if (!hash || hash.length < 2) return {};\n\n    const version = hash[0];\n    if (version !== FORMAT_VERSION) return {};\n\n    const payload = hash.slice(1);\n    const bytes = fromBase64url(payload);\n    const compact = msgpackDecode(bytes) as Record<string, unknown>;\n\n    if (typeof compact !== \"object\" || compact === null) return {};\n\n    const result: ThemeHash = {};\n    for (const [key, value] of Object.entries(compact)) {\n      const fullKey = KEY_MAP[key] ?? key;\n      result[fullKey] = value;\n    }\n    return result;\n  } catch {\n    return {};\n  }\n}\n"],"mappings":";;AAWA,MAAM,iBAAiB;;AAOvB,MAAa,UAAkC;CAC7C,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,KAAK;CACL,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,GAAG;CACH,IAAI;CACL;;AAGD,MAAa,kBAA0C,OAAO,YAC5D,OAAO,QAAQ,QAAQ,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,MAAM,MAAM,CAAC,CAC9D;AAMD,SAAS,YAAY,KAAyB;CAC5C,IAAI,SAAS;AACb,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,QAAQ,IAC9B,WAAU,OAAO,aAAa,IAAI,GAAI;AAExC,QAAO,KAAK,OAAO,CAAC,QAAQ,OAAO,IAAI,CAAC,QAAQ,OAAO,IAAI,CAAC,QAAQ,OAAO,GAAG;;AAGhF,SAAS,cAAc,KAAyB;CAC9C,MAAM,SAAS,IAAI,QAAQ,MAAM,IAAI,CAAC,QAAQ,MAAM,IAAI;CACxD,MAAM,SAAS,SAAS,IAAI,QAAQ,IAAK,OAAO,SAAS,KAAM,EAAE;CACjE,MAAM,SAAS,KAAK,OAAO;CAC3B,MAAM,QAAQ,IAAI,WAAW,OAAO,OAAO;AAC3C,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,IACjC,OAAM,KAAK,OAAO,WAAW,EAAE;AAEjC,QAAO;;;;;;;;;AAcT,SAAgB,gBAAgB,MAAyB;CACvD,MAAM,UAAmC,EAAE;AAC3C,MAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,KAAK,EAAE;EACnD,MAAM,WAAW,gBAAgB,YAAY;AAC7C,UAAQ,YAAY;;AAGtB,QAAO,iBAAiB,YADTA,OAAc,QAAQ,CACM;;;;;;;;;AAU7C,SAAgB,gBAAgB,MAAyB;AACvD,KAAI;AACF,MAAI,CAAC,QAAQ,KAAK,SAAS,EAAG,QAAO,EAAE;AAGvC,MADgB,KAAK,OACL,eAAgB,QAAO,EAAE;EAIzC,MAAM,UAAUC,OADF,cADE,KAAK,MAAM,EAAE,CACO,CACA;AAEpC,MAAI,OAAO,YAAY,YAAY,YAAY,KAAM,QAAO,EAAE;EAE9D,MAAM,SAAoB,EAAE;AAC5B,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE;GAClD,MAAM,UAAU,QAAQ,QAAQ;AAChC,UAAO,WAAW;;AAEpB,SAAO;SACD;AACN,SAAO,EAAE"}