npm - @schemavaults/theme - Versions diffs - 0.26.1 → 0.27.0 - Mend

@schemavaults/theme 0.26.1 → 0.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (22) hide show

package/README.md +36 -0
package/dist/TailwindConfigFactory.js +6 -0
package/dist/TailwindConfigFactory.js.map +1 -1
package/dist/component_colors.js +1 -1
package/dist/component_colors.js.map +1 -1
package/dist/hsl_channels.d.ts +17 -0
package/dist/hsl_channels.js +133 -0
package/dist/hsl_channels.js.map +1 -0
package/dist/index.d.ts +1 -0
package/dist/index.js +3 -0
package/dist/index.js.map +1 -1
package/dist/theme_overrides.d.ts +112 -0
package/dist/theme_overrides.js +171 -0
package/dist/theme_overrides.js.map +1 -0
package/dist/theme_tokens.d.ts +75 -0
package/dist/theme_tokens.js +149 -0
package/dist/theme_tokens.js.map +1 -0
package/dist/tokens.d.ts +12 -0
package/dist/tokens.js +11 -0
package/dist/tokens.js.map +1 -0
package/globals.css +78 -63
package/package.json +7 -1

package/README.md CHANGED Viewed

@@ -83,6 +83,42 @@ export default config;
 In the above example, local `.js`/`.ts`/`.jsx`/`.tsx` paths will be resolved in the app that `@schemavaults/theme` config factory is running in. Also, `@schemavaults/*` scoped packages will be resolved from `node_modules`.
+### Theming a deployment (overriding the tokens)
+`globals.css` declares every design token through an *override variable* with the stock value as its fallback:
+```css
+:root  { --background: var(--sv-theme-light-background, 0 0% 100%); }
+.dark  { --background: var(--sv-theme-dark-background, 222.2 84% 4.9%); }
+:root  { --radius: var(--sv-theme-radius, 0.5rem); }
+```
+So a white-labelled deployment re-themes itself by setting `--sv-theme-light-*`, `--sv-theme-dark-*` and (for tokens shared by both modes) `--sv-theme-*` on the `<html>` element — no fork of `globals.css`, and the stylesheet's defaults keep applying to whatever is not set. A light override only affects light mode; the `.dark` block reads its own variables.
+`@schemavaults/theme/tokens` (safe to import from browser bundles and client components — it has no Node.js dependencies, unlike the config factory at the package root) ships the manifest and the helpers:
+```typescript
+import {
+  THEME_TOKENS,                    // every token: id, css variable, format, group, label, description, light/dark defaults
+  createThemeOverrideStyle,        // ThemeOverrides -> { "--sv-theme-light-background": "210 40% 98%", ... }
+  renderThemeOverrideCss,          // ThemeOverrides -> ":root{--sv-theme-light-background:210 40% 98%;}"
+  resolveThemeTokens,              // every token with default + override + effective value, for a settings page
+  themeOverridesFromEnvironment,   // reads THEME_LIGHT_BACKGROUND, THEME_DARK_BACKGROUND, THEME_RADIUS, ...
+} from "@schemavaults/theme/tokens";
+// e.g. in a Next.js root layout
+const { overrides, problems } = themeOverridesFromEnvironment(process.env, { prefix: "THEME" });
+// problems: variables set to a value the token cannot take; they keep the default
+const style = createThemeOverrideStyle(overrides);
+// <html style={style}> ... </html>
+```
+Values are validated and normalised before they are emitted. Tokens whose format is `hsl-channels` (the shadcn/ui component colours the Tailwind theme wraps in `hsl()`) accept bare channels (`222.2 84% 4.9%`), a hex colour, or an opaque `rgb()`/`hsl()`, and are stored as channels; `css-color` tokens (the brand colours, `warning` and the sidebar) take any CSS colour; `radius` takes a CSS length. A value that could break the stylesheet or escape an attribute is refused with a reason you can show an administrator.
+Environment variable names follow the token id: `<PREFIX>_LIGHT_<TOKEN>`, `<PREFIX>_DARK_<TOKEN>` and `<PREFIX>_<TOKEN>` for shared tokens, upper-cased with hyphens as underscores (`sidebar-primary-foreground` → `THEME_DARK_SIDEBAR_PRIMARY_FOREGROUND`); `themeTokenEnvironmentVariable()` returns the name for a token and scope.
+The generated Tailwind config safelists the `dark` class so the `.dark` token block survives Tailwind's purge in applications that only add the class at runtime.
 ### CommonJS
 Note that currently CommonJS is not supported. I believe that I was struggling to get `tailwindcss-animate` working from CJS, then decided not to support it. Change your `tailwind.config.cjs` files to `tailwind.config.ts` or `tailwind.config.mjs` to use TypeScript or ES modules instead.

package/dist/TailwindConfigFactory.js CHANGED Viewed

@@ -255,6 +255,12 @@ export class SchemaVaultsTailwindConfigFactory {
             theme: { extend },
             plugins,
             darkMode: "class",
+            // globals.css declares the dark-mode tokens under `.dark` inside
+            // `@layer base`, and Tailwind drops a layered rule whose class it
+            // never sees in `content`. An application that adds the class at
+            // runtime (a theme toggle, a `dark` set from a preference) has no
+            // literal "dark" in its source, so the block is kept explicitly.
+            safelist: ["dark"],
         };
         console.assert(config.content.length >= 1, "Failed to load any 'content' search blobs to generate TailwindCSS classes for!");
         if (!config.content.every((blob) => typeof blob === "string")) {

package/dist/TailwindConfigFactory.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"TailwindConfigFactory.js","sourceRoot":"","sources":["../src/TailwindConfigFactory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,eAAe,MAAM,mBAAmB,CAAC,CAAC,wCAAwC;AACzF,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GAEtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEhD,uBAAuB;AACvB,OAAO,qBAAqB,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AA+BnC,MAAM,OAAO,iCAAiC;IAGzB,KAAK,CAAU;IAEf,KAAK,CAA4B;IACjC,MAAM,CAA4B;IAElC,KAAK,CAAS;IAEd,YAAY,CAAS;IAE9B,MAAM,CAAU,6BAA6B,GAAG;QACxD,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,KAAK;QACL,QAAQ;QACR,KAAK;KAC+B,CAAC;IAEpB,wBAAwB,CAAoB;IAE5C,iDAAiD,CAAoB;IAEhF,MAAM,CAAC,0BAA0B,CAAC,YAAoB;QAC5D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,QAAQ,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,CAAC;IAEO,MAAM,CAAC,2BAA2B,CAAC,aAAqB;QAC9D,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,QAAQ,CAAC,aAAa,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1C,CAAC;IAEO,MAAM,CAAC,mBAAmB,CAAC,KAAwB;QACzD,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACpD,CAAC;IAED,YAAmB,IAAoD;QACrE,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC;QAClC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,iCAAiC,CAAC,0BAA0B,CAAC;QAC1E,IAAI,CAAC,MAAM,GAAG,iCAAiC,CAAC,2BAA2B,CAAC;QAC5E,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,eAAe,CAAC;QAC5C,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,SAAS,CACjB,oEAAoE,CACrE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,iDAAiD,GAAG,KAAK,CAAC,OAAO,CACpE,IAAI,EAAE,cAAc,CACrB;YACC,CAAC,CAAC,IAAI,CAAC,cAAc;YACrB,CAAC,CAAC,iCAAiC,CAAC,6BAA6B,CAAC;QAEpE,IAAI,CAAC,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAExD,IAAI,CAAC,wBAAwB,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,mBAAmB,CAAC;YACtE,CAAC,CAAC,IAAI,CAAC,mBAAmB;YAC1B,CAAC,CAAC,iCAAiC,CAAC,+BAA+B,CAAC;QAEtE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CACT,qDAAqD,IAAI,CAAC,KAAK,kBAAkB,CAClF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,IAAc,OAAO;QACnB,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACjC,CAAC;IAED,IAAc,YAAY;QACxB,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,IAAc,WAAW;QACvB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAc,WAAW;QACvB,MAAM,aAAa,GACjB,qBAAqB,EAAE,CAAC;QAC1B,MAAM,WAAW,GAA2C,IAAI,GAAG,EAAE,CAAC;QACtE,KAAK,MAAM,UAAU,IAAI,aAAa,EAAE,CAAC;YACvC,MAAM,UAAU,GAAW,mBAAmB,CAAC,UAAU,CAAC,CAAC;YAC3D,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,UAAU,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,MAAM,GAAmC,MAAM,CAAC,WAAW,CAC/D,WAAW,CAAC,OAAO,EAAE,CACtB,CAAC;QAEF,OAAO,MAAmD,CAAC;IAC7D,CAAC;IAED,IAAc,cAAc;QAC1B,MAAM,OAAO,GAA8C,IAAI,CAAC,WAAW,CAAC;QAC5E,MAAM,MAAM,GAAmB;YAC7B,MAAM,EAAE;gBACN,GAAG,IAAI,CAAC,YAAY;gBACpB,GAAG,IAAI,CAAC,WAAW;aACpB;YACD,YAAY,EAAE;gBACZ,EAAE,EAAE,eAAe;gBACnB,EAAE,EAAE,2BAA2B;gBAC/B,EAAE,EAAE,2BAA2B;aAChC;YACD,OAAO;SACR,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACO,oCAAoC,CAC5C,6BAAqC;QAErC,MAAM,KAAK,GAAW,IAAI,CAAC,KAAK,CAAC;QACjC,IAAI,CAAC,6BAA6B,CAAC,UAAU,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CACb,kEAAkE,KAAK,MAAM,CAC9E,CAAC;QACJ,CAAC;QAED,MAAM,cAAc,GAAG,6BAA6B,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEhE,IACE,cAAc,CAAC,MAAM,GAAG,CAAC;YACzB,CAAC,cAAc,CAAC,CAAC,CAAC;YAClB,OAAO,cAAc,CAAC,CAAC,CAAC,KAAK,QAAQ,EACrC,CAAC;YACD,MAAM,IAAI,SAAS,CACjB,yDAAyD,CAC1D,CAAC;QACJ,CAAC;QACD,MAAM,YAAY,GAAW,cAAc,CAAC,CAAC,CAAC,CAAC;QAE/C,MAAM,sBAAsB,GAAW,IAAI,KAAK,IAAI,YAAY,EAAE,CAAC;QAEnE,IAAI,YAAoB,CAAC;QACzB,IAAI,CAAC;YACH,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE;gBAClD,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,wDAAwD;aACrF,CAAC,CAAC;YACH,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;gBACrC,MAAM,IAAI,SAAS,CACjB,sDAAsD,CACvD,CAAC;YACJ,CAAC;YAED,yEAAyE;YACzE,MAAM,iBAAiB,GAAG,CAAC,YAAoB,EAAW,EAAE;gBAC1D,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC9B,OAAO,KAAK,CAAC;gBACf,CAAC;qBAAM,CAAC;oBACN,IAAI,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;wBACnD,OAAO,IAAI,CAAC;oBACd,CAAC;yBAAM,CAAC;wBACN,OAAO,KAAK,CAAC;oBACf,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC,6BAA6B;YAEhC,+EAA+E;YAC/E,2EAA2E;YAC3E,kFAAkF;YAClF,6EAA6E;YAE7E,IAAI,YAAY,GAAG,YAAY,CAAC;YAChC,IAAI,8BAA8B,GAAG,EAAE,CAAC;YACxC,OAAO,YAAY,KAAK,GAAG,IAAI,YAAY,KAAK,EAAE,EAAE,CAAC;gBACnD,IAAI,8BAA8B,KAAK,CAAC,EAAE,CAAC;oBACzC,MAAM,IAAI,KAAK,CACb,gDAAgD,KAAK,IAAI,YAAY,wCAAwC,CAC9G,CAAC;gBACJ,CAAC;gBACD,8BAA8B,EAAE,CAAC;gBACjC,IAAI,iBAAiB,CAAC,YAAY,CAAC,EAAE,CAAC;oBACpC,MAAM;gBACR,CAAC;gBAED,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC9B,MAAM,IAAI,KAAK,CACb,gDAAgD,KAAK,IAAI,YAAY,YAAY,YAAY,4CAA4C,CAC1I,CAAC;gBACJ,CAAC;gBAED,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC7B,YAAY,GAAG,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;oBACnD,SAAS;gBACX,CAAC;qBAAM,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;oBACrC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;oBACrC,SAAS;gBACX,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,KAAK,CACb,0BAA0B,YAAY,uCAAuC,CAC9E,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,YAAY,GAAG,YAAY,CAAC;YAE5B,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,KAAK,CACb,kDAAkD,KAAK,IAAI,YAAY,cAAc,YAAY,iBAAiB,CACnH,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CACX,uCAAuC,KAAK,IAAI,YAAY,IAAI,EAChE,CAAC,CACF,CAAC;YACF,MAAM,IAAI,KAAK,CACb,wCAAwC,KAAK,IAAI,YAAY,IAAI,CAClE,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CACT,4EAA4E,KAAK,IAAI,YAAY,kBAAkB,EACnH,YAAY,CACb,CAAC;QACJ,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAEO,MAAM,CAAC,+BAA+B,GAAsB;QAClE,MAAM;QACN,KAAK;QACL,OAAO;QACP,KAAK;QACL,QAAQ;KACA,CAAC;IAEJ,YAAY,CACjB,IAAiD;QAEjD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,KAAK,GAAW,IAAI,CAAC,KAAK,CAAC;QAEjC,MAAM,wBAAwB,GAAG,eAAe,IAAI,CAAC,iDAAiD,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QAEpH,MAAM,aAAa,GAAsB,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;YACnE,CAAC,CAAC,IAAI,CAAC,OAAO;YACd,CAAC,CAAE,CAAC,wBAAwB,CAAuC,CAAC;QAEtE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,aAAa,CAAC,OAAO,CAAC,CAAC,kBAA0B,EAAQ,EAAE;YACzD,MAAM,uBAAuB,GAAW,OAAO,CAAC,MAAM,CAAC;YAEvD,IAAI,kBAAkB,CAAC,UAAU,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAChD,MAAM,YAAY,GAChB,IAAI,CAAC,oCAAoC,CAAC,kBAAkB,CAAC,CAAC;gBAEhE,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACjC,MAAM,IAAI,SAAS,CACjB,mEAAmE,kBAAkB,GAAG,CACzF,CAAC;gBACJ,CAAC;gBAED,IAAI,CAAC,wBAAwB,CAAC,OAAO,CACnC,CAAC,kBAA0B,EAAQ,EAAE;oBACnC,MAAM,eAAe,GAAW,IAAI,CAClC,YAAY,EACZ,kBAAkB,CACnB,CAAC;oBACF,IAAI,oBAAoB,GAAY,KAAK,CAAC;oBAC1C,IAAI,CAAC;wBACH,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;4BACf,OAAO,CAAC,GAAG,CACT,oFAAoF,EACpF,eAAe,CAChB,CAAC;wBACJ,CAAC;wBACD,oBAAoB,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;oBACrD,CAAC;oBAAC,OAAO,CAAU,EAAE,CAAC;wBACpB,OAAO,CAAC,KAAK,CACX,+GAA+G,EAC/G,CAAC,CACF,CAAC;wBACF,OAAO,CAAC,KAAK,CACX,iEAAiE,EACjE,eAAe,CAChB,CAAC;wBACF,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;oBACJ,CAAC;oBAED,IAAI,oBAAoB,EAAE,CAAC;wBACzB,MAAM,yBAAyB,GAAW,GAAG,eAAe,UAAU,IAAI,CAAC,iDAAiD,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;wBAC1I,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;wBACxC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;4BACf,OAAO,CAAC,GAAG,CACT,sCAAsC;gCACpC,0DAA0D,EAC5D,yBAAyB,CAC1B,CAAC;wBACJ,CAAC;oBACH,CAAC;gBACH,CAAC,CACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,yHAAyH;gBACzH,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACnC,CAAC;YAED,MAAM,qBAAqB,GAAW,OAAO,CAAC,MAAM,CAAC;YACrD,MAAM,4BAA4B,GAChC,qBAAqB,GAAG,uBAAuB,CAAC;YAElD,IACE,4BAA4B,GAAG,CAAC;gBAChC,kBAAkB,CAAC,UAAU,CAAC,IAAI,KAAK,GAAG,CAAC,EAC3C,CAAC;gBACD,OAAO,CAAC,IAAI,CACV,0EAA0E,iCAAiC,CAAC,mBAAmB,CAAC,IAAI,CAAC,wBAAwB,CAAC,gCAAgC,kBAAkB,IAAI,CACrN,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAA8B,IAAI,CAAC,OAAO,CAAC;QACxD,MAAM,MAAM,GAAmB,IAAI,CAAC,cAAc,CAAC;QAEnD,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;YACrB,KAAK,EAAE,EAAE,MAAM,EAAgC;YAC/C,OAAO;YACP,QAAQ,EAAE,OAAO;~~SACgB~~,CAAC;QAEpC,OAAO,CAAC,MAAM,CACZ,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,EAC1B,gFAAgF,CACjF,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAW,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,SAAS,CACjB,0FAA0F,CAC3F,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CACT,qEAAqE,EACrE,MAAM,CACP,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;;AAGH,eAAe,iCAAiC,CAAC"}
1	+ {"version":3,"file":"TailwindConfigFactory.js","sourceRoot":"","sources":["../src/TailwindConfigFactory.ts"],"names":[],"mappings":"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"}

package/dist/component_colors.js CHANGED Viewed

@@ -18,7 +18,7 @@ export const componentColors = {
     },
     warning: {
         DEFAULT: "var(--warning)",
-        foreground: "var(--destructive-foreground)",
+        foreground: "var(--warning-foreground)",
     },
     muted: {
         DEFAULT: "hsl(var(--muted))",

package/dist/component_colors.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"component_colors.js","sourceRoot":"","sources":["../src/component_colors.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,eAAe,GAAe;IACzC,MAAM,EAAE,oBAAoB;IAC5B,KAAK,EAAE,mBAAmB;IAC1B,IAAI,EAAE,kBAAkB;IACxB,UAAU,EAAE,wBAAwB;IACpC,UAAU,EAAE,wBAAwB;IACpC,OAAO,EAAE;QACP,OAAO,EAAE,qBAAqB;QAC9B,UAAU,EAAE,gCAAgC;KAC7C;IACD,SAAS,EAAE;QACT,OAAO,EAAE,uBAAuB;QAChC,UAAU,EAAE,kCAAkC;KAC/C;IACD,WAAW,EAAE;QACX,OAAO,EAAE,yBAAyB;QAClC,UAAU,EAAE,oCAAoC;KACjD;IACD,OAAO,EAAE;QACP,OAAO,EAAE,gBAAgB;QACzB,UAAU,EAAE~~,+BAA+B~~;~~KAC5C~~;IACD,KAAK,EAAE;QACL,OAAO,EAAE,mBAAmB;QAC5B,UAAU,EAAE,8BAA8B;KAC3C;IACD,MAAM,EAAE;QACN,OAAO,EAAE,oBAAoB;QAC7B,UAAU,EAAE,+BAA+B;KAC5C;IACD,OAAO,EAAE;QACP,OAAO,EAAE,qBAAqB;QAC9B,UAAU,EAAE,gCAAgC;KAC7C;IACD,IAAI,EAAE;QACJ,OAAO,EAAE,kBAAkB;QAC3B,UAAU,EAAE,6BAA6B;KAC1C;CACF,CAAC"}
1	+ {"version":3,"file":"component_colors.js","sourceRoot":"","sources":["../src/component_colors.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,eAAe,GAAe;IACzC,MAAM,EAAE,oBAAoB;IAC5B,KAAK,EAAE,mBAAmB;IAC1B,IAAI,EAAE,kBAAkB;IACxB,UAAU,EAAE,wBAAwB;IACpC,UAAU,EAAE,wBAAwB;IACpC,OAAO,EAAE;QACP,OAAO,EAAE,qBAAqB;QAC9B,UAAU,EAAE,gCAAgC;KAC7C;IACD,SAAS,EAAE;QACT,OAAO,EAAE,uBAAuB;QAChC,UAAU,EAAE,kCAAkC;KAC/C;IACD,WAAW,EAAE;QACX,OAAO,EAAE,yBAAyB;QAClC,UAAU,EAAE,oCAAoC;KACjD;IACD,OAAO,EAAE;QACP,OAAO,EAAE,gBAAgB;QACzB,UAAU,EAAE,2BAA2B;KACxC;IACD,KAAK,EAAE;QACL,OAAO,EAAE,mBAAmB;QAC5B,UAAU,EAAE,8BAA8B;KAC3C;IACD,MAAM,EAAE;QACN,OAAO,EAAE,oBAAoB;QAC7B,UAAU,EAAE,+BAA+B;KAC5C;IACD,OAAO,EAAE;QACP,OAAO,EAAE,qBAAqB;QAC9B,UAAU,EAAE,gCAAgC;KAC7C;IACD,IAAI,EAAE;QACJ,OAAO,EAAE,kBAAkB;QAC3B,UAAU,EAAE,6BAA6B;KAC1C;CACF,CAAC"}

package/dist/hsl_channels.d.ts ADDED Viewed

@@ -0,0 +1,17 @@
+/**
+ * Converts a CSS colour to the space-separated HSL channels the
+ * `hsl-channels` tokens expect (`222.2 84% 4.9%`), so a deployment can
+ * configure `#1e293b` rather than work the channels out by hand.
+ *
+ * Accepted inputs: bare channels, `#rgb`, `#rrggbb` (and their 4/8-digit
+ * forms when fully opaque), `rgb()` and `hsl()` with comma or space
+ * separators. Anything translucent is rejected — the channels carry no
+ * alpha, and silently dropping it would render a different colour.
+ */
+/** Red, green and blue in 0–255 to HSL channels in degrees and percentages. */
+export declare function rgbToHslChannels(red: number, green: number, blue: number): string;
+/**
+ * The HSL channels for a CSS colour, or null when the input is not a colour
+ * this understands (a named colour, an `oklch()`, anything translucent).
+ */
+export declare function toHslChannels(input: string): string | null;

package/dist/hsl_channels.js ADDED Viewed

@@ -0,0 +1,133 @@
+/**
+ * Converts a CSS colour to the space-separated HSL channels the
+ * `hsl-channels` tokens expect (`222.2 84% 4.9%`), so a deployment can
+ * configure `#1e293b` rather than work the channels out by hand.
+ *
+ * Accepted inputs: bare channels, `#rgb`, `#rrggbb` (and their 4/8-digit
+ * forms when fully opaque), `rgb()` and `hsl()` with comma or space
+ * separators. Anything translucent is rejected — the channels carry no
+ * alpha, and silently dropping it would render a different colour.
+ */
+const NUMBER = "-?(?:\\d+\\.?\\d*|\\.\\d+)";
+const BARE_CHANNELS = new RegExp(`^(${NUMBER})(?:deg)?\\s+(${NUMBER})%\\s+(${NUMBER})%$`);
+const HEX = /^#([0-9a-f]{3,8})$/i;
+const FUNCTIONAL = /^(rgba?|hsla?)\(\s*([^)]*?)\s*\)$/i;
+function formatChannel(value) {
+    const rounded = Math.round(value * 10) / 10;
+    return Number.isInteger(rounded) ? String(rounded) : rounded.toFixed(1);
+}
+function formatChannels(hue, saturation, lightness) {
+    const h = ((hue % 360) + 360) % 360;
+    return `${formatChannel(h)} ${formatChannel(saturation)}% ${formatChannel(lightness)}%`;
+}
+/** Red, green and blue in 0–255 to HSL channels in degrees and percentages. */
+export function rgbToHslChannels(red, green, blue) {
+    const r = red / 255;
+    const g = green / 255;
+    const b = blue / 255;
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    const delta = max - min;
+    const lightness = (max + min) / 2;
+    let hue = 0;
+    let saturation = 0;
+    if (delta !== 0) {
+        saturation = delta / (1 - Math.abs(2 * lightness - 1));
+        if (max === r)
+            hue = ((g - b) / delta) % 6;
+        else if (max === g)
+            hue = (b - r) / delta + 2;
+        else
+            hue = (r - g) / delta + 4;
+        hue *= 60;
+    }
+    return formatChannels(hue, saturation * 100, lightness * 100);
+}
+function isOpaqueAlpha(alpha) {
+    if (alpha === undefined)
+        return true;
+    if (alpha.endsWith("%"))
+        return Number(alpha.slice(0, -1)) === 100;
+    return Number(alpha) === 1;
+}
+function parseHex(digits) {
+    let expanded;
+    if (digits.length === 3 || digits.length === 4) {
+        expanded = digits
+            .split("")
+            .map((d) => d + d)
+            .join("");
+    }
+    else if (digits.length === 6 || digits.length === 8) {
+        expanded = digits;
+    }
+    else {
+        return null;
+    }
+    if (expanded.length === 8) {
+        if (expanded.slice(6).toLowerCase() !== "ff")
+            return null;
+        expanded = expanded.slice(0, 6);
+    }
+    const red = parseInt(expanded.slice(0, 2), 16);
+    const green = parseInt(expanded.slice(2, 4), 16);
+    const blue = parseInt(expanded.slice(4, 6), 16);
+    return rgbToHslChannels(red, green, blue);
+}
+function parseRgbComponent(component) {
+    if (component.endsWith("%")) {
+        const percent = Number(component.slice(0, -1));
+        return Number.isFinite(percent) ? (percent / 100) * 255 : null;
+    }
+    const value = Number(component);
+    return Number.isFinite(value) ? value : null;
+}
+function parseFunctional(name, body) {
+    // "r, g, b", "r g b", "r g b / a" and "r, g, b, a" all split the same way.
+    const parts = body.split(/\s*[,/]\s*|\s+/).filter((part) => part.length > 0);
+    if (parts.length < 3 || parts.length > 4)
+        return null;
+    const [first, second, third, alpha] = parts;
+    if (!isOpaqueAlpha(alpha))
+        return null;
+    if (name.startsWith("rgb")) {
+        const red = parseRgbComponent(first);
+        const green = parseRgbComponent(second);
+        const blue = parseRgbComponent(third);
+        if (red === null || green === null || blue === null)
+            return null;
+        const clamp = (v) => Math.min(255, Math.max(0, v));
+        return rgbToHslChannels(clamp(red), clamp(green), clamp(blue));
+    }
+    const hue = Number(first.replace(/deg$/i, ""));
+    if (!second.endsWith("%") || !third.endsWith("%"))
+        return null;
+    const saturation = Number(second.slice(0, -1));
+    const lightness = Number(third.slice(0, -1));
+    if (![hue, saturation, lightness].every(Number.isFinite))
+        return null;
+    return formatChannels(hue, saturation, lightness);
+}
+/**
+ * The HSL channels for a CSS colour, or null when the input is not a colour
+ * this understands (a named colour, an `oklch()`, anything translucent).
+ */
+export function toHslChannels(input) {
+    const value = input.trim();
+    if (value.length === 0)
+        return null;
+    const bare = BARE_CHANNELS.exec(value);
+    if (bare) {
+        const [, hue, saturation, lightness] = bare;
+        return formatChannels(Number(hue), Number(saturation), Number(lightness));
+    }
+    const hex = HEX.exec(value);
+    if (hex)
+        return parseHex(hex[1]);
+    const functional = FUNCTIONAL.exec(value);
+    if (functional) {
+        return parseFunctional(functional[1].toLowerCase(), functional[2]);
+    }
+    return null;
+}
+//# sourceMappingURL=hsl_channels.js.map

package/dist/hsl_channels.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"hsl_channels.js","sourceRoot":"","sources":["../src/hsl_channels.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts CHANGED Viewed

@@ -4,3 +4,4 @@ export type { SchemaVaultsBrandColor } from "./brand_colors";
 export { getSchemaVaultsBrandColor, brandColors } from "./brand_colors";
 export { getScreenBreakpoint, listScreenBreakpoints, isValidScreenBreakpoint, } from "./ScreenBreakpoints";
 export type { ScreenBreakpointID } from "./ScreenBreakpoints";
+export * from "./tokens";

package/dist/index.js CHANGED Viewed

@@ -2,4 +2,7 @@ export { SchemaVaultsTailwindConfigFactory, SchemaVaultsTailwindConfigFactory as
 export { default as withSchemaVaultsTailwindTheme } from "./withSchemaVaultsTailwindTheme";
 export { getSchemaVaultsBrandColor, brandColors } from "./brand_colors";
 export { getScreenBreakpoint, listScreenBreakpoints, isValidScreenBreakpoint, } from "./ScreenBreakpoints";
+// The token manifest and per-deployment override helpers; also available
+// without the Node.js-only config factory from "@schemavaults/theme/tokens".
+export * from "./tokens";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,EACjC,iCAAiC,IAAI,OAAO,GAC7C,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,OAAO,IAAI,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAG3F,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,EACjC,iCAAiC,IAAI,OAAO,GAC7C,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,OAAO,IAAI,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAG3F,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAG7B,yEAAyE;AACzE,6EAA6E;AAC7E,cAAc,UAAU,CAAC"}

package/dist/theme_overrides.d.ts ADDED Viewed

@@ -0,0 +1,112 @@
+import { type ThemeToken, type ThemeTokenID, type ThemeTokenScope } from "./theme_tokens";
+/**
+ * Overriding the stylesheet's tokens for one deployment.
+ *
+ * `globals.css` reads every token through an override variable:
+ *   `--background: var(--sv-theme-light-background, 0 0% 100%)`.
+ * The helpers here turn a `ThemeOverrides` object into those variables — as
+ * a style object for a framework's `<html style={…}>`, or as CSS text for a
+ * `<style>` element — after checking and normalising each value, so a hex
+ * colour becomes the HSL channels an `hsl-channels` token needs, and a
+ * value that would break the stylesheet (or escape an attribute) is
+ * refused rather than shipped.
+ *
+ * Values must be set only for the scopes a token has: `radius` is shared by
+ * both modes (`overrides.shared.radius`), every colour has a `light` and a
+ * `dark` value. A scope left out keeps the stylesheet default.
+ */
+/** Which tokens to override, per scope, keyed by token id. Values are raw: hex colours are fine. */
+export interface ThemeOverrides {
+    light?: Partial<Record<ThemeTokenID, string>>;
+    dark?: Partial<Record<ThemeTokenID, string>>;
+    shared?: Partial<Record<ThemeTokenID, string>>;
+}
+export declare const THEME_OVERRIDE_VARIABLE_PREFIX: "--sv-theme";
+/** The custom property `globals.css` reads a token's override from, e.g. `--sv-theme-dark-background`. */
+export declare function themeOverrideVariable(id: ThemeTokenID, scope: ThemeTokenScope): `--${string}`;
+/** Thrown for a value the token cannot take; `reason` is safe to show to an administrator. */
+export declare class ThemeTokenValueError extends Error {
+    readonly tokenId: ThemeTokenID;
+    readonly scope: ThemeTokenScope;
+    readonly value: string;
+    readonly reason: string;
+    constructor(tokenId: ThemeTokenID, scope: ThemeTokenScope, value: string, reason: string);
+}
+/**
+ * The value as `globals.css` should receive it, or a `ThemeTokenValueError`.
+ * `hsl-channels` tokens accept any opaque colour `toHslChannels` understands
+ * and come back as channels; the other formats are checked and trimmed.
+ */
+export declare function normalizeThemeTokenValue(token: ThemeToken, scope: ThemeTokenScope, rawValue: string): string;
+/**
+ * The override variables as a style object — `{ "--sv-theme-light-background": "210 40% 98%" }` —
+ * for the <html> element's `style` attribute (React passes custom properties
+ * through as given). Only the tokens set in `overrides` appear; a stylesheet
+ * default is never restated, so it keeps applying wherever nothing is set.
+ * Throws `ThemeTokenValueError` for a value a token cannot take.
+ */
+export declare function createThemeOverrideStyle(overrides: ThemeOverrides): Record<`--${string}`, string>;
+/**
+ * The same declarations as one CSS rule for a `<style>` element:
+ * `:root{--sv-theme-light-background:210 40% 98%;}`. Empty when nothing is
+ * overridden. `selector` should be the <html> element (`:root`) so the
+ * variables are inherited by the `.dark` block wherever the class is placed.
+ */
+export declare function renderThemeOverrideCss(overrides: ThemeOverrides, selector?: string): string;
+/** The token's effective value in one scope, for a settings page. */
+export interface ResolvedThemeTokenValue {
+    scope: ThemeTokenScope;
+    /** The stylesheet default. */
+    defaultValue: string;
+    /** The normalised override, or null when the default applies. */
+    override: string | null;
+    /** What the token renders as: the override when set, the default otherwise. */
+    value: string;
+    /** The custom property an override is delivered through. */
+    overrideVariable: `--${string}`;
+}
+export interface ResolvedThemeToken {
+    token: ThemeToken;
+    /** One entry per scope the token has: light and dark, or shared. */
+    values: ResolvedThemeTokenValue[];
+}
+/**
+ * Every token with its defaults and the overrides applied, in stylesheet
+ * order: the rows of a "theme" settings page. Throws for an invalid value,
+ * like `createThemeOverrideStyle`; validate with `themeOverridesFromEnvironment`
+ * (or catch `ThemeTokenValueError`) first when the values are untrusted.
+ */
+export declare function resolveThemeTokens(overrides?: ThemeOverrides): ResolvedThemeToken[];
+export interface ThemeEnvironmentOptions {
+    /** The variable name prefix; `THEME` reads `THEME_LIGHT_BACKGROUND`, `THEME_DARK_BACKGROUND` and `THEME_RADIUS`. */
+    prefix?: string;
+}
+/**
+ * The environment variable that configures a token in one scope:
+ * `<PREFIX>_<SCOPE>_<TOKEN>` for light and dark values and `<PREFIX>_<TOKEN>`
+ * for shared ones, with the token id upper-cased and hyphens turned into
+ * underscores (`sidebar-primary-foreground` → `THEME_LIGHT_SIDEBAR_PRIMARY_FOREGROUND`).
+ */
+export declare function themeTokenEnvironmentVariable(id: ThemeTokenID, scope: ThemeTokenScope, options?: ThemeEnvironmentOptions): string;
+/** A variable whose value was refused, with the reason to show an administrator. */
+export interface ThemeOverrideProblem {
+    variable: string;
+    tokenId: ThemeTokenID;
+    scope: ThemeTokenScope;
+    value: string;
+    reason: string;
+}
+export interface ThemeOverridesFromEnvironment {
+    /** The valid overrides, normalised; safe to pass to `createThemeOverrideStyle`. */
+    overrides: ThemeOverrides;
+    /** Variables that were set to something the token cannot take; those keep their defaults. */
+    problems: ThemeOverrideProblem[];
+}
+/**
+ * Reads every token's override from environment variables named by
+ * `themeTokenEnvironmentVariable`. A variable that is unset or blank leaves
+ * the default alone; an invalid value is reported in `problems` and skipped
+ * rather than thrown, so one typo in a deployment's configuration cannot
+ * take its pages down.
+ */
+export declare function themeOverridesFromEnvironment(env: Readonly<Record<string, string | undefined>>, options?: ThemeEnvironmentOptions): ThemeOverridesFromEnvironment;

package/dist/theme_overrides.js ADDED Viewed

@@ -0,0 +1,171 @@
+import { toHslChannels } from "./hsl_channels";
+import { getThemeToken, isThemeTokenId, listThemeTokens, themeTokenDefault, themeTokenHasScope, } from "./theme_tokens";
+export const THEME_OVERRIDE_VARIABLE_PREFIX = "--sv-theme";
+/** The custom property `globals.css` reads a token's override from, e.g. `--sv-theme-dark-background`. */
+export function themeOverrideVariable(id, scope) {
+    return scope === "shared"
+        ? `${THEME_OVERRIDE_VARIABLE_PREFIX}-${id}`
+        : `${THEME_OVERRIDE_VARIABLE_PREFIX}-${scope}-${id}`;
+}
+/** Thrown for a value the token cannot take; `reason` is safe to show to an administrator. */
+export class ThemeTokenValueError extends Error {
+    tokenId;
+    scope;
+    value;
+    reason;
+    constructor(tokenId, scope, value, reason) {
+        super(`Invalid ${scope} value for theme token '${tokenId}' (${JSON.stringify(value)}): ${reason}`);
+        this.name = "ThemeTokenValueError";
+        this.tokenId = tokenId;
+        this.scope = scope;
+        this.value = value;
+        this.reason = reason;
+    }
+}
+// Characters that could end the declaration, the rule or the attribute the
+// value is written into. No colour or length legitimately contains them.
+const UNSAFE_CHARACTERS = /[;{}<>"'\\\x00-\x1f]|\/\*/;
+const CSS_COLOR = /^(#[0-9a-f]{3,8}|[a-z]+|[a-z-]+\([\w\s.,%/+-]*\))$/i;
+const CSS_LENGTH = /^(0|-?(?:\d+\.?\d*|\.\d+)(px|rem|em|%|vh|vw|vmin|vmax|ch|ex))$/i;
+/**
+ * The value as `globals.css` should receive it, or a `ThemeTokenValueError`.
+ * `hsl-channels` tokens accept any opaque colour `toHslChannels` understands
+ * and come back as channels; the other formats are checked and trimmed.
+ */
+export function normalizeThemeTokenValue(token, scope, rawValue) {
+    const value = rawValue.trim();
+    if (!themeTokenHasScope(token, scope)) {
+        throw new ThemeTokenValueError(token.id, scope, rawValue, `the token has no ${scope} value; it takes ${token.scopes.map((s) => `'${s}'`).join(" and ")}`);
+    }
+    if (value.length === 0) {
+        throw new ThemeTokenValueError(token.id, scope, rawValue, "the value is empty");
+    }
+    if (UNSAFE_CHARACTERS.test(value)) {
+        throw new ThemeTokenValueError(token.id, scope, rawValue, "the value contains characters a CSS value cannot");
+    }
+    switch (token.format) {
+        case "hsl-channels": {
+            const channels = toHslChannels(value);
+            if (channels === null) {
+                throw new ThemeTokenValueError(token.id, scope, rawValue, "expected HSL channels ('222.2 84% 4.9%'), a hex colour, or an opaque rgb()/hsl() colour");
+            }
+            return channels;
+        }
+        case "css-color": {
+            if (!CSS_COLOR.test(value)) {
+                throw new ThemeTokenValueError(token.id, scope, rawValue, "expected a CSS colour such as '#60a5fa' or 'oklch(0.985 0 0)'");
+            }
+            return value;
+        }
+        case "length": {
+            if (!CSS_LENGTH.test(value)) {
+                throw new ThemeTokenValueError(token.id, scope, rawValue, "expected a CSS length such as '0.5rem' or '8px'");
+            }
+            return value;
+        }
+    }
+}
+function assertThemeTokenId(maybeId, scope) {
+    if (!isThemeTokenId(maybeId)) {
+        throw new Error(`Unknown theme token '${maybeId}' in the ${scope} overrides!`);
+    }
+    return maybeId;
+}
+function* eachOverride(overrides) {
+    for (const scope of ["light", "dark", "shared"]) {
+        const values = overrides[scope];
+        if (!values)
+            continue;
+        for (const [maybeId, rawValue] of Object.entries(values)) {
+            if (rawValue === undefined || rawValue === null)
+                continue;
+            const id = assertThemeTokenId(maybeId, scope);
+            yield [getThemeToken(id), scope, rawValue];
+        }
+    }
+}
+/**
+ * The override variables as a style object — `{ "--sv-theme-light-background": "210 40% 98%" }` —
+ * for the <html> element's `style` attribute (React passes custom properties
+ * through as given). Only the tokens set in `overrides` appear; a stylesheet
+ * default is never restated, so it keeps applying wherever nothing is set.
+ * Throws `ThemeTokenValueError` for a value a token cannot take.
+ */
+export function createThemeOverrideStyle(overrides) {
+    const style = {};
+    for (const [token, scope, rawValue] of eachOverride(overrides)) {
+        style[themeOverrideVariable(token.id, scope)] = normalizeThemeTokenValue(token, scope, rawValue);
+    }
+    return style;
+}
+/**
+ * The same declarations as one CSS rule for a `<style>` element:
+ * `:root{--sv-theme-light-background:210 40% 98%;}`. Empty when nothing is
+ * overridden. `selector` should be the <html> element (`:root`) so the
+ * variables are inherited by the `.dark` block wherever the class is placed.
+ */
+export function renderThemeOverrideCss(overrides, selector = ":root") {
+    const declarations = Object.entries(createThemeOverrideStyle(overrides)).map(([variable, value]) => `${variable}:${value};`);
+    if (declarations.length === 0)
+        return "";
+    return `${selector}{${declarations.join("")}}`;
+}
+/**
+ * Every token with its defaults and the overrides applied, in stylesheet
+ * order: the rows of a "theme" settings page. Throws for an invalid value,
+ * like `createThemeOverrideStyle`; validate with `themeOverridesFromEnvironment`
+ * (or catch `ThemeTokenValueError`) first when the values are untrusted.
+ */
+export function resolveThemeTokens(overrides = {}) {
+    const style = createThemeOverrideStyle(overrides);
+    return listThemeTokens().map((token) => ({
+        token,
+        values: token.scopes.map((scope) => {
+            const overrideVariable = themeOverrideVariable(token.id, scope);
+            const defaultValue = themeTokenDefault(token, scope);
+            const override = style[overrideVariable] ?? null;
+            return { scope, defaultValue, override, value: override ?? defaultValue, overrideVariable };
+        }),
+    }));
+}
+const DEFAULT_ENVIRONMENT_PREFIX = "THEME";
+/**
+ * The environment variable that configures a token in one scope:
+ * `<PREFIX>_<SCOPE>_<TOKEN>` for light and dark values and `<PREFIX>_<TOKEN>`
+ * for shared ones, with the token id upper-cased and hyphens turned into
+ * underscores (`sidebar-primary-foreground` → `THEME_LIGHT_SIDEBAR_PRIMARY_FOREGROUND`).
+ */
+export function themeTokenEnvironmentVariable(id, scope, options = {}) {
+    const prefix = options.prefix ?? DEFAULT_ENVIRONMENT_PREFIX;
+    const suffix = id.toUpperCase().replace(/-/g, "_");
+    return scope === "shared" ? `${prefix}_${suffix}` : `${prefix}_${scope.toUpperCase()}_${suffix}`;
+}
+/**
+ * Reads every token's override from environment variables named by
+ * `themeTokenEnvironmentVariable`. A variable that is unset or blank leaves
+ * the default alone; an invalid value is reported in `problems` and skipped
+ * rather than thrown, so one typo in a deployment's configuration cannot
+ * take its pages down.
+ */
+export function themeOverridesFromEnvironment(env, options = {}) {
+    const overrides = {};
+    const problems = [];
+    for (const token of listThemeTokens()) {
+        for (const scope of token.scopes) {
+            const variable = themeTokenEnvironmentVariable(token.id, scope, options);
+            const rawValue = env[variable];
+            if (rawValue === undefined || rawValue.trim().length === 0)
+                continue;
+            try {
+                const value = normalizeThemeTokenValue(token, scope, rawValue);
+                (overrides[scope] ??= {})[token.id] = value;
+            }
+            catch (error) {
+                const reason = error instanceof ThemeTokenValueError ? error.reason : String(error);
+                problems.push({ variable, tokenId: token.id, scope, value: rawValue, reason });
+            }
+        }
+    }
+    return { overrides, problems };
+}
+//# sourceMappingURL=theme_overrides.js.map

package/dist/theme_overrides.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"theme_overrides.js","sourceRoot":"","sources":["../src/theme_overrides.ts"],"names":[],"mappings":"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"}

package/dist/theme_tokens.d.ts ADDED Viewed

@@ -0,0 +1,75 @@
+/**
+ * The design tokens `globals.css` declares, as data: which CSS variable each
+ * one is, the value format it expects, its light and dark defaults, and a
+ * label and description an application can show on a theming settings page.
+ *
+ * `globals.css` declares every token as
+ *   `--token: var(--sv-theme-<scope>-<id>, <default>)`,
+ * so an application overrides a token by setting the override variable on
+ * the <html> element; see `theme_overrides.ts`. A unit test checks that the
+ * stylesheet and this manifest agree.
+ */
+/** Which stylesheet block a value belongs to: the light `:root`, the `.dark` class, or both. */
+export type ThemeTokenScope = "light" | "dark" | "shared";
+/** The two colour modes the stylesheet declares tokens for. */
+export type ThemeMode = Exclude<ThemeTokenScope, "shared">;
+/**
+ * How a token's value is written.
+ * - `hsl-channels`: the three space-separated channels of an HSL colour
+ *   (`222.2 84% 4.9%`), which the Tailwind theme wraps in `hsl()`.
+ * - `css-color`: any CSS `<color>` (`#60a5fa`, `oklch(0.985 0 0)`, `rgb(…)`).
+ * - `length`: a CSS `<length>` such as `0.5rem`.
+ */
+export type ThemeTokenFormat = "hsl-channels" | "css-color" | "length";
+/** A heading a settings page can group tokens under. */
+export type ThemeTokenGroup = "brand" | "page" | "surfaces" | "actions" | "states" | "outlines" | "shape" | "sidebar";
+interface ThemeTokenBase {
+    /** The CSS variable the token is read from, e.g. `--background`. */
+    readonly cssVariable: `--${string}`;
+    readonly format: ThemeTokenFormat;
+    readonly group: ThemeTokenGroup;
+    /** A short human-readable name, e.g. "Page background". */
+    readonly label: string;
+    /** Where the token shows up, for a settings page. */
+    readonly description: string;
+}
+/** A token with a separate value in light and dark mode. */
+export interface ModeThemeToken extends ThemeTokenBase {
+    readonly id: ModeThemeTokenID;
+    readonly scopes: readonly ["light", "dark"];
+    readonly defaults: {
+        readonly light: string;
+        readonly dark: string;
+    };
+}
+/** A token declared once, for both modes. */
+export interface SharedThemeToken extends ThemeTokenBase {
+    readonly id: SharedThemeTokenID;
+    readonly scopes: readonly ["shared"];
+    readonly defaults: {
+        readonly shared: string;
+    };
+}
+export type ThemeToken = ModeThemeToken | SharedThemeToken;
+declare const MODE_THEME_TOKEN_IDS: readonly ["brand-blue", "brand-red", "background", "foreground", "card", "card-foreground", "popover", "popover-foreground", "primary", "primary-foreground", "secondary", "secondary-foreground", "muted", "muted-foreground", "accent", "accent-foreground", "destructive", "destructive-foreground", "warning", "warning-foreground", "border", "input", "ring", "sidebar", "sidebar-foreground", "sidebar-primary", "sidebar-primary-foreground", "sidebar-accent", "sidebar-accent-foreground", "sidebar-border", "sidebar-ring"];
+declare const SHARED_THEME_TOKEN_IDS: readonly ["radius"];
+export type ModeThemeTokenID = (typeof MODE_THEME_TOKEN_IDS)[number];
+export type SharedThemeTokenID = (typeof SHARED_THEME_TOKEN_IDS)[number];
+export type ThemeTokenID = ModeThemeTokenID | SharedThemeTokenID;
+/**
+ * Every token, in the order `globals.css` declares them. Tokens whose format
+ * is `hsl-channels` are the shadcn/ui component colours the Tailwind theme
+ * exposes as `bg-background`, `text-primary-foreground` and so on.
+ */
+export declare const THEME_TOKENS: readonly ThemeToken[];
+/** Every token, in stylesheet order. */
+export declare function listThemeTokens(): readonly ThemeToken[];
+/** The ids of every token, in stylesheet order. */
+export declare function listThemeTokenIds(): readonly ThemeTokenID[];
+export declare function isThemeTokenId(maybeId: string): maybeId is ThemeTokenID;
+export declare function getThemeToken(id: ThemeTokenID): ThemeToken;
+/** Whether the token has a value in the given scope (`radius` has none in `light`). */
+export declare function themeTokenHasScope(token: ThemeToken, scope: ThemeTokenScope): boolean;
+/** The stylesheet's default for the token in a scope, or undefined when the scope does not apply. */
+export declare function themeTokenDefault(token: ThemeToken, scope: ThemeTokenScope): string | undefined;
+export {};

package/dist/theme_tokens.js ADDED Viewed

@@ -0,0 +1,149 @@
+/**
+ * The design tokens `globals.css` declares, as data: which CSS variable each
+ * one is, the value format it expects, its light and dark defaults, and a
+ * label and description an application can show on a theming settings page.
+ *
+ * `globals.css` declares every token as
+ *   `--token: var(--sv-theme-<scope>-<id>, <default>)`,
+ * so an application overrides a token by setting the override variable on
+ * the <html> element; see `theme_overrides.ts`. A unit test checks that the
+ * stylesheet and this manifest agree.
+ */
+const MODE_THEME_TOKEN_IDS = [
+    "brand-blue",
+    "brand-red",
+    "background",
+    "foreground",
+    "card",
+    "card-foreground",
+    "popover",
+    "popover-foreground",
+    "primary",
+    "primary-foreground",
+    "secondary",
+    "secondary-foreground",
+    "muted",
+    "muted-foreground",
+    "accent",
+    "accent-foreground",
+    "destructive",
+    "destructive-foreground",
+    "warning",
+    "warning-foreground",
+    "border",
+    "input",
+    "ring",
+    "sidebar",
+    "sidebar-foreground",
+    "sidebar-primary",
+    "sidebar-primary-foreground",
+    "sidebar-accent",
+    "sidebar-accent-foreground",
+    "sidebar-border",
+    "sidebar-ring",
+];
+const SHARED_THEME_TOKEN_IDS = ["radius"];
+const MODE_SCOPES = ["light", "dark"];
+const SHARED_SCOPES = ["shared"];
+function hsl(id, group, label, description, light, dark) {
+    return {
+        id,
+        cssVariable: `--${id}`,
+        format: "hsl-channels",
+        group,
+        label,
+        description,
+        scopes: MODE_SCOPES,
+        defaults: { light, dark },
+    };
+}
+function color(id, cssVariable, group, label, description, light, dark) {
+    return {
+        id,
+        cssVariable,
+        format: "css-color",
+        group,
+        label,
+        description,
+        scopes: MODE_SCOPES,
+        defaults: { light, dark },
+    };
+}
+/**
+ * Every token, in the order `globals.css` declares them. Tokens whose format
+ * is `hsl-channels` are the shadcn/ui component colours the Tailwind theme
+ * exposes as `bg-background`, `text-primary-foreground` and so on.
+ */
+export const THEME_TOKENS = [
+    color("brand-blue", "--schemavaults-brand-blue", "brand", "Brand blue", "The SchemaVaults brand blue, available as the `schemavaults-brand-blue` Tailwind colour.", "#60a5fa", "#60a5fa"),
+    color("brand-red", "--schemavaults-brand-red", "brand", "Brand red", "The SchemaVaults brand red, available as the `schemavaults-brand-red` Tailwind colour.", "#dc2626", "#dc2626"),
+    hsl("background", "page", "Page background", "The background of the page body.", "0 0% 100%", "222.2 84% 4.9%"),
+    hsl("foreground", "page", "Page text", "The default text colour on the page background.", "222.2 84% 4.9%", "210 40% 98%"),
+    hsl("card", "surfaces", "Card background", "The background of cards and panels.", "0 0% 100%", "222.2 84% 4.9%"),
+    hsl("card-foreground", "surfaces", "Card text", "Text on a card.", "222.2 84% 4.9%", "210 40% 98%"),
+    hsl("popover", "surfaces", "Popover background", "The background of dropdown menus, popovers and tooltips.", "0 0% 100%", "222.2 84% 4.9%"),
+    hsl("popover-foreground", "surfaces", "Popover text", "Text in a popover.", "222.2 84% 4.9%", "210 40% 98%"),
+    hsl("primary", "actions", "Primary", "Primary buttons, links and selected controls.", "222.2 47.4% 11.2%", "210 40% 98%"),
+    hsl("primary-foreground", "actions", "Primary text", "Text on a primary-coloured control.", "210 40% 98%", "222.2 47.4% 11.2%"),
+    hsl("secondary", "actions", "Secondary", "Secondary buttons and badges.", "210 40% 96.1%", "217.2 32.6% 17.5%"),
+    hsl("secondary-foreground", "actions", "Secondary text", "Text on a secondary-coloured control.", "222.2 47.4% 11.2%", "210 40% 98%"),
+    hsl("muted", "actions", "Muted", "Subdued backgrounds: table stripes, disabled controls, skeletons.", "210 40% 96.1%", "217.2 32.6% 17.5%"),
+    hsl("muted-foreground", "actions", "Muted text", "Secondary text such as descriptions and captions.", "215.4 16.3% 46.9%", "215 20.2% 65.1%"),
+    hsl("accent", "actions", "Accent", "Hover and focus backgrounds of menu items and list rows.", "210 40% 96.1%", "217.2 32.6% 17.5%"),
+    hsl("accent-foreground", "actions", "Accent text", "Text on an accent background.", "222.2 47.4% 11.2%", "210 40% 98%"),
+    hsl("destructive", "states", "Destructive", "Delete buttons and error states.", "0 84.2% 60.2%", "0 62.8% 30.6%"),
+    hsl("destructive-foreground", "states", "Destructive text", "Text on a destructive-coloured control.", "210 40% 98%", "210 40% 98%"),
+    color("warning", "--warning", "states", "Warning", "Warning callouts and badges.", "oklch(82% 0.189 84.429)", "oklch(82% 0.189 84.429)"),
+    color("warning-foreground", "--warning-foreground", "states", "Warning text", "Text on a warning background.", "oklch(41% 0.112 45.904)", "oklch(41% 0.112 45.904)"),
+    hsl("border", "outlines", "Border", "The default border colour of every element.", "214.3 31.8% 91.4%", "217.2 32.6% 17.5%"),
+    hsl("input", "outlines", "Input border", "The border of text inputs, selects and textareas.", "214.3 31.8% 91.4%", "217.2 32.6% 17.5%"),
+    hsl("ring", "outlines", "Focus ring", "The outline drawn around a focused control.", "222.2 84% 4.9%", "212.7 26.8% 83.9%"),
+    {
+        id: "radius",
+        cssVariable: "--radius",
+        format: "length",
+        group: "shape",
+        label: "Corner radius",
+        description: "The rounding of buttons, inputs and cards (`rounded-lg`); `rounded-md` and `rounded-sm` are derived from it.",
+        scopes: SHARED_SCOPES,
+        defaults: { shared: "0.5rem" },
+    },
+    color("sidebar", "--sidebar", "sidebar", "Sidebar background", "The background of the navigation sidebar.", "oklch(0.985 0 0)", "oklch(0.205 0 0)"),
+    color("sidebar-foreground", "--sidebar-foreground", "sidebar", "Sidebar text", "Text in the sidebar.", "oklch(0.145 0 0)", "oklch(0.985 0 0)"),
+    color("sidebar-primary", "--sidebar-primary", "sidebar", "Sidebar primary", "The active navigation item's background.", "oklch(0.205 0 0)", "oklch(0.488 0.243 264.376)"),
+    color("sidebar-primary-foreground", "--sidebar-primary-foreground", "sidebar", "Sidebar primary text", "Text of the active navigation item.", "oklch(0.985 0 0)", "oklch(0.985 0 0)"),
+    color("sidebar-accent", "--sidebar-accent", "sidebar", "Sidebar accent", "The hovered navigation item's background.", "oklch(0.97 0 0)", "oklch(0.269 0 0)"),
+    color("sidebar-accent-foreground", "--sidebar-accent-foreground", "sidebar", "Sidebar accent text", "Text of a hovered navigation item.", "oklch(0.205 0 0)", "oklch(0.985 0 0)"),
+    color("sidebar-border", "--sidebar-border", "sidebar", "Sidebar border", "The sidebar's edge and separators.", "oklch(0.922 0 0)", "oklch(1 0 0 / 10%)"),
+    color("sidebar-ring", "--sidebar-ring", "sidebar", "Sidebar focus ring", "The outline around a focused sidebar item.", "oklch(0.708 0 0)", "oklch(0.439 0 0)"),
+];
+const THEME_TOKENS_BY_ID = new Map(THEME_TOKENS.map((token) => [token.id, token]));
+/** Every token, in stylesheet order. */
+export function listThemeTokens() {
+    return THEME_TOKENS;
+}
+/** The ids of every token, in stylesheet order. */
+export function listThemeTokenIds() {
+    return THEME_TOKENS.map((token) => token.id);
+}
+export function isThemeTokenId(maybeId) {
+    return THEME_TOKENS_BY_ID.has(maybeId);
+}
+export function getThemeToken(id) {
+    const token = THEME_TOKENS_BY_ID.get(id);
+    if (!token) {
+        throw new Error(`Unknown theme token '${id}'! Valid tokens: ${listThemeTokenIds()
+            .map((k) => `'${k}'`)
+            .join(", ")}`);
+    }
+    return token;
+}
+/** Whether the token has a value in the given scope (`radius` has none in `light`). */
+export function themeTokenHasScope(token, scope) {
+    return token.scopes.includes(scope);
+}
+/** The stylesheet's default for the token in a scope, or undefined when the scope does not apply. */
+export function themeTokenDefault(token, scope) {
+    return token.defaults[scope];
+}
+//# sourceMappingURL=theme_tokens.js.map

package/dist/theme_tokens.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"theme_tokens.js","sourceRoot":"","sources":["../src/theme_tokens.ts"],"names":[],"mappings":"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"}

package/dist/tokens.d.ts ADDED Viewed

@@ -0,0 +1,12 @@
+/**
+ * "@schemavaults/theme/tokens": the token manifest and the override helpers.
+ * Everything here is plain data and pure functions with no Node.js
+ * dependencies, so it can be imported from browser bundles and client
+ * components — unlike the package root, whose Tailwind config factory reads
+ * the filesystem.
+ */
+export { THEME_TOKENS, listThemeTokens, listThemeTokenIds, isThemeTokenId, getThemeToken, themeTokenHasScope, themeTokenDefault, } from "./theme_tokens";
+export type { ThemeToken, ModeThemeToken, SharedThemeToken, ThemeTokenID, ModeThemeTokenID, SharedThemeTokenID, ThemeTokenScope, ThemeMode, ThemeTokenFormat, ThemeTokenGroup, } from "./theme_tokens";
+export { THEME_OVERRIDE_VARIABLE_PREFIX, ThemeTokenValueError, themeOverrideVariable, normalizeThemeTokenValue, createThemeOverrideStyle, renderThemeOverrideCss, resolveThemeTokens, themeTokenEnvironmentVariable, themeOverridesFromEnvironment, } from "./theme_overrides";
+export type { ThemeOverrides, ResolvedThemeToken, ResolvedThemeTokenValue, ThemeEnvironmentOptions, ThemeOverrideProblem, ThemeOverridesFromEnvironment, } from "./theme_overrides";
+export { toHslChannels, rgbToHslChannels } from "./hsl_channels";

package/dist/tokens.js ADDED Viewed

@@ -0,0 +1,11 @@
+/**
+ * "@schemavaults/theme/tokens": the token manifest and the override helpers.
+ * Everything here is plain data and pure functions with no Node.js
+ * dependencies, so it can be imported from browser bundles and client
+ * components — unlike the package root, whose Tailwind config factory reads
+ * the filesystem.
+ */
+export { THEME_TOKENS, listThemeTokens, listThemeTokenIds, isThemeTokenId, getThemeToken, themeTokenHasScope, themeTokenDefault, } from "./theme_tokens";
+export { THEME_OVERRIDE_VARIABLE_PREFIX, ThemeTokenValueError, themeOverrideVariable, normalizeThemeTokenValue, createThemeOverrideStyle, renderThemeOverrideCss, resolveThemeTokens, themeTokenEnvironmentVariable, themeOverridesFromEnvironment, } from "./theme_overrides";
+export { toHslChannels, rgbToHslChannels } from "./hsl_channels";
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAcxB,OAAO,EACL,8BAA8B,EAC9B,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC;AAU3B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/globals.css CHANGED Viewed

@@ -2,97 +2,112 @@
 @tailwind components;
 @tailwind utilities;
+/*
+ * Every design token below is declared as
+ *     --token: var(--sv-theme-<mode>-<token>, <default>);
+ * so an application can re-theme a deployment without replacing this file:
+ * set the `--sv-theme-light-*` / `--sv-theme-dark-*` (or, for tokens shared by
+ * both modes, `--sv-theme-*`) custom properties on the <html> element — as an
+ * inline style attribute, or from a <style> element — and the matching token
+ * picks the value up in that mode only. An override variable that is not set
+ * leaves the default in place.
+ *
+ * `createThemeOverrideStyle()` / `renderThemeOverrideCss()` from
+ * "@schemavaults/theme/tokens" build those declarations, and
+ * `THEME_TOKENS` lists every token, its format and its defaults; a test keeps
+ * that manifest and this file in step.
+ */
 @layer base {
     :root {
-        --schemavaults-brand-blue: #60a5fa;
-        --schemavaults-brand-red: #dc2626;
+        --schemavaults-brand-blue: var(--sv-theme-light-brand-blue, #60a5fa);
+        --schemavaults-brand-red: var(--sv-theme-light-brand-red, #dc2626);
-        --background: 0 0% 100%;
-        --foreground: 222.2 84% 4.9%;
+        --background: var(--sv-theme-light-background, 0 0% 100%);
+        --foreground: var(--sv-theme-light-foreground, 222.2 84% 4.9%);
-        --card: 0 0% 100%;
-        --card-foreground: 222.2 84% 4.9%;
+        --card: var(--sv-theme-light-card, 0 0% 100%);
+        --card-foreground: var(--sv-theme-light-card-foreground, 222.2 84% 4.9%);
-        --popover: 0 0% 100%;
-        --popover-foreground: 222.2 84% 4.9%;
+        --popover: var(--sv-theme-light-popover, 0 0% 100%);
+        --popover-foreground: var(--sv-theme-light-popover-foreground, 222.2 84% 4.9%);
-        --primary: 222.2 47.4% 11.2%;
-        --primary-foreground: 210 40% 98%;
+        --primary: var(--sv-theme-light-primary, 222.2 47.4% 11.2%);
+        --primary-foreground: var(--sv-theme-light-primary-foreground, 210 40% 98%);
-        --secondary: 210 40% 96.1%;
-        --secondary-foreground: 222.2 47.4% 11.2%;
+        --secondary: var(--sv-theme-light-secondary, 210 40% 96.1%);
+        --secondary-foreground: var(--sv-theme-light-secondary-foreground, 222.2 47.4% 11.2%);
-        --muted: 210 40% 96.1%;
-        --muted-foreground: 215.4 16.3% 46.9%;
+        --muted: var(--sv-theme-light-muted, 210 40% 96.1%);
+        --muted-foreground: var(--sv-theme-light-muted-foreground, 215.4 16.3% 46.9%);
-        --accent: 210 40% 96.1%;
-        --accent-foreground: 222.2 47.4% 11.2%;
+        --accent: var(--sv-theme-light-accent, 210 40% 96.1%);
+        --accent-foreground: var(--sv-theme-light-accent-foreground, 222.2 47.4% 11.2%);
-        --destructive: 0 84.2% 60.2%;
-        --destructive-foreground: 210 40% 98%;
+        --destructive: var(--sv-theme-light-destructive, 0 84.2% 60.2%);
+        --destructive-foreground: var(--sv-theme-light-destructive-foreground, 210 40% 98%);
-        --warning: oklch(82% 0.189 84.429);
-        --warning-foreground: oklch(41% 0.112 45.904);
+        --warning: var(--sv-theme-light-warning, oklch(82% 0.189 84.429));
+        --warning-foreground: var(--sv-theme-light-warning-foreground, oklch(41% 0.112 45.904));
-        --border: 214.3 31.8% 91.4%;
-        --input: 214.3 31.8% 91.4%;
-        --ring: 222.2 84% 4.9%;
+        --border: var(--sv-theme-light-border, 214.3 31.8% 91.4%);
+        --input: var(--sv-theme-light-input, 214.3 31.8% 91.4%);
+        --ring: var(--sv-theme-light-ring, 222.2 84% 4.9%);
-        --radius: 0.5rem;
+        --radius: var(--sv-theme-radius, 0.5rem);
-        --sidebar: oklch(0.985 0 0);
-        --sidebar-foreground: oklch(0.145 0 0);
-        --sidebar-primary: oklch(0.205 0 0);
-        --sidebar-primary-foreground: oklch(0.985 0 0);
-        --sidebar-accent: oklch(0.97 0 0);
-        --sidebar-accent-foreground: oklch(0.205 0 0);
-        --sidebar-border: oklch(0.922 0 0);
-        --sidebar-ring: oklch(0.708 0 0);
+        --sidebar: var(--sv-theme-light-sidebar, oklch(0.985 0 0));
+        --sidebar-foreground: var(--sv-theme-light-sidebar-foreground, oklch(0.145 0 0));
+        --sidebar-primary: var(--sv-theme-light-sidebar-primary, oklch(0.205 0 0));
+        --sidebar-primary-foreground: var(--sv-theme-light-sidebar-primary-foreground, oklch(0.985 0 0));
+        --sidebar-accent: var(--sv-theme-light-sidebar-accent, oklch(0.97 0 0));
+        --sidebar-accent-foreground: var(--sv-theme-light-sidebar-accent-foreground, oklch(0.205 0 0));
+        --sidebar-border: var(--sv-theme-light-sidebar-border, oklch(0.922 0 0));
+        --sidebar-ring: var(--sv-theme-light-sidebar-ring, oklch(0.708 0 0));
     }
     .dark {
-        --schemavaults-brand-blue: #60a5fa;
-        --schemavaults-brand-red: #dc2626;
+        --schemavaults-brand-blue: var(--sv-theme-dark-brand-blue, #60a5fa);
+        --schemavaults-brand-red: var(--sv-theme-dark-brand-red, #dc2626);
-        --background: 222.2 84% 4.9%;
-        --foreground: 210 40% 98%;
+        --background: var(--sv-theme-dark-background, 222.2 84% 4.9%);
+        --foreground: var(--sv-theme-dark-foreground, 210 40% 98%);
-        --card: 222.2 84% 4.9%;
-        --card-foreground: 210 40% 98%;
+        --card: var(--sv-theme-dark-card, 222.2 84% 4.9%);
+        --card-foreground: var(--sv-theme-dark-card-foreground, 210 40% 98%);
-        --popover: 222.2 84% 4.9%;
-        --popover-foreground: 210 40% 98%;
+        --popover: var(--sv-theme-dark-popover, 222.2 84% 4.9%);
+        --popover-foreground: var(--sv-theme-dark-popover-foreground, 210 40% 98%);
-        --primary: 210 40% 98%;
-        --primary-foreground: 222.2 47.4% 11.2%;
+        --primary: var(--sv-theme-dark-primary, 210 40% 98%);
+        --primary-foreground: var(--sv-theme-dark-primary-foreground, 222.2 47.4% 11.2%);
-        --secondary: 217.2 32.6% 17.5%;
-        --secondary-foreground: 210 40% 98%;
+        --secondary: var(--sv-theme-dark-secondary, 217.2 32.6% 17.5%);
+        --secondary-foreground: var(--sv-theme-dark-secondary-foreground, 210 40% 98%);
-        --muted: 217.2 32.6% 17.5%;
-        --muted-foreground: 215 20.2% 65.1%;
+        --muted: var(--sv-theme-dark-muted, 217.2 32.6% 17.5%);
+        --muted-foreground: var(--sv-theme-dark-muted-foreground, 215 20.2% 65.1%);
-        --accent: 217.2 32.6% 17.5%;
-        --accent-foreground: 210 40% 98%;
+        --accent: var(--sv-theme-dark-accent, 217.2 32.6% 17.5%);
+        --accent-foreground: var(--sv-theme-dark-accent-foreground, 210 40% 98%);
-        --destructive: 0 62.8% 30.6%;
-        --destructive-foreground: 210 40% 98%;
+        --destructive: var(--sv-theme-dark-destructive, 0 62.8% 30.6%);
+        --destructive-foreground: var(--sv-theme-dark-destructive-foreground, 210 40% 98%);
-        --warning: oklch(82% 0.189 84.429);
-        --warning-foreground: oklch(41% 0.112 45.904);
+        --warning: var(--sv-theme-dark-warning, oklch(82% 0.189 84.429));
+        --warning-foreground: var(--sv-theme-dark-warning-foreground, oklch(41% 0.112 45.904));
-        --border: 217.2 32.6% 17.5%;
-        --input: 217.2 32.6% 17.5%;
-        --ring: 212.7 26.8% 83.9%;
+        --border: var(--sv-theme-dark-border, 217.2 32.6% 17.5%);
+        --input: var(--sv-theme-dark-input, 217.2 32.6% 17.5%);
+        --ring: var(--sv-theme-dark-ring, 212.7 26.8% 83.9%);
-        --sidebar: oklch(0.205 0 0);
-        --sidebar-foreground: oklch(0.985 0 0);
-        --sidebar-primary: oklch(0.488 0.243 264.376);
-        --sidebar-primary-foreground: oklch(0.985 0 0);
-        --sidebar-accent: oklch(0.269 0 0);
-        --sidebar-accent-foreground: oklch(0.985 0 0);
-        --sidebar-border: oklch(1 0 0 / 10%);
-        --sidebar-ring: oklch(0.439 0 0);
+        --sidebar: var(--sv-theme-dark-sidebar, oklch(0.205 0 0));
+        --sidebar-foreground: var(--sv-theme-dark-sidebar-foreground, oklch(0.985 0 0));
+        --sidebar-primary: var(--sv-theme-dark-sidebar-primary, oklch(0.488 0.243 264.376));
+        --sidebar-primary-foreground: var(--sv-theme-dark-sidebar-primary-foreground, oklch(0.985 0 0));
+        --sidebar-accent: var(--sv-theme-dark-sidebar-accent, oklch(0.269 0 0));
+        --sidebar-accent-foreground: var(--sv-theme-dark-sidebar-accent-foreground, oklch(0.985 0 0));
+        --sidebar-border: var(--sv-theme-dark-sidebar-border, oklch(1 0 0 / 10%));
+        --sidebar-ring: var(--sv-theme-dark-sidebar-ring, oklch(0.439 0 0));
     }
 }

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@schemavaults/theme",
   "description": "TailwindCSS theme shared by different SchemaVaults applications",
-  "version": "0.26.1",
+  "version": "0.27.0",
   "private": false,
   "license": "UNLICENSED",
   "repository": {
@@ -57,6 +57,12 @@
       "node": "./dist/brand_colors.js",
       "import": "./dist/brand_colors.js"
     },
+    "./tokens": {
+      "types": "./dist/tokens.d.ts",
+      "require": "./dist/tokens.js",
+      "node": "./dist/tokens.js",
+      "import": "./dist/tokens.js"
+    },
     ".": {
       "types": "./dist/index.d.ts",
       "require": "./dist/index.js",