@mkbabb/glass-ui 6.0.0 → 8.0.0

package/dist/components/_shared/overlay/placement.d.ts

@@ -0,0 +1,22 @@
+import type { Placement } from "../axes.js";
+/**
+ * The placement TYPES, and nothing else.
+ *
+ * This file is what is left of `_shared/floating.ts` after the 38-entry
+ * retired-attribute denylist died (#19 W-SHIM-PURGE): four type
+ * declarations that every portalled surface's props extend. It moves here
+ * because the types belong beside the seam that consumes them
+ * (`overlayContentAttrs`), not in a `_shared/` root that no longer has a
+ * runtime half to justify its own file.
+ */
+/** Edge used to place floating content relative to its trigger. */
+export type FloatingSide = Exclude<Placement, "center">;
+/** Cross-axis alignment of floating content against its trigger. */
+export type FloatingAlign = "start" | "center" | "end";
+/** Placement controls intentionally shared by Glass floating surfaces. */
+export interface FloatingPlacementProps {
+    side?: FloatingSide;
+    sideOffset?: number;
+    align?: FloatingAlign;
+    alignOffset?: number;
+}

package/dist/components/_shared/primitive.d.ts

@@ -0,0 +1,19 @@
+import type { Component } from "vue";
+/** Host element name accepted by Glass components that render a primitive. */
+export type AsTag = string;
+/** Logical reading direction accepted by directional Glass controls. */
+export type Direction = "ltr" | "rtl";
+/** Stable public shape shared by Glass components backed by a host primitive. */
+export interface PrimitiveProps {
+    /** Merge the component's behavior into its single child instead of rendering a host. */
+    asChild?: boolean;
+    /** Element or Vue component to render when `asChild` is false. */
+    as?: AsTag | Component;
+}
+/** Stable public fields shared by form-associated Glass controls. */
+export interface FormFieldProps {
+    name?: string;
+    required?: boolean;
+}
+/** Forward ordinary host attributes without reviving a retired polymorphic API. */
+export declare function fixedHostAttrs(attrs: Readonly<Record<string, unknown>>): Record<string, unknown>;

package/dist/components/_shared/selection.d.ts

@@ -0,0 +1,46 @@
+import type { HTMLAttributes, InputHTMLAttributes } from "vue";
+import type { FocusOutsideEvent, ListboxItemSelectEvent, PointerDownOutsideEvent } from "./interaction.js";
+/** Stable scalar identity used by Glass selection controls. */
+export type SelectionValue = string | number;
+/** Checkbox state, including the mixed state exposed through ARIA. */
+export type CheckedState = boolean | "indeterminate";
+/** Cardinality of a Glass selection model. */
+export type SelectionMode = "single" | "multiple";
+export declare function isSelectionValue(value: unknown): value is SelectionValue;
+/** Stable scalar selection, with `null` representing no single selection. */
+export type ComboboxValue = SelectionValue | null;
+export interface ComboboxInputProps {
+    modelValue?: string;
+    autoFocus?: boolean;
+    disabled?: boolean;
+    placeholder?: InputHTMLAttributes["placeholder"];
+    class?: HTMLAttributes["class"];
+}
+export interface ComboboxInputEmits {
+    "update:modelValue": [value: string];
+}
+export interface ComboboxItemProps {
+    value: SelectionValue;
+    disabled?: boolean;
+    textValue?: string;
+    class?: HTMLAttributes["class"];
+}
+export interface ComboboxItemEmits {
+    select: [event: ListboxItemSelectEvent<SelectionValue>];
+}
+export interface ComboboxGroupProps {
+    heading?: string;
+    class?: HTMLAttributes["class"];
+}
+export interface ComboboxEmptyProps {
+    class?: HTMLAttributes["class"];
+}
+export interface ComboboxListEmits {
+    escapeKeyDown: [event: KeyboardEvent];
+    pointerDownOutside: [event: PointerDownOutsideEvent];
+    focusOutside: [event: FocusOutsideEvent];
+    interactOutside: [event: PointerDownOutsideEvent | FocusOutsideEvent];
+}
+export interface ComboboxSeparatorProps {
+    class?: HTMLAttributes["class"];
+}

package/dist/components/_shared/surface/resolve.d.ts

@@ -0,0 +1,17 @@
+import type { SurfaceTier } from "../axes.js";
+/**
+ * The ONE surface resolver — a plain function, not a composable.
+ *
+ * Seven call sites across six files ask this question, and six of them pass the
+ * literal `"floating"` wanting nothing but the class string. A `useSurface()`
+ * returning `{ class, attrs }` would ship an `attrs` member with exactly ONE
+ * consumer — sub-`≥2-sites` machinery for a solved problem. The portaled roots'
+ * attribute contract is `overlayContentAttrs()`, which COMPOSES this.
+ *
+ * `deep` is ORTHOGONAL: it thickens the resolved tier, it never jumps to
+ * another one. The predecessor returned the literal `"glass-floating
+ * glass-deep"` for every deep surface, so `<Surface tier="overlay" deep>`
+ * silently became floating and two of the three shipped depth grades were
+ * unreachable through the public door.
+ */
+export declare function surfaceClass(tier: SurfaceTier, deep?: boolean): string;

package/dist/components/_shared/useMotionAxis.d.ts

@@ -1,11 +1,5 @@
 import { type MaybeRefOrGetter } from "vue";
-import type { Motion } from "./axes";
-/**
- * Resolve a prop `Motion` value (default `full`) DOWN under live PRM. The prop may
- * only clamp DOWN — PRM forces `full`/`reduced` → `reduced` (never an escalation),
- * `off` is preserved (the prop went below PRM, which is legal).
- */
-export declare function resolveMotion(motion: Motion | undefined): Motion;
+import type { Motion } from "./axes.js";
 /**
  * The resolved-motion state a carrier reads. `armed` gates the JS gesture
  * enrichment (drag/press/spring-mount/liquid-drag); `dataMotion`/`hostStyle` are the
@@ -33,9 +27,10 @@ export interface MotionAxis {
  *   // <Root :data-motion="motion.dataMotion.value" :style="motion.hostStyle.value">
  *   // if (motion.armed.value) { …arm the drag/press/spring enrichment… }
  */
-export declare function useMotionAxis(motion: MaybeRefOrGetter<Motion | undefined>): {
+export declare function useMotionAxis(motion?: MaybeRefOrGetter<Motion | undefined>): {
     resolved: import("vue").ComputedRef<"off" | "full" | "reduced">;
     armed: import("vue").ComputedRef<boolean>;
     dataMotion: import("vue").ComputedRef<"off" | "reduced" | undefined>;
     hostStyle: import("vue").ComputedRef<Record<string, string> | undefined>;
+    prefersReducedMotion: Readonly<import("vue").Ref<boolean, boolean>>;
 };

package/dist/components/accordion/Accordion.vue.d.ts

@@ -1,19 +1,44 @@
-import { type AccordionRootProps } from 'reka-ui';
-type __VLS_Props = AccordionRootProps;
-declare var __VLS_8: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_8) => any;
+import { type HTMLAttributes } from "vue";
+import type { SelectionMode } from "../_shared/selection.js";
+export type AccordionValue<TMode extends SelectionMode = SelectionMode> = TMode extends "single" ? string | undefined : string[];
+export interface AccordionProps<TMode extends SelectionMode = SelectionMode> {
+    /** Whether the disclosure owns one open item or any number of open items. */
+    type: TMode;
+    /** Controlled open item value or values. */
+    modelValue?: TMode extends "single" ? string : string[];
+    /** Initial value for an uncontrolled accordion. */
+    defaultValue?: TMode extends "single" ? string : string[];
+    /** In single mode, allow the open item to close. */
+    collapsible?: TMode extends "single" ? boolean : never;
+    /** Disable interaction for the complete disclosure group. */
+    disabled?: boolean;
+    class?: HTMLAttributes["class"];
+}
+export interface AccordionEmits<TMode extends SelectionMode = SelectionMode> {
+    "update:modelValue": [value: AccordionValue<TMode>];
+}
+export interface AccordionSlotProps<TMode extends SelectionMode = SelectionMode> {
+    modelValue: AccordionValue<TMode>;
+}
+declare const __VLS_export: <TMode extends SelectionMode>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<AccordionProps<TMode> & {
+        "onUpdate:modelValue"?: ((value: AccordionValue<TMode>) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: {}) => void;
+    attrs: any;
+    slots: {
+        default?: (props: AccordionSlotProps<TMode>) => unknown;
+    };
+    emit: (evt: "update:modelValue", value: AccordionValue<TMode>) => void;
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (value: string | string[] | undefined) => any;
-}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:modelValue"?: ((value: string | string[] | undefined) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/components/accordion/AccordionContent.vue.d.ts

@@ -1,13 +1,15 @@
-import { type HTMLAttributes } from 'vue';
-import { type AccordionContentProps } from 'reka-ui';
-type __VLS_Props = AccordionContentProps & {
-    class?: HTMLAttributes['class'];
+import { type HTMLAttributes } from "vue";
+export interface AccordionContentProps {
+    /** Keep the region mounted while closed, for measurement or external animation. */
+    forceMount?: boolean;
+    class?: HTMLAttributes["class"];
+}
+type __VLS_Slots = {
+    default?: () => unknown;
 };
-declare var __VLS_8: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_8) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_base: import("vue").DefineComponent<AccordionContentProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<AccordionContentProps> & Readonly<{}>, {
+    forceMount: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/accordion/AccordionItem.vue.d.ts

@@ -1,13 +1,16 @@
-import { type HTMLAttributes } from 'vue';
-import { type AccordionItemProps } from 'reka-ui';
-type __VLS_Props = AccordionItemProps & {
-    class?: HTMLAttributes['class'];
+import { type HTMLAttributes } from "vue";
+export interface AccordionItemProps {
+    /** Stable value represented by this item in the root model. */
+    value: string;
+    disabled?: boolean;
+    class?: HTMLAttributes["class"];
+}
+type __VLS_Slots = {
+    default?: () => unknown;
 };
-declare var __VLS_8: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_8) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_base: import("vue").DefineComponent<AccordionItemProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<AccordionItemProps> & Readonly<{}>, {
+    disabled: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/accordion/AccordionTrigger.vue.d.ts

@@ -1,15 +1,12 @@
-import { type HTMLAttributes } from 'vue';
-import { type AccordionTriggerProps } from 'reka-ui';
-type __VLS_Props = AccordionTriggerProps & {
-    class?: HTMLAttributes['class'];
+import { type HTMLAttributes } from "vue";
+export interface AccordionTriggerProps {
+    class?: HTMLAttributes["class"];
+}
+type __VLS_Slots = {
+    default?: () => unknown;
+    icon?: () => unknown;
 };
-declare var __VLS_14: {}, __VLS_16: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_14) => any;
-} & {
-    icon?: (props: typeof __VLS_16) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_base: import("vue").DefineComponent<AccordionTriggerProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<AccordionTriggerProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/accordion/index.d.ts

@@ -1,4 +1,4 @@
-export { default as Accordion } from './Accordion.vue';
-export { default as AccordionContent } from './AccordionContent.vue';
-export { default as AccordionItem } from './AccordionItem.vue';
-export { default as AccordionTrigger } from './AccordionTrigger.vue';
+export { default as Accordion, type AccordionEmits, type AccordionProps, type AccordionSlotProps, type AccordionValue, } from "./Accordion.vue.js";
+export { default as AccordionContent, type AccordionContentProps, } from "./AccordionContent.vue.js";
+export { default as AccordionItem, type AccordionItemProps } from "./AccordionItem.vue.js";
+export { default as AccordionTrigger, type AccordionTriggerProps, } from "./AccordionTrigger.vue.js";

package/dist/components/alert/Alert.vue.d.ts

@@ -1,14 +1,18 @@
-import type { HTMLAttributes } from 'vue';
-import { type AlertVariants } from './';
+import { type HTMLAttributes } from "vue";
+import { type AlertVariants } from "./index.js";
+type AlertAnnouncement = "off" | "polite" | "assertive";
 type __VLS_Props = {
-    class?: HTMLAttributes['class'];
-    tone?: AlertVariants['tone'];
+    class?: HTMLAttributes["class"];
+    tone?: AlertVariants["tone"];
+    announce?: AlertAnnouncement;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    announce: AlertAnnouncement;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/alert/AlertDescription.vue.d.ts

@@ -1,6 +1,6 @@
-import type { HTMLAttributes } from 'vue';
+import type { HTMLAttributes } from "vue";
 type __VLS_Props = {
-    class?: HTMLAttributes['class'];
+    class?: HTMLAttributes["class"];
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/components/alert/AlertTitle.vue.d.ts

@@ -1,6 +1,6 @@
-import type { HTMLAttributes } from 'vue';
+import type { HTMLAttributes } from "vue";
 type __VLS_Props = {
-    class?: HTMLAttributes['class'];
+    class?: HTMLAttributes["class"];
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/components/alert/index.d.ts

@@ -1,8 +1,17 @@
-import { type VariantProps } from 'class-variance-authority';
-export { default as Alert } from './Alert.vue';
-export { default as AlertDescription } from './AlertDescription.vue';
-export { default as AlertTitle } from './AlertTitle.vue';
-export declare const alertVariants: (props?: ({
-    tone?: "neutral" | "destructive" | "success" | "warning" | "info" | null | undefined;
-} & import("class-variance-authority/types").ClassProp) | undefined) => string;
-export type AlertVariants = VariantProps<typeof alertVariants>;
+import { type ClassValue } from "../_shared/class-names.js";
+export { default as Alert } from "./Alert.vue.js";
+export { default as AlertDescription } from "./AlertDescription.vue.js";
+export { default as AlertTitle } from "./AlertTitle.vue.js";
+declare const TONE: {
+    readonly neutral: "text-card-foreground";
+    readonly destructive: "feedback-tone-destructive text-card-foreground [&>svg]:text-(--tone) *:data-[slot=alert-description]:text-card-foreground/90";
+    readonly success: "feedback-tone-success text-card-foreground [&>svg]:text-(--tone) *:data-[slot=alert-description]:text-card-foreground/90";
+    readonly warning: "feedback-tone-warning text-card-foreground [&>svg]:text-(--tone) *:data-[slot=alert-description]:text-card-foreground/90";
+    readonly info: "feedback-tone-info text-card-foreground [&>svg]:text-(--tone) *:data-[slot=alert-description]:text-card-foreground/90";
+};
+export interface AlertVariants {
+    tone?: keyof typeof TONE | null;
+    class?: ClassValue;
+    className?: ClassValue;
+}
+export declare function alertVariants(options?: AlertVariants): string;

package/dist/components/aurora/Aurora.vue.d.ts

@@ -1,9 +1,9 @@
-import type { AuroraRuntimeOptions } from "./composables/runtime";
-import { type AuroraConfig } from "./constants/presets";
-import { type AuroraRenderMode } from "./constants/renderMode";
-import type { RendererStatus } from "../../composables/glass/webgpu/rendererStatus";
+import type { AuroraRuntimeOptions } from "./composables/runtime.js";
+import { type AuroraConfig } from "./constants/presets.js";
+import { type AuroraRenderMode } from "./constants/renderMode.js";
+import type { RendererStatus } from "../../composables/glass/webgpu/rendererStatus.js";
 /**
- * Aurora — a painterly WebGL2 background.
+ * Aurora — a painterly procedural background.
  *
  * Renders into a single canvas sized to its container via ResizeObserver.
  * Config is reactive; the composable watches it deeply and re-uploads
@@ -11,37 +11,34 @@ import type { RendererStatus } from "../../composables/glass/webgpu/rendererStat
  * use `useCursorInteraction` (or call the exposed `setCursor` API) against
  * the container element so the consumer controls pointer policy.
  *
- * Lazy-arm (HA4 §1): by default the expensive WebGL init (shader compile +
- * GPU link) is deferred past the consumer's first paint. Until the runtime
- * arms, a palette-derived GROUND placeholder (`auroraFallbackGround` — the
- * field-sampled nuclei-glow, BI.W-E10-AURORA-ENTRANCE) paints the first frame
- * with zero JS / zero GPU; the canvas cross-fades in over it once armed. The
- * ground is derived from the SAME palette + nuclei the WebGL path uploads, so
- * FRAME 0 is palette-COLORED (never the retired flat gray band) and the live
- * canvas WARMS INTO it — a same-palette dissolve with no tone jump (the UF-E10
- * "no repulsive-gray fade" law). The placeholder stays mounted underneath as
- * the natural WebGL2-unavailable visual fallback (HA4 §1.5). Capture /
- * thumbnail-baking consumers pass `runtimeOptions.initStrategy: "eager"` (or
- * `mode: "capture"`) to arm synchronously.
+ * Lazy-arm: by default GPU initialization is deferred past the consumer's
+ * first paint. Until the runtime arms, a palette-derived GROUND placeholder
+ * (`auroraFallbackGround`, the field-sampled nuclei glow) paints the first frame
+ * with zero JS and zero GPU; the canvas cross-fades in over it once armed. The
+ * ground is derived from the same palette and nuclei the GPU path uploads, so
+ * frame 0 is palette-colored and the live canvas warms into it without a tone
+ * jump. The placeholder stays mounted underneath as the natural static surface.
+ * Capture and thumbnail-baking consumers pass `runtimeOptions.initStrategy: "eager"` (or
+ * `mode: "capture"`) to begin acquisition immediately, then await `armAsync()`
+ * before reading a deterministic frame.
  *
- * Init failures (WebGL2 unavailable, shader compile/link failure) are
- * library-internal contract violations and surface by default (O invariant
- * 24): synchronously on the eager path, on the microtask queue on the
- * deferred path. Pass `onInitError` to handle the error and leave the canvas
- * unmounted instead — the canonical opt-in path back to silent fallback.
+ * Device/context and shader setup failures remain explicit through
+ * `rendererStatus`. Pass `onInitError` (or install Vue's app error handler) to
+ * receive the attributed error as well. A failed runtime never marks the live
+ * canvas armed, so the palette ground remains visible.
  *
- * `opacityCeiling` (A3 §6.R-9, G-AK-D11) is the outer compositing envelope:
+ * `opacityCeiling` is the outer compositing envelope:
  * `1.0` (default) for hero surfaces, `~0.5` for quiet content-over-aurora
  * routes where form/text density would otherwise compete with the drift.
- * It applies uniformly to the placeholder and the canvas so the cross-fade
- * rides under the clamped ceiling and the shader's per-pixel `alpha`
- * remains an orthogonal authoring concern.
+ * It applies once around the stacked placeholder + canvas field so their
+ * internal cross-fade rides under the clamped ceiling and the config's pigment
+ * `alpha` remains an orthogonal authoring concern.
  */
 type __VLS_Props = {
     /**
      * Aurora field configuration (palette, nuclei, warp, media). Optional —
      * omit it and the canonical `DEFAULT_AURORA_CONFIG` painterly look
-     * renders (gap 11, AM.W1). Pass a full config to author a custom field,
+     * renders. Pass a full config to author a custom field,
      * or a preset object from `./constants/presets`. The default is supplied via a
      * `withDefaults` factory so each mount gets its own (un-shared) object.
      */
@@ -49,35 +46,33 @@ type __VLS_Props = {
     runtimeOptions?: AuroraRuntimeOptions;
     onInitError?: (err: Error) => void;
     /**
-     * Adaptive render substrate (AM.W1; `aurora-lazy-init §3.1`). Aurora is
-     * NEVER retired — the warm wash always composites; only the substrate
-     * adapts:
-     *   - `"webgl"` — arm the WebGL path (still deferred to idle past first
-     *     paint via the `initStrategy:"deferred"` default).
-     *   - `"css"`   — never arm WebGL; the `auroraFallbackGround` palette-
+     * Adaptive render substrate. The warm wash always composites; only the
+     * substrate adapts:
+     *   - `"webgl"` — arm the animated GPU path; the runtime prefers WebGPU
+     *     and supports WebGL2.
+     *   - `"css"`   — never arm a GPU; the `auroraFallbackGround` palette-
      *     derived ground stays the permanent surface (the warm wash
      *     composites, it just does not animate).
      *   - `"auto"` (default) — resolves to `"webgl"` on every device EXCEPT a
-     *     detected SOFTWARE renderer (SwiftShader / llvmpipe / MS Basic Render),
-     *     which falls to `"css"` (the page-wedging-software-raster guard, the only
-     *     surviving `"css"` signal). BC.W-VIZ-AURORA (T1) RETIRED the dead-static
-     *     `hardwareConcurrency <= 4` / `saveData` / `reduced-motion` falls: a
-     *     2026-capable low-core / throttled tab no longer gets a frozen gradient
-     *     (the "renders SLOW" defect root), and reduced-motion is handled SOLELY by
+     *     detected SOFTWARE renderer (SwiftShader, llvmpipe, MS Basic Render),
+     *     which falls to `"css"` (the page-wedging-software-raster guard and sole
+     *     `"css"` signal). Reduced motion is handled solely by
      *     the substrate's live `matchMedia` freeze (one static frame then park,
-     *     re-arms on un-reduce). Resolved once at setup; SSR / missing-API safe
+     *     re-arms on un-reduce). Resolved once at setup; SSR, missing-API safe
      *     (assumes capable → `"webgl"` when the probes are unavailable).
      */
     renderMode?: AuroraRenderMode;
     /**
-     * Per-route aurora saturation clamp (A3 §6.R-9 / G-AK-D11).
+     * Per-route aurora saturation clamp.
      *
-     * The shader's `alpha` config field is per-pixel pigment opacity inside
-     * the painted image. `opacityCeiling` is the *outer envelope* — the
+     * The config's `alpha` field is pigment opacity for the painted image.
+     * Live presentation applies it once as canvas opacity over the palette
+     * ground; capture keeps it in the transparent GPU buffer. `opacityCeiling`
+     * is the *outer envelope* — the
      * maximum compositing opacity the aurora surface (placeholder +
-     * canvas) is allowed to reach against page content. It applies
-     * uniformly to both layers via the `--aurora-opacity-ceiling` custom
-     * property so the cross-fade preserves the clamped ceiling.
+     * canvas) is allowed to reach against page content. It applies once
+     * to their shared root; the internal cross-fade remains a full `0` to
+     * `1` handoff.
      *
      * Defaults to `1.0` (the dial route — full brand register). Quiet
      * content-over-aurora routes (survey, thankyou, admin-login) opt in

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

@@ -1,5 +1,8 @@
-import { type AuroraConfig, type AuroraMedium } from "../constants/presets";
-import type { AuroraMotionAtom } from "./atoms";
+import { type AuroraConfig, type AuroraMedium, type OklchStop, type WarpMode } from "../constants/presets.js";
+/** The motion field classifier. */
+export type AuroraMotionAtom = "still" | "breathing" | "drifting";
+/** The deterministic zone-placement classifier. */
+export type AuroraZoneArrangement = "scattered" | "composed" | "centred";
 /** 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. */
@@ -33,6 +36,14 @@ export declare const COLOR_ENERGY: {
     };
 };
 export declare const MOTION_FIELDS: Record<AuroraMotionAtom, MotionFields>;
+/** Deterministic, bounded placement for one to eight color zones. */
+export declare function nucleiPrior(count: number, arrangement?: AuroraZoneArrangement): AuroraConfig["nuclei"];
+/** Apply the derived palette's bounded chroma counterpoint in place. */
+export declare function applyChromaBracket(palette: OklchStop[], variance: number, counterpoint: boolean): void;
+/** Organic-boundary classifier: smooth fBm to hybrid to cellular. */
+export declare function warpModeFor(amount: number): WarpMode;
+/** Expand one bounded noise amount into the coupled boundary fields. */
+export declare function applyNoise(cfg: AuroraConfig, amount: number): void;
 /** 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). */