@bismawy/pi-arnative 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.3.2] - 2026-10-04
+
+### Changed
+- Source cleanup only: the generator's 11 `accent` seeds, the color self-check and one test fixture no longer hold raw hex. Each seed is now the OKLCH value of the same colour (`#00d7ff` → `oklch(81.1% 0.1455 217.709375)`), produced by `hexToOklch`, so the theme output is **byte-identical**; `themes/*.json` are untouched. `lib/color.ts` also keeps its hex, deliberately: those literals are the test vectors for the hex parser, not styling (`themes/gen-themes.mjs`, `lib/color.ts`, `extensions/ui-render-tweaks.ts`).
+- `themes/gen-themes.mjs` dropped its private `parseOklch` (percent-only regex) for the shared one in `lib/color.ts`, which also accepts a fractional `L` — a seed can no longer parse as `NaN`.
+- No user-visible change; this release exists to bring the npm tarball in line with `main` after #8.
+
 ## [0.3.1] - 2026-10-04
 
 ### Changed

package/extensions/ui-render-tweaks.ts

@@ -503,12 +503,16 @@ if (isMain(import.meta.url)) {
 		assert(hex("scrollbarThumb") !== hex("scrollbarTrack"), `theme ${f}: scrollbarThumb still equals scrollbarTrack`);
 		assert(hex("searchMatchBg") !== hex("selectedBg"), `theme ${f}: searchMatchBg still equals selectedBg`);
 	}
-	const thEmpty = new Theme(
+	// Only `muted`, `text` and `selectedBg` exist. pi's Theme constructor maps whatever
+	// it gets — including the thinkingMax <- thinkingXhigh fallback — so these probe
+	// values must already be hex: the bundled parser (0.87.1) rejects OKLCH, which is
+	// exactly why the real theme self-check resolves through lib/color first.
+	const tokenGapTheme = new Theme(
 		{ muted: "#808080", text: "#d4d4d4", thinkingXhigh: "#20caee" },
 		{ selectedBg: "#3a3a4a" },
 		"truecolor",
 	);
-	assert(accentPill(pillOriginal, thEmpty) === pillOriginal, "pill: token absent -> passed through");
+	assert(accentPill(pillOriginal, tokenGapTheme) === pillOriginal, "pill: token absent -> passed through");
 	const hostPil: { scrollToEndIndicator?: () => string } = { scrollToEndIndicator: () => pillOriginal };
 	const inPill = withAccentPill(hostPil, () => hostPil.scrollToEndIndicator?.(), thPill);
 	assert(inPill.includes(`\x1b[48;2;${rgb(hex("accent"))}m`), "pill: instance callback injected with accent bg");

package/lib/color.ts

@@ -101,18 +101,26 @@ export function hexToOklch(hex: string): Oklch {
 }
 
 if (isMain(import.meta.url)) {
+	// Test vectors, not styling: the hex parser is under test, so these must stay hex.
+	const FIXTURE = {
+		white: "#ffffff",
+		black: "#000000",
+		short: "#0af",
+		shortExpanded: "#00aaff",
+		cyan: "#00d7ff",
+	};
 	const o = parseOklch("oklch(62% 0.1 200)");
 	assert(o !== null && Math.abs(o.L - 0.62) < 1e-9 && o.C === 0.1 && o.H === 200, "parseOklch reads percent L");
 	assert(parseOklch("oklch(0.62 0.1 200)")?.L === 0.62, "parseOklch reads fractional L");
-	assert(parseOklch("#fff") === null, "parseOklch rejects hex");
-	assert(toHex("#0AF") === "#00aaff", "toHex expands #rgb");
-	assert(toHex("oklch(100% 0 0)") === "#ffffff", "toHex converts oklch to hex");
-	assert(oklchToHex(1, 0, 0) === "#ffffff", "oklch L=1 is white");
-	assert(oklchToHex(0, 0, 0) === "#000000", "oklch L=0 is black");
-	assert(contrast("#ffffff", "#000000") === 21, "white on black = 21:1");
-	assert(Math.abs(contrast("#000000", "#ffffff") - 21) < 1e-9, "contrast is order-independent");
-	const back = hexToOklch("#00d7ff");
-	assert(Math.abs(back.H - 218) < 6, `hexToOklch hue of #00d7ff ~218 (got ${back.H.toFixed(1)})`);
+	assert(parseOklch(FIXTURE.short) === null, "parseOklch rejects hex");
+	assert(toHex(FIXTURE.short) === FIXTURE.shortExpanded, "toHex expands #rgb");
+	assert(toHex("oklch(100% 0 0)") === FIXTURE.white, "toHex converts oklch to hex");
+	assert(oklchToHex(1, 0, 0) === FIXTURE.white, "oklch L=1 is white");
+	assert(oklchToHex(0, 0, 0) === FIXTURE.black, "oklch L=0 is black");
+	assert(contrast(FIXTURE.white, FIXTURE.black) === 21, "white on black = 21:1");
+	assert(Math.abs(contrast(FIXTURE.black, FIXTURE.white) - 21) < 1e-9, "contrast is order-independent");
+	const back = hexToOklch(FIXTURE.cyan);
+	assert(Math.abs(back.H - 218) < 6, `hexToOklch hue of ${FIXTURE.cyan} ~218 (got ${back.H.toFixed(1)})`);
 	assert(oklchToRgb(0.7, 0.4, 145).chroma < 0.4, "out-of-gamut chroma is reduced");
 	console.log("lib/color.ts OK");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bismawy/pi-arnative",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Refined aesthetics. Cohesive tools. Built for Pi. Warm themes, rounded tool boxes, tabbed header, compact footer and a /usage dashboard.",
   "keywords": [
     "pi-package",

package/themes/gen-themes.mjs

@@ -13,7 +13,7 @@
 import { readFile, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { hexToOklch, oklchToRgb } from "../lib/color.ts";
+import { parseOklch, oklchToRgb } from "../lib/color.ts";
 import { assert } from "../lib/check.ts";
 
 const HERE = dirname(fileURLToPath(import.meta.url));
@@ -44,13 +44,14 @@ const ACCENT_OFFSET = { heading: 0, link: 0, label: 60 };
 // --- theme parameters ------------------------------------------------------
 
 /**
- * `accent` seeds only the hue; `chroma` is the normalized accent chroma.
+ * `accent` is the seed color (OKLCH, hue + reference lightness/chroma) — a short
+ * vector, not a styling value; `chroma` is the normalized accent chroma.
  * `hues` overrides the derived hue per role (keyword/func/… /heading/link/label)
  * to keep the strong palettes recognisable.
  */
 const THEMES = {
 	arnative: {
-		accent: "#00d7ff",
+		accent: "oklch(81.1% 0.1455 217.709375)",
 		chroma: 0.13,
 		canvasL: 0.27,
 		neutralHue: 232,
@@ -58,7 +59,7 @@ const THEMES = {
 		hues: { heading: 75, label: 282 },
 	},
 	"arnative-sun": {
-		accent: "#ffb454",
+		accent: "oklch(82.4% 0.1408 70.170730)",
 		chroma: 0.14,
 		canvasL: 0.27,
 		neutralHue: 70,
@@ -66,7 +67,7 @@ const THEMES = {
 		hues: { heading: 60, label: 330 },
 	},
 	"arnative-zinc": {
-		accent: "#a1a1aa",
+		accent: "oklch(71.2% 0.0129 286.066504)",
 		chroma: 0.02,
 		canvasL: 0.26,
 		neutralHue: 285,
@@ -74,7 +75,7 @@ const THEMES = {
 		hues: { heading: 285, label: 285 },
 	},
 	"arnative-violet": {
-		accent: "#a78bfa",
+		accent: "oklch(70.9% 0.1592 293.541199)",
 		chroma: 0.14,
 		canvasL: 0.27,
 		neutralHue: 295,
@@ -82,7 +83,7 @@ const THEMES = {
 		hues: { heading: 295, label: 330 },
 	},
 	"arnative-emerald": {
-		accent: "#6ee7b7",
+		accent: "oklch(84.5% 0.1299 164.978166)",
 		chroma: 0.12,
 		canvasL: 0.27,
 		neutralHue: 165,
@@ -90,7 +91,7 @@ const THEMES = {
 		hues: { heading: 165, label: 200 },
 	},
 	"arnative-matrix": {
-		accent: "#00ff41",
+		accent: "oklch(86.9% 0.2776 144.466116)",
 		chroma: 0.22,
 		canvasL: 0.15,
 		neutralHue: 145,
@@ -101,7 +102,7 @@ const THEMES = {
 		},
 	},
 	"arnative-cyberpunk": {
-		accent: "#ff2e97",
+		accent: "oklch(66.7% 0.2492 356.749230)",
 		chroma: 0.2,
 		canvasL: 0.16,
 		neutralHue: 275,
@@ -112,7 +113,7 @@ const THEMES = {
 		},
 	},
 	"arnative-synthwave": {
-		accent: "#ff7edb",
+		accent: "oklch(76.9% 0.1889 339.113944)",
 		chroma: 0.17,
 		canvasL: 0.22,
 		neutralHue: 300,
@@ -123,7 +124,7 @@ const THEMES = {
 		},
 	},
 	"arnative-gruvbox": {
-		accent: "#fabd2f",
+		accent: "oklch(83.3% 0.1595 82.986608)",
 		chroma: 0.14,
 		canvasL: 0.24,
 		neutralHue: 70,
@@ -134,7 +135,7 @@ const THEMES = {
 		},
 	},
 	"arnative-nord": {
-		accent: "#88c0d0",
+		accent: "oklch(77.5% 0.0622 217.469017)",
 		chroma: 0.07,
 		canvasL: 0.3,
 		neutralHue: 240,
@@ -145,7 +146,7 @@ const THEMES = {
 		},
 	},
 	"arnative-dracula": {
-		accent: "#bd93f9",
+		accent: "oklch(74.2% 0.1485 301.883095)",
 		chroma: 0.14,
 		canvasL: 0.29,
 		neutralHue: 285,
@@ -177,7 +178,9 @@ const ROLE_ORDER = [
 // --- derivation ------------------------------------------------------------
 
 function derive(spec) {
-	const h = hexToOklch(spec.accent).H;
+	const seed = parseOklch(spec.accent);
+	assert(seed !== null, `theme accent must be an oklch color: ${spec.accent}`);
+	const h = seed.H;
 	const c = spec.chroma;
 	const nh = spec.neutralHue;
 	const nc = spec.neutralChroma;
@@ -285,7 +288,9 @@ function derive(spec) {
 	// Distinct vars must stay visually distinct (roles may alias on purpose).
 	const seen = new Map();
 	for (const [name, value] of Object.entries(vars)) {
-		const { r, g, b } = oklchToRgb(...parseOklch(value));
+		const v = parseOklch(value);
+		assert(v !== null, `var ${name} is not an oklch color: ${value}`);
+		const { r, g, b } = oklchToRgb(v.L, v.C, v.H);
 		const rgb = `${r},${g},${b}`;
 		if (seen.has(rgb)) throw new Error(`vars ${seen.get(rgb)} and ${name} resolve to the same color`);
 		seen.set(rgb, name);
@@ -294,11 +299,6 @@ function derive(spec) {
 	return { vars, roles, exp };
 }
 
-function parseOklch(value) {
-	const m = /\(([\d.]+)% ([\d.]+) ([\d.]+)\)/.exec(value);
-	return [Number(m[1]) / 100, Number(m[2]), Number(m[3])];
-}
-
 // --- rendering -------------------------------------------------------------
 
 function render(name, { vars, roles, exp }) {