@unpunnyfuns/swatchbook-addon 0.13.1 → 0.14.1

package/dist/{constants-B3vYm529.mjs → constants-DhgRF7SI.mjs}

@@ -10,6 +10,17 @@ const AXES_GLOBAL_KEY = "swatchbookAxes";
 const COLOR_FORMAT_GLOBAL_KEY = "swatchbookColorFormat";
 const VIRTUAL_MODULE_ID = "virtual:swatchbook/tokens";
 const RESOLVED_VIRTUAL_MODULE_ID = `\0${VIRTUAL_MODULE_ID}`;
+/**
+* Aggregate virtual module the addon's preview always imports. Its body
+* is a sequence of side-effect imports — one per integration that
+* declared `virtualModule.autoInject: true`. Integrations contributing
+* global stylesheets (Tailwind's `@theme` block, a rules-heavy CSS
+* file) can opt into this path so consumers never hand-write an
+* `import 'virtual:swatchbook/…'` line themselves; the body is empty
+* when no integration opts in.
+*/
+const INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID = "virtual:swatchbook/integration-side-effects";
+const RESOLVED_INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID = `\0${INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID}`;
 const STYLE_ELEMENT_ID = "swatchbook-tokens";
 /** Channel event: preview → manager, carries theme list + mode. */
 const INIT_EVENT = "swatchbook/init";
@@ -34,6 +45,6 @@ const TOKENS_UPDATED_EVENT = "swatchbook/tokens-updated";
 * plugin doesn't need a Storybook-channel dependency. */
 const HMR_EVENT = "swatchbook/tokens-updated";
 //#endregion
-export { HMR_EVENT as a, PARAM_KEY as c, STYLE_ELEMENT_ID as d, TOKENS_UPDATED_EVENT as f, GLOBAL_KEY as i, PREVIEW_MOUSEDOWN_EVENT as l, VIRTUAL_MODULE_ID as m, AXES_GLOBAL_KEY as n, INIT_EVENT as o, TOOL_ID as p, COLOR_FORMAT_GLOBAL_KEY as r, INIT_REQUEST_EVENT as s, ADDON_ID as t, RESOLVED_VIRTUAL_MODULE_ID as u };
+export { HMR_EVENT as a, INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID as c, RESOLVED_INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID as d, RESOLVED_VIRTUAL_MODULE_ID as f, VIRTUAL_MODULE_ID as g, TOOL_ID as h, GLOBAL_KEY as i, PARAM_KEY as l, TOKENS_UPDATED_EVENT as m, AXES_GLOBAL_KEY as n, INIT_EVENT as o, STYLE_ELEMENT_ID as p, COLOR_FORMAT_GLOBAL_KEY as r, INIT_REQUEST_EVENT as s, ADDON_ID as t, PREVIEW_MOUSEDOWN_EVENT as u };
 
-//# sourceMappingURL=constants-B3vYm529.mjs.map
+//# sourceMappingURL=constants-DhgRF7SI.mjs.map

package/dist/constants-DhgRF7SI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-DhgRF7SI.mjs","names":[],"sources":["../src/constants.ts"],"sourcesContent":["export const ADDON_ID = 'swatchbook';\nexport const TOOL_ID = `${ADDON_ID}/theme-switcher`;\nexport const PARAM_KEY = 'swatchbook';\n/** Canonical active-theme global: composed permutation ID (string). Read by toolbar, panel, blocks. */\nexport const GLOBAL_KEY = 'swatchbookTheme';\n/** Tuple companion: `Record<axisName, contextName>`. Optional — when present, takes precedence over the string global. */\nexport const AXES_GLOBAL_KEY = 'swatchbookAxes';\n/** Display-only color format for blocks (`hex` | `rgb` | `hsl` | `oklch` | `raw`). Emitted CSS is unaffected. */\nexport const COLOR_FORMAT_GLOBAL_KEY = 'swatchbookColorFormat';\n\nexport const VIRTUAL_MODULE_ID = 'virtual:swatchbook/tokens';\nexport const RESOLVED_VIRTUAL_MODULE_ID = `\\0${VIRTUAL_MODULE_ID}`;\n\n/**\n * Aggregate virtual module the addon's preview always imports. Its body\n * is a sequence of side-effect imports — one per integration that\n * declared `virtualModule.autoInject: true`. Integrations contributing\n * global stylesheets (Tailwind's `@theme` block, a rules-heavy CSS\n * file) can opt into this path so consumers never hand-write an\n * `import 'virtual:swatchbook/…'` line themselves; the body is empty\n * when no integration opts in.\n */\nexport const INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID = 'virtual:swatchbook/integration-side-effects';\nexport const RESOLVED_INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID = `\\0${INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID}`;\n\nexport const STYLE_ELEMENT_ID = 'swatchbook-tokens';\n\n/** Channel event: preview → manager, carries theme list + mode. */\nexport const INIT_EVENT = 'swatchbook/init';\n/** Channel event: manager → preview, asks preview to re-emit INIT_EVENT.\n * Covers the race where the manager subscribes after the preview's\n * initial broadcast — without it the toolbar stays in \"loading…\" until\n * the user triggers anything that re-fires INIT_EVENT. */\nexport const INIT_REQUEST_EVENT = 'swatchbook/init-request';\n/** Channel event: preview → manager, fires once per `mousedown` on the\n * preview document. The toolbar popover listens for it so clicks landing\n * inside the preview iframe close the popover — a plain document-level\n * listener on the manager can't see iframe events. */\nexport const PREVIEW_MOUSEDOWN_EVENT = 'swatchbook/preview-mousedown';\n\n/** Channel event: preview → blocks, carries the fresh virtual-module\n * payload after a dev-time token refresh so blocks can re-render in\n * place without a full iframe reload. Fired by the preview in response\n * to the `HMR_EVENT` below. */\nexport const TOKENS_UPDATED_EVENT = 'swatchbook/tokens-updated';\n\n/** Custom Vite HMR event: plugin → preview. Preview forwards it to the\n * Storybook channel as {@link TOKENS_UPDATED_EVENT} so blocks can\n * update their snapshot. Kept distinct from the channel event so the\n * plugin doesn't need a Storybook-channel dependency. */\nexport const HMR_EVENT = 'swatchbook/tokens-updated';\n"],"mappings":";AAAA,MAAa,WAAW;AACxB,MAAa,UAAU,GAAG,SAAS;AACnC,MAAa,YAAY;;AAEzB,MAAa,aAAa;;AAE1B,MAAa,kBAAkB;;AAE/B,MAAa,0BAA0B;AAEvC,MAAa,oBAAoB;AACjC,MAAa,6BAA6B,KAAK;;;;;;;;;;AAW/C,MAAa,sCAAsC;AACnD,MAAa,+CAA+C,KAAK;AAEjE,MAAa,mBAAmB;;AAGhC,MAAa,aAAa;;;;;AAK1B,MAAa,qBAAqB;;;;;AAKlC,MAAa,0BAA0B;;;;;AAMvC,MAAa,uBAAuB;;;;;AAMpC,MAAa,YAAY"}

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { i as preview_exports } from "./preview-hz8hF3q0.mjs";
-import { c as PARAM_KEY, i as GLOBAL_KEY, m as VIRTUAL_MODULE_ID, n as AXES_GLOBAL_KEY, t as ADDON_ID } from "./constants-B3vYm529.mjs";
+import { i as preview_exports } from "./preview-C_zsIP5A.mjs";
+import { g as VIRTUAL_MODULE_ID, i as GLOBAL_KEY, l as PARAM_KEY, n as AXES_GLOBAL_KEY, t as ADDON_ID } from "./constants-DhgRF7SI.mjs";
 import { definePreviewAddon } from "storybook/internal/csf";
 export * from "@unpunnyfuns/swatchbook-blocks";
 export * from "@unpunnyfuns/swatchbook-switcher";

package/dist/manager.mjs

@@ -1,4 +1,4 @@
-import { i as GLOBAL_KEY, l as PREVIEW_MOUSEDOWN_EVENT, n as AXES_GLOBAL_KEY, o as INIT_EVENT, p as TOOL_ID, r as COLOR_FORMAT_GLOBAL_KEY, s as INIT_REQUEST_EVENT, t as ADDON_ID } from "./constants-B3vYm529.mjs";
+import { h as TOOL_ID, i as GLOBAL_KEY, n as AXES_GLOBAL_KEY, o as INIT_EVENT, r as COLOR_FORMAT_GLOBAL_KEY, s as INIT_REQUEST_EVENT, t as ADDON_ID, u as PREVIEW_MOUSEDOWN_EVENT } from "./constants-DhgRF7SI.mjs";
 import React, { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { ThemeSwitcher } from "@unpunnyfuns/swatchbook-switcher";
 import { IconButton, WithTooltipPure } from "storybook/internal/components";

package/dist/preset.mjs

@@ -1,4 +1,4 @@
-import { a as HMR_EVENT, u as RESOLVED_VIRTUAL_MODULE_ID } from "./constants-B3vYm529.mjs";
+import { a as HMR_EVENT, d as RESOLVED_INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID, f as RESOLVED_VIRTUAL_MODULE_ID } from "./constants-DhgRF7SI.mjs";
 import { mkdir, writeFile } from "node:fs/promises";
 import { basename, dirname, isAbsolute, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -26,10 +26,13 @@ function swatchbookTokensPlugin({ config, cwd, integrations = [] }) {
 	}
 	/** Map of resolvedId → integration, indexed once. */
 	const integrationById = /* @__PURE__ */ new Map();
+	/** Virtual IDs the preview auto-imports as side effects (global CSS). */
+	const autoInjectIds = [];
 	for (const integration of integrations) {
 		const vm = integration.virtualModule;
 		if (!vm) continue;
 		integrationById.set(resolvedId(vm.virtualId), integration);
+		if (vm.autoInject) autoInjectIds.push(vm.virtualId);
 	}
 	return {
 		name: "swatchbook:virtual-tokens",
@@ -39,10 +42,12 @@ function swatchbookTokensPlugin({ config, cwd, integrations = [] }) {
 		},
 		resolveId(id) {
 			if (id === "virtual:swatchbook/tokens") return RESOLVED_VIRTUAL_MODULE_ID;
+			if (id === "virtual:swatchbook/integration-side-effects") return RESOLVED_INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID;
 			for (const integration of integrations) if (integration.virtualModule?.virtualId === id) return resolvedId(integration.virtualModule.virtualId);
 			return null;
 		},
 		load(id) {
+			if (id === RESOLVED_INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID) return autoInjectIds.map((vid) => `import ${JSON.stringify(vid)};`).join("\n");
 			const integration = integrationById.get(id);
 			if (integration?.virtualModule) {
 				if (!project) return "";

package/dist/preset.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"preset.mjs","names":["fsWatch"],"sources":["../src/virtual/plugin.ts","../src/preset.ts"],"sourcesContent":["import type { Config, Project, SwatchbookIntegration } from '@unpunnyfuns/swatchbook-core';\nimport { loadProject, projectCss } from '@unpunnyfuns/swatchbook-core';\nimport { type FSWatcher, watch as fsWatch } from 'node:fs';\nimport { basename, dirname, isAbsolute, resolve as resolvePath } from 'node:path';\nimport picomatch from 'picomatch';\nimport type { Plugin } from 'vite';\nimport { HMR_EVENT, RESOLVED_VIRTUAL_MODULE_ID, VIRTUAL_MODULE_ID } from '#/constants.ts';\n\nexport interface SwatchbookPluginOptions {\n  config: Config;\n  cwd: string;\n  /** Display-side integrations — each may contribute a virtual module the preview imports. */\n  integrations?: readonly SwatchbookIntegration[];\n}\n\n/** `\\0<virtualId>` — Vite convention for resolved virtual module IDs. */\nfunction resolvedId(virtualId: string): string {\n  return `\\0${virtualId}`;\n}\n\n/**\n * Vite plugin that serves the virtual `virtual:swatchbook/tokens` module —\n * a single source of truth for themes, resolved token maps, per-theme CSS,\n * and diagnostics. Watches the token files + resolver for changes and\n * invalidates the module so HMR reloads the preview with fresh data.\n */\nexport function swatchbookTokensPlugin({\n  config,\n  cwd,\n  integrations = [],\n}: SwatchbookPluginOptions): Plugin {\n  let project: Project | undefined;\n  let css = '';\n\n  async function refresh(): Promise<void> {\n    project = await loadProject(config, cwd);\n    css = projectCss(project);\n  }\n\n  /** Map of resolvedId → integration, indexed once. */\n  const integrationById = new Map<string, SwatchbookIntegration>();\n  for (const integration of integrations) {\n    const vm = integration.virtualModule;\n    if (!vm) continue;\n    integrationById.set(resolvedId(vm.virtualId), integration);\n  }\n\n  return {\n    name: 'swatchbook:virtual-tokens',\n    enforce: 'pre',\n\n    async buildStart() {\n      await refresh();\n    },\n\n    resolveId(id) {\n      if (id === VIRTUAL_MODULE_ID) return RESOLVED_VIRTUAL_MODULE_ID;\n      for (const integration of integrations) {\n        if (integration.virtualModule?.virtualId === id) {\n          return resolvedId(integration.virtualModule.virtualId);\n        }\n      }\n      return null;\n    },\n\n    load(id) {\n      const integration = integrationById.get(id);\n      if (integration?.virtualModule) {\n        if (!project) return '';\n        return integration.virtualModule.render(project);\n      }\n      if (id !== RESOLVED_VIRTUAL_MODULE_ID) return null;\n      if (!project) return 'export default null;';\n      // Emit a typed ESM module. Values are JSON-stringified for stability.\n      return [\n        `/* swatchbook virtual module — generated */`,\n        `export const axes = ${JSON.stringify(project.axes)};`,\n        `export const presets = ${JSON.stringify(project.presets)};`,\n        `export const disabledAxes = ${JSON.stringify(project.disabledAxes)};`,\n        `export const themes = ${JSON.stringify(project.themes)};`,\n        `export const defaultTheme = ${JSON.stringify(project.themes[0]?.name ?? null)};`,\n        `export const themesResolved = ${JSON.stringify(project.themesResolved)};`,\n        `export const diagnostics = ${JSON.stringify(project.diagnostics)};`,\n        `export const css = ${JSON.stringify(css)};`,\n        `export const cssVarPrefix = ${JSON.stringify(config.cssVarPrefix ?? '')};`,\n      ].join('\\n');\n    },\n\n    async configureServer(server) {\n      // `configureServer` fires before `buildStart` in Vite's plugin\n      // lifecycle, so `project` is still undefined when consumers only\n      // set `config.resolver` (no `tokens` glob). Force an initial load\n      // here so the watcher setup below sees a populated `sourceFiles`\n      // list — otherwise only the resolver file itself gets watched,\n      // and saves to any `$ref` target silently drop.\n      if (!project) await refresh();\n\n      /**\n       * Editors typically emit two or three filesystem events per save\n       * (atomic rename + rewrite + metadata). A 100 ms trailing debounce\n       * coalesces those into a single reload while staying well under\n       * user-perceptible latency.\n       */\n      let pending: ReturnType<typeof setTimeout> | null = null;\n      const invalidate = (): void => {\n        if (pending) clearTimeout(pending);\n        pending = setTimeout(() => {\n          pending = null;\n          void (async () => {\n            await refresh();\n            if (!project) return;\n            const tokenCount = Object.keys(\n              project.themesResolved[project.themes[0]?.name ?? ''] ?? {},\n            ).length;\n            const diagCount = project.diagnostics.length;\n            server.config.logger.info(\n              `\\x1b[36m[swatchbook]\\x1b[0m tokens reloaded — ${tokenCount} tokens, ${diagCount} diagnostic${diagCount === 1 ? '' : 's'}`,\n              { clear: false, timestamp: true },\n            );\n            const mod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_MODULE_ID);\n            if (mod) server.moduleGraph.invalidateModule(mod);\n            // Invalidate every integration-contributed virtual module so\n            // its body re-renders against the fresh project on the next\n            // request.\n            for (const resolvedIntegrationId of integrationById.keys()) {\n              const m = server.moduleGraph.getModuleById(resolvedIntegrationId);\n              if (m) server.moduleGraph.invalidateModule(m);\n            }\n            /**\n             * Send the fresh snapshot as a custom HMR event instead of a\n             * full-reload. The preview subscribes and re-broadcasts to\n             * blocks via the Storybook channel so the React tree\n             * re-renders in place without losing toolbar / args / scroll\n             * state. Field shape matches the INIT_EVENT payload so the\n             * preview can hand it straight through.\n             */\n            server.ws.send({\n              type: 'custom',\n              event: HMR_EVENT,\n              data: {\n                axes: project.axes,\n                disabledAxes: project.disabledAxes,\n                presets: project.presets,\n                themes: project.themes,\n                defaultTheme: project.themes[0]?.name ?? null,\n                themesResolved: project.themesResolved,\n                diagnostics: project.diagnostics,\n                css,\n                cssVarPrefix: config.cssVarPrefix ?? '',\n              },\n            });\n          })();\n        }, 100);\n      };\n\n      /**\n       * Watch each source file's *parent directory* rather than the file\n       * itself. File-level `fs.watch` is fragile: atomic-save editors\n       * unlink the old inode and write a new one, so the original\n       * watcher either fires a one-shot 'rename' and goes deaf, or on\n       * some platforms loops on ghost events for the old inode. Watching\n       * the dir sidesteps both — the dir inode is stable across the\n       * rename dance — and filename filtering keeps event volume low.\n       *\n       * Vite's `server.watcher` still wouldn't carry these events across\n       * pnpm symlink boundaries, so we keep running our own watchers.\n       */\n      const byDir = new Map<string, Set<string>>();\n      for (const file of project?.sourceFiles ?? []) {\n        const dir = dirname(file);\n        const set = byDir.get(dir) ?? new Set<string>();\n        set.add(basename(file));\n        byDir.set(dir, set);\n      }\n\n      const fileWatchers: FSWatcher[] = [];\n      for (const [dir, names] of byDir) {\n        try {\n          const w = fsWatch(dir, { persistent: false }, (eventType, filename) => {\n            if (!filename) return;\n            if (!names.has(filename)) return;\n            if (eventType === 'change' || eventType === 'rename') invalidate();\n          });\n          fileWatchers.push(w);\n        } catch {\n          // unwatchable dir — skip. Next loadProject pass will report it.\n        }\n      }\n      server.httpServer?.once('close', () => {\n        for (const w of fileWatchers) w.close();\n      });\n    },\n  };\n}\n\n/**\n * Collect the set of filesystem paths the dev server should watch for\n * HMR. When `config.tokens` is set, use its globs (stripped to their\n * base directories) — users opt in to broader watching this way. When\n * absent, use the resolver file + every `$ref` target it pulled in, as\n * tracked on `project.sourceFiles` — which stays correct as the resolver\n * evolves without requiring a parallel `tokens` glob.\n */\n/** @internal Exported for tests; not part of the public API. */\nexport function collectWatchPaths(\n  config: Config,\n  project: Project | undefined,\n  cwd: string,\n): string[] {\n  const paths: string[] = [];\n  if (config.tokens && config.tokens.length > 0) {\n    for (const glob of config.tokens) {\n      // `picomatch.scan` yields the longest literal prefix before any glob\n      // metachar, so it handles brace expansion, nested globstars, and the\n      // other shapes the hand-rolled regex missed.\n      const { base } = picomatch.scan(glob);\n      paths.push(resolveFromCwd(base || '.', cwd));\n    }\n  } else if (project?.sourceFiles) {\n    for (const file of project.sourceFiles) paths.push(dirname(file));\n  }\n  if (config.resolver) paths.push(resolveFromCwd(config.resolver, cwd));\n  return [...new Set(paths)];\n}\n\nfunction resolveFromCwd(p: string, cwd: string): string {\n  if (isAbsolute(p)) return p;\n  return resolvePath(cwd, p);\n}\n","import { mkdir, writeFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, resolve } from 'node:path';\nimport { fileURLToPath, pathToFileURL } from 'node:url';\nimport type { Config, Project } from '@unpunnyfuns/swatchbook-core';\nimport { loadProject } from '@unpunnyfuns/swatchbook-core';\nimport { createJiti } from 'jiti';\nimport type { InlineConfig } from 'vite';\nimport type { AddonOptions } from '#/options.ts';\nimport { swatchbookTokensPlugin } from '#/virtual/plugin.ts';\n\ninterface PresetOptions extends AddonOptions {\n  /** Storybook injects this — the `.storybook` directory absolute path. */\n  configDir: string;\n}\n\n/**\n * Storybook preset entry. Called by Storybook at config time; extends Vite's\n * plugin list with our virtual-module plugin so the preview can import\n * `virtual:swatchbook/tokens`. Also writes the typed token-path codegen so\n * `useToken()` autocompletes against the loaded project.\n */\nexport async function viteFinal(\n  viteConfig: InlineConfig,\n  options: PresetOptions,\n): Promise<InlineConfig> {\n  const { config, cwd } = await resolveConfig(options);\n\n  // Codegen runs once at Vite startup. The virtual module plugin still\n  // owns the live reload path via its HMR watcher; this file just gives\n  // TS autocomplete for `useToken('…')` in consumer stories.\n  await writeTokenCodegen(config, cwd, options);\n\n  const plugins = Array.isArray(viteConfig.plugins) ? [...viteConfig.plugins] : [];\n  plugins.push(\n    swatchbookTokensPlugin({\n      config,\n      cwd,\n      ...(options.integrations !== undefined && { integrations: options.integrations }),\n    }),\n  );\n\n  return { ...viteConfig, plugins };\n}\n\n/** Storybook appends this module into the manager bundle so our toolbar tool registers. */\nexport function managerEntries(entry: string[] = []): string[] {\n  const managerUrl = import.meta.resolve('@unpunnyfuns/swatchbook-addon/manager');\n  return [...entry, fileURLToPath(managerUrl)];\n}\n\nasync function resolveConfig(options: PresetOptions): Promise<{ config: Config; cwd: string }> {\n  const projectRoot = resolve(options.configDir, '..');\n\n  if (options.config) {\n    return { config: options.config, cwd: projectRoot };\n  }\n\n  const path = options.configPath ?? 'swatchbook.config.ts';\n  const absolute = isAbsolute(path) ? path : resolve(options.configDir, path);\n\n  const jiti = createJiti(pathToFileURL(options.configDir).href, {\n    interopDefault: true,\n    moduleCache: false,\n  });\n  const loaded = (await jiti.import(absolute, { default: true })) as Config;\n\n  // If the config file isn't at projectRoot, still resolve globs from its dir.\n  const cwd = dirname(absolute);\n  return { config: loaded, cwd };\n}\n\nasync function writeTokenCodegen(\n  config: Config,\n  cwd: string,\n  options: PresetOptions,\n): Promise<void> {\n  const project = await loadProject(config, cwd);\n  const projectRoot = resolve(options.configDir, '..');\n  const outDir = resolve(projectRoot, config.outDir ?? '.swatchbook');\n  await mkdir(outDir, { recursive: true });\n  const content = renderTokenTypes(project);\n  await writeFile(resolve(outDir, 'tokens.d.ts'), content);\n}\n\n/** @internal Exported for tests; not part of the public API. */\nexport function renderTokenTypes(project: Project): string {\n  const paths = new Set<string>();\n  for (const theme of project.themes) {\n    const tokens = project.themesResolved[theme.name];\n    if (!tokens) continue;\n    for (const path of Object.keys(tokens)) paths.add(path);\n  }\n  const sorted = [...paths].toSorted();\n  const tokenEntries = sorted.map((p) => `    ${JSON.stringify(p)}: string;`);\n  const themeUnion = project.themes.map((t) => JSON.stringify(t.name)).join(' | ') || 'string';\n\n  return [\n    '// Generated by @unpunnyfuns/swatchbook-addon. Do not edit.',\n    \"declare module '@unpunnyfuns/swatchbook-addon/hooks' {\",\n    '  interface SwatchbookTokenMap {',\n    ...tokenEntries,\n    '  }',\n    '',\n    `  export type SwatchbookThemeName = ${themeUnion};`,\n    '}',\n    '',\n  ].join('\\n');\n}\n"],"mappings":"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"}
+{"version":3,"file":"preset.mjs","names":["fsWatch"],"sources":["../src/virtual/plugin.ts","../src/preset.ts"],"sourcesContent":["import type { Config, Project, SwatchbookIntegration } from '@unpunnyfuns/swatchbook-core';\nimport { loadProject, projectCss } from '@unpunnyfuns/swatchbook-core';\nimport { type FSWatcher, watch as fsWatch } from 'node:fs';\nimport { basename, dirname, isAbsolute, resolve as resolvePath } from 'node:path';\nimport picomatch from 'picomatch';\nimport type { Plugin } from 'vite';\nimport {\n  HMR_EVENT,\n  INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID,\n  RESOLVED_INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID,\n  RESOLVED_VIRTUAL_MODULE_ID,\n  VIRTUAL_MODULE_ID,\n} from '#/constants.ts';\n\nexport interface SwatchbookPluginOptions {\n  config: Config;\n  cwd: string;\n  /** Display-side integrations — each may contribute a virtual module the preview imports. */\n  integrations?: readonly SwatchbookIntegration[];\n}\n\n/** `\\0<virtualId>` — Vite convention for resolved virtual module IDs. */\nfunction resolvedId(virtualId: string): string {\n  return `\\0${virtualId}`;\n}\n\n/**\n * Vite plugin that serves the virtual `virtual:swatchbook/tokens` module —\n * a single source of truth for themes, resolved token maps, per-theme CSS,\n * and diagnostics. Watches the token files + resolver for changes and\n * invalidates the module so HMR reloads the preview with fresh data.\n */\nexport function swatchbookTokensPlugin({\n  config,\n  cwd,\n  integrations = [],\n}: SwatchbookPluginOptions): Plugin {\n  let project: Project | undefined;\n  let css = '';\n\n  async function refresh(): Promise<void> {\n    project = await loadProject(config, cwd);\n    css = projectCss(project);\n  }\n\n  /** Map of resolvedId → integration, indexed once. */\n  const integrationById = new Map<string, SwatchbookIntegration>();\n  /** Virtual IDs the preview auto-imports as side effects (global CSS). */\n  const autoInjectIds: string[] = [];\n  for (const integration of integrations) {\n    const vm = integration.virtualModule;\n    if (!vm) continue;\n    integrationById.set(resolvedId(vm.virtualId), integration);\n    if (vm.autoInject) autoInjectIds.push(vm.virtualId);\n  }\n\n  return {\n    name: 'swatchbook:virtual-tokens',\n    enforce: 'pre',\n\n    async buildStart() {\n      await refresh();\n    },\n\n    resolveId(id) {\n      if (id === VIRTUAL_MODULE_ID) return RESOLVED_VIRTUAL_MODULE_ID;\n      if (id === INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID) {\n        return RESOLVED_INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID;\n      }\n      for (const integration of integrations) {\n        if (integration.virtualModule?.virtualId === id) {\n          return resolvedId(integration.virtualModule.virtualId);\n        }\n      }\n      return null;\n    },\n\n    load(id) {\n      if (id === RESOLVED_INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID) {\n        // Aggregate side-effect imports. Empty when no integration\n        // opted in — still a valid ESM module, just a no-op.\n        return autoInjectIds.map((vid) => `import ${JSON.stringify(vid)};`).join('\\n');\n      }\n      const integration = integrationById.get(id);\n      if (integration?.virtualModule) {\n        if (!project) return '';\n        return integration.virtualModule.render(project);\n      }\n      if (id !== RESOLVED_VIRTUAL_MODULE_ID) return null;\n      if (!project) return 'export default null;';\n      // Emit a typed ESM module. Values are JSON-stringified for stability.\n      return [\n        `/* swatchbook virtual module — generated */`,\n        `export const axes = ${JSON.stringify(project.axes)};`,\n        `export const presets = ${JSON.stringify(project.presets)};`,\n        `export const disabledAxes = ${JSON.stringify(project.disabledAxes)};`,\n        `export const themes = ${JSON.stringify(project.themes)};`,\n        `export const defaultTheme = ${JSON.stringify(project.themes[0]?.name ?? null)};`,\n        `export const themesResolved = ${JSON.stringify(project.themesResolved)};`,\n        `export const diagnostics = ${JSON.stringify(project.diagnostics)};`,\n        `export const css = ${JSON.stringify(css)};`,\n        `export const cssVarPrefix = ${JSON.stringify(config.cssVarPrefix ?? '')};`,\n      ].join('\\n');\n    },\n\n    async configureServer(server) {\n      // `configureServer` fires before `buildStart` in Vite's plugin\n      // lifecycle, so `project` is still undefined when consumers only\n      // set `config.resolver` (no `tokens` glob). Force an initial load\n      // here so the watcher setup below sees a populated `sourceFiles`\n      // list — otherwise only the resolver file itself gets watched,\n      // and saves to any `$ref` target silently drop.\n      if (!project) await refresh();\n\n      /**\n       * Editors typically emit two or three filesystem events per save\n       * (atomic rename + rewrite + metadata). A 100 ms trailing debounce\n       * coalesces those into a single reload while staying well under\n       * user-perceptible latency.\n       */\n      let pending: ReturnType<typeof setTimeout> | null = null;\n      const invalidate = (): void => {\n        if (pending) clearTimeout(pending);\n        pending = setTimeout(() => {\n          pending = null;\n          void (async () => {\n            await refresh();\n            if (!project) return;\n            const tokenCount = Object.keys(\n              project.themesResolved[project.themes[0]?.name ?? ''] ?? {},\n            ).length;\n            const diagCount = project.diagnostics.length;\n            server.config.logger.info(\n              `\\x1b[36m[swatchbook]\\x1b[0m tokens reloaded — ${tokenCount} tokens, ${diagCount} diagnostic${diagCount === 1 ? '' : 's'}`,\n              { clear: false, timestamp: true },\n            );\n            const mod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_MODULE_ID);\n            if (mod) server.moduleGraph.invalidateModule(mod);\n            // Invalidate every integration-contributed virtual module so\n            // its body re-renders against the fresh project on the next\n            // request.\n            for (const resolvedIntegrationId of integrationById.keys()) {\n              const m = server.moduleGraph.getModuleById(resolvedIntegrationId);\n              if (m) server.moduleGraph.invalidateModule(m);\n            }\n            /**\n             * Send the fresh snapshot as a custom HMR event instead of a\n             * full-reload. The preview subscribes and re-broadcasts to\n             * blocks via the Storybook channel so the React tree\n             * re-renders in place without losing toolbar / args / scroll\n             * state. Field shape matches the INIT_EVENT payload so the\n             * preview can hand it straight through.\n             */\n            server.ws.send({\n              type: 'custom',\n              event: HMR_EVENT,\n              data: {\n                axes: project.axes,\n                disabledAxes: project.disabledAxes,\n                presets: project.presets,\n                themes: project.themes,\n                defaultTheme: project.themes[0]?.name ?? null,\n                themesResolved: project.themesResolved,\n                diagnostics: project.diagnostics,\n                css,\n                cssVarPrefix: config.cssVarPrefix ?? '',\n              },\n            });\n          })();\n        }, 100);\n      };\n\n      /**\n       * Watch each source file's *parent directory* rather than the file\n       * itself. File-level `fs.watch` is fragile: atomic-save editors\n       * unlink the old inode and write a new one, so the original\n       * watcher either fires a one-shot 'rename' and goes deaf, or on\n       * some platforms loops on ghost events for the old inode. Watching\n       * the dir sidesteps both — the dir inode is stable across the\n       * rename dance — and filename filtering keeps event volume low.\n       *\n       * Vite's `server.watcher` still wouldn't carry these events across\n       * pnpm symlink boundaries, so we keep running our own watchers.\n       */\n      const byDir = new Map<string, Set<string>>();\n      for (const file of project?.sourceFiles ?? []) {\n        const dir = dirname(file);\n        const set = byDir.get(dir) ?? new Set<string>();\n        set.add(basename(file));\n        byDir.set(dir, set);\n      }\n\n      const fileWatchers: FSWatcher[] = [];\n      for (const [dir, names] of byDir) {\n        try {\n          const w = fsWatch(dir, { persistent: false }, (eventType, filename) => {\n            if (!filename) return;\n            if (!names.has(filename)) return;\n            if (eventType === 'change' || eventType === 'rename') invalidate();\n          });\n          fileWatchers.push(w);\n        } catch {\n          // unwatchable dir — skip. Next loadProject pass will report it.\n        }\n      }\n      server.httpServer?.once('close', () => {\n        for (const w of fileWatchers) w.close();\n      });\n    },\n  };\n}\n\n/**\n * Collect the set of filesystem paths the dev server should watch for\n * HMR. When `config.tokens` is set, use its globs (stripped to their\n * base directories) — users opt in to broader watching this way. When\n * absent, use the resolver file + every `$ref` target it pulled in, as\n * tracked on `project.sourceFiles` — which stays correct as the resolver\n * evolves without requiring a parallel `tokens` glob.\n */\n/** @internal Exported for tests; not part of the public API. */\nexport function collectWatchPaths(\n  config: Config,\n  project: Project | undefined,\n  cwd: string,\n): string[] {\n  const paths: string[] = [];\n  if (config.tokens && config.tokens.length > 0) {\n    for (const glob of config.tokens) {\n      // `picomatch.scan` yields the longest literal prefix before any glob\n      // metachar, so it handles brace expansion, nested globstars, and the\n      // other shapes the hand-rolled regex missed.\n      const { base } = picomatch.scan(glob);\n      paths.push(resolveFromCwd(base || '.', cwd));\n    }\n  } else if (project?.sourceFiles) {\n    for (const file of project.sourceFiles) paths.push(dirname(file));\n  }\n  if (config.resolver) paths.push(resolveFromCwd(config.resolver, cwd));\n  return [...new Set(paths)];\n}\n\nfunction resolveFromCwd(p: string, cwd: string): string {\n  if (isAbsolute(p)) return p;\n  return resolvePath(cwd, p);\n}\n","import { mkdir, writeFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, resolve } from 'node:path';\nimport { fileURLToPath, pathToFileURL } from 'node:url';\nimport type { Config, Project } from '@unpunnyfuns/swatchbook-core';\nimport { loadProject } from '@unpunnyfuns/swatchbook-core';\nimport { createJiti } from 'jiti';\nimport type { InlineConfig } from 'vite';\nimport type { AddonOptions } from '#/options.ts';\nimport { swatchbookTokensPlugin } from '#/virtual/plugin.ts';\n\ninterface PresetOptions extends AddonOptions {\n  /** Storybook injects this — the `.storybook` directory absolute path. */\n  configDir: string;\n}\n\n/**\n * Storybook preset entry. Called by Storybook at config time; extends Vite's\n * plugin list with our virtual-module plugin so the preview can import\n * `virtual:swatchbook/tokens`. Also writes the typed token-path codegen so\n * `useToken()` autocompletes against the loaded project.\n */\nexport async function viteFinal(\n  viteConfig: InlineConfig,\n  options: PresetOptions,\n): Promise<InlineConfig> {\n  const { config, cwd } = await resolveConfig(options);\n\n  // Codegen runs once at Vite startup. The virtual module plugin still\n  // owns the live reload path via its HMR watcher; this file just gives\n  // TS autocomplete for `useToken('…')` in consumer stories.\n  await writeTokenCodegen(config, cwd, options);\n\n  const plugins = Array.isArray(viteConfig.plugins) ? [...viteConfig.plugins] : [];\n  plugins.push(\n    swatchbookTokensPlugin({\n      config,\n      cwd,\n      ...(options.integrations !== undefined && { integrations: options.integrations }),\n    }),\n  );\n\n  return { ...viteConfig, plugins };\n}\n\n/** Storybook appends this module into the manager bundle so our toolbar tool registers. */\nexport function managerEntries(entry: string[] = []): string[] {\n  const managerUrl = import.meta.resolve('@unpunnyfuns/swatchbook-addon/manager');\n  return [...entry, fileURLToPath(managerUrl)];\n}\n\nasync function resolveConfig(options: PresetOptions): Promise<{ config: Config; cwd: string }> {\n  const projectRoot = resolve(options.configDir, '..');\n\n  if (options.config) {\n    return { config: options.config, cwd: projectRoot };\n  }\n\n  const path = options.configPath ?? 'swatchbook.config.ts';\n  const absolute = isAbsolute(path) ? path : resolve(options.configDir, path);\n\n  const jiti = createJiti(pathToFileURL(options.configDir).href, {\n    interopDefault: true,\n    moduleCache: false,\n  });\n  const loaded = (await jiti.import(absolute, { default: true })) as Config;\n\n  // If the config file isn't at projectRoot, still resolve globs from its dir.\n  const cwd = dirname(absolute);\n  return { config: loaded, cwd };\n}\n\nasync function writeTokenCodegen(\n  config: Config,\n  cwd: string,\n  options: PresetOptions,\n): Promise<void> {\n  const project = await loadProject(config, cwd);\n  const projectRoot = resolve(options.configDir, '..');\n  const outDir = resolve(projectRoot, config.outDir ?? '.swatchbook');\n  await mkdir(outDir, { recursive: true });\n  const content = renderTokenTypes(project);\n  await writeFile(resolve(outDir, 'tokens.d.ts'), content);\n}\n\n/** @internal Exported for tests; not part of the public API. */\nexport function renderTokenTypes(project: Project): string {\n  const paths = new Set<string>();\n  for (const theme of project.themes) {\n    const tokens = project.themesResolved[theme.name];\n    if (!tokens) continue;\n    for (const path of Object.keys(tokens)) paths.add(path);\n  }\n  const sorted = [...paths].toSorted();\n  const tokenEntries = sorted.map((p) => `    ${JSON.stringify(p)}: string;`);\n  const themeUnion = project.themes.map((t) => JSON.stringify(t.name)).join(' | ') || 'string';\n\n  return [\n    '// Generated by @unpunnyfuns/swatchbook-addon. Do not edit.',\n    \"declare module '@unpunnyfuns/swatchbook-addon/hooks' {\",\n    '  interface SwatchbookTokenMap {',\n    ...tokenEntries,\n    '  }',\n    '',\n    `  export type SwatchbookThemeName = ${themeUnion};`,\n    '}',\n    '',\n  ].join('\\n');\n}\n"],"mappings":"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"}

package/dist/{preview-hz8hF3q0.mjs → preview-C_zsIP5A.mjs}

@@ -1,6 +1,7 @@
-import { a as HMR_EVENT, c as PARAM_KEY, d as STYLE_ELEMENT_ID, f as TOKENS_UPDATED_EVENT, i as GLOBAL_KEY, l as PREVIEW_MOUSEDOWN_EVENT, n as AXES_GLOBAL_KEY, o as INIT_EVENT, r as COLOR_FORMAT_GLOBAL_KEY, s as INIT_REQUEST_EVENT } from "./constants-B3vYm529.mjs";
+import { a as HMR_EVENT, i as GLOBAL_KEY, l as PARAM_KEY, m as TOKENS_UPDATED_EVENT, n as AXES_GLOBAL_KEY, o as INIT_EVENT, p as STYLE_ELEMENT_ID, r as COLOR_FORMAT_GLOBAL_KEY, s as INIT_REQUEST_EVENT, u as PREVIEW_MOUSEDOWN_EVENT } from "./constants-DhgRF7SI.mjs";
 import { useEffect, useMemo } from "react";
 import { addons } from "storybook/preview-api";
+import "virtual:swatchbook/integration-side-effects";
 import { axes, css, cssVarPrefix, defaultTheme, diagnostics, disabledAxes, presets, themes, themesResolved } from "virtual:swatchbook/tokens";
 import { AxesContext, COLOR_FORMATS, ColorFormatContext, SwatchbookContext, ThemeContext } from "@unpunnyfuns/swatchbook-blocks";
 import { jsx } from "react/jsx-runtime";
@@ -353,4 +354,4 @@ html, body {
 //#endregion
 export { preview_exports as i, globalTypes as n, initialGlobals as r, decorators as t };
 
-//# sourceMappingURL=preview-hz8hF3q0.mjs.map
+//# sourceMappingURL=preview-C_zsIP5A.mjs.map

package/dist/preview-C_zsIP5A.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-C_zsIP5A.mjs","names":["virtualDisabledAxes","virtualAxes","virtualPresets"],"sources":["../src/data-attr.ts","../src/preview.tsx"],"sourcesContent":["/**\n * Produce a prefixed `data-*` attribute name when `prefix` is set, bare\n * `data-<key>` otherwise. Duplicated from `@unpunnyfuns/swatchbook-core`'s\n * `dataAttr` so the preview bundle doesn't have to import from core —\n * core's top-level entry pulls in Node-only modules (`node:fs/promises`\n * via the loader) that throw when evaluated in the browser.\n */\nexport function dataAttr(prefix: string, key: string): string {\n  return prefix ? `data-${prefix}-${key}` : `data-${key}`;\n}\n","/// <reference types=\"vite/client\" />\nimport type { Decorator, Preview } from '@storybook/react-vite';\nimport { useEffect, useMemo } from 'react';\nimport { addons } from 'storybook/preview-api';\nimport { dataAttr } from '#/data-attr.ts';\n// Side-effect import for integrations that opted into `autoInject`\n// (e.g. Tailwind's `@theme` block). When no integration opts in, the\n// virtual module body is empty — still a valid no-op.\nimport 'virtual:swatchbook/integration-side-effects';\nimport {\n  axes as virtualAxes,\n  css,\n  cssVarPrefix,\n  defaultTheme,\n  diagnostics,\n  disabledAxes as virtualDisabledAxes,\n  presets as virtualPresets,\n  themes,\n  themesResolved,\n} from 'virtual:swatchbook/tokens';\nimport {\n  AxesContext,\n  COLOR_FORMATS,\n  type ColorFormat,\n  ColorFormatContext,\n  type ProjectSnapshot,\n  SwatchbookContext,\n  ThemeContext,\n} from '@unpunnyfuns/swatchbook-blocks';\nimport {\n  AXES_GLOBAL_KEY,\n  COLOR_FORMAT_GLOBAL_KEY,\n  GLOBAL_KEY,\n  HMR_EVENT,\n  INIT_EVENT,\n  INIT_REQUEST_EVENT,\n  PREVIEW_MOUSEDOWN_EVENT,\n  PARAM_KEY,\n  STYLE_ELEMENT_ID,\n  TOKENS_UPDATED_EVENT,\n} from '#/constants.ts';\n\n/** CSS var name with the active prefix applied. */\nfunction v(name: string): string {\n  return cssVarPrefix ? `--${cssVarPrefix}-${name}` : `--${name}`;\n}\n\n/**\n * Inject the per-theme stylesheet plus a tiny `html, body { ... }` block so\n * the iframe's own chrome (outside any decorator wrapper — Docs mode,\n * autodocs, empty gutters) also picks up the active theme.\n */\nfunction ensureStylesheet(): void {\n  if (typeof document === 'undefined') return;\n  const bodyRules = `\nhtml, body {\n  background: var(${v('color-surface-default')}, Canvas);\n  color: var(${v('color-text-default')}, CanvasText);\n  margin: 0;\n}\n`;\n  const text = `${css}\\n${bodyRules}`;\n  let style = document.getElementById(STYLE_ELEMENT_ID) as HTMLStyleElement | null;\n  if (!style) {\n    style = document.createElement('style');\n    style.id = STYLE_ELEMENT_ID;\n    document.head.appendChild(style);\n  }\n  if (style.textContent !== text) style.textContent = text;\n}\n\n/**\n * Apply `cb(axisName, value)` for every pinned (disabled) axis whose value\n * is present on any surviving theme's `input`. Disabled axes don't appear\n * in `virtualAxes`, but CSS may still reference their pinned value on\n * compound selectors — every theme that survived filtering carries the\n * same pinned context per disabled axis, so sampling any theme works.\n */\nfunction forEachPinnedAxis(cb: (name: string, value: string) => void): void {\n  const pinnedSample = themes[0]?.input;\n  if (!pinnedSample) return;\n  for (const name of virtualDisabledAxes) {\n    const value = pinnedSample[name];\n    if (value !== undefined) cb(name, value);\n  }\n}\n\n/**\n * Pick the theme name for a tuple, falling back to `defaultTheme` and then\n * the first theme. Returns empty string when the project has no themes so\n * callers can omit the attr instead of writing a made-up context name.\n */\nfunction matchThemeName(tuple: Readonly<Record<string, string>>): string {\n  const match = themes.find((t) => {\n    const input = t.input as Record<string, string>;\n    return Object.keys(input).every((k) => input[k] === tuple[k]);\n  });\n  return match?.name ?? defaultTheme ?? themes[0]?.name ?? '';\n}\n\n/**\n * Write the composed permutation ID to `data-<prefix>-theme` plus one\n * `data-<prefix>-<axis>=<context>` per axis. Prefix follows `cssVarPrefix`\n * so the attr namespace and the emitted-CSS selectors stay in lockstep;\n * empty prefix keeps the bare `data-theme` form.\n */\nfunction setRootAxes(themeName: string, tuple: Readonly<Record<string, string>>): void {\n  if (typeof document === 'undefined') return;\n  const root = document.documentElement;\n  const themeAttr = dataAttr(cssVarPrefix, 'theme');\n  if (themeName) root.setAttribute(themeAttr, themeName);\n  else root.removeAttribute(themeAttr);\n  for (const axis of virtualAxes) {\n    const attr = dataAttr(cssVarPrefix, axis.name);\n    const value = tuple[axis.name];\n    if (value === undefined) {\n      root.removeAttribute(attr);\n    } else {\n      root.setAttribute(attr, value);\n    }\n  }\n  forEachPinnedAxis((name, value) => {\n    root.setAttribute(dataAttr(cssVarPrefix, name), value);\n  });\n}\n\n/**\n * Emit the full virtual-module payload to the manager over Storybook's\n * channel so the toolbar + panel (which run in the manager bundle and\n * can't import our virtual module) can render from it.\n */\nfunction broadcastInit(): void {\n  const channel = addons.getChannel();\n  channel.emit(INIT_EVENT, {\n    axes: virtualAxes,\n    disabledAxes: virtualDisabledAxes,\n    presets: virtualPresets,\n    themes,\n    defaultTheme,\n    themesResolved,\n    diagnostics,\n    cssVarPrefix,\n  });\n}\n\n/** Axis-default tuple, used as the baseline before overrides. */\nfunction defaultTuple(): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const axis of virtualAxes) out[axis.name] = axis.default;\n  return out;\n}\n\n/** Look up a `Theme.input` by composed name. Returns `undefined` if no theme matches. */\nfunction tupleForName(name: string): Record<string, string> | undefined {\n  const match = themes.find((t) => t.name === name);\n  return match?.input;\n}\n\n/**\n * Merge a partial tuple onto the axis defaults, dropping keys for axes that\n * don't exist and silently falling back to the default for contexts that\n * aren't listed on the axis.\n */\nfunction normalizeTuple(partial: Readonly<Record<string, string>>): Record<string, string> {\n  const out = defaultTuple();\n  for (const axis of virtualAxes) {\n    const candidate = partial[axis.name];\n    if (candidate !== undefined && axis.contexts.includes(candidate)) {\n      out[axis.name] = candidate;\n    }\n  }\n  return out;\n}\n\n/**\n * Resolve the active tuple from all four input channels, in priority order:\n *   1. `parameters.swatchbook.axes` — per-story tuple.\n *   2. `parameters.swatchbook.theme` — per-story composed name (legacy).\n *   3. `globals.swatchbookAxes` — toolbar-set tuple.\n *   4. `globals.swatchbookTheme` — toolbar-set composed name.\n *   5. virtual module default.\n */\nfunction resolveTuple(\n  globals: Record<string, unknown>,\n  parameters: Record<string, Record<string, unknown>>,\n): Record<string, string> {\n  const param = parameters[PARAM_KEY];\n  const paramAxes = param?.['axes'];\n  if (paramAxes && typeof paramAxes === 'object') {\n    return normalizeTuple(paramAxes as Record<string, string>);\n  }\n  const paramTheme = param?.['theme'];\n  if (typeof paramTheme === 'string') {\n    const hit = tupleForName(paramTheme);\n    if (hit) return normalizeTuple(hit);\n  }\n  const globalAxes = globals[AXES_GLOBAL_KEY];\n  if (globalAxes && typeof globalAxes === 'object') {\n    return normalizeTuple(globalAxes as Record<string, string>);\n  }\n  const globalTheme = globals[GLOBAL_KEY];\n  if (typeof globalTheme === 'string') {\n    const hit = tupleForName(globalTheme);\n    if (hit) return normalizeTuple(hit);\n  }\n  return defaultTuple();\n}\n\nfunction resolveColorFormat(globals: Record<string, unknown>): ColorFormat {\n  const raw = globals[COLOR_FORMAT_GLOBAL_KEY];\n  if (typeof raw === 'string' && (COLOR_FORMATS as readonly string[]).includes(raw)) {\n    return raw as ColorFormat;\n  }\n  return 'hex';\n}\n\nconst themedDecorator: Decorator = (Story, context) => {\n  const tuple = useMemo(\n    () =>\n      resolveTuple(\n        context.globals as Record<string, unknown>,\n        context.parameters as Record<string, Record<string, unknown>>,\n      ),\n    [context.globals, context.parameters],\n  );\n  const colorFormat = useMemo(\n    () => resolveColorFormat(context.globals as Record<string, unknown>),\n    [context.globals],\n  );\n  const themeName = useMemo(() => matchThemeName(tuple), [tuple]);\n\n  useEffect(() => {\n    ensureStylesheet();\n    broadcastInit();\n  }, []);\n\n  useEffect(() => {\n    setRootAxes(themeName, tuple);\n  }, [themeName, tuple]);\n\n  const wrapperAttrs: Record<string, string> = {};\n  if (themeName) wrapperAttrs[dataAttr(cssVarPrefix, 'theme')] = themeName;\n  for (const axis of virtualAxes) {\n    const value = tuple[axis.name];\n    if (value !== undefined) wrapperAttrs[dataAttr(cssVarPrefix, axis.name)] = value;\n  }\n  forEachPinnedAxis((name, value) => {\n    wrapperAttrs[dataAttr(cssVarPrefix, name)] = value;\n  });\n\n  const snapshot = useMemo<ProjectSnapshot>(\n    () => ({\n      axes: virtualAxes,\n      disabledAxes: virtualDisabledAxes,\n      presets: virtualPresets,\n      themes,\n      themesResolved,\n      activeTheme: themeName,\n      activeAxes: tuple,\n      cssVarPrefix,\n      diagnostics,\n      css,\n    }),\n    [themeName, tuple],\n  );\n\n  return (\n    <SwatchbookContext.Provider value={snapshot}>\n      <ThemeContext.Provider value={themeName}>\n        <AxesContext.Provider value={tuple}>\n          <ColorFormatContext.Provider value={colorFormat}>\n            <div\n              {...wrapperAttrs}\n              style={{\n                padding: '1rem',\n                minHeight: '100%',\n              }}\n            >\n              <Story />\n            </div>\n          </ColorFormatContext.Provider>\n        </AxesContext.Provider>\n      </ThemeContext.Provider>\n    </SwatchbookContext.Provider>\n  );\n};\n\n/**\n * Named exports consumed by `definePreviewAddon(previewExports)` in the\n * addon's CSF Next factory (`src/index.ts`).\n */\nexport const decorators: NonNullable<Preview['decorators']> = [themedDecorator];\n\nexport const globalTypes: NonNullable<Preview['globalTypes']> = {\n  [GLOBAL_KEY]: {\n    name: 'Theme',\n    description: 'Active swatchbook theme (composed permutation ID).',\n  },\n  [AXES_GLOBAL_KEY]: {\n    name: 'Axes',\n    description: 'Per-axis context selection. Takes precedence over the composed theme name.',\n  },\n  [COLOR_FORMAT_GLOBAL_KEY]: {\n    name: 'Color format',\n    description: 'Display format for color tokens in blocks. Emitted CSS is unaffected.',\n  },\n};\n\nfunction buildInitialAxes(): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const axis of virtualAxes) out[axis.name] = axis.default;\n  return out;\n}\n\nexport const initialGlobals: NonNullable<Preview['initialGlobals']> = {\n  [GLOBAL_KEY]: defaultTheme ?? themes[0]?.name ?? '',\n  [AXES_GLOBAL_KEY]: buildInitialAxes(),\n  [COLOR_FORMAT_GLOBAL_KEY]: 'hex',\n};\n\n/**\n * Module-level channel subscription: writes the active tuple's attributes\n * onto `<html>` regardless of whether a story decorator is rendering.\n *\n * The {@link themedDecorator} already sets these inside story renders, but\n * it never runs on MDX docs pages that embed blocks without `<Story />`.\n * Without attrs on an ancestor, the per-tuple CSS selectors\n * (`[data-mode=\"Dark\"][data-brand=\"…\"]`) don't match and everything falls\n * back to the `:root` default tuple — so colors stay defaults even after\n * the toolbar switches axes. Subscribing globally fixes MDX docs at the\n * cost of one idempotent redundant write per story render.\n */\nfunction installGlobalAxisApplier(): void {\n  if (typeof document === 'undefined') return;\n  const channel = addons.getChannel();\n  /**\n   * Inject the stylesheet and emit the init payload once on module load so\n   * the manager's toolbar populates and CSS vars are available even when no\n   * story/decorator ever runs (bare MDX docs pages). Without these, the\n   * toolbar sits in its disabled \"loading…\" state and nothing is styled.\n   */\n  ensureStylesheet();\n  broadcastInit();\n  /**\n   * If the manager subscribes to INIT_EVENT after our initial broadcast,\n   * it misses the payload and the toolbar stays in its \"loading…\" state\n   * until something else re-fires it. Honor an explicit request event so\n   * a late-mounting manager can ask for the payload.\n   */\n  channel.on(INIT_REQUEST_EVENT, broadcastInit);\n  const apply = (globals: Record<string, unknown>): void => {\n    ensureStylesheet();\n    const tuple = resolveTuple(globals, {});\n    setRootAxes(matchThemeName(tuple), tuple);\n  };\n  const onGlobals = (payload: { globals?: Record<string, unknown> }): void => {\n    if (payload.globals) apply(payload.globals);\n  };\n  channel.on('globalsUpdated', onGlobals);\n  channel.on('setGlobals', onGlobals);\n  channel.on('updateGlobals', onGlobals);\n}\n\ninstallGlobalAxisApplier();\n\n/**\n * Bridge `mousedown` inside the preview iframe to the manager via a\n * dedicated channel event. The toolbar popover's outside-click listener\n * runs on the manager's document, which can't observe mousedowns inside\n * the preview; without this bridge, clicking the canvas leaves the\n * popover open. Idempotent: fires at most once per real mousedown.\n */\nfunction installPreviewMouseDownBridge(): void {\n  if (typeof document === 'undefined') return;\n  const channel = addons.getChannel();\n  document.addEventListener('mousedown', () => {\n    channel.emit(PREVIEW_MOUSEDOWN_EVENT);\n  });\n}\n\ninstallPreviewMouseDownBridge();\n\n/**\n * Wire the dev-time token-refresh HMR path. The plugin emits `HMR_EVENT`\n * with the fresh virtual-module payload whenever a watched source file\n * changes; we re-inject the stylesheet and forward to the Storybook\n * channel so the toolbar re-renders and blocks can re-subscribe with\n * the new snapshot — no full preview reload, so args / scroll / open\n * overlays survive the refresh. No-ops in production where\n * `import.meta.hot` is undefined.\n */\ninterface HmrSnapshot {\n  axes: typeof virtualAxes;\n  disabledAxes: typeof virtualDisabledAxes;\n  presets: typeof virtualPresets;\n  themes: typeof themes;\n  defaultTheme: typeof defaultTheme;\n  themesResolved: typeof themesResolved;\n  diagnostics: typeof diagnostics;\n  css: string;\n  cssVarPrefix: string;\n}\nif (import.meta.hot) {\n  import.meta.hot.on(HMR_EVENT, (payload: HmrSnapshot) => {\n    if (typeof document !== 'undefined') {\n      const bodyRules = `\nhtml, body {\n  background: var(${payload.cssVarPrefix ? `--${payload.cssVarPrefix}-` : '--'}color-surface-default, Canvas);\n  color: var(${payload.cssVarPrefix ? `--${payload.cssVarPrefix}-` : '--'}color-text-default, CanvasText);\n  margin: 0;\n}\n`;\n      const text = `${payload.css}\\n${bodyRules}`;\n      let style = document.getElementById(STYLE_ELEMENT_ID) as HTMLStyleElement | null;\n      if (!style) {\n        style = document.createElement('style');\n        style.id = STYLE_ELEMENT_ID;\n        document.head.appendChild(style);\n      }\n      if (style.textContent !== text) style.textContent = text;\n    }\n    const channel = addons.getChannel();\n    channel.emit(INIT_EVENT, {\n      axes: payload.axes,\n      disabledAxes: payload.disabledAxes,\n      presets: payload.presets,\n      themes: payload.themes,\n      defaultTheme: payload.defaultTheme,\n      themesResolved: payload.themesResolved,\n      diagnostics: payload.diagnostics,\n      cssVarPrefix: payload.cssVarPrefix,\n    });\n    channel.emit(TOKENS_UPDATED_EVENT, payload);\n  });\n}\n"],"mappings":"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"}

package/dist/preview.mjs

@@ -1,2 +1,2 @@
-import { n as globalTypes, r as initialGlobals, t as decorators } from "./preview-hz8hF3q0.mjs";
+import { n as globalTypes, r as initialGlobals, t as decorators } from "./preview-C_zsIP5A.mjs";
 export { decorators, globalTypes, initialGlobals };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unpunnyfuns/swatchbook-addon",
-  "version": "0.13.1",
+  "version": "0.14.1",
   "description": "Storybook addon for DTCG design tokens — toolbar, panel, and useToken hook.",
   "license": "MIT",
   "author": "unpunnyfuns <unpunnyfuns@gmail.com>",
@@ -70,9 +70,9 @@
   "dependencies": {
     "jiti": "^2.4.0",
     "picomatch": "^4.0.4",
-    "@unpunnyfuns/swatchbook-blocks": "0.13.1",
-    "@unpunnyfuns/swatchbook-core": "0.13.1",
-    "@unpunnyfuns/swatchbook-switcher": "0.13.1"
+    "@unpunnyfuns/swatchbook-blocks": "0.14.1",
+    "@unpunnyfuns/swatchbook-core": "0.14.1",
+    "@unpunnyfuns/swatchbook-switcher": "0.14.1"
   },
   "peerDependencies": {
     "react": ">=18",

package/dist/constants-B3vYm529.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants-B3vYm529.mjs","names":[],"sources":["../src/constants.ts"],"sourcesContent":["export const ADDON_ID = 'swatchbook';\nexport const TOOL_ID = `${ADDON_ID}/theme-switcher`;\nexport const PARAM_KEY = 'swatchbook';\n/** Canonical active-theme global: composed permutation ID (string). Read by toolbar, panel, blocks. */\nexport const GLOBAL_KEY = 'swatchbookTheme';\n/** Tuple companion: `Record<axisName, contextName>`. Optional — when present, takes precedence over the string global. */\nexport const AXES_GLOBAL_KEY = 'swatchbookAxes';\n/** Display-only color format for blocks (`hex` | `rgb` | `hsl` | `oklch` | `raw`). Emitted CSS is unaffected. */\nexport const COLOR_FORMAT_GLOBAL_KEY = 'swatchbookColorFormat';\n\nexport const VIRTUAL_MODULE_ID = 'virtual:swatchbook/tokens';\nexport const RESOLVED_VIRTUAL_MODULE_ID = `\\0${VIRTUAL_MODULE_ID}`;\n\nexport const STYLE_ELEMENT_ID = 'swatchbook-tokens';\n\n/** Channel event: preview → manager, carries theme list + mode. */\nexport const INIT_EVENT = 'swatchbook/init';\n/** Channel event: manager → preview, asks preview to re-emit INIT_EVENT.\n * Covers the race where the manager subscribes after the preview's\n * initial broadcast — without it the toolbar stays in \"loading…\" until\n * the user triggers anything that re-fires INIT_EVENT. */\nexport const INIT_REQUEST_EVENT = 'swatchbook/init-request';\n/** Channel event: preview → manager, fires once per `mousedown` on the\n * preview document. The toolbar popover listens for it so clicks landing\n * inside the preview iframe close the popover — a plain document-level\n * listener on the manager can't see iframe events. */\nexport const PREVIEW_MOUSEDOWN_EVENT = 'swatchbook/preview-mousedown';\n\n/** Channel event: preview → blocks, carries the fresh virtual-module\n * payload after a dev-time token refresh so blocks can re-render in\n * place without a full iframe reload. Fired by the preview in response\n * to the `HMR_EVENT` below. */\nexport const TOKENS_UPDATED_EVENT = 'swatchbook/tokens-updated';\n\n/** Custom Vite HMR event: plugin → preview. Preview forwards it to the\n * Storybook channel as {@link TOKENS_UPDATED_EVENT} so blocks can\n * update their snapshot. Kept distinct from the channel event so the\n * plugin doesn't need a Storybook-channel dependency. */\nexport const HMR_EVENT = 'swatchbook/tokens-updated';\n"],"mappings":";AAAA,MAAa,WAAW;AACxB,MAAa,UAAU,GAAG,SAAS;AACnC,MAAa,YAAY;;AAEzB,MAAa,aAAa;;AAE1B,MAAa,kBAAkB;;AAE/B,MAAa,0BAA0B;AAEvC,MAAa,oBAAoB;AACjC,MAAa,6BAA6B,KAAK;AAE/C,MAAa,mBAAmB;;AAGhC,MAAa,aAAa;;;;;AAK1B,MAAa,qBAAqB;;;;;AAKlC,MAAa,0BAA0B;;;;;AAMvC,MAAa,uBAAuB;;;;;AAMpC,MAAa,YAAY"}

package/dist/preview-hz8hF3q0.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"preview-hz8hF3q0.mjs","names":["virtualDisabledAxes","virtualAxes","virtualPresets"],"sources":["../src/data-attr.ts","../src/preview.tsx"],"sourcesContent":["/**\n * Produce a prefixed `data-*` attribute name when `prefix` is set, bare\n * `data-<key>` otherwise. Duplicated from `@unpunnyfuns/swatchbook-core`'s\n * `dataAttr` so the preview bundle doesn't have to import from core —\n * core's top-level entry pulls in Node-only modules (`node:fs/promises`\n * via the loader) that throw when evaluated in the browser.\n */\nexport function dataAttr(prefix: string, key: string): string {\n  return prefix ? `data-${prefix}-${key}` : `data-${key}`;\n}\n","/// <reference types=\"vite/client\" />\nimport type { Decorator, Preview } from '@storybook/react-vite';\nimport { useEffect, useMemo } from 'react';\nimport { addons } from 'storybook/preview-api';\nimport { dataAttr } from '#/data-attr.ts';\nimport {\n  axes as virtualAxes,\n  css,\n  cssVarPrefix,\n  defaultTheme,\n  diagnostics,\n  disabledAxes as virtualDisabledAxes,\n  presets as virtualPresets,\n  themes,\n  themesResolved,\n} from 'virtual:swatchbook/tokens';\nimport {\n  AxesContext,\n  COLOR_FORMATS,\n  type ColorFormat,\n  ColorFormatContext,\n  type ProjectSnapshot,\n  SwatchbookContext,\n  ThemeContext,\n} from '@unpunnyfuns/swatchbook-blocks';\nimport {\n  AXES_GLOBAL_KEY,\n  COLOR_FORMAT_GLOBAL_KEY,\n  GLOBAL_KEY,\n  HMR_EVENT,\n  INIT_EVENT,\n  INIT_REQUEST_EVENT,\n  PREVIEW_MOUSEDOWN_EVENT,\n  PARAM_KEY,\n  STYLE_ELEMENT_ID,\n  TOKENS_UPDATED_EVENT,\n} from '#/constants.ts';\n\n/** CSS var name with the active prefix applied. */\nfunction v(name: string): string {\n  return cssVarPrefix ? `--${cssVarPrefix}-${name}` : `--${name}`;\n}\n\n/**\n * Inject the per-theme stylesheet plus a tiny `html, body { ... }` block so\n * the iframe's own chrome (outside any decorator wrapper — Docs mode,\n * autodocs, empty gutters) also picks up the active theme.\n */\nfunction ensureStylesheet(): void {\n  if (typeof document === 'undefined') return;\n  const bodyRules = `\nhtml, body {\n  background: var(${v('color-surface-default')}, Canvas);\n  color: var(${v('color-text-default')}, CanvasText);\n  margin: 0;\n}\n`;\n  const text = `${css}\\n${bodyRules}`;\n  let style = document.getElementById(STYLE_ELEMENT_ID) as HTMLStyleElement | null;\n  if (!style) {\n    style = document.createElement('style');\n    style.id = STYLE_ELEMENT_ID;\n    document.head.appendChild(style);\n  }\n  if (style.textContent !== text) style.textContent = text;\n}\n\n/**\n * Apply `cb(axisName, value)` for every pinned (disabled) axis whose value\n * is present on any surviving theme's `input`. Disabled axes don't appear\n * in `virtualAxes`, but CSS may still reference their pinned value on\n * compound selectors — every theme that survived filtering carries the\n * same pinned context per disabled axis, so sampling any theme works.\n */\nfunction forEachPinnedAxis(cb: (name: string, value: string) => void): void {\n  const pinnedSample = themes[0]?.input;\n  if (!pinnedSample) return;\n  for (const name of virtualDisabledAxes) {\n    const value = pinnedSample[name];\n    if (value !== undefined) cb(name, value);\n  }\n}\n\n/**\n * Pick the theme name for a tuple, falling back to `defaultTheme` and then\n * the first theme. Returns empty string when the project has no themes so\n * callers can omit the attr instead of writing a made-up context name.\n */\nfunction matchThemeName(tuple: Readonly<Record<string, string>>): string {\n  const match = themes.find((t) => {\n    const input = t.input as Record<string, string>;\n    return Object.keys(input).every((k) => input[k] === tuple[k]);\n  });\n  return match?.name ?? defaultTheme ?? themes[0]?.name ?? '';\n}\n\n/**\n * Write the composed permutation ID to `data-<prefix>-theme` plus one\n * `data-<prefix>-<axis>=<context>` per axis. Prefix follows `cssVarPrefix`\n * so the attr namespace and the emitted-CSS selectors stay in lockstep;\n * empty prefix keeps the bare `data-theme` form.\n */\nfunction setRootAxes(themeName: string, tuple: Readonly<Record<string, string>>): void {\n  if (typeof document === 'undefined') return;\n  const root = document.documentElement;\n  const themeAttr = dataAttr(cssVarPrefix, 'theme');\n  if (themeName) root.setAttribute(themeAttr, themeName);\n  else root.removeAttribute(themeAttr);\n  for (const axis of virtualAxes) {\n    const attr = dataAttr(cssVarPrefix, axis.name);\n    const value = tuple[axis.name];\n    if (value === undefined) {\n      root.removeAttribute(attr);\n    } else {\n      root.setAttribute(attr, value);\n    }\n  }\n  forEachPinnedAxis((name, value) => {\n    root.setAttribute(dataAttr(cssVarPrefix, name), value);\n  });\n}\n\n/**\n * Emit the full virtual-module payload to the manager over Storybook's\n * channel so the toolbar + panel (which run in the manager bundle and\n * can't import our virtual module) can render from it.\n */\nfunction broadcastInit(): void {\n  const channel = addons.getChannel();\n  channel.emit(INIT_EVENT, {\n    axes: virtualAxes,\n    disabledAxes: virtualDisabledAxes,\n    presets: virtualPresets,\n    themes,\n    defaultTheme,\n    themesResolved,\n    diagnostics,\n    cssVarPrefix,\n  });\n}\n\n/** Axis-default tuple, used as the baseline before overrides. */\nfunction defaultTuple(): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const axis of virtualAxes) out[axis.name] = axis.default;\n  return out;\n}\n\n/** Look up a `Theme.input` by composed name. Returns `undefined` if no theme matches. */\nfunction tupleForName(name: string): Record<string, string> | undefined {\n  const match = themes.find((t) => t.name === name);\n  return match?.input;\n}\n\n/**\n * Merge a partial tuple onto the axis defaults, dropping keys for axes that\n * don't exist and silently falling back to the default for contexts that\n * aren't listed on the axis.\n */\nfunction normalizeTuple(partial: Readonly<Record<string, string>>): Record<string, string> {\n  const out = defaultTuple();\n  for (const axis of virtualAxes) {\n    const candidate = partial[axis.name];\n    if (candidate !== undefined && axis.contexts.includes(candidate)) {\n      out[axis.name] = candidate;\n    }\n  }\n  return out;\n}\n\n/**\n * Resolve the active tuple from all four input channels, in priority order:\n *   1. `parameters.swatchbook.axes` — per-story tuple.\n *   2. `parameters.swatchbook.theme` — per-story composed name (legacy).\n *   3. `globals.swatchbookAxes` — toolbar-set tuple.\n *   4. `globals.swatchbookTheme` — toolbar-set composed name.\n *   5. virtual module default.\n */\nfunction resolveTuple(\n  globals: Record<string, unknown>,\n  parameters: Record<string, Record<string, unknown>>,\n): Record<string, string> {\n  const param = parameters[PARAM_KEY];\n  const paramAxes = param?.['axes'];\n  if (paramAxes && typeof paramAxes === 'object') {\n    return normalizeTuple(paramAxes as Record<string, string>);\n  }\n  const paramTheme = param?.['theme'];\n  if (typeof paramTheme === 'string') {\n    const hit = tupleForName(paramTheme);\n    if (hit) return normalizeTuple(hit);\n  }\n  const globalAxes = globals[AXES_GLOBAL_KEY];\n  if (globalAxes && typeof globalAxes === 'object') {\n    return normalizeTuple(globalAxes as Record<string, string>);\n  }\n  const globalTheme = globals[GLOBAL_KEY];\n  if (typeof globalTheme === 'string') {\n    const hit = tupleForName(globalTheme);\n    if (hit) return normalizeTuple(hit);\n  }\n  return defaultTuple();\n}\n\nfunction resolveColorFormat(globals: Record<string, unknown>): ColorFormat {\n  const raw = globals[COLOR_FORMAT_GLOBAL_KEY];\n  if (typeof raw === 'string' && (COLOR_FORMATS as readonly string[]).includes(raw)) {\n    return raw as ColorFormat;\n  }\n  return 'hex';\n}\n\nconst themedDecorator: Decorator = (Story, context) => {\n  const tuple = useMemo(\n    () =>\n      resolveTuple(\n        context.globals as Record<string, unknown>,\n        context.parameters as Record<string, Record<string, unknown>>,\n      ),\n    [context.globals, context.parameters],\n  );\n  const colorFormat = useMemo(\n    () => resolveColorFormat(context.globals as Record<string, unknown>),\n    [context.globals],\n  );\n  const themeName = useMemo(() => matchThemeName(tuple), [tuple]);\n\n  useEffect(() => {\n    ensureStylesheet();\n    broadcastInit();\n  }, []);\n\n  useEffect(() => {\n    setRootAxes(themeName, tuple);\n  }, [themeName, tuple]);\n\n  const wrapperAttrs: Record<string, string> = {};\n  if (themeName) wrapperAttrs[dataAttr(cssVarPrefix, 'theme')] = themeName;\n  for (const axis of virtualAxes) {\n    const value = tuple[axis.name];\n    if (value !== undefined) wrapperAttrs[dataAttr(cssVarPrefix, axis.name)] = value;\n  }\n  forEachPinnedAxis((name, value) => {\n    wrapperAttrs[dataAttr(cssVarPrefix, name)] = value;\n  });\n\n  const snapshot = useMemo<ProjectSnapshot>(\n    () => ({\n      axes: virtualAxes,\n      disabledAxes: virtualDisabledAxes,\n      presets: virtualPresets,\n      themes,\n      themesResolved,\n      activeTheme: themeName,\n      activeAxes: tuple,\n      cssVarPrefix,\n      diagnostics,\n      css,\n    }),\n    [themeName, tuple],\n  );\n\n  return (\n    <SwatchbookContext.Provider value={snapshot}>\n      <ThemeContext.Provider value={themeName}>\n        <AxesContext.Provider value={tuple}>\n          <ColorFormatContext.Provider value={colorFormat}>\n            <div\n              {...wrapperAttrs}\n              style={{\n                padding: '1rem',\n                minHeight: '100%',\n              }}\n            >\n              <Story />\n            </div>\n          </ColorFormatContext.Provider>\n        </AxesContext.Provider>\n      </ThemeContext.Provider>\n    </SwatchbookContext.Provider>\n  );\n};\n\n/**\n * Named exports consumed by `definePreviewAddon(previewExports)` in the\n * addon's CSF Next factory (`src/index.ts`).\n */\nexport const decorators: NonNullable<Preview['decorators']> = [themedDecorator];\n\nexport const globalTypes: NonNullable<Preview['globalTypes']> = {\n  [GLOBAL_KEY]: {\n    name: 'Theme',\n    description: 'Active swatchbook theme (composed permutation ID).',\n  },\n  [AXES_GLOBAL_KEY]: {\n    name: 'Axes',\n    description: 'Per-axis context selection. Takes precedence over the composed theme name.',\n  },\n  [COLOR_FORMAT_GLOBAL_KEY]: {\n    name: 'Color format',\n    description: 'Display format for color tokens in blocks. Emitted CSS is unaffected.',\n  },\n};\n\nfunction buildInitialAxes(): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const axis of virtualAxes) out[axis.name] = axis.default;\n  return out;\n}\n\nexport const initialGlobals: NonNullable<Preview['initialGlobals']> = {\n  [GLOBAL_KEY]: defaultTheme ?? themes[0]?.name ?? '',\n  [AXES_GLOBAL_KEY]: buildInitialAxes(),\n  [COLOR_FORMAT_GLOBAL_KEY]: 'hex',\n};\n\n/**\n * Module-level channel subscription: writes the active tuple's attributes\n * onto `<html>` regardless of whether a story decorator is rendering.\n *\n * The {@link themedDecorator} already sets these inside story renders, but\n * it never runs on MDX docs pages that embed blocks without `<Story />`.\n * Without attrs on an ancestor, the per-tuple CSS selectors\n * (`[data-mode=\"Dark\"][data-brand=\"…\"]`) don't match and everything falls\n * back to the `:root` default tuple — so colors stay defaults even after\n * the toolbar switches axes. Subscribing globally fixes MDX docs at the\n * cost of one idempotent redundant write per story render.\n */\nfunction installGlobalAxisApplier(): void {\n  if (typeof document === 'undefined') return;\n  const channel = addons.getChannel();\n  /**\n   * Inject the stylesheet and emit the init payload once on module load so\n   * the manager's toolbar populates and CSS vars are available even when no\n   * story/decorator ever runs (bare MDX docs pages). Without these, the\n   * toolbar sits in its disabled \"loading…\" state and nothing is styled.\n   */\n  ensureStylesheet();\n  broadcastInit();\n  /**\n   * If the manager subscribes to INIT_EVENT after our initial broadcast,\n   * it misses the payload and the toolbar stays in its \"loading…\" state\n   * until something else re-fires it. Honor an explicit request event so\n   * a late-mounting manager can ask for the payload.\n   */\n  channel.on(INIT_REQUEST_EVENT, broadcastInit);\n  const apply = (globals: Record<string, unknown>): void => {\n    ensureStylesheet();\n    const tuple = resolveTuple(globals, {});\n    setRootAxes(matchThemeName(tuple), tuple);\n  };\n  const onGlobals = (payload: { globals?: Record<string, unknown> }): void => {\n    if (payload.globals) apply(payload.globals);\n  };\n  channel.on('globalsUpdated', onGlobals);\n  channel.on('setGlobals', onGlobals);\n  channel.on('updateGlobals', onGlobals);\n}\n\ninstallGlobalAxisApplier();\n\n/**\n * Bridge `mousedown` inside the preview iframe to the manager via a\n * dedicated channel event. The toolbar popover's outside-click listener\n * runs on the manager's document, which can't observe mousedowns inside\n * the preview; without this bridge, clicking the canvas leaves the\n * popover open. Idempotent: fires at most once per real mousedown.\n */\nfunction installPreviewMouseDownBridge(): void {\n  if (typeof document === 'undefined') return;\n  const channel = addons.getChannel();\n  document.addEventListener('mousedown', () => {\n    channel.emit(PREVIEW_MOUSEDOWN_EVENT);\n  });\n}\n\ninstallPreviewMouseDownBridge();\n\n/**\n * Wire the dev-time token-refresh HMR path. The plugin emits `HMR_EVENT`\n * with the fresh virtual-module payload whenever a watched source file\n * changes; we re-inject the stylesheet and forward to the Storybook\n * channel so the toolbar re-renders and blocks can re-subscribe with\n * the new snapshot — no full preview reload, so args / scroll / open\n * overlays survive the refresh. No-ops in production where\n * `import.meta.hot` is undefined.\n */\ninterface HmrSnapshot {\n  axes: typeof virtualAxes;\n  disabledAxes: typeof virtualDisabledAxes;\n  presets: typeof virtualPresets;\n  themes: typeof themes;\n  defaultTheme: typeof defaultTheme;\n  themesResolved: typeof themesResolved;\n  diagnostics: typeof diagnostics;\n  css: string;\n  cssVarPrefix: string;\n}\nif (import.meta.hot) {\n  import.meta.hot.on(HMR_EVENT, (payload: HmrSnapshot) => {\n    if (typeof document !== 'undefined') {\n      const bodyRules = `\nhtml, body {\n  background: var(${payload.cssVarPrefix ? `--${payload.cssVarPrefix}-` : '--'}color-surface-default, Canvas);\n  color: var(${payload.cssVarPrefix ? `--${payload.cssVarPrefix}-` : '--'}color-text-default, CanvasText);\n  margin: 0;\n}\n`;\n      const text = `${payload.css}\\n${bodyRules}`;\n      let style = document.getElementById(STYLE_ELEMENT_ID) as HTMLStyleElement | null;\n      if (!style) {\n        style = document.createElement('style');\n        style.id = STYLE_ELEMENT_ID;\n        document.head.appendChild(style);\n      }\n      if (style.textContent !== text) style.textContent = text;\n    }\n    const channel = addons.getChannel();\n    channel.emit(INIT_EVENT, {\n      axes: payload.axes,\n      disabledAxes: payload.disabledAxes,\n      presets: payload.presets,\n      themes: payload.themes,\n      defaultTheme: payload.defaultTheme,\n      themesResolved: payload.themesResolved,\n      diagnostics: payload.diagnostics,\n      cssVarPrefix: payload.cssVarPrefix,\n    });\n    channel.emit(TOKENS_UPDATED_EVENT, payload);\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,SAAgB,SAAS,QAAgB,KAAqB;AAC5D,QAAO,SAAS,QAAQ,OAAO,GAAG,QAAQ,QAAQ;;;;;;;;;;AC+BpD,SAAS,EAAE,MAAsB;AAC/B,QAAO,eAAe,KAAK,aAAa,GAAG,SAAS,KAAK;;;;;;;AAQ3D,SAAS,mBAAyB;AAChC,KAAI,OAAO,aAAa,YAAa;CAQrC,MAAM,OAAO,GAAG,IAAI,IAPF;;oBAEA,EAAE,wBAAwB,CAAC;eAChC,EAAE,qBAAqB,CAAC;;;;CAKrC,IAAI,QAAQ,SAAS,eAAe,iBAAiB;AACrD,KAAI,CAAC,OAAO;AACV,UAAQ,SAAS,cAAc,QAAQ;AACvC,QAAM,KAAK;AACX,WAAS,KAAK,YAAY,MAAM;;AAElC,KAAI,MAAM,gBAAgB,KAAM,OAAM,cAAc;;;;;;;;;AAUtD,SAAS,kBAAkB,IAAiD;CAC1E,MAAM,eAAe,OAAO,IAAI;AAChC,KAAI,CAAC,aAAc;AACnB,MAAK,MAAM,QAAQA,cAAqB;EACtC,MAAM,QAAQ,aAAa;AAC3B,MAAI,UAAU,KAAA,EAAW,IAAG,MAAM,MAAM;;;;;;;;AAS5C,SAAS,eAAe,OAAiD;AAKvE,QAJc,OAAO,MAAM,MAAM;EAC/B,MAAM,QAAQ,EAAE;AAChB,SAAO,OAAO,KAAK,MAAM,CAAC,OAAO,MAAM,MAAM,OAAO,MAAM,GAAG;GAC7D,EACY,QAAQ,gBAAgB,OAAO,IAAI,QAAQ;;;;;;;;AAS3D,SAAS,YAAY,WAAmB,OAA+C;AACrF,KAAI,OAAO,aAAa,YAAa;CACrC,MAAM,OAAO,SAAS;CACtB,MAAM,YAAY,SAAS,cAAc,QAAQ;AACjD,KAAI,UAAW,MAAK,aAAa,WAAW,UAAU;KACjD,MAAK,gBAAgB,UAAU;AACpC,MAAK,MAAM,QAAQC,MAAa;EAC9B,MAAM,OAAO,SAAS,cAAc,KAAK,KAAK;EAC9C,MAAM,QAAQ,MAAM,KAAK;AACzB,MAAI,UAAU,KAAA,EACZ,MAAK,gBAAgB,KAAK;MAE1B,MAAK,aAAa,MAAM,MAAM;;AAGlC,oBAAmB,MAAM,UAAU;AACjC,OAAK,aAAa,SAAS,cAAc,KAAK,EAAE,MAAM;GACtD;;;;;;;AAQJ,SAAS,gBAAsB;AACb,QAAO,YAAY,CAC3B,KAAK,YAAY;EACjBA;EACQD;EACLE;EACT;EACA;EACA;EACA;EACA;EACD,CAAC;;;AAIJ,SAAS,eAAuC;CAC9C,MAAM,MAA8B,EAAE;AACtC,MAAK,MAAM,QAAQD,KAAa,KAAI,KAAK,QAAQ,KAAK;AACtD,QAAO;;;AAIT,SAAS,aAAa,MAAkD;AAEtE,QADc,OAAO,MAAM,MAAM,EAAE,SAAS,KAAK,EACnC;;;;;;;AAQhB,SAAS,eAAe,SAAmE;CACzF,MAAM,MAAM,cAAc;AAC1B,MAAK,MAAM,QAAQA,MAAa;EAC9B,MAAM,YAAY,QAAQ,KAAK;AAC/B,MAAI,cAAc,KAAA,KAAa,KAAK,SAAS,SAAS,UAAU,CAC9D,KAAI,KAAK,QAAQ;;AAGrB,QAAO;;;;;;;;;;AAWT,SAAS,aACP,SACA,YACwB;CACxB,MAAM,QAAQ,WAAW;CACzB,MAAM,YAAY,QAAQ;AAC1B,KAAI,aAAa,OAAO,cAAc,SACpC,QAAO,eAAe,UAAoC;CAE5D,MAAM,aAAa,QAAQ;AAC3B,KAAI,OAAO,eAAe,UAAU;EAClC,MAAM,MAAM,aAAa,WAAW;AACpC,MAAI,IAAK,QAAO,eAAe,IAAI;;CAErC,MAAM,aAAa,QAAQ;AAC3B,KAAI,cAAc,OAAO,eAAe,SACtC,QAAO,eAAe,WAAqC;CAE7D,MAAM,cAAc,QAAQ;AAC5B,KAAI,OAAO,gBAAgB,UAAU;EACnC,MAAM,MAAM,aAAa,YAAY;AACrC,MAAI,IAAK,QAAO,eAAe,IAAI;;AAErC,QAAO,cAAc;;AAGvB,SAAS,mBAAmB,SAA+C;CACzE,MAAM,MAAM,QAAQ;AACpB,KAAI,OAAO,QAAQ,YAAa,cAAoC,SAAS,IAAI,CAC/E,QAAO;AAET,QAAO;;AAGT,MAAM,mBAA8B,OAAO,YAAY;CACrD,MAAM,QAAQ,cAEV,aACE,QAAQ,SACR,QAAQ,WACT,EACH,CAAC,QAAQ,SAAS,QAAQ,WAAW,CACtC;CACD,MAAM,cAAc,cACZ,mBAAmB,QAAQ,QAAmC,EACpE,CAAC,QAAQ,QAAQ,CAClB;CACD,MAAM,YAAY,cAAc,eAAe,MAAM,EAAE,CAAC,MAAM,CAAC;AAE/D,iBAAgB;AACd,oBAAkB;AAClB,iBAAe;IACd,EAAE,CAAC;AAEN,iBAAgB;AACd,cAAY,WAAW,MAAM;IAC5B,CAAC,WAAW,MAAM,CAAC;CAEtB,MAAM,eAAuC,EAAE;AAC/C,KAAI,UAAW,cAAa,SAAS,cAAc,QAAQ,IAAI;AAC/D,MAAK,MAAM,QAAQA,MAAa;EAC9B,MAAM,QAAQ,MAAM,KAAK;AACzB,MAAI,UAAU,KAAA,EAAW,cAAa,SAAS,cAAc,KAAK,KAAK,IAAI;;AAE7E,oBAAmB,MAAM,UAAU;AACjC,eAAa,SAAS,cAAc,KAAK,IAAI;GAC7C;CAEF,MAAM,WAAW,eACR;EACCA;EACQD;EACLE;EACT;EACA;EACA,aAAa;EACb,YAAY;EACZ;EACA;EACA;EACD,GACD,CAAC,WAAW,MAAM,CACnB;AAED,QACE,oBAAC,kBAAkB,UAAnB;EAA4B,OAAO;YACjC,oBAAC,aAAa,UAAd;GAAuB,OAAO;aAC5B,oBAAC,YAAY,UAAb;IAAsB,OAAO;cAC3B,oBAAC,mBAAmB,UAApB;KAA6B,OAAO;eAClC,oBAAC,OAAD;MACE,GAAI;MACJ,OAAO;OACL,SAAS;OACT,WAAW;OACZ;gBAED,oBAAC,OAAD,EAAS,CAAA;MACL,CAAA;KACsB,CAAA;IACT,CAAA;GACD,CAAA;EACG,CAAA;;;;;;AAQjC,MAAa,aAAiD,CAAC,gBAAgB;AAE/E,MAAa,cAAmD;EAC7D,aAAa;EACZ,MAAM;EACN,aAAa;EACd;EACA,kBAAkB;EACjB,MAAM;EACN,aAAa;EACd;EACA,0BAA0B;EACzB,MAAM;EACN,aAAa;EACd;CACF;AAED,SAAS,mBAA2C;CAClD,MAAM,MAA8B,EAAE;AACtC,MAAK,MAAM,QAAQD,KAAa,KAAI,KAAK,QAAQ,KAAK;AACtD,QAAO;;AAGT,MAAa,iBAAyD;EACnE,aAAa,gBAAgB,OAAO,IAAI,QAAQ;EAChD,kBAAkB,kBAAkB;EACpC,0BAA0B;CAC5B;;;;;;;;;;;;;AAcD,SAAS,2BAAiC;AACxC,KAAI,OAAO,aAAa,YAAa;CACrC,MAAM,UAAU,OAAO,YAAY;;;;;;;AAOnC,mBAAkB;AAClB,gBAAe;;;;;;;AAOf,SAAQ,GAAG,oBAAoB,cAAc;CAC7C,MAAM,SAAS,YAA2C;AACxD,oBAAkB;EAClB,MAAM,QAAQ,aAAa,SAAS,EAAE,CAAC;AACvC,cAAY,eAAe,MAAM,EAAE,MAAM;;CAE3C,MAAM,aAAa,YAAyD;AAC1E,MAAI,QAAQ,QAAS,OAAM,QAAQ,QAAQ;;AAE7C,SAAQ,GAAG,kBAAkB,UAAU;AACvC,SAAQ,GAAG,cAAc,UAAU;AACnC,SAAQ,GAAG,iBAAiB,UAAU;;AAGxC,0BAA0B;;;;;;;;AAS1B,SAAS,gCAAsC;AAC7C,KAAI,OAAO,aAAa,YAAa;CACrC,MAAM,UAAU,OAAO,YAAY;AACnC,UAAS,iBAAiB,mBAAmB;AAC3C,UAAQ,KAAK,wBAAwB;GACrC;;AAGJ,+BAA+B;AAsB/B,IAAI,OAAO,KAAK,IACd,QAAO,KAAK,IAAI,GAAG,YAAY,YAAyB;AACtD,KAAI,OAAO,aAAa,aAAa;EACnC,MAAM,YAAY;;oBAEJ,QAAQ,eAAe,KAAK,QAAQ,aAAa,KAAK,KAAK;eAChE,QAAQ,eAAe,KAAK,QAAQ,aAAa,KAAK,KAAK;;;;EAIpE,MAAM,OAAO,GAAG,QAAQ,IAAI,IAAI;EAChC,IAAI,QAAQ,SAAS,eAAe,iBAAiB;AACrD,MAAI,CAAC,OAAO;AACV,WAAQ,SAAS,cAAc,QAAQ;AACvC,SAAM,KAAK;AACX,YAAS,KAAK,YAAY,MAAM;;AAElC,MAAI,MAAM,gBAAgB,KAAM,OAAM,cAAc;;CAEtD,MAAM,UAAU,OAAO,YAAY;AACnC,SAAQ,KAAK,YAAY;EACvB,MAAM,QAAQ;EACd,cAAc,QAAQ;EACtB,SAAS,QAAQ;EACjB,QAAQ,QAAQ;EAChB,cAAc,QAAQ;EACtB,gBAAgB,QAAQ;EACxB,aAAa,QAAQ;EACrB,cAAc,QAAQ;EACvB,CAAC;AACF,SAAQ,KAAK,sBAAsB,QAAQ;EAC3C"}