@stridge/noctis-theme-engine 1.0.0-beta.0 → 1.0.0-beta.2

package/README.md

@@ -1,5 +1,7 @@
 # @stridge/noctis-theme-engine
 
+![license](https://img.shields.io/badge/license-MIT-blue) ![coverage](https://img.shields.io/badge/coverage-100%25-brightgreen)
+
 The framework-agnostic OKLCH theme generator at the base of the design system. From a
 `{ background, accent, contrast }` input it produces the complete private primitive ramp
 (`--noctis-engine-*`) — plus the elevation-scope re-derivations — as CSS variables, with

package/dist/color/oklch.js

@@ -84,6 +84,7 @@ function mix(x, y, t) {
 /** Reduce chroma until the color sits inside the sRGB gamut, preserving L, H and alpha. */
 function toSrgbGamut(o) {
 	const mapped = clampChroma(toCulori(o), "oklch", "rgb");
+	/* v8 ignore next -- defensive: clampChroma never returns undefined for a valid input */
 	return mapped ? fromCulori(mapped, o.h) : o;
 }
 function round(value, places) {
@@ -100,6 +101,7 @@ function toCss(o) {
 	const l = round(g.l, 4);
 	const c = round(g.c, 4);
 	const h = c === 0 ? 0 : round(g.h, 2);
+	/* v8 ignore next -- defensive: g.a is always set by toSrgbGamut/clampOklch */
 	const a = g.a ?? 1;
 	const base = `oklch(${l} ${c} ${h}`;
 	return a < 1 ? `${base} / ${round(a, 3)})` : `${base})`;

package/dist/generate/theme.js

@@ -139,10 +139,14 @@ function generateTheme(input, options) {
 	const magnitude = Math.abs(gain);
 	const controlGain = (bright ? -.8 : 1) * (contrast / 70);
 	const mutedAmount = bright ? MUTED_MIX.light : MUTED_MIX.dark;
-	const bg = (bright ? BG_L_STEPS_LIGHT : BG_L_STEPS).map((lStep, i) => adjust(canvas, {
-		l: lStep * magnitude,
-		c: (BG_C_STEPS[i] ?? 0) * magnitude
-	}));
+	const bg = (bright ? BG_L_STEPS_LIGHT : BG_L_STEPS).map((lStep, i) => {
+		/* v8 ignore next 2 -- defensive: BG_C_STEPS[i] is always defined for every bgSteps index */
+		const cStep = BG_C_STEPS[i] ?? 0;
+		return adjust(canvas, {
+			l: lStep * magnitude,
+			c: cStep * magnitude
+		});
+	});
 	const bgSunken = adjust(canvas, { l: -(bright ? SUNKEN_L_STEP_LIGHT : SUNKEN_L_STEP) * magnitude });
 	const bgSelected = overrideColor("bg-selected") ?? mix(canvas, accent, bright ? SELECTED_MIX.light : SELECTED_MIX.dark);
 	const bgSelectedHover = adjust(bgSelected, {

package/dist/presets.d.ts

@@ -15,8 +15,12 @@ interface ThemePreset extends ThemeInput {
  */
 declare const defaultPreset: ThemePreset;
 /**
- * The shipped presets. Dark is the Noctis default; Midnight is a deeper violet, Light the inverse,
- * Forest a deliberately distinct green. Seeds are authored in OKLCH so the calibration is exact.
+ * The presets Noctis itself ships — the neutral core of the system, no chromatic identities. Dark is
+ * the default; Light is its inverse; the two High Contrast variants keep the same canvas and accent but
+ * push the contrast knob up for low-vision and bright-environment reading. Brand/showcase themes (a
+ * violet Midnight, a green Forest, a warm Sunset, …) are an application concern, not the package's — the
+ * engine generates any seed at runtime, so a consumer assembles its own palette and passes it to the
+ * provider's `presets`. Seeds are authored in OKLCH so the calibration is exact.
  */
 declare const presets: readonly ThemePreset[];
 //#endregion

package/dist/presets.js

@@ -14,8 +14,12 @@ const defaultPreset = {
 	contrast: 30
 };
 /**
-* The shipped presets. Dark is the Noctis default; Midnight is a deeper violet, Light the inverse,
-* Forest a deliberately distinct green. Seeds are authored in OKLCH so the calibration is exact.
+* The presets Noctis itself ships — the neutral core of the system, no chromatic identities. Dark is
+* the default; Light is its inverse; the two High Contrast variants keep the same canvas and accent but
+* push the contrast knob up for low-vision and bright-environment reading. Brand/showcase themes (a
+* violet Midnight, a green Forest, a warm Sunset, …) are an application concern, not the package's — the
+* engine generates any seed at runtime, so a consumer assembles its own palette and passes it to the
+* provider's `presets`. Seeds are authored in OKLCH so the calibration is exact.
 */
 const presets = [
 	defaultPreset,
@@ -26,16 +30,16 @@ const presets = [
 		contrast: 30
 	},
 	{
-		name: "Midnight",
-		background: "oklch(0.18 0.03 268)",
-		accent: "oklch(0.62 0.19 285)",
-		contrast: 36
+		name: "Dark High Contrast",
+		background: "oklch(0.1711 0.0011 271)",
+		accent: "oklch(0.5674 0.1585 275)",
+		contrast: 70
 	},
 	{
-		name: "Forest",
-		background: "oklch(0.19 0.018 158)",
-		accent: "oklch(0.65 0.15 152)",
-		contrast: 32
+		name: "Light High Contrast",
+		background: "oklch(0.991 0.002 271)",
+		accent: "oklch(0.5674 0.1585 275)",
+		contrast: 70
 	}
 ];
 //#endregion

package/dist/react/provider.d.ts

@@ -1,4 +1,5 @@
 import { ThemeInput, ThemeOverrides } from "../generate/tokens.js";
+import { ThemePreset } from "../presets.js";
 import { ReactNode } from "react";
 
 //#region src/react/provider.d.ts
@@ -11,6 +12,13 @@ interface ThemeProviderProps {
    * uncontrolled case. Overrides participate in derivation — see `ThemeOverrides`.
    */
   overrides?: ThemeOverrides;
+  /**
+   * The selectable presets exposed to the tree via `useTheme().presets` — the named seeds a theme
+   * picker offers. Defaults to the presets Noctis ships (Dark, Light, and their High Contrast
+   * variants); pass your own to advertise a custom palette. Purely the picker's menu — it does not
+   * change the active theme, which is driven by `initialInput`/`setTheme`.
+   */
+  presets?: readonly ThemePreset[];
   children: ReactNode;
 }
 /**
@@ -22,6 +30,7 @@ interface ThemeProviderProps {
 declare function ThemeProvider({
   initialInput,
   overrides: overridesProp,
+  presets,
   children
 }: ThemeProviderProps): ReactNode;
 //#endregion

package/dist/react/provider.js

@@ -13,7 +13,7 @@ import { jsx } from "react/jsx-runtime";
 * localStorage) so the next load's SSR seed and blocking script repaint correctly. Exposes
 * {@link useTheme}.
 */
-function ThemeProvider({ initialInput, overrides: overridesProp, children }) {
+function ThemeProvider({ initialInput, overrides: overridesProp, presets: presets$1 = presets, children }) {
 	const [input, setInput] = useState(() => initialInput ?? readPersistedInput() ?? defaultPreset);
 	const [localOverrides, setLocalOverrides] = useState(() => initialInput ? void 0 : readPersistedOverrides() ?? void 0);
 	const overrides = overridesProp ?? localOverrides;
@@ -37,12 +37,13 @@ function ThemeProvider({ initialInput, overrides: overridesProp, children }) {
 			setTheme,
 			overrides,
 			setOverrides,
-			presets
+			presets: presets$1
 		}), [
 			input,
 			setTheme,
 			overrides,
-			setOverrides
+			setOverrides,
+			presets$1
 		]),
 		children
 	});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stridge/noctis-theme-engine",
-  "version": "1.0.0-beta.0",
+  "version": "1.0.0-beta.2",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -47,6 +47,7 @@
     "tsdown": "0.21.10",
     "typescript": "6.0.3",
     "vitest": "4.1.8",
+    "@vitest/coverage-v8": "4.1.8",
     "@stridge/noctis-typescript": "0.0.0"
   },
   "scripts": {
@@ -54,6 +55,6 @@
     "check:publint": "publint",
     "check:publish": "pnpm run check:publint",
     "check:types": "tsc --noEmit",
-    "test": "vitest --run"
+    "test": "vitest --run --coverage"
   }
 }