@vizejs/vite-plugin-musea 0.268.0 → 0.270.0

package/dist/index.d.mts

@@ -3,6 +3,111 @@ import { c as AnalysisApiResponse, l as PaletteApiResponse, n as MuseaA11yRunner
 import { AutogenOptions, AutogenOutput, GeneratedVariant, PropDefinition, generateArtFile, writeArtFile } from "./autogen/index.mjs";
 import { Plugin } from "vite";
 
+//#region src/tokens/parser.d.ts
+/**
+ * Token parsing utilities for Style Dictionary integration.
+ *
+ * Thin native binding for design token files (JSON) and directories.
+ */
+/**
+ * Design token value.
+ */
+interface DesignToken {
+  value: string | number;
+  type?: string;
+  description?: string;
+  attributes?: Record<string, unknown>;
+  $tier?: "primitive" | "semantic";
+  $reference?: string;
+  $resolvedValue?: string | number;
+}
+/**
+ * Token category (e.g., colors, spacing, typography).
+ */
+interface TokenCategory {
+  name: string;
+  tokens: Record<string, DesignToken>;
+  subcategories?: TokenCategory[];
+}
+/**
+ * Style Dictionary output format.
+ */
+interface StyleDictionaryOutput {
+  categories: TokenCategory[];
+  metadata: {
+    name: string;
+    version?: string;
+    generatedAt: string;
+  };
+}
+/**
+ * Configuration for Style Dictionary integration.
+ */
+interface StyleDictionaryConfig {
+  /**
+   * Path to tokens JSON file/directory or Tailwind CSS theme file.
+   */
+  tokensPath: string;
+  /**
+   * Output format for documentation.
+   * @default 'html'
+   */
+  outputFormat?: "html" | "json" | "markdown";
+  /**
+   * Output directory for generated documentation.
+   * @default '.vize/tokens'
+   */
+  outputDir?: string;
+  /**
+   * Custom token transformations.
+   */
+  transforms?: TokenTransform[];
+}
+/**
+ * Token transformation function.
+ */
+type TokenTransform = (token: DesignToken, path: string[]) => DesignToken;
+/**
+ * Parse Style Dictionary tokens file/directory or Tailwind CSS theme variables.
+ */
+declare function parseTokens(tokensPath: string): Promise<TokenCategory[]>;
+//#endregion
+//#region src/tokens/preview.d.ts
+type MuseaTokenPreviewKind = "color" | "spacing" | "fontSize" | "fontWeight" | "lineHeight" | "shadow" | "radius" | "opacity" | "zIndex" | "generic";
+interface MuseaTokenPreviewRule {
+  kind: MuseaTokenPreviewKind;
+  type?: string | string[];
+  pathIncludes?: string | string[];
+  nameIncludes?: string | string[];
+  referencePathIncludes?: string | string[];
+}
+interface MuseaTokenPreviewConfig {
+  /**
+   * User rules are evaluated before Musea's built-in token preview heuristics.
+   * Use `kind: "generic"` to intentionally suppress a preview for matching tokens.
+   */
+  rules?: MuseaTokenPreviewRule[];
+  /** Disable selected preview kinds after custom and built-in rules are evaluated. */
+  disabledKinds?: MuseaTokenPreviewKind[];
+}
+interface ResolvedTokenPreview {
+  kind: MuseaTokenPreviewKind;
+  value: string | number;
+  tokenPath: string;
+  reference?: {
+    path: string;
+    token?: DesignToken;
+    value?: string | number;
+  };
+}
+interface ResolveTokenPreviewInput {
+  tokenPath: string;
+  token: DesignToken;
+  tokenMap?: Record<string, DesignToken>;
+  config?: MuseaTokenPreviewConfig;
+}
+declare function resolveTokenPreview(input: ResolveTokenPreviewInput): ResolvedTokenPreview;
+//#endregion
 //#region src/types/plugin.d.ts
 type MuseaVueVersion = 0.11 | 1 | 2 | "2.7" | 3 | "legacy";
 /**
@@ -86,6 +191,11 @@ interface MuseaOptions {
    * @example 'src/tokens.json', 'src/tokens/', or 'src/styles/main.css'
    */
   tokensPath?: string;
+  /**
+   * Design token preview rules for the gallery.
+   * Custom rules run before Musea's built-in previews.
+   */
+  tokenPreviews?: MuseaTokenPreviewConfig;
   /**
    * Project root that should be treated as the outer boundary for path resolution
    * (notably `tokensPath`). When set, sibling directories of the Vite root that
@@ -137,75 +247,6 @@ interface MuseaOptions {
 //#region src/plugin/index.d.ts
 declare function musea(options?: MuseaOptions): Plugin[];
 //#endregion
-//#region src/tokens/parser.d.ts
-/**
- * Token parsing utilities for Style Dictionary integration.
- *
- * Thin native binding for design token files (JSON) and directories.
- */
-/**
- * Design token value.
- */
-interface DesignToken {
-  value: string | number;
-  type?: string;
-  description?: string;
-  attributes?: Record<string, unknown>;
-  $tier?: "primitive" | "semantic";
-  $reference?: string;
-  $resolvedValue?: string | number;
-}
-/**
- * Token category (e.g., colors, spacing, typography).
- */
-interface TokenCategory {
-  name: string;
-  tokens: Record<string, DesignToken>;
-  subcategories?: TokenCategory[];
-}
-/**
- * Style Dictionary output format.
- */
-interface StyleDictionaryOutput {
-  categories: TokenCategory[];
-  metadata: {
-    name: string;
-    version?: string;
-    generatedAt: string;
-  };
-}
-/**
- * Configuration for Style Dictionary integration.
- */
-interface StyleDictionaryConfig {
-  /**
-   * Path to tokens JSON file/directory or Tailwind CSS theme file.
-   */
-  tokensPath: string;
-  /**
-   * Output format for documentation.
-   * @default 'html'
-   */
-  outputFormat?: "html" | "json" | "markdown";
-  /**
-   * Output directory for generated documentation.
-   * @default '.vize/tokens'
-   */
-  outputDir?: string;
-  /**
-   * Custom token transformations.
-   */
-  transforms?: TokenTransform[];
-}
-/**
- * Token transformation function.
- */
-type TokenTransform = (token: DesignToken, path: string[]) => DesignToken;
-/**
- * Parse Style Dictionary tokens file/directory or Tailwind CSS theme variables.
- */
-declare function parseTokens(tokensPath: string): Promise<TokenCategory[]>;
-//#endregion
 //#region src/tokens/usage.d.ts
 /**
  * Scan art file sources for token value matches in `<style>` blocks.
@@ -264,5 +305,5 @@ declare function generateTokensMarkdown(categories: TokenCategory[]): string;
  */
 declare function processStyleDictionary(config: StyleDictionaryConfig): Promise<StyleDictionaryOutput>;
 //#endregion
-export { type A11yOptions, type A11yResult, type A11ySummary, type AnalysisApiResponse, type ArtFileInfo, type ArtMetadata, type ArtVariant, type AutogenOptions, type AutogenOutput, type CaptureConfig, type CiConfig, type ComparisonConfig, type CsfOutput, type DesignToken, type GeneratedVariant, MuseaA11yRunner, type MuseaOptions, type MuseaTheme, type MuseaThemeColors, MuseaVrtRunner, type PaletteApiResponse, type PropDefinition, type StyleDictionaryConfig, type StyleDictionaryOutput, type TokenCategory, type TokenUsageMap, type ViewportConfig, type VrtOptions, type VrtResult, type VrtSummary, buildTokenMap, musea as default, musea, generateArtFile, generateTokensHtml, generateTokensMarkdown, generateVrtJsonReport, generateVrtReport, parseTokens, processStyleDictionary, resolveReferences, scanTokenUsage, writeArtFile };
+export { type A11yOptions, type A11yResult, type A11ySummary, type AnalysisApiResponse, type ArtFileInfo, type ArtMetadata, type ArtVariant, type AutogenOptions, type AutogenOutput, type CaptureConfig, type CiConfig, type ComparisonConfig, type CsfOutput, type DesignToken, type GeneratedVariant, MuseaA11yRunner, type MuseaOptions, type MuseaTheme, type MuseaThemeColors, type MuseaTokenPreviewConfig, type MuseaTokenPreviewKind, type MuseaTokenPreviewRule, MuseaVrtRunner, type PaletteApiResponse, type PropDefinition, type ResolvedTokenPreview, type StyleDictionaryConfig, type StyleDictionaryOutput, type TokenCategory, type TokenUsageMap, type ViewportConfig, type VrtOptions, type VrtResult, type VrtSummary, buildTokenMap, musea as default, musea, generateArtFile, generateTokensHtml, generateTokensMarkdown, generateVrtJsonReport, generateVrtReport, parseTokens, processStyleDictionary, resolveReferences, resolveTokenPreview, scanTokenUsage, writeArtFile };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/plugin.ts","../src/plugin/index.ts","../src/tokens/parser.ts","../src/tokens/usage.ts","../src/tokens/resolver.ts","../src/tokens/generator.ts"],"mappings":";;;;;;KAEY,eAAA;;;;;UAMK,gBAAA;EACf,SAAA;EACA,WAAA;EACA,UAAA;EACA,UAAA;EACA,MAAA;EACA,WAAA;EACA,cAAA;EACA,YAAA;EACA,IAAA;EACA,aAAA;EACA,SAAA;EACA,MAAA;EACA,YAAA;EACA,OAAA;EACA,KAAA;EACA,IAAA;EACA,OAAA;EACA,MAAA;AAAA;;;;UAMe,UAAA;EARf;EAUA,IAAA;EARA;EAUA,IAAA;EAVM;EAYN,MAAA,EAAQ,gBAAA;AAAA;;;;UAMO,YAAA;EANf;;;;EAWA,OAAA;EAL2B;;;;EAW3B,OAAA;EAyFa;;;;EAnFb,QAAA;EAAA;;;;EAMA,eAAA;EAmBM;;;;EAbN,eAAA;EA0CmD;;;;;;EAlCnD,SAAA;;;;EAKA,GAAA,GAAM,UAAA;EC3Ca;;;;;EDkDnB,UAAA;EClDuD;;;;;AC/BzD;;;;;EF6FE,WAAA;EE1FA;;;;;;;;EFoGA,KAAA,iCAAsC,UAAA,GAAa,UAAA;EE1FvB;;;;;;;;EFoG5B,UAAA;EElGQ;;;;;;AAOV;;;;EFuGE,YAAA;EEtGY;;;;;EF6GZ,UAAA,GAAa,eAAA;AAAA;;;iBCrGC,KAAA,CAAM,OAAA,GAAS,YAAA,GAAoB,MAAA;;;;;;;;;ADzCnD;;UEUiB,WAAA;EACf,KAAA;EACA,IAAA;EACA,WAAA;EACA,UAAA,GAAa,MAAA;EACb,KAAA;EACA,UAAA;EACA,cAAA;AAAA;;;;UAMe,aAAA;EACf,IAAA;EACA,MAAA,EAAQ,MAAA,SAAe,WAAA;EACvB,aAAA,GAAgB,aAAA;AAAA;;;;UAMD,qBAAA;EACf,UAAA,EAAY,aAAA;EACZ,QAAA;IACE,IAAA;IACA,OAAA;IACA,WAAA;EAAA;AAAA;;;;UAOa,qBAAA;EFVf;;;EEcA,UAAA;EFZwB;AAM1B;;;EEYE,YAAA;EF2DsC;;;;EErDtC,SAAA;EFbA;;;EEkBA,UAAA,GAAa,cAAA;AAAA;;;;KAMH,cAAA,IAAkB,KAAA,EAAO,WAAA,EAAa,IAAA,eAAmB,WAAA;;;;iBAK/C,WAAA,CAAY,UAAA,WAAqB,OAAA,CAAQ,aAAA;;;;;;iBCtC/C,cAAA,CACd,QAAA,EAAU,GAAA;EAAc,IAAA;EAAc,QAAA;IAAY,KAAA;IAAe,QAAA;EAAA;AAAA,IACjE,QAAA,EAAU,MAAA,SAAe,WAAA,IACxB,aAAA;;;;;;UCtBc,eAAA;EACf,IAAA;EACA,WAAA;EACA,QAAA;AAAA;;;;UAMe,eAAA;EACf,OAAA;EACA,QAAA;EACA,WAAA;EACA,OAAA,EAAS,eAAA;AAAA;;;;KAMC,aAAA,GAAgB,MAAA,SAAe,eAAA;;;;iBAqB3B,aAAA,CAAc,UAAA,EAAY,aAAA,KAAkB,MAAA,SAAe,WAAA;;;AJ7B3E;iBIoCgB,iBAAA,CACd,UAAA,EAAY,aAAA,IACZ,SAAA,EAAW,MAAA,SAAe,WAAA;;;;;;iBC/BZ,kBAAA,CAAmB,UAAA,EAAY,aAAA;AL/B/C;;;AAAA,iBK+JgB,sBAAA,CAAuB,UAAA,EAAY,aAAA;;;;;iBAQ7B,sBAAA,CACpB,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,qBAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/tokens/parser.ts","../src/tokens/preview.ts","../src/types/plugin.ts","../src/plugin/index.ts","../src/tokens/usage.ts","../src/tokens/resolver.ts","../src/tokens/generator.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { c as createDevSessionToken, d as resolveInside, f as resolveInsideAny, h as validateDevApiRequest, i as generateGalleryScript, l as decodeUrlComponent, m as serializeScriptValue, n as generateGalleryModule, o as HttpError, p as resolveUrlPathInside, r as generateGalleryBody, s as collectRequestBody, u as parseJsonBody } from "./gallery-DIBlUrB6.mjs";
+import { _ as validateDevApiRequest, a as generateDevGlobalsScript, c as HttpError, d as decodeUrlComponent, f as parseJsonBody, g as serializeScriptValue, h as resolveUrlPathInside, i as generateGalleryScript, l as collectRequestBody, m as resolveInsideAny, n as generateGalleryModule, o as generateGalleryGlobalsScript, p as resolveInside, r as generateGalleryBody, u as createDevSessionToken } from "./gallery-qM8Q_21C.mjs";
 import { i as MuseaVrtRunner, n as generateVrtJsonReport, r as generateVrtReport } from "./vrt-Cv1PK1EF.mjs";
 import { t as MuseaA11yRunner } from "./a11y-62l8G1tr.mjs";
 import { n as writeArtFile, t as generateArtFile } from "./autogen-B7_TO0n5.mjs";
@@ -1405,11 +1405,7 @@ function resolveGallerySourceDir() {
 function toViteFsPath(filePath) {
 	return encodeURI(`/@fs${filePath.split(path.sep).join("/")}`);
 }
-function generateDevGlobalsScript(basePath, devSessionToken, themeConfig) {
-	const themeScript = themeConfig ? `window.__MUSEA_THEME_CONFIG__=${serializeScriptValue(themeConfig)};` : "";
-	return `window.__MUSEA_BASE_PATH__=${serializeScriptValue(basePath)};window.__MUSEA_SESSION_TOKEN__=${serializeScriptValue(devSessionToken)};${themeScript}`;
-}
-async function tryLoadSourceGalleryHtml(devServer, url, basePath, devSessionToken, themeConfig) {
+async function tryLoadSourceGalleryHtml(devServer, url, basePath, devSessionToken, themeConfig, tokenPreviewConfig) {
 	const gallerySourceDir = resolveGallerySourceDir();
 	const indexHtmlPath = path.join(gallerySourceDir, "index.html");
 	try {
@@ -1420,12 +1416,12 @@ async function tryLoadSourceGalleryHtml(devServer, url, basePath, devSessionToke
 	const sourceEntryPath = toViteFsPath(path.join(gallerySourceDir, "main.ts"));
 	let html = await fs.promises.readFile(indexHtmlPath, "utf-8");
 	html = html.replace("src=\"./main.ts\"", `src="${sourceEntryPath}"`);
-	html = html.replace("</head>", `<script>${generateDevGlobalsScript(basePath, devSessionToken, themeConfig)}<\/script></head>`);
+	html = html.replace("</head>", `<script>${generateDevGlobalsScript(basePath, devSessionToken, themeConfig, tokenPreviewConfig)}<\/script></head>`);
 	return devServer.transformIndexHtml(url, html);
 }
-async function generateFallbackGalleryHtml(basePath, devSessionToken, themeConfig) {
-	const { generateGalleryHtml } = await import("./gallery-DIBlUrB6.mjs").then((n) => n.t);
-	return generateGalleryHtml(basePath, devSessionToken, themeConfig);
+async function generateFallbackGalleryHtml(basePath, devSessionToken, themeConfig, tokenPreviewConfig) {
+	const { generateGalleryHtml } = await import("./gallery-qM8Q_21C.mjs").then((n) => n.t);
+	return generateGalleryHtml(basePath, devSessionToken, themeConfig, tokenPreviewConfig);
 }
 async function serveGalleryAsset(galleryDistDir, requestUrl, res) {
 	try {
@@ -1458,7 +1454,7 @@ async function serveGalleryAsset(galleryDistDir, requestUrl, res) {
 * - Art module route
 */
 function registerMiddleware(devServer, ctx) {
-	const { basePath, devSessionToken, themeConfig, artFiles } = ctx;
+	const { basePath, devSessionToken, themeConfig, tokenPreviewConfig, artFiles } = ctx;
 	devServer.middlewares.use(basePath, async (req, res, next) => {
 		const url = req.url || "/";
 		if (url === "/" || url === "/index.html" || url.startsWith("/tokens") || url.startsWith("/component/") || url.startsWith("/tests")) {
@@ -1467,18 +1463,18 @@ function registerMiddleware(devServer, ctx) {
 			try {
 				await fs.promises.access(indexHtmlPath);
 				let html = await fs.promises.readFile(indexHtmlPath, "utf-8");
-				html = html.replace("</head>", `<script>${generateDevGlobalsScript(basePath, devSessionToken, themeConfig)}<\/script></head>`);
+				html = html.replace("</head>", `<script>${generateDevGlobalsScript(basePath, devSessionToken, themeConfig, tokenPreviewConfig)}<\/script></head>`);
 				res.setHeader("Content-Type", "text/html");
 				res.end(html);
 				return;
 			} catch {
-				const sourceHtml = await tryLoadSourceGalleryHtml(devServer, url, basePath, devSessionToken, themeConfig);
+				const sourceHtml = await tryLoadSourceGalleryHtml(devServer, url, basePath, devSessionToken, themeConfig, tokenPreviewConfig);
 				if (sourceHtml) {
 					res.setHeader("Content-Type", "text/html");
 					res.end(sourceHtml);
 					return;
 				}
-				const html = await generateFallbackGalleryHtml(basePath, devSessionToken, themeConfig);
+				const html = await generateFallbackGalleryHtml(basePath, devSessionToken, themeConfig, tokenPreviewConfig);
 				res.setHeader("Content-Type", "text/html");
 				res.end(html);
 				return;
@@ -2274,6 +2270,133 @@ async function processStyleDictionary(config) {
 	};
 }
 //#endregion
+//#region src/tokens/preview.ts
+function resolveTokenPreview(input) {
+	const reference = resolveReference(input.token, input.tokenMap);
+	const value = input.token.$resolvedValue ?? reference?.value ?? input.token.value;
+	const candidates = buildCandidates(input.tokenPath, input.token, reference);
+	const kind = resolveCustomKind(candidates, reference?.path, input.config?.rules) ?? inferPreviewKind(candidates, value);
+	return {
+		kind: new Set(input.config?.disabledKinds ?? []).has(kind) ? "generic" : kind,
+		value,
+		tokenPath: input.tokenPath,
+		reference
+	};
+}
+function resolveReference(token, tokenMap) {
+	if (!token.$reference) return void 0;
+	const referencedToken = tokenMap?.[token.$reference];
+	return {
+		path: token.$reference,
+		token: referencedToken,
+		value: referencedToken ? referencedToken.$resolvedValue ?? referencedToken.value : void 0
+	};
+}
+function buildCandidates(tokenPath, token, reference) {
+	const candidates = [{
+		tokenPath,
+		name: pathName(tokenPath),
+		token
+	}];
+	if (reference?.token) candidates.push({
+		tokenPath: reference.path,
+		name: pathName(reference.path),
+		token: reference.token
+	});
+	return candidates;
+}
+function resolveCustomKind(candidates, referencePath, rules) {
+	for (const rule of rules ?? []) if (matchesRule(rule, candidates, referencePath)) return rule.kind;
+}
+function matchesRule(rule, candidates, referencePath) {
+	const checks = [];
+	if (rule.type !== void 0) checks.push(candidates.some((candidate) => typeMatches(candidate, rule.type)));
+	if (rule.pathIncludes !== void 0) checks.push(candidates.some((candidate) => includesAny(candidate.tokenPath, rule.pathIncludes)));
+	if (rule.nameIncludes !== void 0) checks.push(candidates.some((candidate) => includesAny(candidate.name, rule.nameIncludes)));
+	if (rule.referencePathIncludes !== void 0) checks.push(referencePath !== void 0 && includesAny(referencePath, rule.referencePathIncludes));
+	return checks.length > 0 && checks.every(Boolean);
+}
+function inferPreviewKind(candidates, value) {
+	if (hasType(candidates, ["color"]) || isColorValue(value)) return "color";
+	if (hasType(candidates, ["shadow", "box-shadow"]) || hasSignal(candidates, ["shadow", "box-shadow"])) return "shadow";
+	if (hasType(candidates, [
+		"z-index",
+		"zindex",
+		"zIndex"
+	]) || hasSignal(candidates, [
+		"z-index",
+		"zindex",
+		"stacking-order"
+	])) return "zIndex";
+	if (hasType(candidates, ["opacity"]) || hasSignal(candidates, ["opacity", "alpha"])) return "opacity";
+	if (hasType(candidates, [
+		"border-radius",
+		"borderradius",
+		"radius"
+	]) || hasSignal(candidates, [
+		"border-radius",
+		"borderradius",
+		"radius",
+		"round",
+		"rounded"
+	])) return "radius";
+	if (hasType(candidates, ["spacing", "space"]) || hasSignal(candidates, [
+		"spacing",
+		"spasing",
+		"space",
+		"gap",
+		"padding",
+		"margin",
+		"inset"
+	])) return "spacing";
+	if (hasSignal(candidates, [
+		"font-size",
+		"fontsize",
+		"text-size"
+	])) return "fontSize";
+	if (hasType(candidates, ["fontweight", "font-weight"]) || hasSignal(candidates, [
+		"font-weight",
+		"fontweight",
+		"weight"
+	])) return "fontWeight";
+	if (hasType(candidates, ["lineheight", "line-height"]) || hasSignal(candidates, ["line-height", "lineheight"])) return "lineHeight";
+	return "generic";
+}
+function hasType(candidates, terms) {
+	return candidates.some((candidate) => typeMatches(candidate, terms));
+}
+function hasSignal(candidates, terms) {
+	return candidates.some((candidate) => includesAny(candidate.tokenPath, terms) || includesAny(candidate.name, terms) || candidate.token.type !== void 0 && includesAny(candidate.token.type, terms));
+}
+function typeMatches(candidate, expected) {
+	if (!candidate.token.type) return false;
+	return toArray(expected).some((term) => normalize(candidate.token.type) === normalize(term));
+}
+function includesAny(value, expected) {
+	const normalizedValue = normalize(value);
+	const compactValue = compact(normalizedValue);
+	return toArray(expected).some((term) => {
+		const normalizedTerm = normalize(term);
+		return normalizedValue.includes(normalizedTerm) || compactValue.includes(compact(normalizedTerm));
+	});
+}
+function isColorValue(value) {
+	if (typeof value !== "string") return false;
+	return /^(#|rgb\(|rgba\(|hsl\(|hsla\(|oklch\(|oklab\(|lab\(|lch\(|color\()/i.test(value.trim());
+}
+function pathName(tokenPath) {
+	return tokenPath.split(".").at(-1) ?? tokenPath;
+}
+function normalize(value) {
+	return value.trim().toLowerCase().replace(/[_\s]+/g, "-");
+}
+function compact(value) {
+	return value.replace(/[-.]/g, "");
+}
+function toArray(value) {
+	return Array.isArray(value) ? value : [value];
+}
+//#endregion
 //#region src/api-tokens.ts
 function resolveTokensPath(ctx) {
 	const allowedRoots = [ctx.config.root, ...ctx.scanRoots];
@@ -3423,8 +3546,12 @@ function generateStaticPreviewHtml(art, variantName, previewId, basePath, runtim
 </html>`;
 }
 function injectStaticGlobals(html, ctx, payload) {
-	const themeScript = ctx.themeConfig ? `window.__MUSEA_THEME_CONFIG__=${serializeScriptValue(ctx.themeConfig)};` : "";
-	const script = `<script>window.__MUSEA_BASE_PATH__=${serializeScriptValue(ctx.basePath)};window.__MUSEA_STATIC__=true;window.__MUSEA_STATIC_PREVIEWS__=${serializeScriptValue(payload.previews)};${themeScript}<\/script>`;
+	const script = `<script>${generateGalleryGlobalsScript({
+		basePath: ctx.basePath,
+		staticPreviews: payload.previews,
+		themeConfig: ctx.themeConfig,
+		tokenPreviewConfig: ctx.tokenPreviewConfig
+	})}<\/script>`;
 	return html.includes("</head>") ? html.replace("</head>", `${script}</head>`) : `${script}${html}`;
 }
 function rewriteGalleryBase(html, basePath) {
@@ -3631,6 +3758,7 @@ function musea(options = {}) {
 	const storybookOutDir = options.storybookOutDir ?? ".storybook/stories";
 	let inlineArt = options.inlineArt ?? false;
 	const tokensPath = options.tokensPath;
+	let tokenPreviewConfig = options.tokenPreviews;
 	const projectRootOption = options.projectRoot;
 	const themeConfig = buildThemeConfig(options.theme);
 	const previewCss = options.previewCss ?? [];
@@ -3684,6 +3812,7 @@ function musea(options = {}) {
 				if (!options.basePath && mc.basePath) basePath = mc.basePath;
 				if (options.storybookCompat === void 0 && mc.storybookCompat !== void 0) storybookCompat = mc.storybookCompat;
 				if (options.inlineArt === void 0 && mc.inlineArt !== void 0) inlineArt = mc.inlineArt;
+				if (options.tokenPreviews === void 0 && mc.tokenPreviews !== void 0) tokenPreviewConfig = mc.tokenPreviews;
 			}
 			vueVersion = resolveStaticPreviewVueVersion(vueVersion, resolvedConfig.plugins);
 			virtualState.basePath = basePath;
@@ -3699,6 +3828,7 @@ function musea(options = {}) {
 				basePath,
 				devSessionToken,
 				themeConfig,
+				tokenPreviewConfig,
 				artFiles,
 				scanRoots,
 				resolvedPreviewCss,
@@ -3797,7 +3927,8 @@ function musea(options = {}) {
 				resolvedPreviewCss,
 				resolvedPreviewSetup,
 				devSessionToken,
-				themeConfig
+				themeConfig,
+				tokenPreviewConfig
 			});
 		},
 		async transform(code, id) {
@@ -3826,6 +3957,6 @@ function resolveProjectRoot(projectRoot, viteRoot) {
 //#region src/index.ts
 var src_default = musea;
 //#endregion
-export { MuseaA11yRunner, MuseaVrtRunner, buildTokenMap, src_default as default, generateArtFile, generateTokensHtml, generateTokensMarkdown, generateVrtJsonReport, generateVrtReport, musea, parseTokens, processStyleDictionary, resolveReferences, scanTokenUsage, writeArtFile };
+export { MuseaA11yRunner, MuseaVrtRunner, buildTokenMap, src_default as default, generateArtFile, generateTokensHtml, generateTokensMarkdown, generateVrtJsonReport, generateVrtReport, musea, parseTokens, processStyleDictionary, resolveReferences, resolveTokenPreview, scanTokenUsage, writeArtFile };
 
 //# sourceMappingURL=index.mjs.map