@razorwind/storybook 0.0.25 → 0.0.27

package/dist/index.cjs

@@ -1,5 +1,56 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});let e=require("@razorwind/core/plugin"),t=require("@razorwind/core/utils"),n=require("node:path");function r(e){return e.replaceAll(`\\`,`\\\\`).replaceAll(`"`,`\\"`).replaceAll(`
-`,`\\n`).replaceAll(`\r`,`\\r`)}function i(e){return typeof e==`string`?`"${r(e)}"`:typeof e==`number`||typeof e==`boolean`?String(e):e==null?`undefined`:JSON.stringify(e)}const a=/^(?:light|dark|dim|high-contrast|hc|default|base|theme)(?:[._-].+)?$/i;function o(e){return`$value`in e||`value`in e||`$ref`in e||`ref`in e}function s(e){if(typeof e.$description==`string`)return e.$description;if(typeof e.description==`string`)return e.description}function c(e,t){return typeof e.$type==`string`?e.$type:typeof e.type==`string`?e.type:t}function l(e){if(`$value`in e)return e.$value;if(`value`in e)return e.value;if(typeof e.$ref==`string`)return e.$ref;if(typeof e.ref==`string`)return e.ref}function u(e,n,r,i,a,d){if(!(0,t.isObject)(e))return;let f=c(e,r);if(o(e)){let r=l(e),o=n.join(`.`);d.push({path:o,type:f,value:r,cssValue:(0,t.formatTokenValue)(r,f),cssVar:(0,t.toCssVar)(o,a),description:s(e),theme:i});return}for(let[t,r]of Object.entries(e))t.startsWith(`$`)||u(r,[...n,t],f,i,a,d)}function d(e){if(!(0,t.isObject)(e))return[];let n=Object.keys(e).filter(e=>!e.startsWith(`$`));if(n.length>0&&n.every(e=>a.test(e))){let t=e;return n.map(e=>({id:e,tokens:t[e]}))}return[{id:`default`,tokens:e}]}function f(e,t={}){let n=t.cssVarPrefix??`rw`,r=t.includeTypes?new Set(t.includeTypes):void 0,i=[];for(let t of d(e)){let e=t.id==="default"?void 0:t.id;u(t.tokens,[],void 0,e,n,i)}return r?i.filter(e=>!e.type||r.has(e.type)):i}function p(e,t){let n=new Map;for(let r of e){let e=r.path.split(`.`).slice(0,Math.max(t,1)).join(`.`)||r.path,i=n.get(e)??[];i.push(r),n.set(e,i)}return n}function m(e,t){return e===t?e.split(`.`).at(-1)??e:e.startsWith(`${t}.`)?e.slice(t.length+1):e.split(`.`).at(-1)??e}function h(e,t={}){return`import { ColorPalette, ColorItem } from "@storybook/addon-docs/blocks";
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});let e=require("@razorwind/core/plugin"),t=require("@razorwind/core/utils"),n=require("node:path");function r(e,n={}){let r=n.cssVarPrefix??`rw`;return(0,t.flattenTokens)(e,{includeTypes:n.includeTypes,enrichToken:e=>({...e,cssVar:(0,t.toCssVar)(e.path,r)})})}function i(e){return e.replaceAll(`\\`,`\\\\`).replaceAll(`"`,`\\"`).replaceAll(`
+`,`\\n`).replaceAll(`\r`,`\\r`)}function a(e){return typeof e==`string`?`"${i(e)}"`:typeof e==`number`||typeof e==`boolean`?String(e):e==null?`undefined`:JSON.stringify(e)}function o(e){let t=e.titlePrefix??`Design Tokens`,n=e.themeFiles&&e.themeFiles.length>0?`
+## Storybook UI theme
+
+Generated theme module(s):
+
+${e.themeFiles.map(e=>`- \`${e}\``).join(`
+`)}
+
+Wire into \`.storybook/preview.ts\`:
+
+\`\`\`ts
+import theme from "../${e.themeFiles[0]}";
+
+export const parameters = {
+  docs: { theme }
+};
+\`\`\`
+`:``;return`# Installing Storybook Token Docs
+
+Generated by \`@razorwind/storybook\`.
+
+## Files
+
+- \`${e.outputPath}/Tokens.mdx\` — token overview (${t})
+- \`${e.outputPath}/blocks/\` — React doc blocks (ColorPalette, Typeset, …)
+- \`${e.outputPath}/tokens.json\` — flattened token manifest
+${n}
+## Setup
+
+1. Add the generated MDX pages to Storybook (paths depend on your \`stories\` config):
+
+\`\`\`ts
+// .storybook/main.ts
+export default {
+  stories: [
+    "../${e.outputPath}/**/*.mdx"
+  ]
+};
+\`\`\`
+
+2. Import doc blocks in MDX as needed:
+
+\`\`\`mdx
+import { ColorPaletteBlock } from "./blocks";
+\`\`\`
+
+3. Start Storybook and open **${t}** in the sidebar.
+
+## Regenerate
+
+Re-run Razorwind generate when tokens change to refresh docs under \`${e.outputPath}/\`.
+`}function s(e,t){let n=new Map;for(let r of e){let e=r.path.split(`.`).slice(0,Math.max(t,1)).join(`.`)||r.path,i=n.get(e)??[];i.push(r),n.set(e,i)}return n}function c(e,t){return e===t?e.split(`.`).at(-1)??e:e.startsWith(`${t}.`)?e.slice(t.length+1):e.split(`.`).at(-1)??e}function l(e,t={}){return`import { ColorPalette, ColorItem } from "@storybook/addon-docs/blocks";
 
 /**
  * Color tokens rendered with Storybook's ColorPalette doc block.
@@ -9,10 +60,10 @@ Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{val
 export function ColorPaletteBlock() {
   return (
     <ColorPalette>
-${[...p(e.filter(e=>e.type===`color`),t.colorGroupBy??2).entries()].toSorted(([e],[t])=>e.localeCompare(t)).map(([e,t])=>{let n=t.map(t=>`      ${i(m(t.path,e))}: ${i(t.cssValue)}`).join(`,
+${[...s(e.filter(e=>e.type===`color`),t.colorGroupBy??2).entries()].toSorted(([e],[t])=>e.localeCompare(t)).map(([e,t])=>{let n=t.map(t=>`      ${a(c(t.path,e))}: ${a(t.cssValue)}`).join(`,
 `),r=t.find(e=>e.description)?.description??`${t.length} token${t.length===1?``:`s`}`;return`    <ColorItem
-      title={${i(e)}}
-      subtitle={${i(r)}}
+      title={${a(e)}}
+      subtitle={${a(r)}}
       colors={{
 ${n}
       }}
@@ -21,7 +72,7 @@ ${n}
     </ColorPalette>
   );
 }
-`}function g(e,t={}){let n=t.sampleText??`The quick brown fox jumps over the lazy dog`,r=e.filter(e=>e.type===`dimension`&&/(?:font|type|text).*size|size.*(?:font|type|text)/i.test(e.path)).map(e=>{let t=/^(\d+(?:\.\d+)?)/.exec(e.cssValue);return t?Number(t[1]):e.cssValue}),a=[...new Set(r)],o=e.find(e=>e.type===`fontFamily`)?.cssValue??`system-ui, sans-serif`,s=e.find(e=>e.type===`fontWeight`),c=s&&Number.parseFloat(s.cssValue)||400,l=a.length>0?`[${a.map(e=>i(e)).join(`, `)}]`:`[12, 14, 16, 20, 24, 32]`;return`import { Typeset } from "@storybook/addon-docs/blocks";
+`}function u(e,t={}){let n=t.sampleText??`The quick brown fox jumps over the lazy dog`,r=e.filter(e=>e.type===`dimension`&&/(?:font|type|text).*size|size.*(?:font|type|text)/i.test(e.path)).map(e=>{let t=/^(\d+(?:\.\d+)?)/.exec(e.cssValue);return t?Number(t[1]):e.cssValue}),i=[...new Set(r)],o=e.find(e=>e.type===`fontFamily`)?.cssValue??`system-ui, sans-serif`,s=e.find(e=>e.type===`fontWeight`),c=s&&Number.parseFloat(s.cssValue)||400,l=i.length>0?`[${i.map(e=>a(e)).join(`, `)}]`:`[12, 14, 16, 20, 24, 32]`;return`import { Typeset } from "@storybook/addon-docs/blocks";
 
 /**
  * Typography tokens rendered with Storybook's Typeset doc block.
@@ -31,14 +82,14 @@ ${n}
 export function TypesetBlock() {
   return (
     <Typeset
-      fontFamily={${i(o)}}
+      fontFamily={${a(o)}}
       fontSizes={${l}}
-      fontWeight={${i(c)}}
-      sampleText={${i(n)}}
+      fontWeight={${a(c)}}
+      sampleText={${a(n)}}
     />
   );
 }
-`}function _(e){return`import type { CSSProperties, ReactElement } from "react";
+`}function d(e){return`import type { CSSProperties, ReactElement } from "react";
 
 export interface TokenTableRow {
   path: string;
@@ -50,12 +101,12 @@ export interface TokenTableRow {
 }
 
 const TOKENS: TokenTableRow[] = [
-${e.map(e=>{let t=e.theme?i(e.theme):`undefined`;return`    {
-      path: ${i(e.path)},
-      type: ${e.type?i(e.type):`undefined`},
-      value: ${i(e.cssValue)},
-      cssVar: ${i(e.cssVar)},
-      description: ${e.description?i(e.description):`undefined`},
+${e.map(e=>{let t=e.theme?a(e.theme):`undefined`;return`    {
+      path: ${a(e.path)},
+      type: ${e.type?a(e.type):`undefined`},
+      value: ${a(e.cssValue)},
+      cssVar: ${a(e.cssVar)},
+      description: ${e.description?a(e.description):`undefined`},
       theme: ${t}
     }`}).join(`,
 `)||``}
@@ -142,11 +193,11 @@ export function TokenTableBlock({
     </table>
   );
 }
-`}function v(e){let t=e.titlePrefix??`Design Tokens`,n=e.hasColors?`
+`}function f(e){let t=e.titlePrefix??`Design Tokens`,n=e.hasColors?`
 ## Colors
 
 <ColorPaletteBlock />
-`:``,i=e.hasTypography?`
+`:``,r=e.hasTypography?`
 ## Typography
 
 <TypesetBlock />
@@ -155,32 +206,32 @@ import { ColorPaletteBlock } from "./blocks/ColorPalette";
 import { TokenTableBlock } from "./blocks/TokenTable";
 import { TypesetBlock } from "./blocks/Typeset";
 
-<Meta title="${r(t)}/Overview" />
+<Meta title="${i(t)}/Overview" />
 
 # ${t}
 
 Design tokens generated by \`@razorwind/storybook\` for Storybook MDX docs.
-${n}${i}
+${n}${r}
 ## All tokens
 
 <TokenTableBlock />
-`}function y(e={}){return`import { Meta } from "@storybook/addon-docs/blocks";
+`}function p(e={}){return`import { Meta } from "@storybook/addon-docs/blocks";
 import { ColorPaletteBlock } from "./blocks/ColorPalette";
 
-<Meta title="${r(e.titlePrefix??`Design Tokens`)}/Colors" />
+<Meta title="${i(e.titlePrefix??`Design Tokens`)}/Colors" />
 
 # Colors
 
 <ColorPaletteBlock />
-`}function b(e={}){return`import { Meta } from "@storybook/addon-docs/blocks";
+`}function m(e={}){return`import { Meta } from "@storybook/addon-docs/blocks";
 import { TypesetBlock } from "./blocks/Typeset";
 
-<Meta title="${r(e.titlePrefix??`Design Tokens`)}/Typography" />
+<Meta title="${i(e.titlePrefix??`Design Tokens`)}/Typography" />
 
 # Typography
 
 <TypesetBlock />
-`}function x(e,t){let n=e[t];return typeof n==`string`?n:void 0}function S(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function C(e){return`import { IconGallery, IconItem } from "@storybook/addon-docs/blocks";
+`}function h(e,t){let n=e[t];return typeof n==`string`?n:void 0}function g(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function _(e){return`import { IconGallery, IconItem } from "@storybook/addon-docs/blocks";
 
 /**
  * Icons rendered with Storybook's IconGallery doc block.
@@ -190,30 +241,30 @@ import { TypesetBlock } from "./blocks/Typeset";
 export function IconGalleryBlock() {
   return (
     <IconGallery>
-${(S(e)?Object.values(e).filter(S).toSorted((e,t)=>(x(e,`name`)??``).localeCompare(x(t,`name`)??``)):[]).map(e=>{let t=x(e,`name`)??`unknown`,n=(Array.isArray(e.files)?e.files:[]).find(e=>S(e)&&x(e,`type`)===`svg`&&typeof e.content==`string`),a=S(n)&&typeof n.content==`string`?`<span
+${(g(e)?Object.values(e).filter(g).toSorted((e,t)=>(h(e,`name`)??``).localeCompare(h(t,`name`)??``)):[]).map(e=>{let t=h(e,`name`)??`unknown`,n=(Array.isArray(e.files)?e.files:[]).find(e=>g(e)&&h(e,`type`)===`svg`&&typeof e.content==`string`),r=g(n)&&typeof n.content==`string`?`<span
           style={{ display: "inline-flex", width: 24, height: 24 }}
-          dangerouslySetInnerHTML={{ __html: ${i(n.content)} }}
-        />`:`<code>${r(t)}</code>`;return`    <IconItem name={${i(t)}}>
-      ${a}
+          dangerouslySetInnerHTML={{ __html: ${a(n.content)} }}
+        />`:`<code>${i(t)}</code>`;return`    <IconItem name={${a(t)}}>
+      ${r}
     </IconItem>`}).join(`
 `)||`      {/* No icons */}`}
     </IconGallery>
   );
 }
-`}function w(e={}){return`import { Meta } from "@storybook/addon-docs/blocks";
+`}function v(e={}){return`import { Meta } from "@storybook/addon-docs/blocks";
 import { IconGalleryBlock } from "./blocks/IconGallery";
 
-<Meta title="${r(e.titlePrefix??`Design Tokens`)}/Icons" />
+<Meta title="${i(e.titlePrefix??`Design Tokens`)}/Icons" />
 
 # Icons
 
 <IconGalleryBlock />
-`}function T(){return`export { ColorPaletteBlock } from "./ColorPalette";
+`}function y(){return`export { ColorPaletteBlock } from "./ColorPalette";
 export { IconGalleryBlock } from "./IconGallery";
 export { TokenTableBlock } from "./TokenTable";
 export type { TokenTableBlockProps, TokenTableRow } from "./TokenTable";
 export { TypesetBlock } from "./Typeset";
-`}function E(e){return`import { create } from "storybook/theming";
+`}function b(e){return`import { create } from "storybook/theming";
 
 /**
  * Storybook UI theme generated by \`@razorwind/storybook\`.
@@ -221,7 +272,7 @@ export { TypesetBlock } from "./Typeset";
  * @see https://storybook.js.org/docs/configure/user-interface/theming
  */
 export default create({
-${Object.entries(e).filter(([,e])=>e!==void 0).map(([e,t])=>`  ${e}: ${i(t)}`).join(`,
+${Object.entries(e).filter(([,e])=>e!==void 0).map(([e,t])=>`  ${e}: ${a(t)}`).join(`,
 `)}
 });
-`}function D(e,n,r){return(0,t.createDocument)(e,n,{name:`razorwind-storybook`},r)}function O(e,t={}){let r=t.outputPath??`storybook/tokens`,i=f(e.tokens,t),a=i.some(e=>e.type===`color`),o=i.some(e=>e.type===`fontFamily`||e.type===`fontWeight`||e.type===`typography`||e.type===`dimension`&&/(?:font|type|text).*size|size.*(?:font|type|text)/i.test(e.path)),s=!t.skipIcons&&S(e.icons)&&Object.keys(e.icons).length>0,c={[(0,n.join)(r,`blocks/ColorPalette.tsx`)]:D((0,n.join)(r,`blocks/ColorPalette.tsx`),h(i,t),`tsx`),[(0,n.join)(r,`blocks/Typeset.tsx`)]:D((0,n.join)(r,`blocks/Typeset.tsx`),g(i,t),`tsx`),[(0,n.join)(r,`blocks/TokenTable.tsx`)]:D((0,n.join)(r,`blocks/TokenTable.tsx`),_(i),`tsx`),[(0,n.join)(r,`blocks/IconGallery.tsx`)]:D((0,n.join)(r,`blocks/IconGallery.tsx`),C(t.skipIcons?{}:e.icons),`tsx`),[(0,n.join)(r,`blocks/index.ts`)]:D((0,n.join)(r,`blocks/index.ts`),T(),`typescript`),[(0,n.join)(r,`Tokens.mdx`)]:D((0,n.join)(r,`Tokens.mdx`),v({titlePrefix:t.titlePrefix,hasColors:a,hasTypography:o}),`mdx`)};if(a&&(c[(0,n.join)(r,`Colors.mdx`)]=D((0,n.join)(r,`Colors.mdx`),y(t),`mdx`)),o&&(c[(0,n.join)(r,`Typography.mdx`)]=D((0,n.join)(r,`Typography.mdx`),b(t),`mdx`)),s&&(c[(0,n.join)(r,`Icons.mdx`)]=D((0,n.join)(r,`Icons.mdx`),w(t),`mdx`)),c[(0,n.join)(r,`tokens.json`)]=D((0,n.join)(r,`tokens.json`),`${JSON.stringify(i,null,2)}\n`,`json`),t.generateTheme){let i=t.generateTheme(e.tokens);if(typeof i==`object`&&i)for(let[e,t]of Object.entries(i))c[(0,n.join)(r,`theme-${e}.ts`)]=D((0,n.join)(r,`theme-${e}.ts`),E(t),`typescript`);else c[(0,n.join)(r,`theme.ts`)]=D((0,n.join)(r,`theme.ts`),E(i),`typescript`)}return c}var k=(0,e.definePlugin)(e=>({name:`storybook`,generate:async t=>O(t,e??{})}));exports.default=k,exports.flattenTokens=f,Object.defineProperty(exports,"formatTokenValue",{enumerable:!0,get:function(){return t.formatTokenValue}}),exports.generateTokenDocs=O,exports.renderThemeFile=E,exports.resolveTokenSets=d,Object.defineProperty(exports,"toCssVar",{enumerable:!0,get:function(){return t.toCssVar}});
+`}function x(e,n,r){return(0,t.createDocument)(e,n,{name:`razorwind-storybook`},r)}function S(e,t={}){let i=t.outputPath??`storybook/tokens`,a=r(e.tokens,t),s=a.some(e=>e.type===`color`),c=a.some(e=>e.type===`fontFamily`||e.type===`fontWeight`||e.type===`typography`||e.type===`dimension`&&/(?:font|type|text).*size|size.*(?:font|type|text)/i.test(e.path)),h=!t.skipIcons&&g(e.icons)&&Object.keys(e.icons).length>0,S={[(0,n.join)(i,`blocks/ColorPalette.tsx`)]:x((0,n.join)(i,`blocks/ColorPalette.tsx`),l(a,t),`tsx`),[(0,n.join)(i,`blocks/Typeset.tsx`)]:x((0,n.join)(i,`blocks/Typeset.tsx`),u(a,t),`tsx`),[(0,n.join)(i,`blocks/TokenTable.tsx`)]:x((0,n.join)(i,`blocks/TokenTable.tsx`),d(a),`tsx`),[(0,n.join)(i,`blocks/IconGallery.tsx`)]:x((0,n.join)(i,`blocks/IconGallery.tsx`),_(t.skipIcons?{}:e.icons),`tsx`),[(0,n.join)(i,`blocks/index.ts`)]:x((0,n.join)(i,`blocks/index.ts`),y(),`typescript`),[(0,n.join)(i,`Tokens.mdx`)]:x((0,n.join)(i,`Tokens.mdx`),f({titlePrefix:t.titlePrefix,hasColors:s,hasTypography:c}),`mdx`)};if(s&&(S[(0,n.join)(i,`Colors.mdx`)]=x((0,n.join)(i,`Colors.mdx`),p(t),`mdx`)),c&&(S[(0,n.join)(i,`Typography.mdx`)]=x((0,n.join)(i,`Typography.mdx`),m(t),`mdx`)),h&&(S[(0,n.join)(i,`Icons.mdx`)]=x((0,n.join)(i,`Icons.mdx`),v(t),`mdx`)),S[(0,n.join)(i,`tokens.json`)]=x((0,n.join)(i,`tokens.json`),`${JSON.stringify(a,null,2)}\n`,`json`),t.generateTheme){let r=t.generateTheme(e.tokens);if(typeof r==`object`&&r)for(let[e,t]of Object.entries(r))S[(0,n.join)(i,`theme-${e}.ts`)]=x((0,n.join)(i,`theme-${e}.ts`),b(t),`typescript`);else S[(0,n.join)(i,`theme.ts`)]=x((0,n.join)(i,`theme.ts`),b(r),`typescript`)}let C=Object.keys(S).filter(e=>e.startsWith((0,n.join)(i,`theme`))).map(e=>e.slice(i.length+1)),w=t.installGuide??o({outputPath:i,titlePrefix:t.titlePrefix,themeFiles:C.length>0?C:void 0}),T=(0,n.join)(i,`INSTALL.md`);return S[T]=x(T,w,`markdown`),S}var C=(0,e.definePlugin)(e=>({name:`storybook`,generate:async t=>S(t,e??{})}));exports.default=C,exports.flattenTokens=r,Object.defineProperty(exports,"formatTokenValue",{enumerable:!0,get:function(){return t.formatTokenValue}}),exports.generateTokenDocs=S,exports.renderInstallMd=o,exports.renderThemeFile=b,exports.resolveTokenSets=t.resolveTokenSets,Object.defineProperty(exports,"toCssVar",{enumerable:!0,get:function(){return t.toCssVar}});

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { TokenType, Tokens } from "@power-plant/dtcg-schema";
 import { Schema, Tokens as Tokens$1 } from "@razorwind/core/schema";
-import { formatTokenValue, toCssVar } from "@razorwind/core/utils";
+import { formatTokenValue, resolveTokenSets, toCssVar } from "@razorwind/core/utils";
 import { GeneratorFunctionResult } from "@power-plant/core";
 //#region src/types.d.ts
 /**
@@ -122,25 +122,31 @@ interface StorybookPluginOptions {
    * @defaultValue `false`
    */
   skipIcons?: boolean;
+  /**
+   * Override body for generated `INSTALL.md`. When omitted, Storybook wiring
+   * steps are generated for the output directory.
+   */
+  installGuide?: string;
 }
 //#endregion
 //#region src/flatten.d.ts
-interface TokenSet {
-  id: string;
-  tokens: Tokens$1;
-}
-/**
- * Split `Schema.tokens` into one or more named token sets.
- *
- * A record whose keys all look like themes (`light`, `dark`, …) is treated as
- * multi-theme input; otherwise the whole document is a single set.
- */
-declare function resolveTokenSets(tokens: Tokens$1 | Record<string, Tokens$1>): TokenSet[];
 /**
  * Flatten DTCG token trees into documentation rows.
  */
 declare function flattenTokens(tokens: Tokens$1 | Record<string, Tokens$1>, options?: Pick<StorybookPluginOptions, "cssVarPrefix" | "includeTypes">): FlatToken[];
 //#endregion
+//#region src/install.d.ts
+/**
+ * Build Storybook INSTALL.md for generated token docs.
+ *
+ * @see https://storybook.js.org/docs/writing-docs/mdx
+ */
+declare function renderInstallMd(options: {
+  outputPath: string;
+  titlePrefix?: string;
+  themeFiles?: string[];
+}): string;
+//#endregion
 //#region src/generate.d.ts
 /**
  * Serialize a Storybook theme object as a `storybook/theming` `create()` module.
@@ -182,5 +188,5 @@ declare function generateTokenDocs(spec: Schema, options?: StorybookPluginOption
  */
 declare const _default: (options?: StorybookPluginOptions | undefined) => import("@razorwind/core/plugin").Plugin;
 //#endregion
-export { type FlatToken, type GenerateStorybookTheme, type StorybookPluginOptions, type StorybookTheme, _default as default, flattenTokens, formatTokenValue, generateTokenDocs, renderThemeFile, resolveTokenSets, toCssVar };
+export { type FlatToken, type GenerateStorybookTheme, type StorybookPluginOptions, type StorybookTheme, _default as default, flattenTokens, formatTokenValue, generateTokenDocs, renderInstallMd, renderThemeFile, resolveTokenSets, toCssVar };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/flatten.ts","../src/generate.ts","../src/index.ts"],"mappings":";;;;;;;;UAuBiB;;EAEf;;EAEA,OAAO;;EAEP;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;;UAQe;;EAEf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;KAGU,uBACV,iBAAiB,eAAe;;;;;;KAOtB,0BACV,QAAQ,SAAS,eAAe,YAC7B;;;;UAKY;;;;;;EAMf;;;;;;EAOA;;;;;;EAOA;;;;;;EAOA;;;;;EAMA,eAAe;;;;;;EAOf;;;;;;;;;EAUA,gBAAgB;;;;;;EAOhB;;;;UC5Ce;EACf;EACA,QAAQ;;;;;;;;iBASM,iBACd,QAAQ,WAAS,eAAe,YAC/B;;;;iBAwBa,cACd,QAAQ,WAAS,eAAe,WAChC,UAAS,KAAK,2DACb;;;;;;;;iBC8Ta,gBAAgB,OAAO;;;;iBAmCvB,kBACd,MAAM,QACN,UAAS,yBACR,wBAAwB,QAAQ"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/flatten.ts","../src/install.ts","../src/generate.ts","../src/index.ts"],"mappings":";;;;;;;;UAuBiB;;EAEf;;EAEA,OAAO;;EAEP;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;;UAQe;;EAEf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;KAGU,uBACV,iBAAiB,eAAe;;;;;;KAOtB,0BACV,QAAQ,SAAS,eAAe,YAC7B;;;;UAKY;;;;;;EAMf;;;;;;EAOA;;;;;;EAOA;;;;;;EAOA;;;;;EAMA,eAAe;;;;;;EAOf;;;;;;;;;EAUA,gBAAgB;;;;;;EAOhB;;;;;EAMA;;;;;;;iBC7Hc,cACd,QAAQ,WAAS,eAAe,WAChC,UAAS,KAAK,2DACb;;;;;;;;iBCba,gBAAgB;EAC9B;EACA;EACA;;;;;;;;;iBCybc,gBAAgB,OAAO;;;;iBAqCvB,kBACd,MAAM,QACN,UAAS,yBACR,wBAAwB,QAAQ"}

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { formatTokenValue, toCssVar } from "@razorwind/core/utils";
+import { formatTokenValue, resolveTokenSets, toCssVar } from "@razorwind/core/utils";
 import { TokenType, Tokens } from "@power-plant/dtcg-schema";
 import { Schema, Tokens as Tokens$1 } from "@razorwind/core/schema";
 import { GeneratorFunctionResult } from "@power-plant/core";
@@ -122,25 +122,31 @@ interface StorybookPluginOptions {
    * @defaultValue `false`
    */
   skipIcons?: boolean;
+  /**
+   * Override body for generated `INSTALL.md`. When omitted, Storybook wiring
+   * steps are generated for the output directory.
+   */
+  installGuide?: string;
 }
 //#endregion
 //#region src/flatten.d.ts
-interface TokenSet {
-  id: string;
-  tokens: Tokens$1;
-}
-/**
- * Split `Schema.tokens` into one or more named token sets.
- *
- * A record whose keys all look like themes (`light`, `dark`, …) is treated as
- * multi-theme input; otherwise the whole document is a single set.
- */
-declare function resolveTokenSets(tokens: Tokens$1 | Record<string, Tokens$1>): TokenSet[];
 /**
  * Flatten DTCG token trees into documentation rows.
  */
 declare function flattenTokens(tokens: Tokens$1 | Record<string, Tokens$1>, options?: Pick<StorybookPluginOptions, "cssVarPrefix" | "includeTypes">): FlatToken[];
 //#endregion
+//#region src/install.d.ts
+/**
+ * Build Storybook INSTALL.md for generated token docs.
+ *
+ * @see https://storybook.js.org/docs/writing-docs/mdx
+ */
+declare function renderInstallMd(options: {
+  outputPath: string;
+  titlePrefix?: string;
+  themeFiles?: string[];
+}): string;
+//#endregion
 //#region src/generate.d.ts
 /**
  * Serialize a Storybook theme object as a `storybook/theming` `create()` module.
@@ -182,5 +188,5 @@ declare function generateTokenDocs(spec: Schema, options?: StorybookPluginOption
  */
 declare const _default: (options?: StorybookPluginOptions | undefined) => import("@razorwind/core/plugin").Plugin;
 //#endregion
-export { type FlatToken, type GenerateStorybookTheme, type StorybookPluginOptions, type StorybookTheme, _default as default, flattenTokens, formatTokenValue, generateTokenDocs, renderThemeFile, resolveTokenSets, toCssVar };
+export { type FlatToken, type GenerateStorybookTheme, type StorybookPluginOptions, type StorybookTheme, _default as default, flattenTokens, formatTokenValue, generateTokenDocs, renderInstallMd, renderThemeFile, resolveTokenSets, toCssVar };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/flatten.ts","../src/generate.ts","../src/index.ts"],"mappings":""}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/flatten.ts","../src/install.ts","../src/generate.ts","../src/index.ts"],"mappings":""}

package/dist/index.mjs

@@ -1,5 +1,56 @@
-import{definePlugin as e}from"@razorwind/core/plugin";import{createDocument as t,formatTokenValue as n,isObject as r,toCssVar as i}from"@razorwind/core/utils";import{join as a}from"node:path";function o(e){return e.replaceAll(`\\`,`\\\\`).replaceAll(`"`,`\\"`).replaceAll(`
-`,`\\n`).replaceAll(`\r`,`\\r`)}function s(e){return typeof e==`string`?`"${o(e)}"`:typeof e==`number`||typeof e==`boolean`?String(e):e==null?`undefined`:JSON.stringify(e)}const c=/^(?:light|dark|dim|high-contrast|hc|default|base|theme)(?:[._-].+)?$/i;function l(e){return`$value`in e||`value`in e||`$ref`in e||`ref`in e}function u(e){if(typeof e.$description==`string`)return e.$description;if(typeof e.description==`string`)return e.description}function d(e,t){return typeof e.$type==`string`?e.$type:typeof e.type==`string`?e.type:t}function f(e){if(`$value`in e)return e.$value;if(`value`in e)return e.value;if(typeof e.$ref==`string`)return e.$ref;if(typeof e.ref==`string`)return e.ref}function p(e,t,a,o,s,c){if(!r(e))return;let m=d(e,a);if(l(e)){let r=f(e),a=t.join(`.`);c.push({path:a,type:m,value:r,cssValue:n(r,m),cssVar:i(a,s),description:u(e),theme:o});return}for(let[n,r]of Object.entries(e))n.startsWith(`$`)||p(r,[...t,n],m,o,s,c)}function m(e){if(!r(e))return[];let t=Object.keys(e).filter(e=>!e.startsWith(`$`));if(t.length>0&&t.every(e=>c.test(e))){let n=e;return t.map(e=>({id:e,tokens:n[e]}))}return[{id:`default`,tokens:e}]}function h(e,t={}){let n=t.cssVarPrefix??`rw`,r=t.includeTypes?new Set(t.includeTypes):void 0,i=[];for(let t of m(e)){let e=t.id==="default"?void 0:t.id;p(t.tokens,[],void 0,e,n,i)}return r?i.filter(e=>!e.type||r.has(e.type)):i}function g(e,t){let n=new Map;for(let r of e){let e=r.path.split(`.`).slice(0,Math.max(t,1)).join(`.`)||r.path,i=n.get(e)??[];i.push(r),n.set(e,i)}return n}function _(e,t){return e===t?e.split(`.`).at(-1)??e:e.startsWith(`${t}.`)?e.slice(t.length+1):e.split(`.`).at(-1)??e}function v(e,t={}){return`import { ColorPalette, ColorItem } from "@storybook/addon-docs/blocks";
+import{definePlugin as e}from"@razorwind/core/plugin";import{createDocument as t,flattenTokens as n,formatTokenValue as r,resolveTokenSets as i,toCssVar as a,toCssVar as o}from"@razorwind/core/utils";import{join as s}from"node:path";function c(e,t={}){let r=t.cssVarPrefix??`rw`;return n(e,{includeTypes:t.includeTypes,enrichToken:e=>({...e,cssVar:o(e.path,r)})})}function l(e){return e.replaceAll(`\\`,`\\\\`).replaceAll(`"`,`\\"`).replaceAll(`
+`,`\\n`).replaceAll(`\r`,`\\r`)}function u(e){return typeof e==`string`?`"${l(e)}"`:typeof e==`number`||typeof e==`boolean`?String(e):e==null?`undefined`:JSON.stringify(e)}function d(e){let t=e.titlePrefix??`Design Tokens`,n=e.themeFiles&&e.themeFiles.length>0?`
+## Storybook UI theme
+
+Generated theme module(s):
+
+${e.themeFiles.map(e=>`- \`${e}\``).join(`
+`)}
+
+Wire into \`.storybook/preview.ts\`:
+
+\`\`\`ts
+import theme from "../${e.themeFiles[0]}";
+
+export const parameters = {
+  docs: { theme }
+};
+\`\`\`
+`:``;return`# Installing Storybook Token Docs
+
+Generated by \`@razorwind/storybook\`.
+
+## Files
+
+- \`${e.outputPath}/Tokens.mdx\` — token overview (${t})
+- \`${e.outputPath}/blocks/\` — React doc blocks (ColorPalette, Typeset, …)
+- \`${e.outputPath}/tokens.json\` — flattened token manifest
+${n}
+## Setup
+
+1. Add the generated MDX pages to Storybook (paths depend on your \`stories\` config):
+
+\`\`\`ts
+// .storybook/main.ts
+export default {
+  stories: [
+    "../${e.outputPath}/**/*.mdx"
+  ]
+};
+\`\`\`
+
+2. Import doc blocks in MDX as needed:
+
+\`\`\`mdx
+import { ColorPaletteBlock } from "./blocks";
+\`\`\`
+
+3. Start Storybook and open **${t}** in the sidebar.
+
+## Regenerate
+
+Re-run Razorwind generate when tokens change to refresh docs under \`${e.outputPath}/\`.
+`}function f(e,t){let n=new Map;for(let r of e){let e=r.path.split(`.`).slice(0,Math.max(t,1)).join(`.`)||r.path,i=n.get(e)??[];i.push(r),n.set(e,i)}return n}function p(e,t){return e===t?e.split(`.`).at(-1)??e:e.startsWith(`${t}.`)?e.slice(t.length+1):e.split(`.`).at(-1)??e}function m(e,t={}){return`import { ColorPalette, ColorItem } from "@storybook/addon-docs/blocks";
 
 /**
  * Color tokens rendered with Storybook's ColorPalette doc block.
@@ -9,10 +60,10 @@ import{definePlugin as e}from"@razorwind/core/plugin";import{createDocument as t
 export function ColorPaletteBlock() {
   return (
     <ColorPalette>
-${[...g(e.filter(e=>e.type===`color`),t.colorGroupBy??2).entries()].toSorted(([e],[t])=>e.localeCompare(t)).map(([e,t])=>{let n=t.map(t=>`      ${s(_(t.path,e))}: ${s(t.cssValue)}`).join(`,
+${[...f(e.filter(e=>e.type===`color`),t.colorGroupBy??2).entries()].toSorted(([e],[t])=>e.localeCompare(t)).map(([e,t])=>{let n=t.map(t=>`      ${u(p(t.path,e))}: ${u(t.cssValue)}`).join(`,
 `),r=t.find(e=>e.description)?.description??`${t.length} token${t.length===1?``:`s`}`;return`    <ColorItem
-      title={${s(e)}}
-      subtitle={${s(r)}}
+      title={${u(e)}}
+      subtitle={${u(r)}}
       colors={{
 ${n}
       }}
@@ -21,7 +72,7 @@ ${n}
     </ColorPalette>
   );
 }
-`}function y(e,t={}){let n=t.sampleText??`The quick brown fox jumps over the lazy dog`,r=e.filter(e=>e.type===`dimension`&&/(?:font|type|text).*size|size.*(?:font|type|text)/i.test(e.path)).map(e=>{let t=/^(\d+(?:\.\d+)?)/.exec(e.cssValue);return t?Number(t[1]):e.cssValue}),i=[...new Set(r)],a=e.find(e=>e.type===`fontFamily`)?.cssValue??`system-ui, sans-serif`,o=e.find(e=>e.type===`fontWeight`),c=o&&Number.parseFloat(o.cssValue)||400,l=i.length>0?`[${i.map(e=>s(e)).join(`, `)}]`:`[12, 14, 16, 20, 24, 32]`;return`import { Typeset } from "@storybook/addon-docs/blocks";
+`}function h(e,t={}){let n=t.sampleText??`The quick brown fox jumps over the lazy dog`,r=e.filter(e=>e.type===`dimension`&&/(?:font|type|text).*size|size.*(?:font|type|text)/i.test(e.path)).map(e=>{let t=/^(\d+(?:\.\d+)?)/.exec(e.cssValue);return t?Number(t[1]):e.cssValue}),i=[...new Set(r)],a=e.find(e=>e.type===`fontFamily`)?.cssValue??`system-ui, sans-serif`,o=e.find(e=>e.type===`fontWeight`),s=o&&Number.parseFloat(o.cssValue)||400,c=i.length>0?`[${i.map(e=>u(e)).join(`, `)}]`:`[12, 14, 16, 20, 24, 32]`;return`import { Typeset } from "@storybook/addon-docs/blocks";
 
 /**
  * Typography tokens rendered with Storybook's Typeset doc block.
@@ -31,14 +82,14 @@ ${n}
 export function TypesetBlock() {
   return (
     <Typeset
-      fontFamily={${s(a)}}
-      fontSizes={${l}}
-      fontWeight={${s(c)}}
-      sampleText={${s(n)}}
+      fontFamily={${u(a)}}
+      fontSizes={${c}}
+      fontWeight={${u(s)}}
+      sampleText={${u(n)}}
     />
   );
 }
-`}function b(e){return`import type { CSSProperties, ReactElement } from "react";
+`}function g(e){return`import type { CSSProperties, ReactElement } from "react";
 
 export interface TokenTableRow {
   path: string;
@@ -50,12 +101,12 @@ export interface TokenTableRow {
 }
 
 const TOKENS: TokenTableRow[] = [
-${e.map(e=>{let t=e.theme?s(e.theme):`undefined`;return`    {
-      path: ${s(e.path)},
-      type: ${e.type?s(e.type):`undefined`},
-      value: ${s(e.cssValue)},
-      cssVar: ${s(e.cssVar)},
-      description: ${e.description?s(e.description):`undefined`},
+${e.map(e=>{let t=e.theme?u(e.theme):`undefined`;return`    {
+      path: ${u(e.path)},
+      type: ${e.type?u(e.type):`undefined`},
+      value: ${u(e.cssValue)},
+      cssVar: ${u(e.cssVar)},
+      description: ${e.description?u(e.description):`undefined`},
       theme: ${t}
     }`}).join(`,
 `)||``}
@@ -142,7 +193,7 @@ export function TokenTableBlock({
     </table>
   );
 }
-`}function x(e){let t=e.titlePrefix??`Design Tokens`,n=e.hasColors?`
+`}function _(e){let t=e.titlePrefix??`Design Tokens`,n=e.hasColors?`
 ## Colors
 
 <ColorPaletteBlock />
@@ -155,7 +206,7 @@ import { ColorPaletteBlock } from "./blocks/ColorPalette";
 import { TokenTableBlock } from "./blocks/TokenTable";
 import { TypesetBlock } from "./blocks/Typeset";
 
-<Meta title="${o(t)}/Overview" />
+<Meta title="${l(t)}/Overview" />
 
 # ${t}
 
@@ -164,23 +215,23 @@ ${n}${r}
 ## All tokens
 
 <TokenTableBlock />
-`}function S(e={}){return`import { Meta } from "@storybook/addon-docs/blocks";
+`}function v(e={}){return`import { Meta } from "@storybook/addon-docs/blocks";
 import { ColorPaletteBlock } from "./blocks/ColorPalette";
 
-<Meta title="${o(e.titlePrefix??`Design Tokens`)}/Colors" />
+<Meta title="${l(e.titlePrefix??`Design Tokens`)}/Colors" />
 
 # Colors
 
 <ColorPaletteBlock />
-`}function C(e={}){return`import { Meta } from "@storybook/addon-docs/blocks";
+`}function y(e={}){return`import { Meta } from "@storybook/addon-docs/blocks";
 import { TypesetBlock } from "./blocks/Typeset";
 
-<Meta title="${o(e.titlePrefix??`Design Tokens`)}/Typography" />
+<Meta title="${l(e.titlePrefix??`Design Tokens`)}/Typography" />
 
 # Typography
 
 <TypesetBlock />
-`}function w(e,t){let n=e[t];return typeof n==`string`?n:void 0}function T(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function E(e){return`import { IconGallery, IconItem } from "@storybook/addon-docs/blocks";
+`}function b(e,t){let n=e[t];return typeof n==`string`?n:void 0}function x(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function S(e){return`import { IconGallery, IconItem } from "@storybook/addon-docs/blocks";
 
 /**
  * Icons rendered with Storybook's IconGallery doc block.
@@ -190,30 +241,30 @@ import { TypesetBlock } from "./blocks/Typeset";
 export function IconGalleryBlock() {
   return (
     <IconGallery>
-${(T(e)?Object.values(e).filter(T).toSorted((e,t)=>(w(e,`name`)??``).localeCompare(w(t,`name`)??``)):[]).map(e=>{let t=w(e,`name`)??`unknown`,n=(Array.isArray(e.files)?e.files:[]).find(e=>T(e)&&w(e,`type`)===`svg`&&typeof e.content==`string`),r=T(n)&&typeof n.content==`string`?`<span
+${(x(e)?Object.values(e).filter(x).toSorted((e,t)=>(b(e,`name`)??``).localeCompare(b(t,`name`)??``)):[]).map(e=>{let t=b(e,`name`)??`unknown`,n=(Array.isArray(e.files)?e.files:[]).find(e=>x(e)&&b(e,`type`)===`svg`&&typeof e.content==`string`),r=x(n)&&typeof n.content==`string`?`<span
           style={{ display: "inline-flex", width: 24, height: 24 }}
-          dangerouslySetInnerHTML={{ __html: ${s(n.content)} }}
-        />`:`<code>${o(t)}</code>`;return`    <IconItem name={${s(t)}}>
+          dangerouslySetInnerHTML={{ __html: ${u(n.content)} }}
+        />`:`<code>${l(t)}</code>`;return`    <IconItem name={${u(t)}}>
       ${r}
     </IconItem>`}).join(`
 `)||`      {/* No icons */}`}
     </IconGallery>
   );
 }
-`}function D(e={}){return`import { Meta } from "@storybook/addon-docs/blocks";
+`}function C(e={}){return`import { Meta } from "@storybook/addon-docs/blocks";
 import { IconGalleryBlock } from "./blocks/IconGallery";
 
-<Meta title="${o(e.titlePrefix??`Design Tokens`)}/Icons" />
+<Meta title="${l(e.titlePrefix??`Design Tokens`)}/Icons" />
 
 # Icons
 
 <IconGalleryBlock />
-`}function O(){return`export { ColorPaletteBlock } from "./ColorPalette";
+`}function w(){return`export { ColorPaletteBlock } from "./ColorPalette";
 export { IconGalleryBlock } from "./IconGallery";
 export { TokenTableBlock } from "./TokenTable";
 export type { TokenTableBlockProps, TokenTableRow } from "./TokenTable";
 export { TypesetBlock } from "./Typeset";
-`}function k(e){return`import { create } from "storybook/theming";
+`}function T(e){return`import { create } from "storybook/theming";
 
 /**
  * Storybook UI theme generated by \`@razorwind/storybook\`.
@@ -221,8 +272,8 @@ export { TypesetBlock } from "./Typeset";
  * @see https://storybook.js.org/docs/configure/user-interface/theming
  */
 export default create({
-${Object.entries(e).filter(([,e])=>e!==void 0).map(([e,t])=>`  ${e}: ${s(t)}`).join(`,
+${Object.entries(e).filter(([,e])=>e!==void 0).map(([e,t])=>`  ${e}: ${u(t)}`).join(`,
 `)}
 });
-`}function A(e,n,r){return t(e,n,{name:`razorwind-storybook`},r)}function j(e,t={}){let n=t.outputPath??`storybook/tokens`,r=h(e.tokens,t),i=r.some(e=>e.type===`color`),o=r.some(e=>e.type===`fontFamily`||e.type===`fontWeight`||e.type===`typography`||e.type===`dimension`&&/(?:font|type|text).*size|size.*(?:font|type|text)/i.test(e.path)),s=!t.skipIcons&&T(e.icons)&&Object.keys(e.icons).length>0,c={[a(n,`blocks/ColorPalette.tsx`)]:A(a(n,`blocks/ColorPalette.tsx`),v(r,t),`tsx`),[a(n,`blocks/Typeset.tsx`)]:A(a(n,`blocks/Typeset.tsx`),y(r,t),`tsx`),[a(n,`blocks/TokenTable.tsx`)]:A(a(n,`blocks/TokenTable.tsx`),b(r),`tsx`),[a(n,`blocks/IconGallery.tsx`)]:A(a(n,`blocks/IconGallery.tsx`),E(t.skipIcons?{}:e.icons),`tsx`),[a(n,`blocks/index.ts`)]:A(a(n,`blocks/index.ts`),O(),`typescript`),[a(n,`Tokens.mdx`)]:A(a(n,`Tokens.mdx`),x({titlePrefix:t.titlePrefix,hasColors:i,hasTypography:o}),`mdx`)};if(i&&(c[a(n,`Colors.mdx`)]=A(a(n,`Colors.mdx`),S(t),`mdx`)),o&&(c[a(n,`Typography.mdx`)]=A(a(n,`Typography.mdx`),C(t),`mdx`)),s&&(c[a(n,`Icons.mdx`)]=A(a(n,`Icons.mdx`),D(t),`mdx`)),c[a(n,`tokens.json`)]=A(a(n,`tokens.json`),`${JSON.stringify(r,null,2)}\n`,`json`),t.generateTheme){let r=t.generateTheme(e.tokens);if(typeof r==`object`&&r)for(let[e,t]of Object.entries(r))c[a(n,`theme-${e}.ts`)]=A(a(n,`theme-${e}.ts`),k(t),`typescript`);else c[a(n,`theme.ts`)]=A(a(n,`theme.ts`),k(r),`typescript`)}return c}var M=e(e=>({name:`storybook`,generate:async t=>j(t,e??{})}));export{M as default,h as flattenTokens,n as formatTokenValue,j as generateTokenDocs,k as renderThemeFile,m as resolveTokenSets,i as toCssVar};
+`}function E(e,n,r){return t(e,n,{name:`razorwind-storybook`},r)}function D(e,t={}){let n=t.outputPath??`storybook/tokens`,r=c(e.tokens,t),i=r.some(e=>e.type===`color`),a=r.some(e=>e.type===`fontFamily`||e.type===`fontWeight`||e.type===`typography`||e.type===`dimension`&&/(?:font|type|text).*size|size.*(?:font|type|text)/i.test(e.path)),o=!t.skipIcons&&x(e.icons)&&Object.keys(e.icons).length>0,l={[s(n,`blocks/ColorPalette.tsx`)]:E(s(n,`blocks/ColorPalette.tsx`),m(r,t),`tsx`),[s(n,`blocks/Typeset.tsx`)]:E(s(n,`blocks/Typeset.tsx`),h(r,t),`tsx`),[s(n,`blocks/TokenTable.tsx`)]:E(s(n,`blocks/TokenTable.tsx`),g(r),`tsx`),[s(n,`blocks/IconGallery.tsx`)]:E(s(n,`blocks/IconGallery.tsx`),S(t.skipIcons?{}:e.icons),`tsx`),[s(n,`blocks/index.ts`)]:E(s(n,`blocks/index.ts`),w(),`typescript`),[s(n,`Tokens.mdx`)]:E(s(n,`Tokens.mdx`),_({titlePrefix:t.titlePrefix,hasColors:i,hasTypography:a}),`mdx`)};if(i&&(l[s(n,`Colors.mdx`)]=E(s(n,`Colors.mdx`),v(t),`mdx`)),a&&(l[s(n,`Typography.mdx`)]=E(s(n,`Typography.mdx`),y(t),`mdx`)),o&&(l[s(n,`Icons.mdx`)]=E(s(n,`Icons.mdx`),C(t),`mdx`)),l[s(n,`tokens.json`)]=E(s(n,`tokens.json`),`${JSON.stringify(r,null,2)}\n`,`json`),t.generateTheme){let r=t.generateTheme(e.tokens);if(typeof r==`object`&&r)for(let[e,t]of Object.entries(r))l[s(n,`theme-${e}.ts`)]=E(s(n,`theme-${e}.ts`),T(t),`typescript`);else l[s(n,`theme.ts`)]=E(s(n,`theme.ts`),T(r),`typescript`)}let u=Object.keys(l).filter(e=>e.startsWith(s(n,`theme`))).map(e=>e.slice(n.length+1)),f=t.installGuide??d({outputPath:n,titlePrefix:t.titlePrefix,themeFiles:u.length>0?u:void 0}),p=s(n,`INSTALL.md`);return l[p]=E(p,f,`markdown`),l}var O=e(e=>({name:`storybook`,generate:async t=>D(t,e??{})}));export{O as default,c as flattenTokens,r as formatTokenValue,D as generateTokenDocs,d as renderInstallMd,T as renderThemeFile,i as resolveTokenSets,a as toCssVar};
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@razorwind/storybook",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "type": "module",
   "description": "Razorwind plugin that creates Storybook MDX token doc blocks from Razorwind design tokens.",
   "repository": {
@@ -83,9 +83,9 @@
   "types": "./dist/index.d.cts",
   "typings": "dist/index.d.mts",
   "dependencies": {
-    "@power-plant/core": "^0.0.75",
+    "@power-plant/core": "^0.0.81",
     "@power-plant/dtcg-schema": "^0.0.1",
-    "@razorwind/core": "0.0.28",
+    "@razorwind/core": "^0.0.30",
     "@stryke/type-checks": "^0.6.35"
   },
   "peerDependencies": {
@@ -99,10 +99,10 @@
     "storybook": { "optional": true }
   },
   "devDependencies": {
-    "@powerlines/plugin-tsdown": "^0.1.589",
+    "@powerlines/plugin-tsdown": "^0.1.590",
     "@types/node": "^25.9.5",
     "typescript": "^6.0.3"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "1035cb442a4b46f2373951c74b1c89821749be2b"
+  "gitHead": "11a6e827627acf51ef0044e366fd9493f2173ec2"
 }