@mkbabb/glass-ui 4.0.0 → 4.0.1

package/dist/carousel.js

@@ -1,29 +1,12 @@
 import { t as e } from "./cn-DJXf4yaB.js";
-import { t } from "./createLucideIcon-DydS2qgk.js";
-import { t as n } from "./chevron-down-DKkxb4VV.js";
-import { t as r } from "./chevron-right-CPXbqQQz.js";
-import { t as i } from "./chevron-up-n_24SqI-.js";
-import { n as a } from "./button-BNDWhAZb.js";
-import { computed as o, createBlock as s, createCommentVNode as c, createElementBlock as l, createElementVNode as u, createVNode as d, defineComponent as f, mergeProps as p, normalizeClass as m, onMounted as h, openBlock as g, ref as _, renderSlot as v, resolveDynamicComponent as y, toDisplayString as b, unref as x, watch as S, withCtx as C } from "vue";
-import { createInjectionState as w } from "@vueuse/core";
-import T from "embla-carousel-vue";
-var E = t("arrow-left", [["path", {
-	d: "m12 19-7-7 7-7",
-	key: "1l729n"
-}], ["path", {
-	d: "M19 12H5",
-	key: "x3x0zl"
-}]]), D = t("arrow-right", [["path", {
-	d: "M5 12h14",
-	key: "1ays0h"
-}], ["path", {
-	d: "m12 5 7 7-7 7",
-	key: "xquz4c"
-}]]), O = t("chevron-left", [["path", {
-	d: "m15 18-6-6 6-6",
-	key: "1wnfg3"
-}]]), [k, A] = w(({ opts: e, orientation: t, plugins: n }, r) => {
-	let [i, a] = T({
+import { C as t, S as n, _ as r, b as i, v as a, y as o } from "./vendor-CKmzio-i.js";
+import { n as s } from "./button-DYCUa-tH.js";
+import { computed as c, createBlock as l, createCommentVNode as u, createElementBlock as d, createElementVNode as f, createVNode as p, defineComponent as m, mergeProps as h, normalizeClass as g, onMounted as _, openBlock as v, ref as y, renderSlot as b, resolveDynamicComponent as x, toDisplayString as S, unref as C, watch as w, withCtx as T } from "vue";
+import { createInjectionState as E } from "@vueuse/core";
+import D from "embla-carousel-vue";
+//#region src/components/ui/carousel/useCarousel.ts
+var [O, k] = E(({ opts: e, orientation: t, plugins: n }, r) => {
+	let [i, a] = D({
 		...e,
 		axis: t === "horizontal" ? "x" : "y"
 	}, n);
@@ -33,11 +16,11 @@ var E = t("arrow-left", [["path", {
 	function s() {
 		a.value?.scrollNext();
 	}
-	let c = _(!1), l = _(!1);
+	let c = y(!1), l = y(!1);
 	function u(e) {
 		c.value = e?.canScrollNext() || !1, l.value = e?.canScrollPrev() || !1;
 	}
-	return h(() => {
+	return _(() => {
 		a.value && (a.value?.on("init", u), a.value?.on("reInit", u), a.value?.on("select", u), r("init-api", a.value));
 	}), {
 		carouselRef: i,
@@ -49,14 +32,14 @@ var E = t("arrow-left", [["path", {
 		orientation: t
 	};
 });
-function j() {
-	let e = A();
+function A() {
+	let e = k();
 	if (!e) throw Error("useCarousel must be used within a <Carousel />");
 	return e;
 }
 //#endregion
 //#region src/components/ui/carousel/Carousel.vue
-var M = /* @__PURE__ */ f({
+var j = /* @__PURE__ */ m({
 	__name: "Carousel",
 	props: {
 		opts: {},
@@ -72,14 +55,14 @@ var M = /* @__PURE__ */ f({
 	},
 	emits: ["init-api"],
 	setup(t, { expose: n, emit: r }) {
-		let i = t, { canScrollNext: a, canScrollPrev: o, carouselApi: s, carouselRef: c, orientation: u, scrollNext: d, scrollPrev: f } = k(i, r);
+		let i = t, { canScrollNext: a, canScrollPrev: o, carouselApi: s, carouselRef: c, orientation: l, scrollNext: u, scrollPrev: f } = O(i, r);
 		n({
 			canScrollNext: a,
 			canScrollPrev: o,
 			carouselApi: s,
 			carouselRef: c,
-			orientation: u,
-			scrollNext: d,
+			orientation: l,
+			scrollNext: u,
 			scrollPrev: f
 		});
 		function p(e) {
@@ -88,26 +71,26 @@ var M = /* @__PURE__ */ f({
 				e.preventDefault(), f();
 				return;
 			}
-			e.key === n && (e.preventDefault(), d());
+			e.key === n && (e.preventDefault(), u());
 		}
-		return (t, n) => (g(), l("div", {
+		return (t, n) => (v(), d("div", {
 			"data-slot": "carousel",
-			class: m(x(e)("relative", i.class)),
+			class: g(C(e)("relative", i.class)),
 			role: "region",
 			"aria-roledescription": "carousel",
 			tabindex: "0",
 			onKeydown: p
-		}, [v(t.$slots, "default", {
-			canScrollNext: x(a),
-			canScrollPrev: x(o),
-			carouselApi: x(s),
-			carouselRef: x(c),
-			orientation: x(u),
-			scrollNext: x(d),
-			scrollPrev: x(f)
+		}, [b(t.$slots, "default", {
+			canScrollNext: C(a),
+			canScrollPrev: C(o),
+			carouselApi: C(s),
+			carouselRef: C(c),
+			orientation: C(l),
+			scrollNext: C(u),
+			scrollPrev: C(f)
 		})], 34));
 	}
-}), N = /* @__PURE__ */ f({
+}), M = /* @__PURE__ */ m({
 	inheritAttrs: !1,
 	__name: "CarouselContent",
 	props: { class: { type: [
@@ -118,15 +101,15 @@ var M = /* @__PURE__ */ f({
 		Array
 	] } },
 	setup(t, { expose: n }) {
-		let r = t, { carouselRef: i, orientation: a } = j();
-		return n({ carouselRef: i }), (t, n) => (g(), l("div", {
+		let r = t, { carouselRef: i, orientation: a } = A();
+		return n({ carouselRef: i }), (t, n) => (v(), d("div", {
 			ref_key: "carouselRef",
 			ref: i,
 			"data-slot": "carousel-content",
 			class: "overflow-hidden"
-		}, [u("div", p({ class: x(e)("flex", x(a) === "horizontal" ? "-ml-4" : "-mt-4 flex-col", r.class) }, t.$attrs), [v(t.$slots, "default")], 16)], 512));
+		}, [f("div", h({ class: C(e)("flex", C(a) === "horizontal" ? "-ml-4" : "-mt-4 flex-col", r.class) }, t.$attrs), [b(t.$slots, "default")], 16)], 512));
 	}
-}), P = /* @__PURE__ */ f({
+}), N = /* @__PURE__ */ m({
 	__name: "CarouselItem",
 	props: { class: { type: [
 		Boolean,
@@ -136,15 +119,15 @@ var M = /* @__PURE__ */ f({
 		Array
 	] } },
 	setup(t) {
-		let n = t, { orientation: r } = j();
-		return (t, i) => (g(), l("div", {
+		let n = t, { orientation: r } = A();
+		return (t, i) => (v(), d("div", {
 			"data-slot": "carousel-item",
 			role: "group",
 			"aria-roledescription": "slide",
-			class: m(x(e)("min-w-0 shrink-0 grow-0 basis-full", x(r) === "horizontal" ? "pl-4" : "pt-4", n.class))
-		}, [v(t.$slots, "default")], 2));
+			class: g(C(e)("min-w-0 shrink-0 grow-0 basis-full", C(r) === "horizontal" ? "pl-4" : "pt-4", n.class))
+		}, [b(t.$slots, "default")], 2));
 	}
-}), F = /* @__PURE__ */ f({
+}), P = /* @__PURE__ */ m({
 	__name: "CarouselNext",
 	props: {
 		variant: { default: "outline" },
@@ -158,16 +141,16 @@ var M = /* @__PURE__ */ f({
 		] }
 	},
 	setup(t) {
-		let n = t, { orientation: r, canScrollNext: i, scrollNext: o } = j();
-		return (c, l) => (g(), s(x(a), {
+		let r = t, { orientation: i, canScrollNext: a, scrollNext: o } = A();
+		return (c, u) => (v(), l(C(s), {
 			"data-slot": "carousel-next",
-			disabled: !x(i),
-			class: m(x(e)("absolute h-(--carousel-nav-size) w-(--carousel-nav-size) rounded-pill", x(r) === "horizontal" ? "top-1/2 -translate-y-1/2 right-[calc(-1*var(--carousel-nav-offset))]" : "left-1/2 -translate-x-1/2 rotate-90 bottom-[calc(-1*var(--carousel-nav-offset))]", n.class)),
+			disabled: !C(a),
+			class: g(C(e)("absolute h-(--carousel-nav-size) w-(--carousel-nav-size) rounded-pill", C(i) === "horizontal" ? "top-1/2 -translate-y-1/2 right-[calc(-1*var(--carousel-nav-offset))]" : "left-1/2 -translate-x-1/2 rotate-90 bottom-[calc(-1*var(--carousel-nav-offset))]", r.class)),
 			variant: t.variant,
 			size: t.size,
-			onClick: x(o)
+			onClick: C(o)
 		}, {
-			default: C(() => [v(c.$slots, "default", {}, () => [d(x(D)), l[0] ||= u("span", { class: "sr-only" }, "Next Slide", -1)])]),
+			default: T(() => [b(c.$slots, "default", {}, () => [p(C(n)), u[0] ||= f("span", { class: "sr-only" }, "Next Slide", -1)])]),
 			_: 3
 		}, 8, [
 			"disabled",
@@ -177,11 +160,11 @@ var M = /* @__PURE__ */ f({
 			"onClick"
 		]));
 	}
-}), I = {
+}), F = {
 	key: 0,
 	"data-slot": "carousel-pager-counter",
 	class: "glass-pager-ring text-mono-caption tabular-nums"
-}, L = /* @__PURE__ */ f({
+}, I = /* @__PURE__ */ m({
 	__name: "CarouselPager",
 	props: {
 		showCounter: {
@@ -197,44 +180,44 @@ var M = /* @__PURE__ */ f({
 		] }
 	},
 	setup(t) {
-		let u = t, { carouselApi: f, canScrollNext: p, canScrollPrev: v, orientation: w, scrollNext: T, scrollPrev: E } = j(), D = _(0), k = _(0);
-		function A() {
+		let n = t, { carouselApi: f, canScrollNext: m, canScrollPrev: h, orientation: b, scrollNext: E, scrollPrev: D } = A(), O = y(0), k = y(0);
+		function j() {
 			let e = f.value;
-			e && (D.value = e.selectedScrollSnap(), k.value = e.scrollSnapList().length);
+			e && (O.value = e.selectedScrollSnap(), k.value = e.scrollSnapList().length);
 		}
-		S(f, (e) => {
-			e && (A(), e.on("select", A), e.on("reInit", A));
-		}, { immediate: !0 }), h(A);
-		let M = o(() => w === "vertical" ? i : O), N = o(() => w === "vertical" ? n : r);
-		return (n, r) => (g(), l("div", {
+		w(f, (e) => {
+			e && (j(), e.on("select", j), e.on("reInit", j));
+		}, { immediate: !0 }), _(j);
+		let M = c(() => b === "vertical" ? r : o), N = c(() => b === "vertical" ? i : a);
+		return (r, i) => (v(), d("div", {
 			"data-slot": "carousel-pager",
-			class: m(x(e)("inline-flex items-center gap-2", x(w) === "vertical" && "flex-col", u.class))
+			class: g(C(e)("inline-flex items-center gap-2", C(b) === "vertical" && "flex-col", n.class))
 		}, [
-			d(x(a), {
+			p(C(s), {
 				variant: "ghost",
 				size: "icon",
-				disabled: !x(v),
-				"aria-label": x(w) === "vertical" ? "Previous slide (up)" : "Previous slide",
+				disabled: !C(h),
+				"aria-label": C(b) === "vertical" ? "Previous slide (up)" : "Previous slide",
 				"data-slot": "carousel-pager-prev",
-				onClick: x(E)
+				onClick: C(D)
 			}, {
-				default: C(() => [(g(), s(y(M.value), { class: "size-4" }))]),
+				default: T(() => [(v(), l(x(M.value), { class: "size-4" }))]),
 				_: 1
 			}, 8, [
 				"disabled",
 				"aria-label",
 				"onClick"
 			]),
-			t.showCounter && k.value > 0 ? (g(), l("span", I, b(D.value + 1) + " / " + b(k.value), 1)) : c("", !0),
-			d(x(a), {
+			t.showCounter && k.value > 0 ? (v(), d("span", F, S(O.value + 1) + " / " + S(k.value), 1)) : u("", !0),
+			p(C(s), {
 				variant: "ghost",
 				size: "icon",
-				disabled: !x(p),
-				"aria-label": x(w) === "vertical" ? "Next slide (down)" : "Next slide",
+				disabled: !C(m),
+				"aria-label": C(b) === "vertical" ? "Next slide (down)" : "Next slide",
 				"data-slot": "carousel-pager-next",
-				onClick: x(T)
+				onClick: C(E)
 			}, {
-				default: C(() => [(g(), s(y(N.value), { class: "size-4" }))]),
+				default: T(() => [(v(), l(x(N.value), { class: "size-4" }))]),
 				_: 1
 			}, 8, [
 				"disabled",
@@ -243,7 +226,7 @@ var M = /* @__PURE__ */ f({
 			])
 		], 2));
 	}
-}), R = /* @__PURE__ */ f({
+}), L = /* @__PURE__ */ m({
 	__name: "CarouselPrevious",
 	props: {
 		variant: { default: "outline" },
@@ -256,17 +239,17 @@ var M = /* @__PURE__ */ f({
 			Array
 		] }
 	},
-	setup(t) {
-		let n = t, { orientation: r, canScrollPrev: i, scrollPrev: o } = j();
-		return (c, l) => (g(), s(x(a), {
+	setup(n) {
+		let r = n, { orientation: i, canScrollPrev: a, scrollPrev: o } = A();
+		return (c, u) => (v(), l(C(s), {
 			"data-slot": "carousel-previous",
-			disabled: !x(i),
-			class: m(x(e)("absolute h-(--carousel-nav-size) w-(--carousel-nav-size) rounded-pill", x(r) === "horizontal" ? "top-1/2 -translate-y-1/2 left-[calc(-1*var(--carousel-nav-offset))]" : "left-1/2 -translate-x-1/2 rotate-90 top-[calc(-1*var(--carousel-nav-offset))]", n.class)),
-			variant: t.variant,
-			size: t.size,
-			onClick: x(o)
+			disabled: !C(a),
+			class: g(C(e)("absolute h-(--carousel-nav-size) w-(--carousel-nav-size) rounded-pill", C(i) === "horizontal" ? "top-1/2 -translate-y-1/2 left-[calc(-1*var(--carousel-nav-offset))]" : "left-1/2 -translate-x-1/2 rotate-90 top-[calc(-1*var(--carousel-nav-offset))]", r.class)),
+			variant: n.variant,
+			size: n.size,
+			onClick: C(o)
 		}, {
-			default: C(() => [v(c.$slots, "default", {}, () => [d(x(E)), l[0] ||= u("span", { class: "sr-only" }, "Previous Slide", -1)])]),
+			default: T(() => [b(c.$slots, "default", {}, () => [p(C(t)), u[0] ||= f("span", { class: "sr-only" }, "Previous Slide", -1)])]),
 			_: 3
 		}, 8, [
 			"disabled",
@@ -276,11 +259,11 @@ var M = /* @__PURE__ */ f({
 			"onClick"
 		]));
 	}
-}), z = {
+}), R = {
 	key: 0,
 	"data-slot": "glass-carousel-pager-counter",
 	class: "rounded-pill border border-border bg-card px-3 py-1 text-mono-caption tabular-nums shadow-cartoon-sm"
-}, B = /* @__PURE__ */ f({
+}, z = /* @__PURE__ */ m({
 	__name: "GlassCarouselPager",
 	props: {
 		index: {},
@@ -307,32 +290,32 @@ var M = /* @__PURE__ */ f({
 		"next",
 		"select"
 	],
-	setup(t, { emit: u }) {
-		let f = t, p = u, h = o(() => f.loop ? f.total > 1 : f.index > 0), _ = o(() => f.loop ? f.total > 1 : f.index < f.total - 1);
-		function S() {
-			h.value && (f.loop ? p("select", (f.index - 1 + f.total) % f.total) : (p("prev"), p("select", Math.max(0, f.index - 1))));
+	setup(t, { emit: n }) {
+		let f = t, m = n, h = c(() => f.loop ? f.total > 1 : f.index > 0), _ = c(() => f.loop ? f.total > 1 : f.index < f.total - 1);
+		function y() {
+			h.value && (f.loop ? m("select", (f.index - 1 + f.total) % f.total) : (m("prev"), m("select", Math.max(0, f.index - 1))));
 		}
 		function w() {
-			_.value && (f.loop ? p("select", (f.index + 1) % f.total) : (p("next"), p("select", Math.min(f.total - 1, f.index + 1))));
+			_.value && (f.loop ? m("select", (f.index + 1) % f.total) : (m("next"), m("select", Math.min(f.total - 1, f.index + 1))));
 		}
-		let T = o(() => f.orientation === "vertical" ? i : O), E = o(() => f.orientation === "vertical" ? n : r);
-		return (n, r) => (g(), l("div", {
+		let E = c(() => f.orientation === "vertical" ? r : o), D = c(() => f.orientation === "vertical" ? i : a);
+		return (n, r) => (v(), d("div", {
 			"data-slot": "glass-carousel-pager",
-			class: m(x(e)("inline-flex items-center gap-2", t.orientation === "vertical" && "flex-col", "max-md:flex-wrap max-md:justify-center max-md:gap-2", f.class))
+			class: g(C(e)("inline-flex items-center gap-2", t.orientation === "vertical" && "flex-col", "max-md:flex-wrap max-md:justify-center max-md:gap-2", f.class))
 		}, [
-			d(x(a), {
+			p(C(s), {
 				variant: "outline",
 				size: "icon",
 				disabled: !h.value,
 				"aria-label": t.orientation === "vertical" ? "Previous slide (up)" : "Previous slide",
 				"data-slot": "glass-carousel-pager-prev",
-				onClick: S
+				onClick: y
 			}, {
-				default: C(() => [(g(), s(y(T.value), { class: "size-4" }))]),
+				default: T(() => [(v(), l(x(E.value), { class: "size-4" }))]),
 				_: 1
 			}, 8, ["disabled", "aria-label"]),
-			t.showCounter && t.total > 0 ? (g(), l("span", z, b(t.index + 1) + " / " + b(t.total), 1)) : c("", !0),
-			d(x(a), {
+			t.showCounter && t.total > 0 ? (v(), d("span", R, S(t.index + 1) + " / " + S(t.total), 1)) : u("", !0),
+			p(C(s), {
 				variant: "outline",
 				size: "icon",
 				disabled: !_.value,
@@ -340,12 +323,12 @@ var M = /* @__PURE__ */ f({
 				"data-slot": "glass-carousel-pager-next",
 				onClick: w
 			}, {
-				default: C(() => [(g(), s(y(E.value), { class: "size-4" }))]),
+				default: T(() => [(v(), l(x(D.value), { class: "size-4" }))]),
 				_: 1
 			}, 8, ["disabled", "aria-label"]),
-			v(n.$slots, "trailing")
+			b(n.$slots, "trailing")
 		], 2));
 	}
 });
 //#endregion
-export { M as Carousel, N as CarouselContent, P as CarouselItem, F as CarouselNext, L as CarouselPager, R as CarouselPrevious, B as GlassCarouselPager, j as useCarousel };
+export { j as Carousel, M as CarouselContent, N as CarouselItem, P as CarouselNext, I as CarouselPager, L as CarouselPrevious, z as GlassCarouselPager, A as useCarousel };

package/dist/collapsible.js

@@ -1,2 +1,2 @@
-import { n as e, r as t, t as n } from "./CollapsibleContent-C_s6fG7r.js";
+import { n as e, r as t, t as n } from "./CollapsibleContent-68dEXIAl.js";
 export { t as Collapsible, n as CollapsibleContent, e as CollapsibleTrigger };

package/dist/command.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "./CommandShortcut-DdtWXxOK.js";
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "./CommandShortcut-DvZNQ_HF.js";
 export { r as Command, t as CommandDialog, s as CommandEmpty, a as CommandGroup, e as CommandInput, n as CommandItem, o as CommandList, i as CommandSeparator, c as CommandShortcut };

package/dist/compile-CQEFRTmx.js

@@ -0,0 +1,19 @@
+//#region src/composables/glass/webgl/compile.ts
+function e(e, t, n, r = "[glass-ui:webgl]") {
+	let i = e.createShader(t);
+	if (e.shaderSource(i, n), e.compileShader(i), !e.getShaderParameter(i, e.COMPILE_STATUS)) {
+		let t = e.getShaderInfoLog(i) ?? "unknown";
+		throw e.deleteShader(i), Error(`${r} shader compile failed:\n${t}`);
+	}
+	return i;
+}
+function t(e, t, n, r = "[glass-ui:webgl]") {
+	let i = e.createProgram();
+	if (e.attachShader(i, t), e.attachShader(i, n), e.linkProgram(i), !e.getProgramParameter(i, e.LINK_STATUS)) {
+		let t = e.getProgramInfoLog(i) ?? "unknown";
+		throw e.deleteProgram(i), Error(`${r} program link failed:\n${t}`);
+	}
+	return i;
+}
+//#endregion
+export { t as n, e as t };

package/dist/components/custom/aurora/composables/atoms-fields.d.ts

@@ -0,0 +1,39 @@
+import { type AuroraConfig, type AuroraMedium } from "../constants/presets";
+import type { AuroraMotionAtom } from "./atoms";
+/** Linear interpolation over a co-varying axis (the continuous curve, not a LUT). */
+export declare function lerp(a: number, b: number, t: number): number;
+/** The motion atom → the three motion fields. */
+export interface MotionFields {
+    nucleiDrift: number;
+    paletteDrift: number;
+    warpDrift: number;
+    breathDepth: number;
+}
+/** The calm↔vivid poles for each co-varying COLOR-energy axis. */
+export declare const COLOR_ENERGY: {
+    readonly saturation: {
+        readonly calm: 0.85;
+        readonly vivid: 1.2;
+    };
+    readonly valueVariance: {
+        readonly calm: 0.04;
+        readonly vivid: 0.14;
+    };
+    readonly breathDepth: {
+        readonly calm: 0.03;
+        readonly vivid: 0.08;
+    };
+    readonly temperatureShift: {
+        readonly calm: 0.15;
+        readonly vivid: 0.5;
+    };
+};
+export declare const MOTION_FIELDS: Record<AuroraMotionAtom, MotionFields>;
+/** The textured medium → its dominant texture knob. Only reached for a textured medium. */
+export declare function applyTexture(cfg: AuroraConfig, medium: Exclude<AuroraMedium, "smooth">, amount: number): void;
+/** Read back the textured medium's dominant texture amount (the applyTexture inverse). */
+export declare function textureAmountFor(cfg: AuroraConfig, kind: Exclude<AuroraMedium, "smooth">): number;
+/** Classify the motion atom from the config's drift fields (the resolveAtoms forward map). */
+export declare function motionFor(cfg: AuroraConfig): AuroraMotionAtom;
+/** Invert a clamped lerp(calm, vivid, t) back to t∈[0,1] (the energy/noise inverses). */
+export declare function unlerp(value: number, lo: number, hi: number): number;

package/dist/components/custom/aurora/composables/auroraFallbackGround.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Aurora luminance-faithful fallback ground (BB.W-AURORA-SWRASTER).
+ *
+ * The headless / software-raster substrate cannot run the live WebGL field, but
+ * speedtest's CI/witness harness must still certify text-on-aurora AA contrast
+ * floors HEADLESS (no `--use-gl=angle`). The flat `paletteToCssGradient`
+ * placeholder (`color.ts`) is a deliberate "visually-adjacent approximation" — a
+ * gamma-sRGB-stop `linear-gradient(135deg, …)` band whose MEAN luminance and
+ * SPATIAL distribution both diverge from the shader's nuclei-field composite, so a
+ * contrast capture against it certifies the WRONG floor. This module REPLACES it,
+ * in the software-raster / capture substrate, with a FIELD-SAMPLED ground derived
+ * from the SAME inputs the shader uploads (the palette stops + the nuclei field),
+ * matching the composite's mean + per-quadrant luminance within the certify band.
+ *
+ * THE FIELD MATH IS MIRRORED CPU-SIDE, NOT RE-INVENTED. `sampleAuroraField`
+ * reproduces the shader's STATIC (t=0) composite — `composition.glsl.ts`'s
+ * `nucleiField` (the softmax-Gaussian over the nuclei → paletteId + valueMod) +
+ * `samplePalette` (the linear-sRGB LUT lerp of the CPU-baked endpoints) + the
+ * `valueVariance` modulation + the Khronos PBR-Neutral tonemap (`tonemap.glsl.ts`'s
+ * `aces()`) + the mandatory `linearToSrgb` OETF (`proof:aurora-space-gamma`). The
+ * palette LUT is `oklchToLinear` (the SAME value.js Ottosson bake `flattenPalette`
+ * feeds the GPU) — ONE color source, no re-implemented OKLCh math. The
+ * between-endpoint interpolation runs in LINEAR (the linear-baked endpoints the
+ * shader's LUT also reads); the shader's OKLCh between-stop refinement is a
+ * sub-perceptual luminance delta on adjacent stops, well inside the certify band.
+ *
+ * THE GROUND IS A ONE-SHOT 2D-CANVAS RASTER (the "CSS/2D fallback" the brief names
+ * verbatim — option b, the higher-faithfulness path). A low-res `<canvas>` 2D
+ * context paints the downsampled nuclei-field raster (each texel its `sampleAuroraField`
+ * color), exported ONCE as a `data:` URI and CSS-upscaled (`image-rendering` smooth →
+ * bilinear, which preserves the per-quadrant MEAN luminance) — so the painted ground
+ * reproduces the composite's SPATIAL luminance, not a partial-alpha approximation. It
+ * paints once at mount and parks (no rAF, zero ongoing GPU). When no `document` is
+ * available (SSR / happy-dom) it degrades to a deterministic pure-CSS layered
+ * `radial-gradient` stack (zero canvas) — the same field samples, the SSR-safe form.
+ * The luminance metrics (mean + the 4-quadrant relative luminance) are returned
+ * alongside so the gate / π can MEASURE the faithfulness claim rather than assert it.
+ */
+import type { AuroraConfig, AuroraNucleus } from "../constants/presets";
+/** A linear-sRGB triple in [0,1]. */
+type Lin = [number, number, number];
+/** Linear-sRGB relative luminance (Rec.709 / WCAG), the contrast-floor metric. */
+export declare function relativeLuminance([r, g, b]: Lin): number;
+/**
+ * The static (t=0) nuclei field at normalized `(x, y)` — mirrors
+ * `composition.glsl.ts`'s `nucleiField`. At t=0 the drift orbit term vanishes
+ * (cos 0 / sin 0 → the nucleus sits at its authored position), so the field is a
+ * pure softmax-Gaussian over the static nuclei: `w_i = exp(-β·d2_i/r_i²)`,
+ * `paletteId = Σ(w_i·bias_i)/Σw_i`, `valueMod = Σ(w_i·vbias_i)/Σw_i`. The
+ * anisotropic-ellipse local-frame rotation (elongation + angle) is reproduced.
+ *
+ * NOTE the Y convention: the shader flips Y at the uniform boundary
+ * (`uniformBridge.flipY`) so a CSS-top-origin `nucleus.y` becomes a shader
+ * bottom-origin position, AND the fragment samples `vUv` (bottom-origin). Sampling
+ * here in CSS-top-origin against the AUTHORED (un-flipped) positions reproduces the
+ * same field in the SAME visual frame — the two Y flips cancel, so the emitted CSS
+ * ground (top-origin) matches the rendered surface visually.
+ */
+export declare function nucleiFieldStatic(nuclei: readonly AuroraNucleus[], softmaxBeta: number, x: number, y: number): {
+    paletteId: number;
+    valueMod: number;
+};
+/**
+ * Sample the aurora's STATIC composite at normalized `(x, y)` → a gamma-sRGB
+ * `[r,g,b]` in [0,1]. The full CPU mirror of the shader main() output transfer:
+ * field → linear palette LUT → valueVariance modulation → PBR-Neutral tonemap →
+ * the `clamp(col*0.985 + 0.008)` toe → the `linearToSrgb` OETF. The drift / breath
+ * / cursor / medium-texture terms are STATIC (t=0, no cursor, the atmospheric
+ * smooth pole) — the luminance ground the certify reads, not the live animation.
+ */
+export declare function sampleAuroraField(config: AuroraConfig, x: number, y: number): Lin;
+/** The luminance metrics the gate / π MEASURES the faithfulness against. */
+export interface AuroraGroundMetrics {
+    /** Mean relative luminance over the sample grid (gamma → relative-luminance). */
+    mean: number;
+    /** The 4-quadrant mean relative luminance, [topLeft, topRight, bottomLeft, bottomRight]. */
+    quadrants: [number, number, number, number];
+}
+export interface AuroraFallbackGroundOptions {
+    /** Field-sample grid resolution per axis (default 8 → an 8×8 = 64-sample ground). */
+    grid?: number;
+}
+export interface AuroraFallbackGround {
+    /** The CSS `background-image` value — a layered radial-gradient nuclei-glow field. */
+    backgroundImage: string;
+    /** The CSS `background-color` base fill (the field-mean color — the luminance anchor). */
+    backgroundColor: string;
+    /** The measured luminance metrics (mean + per-quadrant) for the certify band. */
+    metrics: AuroraGroundMetrics;
+}
+/**
+ * Build the luminance-faithful CSS fallback ground for an aurora config.
+ *
+ * Samples the static field at a `grid × grid` lattice (the SAME `sampleAuroraField`
+ * the gate / π measures), emits a stack of soft `radial-gradient` layers — one per
+ * sample cell, centred on the cell, fading to transparent at ~the cell radius — over
+ * a base fill at the FIELD-MEAN color. The base fill anchors the global luminance;
+ * the radial layers paint the spatial nuclei-glow distribution, so the ground reads
+ * as the same atmosphere the composite paints, not a flat diagonal band. Pure CSS,
+ * zero canvas, deterministic from the config (palette + nuclei) — a re-run with the
+ * same config reproduces it byte-for-byte.
+ *
+ * The returned `metrics` are computed over the SAME sample lattice the layers paint,
+ * so the gate's certify-band assertion measures the ground the consumer actually
+ * sees (not a separate idealization).
+ */
+export declare function auroraFallbackGround(config: AuroraConfig, options?: AuroraFallbackGroundOptions): AuroraFallbackGround;
+export {};

package/dist/components/custom/aurora/composables/runtime.d.ts

@@ -70,8 +70,27 @@ export interface AuroraRuntimeOptions {
      * NOTE: this is the `useAurora` Vue-wrapper contract surface. The imperative
      * `createAurora(...)` runtime throws on eager init failure and — for
      * `instance.arm()` on the deferred path — rethrows from `arm()`.
+     *
+     * BB.W-AURORA-SWRASTER — a SOFTWARE-RASTER fall is NOT a contract violation:
+     * it never reaches `onInitError`. The wedge catch (see {@link createAurora})
+     * recognizes the software-raster signal at arm time, leaves the canvas
+     * un-armed (the placeholder stays the surface), and returns CLEANLY — so a
+     * consumer who pins `mode:"capture"`/`mode:"webgl"` under SwiftShader never
+     * has to wire `onInitError` to avoid the hang. The handler is preserved for
+     * GENUINE violations (a malformed shader, an OOM, a real link failure).
      */
     onInitError?: (err: Error) => void;
+    /**
+     * BB.W-AURORA-SWRASTER — opt OUT of the runtime software-raster wedge catch.
+     * Default `false`: the wedge catch is the safe default — `createAurora`
+     * recognizes a software renderer at arm time and falls cleanly to the
+     * placeholder rather than arming the page-wedging live GL layer. `true` (the
+     * named, recorded escape for a deterministic test that ACCEPTS the cost)
+     * arms WebGL even under a detected software renderer. Mirrors the
+     * `resolveRenderMode` escape of the same name — ONE consumer-facing flag,
+     * threaded through both seams.
+     */
+    forceWebGLUnderSoftwareRaster?: boolean;
 }
 /**
  * The concrete `createAurora` return shape. It IS an {@link AuroraInstance}

package/dist/components/custom/aurora/composables/uniformBridge.d.ts

@@ -27,6 +27,7 @@ export declare const MEDIUM_ID: {
     readonly crayon: 4;
     readonly vangogh: 5;
     readonly "oil-pastel": 6;
+    readonly kuwahara: 7;
 };
 export declare const HUE_PATH_ID: {
     readonly shorter: 0;
@@ -50,6 +51,7 @@ export declare const WARP_ID: {
     readonly fbm: 0;
     readonly cellular: 1;
     readonly hybrid: 2;
+    readonly curl: 3;
 };
 export declare const STROKE_MODE_ID: {
     readonly oil: 0;
@@ -81,7 +83,9 @@ export declare function resolveStrokeModeId(cfg: AuroraConfig): number;
  * `oil-pastel`, `crayon`) FORCE the structure-tensor orientation regardless of the
  * config's `strokeOrient` field — their marks must hug the color zones (the
  * congruent-to-real-works contract). Every other medium honors the config's
- * `strokeOrient` (default `"flow"`).
+ * `strokeOrient` (default `"flow"`). BB.W-AUR-KUWAHARA — `kuwahara` ALSO forces
+ * tensor: the anisotropic Kuwahara kernel is squeezed along the structure-tensor
+ * minor eigenvector, so the orientation source must be the tensor field.
  */
 export declare function resolveStrokeOrientId(cfg: AuroraConfig): number;
 /**