osdy-pi 1.2.0 → 1.3.0

package/extensions/osdy-pi/animation.test.ts

@@ -0,0 +1,84 @@
+import assert from "node:assert/strict";
+import { registerHooks } from "node:module";
+import test from "node:test";
+// @ts-expect-error Node's native TypeScript runner resolves test-only TypeScript source imports.
+import { HEADER_VARIANTS } from "./constants.ts";
+import type { SimpleTheme } from "./types.js";
+
+registerHooks({
+	resolve(specifier, context, nextResolve) {
+		if (
+			context.parentURL?.includes("/extensions/osdy-pi/") &&
+			specifier.startsWith("./") &&
+			specifier.endsWith(".js")
+		) {
+			return nextResolve(`${specifier.slice(0, -3)}.ts`, context);
+		}
+		return nextResolve(specifier, context);
+	},
+});
+
+// @ts-expect-error Node's native TypeScript runner resolves test-only TypeScript source imports.
+const { colorAsciiCharacter } = await import("./animation.ts");
+
+class RecordingTheme implements SimpleTheme {
+	readonly calls: Array<{ name: string; text: string }> = [];
+
+	fg(name: string, text: string): string {
+		this.calls.push({ name, text });
+		return `<${name}:${text}>`;
+	}
+}
+
+function neonPalette() {
+	const palette = HEADER_VARIANTS.neon.headerTonePalette;
+	assert.ok(palette);
+	return palette;
+}
+
+void test("Neon renders fixed white and near-black as foreground RGB", () => {
+	const palette = neonPalette();
+	const theme = new RecordingTheme();
+
+	assert.equal(
+		colorAsciiCharacter(theme, palette.c, "W"),
+		"\u001B[38;2;255;255;255mW\u001B[39m",
+	);
+	assert.equal(
+		colorAsciiCharacter(theme, palette.d, "B"),
+		"\u001B[38;2;18;1;27mB\u001B[39m",
+	);
+	assert.deepEqual(theme.calls, []);
+});
+
+void test("Neon renders main and dark pink through bounded accent styling", () => {
+	const palette = neonPalette();
+	const theme = new RecordingTheme();
+
+	const main = colorAsciiCharacter(theme, palette.h, "H");
+	const dark = [palette.l, palette.m, palette.p].map((color, index) =>
+		colorAsciiCharacter(theme, color, `D${index}`),
+	);
+	assert.equal(main, "<accent:H>");
+	assert.deepEqual(dark, [
+		"\u001B[2m<accent:D0>\u001B[22m",
+		"\u001B[2m<accent:D1>\u001B[22m",
+		"\u001B[2m<accent:D2>\u001B[22m",
+	]);
+	assert.deepEqual(theme.calls, [
+		{ name: "accent", text: "H" },
+		{ name: "accent", text: "D0" },
+		{ name: "accent", text: "D1" },
+		{ name: "accent", text: "D2" },
+	]);
+	assert.equal(`${main}${dark.join("")}`.includes("\u001B[48;"), false);
+});
+
+void test("Neon never maps a tone to mdHeading or mdLink", () => {
+	for (const color of Object.values(neonPalette())) {
+		if (typeof color === "string") {
+			assert.notEqual(color, "mdHeading");
+			assert.notEqual(color, "mdLink");
+		}
+	}
+});

package/extensions/osdy-pi/animation.ts

@@ -1,6 +1,9 @@
 import { ANIMATION_ENABLED } from "./constants.js";
 import type { AnimationMode, SimpleTheme } from "./types.js";
-import type { MascotTonePalette } from "./constants.js";
+import type {
+	MascotTonePalette,
+	ThemeForegroundColor,
+} from "./constants.js";
 import { positiveModulo } from "./utils.js";
 
 export type AsciiAnimationStyle = "static" | "animated";
@@ -25,12 +28,12 @@ export function asciiAnimationMode(): AnimationMode {
 	return getAnimationOverrideMode(process.env.OSDY_PI_ANIMATION) ?? "intro";
 }
 
-function getAnimatedAsciiColor(
+function getAnimatedAsciiColor<Color>(
 	wave: number,
-	baseColor: string,
-	highlightColor: string,
-	trailColor: string,
-): string {
+	baseColor: Color,
+	highlightColor: Color,
+	trailColor: Color,
+): Color {
 	if (wave <= 3) return highlightColor;
 	if (wave <= 8) return trailColor;
 	return baseColor;
@@ -50,11 +53,17 @@ const GLOW_TRAIL_TONES = {
 	v: "c",
 } as const;
 
-function colorAsciiCharacter(
+export function colorAsciiCharacter(
 	theme: SimpleTheme,
-	color: string,
+	color: string | ThemeForegroundColor,
 	character: string,
 ): string {
+	if (typeof color !== "string") {
+		const themedCharacter = theme.fg(color.token, character);
+		return color.dimmed
+			? `\u001B[2m${themedCharacter}\u001B[22m`
+			: themedCharacter;
+	}
 	const hexMatch = RAW_HEX_COLOR.exec(color);
 	if (!hexMatch) return theme.fg(color, character);
 	const red = Number.parseInt(hexMatch[1] ?? "", 16);