@xenition/ui 0.1.0

package/dist/primitives/useForm.js

@@ -0,0 +1,66 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useForm = useForm;
+const React = __importStar(require("react"));
+/**
+ * Headless controlled-form helper: tracks values/errors/submitting, validates on
+ * submit, and drives the async `onSubmit`. Pairs with `Field` + `Form` and the
+ * composed auth forms. No dependency on `@xenition/sdk` — pass your own submit.
+ */
+function useForm(options) {
+    const [values, setValues] = React.useState(options.initialValues);
+    const [errors, setErrors] = React.useState({});
+    const [submitting, setSubmitting] = React.useState(false);
+    const setValue = React.useCallback((key, value) => {
+        setValues((s) => ({ ...s, [key]: value }));
+    }, []);
+    const handleSubmit = React.useCallback(async (e) => {
+        e?.preventDefault();
+        const errs = options.validate ? options.validate(values) : {};
+        setErrors(errs);
+        if (Object.keys(errs).length > 0)
+            return;
+        setSubmitting(true);
+        try {
+            await options.onSubmit(values);
+        }
+        finally {
+            setSubmitting(false);
+        }
+    }, [options, values]);
+    return { values, errors, submitting, setValue, setValues, setErrors, handleSubmit };
+}
+//# sourceMappingURL=useForm.js.map

package/dist/primitives/useForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useForm.js","sourceRoot":"","sources":["../../src/primitives/useForm.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,0BA0BC;AAnDD,6CAA+B;AAoB/B;;;;GAIG;AACH,SAAgB,OAAO,CAAmB,OAA0B;IAClE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IACrE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAmC,EAAE,CAAC,CAAC;IACjF,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE1D,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,CAAoB,GAAM,EAAE,KAAW,EAAE,EAAE;QAC5E,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAM,CAAC,CAAC;IAClD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CACpC,KAAK,EAAE,CAAmB,EAAE,EAAE;QAC5B,CAAC,EAAE,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO;QACzC,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,EAAE,MAAM,CAAC,CAClB,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AACtF,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,27 @@
+import * as React from 'react';
+import type { CompiledTheme, ThemeSeed } from './theme/types';
+/** Narrow a `ThemeSeed | CompiledTheme` union to the compiled form. */
+export declare function isCompiledTheme(theme: ThemeSeed | CompiledTheme): theme is CompiledTheme;
+export interface XenitionUIProviderProps {
+    /** A raw seed (compiled on the fly) or an already-compiled theme. */
+    theme: ThemeSeed | CompiledTheme;
+    /**
+     * Active color scheme. Defaults from the seed: `'dark'` when
+     * `seed.mode === 'dark'`, otherwise `'light'`. Only meaningful when the
+     * seed mode is `'both'`, where it toggles the `data-theme` attribute.
+     */
+    mode?: 'light' | 'dark';
+    children?: React.ReactNode;
+}
+/**
+ * Root theme provider for web apps.
+ *
+ * Compiles the seed (if needed), injects the `--xen-*` CSS custom properties
+ * via a `<style>` tag, and stamps `data-theme` on a wrapper so the
+ * `[data-theme="dark"]` overrides apply. Place once at the app root, above
+ * any `@xenition/ui` component.
+ */
+export declare function XenitionUIProvider({ theme, mode, children, }: XenitionUIProviderProps): React.ReactElement;
+/** Access the compiled theme from anywhere below `XenitionUIProvider`. */
+export declare function useXenitionCompiledTheme(): CompiledTheme;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE9D,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,aAAa,GAAG,KAAK,IAAI,aAAa,CAIxF;AAID,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,KAAK,EAAE,SAAS,GAAG,aAAa,CAAC;IACjC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,IAAI,EACJ,QAAQ,GACT,EAAE,uBAAuB,GAAG,KAAK,CAAC,YAAY,CAgB9C;AAED,0EAA0E;AAC1E,wBAAgB,wBAAwB,IAAI,aAAa,CAQxD"}

package/dist/provider.js

@@ -0,0 +1,70 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCompiledTheme = isCompiledTheme;
+exports.XenitionUIProvider = XenitionUIProvider;
+exports.useXenitionCompiledTheme = useXenitionCompiledTheme;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const React = __importStar(require("react"));
+const compile_1 = require("./theme/compile");
+const outputs_1 = require("./theme/outputs");
+/** Narrow a `ThemeSeed | CompiledTheme` union to the compiled form. */
+function isCompiledTheme(theme) {
+    return (typeof theme === 'object' && theme !== null && 'ramps' in theme && 'light' in theme);
+}
+const XenitionThemeContext = React.createContext(null);
+/**
+ * Root theme provider for web apps.
+ *
+ * Compiles the seed (if needed), injects the `--xen-*` CSS custom properties
+ * via a `<style>` tag, and stamps `data-theme` on a wrapper so the
+ * `[data-theme="dark"]` overrides apply. Place once at the app root, above
+ * any `@xenition/ui` component.
+ */
+function XenitionUIProvider({ theme, mode, children, }) {
+    const compiled = React.useMemo(() => (isCompiledTheme(theme) ? theme : (0, compile_1.compileTheme)(theme)), [theme]);
+    const css = React.useMemo(() => (0, outputs_1.toCssVars)(compiled), [compiled]);
+    const resolvedMode = mode ?? (compiled.seed.mode === 'dark' ? 'dark' : 'light');
+    return ((0, jsx_runtime_1.jsxs)(XenitionThemeContext.Provider, { value: compiled, children: [(0, jsx_runtime_1.jsx)("style", { "data-xenition-theme": "", dangerouslySetInnerHTML: { __html: css } }), (0, jsx_runtime_1.jsx)("div", { "data-theme": resolvedMode, style: { display: 'contents' }, children: children })] }));
+}
+/** Access the compiled theme from anywhere below `XenitionUIProvider`. */
+function useXenitionCompiledTheme() {
+    const compiled = React.useContext(XenitionThemeContext);
+    if (compiled === null) {
+        throw new Error('useXenitionCompiledTheme must be used inside <XenitionUIProvider theme={...}>.');
+    }
+    return compiled;
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,0CAIC;AAwBD,gDAoBC;AAGD,4DAQC;;AAjED,6CAA+B;AAC/B,6CAA+C;AAC/C,6CAA4C;AAG5C,uEAAuE;AACvE,SAAgB,eAAe,CAAC,KAAgC;IAC9D,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,CACpF,CAAC;AACJ,CAAC;AAED,MAAM,oBAAoB,GAAG,KAAK,CAAC,aAAa,CAAuB,IAAI,CAAC,CAAC;AAc7E;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,IAAI,EACJ,QAAQ,GACgB;IACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAC5B,GAAG,EAAE,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,sBAAY,EAAC,KAAK,CAAC,CAAC,EAC5D,CAAC,KAAK,CAAC,CACR,CAAC;IACF,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAA,mBAAS,EAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAEhF,OAAO,CACL,wBAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,aAC5C,yDAA2B,EAAE,EAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAI,EAC1E,8CAAiB,YAAY,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,YAC1D,QAAQ,GACL,IACwB,CACjC,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,SAAgB,wBAAwB;IACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACxD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/tailwind-preset/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `@xenition/ui/tailwind-preset` — Tailwind preset bound to the `--xen-*`
+ * CSS variables injected by `XenitionUIProvider` (or a build-time
+ * `toCssVars` dump).
+ *
+ * ```js
+ * // tailwind.config.js of a generated app
+ * const { compileTheme } = require('@xenition/ui/theme');
+ * const { toTailwindPreset } = require('@xenition/ui/tailwind-preset');
+ * const seed = require('./theme.seed.json');
+ *
+ * module.exports = {
+ *   presets: [toTailwindPreset(compileTheme(seed))],
+ *   content: ['./src/**\/*.{ts,tsx}', './node_modules/@xenition/ui/**\/*.js'],
+ * };
+ * ```
+ */
+export { toTailwindPreset, toTailwindPreset as default } from '../theme/outputs';
+export type { TailwindPreset } from '../theme/outputs';
+//# sourceMappingURL=index.d.ts.map

package/dist/tailwind-preset/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tailwind-preset/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACjF,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/tailwind-preset/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * `@xenition/ui/tailwind-preset` — Tailwind preset bound to the `--xen-*`
+ * CSS variables injected by `XenitionUIProvider` (or a build-time
+ * `toCssVars` dump).
+ *
+ * ```js
+ * // tailwind.config.js of a generated app
+ * const { compileTheme } = require('@xenition/ui/theme');
+ * const { toTailwindPreset } = require('@xenition/ui/tailwind-preset');
+ * const seed = require('./theme.seed.json');
+ *
+ * module.exports = {
+ *   presets: [toTailwindPreset(compileTheme(seed))],
+ *   content: ['./src/**\/*.{ts,tsx}', './node_modules/@xenition/ui/**\/*.js'],
+ * };
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = exports.toTailwindPreset = void 0;
+var outputs_1 = require("../theme/outputs");
+Object.defineProperty(exports, "toTailwindPreset", { enumerable: true, get: function () { return outputs_1.toTailwindPreset; } });
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return outputs_1.toTailwindPreset; } });
+//# sourceMappingURL=index.js.map

package/dist/tailwind-preset/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tailwind-preset/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,4CAAiF;AAAxE,2GAAA,gBAAgB,OAAA;AAAE,kGAAA,gBAAgB,OAAW"}

package/dist/theme/color.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Color math for the theme compiler: hex ↔ RGB ↔ HSL conversions and the
+ * real WCAG 2.1 relative-luminance / contrast-ratio formulas
+ * (https://www.w3.org/TR/WCAG21/#dfn-relative-luminance).
+ *
+ * All functions are pure and deterministic.
+ */
+export interface RGB {
+    /** 0–255 */
+    r: number;
+    /** 0–255 */
+    g: number;
+    /** 0–255 */
+    b: number;
+}
+export interface HSL {
+    /** Hue in degrees, 0–360. */
+    h: number;
+    /** Saturation, 0–100. */
+    s: number;
+    /** Lightness, 0–100. */
+    l: number;
+}
+/** True if `value` is a `#rgb` or `#rrggbb` hex color string. */
+export declare function isValidHex(value: unknown): value is string;
+export declare function hexToRgb(hex: string): RGB;
+export declare function rgbToHex({ r, g, b }: RGB): string;
+export declare function rgbToHsl({ r, g, b }: RGB): HSL;
+export declare function hslToRgb({ h, s, l }: HSL): RGB;
+export declare function hexToHsl(hex: string): HSL;
+export declare function hslToHex(hsl: HSL): string;
+/**
+ * WCAG 2.1 relative luminance of a color, 0 (black) to 1 (white).
+ * Channels are linearized with the sRGB piecewise transfer function before
+ * the luminance weights are applied.
+ */
+export declare function relativeLuminance(hex: string): number;
+/**
+ * WCAG 2.1 contrast ratio between two colors: (L1 + 0.05) / (L2 + 0.05),
+ * where L1 is the lighter color's relative luminance. Range 1–21; symmetric.
+ */
+export declare function contrastRatio(a: string, b: string): number;
+/**
+ * Returns `fg` adjusted in lightness (hue and saturation preserved) until
+ * `contrastRatio(result, bg) >= min`.
+ *
+ * Guaranteed to terminate: both lightness sweeps are bounded (0–100 in
+ * integer steps), and if neither passes, the fallback picks pure black or
+ * pure white — whichever contrasts more with `bg`, which for any background
+ * is at least ≈4.58:1 (the black/white equal-contrast minimum), above the
+ * 4.5:1 default.
+ */
+export declare function ensureContrast(fg: string, bg: string, min?: number): string;
+//# sourceMappingURL=color.d.ts.map

package/dist/theme/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/theme/color.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,GAAG;IAClB,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,GAAG;IAClB,6BAA6B;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAC;CACX;AAID,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE1D;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAkBzC;AAED,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,CAIjD;AAED,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,CAyB9C;AAED,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,CA4B9C;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAEzC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOrD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1D;AASD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,SAAM,GAAG,MAAM,CAexE"}

package/dist/theme/color.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * Color math for the theme compiler: hex ↔ RGB ↔ HSL conversions and the
+ * real WCAG 2.1 relative-luminance / contrast-ratio formulas
+ * (https://www.w3.org/TR/WCAG21/#dfn-relative-luminance).
+ *
+ * All functions are pure and deterministic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidHex = isValidHex;
+exports.hexToRgb = hexToRgb;
+exports.rgbToHex = rgbToHex;
+exports.rgbToHsl = rgbToHsl;
+exports.hslToRgb = hslToRgb;
+exports.hexToHsl = hexToHsl;
+exports.hslToHex = hslToHex;
+exports.relativeLuminance = relativeLuminance;
+exports.contrastRatio = contrastRatio;
+exports.ensureContrast = ensureContrast;
+const HEX_RE = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
+/** True if `value` is a `#rgb` or `#rrggbb` hex color string. */
+function isValidHex(value) {
+    return typeof value === 'string' && HEX_RE.test(value);
+}
+function hexToRgb(hex) {
+    if (!isValidHex(hex)) {
+        throw new Error(`Invalid hex color ${JSON.stringify(hex)} — expected "#rgb" or "#rrggbb" (e.g. "#7C3AED").`);
+    }
+    let raw = hex.slice(1).toLowerCase();
+    if (raw.length === 3) {
+        raw = raw
+            .split('')
+            .map((c) => c + c)
+            .join('');
+    }
+    return {
+        r: parseInt(raw.slice(0, 2), 16),
+        g: parseInt(raw.slice(2, 4), 16),
+        b: parseInt(raw.slice(4, 6), 16),
+    };
+}
+function rgbToHex({ r, g, b }) {
+    const channel = (n) => Math.max(0, Math.min(255, Math.round(n))).toString(16).padStart(2, '0');
+    return `#${channel(r)}${channel(g)}${channel(b)}`;
+}
+function rgbToHsl({ r, g, b }) {
+    const rn = r / 255;
+    const gn = g / 255;
+    const bn = b / 255;
+    const max = Math.max(rn, gn, bn);
+    const min = Math.min(rn, gn, bn);
+    const l = (max + min) / 2;
+    if (max === min) {
+        return { h: 0, s: 0, l: l * 100 };
+    }
+    const d = max - min;
+    const s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    let h;
+    if (max === rn) {
+        h = (gn - bn) / d + (gn < bn ? 6 : 0);
+    }
+    else if (max === gn) {
+        h = (bn - rn) / d + 2;
+    }
+    else {
+        h = (rn - gn) / d + 4;
+    }
+    return { h: h * 60, s: s * 100, l: l * 100 };
+}
+function hslToRgb({ h, s, l }) {
+    const hn = (((h % 360) + 360) % 360) / 360;
+    const sn = Math.max(0, Math.min(1, s / 100));
+    const ln = Math.max(0, Math.min(1, l / 100));
+    if (sn === 0) {
+        const v = Math.round(ln * 255);
+        return { r: v, g: v, b: v };
+    }
+    const q = ln < 0.5 ? ln * (1 + sn) : ln + sn - ln * sn;
+    const p = 2 * ln - q;
+    const hueToChannel = (t) => {
+        let tt = t;
+        if (tt < 0)
+            tt += 1;
+        if (tt > 1)
+            tt -= 1;
+        if (tt < 1 / 6)
+            return p + (q - p) * 6 * tt;
+        if (tt < 1 / 2)
+            return q;
+        if (tt < 2 / 3)
+            return p + (q - p) * (2 / 3 - tt) * 6;
+        return p;
+    };
+    return {
+        r: Math.round(hueToChannel(hn + 1 / 3) * 255),
+        g: Math.round(hueToChannel(hn) * 255),
+        b: Math.round(hueToChannel(hn - 1 / 3) * 255),
+    };
+}
+function hexToHsl(hex) {
+    return rgbToHsl(hexToRgb(hex));
+}
+function hslToHex(hsl) {
+    return rgbToHex(hslToRgb(hsl));
+}
+/**
+ * WCAG 2.1 relative luminance of a color, 0 (black) to 1 (white).
+ * Channels are linearized with the sRGB piecewise transfer function before
+ * the luminance weights are applied.
+ */
+function relativeLuminance(hex) {
+    const { r, g, b } = hexToRgb(hex);
+    const linearize = (channel) => {
+        const c = channel / 255;
+        return c <= 0.03928 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
+    };
+    return 0.2126 * linearize(r) + 0.7152 * linearize(g) + 0.0722 * linearize(b);
+}
+/**
+ * WCAG 2.1 contrast ratio between two colors: (L1 + 0.05) / (L2 + 0.05),
+ * where L1 is the lighter color's relative luminance. Range 1–21; symmetric.
+ */
+function contrastRatio(a, b) {
+    const la = relativeLuminance(a);
+    const lb = relativeLuminance(b);
+    const lighter = Math.max(la, lb);
+    const darker = Math.min(la, lb);
+    return (lighter + 0.05) / (darker + 0.05);
+}
+/**
+ * Luminance at which a background contrasts equally with pure black and pure
+ * white: solve (1.05)/(x+0.05) = (x+0.05)/0.05 → x ≈ 0.1791. Backgrounds
+ * lighter than this get dark foregrounds first, and vice versa.
+ */
+const BLACK_WHITE_PIVOT = Math.sqrt(1.05 * 0.05) - 0.05;
+/**
+ * Returns `fg` adjusted in lightness (hue and saturation preserved) until
+ * `contrastRatio(result, bg) >= min`.
+ *
+ * Guaranteed to terminate: both lightness sweeps are bounded (0–100 in
+ * integer steps), and if neither passes, the fallback picks pure black or
+ * pure white — whichever contrasts more with `bg`, which for any background
+ * is at least ≈4.58:1 (the black/white equal-contrast minimum), above the
+ * 4.5:1 default.
+ */
+function ensureContrast(fg, bg, min = 4.5) {
+    if (contrastRatio(fg, bg) >= min)
+        return fg;
+    const { h, s, l } = hexToHsl(fg);
+    const preferDark = relativeLuminance(bg) >= BLACK_WHITE_PIVOT;
+    const directions = preferDark ? [-1, 1] : [1, -1];
+    for (const dir of directions) {
+        for (let candidate = l + dir; candidate >= 0 && candidate <= 100; candidate += dir) {
+            const adjusted = hslToHex({ h, s, l: candidate });
+            if (contrastRatio(adjusted, bg) >= min)
+                return adjusted;
+        }
+    }
+    return contrastRatio('#000000', bg) >= contrastRatio('#ffffff', bg) ? '#000000' : '#ffffff';
+}
+//# sourceMappingURL=color.js.map

package/dist/theme/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../src/theme/color.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAuBH,gCAEC;AAED,4BAkBC;AAED,4BAIC;AAED,4BAyBC;AAED,4BA4BC;AAED,4BAEC;AAED,4BAEC;AAOD,8CAOC;AAMD,sCAMC;AAmBD,wCAeC;AA5JD,MAAM,MAAM,GAAG,sCAAsC,CAAC;AAEtD,iEAAiE;AACjE,SAAgB,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED,SAAgB,QAAQ,CAAC,GAAW;IAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,qBAAqB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,mDAAmD,CAC5F,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACrC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,GAAG,GAAG,GAAG;aACN,KAAK,CAAC,EAAE,CAAC;aACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;aACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;IACD,OAAO;QACL,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QAChC,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QAChC,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,SAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAO;IACvC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAU,EAAE,CACpC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1E,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,SAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAO;IACvC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC;IACnB,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC;IACnB,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC;IACnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IAE1B,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC;IACpB,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;IAE1D,IAAI,CAAS,CAAC;IACd,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACf,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;SAAM,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACtB,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC;AAC/C,CAAC;AAED,SAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAO;IACvC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC7C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAE7C,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;QAC/B,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACvD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAErB,MAAM,YAAY,GAAG,CAAC,CAAS,EAAU,EAAE;QACzC,IAAI,EAAE,GAAG,CAAC,CAAC;QACX,IAAI,EAAE,GAAG,CAAC;YAAE,EAAE,IAAI,CAAC,CAAC;QACpB,IAAI,EAAE,GAAG,CAAC;YAAE,EAAE,IAAI,CAAC,CAAC;QACpB,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QAC5C,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC;QACzB,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACtD,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IAEF,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;QAC7C,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;QACrC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,SAAgB,QAAQ,CAAC,GAAW;IAClC,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,SAAgB,QAAQ,CAAC,GAAQ;IAC/B,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,GAAW;IAC3C,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAU,EAAE;QAC5C,MAAM,CAAC,GAAG,OAAO,GAAG,GAAG,CAAC;QACxB,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,EAAE,GAAG,CAAC,CAAC;IACvE,CAAC,CAAC;IACF,OAAO,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,CAAS,EAAE,CAAS;IAChD,MAAM,EAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAChC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AAExD;;;;;;;;;GASG;AACH,SAAgB,cAAc,CAAC,EAAU,EAAE,EAAU,EAAE,GAAG,GAAG,GAAG;IAC9D,IAAI,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG;QAAE,OAAO,EAAE,CAAC;IAE5C,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjC,MAAM,UAAU,GAAG,iBAAiB,CAAC,EAAE,CAAC,IAAI,iBAAiB,CAAC;IAC9D,MAAM,UAAU,GAA0B,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,KAAK,IAAI,SAAS,GAAG,CAAC,GAAG,GAAG,EAAE,SAAS,IAAI,CAAC,IAAI,SAAS,IAAI,GAAG,EAAE,SAAS,IAAI,GAAG,EAAE,CAAC;YACnF,MAAM,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;YAClD,IAAI,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,GAAG;gBAAE,OAAO,QAAQ,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9F,CAAC"}

package/dist/theme/compile.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The theme compiler: `compileTheme(seed)` — a deterministic, pure function
+ * that turns a ~5-value {@link ThemeSeed} into a full {@link CompiledTheme}.
+ *
+ * Guarantees:
+ * - Deterministic: the same seed always deep-equals the same output.
+ * - Validated: malformed seeds throw descriptive errors, never "best-effort".
+ * - Readable: every semantic `onX`/`X` pair passes WCAG AA (≥ 4.5:1) in both
+ *   light and dark mode — enforced by `ensureContrast`, which cannot fail.
+ */
+import { CompiledTheme, ThemeSeed } from './types';
+/** Minimum WCAG contrast enforced for every semantic on-pair. */
+export declare const MIN_CONTRAST = 4.5;
+/**
+ * Compile a {@link ThemeSeed} into a full {@link CompiledTheme}.
+ *
+ * Pure and deterministic — safe to run at build time, on the server, or in
+ * the browser; the same seed always produces a deep-equal theme.
+ *
+ * @throws {Error} with a descriptive message if the seed is malformed.
+ */
+export declare function compileTheme(seed: ThemeSeed): CompiledTheme;
+//# sourceMappingURL=compile.d.ts.map

package/dist/theme/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/theme/compile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAEL,aAAa,EAQb,SAAS,EAGV,MAAM,SAAS,CAAC;AAEjB,iEAAiE;AACjE,eAAO,MAAM,YAAY,MAAM,CAAC;AAyJhC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,CAkC3D"}