@once-ui-system/core 1.8.4 → 2.0.0-alpha.0

package/dist/utils/colorScheme.js

@@ -0,0 +1,140 @@
+/**
+ * Generate a 12-step Once UI colour ramp from one seed colour.
+ *
+ * Steps are anchored to a contrast ratio against black rather than to fixed
+ * lightness values, so a generated ramp keeps the same contrast relationships
+ * as the built-in schemes no matter which hue it is built from.
+ *
+ * Hue and chroma are taken from the seed and held constant; only lightness
+ * moves. That was measured against the 19 hand-tuned schemes rather than
+ * assumed: their hue drift averages to nothing across the set (each scheme
+ * drifts its own way, so there is no house curve to copy), and reproducing
+ * their chroma arc made the match worse, not better.
+ *
+ * What does matter is staying inside the gamut. A chroma that exists at the
+ * seed's lightness usually does not exist at 0.98, and clamping the red,
+ * green and blue channels separately — which is what converting an
+ * out-of-range colour to hex does — shifts the hue as it clips. Reducing
+ * chroma until the colour fits instead cuts the worst error across the
+ * built-in schemes from 0.168 to 0.110 in OKLab ΔE, and roughly five-fold on
+ * the lightest steps, where clipping is worst.
+ */
+/** Contrast against black for each step, matching the built-in schemes. */
+export const defaultContrastRatios = [
+    [100, 1.05], [200, 1.15], [300, 2], [400, 3], [500, 4.5], [600, 7],
+    [700, 10], [800, 14], [900, 16], [1000, 18], [1100, 19], [1200, 20],
+];
+const clamp01 = (n) => Math.min(1, Math.max(0, n));
+function parseSeed(input) {
+    const value = input.trim();
+    const oklch = value.match(/^oklch\(\s*([\d.]+%?)\s+([\d.]+)\s+([\d.]+)(?:\s*\/\s*[\d.]+%?)?\s*\)$/i);
+    if (oklch) {
+        const l = oklch[1].endsWith("%") ? parseFloat(oklch[1]) / 100 : parseFloat(oklch[1]);
+        return { l, c: parseFloat(oklch[2]), h: parseFloat(oklch[3]) };
+    }
+    const rgb = value.match(/^rgba?\(([^)]+)\)$/i);
+    if (rgb) {
+        const parts = rgb[1].split(/[\s,/]+/).filter(Boolean).map(parseFloat);
+        if (parts.length >= 3)
+            return srgbToOklch(parts[0] / 255, parts[1] / 255, parts[2] / 255);
+    }
+    let hex = value.replace(/^#/, "");
+    if (hex.length === 3 || hex.length === 4)
+        hex = hex.split("").map((d) => d + d).join("");
+    if (hex.length === 6 || hex.length === 8) {
+        const n = Number.parseInt(hex.slice(0, 6), 16);
+        if (!Number.isNaN(n)) {
+            return srgbToOklch(((n >> 16) & 255) / 255, ((n >> 8) & 255) / 255, (n & 255) / 255);
+        }
+    }
+    return null;
+}
+const toLinear = (c) => (c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4);
+function srgbToOklch(r, g, b) {
+    const [lr, lg, lb] = [toLinear(r), toLinear(g), toLinear(b)];
+    const l = Math.cbrt(0.4122214708 * lr + 0.5363325363 * lg + 0.0514459929 * lb);
+    const m = Math.cbrt(0.2119034982 * lr + 0.6806995451 * lg + 0.1073969566 * lb);
+    const s = Math.cbrt(0.0883024619 * lr + 0.2817188376 * lg + 0.6299787005 * lb);
+    const L = 0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s;
+    const a = 1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s;
+    const bb = 0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s;
+    return { l: L, c: Math.hypot(a, bb), h: ((Math.atan2(bb, a) * 180) / Math.PI + 360) % 360 };
+}
+/** Linear sRGB, which may fall outside 0–1 when the colour is out of gamut. */
+function oklchToLinearSrgb({ l: L, c, h }) {
+    const a = c * Math.cos((h * Math.PI) / 180);
+    const b = c * Math.sin((h * Math.PI) / 180);
+    const l = (L + 0.3963377774 * a + 0.2158037573 * b) ** 3;
+    const m = (L - 0.1055613458 * a - 0.0638541728 * b) ** 3;
+    const s = (L - 0.0894841775 * a - 1.291485548 * b) ** 3;
+    return [
+        4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s,
+        -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s,
+        -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s,
+    ];
+}
+const inGamut = (lch) => oklchToLinearSrgb(lch).every((channel) => channel >= -1e-4 && channel <= 1 + 1e-4);
+/** The most chroma this hue and lightness can carry inside sRGB. */
+function fitChroma(lch) {
+    if (inGamut(lch))
+        return lch;
+    let low = 0;
+    let high = lch.c;
+    for (let i = 0; i < 24; i++) {
+        const mid = (low + high) / 2;
+        if (inGamut({ ...lch, c: mid }))
+            low = mid;
+        else
+            high = mid;
+    }
+    return { ...lch, c: low };
+}
+/** WCAG relative luminance, which is what a contrast ratio is built from. */
+function luminance(lch) {
+    const [r, g, b] = oklchToLinearSrgb(lch).map(clamp01);
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+const contrastAgainstBlack = (lch) => (luminance(lch) + 0.05) / 0.05;
+/** The lightness whose contrast against black is closest to `ratio`. */
+function lightnessForContrast(ratio, c, h) {
+    let low = 0;
+    let high = 1;
+    for (let i = 0; i < 24; i++) {
+        const mid = (low + high) / 2;
+        if (contrastAgainstBlack(fitChroma({ l: mid, c, h })) < ratio)
+            low = mid;
+        else
+            high = mid;
+    }
+    return (low + high) / 2;
+}
+const format = ({ l, c, h }, alpha) => `oklch(${l.toFixed(4)} ${c.toFixed(4)} ${c < 0.0005 ? 0 : h.toFixed(2)}${alpha === undefined ? "" : ` / ${alpha}`})`;
+/**
+ * Build a scheme from a seed colour. Accepts hex, `rgb()`/`rgba()` or
+ * `oklch()` — which covers what `ColorInput` produces with and without
+ * `supportAlpha`. Returns `null` if the seed cannot be parsed, so a caller
+ * can leave the current scheme in place rather than apply something wrong.
+ */
+export function generateColorScheme(seed, ratios = defaultContrastRatios) {
+    const base = parseSeed(seed);
+    if (!base)
+        return null;
+    const scheme = {};
+    for (const [weight, ratio] of ratios) {
+        const l = lightnessForContrast(ratio, base.c, base.h);
+        scheme[weight] = format(fitChroma({ l, c: base.c, h: base.h }));
+    }
+    return scheme;
+}
+/** The three translucent variants of step 600 that the token set expects. */
+export function schemeAlphaVariants(scheme) {
+    const base = parseSeed(scheme[600]);
+    if (!base)
+        return {};
+    return {
+        "600-15": format(base, 0.15),
+        "600-30": format(base, 0.3),
+        "600-50": format(base, 0.5),
+    };
+}
+//# sourceMappingURL=colorScheme.js.map

package/dist/utils/colorScheme.js.map

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

package/dist/utils/index.d.ts

@@ -1,5 +1,7 @@
 export * from "./devLogger";
 export * from "./MissingDependency";
 export * from "./dropdownState";
+export * from "./colorScheme";
+export * from "./navMatch";
 export * from "./safe-html";
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/utils/index.js

@@ -1,5 +1,7 @@
 export * from "./devLogger";
 export * from "./MissingDependency";
 export * from "./dropdownState";
+export * from "./colorScheme";
+export * from "./navMatch";
 export * from "./safe-html";
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/utils/navMatch.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Which of a set of hrefs a pathname is currently on.
+ *
+ * A sidebar cannot decide this with `pathname === href`, because a nested
+ * route (`/settings/billing/invoices`) is on none of its links, and it cannot
+ * use `startsWith` either, because `/settings` is a prefix of every one of its
+ * children and would light up alongside them. The answer is the *longest*
+ * href that matches, which is the one lower in the tree.
+ *
+ * Lifted out of a product sidebar where it had been written once and copied
+ * nowhere — every other sidebar in the fleet got the highlight subtly wrong.
+ *
+ * ```ts
+ * const hrefs = items.map((i) => i.href);
+ * const current = selectNavHref(pathname, hrefs);
+ * // then: selected={item.href === current}
+ * ```
+ */
+declare function selectNavHref(pathname: string, hrefs: string[]): string | null;
+export { selectNavHref };
+//# sourceMappingURL=navMatch.d.ts.map

package/dist/utils/navMatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navMatch.d.ts","sourceRoot":"","sources":["../../src/utils/navMatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,iBAAS,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAIvE;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/utils/navMatch.js

@@ -0,0 +1,26 @@
+/**
+ * Which of a set of hrefs a pathname is currently on.
+ *
+ * A sidebar cannot decide this with `pathname === href`, because a nested
+ * route (`/settings/billing/invoices`) is on none of its links, and it cannot
+ * use `startsWith` either, because `/settings` is a prefix of every one of its
+ * children and would light up alongside them. The answer is the *longest*
+ * href that matches, which is the one lower in the tree.
+ *
+ * Lifted out of a product sidebar where it had been written once and copied
+ * nowhere — every other sidebar in the fleet got the highlight subtly wrong.
+ *
+ * ```ts
+ * const hrefs = items.map((i) => i.href);
+ * const current = selectNavHref(pathname, hrefs);
+ * // then: selected={item.href === current}
+ * ```
+ */
+function selectNavHref(pathname, hrefs) {
+    const matches = hrefs.filter((href) => pathname === href || pathname.startsWith(`${href}/`));
+    if (matches.length === 0)
+        return null;
+    return matches.reduce((a, b) => (a.length >= b.length ? a : b));
+}
+export { selectNavHref };
+//# sourceMappingURL=navMatch.js.map

package/dist/utils/navMatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navMatch.js","sourceRoot":"","sources":["../../src/utils/navMatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAS,aAAa,CAAC,QAAgB,EAAE,KAAe;IACtD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;IAC7F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}