@mkbabb/glass-ui 6.0.0 → 7.0.0

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

@@ -0,0 +1,23 @@
+import type { SelectionValue } from "./selection";
+/** Pointer interaction dispatched outside dismissable floating content. */
+export type PointerDownOutsideEvent = CustomEvent<{
+    originalEvent: PointerEvent;
+}>;
+/** Focus interaction dispatched outside dismissable floating content. */
+export type FocusOutsideEvent = CustomEvent<{
+    originalEvent: FocusEvent;
+}>;
+/** Preventable lifecycle events shared by modal content surfaces. */
+export interface DismissableContentEmits {
+    escapeKeyDown: [event: KeyboardEvent];
+    pointerDownOutside: [event: PointerDownOutsideEvent];
+    focusOutside: [event: FocusOutsideEvent];
+    interactOutside: [event: PointerDownOutsideEvent | FocusOutsideEvent];
+    openAutoFocus: [event: Event];
+    closeAutoFocus: [event: Event];
+}
+/** Preventable selection event dispatched by a Glass listbox item. */
+export type ListboxItemSelectEvent<T = SelectionValue> = CustomEvent<{
+    originalEvent: PointerEvent;
+    value?: T;
+}>;

package/dist/components/_shared/menu.css

@@ -1 +1 @@
-@layer components { .glass-menu-row { --menu-row-bg: color-mix( in oklab, var(--glass-bg-quiet), var(--glass-tint-source) var(--glass-tint-strength) ); --menu-row-lift: -1px; min-block-size: max(2rem, var(--touch-target, 2.75rem)); transition: translate var(--spring-smooth-duration) var(--spring-smooth); translate: 0 0; } .glass-menu-row:hover:not([data-disabled]), .glass-menu-row:focus:not([data-disabled]), .glass-menu-row[data-highlighted]:not([data-disabled]), .glass-menu-row[data-state="open"]:not([data-disabled]) { background: var(--menu-row-bg); color: var(--accent-foreground); } .glass-menu-row:hover:not([data-disabled]) { translate: 0 var(--menu-row-lift); } .glass-menu-section { --menu-section-font: var(--font-mono); --menu-section-size: var(--type-caption); --menu-section-color: var(--muted-foreground); --menu-section-tracking: var(--type-tracking-caps); --menu-section-hairline: var(--border-hairline); --menu-section-gap: 0.375rem; display: block; margin-block-start: var(--menu-section-gap); padding-block-start: var(--menu-section-gap); box-shadow: var(--menu-section-hairline); } .glass-menu-section-label, .glass-menu-section > [data-menu-section-label] { font-family: var(--menu-section-font); font-size: var(--menu-section-size); color: var(--menu-section-color); text-transform: uppercase; letter-spacing: var(--menu-section-tracking); } } @media (prefers-reduced-motion: reduce) { .glass-menu-row { --menu-row-lift: 0px; transition: none; } } .dropdown-menu-content, .dropdown-sub-content { font-family: var(--dropdown-menu-font, inherit); padding: var(--panel-padding); --glass-bg-rung: var(--dropdown-menu-bg, var(--glass-bg-floating)); --glass-border-rung: var(--dropdown-menu-border, var(--glass-border-floating)); box-shadow: var( --dropdown-menu-shadow, var(--glass-material-rim), var(--glass-under-shadow-vivid), var(--glass-shadow-floating) ); }
+@layer components { .glass-menu-row { --menu-row-bg: color-mix( in oklab, var(--glass-bg-quiet), var(--glass-tint-source) var(--glass-tint-strength) ); --menu-row-lift: -1px; min-block-size: max(2rem, var(--touch-target, 2.75rem)); transition: translate var(--spring-smooth-duration) var(--spring-smooth); translate: 0 0; } .glass-menu-row:hover:not([data-disabled]), .glass-menu-row:focus:not([data-disabled]), .glass-menu-row[data-highlighted]:not([data-disabled]), .glass-menu-row[data-state="open"]:not([data-disabled]) { background: var(--menu-row-bg); color: var(--accent-foreground); } .glass-menu-row:hover:not([data-disabled]) { translate: 0 var(--menu-row-lift); } } @media (prefers-reduced-motion: reduce) { .glass-menu-row { --menu-row-lift: 0px; transition: none; } } .dropdown-menu-content, .dropdown-sub-content { font-family: var(--dropdown-menu-font, inherit); padding: var(--panel-padding); --glass-bg-rung: var(--dropdown-menu-bg, var(--glass-bg-floating)); --glass-border-rung: var(--dropdown-menu-border, var(--glass-border-floating)); box-shadow: var( --dropdown-menu-shadow, var(--glass-material-rim), var(--glass-under-shadow-vivid), var(--glass-shadow-floating) ); }

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

@@ -0,0 +1,2 @@
+export type MenuRowIndicator = "none" | "start";
+export declare function menuRowClass(indicator?: MenuRowIndicator): string;

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/resolveSurfaceClass.d.ts

@@ -0,0 +1,3 @@
+import type { SurfaceTier } from "./axes";
+/** Private ladder resolver. Decoration paint remains attribute-driven. */
+export declare function resolveSurfaceClass(tier: SurfaceTier, deep?: boolean): string;

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

@@ -0,0 +1,7 @@
+/** 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;

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

@@ -5,7 +5,7 @@ import type { Motion } from "./axes";
  * 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;
+export declare function resolveMotion(motion: Motion | undefined, prefersReducedMotion?: boolean): Motion;
 /**
  * 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 +33,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";
+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";
+export { default as AccordionContent, type AccordionContentProps, } from "./AccordionContent.vue";
+export { default as AccordionItem, type AccordionItemProps } from "./AccordionItem.vue";
+export { default as AccordionTrigger, type AccordionTriggerProps, } from "./AccordionTrigger.vue";

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 "./";
+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/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";
+export { default as Alert } from "./Alert.vue";
+export { default as AlertDescription } from "./AlertDescription.vue";
+export { default as AlertTitle } from "./AlertTitle.vue";
+declare const TONE: {
+    readonly neutral: "bg-(--glass-bg-wash) [backdrop-filter:var(--glass-blur-wash)] text-card-foreground";
+    readonly destructive: "feedback-tone feedback-tone-destructive [--feedback-tone-rung:var(--glass-bg-wash)] [backdrop-filter:var(--glass-blur-wash)] text-card-foreground [&>svg]:text-(--tone) *:data-[slot=alert-description]:text-card-foreground/90";
+    readonly success: "feedback-tone feedback-tone-success [--feedback-tone-rung:var(--glass-bg-wash)] [backdrop-filter:var(--glass-blur-wash)] text-card-foreground [&>svg]:text-(--tone) *:data-[slot=alert-description]:text-card-foreground/90";
+    readonly warning: "feedback-tone feedback-tone-warning [--feedback-tone-rung:var(--glass-bg-wash)] [backdrop-filter:var(--glass-blur-wash)] text-card-foreground [&>svg]:text-(--tone) *:data-[slot=alert-description]:text-card-foreground/90";
+    readonly info: "feedback-tone feedback-tone-info [--feedback-tone-rung:var(--glass-bg-wash)] [backdrop-filter:var(--glass-blur-wash)] 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/animated-digit/AnimatedDigit.vue.d.ts

@@ -5,8 +5,7 @@ import type { HTMLAttributes } from "vue";
  * the tabular-numerals + ss01 + lnum font-feature register so consumers
  * stop hand-wiring those rules per site.
  *
- * AC.W6d — promoted from speedtest's hand-wired
- * `useAnimatedNumber(metric) → result.formatted` + `<span class="tabular-
+ * Replaces hand-wired `useAnimatedNumber(metric) → result.formatted` plus a `<span class="tabular-
  * nums">{{ result.formatted.value }}</span>` pattern. Two-line replacement.
  *
  * Consumers pass:
@@ -23,7 +22,7 @@ import type { HTMLAttributes } from "vue";
  *  - `mode`: `"absolute"` (default) or `"progress"` — passes through to
  *    `useAnimatedNumber`.
  *
- * AZ.W-METRIC-UNIFY — AnimatedDigit keeps its OWN local `placeholder: "—"`
+ * AnimatedDigit keeps its own local `placeholder: "—"`
  * default (NOT the shared `coalesceMetric` leaf). It is a distinct animated
  * single-glyph reel, not a static value-display card: it damps the FORMATTED
  * number toward its target and its empty-check fires only on `null`/`undefined`

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

@@ -3,7 +3,7 @@ import { type AuroraConfig } from "./constants/presets";
 import { type AuroraRenderMode } from "./constants/renderMode";
 import type { RendererStatus } from "../../composables/glass/webgpu/rendererStatus";
 /**
- * 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";
+/** 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). */