tempest-react-sdk 0.73.0 → 0.75.0

package/dist/theme/inverse-restore.cjs

@@ -0,0 +1,5 @@
+var e=`[data-tempest-tone="default"]`,t=`[data-tempest-theme="dark"]`,n={selector:`:root`,darkSelector:t};function r(e){return e.replace(`--tempest-`,`--tempest-default-`)}function i(n,i,a){let o=[...new Set([`:root`,`[data-tempest-theme]`,a.selector,a.darkSelector])].filter(e=>e!==t).join(`, `),s=(e,t)=>`${e} {\n${t.map(([e,t])=>`    ${e}: ${t};`).join(`
+`)}\n}`;return[s(`:where(:is(${o}):not(${i}))`,n.map(e=>[r(e),`var(${e})`])),s(`:where(${e}:not(${o}))`,n.map(e=>[e,`var(${r(e)})`])),s(`:where(${e})`,[[`color-scheme`,`light`],[`background-color`,`var(--tempest-bg)`],[`color`,`var(--tempest-text)`]]),s(`:where(:is(${a.darkSelector}) ${e})`,[[`color-scheme`,`dark`]])].join(`
+
+`)}exports.DEFAULT_PAGE_SELECTORS=n,exports.DEFAULT_TONE_SELECTOR=e,exports.defaultToneRules=i;
+//# sourceMappingURL=inverse-restore.cjs.map

package/dist/theme/inverse-restore.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inverse-restore.cjs","names":[],"sources":["../../src/theme/inverse-restore.ts"],"sourcesContent":["/**\n * The default tone: a region inside an inverse surface that goes back to the\n * page's tokens — `data-tempest-tone=\"default\"`, or `<Section tone=\"default\">`.\n * A white form or price `Card` in a navy hero.\n *\n * Lives beside the generator, not in `inverse-render.ts`, so only an app that\n * imports `createInverseSurface` ships it: `createTheme` alone stays the size it\n * was.\n */\nimport type { PageSelectors } from \"./inverse-render\";\n\n/** Selector that hands a region inside an inverse surface back to the page's tokens. */\nexport const DEFAULT_TONE_SELECTOR = '[data-tempest-tone=\"default\"]';\n\n/** `createTheme`'s default `darkSelector`, already covered by `[data-tempest-theme]`. */\nconst DARK_SELECTOR = '[data-tempest-theme=\"dark\"]';\n\n/** Where `createTheme` writes the page's schemes when told nothing else. */\nexport const DEFAULT_PAGE_SELECTORS: PageSelectors = {\n    selector: \":root\",\n    darkSelector: DARK_SELECTOR,\n};\n\n/**\n * Name of the custom property that keeps the page's value of `token`.\n *\n * @param token - A `--tempest-*` token.\n * @returns The `--tempest-default-*` twin it is saved under.\n */\nfunction twinOf(token: string): string {\n    return token.replace(\"--tempest-\", \"--tempest-default-\");\n}\n\n/**\n * The rules that let a region inside an inverse surface go back to the page's\n * tokens, light or dark — whichever the page is on.\n *\n * Custom properties inherit from the parent, so a rule cannot \"skip\" the\n * inverse section and read `:root` again — and scoping the inverse block away\n * from the region (`@scope (…) to (…)`, `:not()`) changes nothing either, since\n * the region still inherits what its inverse parent declared. Measured in\n * Chromium on a `Card`, an `Input` and a `Button` inside the region, 25 of 28\n * computed values differed from the same trio on the page in light and 18 of 28\n * in dark, with or without `@scope`.\n *\n * What works is saving the page's values before the section overrides them.\n * Every element a theme is declared on (`:root`, `[data-tempest-theme]`, and the\n * theme's own selectors) copies each token the surface redefines into a\n * `--tempest-default-*` twin. `var()` in a custom property resolves on the\n * element that declares it, so the twin holds the page's value — the SDK's, a\n * theme's or the app's own `:root` override — and inherits through the section\n * untouched. The region reads its tokens back from the twins: 0 of 28 values\n * differ, in light, in dark and under a dark subtree.\n *\n * Two alternatives were measured and rejected. Writing the page's values out,\n * one block per scheme, is 1257 B brotli and restores the SDK's defaults rather\n * than the page: with a brand override on `:root`, 3 of 28 values came back\n * wrong. Adding the region to the selectors of `colors.css` costs 15 B brotli,\n * but charges every app and misses the same override.\n *\n * Everything sits under `:where()`, so a class the app puts on the same element\n * still wins. The anchors are left out of the region and the section out of the\n * anchors: a token and its twin declared on one element reference each other,\n * and both resolve to nothing.\n *\n * @param tokens - The tokens the surface redefines.\n * @param selector - Selector the inverse surface is written under.\n * @param page - Selectors the page's schemes are written under.\n * @returns The CSS text of the rules, in the order they must be written.\n */\nexport function defaultToneRules(\n    tokens: readonly string[],\n    selector: string,\n    page: PageSelectors,\n): string {\n    const anchors = [\n        ...new Set([\":root\", \"[data-tempest-theme]\", page.selector, page.darkSelector]),\n    ]\n        .filter((anchor) => anchor !== DARK_SELECTOR)\n        .join(\", \");\n    const block = (rule: string, declarations: readonly (readonly [string, string])[]): string =>\n        `${rule} {\\n${declarations.map(([name, value]) => `    ${name}: ${value};`).join(\"\\n\")}\\n}`;\n    return [\n        block(\n            `:where(:is(${anchors}):not(${selector}))`,\n            tokens.map((token) => [twinOf(token), `var(${token})`]),\n        ),\n        block(\n            `:where(${DEFAULT_TONE_SELECTOR}:not(${anchors}))`,\n            tokens.map((token) => [token, `var(${twinOf(token)})`]),\n        ),\n        block(`:where(${DEFAULT_TONE_SELECTOR})`, [\n            [\"color-scheme\", \"light\"],\n            [\"background-color\", \"var(--tempest-bg)\"],\n            [\"color\", \"var(--tempest-text)\"],\n        ]),\n        block(`:where(:is(${page.darkSelector}) ${DEFAULT_TONE_SELECTOR})`, [\n            [\"color-scheme\", \"dark\"],\n        ]),\n    ].join(\"\\n\\n\");\n}\n"],"mappings":"AAYA,IAAa,EAAwB,gCAG/B,EAAgB,8BAGT,EAAwC,CACjD,SAAU,QACV,aAAc,CAClB,EAQA,SAAS,EAAO,EAAuB,CACnC,OAAO,EAAM,QAAQ,aAAc,oBAAoB,CAC3D,CAuCA,SAAgB,EACZ,EACA,EACA,EACM,CACN,IAAM,EAAU,CACZ,GAAG,IAAI,IAAI,CAAC,QAAS,uBAAwB,EAAK,SAAU,EAAK,YAAY,CAAC,CAClF,CAAC,CACI,OAAQ,GAAW,IAAW,CAAa,CAAC,CAC5C,KAAK,IAAI,EACR,GAAS,EAAc,IACzB,GAAG,EAAK,MAAM,EAAa,KAAK,CAAC,EAAM,KAAW,OAAO,EAAK,IAAI,EAAM,EAAE,CAAC,CAAC,KAAK;CAAI,EAAE,KAC3F,MAAO,CACH,EACI,cAAc,EAAQ,QAAQ,EAAS,IACvC,EAAO,IAAK,GAAU,CAAC,EAAO,CAAK,EAAG,OAAO,EAAM,EAAE,CAAC,CAC1D,EACA,EACI,UAAU,EAAsB,OAAO,EAAQ,IAC/C,EAAO,IAAK,GAAU,CAAC,EAAO,OAAO,EAAO,CAAK,EAAE,EAAE,CAAC,CAC1D,EACA,EAAM,UAAU,EAAsB,GAAI,CACtC,CAAC,eAAgB,OAAO,EACxB,CAAC,mBAAoB,mBAAmB,EACxC,CAAC,QAAS,qBAAqB,CACnC,CAAC,EACD,EAAM,cAAc,EAAK,aAAa,IAAI,EAAsB,GAAI,CAChE,CAAC,eAAgB,MAAM,CAC3B,CAAC,CACL,CAAC,CAAC,KAAK;;CAAM,CACjB"}

package/dist/theme/inverse-restore.js

@@ -0,0 +1,30 @@
+//#region src/theme/inverse-restore.ts
+var e = "[data-tempest-tone=\"default\"]", t = "[data-tempest-theme=\"dark\"]", n = {
+	selector: ":root",
+	darkSelector: t
+};
+function r(e) {
+	return e.replace("--tempest-", "--tempest-default-");
+}
+function i(n, i, a) {
+	let o = [.../* @__PURE__ */ new Set([
+		":root",
+		"[data-tempest-theme]",
+		a.selector,
+		a.darkSelector
+	])].filter((e) => e !== t).join(", "), s = (e, t) => `${e} {\n${t.map(([e, t]) => `    ${e}: ${t};`).join("\n")}\n}`;
+	return [
+		s(`:where(:is(${o}):not(${i}))`, n.map((e) => [r(e), `var(${e})`])),
+		s(`:where(${e}:not(${o}))`, n.map((e) => [e, `var(${r(e)})`])),
+		s(`:where(${e})`, [
+			["color-scheme", "light"],
+			["background-color", "var(--tempest-bg)"],
+			["color", "var(--tempest-text)"]
+		]),
+		s(`:where(:is(${a.darkSelector}) ${e})`, [["color-scheme", "dark"]])
+	].join("\n\n");
+}
+//#endregion
+export { n as DEFAULT_PAGE_SELECTORS, e as DEFAULT_TONE_SELECTOR, i as defaultToneRules };
+
+//# sourceMappingURL=inverse-restore.js.map

package/dist/theme/inverse-restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inverse-restore.js","names":[],"sources":["../../src/theme/inverse-restore.ts"],"sourcesContent":["/**\n * The default tone: a region inside an inverse surface that goes back to the\n * page's tokens — `data-tempest-tone=\"default\"`, or `<Section tone=\"default\">`.\n * A white form or price `Card` in a navy hero.\n *\n * Lives beside the generator, not in `inverse-render.ts`, so only an app that\n * imports `createInverseSurface` ships it: `createTheme` alone stays the size it\n * was.\n */\nimport type { PageSelectors } from \"./inverse-render\";\n\n/** Selector that hands a region inside an inverse surface back to the page's tokens. */\nexport const DEFAULT_TONE_SELECTOR = '[data-tempest-tone=\"default\"]';\n\n/** `createTheme`'s default `darkSelector`, already covered by `[data-tempest-theme]`. */\nconst DARK_SELECTOR = '[data-tempest-theme=\"dark\"]';\n\n/** Where `createTheme` writes the page's schemes when told nothing else. */\nexport const DEFAULT_PAGE_SELECTORS: PageSelectors = {\n    selector: \":root\",\n    darkSelector: DARK_SELECTOR,\n};\n\n/**\n * Name of the custom property that keeps the page's value of `token`.\n *\n * @param token - A `--tempest-*` token.\n * @returns The `--tempest-default-*` twin it is saved under.\n */\nfunction twinOf(token: string): string {\n    return token.replace(\"--tempest-\", \"--tempest-default-\");\n}\n\n/**\n * The rules that let a region inside an inverse surface go back to the page's\n * tokens, light or dark — whichever the page is on.\n *\n * Custom properties inherit from the parent, so a rule cannot \"skip\" the\n * inverse section and read `:root` again — and scoping the inverse block away\n * from the region (`@scope (…) to (…)`, `:not()`) changes nothing either, since\n * the region still inherits what its inverse parent declared. Measured in\n * Chromium on a `Card`, an `Input` and a `Button` inside the region, 25 of 28\n * computed values differed from the same trio on the page in light and 18 of 28\n * in dark, with or without `@scope`.\n *\n * What works is saving the page's values before the section overrides them.\n * Every element a theme is declared on (`:root`, `[data-tempest-theme]`, and the\n * theme's own selectors) copies each token the surface redefines into a\n * `--tempest-default-*` twin. `var()` in a custom property resolves on the\n * element that declares it, so the twin holds the page's value — the SDK's, a\n * theme's or the app's own `:root` override — and inherits through the section\n * untouched. The region reads its tokens back from the twins: 0 of 28 values\n * differ, in light, in dark and under a dark subtree.\n *\n * Two alternatives were measured and rejected. Writing the page's values out,\n * one block per scheme, is 1257 B brotli and restores the SDK's defaults rather\n * than the page: with a brand override on `:root`, 3 of 28 values came back\n * wrong. Adding the region to the selectors of `colors.css` costs 15 B brotli,\n * but charges every app and misses the same override.\n *\n * Everything sits under `:where()`, so a class the app puts on the same element\n * still wins. The anchors are left out of the region and the section out of the\n * anchors: a token and its twin declared on one element reference each other,\n * and both resolve to nothing.\n *\n * @param tokens - The tokens the surface redefines.\n * @param selector - Selector the inverse surface is written under.\n * @param page - Selectors the page's schemes are written under.\n * @returns The CSS text of the rules, in the order they must be written.\n */\nexport function defaultToneRules(\n    tokens: readonly string[],\n    selector: string,\n    page: PageSelectors,\n): string {\n    const anchors = [\n        ...new Set([\":root\", \"[data-tempest-theme]\", page.selector, page.darkSelector]),\n    ]\n        .filter((anchor) => anchor !== DARK_SELECTOR)\n        .join(\", \");\n    const block = (rule: string, declarations: readonly (readonly [string, string])[]): string =>\n        `${rule} {\\n${declarations.map(([name, value]) => `    ${name}: ${value};`).join(\"\\n\")}\\n}`;\n    return [\n        block(\n            `:where(:is(${anchors}):not(${selector}))`,\n            tokens.map((token) => [twinOf(token), `var(${token})`]),\n        ),\n        block(\n            `:where(${DEFAULT_TONE_SELECTOR}:not(${anchors}))`,\n            tokens.map((token) => [token, `var(${twinOf(token)})`]),\n        ),\n        block(`:where(${DEFAULT_TONE_SELECTOR})`, [\n            [\"color-scheme\", \"light\"],\n            [\"background-color\", \"var(--tempest-bg)\"],\n            [\"color\", \"var(--tempest-text)\"],\n        ]),\n        block(`:where(:is(${page.darkSelector}) ${DEFAULT_TONE_SELECTOR})`, [\n            [\"color-scheme\", \"dark\"],\n        ]),\n    ].join(\"\\n\\n\");\n}\n"],"mappings":";AAYA,IAAa,IAAwB,mCAG/B,IAAgB,iCAGT,IAAwC;CACjD,UAAU;CACV,cAAc;AAClB;AAQA,SAAS,EAAO,GAAuB;CACnC,OAAO,EAAM,QAAQ,cAAc,oBAAoB;AAC3D;AAuCA,SAAgB,EACZ,GACA,GACA,GACM;CACN,IAAM,IAAU,CACZ,mBAAG,IAAI,IAAI;EAAC;EAAS;EAAwB,EAAK;EAAU,EAAK;CAAY,CAAC,CAClF,CAAC,CACI,QAAQ,MAAW,MAAW,CAAa,CAAC,CAC5C,KAAK,IAAI,GACR,KAAS,GAAc,MACzB,GAAG,EAAK,MAAM,EAAa,KAAK,CAAC,GAAM,OAAW,OAAO,EAAK,IAAI,EAAM,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;CAC3F,OAAO;EACH,EACI,cAAc,EAAQ,QAAQ,EAAS,KACvC,EAAO,KAAK,MAAU,CAAC,EAAO,CAAK,GAAG,OAAO,EAAM,EAAE,CAAC,CAC1D;EACA,EACI,UAAU,EAAsB,OAAO,EAAQ,KAC/C,EAAO,KAAK,MAAU,CAAC,GAAO,OAAO,EAAO,CAAK,EAAE,EAAE,CAAC,CAC1D;EACA,EAAM,UAAU,EAAsB,IAAI;GACtC,CAAC,gBAAgB,OAAO;GACxB,CAAC,oBAAoB,mBAAmB;GACxC,CAAC,SAAS,qBAAqB;EACnC,CAAC;EACD,EAAM,cAAc,EAAK,aAAa,IAAI,EAAsB,IAAI,CAChE,CAAC,gBAAgB,MAAM,CAC3B,CAAC;CACL,CAAC,CAAC,KAAK,MAAM;AACjB"}

package/dist/theme/inverse-surface.cjs

@@ -0,0 +1,2 @@
+const e=require("./color.cjs"),t=require("./data-viz-ramps.cjs");require("./inverse-render.cjs");const n=require("./status-tokens.cjs"),r=require("./inverse-restore.cjs");var i=4.5,a=4.75,o=3,s=4.5,c=7,l=[500,600,400,700,300,800,200,900],u={dark:{surfaces:[.046,.094,.14],border:.155,borderStrong:.222},light:{surfaces:[.018,.037,.073],border:.073,borderStrong:.128}},d=.1,f={dark:`#ffffff`,light:`#101828`},p={success:`#16a34a`,warning:`#d97706`,danger:`#dc2626`,info:`#2563eb`},m={light:[`#2563eb`,`#16a34a`,`#f59e0b`,`#7c3aed`,`#ec4899`,`#06b6d4`,`#ea580c`,`#0f766e`],dark:[`#60a5fa`,`#4ade80`,`#fbbf24`,`#a78bfa`,`#f472b6`,`#22d3ee`,`#fb923c`,`#2dd4bf`]},h=[`comment`,`punctuation`,`string`,`number`,`keyword`,`literal`,`function`,`tag`,`attribute`,`property`],g={light:[`#5f666e`,`#5d6671`,`#327243`,`#9d5035`,`#625baf`,`#9f4c4f`,`#1a6c94`,`#974d72`,`#127171`,`#127171`],dark:[`#838b93`,`#818b95`,`#589866`,`#c57558`,`#8580d8`,`#c87172`,`#2893c6`,`#c07197`,`#349897`,`#349897`]},_={light:{xs:`0 1px 2px rgba(15, 23, 42, 0.04)`,sm:`0 1px 3px rgba(15, 23, 42, 0.08), 0 1px 2px rgba(15, 23, 42, 0.04)`,md:`0 4px 12px rgba(15, 23, 42, 0.08), 0 2px 4px rgba(15, 23, 42, 0.04)`,lg:`0 12px 32px rgba(15, 23, 42, 0.12), 0 4px 8px rgba(15, 23, 42, 0.06)`,xl:`0 24px 48px rgba(15, 23, 42, 0.18), 0 8px 16px rgba(15, 23, 42, 0.08)`,inner:`inset 0 2px 4px rgba(15, 23, 42, 0.06)`},dark:{xs:`0 1px 2px rgba(0, 0, 0, 0.3)`,sm:`0 1px 3px rgba(0, 0, 0, 0.4), 0 1px 2px rgba(0, 0, 0, 0.2)`,md:`0 4px 12px rgba(0, 0, 0, 0.4), 0 2px 4px rgba(0, 0, 0, 0.2)`,lg:`0 12px 32px rgba(0, 0, 0, 0.5), 0 4px 8px rgba(0, 0, 0, 0.3)`,xl:`0 24px 48px rgba(0, 0, 0, 0.6), 0 8px 16px rgba(0, 0, 0, 0.3)`,inner:`inset 0 2px 4px rgba(15, 23, 42, 0.06)`}},v=.005;function y(t,n,r,i=t.c){let a=Math.min(1,Math.max(0,t.l+n*r));return e.oklchToHex({l:a,c:i,h:t.h})}function b(t,n){return Math.min(...n.map(n=>e.contrastRatio(t,n)))}function x(t,n,r,i,a){let o=e.hexToOklch(t);for(let e=0;e<=1;e+=v){let t=y(o,n,e);if(b(t,r)>=i)return t;if(n===1&&o.l+e>=1||n===-1&&o.l-e<=0)break}return a}var S={dark:.07,light:.05},C=1.6;function w(e,t,n,r){for(let i=n;i>v;i-=v){let n=[y(e,t,i),y(e,t,i*C)];if(b(r,n)>=a)return n}return[y(e,t,-n),y(e,t,-n*C)]}function T(e,t,n){let r=e=>[1,3,5].map(t=>Number.parseInt(e.slice(t,t+2),16)),[i,a]=[r(e),r(t)];return`#${i.map((e,t)=>Math.round(e+(a[t]-e)*n)).map(e=>e.toString(16).padStart(2,`0`)).join(``)}`}function E(r,i){let c=e.readableForeground(r,f.dark,f.light),l=c===f.dark?`dark`:`light`,v=l===`dark`?1:-1,C=e.hexToOklch(r),E=u[l],D={},O=[r,...E.surfaces.map(e=>y(C,v,-e))],[k,A,j,M]=O,N=y(C,v,d),P=[...O,N];D[`--tempest-bg`]=k,D[`--tempest-surface`]=A,D[`--tempest-surface-2`]=j,D[`--tempest-surface-3`]=M,D[`--tempest-border`]=y(C,v,E.border),D[`--tempest-border-strong`]=y(C,v,E.borderStrong);let F=b(c,P),I=C.c*.4;D[`--tempest-text`]=c,D[`--tempest-text-muted`]=x(y(C,v,0,I),v,P,Math.max(a,Math.sqrt(F*a)),c),D[`--tempest-text-subtle`]=x(y(C,v,0,I),v,[k,A,N],a,c);let L={...e.hexToOklch(c),h:C.h};D[`--tempest-primary`]=c,D[`--tempest-primary-hover`]=y(L,v,-.05,C.c*.25),D[`--tempest-primary-active`]=y(L,v,-.1,C.c*.3),D[`--tempest-primary-foreground`]=r,D[`--tempest-text-on-primary`]=r;let[R,z]=w(C,v,S[l],c);D[`--tempest-primary-soft`]=R,D[`--tempest-primary-soft-hover`]=z,D[`--tempest-primary-on-soft`]=x(R,v,[R,z],a,c);let B=x(r,v,P,s,c);D[`--tempest-focus-ring-color`]=B,D[`--tempest-selected-indicator`]=B;let V=e.createColorScale(i.primary,l,{anchor:!1});for(let[e,t]of Object.entries(V))D[`--tempest-primary-${e}`]=t;for(let t of n.THEME_STATUSES){let r=e.createColorScale(i.statuses?.[t]??p[t],l);n.writeStatus(D,t,r,l),D[`--tempest-${t}`]=x(D[`--tempest-${t}`],v,P,a,c),t===`danger`&&(D[`--tempest-danger-hover`]=r[D[`--tempest-danger-on-solid`]===`#ffffff`?l===`dark`?400:700:l===`dark`?600:500])}(i.chart?.length?i.chart:m[l]).forEach((e,t)=>{D[`--tempest-chart-${t+1}`]=x(e,v,[k,A,N],o,c)});let H=t.hueOf(i.chart?.[0]??i.primary),U=i.statuses?.danger?t.hueOf(i.statuses.danger):(H+180)%360;t.buildRamp(H,l).forEach((e,t)=>{D[`--tempest-chart-sequential-${t+1}`]=e});let W=t.buildDivergingRamp({coolHue:H,warmHue:U,mid:M,mode:l});[...W.cool,W.mid,...W.warm].forEach((e,t)=>{D[`--tempest-chart-diverging-${t+1}`]=e}),D[`--tempest-chart-grid`]=D[`--tempest-border`],D[`--tempest-chart-axis`]=D[`--tempest-text-subtle`];let G=[k,A,T(A,c,.1)];h.forEach((e,t)=>{D[`--tempest-code-${e}`]=x(g[l][t],v,G,a,c)});for(let[e,t]of Object.entries(_[l]))D[`--tempest-shadow-${e}`]=t;return{tokens:D,scheme:l,glow:N}}function D(e,t){let n=t=>e[t],r=[n(`--tempest-bg`),n(`--tempest-surface`),n(`--tempest-surface-2`),n(`--tempest-surface-3`)],a=n(`--tempest-primary-foreground`),s=[b(n(`--tempest-text`),[...r,t])/c,b(n(`--tempest-text-muted`),[...r,t])/i,b(n(`--tempest-text-subtle`),[...r.slice(0,2),t])/i,b(n(`--tempest-focus-ring-color`),[...r,t])/o,b(a,[n(`--tempest-primary`),n(`--tempest-primary-hover`),n(`--tempest-primary-active`)])/i];return Math.min(...s)-1}function O(t){let n=e.createColorScale(t.primary,`light`),i=null,a=-1/0;for(let e of l){let r=E(n[e],t),o=D(r.tokens,r.glow);if(o>a&&(i={tokens:r.tokens,scheme:r.scheme,step:e},a=o),o>=0)break}let o=i;return o.rules=r.defaultToneRules(Object.keys(o.tokens),t.selector??`[data-tempest-tone="inverse"]`,t.page??r.DEFAULT_PAGE_SELECTORS),o}exports.DEFAULT_CHART_COLORS=m,exports.DEFAULT_CODE_COLORS=g,exports.DEFAULT_STATUS_COLORS=p,exports.createInverseSurface=O;
+//# sourceMappingURL=inverse-surface.cjs.map

package/dist/theme/inverse-surface.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inverse-surface.cjs","names":[],"sources":["../../src/theme/inverse-surface.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — the inverse surface is a whole scheme: surfaces,\n * text, the action color, focus, selection, statuses, charts and syntax colors,\n * each derived and then measured against the brand fill it sits on. Splitting\n * the derivation from the table it is measured against is how the two drift.\n */\n/**\n * Inverse surface: the token set for a section painted in the brand color —\n * a hero, a call-to-action band, a footer — so the components inside it invert\n * instead of inheriting the page's tokens.\n *\n * Every value is derived from the brand and measured against the fill it will\n * sit on, the same way {@link createTheme} measures the page schemes. Overriding\n * eight tokens by hand (what #409 had to do) leaves the rest of the scheme on\n * the page's values: measured over a navy `#1e2a5a`, the inherited\n * `--tempest-text-subtle` lands at 2.75:1, `--tempest-danger` at 2.12:1, the\n * selected indicator at 2.01:1, and a `Card` puts white text on\n * `--tempest-surface` at 1.05:1.\n */\nimport {\n    contrastRatio,\n    createColorScale,\n    hexToOklch,\n    oklchToHex,\n    readableForeground,\n    type ColorScale,\n    type Oklch,\n    type ScaleStep,\n} from \"./color\";\nimport { buildDivergingRamp, buildRamp, hueOf } from \"./data-viz-ramps\";\nimport {\n    INVERSE_SELECTOR,\n    type InverseScheme,\n    type InverseSurface,\n    type InverseSurfaceOptions,\n} from \"./inverse-render\";\nimport { DEFAULT_PAGE_SELECTORS, defaultToneRules } from \"./inverse-restore\";\nimport { THEME_STATUSES, writeStatus, type ThemeStatus } from \"./status-tokens\";\n\nexport { INVERSE_SELECTOR, renderInverseSurface } from \"./inverse-render\";\nexport { DEFAULT_TONE_SELECTOR } from \"./inverse-restore\";\nexport type {\n    InverseScheme,\n    InverseSurface,\n    InverseSurfaceGenerator,\n    InverseSurfaceOptions,\n    PageSelectors,\n} from \"./inverse-render\";\n\n/** WCAG 2.x AA floor for body text. */\nconst AA_TEXT = 4.5;\n\n/**\n * What text is fitted to, rather than the floor itself.\n *\n * The margin the SDK's dark theme keeps on `--tempest-text-subtle` (4.79 over its\n * surface): a value solved to exactly 4.5 turns the next rounding into a failure.\n */\nconst TEXT_TARGET = 4.75;\n\n/** WCAG 2.2 SC 1.4.11 floor for a non-text indicator. */\nconst INDICATOR_FLOOR = 3;\n\n/**\n * What the focus ring and the selected indicator are fitted to.\n *\n * Well above the 3:1 floor on purpose: the SDK's own rings keep 5.40:1 (dark)\n * and 5.50:1 (light) worst case, because a ring travels onto surfaces nobody\n * validated it against.\n */\nconst RING_TARGET = 4.5;\n\n/**\n * The smallest contrast the ink must keep — on the fill, the surfaces and the\n * glow — before the fill is accepted.\n *\n * AA (4.5) is not enough here, because the surface has three text levels — text,\n * muted and subtle — and all three must clear AA. With text at 4.83:1 (white on\n * the default `#0066ff`) the three collapse into one color. 7:1 (AAA) leaves room\n * for muted to sit visibly between text and subtle.\n */\nconst MIN_TEXT_RATIO = 7;\n\n/**\n * Fill candidates, nearest the brand first, darker before lighter on a tie.\n *\n * `500` is the brand itself and wins whenever it can carry the scheme. When it\n * cannot — a mid-tone brand such as `#0066ff`, where white measures 4.83:1 —\n * the walk moves one step at a time, so the section stays as close to the brand\n * as the measurement allows.\n *\n * Measuring the glow is what most of the walking pays for: against the flat\n * fill and the surfaces alone, 9 of the 14 test brands keep their `500`; with\n * the glow, 6 do. The three that move (`#8100D7`, `#22d3ee`, `#14b8a6`) are the\n * ones whose subtle text would fail on a lifted region of their own band.\n */\nconst FILL_CANDIDATES: readonly ScaleStep[] = [500, 600, 400, 700, 300, 800, 200, 900];\n\n/**\n * Lightness offsets from the fill, per scheme.\n *\n * The sizes are the SDK's own, measured in OKLCH: the dark theme's surfaces sit\n * 0.046, 0.094 and 0.140 from `#0b0d12`, its borders 0.155 and 0.222; the light\n * theme's surfaces sit 0.018, 0.037 and 0.073 from white, its borders 0.073 and\n * 0.128.\n *\n * The direction is not the SDK's. On the page, raised surfaces move toward the\n * ink, which costs nothing there: the page fill is near-white or near-black, so\n * the ink keeps 13:1 or more on the third surface. A brand fill sits mid-axis,\n * and moving toward the ink spends exactly the contrast the text needs. Measured\n * across the fourteen brands of the contrast test, every text level held to AA\n * on every surface and on the glow ({@link GLOW_OFFSET}):\n *\n * | surfaces move | brands keeping their own `500` | where `#8100D7` / `#4f46e5` land |\n * | --- | --- | --- |\n * | toward the ink | 6 of 14 | `800` / `800` |\n * | away from the ink | 6 of 14 | `700` / `700` |\n *\n * Never worse and one step nearer the brand for the purples, and with every\n * surface carrying the ink at least as well as the fill does.\n *\n * So surfaces move away from the ink — a card in a navy band is a deeper navy,\n * one in a yellow band a paler yellow — and every surface then carries the ink\n * at least as well as the fill does. Borders still move toward the ink, since a\n * border has to separate from the fill and the surfaces alike.\n */\nconst OFFSETS: Record<\n    InverseScheme,\n    { surfaces: readonly [number, number, number]; border: number; borderStrong: number }\n> = {\n    dark: { surfaces: [0.046, 0.094, 0.14], border: 0.155, borderStrong: 0.222 },\n    light: { surfaces: [0.018, 0.037, 0.073], border: 0.073, borderStrong: 0.128 },\n};\n\n/**\n * How far toward the ink a region of the band may lift and still be measured.\n *\n * A brand section is rarely one flat color: the landing that opened #409 lays a\n * radial glow of `#1f3f8f` at 55% over its navy `#03184b`, which lifts the\n * ground by 0.09 in OKLCH lightness, and a hover tint does the same. Text fitted\n * to the flat fill alone failed there — subtle measured 3.64:1 on that glow. So\n * every text and indicator token is also fitted against the fill lifted by this\n * much; darker variations (the landing's `#020f30` footer) only add contrast.\n */\nconst GLOW_OFFSET = 0.1;\n\n/** Text ink per scheme — the SDK's own extremes. */\nconst INK: Record<InverseScheme, string> = { dark: \"#ffffff\", light: \"#101828\" };\n\n/**\n * The SDK's default status colors, used when a theme names none.\n *\n * Ported from `src/styles/colors.css` (`--tempest-*-solid` in the light block),\n * and pinned by a test that reads that file.\n */\nexport const DEFAULT_STATUS_COLORS: Record<ThemeStatus, string> = {\n    success: \"#16a34a\",\n    warning: \"#d97706\",\n    danger: \"#dc2626\",\n    info: \"#2563eb\",\n};\n\n/**\n * The SDK's categorical chart colors, per scheme.\n *\n * Ported from `src/styles/colors.css` (`--tempest-chart-1` … `-8`), pinned by a\n * test that reads that file. Used as the starting hue for each slot, then fitted\n * to the inverse fill.\n */\nexport const DEFAULT_CHART_COLORS: Record<InverseScheme, readonly string[]> = {\n    light: [\"#2563eb\", \"#16a34a\", \"#f59e0b\", \"#7c3aed\", \"#ec4899\", \"#06b6d4\", \"#ea580c\", \"#0f766e\"],\n    dark: [\"#60a5fa\", \"#4ade80\", \"#fbbf24\", \"#a78bfa\", \"#f472b6\", \"#22d3ee\", \"#fb923c\", \"#2dd4bf\"],\n};\n\n/** Names of the `CodeBlock` syntax tokens, in `colors.css` order. */\nconst CODE_TOKENS = [\n    \"comment\",\n    \"punctuation\",\n    \"string\",\n    \"number\",\n    \"keyword\",\n    \"literal\",\n    \"function\",\n    \"tag\",\n    \"attribute\",\n    \"property\",\n] as const;\n\n/**\n * The SDK's syntax colors, per scheme, in {@link CODE_TOKENS} order.\n *\n * Ported from `src/styles/colors.css` (`--tempest-code-*`), pinned by a test\n * that reads that file. Used as the starting hue, then fitted to the inverse\n * code grounds.\n */\nexport const DEFAULT_CODE_COLORS: Record<InverseScheme, readonly string[]> = {\n    light: [\n        \"#5f666e\",\n        \"#5d6671\",\n        \"#327243\",\n        \"#9d5035\",\n        \"#625baf\",\n        \"#9f4c4f\",\n        \"#1a6c94\",\n        \"#974d72\",\n        \"#127171\",\n        \"#127171\",\n    ],\n    dark: [\n        \"#838b93\",\n        \"#818b95\",\n        \"#589866\",\n        \"#c57558\",\n        \"#8580d8\",\n        \"#c87172\",\n        \"#2893c6\",\n        \"#c07197\",\n        \"#349897\",\n        \"#349897\",\n    ],\n};\n\n/**\n * The SDK's elevation shadows, per scheme.\n *\n * Ported from `src/styles/colors.css` (`--tempest-shadow-*`). A light-ink fill\n * takes the dark theme's heavier shadows, since a faint shadow vanishes on it.\n * The dark block does not override `--tempest-shadow-inner`, so the dark row\n * carries the light value it inherits.\n */\nconst SHADOWS: Record<InverseScheme, Record<string, string>> = {\n    light: {\n        xs: \"0 1px 2px rgba(15, 23, 42, 0.04)\",\n        sm: \"0 1px 3px rgba(15, 23, 42, 0.08), 0 1px 2px rgba(15, 23, 42, 0.04)\",\n        md: \"0 4px 12px rgba(15, 23, 42, 0.08), 0 2px 4px rgba(15, 23, 42, 0.04)\",\n        lg: \"0 12px 32px rgba(15, 23, 42, 0.12), 0 4px 8px rgba(15, 23, 42, 0.06)\",\n        xl: \"0 24px 48px rgba(15, 23, 42, 0.18), 0 8px 16px rgba(15, 23, 42, 0.08)\",\n        inner: \"inset 0 2px 4px rgba(15, 23, 42, 0.06)\",\n    },\n    dark: {\n        xs: \"0 1px 2px rgba(0, 0, 0, 0.3)\",\n        sm: \"0 1px 3px rgba(0, 0, 0, 0.4), 0 1px 2px rgba(0, 0, 0, 0.2)\",\n        md: \"0 4px 12px rgba(0, 0, 0, 0.4), 0 2px 4px rgba(0, 0, 0, 0.2)\",\n        lg: \"0 12px 32px rgba(0, 0, 0, 0.5), 0 4px 8px rgba(0, 0, 0, 0.3)\",\n        xl: \"0 24px 48px rgba(0, 0, 0, 0.6), 0 8px 16px rgba(0, 0, 0, 0.3)\",\n        inner: \"inset 0 2px 4px rgba(15, 23, 42, 0.06)\",\n    },\n};\n\n/** Lightness step used when fitting a color toward the ink. */\nconst FIT_STEP = 0.005;\n\n/**\n * Move a color along the lightness axis toward (positive `delta`) or away from\n * the ink, keeping its hue.\n *\n * @param base - The color to move, in OKLCH.\n * @param direction - `1` when the ink is lighter than the fill, `-1` otherwise.\n * @param delta - How far to move, in OKLCH lightness.\n * @param chroma - Chroma of the result; defaults to the base's.\n * @returns The moved color as hex, gamut-mapped.\n */\nfunction shift(base: Oklch, direction: 1 | -1, delta: number, chroma: number = base.c): string {\n    const l = Math.min(1, Math.max(0, base.l + direction * delta));\n    return oklchToHex({ l, c: chroma, h: base.h });\n}\n\n/** Weakest contrast of `color` against every ground. */\nfunction worst(color: string, grounds: readonly string[]): number {\n    return Math.min(...grounds.map((ground) => contrastRatio(color, ground)));\n}\n\n/**\n * Walk a color toward the ink until it clears `floor` against every ground.\n *\n * Hue and chroma are kept, so a danger stays red and a keyword stays violet;\n * only lightness moves, and only as far as the measurement asks. When the walk\n * reaches the end of the lightness axis without clearing, the ink itself is\n * returned — it is the most contrasting color the scheme has.\n *\n * @param start - Where to start, as hex.\n * @param direction - `1` when the ink is lighter than the grounds, `-1` otherwise.\n * @param grounds - Every background the color will sit on.\n * @param floor - The ratio to clear against all of them.\n * @param ink - Fallback when nothing on the walk clears.\n * @returns The first color on the walk that clears, else `ink`.\n */\nfunction fitToward(\n    start: string,\n    direction: 1 | -1,\n    grounds: readonly string[],\n    floor: number,\n    ink: string,\n): string {\n    const base = hexToOklch(start);\n    for (let delta = 0; delta <= 1; delta += FIT_STEP) {\n        const candidate = shift(base, direction, delta);\n        if (worst(candidate, grounds) >= floor) return candidate;\n        if ((direction === 1 && base.l + delta >= 1) || (direction === -1 && base.l - delta <= 0)) {\n            break;\n        }\n    }\n    return ink;\n}\n\n/**\n * How far the soft tint sits from the fill, per scheme; the hover tint sits\n * {@link SOFT_HOVER_FACTOR} times as far.\n */\nconst SOFT_OFFSET: Record<InverseScheme, number> = { dark: 0.07, light: 0.05 };\n\n/** Distance of the soft hover tint, relative to the soft tint's. */\nconst SOFT_HOVER_FACTOR = 1.6;\n\n/**\n * The soft tint and its hover, lifted toward the ink only as far as the ink\n * still reads on both.\n *\n * A tint toward the ink is what reads as \"highlighted\" on a fill, and it is also\n * what eats the ink's contrast: on the `#8100D7` fill, the full offset left white\n * at 4.42:1 on the hover tint. So the offset shrinks until the ink clears\n * {@link TEXT_TARGET} on both, and when even a sliver cannot — the fill gives the\n * ink no room — the tints move away from the ink instead, like the surfaces.\n *\n * @param base - The fill, in OKLCH.\n * @param direction - `1` when the ink is lighter than the fill, `-1` otherwise.\n * @param offset - The preferred distance of the soft tint.\n * @param ink - The scheme's text ink.\n * @returns The soft tint and its hover, as hex.\n */\nfunction softTints(base: Oklch, direction: 1 | -1, offset: number, ink: string): [string, string] {\n    for (let delta = offset; delta > FIT_STEP; delta -= FIT_STEP) {\n        const tints: [string, string] = [\n            shift(base, direction, delta),\n            shift(base, direction, delta * SOFT_HOVER_FACTOR),\n        ];\n        if (worst(ink, tints) >= TEXT_TARGET) return tints;\n    }\n    return [shift(base, direction, -offset), shift(base, direction, -offset * SOFT_HOVER_FACTOR)];\n}\n\n/** Mix `top` over `bottom` at `amount`, the way `color-mix(in srgb, …)` composites. */\nfunction mix(bottom: string, top: string, amount: number): string {\n    const parse = (hex: string): number[] =>\n        [1, 3, 5].map((index) => Number.parseInt(hex.slice(index, index + 2), 16));\n    const [a, b] = [parse(bottom), parse(top)];\n    const channels = a.map((channel, index) =>\n        Math.round(channel + ((b[index] as number) - channel) * amount),\n    );\n    return `#${channels.map((channel) => channel.toString(16).padStart(2, \"0\")).join(\"\")}`;\n}\n\n/**\n * Derive the inverse scheme over one candidate fill.\n *\n * Text is three levels, like the page: the ink, then `muted` fitted to the\n * geometric mean of the ink's contrast and {@link TEXT_TARGET} (so it sits\n * visibly between the two), then `subtle` fitted to {@link TEXT_TARGET} on\n * `bg` and `surface` — the same pairs the SDK holds its own `text-subtle` to.\n *\n * The action color is the ink itself: a white button on a navy band, labelled in\n * the fill. Hover and active step back toward the fill, because the ink is\n * already the end of the axis and has nowhere further to go.\n *\n * `--tempest-danger-hover` steps toward the side that keeps `-on-solid`\n * readable: darker when the ink is white, lighter when it is dark. A fixed\n * direction cannot hold one ink over both fills — over the dark scheme's\n * `#dc2626` it measured 4.00:1 with the lighter hover.\n *\n * The ramp (`--tempest-primary-50` … `-900`) is emitted too, because `Tag` and\n * `Sidebar` pair raw steps (`100` under `700`). It is the scheme's unanchored\n * ramp, so that pair keeps the shape it has on the page.\n *\n * @param fill - The fill, as hex.\n * @param options - The brand description.\n * @returns The token map and the scheme it reads as.\n */\nfunction deriveOver(\n    fill: string,\n    options: InverseSurfaceOptions,\n): { tokens: Record<string, string>; scheme: InverseScheme; glow: string } {\n    const ink = readableForeground(fill, INK.dark, INK.light);\n    const scheme: InverseScheme = ink === INK.dark ? \"dark\" : \"light\";\n    const direction: 1 | -1 = scheme === \"dark\" ? 1 : -1;\n    const base = hexToOklch(fill);\n    const offsets = OFFSETS[scheme];\n    const tokens: Record<string, string> = {};\n\n    const surfaces = [fill, ...offsets.surfaces.map((delta) => shift(base, direction, -delta))];\n    const [bg, surface, surface2, surface3] = surfaces as [string, string, string, string];\n    const glow = shift(base, direction, GLOW_OFFSET);\n    const grounds = [...surfaces, glow];\n    tokens[\"--tempest-bg\"] = bg;\n    tokens[\"--tempest-surface\"] = surface;\n    tokens[\"--tempest-surface-2\"] = surface2;\n    tokens[\"--tempest-surface-3\"] = surface3;\n    tokens[\"--tempest-border\"] = shift(base, direction, offsets.border);\n    tokens[\"--tempest-border-strong\"] = shift(base, direction, offsets.borderStrong);\n\n    const textWorst = worst(ink, grounds);\n    const tint = base.c * 0.4;\n    tokens[\"--tempest-text\"] = ink;\n    tokens[\"--tempest-text-muted\"] = fitToward(\n        shift(base, direction, 0, tint),\n        direction,\n        grounds,\n        Math.max(TEXT_TARGET, Math.sqrt(textWorst * TEXT_TARGET)),\n        ink,\n    );\n    tokens[\"--tempest-text-subtle\"] = fitToward(\n        shift(base, direction, 0, tint),\n        direction,\n        [bg, surface, glow],\n        TEXT_TARGET,\n        ink,\n    );\n\n    const inkBase: Oklch = { ...hexToOklch(ink), h: base.h };\n    tokens[\"--tempest-primary\"] = ink;\n    tokens[\"--tempest-primary-hover\"] = shift(inkBase, direction, -0.05, base.c * 0.25);\n    tokens[\"--tempest-primary-active\"] = shift(inkBase, direction, -0.1, base.c * 0.3);\n    tokens[\"--tempest-primary-foreground\"] = fill;\n    tokens[\"--tempest-text-on-primary\"] = fill;\n\n    const [soft, softHover] = softTints(base, direction, SOFT_OFFSET[scheme], ink);\n    tokens[\"--tempest-primary-soft\"] = soft;\n    tokens[\"--tempest-primary-soft-hover\"] = softHover;\n    tokens[\"--tempest-primary-on-soft\"] = fitToward(\n        soft,\n        direction,\n        [soft, softHover],\n        TEXT_TARGET,\n        ink,\n    );\n\n    const ring = fitToward(fill, direction, grounds, RING_TARGET, ink);\n    tokens[\"--tempest-focus-ring-color\"] = ring;\n    tokens[\"--tempest-selected-indicator\"] = ring;\n\n    const ramp: ColorScale = createColorScale(options.primary, scheme, { anchor: false });\n    for (const [step, value] of Object.entries(ramp)) {\n        tokens[`--tempest-primary-${step}`] = value;\n    }\n\n    for (const status of THEME_STATUSES) {\n        const scale = createColorScale(\n            options.statuses?.[status] ?? DEFAULT_STATUS_COLORS[status],\n            scheme,\n        );\n        writeStatus(tokens, status, scale, scheme);\n        tokens[`--tempest-${status}`] = fitToward(\n            tokens[`--tempest-${status}`] as string,\n            direction,\n            grounds,\n            TEXT_TARGET,\n            ink,\n        );\n        if (status === \"danger\") {\n            const whiteInk = tokens[\"--tempest-danger-on-solid\"] === \"#ffffff\";\n            const darker: ScaleStep = scheme === \"dark\" ? 400 : 700;\n            const lighter: ScaleStep = scheme === \"dark\" ? 600 : 500;\n            tokens[\"--tempest-danger-hover\"] = scale[whiteInk ? darker : lighter];\n        }\n    }\n\n    const chart = options.chart?.length ? options.chart : DEFAULT_CHART_COLORS[scheme];\n    chart.forEach((color, index) => {\n        tokens[`--tempest-chart-${index + 1}`] = fitToward(\n            color,\n            direction,\n            [bg, surface, glow],\n            INDICATOR_FLOOR,\n            ink,\n        );\n    });\n    const coolHue = hueOf(options.chart?.[0] ?? options.primary);\n    const warmHue = options.statuses?.danger\n        ? hueOf(options.statuses.danger)\n        : (coolHue + 180) % 360;\n    buildRamp(coolHue, scheme).forEach((value, index) => {\n        tokens[`--tempest-chart-sequential-${index + 1}`] = value;\n    });\n    const diverging = buildDivergingRamp({ coolHue, warmHue, mid: surface3, mode: scheme });\n    [...diverging.cool, diverging.mid, ...diverging.warm].forEach((value, index) => {\n        tokens[`--tempest-chart-diverging-${index + 1}`] = value;\n    });\n    tokens[\"--tempest-chart-grid\"] = tokens[\"--tempest-border\"] as string;\n    tokens[\"--tempest-chart-axis\"] = tokens[\"--tempest-text-subtle\"] as string;\n\n    const codeGrounds = [bg, surface, mix(surface, ink, 0.1)];\n    CODE_TOKENS.forEach((name, index) => {\n        tokens[`--tempest-code-${name}`] = fitToward(\n            DEFAULT_CODE_COLORS[scheme][index] as string,\n            direction,\n            codeGrounds,\n            TEXT_TARGET,\n            ink,\n        );\n    });\n\n    for (const [name, value] of Object.entries(SHADOWS[scheme])) {\n        tokens[`--tempest-shadow-${name}`] = value;\n    }\n\n    return { tokens, scheme, glow };\n}\n\n/**\n * The gates a candidate fill must clear before it is accepted.\n *\n * Text reaches {@link MIN_TEXT_RATIO} on every surface, every fitted text token\n * clears AA where it is used, the ring clears 3:1 on every surface, and the\n * action label clears AA on all three button states.\n *\n * @param tokens - A derived token map.\n * @param glow - The fill lifted by {@link GLOW_OFFSET}, measured alongside the surfaces.\n * @returns The weakest margin over its floor across all gates; `>= 0` passes.\n */\nfunction margin(tokens: Record<string, string>, glow: string): number {\n    const read = (name: string): string => tokens[name] as string;\n    const surfaces = [\n        read(\"--tempest-bg\"),\n        read(\"--tempest-surface\"),\n        read(\"--tempest-surface-2\"),\n        read(\"--tempest-surface-3\"),\n    ];\n    const label = read(\"--tempest-primary-foreground\");\n    const checks: number[] = [\n        worst(read(\"--tempest-text\"), [...surfaces, glow]) / MIN_TEXT_RATIO,\n        worst(read(\"--tempest-text-muted\"), [...surfaces, glow]) / AA_TEXT,\n        worst(read(\"--tempest-text-subtle\"), [...surfaces.slice(0, 2), glow]) / AA_TEXT,\n        worst(read(\"--tempest-focus-ring-color\"), [...surfaces, glow]) / INDICATOR_FLOOR,\n        worst(label, [\n            read(\"--tempest-primary\"),\n            read(\"--tempest-primary-hover\"),\n            read(\"--tempest-primary-active\"),\n        ]) / AA_TEXT,\n    ];\n    return Math.min(...checks) - 1;\n}\n\n/**\n * Build the inverse surface for a brand.\n *\n * The fill is the brand's own `500` whenever it can carry the scheme, and\n * otherwise the nearest ramp step that can (see {@link FILL_CANDIDATES}). Whether\n * the surface reads light-on-dark or dark-on-light follows the fill, so a yellow\n * brand gets dark ink and a navy one white — the same pick `createTheme` makes\n * for `--tempest-primary-foreground`.\n *\n * The values are literal colors, not references to the page's ramp, so the\n * section paints the same in the light and the dark page scheme: the brand is\n * the brand in both.\n *\n * The result also carries the rules that let a region inside the surface go\n * back to the page's tokens (`data-tempest-tone=\"default\"`), written for the\n * selectors in `options`.\n *\n * @param options - The brand, plus the status and chart colors the theme names\n *   and the selectors the surface and the page are written under.\n * @returns The token map, the scheme it reads as, the fill step used and the\n *   default-tone rules.\n */\nexport function createInverseSurface(options: InverseSurfaceOptions): InverseSurface {\n    const ramp = createColorScale(options.primary, \"light\");\n    let best: InverseSurface | null = null;\n    let bestMargin = Number.NEGATIVE_INFINITY;\n    for (const step of FILL_CANDIDATES) {\n        const derived = deriveOver(ramp[step], options);\n        const measured = margin(derived.tokens, derived.glow);\n        if (measured > bestMargin) {\n            best = { tokens: derived.tokens, scheme: derived.scheme, step };\n            bestMargin = measured;\n        }\n        if (measured >= 0) break;\n    }\n    const surface = best as InverseSurface;\n    surface.rules = defaultToneRules(\n        Object.keys(surface.tokens),\n        options.selector ?? INVERSE_SELECTOR,\n        options.page ?? DEFAULT_PAGE_SELECTORS,\n    );\n    return surface;\n}\n"],"mappings":"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"}

package/dist/theme/inverse-surface.js

@@ -0,0 +1,255 @@
+import { contrastRatio as e, createColorScale as t, hexToOklch as n, oklchToHex as r, readableForeground as i } from "./color.js";
+import { buildDivergingRamp as a, buildRamp as o, hueOf as s } from "./data-viz-ramps.js";
+import "./inverse-render.js";
+import { THEME_STATUSES as c, writeStatus as l } from "./status-tokens.js";
+import { DEFAULT_PAGE_SELECTORS as u, defaultToneRules as d } from "./inverse-restore.js";
+//#region src/theme/inverse-surface.ts
+var f = 4.5, p = 4.75, m = 3, h = 4.5, g = 7, _ = [
+	500,
+	600,
+	400,
+	700,
+	300,
+	800,
+	200,
+	900
+], v = {
+	dark: {
+		surfaces: [
+			.046,
+			.094,
+			.14
+		],
+		border: .155,
+		borderStrong: .222
+	},
+	light: {
+		surfaces: [
+			.018,
+			.037,
+			.073
+		],
+		border: .073,
+		borderStrong: .128
+	}
+}, y = .1, b = {
+	dark: "#ffffff",
+	light: "#101828"
+}, x = {
+	success: "#16a34a",
+	warning: "#d97706",
+	danger: "#dc2626",
+	info: "#2563eb"
+}, S = {
+	light: [
+		"#2563eb",
+		"#16a34a",
+		"#f59e0b",
+		"#7c3aed",
+		"#ec4899",
+		"#06b6d4",
+		"#ea580c",
+		"#0f766e"
+	],
+	dark: [
+		"#60a5fa",
+		"#4ade80",
+		"#fbbf24",
+		"#a78bfa",
+		"#f472b6",
+		"#22d3ee",
+		"#fb923c",
+		"#2dd4bf"
+	]
+}, C = [
+	"comment",
+	"punctuation",
+	"string",
+	"number",
+	"keyword",
+	"literal",
+	"function",
+	"tag",
+	"attribute",
+	"property"
+], w = {
+	light: [
+		"#5f666e",
+		"#5d6671",
+		"#327243",
+		"#9d5035",
+		"#625baf",
+		"#9f4c4f",
+		"#1a6c94",
+		"#974d72",
+		"#127171",
+		"#127171"
+	],
+	dark: [
+		"#838b93",
+		"#818b95",
+		"#589866",
+		"#c57558",
+		"#8580d8",
+		"#c87172",
+		"#2893c6",
+		"#c07197",
+		"#349897",
+		"#349897"
+	]
+}, T = {
+	light: {
+		xs: "0 1px 2px rgba(15, 23, 42, 0.04)",
+		sm: "0 1px 3px rgba(15, 23, 42, 0.08), 0 1px 2px rgba(15, 23, 42, 0.04)",
+		md: "0 4px 12px rgba(15, 23, 42, 0.08), 0 2px 4px rgba(15, 23, 42, 0.04)",
+		lg: "0 12px 32px rgba(15, 23, 42, 0.12), 0 4px 8px rgba(15, 23, 42, 0.06)",
+		xl: "0 24px 48px rgba(15, 23, 42, 0.18), 0 8px 16px rgba(15, 23, 42, 0.08)",
+		inner: "inset 0 2px 4px rgba(15, 23, 42, 0.06)"
+	},
+	dark: {
+		xs: "0 1px 2px rgba(0, 0, 0, 0.3)",
+		sm: "0 1px 3px rgba(0, 0, 0, 0.4), 0 1px 2px rgba(0, 0, 0, 0.2)",
+		md: "0 4px 12px rgba(0, 0, 0, 0.4), 0 2px 4px rgba(0, 0, 0, 0.2)",
+		lg: "0 12px 32px rgba(0, 0, 0, 0.5), 0 4px 8px rgba(0, 0, 0, 0.3)",
+		xl: "0 24px 48px rgba(0, 0, 0, 0.6), 0 8px 16px rgba(0, 0, 0, 0.3)",
+		inner: "inset 0 2px 4px rgba(15, 23, 42, 0.06)"
+	}
+}, E = .005;
+function D(e, t, n, i = e.c) {
+	let a = Math.min(1, Math.max(0, e.l + t * n));
+	return r({
+		l: a,
+		c: i,
+		h: e.h
+	});
+}
+function O(t, n) {
+	return Math.min(...n.map((n) => e(t, n)));
+}
+function k(e, t, r, i, a) {
+	let o = n(e);
+	for (let e = 0; e <= 1; e += E) {
+		let n = D(o, t, e);
+		if (O(n, r) >= i) return n;
+		if (t === 1 && o.l + e >= 1 || t === -1 && o.l - e <= 0) break;
+	}
+	return a;
+}
+var A = {
+	dark: .07,
+	light: .05
+}, j = 1.6;
+function M(e, t, n, r) {
+	for (let i = n; i > E; i -= E) {
+		let n = [D(e, t, i), D(e, t, i * j)];
+		if (O(r, n) >= p) return n;
+	}
+	return [D(e, t, -n), D(e, t, -n * j)];
+}
+function N(e, t, n) {
+	let r = (e) => [
+		1,
+		3,
+		5
+	].map((t) => Number.parseInt(e.slice(t, t + 2), 16)), [i, a] = [r(e), r(t)];
+	return `#${i.map((e, t) => Math.round(e + (a[t] - e) * n)).map((e) => e.toString(16).padStart(2, "0")).join("")}`;
+}
+function P(e, r) {
+	let u = i(e, b.dark, b.light), d = u === b.dark ? "dark" : "light", f = d === "dark" ? 1 : -1, g = n(e), _ = v[d], E = {}, j = [e, ..._.surfaces.map((e) => D(g, f, -e))], [P, F, I, L] = j, R = D(g, f, y), z = [...j, R];
+	E["--tempest-bg"] = P, E["--tempest-surface"] = F, E["--tempest-surface-2"] = I, E["--tempest-surface-3"] = L, E["--tempest-border"] = D(g, f, _.border), E["--tempest-border-strong"] = D(g, f, _.borderStrong);
+	let B = O(u, z), V = g.c * .4;
+	E["--tempest-text"] = u, E["--tempest-text-muted"] = k(D(g, f, 0, V), f, z, Math.max(p, Math.sqrt(B * p)), u), E["--tempest-text-subtle"] = k(D(g, f, 0, V), f, [
+		P,
+		F,
+		R
+	], p, u);
+	let H = {
+		...n(u),
+		h: g.h
+	};
+	E["--tempest-primary"] = u, E["--tempest-primary-hover"] = D(H, f, -.05, g.c * .25), E["--tempest-primary-active"] = D(H, f, -.1, g.c * .3), E["--tempest-primary-foreground"] = e, E["--tempest-text-on-primary"] = e;
+	let [U, W] = M(g, f, A[d], u);
+	E["--tempest-primary-soft"] = U, E["--tempest-primary-soft-hover"] = W, E["--tempest-primary-on-soft"] = k(U, f, [U, W], p, u);
+	let G = k(e, f, z, h, u);
+	E["--tempest-focus-ring-color"] = G, E["--tempest-selected-indicator"] = G;
+	let K = t(r.primary, d, { anchor: !1 });
+	for (let [e, t] of Object.entries(K)) E[`--tempest-primary-${e}`] = t;
+	for (let e of c) {
+		let n = t(r.statuses?.[e] ?? x[e], d);
+		l(E, e, n, d), E[`--tempest-${e}`] = k(E[`--tempest-${e}`], f, z, p, u), e === "danger" && (E["--tempest-danger-hover"] = n[E["--tempest-danger-on-solid"] === "#ffffff" ? d === "dark" ? 400 : 700 : d === "dark" ? 600 : 500]);
+	}
+	(r.chart?.length ? r.chart : S[d]).forEach((e, t) => {
+		E[`--tempest-chart-${t + 1}`] = k(e, f, [
+			P,
+			F,
+			R
+		], m, u);
+	});
+	let q = s(r.chart?.[0] ?? r.primary), J = r.statuses?.danger ? s(r.statuses.danger) : (q + 180) % 360;
+	o(q, d).forEach((e, t) => {
+		E[`--tempest-chart-sequential-${t + 1}`] = e;
+	});
+	let Y = a({
+		coolHue: q,
+		warmHue: J,
+		mid: L,
+		mode: d
+	});
+	[
+		...Y.cool,
+		Y.mid,
+		...Y.warm
+	].forEach((e, t) => {
+		E[`--tempest-chart-diverging-${t + 1}`] = e;
+	}), E["--tempest-chart-grid"] = E["--tempest-border"], E["--tempest-chart-axis"] = E["--tempest-text-subtle"];
+	let X = [
+		P,
+		F,
+		N(F, u, .1)
+	];
+	C.forEach((e, t) => {
+		E[`--tempest-code-${e}`] = k(w[d][t], f, X, p, u);
+	});
+	for (let [e, t] of Object.entries(T[d])) E[`--tempest-shadow-${e}`] = t;
+	return {
+		tokens: E,
+		scheme: d,
+		glow: R
+	};
+}
+function F(e, t) {
+	let n = (t) => e[t], r = [
+		n("--tempest-bg"),
+		n("--tempest-surface"),
+		n("--tempest-surface-2"),
+		n("--tempest-surface-3")
+	], i = n("--tempest-primary-foreground"), a = [
+		O(n("--tempest-text"), [...r, t]) / g,
+		O(n("--tempest-text-muted"), [...r, t]) / f,
+		O(n("--tempest-text-subtle"), [...r.slice(0, 2), t]) / f,
+		O(n("--tempest-focus-ring-color"), [...r, t]) / m,
+		O(i, [
+			n("--tempest-primary"),
+			n("--tempest-primary-hover"),
+			n("--tempest-primary-active")
+		]) / f
+	];
+	return Math.min(...a) - 1;
+}
+function I(e) {
+	let n = t(e.primary, "light"), r = null, i = -Infinity;
+	for (let t of _) {
+		let a = P(n[t], e), o = F(a.tokens, a.glow);
+		if (o > i && (r = {
+			tokens: a.tokens,
+			scheme: a.scheme,
+			step: t
+		}, i = o), o >= 0) break;
+	}
+	let a = r;
+	return a.rules = d(Object.keys(a.tokens), e.selector ?? "[data-tempest-tone=\"inverse\"]", e.page ?? u), a;
+}
+//#endregion
+export { S as DEFAULT_CHART_COLORS, w as DEFAULT_CODE_COLORS, x as DEFAULT_STATUS_COLORS, I as createInverseSurface };
+
+//# sourceMappingURL=inverse-surface.js.map

package/dist/theme/inverse-surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inverse-surface.js","names":[],"sources":["../../src/theme/inverse-surface.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — the inverse surface is a whole scheme: surfaces,\n * text, the action color, focus, selection, statuses, charts and syntax colors,\n * each derived and then measured against the brand fill it sits on. Splitting\n * the derivation from the table it is measured against is how the two drift.\n */\n/**\n * Inverse surface: the token set for a section painted in the brand color —\n * a hero, a call-to-action band, a footer — so the components inside it invert\n * instead of inheriting the page's tokens.\n *\n * Every value is derived from the brand and measured against the fill it will\n * sit on, the same way {@link createTheme} measures the page schemes. Overriding\n * eight tokens by hand (what #409 had to do) leaves the rest of the scheme on\n * the page's values: measured over a navy `#1e2a5a`, the inherited\n * `--tempest-text-subtle` lands at 2.75:1, `--tempest-danger` at 2.12:1, the\n * selected indicator at 2.01:1, and a `Card` puts white text on\n * `--tempest-surface` at 1.05:1.\n */\nimport {\n    contrastRatio,\n    createColorScale,\n    hexToOklch,\n    oklchToHex,\n    readableForeground,\n    type ColorScale,\n    type Oklch,\n    type ScaleStep,\n} from \"./color\";\nimport { buildDivergingRamp, buildRamp, hueOf } from \"./data-viz-ramps\";\nimport {\n    INVERSE_SELECTOR,\n    type InverseScheme,\n    type InverseSurface,\n    type InverseSurfaceOptions,\n} from \"./inverse-render\";\nimport { DEFAULT_PAGE_SELECTORS, defaultToneRules } from \"./inverse-restore\";\nimport { THEME_STATUSES, writeStatus, type ThemeStatus } from \"./status-tokens\";\n\nexport { INVERSE_SELECTOR, renderInverseSurface } from \"./inverse-render\";\nexport { DEFAULT_TONE_SELECTOR } from \"./inverse-restore\";\nexport type {\n    InverseScheme,\n    InverseSurface,\n    InverseSurfaceGenerator,\n    InverseSurfaceOptions,\n    PageSelectors,\n} from \"./inverse-render\";\n\n/** WCAG 2.x AA floor for body text. */\nconst AA_TEXT = 4.5;\n\n/**\n * What text is fitted to, rather than the floor itself.\n *\n * The margin the SDK's dark theme keeps on `--tempest-text-subtle` (4.79 over its\n * surface): a value solved to exactly 4.5 turns the next rounding into a failure.\n */\nconst TEXT_TARGET = 4.75;\n\n/** WCAG 2.2 SC 1.4.11 floor for a non-text indicator. */\nconst INDICATOR_FLOOR = 3;\n\n/**\n * What the focus ring and the selected indicator are fitted to.\n *\n * Well above the 3:1 floor on purpose: the SDK's own rings keep 5.40:1 (dark)\n * and 5.50:1 (light) worst case, because a ring travels onto surfaces nobody\n * validated it against.\n */\nconst RING_TARGET = 4.5;\n\n/**\n * The smallest contrast the ink must keep — on the fill, the surfaces and the\n * glow — before the fill is accepted.\n *\n * AA (4.5) is not enough here, because the surface has three text levels — text,\n * muted and subtle — and all three must clear AA. With text at 4.83:1 (white on\n * the default `#0066ff`) the three collapse into one color. 7:1 (AAA) leaves room\n * for muted to sit visibly between text and subtle.\n */\nconst MIN_TEXT_RATIO = 7;\n\n/**\n * Fill candidates, nearest the brand first, darker before lighter on a tie.\n *\n * `500` is the brand itself and wins whenever it can carry the scheme. When it\n * cannot — a mid-tone brand such as `#0066ff`, where white measures 4.83:1 —\n * the walk moves one step at a time, so the section stays as close to the brand\n * as the measurement allows.\n *\n * Measuring the glow is what most of the walking pays for: against the flat\n * fill and the surfaces alone, 9 of the 14 test brands keep their `500`; with\n * the glow, 6 do. The three that move (`#8100D7`, `#22d3ee`, `#14b8a6`) are the\n * ones whose subtle text would fail on a lifted region of their own band.\n */\nconst FILL_CANDIDATES: readonly ScaleStep[] = [500, 600, 400, 700, 300, 800, 200, 900];\n\n/**\n * Lightness offsets from the fill, per scheme.\n *\n * The sizes are the SDK's own, measured in OKLCH: the dark theme's surfaces sit\n * 0.046, 0.094 and 0.140 from `#0b0d12`, its borders 0.155 and 0.222; the light\n * theme's surfaces sit 0.018, 0.037 and 0.073 from white, its borders 0.073 and\n * 0.128.\n *\n * The direction is not the SDK's. On the page, raised surfaces move toward the\n * ink, which costs nothing there: the page fill is near-white or near-black, so\n * the ink keeps 13:1 or more on the third surface. A brand fill sits mid-axis,\n * and moving toward the ink spends exactly the contrast the text needs. Measured\n * across the fourteen brands of the contrast test, every text level held to AA\n * on every surface and on the glow ({@link GLOW_OFFSET}):\n *\n * | surfaces move | brands keeping their own `500` | where `#8100D7` / `#4f46e5` land |\n * | --- | --- | --- |\n * | toward the ink | 6 of 14 | `800` / `800` |\n * | away from the ink | 6 of 14 | `700` / `700` |\n *\n * Never worse and one step nearer the brand for the purples, and with every\n * surface carrying the ink at least as well as the fill does.\n *\n * So surfaces move away from the ink — a card in a navy band is a deeper navy,\n * one in a yellow band a paler yellow — and every surface then carries the ink\n * at least as well as the fill does. Borders still move toward the ink, since a\n * border has to separate from the fill and the surfaces alike.\n */\nconst OFFSETS: Record<\n    InverseScheme,\n    { surfaces: readonly [number, number, number]; border: number; borderStrong: number }\n> = {\n    dark: { surfaces: [0.046, 0.094, 0.14], border: 0.155, borderStrong: 0.222 },\n    light: { surfaces: [0.018, 0.037, 0.073], border: 0.073, borderStrong: 0.128 },\n};\n\n/**\n * How far toward the ink a region of the band may lift and still be measured.\n *\n * A brand section is rarely one flat color: the landing that opened #409 lays a\n * radial glow of `#1f3f8f` at 55% over its navy `#03184b`, which lifts the\n * ground by 0.09 in OKLCH lightness, and a hover tint does the same. Text fitted\n * to the flat fill alone failed there — subtle measured 3.64:1 on that glow. So\n * every text and indicator token is also fitted against the fill lifted by this\n * much; darker variations (the landing's `#020f30` footer) only add contrast.\n */\nconst GLOW_OFFSET = 0.1;\n\n/** Text ink per scheme — the SDK's own extremes. */\nconst INK: Record<InverseScheme, string> = { dark: \"#ffffff\", light: \"#101828\" };\n\n/**\n * The SDK's default status colors, used when a theme names none.\n *\n * Ported from `src/styles/colors.css` (`--tempest-*-solid` in the light block),\n * and pinned by a test that reads that file.\n */\nexport const DEFAULT_STATUS_COLORS: Record<ThemeStatus, string> = {\n    success: \"#16a34a\",\n    warning: \"#d97706\",\n    danger: \"#dc2626\",\n    info: \"#2563eb\",\n};\n\n/**\n * The SDK's categorical chart colors, per scheme.\n *\n * Ported from `src/styles/colors.css` (`--tempest-chart-1` … `-8`), pinned by a\n * test that reads that file. Used as the starting hue for each slot, then fitted\n * to the inverse fill.\n */\nexport const DEFAULT_CHART_COLORS: Record<InverseScheme, readonly string[]> = {\n    light: [\"#2563eb\", \"#16a34a\", \"#f59e0b\", \"#7c3aed\", \"#ec4899\", \"#06b6d4\", \"#ea580c\", \"#0f766e\"],\n    dark: [\"#60a5fa\", \"#4ade80\", \"#fbbf24\", \"#a78bfa\", \"#f472b6\", \"#22d3ee\", \"#fb923c\", \"#2dd4bf\"],\n};\n\n/** Names of the `CodeBlock` syntax tokens, in `colors.css` order. */\nconst CODE_TOKENS = [\n    \"comment\",\n    \"punctuation\",\n    \"string\",\n    \"number\",\n    \"keyword\",\n    \"literal\",\n    \"function\",\n    \"tag\",\n    \"attribute\",\n    \"property\",\n] as const;\n\n/**\n * The SDK's syntax colors, per scheme, in {@link CODE_TOKENS} order.\n *\n * Ported from `src/styles/colors.css` (`--tempest-code-*`), pinned by a test\n * that reads that file. Used as the starting hue, then fitted to the inverse\n * code grounds.\n */\nexport const DEFAULT_CODE_COLORS: Record<InverseScheme, readonly string[]> = {\n    light: [\n        \"#5f666e\",\n        \"#5d6671\",\n        \"#327243\",\n        \"#9d5035\",\n        \"#625baf\",\n        \"#9f4c4f\",\n        \"#1a6c94\",\n        \"#974d72\",\n        \"#127171\",\n        \"#127171\",\n    ],\n    dark: [\n        \"#838b93\",\n        \"#818b95\",\n        \"#589866\",\n        \"#c57558\",\n        \"#8580d8\",\n        \"#c87172\",\n        \"#2893c6\",\n        \"#c07197\",\n        \"#349897\",\n        \"#349897\",\n    ],\n};\n\n/**\n * The SDK's elevation shadows, per scheme.\n *\n * Ported from `src/styles/colors.css` (`--tempest-shadow-*`). A light-ink fill\n * takes the dark theme's heavier shadows, since a faint shadow vanishes on it.\n * The dark block does not override `--tempest-shadow-inner`, so the dark row\n * carries the light value it inherits.\n */\nconst SHADOWS: Record<InverseScheme, Record<string, string>> = {\n    light: {\n        xs: \"0 1px 2px rgba(15, 23, 42, 0.04)\",\n        sm: \"0 1px 3px rgba(15, 23, 42, 0.08), 0 1px 2px rgba(15, 23, 42, 0.04)\",\n        md: \"0 4px 12px rgba(15, 23, 42, 0.08), 0 2px 4px rgba(15, 23, 42, 0.04)\",\n        lg: \"0 12px 32px rgba(15, 23, 42, 0.12), 0 4px 8px rgba(15, 23, 42, 0.06)\",\n        xl: \"0 24px 48px rgba(15, 23, 42, 0.18), 0 8px 16px rgba(15, 23, 42, 0.08)\",\n        inner: \"inset 0 2px 4px rgba(15, 23, 42, 0.06)\",\n    },\n    dark: {\n        xs: \"0 1px 2px rgba(0, 0, 0, 0.3)\",\n        sm: \"0 1px 3px rgba(0, 0, 0, 0.4), 0 1px 2px rgba(0, 0, 0, 0.2)\",\n        md: \"0 4px 12px rgba(0, 0, 0, 0.4), 0 2px 4px rgba(0, 0, 0, 0.2)\",\n        lg: \"0 12px 32px rgba(0, 0, 0, 0.5), 0 4px 8px rgba(0, 0, 0, 0.3)\",\n        xl: \"0 24px 48px rgba(0, 0, 0, 0.6), 0 8px 16px rgba(0, 0, 0, 0.3)\",\n        inner: \"inset 0 2px 4px rgba(15, 23, 42, 0.06)\",\n    },\n};\n\n/** Lightness step used when fitting a color toward the ink. */\nconst FIT_STEP = 0.005;\n\n/**\n * Move a color along the lightness axis toward (positive `delta`) or away from\n * the ink, keeping its hue.\n *\n * @param base - The color to move, in OKLCH.\n * @param direction - `1` when the ink is lighter than the fill, `-1` otherwise.\n * @param delta - How far to move, in OKLCH lightness.\n * @param chroma - Chroma of the result; defaults to the base's.\n * @returns The moved color as hex, gamut-mapped.\n */\nfunction shift(base: Oklch, direction: 1 | -1, delta: number, chroma: number = base.c): string {\n    const l = Math.min(1, Math.max(0, base.l + direction * delta));\n    return oklchToHex({ l, c: chroma, h: base.h });\n}\n\n/** Weakest contrast of `color` against every ground. */\nfunction worst(color: string, grounds: readonly string[]): number {\n    return Math.min(...grounds.map((ground) => contrastRatio(color, ground)));\n}\n\n/**\n * Walk a color toward the ink until it clears `floor` against every ground.\n *\n * Hue and chroma are kept, so a danger stays red and a keyword stays violet;\n * only lightness moves, and only as far as the measurement asks. When the walk\n * reaches the end of the lightness axis without clearing, the ink itself is\n * returned — it is the most contrasting color the scheme has.\n *\n * @param start - Where to start, as hex.\n * @param direction - `1` when the ink is lighter than the grounds, `-1` otherwise.\n * @param grounds - Every background the color will sit on.\n * @param floor - The ratio to clear against all of them.\n * @param ink - Fallback when nothing on the walk clears.\n * @returns The first color on the walk that clears, else `ink`.\n */\nfunction fitToward(\n    start: string,\n    direction: 1 | -1,\n    grounds: readonly string[],\n    floor: number,\n    ink: string,\n): string {\n    const base = hexToOklch(start);\n    for (let delta = 0; delta <= 1; delta += FIT_STEP) {\n        const candidate = shift(base, direction, delta);\n        if (worst(candidate, grounds) >= floor) return candidate;\n        if ((direction === 1 && base.l + delta >= 1) || (direction === -1 && base.l - delta <= 0)) {\n            break;\n        }\n    }\n    return ink;\n}\n\n/**\n * How far the soft tint sits from the fill, per scheme; the hover tint sits\n * {@link SOFT_HOVER_FACTOR} times as far.\n */\nconst SOFT_OFFSET: Record<InverseScheme, number> = { dark: 0.07, light: 0.05 };\n\n/** Distance of the soft hover tint, relative to the soft tint's. */\nconst SOFT_HOVER_FACTOR = 1.6;\n\n/**\n * The soft tint and its hover, lifted toward the ink only as far as the ink\n * still reads on both.\n *\n * A tint toward the ink is what reads as \"highlighted\" on a fill, and it is also\n * what eats the ink's contrast: on the `#8100D7` fill, the full offset left white\n * at 4.42:1 on the hover tint. So the offset shrinks until the ink clears\n * {@link TEXT_TARGET} on both, and when even a sliver cannot — the fill gives the\n * ink no room — the tints move away from the ink instead, like the surfaces.\n *\n * @param base - The fill, in OKLCH.\n * @param direction - `1` when the ink is lighter than the fill, `-1` otherwise.\n * @param offset - The preferred distance of the soft tint.\n * @param ink - The scheme's text ink.\n * @returns The soft tint and its hover, as hex.\n */\nfunction softTints(base: Oklch, direction: 1 | -1, offset: number, ink: string): [string, string] {\n    for (let delta = offset; delta > FIT_STEP; delta -= FIT_STEP) {\n        const tints: [string, string] = [\n            shift(base, direction, delta),\n            shift(base, direction, delta * SOFT_HOVER_FACTOR),\n        ];\n        if (worst(ink, tints) >= TEXT_TARGET) return tints;\n    }\n    return [shift(base, direction, -offset), shift(base, direction, -offset * SOFT_HOVER_FACTOR)];\n}\n\n/** Mix `top` over `bottom` at `amount`, the way `color-mix(in srgb, …)` composites. */\nfunction mix(bottom: string, top: string, amount: number): string {\n    const parse = (hex: string): number[] =>\n        [1, 3, 5].map((index) => Number.parseInt(hex.slice(index, index + 2), 16));\n    const [a, b] = [parse(bottom), parse(top)];\n    const channels = a.map((channel, index) =>\n        Math.round(channel + ((b[index] as number) - channel) * amount),\n    );\n    return `#${channels.map((channel) => channel.toString(16).padStart(2, \"0\")).join(\"\")}`;\n}\n\n/**\n * Derive the inverse scheme over one candidate fill.\n *\n * Text is three levels, like the page: the ink, then `muted` fitted to the\n * geometric mean of the ink's contrast and {@link TEXT_TARGET} (so it sits\n * visibly between the two), then `subtle` fitted to {@link TEXT_TARGET} on\n * `bg` and `surface` — the same pairs the SDK holds its own `text-subtle` to.\n *\n * The action color is the ink itself: a white button on a navy band, labelled in\n * the fill. Hover and active step back toward the fill, because the ink is\n * already the end of the axis and has nowhere further to go.\n *\n * `--tempest-danger-hover` steps toward the side that keeps `-on-solid`\n * readable: darker when the ink is white, lighter when it is dark. A fixed\n * direction cannot hold one ink over both fills — over the dark scheme's\n * `#dc2626` it measured 4.00:1 with the lighter hover.\n *\n * The ramp (`--tempest-primary-50` … `-900`) is emitted too, because `Tag` and\n * `Sidebar` pair raw steps (`100` under `700`). It is the scheme's unanchored\n * ramp, so that pair keeps the shape it has on the page.\n *\n * @param fill - The fill, as hex.\n * @param options - The brand description.\n * @returns The token map and the scheme it reads as.\n */\nfunction deriveOver(\n    fill: string,\n    options: InverseSurfaceOptions,\n): { tokens: Record<string, string>; scheme: InverseScheme; glow: string } {\n    const ink = readableForeground(fill, INK.dark, INK.light);\n    const scheme: InverseScheme = ink === INK.dark ? \"dark\" : \"light\";\n    const direction: 1 | -1 = scheme === \"dark\" ? 1 : -1;\n    const base = hexToOklch(fill);\n    const offsets = OFFSETS[scheme];\n    const tokens: Record<string, string> = {};\n\n    const surfaces = [fill, ...offsets.surfaces.map((delta) => shift(base, direction, -delta))];\n    const [bg, surface, surface2, surface3] = surfaces as [string, string, string, string];\n    const glow = shift(base, direction, GLOW_OFFSET);\n    const grounds = [...surfaces, glow];\n    tokens[\"--tempest-bg\"] = bg;\n    tokens[\"--tempest-surface\"] = surface;\n    tokens[\"--tempest-surface-2\"] = surface2;\n    tokens[\"--tempest-surface-3\"] = surface3;\n    tokens[\"--tempest-border\"] = shift(base, direction, offsets.border);\n    tokens[\"--tempest-border-strong\"] = shift(base, direction, offsets.borderStrong);\n\n    const textWorst = worst(ink, grounds);\n    const tint = base.c * 0.4;\n    tokens[\"--tempest-text\"] = ink;\n    tokens[\"--tempest-text-muted\"] = fitToward(\n        shift(base, direction, 0, tint),\n        direction,\n        grounds,\n        Math.max(TEXT_TARGET, Math.sqrt(textWorst * TEXT_TARGET)),\n        ink,\n    );\n    tokens[\"--tempest-text-subtle\"] = fitToward(\n        shift(base, direction, 0, tint),\n        direction,\n        [bg, surface, glow],\n        TEXT_TARGET,\n        ink,\n    );\n\n    const inkBase: Oklch = { ...hexToOklch(ink), h: base.h };\n    tokens[\"--tempest-primary\"] = ink;\n    tokens[\"--tempest-primary-hover\"] = shift(inkBase, direction, -0.05, base.c * 0.25);\n    tokens[\"--tempest-primary-active\"] = shift(inkBase, direction, -0.1, base.c * 0.3);\n    tokens[\"--tempest-primary-foreground\"] = fill;\n    tokens[\"--tempest-text-on-primary\"] = fill;\n\n    const [soft, softHover] = softTints(base, direction, SOFT_OFFSET[scheme], ink);\n    tokens[\"--tempest-primary-soft\"] = soft;\n    tokens[\"--tempest-primary-soft-hover\"] = softHover;\n    tokens[\"--tempest-primary-on-soft\"] = fitToward(\n        soft,\n        direction,\n        [soft, softHover],\n        TEXT_TARGET,\n        ink,\n    );\n\n    const ring = fitToward(fill, direction, grounds, RING_TARGET, ink);\n    tokens[\"--tempest-focus-ring-color\"] = ring;\n    tokens[\"--tempest-selected-indicator\"] = ring;\n\n    const ramp: ColorScale = createColorScale(options.primary, scheme, { anchor: false });\n    for (const [step, value] of Object.entries(ramp)) {\n        tokens[`--tempest-primary-${step}`] = value;\n    }\n\n    for (const status of THEME_STATUSES) {\n        const scale = createColorScale(\n            options.statuses?.[status] ?? DEFAULT_STATUS_COLORS[status],\n            scheme,\n        );\n        writeStatus(tokens, status, scale, scheme);\n        tokens[`--tempest-${status}`] = fitToward(\n            tokens[`--tempest-${status}`] as string,\n            direction,\n            grounds,\n            TEXT_TARGET,\n            ink,\n        );\n        if (status === \"danger\") {\n            const whiteInk = tokens[\"--tempest-danger-on-solid\"] === \"#ffffff\";\n            const darker: ScaleStep = scheme === \"dark\" ? 400 : 700;\n            const lighter: ScaleStep = scheme === \"dark\" ? 600 : 500;\n            tokens[\"--tempest-danger-hover\"] = scale[whiteInk ? darker : lighter];\n        }\n    }\n\n    const chart = options.chart?.length ? options.chart : DEFAULT_CHART_COLORS[scheme];\n    chart.forEach((color, index) => {\n        tokens[`--tempest-chart-${index + 1}`] = fitToward(\n            color,\n            direction,\n            [bg, surface, glow],\n            INDICATOR_FLOOR,\n            ink,\n        );\n    });\n    const coolHue = hueOf(options.chart?.[0] ?? options.primary);\n    const warmHue = options.statuses?.danger\n        ? hueOf(options.statuses.danger)\n        : (coolHue + 180) % 360;\n    buildRamp(coolHue, scheme).forEach((value, index) => {\n        tokens[`--tempest-chart-sequential-${index + 1}`] = value;\n    });\n    const diverging = buildDivergingRamp({ coolHue, warmHue, mid: surface3, mode: scheme });\n    [...diverging.cool, diverging.mid, ...diverging.warm].forEach((value, index) => {\n        tokens[`--tempest-chart-diverging-${index + 1}`] = value;\n    });\n    tokens[\"--tempest-chart-grid\"] = tokens[\"--tempest-border\"] as string;\n    tokens[\"--tempest-chart-axis\"] = tokens[\"--tempest-text-subtle\"] as string;\n\n    const codeGrounds = [bg, surface, mix(surface, ink, 0.1)];\n    CODE_TOKENS.forEach((name, index) => {\n        tokens[`--tempest-code-${name}`] = fitToward(\n            DEFAULT_CODE_COLORS[scheme][index] as string,\n            direction,\n            codeGrounds,\n            TEXT_TARGET,\n            ink,\n        );\n    });\n\n    for (const [name, value] of Object.entries(SHADOWS[scheme])) {\n        tokens[`--tempest-shadow-${name}`] = value;\n    }\n\n    return { tokens, scheme, glow };\n}\n\n/**\n * The gates a candidate fill must clear before it is accepted.\n *\n * Text reaches {@link MIN_TEXT_RATIO} on every surface, every fitted text token\n * clears AA where it is used, the ring clears 3:1 on every surface, and the\n * action label clears AA on all three button states.\n *\n * @param tokens - A derived token map.\n * @param glow - The fill lifted by {@link GLOW_OFFSET}, measured alongside the surfaces.\n * @returns The weakest margin over its floor across all gates; `>= 0` passes.\n */\nfunction margin(tokens: Record<string, string>, glow: string): number {\n    const read = (name: string): string => tokens[name] as string;\n    const surfaces = [\n        read(\"--tempest-bg\"),\n        read(\"--tempest-surface\"),\n        read(\"--tempest-surface-2\"),\n        read(\"--tempest-surface-3\"),\n    ];\n    const label = read(\"--tempest-primary-foreground\");\n    const checks: number[] = [\n        worst(read(\"--tempest-text\"), [...surfaces, glow]) / MIN_TEXT_RATIO,\n        worst(read(\"--tempest-text-muted\"), [...surfaces, glow]) / AA_TEXT,\n        worst(read(\"--tempest-text-subtle\"), [...surfaces.slice(0, 2), glow]) / AA_TEXT,\n        worst(read(\"--tempest-focus-ring-color\"), [...surfaces, glow]) / INDICATOR_FLOOR,\n        worst(label, [\n            read(\"--tempest-primary\"),\n            read(\"--tempest-primary-hover\"),\n            read(\"--tempest-primary-active\"),\n        ]) / AA_TEXT,\n    ];\n    return Math.min(...checks) - 1;\n}\n\n/**\n * Build the inverse surface for a brand.\n *\n * The fill is the brand's own `500` whenever it can carry the scheme, and\n * otherwise the nearest ramp step that can (see {@link FILL_CANDIDATES}). Whether\n * the surface reads light-on-dark or dark-on-light follows the fill, so a yellow\n * brand gets dark ink and a navy one white — the same pick `createTheme` makes\n * for `--tempest-primary-foreground`.\n *\n * The values are literal colors, not references to the page's ramp, so the\n * section paints the same in the light and the dark page scheme: the brand is\n * the brand in both.\n *\n * The result also carries the rules that let a region inside the surface go\n * back to the page's tokens (`data-tempest-tone=\"default\"`), written for the\n * selectors in `options`.\n *\n * @param options - The brand, plus the status and chart colors the theme names\n *   and the selectors the surface and the page are written under.\n * @returns The token map, the scheme it reads as, the fill step used and the\n *   default-tone rules.\n */\nexport function createInverseSurface(options: InverseSurfaceOptions): InverseSurface {\n    const ramp = createColorScale(options.primary, \"light\");\n    let best: InverseSurface | null = null;\n    let bestMargin = Number.NEGATIVE_INFINITY;\n    for (const step of FILL_CANDIDATES) {\n        const derived = deriveOver(ramp[step], options);\n        const measured = margin(derived.tokens, derived.glow);\n        if (measured > bestMargin) {\n            best = { tokens: derived.tokens, scheme: derived.scheme, step };\n            bestMargin = measured;\n        }\n        if (measured >= 0) break;\n    }\n    const surface = best as InverseSurface;\n    surface.rules = defaultToneRules(\n        Object.keys(surface.tokens),\n        options.selector ?? INVERSE_SELECTOR,\n        options.page ?? DEFAULT_PAGE_SELECTORS,\n    );\n    return surface;\n}\n"],"mappings":"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"}

package/dist/theme/status-tokens.cjs

@@ -0,0 +1,2 @@
+const e=require("./color.cjs");var t=[`success`,`warning`,`danger`,`info`],n=`#1f0606`;function r(t,r,i,a){a===`light`?(t[`--tempest-${r}`]=i[700],t[`--tempest-${r}-fg`]=i[800],t[`--tempest-${r}-bg`]=i[50],t[`--tempest-${r}-border`]=i[200],t[`--tempest-${r}-solid`]=i[600],t[`--tempest-${r}-on-solid`]=e.readableForeground(i[600],`#ffffff`,n)):(t[`--tempest-${r}`]=i[700],t[`--tempest-${r}-fg`]=i[700],t[`--tempest-${r}-bg`]=i[50],t[`--tempest-${r}-border`]=i[200],t[`--tempest-${r}-solid`]=i[500],t[`--tempest-${r}-on-solid`]=e.readableForeground(i[500],`#ffffff`,n))}exports.ON_SOLID_INK=n,exports.THEME_STATUSES=t,exports.writeStatus=r;
+//# sourceMappingURL=status-tokens.cjs.map

package/dist/theme/status-tokens.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-tokens.cjs","names":[],"sources":["../../src/theme/status-tokens.ts"],"sourcesContent":["/**\n * Status token families, shared by the page schemes {@link createTheme} emits and\n * by the inverse surface.\n */\nimport { readableForeground, type ColorScale } from \"./color\";\n\n/** Status token families that {@link createTheme} can regenerate. */\nexport type ThemeStatus = \"success\" | \"warning\" | \"danger\" | \"info\";\n\n/** The four status families, in the order they are emitted. */\nexport const THEME_STATUSES: readonly ThemeStatus[] = [\"success\", \"warning\", \"danger\", \"info\"];\n\n/**\n * The dark ink for content sitting on a saturated fill.\n *\n * Near-black tinted toward warm rather than pure black, matching the value\n * `colors.css` uses for the same job: it reads as part of the swatch instead of\n * a hole punched in it.\n */\nexport const ON_SOLID_INK = \"#1f0606\";\n\n/**\n * Emit one status family (`--tempest-danger`, `-fg`, `-bg`, `-border`, `-solid`).\n *\n * `-fg` is the text shade over `-bg`, so it has to cross the ramp in opposite\n * directions per scheme; `-solid` stays the saturated fill used by badges.\n *\n * `-on-solid` is derived from the `-solid` this call just emitted, rather than\n * left to fall through. Falling through was the bug: the SDK's own\n * `-on-solid` values are measured against the SDK's own fills, so a brand whose\n * `danger-600` lands light kept white ink over it and nothing said so. The\n * generated neutral hit exactly that — white over a generated `gray-700` of\n * `#a8b2c6` measures 2.13:1.\n *\n * @param tokens - The token map for this scheme, written in place.\n * @param name - Which status family.\n * @param scale - The generated ramp for that status, in the scheme's direction.\n * @param scheme - Which scheme is being emitted.\n */\nexport function writeStatus(\n    tokens: Record<string, string>,\n    name: ThemeStatus,\n    scale: ColorScale,\n    scheme: \"light\" | \"dark\",\n): void {\n    if (scheme === \"light\") {\n        tokens[`--tempest-${name}`] = scale[700];\n        tokens[`--tempest-${name}-fg`] = scale[800];\n        tokens[`--tempest-${name}-bg`] = scale[50];\n        tokens[`--tempest-${name}-border`] = scale[200];\n        tokens[`--tempest-${name}-solid`] = scale[600];\n        tokens[`--tempest-${name}-on-solid`] = readableForeground(\n            scale[600],\n            \"#ffffff\",\n            ON_SOLID_INK,\n        );\n    } else {\n        tokens[`--tempest-${name}`] = scale[700];\n        tokens[`--tempest-${name}-fg`] = scale[700];\n        tokens[`--tempest-${name}-bg`] = scale[50];\n        tokens[`--tempest-${name}-border`] = scale[200];\n        tokens[`--tempest-${name}-solid`] = scale[500];\n        tokens[`--tempest-${name}-on-solid`] = readableForeground(\n            scale[500],\n            \"#ffffff\",\n            ON_SOLID_INK,\n        );\n    }\n}\n"],"mappings":"+BAUA,IAAa,EAAyC,CAAC,UAAW,UAAW,SAAU,MAAM,EAShF,EAAe,UAoB5B,SAAgB,EACZ,EACA,EACA,EACA,EACI,CACA,IAAW,SACX,EAAO,aAAa,KAAU,EAAM,KACpC,EAAO,aAAa,EAAK,MAAQ,EAAM,KACvC,EAAO,aAAa,EAAK,MAAQ,EAAM,IACvC,EAAO,aAAa,EAAK,UAAY,EAAM,KAC3C,EAAO,aAAa,EAAK,SAAW,EAAM,KAC1C,EAAO,aAAa,EAAK,YAAc,EAAA,mBACnC,EAAM,KACN,UACA,CACJ,IAEA,EAAO,aAAa,KAAU,EAAM,KACpC,EAAO,aAAa,EAAK,MAAQ,EAAM,KACvC,EAAO,aAAa,EAAK,MAAQ,EAAM,IACvC,EAAO,aAAa,EAAK,UAAY,EAAM,KAC3C,EAAO,aAAa,EAAK,SAAW,EAAM,KAC1C,EAAO,aAAa,EAAK,YAAc,EAAA,mBACnC,EAAM,KACN,UACA,CACJ,EAER"}

package/dist/theme/status-tokens.js

@@ -0,0 +1,15 @@
+import { readableForeground as e } from "./color.js";
+//#region src/theme/status-tokens.ts
+var t = [
+	"success",
+	"warning",
+	"danger",
+	"info"
+], n = "#1f0606";
+function r(t, r, i, a) {
+	a === "light" ? (t[`--tempest-${r}`] = i[700], t[`--tempest-${r}-fg`] = i[800], t[`--tempest-${r}-bg`] = i[50], t[`--tempest-${r}-border`] = i[200], t[`--tempest-${r}-solid`] = i[600], t[`--tempest-${r}-on-solid`] = e(i[600], "#ffffff", n)) : (t[`--tempest-${r}`] = i[700], t[`--tempest-${r}-fg`] = i[700], t[`--tempest-${r}-bg`] = i[50], t[`--tempest-${r}-border`] = i[200], t[`--tempest-${r}-solid`] = i[500], t[`--tempest-${r}-on-solid`] = e(i[500], "#ffffff", n));
+}
+//#endregion
+export { n as ON_SOLID_INK, t as THEME_STATUSES, r as writeStatus };
+
+//# sourceMappingURL=status-tokens.js.map

package/dist/theme/status-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-tokens.js","names":[],"sources":["../../src/theme/status-tokens.ts"],"sourcesContent":["/**\n * Status token families, shared by the page schemes {@link createTheme} emits and\n * by the inverse surface.\n */\nimport { readableForeground, type ColorScale } from \"./color\";\n\n/** Status token families that {@link createTheme} can regenerate. */\nexport type ThemeStatus = \"success\" | \"warning\" | \"danger\" | \"info\";\n\n/** The four status families, in the order they are emitted. */\nexport const THEME_STATUSES: readonly ThemeStatus[] = [\"success\", \"warning\", \"danger\", \"info\"];\n\n/**\n * The dark ink for content sitting on a saturated fill.\n *\n * Near-black tinted toward warm rather than pure black, matching the value\n * `colors.css` uses for the same job: it reads as part of the swatch instead of\n * a hole punched in it.\n */\nexport const ON_SOLID_INK = \"#1f0606\";\n\n/**\n * Emit one status family (`--tempest-danger`, `-fg`, `-bg`, `-border`, `-solid`).\n *\n * `-fg` is the text shade over `-bg`, so it has to cross the ramp in opposite\n * directions per scheme; `-solid` stays the saturated fill used by badges.\n *\n * `-on-solid` is derived from the `-solid` this call just emitted, rather than\n * left to fall through. Falling through was the bug: the SDK's own\n * `-on-solid` values are measured against the SDK's own fills, so a brand whose\n * `danger-600` lands light kept white ink over it and nothing said so. The\n * generated neutral hit exactly that — white over a generated `gray-700` of\n * `#a8b2c6` measures 2.13:1.\n *\n * @param tokens - The token map for this scheme, written in place.\n * @param name - Which status family.\n * @param scale - The generated ramp for that status, in the scheme's direction.\n * @param scheme - Which scheme is being emitted.\n */\nexport function writeStatus(\n    tokens: Record<string, string>,\n    name: ThemeStatus,\n    scale: ColorScale,\n    scheme: \"light\" | \"dark\",\n): void {\n    if (scheme === \"light\") {\n        tokens[`--tempest-${name}`] = scale[700];\n        tokens[`--tempest-${name}-fg`] = scale[800];\n        tokens[`--tempest-${name}-bg`] = scale[50];\n        tokens[`--tempest-${name}-border`] = scale[200];\n        tokens[`--tempest-${name}-solid`] = scale[600];\n        tokens[`--tempest-${name}-on-solid`] = readableForeground(\n            scale[600],\n            \"#ffffff\",\n            ON_SOLID_INK,\n        );\n    } else {\n        tokens[`--tempest-${name}`] = scale[700];\n        tokens[`--tempest-${name}-fg`] = scale[700];\n        tokens[`--tempest-${name}-bg`] = scale[50];\n        tokens[`--tempest-${name}-border`] = scale[200];\n        tokens[`--tempest-${name}-solid`] = scale[500];\n        tokens[`--tempest-${name}-on-solid`] = readableForeground(\n            scale[500],\n            \"#ffffff\",\n            ON_SOLID_INK,\n        );\n    }\n}\n"],"mappings":";;AAUA,IAAa,IAAyC;CAAC;CAAW;CAAW;CAAU;AAAM,GAShF,IAAe;AAoB5B,SAAgB,EACZ,GACA,GACA,GACA,GACI;CACJ,AAAI,MAAW,WACX,EAAO,aAAa,OAAU,EAAM,MACpC,EAAO,aAAa,EAAK,QAAQ,EAAM,MACvC,EAAO,aAAa,EAAK,QAAQ,EAAM,KACvC,EAAO,aAAa,EAAK,YAAY,EAAM,MAC3C,EAAO,aAAa,EAAK,WAAW,EAAM,MAC1C,EAAO,aAAa,EAAK,cAAc,EACnC,EAAM,MACN,WACA,CACJ,MAEA,EAAO,aAAa,OAAU,EAAM,MACpC,EAAO,aAAa,EAAK,QAAQ,EAAM,MACvC,EAAO,aAAa,EAAK,QAAQ,EAAM,KACvC,EAAO,aAAa,EAAK,YAAY,EAAM,MAC3C,EAAO,aAAa,EAAK,WAAW,EAAM,MAC1C,EAAO,aAAa,EAAK,cAAc,EACnC,EAAM,MACN,WACA,CACJ;AAER"}

package/dist/vite/create-vite-config.cjs

@@ -1,2 +1,2 @@
-const e=require("../_virtual/_rolldown/runtime.cjs"),t=require("./tempest-icons.cjs"),n=require("./tempest-vitest.cjs");let r=require("node:path"),i=require("vite"),a=require("@vitejs/plugin-react");a=e.__toESM(a,1);function o(e){let t={};for(let[n,r]of Object.entries(e))t[n]=typeof r==`string`?{target:r,changeOrigin:!0}:r;return t}function s(e={}){let{srcDir:s=`src`,port:c=5173,host:l=`127.0.0.1`,open:u=!1,proxy:d,alias:f={},plugins:p=[],icons:m=!0,overrides:h={}}=e,g=h,_=m?[t.tempestIcons({dir:s,...typeof m==`object`?m:{}})]:[],v={plugins:[(0,a.default)(),..._,n.tempestVitest(),...p],resolve:{alias:{"@":(0,r.resolve)(process.cwd(),s),...f}},server:{port:c,host:l,open:u,...d?{proxy:o(d)}:{}}},y={...v,...g,plugins:[...v.plugins??[],...g.plugins??[]],resolve:{...v.resolve,...g.resolve},server:{...v.server,...g.server}};return(0,i.defineConfig)(y)}exports.createViteConfig=s;
+const e=require("./tempest-icons.cjs"),t=require("./tempest-vitest.cjs");let n=require("node:path"),r=require("vite");function i(e){let t={};for(let[n,r]of Object.entries(e))t[n]=typeof r==`string`?{target:r,changeOrigin:!0}:r;return t}function a(){return import(`@vitejs/plugin-react`).then(e=>e.default())}function o(o={}){let{srcDir:s=`src`,port:c=5173,host:l=`127.0.0.1`,open:u=!1,proxy:d,alias:f={},plugins:p=[],icons:m=!0,overrides:h={}}=o,g=h,_=m?[e.tempestIcons({dir:s,...typeof m==`object`?m:{}})]:[],v={plugins:[a(),..._,t.tempestVitest(),...p],resolve:{alias:{"@":(0,n.resolve)(process.cwd(),s),...f}},server:{port:c,host:l,open:u,...d?{proxy:i(d)}:{}}},y={...v,...g,plugins:[...v.plugins??[],...g.plugins??[]],resolve:{...v.resolve,...g.resolve},server:{...v.server,...g.server}};return(0,r.defineConfig)(y)}exports.createViteConfig=o;
 //# sourceMappingURL=create-vite-config.cjs.map

package/dist/vite/create-vite-config.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-vite-config.cjs","names":[],"sources":["../../src/vite/create-vite-config.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { defineConfig } from \"vite\";\nimport type { ProxyOptions, UserConfig } from \"vite\";\nimport react from \"@vitejs/plugin-react\";\n\nimport { tempestIcons, type TempestIconsOptions } from \"./tempest-icons\";\nimport { tempestVitest } from \"./tempest-vitest\";\n\n/**\n * A Vite proxy entry: either a target URL string (expanded to\n * `{ target, changeOrigin: true }`) or a raw Vite `ProxyOptions` object.\n */\nexport type ProxyEntry = string | Record<string, unknown>;\n\nexport interface CreateViteConfigOptions {\n    /**\n     * Source directory aliased to `@`, relative to the project root.\n     * Default: `\"src\"` (so `@/components/Button` → `<root>/src/components/Button`).\n     */\n    srcDir?: string;\n    /** Dev server port. Default: `5173`. */\n    port?: number;\n    /** Dev server host. Default: `\"127.0.0.1\"`. */\n    host?: string | boolean;\n    /** Open the browser on `dev` start. Default: `false`. */\n    open?: boolean;\n    /**\n     * Dev proxy table. String values are expanded to\n     * `{ target, changeOrigin: true }`; objects are passed through untouched.\n     *\n     * @example { \"/api\": \"http://127.0.0.1:8000\" }\n     */\n    proxy?: Record<string, ProxyEntry>;\n    /** Extra path aliases merged on top of the default `@` → src alias. */\n    alias?: Record<string, string>;\n    /** Vite plugins appended after `@vitejs/plugin-react`. */\n    plugins?: unknown[];\n    /**\n     * The `tempestIcons()` plugin, which generates `virtual:tempest-icons` from the\n     * icon slugs your source mentions. On by default — it only ever removes\n     * requests. Pass `false` to leave it out, or an options object to configure the\n     * scan.\n     */\n    icons?: boolean | TempestIconsOptions;\n    /**\n     * Arbitrary Vite config (a `UserConfig` object) deep-merged last, for\n     * escape-hatch overrides (build target, define, extra `server` keys, …).\n     */\n    overrides?: Record<string, unknown>;\n}\n\n/**\n * The resulting Vite config object. Typed loosely so the SDK's published\n * declarations stay free of `vite`'s internal types; assign it straight to a\n * `vite.config.ts` default export.\n */\nexport type TempestViteConfig = Record<string, unknown>;\n\nfunction normalizeProxy(proxy: Record<string, ProxyEntry>): Record<string, ProxyOptions> {\n    const out: Record<string, ProxyOptions> = {};\n    for (const [path, value] of Object.entries(proxy)) {\n        out[path] =\n            typeof value === \"string\"\n                ? { target: value, changeOrigin: true }\n                : (value as ProxyOptions);\n    }\n    return out;\n}\n\n/**\n * Build a Tempest-flavored Vite config for a React app: the `@vitejs/plugin-react`\n * plugin, the `@` → `src` import alias, sane dev-server defaults and\n * {@link tempestVitest}, which lets a Vitest suite import the SDK — so a\n * consuming app's `vite.config.ts` is a single call instead of repeated\n * boilerplate. Everything is overridable.\n *\n * Import it from the dedicated Node entry point:\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *     proxy: { \"/api\": \"http://127.0.0.1:8000\" },\n * });\n */\nexport function createViteConfig(options: CreateViteConfigOptions = {}): TempestViteConfig {\n    const {\n        srcDir = \"src\",\n        port = 5173,\n        host = \"127.0.0.1\",\n        open = false,\n        proxy,\n        alias = {},\n        plugins = [],\n        icons = true,\n        overrides = {},\n    } = options;\n\n    const overridesConfig = overrides as UserConfig;\n    const iconsPlugin = icons\n        ? [tempestIcons({ dir: srcDir, ...(typeof icons === \"object\" ? icons : {}) })]\n        : [];\n\n    const base: UserConfig = {\n        plugins: [react(), ...iconsPlugin, tempestVitest(), ...plugins] as UserConfig[\"plugins\"],\n        resolve: {\n            alias: {\n                \"@\": resolve(process.cwd(), srcDir),\n                ...alias,\n            },\n        },\n        server: {\n            port,\n            host,\n            open,\n            ...(proxy ? { proxy: normalizeProxy(proxy) } : {}),\n        },\n    };\n\n    const merged: UserConfig = {\n        ...base,\n        ...overridesConfig,\n        plugins: [...(base.plugins ?? []), ...(overridesConfig.plugins ?? [])],\n        resolve: { ...base.resolve, ...overridesConfig.resolve },\n        server: { ...base.server, ...overridesConfig.server },\n    };\n\n    return defineConfig(merged) as TempestViteConfig;\n}\n"],"mappings":"wNA0DA,SAAS,EAAe,EAAiE,CACrF,IAAM,EAAoC,CAAC,EAC3C,IAAK,GAAM,CAAC,EAAM,KAAU,OAAO,QAAQ,CAAK,EAC5C,EAAI,GACA,OAAO,GAAU,SACX,CAAE,OAAQ,EAAO,aAAc,EAAK,EACnC,EAEf,OAAO,CACX,CAmBA,SAAgB,EAAiB,EAAmC,CAAC,EAAsB,CACvF,GAAM,CACF,SAAS,MACT,OAAO,KACP,OAAO,YACP,OAAO,GACP,QACA,QAAQ,CAAC,EACT,UAAU,CAAC,EACX,QAAQ,GACR,YAAY,CAAC,GACb,EAEE,EAAkB,EAClB,EAAc,EACd,CAAC,EAAA,aAAa,CAAE,IAAK,EAAQ,GAAI,OAAO,GAAU,SAAW,EAAQ,CAAC,CAAG,CAAC,CAAC,EAC3E,CAAC,EAED,EAAmB,CACrB,QAAS,EAAC,EAAA,EAAA,QAAA,CAAM,EAAG,GAAG,EAAa,EAAA,cAAc,EAAG,GAAG,CAAO,EAC9D,QAAS,CACL,MAAO,CACH,KAAA,EAAK,EAAA,QAAA,CAAQ,QAAQ,IAAI,EAAG,CAAM,EAClC,GAAG,CACP,CACJ,EACA,OAAQ,CACJ,OACA,OACA,OACA,GAAI,EAAQ,CAAE,MAAO,EAAe,CAAK,CAAE,EAAI,CAAC,CACpD,CACJ,EAEM,EAAqB,CACvB,GAAG,EACH,GAAG,EACH,QAAS,CAAC,GAAI,EAAK,SAAW,CAAC,EAAI,GAAI,EAAgB,SAAW,CAAC,CAAE,EACrE,QAAS,CAAE,GAAG,EAAK,QAAS,GAAG,EAAgB,OAAQ,EACvD,OAAQ,CAAE,GAAG,EAAK,OAAQ,GAAG,EAAgB,MAAO,CACxD,EAEA,OAAA,EAAO,EAAA,aAAA,CAAa,CAAM,CAC9B"}
+{"version":3,"file":"create-vite-config.cjs","names":[],"sources":["../../src/vite/create-vite-config.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { defineConfig } from \"vite\";\nimport type { PluginOption, ProxyOptions, UserConfig } from \"vite\";\n\nimport { tempestIcons, type TempestIconsOptions } from \"./tempest-icons\";\nimport { tempestVitest } from \"./tempest-vitest\";\n\n/**\n * A Vite proxy entry: either a target URL string (expanded to\n * `{ target, changeOrigin: true }`) or a raw Vite `ProxyOptions` object.\n */\nexport type ProxyEntry = string | Record<string, unknown>;\n\nexport interface CreateViteConfigOptions {\n    /**\n     * Source directory aliased to `@`, relative to the project root.\n     * Default: `\"src\"` (so `@/components/Button` → `<root>/src/components/Button`).\n     */\n    srcDir?: string;\n    /** Dev server port. Default: `5173`. */\n    port?: number;\n    /** Dev server host. Default: `\"127.0.0.1\"`. */\n    host?: string | boolean;\n    /** Open the browser on `dev` start. Default: `false`. */\n    open?: boolean;\n    /**\n     * Dev proxy table. String values are expanded to\n     * `{ target, changeOrigin: true }`; objects are passed through untouched.\n     *\n     * @example { \"/api\": \"http://127.0.0.1:8000\" }\n     */\n    proxy?: Record<string, ProxyEntry>;\n    /** Extra path aliases merged on top of the default `@` → src alias. */\n    alias?: Record<string, string>;\n    /** Vite plugins appended after `@vitejs/plugin-react`. */\n    plugins?: unknown[];\n    /**\n     * The `tempestIcons()` plugin, which generates `virtual:tempest-icons` from the\n     * icon slugs your source mentions. On by default — it only ever removes\n     * requests. Pass `false` to leave it out, or an options object to configure the\n     * scan.\n     */\n    icons?: boolean | TempestIconsOptions;\n    /**\n     * Arbitrary Vite config (a `UserConfig` object) deep-merged last, for\n     * escape-hatch overrides (build target, define, extra `server` keys, …).\n     */\n    overrides?: Record<string, unknown>;\n}\n\n/**\n * The resulting Vite config object. Typed loosely so the SDK's published\n * declarations stay free of `vite`'s internal types; assign it straight to a\n * `vite.config.ts` default export.\n */\nexport type TempestViteConfig = Record<string, unknown>;\n\nfunction normalizeProxy(proxy: Record<string, ProxyEntry>): Record<string, ProxyOptions> {\n    const out: Record<string, ProxyOptions> = {};\n    for (const [path, value] of Object.entries(proxy)) {\n        out[path] =\n            typeof value === \"string\"\n                ? { target: value, changeOrigin: true }\n                : (value as ProxyOptions);\n    }\n    return out;\n}\n\n/**\n * Load `@vitejs/plugin-react` when a config is built, not when this module loads.\n *\n * The plugin is an optional peer, and every helper of `tempest-react-sdk/vite`\n * ships through one barrel. A top-level import made the whole barrel require it:\n * a project without the React plugin could not load a config importing only\n * `tempestVitest` or `tempestCsp` (`ERR_MODULE_NOT_FOUND`, #401). Vite resolves a\n * promise in `plugins` before using it, so {@link createViteConfig} stays\n * synchronous and only it needs the peer.\n *\n * @returns The React plugin, once its module has loaded.\n */\nfunction reactPlugin(): Promise<PluginOption> {\n    return import(\"@vitejs/plugin-react\").then((module) => module.default());\n}\n\n/**\n * Build a Tempest-flavored Vite config for a React app: the `@vitejs/plugin-react`\n * plugin, the `@` → `src` import alias, sane dev-server defaults and\n * {@link tempestVitest}, which lets a Vitest suite import the SDK — so a\n * consuming app's `vite.config.ts` is a single call instead of repeated\n * boilerplate. Everything is overridable.\n *\n * Import it from the dedicated Node entry point:\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *     proxy: { \"/api\": \"http://127.0.0.1:8000\" },\n * });\n */\nexport function createViteConfig(options: CreateViteConfigOptions = {}): TempestViteConfig {\n    const {\n        srcDir = \"src\",\n        port = 5173,\n        host = \"127.0.0.1\",\n        open = false,\n        proxy,\n        alias = {},\n        plugins = [],\n        icons = true,\n        overrides = {},\n    } = options;\n\n    const overridesConfig = overrides as UserConfig;\n    const iconsPlugin = icons\n        ? [tempestIcons({ dir: srcDir, ...(typeof icons === \"object\" ? icons : {}) })]\n        : [];\n\n    const base: UserConfig = {\n        plugins: [\n            reactPlugin(),\n            ...iconsPlugin,\n            tempestVitest(),\n            ...plugins,\n        ] as UserConfig[\"plugins\"],\n        resolve: {\n            alias: {\n                \"@\": resolve(process.cwd(), srcDir),\n                ...alias,\n            },\n        },\n        server: {\n            port,\n            host,\n            open,\n            ...(proxy ? { proxy: normalizeProxy(proxy) } : {}),\n        },\n    };\n\n    const merged: UserConfig = {\n        ...base,\n        ...overridesConfig,\n        plugins: [...(base.plugins ?? []), ...(overridesConfig.plugins ?? [])],\n        resolve: { ...base.resolve, ...overridesConfig.resolve },\n        server: { ...base.server, ...overridesConfig.server },\n    };\n\n    return defineConfig(merged) as TempestViteConfig;\n}\n"],"mappings":"sHAyDA,SAAS,EAAe,EAAiE,CACrF,IAAM,EAAoC,CAAC,EAC3C,IAAK,GAAM,CAAC,EAAM,KAAU,OAAO,QAAQ,CAAK,EAC5C,EAAI,GACA,OAAO,GAAU,SACX,CAAE,OAAQ,EAAO,aAAc,EAAK,EACnC,EAEf,OAAO,CACX,CAcA,SAAS,GAAqC,CAC1C,OAAO,OAAO,uBAAuB,CAAC,KAAM,GAAW,EAAO,QAAQ,CAAC,CAC3E,CAmBA,SAAgB,EAAiB,EAAmC,CAAC,EAAsB,CACvF,GAAM,CACF,SAAS,MACT,OAAO,KACP,OAAO,YACP,OAAO,GACP,QACA,QAAQ,CAAC,EACT,UAAU,CAAC,EACX,QAAQ,GACR,YAAY,CAAC,GACb,EAEE,EAAkB,EAClB,EAAc,EACd,CAAC,EAAA,aAAa,CAAE,IAAK,EAAQ,GAAI,OAAO,GAAU,SAAW,EAAQ,CAAC,CAAG,CAAC,CAAC,EAC3E,CAAC,EAED,EAAmB,CACrB,QAAS,CACL,EAAY,EACZ,GAAG,EACH,EAAA,cAAc,EACd,GAAG,CACP,EACA,QAAS,CACL,MAAO,CACH,KAAA,EAAK,EAAA,QAAA,CAAQ,QAAQ,IAAI,EAAG,CAAM,EAClC,GAAG,CACP,CACJ,EACA,OAAQ,CACJ,OACA,OACA,OACA,GAAI,EAAQ,CAAE,MAAO,EAAe,CAAK,CAAE,EAAI,CAAC,CACpD,CACJ,EAEM,EAAqB,CACvB,GAAG,EACH,GAAG,EACH,QAAS,CAAC,GAAI,EAAK,SAAW,CAAC,EAAI,GAAI,EAAgB,SAAW,CAAC,CAAE,EACrE,QAAS,CAAE,GAAG,EAAK,QAAS,GAAG,EAAgB,OAAQ,EACvD,OAAQ,CAAE,GAAG,EAAK,OAAQ,GAAG,EAAgB,MAAO,CACxD,EAEA,OAAA,EAAO,EAAA,aAAA,CAAa,CAAM,CAC9B"}

package/dist/vite/create-vite-config.js

@@ -2,9 +2,8 @@ import { tempestIcons as e } from "./tempest-icons.js";
 import { tempestVitest as t } from "./tempest-vitest.js";
 import { resolve as n } from "node:path";
 import { defineConfig as r } from "vite";
-import i from "@vitejs/plugin-react";
 //#region src/vite/create-vite-config.ts
-function a(e) {
+function i(e) {
 	let t = {};
 	for (let [n, r] of Object.entries(e)) t[n] = typeof r == "string" ? {
 		target: r,
@@ -12,13 +11,16 @@ function a(e) {
 	} : r;
 	return t;
 }
+function a() {
+	return import("@vitejs/plugin-react").then((e) => e.default());
+}
 function o(o = {}) {
 	let { srcDir: s = "src", port: c = 5173, host: l = "127.0.0.1", open: u = !1, proxy: d, alias: f = {}, plugins: p = [], icons: m = !0, overrides: h = {} } = o, g = h, _ = m ? [e({
 		dir: s,
 		...typeof m == "object" ? m : {}
 	})] : [], v = {
 		plugins: [
-			i(),
+			a(),
 			..._,
 			t(),
 			...p
@@ -31,7 +33,7 @@ function o(o = {}) {
 			port: c,
 			host: l,
 			open: u,
-			...d ? { proxy: a(d) } : {}
+			...d ? { proxy: i(d) } : {}
 		}
 	}, y = {
 		...v,