@unpunnyfuns/swatchbook-addon 0.54.0 → 0.56.0

package/dist/{constants-B31xFInv.mjs → constants-Kiuu63Ks.mjs}

@@ -1,7 +1,6 @@
 //#region src/constants.ts
 const ADDON_ID = "swatchbook";
 const TOOL_ID = `${ADDON_ID}/theme-switcher`;
-const PARAM_KEY = "swatchbook";
 /** Canonical active-permutation tuple: `Record<axisName, contextName>`. Read by toolbar, panel, blocks. */
 const AXES_GLOBAL_KEY = "swatchbookAxes";
 /** Display-only color format for blocks (`hex` | `rgb` | `hsl` | `oklch` | `raw`). Emitted CSS is unaffected. */
@@ -43,6 +42,6 @@ const TOKENS_UPDATED_EVENT = "swatchbook/tokens-updated";
 * plugin doesn't need a Storybook-channel dependency. */
 const HMR_EVENT = "swatchbook/tokens-updated";
 //#endregion
-export { INIT_EVENT as a, PARAM_KEY as c, RESOLVED_VIRTUAL_MODULE_ID as d, STYLE_ELEMENT_ID as f, VIRTUAL_MODULE_ID as h, HMR_EVENT as i, PREVIEW_MOUSEDOWN_EVENT as l, TOOL_ID as m, AXES_GLOBAL_KEY as n, INIT_REQUEST_EVENT as o, TOKENS_UPDATED_EVENT as p, COLOR_FORMAT_GLOBAL_KEY as r, INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID as s, ADDON_ID as t, RESOLVED_INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID as u };
+export { INIT_EVENT as a, PREVIEW_MOUSEDOWN_EVENT as c, STYLE_ELEMENT_ID as d, TOKENS_UPDATED_EVENT as f, HMR_EVENT as i, RESOLVED_INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID as l, VIRTUAL_MODULE_ID as m, AXES_GLOBAL_KEY as n, INIT_REQUEST_EVENT as o, TOOL_ID as p, COLOR_FORMAT_GLOBAL_KEY as r, INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID as s, ADDON_ID as t, RESOLVED_VIRTUAL_MODULE_ID as u };
 
-//# sourceMappingURL=constants-B31xFInv.mjs.map
+//# sourceMappingURL=constants-Kiuu63Ks.mjs.map

package/dist/{constants-B31xFInv.mjs.map → constants-Kiuu63Ks.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"constants-B31xFInv.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-permutation tuple: `Record<axisName, contextName>`. Read by toolbar, panel, blocks. */\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,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"}
+{"version":3,"file":"constants-Kiuu63Ks.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-permutation tuple: `Record<axisName, contextName>`. Read by toolbar, panel, blocks. */\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;;AAGnC,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/hooks/index.d.mts

@@ -21,15 +21,19 @@ interface TokenInfo {
 }
 /**
  * Read a DTCG token for the currently active theme. Re-reads on theme
- * switch via the addon's `PermutationContext`. Returns `{ value, cssVar, type,
- * description }`.
+ * switch via the addon's `SwatchbookContext`. Returns `{ value, cssVar,
+ * type, description }`.
  *
  * Typed paths appear automatically once `.swatchbook/tokens.d.ts` is
  * generated (happens on first storybook start/build). Until then
  * `TokenPath` is `string`.
  *
  * Safe to call in autodocs / MDX renders — uses plain React context, not
- * Storybook's preview-only hooks.
+ * Storybook's preview-only hooks. Reads from the addon-provided
+ * `SwatchbookContext` when present (preferred — uses the lifted
+ * `resolveAt` accessor and the live active tuple); falls back to the
+ * virtual module's eager `permutationsResolved` lookup keyed by the
+ * default permutation name when no provider is mounted.
  */
 declare function useToken(path: TokenPath): TokenInfo;
 //#endregion

package/dist/hooks/index.mjs

@@ -1,27 +1,41 @@
-import { cssVarPrefix, defaultPermutation, permutationsResolved } from "virtual:swatchbook/tokens";
-import { useActivePermutation } from "@unpunnyfuns/swatchbook-blocks";
+import { buildResolveAt } from "@unpunnyfuns/swatchbook-core/resolve-at";
+import { axes, cells, cssVarPrefix, defaultTuple, jointOverrides } from "virtual:swatchbook/tokens";
+import { useActiveAxes, useOptionalSwatchbookData } from "@unpunnyfuns/swatchbook-blocks";
+import { makeCssVar } from "@unpunnyfuns/swatchbook-core/css-var";
 //#region src/hooks/use-token.ts
-function makeCssVar(path, prefix) {
-	const tail = path.replaceAll(".", "-");
-	return prefix ? `var(--${prefix}-${tail})` : `var(--${tail})`;
-}
+/**
+* Module-scope `resolveAt` for the no-provider fallback path. Built
+* once from the stable virtual-module exports — mirrors what the
+* preview decorator does for its `previewResolveAt` but lives in this
+* file so the hook can be called outside the addon's preview wrapper
+* (autodocs / MDX renders).
+*/
+const fallbackResolveAt = buildResolveAt(axes, cells, jointOverrides, defaultTuple);
 /**
 * Read a DTCG token for the currently active theme. Re-reads on theme
-* switch via the addon's `PermutationContext`. Returns `{ value, cssVar, type,
-* description }`.
+* switch via the addon's `SwatchbookContext`. Returns `{ value, cssVar,
+* type, description }`.
 *
 * Typed paths appear automatically once `.swatchbook/tokens.d.ts` is
 * generated (happens on first storybook start/build). Until then
 * `TokenPath` is `string`.
 *
 * Safe to call in autodocs / MDX renders — uses plain React context, not
-* Storybook's preview-only hooks.
+* Storybook's preview-only hooks. Reads from the addon-provided
+* `SwatchbookContext` when present (preferred — uses the lifted
+* `resolveAt` accessor and the live active tuple); falls back to the
+* virtual module's eager `permutationsResolved` lookup keyed by the
+* default permutation name when no provider is mounted.
 */
 function useToken(path) {
-	const token = (permutationsResolved[useActivePermutation() || (defaultPermutation ?? "")] ?? {})[path];
+	const snapshot = useOptionalSwatchbookData();
+	const contextAxes = useActiveAxes();
+	const hasContextAxes = Object.keys(contextAxes).length > 0;
+	const prefix = snapshot?.cssVarPrefix ?? cssVarPrefix;
+	const token = (snapshot?.resolveAt ?? fallbackResolveAt)(hasContextAxes ? contextAxes : snapshot?.defaultTuple ?? defaultTuple)[path];
 	const info = {
 		value: token?.$value,
-		cssVar: makeCssVar(path, cssVarPrefix)
+		cssVar: makeCssVar(path, prefix)
 	};
 	if (token?.$type) info.type = token.$type;
 	if (token?.$description) info.description = token.$description;

package/dist/hooks/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/hooks/use-token.ts"],"sourcesContent":["import { cssVarPrefix, defaultPermutation, permutationsResolved } from 'virtual:swatchbook/tokens';\nimport { useActivePermutation } from '@unpunnyfuns/swatchbook-blocks';\n\n/**\n * Consumers augment this interface (via the addon's generated\n * `.swatchbook/tokens.d.ts`) to narrow {@link useToken}'s first parameter\n * to their project's actual token paths. Without augmentation it's empty\n * and {@link TokenPath} falls back to `string`.\n */\nexport interface SwatchbookTokenMap {}\n\ntype KnownPath = keyof SwatchbookTokenMap;\n\n/** Union of known token paths, or `string` when the addon codegen hasn't run. */\nexport type TokenPath = [KnownPath] extends [never] ? string : KnownPath;\n\nexport interface TokenInfo {\n  /** The resolved DTCG `$value`. Shape varies by `$type`. */\n  value: unknown;\n  /** `var(--prefix-token-path)` reference, ready to drop into any CSS value. */\n  cssVar: string;\n  /** DTCG `$type` of the token, if known. */\n  type?: string;\n  /** Optional DTCG `$description`. */\n  description?: string;\n}\n\nfunction makeCssVar(path: string, prefix: string): string {\n  const tail = path.replaceAll('.', '-');\n  return prefix ? `var(--${prefix}-${tail})` : `var(--${tail})`;\n}\n\n/**\n * Read a DTCG token for the currently active theme. Re-reads on theme\n * switch via the addon's `PermutationContext`. Returns `{ value, cssVar, type,\n * description }`.\n *\n * Typed paths appear automatically once `.swatchbook/tokens.d.ts` is\n * generated (happens on first storybook start/build). Until then\n * `TokenPath` is `string`.\n *\n * Safe to call in autodocs / MDX renders — uses plain React context, not\n * Storybook's preview-only hooks.\n */\nexport function useToken(path: TokenPath): TokenInfo {\n  const contextPermutation = useActivePermutation();\n  const permutationName = contextPermutation || (defaultPermutation ?? '');\n  const tokens = permutationsResolved[permutationName] ?? {};\n  const token = tokens[path];\n  const info: TokenInfo = {\n    value: token?.$value,\n    cssVar: makeCssVar(path, cssVarPrefix),\n  };\n  if (token?.$type) info.type = token.$type;\n  if (token?.$description) info.description = token.$description;\n  return info;\n}\n"],"mappings":";;;AA2BA,SAAS,WAAW,MAAc,QAAwB;CACxD,MAAM,OAAO,KAAK,WAAW,KAAK,IAAI;AACtC,QAAO,SAAS,SAAS,OAAO,GAAG,KAAK,KAAK,SAAS,KAAK;;;;;;;;;;;;;;AAe7D,SAAgB,SAAS,MAA4B;CAInD,MAAM,SADS,qBAFY,sBAAsB,KACF,sBAAsB,QACb,EAAE,EACrC;CACrB,MAAM,OAAkB;EACtB,OAAO,OAAO;EACd,QAAQ,WAAW,MAAM,aAAa;EACvC;AACD,KAAI,OAAO,MAAO,MAAK,OAAO,MAAM;AACpC,KAAI,OAAO,aAAc,MAAK,cAAc,MAAM;AAClD,QAAO"}
+{"version":3,"file":"index.mjs","names":["virtualAxes","virtualCells","virtualJointOverrides","virtualDefaultTuple","virtualCssVarPrefix"],"sources":["../../src/hooks/use-token.ts"],"sourcesContent":["import {\n  axes as virtualAxes,\n  cells as virtualCells,\n  cssVarPrefix as virtualCssVarPrefix,\n  defaultTuple as virtualDefaultTuple,\n  jointOverrides as virtualJointOverrides,\n} from 'virtual:swatchbook/tokens';\nimport { buildResolveAt } from '@unpunnyfuns/swatchbook-core/resolve-at';\nimport { makeCssVar } from '@unpunnyfuns/swatchbook-core/css-var';\nimport type {\n  Axis as CoreAxis,\n  Cells as CoreCells,\n  JointOverrides,\n} from '@unpunnyfuns/swatchbook-core';\nimport { useActiveAxes, useOptionalSwatchbookData } from '@unpunnyfuns/swatchbook-blocks';\n\n/**\n * Module-scope `resolveAt` for the no-provider fallback path. Built\n * once from the stable virtual-module exports — mirrors what the\n * preview decorator does for its `previewResolveAt` but lives in this\n * file so the hook can be called outside the addon's preview wrapper\n * (autodocs / MDX renders).\n */\nconst fallbackResolveAt = buildResolveAt(\n  virtualAxes as readonly CoreAxis[],\n  virtualCells as CoreCells,\n  virtualJointOverrides as JointOverrides,\n  virtualDefaultTuple,\n);\n\n/**\n * Consumers augment this interface (via the addon's generated\n * `.swatchbook/tokens.d.ts`) to narrow {@link useToken}'s first parameter\n * to their project's actual token paths. Without augmentation it's empty\n * and {@link TokenPath} falls back to `string`.\n */\nexport interface SwatchbookTokenMap {}\n\ntype KnownPath = keyof SwatchbookTokenMap;\n\n/** Union of known token paths, or `string` when the addon codegen hasn't run. */\nexport type TokenPath = [KnownPath] extends [never] ? string : KnownPath;\n\nexport interface TokenInfo {\n  /** The resolved DTCG `$value`. Shape varies by `$type`. */\n  value: unknown;\n  /** `var(--prefix-token-path)` reference, ready to drop into any CSS value. */\n  cssVar: string;\n  /** DTCG `$type` of the token, if known. */\n  type?: string;\n  /** Optional DTCG `$description`. */\n  description?: string;\n}\n\n/**\n * Read a DTCG token for the currently active theme. Re-reads on theme\n * switch via the addon's `SwatchbookContext`. Returns `{ value, cssVar,\n * type, description }`.\n *\n * Typed paths appear automatically once `.swatchbook/tokens.d.ts` is\n * generated (happens on first storybook start/build). Until then\n * `TokenPath` is `string`.\n *\n * Safe to call in autodocs / MDX renders — uses plain React context, not\n * Storybook's preview-only hooks. Reads from the addon-provided\n * `SwatchbookContext` when present (preferred — uses the lifted\n * `resolveAt` accessor and the live active tuple); falls back to the\n * virtual module's eager `permutationsResolved` lookup keyed by the\n * default permutation name when no provider is mounted.\n */\nexport function useToken(path: TokenPath): TokenInfo {\n  const snapshot = useOptionalSwatchbookData();\n  const contextAxes = useActiveAxes();\n  const hasContextAxes = Object.keys(contextAxes).length > 0;\n\n  const prefix = snapshot?.cssVarPrefix ?? virtualCssVarPrefix;\n  const resolver = snapshot?.resolveAt ?? fallbackResolveAt;\n  const tuple = hasContextAxes\n    ? (contextAxes as Record<string, string>)\n    : (snapshot?.defaultTuple ?? virtualDefaultTuple);\n  const token = resolver(tuple)[path] as\n    | { $value?: unknown; $type?: string; $description?: string }\n    | undefined;\n\n  const info: TokenInfo = {\n    value: token?.$value,\n    cssVar: makeCssVar(path, prefix),\n  };\n  if (token?.$type) info.type = token.$type;\n  if (token?.$description) info.description = token.$description;\n  return info;\n}\n"],"mappings":";;;;;;;;;;;;AAuBA,MAAM,oBAAoB,eACxBA,MACAC,OACAC,gBACAC,aACD;;;;;;;;;;;;;;;;;AA0CD,SAAgB,SAAS,MAA4B;CACnD,MAAM,WAAW,2BAA2B;CAC5C,MAAM,cAAc,eAAe;CACnC,MAAM,iBAAiB,OAAO,KAAK,YAAY,CAAC,SAAS;CAEzD,MAAM,SAAS,UAAU,gBAAgBC;CAKzC,MAAM,SAJW,UAAU,aAAa,mBAC1B,iBACT,cACA,UAAU,gBAAgBD,aACF,CAAC;CAI9B,MAAM,OAAkB;EACtB,OAAO,OAAO;EACd,QAAQ,WAAW,MAAM,OAAO;EACjC;AACD,KAAI,OAAO,MAAO,MAAK,OAAO,MAAM;AACpC,KAAI,OAAO,aAAc,MAAK,cAAc,MAAM;AAClD,QAAO"}

package/dist/index.d.mts

@@ -1,15 +1,8 @@
-import { t as AddonOptions } from "./options-q4CiYIs4.mjs";
+import { t as AddonOptions } from "./options-Bcekz7uL.mjs";
 import { definePreviewAddon } from "storybook/internal/csf";
 export * from "@unpunnyfuns/swatchbook-blocks";
 export * from "@unpunnyfuns/swatchbook-switcher";
 
-//#region src/constants.d.ts
-declare const ADDON_ID = "swatchbook";
-declare const PARAM_KEY = "swatchbook";
-/** Canonical active-permutation tuple: `Record<axisName, contextName>`. Read by toolbar, panel, blocks. */
-declare const AXES_GLOBAL_KEY = "swatchbookAxes";
-declare const VIRTUAL_MODULE_ID = "virtual:swatchbook/tokens";
-//#endregion
 //#region src/index.d.ts
 /**
  * CSF Next factory. Consumers call this inside
@@ -18,5 +11,5 @@ declare const VIRTUAL_MODULE_ID = "virtual:swatchbook/tokens";
  */
 declare function swatchbookAddon(): ReturnType<typeof definePreviewAddon>;
 //#endregion
-export { ADDON_ID, AXES_GLOBAL_KEY, type AddonOptions, PARAM_KEY, VIRTUAL_MODULE_ID, swatchbookAddon as default };
+export { type AddonOptions, swatchbookAddon as default };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,5 +1,4 @@
-import { i as preview_exports } from "./preview-ZVsSsSIf.mjs";
-import { c as PARAM_KEY, h as VIRTUAL_MODULE_ID, n as AXES_GLOBAL_KEY, t as ADDON_ID } from "./constants-B31xFInv.mjs";
+import { i as preview_exports } from "./preview-D4foteT9.mjs";
 import { definePreviewAddon } from "storybook/internal/csf";
 export * from "@unpunnyfuns/swatchbook-blocks";
 export * from "@unpunnyfuns/swatchbook-switcher";
@@ -13,6 +12,6 @@ function swatchbookAddon() {
 	return definePreviewAddon(preview_exports);
 }
 //#endregion
-export { ADDON_ID, AXES_GLOBAL_KEY, PARAM_KEY, VIRTUAL_MODULE_ID, swatchbookAddon as default };
+export { swatchbookAddon as default };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["previewExports"],"sources":["../src/index.ts"],"sourcesContent":["import { definePreviewAddon } from 'storybook/internal/csf';\nimport * as previewExports from '#/preview.tsx';\n\nexport { ADDON_ID, AXES_GLOBAL_KEY, PARAM_KEY, VIRTUAL_MODULE_ID } from '#/constants.ts';\nexport type { AddonOptions } from '#/options.ts';\n\n/**\n * Re-export the full user-facing surface from `@unpunnyfuns/swatchbook-blocks`\n * and `@unpunnyfuns/swatchbook-switcher` so consumers can\n * `import { TokenTable, ThemeSwitcher, useToken } from '@unpunnyfuns/swatchbook-addon'`\n * without adding the sibling packages to their own package.json. Both are\n * declared as regular dependencies of the addon, so they come along for the\n * ride. Subpath entries (`./preset`, `./manager`, `./preview`, `./hooks`)\n * still exist for Storybook's preset loader — this meta re-export is just\n * for the React / MDX consumer path.\n */\nexport * from '@unpunnyfuns/swatchbook-blocks';\nexport * from '@unpunnyfuns/swatchbook-switcher';\n\n/**\n * CSF Next factory. Consumers call this inside\n * `definePreview({ addons: [swatchbookAddon()] })` so the preview annotations\n * (decorator, globalTypes, initialGlobals) are added to the preview bundle.\n */\nexport default function swatchbookAddon(): ReturnType<typeof definePreviewAddon> {\n  return definePreviewAddon(previewExports);\n}\n"],"mappings":";;;;;;;;;;;AAwBA,SAAwB,kBAAyD;AAC/E,QAAO,mBAAmBA,gBAAe"}
+{"version":3,"file":"index.mjs","names":["previewExports"],"sources":["../src/index.ts"],"sourcesContent":["import { definePreviewAddon } from 'storybook/internal/csf';\nimport * as previewExports from '#/preview.tsx';\n\nexport type { AddonOptions } from '#/options.ts';\n\n/**\n * Re-export the full user-facing surface from `@unpunnyfuns/swatchbook-blocks`\n * and `@unpunnyfuns/swatchbook-switcher` so consumers can\n * `import { TokenTable, ThemeSwitcher, useToken } from '@unpunnyfuns/swatchbook-addon'`\n * without adding the sibling packages to their own package.json. Both are\n * declared as regular dependencies of the addon, so they come along for the\n * ride. Subpath entries (`./preset`, `./manager`, `./preview`, `./hooks`)\n * still exist for Storybook's preset loader — this meta re-export is just\n * for the React / MDX consumer path.\n */\nexport * from '@unpunnyfuns/swatchbook-blocks';\nexport * from '@unpunnyfuns/swatchbook-switcher';\n\n/**\n * CSF Next factory. Consumers call this inside\n * `definePreview({ addons: [swatchbookAddon()] })` so the preview annotations\n * (decorator, globalTypes, initialGlobals) are added to the preview bundle.\n */\nexport default function swatchbookAddon(): ReturnType<typeof definePreviewAddon> {\n  return definePreviewAddon(previewExports);\n}\n"],"mappings":";;;;;;;;;;AAuBA,SAAwB,kBAAyD;AAC/E,QAAO,mBAAmBA,gBAAe"}

package/dist/manager.mjs

@@ -1,4 +1,4 @@
-import { a as INIT_EVENT, l as PREVIEW_MOUSEDOWN_EVENT, m as TOOL_ID, n as AXES_GLOBAL_KEY, o as INIT_REQUEST_EVENT, r as COLOR_FORMAT_GLOBAL_KEY, t as ADDON_ID } from "./constants-B31xFInv.mjs";
+import { a as INIT_EVENT, c as PREVIEW_MOUSEDOWN_EVENT, n as AXES_GLOBAL_KEY, o as INIT_REQUEST_EVENT, p as TOOL_ID, r as COLOR_FORMAT_GLOBAL_KEY, t as ADDON_ID } from "./constants-Kiuu63Ks.mjs";
 import React, { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { ThemeSwitcher } from "@unpunnyfuns/swatchbook-switcher";
 import { IconButton, WithTooltipPure } from "storybook/internal/components";
@@ -119,8 +119,10 @@ function AxesToolbar() {
 	const presets = payload?.presets ?? EMPTY_PRESETS;
 	const defaults = useMemo(() => defaultTupleFor(axes), [axes]);
 	const [lastApplied, setLastApplied] = useState(null);
-	const globalTuple = globals[AXES_GLOBAL_KEY];
-	const activeColorFormat = globals["swatchbookColorFormat"] ?? "hex";
+	const rawTuple = globals[AXES_GLOBAL_KEY];
+	const globalTuple = rawTuple && typeof rawTuple === "object" ? rawTuple : void 0;
+	const rawColorFormat = globals[COLOR_FORMAT_GLOBAL_KEY];
+	const activeColorFormat = rawColorFormat === "hex" || rawColorFormat === "rgb" || rawColorFormat === "hsl" || rawColorFormat === "oklch" || rawColorFormat === "raw" ? rawColorFormat : "hex";
 	const activeTuple = useMemo(() => {
 		const out = { ...defaults };
 		if (globalTuple) for (const axis of axes) {

package/dist/manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"manager.mjs","names":["h"],"sources":["../src/ColorFormatSelector.tsx","../src/manager.tsx"],"sourcesContent":["import React, { type ReactElement } from 'react';\n\n/**\n * Storybook-addon-specific pill row for picking how color sub-values\n * render in swatchbook blocks (hex / rgb / hsl / oklch / raw). Lives in\n * the addon rather than the shared switcher because color format is a\n * blocks-rendering concern, not a theming one — the docs-site navbar\n * switcher has no consumer for it.\n *\n * Reuses the `sb-switcher__*` class names so styling stays consistent\n * with the rest of the toolbar popover. The switcher's CSS is already\n * loaded on the page because this selector only renders inside\n * `<ThemeSwitcher>`'s `footer` prop.\n *\n * Uses `React.createElement` (via `h`) to survive embedding in Storybook's\n * manager bundle, which doesn't expose `react/jsx-runtime`.\n */\n\nexport type ColorFormat = 'hex' | 'rgb' | 'hsl' | 'oklch' | 'raw';\n\nconst COLOR_FORMAT_OPTIONS: readonly { id: ColorFormat; label: string }[] = [\n  { id: 'hex', label: 'Hex' },\n  { id: 'rgb', label: 'RGB' },\n  { id: 'hsl', label: 'HSL' },\n  { id: 'oklch', label: 'OKLCH' },\n  { id: 'raw', label: 'Raw (JSON)' },\n];\n\nconst h = React.createElement;\n\nexport interface ColorFormatSelectorProps {\n  active: ColorFormat;\n  onSelect(next: ColorFormat): void;\n}\n\nexport function ColorFormatSelector({ active, onSelect }: ColorFormatSelectorProps): ReactElement {\n  return h(\n    'div',\n    null,\n    h('div', { className: 'sb-switcher__section-label' }, 'Color format'),\n    h(\n      'div',\n      { className: 'sb-switcher__section-body' },\n      ...COLOR_FORMAT_OPTIONS.map((opt) =>\n        h(\n          'button',\n          {\n            key: `color-format/${opt.id}`,\n            type: 'button',\n            onClick: () => onSelect(opt.id),\n            onMouseDown: (event: React.MouseEvent) => event.preventDefault(),\n            className:\n              opt.id === active\n                ? 'sb-switcher__pill sb-switcher__pill--active'\n                : 'sb-switcher__pill',\n          },\n          opt.label,\n        ),\n      ),\n    ),\n  );\n}\n","import { ThemeSwitcher } from '@unpunnyfuns/swatchbook-switcher';\nimport { type ColorFormat, ColorFormatSelector } from '#/ColorFormatSelector.tsx';\nimport React, { useCallback, useEffect, useMemo, useRef, useState, type ReactElement } from 'react';\nimport { IconButton, WithTooltipPure } from 'storybook/internal/components';\nimport { addons, types, useGlobals, useStorybookApi } from 'storybook/manager-api';\nimport {\n  type InitPayload,\n  type VirtualAxis as AxisEntry,\n  type VirtualPreset as PresetEntry,\n} from '#/channel-types.ts';\nimport {\n  ADDON_ID,\n  AXES_GLOBAL_KEY,\n  COLOR_FORMAT_GLOBAL_KEY,\n  INIT_EVENT,\n  INIT_REQUEST_EVENT,\n  PREVIEW_MOUSEDOWN_EVENT,\n  TOOL_ID,\n} from '#/constants.ts';\n\n/**\n * Use explicit `React.createElement` rather than JSX so the manager bundle\n * doesn't take a hard dependency on `react/jsx-runtime`. Storybook's manager\n * page injects its own React as a runtime global; `react/jsx-runtime` isn't\n * always part of that exposure, which breaks JSX with\n * \"Cannot read properties of undefined (reading 'recentlyCreatedOwnerStacks')\".\n * Mirrors the pattern `@storybook/addon-a11y` uses in its manager.\n *\n * The imported `<ThemeSwitcher>` from `@unpunnyfuns/swatchbook-switcher`\n * compiles with classic JSX (`React.createElement`) specifically so it\n * survives embedding in the manager bundle the same way.\n */\nconst h = React.createElement;\n\nconst EMPTY_AXES: readonly AxisEntry[] = [];\nconst EMPTY_PRESETS: readonly PresetEntry[] = [];\n\n/**\n * Root toolbar glyph — a split-circle (\"yinyang\") mark: a faint filled\n * disc for the full-swatch silhouette, with a darker half-and-inset-disc\n * path reading as a pair of theme variants swapped in place.\n */\nfunction SwatchbookIcon(): ReactElement {\n  return h(\n    'svg',\n    { width: 14, height: 14, viewBox: '0 0 14 14', 'aria-hidden': true },\n    h('circle', { cx: 7, cy: 7, r: 6, fill: 'currentColor', opacity: 0.15 }),\n    h('path', {\n      d: 'M7 1a6 6 0 0 0 0 12 3 3 0 0 0 0-6 3 3 0 0 1 0-6Z',\n      fill: 'currentColor',\n    }),\n  );\n}\n\nfunction defaultTupleFor(axes: readonly AxisEntry[]): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const axis of axes) out[axis.name] = axis.default;\n  return out;\n}\n\n/**\n * Compose a preset's sanitized partial tuple with the axis defaults, so\n * applying a preset that only names some axes leaves the omitted ones at\n * their defaults (not blank). Mirrors the preview decorator's own fallback\n * logic so what the toolbar sends out is what the decorator honors.\n */\nfunction presetTuple(\n  preset: PresetEntry,\n  axes: readonly AxisEntry[],\n  defaults: Readonly<Record<string, string>>,\n): Record<string, string> {\n  const out: Record<string, string> = { ...defaults };\n  for (const axis of axes) {\n    const candidate = preset.axes[axis.name];\n    if (candidate !== undefined && axis.contexts.includes(candidate)) {\n      out[axis.name] = candidate;\n    }\n  }\n  return out;\n}\n\nfunction AxesToolbar(): ReactElement {\n  const [globals, updateGlobals] = useGlobals();\n  const api = useStorybookApi();\n  const [payload, setPayload] = useState<InitPayload | null>(null);\n  const [open, setOpen] = useState(false);\n  const bodyRef = useRef<HTMLDivElement | null>(null);\n\n  useEffect(() => {\n    const channel = addons.getChannel();\n    const onInit = (next: InitPayload): void => setPayload(next);\n    channel.on(INIT_EVENT, onInit);\n    /**\n     * Ask the preview to (re-)emit INIT_EVENT in case it already broadcast\n     * before this effect subscribed. Without this request, a late-mounting\n     * manager (story navigation, docs reload) can stay in \"loading…\" until\n     * the user triggers a globals change.\n     */\n    channel.emit(INIT_REQUEST_EVENT);\n    return () => {\n      channel.off(INIT_EVENT, onInit);\n    };\n  }, []);\n\n  const axes = payload?.axes ?? EMPTY_AXES;\n  const presets = payload?.presets ?? EMPTY_PRESETS;\n  const defaults = useMemo(() => defaultTupleFor(axes), [axes]);\n  const [lastApplied, setLastApplied] = useState<string | null>(null);\n  const globalTuple = globals[AXES_GLOBAL_KEY] as Record<string, string> | undefined;\n  const activeColorFormat = ((globals[COLOR_FORMAT_GLOBAL_KEY] as string | undefined) ??\n    'hex') as ColorFormat;\n\n  const activeTuple = useMemo<Record<string, string>>(() => {\n    const out: Record<string, string> = { ...defaults };\n    if (globalTuple) {\n      for (const axis of axes) {\n        const candidate = globalTuple[axis.name];\n        if (candidate !== undefined && axis.contexts.includes(candidate)) {\n          out[axis.name] = candidate;\n        }\n      }\n    }\n    return out;\n  }, [axes, defaults, globalTuple]);\n\n  const setAxis = useCallback(\n    (axisName: string, next: string): void => {\n      const tuple: Record<string, string> = { ...activeTuple, [axisName]: next };\n      updateGlobals({ [AXES_GLOBAL_KEY]: tuple });\n    },\n    [activeTuple, updateGlobals],\n  );\n\n  const applyPreset = useCallback(\n    (preset: PresetEntry): void => {\n      const tuple = presetTuple(preset, axes, defaults);\n      updateGlobals({ [AXES_GLOBAL_KEY]: tuple });\n      setLastApplied(preset.name);\n    },\n    [axes, defaults, updateGlobals],\n  );\n\n  useEffect(() => {\n    if (presets.length === 0) return;\n    // `alt+shift+C` rather than `alt+T` — the latter conflicts with\n    // Storybook's built-in \"toggle addon panel\" binding on some\n    // platforms. Rebindable from Storybook's keyboard-shortcuts panel.\n    api.setAddonShortcut(ADDON_ID, {\n      label: `Cycle swatchbook presets (${presets.length})`,\n      defaultShortcut: ['alt', 'shift', 'C'],\n      actionName: 'cyclePreset',\n      showInMenu: true,\n      action: () => {\n        const currentIdx = lastApplied\n          ? presets.findIndex((preset) => preset.name === lastApplied)\n          : -1;\n        const next = presets[(currentIdx + 1) % presets.length];\n        if (next) applyPreset(next);\n      },\n    });\n  }, [api, presets, lastApplied, applyPreset]);\n\n  const handleKeyDown = useCallback((event: React.KeyboardEvent<HTMLDivElement>): void => {\n    if (event.key === 'Escape') {\n      event.stopPropagation();\n      setOpen(false);\n    }\n  }, []);\n\n  /**\n   * Escape closes even when focus hasn't entered the popover yet (e.g. the\n   * user opened it via click and the mouse is still over the canvas). We\n   * attach a document-level listener when open.\n   */\n  useEffect(() => {\n    if (!open) return;\n    const onDocKey = (e: KeyboardEvent): void => {\n      if (e.key === 'Escape') setOpen(false);\n    };\n    document.addEventListener('keydown', onDocKey);\n    return () => document.removeEventListener('keydown', onDocKey);\n  }, [open]);\n\n  /**\n   * `WithTooltipPure`'s built-in `closeOnOutsideClick` misses some cases\n   * (portaled popover + manager iframe boundaries). Belt-and-suspenders:\n   * close when the user mouses down anywhere that isn't the trigger wrapper\n   * or the popover body.\n   */\n  useEffect(() => {\n    if (!open) return;\n    const onDocMouseDown = (e: MouseEvent): void => {\n      const target = e.target;\n      if (!(target instanceof Element)) return;\n      if (bodyRef.current?.contains(target)) return;\n      if (target.closest('[data-testid=\"swatchbook-switcher\"]')) return;\n      setOpen(false);\n    };\n    /**\n     * The manager's document-level listener above can't see mousedowns\n     * inside the preview iframe. Preview emits PREVIEW_MOUSEDOWN_EVENT on\n     * every mousedown over its own document; listen for it here so\n     * clicking the canvas / docs page also closes the popover.\n     */\n    const channel = addons.getChannel();\n    const onPreviewMouseDown = (): void => setOpen(false);\n    document.addEventListener('mousedown', onDocMouseDown);\n    channel.on(PREVIEW_MOUSEDOWN_EVENT, onPreviewMouseDown);\n    return () => {\n      document.removeEventListener('mousedown', onDocMouseDown);\n      channel.off(PREVIEW_MOUSEDOWN_EVENT, onPreviewMouseDown);\n    };\n  }, [open]);\n\n  if (axes.length === 0) {\n    return h(\n      IconButton,\n      { key: TOOL_ID, title: 'Swatchbook theme (loading…)', disabled: true },\n      h(SwatchbookIcon),\n    );\n  }\n\n  const summary = axes.map((a) => activeTuple[a.name] ?? a.default).join(' · ');\n  const title = `Swatchbook · ${summary}`;\n\n  const button = h(\n    IconButton,\n    {\n      key: TOOL_ID,\n      title,\n      active: open,\n      onClick: () => setOpen((prev) => !prev),\n      // Screen-reader disclosure semantics for the popover trigger. We\n      // don't set `aria-controls` because the popover is portaled by\n      // Storybook's `WithTooltipPure` with a dynamically-generated id we\n      // don't have a stable handle on; `aria-haspopup` + `aria-expanded`\n      // is the practical subset of the disclosure pattern.\n      'aria-haspopup': 'dialog' as const,\n      'aria-expanded': open,\n    },\n    h(SwatchbookIcon),\n  );\n\n  const tooltipBody = h(ThemeSwitcher, {\n    axes,\n    presets,\n    activeTuple,\n    defaults,\n    lastApplied,\n    onAxisChange: setAxis,\n    onPresetApply: applyPreset,\n    onKeyDown: handleKeyDown,\n    /**\n     * Color format is addon-local chrome — drives how swatchbook blocks\n     * stringify colors inside stories and docs. Slotted through the\n     * switcher's `footer` escape hatch so shared theming UI stays free\n     * of this concern.\n     */\n    footer: h(ColorFormatSelector, {\n      active: activeColorFormat,\n      onSelect: (next: ColorFormat) => updateGlobals({ [COLOR_FORMAT_GLOBAL_KEY]: next }),\n    }),\n  });\n\n  return h(\n    'span',\n    { ref: bodyRef, style: { display: 'inline-flex', alignItems: 'center' } },\n    h(WithTooltipPure, {\n      placement: 'bottom',\n      trigger: 'click',\n      visible: open,\n      onVisibleChange: (next: boolean) => setOpen(next),\n      closeOnOutsideClick: true,\n      tooltip: tooltipBody,\n      children: button,\n    }),\n  );\n}\n\naddons.register(ADDON_ID, () => {\n  addons.add(TOOL_ID, {\n    type: types.TOOL,\n    title: 'Swatchbook theme',\n    match: ({ viewMode, tabId }) => !tabId && (viewMode === 'story' || viewMode === 'docs'),\n    render: () => h(AxesToolbar),\n  });\n});\n"],"mappings":"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"}
+{"version":3,"file":"manager.mjs","names":["h"],"sources":["../src/ColorFormatSelector.tsx","../src/manager.tsx"],"sourcesContent":["import React, { type ReactElement } from 'react';\n\n/**\n * Storybook-addon-specific pill row for picking how color sub-values\n * render in swatchbook blocks (hex / rgb / hsl / oklch / raw). Lives in\n * the addon rather than the shared switcher because color format is a\n * blocks-rendering concern, not a theming one — the docs-site navbar\n * switcher has no consumer for it.\n *\n * Reuses the `sb-switcher__*` class names so styling stays consistent\n * with the rest of the toolbar popover. The switcher's CSS is already\n * loaded on the page because this selector only renders inside\n * `<ThemeSwitcher>`'s `footer` prop.\n *\n * Uses `React.createElement` (via `h`) to survive embedding in Storybook's\n * manager bundle, which doesn't expose `react/jsx-runtime`.\n */\n\nexport type ColorFormat = 'hex' | 'rgb' | 'hsl' | 'oklch' | 'raw';\n\nconst COLOR_FORMAT_OPTIONS: readonly { id: ColorFormat; label: string }[] = [\n  { id: 'hex', label: 'Hex' },\n  { id: 'rgb', label: 'RGB' },\n  { id: 'hsl', label: 'HSL' },\n  { id: 'oklch', label: 'OKLCH' },\n  { id: 'raw', label: 'Raw (JSON)' },\n];\n\nconst h = React.createElement;\n\nexport interface ColorFormatSelectorProps {\n  active: ColorFormat;\n  onSelect(next: ColorFormat): void;\n}\n\nexport function ColorFormatSelector({ active, onSelect }: ColorFormatSelectorProps): ReactElement {\n  return h(\n    'div',\n    null,\n    h('div', { className: 'sb-switcher__section-label' }, 'Color format'),\n    h(\n      'div',\n      { className: 'sb-switcher__section-body' },\n      ...COLOR_FORMAT_OPTIONS.map((opt) =>\n        h(\n          'button',\n          {\n            key: `color-format/${opt.id}`,\n            type: 'button',\n            onClick: () => onSelect(opt.id),\n            onMouseDown: (event: React.MouseEvent) => event.preventDefault(),\n            className:\n              opt.id === active\n                ? 'sb-switcher__pill sb-switcher__pill--active'\n                : 'sb-switcher__pill',\n          },\n          opt.label,\n        ),\n      ),\n    ),\n  );\n}\n","import { ThemeSwitcher } from '@unpunnyfuns/swatchbook-switcher';\nimport { type ColorFormat, ColorFormatSelector } from '#/ColorFormatSelector.tsx';\nimport React, { useCallback, useEffect, useMemo, useRef, useState, type ReactElement } from 'react';\nimport { IconButton, WithTooltipPure } from 'storybook/internal/components';\nimport { addons, types, useGlobals, useStorybookApi } from 'storybook/manager-api';\nimport {\n  type InitPayload,\n  type VirtualAxis as AxisEntry,\n  type VirtualPreset as PresetEntry,\n} from '#/channel-types.ts';\nimport {\n  ADDON_ID,\n  AXES_GLOBAL_KEY,\n  COLOR_FORMAT_GLOBAL_KEY,\n  INIT_EVENT,\n  INIT_REQUEST_EVENT,\n  PREVIEW_MOUSEDOWN_EVENT,\n  TOOL_ID,\n} from '#/constants.ts';\n\n/**\n * Use explicit `React.createElement` rather than JSX so the manager bundle\n * doesn't take a hard dependency on `react/jsx-runtime`. Storybook's manager\n * page injects its own React as a runtime global; `react/jsx-runtime` isn't\n * always part of that exposure, which breaks JSX with\n * \"Cannot read properties of undefined (reading 'recentlyCreatedOwnerStacks')\".\n * Mirrors the pattern `@storybook/addon-a11y` uses in its manager.\n *\n * The imported `<ThemeSwitcher>` from `@unpunnyfuns/swatchbook-switcher`\n * compiles with classic JSX (`React.createElement`) specifically so it\n * survives embedding in the manager bundle the same way.\n */\nconst h = React.createElement;\n\nconst EMPTY_AXES: readonly AxisEntry[] = [];\nconst EMPTY_PRESETS: readonly PresetEntry[] = [];\n\n/**\n * Root toolbar glyph — a split-circle (\"yinyang\") mark: a faint filled\n * disc for the full-swatch silhouette, with a darker half-and-inset-disc\n * path reading as a pair of theme variants swapped in place.\n */\nfunction SwatchbookIcon(): ReactElement {\n  return h(\n    'svg',\n    { width: 14, height: 14, viewBox: '0 0 14 14', 'aria-hidden': true },\n    h('circle', { cx: 7, cy: 7, r: 6, fill: 'currentColor', opacity: 0.15 }),\n    h('path', {\n      d: 'M7 1a6 6 0 0 0 0 12 3 3 0 0 0 0-6 3 3 0 0 1 0-6Z',\n      fill: 'currentColor',\n    }),\n  );\n}\n\nfunction defaultTupleFor(axes: readonly AxisEntry[]): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const axis of axes) out[axis.name] = axis.default;\n  return out;\n}\n\n/**\n * Compose a preset's sanitized partial tuple with the axis defaults, so\n * applying a preset that only names some axes leaves the omitted ones at\n * their defaults (not blank). Mirrors the preview decorator's own fallback\n * logic so what the toolbar sends out is what the decorator honors.\n */\nfunction presetTuple(\n  preset: PresetEntry,\n  axes: readonly AxisEntry[],\n  defaults: Readonly<Record<string, string>>,\n): Record<string, string> {\n  const out: Record<string, string> = { ...defaults };\n  for (const axis of axes) {\n    const candidate = preset.axes[axis.name];\n    if (candidate !== undefined && axis.contexts.includes(candidate)) {\n      out[axis.name] = candidate;\n    }\n  }\n  return out;\n}\n\nfunction AxesToolbar(): ReactElement {\n  const [globals, updateGlobals] = useGlobals();\n  const api = useStorybookApi();\n  const [payload, setPayload] = useState<InitPayload | null>(null);\n  const [open, setOpen] = useState(false);\n  const bodyRef = useRef<HTMLDivElement | null>(null);\n\n  useEffect(() => {\n    const channel = addons.getChannel();\n    const onInit = (next: InitPayload): void => setPayload(next);\n    channel.on(INIT_EVENT, onInit);\n    /**\n     * Ask the preview to (re-)emit INIT_EVENT in case it already broadcast\n     * before this effect subscribed. Without this request, a late-mounting\n     * manager (story navigation, docs reload) can stay in \"loading…\" until\n     * the user triggers a globals change.\n     */\n    channel.emit(INIT_REQUEST_EVENT);\n    return () => {\n      channel.off(INIT_EVENT, onInit);\n    };\n  }, []);\n\n  const axes = payload?.axes ?? EMPTY_AXES;\n  const presets = payload?.presets ?? EMPTY_PRESETS;\n  const defaults = useMemo(() => defaultTupleFor(axes), [axes]);\n  const [lastApplied, setLastApplied] = useState<string | null>(null);\n  const rawTuple = globals[AXES_GLOBAL_KEY];\n  const globalTuple =\n    rawTuple && typeof rawTuple === 'object' ? (rawTuple as Record<string, string>) : undefined;\n  const rawColorFormat = globals[COLOR_FORMAT_GLOBAL_KEY];\n  const activeColorFormat: ColorFormat =\n    rawColorFormat === 'hex' ||\n    rawColorFormat === 'rgb' ||\n    rawColorFormat === 'hsl' ||\n    rawColorFormat === 'oklch' ||\n    rawColorFormat === 'raw'\n      ? rawColorFormat\n      : 'hex';\n\n  const activeTuple = useMemo<Record<string, string>>(() => {\n    const out: Record<string, string> = { ...defaults };\n    if (globalTuple) {\n      for (const axis of axes) {\n        const candidate = globalTuple[axis.name];\n        if (candidate !== undefined && axis.contexts.includes(candidate)) {\n          out[axis.name] = candidate;\n        }\n      }\n    }\n    return out;\n  }, [axes, defaults, globalTuple]);\n\n  const setAxis = useCallback(\n    (axisName: string, next: string): void => {\n      const tuple: Record<string, string> = { ...activeTuple, [axisName]: next };\n      updateGlobals({ [AXES_GLOBAL_KEY]: tuple });\n    },\n    [activeTuple, updateGlobals],\n  );\n\n  const applyPreset = useCallback(\n    (preset: PresetEntry): void => {\n      const tuple = presetTuple(preset, axes, defaults);\n      updateGlobals({ [AXES_GLOBAL_KEY]: tuple });\n      setLastApplied(preset.name);\n    },\n    [axes, defaults, updateGlobals],\n  );\n\n  useEffect(() => {\n    if (presets.length === 0) return;\n    // `alt+shift+C` rather than `alt+T` — the latter conflicts with\n    // Storybook's built-in \"toggle addon panel\" binding on some\n    // platforms. Rebindable from Storybook's keyboard-shortcuts panel.\n    api.setAddonShortcut(ADDON_ID, {\n      label: `Cycle swatchbook presets (${presets.length})`,\n      defaultShortcut: ['alt', 'shift', 'C'],\n      actionName: 'cyclePreset',\n      showInMenu: true,\n      action: () => {\n        const currentIdx = lastApplied\n          ? presets.findIndex((preset) => preset.name === lastApplied)\n          : -1;\n        const next = presets[(currentIdx + 1) % presets.length];\n        if (next) applyPreset(next);\n      },\n    });\n  }, [api, presets, lastApplied, applyPreset]);\n\n  const handleKeyDown = useCallback((event: React.KeyboardEvent<HTMLDivElement>): void => {\n    if (event.key === 'Escape') {\n      event.stopPropagation();\n      setOpen(false);\n    }\n  }, []);\n\n  /**\n   * Escape closes even when focus hasn't entered the popover yet (e.g. the\n   * user opened it via click and the mouse is still over the canvas). We\n   * attach a document-level listener when open.\n   */\n  useEffect(() => {\n    if (!open) return;\n    const onDocKey = (e: KeyboardEvent): void => {\n      if (e.key === 'Escape') setOpen(false);\n    };\n    document.addEventListener('keydown', onDocKey);\n    return () => document.removeEventListener('keydown', onDocKey);\n  }, [open]);\n\n  /**\n   * `WithTooltipPure`'s built-in `closeOnOutsideClick` misses some cases\n   * (portaled popover + manager iframe boundaries). Belt-and-suspenders:\n   * close when the user mouses down anywhere that isn't the trigger wrapper\n   * or the popover body.\n   */\n  useEffect(() => {\n    if (!open) return;\n    const onDocMouseDown = (e: MouseEvent): void => {\n      const target = e.target;\n      if (!(target instanceof Element)) return;\n      if (bodyRef.current?.contains(target)) return;\n      if (target.closest('[data-testid=\"swatchbook-switcher\"]')) return;\n      setOpen(false);\n    };\n    /**\n     * The manager's document-level listener above can't see mousedowns\n     * inside the preview iframe. Preview emits PREVIEW_MOUSEDOWN_EVENT on\n     * every mousedown over its own document; listen for it here so\n     * clicking the canvas / docs page also closes the popover.\n     */\n    const channel = addons.getChannel();\n    const onPreviewMouseDown = (): void => setOpen(false);\n    document.addEventListener('mousedown', onDocMouseDown);\n    channel.on(PREVIEW_MOUSEDOWN_EVENT, onPreviewMouseDown);\n    return () => {\n      document.removeEventListener('mousedown', onDocMouseDown);\n      channel.off(PREVIEW_MOUSEDOWN_EVENT, onPreviewMouseDown);\n    };\n  }, [open]);\n\n  if (axes.length === 0) {\n    return h(\n      IconButton,\n      { key: TOOL_ID, title: 'Swatchbook theme (loading…)', disabled: true },\n      h(SwatchbookIcon),\n    );\n  }\n\n  const summary = axes.map((a) => activeTuple[a.name] ?? a.default).join(' · ');\n  const title = `Swatchbook · ${summary}`;\n\n  const button = h(\n    IconButton,\n    {\n      key: TOOL_ID,\n      title,\n      active: open,\n      onClick: () => setOpen((prev) => !prev),\n      // Screen-reader disclosure semantics for the popover trigger. We\n      // don't set `aria-controls` because the popover is portaled by\n      // Storybook's `WithTooltipPure` with a dynamically-generated id we\n      // don't have a stable handle on; `aria-haspopup` + `aria-expanded`\n      // is the practical subset of the disclosure pattern.\n      'aria-haspopup': 'dialog' as const,\n      'aria-expanded': open,\n    },\n    h(SwatchbookIcon),\n  );\n\n  const tooltipBody = h(ThemeSwitcher, {\n    axes,\n    presets,\n    activeTuple,\n    defaults,\n    lastApplied,\n    onAxisChange: setAxis,\n    onPresetApply: applyPreset,\n    onKeyDown: handleKeyDown,\n    /**\n     * Color format is addon-local chrome — drives how swatchbook blocks\n     * stringify colors inside stories and docs. Slotted through the\n     * switcher's `footer` escape hatch so shared theming UI stays free\n     * of this concern.\n     */\n    footer: h(ColorFormatSelector, {\n      active: activeColorFormat,\n      onSelect: (next: ColorFormat) => updateGlobals({ [COLOR_FORMAT_GLOBAL_KEY]: next }),\n    }),\n  });\n\n  return h(\n    'span',\n    { ref: bodyRef, style: { display: 'inline-flex', alignItems: 'center' } },\n    h(WithTooltipPure, {\n      placement: 'bottom',\n      trigger: 'click',\n      visible: open,\n      onVisibleChange: (next: boolean) => setOpen(next),\n      closeOnOutsideClick: true,\n      tooltip: tooltipBody,\n      children: button,\n    }),\n  );\n}\n\naddons.register(ADDON_ID, () => {\n  addons.add(TOOL_ID, {\n    type: types.TOOL,\n    title: 'Swatchbook theme',\n    match: ({ viewMode, tabId }) => !tabId && (viewMode === 'story' || viewMode === 'docs'),\n    render: () => h(AxesToolbar),\n  });\n});\n"],"mappings":"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"}

package/dist/options-Bcekz7uL.d.mts

@@ -0,0 +1,25 @@
+import { Config, SwatchbookIntegration } from "@unpunnyfuns/swatchbook-core";
+
+//#region src/options.d.ts
+/**
+ * Options accepted by the swatchbook preset. Either pass a full {@link Config}
+ * as `config`, or set `configPath` pointing at a module whose default export
+ * is a `Config` (supports `.ts`, `.mts`, `.js`, `.mjs` via jiti).
+ */
+interface AddonOptions {
+  /** Inline swatchbook config. Mutually exclusive with `configPath`. */
+  config?: Config;
+  /** Path to a config module, relative to the Storybook `configDir`. */
+  configPath?: string;
+  /**
+   * Display-side integrations that plug into the addon's Vite plugin.
+   * Each integration typically contributes a virtual module the
+   * preview imports — e.g. the Tailwind integration serves
+   * `virtual:swatchbook/tailwind.css`. The addon itself is
+   * tool-agnostic; integrations ship as separate packages.
+   */
+  integrations?: SwatchbookIntegration[];
+}
+//#endregion
+export { AddonOptions as t };
+//# sourceMappingURL=options-Bcekz7uL.d.mts.map

package/dist/preset.d.mts

@@ -1,4 +1,4 @@
-import { t as AddonOptions } from "./options-q4CiYIs4.mjs";
+import { t as AddonOptions } from "./options-Bcekz7uL.mjs";
 import { Project } from "@unpunnyfuns/swatchbook-core";
 import { InlineConfig } from "vite";
 

package/dist/preset.mjs

@@ -1,9 +1,10 @@
-import { d as RESOLVED_VIRTUAL_MODULE_ID, i as HMR_EVENT, u as RESOLVED_INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID } from "./constants-B31xFInv.mjs";
+import { i as HMR_EVENT, l as RESOLVED_INTEGRATION_SIDE_EFFECTS_VIRTUAL_ID, u as RESOLVED_VIRTUAL_MODULE_ID } from "./constants-Kiuu63Ks.mjs";
 import { mkdir, writeFile } from "node:fs/promises";
 import { basename, dirname, isAbsolute, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { emitAxisProjectedCss, loadProject, projectCss } from "@unpunnyfuns/swatchbook-core";
+import { emitAxisProjectedCss, loadProject } from "@unpunnyfuns/swatchbook-core";
 import { createJiti } from "jiti";
+import { snapshotForWire } from "@unpunnyfuns/swatchbook-core/snapshot-for-wire";
 import { watch } from "node:fs";
 import "picomatch";
 //#region src/virtual/plugin.ts
@@ -17,12 +18,12 @@ function resolvedId(virtualId) {
 * and diagnostics. Watches the token files + resolver for changes and
 * invalidates the module so HMR reloads the preview with fresh data.
 */
-function swatchbookTokensPlugin({ config, cwd, integrations = [], emitMode = "projected" }) {
-	let project;
-	let css = "";
+function swatchbookTokensPlugin({ config, cwd, integrations = [], initialProject }) {
+	let project = initialProject;
+	let css = project ? emitAxisProjectedCss(project) : "";
 	async function refresh() {
 		project = await loadProject(config, cwd);
-		css = composeProjectCss(project, emitMode);
+		css = emitAxisProjectedCss(project);
 	}
 	/** Map of resolvedId → integration, indexed once. */
 	const integrationById = /* @__PURE__ */ new Map();
@@ -38,6 +39,7 @@ function swatchbookTokensPlugin({ config, cwd, integrations = [], emitMode = "pr
 		name: "swatchbook:virtual-tokens",
 		enforce: "pre",
 		async buildStart() {
+			if (project) return;
 			await refresh();
 		},
 		resolveId(id) {
@@ -55,18 +57,20 @@ function swatchbookTokensPlugin({ config, cwd, integrations = [], emitMode = "pr
 			}
 			if (id !== RESOLVED_VIRTUAL_MODULE_ID) return null;
 			if (!project) return "export default null;";
+			const snap = snapshotForWire(project, css);
 			return [
 				`/* swatchbook virtual module — generated */`,
-				`export const axes = ${JSON.stringify(project.axes)};`,
-				`export const presets = ${JSON.stringify(project.presets)};`,
-				`export const disabledAxes = ${JSON.stringify(project.disabledAxes)};`,
-				`export const permutations = ${JSON.stringify(project.permutations)};`,
-				`export const defaultPermutation = ${JSON.stringify(project.permutations[0]?.name ?? null)};`,
-				`export const permutationsResolved = ${JSON.stringify(project.permutationsResolved)};`,
-				`export const diagnostics = ${JSON.stringify(project.diagnostics)};`,
-				`export const css = ${JSON.stringify(css)};`,
-				`export const cssVarPrefix = ${JSON.stringify(config.cssVarPrefix ?? "")};`,
-				`export const listing = ${JSON.stringify(slimListing(project.listing))};`
+				`export const axes = ${JSON.stringify(snap.axes)};`,
+				`export const presets = ${JSON.stringify(snap.presets)};`,
+				`export const disabledAxes = ${JSON.stringify(snap.disabledAxes)};`,
+				`export const diagnostics = ${JSON.stringify(snap.diagnostics)};`,
+				`export const css = ${JSON.stringify(snap.css)};`,
+				`export const cssVarPrefix = ${JSON.stringify(snap.cssVarPrefix)};`,
+				`export const listing = ${JSON.stringify(snap.listing)};`,
+				`export const cells = ${JSON.stringify(snap.cells)};`,
+				`export const jointOverrides = ${JSON.stringify(snap.jointOverrides)};`,
+				`export const varianceByPath = ${JSON.stringify(snap.varianceByPath)};`,
+				`export const defaultTuple = ${JSON.stringify(snap.defaultTuple)};`
 			].join("\n");
 		},
 		async configureServer(server) {
@@ -85,7 +89,7 @@ function swatchbookTokensPlugin({ config, cwd, integrations = [], emitMode = "pr
 					(async () => {
 						await refresh();
 						if (!project) return;
-						const tokenCount = Object.keys(project.permutationsResolved[project.permutations[0]?.name ?? ""] ?? {}).length;
+						const tokenCount = project.varianceByPath.size;
 						const diagCount = project.diagnostics.length;
 						server.config.logger.info(`\x1b[36m[swatchbook]\x1b[0m tokens reloaded — ${tokenCount} tokens, ${diagCount} diagnostic${diagCount === 1 ? "" : "s"}`, {
 							clear: false,
@@ -108,18 +112,7 @@ function swatchbookTokensPlugin({ config, cwd, integrations = [], emitMode = "pr
 						server.ws.send({
 							type: "custom",
 							event: HMR_EVENT,
-							data: {
-								axes: project.axes,
-								disabledAxes: project.disabledAxes,
-								presets: project.presets,
-								permutations: project.permutations,
-								defaultPermutation: project.permutations[0]?.name ?? null,
-								permutationsResolved: project.permutationsResolved,
-								diagnostics: project.diagnostics,
-								css,
-								cssVarPrefix: config.cssVarPrefix ?? "",
-								listing: slimListing(project.listing)
-							}
+							data: snapshotForWire(project, css)
 						});
 					})();
 				}, 100);
@@ -158,39 +151,6 @@ function swatchbookTokensPlugin({ config, cwd, integrations = [], emitMode = "pr
 		}
 	};
 }
-/**
-* Dispatch between the two CSS emitters based on `emitMode`. Extracted
-* from the plugin's closure so unit tests can verify the dispatch
-* without booting Vite — pass a project + mode, get the matching CSS.
-*
-* The plugin defaults to `'projected'` (the smart axis-projected
-* emitter); `'cartesian'` calls `projectCss` for explicit per-tuple
-* fan-out.
-*
-* @internal Exported for tests; not part of the public API.
-*/
-function composeProjectCss(project, emitMode = "projected") {
-	if (emitMode === "cartesian") return projectCss(project);
-	return emitAxisProjectedCss(project);
-}
-/**
-* Reduce the full Token Listing surface down to the fields blocks read.
-* Drops `originalValue` (large, not needed for display), `$value`, `$type`,
-* `mode`, `subtype` for now — the blocks don't consume them yet. Keeps the
-* virtual module payload lean, especially for large projects where each
-* token's raw listing entry can weigh a few KB.
-*/
-function slimListing(listing) {
-	const out = {};
-	for (const [path, entry] of Object.entries(listing)) {
-		const ext = entry.$extensions["app.terrazzo.listing"];
-		const slim = { names: ext.names };
-		if (ext.previewValue !== void 0) slim.previewValue = ext.previewValue;
-		if (ext.source !== void 0) slim.source = ext.source;
-		out[path] = slim;
-	}
-	return out;
-}
 //#endregion
 //#region src/preset.ts
 /**
@@ -201,13 +161,14 @@ function slimListing(listing) {
 */
 async function viteFinal(viteConfig, options) {
 	const { config, cwd } = await resolveConfig(options);
-	await writeTokenCodegen(config, cwd, options);
+	const project = await loadProject(config, cwd);
+	await writeTokenCodegen(project, options);
 	const plugins = Array.isArray(viteConfig.plugins) ? [...viteConfig.plugins] : [];
 	plugins.push(swatchbookTokensPlugin({
 		config,
 		cwd,
-		...options.integrations !== void 0 && { integrations: options.integrations },
-		...options.emitMode !== void 0 && { emitMode: options.emitMode }
+		initialProject: project,
+		...options.integrations !== void 0 && { integrations: options.integrations }
 	}));
 	return {
 		...viteConfig,
@@ -235,23 +196,17 @@ async function resolveConfig(options) {
 		cwd: dirname(absolute)
 	};
 }
-async function writeTokenCodegen(config, cwd, options) {
-	const project = await loadProject(config, cwd);
-	const outDir = resolve(resolve(options.configDir, ".."), config.outDir ?? ".swatchbook");
+async function writeTokenCodegen(project, options) {
+	const outDir = resolve(resolve(options.configDir, ".."), project.config.outDir ?? ".swatchbook");
 	await mkdir(outDir, { recursive: true });
 	const content = renderTokenTypes(project);
 	await writeFile(resolve(outDir, "tokens.d.ts"), content);
 }
 /** @internal Exported for tests; not part of the public API. */
 function renderTokenTypes(project) {
-	const paths = /* @__PURE__ */ new Set();
-	for (const theme of project.permutations) {
-		const tokens = project.permutationsResolved[theme.name];
-		if (!tokens) continue;
-		for (const path of Object.keys(tokens)) paths.add(path);
-	}
-	const tokenEntries = [...paths].toSorted().map((p) => `    ${JSON.stringify(p)}: string;`);
-	const themeUnion = project.permutations.map((t) => JSON.stringify(t.name)).join(" | ") || "string";
+	const tokenEntries = [...project.varianceByPath.keys()].toSorted().map((p) => `    ${JSON.stringify(p)}: string;`);
+	const themeNames = enumerateThemeNames(project);
+	const themeUnion = themeNames.length > 0 ? themeNames.map((n) => JSON.stringify(n)).join(" | ") : "string";
 	return [
 		"// Generated by @unpunnyfuns/swatchbook-addon. Do not edit.",
 		"declare module '@unpunnyfuns/swatchbook-addon/hooks' {",
@@ -264,6 +219,30 @@ function renderTokenTypes(project) {
 		""
 	].join("\n");
 }
+/**
+* Default tuple + one per non-default cell on each axis + each
+* preset — same set the resolver loader's singleton enumeration
+* produces.
+*/
+function enumerateThemeNames(project) {
+	if (project.axes.length === 0) return [];
+	const names = /* @__PURE__ */ new Set();
+	const tupleToName = (tuple) => project.axes.map((a) => tuple[a.name] ?? a.default).join(" · ");
+	names.add(tupleToName(project.defaultTuple));
+	for (const axis of project.axes) for (const ctx of axis.contexts) {
+		if (ctx === axis.default) continue;
+		names.add(tupleToName({
+			...project.defaultTuple,
+			[axis.name]: ctx
+		}));
+	}
+	for (const preset of project.presets) {
+		const tuple = { ...project.defaultTuple };
+		for (const [axis, ctx] of Object.entries(preset.axes)) if (ctx !== void 0) tuple[axis] = ctx;
+		names.add(tupleToName(tuple));
+	}
+	return [...names];
+}
 //#endregion
 export { managerEntries, renderTokenTypes, viteFinal };
 

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 {\n  Config,\n  ListedToken,\n  Project,\n  SwatchbookIntegration,\n  TokenListingByPath,\n} from '@unpunnyfuns/swatchbook-core';\nimport { emitAxisProjectedCss, 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   * Which CSS emitter to use for the virtual module's `css` export.\n   * `'projected'` (default) calls the smart `emitAxisProjectedCss`;\n   * `'cartesian'` calls `projectCss` for explicit per-tuple fan-out.\n   * See `AddonOptions.emitMode` for trade-offs.\n   */\n  emitMode?: 'cartesian' | 'projected';\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 permutations, 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  emitMode = 'projected',\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 = composeProjectCss(project, emitMode);\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 permutations = ${JSON.stringify(project.permutations)};`,\n        `export const defaultPermutation = ${JSON.stringify(project.permutations[0]?.name ?? null)};`,\n        `export const permutationsResolved = ${JSON.stringify(project.permutationsResolved)};`,\n        `export const diagnostics = ${JSON.stringify(project.diagnostics)};`,\n        `export const css = ${JSON.stringify(css)};`,\n        `export const cssVarPrefix = ${JSON.stringify(config.cssVarPrefix ?? '')};`,\n        `export const listing = ${JSON.stringify(slimListing(project.listing))};`,\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.permutationsResolved[project.permutations[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                permutations: project.permutations,\n                defaultPermutation: project.permutations[0]?.name ?? null,\n                permutationsResolved: project.permutationsResolved,\n                diagnostics: project.diagnostics,\n                css,\n                cssVarPrefix: config.cssVarPrefix ?? '',\n                listing: slimListing(project.listing),\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\n/**\n * Dispatch between the two CSS emitters based on `emitMode`. Extracted\n * from the plugin's closure so unit tests can verify the dispatch\n * without booting Vite — pass a project + mode, get the matching CSS.\n *\n * The plugin defaults to `'projected'` (the smart axis-projected\n * emitter); `'cartesian'` calls `projectCss` for explicit per-tuple\n * fan-out.\n *\n * @internal Exported for tests; not part of the public API.\n */\nexport function composeProjectCss(\n  project: Project,\n  emitMode: 'cartesian' | 'projected' = 'projected',\n): string {\n  if (emitMode === 'cartesian') return projectCss(project);\n  return emitAxisProjectedCss(project);\n}\n\ntype SlimListedToken = Pick<\n  ListedToken['$extensions']['app.terrazzo.listing'],\n  'names' | 'previewValue' | 'source'\n>;\n\n/**\n * Reduce the full Token Listing surface down to the fields blocks read.\n * Drops `originalValue` (large, not needed for display), `$value`, `$type`,\n * `mode`, `subtype` for now — the blocks don't consume them yet. Keeps the\n * virtual module payload lean, especially for large projects where each\n * token's raw listing entry can weigh a few KB.\n */\nfunction slimListing(listing: TokenListingByPath): Record<string, SlimListedToken> {\n  const out: Record<string, SlimListedToken> = {};\n  for (const [path, entry] of Object.entries(listing)) {\n    const ext = entry.$extensions['app.terrazzo.listing'];\n    const slim: SlimListedToken = { names: ext.names };\n    if (ext.previewValue !== undefined) slim.previewValue = ext.previewValue;\n    if (ext.source !== undefined) slim.source = ext.source;\n    out[path] = slim;\n  }\n  return out;\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      ...(options.emitMode !== undefined && { emitMode: options.emitMode }),\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.permutations) {\n    const tokens = project.permutationsResolved[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 =\n    project.permutations.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 SwatchbookPermutationName = ${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 { emitAxisProjectedCss, loadProject } from '@unpunnyfuns/swatchbook-core';\nimport { snapshotForWire } from '@unpunnyfuns/swatchbook-core/snapshot-for-wire';\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   * Pre-loaded project to use for the first `buildStart` instead of\n   * calling `loadProject` again. Lets `preset.viteFinal` share its\n   * single `loadProject` call (originally needed for codegen) with the\n   * plugin, eliminating a redundant parse pass at Storybook startup.\n   * HMR-triggered reloads still call `loadProject` directly.\n   */\n  initialProject?: Project;\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 permutations, 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  initialProject,\n}: SwatchbookPluginOptions): Plugin {\n  let project: Project | undefined = initialProject;\n  let css = project ? emitAxisProjectedCss(project) : '';\n\n  async function refresh(): Promise<void> {\n    project = await loadProject(config, cwd);\n    css = emitAxisProjectedCss(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      // Skip the redundant load when preset.viteFinal already supplied\n      // a freshly-loaded project via `initialProject`. The first HMR\n      // reload (or a manual `refresh()`) calls `loadProject` as usual.\n      if (project) return;\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. `snapshotForWire` does the field set +\n      // Map-to-Object conversion in one place; we destructure here and\n      // JSON-stringify each field for ESM export.\n      const snap = snapshotForWire(project, css);\n      return [\n        `/* swatchbook virtual module — generated */`,\n        `export const axes = ${JSON.stringify(snap.axes)};`,\n        `export const presets = ${JSON.stringify(snap.presets)};`,\n        `export const disabledAxes = ${JSON.stringify(snap.disabledAxes)};`,\n        `export const diagnostics = ${JSON.stringify(snap.diagnostics)};`,\n        `export const css = ${JSON.stringify(snap.css)};`,\n        `export const cssVarPrefix = ${JSON.stringify(snap.cssVarPrefix)};`,\n        `export const listing = ${JSON.stringify(snap.listing)};`,\n        `export const cells = ${JSON.stringify(snap.cells)};`,\n        `export const jointOverrides = ${JSON.stringify(snap.jointOverrides)};`,\n        `export const varianceByPath = ${JSON.stringify(snap.varianceByPath)};`,\n        `export const defaultTuple = ${JSON.stringify(snap.defaultTuple)};`,\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 = project.varianceByPath.size;\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: snapshotForWire(project, css),\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  // One `loadProject` call shared between codegen (needs the resolved\n  // shape to render typed token paths) and the Vite plugin (uses it\n  // for its first virtual-module render). Without sharing, the addon\n  // calls `loadProject` twice at Storybook startup — once here for\n  // codegen, once again inside the plugin's `buildStart`.\n  const project = await loadProject(config, cwd);\n  await writeTokenCodegen(project, options);\n\n  const plugins = Array.isArray(viteConfig.plugins) ? [...viteConfig.plugins] : [];\n  plugins.push(\n    swatchbookTokensPlugin({\n      config,\n      cwd,\n      initialProject: project,\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(project: Project, options: PresetOptions): Promise<void> {\n  const projectRoot = resolve(options.configDir, '..');\n  const outDir = resolve(projectRoot, project.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 sorted = [...project.varianceByPath.keys()].toSorted();\n  const tokenEntries = sorted.map((p) => `    ${JSON.stringify(p)}: string;`);\n  const themeNames = enumerateThemeNames(project);\n  const themeUnion =\n    themeNames.length > 0 ? themeNames.map((n) => JSON.stringify(n)).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 SwatchbookPermutationName = ${themeUnion};`,\n    '}',\n    '',\n  ].join('\\n');\n}\n\n/**\n * Default tuple + one per non-default cell on each axis + each\n * preset — same set the resolver loader's singleton enumeration\n * produces.\n */\nfunction enumerateThemeNames(project: Project): string[] {\n  if (project.axes.length === 0) return [];\n  const names = new Set<string>();\n  const tupleToName = (tuple: Record<string, string>): string =>\n    project.axes.map((a) => tuple[a.name] ?? a.default).join(' · ');\n  names.add(tupleToName(project.defaultTuple));\n  for (const axis of project.axes) {\n    for (const ctx of axis.contexts) {\n      if (ctx === axis.default) continue;\n      names.add(tupleToName({ ...project.defaultTuple, [axis.name]: ctx }));\n    }\n  }\n  for (const preset of project.presets) {\n    const tuple: Record<string, string> = { ...project.defaultTuple };\n    for (const [axis, ctx] of Object.entries(preset.axes)) {\n      if (ctx !== undefined) tuple[axis] = ctx;\n    }\n    names.add(tupleToName(tuple));\n  }\n  return [...names];\n}\n"],"mappings":"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"}

package/dist/{preview-ZVsSsSIf.mjs → preview-D4foteT9.mjs}

@@ -1,8 +1,10 @@
-import { a as INIT_EVENT, f as STYLE_ELEMENT_ID, i as HMR_EVENT, l as PREVIEW_MOUSEDOWN_EVENT, n as AXES_GLOBAL_KEY, o as INIT_REQUEST_EVENT, p as TOKENS_UPDATED_EVENT, r as COLOR_FORMAT_GLOBAL_KEY } from "./constants-B31xFInv.mjs";
+import { a as INIT_EVENT, c as PREVIEW_MOUSEDOWN_EVENT, d as STYLE_ELEMENT_ID, f as TOKENS_UPDATED_EVENT, i as HMR_EVENT, n as AXES_GLOBAL_KEY, o as INIT_REQUEST_EVENT, r as COLOR_FORMAT_GLOBAL_KEY } from "./constants-Kiuu63Ks.mjs";
+import { buildResolveAt } from "@unpunnyfuns/swatchbook-core/resolve-at";
 import { useEffect, useMemo } from "react";
 import { addons } from "storybook/preview-api";
+import { dataAttr } from "@unpunnyfuns/swatchbook-core/data-attr";
 import "virtual:swatchbook/integration-side-effects";
-import { axes, css, cssVarPrefix, defaultPermutation, diagnostics, disabledAxes, listing, permutations, permutationsResolved, presets } from "virtual:swatchbook/tokens";
+import { axes, cells, css, cssVarPrefix, defaultTuple, diagnostics, disabledAxes, jointOverrides, listing, presets, varianceByPath } from "virtual:swatchbook/tokens";
 import { AxesContext, COLOR_FORMATS, ColorFormatContext, PermutationContext, SwatchbookContext } from "@unpunnyfuns/swatchbook-blocks";
 import { jsx } from "react/jsx-runtime";
 //#region \0rolldown/runtime.js
@@ -17,18 +19,6 @@ var __exportAll = (all, no_symbols) => {
 	return target;
 };
 //#endregion
-//#region src/data-attr.ts
-/**
-* Produce a prefixed `data-*` attribute name when `prefix` is set, bare
-* `data-<key>` otherwise. Duplicated from `@unpunnyfuns/swatchbook-core`'s
-* `dataAttr` so the preview bundle doesn't have to import from core —
-* core's top-level entry pulls in Node-only modules (`node:fs/promises`
-* via the loader) that throw when evaluated in the browser.
-*/
-function dataAttr(prefix, key) {
-	return prefix ? `data-${prefix}-${key}` : `data-${key}`;
-}
-//#endregion
 //#region src/preview.tsx
 var preview_exports = /* @__PURE__ */ __exportAll({
 	decorators: () => decorators,
@@ -62,30 +52,29 @@ html, body {
 	if (style.textContent !== text) style.textContent = text;
 }
 /**
-* Apply `cb(axisName, value)` for every pinned (disabled) axis whose value
-* is present on any surviving theme's `input`. Disabled axes don't appear
-* in `virtualAxes`, but CSS may still reference their pinned value on
-* compound selectors — every theme that survived filtering carries the
-* same pinned context per disabled axis, so sampling any theme works.
+* Apply `cb(axisName, value)` for every pinned (disabled) axis whose
+* default-tuple value is set. `virtualDefaultTuple` carries the
+* post-filter axis defaults; disabled axes don't appear in
+* `virtualAxes` but their pinned context value still lives here, so
+* sampling it gives the same result the old "first permutation's
+* input" lookup did.
 */
 function forEachPinnedAxis(cb) {
-	const pinnedSample = permutations[0]?.input;
-	if (!pinnedSample) return;
 	for (const name of disabledAxes) {
-		const value = pinnedSample[name];
+		const value = defaultTuple[name];
 		if (value !== void 0) cb(name, value);
 	}
 }
 /**
-* Pick the theme name for a tuple, falling back to `defaultPermutation` and then
-* the first theme. Returns empty string when the project has no permutations so
-* callers can omit the attr instead of writing a made-up context name.
+* Compose a stable theme name from a tuple — the same `Light · Brand A
+* · Normal` form `permutationID` produced server-side. Used for the
+* `data-<prefix>-theme` attribute and the `swatchbook/theme` channel
+* signal. Returns empty string when there are no axes (no name to
+* write).
 */
 function matchPermutationName(tuple) {
-	return permutations.find((t) => {
-		const input = t.input;
-		return Object.keys(input).every((k) => input[k] === tuple[k]);
-	})?.name ?? defaultPermutation ?? permutations[0]?.name ?? "";
+	if (axes.length === 0) return "";
+	return axes.map((axis) => tuple[axis.name] ?? axis.default).join(" · ");
 }
 /**
 * Write the composed permutation ID to `data-<prefix>-theme` plus one
@@ -119,22 +108,39 @@ function broadcastInit() {
 		axes,
 		disabledAxes,
 		presets,
-		permutations,
-		defaultPermutation,
-		permutationsResolved,
 		diagnostics,
-		cssVarPrefix
+		cssVarPrefix,
+		cells,
+		jointOverrides,
+		varianceByPath,
+		defaultTuple
 	});
 }
 /** Axis-default tuple, used as the baseline before overrides. */
-function defaultTuple() {
+function defaultTuple$1() {
 	const out = {};
 	for (const axis of axes) out[axis.name] = axis.default;
 	return out;
 }
-/** Look up a `Permutation.input` by composed name. Returns `undefined` if no theme matches. */
+/**
+* Reverse-engineer a tuple from a `Light · Brand A · Normal`-shape
+* theme name. Splits on ` · ` and zips with `virtualAxes` in declared
+* order — matches `matchPermutationName`'s production direction so a
+* round-trip is lossless. Returns `undefined` when the segment count
+* doesn't match the axis count.
+*/
 function tupleForName(name) {
-	return permutations.find((t) => t.name === name)?.input;
+	if (!name) return void 0;
+	const parts = name.split(" · ");
+	if (parts.length !== axes.length) return void 0;
+	const out = {};
+	for (let i = 0; i < axes.length; i++) {
+		const axis = axes[i];
+		const value = parts[i];
+		if (value === void 0) return void 0;
+		out[axis.name] = value;
+	}
+	return out;
 }
 /**
 * Merge a partial tuple onto the axis defaults, dropping keys for axes that
@@ -142,7 +148,7 @@ function tupleForName(name) {
 * aren't listed on the axis.
 */
 function normalizeTuple(partial) {
-	const out = defaultTuple();
+	const out = defaultTuple$1();
 	for (const axis of axes) {
 		const candidate = partial[axis.name];
 		if (candidate !== void 0 && axis.contexts.includes(candidate)) out[axis.name] = candidate;
@@ -166,13 +172,22 @@ function resolveTuple(globals, parameters) {
 	}
 	const globalAxes = globals[AXES_GLOBAL_KEY];
 	if (globalAxes && typeof globalAxes === "object") return normalizeTuple(globalAxes);
-	return defaultTuple();
+	return defaultTuple$1();
 }
 function resolveColorFormat(globals) {
 	const raw = globals[COLOR_FORMAT_GLOBAL_KEY];
 	if (typeof raw === "string" && COLOR_FORMATS.includes(raw)) return raw;
 	return "hex";
 }
+/**
+* Single shared `resolveAt` instance for the lifetime of the preview
+* iframe. The inputs (`virtualAxes`, `virtualCells`, …) are all
+* module-level virtual-module exports with stable identity, so this
+* never needs to rebuild; downstream `ProjectSnapshot` consumers can
+* key memos on the snapshot wrapper without worrying about
+* `resolveAt` churning when Storybook recreates `context.globals`.
+*/
+const previewResolveAt = buildResolveAt(axes, cells, jointOverrides, defaultTuple);
 const themedDecorator = (Story, context) => {
 	const globals = context.globals;
 	const parameters = context.parameters;
@@ -199,14 +214,17 @@ const themedDecorator = (Story, context) => {
 		axes,
 		disabledAxes,
 		presets,
-		permutations,
-		permutationsResolved,
 		activePermutation: themeName,
 		activeAxes: tuple,
 		cssVarPrefix,
 		diagnostics,
 		css,
-		listing
+		listing,
+		cells,
+		jointOverrides,
+		varianceByPath,
+		defaultTuple,
+		resolveAt: previewResolveAt
 	}), [themeName, tuple]);
 	return /* @__PURE__ */ jsx(SwatchbookContext.Provider, {
 		value: snapshot,
@@ -288,8 +306,13 @@ function installGlobalAxisApplier() {
 		const tuple = resolveTuple(globals, {});
 		setRootAxes(matchPermutationName(tuple), tuple);
 	};
+	let lastApplied = "";
 	const onGlobals = (payload) => {
-		if (payload.globals) apply(payload.globals);
+		if (!payload.globals) return;
+		const fingerprint = matchPermutationName(resolveTuple(payload.globals, {}));
+		if (fingerprint === lastApplied) return;
+		lastApplied = fingerprint;
+		apply(payload.globals);
 	};
 	channel.on("globalsUpdated", onGlobals);
 	channel.on("setGlobals", onGlobals);
@@ -334,15 +357,16 @@ html, body {
 		axes: payload.axes,
 		disabledAxes: payload.disabledAxes,
 		presets: payload.presets,
-		permutations: payload.permutations,
-		defaultPermutation: payload.defaultPermutation,
-		permutationsResolved: payload.permutationsResolved,
 		diagnostics: payload.diagnostics,
-		cssVarPrefix: payload.cssVarPrefix
+		cssVarPrefix: payload.cssVarPrefix,
+		cells: payload.cells,
+		jointOverrides: payload.jointOverrides,
+		varianceByPath: payload.varianceByPath,
+		defaultTuple: payload.defaultTuple
 	});
 	channel.emit(TOKENS_UPDATED_EVENT, payload);
 });
 //#endregion
 export { preview_exports as i, globalTypes as n, initialGlobals as r, decorators as t };
 
-//# sourceMappingURL=preview-ZVsSsSIf.mjs.map
+//# sourceMappingURL=preview-D4foteT9.mjs.map

package/dist/preview-D4foteT9.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-D4foteT9.mjs","names":["virtualDisabledAxes","virtualDefaultTuple","virtualAxes","virtualPresets","virtualCells","virtualJointOverrides","virtualVarianceByPath","defaultTuple","virtualListing"],"sources":["../src/preview.tsx"],"sourcesContent":["/// <reference types=\"vite/client\" />\nimport { buildResolveAt } from '@unpunnyfuns/swatchbook-core/resolve-at';\nimport type {\n  Axis as CoreAxis,\n  Cells as CoreCells,\n  JointOverrides,\n} from '@unpunnyfuns/swatchbook-core';\nimport type { Decorator, Preview } from '@storybook/react-vite';\nimport { useEffect, useMemo } from 'react';\nimport { addons } from 'storybook/preview-api';\nimport { dataAttr } from '@unpunnyfuns/swatchbook-core/data-attr';\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  cells as virtualCells,\n  css,\n  cssVarPrefix,\n  defaultTuple as virtualDefaultTuple,\n  diagnostics,\n  disabledAxes as virtualDisabledAxes,\n  jointOverrides as virtualJointOverrides,\n  listing as virtualListing,\n  presets as virtualPresets,\n  varianceByPath as virtualVarianceByPath,\n} from 'virtual:swatchbook/tokens';\nimport {\n  AxesContext,\n  COLOR_FORMATS,\n  type ColorFormat,\n  ColorFormatContext,\n  type ProjectSnapshot,\n  SwatchbookContext,\n  PermutationContext,\n} from '@unpunnyfuns/swatchbook-blocks';\nimport {\n  AXES_GLOBAL_KEY,\n  COLOR_FORMAT_GLOBAL_KEY,\n  HMR_EVENT,\n  INIT_EVENT,\n  INIT_REQUEST_EVENT,\n  PREVIEW_MOUSEDOWN_EVENT,\n  STYLE_ELEMENT_ID,\n  TOKENS_UPDATED_EVENT,\n} from '#/constants.ts';\nimport type { StoryParameters, SwatchbookGlobals } from '#/globals.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\n * default-tuple value is set. `virtualDefaultTuple` carries the\n * post-filter axis defaults; disabled axes don't appear in\n * `virtualAxes` but their pinned context value still lives here, so\n * sampling it gives the same result the old \"first permutation's\n * input\" lookup did.\n */\nfunction forEachPinnedAxis(cb: (name: string, value: string) => void): void {\n  for (const name of virtualDisabledAxes) {\n    const value = virtualDefaultTuple[name];\n    if (value !== undefined) cb(name, value);\n  }\n}\n\n/**\n * Compose a stable theme name from a tuple — the same `Light · Brand A\n * · Normal` form `permutationID` produced server-side. Used for the\n * `data-<prefix>-theme` attribute and the `swatchbook/theme` channel\n * signal. Returns empty string when there are no axes (no name to\n * write).\n */\nfunction matchPermutationName(tuple: Readonly<Record<string, string>>): string {\n  if (virtualAxes.length === 0) return '';\n  return virtualAxes.map((axis) => tuple[axis.name] ?? axis.default).join(' · ');\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    diagnostics,\n    cssVarPrefix,\n    cells: virtualCells,\n    jointOverrides: virtualJointOverrides,\n    varianceByPath: virtualVarianceByPath,\n    defaultTuple: virtualDefaultTuple,\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/**\n * Reverse-engineer a tuple from a `Light · Brand A · Normal`-shape\n * theme name. Splits on ` · ` and zips with `virtualAxes` in declared\n * order — matches `matchPermutationName`'s production direction so a\n * round-trip is lossless. Returns `undefined` when the segment count\n * doesn't match the axis count.\n */\nfunction tupleForName(name: string): Record<string, string> | undefined {\n  if (!name) return undefined;\n  const parts = name.split(' · ');\n  if (parts.length !== virtualAxes.length) return undefined;\n  const out: Record<string, string> = {};\n  for (let i = 0; i < virtualAxes.length; i++) {\n    const axis = virtualAxes[i] as (typeof virtualAxes)[number];\n    const value = parts[i];\n    if (value === undefined) return undefined;\n    out[axis.name] = value;\n  }\n  return out;\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 input channels, in priority order:\n *   1. `parameters.swatchbook.axes` — per-story tuple.\n *   2. `parameters.swatchbook.permutation` — per-story composed name.\n *   3. `globals.swatchbookAxes` — toolbar-set tuple.\n *   4. virtual module default.\n */\nfunction resolveTuple(\n  globals: SwatchbookGlobals,\n  parameters: StoryParameters,\n): Record<string, string> {\n  const param = parameters.swatchbook;\n  const paramAxes = param?.axes;\n  if (paramAxes) {\n    return normalizeTuple(paramAxes);\n  }\n  if (param?.permutation) {\n    const hit = tupleForName(param.permutation);\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  return defaultTuple();\n}\n\nfunction resolveColorFormat(globals: SwatchbookGlobals): 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\n/**\n * Single shared `resolveAt` instance for the lifetime of the preview\n * iframe. The inputs (`virtualAxes`, `virtualCells`, …) are all\n * module-level virtual-module exports with stable identity, so this\n * never needs to rebuild; downstream `ProjectSnapshot` consumers can\n * key memos on the snapshot wrapper without worrying about\n * `resolveAt` churning when Storybook recreates `context.globals`.\n */\nconst previewResolveAt = buildResolveAt(\n  virtualAxes as readonly CoreAxis[],\n  virtualCells as CoreCells,\n  virtualJointOverrides as JointOverrides,\n  virtualDefaultTuple,\n);\n\nconst themedDecorator: Decorator = (Story, context) => {\n  const globals = context.globals as SwatchbookGlobals;\n  const parameters = context.parameters as StoryParameters;\n  const tuple = useMemo(() => resolveTuple(globals, parameters), [globals, parameters]);\n  const colorFormat = useMemo(() => resolveColorFormat(globals), [globals]);\n  const themeName = useMemo(() => matchPermutationName(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      activePermutation: themeName,\n      activeAxes: tuple,\n      cssVarPrefix,\n      diagnostics,\n      css,\n      listing: virtualListing,\n      cells: virtualCells,\n      jointOverrides: virtualJointOverrides,\n      varianceByPath: virtualVarianceByPath,\n      defaultTuple: virtualDefaultTuple,\n      resolveAt: previewResolveAt,\n    }),\n    [themeName, tuple],\n  );\n\n  return (\n    <SwatchbookContext.Provider value={snapshot}>\n      <PermutationContext.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      </PermutationContext.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  [AXES_GLOBAL_KEY]: {\n    name: 'Axes',\n    description: 'Per-axis context selection — the active permutation tuple.',\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  [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: SwatchbookGlobals): void => {\n    ensureStylesheet();\n    const tuple = resolveTuple(globals, {});\n    setRootAxes(matchPermutationName(tuple), tuple);\n  };\n  // Storybook fires `globalsUpdated`, `setGlobals`, and `updateGlobals`\n  // for the same logical change (preview init + every toolbar tick).\n  // Subscribing to all three is intentional — `setGlobals` carries the\n  // initial URL-persisted globals; `updateGlobals` is the toolbar\n  // signal; `globalsUpdated` is the cross-frame echo. Apply the same\n  // handler to all three but dedupe via a stringified-tuple guard so\n  // downstream `setRootAxes` + `useSyncExternalStore` consumers\n  // re-render at most once per real change instead of three times per\n  // tick.\n  let lastApplied = '';\n  const onGlobals = (payload: { globals?: SwatchbookGlobals }): void => {\n    if (!payload.globals) return;\n    const tuple = resolveTuple(payload.globals, {});\n    const fingerprint = matchPermutationName(tuple);\n    if (fingerprint === lastApplied) return;\n    lastApplied = fingerprint;\n    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  diagnostics: typeof diagnostics;\n  css: string;\n  cssVarPrefix: string;\n  listing: typeof virtualListing;\n  cells: typeof virtualCells;\n  jointOverrides: typeof virtualJointOverrides;\n  varianceByPath: typeof virtualVarianceByPath;\n  defaultTuple: typeof virtualDefaultTuple;\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      diagnostics: payload.diagnostics,\n      cssVarPrefix: payload.cssVarPrefix,\n      cells: payload.cells,\n      jointOverrides: payload.jointOverrides,\n      varianceByPath: payload.varianceByPath,\n      defaultTuple: payload.defaultTuple,\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-ZVsSsSIf.mjs";
+import { n as globalTypes, r as initialGlobals, t as decorators } from "./preview-D4foteT9.mjs";
 export { decorators, globalTypes, initialGlobals };

package/package.json

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

package/dist/options-q4CiYIs4.d.mts

@@ -1,51 +0,0 @@
-import { Config, SwatchbookIntegration } from "@unpunnyfuns/swatchbook-core";
-
-//#region src/options.d.ts
-/**
- * Options accepted by the swatchbook preset. Either pass a full {@link Config}
- * as `config`, or set `configPath` pointing at a module whose default export
- * is a `Config` (supports `.ts`, `.mts`, `.js`, `.mjs` via jiti).
- */
-interface AddonOptions {
-  /** Inline swatchbook config. Mutually exclusive with `configPath`. */
-  config?: Config;
-  /** Path to a config module, relative to the Storybook `configDir`. */
-  configPath?: string;
-  /**
-   * Display-side integrations that plug into the addon's Vite plugin.
-   * Each integration typically contributes a virtual module the
-   * preview imports — e.g. the Tailwind integration serves
-   * `virtual:swatchbook/tailwind.css`. The addon itself is
-   * tool-agnostic; integrations ship as separate packages.
-   */
-  integrations?: SwatchbookIntegration[];
-  /**
-   * Which CSS emitter populates the `css` export of
-   * `virtual:swatchbook/tokens`. Defaults to `'projected'`.
-   *
-   * - `'projected'` (default) — smart axis-projected emit
-   *   (`emitAxisProjectedCss`). One `:root` baseline block, one
-   *   `[data-<axis>="<ctx>"]` block per non-default cell (deltas only
-   *   for tokens that axis touches), and compound `[data-A][data-B]`
-   *   blocks for joint-variant tokens that need cartesian-correct
-   *   values at specific joint tuples. Output size scales with
-   *   `Σ(axes × non-default contexts × touching tokens) + joint
-   *   compound blocks` — dramatically smaller than cartesian for
-   *   typical fixtures. Spec-faithful for any DTCG-compliant
-   *   resolver: orthogonal tokens project, joint-variant tokens fall
-   *   back to compound selectors automatically.
-   * - `'cartesian'` — explicit fan-out (`projectCss`). One block per
-   *   cartesian tuple, scoped by compound
-   *   `[data-<axis>="<ctx>"][data-…]` selectors. Output scales with
-   *   the cartesian product. Pick this when you want explicit
-   *   per-tuple blocks for debugging, regression-comparison against
-   *   the projected output, or because your tooling reads them
-   *   directly. Not an escape hatch for large cardinality — at the
-   *   scales where the projection analysis is expensive, the
-   *   cartesian output is just as unmanageable.
-   */
-  emitMode?: 'cartesian' | 'projected';
-}
-//#endregion
-export { AddonOptions as t };
-//# sourceMappingURL=options-q4CiYIs4.d.mts.map

package/dist/preview-ZVsSsSIf.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"preview-ZVsSsSIf.mjs","names":["virtualDisabledAxes","virtualAxes","virtualPresets","virtualListing"],"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  defaultPermutation,\n  diagnostics,\n  disabledAxes as virtualDisabledAxes,\n  listing as virtualListing,\n  presets as virtualPresets,\n  permutations,\n  permutationsResolved,\n} from 'virtual:swatchbook/tokens';\nimport {\n  AxesContext,\n  COLOR_FORMATS,\n  type ColorFormat,\n  ColorFormatContext,\n  type ProjectSnapshot,\n  SwatchbookContext,\n  PermutationContext,\n} from '@unpunnyfuns/swatchbook-blocks';\nimport {\n  AXES_GLOBAL_KEY,\n  COLOR_FORMAT_GLOBAL_KEY,\n  HMR_EVENT,\n  INIT_EVENT,\n  INIT_REQUEST_EVENT,\n  PREVIEW_MOUSEDOWN_EVENT,\n  STYLE_ELEMENT_ID,\n  TOKENS_UPDATED_EVENT,\n} from '#/constants.ts';\nimport type { StoryParameters, SwatchbookGlobals } from '#/globals.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 = permutations[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 `defaultPermutation` and then\n * the first theme. Returns empty string when the project has no permutations so\n * callers can omit the attr instead of writing a made-up context name.\n */\nfunction matchPermutationName(tuple: Readonly<Record<string, string>>): string {\n  const match = permutations.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 ?? defaultPermutation ?? permutations[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    permutations,\n    defaultPermutation,\n    permutationsResolved,\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 `Permutation.input` by composed name. Returns `undefined` if no theme matches. */\nfunction tupleForName(name: string): Record<string, string> | undefined {\n  const match = permutations.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 input channels, in priority order:\n *   1. `parameters.swatchbook.axes` — per-story tuple.\n *   2. `parameters.swatchbook.permutation` — per-story composed name.\n *   3. `globals.swatchbookAxes` — toolbar-set tuple.\n *   4. virtual module default.\n */\nfunction resolveTuple(\n  globals: SwatchbookGlobals,\n  parameters: StoryParameters,\n): Record<string, string> {\n  const param = parameters.swatchbook;\n  const paramAxes = param?.axes;\n  if (paramAxes) {\n    return normalizeTuple(paramAxes);\n  }\n  if (param?.permutation) {\n    const hit = tupleForName(param.permutation);\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  return defaultTuple();\n}\n\nfunction resolveColorFormat(globals: SwatchbookGlobals): 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 globals = context.globals as SwatchbookGlobals;\n  const parameters = context.parameters as StoryParameters;\n  const tuple = useMemo(() => resolveTuple(globals, parameters), [globals, parameters]);\n  const colorFormat = useMemo(() => resolveColorFormat(globals), [globals]);\n  const themeName = useMemo(() => matchPermutationName(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      permutations,\n      permutationsResolved,\n      activePermutation: themeName,\n      activeAxes: tuple,\n      cssVarPrefix,\n      diagnostics,\n      css,\n      listing: virtualListing,\n    }),\n    [themeName, tuple],\n  );\n\n  return (\n    <SwatchbookContext.Provider value={snapshot}>\n      <PermutationContext.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      </PermutationContext.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  [AXES_GLOBAL_KEY]: {\n    name: 'Axes',\n    description: 'Per-axis context selection — the active permutation tuple.',\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  [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: SwatchbookGlobals): void => {\n    ensureStylesheet();\n    const tuple = resolveTuple(globals, {});\n    setRootAxes(matchPermutationName(tuple), tuple);\n  };\n  const onGlobals = (payload: { globals?: SwatchbookGlobals }): 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  permutations: typeof permutations;\n  defaultPermutation: typeof defaultPermutation;\n  permutationsResolved: typeof permutationsResolved;\n  diagnostics: typeof diagnostics;\n  css: string;\n  cssVarPrefix: string;\n  listing: typeof virtualListing;\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      permutations: payload.permutations,\n      defaultPermutation: payload.defaultPermutation,\n      permutationsResolved: payload.permutationsResolved,\n      diagnostics: payload.diagnostics,\n      cssVarPrefix: payload.cssVarPrefix,\n    });\n    channel.emit(TOKENS_UPDATED_EVENT, payload);\n  });\n}\n"],"mappings":"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"}