@razorwind/vsce 0.0.2

package/dist/index.cjs

@@ -0,0 +1,152 @@
+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";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+interface PackageJson {
+  name?: unknown;
+  [key: string]: unknown;
+}
+
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+export const packageRoot = join(scriptDir, "..");
+const packageJsonPath = join(packageRoot, "package.json");
+const readmePath = join(packageRoot, "README.md");
+const vsceReadmePath = join(scriptDir, "README.package.md");
+const readmeBackupPath = join(packageRoot, "README.md.bak");
+
+/**
+ * Temporarily rewrite package.json / README for VSIX tooling.
+ *
+ * VSIX packaging reads package.json and README.md from the extension root,
+ * while an npm-scoped package may keep a different name and README.
+ */
+export function withVsixPackageShim(action: () => void): void {
+  const originalPackageJson = readFileSync(packageJsonPath, "utf8");
+  const packageJson = JSON.parse(originalPackageJson) as PackageJson;
+
+  if (typeof packageJson.name !== "string") {
+    throw new TypeError("package.json must define a string name");
+  }
+
+  const originalName = packageJson.name;
+  const extensionName = ${JSON.stringify(e)};
+  packageJson.name = extensionName;
+  delete packageJson.files;
+
+  console.log(
+    \`Temporarily renaming package: \${originalName} -> \${extensionName}\\n\`
+  );
+
+  const hadReadme = existsSync(readmePath);
+
+  try {
+    writeFileSync(packageJsonPath, \`\${JSON.stringify(packageJson, null, 2)}\\n\`);
+
+    if (hadReadme) {
+      renameSync(readmePath, readmeBackupPath);
+    }
+    if (existsSync(vsceReadmePath)) {
+      renameSync(vsceReadmePath, readmePath);
+    }
+
+    action();
+  } finally {
+    if (existsSync(readmePath) && existsSync(vsceReadmePath) === false) {
+      renameSync(readmePath, vsceReadmePath);
+    }
+    if (hadReadme && existsSync(readmeBackupPath)) {
+      renameSync(readmeBackupPath, readmePath);
+    }
+
+    writeFileSync(packageJsonPath, originalPackageJson);
+    console.log(\`\\nRestored package name: \${originalName}\`);
+  }
+}
+`}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";
+
+mkdirSync(join(packageRoot, "artifacts", "vsix"), { recursive: true });
+
+withVsixPackageShim(() => {
+  execFileSync(
+    "pnpm",
+    [
+      "exec",
+      "vsce",
+      "package",
+      "--no-dependencies",
+      "--out",
+      "artifacts/vsix"
+    ],
+    {
+      cwd: packageRoot,
+      stdio: "inherit"
+    }
+  );
+});
+`}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.
+const vscePat = process.env.VSCE_PAT;
+
+if (vscePat === undefined || vscePat.length === 0) {
+  throw new Error("VSCE_PAT must be set to publish the VS Code extension");
+}
+
+withVsixPackageShim(() => {
+  execFileSync("pnpm", ["exec", "vsce", "publish", "--no-dependencies"], {
+    cwd: packageRoot,
+    env: { ...process.env, VSCE_PAT: vscePat },
+    stdio: "inherit"
+  });
+});
+`}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.
+const ovsxPat = process.env.OVSX_PAT;
+
+if (ovsxPat === undefined || ovsxPat.length === 0) {
+  throw new Error("OVSX_PAT must be set to publish the Open VSX extension");
+}
+
+withVsixPackageShim(() => {
+  execFileSync("pnpm", ["exec", "ovsx", "publish", "--no-dependencies"], {
+    cwd: packageRoot,
+    env: { ...process.env, OVSX_PAT: ovsxPat },
+    stdio: "inherit"
+  });
+});
+`}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
+
+## Themes
+
+${t||`- (generated themes)`}
+${n}`}function g(){return`node_modules/**
+src/**
+scripts/**
+test/**
+tests/**
+.github/**
+.vscode/**
+
+.gitignore
+*.tsbuildinfo
+*.vsix
+artifacts/**
+README.md.bak
+.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}});

package/dist/index.d.cts

@@ -0,0 +1,261 @@
+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 VS Code theme mapping.
+ */
+interface FlatToken {
+  /** Dot-separated token path (e.g. `color.primary`). */
+  path: string;
+  /** DTCG `$type`, when known. */
+  type?: TokenType | string;
+  /** Raw `$value` from the token document. */
+  value: unknown;
+  /** CSS-friendly string form of {@link value}. */
+  cssValue: string;
+  /** Optional DTCG `$description`. */
+  description?: string;
+  /** Theme / set id when tokens are a `Record<string, Tokens>`. */
+  theme?: string;
+}
+/**
+ * TextMate token color rule for a VS Code theme.
+ *
+ * @see https://code.visualstudio.com/api/language-extensions/syntax-highlight-guide
+ */
+interface VsCodeTokenColor {
+  name?: string;
+  scope?: string | string[];
+  settings: {
+    foreground?: string;
+    background?: string;
+    fontStyle?: string;
+  };
+}
+/**
+ * VS Code / TextMate color theme document.
+ *
+ * @see https://code.visualstudio.com/api/extension-guides/color-theme
+ */
+interface VsCodeTheme {
+  /** Stable theme id used for the theme file name. */
+  name: string;
+  /** Marketplace / Color Theme picker label. Defaults to {@link name}. */
+  displayName?: string;
+  /** Theme kind — maps to `contributes.themes[].uiTheme`. */
+  type: "light" | "dark" | "hc" | "hcLight";
+  colors?: Record<string, string>;
+  tokenColors?: VsCodeTokenColor[];
+  semanticHighlighting?: boolean;
+  semanticTokenColors?: Record<string, string | {
+    foreground?: string;
+    fontStyle?: string;
+    bold?: boolean;
+  }>;
+}
+/**
+ * Map extracted design tokens to one or more VS Code theme documents.
+ *
+ * Return a single theme, an array, or a record keyed by theme id.
+ */
+type GenerateVsCodeTheme = (tokens: Tokens | Record<string, Tokens>) => VsCodeTheme | VsCodeTheme[] | Record<string, VsCodeTheme>;
+/**
+ * package.json `author` field shape.
+ */
+type VscePackageAuthor = string | {
+  name: string;
+  email?: string;
+  url?: string;
+};
+/**
+ * Options for the Razorwind VS Code extension (theme) generator.
+ *
+ * @see https://code.visualstudio.com/api/extension-guides/color-theme
+ * @see https://github.com/pierrecomputer/pierre/tree/main/packages/theme/scripts
+ */
+interface VscePluginOptions {
+  /**
+   * Directory (relative to the execution cwd) for the generated extension
+   * package.
+   *
+   * @defaultValue `"vscode-extension"`
+   */
+  outputPath?: string;
+  /**
+   * Map extracted tokens to VS Code theme JSON document(s).
+   *
+   * Required — without a mapping there is nothing to emit.
+   */
+  mapTheme: GenerateVsCodeTheme;
+  /**
+   * Unscoped Marketplace extension id (`contributes` / VSIX name).
+   * Must not include an npm scope.
+   */
+  name: string;
+  /** Marketplace display name. Defaults to a title-cased {@link name}. */
+  displayName?: string;
+  /** Marketplace short description. */
+  description?: string;
+  /**
+   * Extension version (semver without prerelease tags — vsce rejects them).
+   *
+   * @defaultValue `"0.0.1"`
+   */
+  version?: string;
+  /** Marketplace publisher id. */
+  publisher: string;
+  /**
+   * Unscoped name written into the VSIX shim when packaging.
+   * Defaults to {@link name}.
+   */
+  extensionName?: string;
+  /**
+   * @defaultValue `"Apache-2.0"`
+   */
+  license?: string;
+  repository?: string | {
+    type?: string;
+    url?: string;
+    directory?: string;
+  };
+  homepage?: string;
+  bugs?: string | {
+    url?: string;
+    email?: string;
+  };
+  author?: VscePackageAuthor;
+  /**
+   * Icon path relative to the extension root (e.g. `icon.png`).
+   * The file itself is not generated — place it beside the package.
+   */
+  icon?: string;
+  galleryBanner?: {
+    color?: string;
+    theme?: "dark" | "light";
+  };
+  /**
+   * @defaultValue `["Themes"]`
+   */
+  categories?: string[];
+  keywords?: string[];
+  /**
+   * @defaultValue `{ vscode: "^1.85.0" }`
+   */
+  engines?: {
+    vscode: string;
+  };
+  /**
+   * Emit pierre-style `scripts/` helpers and `package.json` script entries
+   * for packaging / publishing.
+   *
+   * @defaultValue `true`
+   *
+   * @see https://github.com/pierrecomputer/pierre/tree/main/packages/theme/scripts
+   */
+  includeScripts?: boolean;
+  /**
+   * Marketplace README body. When omitted, a minimal install guide is
+   * generated from the contributed themes.
+   */
+  readme?: string;
+  /**
+   * Restrict flattened helper tokens to these DTCG `$type` values.
+   * Does not filter what {@link mapTheme} receives.
+   */
+  includeTypes?: TokenType[];
+  /**
+   * Extra fields merged into the generated extension `package.json`
+   * (shallow merge; `contributes.themes` / `scripts` from the plugin win).
+   */
+  packageJson?: Record<string, unknown>;
+}
+//#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.
+ */
+declare function normalizeThemes(result: VsCodeTheme | VsCodeTheme[] | Record<string, VsCodeTheme>): VsCodeTheme[];
+declare function renderThemeJson(theme: VsCodeTheme): string;
+/**
+ * Build the extension `package.json` manifest (themes + optional scripts).
+ */
+declare function renderPackageJson(options: VscePluginOptions, themes: VsCodeTheme[]): string;
+/**
+ * Generate a publishable VS Code theme extension package from a Razorwind schema.
+ */
+declare function generateVsceExtension(spec: Schema, options: VscePluginOptions): GeneratorFunctionResult<Schema, VscePluginOptions>;
+//#endregion
+//#region src/index.d.ts
+/**
+ * Razorwind plugin that turns design tokens into a publishable VS Code
+ * theme extension package (theme JSON, package.json, scripts, README).
+ *
+ * Provide {@link VscePluginOptions.mapTheme} to map extracted tokens to one
+ * or more VS Code theme documents. Packaging / publish helpers follow the
+ * pierre theme script layout.
+ *
+ * @see https://code.visualstudio.com/api/extension-guides/color-theme
+ * @see https://github.com/pierrecomputer/pierre/tree/main/packages/theme/scripts
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "@razorwind/core";
+ * import vsce, { flattenTokens } from "@razorwind/vsce";
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     vsce({
+ *       name: "my-theme",
+ *       publisher: "acme",
+ *       displayName: "My Theme",
+ *       mapTheme: tokens => {
+ *         const flat = flattenTokens(tokens);
+ *         const color = (path: string) =>
+ *           flat.find(t => t.path === path)?.cssValue ?? "#000000";
+ *
+ *         return [
+ *           {
+ *             name: "my-theme-dark",
+ *             displayName: "My Theme Dark",
+ *             type: "dark",
+ *             colors: {
+ *               "editor.background": color("color.bg"),
+ *               "editor.foreground": color("color.fg")
+ *             }
+ *           },
+ *           {
+ *             name: "my-theme-light",
+ *             displayName: "My Theme Light",
+ *             type: "light",
+ *             colors: {
+ *               "editor.background": color("color.bg"),
+ *               "editor.foreground": color("color.fg")
+ *             }
+ *           }
+ *         ];
+ *       }
+ *     })
+ *   ]
+ * });
+ * ```
+ */
+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 };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +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"}

package/dist/index.d.mts

@@ -0,0 +1,261 @@
+import { formatTokenValue, toCssVar } from "@razorwind/core/utils";
+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 VS Code theme mapping.
+ */
+interface FlatToken {
+  /** Dot-separated token path (e.g. `color.primary`). */
+  path: string;
+  /** DTCG `$type`, when known. */
+  type?: TokenType | string;
+  /** Raw `$value` from the token document. */
+  value: unknown;
+  /** CSS-friendly string form of {@link value}. */
+  cssValue: string;
+  /** Optional DTCG `$description`. */
+  description?: string;
+  /** Theme / set id when tokens are a `Record<string, Tokens>`. */
+  theme?: string;
+}
+/**
+ * TextMate token color rule for a VS Code theme.
+ *
+ * @see https://code.visualstudio.com/api/language-extensions/syntax-highlight-guide
+ */
+interface VsCodeTokenColor {
+  name?: string;
+  scope?: string | string[];
+  settings: {
+    foreground?: string;
+    background?: string;
+    fontStyle?: string;
+  };
+}
+/**
+ * VS Code / TextMate color theme document.
+ *
+ * @see https://code.visualstudio.com/api/extension-guides/color-theme
+ */
+interface VsCodeTheme {
+  /** Stable theme id used for the theme file name. */
+  name: string;
+  /** Marketplace / Color Theme picker label. Defaults to {@link name}. */
+  displayName?: string;
+  /** Theme kind — maps to `contributes.themes[].uiTheme`. */
+  type: "light" | "dark" | "hc" | "hcLight";
+  colors?: Record<string, string>;
+  tokenColors?: VsCodeTokenColor[];
+  semanticHighlighting?: boolean;
+  semanticTokenColors?: Record<string, string | {
+    foreground?: string;
+    fontStyle?: string;
+    bold?: boolean;
+  }>;
+}
+/**
+ * Map extracted design tokens to one or more VS Code theme documents.
+ *
+ * Return a single theme, an array, or a record keyed by theme id.
+ */
+type GenerateVsCodeTheme = (tokens: Tokens | Record<string, Tokens>) => VsCodeTheme | VsCodeTheme[] | Record<string, VsCodeTheme>;
+/**
+ * package.json `author` field shape.
+ */
+type VscePackageAuthor = string | {
+  name: string;
+  email?: string;
+  url?: string;
+};
+/**
+ * Options for the Razorwind VS Code extension (theme) generator.
+ *
+ * @see https://code.visualstudio.com/api/extension-guides/color-theme
+ * @see https://github.com/pierrecomputer/pierre/tree/main/packages/theme/scripts
+ */
+interface VscePluginOptions {
+  /**
+   * Directory (relative to the execution cwd) for the generated extension
+   * package.
+   *
+   * @defaultValue `"vscode-extension"`
+   */
+  outputPath?: string;
+  /**
+   * Map extracted tokens to VS Code theme JSON document(s).
+   *
+   * Required — without a mapping there is nothing to emit.
+   */
+  mapTheme: GenerateVsCodeTheme;
+  /**
+   * Unscoped Marketplace extension id (`contributes` / VSIX name).
+   * Must not include an npm scope.
+   */
+  name: string;
+  /** Marketplace display name. Defaults to a title-cased {@link name}. */
+  displayName?: string;
+  /** Marketplace short description. */
+  description?: string;
+  /**
+   * Extension version (semver without prerelease tags — vsce rejects them).
+   *
+   * @defaultValue `"0.0.1"`
+   */
+  version?: string;
+  /** Marketplace publisher id. */
+  publisher: string;
+  /**
+   * Unscoped name written into the VSIX shim when packaging.
+   * Defaults to {@link name}.
+   */
+  extensionName?: string;
+  /**
+   * @defaultValue `"Apache-2.0"`
+   */
+  license?: string;
+  repository?: string | {
+    type?: string;
+    url?: string;
+    directory?: string;
+  };
+  homepage?: string;
+  bugs?: string | {
+    url?: string;
+    email?: string;
+  };
+  author?: VscePackageAuthor;
+  /**
+   * Icon path relative to the extension root (e.g. `icon.png`).
+   * The file itself is not generated — place it beside the package.
+   */
+  icon?: string;
+  galleryBanner?: {
+    color?: string;
+    theme?: "dark" | "light";
+  };
+  /**
+   * @defaultValue `["Themes"]`
+   */
+  categories?: string[];
+  keywords?: string[];
+  /**
+   * @defaultValue `{ vscode: "^1.85.0" }`
+   */
+  engines?: {
+    vscode: string;
+  };
+  /**
+   * Emit pierre-style `scripts/` helpers and `package.json` script entries
+   * for packaging / publishing.
+   *
+   * @defaultValue `true`
+   *
+   * @see https://github.com/pierrecomputer/pierre/tree/main/packages/theme/scripts
+   */
+  includeScripts?: boolean;
+  /**
+   * Marketplace README body. When omitted, a minimal install guide is
+   * generated from the contributed themes.
+   */
+  readme?: string;
+  /**
+   * Restrict flattened helper tokens to these DTCG `$type` values.
+   * Does not filter what {@link mapTheme} receives.
+   */
+  includeTypes?: TokenType[];
+  /**
+   * Extra fields merged into the generated extension `package.json`
+   * (shallow merge; `contributes.themes` / `scripts` from the plugin win).
+   */
+  packageJson?: Record<string, unknown>;
+}
+//#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.
+ */
+declare function normalizeThemes(result: VsCodeTheme | VsCodeTheme[] | Record<string, VsCodeTheme>): VsCodeTheme[];
+declare function renderThemeJson(theme: VsCodeTheme): string;
+/**
+ * Build the extension `package.json` manifest (themes + optional scripts).
+ */
+declare function renderPackageJson(options: VscePluginOptions, themes: VsCodeTheme[]): string;
+/**
+ * Generate a publishable VS Code theme extension package from a Razorwind schema.
+ */
+declare function generateVsceExtension(spec: Schema, options: VscePluginOptions): GeneratorFunctionResult<Schema, VscePluginOptions>;
+//#endregion
+//#region src/index.d.ts
+/**
+ * Razorwind plugin that turns design tokens into a publishable VS Code
+ * theme extension package (theme JSON, package.json, scripts, README).
+ *
+ * Provide {@link VscePluginOptions.mapTheme} to map extracted tokens to one
+ * or more VS Code theme documents. Packaging / publish helpers follow the
+ * pierre theme script layout.
+ *
+ * @see https://code.visualstudio.com/api/extension-guides/color-theme
+ * @see https://github.com/pierrecomputer/pierre/tree/main/packages/theme/scripts
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "@razorwind/core";
+ * import vsce, { flattenTokens } from "@razorwind/vsce";
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     vsce({
+ *       name: "my-theme",
+ *       publisher: "acme",
+ *       displayName: "My Theme",
+ *       mapTheme: tokens => {
+ *         const flat = flattenTokens(tokens);
+ *         const color = (path: string) =>
+ *           flat.find(t => t.path === path)?.cssValue ?? "#000000";
+ *
+ *         return [
+ *           {
+ *             name: "my-theme-dark",
+ *             displayName: "My Theme Dark",
+ *             type: "dark",
+ *             colors: {
+ *               "editor.background": color("color.bg"),
+ *               "editor.foreground": color("color.fg")
+ *             }
+ *           },
+ *           {
+ *             name: "my-theme-light",
+ *             displayName: "My Theme Light",
+ *             type: "light",
+ *             colors: {
+ *               "editor.background": color("color.bg"),
+ *               "editor.foreground": color("color.fg")
+ *             }
+ *           }
+ *         ];
+ *       }
+ *     })
+ *   ]
+ * });
+ * ```
+ */
+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 };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

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