@razorwind/vsce 0.0.6 → 0.0.8

package/dist/index.cjs

@@ -1,4 +1,41 @@
-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}function d(e){return`import { existsSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+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.map(e=>`- \`${e.path}\` — ${e.label}`).join(`
+`),n=e.themes.map(e=>`- **${e.label}**`).join(`
+`),r=`./dist/${e.extensionName}.vsix`,i=e.includeScripts?`
+## Package VSIX
+
+From the generated extension directory:
+
+\`\`\`bash
+pnpm package-vsix
+\`\`\`
+
+This writes \`${r}\`.
+
+## Install from VSIX
+
+1. Open the Extensions view (\`Ctrl+Shift+X\` / \`Cmd+Shift+X\`)
+2. Open the **⋯** menu → **Install from VSIX...**
+3. Select \`${r}\`
+`:`
+## Install locally
+
+Open this folder in VS Code / Cursor and press **F5** to launch an Extension Development Host, or copy \`themes/*.json\` into a local extension package.
+`;return`# Installing ${e.displayName}
+
+Generated by \`@razorwind/vsce\`.
+
+## Files
+
+- \`package.json\` — extension manifest (\`contributes.themes\`)
+- \`themes/*.json\` — color theme documents
+${t}
+${i}
+## Select theme
+
+Open the Command Palette (\`Ctrl+Shift+P\` / \`Cmd+Shift+P\`) → **Preferences: Color Theme** → choose:
+
+${n}
+`}function i(e){return`import { existsSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -62,7 +99,7 @@ export function withVsixPackageShim(action: () => void): void {
     console.log(\`\\nRestored package name: \${originalName}\`);
   }
 }
-`}function f(){return`import { execFileSync } from "node:child_process";
+`}function a(){return`import { execFileSync } from "node:child_process";
 import { mkdirSync } from "node:fs";
 import { join } from "node:path";
 import { packageRoot, withVsixPackageShim } from "./vsixPackageShim.ts";
@@ -86,7 +123,7 @@ withVsixPackageShim(() => {
     }
   );
 });
-`}function p(){return`import { execFileSync } from "node:child_process";
+`}function o(){return`import { execFileSync } from "node:child_process";
 import { packageRoot, withVsixPackageShim } from "./vsixPackageShim.ts";
 
 // Manual VS Marketplace publish. Requires VSCE_PAT in the environment.
@@ -103,7 +140,7 @@ withVsixPackageShim(() => {
     stdio: "inherit"
   });
 });
-`}function m(){return`import { execFileSync } from "node:child_process";
+`}function s(){return`import { execFileSync } from "node:child_process";
 import { packageRoot, withVsixPackageShim } from "./vsixPackageShim.ts";
 
 // Manual Open VSX publish. Requires OVSX_PAT in the environment.
@@ -120,22 +157,17 @@ withVsixPackageShim(() => {
     stdio: "inherit"
   });
 });
-`}function h(e){let t=e.themes.map(e=>`- ${e.label}`).join(`
+`}function c(e){let t=e.themes.map(e=>`- ${e.label}`).join(`
 `),n=e.repositoryUrl?`\n## Links\n\n- [GitHub](${e.repositoryUrl})\n`:``;return`# ${e.displayName}
 
 ${e.description}
 
-## Installation
-
-1. Open the Extensions view (\`Cmd+Shift+X\` / \`Ctrl+Shift+X\`)
-2. Search for **${e.displayName}**
-3. Click **Install**
-4. Open the Command Palette (\`Cmd+Shift+P\` / \`Ctrl+Shift+P\`) → **Color Theme** → select a theme
+See **INSTALL.md** for VS Code extension install steps (VSIX or Extension Development Host).
 
 ## Themes
 
 ${t||`- (generated themes)`}
-${n}`}function g(){return`node_modules/**
+${n}`}function l(){return`node_modules/**
 src/**
 scripts/**
 test/**
@@ -148,5 +180,6 @@ tests/**
 *.vsix
 artifacts/**
 README.md.bak
+INSTALL.md
 .DS_Store
-`}const _={name:`razorwind-vsce`},v={vscode:`^1.85.0`};function y(e,n,r){return(0,t.createDocument)(e,n,_,r)}function b(e){return e.split(/[-_.\s]+/).filter(Boolean).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(` `)}function x(e){return e.trim().toLowerCase().replaceAll(/[^a-z0-9]+/g,`-`).replaceAll(/^-+|-+$/g,``)}function S(e){switch(e){case`light`:return`vs`;case`hc`:return`hc-black`;case`hcLight`:return`hc-light`;case`dark`:return`vs-dark`;default:return`vs-dark`}}function C(e){return(0,t.isObject)(e)&&typeof e.name==`string`&&(e.type===`light`||e.type===`dark`||e.type===`hc`||e.type===`hcLight`)}function w(e){if(Array.isArray(e))return e.map((e,t)=>{if(!C(e))throw TypeError(`@razorwind/vsce mapTheme()[${t}] must be a VsCodeTheme with name + type`);return e});if(C(e))return[e];if(!(0,t.isObject)(e))throw TypeError(`@razorwind/vsce mapTheme() must return a theme, theme array, or theme record`);return Object.entries(e).map(([e,t])=>{if(!C(t))throw TypeError(`@razorwind/vsce mapTheme()["${e}"] must be a VsCodeTheme with name + type`);return{...t,name:t.name||e}})}function T(e){if(typeof e==`string`)return e;if(e&&typeof e.url==`string`)return e.url}function E(e){if(!e.mapTheme)throw Error(`@razorwind/vsce requires options.mapTheme`);if(!e.name||e.name.includes(`/`))throw Error(`@razorwind/vsce requires options.name (unscoped Marketplace id)`);if(!e.publisher)throw Error(`@razorwind/vsce requires options.publisher`)}function D(e){return e===`light`||e===`hcLight`?`light`:`dark`}function O(e){let t={name:e.name,type:D(e.type),colors:e.colors??{}};return e.displayName&&(t.displayName=e.displayName),e.tokenColors&&(t.tokenColors=e.tokenColors),e.semanticHighlighting!==void 0&&(t.semanticHighlighting=e.semanticHighlighting),e.semanticTokenColors&&(t.semanticTokenColors=e.semanticTokenColors),`${JSON.stringify(t,null,2)}\n`}function k(e,n){let r=e.includeScripts!==!1,i=e.displayName??b(e.name),a=e.description??`${i} — VS Code themes generated by Razorwind`,o={themes:n.map(e=>({label:e.displayName??e.name,uiTheme:S(e.type),path:`./themes/${x(e.name)}.json`}))},s=r?{"package-vsix":`node --import tsx scripts/buildVsCodePackage.ts`,"publish-vsce":`node --import tsx scripts/publishVsce.ts`,"publish-ovsx":`node --import tsx scripts/publishOvsx.ts`}:void 0,c={name:e.name,displayName:i,description:a,version:e.version??`0.0.1`,publisher:e.publisher,license:e.license??`Apache-2.0`,categories:e.categories??[`Themes`],engines:e.engines??{...v},contributes:o,...e.keywords?{keywords:e.keywords}:{},...e.repository?{repository:e.repository}:{},...e.homepage?{homepage:e.homepage}:{},...e.bugs?{bugs:e.bugs}:{},...e.author?{author:e.author}:{},...e.icon?{icon:e.icon}:{},...e.galleryBanner?{galleryBanner:e.galleryBanner}:{},...s?{scripts:s}:{},...e.packageJson??{}};return c.name=e.name,c.publisher=e.publisher,c.contributes=o,s&&(c.scripts=(0,t.isObject)(c.scripts)&&!Array.isArray(c.scripts)?{...c.scripts,...s}:s),`${JSON.stringify(c,null,2)}\n`}function A(e,t){E(t);let r=t.outputPath??`vscode-extension`,i=t.includeScripts!==!1,a=t.extensionName??t.name,o=t.displayName??b(t.name),s=t.description??`${o} — VS Code themes generated by Razorwind`,c=w(t.mapTheme(e.tokens));if(c.length===0)throw Error(`@razorwind/vsce mapTheme() returned no themes`);let l={};for(let e of c){let t=`${x(e.name)}.json`,i=(0,n.join)(r,`themes`,t);l[i]=y(i,O(e),`json`)}let u=(0,n.join)(r,`package.json`);l[u]=y(u,k(t,c),`json`);let _=(0,n.join)(r,`.vscodeignore`);l[_]=y(_,g(),`ignore`);let v=c.map(e=>({label:e.displayName??e.name})),S=t.readme??h({displayName:o,description:s,themes:v,repositoryUrl:T(t.repository)}),C=(0,n.join)(r,`README.md`);if(l[C]=y(C,S,`markdown`),i){let e=(0,n.join)(r,`scripts`,`vsixPackageShim.ts`);l[e]=y(e,d(a),`typescript`);let i=(0,n.join)(r,`scripts`,`buildVsCodePackage.ts`);l[i]=y(i,f(),`typescript`);let c=(0,n.join)(r,`scripts`,`publishVsce.ts`);l[c]=y(c,p(),`typescript`);let u=(0,n.join)(r,`scripts`,`publishOvsx.ts`);l[u]=y(u,m(),`typescript`);let g=(0,n.join)(r,`scripts`,`README.package.md`);l[g]=y(g,h({displayName:o,description:s,themes:v,repositoryUrl:T(t.repository)}),`markdown`)}return l}var j=(0,e.definePlugin)(e=>({name:`vsce`,generate:async t=>{if(!e)throw Error(`@razorwind/vsce requires options: { name, publisher, mapTheme }`);return A(t,e)}}));exports.default=j,exports.flattenTokens=u,Object.defineProperty(exports,"formatTokenValue",{enumerable:!0,get:function(){return t.formatTokenValue}}),exports.generateVsceExtension=A,exports.normalizeThemes=w,exports.renderPackageJson=k,exports.renderThemeJson=O,exports.resolveTokenSets=l,Object.defineProperty(exports,"toCssVar",{enumerable:!0,get:function(){return t.toCssVar}});
+`}const u={name:`razorwind-vsce`},d={vscode:`^1.85.0`};function f(e,n,r){return(0,t.createDocument)(e,n,u,r)}function p(e){switch(e){case`light`:return`vs`;case`hc`:return`hc-black`;case`hcLight`:return`hc-light`;case`dark`:return`vs-dark`;default:return`vs-dark`}}function m(e){return(0,t.isObject)(e)&&typeof e.name==`string`&&(e.type===`light`||e.type===`dark`||e.type===`hc`||e.type===`hcLight`)}function h(e){if(Array.isArray(e))return e.map((e,t)=>{if(!m(e))throw TypeError(`@razorwind/vsce mapTheme()[${t}] must be a VsCodeTheme with name + type`);return e});if(m(e))return[e];if(!(0,t.isObject)(e))throw TypeError(`@razorwind/vsce mapTheme() must return a theme, theme array, or theme record`);return Object.entries(e).map(([e,t])=>{if(!m(t))throw TypeError(`@razorwind/vsce mapTheme()["${e}"] must be a VsCodeTheme with name + type`);return{...t,name:t.name||e}})}function g(e){if(typeof e==`string`)return e;if(e&&typeof e.url==`string`)return e.url}function _(e){if(!e.mapTheme)throw Error(`@razorwind/vsce requires options.mapTheme`);if(!e.name||e.name.includes(`/`))throw Error(`@razorwind/vsce requires options.name (unscoped Marketplace id)`);if(!e.publisher)throw Error(`@razorwind/vsce requires options.publisher`)}function v(e){return e===`light`||e===`hcLight`?`light`:`dark`}function y(e){let t={name:e.name,type:v(e.type),colors:e.colors??{}};return e.displayName&&(t.displayName=e.displayName),e.tokenColors&&(t.tokenColors=e.tokenColors),e.semanticHighlighting!==void 0&&(t.semanticHighlighting=e.semanticHighlighting),e.semanticTokenColors&&(t.semanticTokenColors=e.semanticTokenColors),`${JSON.stringify(t,null,2)}\n`}function b(e,n){let r=e.includeScripts!==!1,i=e.displayName??(0,t.titleCase)(e.name),a=e.description??`${i} — VS Code themes generated by Razorwind`,o={themes:n.map(e=>({label:e.displayName??e.name,uiTheme:p(e.type),path:`./themes/${(0,t.slugifyThemeName)(e.name)}.json`}))},s=r?{"package-vsix":`node --import tsx scripts/buildVsCodePackage.ts`,"publish-vsce":`node --import tsx scripts/publishVsce.ts`,"publish-ovsx":`node --import tsx scripts/publishOvsx.ts`}:void 0,c={name:e.name,displayName:i,description:a,version:e.version??`0.0.1`,publisher:e.publisher,license:e.license??`Apache-2.0`,categories:e.categories??[`Themes`],engines:e.engines??{...d},contributes:o,...e.keywords?{keywords:e.keywords}:{},...e.repository?{repository:e.repository}:{},...e.homepage?{homepage:e.homepage}:{},...e.bugs?{bugs:e.bugs}:{},...e.author?{author:e.author}:{},...e.icon?{icon:e.icon}:{},...e.galleryBanner?{galleryBanner:e.galleryBanner}:{},...s?{scripts:s}:{},...e.packageJson??{}};return c.name=e.name,c.publisher=e.publisher,c.contributes=o,s&&(c.scripts=(0,t.isObject)(c.scripts)&&!Array.isArray(c.scripts)?{...c.scripts,...s}:s),`${JSON.stringify(c,null,2)}\n`}function x(e,u){_(u);let d=u.outputPath??`vscode-extension`,p=u.includeScripts!==!1,m=u.extensionName??u.name,v=u.displayName??(0,t.titleCase)(u.name),x=u.description??`${v} — VS Code themes generated by Razorwind`,S=h(u.mapTheme(e.tokens));if(S.length===0)throw Error(`@razorwind/vsce mapTheme() returned no themes`);let C={};for(let e of S){let r=`${(0,t.slugifyThemeName)(e.name)}.json`,i=(0,n.join)(d,`themes`,r);C[i]=f(i,y(e),`json`)}let w=(0,n.join)(d,`package.json`);C[w]=f(w,b(u,S),`json`);let T=(0,n.join)(d,`.vscodeignore`);C[T]=f(T,l(),`ignore`);let E=S.map(e=>({label:e.displayName??e.name,path:`./themes/${(0,t.slugifyThemeName)(e.name)}.json`})),D=u.readme??c({displayName:v,description:x,themes:E,repositoryUrl:g(u.repository)}),O=(0,n.join)(d,`README.md`);C[O]=f(O,D,`markdown`);let k=u.installGuide??r({displayName:v,extensionName:m,themes:E,includeScripts:p}),A=(0,n.join)(d,`INSTALL.md`);if(C[A]=f(A,k,`markdown`),p){let e=(0,n.join)(d,`scripts`,`vsixPackageShim.ts`);C[e]=f(e,i(m),`typescript`);let t=(0,n.join)(d,`scripts`,`buildVsCodePackage.ts`);C[t]=f(t,a(),`typescript`);let r=(0,n.join)(d,`scripts`,`publishVsce.ts`);C[r]=f(r,o(),`typescript`);let l=(0,n.join)(d,`scripts`,`publishOvsx.ts`);C[l]=f(l,s(),`typescript`);let p=(0,n.join)(d,`scripts`,`README.package.md`);C[p]=f(p,c({displayName:v,description:x,themes:E,repositoryUrl:g(u.repository)}),`markdown`)}return C}var S=(0,e.definePlugin)(e=>({name:`vsce`,generate:async t=>{if(!e)throw Error(`@razorwind/vsce requires options: { name, publisher, mapTheme }`);return x(t,e)}}));exports.default=S,Object.defineProperty(exports,"flattenTokens",{enumerable:!0,get:function(){return t.flattenTokens}}),Object.defineProperty(exports,"formatTokenValue",{enumerable:!0,get:function(){return t.formatTokenValue}}),exports.generateVsceExtension=x,exports.normalizeThemes=h,exports.renderInstallMd=r,exports.renderPackageJson=b,exports.renderThemeJson=y,Object.defineProperty(exports,"resolveTokenSets",{enumerable:!0,get:function(){return t.resolveTokenSets}}),Object.defineProperty(exports,"toCssVar",{enumerable:!0,get:function(){return t.toCssVar}});

package/dist/index.d.cts

@@ -1,7 +1,23 @@
+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/install.d.ts
+/**
+ * VS Code extension INSTALL.md for generated theme packages.
+ *
+ * @see https://code.visualstudio.com/api/extension-guides/color-theme
+ */
+declare function renderInstallMd(options: {
+  displayName: string;
+  extensionName: string;
+  themes: Array<{
+    label: string;
+    path: string;
+  }>;
+  includeScripts: boolean;
+}): string;
+//#endregion
 //#region src/types.d.ts
 /**
  * A flattened design token ready for VS Code theme mapping.
@@ -170,22 +186,13 @@ interface VscePluginOptions {
    * (shallow merge; `contributes.themes` / `scripts` from the plugin win).
    */
   packageJson?: Record<string, unknown>;
+  /**
+   * Override body for generated `INSTALL.md`. When omitted, VS Code extension
+   * install steps are generated from contributed themes.
+   */
+  installGuide?: string;
 }
 //#endregion
-//#region src/flatten.d.ts
-interface TokenSet {
-  id: string;
-  tokens: Tokens;
-}
-/**
- * Split `Schema.tokens` into one or more named token sets.
- */
-declare function resolveTokenSets(tokens: Tokens | Record<string, Tokens>): TokenSet[];
-/**
- * Flatten DTCG token trees into rows helpful for {@link VscePluginOptions.mapTheme}.
- */
-declare function flattenTokens(tokens: Tokens | Record<string, Tokens>, options?: Pick<VscePluginOptions, "includeTypes">): FlatToken[];
-//#endregion
 //#region src/generate.d.ts
 /**
  * Normalize {@link VscePluginOptions.mapTheme} results into a theme list.
@@ -257,5 +264,5 @@ declare function generateVsceExtension(spec: Schema, options: VscePluginOptions)
  */
 declare const _default: (options?: VscePluginOptions | undefined) => import("@razorwind/core/plugin").Plugin;
 //#endregion
-export { type FlatToken, type GenerateVsCodeTheme, type VsCodeTheme, type VsCodeTokenColor, type VscePluginOptions, _default as default, flattenTokens, formatTokenValue, generateVsceExtension, normalizeThemes, renderPackageJson, renderThemeJson, resolveTokenSets, toCssVar };
+export { type FlatToken, type GenerateVsCodeTheme, type VsCodeTheme, type VsCodeTokenColor, type VscePluginOptions, _default as default, flattenTokens, formatTokenValue, generateVsceExtension, normalizeThemes, renderInstallMd, renderPackageJson, renderThemeJson, 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":";;;;;;;;UAwBiB;;EAEf;;EAEA,OAAO;;EAEP;;EAEA;;EAEA;;EAEA;;;;;;;UAQe;EACf;EACA;EACA;IACE;IACA;IACA;;;;;;;;UASa;;EAEf;;EAEA;;EAEA;EACA,SAAS;EACT,cAAc;EACd;EACA,sBAAsB;IAET;IAAqB;IAAoB;;;;;;;;KAS5C,uBACV,QAAQ,SAAS,eAAe,YAC7B,cAAc,gBAAgB,eAAe;;;;KAKtC;EAGN;EACA;EACA;;;;;;;;UASW;;;;;;;EAOf;;;;;;EAOA,UAAU;;;;;EAMV;;EAGA;;EAGA;;;;;;EAOA;;EAGA;;;;;EAMA;;;;EAKA;EAEA;IAGM;IACA;IACA;;EAGN;EAEA;IAGM;IACA;;EAGN,SAAS;;;;;EAMT;EAEA;IACE;IACA;;;;;EAMF;EAEA;;;;EAKA;IACE;;;;;;;;;;EAWF;;;;;EAMA;;;;;EAMA,eAAe;;;;;EAMf,cAAc;;;;UChHC;EACf;EACA,QAAQ;;;;;iBAMM,iBACd,QAAQ,SAAS,eAAe,UAC/B;;;;iBAwBa,cACd,QAAQ,SAAS,eAAe,SAChC,UAAS,KAAK,qCACb;;;;;;iBCjDa,gBACd,QAAQ,cAAc,gBAAgB,eAAe,eACpD;iBA0Ea,gBAAgB,OAAO;;;;iBA0BvB,kBACd,SAAS,mBACT,QAAQ;;;;iBA+DM,sBACd,MAAM,QACN,SAAS,oBACR,wBAAwB,QAAQ"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/install.ts","../src/types.ts","../src/generate.ts","../src/index.ts"],"mappings":";;;;;;;;;;iBAuBgB,gBAAgB;EAC9B;EACA;EACA,QAAQ;IAAQ;IAAe;;EAC/B;;;;;;;UCHe;;EAEf;;EAEA,OAAO;;EAEP;;EAEA;;EAEA;;EAEA;;;;;;;UAQe;EACf;EACA;EACA;IACE;IACA;IACA;;;;;;;;UASa;;EAEf;;EAEA;;EAEA;EACA,SAAS;EACT,cAAc;EACd;EACA,sBAAsB;IAET;IAAqB;IAAoB;;;;;;;;KAS5C,uBACV,QAAQ,SAAS,eAAe,YAC7B,cAAc,gBAAgB,eAAe;;;;KAKtC;EAGN;EACA;EACA;;;;;;;;UASW;;;;;;;EAOf;;;;;;EAOA,UAAU;;;;;EAMV;;EAGA;;EAGA;;;;;;EAOA;;EAGA;;;;;EAMA;;;;EAKA;EAEA;IAGM;IACA;IACA;;EAGN;EAEA;IAGM;IACA;;EAGN,SAAS;;;;;EAMT;EAEA;IACE;IACA;;;;;EAMF;EAEA;;;;EAKA;IACE;;;;;;;;;;EAWF;;;;;EAMA;;;;;EAMA,eAAe;;;;;EAMf,cAAc;;;;;EAMd;;;;;;;iBCjJc,gBACd,QAAQ,cAAc,gBAAgB,eAAe,eACpD;iBA0Ea,gBAAgB,OAAO;;;;iBA0BvB,kBACd,SAAS,mBACT,QAAQ;;;;iBAiEM,sBACd,MAAM,QACN,SAAS,oBACR,wBAAwB,QAAQ"}

package/dist/index.d.mts

@@ -1,7 +1,23 @@
-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/install.d.ts
+/**
+ * VS Code extension INSTALL.md for generated theme packages.
+ *
+ * @see https://code.visualstudio.com/api/extension-guides/color-theme
+ */
+declare function renderInstallMd(options: {
+  displayName: string;
+  extensionName: string;
+  themes: Array<{
+    label: string;
+    path: string;
+  }>;
+  includeScripts: boolean;
+}): string;
+//#endregion
 //#region src/types.d.ts
 /**
  * A flattened design token ready for VS Code theme mapping.
@@ -170,22 +186,13 @@ interface VscePluginOptions {
    * (shallow merge; `contributes.themes` / `scripts` from the plugin win).
    */
   packageJson?: Record<string, unknown>;
+  /**
+   * Override body for generated `INSTALL.md`. When omitted, VS Code extension
+   * install steps are generated from contributed themes.
+   */
+  installGuide?: string;
 }
 //#endregion
-//#region src/flatten.d.ts
-interface TokenSet {
-  id: string;
-  tokens: Tokens;
-}
-/**
- * Split `Schema.tokens` into one or more named token sets.
- */
-declare function resolveTokenSets(tokens: Tokens | Record<string, Tokens>): TokenSet[];
-/**
- * Flatten DTCG token trees into rows helpful for {@link VscePluginOptions.mapTheme}.
- */
-declare function flattenTokens(tokens: Tokens | Record<string, Tokens>, options?: Pick<VscePluginOptions, "includeTypes">): FlatToken[];
-//#endregion
 //#region src/generate.d.ts
 /**
  * Normalize {@link VscePluginOptions.mapTheme} results into a theme list.
@@ -257,5 +264,5 @@ declare function generateVsceExtension(spec: Schema, options: VscePluginOptions)
  */
 declare const _default: (options?: VscePluginOptions | undefined) => import("@razorwind/core/plugin").Plugin;
 //#endregion
-export { type FlatToken, type GenerateVsCodeTheme, type VsCodeTheme, type VsCodeTokenColor, type VscePluginOptions, _default as default, flattenTokens, formatTokenValue, generateVsceExtension, normalizeThemes, renderPackageJson, renderThemeJson, resolveTokenSets, toCssVar };
+export { type FlatToken, type GenerateVsCodeTheme, type VsCodeTheme, type VsCodeTokenColor, type VscePluginOptions, _default as default, flattenTokens, formatTokenValue, generateVsceExtension, normalizeThemes, renderInstallMd, renderPackageJson, renderThemeJson, 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/install.ts","../src/types.ts","../src/generate.ts","../src/index.ts"],"mappings":""}

package/dist/index.mjs

@@ -1,4 +1,41 @@
-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}function h(e){return`import { existsSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+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,titleCase as s,toCssVar as c}from"@razorwind/core/utils";import{join as l}from"node:path";function u(e){let t=e.themes.map(e=>`- \`${e.path}\` — ${e.label}`).join(`
+`),n=e.themes.map(e=>`- **${e.label}**`).join(`
+`),r=`./dist/${e.extensionName}.vsix`,i=e.includeScripts?`
+## Package VSIX
+
+From the generated extension directory:
+
+\`\`\`bash
+pnpm package-vsix
+\`\`\`
+
+This writes \`${r}\`.
+
+## Install from VSIX
+
+1. Open the Extensions view (\`Ctrl+Shift+X\` / \`Cmd+Shift+X\`)
+2. Open the **⋯** menu → **Install from VSIX...**
+3. Select \`${r}\`
+`:`
+## Install locally
+
+Open this folder in VS Code / Cursor and press **F5** to launch an Extension Development Host, or copy \`themes/*.json\` into a local extension package.
+`;return`# Installing ${e.displayName}
+
+Generated by \`@razorwind/vsce\`.
+
+## Files
+
+- \`package.json\` — extension manifest (\`contributes.themes\`)
+- \`themes/*.json\` — color theme documents
+${t}
+${i}
+## Select theme
+
+Open the Command Palette (\`Ctrl+Shift+P\` / \`Cmd+Shift+P\`) → **Preferences: Color Theme** → choose:
+
+${n}
+`}function d(e){return`import { existsSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -62,7 +99,7 @@ export function withVsixPackageShim(action: () => void): void {
     console.log(\`\\nRestored package name: \${originalName}\`);
   }
 }
-`}function g(){return`import { execFileSync } from "node:child_process";
+`}function f(){return`import { execFileSync } from "node:child_process";
 import { mkdirSync } from "node:fs";
 import { join } from "node:path";
 import { packageRoot, withVsixPackageShim } from "./vsixPackageShim.ts";
@@ -86,7 +123,7 @@ withVsixPackageShim(() => {
     }
   );
 });
-`}function _(){return`import { execFileSync } from "node:child_process";
+`}function p(){return`import { execFileSync } from "node:child_process";
 import { packageRoot, withVsixPackageShim } from "./vsixPackageShim.ts";
 
 // Manual VS Marketplace publish. Requires VSCE_PAT in the environment.
@@ -103,7 +140,7 @@ withVsixPackageShim(() => {
     stdio: "inherit"
   });
 });
-`}function v(){return`import { execFileSync } from "node:child_process";
+`}function m(){return`import { execFileSync } from "node:child_process";
 import { packageRoot, withVsixPackageShim } from "./vsixPackageShim.ts";
 
 // Manual Open VSX publish. Requires OVSX_PAT in the environment.
@@ -120,22 +157,17 @@ withVsixPackageShim(() => {
     stdio: "inherit"
   });
 });
-`}function y(e){let t=e.themes.map(e=>`- ${e.label}`).join(`
+`}function h(e){let t=e.themes.map(e=>`- ${e.label}`).join(`
 `),n=e.repositoryUrl?`\n## Links\n\n- [GitHub](${e.repositoryUrl})\n`:``;return`# ${e.displayName}
 
 ${e.description}
 
-## Installation
-
-1. Open the Extensions view (\`Cmd+Shift+X\` / \`Ctrl+Shift+X\`)
-2. Search for **${e.displayName}**
-3. Click **Install**
-4. Open the Command Palette (\`Cmd+Shift+P\` / \`Ctrl+Shift+P\`) → **Color Theme** → select a theme
+See **INSTALL.md** for VS Code extension install steps (VSIX or Extension Development Host).
 
 ## Themes
 
 ${t||`- (generated themes)`}
-${n}`}function b(){return`node_modules/**
+${n}`}function g(){return`node_modules/**
 src/**
 scripts/**
 test/**
@@ -148,6 +180,7 @@ tests/**
 *.vsix
 artifacts/**
 README.md.bak
+INSTALL.md
 .DS_Store
-`}const x={name:`razorwind-vsce`},S={vscode:`^1.85.0`};function C(e,n,r){return t(e,n,x,r)}function w(e){return e.split(/[-_.\s]+/).filter(Boolean).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(` `)}function T(e){return e.trim().toLowerCase().replaceAll(/[^a-z0-9]+/g,`-`).replaceAll(/^-+|-+$/g,``)}function E(e){switch(e){case`light`:return`vs`;case`hc`:return`hc-black`;case`hcLight`:return`hc-light`;case`dark`:return`vs-dark`;default:return`vs-dark`}}function D(e){return i(e)&&typeof e.name==`string`&&(e.type===`light`||e.type===`dark`||e.type===`hc`||e.type===`hcLight`)}function O(e){if(Array.isArray(e))return e.map((e,t)=>{if(!D(e))throw TypeError(`@razorwind/vsce mapTheme()[${t}] must be a VsCodeTheme with name + type`);return e});if(D(e))return[e];if(!i(e))throw TypeError(`@razorwind/vsce mapTheme() must return a theme, theme array, or theme record`);return Object.entries(e).map(([e,t])=>{if(!D(t))throw TypeError(`@razorwind/vsce mapTheme()["${e}"] must be a VsCodeTheme with name + type`);return{...t,name:t.name||e}})}function k(e){if(typeof e==`string`)return e;if(e&&typeof e.url==`string`)return e.url}function A(e){if(!e.mapTheme)throw Error(`@razorwind/vsce requires options.mapTheme`);if(!e.name||e.name.includes(`/`))throw Error(`@razorwind/vsce requires options.name (unscoped Marketplace id)`);if(!e.publisher)throw Error(`@razorwind/vsce requires options.publisher`)}function j(e){return e===`light`||e===`hcLight`?`light`:`dark`}function M(e){let t={name:e.name,type:j(e.type),colors:e.colors??{}};return e.displayName&&(t.displayName=e.displayName),e.tokenColors&&(t.tokenColors=e.tokenColors),e.semanticHighlighting!==void 0&&(t.semanticHighlighting=e.semanticHighlighting),e.semanticTokenColors&&(t.semanticTokenColors=e.semanticTokenColors),`${JSON.stringify(t,null,2)}\n`}function N(e,t){let n=e.includeScripts!==!1,r=e.displayName??w(e.name),a=e.description??`${r} — VS Code themes generated by Razorwind`,o={themes:t.map(e=>({label:e.displayName??e.name,uiTheme:E(e.type),path:`./themes/${T(e.name)}.json`}))},s=n?{"package-vsix":`node --import tsx scripts/buildVsCodePackage.ts`,"publish-vsce":`node --import tsx scripts/publishVsce.ts`,"publish-ovsx":`node --import tsx scripts/publishOvsx.ts`}:void 0,c={name:e.name,displayName:r,description:a,version:e.version??`0.0.1`,publisher:e.publisher,license:e.license??`Apache-2.0`,categories:e.categories??[`Themes`],engines:e.engines??{...S},contributes:o,...e.keywords?{keywords:e.keywords}:{},...e.repository?{repository:e.repository}:{},...e.homepage?{homepage:e.homepage}:{},...e.bugs?{bugs:e.bugs}:{},...e.author?{author:e.author}:{},...e.icon?{icon:e.icon}:{},...e.galleryBanner?{galleryBanner:e.galleryBanner}:{},...s?{scripts:s}:{},...e.packageJson??{}};return c.name=e.name,c.publisher=e.publisher,c.contributes=o,s&&(c.scripts=i(c.scripts)&&!Array.isArray(c.scripts)?{...c.scripts,...s}:s),`${JSON.stringify(c,null,2)}\n`}function P(e,t){A(t);let n=t.outputPath??`vscode-extension`,r=t.includeScripts!==!1,i=t.extensionName??t.name,a=t.displayName??w(t.name),s=t.description??`${a} — VS Code themes generated by Razorwind`,c=O(t.mapTheme(e.tokens));if(c.length===0)throw Error(`@razorwind/vsce mapTheme() returned no themes`);let l={};for(let e of c){let t=`${T(e.name)}.json`,r=o(n,`themes`,t);l[r]=C(r,M(e),`json`)}let u=o(n,`package.json`);l[u]=C(u,N(t,c),`json`);let d=o(n,`.vscodeignore`);l[d]=C(d,b(),`ignore`);let f=c.map(e=>({label:e.displayName??e.name})),p=t.readme??y({displayName:a,description:s,themes:f,repositoryUrl:k(t.repository)}),m=o(n,`README.md`);if(l[m]=C(m,p,`markdown`),r){let e=o(n,`scripts`,`vsixPackageShim.ts`);l[e]=C(e,h(i),`typescript`);let r=o(n,`scripts`,`buildVsCodePackage.ts`);l[r]=C(r,g(),`typescript`);let c=o(n,`scripts`,`publishVsce.ts`);l[c]=C(c,_(),`typescript`);let u=o(n,`scripts`,`publishOvsx.ts`);l[u]=C(u,v(),`typescript`);let d=o(n,`scripts`,`README.package.md`);l[d]=C(d,y({displayName:a,description:s,themes:f,repositoryUrl:k(t.repository)}),`markdown`)}return l}var F=e(e=>({name:`vsce`,generate:async t=>{if(!e)throw Error(`@razorwind/vsce requires options: { name, publisher, mapTheme }`);return P(t,e)}}));export{F as default,m as flattenTokens,n as formatTokenValue,P as generateVsceExtension,O as normalizeThemes,N as renderPackageJson,M as renderThemeJson,p as resolveTokenSets,a as toCssVar};
+`}const _={name:`razorwind-vsce`},v={vscode:`^1.85.0`};function y(e,n,r){return t(e,n,_,r)}function b(e){switch(e){case`light`:return`vs`;case`hc`:return`hc-black`;case`hcLight`:return`hc-light`;case`dark`:return`vs-dark`;default:return`vs-dark`}}function x(e){return i(e)&&typeof e.name==`string`&&(e.type===`light`||e.type===`dark`||e.type===`hc`||e.type===`hcLight`)}function S(e){if(Array.isArray(e))return e.map((e,t)=>{if(!x(e))throw TypeError(`@razorwind/vsce mapTheme()[${t}] must be a VsCodeTheme with name + type`);return e});if(x(e))return[e];if(!i(e))throw TypeError(`@razorwind/vsce mapTheme() must return a theme, theme array, or theme record`);return Object.entries(e).map(([e,t])=>{if(!x(t))throw TypeError(`@razorwind/vsce mapTheme()["${e}"] must be a VsCodeTheme with name + type`);return{...t,name:t.name||e}})}function C(e){if(typeof e==`string`)return e;if(e&&typeof e.url==`string`)return e.url}function w(e){if(!e.mapTheme)throw Error(`@razorwind/vsce requires options.mapTheme`);if(!e.name||e.name.includes(`/`))throw Error(`@razorwind/vsce requires options.name (unscoped Marketplace id)`);if(!e.publisher)throw Error(`@razorwind/vsce requires options.publisher`)}function T(e){return e===`light`||e===`hcLight`?`light`:`dark`}function E(e){let t={name:e.name,type:T(e.type),colors:e.colors??{}};return e.displayName&&(t.displayName=e.displayName),e.tokenColors&&(t.tokenColors=e.tokenColors),e.semanticHighlighting!==void 0&&(t.semanticHighlighting=e.semanticHighlighting),e.semanticTokenColors&&(t.semanticTokenColors=e.semanticTokenColors),`${JSON.stringify(t,null,2)}\n`}function D(e,t){let n=e.includeScripts!==!1,r=e.displayName??s(e.name),a=e.description??`${r} — VS Code themes generated by Razorwind`,c={themes:t.map(e=>({label:e.displayName??e.name,uiTheme:b(e.type),path:`./themes/${o(e.name)}.json`}))},l=n?{"package-vsix":`node --import tsx scripts/buildVsCodePackage.ts`,"publish-vsce":`node --import tsx scripts/publishVsce.ts`,"publish-ovsx":`node --import tsx scripts/publishOvsx.ts`}:void 0,u={name:e.name,displayName:r,description:a,version:e.version??`0.0.1`,publisher:e.publisher,license:e.license??`Apache-2.0`,categories:e.categories??[`Themes`],engines:e.engines??{...v},contributes:c,...e.keywords?{keywords:e.keywords}:{},...e.repository?{repository:e.repository}:{},...e.homepage?{homepage:e.homepage}:{},...e.bugs?{bugs:e.bugs}:{},...e.author?{author:e.author}:{},...e.icon?{icon:e.icon}:{},...e.galleryBanner?{galleryBanner:e.galleryBanner}:{},...l?{scripts:l}:{},...e.packageJson??{}};return u.name=e.name,u.publisher=e.publisher,u.contributes=c,l&&(u.scripts=i(u.scripts)&&!Array.isArray(u.scripts)?{...u.scripts,...l}:l),`${JSON.stringify(u,null,2)}\n`}function O(e,t){w(t);let n=t.outputPath??`vscode-extension`,r=t.includeScripts!==!1,i=t.extensionName??t.name,a=t.displayName??s(t.name),c=t.description??`${a} — VS Code themes generated by Razorwind`,_=S(t.mapTheme(e.tokens));if(_.length===0)throw Error(`@razorwind/vsce mapTheme() returned no themes`);let v={};for(let e of _){let t=`${o(e.name)}.json`,r=l(n,`themes`,t);v[r]=y(r,E(e),`json`)}let b=l(n,`package.json`);v[b]=y(b,D(t,_),`json`);let x=l(n,`.vscodeignore`);v[x]=y(x,g(),`ignore`);let T=_.map(e=>({label:e.displayName??e.name,path:`./themes/${o(e.name)}.json`})),O=t.readme??h({displayName:a,description:c,themes:T,repositoryUrl:C(t.repository)}),k=l(n,`README.md`);v[k]=y(k,O,`markdown`);let A=t.installGuide??u({displayName:a,extensionName:i,themes:T,includeScripts:r}),j=l(n,`INSTALL.md`);if(v[j]=y(j,A,`markdown`),r){let e=l(n,`scripts`,`vsixPackageShim.ts`);v[e]=y(e,d(i),`typescript`);let r=l(n,`scripts`,`buildVsCodePackage.ts`);v[r]=y(r,f(),`typescript`);let o=l(n,`scripts`,`publishVsce.ts`);v[o]=y(o,p(),`typescript`);let s=l(n,`scripts`,`publishOvsx.ts`);v[s]=y(s,m(),`typescript`);let u=l(n,`scripts`,`README.package.md`);v[u]=y(u,h({displayName:a,description:c,themes:T,repositoryUrl:C(t.repository)}),`markdown`)}return v}var k=e(e=>({name:`vsce`,generate:async t=>{if(!e)throw Error(`@razorwind/vsce requires options: { name, publisher, mapTheme }`);return O(t,e)}}));export{k as default,n as flattenTokens,r as formatTokenValue,O as generateVsceExtension,S as normalizeThemes,u as renderInstallMd,D as renderPackageJson,E as renderThemeJson,a as resolveTokenSets,c as toCssVar};
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@razorwind/vsce",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "type": "module",
   "description": "Razorwind Visual Studio Code Extension plugin that creates theming extensions from design tokens.",
   "repository": {
@@ -66,15 +66,14 @@
   "types": "./dist/index.d.cts",
   "typings": "dist/index.d.mts",
   "dependencies": {
-    "@power-plant/core": "^0.0.75",
-    "@power-plant/dtcg-schema": "^0.0.1",
-    "@razorwind/core": "0.0.29"
+    "@power-plant/core": "catalog:",
+    "@power-plant/dtcg-schema": "catalog:",
+    "@razorwind/core": "workspace:*"
   },
   "devDependencies": {
-    "@powerlines/plugin-tsdown": "^0.1.589",
-    "@types/node": "^25.9.5",
+    "@powerlines/plugin-tsdown": "catalog:",
+    "@types/node": "catalog:",
     "typescript": "^6.0.3"
   },
-  "publishConfig": { "access": "public" },
-  "gitHead": "a861c6938501ed645ccdcd3970fc1164d110b4ed"
+  "publishConfig": { "access": "public" }
 }