@razorwind/shiki 0.0.3 → 0.0.4

package/dist/index.cjs

@@ -1 +1,48 @@
-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");const r=/^(?:light|dark|dim|dimmed|high-contrast|hc|protanopia|deuteranopia|tritanopia|achromatopsia|achromatomaly|monochrome|monochromatic|grayscale|greyscale|bw|black-and-white|black-white|blackWhite|default|base|theme)(?:[A-Z]\w*|[._-].+)?$/i;function i(e){return`$value`in e||`value`in e||`$ref`in e||`ref`in e}function a(e){if(typeof e.$description==`string`)return e.$description;if(typeof e.description==`string`)return e.description}function o(e,t){return typeof e.$type==`string`?e.$type:typeof e.type==`string`?e.type:t}function s(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 c(e,n,r,l,u){if(!(0,t.isObject)(e))return;let d=o(e,r);if(i(e)){let r=s(e);u.push({path:n.join(`.`),type:d,value:r,cssValue:(0,t.formatTokenValue)(r,d),description:a(e),theme:l});return}for(let[t,r]of Object.entries(e))t.startsWith(`$`)||c(r,[...n,t],d,l,u)}function l(e){if(!(0,t.isObject)(e))return[];let n=Object.keys(e).filter(e=>!e.startsWith(`$`));if(n.length>0&&n.every(e=>r.test(e))){let t=e;return n.map(e=>({id:e,tokens:t[e]}))}return[{id:`default`,tokens:e}]}function u(e,t={}){let n=t.includeTypes?new Set(t.includeTypes):void 0,r=[];for(let t of l(e)){let e=t.id==="default"?void 0:t.id;c(t.tokens,[],void 0,e,r)}return n?r.filter(e=>!e.type||n.has(e.type)):r}const d={name:`razorwind-shiki`};function f(e,n,r){return(0,t.createDocument)(e,n,d,r)}function p(e){return e.trim().toLowerCase().replaceAll(/[^a-z0-9]+/g,`-`).replaceAll(/^-+|-+$/g,``)}function m(e){return(0,t.isObject)(e)&&typeof e.name==`string`&&e.name.length>0}function h(e){if(Array.isArray(e))return e.map((e,t)=>{if(!m(e))throw TypeError(`@razorwind/shiki mapTheme()[${t}] must be a ShikiTheme with name`);return e});if(m(e))return[e];if(!(0,t.isObject)(e))throw TypeError(`@razorwind/shiki mapTheme() must return a theme, theme array, or theme record`);return Object.entries(e).map(([e,t])=>{if(!m(t))throw TypeError(`@razorwind/shiki mapTheme()["${e}"] must be a ShikiTheme with name`);return{...t,name:t.name||e}})}function g(e){if(!e.mapTheme)throw Error(`@razorwind/shiki requires options.mapTheme`)}function _(e){let t=e.settings??e.tokenColors??[],n={name:e.name,settings:t};return e.displayName&&(n.displayName=e.displayName),e.type&&(n.type=e.type),e.fg!==void 0&&(n.fg=e.fg),e.bg!==void 0&&(n.bg=e.bg),e.colors&&(n.colors=e.colors),e.tokenColors&&e.settings&&(n.tokenColors=e.tokenColors),e.colorReplacements&&(n.colorReplacements=e.colorReplacements),e.semanticHighlighting!==void 0&&(n.semanticHighlighting=e.semanticHighlighting),e.semanticTokenColors&&(n.semanticTokenColors=e.semanticTokenColors),`${JSON.stringify(n,null,2)}\n`}function v(e,t){g(t);let r=t.outputPath??`shiki-themes`,i=h(t.mapTheme(e.tokens));if(i.length===0)throw Error(`@razorwind/shiki mapTheme() returned no themes`);let a={},o=new Set;for(let e of i){let t=`${p(e.name)}.json`;if(o.has(t)){let n=2;for(;o.has(`${p(e.name)}-${n}.json`);)n+=1;t=`${p(e.name)}-${n}.json`}o.add(t);let i=(0,n.join)(r,t);a[i]=f(i,_(e),`json`)}return a}var y=(0,e.definePlugin)(e=>({name:`shiki`,generate:async t=>{if(!e)throw Error(`@razorwind/shiki requires options: { mapTheme }`);return v(t,e)}}));exports.default=y,exports.flattenTokens=u,Object.defineProperty(exports,"formatTokenValue",{enumerable:!0,get:function(){return t.formatTokenValue}}),exports.generateShikiTheme=v,exports.normalizeThemes=h,exports.renderThemeJson=_,exports.resolveTokenSets=l,Object.defineProperty(exports,"toCssVar",{enumerable:!0,get:function(){return t.toCssVar}});
+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){let t=e.themes[0],n=e.themes.length===1?t.displayName:`Shiki Themes`,r=e.themes.map(e=>`- \`${e.fileName}\` — ${e.displayName} (theme id: \`${e.name}\`)`).join(`
+`),i=e.themes.map(e=>`- \`${e.name}\` — ${e.displayName}`).join(`
+`);return`# Installing ${n}
+
+Generated by \`@razorwind/shiki\`.
+
+## Files
+
+${r}
+
+## Setup
+
+1. Copy or import the generated JSON into your app (paths depend on your bundler).
+
+2. Register themes when creating a Shiki highlighter:
+
+\`\`\`ts
+import { createHighlighter } from "shiki";
+import theme from "./${t.fileName}";
+
+const highlighter = await createHighlighter({
+  themes: [theme],
+  langs: ["javascript"]
+});
+
+const html = highlighter.codeToHtml("const x = 1", {
+  lang: "javascript",
+  theme: "${t.name}"
+});
+\`\`\`
+
+Or load at runtime:
+
+\`\`\`ts
+import { readFile } from "node:fs/promises";
+
+const theme = JSON.parse(
+  await readFile("./${t.fileName}", "utf8")
+);
+await highlighter.loadTheme(theme);
+\`\`\`
+
+## Select / load theme
+
+Pass the theme id to \`codeToHtml\`, \`codeToTokens\`, or \`getTokenStyle\`:
+
+${i}
+`}function i(e){return(0,t.themeDisplayName)(e)}const a={name:`razorwind-shiki`};function o(e,n,r){return(0,t.createDocument)(e,n,a,r)}function s(e){return(0,t.isObject)(e)&&typeof e.name==`string`&&e.name.length>0}function c(e){if(Array.isArray(e))return e.map((e,t)=>{if(!s(e))throw TypeError(`@razorwind/shiki mapTheme()[${t}] must be a ShikiTheme with name`);return e});if(s(e))return[e];if(!(0,t.isObject)(e))throw TypeError(`@razorwind/shiki mapTheme() must return a theme, theme array, or theme record`);return Object.entries(e).map(([e,t])=>{if(!s(t))throw TypeError(`@razorwind/shiki mapTheme()["${e}"] must be a ShikiTheme with name`);return{...t,name:t.name||e}})}function l(e){if(!e.mapTheme)throw Error(`@razorwind/shiki requires options.mapTheme`)}function u(e){let t=e.settings??e.tokenColors??[],n={name:e.name,settings:t};return e.displayName&&(n.displayName=e.displayName),e.type&&(n.type=e.type),e.fg!==void 0&&(n.fg=e.fg),e.bg!==void 0&&(n.bg=e.bg),e.colors&&(n.colors=e.colors),e.tokenColors&&e.settings&&(n.tokenColors=e.tokenColors),e.colorReplacements&&(n.colorReplacements=e.colorReplacements),e.semanticHighlighting!==void 0&&(n.semanticHighlighting=e.semanticHighlighting),e.semanticTokenColors&&(n.semanticTokenColors=e.semanticTokenColors),`${JSON.stringify(n,null,2)}\n`}function d(e,a){l(a);let s=a.outputPath??`shiki-themes`,d=c(a.mapTheme(e.tokens));if(d.length===0)throw Error(`@razorwind/shiki mapTheme() returned no themes`);let f={},p=new Set,m=[];for(let e of d){let r=`${(0,t.slugifyThemeName)(e.name)}.json`;if(p.has(r)){let n=2;for(;p.has(`${(0,t.slugifyThemeName)(e.name)}-${n}.json`);)n+=1;r=`${(0,t.slugifyThemeName)(e.name)}-${n}.json`}p.add(r);let a=(0,n.join)(s,r);f[a]=o(a,u(e),`json`),m.push({name:e.name,displayName:i(e),fileName:r})}let h=a.installGuide??r({themes:m}),g=(0,n.join)(s,`INSTALL.md`);return f[g]=o(g,h,`markdown`),f}var f=(0,e.definePlugin)(e=>({name:`shiki`,generate:async t=>{if(!e)throw Error(`@razorwind/shiki requires options: { mapTheme }`);return d(t,e)}}));exports.default=f,Object.defineProperty(exports,"flattenTokens",{enumerable:!0,get:function(){return t.flattenTokens}}),Object.defineProperty(exports,"formatTokenValue",{enumerable:!0,get:function(){return t.formatTokenValue}}),exports.generateShikiTheme=d,exports.normalizeThemes=c,exports.renderInstallMd=r,exports.renderThemeJson=u,Object.defineProperty(exports,"resolveTokenSets",{enumerable:!0,get:function(){return t.resolveTokenSets}}),exports.themeDisplayName=i,Object.defineProperty(exports,"toCssVar",{enumerable:!0,get:function(){return t.toCssVar}});

package/dist/index.d.cts

@@ -1,7 +1,7 @@
+import { flattenTokens, formatTokenValue, resolveTokenSets, toCssVar } from "@razorwind/core/utils";
+import { GeneratorFunctionResult } from "@power-plant/core";
 import { Schema, Tokens } from "@razorwind/core/schema";
 import { TokenType } from "@power-plant/dtcg-schema";
-import { formatTokenValue, toCssVar } from "@razorwind/core/utils";
-import { GeneratorFunctionResult } from "@power-plant/core";
 //#region src/types.d.ts
 /**
  * A flattened design token ready for Shiki theme mapping.
@@ -100,21 +100,30 @@ interface ShikiPluginOptions {
    * Does not filter what {@link mapTheme} receives.
    */
   includeTypes?: TokenType[];
+  /**
+   * Override body for generated `INSTALL.md`. When omitted, Shiki load-theme
+   * steps are generated from contributed themes.
+   */
+  installGuide?: string;
 }
 //#endregion
-//#region src/flatten.d.ts
-interface TokenSet {
-  id: string;
-  tokens: Tokens;
-}
+//#region src/install.d.ts
 /**
- * Split `Schema.tokens` into one or more named token sets.
+ * Build Shiki INSTALL.md for generated theme JSON files.
+ *
+ * @see https://shiki.style/guide/load-theme
  */
-declare function resolveTokenSets(tokens: Tokens | Record<string, Tokens>): TokenSet[];
+declare function renderInstallMd(options: {
+  themes: Array<{
+    name: string;
+    displayName: string;
+    fileName: string;
+  }>;
+}): string;
 /**
- * Flatten DTCG token trees into rows helpful for {@link ShikiPluginOptions.mapTheme}.
+ * Title-case a theme name for display when \`displayName\` is omitted.
  */
-declare function flattenTokens(tokens: Tokens | Record<string, Tokens>, options?: Pick<ShikiPluginOptions, "includeTypes">): FlatToken[];
+declare function themeDisplayName(theme: ShikiTheme): string;
 //#endregion
 //#region src/generate.d.ts
 /**
@@ -186,5 +195,5 @@ declare function generateShikiTheme(spec: Schema, options: ShikiPluginOptions):
  */
 declare const _default: (options?: ShikiPluginOptions | undefined) => import("@razorwind/core/plugin").Plugin;
 //#endregion
-export { type FlatToken, type GenerateShikiTheme, type ShikiPluginOptions, type ShikiTheme, type ShikiThemeSetting, _default as default, flattenTokens, formatTokenValue, generateShikiTheme, normalizeThemes, renderThemeJson, resolveTokenSets, toCssVar };
+export { type FlatToken, type GenerateShikiTheme, type ShikiPluginOptions, type ShikiTheme, type ShikiThemeSetting, _default as default, flattenTokens, formatTokenValue, generateShikiTheme, normalizeThemes, renderInstallMd, renderThemeJson, resolveTokenSets, themeDisplayName, 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":";;;;;;;;UAwBiB;;EAEf;;EAEA,OAAO;;EAEP;;EAEA;;EAEA;;EAEA;;;;;;;UAQe;EACf;EACA;EACA;IACE;IACA;IACA;;;;;;;;;;;;UAaa;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;;;;EAKA,SAAS;;EAET,WAAW;;;;;EAKX,cAAc;;EAEd,oBAAoB;EACpB;EACA,sBAAsB;;;;;;;KAQZ,sBACV,QAAQ,SAAS,eAAe,YAC7B,aAAa,eAAe,eAAe;;;;;;UAO/B;;;;;;EAMf;;;;;;EAOA,UAAU;;;;;EAMV,eAAe;;;;UCjBA;EACf;EACA,QAAQ;;;;;iBAMM,iBACd,QAAQ,SAAS,eAAe,UAC/B;;;;iBAwBa,cACd,QAAQ,SAAS,eAAe,SAChC,UAAS,KAAK,sCACb;;;;;;iBCzFa,gBACd,QAAQ,aAAa,eAAe,eAAe,cAClD;;;;;;iBAkDa,gBAAgB,OAAO;;;;;;;;;iBAgDvB,mBACd,MAAM,QACN,SAAS,qBACR,wBAAwB,QAAQ"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/install.ts","../src/generate.ts","../src/index.ts"],"mappings":";;;;;;;;UAwBiB;;EAEf;;EAEA,OAAO;;EAEP;;EAEA;;EAEA;;EAEA;;;;;;;UAQe;EACf;EACA;EACA;IACE;IACA;IACA;;;;;;;;;;;;UAaa;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;;;;EAKA,SAAS;;EAET,WAAW;;;;;EAKX,cAAc;;EAEd,oBAAoB;EACpB;EACA,sBAAsB;;;;;;;KAQZ,sBACV,QAAQ,SAAS,eAAe,YAC7B,aAAa,eAAe,eAAe;;;;;;UAO/B;;;;;;EAMf;;;;;;EAOA,UAAU;;;;;EAMV,eAAe;;;;;EAMf;;;;;;;;;iBCzGc,gBAAgB;EAC9B,QAAQ;IAAQ;IAAc;IAAqB;;;;;;iBAsErC,iBAAiB,OAAO;;;;;;iBChDxB,gBACd,QAAQ,aAAa,eAAe,eAAe,cAClD;;;;;;iBAkDa,gBAAgB,OAAO;;;;;;;;;iBAkDvB,mBACd,MAAM,QACN,SAAS,qBACR,wBAAwB,QAAQ"}

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { formatTokenValue, toCssVar } from "@razorwind/core/utils";
+import { flattenTokens, formatTokenValue, resolveTokenSets, toCssVar } from "@razorwind/core/utils";
+import { GeneratorFunctionResult } from "@power-plant/core";
 import { Schema, Tokens } from "@razorwind/core/schema";
 import { TokenType } from "@power-plant/dtcg-schema";
-import { GeneratorFunctionResult } from "@power-plant/core";
 //#region src/types.d.ts
 /**
  * A flattened design token ready for Shiki theme mapping.
@@ -100,21 +100,30 @@ interface ShikiPluginOptions {
    * Does not filter what {@link mapTheme} receives.
    */
   includeTypes?: TokenType[];
+  /**
+   * Override body for generated `INSTALL.md`. When omitted, Shiki load-theme
+   * steps are generated from contributed themes.
+   */
+  installGuide?: string;
 }
 //#endregion
-//#region src/flatten.d.ts
-interface TokenSet {
-  id: string;
-  tokens: Tokens;
-}
+//#region src/install.d.ts
 /**
- * Split `Schema.tokens` into one or more named token sets.
+ * Build Shiki INSTALL.md for generated theme JSON files.
+ *
+ * @see https://shiki.style/guide/load-theme
  */
-declare function resolveTokenSets(tokens: Tokens | Record<string, Tokens>): TokenSet[];
+declare function renderInstallMd(options: {
+  themes: Array<{
+    name: string;
+    displayName: string;
+    fileName: string;
+  }>;
+}): string;
 /**
- * Flatten DTCG token trees into rows helpful for {@link ShikiPluginOptions.mapTheme}.
+ * Title-case a theme name for display when \`displayName\` is omitted.
  */
-declare function flattenTokens(tokens: Tokens | Record<string, Tokens>, options?: Pick<ShikiPluginOptions, "includeTypes">): FlatToken[];
+declare function themeDisplayName(theme: ShikiTheme): string;
 //#endregion
 //#region src/generate.d.ts
 /**
@@ -186,5 +195,5 @@ declare function generateShikiTheme(spec: Schema, options: ShikiPluginOptions):
  */
 declare const _default: (options?: ShikiPluginOptions | undefined) => import("@razorwind/core/plugin").Plugin;
 //#endregion
-export { type FlatToken, type GenerateShikiTheme, type ShikiPluginOptions, type ShikiTheme, type ShikiThemeSetting, _default as default, flattenTokens, formatTokenValue, generateShikiTheme, normalizeThemes, renderThemeJson, resolveTokenSets, toCssVar };
+export { type FlatToken, type GenerateShikiTheme, type ShikiPluginOptions, type ShikiTheme, type ShikiThemeSetting, _default as default, flattenTokens, formatTokenValue, generateShikiTheme, normalizeThemes, renderInstallMd, renderThemeJson, resolveTokenSets, themeDisplayName, 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/install.ts","../src/generate.ts","../src/index.ts"],"mappings":""}

package/dist/index.mjs

@@ -1,2 +1,49 @@
-import{definePlugin as e}from"@razorwind/core/plugin";import{createDocument as t,formatTokenValue as n,formatTokenValue as r,isObject as i,toCssVar as a}from"@razorwind/core/utils";import{join as o}from"node:path";const s=/^(?:light|dark|dim|dimmed|high-contrast|hc|protanopia|deuteranopia|tritanopia|achromatopsia|achromatomaly|monochrome|monochromatic|grayscale|greyscale|bw|black-and-white|black-white|blackWhite|default|base|theme)(?:[A-Z]\w*|[._-].+)?$/i;function c(e){return`$value`in e||`value`in e||`$ref`in e||`ref`in e}function l(e){if(typeof e.$description==`string`)return e.$description;if(typeof e.description==`string`)return e.description}function u(e,t){return typeof e.$type==`string`?e.$type:typeof e.type==`string`?e.type:t}function d(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 f(e,t,n,a,o){if(!i(e))return;let s=u(e,n);if(c(e)){let n=d(e);o.push({path:t.join(`.`),type:s,value:n,cssValue:r(n,s),description:l(e),theme:a});return}for(let[n,r]of Object.entries(e))n.startsWith(`$`)||f(r,[...t,n],s,a,o)}function p(e){if(!i(e))return[];let t=Object.keys(e).filter(e=>!e.startsWith(`$`));if(t.length>0&&t.every(e=>s.test(e))){let n=e;return t.map(e=>({id:e,tokens:n[e]}))}return[{id:`default`,tokens:e}]}function m(e,t={}){let n=t.includeTypes?new Set(t.includeTypes):void 0,r=[];for(let t of p(e)){let e=t.id==="default"?void 0:t.id;f(t.tokens,[],void 0,e,r)}return n?r.filter(e=>!e.type||n.has(e.type)):r}const h={name:`razorwind-shiki`};function g(e,n,r){return t(e,n,h,r)}function _(e){return e.trim().toLowerCase().replaceAll(/[^a-z0-9]+/g,`-`).replaceAll(/^-+|-+$/g,``)}function v(e){return i(e)&&typeof e.name==`string`&&e.name.length>0}function y(e){if(Array.isArray(e))return e.map((e,t)=>{if(!v(e))throw TypeError(`@razorwind/shiki mapTheme()[${t}] must be a ShikiTheme with name`);return e});if(v(e))return[e];if(!i(e))throw TypeError(`@razorwind/shiki mapTheme() must return a theme, theme array, or theme record`);return Object.entries(e).map(([e,t])=>{if(!v(t))throw TypeError(`@razorwind/shiki mapTheme()["${e}"] must be a ShikiTheme with name`);return{...t,name:t.name||e}})}function b(e){if(!e.mapTheme)throw Error(`@razorwind/shiki requires options.mapTheme`)}function x(e){let t=e.settings??e.tokenColors??[],n={name:e.name,settings:t};return e.displayName&&(n.displayName=e.displayName),e.type&&(n.type=e.type),e.fg!==void 0&&(n.fg=e.fg),e.bg!==void 0&&(n.bg=e.bg),e.colors&&(n.colors=e.colors),e.tokenColors&&e.settings&&(n.tokenColors=e.tokenColors),e.colorReplacements&&(n.colorReplacements=e.colorReplacements),e.semanticHighlighting!==void 0&&(n.semanticHighlighting=e.semanticHighlighting),e.semanticTokenColors&&(n.semanticTokenColors=e.semanticTokenColors),`${JSON.stringify(n,null,2)}\n`}function S(e,t){b(t);let n=t.outputPath??`shiki-themes`,r=y(t.mapTheme(e.tokens));if(r.length===0)throw Error(`@razorwind/shiki mapTheme() returned no themes`);let i={},a=new Set;for(let e of r){let t=`${_(e.name)}.json`;if(a.has(t)){let n=2;for(;a.has(`${_(e.name)}-${n}.json`);)n+=1;t=`${_(e.name)}-${n}.json`}a.add(t);let r=o(n,t);i[r]=g(r,x(e),`json`)}return i}var C=e(e=>({name:`shiki`,generate:async t=>{if(!e)throw Error(`@razorwind/shiki requires options: { mapTheme }`);return S(t,e)}}));export{C as default,m as flattenTokens,n as formatTokenValue,S as generateShikiTheme,y as normalizeThemes,x as renderThemeJson,p as resolveTokenSets,a as toCssVar};
+import{definePlugin as e}from"@razorwind/core/plugin";import{createDocument as t,flattenTokens as n,formatTokenValue as r,isObject as i,resolveTokenSets as a,slugifyThemeName as o,themeDisplayName as s,toCssVar as c}from"@razorwind/core/utils";import{join as l}from"node:path";function u(e){let t=e.themes[0],n=e.themes.length===1?t.displayName:`Shiki Themes`,r=e.themes.map(e=>`- \`${e.fileName}\` — ${e.displayName} (theme id: \`${e.name}\`)`).join(`
+`),i=e.themes.map(e=>`- \`${e.name}\` — ${e.displayName}`).join(`
+`);return`# Installing ${n}
+
+Generated by \`@razorwind/shiki\`.
+
+## Files
+
+${r}
+
+## Setup
+
+1. Copy or import the generated JSON into your app (paths depend on your bundler).
+
+2. Register themes when creating a Shiki highlighter:
+
+\`\`\`ts
+import { createHighlighter } from "shiki";
+import theme from "./${t.fileName}";
+
+const highlighter = await createHighlighter({
+  themes: [theme],
+  langs: ["javascript"]
+});
+
+const html = highlighter.codeToHtml("const x = 1", {
+  lang: "javascript",
+  theme: "${t.name}"
+});
+\`\`\`
+
+Or load at runtime:
+
+\`\`\`ts
+import { readFile } from "node:fs/promises";
+
+const theme = JSON.parse(
+  await readFile("./${t.fileName}", "utf8")
+);
+await highlighter.loadTheme(theme);
+\`\`\`
+
+## Select / load theme
+
+Pass the theme id to \`codeToHtml\`, \`codeToTokens\`, or \`getTokenStyle\`:
+
+${i}
+`}function d(e){return s(e)}const f={name:`razorwind-shiki`};function p(e,n,r){return t(e,n,f,r)}function m(e){return i(e)&&typeof e.name==`string`&&e.name.length>0}function h(e){if(Array.isArray(e))return e.map((e,t)=>{if(!m(e))throw TypeError(`@razorwind/shiki mapTheme()[${t}] must be a ShikiTheme with name`);return e});if(m(e))return[e];if(!i(e))throw TypeError(`@razorwind/shiki mapTheme() must return a theme, theme array, or theme record`);return Object.entries(e).map(([e,t])=>{if(!m(t))throw TypeError(`@razorwind/shiki mapTheme()["${e}"] must be a ShikiTheme with name`);return{...t,name:t.name||e}})}function g(e){if(!e.mapTheme)throw Error(`@razorwind/shiki requires options.mapTheme`)}function _(e){let t=e.settings??e.tokenColors??[],n={name:e.name,settings:t};return e.displayName&&(n.displayName=e.displayName),e.type&&(n.type=e.type),e.fg!==void 0&&(n.fg=e.fg),e.bg!==void 0&&(n.bg=e.bg),e.colors&&(n.colors=e.colors),e.tokenColors&&e.settings&&(n.tokenColors=e.tokenColors),e.colorReplacements&&(n.colorReplacements=e.colorReplacements),e.semanticHighlighting!==void 0&&(n.semanticHighlighting=e.semanticHighlighting),e.semanticTokenColors&&(n.semanticTokenColors=e.semanticTokenColors),`${JSON.stringify(n,null,2)}\n`}function v(e,t){g(t);let n=t.outputPath??`shiki-themes`,r=h(t.mapTheme(e.tokens));if(r.length===0)throw Error(`@razorwind/shiki mapTheme() returned no themes`);let i={},a=new Set,s=[];for(let e of r){let t=`${o(e.name)}.json`;if(a.has(t)){let n=2;for(;a.has(`${o(e.name)}-${n}.json`);)n+=1;t=`${o(e.name)}-${n}.json`}a.add(t);let r=l(n,t);i[r]=p(r,_(e),`json`),s.push({name:e.name,displayName:d(e),fileName:t})}let c=t.installGuide??u({themes:s}),f=l(n,`INSTALL.md`);return i[f]=p(f,c,`markdown`),i}var y=e(e=>({name:`shiki`,generate:async t=>{if(!e)throw Error(`@razorwind/shiki requires options: { mapTheme }`);return v(t,e)}}));export{y as default,n as flattenTokens,r as formatTokenValue,v as generateShikiTheme,h as normalizeThemes,u as renderInstallMd,_ as renderThemeJson,a as resolveTokenSets,d as themeDisplayName,c as toCssVar};
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@razorwind/shiki",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "type": "module",
   "description": "Razorwind plugin that generates Shiki / TextMate themes from design tokens.",
   "repository": {
@@ -67,15 +67,15 @@
   "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.29"
+    "@razorwind/core": "^0.0.30"
   },
   "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": "a861c6938501ed645ccdcd3970fc1164d110b4ed"
+  "gitHead": "11a6e827627acf51ef0044e366fd9493f2173ec2"
 }