@razorwind/design-md 0.0.4 → 0.0.5

package/dist/extract.cjs

@@ -0,0 +1 @@
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("./rolldown-runtime-BIInC43l.cjs");let t=require("@power-plant/core"),n=require("@razorwind/core/plugin"),r=require("@stryke/fs/read-file"),i=require("@stryke/type-checks/is-empty-object"),a=require("@razorwind/core/tokens"),o=require("@stryke/fs/exists"),s=require("@stryke/path/join"),c=require("yaml");var l=e.t({DESIGN_MD_FILE_PATTERN:()=>u,DESIGN_MD_PATH_CANDIDATES:()=>d,default:()=>A,designMdToTokens:()=>T,extractDesignMdFrontMatter:()=>w,isDesignMdFile:()=>D,loadDesignMdTokens:()=>k,parseDesignMdTokens:()=>E,resolveDesignMdPath:()=>O});const u=/(?:^|[/\\])design\.md$/i,d=[`DESIGN.md`,`design.md`,`docs/DESIGN.md`],f=/^\uFEFF?---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/,p=/^\{[^{}]+\}$/,m=new Set([`version`,`name`,`description`]),h=[`fontFamily`,`fontSize`,`fontWeight`,`lineHeight`,`letterSpacing`,`fontFeature`,`fontVariation`],g={backgroundColor:`color`,textColor:`color`,typography:`typography`,rounded:`dimension`,padding:`dimension`,size:`dimension`,height:`dimension`,width:`dimension`};function _(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function v(e){return typeof e==`string`&&p.test(e.trim())}function y(e){return typeof e==`number`?`${e}px`:e}function b(e){let t={};for(let n of h){let r=e[n];r!=null&&(t[n]=r)}for(let[n,r]of Object.entries(e))!(n in t)&&r!=null&&(typeof r==`string`||typeof r==`number`)&&(t[n]=r);return t}function x(e,t,n=!1){let r={};for(let[i,a]of Object.entries(e))a!=null&&(r[i]={$type:t,$value:v(a)?a.trim():n?y(a):a});return r}function S(e){let t={};for(let[n,r]of Object.entries(e))v(r)?t[n]={$type:`typography`,$value:r.trim()}:_(r)&&(t[n]={$type:`typography`,$value:b(r)});return t}function C(e){let t={};for(let[n,r]of Object.entries(e)){if(!_(r))continue;let e={};for(let[t,n]of Object.entries(r)){if(n==null)continue;let r=g[t];e[t]={...r?{$type:r}:{},$value:v(n)?n.trim():r===`typography`&&_(n)?b(n):y(n)}}Object.keys(e).length>0&&(t[n]=e)}return t}function w(e){let t=f.exec(e);if(!t?.[1])return;let n;try{n=(0,c.parse)(t[1])}catch(e){let t=e instanceof Error?e.message:String(e);throw Error(`Failed to parse DESIGN.md front matter as YAML: ${t}`)}return _(n)?n:void 0}function T(e){let t={};for(let[n,r]of Object.entries(e))if(!(m.has(n)||!_(r)))switch(n){case`colors`:t[n]=x(r,`color`);break;case`typography`:t[n]=S(r);break;case`rounded`:case`spacing`:t[n]=x(r,`dimension`,!0);break;case`components`:t[n]=C(r);break;default:t[n]=r;break}return(0,a.normalizeTokenTree)(t)}function E(e){let t=w(e);return t?T(t):{}}function D(e){return u.test(e)}function O(e){for(let t of d){let n=(0,s.joinPaths)(e,t);if((0,o.existsSync)(n))return n}}async function k(e){let t=O(e);if(t)return E(await(0,r.readFile)(t))}var A=(0,n.definePlugin)((e={})=>({name:`design-md:extract`,parsers:[{name:`design-md`,pattern:u,parser:e=>E(e)}],extract:async n=>{if(n.tokens&&!(0,i.isEmptyObject)(n.tokens))return n;let a=e.path;if(!a){let{cwd:e}=(0,t.useExecution)();if(a=O(e),!a)return n}let o=E(await(0,r.readFile)(a));return!o||(0,i.isEmptyObject)(o)?n:{...n,tokens:o}}}));exports.DESIGN_MD_FILE_PATTERN=u,exports.DESIGN_MD_PATH_CANDIDATES=d,exports.default=A,exports.designMdToTokens=T,exports.extractDesignMdFrontMatter=w,exports.isDesignMdFile=D,exports.loadDesignMdTokens=k,exports.parseDesignMdTokens=E,exports.resolveDesignMdPath=O,Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return l}});

package/dist/extract.d.cts

@@ -0,0 +1,81 @@
+import { DesignTokens } from "style-dictionary/types";
+declare namespace extract_d_exports {
+  export { DESIGN_MD_FILE_PATTERN, DESIGN_MD_PATH_CANDIDATES, _default as default, designMdToTokens, extractDesignMdFrontMatter, isDesignMdFile, loadDesignMdTokens, parseDesignMdTokens, resolveDesignMdPath };
+}
+/**
+ * Basename pattern for DESIGN.md spec files
+ * (https://github.com/google-labs-code/design.md).
+ */
+declare const DESIGN_MD_FILE_PATTERN: RegExp;
+/** Candidate workspace paths checked for a DESIGN.md spec file. */
+declare const DESIGN_MD_PATH_CANDIDATES: readonly ["DESIGN.md", "design.md", "docs/DESIGN.md"];
+/**
+ * Extract the YAML front matter object from DESIGN.md contents.
+ *
+ * @param contents - The raw DESIGN.md file contents.
+ * @returns The parsed front matter, or `undefined` when no front matter fence
+ * is present.
+ */
+declare function extractDesignMdFrontMatter(contents: string): Record<string, unknown> | undefined;
+/**
+ * Convert DESIGN.md front-matter tokens (colors, typography, rounded,
+ * spacing, components) into a DTCG design-token tree.
+ *
+ * DESIGN.md `{path.to.token}` references are preserved verbatim — the group
+ * names in the emitted tree match the front-matter section names, so the
+ * references resolve as DTCG aliases without rewriting.
+ *
+ * @see https://github.com/google-labs-code/design.md#the-specification
+ *
+ * @param frontMatter - The parsed DESIGN.md YAML front matter.
+ * @returns The equivalent DTCG token tree.
+ */
+declare function designMdToTokens(frontMatter: Record<string, unknown>): DesignTokens;
+/**
+ * Parse DESIGN.md file contents into a DTCG token tree.
+ *
+ * @param contents - The raw DESIGN.md file contents.
+ * @returns The extracted tokens; an empty object when the file has no YAML
+ * front matter.
+ */
+declare function parseDesignMdTokens(contents: string): DesignTokens;
+/**
+ * Check whether a path points at a DESIGN.md spec file.
+ *
+ * @param filePath - The file path to test.
+ * @returns True when the basename is `DESIGN.md` (case-insensitive).
+ */
+declare function isDesignMdFile(filePath: string): boolean;
+/**
+ * Resolve the DESIGN.md file for a workspace, if one exists.
+ *
+ * @param cwd - The workspace root to search from.
+ * @returns The absolute path to the first matching candidate, or `undefined`.
+ */
+declare function resolveDesignMdPath(cwd: string): string | undefined;
+/**
+ * Load DTCG tokens from the DESIGN.md file in a workspace, if present.
+ *
+ * @param cwd - The workspace root to search from.
+ * @returns Parsed tokens, or `undefined` when no DESIGN.md exists.
+ */
+declare function loadDesignMdTokens(cwd: string): Promise<DesignTokens | undefined>;
+/**
+ * Extract design-system specification from DESIGN.md
+ *
+ * @see https://github.com/google-labs-code/design.md
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "@razorwind/core";
+ * import designMd from "@razorwind/design-md/extract";
+ *
+ * export default defineConfig({
+ *   plugins: [designMd()]
+ * });
+ * ```
+ */
+declare const _default: any;
+//#endregion
+export { DESIGN_MD_FILE_PATTERN, DESIGN_MD_PATH_CANDIDATES, _default as default, designMdToTokens, extractDesignMdFrontMatter, isDesignMdFile, loadDesignMdTokens, parseDesignMdTokens, resolveDesignMdPath, extract_d_exports as t };
+//# sourceMappingURL=extract.d.cts.map

package/dist/extract.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.cts","names":[],"sources":["../src/extract.ts"],"mappings":";;;;;;;;cAkCa,wBAAsB;;cAGtB;;;;;;;;iBAiLG,2BACd,mBACC;;;;;;;;;;;;;;iBAgCa,iBACd,aAAa,0BACZ;;;;;;;;iBAwCa,oBAAoB,mBAAmB;;;;;;;iBAevC,eAAe;;;;;;;iBAUf,oBAAoB;;;;;;;iBAiBd,mBACpB,cACC,QAAQ"}

package/dist/extract.d.mts

@@ -0,0 +1,81 @@
+import { DesignTokens } from "style-dictionary/types";
+declare namespace extract_d_exports {
+  export { DESIGN_MD_FILE_PATTERN, DESIGN_MD_PATH_CANDIDATES, _default as default, designMdToTokens, extractDesignMdFrontMatter, isDesignMdFile, loadDesignMdTokens, parseDesignMdTokens, resolveDesignMdPath };
+}
+/**
+ * Basename pattern for DESIGN.md spec files
+ * (https://github.com/google-labs-code/design.md).
+ */
+declare const DESIGN_MD_FILE_PATTERN: RegExp;
+/** Candidate workspace paths checked for a DESIGN.md spec file. */
+declare const DESIGN_MD_PATH_CANDIDATES: readonly ["DESIGN.md", "design.md", "docs/DESIGN.md"];
+/**
+ * Extract the YAML front matter object from DESIGN.md contents.
+ *
+ * @param contents - The raw DESIGN.md file contents.
+ * @returns The parsed front matter, or `undefined` when no front matter fence
+ * is present.
+ */
+declare function extractDesignMdFrontMatter(contents: string): Record<string, unknown> | undefined;
+/**
+ * Convert DESIGN.md front-matter tokens (colors, typography, rounded,
+ * spacing, components) into a DTCG design-token tree.
+ *
+ * DESIGN.md `{path.to.token}` references are preserved verbatim — the group
+ * names in the emitted tree match the front-matter section names, so the
+ * references resolve as DTCG aliases without rewriting.
+ *
+ * @see https://github.com/google-labs-code/design.md#the-specification
+ *
+ * @param frontMatter - The parsed DESIGN.md YAML front matter.
+ * @returns The equivalent DTCG token tree.
+ */
+declare function designMdToTokens(frontMatter: Record<string, unknown>): DesignTokens;
+/**
+ * Parse DESIGN.md file contents into a DTCG token tree.
+ *
+ * @param contents - The raw DESIGN.md file contents.
+ * @returns The extracted tokens; an empty object when the file has no YAML
+ * front matter.
+ */
+declare function parseDesignMdTokens(contents: string): DesignTokens;
+/**
+ * Check whether a path points at a DESIGN.md spec file.
+ *
+ * @param filePath - The file path to test.
+ * @returns True when the basename is `DESIGN.md` (case-insensitive).
+ */
+declare function isDesignMdFile(filePath: string): boolean;
+/**
+ * Resolve the DESIGN.md file for a workspace, if one exists.
+ *
+ * @param cwd - The workspace root to search from.
+ * @returns The absolute path to the first matching candidate, or `undefined`.
+ */
+declare function resolveDesignMdPath(cwd: string): string | undefined;
+/**
+ * Load DTCG tokens from the DESIGN.md file in a workspace, if present.
+ *
+ * @param cwd - The workspace root to search from.
+ * @returns Parsed tokens, or `undefined` when no DESIGN.md exists.
+ */
+declare function loadDesignMdTokens(cwd: string): Promise<DesignTokens | undefined>;
+/**
+ * Extract design-system specification from DESIGN.md
+ *
+ * @see https://github.com/google-labs-code/design.md
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "@razorwind/core";
+ * import designMd from "@razorwind/design-md/extract";
+ *
+ * export default defineConfig({
+ *   plugins: [designMd()]
+ * });
+ * ```
+ */
+declare const _default: any;
+//#endregion
+export { DESIGN_MD_FILE_PATTERN, DESIGN_MD_PATH_CANDIDATES, _default as default, designMdToTokens, extractDesignMdFrontMatter, isDesignMdFile, loadDesignMdTokens, parseDesignMdTokens, resolveDesignMdPath, extract_d_exports as t };
+//# sourceMappingURL=extract.d.mts.map

package/dist/extract.d.mts.map

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

package/dist/extract.mjs

@@ -0,0 +1,2 @@
+import{t as e}from"./rolldown-runtime-DK3Fl9T5.mjs";import{useExecution as t}from"@power-plant/core";import{definePlugin as n}from"@razorwind/core/plugin";import{readFile as r}from"@stryke/fs/read-file";import{isEmptyObject as i}from"@stryke/type-checks/is-empty-object";import{normalizeTokenTree as a}from"@razorwind/core/tokens";import{existsSync as o}from"@stryke/fs/exists";import{joinPaths as s}from"@stryke/path/join";import{parse as c}from"yaml";var l=e({DESIGN_MD_FILE_PATTERN:()=>u,DESIGN_MD_PATH_CANDIDATES:()=>d,default:()=>A,designMdToTokens:()=>T,extractDesignMdFrontMatter:()=>w,isDesignMdFile:()=>D,loadDesignMdTokens:()=>k,parseDesignMdTokens:()=>E,resolveDesignMdPath:()=>O});const u=/(?:^|[/\\])design\.md$/i,d=[`DESIGN.md`,`design.md`,`docs/DESIGN.md`],f=/^\uFEFF?---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/,p=/^\{[^{}]+\}$/,m=new Set([`version`,`name`,`description`]),h=[`fontFamily`,`fontSize`,`fontWeight`,`lineHeight`,`letterSpacing`,`fontFeature`,`fontVariation`],g={backgroundColor:`color`,textColor:`color`,typography:`typography`,rounded:`dimension`,padding:`dimension`,size:`dimension`,height:`dimension`,width:`dimension`};function _(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function v(e){return typeof e==`string`&&p.test(e.trim())}function y(e){return typeof e==`number`?`${e}px`:e}function b(e){let t={};for(let n of h){let r=e[n];r!=null&&(t[n]=r)}for(let[n,r]of Object.entries(e))!(n in t)&&r!=null&&(typeof r==`string`||typeof r==`number`)&&(t[n]=r);return t}function x(e,t,n=!1){let r={};for(let[i,a]of Object.entries(e))a!=null&&(r[i]={$type:t,$value:v(a)?a.trim():n?y(a):a});return r}function S(e){let t={};for(let[n,r]of Object.entries(e))v(r)?t[n]={$type:`typography`,$value:r.trim()}:_(r)&&(t[n]={$type:`typography`,$value:b(r)});return t}function C(e){let t={};for(let[n,r]of Object.entries(e)){if(!_(r))continue;let e={};for(let[t,n]of Object.entries(r)){if(n==null)continue;let r=g[t];e[t]={...r?{$type:r}:{},$value:v(n)?n.trim():r===`typography`&&_(n)?b(n):y(n)}}Object.keys(e).length>0&&(t[n]=e)}return t}function w(e){let t=f.exec(e);if(!t?.[1])return;let n;try{n=c(t[1])}catch(e){let t=e instanceof Error?e.message:String(e);throw Error(`Failed to parse DESIGN.md front matter as YAML: ${t}`)}return _(n)?n:void 0}function T(e){let t={};for(let[n,r]of Object.entries(e))if(!(m.has(n)||!_(r)))switch(n){case`colors`:t[n]=x(r,`color`);break;case`typography`:t[n]=S(r);break;case`rounded`:case`spacing`:t[n]=x(r,`dimension`,!0);break;case`components`:t[n]=C(r);break;default:t[n]=r;break}return a(t)}function E(e){let t=w(e);return t?T(t):{}}function D(e){return u.test(e)}function O(e){for(let t of d){let n=s(e,t);if(o(n))return n}}async function k(e){let t=O(e);if(t)return E(await r(t))}var A=n((e={})=>({name:`design-md:extract`,parsers:[{name:`design-md`,pattern:u,parser:e=>E(e)}],extract:async n=>{if(n.tokens&&!i(n.tokens))return n;let a=e.path;if(!a){let{cwd:e}=t();if(a=O(e),!a)return n}let o=E(await r(a));return!o||i(o)?n:{...n,tokens:o}}}));export{u as DESIGN_MD_FILE_PATTERN,d as DESIGN_MD_PATH_CANDIDATES,A as default,T as designMdToTokens,w as extractDesignMdFrontMatter,D as isDesignMdFile,k as loadDesignMdTokens,E as parseDesignMdTokens,O as resolveDesignMdPath,l as t};
+//# sourceMappingURL=extract.mjs.map

package/dist/extract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.mjs","names":[],"sources":[],"mappings":""}

package/dist/generate-BIFtSW2h.cjs

@@ -0,0 +1,9 @@
+const e=require("./rolldown-runtime-BIInC43l.cjs");let t=require("@razorwind/core/plugin"),n=require("@razorwind/core/utils");function r(e,t){let n=e.split(`.`).filter(Boolean);for(;n.length>1&&t.includes(n[0].toLowerCase());)n.shift();return n.join(`-`).replaceAll(/[^\w-]+/g,`-`).toLowerCase()}function i(e){if(typeof e==`number`||typeof e==`boolean`)return String(e);let t=String(e);return/^[a-z][\w-]*$/i.test(t)?t:JSON.stringify(t)}function a(e){return e.split(/[-_.]+/).filter(Boolean).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(` `)}const o=/^(?:light|dark|dim|high-contrast|hc|default|base|theme)(?:[._-].+)?$/i;function s(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}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,r,i,a){if(!s(e))return;let o=u(e,r);if(c(e)){let r=d(e);a.push({path:t.join(`.`),type:o,value:r,cssValue:(0,n.formatTokenValue)(r,o),description:l(e),theme:i});return}for(let[n,r]of Object.entries(e))n.startsWith(`$`)||f(r,[...t,n],o,i,a)}function p(e){if(!s(e))return[];let t=Object.keys(e).filter(e=>!e.startsWith(`$`));return t.length>0&&t.every(e=>o.test(e))?t.map(t=>({id:t,tokens:e[t]})):[{id:`default`,tokens:e}]}function m(e,t){let n=t?new Set(t):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}var h=e.t({default:()=>B,selectPrimaryTheme:()=>E});const g=new Set([`backgroundColor`,`textColor`,`typography`,`rounded`,`padding`,`size`,`height`,`width`]),_={background:`backgroundColor`,backgroundcolor:`backgroundColor`,bg:`backgroundColor`,fill:`backgroundColor`,color:`textColor`,foreground:`textColor`,text:`textColor`,textcolor:`textColor`,font:`typography`,radius:`rounded`,borderradius:`rounded`,corner:`rounded`},v=[`color`,`colors`,`palette`],y=[`typography`,`type`,`text`,`font`,`fonts`],b=/(?:^|\.)(?:radius|radii|rounded|corner)(?:\.|$)/i,x=/(?:^|\.)(?:spacing|space|gap)(?:\.|$)/i,S=/^components?$/i,C=/^\{([^}]+)\}$/,w=[`fontFamily`,`fontSize`,`fontWeight`,`lineHeight`,`letterSpacing`];function T(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function E(e){let t=[...new Set(e.map(e=>e.theme))],n=t.find(e=>e===void 0)??t.find(e=>/^light/i.test(e??``))??t.find(e=>/^(?:default|base)/i.test(e??``))??t[0];return e.filter(e=>e.theme===n)}function D(e){if(typeof e==`string`)return C.exec(e.trim())?.[1]}function O(e,t){let n=e;for(let e=0;e<8;e++){let e=D(n.value);if(!e)return n;let r=t.get(e);if(!r)return n;n=r}return n}function k(e){return e.split(/[-_.\s]+/).filter(Boolean).map((e,t)=>t===0?e.toLowerCase():e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join(``)}function A(e){let t=k(e);return g.has(t)?t:_[t.toLowerCase()]}function j(e,t){let r={};if(!T(e))return r;for(let i of w){let a=e[i];if(a==null)continue;let o=D(a),s=o?t.get(o):void 0,c=s?O(s,t).cssValue:void 0;if(typeof a==`number`){r[i]=a;continue}r[i]=c??(0,n.formatTokenValue)(a)}return r}function M(e){let t=E(m(e.tokens)),n=new Map(t.map(e=>[e.path,e])),i={colors:{},colorDescriptions:{},typography:{},rounded:{},spacing:{},components:{}},a=new Map,o=[];for(let e of t){let t=e.path.split(`.`);if(t[0]&&S.test(t[0])){o.push(e);continue}if(e.type===`color`){let t=r(e.path,v),o=O(e,n);i.colors[t]=o.cssValue,e.description&&(i.colorDescriptions[t]=e.description),a.set(e.path,`colors.${t}`);continue}if(e.type===`typography`){let t=r(e.path,y);i.typography[t]=j(e.value,n),a.set(e.path,`typography.${t}`);continue}if(e.type===`fontFamily`){let t=r(e.path,y);i.typography[t]??={},i.typography[t].fontFamily=e.cssValue,a.set(e.path,`typography.${t}`);continue}let s=e.type===`dimension`||e.type===`number`||typeof e.value==`number`;if(s&&b.test(e.path)){let r=t.at(-1);i.rounded[r]=O(e,n).cssValue,a.set(e.path,`rounded.${r}`);continue}if(s&&x.test(e.path)){let r=t.at(-1);i.spacing[r]=O(e,n).cssValue,a.set(e.path,`spacing.${r}`)}}for(let e of o){let t=e.path.split(`.`).slice(1);if(t.length<2)continue;let r=A(t.at(-1));if(!r)continue;let o=t.slice(0,-1).join(`-`).replaceAll(/[^\w-]+/g,`-`).toLowerCase(),s=D(e.value),c=s?a.get(s):void 0,l=c?`{${c}}`:O(e,n).cssValue;i.components[o]??={},i.components[o][r]=l}return i}function N(e,t,n){let r=Object.entries(t);if(r.length!==0){n.push(`${e}:`);for(let[e,t]of r){if(typeof t==`object`&&t){n.push(`  ${e}:`);for(let[e,r]of Object.entries(t))n.push(`    ${e}: ${i(r)}`);continue}n.push(`  ${e}: ${i(t)}`)}}}function P(e){let t=[`---`];return e.version&&t.push(`version: ${i(e.version)}`),t.push(`name: ${i(e.name)}`),e.description&&t.push(`description: ${i(e.description)}`),N(`colors`,e.colors,t),N(`typography`,e.typography,t),N(`rounded`,e.rounded,t),N(`spacing`,e.spacing,t),N(`components`,e.components,t),t.push(`---`),`${t.join(`
+`)}\n`}function F(e,...t){return`## ${e}\n\n${t.filter(Boolean).join(`
+`)}\n`}function I(e){let t=[[Object.keys(e.colors).length,`color`],[Object.keys(e.typography).length,`typography`],[Object.keys(e.rounded).length,`shape`],[Object.keys(e.spacing).length,`spacing`],[Object.keys(e.components).length,`component`]].filter(([e])=>e>0).map(([e,t])=>`${e} ${t} token${e===1?``:`s`}`).join(`, `);return`${e.name} design tokens${t?` — ${t}`:``}. The YAML front matter above is the normative source; the prose below explains how to apply it.`}function L(e,t={}){let n=[F(`Overview`,t.overview??I(e))],r=Object.entries(e.colors);r.length>0&&n.push(F(`Colors`,r.map(([t,n])=>{let r=e.colorDescriptions[t];return`- **${a(t)} (${n}):**${r?` ${r}`:``}`}).join(`
+`)));let i=Object.entries(e.typography);i.length>0&&n.push(F(`Typography`,i.map(([e,t])=>`- **${e}:** ${Object.entries(t).map(([e,t])=>`${e}: ${t}`).join(`, `)}`).join(`
+`)));let o=Object.entries(e.spacing);o.length>0&&n.push(F(`Layout`,`Spacing scale:`,``,o.map(([e,t])=>`- **${e}:** ${t}`).join(`
+`)));let s=Object.entries(e.rounded);s.length>0&&n.push(F(`Shapes`,`Corner radius scale:`,``,s.map(([e,t])=>`- **${e}:** ${t}`).join(`
+`)));let c=Object.entries(e.components);return c.length>0&&n.push(F(`Components`,c.map(([e,t])=>`- **${e}:** ${Object.entries(t).map(([e,t])=>`${e}: \`${t}\``).join(`, `)}`).join(`
+`))),n.join(`
+`)}function R(e,t={}){return`${P(e)}\n${L(e,t)}`}function z(e,t={}){let n=M(e);return{[t.outputPath??`DESIGN.md`]:{path:t.outputPath??`DESIGN.md`,language:`markdown`,chunks:[{content:R(n,t),meta:{name:`razorwind-design-md`}}]}}}var B=(0,t.definePlugin)((e={})=>({name:`design-md:generate`,generate:async t=>z(t,e)}));Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return B}});

package/dist/generate-BvP-cKvD.d.cts

@@ -0,0 +1,47 @@
+import { TokenType } from "@power-plant/dtcg-schema";
+//#region src/types.d.ts
+/**
+ * A flattened design token ready for DESIGN.md extraction.
+ */
+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;
+}
+declare namespace generate_d_exports {
+  export { _default as default, selectPrimaryTheme };
+}
+/**
+ * Select the token set used for the front matter when tokens are split into
+ * multiple themes: the un-themed set first, then `light`, then `default`,
+ * then whichever theme appears first.
+ */
+declare function selectPrimaryTheme(flat: FlatToken[]): FlatToken[];
+/**
+ * Generate a DESIGN.md design-system specification file from a Razorwind schema.
+ *
+ * @see https://github.com/google-labs-code/design.md
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "@razorwind/core";
+ * import designMd from "@razorwind/design-md/generate";
+ *
+ * export default defineConfig({
+ *   plugins: [designMd()]
+ * });
+ * ```
+ */
+declare const _default: any;
+//#endregion
+export { generate_d_exports as n, selectPrimaryTheme as r, _default as t };
+//# sourceMappingURL=generate-BvP-cKvD.d.cts.map

package/dist/generate-BvP-cKvD.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-BvP-cKvD.d.cts","names":[],"sources":["../src/types.ts","../src/generate.ts"],"mappings":";;;;;UAkEiB;;EAEf;;EAEA,OAAO;;EAEP;;EAEA;;EAEA;;EAEA;;;;;;;;;;iBCSc,mBAAmB,MAAM,cAAc"}

package/dist/generate-BvP-cKvD.d.mts

@@ -0,0 +1,47 @@
+import { TokenType } from "@power-plant/dtcg-schema";
+//#region src/types.d.ts
+/**
+ * A flattened design token ready for DESIGN.md extraction.
+ */
+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;
+}
+declare namespace generate_d_exports {
+  export { _default as default, selectPrimaryTheme };
+}
+/**
+ * Select the token set used for the front matter when tokens are split into
+ * multiple themes: the un-themed set first, then `light`, then `default`,
+ * then whichever theme appears first.
+ */
+declare function selectPrimaryTheme(flat: FlatToken[]): FlatToken[];
+/**
+ * Generate a DESIGN.md design-system specification file from a Razorwind schema.
+ *
+ * @see https://github.com/google-labs-code/design.md
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "@razorwind/core";
+ * import designMd from "@razorwind/design-md/generate";
+ *
+ * export default defineConfig({
+ *   plugins: [designMd()]
+ * });
+ * ```
+ */
+declare const _default: any;
+//#endregion
+export { generate_d_exports as n, selectPrimaryTheme as r, _default as t };
+//# sourceMappingURL=generate-BvP-cKvD.d.mts.map

package/dist/generate-BvP-cKvD.d.mts.map

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

package/dist/generate-C7bCox0_.mjs

@@ -0,0 +1,10 @@
+import{t as e}from"./rolldown-runtime-DK3Fl9T5.mjs";import{definePlugin as t}from"@razorwind/core/plugin";import{formatTokenValue as n}from"@razorwind/core/utils";function r(e,t){let n=e.split(`.`).filter(Boolean);for(;n.length>1&&t.includes(n[0].toLowerCase());)n.shift();return n.join(`-`).replaceAll(/[^\w-]+/g,`-`).toLowerCase()}function i(e){if(typeof e==`number`||typeof e==`boolean`)return String(e);let t=String(e);return/^[a-z][\w-]*$/i.test(t)?t:JSON.stringify(t)}function a(e){return e.split(/[-_.]+/).filter(Boolean).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(` `)}const o=/^(?:light|dark|dim|high-contrast|hc|default|base|theme)(?:[._-].+)?$/i;function s(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}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,r,i,a){if(!s(e))return;let o=u(e,r);if(c(e)){let r=d(e);a.push({path:t.join(`.`),type:o,value:r,cssValue:n(r,o),description:l(e),theme:i});return}for(let[n,r]of Object.entries(e))n.startsWith(`$`)||f(r,[...t,n],o,i,a)}function p(e){if(!s(e))return[];let t=Object.keys(e).filter(e=>!e.startsWith(`$`));return t.length>0&&t.every(e=>o.test(e))?t.map(t=>({id:t,tokens:e[t]})):[{id:`default`,tokens:e}]}function m(e,t){let n=t?new Set(t):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}var h=e({default:()=>B,selectPrimaryTheme:()=>E});const g=new Set([`backgroundColor`,`textColor`,`typography`,`rounded`,`padding`,`size`,`height`,`width`]),_={background:`backgroundColor`,backgroundcolor:`backgroundColor`,bg:`backgroundColor`,fill:`backgroundColor`,color:`textColor`,foreground:`textColor`,text:`textColor`,textcolor:`textColor`,font:`typography`,radius:`rounded`,borderradius:`rounded`,corner:`rounded`},v=[`color`,`colors`,`palette`],y=[`typography`,`type`,`text`,`font`,`fonts`],b=/(?:^|\.)(?:radius|radii|rounded|corner)(?:\.|$)/i,x=/(?:^|\.)(?:spacing|space|gap)(?:\.|$)/i,S=/^components?$/i,C=/^\{([^}]+)\}$/,w=[`fontFamily`,`fontSize`,`fontWeight`,`lineHeight`,`letterSpacing`];function T(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function E(e){let t=[...new Set(e.map(e=>e.theme))],n=t.find(e=>e===void 0)??t.find(e=>/^light/i.test(e??``))??t.find(e=>/^(?:default|base)/i.test(e??``))??t[0];return e.filter(e=>e.theme===n)}function D(e){if(typeof e==`string`)return C.exec(e.trim())?.[1]}function O(e,t){let n=e;for(let e=0;e<8;e++){let e=D(n.value);if(!e)return n;let r=t.get(e);if(!r)return n;n=r}return n}function k(e){return e.split(/[-_.\s]+/).filter(Boolean).map((e,t)=>t===0?e.toLowerCase():e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join(``)}function A(e){let t=k(e);return g.has(t)?t:_[t.toLowerCase()]}function j(e,t){let r={};if(!T(e))return r;for(let i of w){let a=e[i];if(a==null)continue;let o=D(a),s=o?t.get(o):void 0,c=s?O(s,t).cssValue:void 0;if(typeof a==`number`){r[i]=a;continue}r[i]=c??n(a)}return r}function M(e){let t=E(m(e.tokens)),n=new Map(t.map(e=>[e.path,e])),i={colors:{},colorDescriptions:{},typography:{},rounded:{},spacing:{},components:{}},a=new Map,o=[];for(let e of t){let t=e.path.split(`.`);if(t[0]&&S.test(t[0])){o.push(e);continue}if(e.type===`color`){let t=r(e.path,v),o=O(e,n);i.colors[t]=o.cssValue,e.description&&(i.colorDescriptions[t]=e.description),a.set(e.path,`colors.${t}`);continue}if(e.type===`typography`){let t=r(e.path,y);i.typography[t]=j(e.value,n),a.set(e.path,`typography.${t}`);continue}if(e.type===`fontFamily`){let t=r(e.path,y);i.typography[t]??={},i.typography[t].fontFamily=e.cssValue,a.set(e.path,`typography.${t}`);continue}let s=e.type===`dimension`||e.type===`number`||typeof e.value==`number`;if(s&&b.test(e.path)){let r=t.at(-1);i.rounded[r]=O(e,n).cssValue,a.set(e.path,`rounded.${r}`);continue}if(s&&x.test(e.path)){let r=t.at(-1);i.spacing[r]=O(e,n).cssValue,a.set(e.path,`spacing.${r}`)}}for(let e of o){let t=e.path.split(`.`).slice(1);if(t.length<2)continue;let r=A(t.at(-1));if(!r)continue;let o=t.slice(0,-1).join(`-`).replaceAll(/[^\w-]+/g,`-`).toLowerCase(),s=D(e.value),c=s?a.get(s):void 0,l=c?`{${c}}`:O(e,n).cssValue;i.components[o]??={},i.components[o][r]=l}return i}function N(e,t,n){let r=Object.entries(t);if(r.length!==0){n.push(`${e}:`);for(let[e,t]of r){if(typeof t==`object`&&t){n.push(`  ${e}:`);for(let[e,r]of Object.entries(t))n.push(`    ${e}: ${i(r)}`);continue}n.push(`  ${e}: ${i(t)}`)}}}function P(e){let t=[`---`];return e.version&&t.push(`version: ${i(e.version)}`),t.push(`name: ${i(e.name)}`),e.description&&t.push(`description: ${i(e.description)}`),N(`colors`,e.colors,t),N(`typography`,e.typography,t),N(`rounded`,e.rounded,t),N(`spacing`,e.spacing,t),N(`components`,e.components,t),t.push(`---`),`${t.join(`
+`)}\n`}function F(e,...t){return`## ${e}\n\n${t.filter(Boolean).join(`
+`)}\n`}function I(e){let t=[[Object.keys(e.colors).length,`color`],[Object.keys(e.typography).length,`typography`],[Object.keys(e.rounded).length,`shape`],[Object.keys(e.spacing).length,`spacing`],[Object.keys(e.components).length,`component`]].filter(([e])=>e>0).map(([e,t])=>`${e} ${t} token${e===1?``:`s`}`).join(`, `);return`${e.name} design tokens${t?` — ${t}`:``}. The YAML front matter above is the normative source; the prose below explains how to apply it.`}function L(e,t={}){let n=[F(`Overview`,t.overview??I(e))],r=Object.entries(e.colors);r.length>0&&n.push(F(`Colors`,r.map(([t,n])=>{let r=e.colorDescriptions[t];return`- **${a(t)} (${n}):**${r?` ${r}`:``}`}).join(`
+`)));let i=Object.entries(e.typography);i.length>0&&n.push(F(`Typography`,i.map(([e,t])=>`- **${e}:** ${Object.entries(t).map(([e,t])=>`${e}: ${t}`).join(`, `)}`).join(`
+`)));let o=Object.entries(e.spacing);o.length>0&&n.push(F(`Layout`,`Spacing scale:`,``,o.map(([e,t])=>`- **${e}:** ${t}`).join(`
+`)));let s=Object.entries(e.rounded);s.length>0&&n.push(F(`Shapes`,`Corner radius scale:`,``,s.map(([e,t])=>`- **${e}:** ${t}`).join(`
+`)));let c=Object.entries(e.components);return c.length>0&&n.push(F(`Components`,c.map(([e,t])=>`- **${e}:** ${Object.entries(t).map(([e,t])=>`${e}: \`${t}\``).join(`, `)}`).join(`
+`))),n.join(`
+`)}function R(e,t={}){return`${P(e)}\n${L(e,t)}`}function z(e,t={}){let n=M(e);return{[t.outputPath??`DESIGN.md`]:{path:t.outputPath??`DESIGN.md`,language:`markdown`,chunks:[{content:R(n,t),meta:{name:`razorwind-design-md`}}]}}}var B=t((e={})=>({name:`design-md:generate`,generate:async t=>z(t,e)}));export{h as n,E as r,B as t};
+//# sourceMappingURL=generate-C7bCox0_.mjs.map

package/dist/generate-C7bCox0_.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-C7bCox0_.mjs","names":[],"sources":[],"mappings":""}

package/dist/generate.cjs

@@ -0,0 +1 @@
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("./generate-BIFtSW2h.cjs");exports.default=e.t,exports.selectPrimaryTheme=e.r;

package/dist/generate.d.cts

@@ -0,0 +1,2 @@
+import { r as selectPrimaryTheme, t as _default } from "./generate-BvP-cKvD.cjs";
+export { _default as default, selectPrimaryTheme };

package/dist/generate.d.mts

@@ -0,0 +1,2 @@
+import { r as selectPrimaryTheme, t as _default } from "./generate-BvP-cKvD.mjs";
+export { _default as default, selectPrimaryTheme };

package/dist/generate.mjs

@@ -0,0 +1 @@
+import{r as e,t}from"./generate-C7bCox0_.mjs";export{t as default,e as selectPrimaryTheme};

package/dist/index.cjs

@@ -1,9 +1 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});let e=require("@power-plant/core"),t=require("@razorwind/core/plugin"),n=require("@stryke/fs/read-file"),r=require("@stryke/type-checks/is-empty-object"),i=require("@razorwind/core/utils"),a=require("@razorwind/core/tokens"),o=require("@stryke/fs/exists"),s=require("@stryke/path/join"),c=require("yaml");function l(e,t){let n=e.split(`.`).filter(Boolean);for(;n.length>1&&t.includes(n[0].toLowerCase());)n.shift();return n.join(`-`).replaceAll(/[^\w-]+/g,`-`).toLowerCase()}function u(e){if(typeof e==`number`||typeof e==`boolean`)return String(e);let t=String(e);return/^[a-z][\w-]*$/i.test(t)?t:JSON.stringify(t)}function ee(e){return e.split(/[-_.]+/).filter(Boolean).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(` `)}const te=/^(?:light|dark|dim|high-contrast|hc|default|base|theme)(?:[._-].+)?$/i;function d(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function f(e){return`$value`in e||`value`in e||`$ref`in e||`ref`in e}function p(e){if(typeof e.$description==`string`)return e.$description;if(typeof e.description==`string`)return e.description}function m(e,t){return typeof e.$type==`string`?e.$type:typeof e.type==`string`?e.type:t}function h(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 g(e,t,n,r,a){if(!d(e))return;let o=m(e,n);if(f(e)){let n=h(e);a.push({path:t.join(`.`),type:o,value:n,cssValue:(0,i.formatTokenValue)(n,o),description:p(e),theme:r});return}for(let[n,i]of Object.entries(e))n.startsWith(`$`)||g(i,[...t,n],o,r,a)}function _(e){if(!d(e))return[];let t=Object.keys(e).filter(e=>!e.startsWith(`$`));return t.length>0&&t.every(e=>te.test(e))?t.map(t=>({id:t,tokens:e[t]})):[{id:`default`,tokens:e}]}function v(e,t){let n=t?new Set(t):void 0,r=[];for(let t of _(e)){let e=t.id==="default"?void 0:t.id;g(t.tokens,[],void 0,e,r)}return n?r.filter(e=>!e.type||n.has(e.type)):r}const y=new Set([`backgroundColor`,`textColor`,`typography`,`rounded`,`padding`,`size`,`height`,`width`]),ne={background:`backgroundColor`,backgroundcolor:`backgroundColor`,bg:`backgroundColor`,fill:`backgroundColor`,color:`textColor`,foreground:`textColor`,text:`textColor`,textcolor:`textColor`,font:`typography`,radius:`rounded`,borderradius:`rounded`,corner:`rounded`},re=[`color`,`colors`,`palette`],b=[`typography`,`type`,`text`,`font`,`fonts`],x=/(?:^|\.)(?:radius|radii|rounded|corner)(?:\.|$)/i,S=/(?:^|\.)(?:spacing|space|gap)(?:\.|$)/i,C=/^components?$/i,w=/^\{([^}]+)\}$/,T=[`fontFamily`,`fontSize`,`fontWeight`,`lineHeight`,`letterSpacing`];function E(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function D(e){let t=[...new Set(e.map(e=>e.theme))],n=t.find(e=>e===void 0)??t.find(e=>/^light/i.test(e??``))??t.find(e=>/^(?:default|base)/i.test(e??``))??t[0];return e.filter(e=>e.theme===n)}function O(e){if(typeof e==`string`)return w.exec(e.trim())?.[1]}function k(e,t){let n=e;for(let e=0;e<8;e++){let e=O(n.value);if(!e)return n;let r=t.get(e);if(!r)return n;n=r}return n}function ie(e){return e.split(/[-_.\s]+/).filter(Boolean).map((e,t)=>t===0?e.toLowerCase():e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join(``)}function ae(e){let t=ie(e);return y.has(t)?t:ne[t.toLowerCase()]}function oe(e,t){let n={};if(!E(e))return n;for(let r of T){let a=e[r];if(a==null)continue;let o=O(a),s=o?t.get(o):void 0,c=s?k(s,t).cssValue:void 0;if(typeof a==`number`){n[r]=a;continue}n[r]=c??(0,i.formatTokenValue)(a)}return n}function A(e,t={}){let n=D(v(e.tokens)),r=new Map(n.map(e=>[e.path,e])),i={name:t.name??`Razorwind Design System`,description:t.description,version:t.version??`alpha`,colors:{},colorDescriptions:{},typography:{},rounded:{},spacing:{},components:{}},a=new Map,o=[];for(let e of n){let t=e.path.split(`.`);if(t[0]&&C.test(t[0])){o.push(e);continue}if(e.type===`color`){let t=l(e.path,re),n=k(e,r);i.colors[t]=n.cssValue,e.description&&(i.colorDescriptions[t]=e.description),a.set(e.path,`colors.${t}`);continue}if(e.type===`typography`){let t=l(e.path,b);i.typography[t]=oe(e.value,r),a.set(e.path,`typography.${t}`);continue}if(e.type===`fontFamily`){let t=l(e.path,b);i.typography[t]??={},i.typography[t].fontFamily=e.cssValue,a.set(e.path,`typography.${t}`);continue}let n=e.type===`dimension`||e.type===`number`||typeof e.value==`number`;if(n&&x.test(e.path)){let n=t.at(-1);i.rounded[n]=k(e,r).cssValue,a.set(e.path,`rounded.${n}`);continue}if(n&&S.test(e.path)){let n=t.at(-1);i.spacing[n]=k(e,r).cssValue,a.set(e.path,`spacing.${n}`)}}for(let e of o){let t=e.path.split(`.`).slice(1);if(t.length<2)continue;let n=ae(t.at(-1));if(!n)continue;let o=t.slice(0,-1).join(`-`).replaceAll(/[^\w-]+/g,`-`).toLowerCase(),s=O(e.value),c=s?a.get(s):void 0,l=c?`{${c}}`:k(e,r).cssValue;i.components[o]??={},i.components[o][n]=l}return i}function j(e,t,n){let r=Object.entries(t);if(r.length!==0){n.push(`${e}:`);for(let[e,t]of r){if(typeof t==`object`&&t){n.push(`  ${e}:`);for(let[e,r]of Object.entries(t))n.push(`    ${e}: ${u(r)}`);continue}n.push(`  ${e}: ${u(t)}`)}}}function M(e){let t=[`---`];return e.version&&t.push(`version: ${u(e.version)}`),t.push(`name: ${u(e.name)}`),e.description&&t.push(`description: ${u(e.description)}`),j(`colors`,e.colors,t),j(`typography`,e.typography,t),j(`rounded`,e.rounded,t),j(`spacing`,e.spacing,t),j(`components`,e.components,t),t.push(`---`),`${t.join(`
-`)}\n`}function N(e,...t){return`## ${e}\n\n${t.filter(Boolean).join(`
-`)}\n`}function P(e){let t=[[Object.keys(e.colors).length,`color`],[Object.keys(e.typography).length,`typography`],[Object.keys(e.rounded).length,`shape`],[Object.keys(e.spacing).length,`spacing`],[Object.keys(e.components).length,`component`]].filter(([e])=>e>0).map(([e,t])=>`${e} ${t} token${e===1?``:`s`}`).join(`, `);return`${e.name} design tokens${t?` — ${t}`:``}. The YAML front matter above is the normative source; the prose below explains how to apply it.`}function F(e,t={}){let n=[N(`Overview`,t.overview??P(e))],r=Object.entries(e.colors);r.length>0&&n.push(N(`Colors`,r.map(([t,n])=>{let r=e.colorDescriptions[t];return`- **${ee(t)} (${n}):**${r?` ${r}`:``}`}).join(`
-`)));let i=Object.entries(e.typography);i.length>0&&n.push(N(`Typography`,i.map(([e,t])=>`- **${e}:** ${Object.entries(t).map(([e,t])=>`${e}: ${t}`).join(`, `)}`).join(`
-`)));let a=Object.entries(e.spacing);a.length>0&&n.push(N(`Layout`,`Spacing scale:`,``,a.map(([e,t])=>`- **${e}:** ${t}`).join(`
-`)));let o=Object.entries(e.rounded);o.length>0&&n.push(N(`Shapes`,`Corner radius scale:`,``,o.map(([e,t])=>`- **${e}:** ${t}`).join(`
-`)));let s=Object.entries(e.components);return s.length>0&&n.push(N(`Components`,s.map(([e,t])=>`- **${e}:** ${Object.entries(t).map(([e,t])=>`${e}: \`${t}\``).join(`, `)}`).join(`
-`))),n.join(`
-`)}function I(e,t={}){return`${M(e)}\n${F(e,t)}`}function L(e,t={}){let n=t.outFile??`DESIGN.md`,r=A(e,t);return{[n]:{path:n,language:`markdown`,chunks:[{content:I(r,t),meta:{name:`razorwind-design-md`}}]}}}const R=/(?:^|[/\\])design\.md$/i,z=[`DESIGN.md`,`design.md`,`docs/DESIGN.md`],B=/^\uFEFF?---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/,V=/^\{[^{}]+\}$/,H=new Set([`version`,`name`,`description`]),U=[`fontFamily`,`fontSize`,`fontWeight`,`lineHeight`,`letterSpacing`,`fontFeature`,`fontVariation`],W={backgroundColor:`color`,textColor:`color`,typography:`typography`,rounded:`dimension`,padding:`dimension`,size:`dimension`,height:`dimension`,width:`dimension`};function G(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function K(e){return typeof e==`string`&&V.test(e.trim())}function q(e){return typeof e==`number`?`${e}px`:e}function J(e){let t={};for(let n of U){let r=e[n];r!=null&&(t[n]=r)}for(let[n,r]of Object.entries(e))!(n in t)&&r!=null&&(typeof r==`string`||typeof r==`number`)&&(t[n]=r);return t}function Y(e,t,n=!1){let r={};for(let[i,a]of Object.entries(e))a!=null&&(r[i]={$type:t,$value:K(a)?a.trim():n?q(a):a});return r}function se(e){let t={};for(let[n,r]of Object.entries(e))K(r)?t[n]={$type:`typography`,$value:r.trim()}:G(r)&&(t[n]={$type:`typography`,$value:J(r)});return t}function ce(e){let t={};for(let[n,r]of Object.entries(e)){if(!G(r))continue;let e={};for(let[t,n]of Object.entries(r)){if(n==null)continue;let r=W[t];e[t]={...r?{$type:r}:{},$value:K(n)?n.trim():r===`typography`&&G(n)?J(n):q(n)}}Object.keys(e).length>0&&(t[n]=e)}return t}function X(e){let t=B.exec(e);if(!t?.[1])return;let n;try{n=(0,c.parse)(t[1])}catch(e){let t=e instanceof Error?e.message:String(e);throw Error(`Failed to parse DESIGN.md front matter as YAML: ${t}`)}return G(n)?n:void 0}function Z(e){let t={};for(let[n,r]of Object.entries(e))if(!(H.has(n)||!G(r)))switch(n){case`colors`:t[n]=Y(r,`color`);break;case`typography`:t[n]=se(r);break;case`rounded`:case`spacing`:t[n]=Y(r,`dimension`,!0);break;case`components`:t[n]=ce(r);break;default:t[n]=r;break}return(0,a.normalizeTokenTree)(t)}function Q(e){let t=X(e);return t?Z(t):{}}function le(e){return R.test(e)}function $(e){for(let t of z){let n=(0,s.joinPaths)(e,t);if((0,o.existsSync)(n))return n}}var ue=(0,t.definePlugin)((t={})=>({name:`razorwind-design-md`,parsers:[{name:`razorwind-design-md`,pattern:R,parser:e=>Q(e)}],extract:async(i,a)=>{if(i.tokens&&!(0,r.isEmptyObject)(i.tokens))return i;let o=t.path;if(!o){let{cwd:t}=(0,e.useExecution)();if(o=$(t),!o)return i}let s=Q(await(0,n.readFile)(o));return!s||(0,r.isEmptyObject)(s)?i:{...i,tokens:s}},generate:async(e,t)=>L(e,t)}));exports.DESIGN_MD_FILE_PATTERN=R,exports.DESIGN_MD_PATH_CANDIDATES=z,exports.default=ue,exports.designMdToTokens=Z,exports.extractDesignMd=A,exports.extractDesignMdFrontMatter=X,exports.flattenTokens=v,Object.defineProperty(exports,"formatTokenValue",{enumerable:!0,get:function(){return i.formatTokenValue}}),exports.generateDesignMd=L,exports.isDesignMdFile=le,exports.parseDesignMdTokens=Q,exports.renderBody=F,exports.renderDesignMd=I,exports.renderFrontMatter=M,exports.resolveDesignMdPath=$,exports.resolveTokenSets=_,exports.selectPrimaryTheme=D,exports.toTokenName=l,exports.toYamlScalar=u;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./extract.cjs"),t=require("./generate-BIFtSW2h.cjs");Object.defineProperty(exports,"extract",{enumerable:!0,get:function(){return e.t}}),Object.defineProperty(exports,"generate",{enumerable:!0,get:function(){return t.n}});

package/dist/index.d.cts

@@ -1,248 +1,3 @@
-import { Schema, Tokens } from "@razorwind/core/schema";
-import { TokenType } from "@power-plant/dtcg-schema";
-import { formatTokenValue } from "@razorwind/core/utils";
-import { GeneratorFunctionResult } from "@power-plant/core";
-import { DesignTokens } from "style-dictionary/types";
-//#region src/types.d.ts
-/**
- * Options for the Razorwind DESIGN.md generator.
- */
-interface Options {
-  /**
-   * Output file path (relative to the execution cwd).
-   *
-   * @defaultValue `"DESIGN.md"`
-   */
-  outFile?: string;
-  /**
-   * Design system name written to the YAML front matter.
-   *
-   * @defaultValue `"Razorwind Design System"`
-   */
-  name?: string;
-  /**
-   * Short design system description written to the YAML front matter.
-   */
-  description?: string;
-  /**
-   * DESIGN.md spec version written to the YAML front matter.
-   *
-   * @defaultValue `"alpha"`
-   */
-  version?: string;
-  /**
-   * Prose used for the `## Overview` section. When omitted, a summary is
-   * generated from the extracted tokens.
-   */
-  overview?: string;
-}
-/**
- * A flattened design token ready for DESIGN.md extraction.
- */
-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;
-}
-/**
- * A DESIGN.md typography token
- * (https://github.com/google-labs-code/design.md — Token Types).
- */
-interface TypographyToken {
-  fontFamily?: string;
-  fontSize?: string;
-  fontWeight?: string | number;
-  lineHeight?: string | number;
-  letterSpacing?: string;
-}
-/**
- * A DESIGN.md component token — a map of valid component properties
- * (`backgroundColor`, `textColor`, `typography`, `rounded`, `padding`,
- * `size`, `height`, `width`) to values or `{token.references}`.
- */
-type ComponentToken = Record<string, string>;
-/**
- * Intermediate representation of a DESIGN.md document, extracted from the
- * Razorwind schema before rendering.
- */
-interface DesignMdDocument {
-  name: string;
-  description?: string;
-  version?: string;
-  colors: Record<string, string>;
-  /** Prose descriptions keyed by color token name. */
-  colorDescriptions: Record<string, string>;
-  typography: Record<string, TypographyToken>;
-  rounded: Record<string, string>;
-  spacing: Record<string, string>;
-  components: Record<string, ComponentToken>;
-}
-//#endregion
-//#region src/extract.d.ts
-/**
- * Select the token set used for the front matter when tokens are split into
- * multiple themes: the un-themed set first, then `light`, then `default`,
- * then whichever theme appears first.
- */
-declare function selectPrimaryTheme(flat: FlatToken[]): FlatToken[];
-/**
- * Extract a DESIGN.md document from the Razorwind schema.
- *
- * Colors, typography, rounded / spacing scales, and component tokens are
- * derived from the DTCG token tree. DTCG aliases are re-emitted as DESIGN.md
- * `{section.token}` references when the target token is part of the output,
- * or resolved to their terminal CSS value otherwise.
- */
-declare function extractDesignMd(spec: Schema, options?: Options): DesignMdDocument;
-//#endregion
-//#region src/flatten.d.ts
-interface TokenSet {
-  id: string;
-  tokens: Tokens;
-}
-/**
- * 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 | Record<string, Tokens>): TokenSet[];
-/**
- * Flatten DTCG token trees into extraction rows.
- */
-declare function flattenTokens(tokens: Tokens | Record<string, Tokens>, includeTypes?: TokenType[]): FlatToken[];
-//#endregion
-//#region src/format.d.ts
-/**
- * Convert a token path into a DESIGN.md token name.
- *
- * Strips a leading group segment (e.g. `color`, `colors`, `radius`) when it
- * matches the section the token is emitted into, then joins the rest with
- * `-` (DESIGN.md token names are flat kebab-case).
- *
- * @example
- * toTokenName("color.primary", ["color", "colors"]) // "primary"
- */
-declare function toTokenName(path: string, stripPrefixes: string[]): string;
-/**
- * Serialize a value as a YAML scalar, quoting when required (values starting
- * with `#`, `{`, containing YAML-significant characters, etc.).
- */
-declare function toYamlScalar(value: unknown): string;
-//#endregion
-//#region src/generate.d.ts
-/**
- * Render the machine-readable YAML front matter layer of a DESIGN.md file.
- */
-declare function renderFrontMatter(document: DesignMdDocument): string;
-/**
- * Render the human-readable markdown body of a DESIGN.md file. Sections
- * follow the canonical order defined by the spec (Overview, Colors,
- * Typography, Layout, Shapes, Components); empty sections are omitted.
- */
-declare function renderBody(document: DesignMdDocument, options?: Options): string;
-/**
- * Render a complete DESIGN.md file — YAML front matter followed by the
- * markdown body.
- *
- * @see https://github.com/google-labs-code/design.md
- */
-declare function renderDesignMd(document: DesignMdDocument, options?: Options): string;
-/**
- * Generate a DESIGN.md design-system specification file from a Razorwind
- * schema.
- *
- * @see https://github.com/google-labs-code/design.md
- */
-declare function generateDesignMd(spec: Schema, options?: Options): GeneratorFunctionResult<Schema, Options>;
-//#endregion
-//#region src/load.d.ts
-/**
- * Basename pattern for DESIGN.md spec files
- * (https://github.com/google-labs-code/design.md).
- */
-declare const DESIGN_MD_FILE_PATTERN: RegExp;
-/** Candidate workspace paths checked for a DESIGN.md spec file. */
-declare const DESIGN_MD_PATH_CANDIDATES: readonly ["DESIGN.md", "design.md", "docs/DESIGN.md"];
-/**
- * Extract the YAML front matter object from DESIGN.md contents.
- *
- * @param contents - The raw DESIGN.md file contents.
- * @returns The parsed front matter, or `undefined` when no front matter fence
- * is present.
- */
-declare function extractDesignMdFrontMatter(contents: string): Record<string, unknown> | undefined;
-/**
- * Convert DESIGN.md front-matter tokens (colors, typography, rounded,
- * spacing, components) into a DTCG design-token tree.
- *
- * DESIGN.md `{path.to.token}` references are preserved verbatim — the group
- * names in the emitted tree match the front-matter section names, so the
- * references resolve as DTCG aliases without rewriting.
- *
- * @see https://github.com/google-labs-code/design.md#the-specification
- *
- * @param frontMatter - The parsed DESIGN.md YAML front matter.
- * @returns The equivalent DTCG token tree.
- */
-declare function designMdToTokens(frontMatter: Record<string, unknown>): DesignTokens;
-/**
- * Parse DESIGN.md file contents into a DTCG token tree.
- *
- * @param contents - The raw DESIGN.md file contents.
- * @returns The extracted tokens; an empty object when the file has no YAML
- * front matter.
- */
-declare function parseDesignMdTokens(contents: string): DesignTokens;
-/**
- * Check whether a path points at a DESIGN.md spec file.
- *
- * @param filePath - The file path to test.
- * @returns True when the basename is `DESIGN.md` (case-insensitive).
- */
-declare function isDesignMdFile(filePath: string): boolean;
-/**
- * Resolve the DESIGN.md file for a workspace, if one exists.
- *
- * @param cwd - The workspace root to search from.
- * @returns The absolute path to the first matching candidate, or `undefined`.
- */
-declare function resolveDesignMdPath(cwd: string): string | undefined;
-//#endregion
-//#region src/index.d.ts
-interface DesignMdPluginOptions {
-  /**
-   * The path to the DESIGN.md file.
-   *
-   * @default "DESIGN.md"
-   */
-  path?: string;
-}
-/**
- * Razorwind plugin: load DESIGN.md tokens on extract, emit DESIGN.md on generate.
- *
- * @see https://github.com/google-labs-code/design.md
- *
- * @example
- * ```ts
- * import { defineConfig } from "@razorwind/core";
- * import designMd from "@razorwind/design-md";
- *
- * export default defineConfig({
- *   plugins: [designMd()]
- * });
- * ```
- */
-declare const _default: any;
-//#endregion
-export { type ComponentToken, DESIGN_MD_FILE_PATTERN, DESIGN_MD_PATH_CANDIDATES, type DesignMdDocument, DesignMdPluginOptions, type FlatToken, type Options, type TypographyToken, _default as default, designMdToTokens, extractDesignMd, extractDesignMdFrontMatter, flattenTokens, formatTokenValue, generateDesignMd, isDesignMdFile, parseDesignMdTokens, renderBody, renderDesignMd, renderFrontMatter, resolveDesignMdPath, resolveTokenSets, selectPrimaryTheme, toTokenName, toYamlScalar };
-//# sourceMappingURL=index.d.cts.map
+import { t as extract_d_exports } from "./extract.cjs";
+import { n as generate_d_exports } from "./generate-BvP-cKvD.cjs";
+export { extract_d_exports as extract, generate_d_exports as generate };

package/dist/index.d.mts

@@ -1,248 +1,3 @@
-import { GeneratorFunctionResult } from "@power-plant/core";
-import { formatTokenValue } from "@razorwind/core/utils";
-import { Schema, Tokens } from "@razorwind/core/schema";
-import { TokenType } from "@power-plant/dtcg-schema";
-import { DesignTokens } from "style-dictionary/types";
-//#region src/types.d.ts
-/**
- * Options for the Razorwind DESIGN.md generator.
- */
-interface Options {
-  /**
-   * Output file path (relative to the execution cwd).
-   *
-   * @defaultValue `"DESIGN.md"`
-   */
-  outFile?: string;
-  /**
-   * Design system name written to the YAML front matter.
-   *
-   * @defaultValue `"Razorwind Design System"`
-   */
-  name?: string;
-  /**
-   * Short design system description written to the YAML front matter.
-   */
-  description?: string;
-  /**
-   * DESIGN.md spec version written to the YAML front matter.
-   *
-   * @defaultValue `"alpha"`
-   */
-  version?: string;
-  /**
-   * Prose used for the `## Overview` section. When omitted, a summary is
-   * generated from the extracted tokens.
-   */
-  overview?: string;
-}
-/**
- * A flattened design token ready for DESIGN.md extraction.
- */
-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;
-}
-/**
- * A DESIGN.md typography token
- * (https://github.com/google-labs-code/design.md — Token Types).
- */
-interface TypographyToken {
-  fontFamily?: string;
-  fontSize?: string;
-  fontWeight?: string | number;
-  lineHeight?: string | number;
-  letterSpacing?: string;
-}
-/**
- * A DESIGN.md component token — a map of valid component properties
- * (`backgroundColor`, `textColor`, `typography`, `rounded`, `padding`,
- * `size`, `height`, `width`) to values or `{token.references}`.
- */
-type ComponentToken = Record<string, string>;
-/**
- * Intermediate representation of a DESIGN.md document, extracted from the
- * Razorwind schema before rendering.
- */
-interface DesignMdDocument {
-  name: string;
-  description?: string;
-  version?: string;
-  colors: Record<string, string>;
-  /** Prose descriptions keyed by color token name. */
-  colorDescriptions: Record<string, string>;
-  typography: Record<string, TypographyToken>;
-  rounded: Record<string, string>;
-  spacing: Record<string, string>;
-  components: Record<string, ComponentToken>;
-}
-//#endregion
-//#region src/extract.d.ts
-/**
- * Select the token set used for the front matter when tokens are split into
- * multiple themes: the un-themed set first, then `light`, then `default`,
- * then whichever theme appears first.
- */
-declare function selectPrimaryTheme(flat: FlatToken[]): FlatToken[];
-/**
- * Extract a DESIGN.md document from the Razorwind schema.
- *
- * Colors, typography, rounded / spacing scales, and component tokens are
- * derived from the DTCG token tree. DTCG aliases are re-emitted as DESIGN.md
- * `{section.token}` references when the target token is part of the output,
- * or resolved to their terminal CSS value otherwise.
- */
-declare function extractDesignMd(spec: Schema, options?: Options): DesignMdDocument;
-//#endregion
-//#region src/flatten.d.ts
-interface TokenSet {
-  id: string;
-  tokens: Tokens;
-}
-/**
- * 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 | Record<string, Tokens>): TokenSet[];
-/**
- * Flatten DTCG token trees into extraction rows.
- */
-declare function flattenTokens(tokens: Tokens | Record<string, Tokens>, includeTypes?: TokenType[]): FlatToken[];
-//#endregion
-//#region src/format.d.ts
-/**
- * Convert a token path into a DESIGN.md token name.
- *
- * Strips a leading group segment (e.g. `color`, `colors`, `radius`) when it
- * matches the section the token is emitted into, then joins the rest with
- * `-` (DESIGN.md token names are flat kebab-case).
- *
- * @example
- * toTokenName("color.primary", ["color", "colors"]) // "primary"
- */
-declare function toTokenName(path: string, stripPrefixes: string[]): string;
-/**
- * Serialize a value as a YAML scalar, quoting when required (values starting
- * with `#`, `{`, containing YAML-significant characters, etc.).
- */
-declare function toYamlScalar(value: unknown): string;
-//#endregion
-//#region src/generate.d.ts
-/**
- * Render the machine-readable YAML front matter layer of a DESIGN.md file.
- */
-declare function renderFrontMatter(document: DesignMdDocument): string;
-/**
- * Render the human-readable markdown body of a DESIGN.md file. Sections
- * follow the canonical order defined by the spec (Overview, Colors,
- * Typography, Layout, Shapes, Components); empty sections are omitted.
- */
-declare function renderBody(document: DesignMdDocument, options?: Options): string;
-/**
- * Render a complete DESIGN.md file — YAML front matter followed by the
- * markdown body.
- *
- * @see https://github.com/google-labs-code/design.md
- */
-declare function renderDesignMd(document: DesignMdDocument, options?: Options): string;
-/**
- * Generate a DESIGN.md design-system specification file from a Razorwind
- * schema.
- *
- * @see https://github.com/google-labs-code/design.md
- */
-declare function generateDesignMd(spec: Schema, options?: Options): GeneratorFunctionResult<Schema, Options>;
-//#endregion
-//#region src/load.d.ts
-/**
- * Basename pattern for DESIGN.md spec files
- * (https://github.com/google-labs-code/design.md).
- */
-declare const DESIGN_MD_FILE_PATTERN: RegExp;
-/** Candidate workspace paths checked for a DESIGN.md spec file. */
-declare const DESIGN_MD_PATH_CANDIDATES: readonly ["DESIGN.md", "design.md", "docs/DESIGN.md"];
-/**
- * Extract the YAML front matter object from DESIGN.md contents.
- *
- * @param contents - The raw DESIGN.md file contents.
- * @returns The parsed front matter, or `undefined` when no front matter fence
- * is present.
- */
-declare function extractDesignMdFrontMatter(contents: string): Record<string, unknown> | undefined;
-/**
- * Convert DESIGN.md front-matter tokens (colors, typography, rounded,
- * spacing, components) into a DTCG design-token tree.
- *
- * DESIGN.md `{path.to.token}` references are preserved verbatim — the group
- * names in the emitted tree match the front-matter section names, so the
- * references resolve as DTCG aliases without rewriting.
- *
- * @see https://github.com/google-labs-code/design.md#the-specification
- *
- * @param frontMatter - The parsed DESIGN.md YAML front matter.
- * @returns The equivalent DTCG token tree.
- */
-declare function designMdToTokens(frontMatter: Record<string, unknown>): DesignTokens;
-/**
- * Parse DESIGN.md file contents into a DTCG token tree.
- *
- * @param contents - The raw DESIGN.md file contents.
- * @returns The extracted tokens; an empty object when the file has no YAML
- * front matter.
- */
-declare function parseDesignMdTokens(contents: string): DesignTokens;
-/**
- * Check whether a path points at a DESIGN.md spec file.
- *
- * @param filePath - The file path to test.
- * @returns True when the basename is `DESIGN.md` (case-insensitive).
- */
-declare function isDesignMdFile(filePath: string): boolean;
-/**
- * Resolve the DESIGN.md file for a workspace, if one exists.
- *
- * @param cwd - The workspace root to search from.
- * @returns The absolute path to the first matching candidate, or `undefined`.
- */
-declare function resolveDesignMdPath(cwd: string): string | undefined;
-//#endregion
-//#region src/index.d.ts
-interface DesignMdPluginOptions {
-  /**
-   * The path to the DESIGN.md file.
-   *
-   * @default "DESIGN.md"
-   */
-  path?: string;
-}
-/**
- * Razorwind plugin: load DESIGN.md tokens on extract, emit DESIGN.md on generate.
- *
- * @see https://github.com/google-labs-code/design.md
- *
- * @example
- * ```ts
- * import { defineConfig } from "@razorwind/core";
- * import designMd from "@razorwind/design-md";
- *
- * export default defineConfig({
- *   plugins: [designMd()]
- * });
- * ```
- */
-declare const _default: any;
-//#endregion
-export { type ComponentToken, DESIGN_MD_FILE_PATTERN, DESIGN_MD_PATH_CANDIDATES, type DesignMdDocument, DesignMdPluginOptions, type FlatToken, type Options, type TypographyToken, _default as default, designMdToTokens, extractDesignMd, extractDesignMdFrontMatter, flattenTokens, formatTokenValue, generateDesignMd, isDesignMdFile, parseDesignMdTokens, renderBody, renderDesignMd, renderFrontMatter, resolveDesignMdPath, resolveTokenSets, selectPrimaryTheme, toTokenName, toYamlScalar };
-//# sourceMappingURL=index.d.mts.map
+import { t as extract_d_exports } from "./extract.mjs";
+import { n as generate_d_exports } from "./generate-BvP-cKvD.mjs";
+export { extract_d_exports as extract, generate_d_exports as generate };

package/dist/index.mjs

@@ -1,10 +1 @@
-import{useExecution as e}from"@power-plant/core";import{definePlugin as t}from"@razorwind/core/plugin";import{readFile as n}from"@stryke/fs/read-file";import{isEmptyObject as r}from"@stryke/type-checks/is-empty-object";import{formatTokenValue as i}from"@razorwind/core/utils";import{normalizeTokenTree as a}from"@razorwind/core/tokens";import{existsSync as o}from"@stryke/fs/exists";import{joinPaths as s}from"@stryke/path/join";import{parse as c}from"yaml";function l(e,t){let n=e.split(`.`).filter(Boolean);for(;n.length>1&&t.includes(n[0].toLowerCase());)n.shift();return n.join(`-`).replaceAll(/[^\w-]+/g,`-`).toLowerCase()}function u(e){if(typeof e==`number`||typeof e==`boolean`)return String(e);let t=String(e);return/^[a-z][\w-]*$/i.test(t)?t:JSON.stringify(t)}function ee(e){return e.split(/[-_.]+/).filter(Boolean).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(` `)}const te=/^(?:light|dark|dim|high-contrast|hc|default|base|theme)(?:[._-].+)?$/i;function d(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function f(e){return`$value`in e||`value`in e||`$ref`in e||`ref`in e}function p(e){if(typeof e.$description==`string`)return e.$description;if(typeof e.description==`string`)return e.description}function m(e,t){return typeof e.$type==`string`?e.$type:typeof e.type==`string`?e.type:t}function h(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 g(e,t,n,r,a){if(!d(e))return;let o=m(e,n);if(f(e)){let n=h(e);a.push({path:t.join(`.`),type:o,value:n,cssValue:i(n,o),description:p(e),theme:r});return}for(let[n,i]of Object.entries(e))n.startsWith(`$`)||g(i,[...t,n],o,r,a)}function _(e){if(!d(e))return[];let t=Object.keys(e).filter(e=>!e.startsWith(`$`));return t.length>0&&t.every(e=>te.test(e))?t.map(t=>({id:t,tokens:e[t]})):[{id:`default`,tokens:e}]}function v(e,t){let n=t?new Set(t):void 0,r=[];for(let t of _(e)){let e=t.id==="default"?void 0:t.id;g(t.tokens,[],void 0,e,r)}return n?r.filter(e=>!e.type||n.has(e.type)):r}const y=new Set([`backgroundColor`,`textColor`,`typography`,`rounded`,`padding`,`size`,`height`,`width`]),ne={background:`backgroundColor`,backgroundcolor:`backgroundColor`,bg:`backgroundColor`,fill:`backgroundColor`,color:`textColor`,foreground:`textColor`,text:`textColor`,textcolor:`textColor`,font:`typography`,radius:`rounded`,borderradius:`rounded`,corner:`rounded`},re=[`color`,`colors`,`palette`],b=[`typography`,`type`,`text`,`font`,`fonts`],x=/(?:^|\.)(?:radius|radii|rounded|corner)(?:\.|$)/i,S=/(?:^|\.)(?:spacing|space|gap)(?:\.|$)/i,C=/^components?$/i,w=/^\{([^}]+)\}$/,T=[`fontFamily`,`fontSize`,`fontWeight`,`lineHeight`,`letterSpacing`];function E(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function D(e){let t=[...new Set(e.map(e=>e.theme))],n=t.find(e=>e===void 0)??t.find(e=>/^light/i.test(e??``))??t.find(e=>/^(?:default|base)/i.test(e??``))??t[0];return e.filter(e=>e.theme===n)}function O(e){if(typeof e==`string`)return w.exec(e.trim())?.[1]}function k(e,t){let n=e;for(let e=0;e<8;e++){let e=O(n.value);if(!e)return n;let r=t.get(e);if(!r)return n;n=r}return n}function ie(e){return e.split(/[-_.\s]+/).filter(Boolean).map((e,t)=>t===0?e.toLowerCase():e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join(``)}function ae(e){let t=ie(e);return y.has(t)?t:ne[t.toLowerCase()]}function oe(e,t){let n={};if(!E(e))return n;for(let r of T){let a=e[r];if(a==null)continue;let o=O(a),s=o?t.get(o):void 0,c=s?k(s,t).cssValue:void 0;if(typeof a==`number`){n[r]=a;continue}n[r]=c??i(a)}return n}function A(e,t={}){let n=D(v(e.tokens)),r=new Map(n.map(e=>[e.path,e])),i={name:t.name??`Razorwind Design System`,description:t.description,version:t.version??`alpha`,colors:{},colorDescriptions:{},typography:{},rounded:{},spacing:{},components:{}},a=new Map,o=[];for(let e of n){let t=e.path.split(`.`);if(t[0]&&C.test(t[0])){o.push(e);continue}if(e.type===`color`){let t=l(e.path,re),n=k(e,r);i.colors[t]=n.cssValue,e.description&&(i.colorDescriptions[t]=e.description),a.set(e.path,`colors.${t}`);continue}if(e.type===`typography`){let t=l(e.path,b);i.typography[t]=oe(e.value,r),a.set(e.path,`typography.${t}`);continue}if(e.type===`fontFamily`){let t=l(e.path,b);i.typography[t]??={},i.typography[t].fontFamily=e.cssValue,a.set(e.path,`typography.${t}`);continue}let n=e.type===`dimension`||e.type===`number`||typeof e.value==`number`;if(n&&x.test(e.path)){let n=t.at(-1);i.rounded[n]=k(e,r).cssValue,a.set(e.path,`rounded.${n}`);continue}if(n&&S.test(e.path)){let n=t.at(-1);i.spacing[n]=k(e,r).cssValue,a.set(e.path,`spacing.${n}`)}}for(let e of o){let t=e.path.split(`.`).slice(1);if(t.length<2)continue;let n=ae(t.at(-1));if(!n)continue;let o=t.slice(0,-1).join(`-`).replaceAll(/[^\w-]+/g,`-`).toLowerCase(),s=O(e.value),c=s?a.get(s):void 0,l=c?`{${c}}`:k(e,r).cssValue;i.components[o]??={},i.components[o][n]=l}return i}function j(e,t,n){let r=Object.entries(t);if(r.length!==0){n.push(`${e}:`);for(let[e,t]of r){if(typeof t==`object`&&t){n.push(`  ${e}:`);for(let[e,r]of Object.entries(t))n.push(`    ${e}: ${u(r)}`);continue}n.push(`  ${e}: ${u(t)}`)}}}function M(e){let t=[`---`];return e.version&&t.push(`version: ${u(e.version)}`),t.push(`name: ${u(e.name)}`),e.description&&t.push(`description: ${u(e.description)}`),j(`colors`,e.colors,t),j(`typography`,e.typography,t),j(`rounded`,e.rounded,t),j(`spacing`,e.spacing,t),j(`components`,e.components,t),t.push(`---`),`${t.join(`
-`)}\n`}function N(e,...t){return`## ${e}\n\n${t.filter(Boolean).join(`
-`)}\n`}function P(e){let t=[[Object.keys(e.colors).length,`color`],[Object.keys(e.typography).length,`typography`],[Object.keys(e.rounded).length,`shape`],[Object.keys(e.spacing).length,`spacing`],[Object.keys(e.components).length,`component`]].filter(([e])=>e>0).map(([e,t])=>`${e} ${t} token${e===1?``:`s`}`).join(`, `);return`${e.name} design tokens${t?` — ${t}`:``}. The YAML front matter above is the normative source; the prose below explains how to apply it.`}function F(e,t={}){let n=[N(`Overview`,t.overview??P(e))],r=Object.entries(e.colors);r.length>0&&n.push(N(`Colors`,r.map(([t,n])=>{let r=e.colorDescriptions[t];return`- **${ee(t)} (${n}):**${r?` ${r}`:``}`}).join(`
-`)));let i=Object.entries(e.typography);i.length>0&&n.push(N(`Typography`,i.map(([e,t])=>`- **${e}:** ${Object.entries(t).map(([e,t])=>`${e}: ${t}`).join(`, `)}`).join(`
-`)));let a=Object.entries(e.spacing);a.length>0&&n.push(N(`Layout`,`Spacing scale:`,``,a.map(([e,t])=>`- **${e}:** ${t}`).join(`
-`)));let o=Object.entries(e.rounded);o.length>0&&n.push(N(`Shapes`,`Corner radius scale:`,``,o.map(([e,t])=>`- **${e}:** ${t}`).join(`
-`)));let s=Object.entries(e.components);return s.length>0&&n.push(N(`Components`,s.map(([e,t])=>`- **${e}:** ${Object.entries(t).map(([e,t])=>`${e}: \`${t}\``).join(`, `)}`).join(`
-`))),n.join(`
-`)}function I(e,t={}){return`${M(e)}\n${F(e,t)}`}function L(e,t={}){let n=t.outFile??`DESIGN.md`,r=A(e,t);return{[n]:{path:n,language:`markdown`,chunks:[{content:I(r,t),meta:{name:`razorwind-design-md`}}]}}}const R=/(?:^|[/\\])design\.md$/i,z=[`DESIGN.md`,`design.md`,`docs/DESIGN.md`],B=/^\uFEFF?---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/,V=/^\{[^{}]+\}$/,H=new Set([`version`,`name`,`description`]),U=[`fontFamily`,`fontSize`,`fontWeight`,`lineHeight`,`letterSpacing`,`fontFeature`,`fontVariation`],W={backgroundColor:`color`,textColor:`color`,typography:`typography`,rounded:`dimension`,padding:`dimension`,size:`dimension`,height:`dimension`,width:`dimension`};function G(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function K(e){return typeof e==`string`&&V.test(e.trim())}function q(e){return typeof e==`number`?`${e}px`:e}function J(e){let t={};for(let n of U){let r=e[n];r!=null&&(t[n]=r)}for(let[n,r]of Object.entries(e))!(n in t)&&r!=null&&(typeof r==`string`||typeof r==`number`)&&(t[n]=r);return t}function Y(e,t,n=!1){let r={};for(let[i,a]of Object.entries(e))a!=null&&(r[i]={$type:t,$value:K(a)?a.trim():n?q(a):a});return r}function se(e){let t={};for(let[n,r]of Object.entries(e))K(r)?t[n]={$type:`typography`,$value:r.trim()}:G(r)&&(t[n]={$type:`typography`,$value:J(r)});return t}function ce(e){let t={};for(let[n,r]of Object.entries(e)){if(!G(r))continue;let e={};for(let[t,n]of Object.entries(r)){if(n==null)continue;let r=W[t];e[t]={...r?{$type:r}:{},$value:K(n)?n.trim():r===`typography`&&G(n)?J(n):q(n)}}Object.keys(e).length>0&&(t[n]=e)}return t}function X(e){let t=B.exec(e);if(!t?.[1])return;let n;try{n=c(t[1])}catch(e){let t=e instanceof Error?e.message:String(e);throw Error(`Failed to parse DESIGN.md front matter as YAML: ${t}`)}return G(n)?n:void 0}function Z(e){let t={};for(let[n,r]of Object.entries(e))if(!(H.has(n)||!G(r)))switch(n){case`colors`:t[n]=Y(r,`color`);break;case`typography`:t[n]=se(r);break;case`rounded`:case`spacing`:t[n]=Y(r,`dimension`,!0);break;case`components`:t[n]=ce(r);break;default:t[n]=r;break}return a(t)}function Q(e){let t=X(e);return t?Z(t):{}}function le(e){return R.test(e)}function $(e){for(let t of z){let n=s(e,t);if(o(n))return n}}var ue=t((t={})=>({name:`razorwind-design-md`,parsers:[{name:`razorwind-design-md`,pattern:R,parser:e=>Q(e)}],extract:async(i,a)=>{if(i.tokens&&!r(i.tokens))return i;let o=t.path;if(!o){let{cwd:t}=e();if(o=$(t),!o)return i}let s=Q(await n(o));return!s||r(s)?i:{...i,tokens:s}},generate:async(e,t)=>L(e,t)}));export{R as DESIGN_MD_FILE_PATTERN,z as DESIGN_MD_PATH_CANDIDATES,ue as default,Z as designMdToTokens,A as extractDesignMd,X as extractDesignMdFrontMatter,v as flattenTokens,i as formatTokenValue,L as generateDesignMd,le as isDesignMdFile,Q as parseDesignMdTokens,F as renderBody,I as renderDesignMd,M as renderFrontMatter,$ as resolveDesignMdPath,_ as resolveTokenSets,D as selectPrimaryTheme,l as toTokenName,u as toYamlScalar};
-//# sourceMappingURL=index.mjs.map
+import{t as e}from"./extract.mjs";import{n as t}from"./generate-C7bCox0_.mjs";export{e as extract,t as generate};

package/dist/rolldown-runtime-BIInC43l.cjs

@@ -0,0 +1 @@
+var e=Object.defineProperty,t=(t,n)=>{let r={};for(var i in t)e(r,i,{get:t[i],enumerable:!0});return n||e(r,Symbol.toStringTag,{value:`Module`}),r};Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return t}});

package/dist/rolldown-runtime-DK3Fl9T5.mjs

@@ -0,0 +1 @@
+var e=Object.defineProperty,t=(t,n)=>{let r={};for(var i in t)e(r,i,{get:t[i],enumerable:!0});return n||e(r,Symbol.toStringTag,{value:`Module`}),r};export{t};

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@razorwind/design-md",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "type": "module",
-  "description": "Razorwind design-md package that can create a DESIGN.md design-system specification file from design tokens or read a DESIGN.md file and return the design-system specification.",
+  "description": "Razorwind DESIGN.md plugin that can create a DESIGN.md design-system specification file from design tokens or read a DESIGN.md file and return the design-system specification.",
   "repository": {
     "type": "github",
     "url": "https://github.com/storm-software/razorwind.git",
@@ -43,6 +43,34 @@
         "default": "./dist/index.mjs"
       }
     },
+    "./extract": {
+      "require": {
+        "types": "./dist/extract.d.cts",
+        "default": "./dist/extract.cjs"
+      },
+      "import": {
+        "types": "./dist/extract.d.mts",
+        "default": "./dist/extract.mjs"
+      },
+      "default": {
+        "types": "./dist/extract.d.mts",
+        "default": "./dist/extract.mjs"
+      }
+    },
+    "./generate": {
+      "require": {
+        "types": "./dist/generate.d.cts",
+        "default": "./dist/generate.cjs"
+      },
+      "import": {
+        "types": "./dist/generate.d.mts",
+        "default": "./dist/generate.mjs"
+      },
+      "default": {
+        "types": "./dist/generate.d.mts",
+        "default": "./dist/generate.mjs"
+      }
+    },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.cjs",
@@ -52,7 +80,7 @@
   "dependencies": {
     "@power-plant/core": "^0.0.37",
     "@power-plant/dtcg-schema": "^0.0.1",
-    "@razorwind/core": "^0.0.8",
+    "@razorwind/core": "^0.0.9",
     "@stryke/fs": "^0.33.99",
     "@stryke/path": "^0.29.25",
     "@stryke/type-checks": "^0.6.31",
@@ -65,5 +93,5 @@
     "typescript": "^6.0.3"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "1d74276595c13888022fafaa5f501092dc8e03a0"
+  "gitHead": "6ca83196e6028c6c051887e6390dbd62dd3b0582"
 }

package/dist/index.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/extract.ts","../src/flatten.ts","../src/format.ts","../src/generate.ts","../src/load.ts","../src/index.ts"],"mappings":";;;;;;;;;UAuBiB;;;;;;EAMf;;;;;;EAOA;;;;EAKA;;;;;;EAOA;;;;;EAMA;;;;;UAMe;;EAEf;;EAEA,OAAO;;EAEP;;EAEA;;EAEA;;EAEA;;;;;;UAOe;EACf;EACA;EACA;EACA;EACA;;;;;;;KAQU,iBAAiB;;;;;UAMZ;EACf;EACA;EACA;EACA,QAAQ;;EAER,mBAAmB;EACnB,YAAY,eAAe;EAC3B,SAAS;EACT,SAAS;EACT,YAAY,eAAe;;;;;;;;;iBC5Bb,mBAAmB,MAAM,cAAc;;;;;;;;;iBA6GvC,gBACd,MAAM,QACN,UAAS,UACR;;;UCpFc;EACf;EACA,QAAQ;;;;;;;;iBASM,iBACd,QAAQ,SAAS,eAAe,UAC/B;;;;iBAsBa,cACd,QAAQ,SAAS,eAAe,SAChC,eAAe,cACd;;;;;;;;;;;;;iBCpHa,YAAY,cAAc;;;;;iBAoB1B,aAAa;;;;;;iBCIb,kBAAkB,UAAU;;;;;;iBAgD5B,WACd,UAAU,kBACV,UAAS;;;;;;;iBA6FK,eACd,UAAU,kBACV,UAAS;;;;;;;iBAWK,iBACd,MAAM,QACN,UAAS,UACR,wBAAwB,QAAQ;;;;;;;cCzLtB,wBAAsB;;cAGtB;;;;;;;;iBAiLG,2BACd,mBACC;;;;;;;;;;;;;;iBAgCa,iBACd,aAAa,0BACZ;;;;;;;;iBAwCa,oBAAoB,mBAAmB;;;;;;;iBAevC,eAAe;;;;;;;iBAUf,oBAAoB;;;UC7PnB;;;;;;EAMf"}

package/dist/index.d.mts.map

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

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","names":[],"sources":[],"mappings":""}