@mkbabb/glass-ui 7.0.0 → 9.0.0

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, prefersReducedMotion?: boolean): 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

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

@@ -1,5 +1,5 @@
 import { type HTMLAttributes } from "vue";
-import type { SelectionMode } from "../_shared/selection";
+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. */

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

@@ -1,4 +1,4 @@
-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";
+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,5 +1,5 @@
 import { type HTMLAttributes } from "vue";
-import { type AlertVariants } from "./";
+import { type AlertVariants } from "./index.js";
 type AlertAnnouncement = "off" | "polite" | "assertive";
 type __VLS_Props = {
     class?: HTMLAttributes["class"];

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,13 +1,13 @@
-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";
+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: "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";
+    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;

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

@@ -1,7 +1,7 @@
-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 procedural background.
  *
@@ -91,6 +91,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
     pause: () => void;
     resume: () => void;
     isArmed: Readonly<import("vue").Ref<boolean, boolean>>;
+    isSettled: Readonly<import("vue").Ref<boolean, boolean>>;
     rendererStatus: Readonly<import("vue").Ref<RendererStatus, RendererStatus>>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     rendererStatus: (status: RendererStatus) => any;

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

@@ -1,4 +1,4 @@
-import { type AuroraConfig, type AuroraMedium, type OklchStop, type WarpMode } from "../constants/presets";
+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. */

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

@@ -23,9 +23,9 @@
  * as clamped overrides. An absent atom keeps the default's value, so the empty atom
  * set (`DEFAULT_ATOMS`) resolves to exactly the wispy-sky default by construction.
  */
-import { type AuroraConfig, type AuroraMedium, type OklchStop } from "../constants/presets";
-import { type AuroraHarmony } from "./color";
-import { type AuroraMotionAtom, type AuroraZoneArrangement } from "./atoms-fields";
+import { type AuroraConfig, type AuroraMedium, type OklchStop } from "../constants/presets.js";
+import { type AuroraHarmony } from "./color.js";
+import { type AuroraMotionAtom, type AuroraZoneArrangement } from "./atoms-fields.js";
 /**
  * The ZONES arrangement character — selects the nuclei placement prior. NOT a bare
  * integer count: the same count reads as a different field per arrangement.

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

@@ -36,7 +36,7 @@
  * 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";
+import type { AuroraConfig, AuroraNucleus } from "../constants/presets.js";
 /** A linear-sRGB triple in [0,1]. */
 type Lin = [number, number, number];
 /** Linear-sRGB relative luminance (Rec.709, WCAG), the contrast-floor metric. */

package/dist/components/aurora/composables/auroraImageSource.d.ts

@@ -15,8 +15,8 @@
  *
  * The runtime composes this leaf as the WebGL2 image-source path.
  */
-import { type UploadableImageSource } from "../../../composables/glass/textureUpload";
-import type { AuroraConfig } from "../constants/presets";
+import { type UploadableImageSource } from "./textureUpload.js";
+import type { AuroraConfig } from "../constants/presets.js";
 export interface AuroraImageCoordinator {
     /** The decoded photo (or null before decode, on a palette config). */
     getDecodedImage(): UploadableImageSource | null;

package/dist/components/aurora/composables/color.d.ts

@@ -1,7 +1,6 @@
-import { type ColorHarmony, type OklchStop } from "../../../composables/color";
-export { cssToOklch, oklchStopToHex, oklchToLinear, gamutMapStop, } from "../../../composables/color";
-export type { OklchStop } from "../../../composables/color";
-export type { ColorHarmony } from "../../../composables/color";
+import { type ColorHarmony, type OklchStop } from "../../../composables/color/index.js";
+export type { OklchStop } from "../../../composables/color/index.js";
+export type { ColorHarmony } from "../../../composables/color/index.js";
 /**
  * Pack up to `maxStops` OklchStops into linear-sRGB triples. When `out` is
  * provided the buffer is filled in place (no allocation) — the runtime owns a

package/dist/components/aurora/composables/frameLoop.d.ts

@@ -11,15 +11,16 @@
  *
  * `drawFrame` re-sends the per-frame cursor + time uniforms and issues the single
  * full-screen-triangle draw. `needsAnimation` is the demand gate: `false` under
- * reduced-motion (the static frame draws once, then parks), `false` at steady-state (all
- * four drift uniforms 0 AND the field settled — the next frame is pixel-identical), and
- * `true` while drift is live or the field is still easing (engagement, speed, burst,
- * attractor motion above ε).
+ * reduced-motion (the static frame draws once, then parks), `false` at steady-state (no
+ * drift axis above its own amplitude floor AND the field settled — the next frame is
+ * pixel-identical), and `true` while drift is live or the field is still easing
+ * (engagement, speed, burst, attractor motion above ε). The drift half is
+ * `isAuroraDriftLive` — the ONE predicate this loop and both WGSL loops share.
  */
-import type { UniformLocations } from "./glSetup";
-import type { AuroraCursorUniforms } from "./uniformBridge";
-import type { AuroraConfig } from "../constants/presets";
-import type { UsePointerVelocityField } from "../../../composables/motion/pointer/usePointerVelocityField";
+import type { UniformLocations } from "./glSetup.js";
+import type { AuroraCursorUniforms } from "./uniformBridge.js";
+import { type AuroraConfig } from "../constants/presets.js";
+import type { UsePointerVelocityField } from "../../../composables/motion/pointer/usePointerVelocityField.js";
 /** The at-rest scalars a config-less cursor read seeds (strength ceiling + influence radius). */
 export interface AuroraCursorScalars {
     /** The active-strength ceiling (cfg.strength; scaled by engagement). */

package/dist/components/aurora/composables/glSetup.d.ts

@@ -9,11 +9,11 @@
  * shader-uniform boundary: a NEW uniform name must be added here, and the cache is
  * keyed off it, so a fresh uniform always gets a location slot.
  */
-import type { WebGLCanvasFrame } from "../../../composables/glass/webgpu/useGpuSubstrate";
-import type { UsePointerVelocityField } from "../../../composables/motion/pointer/usePointerVelocityField";
-import type { AuroraConfig } from "../constants/presets";
-import { type AuroraImageCoordinator } from "./auroraImageSource";
-import { type AuroraCursorScalars } from "./frameLoop";
+import type { WebGLCanvasFrame } from "../../../composables/glass/webgpu/useGpuSubstrate.js";
+import type { UsePointerVelocityField } from "../../../composables/motion/pointer/usePointerVelocityField.js";
+import type { AuroraConfig } from "../constants/presets.js";
+import { type AuroraImageCoordinator } from "./auroraImageSource.js";
+import { type AuroraCursorScalars } from "./frameLoop.js";
 export declare const UNIFORM_NAMES: readonly ["uTime", "uPalette", "uStopCount", "uNucleiCount", "uNucleiPos", "uNucleiRadius", "uNucleiPaletteBias", "uNucleiValueBias", "uNucleiDriftRadius", "uNucleiDriftPhase", "uNucleiElong", "uNucleiAngle", "uSoftmaxBeta", "uValueVariance", "uWarpAmount", "uWarpScale", "uWarpDrift", "uWarpMode", "uNoiseOctaves", "uMedium", "uHuePath", "uFlowPattern", "uFlowFocal", "uFlowAngle", "uFlowCurl", "uCursor", "uCursorStrength", "uCursorRadius", "uStrokeAmount", "uStrokeScale", "uStrokeAnisotropy", "uStrokeLayers", "uStrokeMode", "uStrokeOrient", "uLightDir", "uLightColor", "uWetEdge", "uGranulation", "uImpasto", "uBrokenColor", "uCanvasGrain", "uMetalPolish", "uMetalHeightScale", "uNucleiDrift", "uPaletteDrift", "uBreathDepth", "uBreathPeriod", "uSaturation", "uPaperGrain", "uAlpha", "uVividness", "uImage", "uBlurMin", "uBlurMax", "uImageAspect"];
 export type UniformName = (typeof UNIFORM_NAMES)[number];
 export type UniformLocations = Record<UniformName, WebGLUniformLocation | null>;
@@ -27,11 +27,6 @@ export interface GlProgram {
         buf: WebGLBuffer;
     };
 }
-/**
- * Compile + link the shader pair, build the full-screen triangle (one draw covers
- * the viewport), and resolve the uniform location cache. Leaves the program bound.
- */
-export declare function createGlProgram(gl: WebGL2RenderingContext, vertexSrc: string, fragmentSrc: string): GlProgram;
 export interface AuroraGLSetupDeps {
     opaquePresentation: boolean;
     getConfig: () => AuroraConfig;

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

@@ -15,8 +15,8 @@
  * Y-origin convention: config authoring is CSS-top-origin (0 = top). The seams
  * flip Y at the uniform boundary (`flipY` in uniformBridge/frameLoop).
  */
-import { type RendererStatus } from "../../../composables/glass/webgpu/useGpuSubstrate";
-import type { AuroraConfig, AuroraInstance } from "../constants/presets";
+import { type RendererStatus } from "../../../composables/glass/webgpu/useGpuSubstrate.js";
+import type { AuroraConfig, AuroraInstance } from "../constants/presets.js";
 export type AuroraRuntimeMode = "live" | "capture";
 /**
  * The three independent reasons the frame loop may be suspended. Owned by the
@@ -75,6 +75,20 @@ export interface AuroraRuntimeOptions {
      * threaded through both seams.
      */
     forceWebGLUnderSoftwareRaster?: boolean;
+    /**
+     * Pin the render backend instead of letting the substrate picker choose.
+     *
+     * `"webgl2"` withholds the WGSL setup from `createGpuSubstrate`, which is the ONLY
+     * honest way to reach the WebGL2 arm in-app: the picker's `attemptWebGPU` reads
+     * `supportsWebGPU() && setupWGPU != null`, so a browser flag cannot express this and
+     * `renderMode: "webgl"` is a MODE (animate at all / never), not a backend.
+     *
+     * The capture harness drives it as `?engine=webgl2` so the GL arm can be archived
+     * before it is deleted. There is no `"webgpu"` member: forcing WebGPU on a host
+     * without an adapter would be a masking fallback — the picker already prefers it and
+     * falls loud when it cannot arm.
+     */
+    forceBackend?: "webgl2";
     /**
      * Reveal-bloom consumer door.
      *
@@ -131,7 +145,18 @@ export interface AuroraRuntime extends Omit<AuroraInstance, "pause" | "resume">
     /** Live reduced-motion state; the cursor listener early-outs on it. */
     readonly reducedMotion: boolean;
 }
-/** One medium-aware predicate shared by pointer writes and uniform projection. */
+/**
+ * One medium-aware predicate shared by pointer writes and uniform projection.
+ *
+ * `swirl` is the DEFAULT-ON axis: every aurora shapes under the pointer unless its
+ * config says `swirl: false`. Suppression is not this predicate's job — the master
+ * tempo scalar zeroes the field tick under reduced motion and under the background
+ * pause, so a PRM reader never sees the cursor regardless of what this returns.
+ *
+ * `light` stays an explicit opt-in AND stays medium-aware: it steers the impasto light
+ * direction, and the smooth body has no impasto, so `light` alone over `smooth` shapes
+ * nothing and must not arm a pointer path.
+ */
 export declare function isAuroraPointerEnabled(config: AuroraConfig): boolean;
 /** One shader-time projection shared by the WebGPU and WebGL2 bridges. */
 export declare function resolveAuroraRenderTime(config: AuroraConfig, elapsedSec: number, progress: number, reducedMotion: boolean): number;

package/dist/{composables/glass → components/aurora/composables}/textureUpload.d.ts

@@ -22,8 +22,6 @@
  * so the decoded bytes are raw sRGB-encoded, un-premultiplied — the shader owns the
  * sRGB→linear transfer + the premultiply-on-display, exactly like the procedural path.
  */
-/** The shared decode options — the ONE normalised `createImageBitmap` flag set. */
-export declare const IMAGE_DECODE_OPTIONS: ImageBitmapOptions;
 /**
  * An already-uploadable image source — a decoded bitmap or a live DOM raster that
  * both `gl.texImage2D` and `queue.copyExternalImageToTexture` accept directly.
@@ -35,12 +33,6 @@ export type UploadableImageSource = ImageBitmap | HTMLImageElement | HTMLCanvasE
  * every form to an {@link UploadableImageSource} via the shared decode contract.
  */
 export type ImageInputSource = UploadableImageSource | Blob | string;
-/**
- * Decode a `Blob` to an `ImageBitmap` through the shared normalised flag set. The
- * single decode home — a consumer NEVER re-spells `createImageBitmap` with its own
- * (divergent) options.
- */
-export declare function decodeImageBitmap(blob: Blob): Promise<ImageBitmap>;
 /**
  * Normalise any {@link ImageInputSource} to an uploadable source. A URL string is
  * fetched → blob → decoded; a `Blob` is decoded; an already-uploadable source is
@@ -54,11 +46,6 @@ export declare function resolveImageSource(src: ImageInputSource): Promise<Uploa
  * texture creation has exactly ONE home (the anti-evasion floor). DOM-only (`ImageData`).
  */
 export declare function placeholderImageSource(): ImageData;
-/** The intrinsic pixel dimensions of an uploadable source (both legs size the texture from it). */
-export declare function imageSourceDimensions(src: UploadableImageSource): {
-    width: number;
-    height: number;
-};
 /** WebGL2 upload options — the sampling register the texture is created with. */
 export interface WebGL2TextureOptions {
     /** Min/mag filter. Default `LINEAR` (the smooth-bokeh dissolve register). */

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

@@ -15,8 +15,8 @@
  * The pre-allocated upload buffers live in the bridge: a slider drag refills them
  * in place rather than allocating ~8 Float32Arrays per frame.
  */
-import type { OklchStop } from "../../../composables/color";
-import type { UniformLocations } from "./glSetup";
+import type { OklchStop } from "../../../composables/color/index.js";
+import type { UniformLocations } from "./glSetup.js";
 /**
  * the aurora cursor UNIFORM shape (the `uCursor*` upload inputs). The
  * retired `cursorModel.ts` `CursorState` is GONE — the cursor is now the mapped readout of
@@ -31,7 +31,7 @@ export interface AuroraCursorUniforms {
     radius: number;
 }
 export declare const AURORA_CURSOR_UNIFORM_REST: AuroraCursorUniforms;
-import { type AuroraConfig } from "../constants/presets";
+import { type AuroraConfig } from "../constants/presets.js";
 export declare const MEDIUM_ID: {
     readonly smooth: 0;
     readonly pastel: 1;
@@ -68,19 +68,7 @@ export declare const WARP_ID: {
     readonly hybrid: 2;
     readonly curl: 3;
 };
-export declare const STROKE_MODE_ID: {
-    readonly oil: 0;
-    readonly knife: 1;
-    readonly chunky: 3;
-};
 export declare const AURORA_CATCH_LIGHT_ANCHOR: OklchStop;
-/**
- * Resolve a config's `lightColor` to a LINEAR-light `[r,g,b]` triple. Accepts either
- * a raw linear triple (the array form, passed through) OR an `{L,C,h}` OKLCh anchor
- * (derived through the shared `warmCatchLight` helper). Omitted = the canonical aurora
- * warm-white from `AURORA_CATCH_LIGHT_ANCHOR`.
- */
-export declare function resolveLightColor(lightColor: [number, number, number] | OklchStop | undefined): [number, number, number];
 /**
  * The effective `uMedium` integer for a config: a pure identity map over the
  * medium union (the `oil` + `strokeMode:"crayon"` peer-route is REMOVED; crayon is its
@@ -88,11 +76,6 @@ export declare function resolveLightColor(lightColor: [number, number, number] |
  * `satisfies` guarantees it), so this never resolves `undefined`.
  */
 export declare function resolveMediumId(cfg: AuroraConfig): number;
-/**
- * The `uStrokeMode` integer for a config. `strokeMode` is total over
- * `STROKE_MODE_ID` (no `crayon` special-case), so this is a direct map.
- */
-export declare function resolveStrokeModeId(cfg: AuroraConfig): number;
 /**
  * The `uStrokeOrient` integer for a config. The painterly mediums (`vangogh`,
  * `oil-pastel`, `crayon`) FORCE the structure-tensor orientation regardless of the

package/dist/components/aurora/composables/uniformBridgeWGPU.d.ts

@@ -34,8 +34,8 @@
  * Y-origin: config authoring is CSS-top-origin (0 = top); the bridge flips Y at the
  * uniform boundary (`flipY`), exactly as the GLSL `uniformBridge` does.
  */
-import { type AuroraConfig } from "../constants/presets";
-import type { AuroraCursorUniforms } from "./uniformBridge";
+import { type AuroraConfig } from "../constants/presets.js";
+import type { AuroraCursorUniforms } from "./uniformBridge.js";
 /** The total uniform-buffer byte size (16-aligned). */
 export declare const AURORA_WGPU_UNIFORM_BYTES = 672;
 /**

package/dist/components/aurora/composables/uniformBridgeWGPUImage.d.ts

@@ -21,8 +21,8 @@
  *   nuc1: array<vec4<f32>, 8>  off 224   (driftRadius, driftPhase, elong, angle)
  *   total: 352 bytes (16-aligned)
  */
-import { type AuroraConfig } from "../constants/presets";
-import type { AuroraCursorUniforms } from "./uniformBridge";
+import { type AuroraConfig } from "../constants/presets.js";
+import type { AuroraCursorUniforms } from "./uniformBridge.js";
 /** The total image-uniform-buffer byte size (16-aligned). */
 export declare const AURORA_IMAGE_WGPU_UNIFORM_BYTES = 352;
 export interface AuroraImageWGPUScratch {

package/dist/components/aurora/composables/useAurora.d.ts

@@ -1,8 +1,8 @@
 import { type Ref } from "vue";
-import { type AuroraRuntimeOptions } from "./runtime";
-import { type ConfigSource } from "./configSource";
-import type { AuroraConfig } from "../constants/presets";
-import { type RendererStatus } from "../../../composables/glass/webgpu/rendererStatus";
+import { type AuroraRuntimeOptions } from "./runtime.js";
+import { type ConfigSource } from "./configSource.js";
+import type { AuroraConfig } from "../constants/presets.js";
+import { type RendererStatus } from "../../../composables/glass/webgpu/rendererStatus.js";
 /**
  * Adaptive-substrate options threaded down from `Aurora.vue`. `"webgl"` is the
  * historical name of the animated GPU mode; the runtime itself prefers WebGPU
@@ -42,8 +42,36 @@ export interface UseAuroraReturn {
      * acquisition and flips only when the backend readiness promise resolves.
      */
     isArmed: Readonly<Ref<boolean>>;
+    /**
+     * The SETTLE BEACON. `true` once the runtime has armed, the current config has been
+     * applied, and the ground→field entrance has finished painting over it.
+     *
+     * `Aurora.vue` publishes it as `data-aurora-settled`; every capture — π, gate, or a
+     * consumer's own — waits on that attribute. A wall-clock sleep is not a substitute:
+     * inside the entrance the field paints medium-INDEPENDENTLY, so an early capture
+     * reads a picture that is identical across every medium and across page loads, with
+     * perfect confidence and no way to tell. Three seats measured that picture.
+     *
+     * Any config change re-opens it — a preset switch has its own entrance. So does a
+     * context LOSS: the field it witnesses is gone, and the restore replays the entrance,
+     * so the beacon never carries its pre-loss stamp across that replay.
+     */
+    isSettled: Readonly<Ref<boolean>>;
     rendererStatus: Readonly<Ref<RendererStatus>>;
 }
+/**
+ * How long past the last applied config the field needs before a capture is admissible.
+ *
+ * The entrance is the ground→field CROSSFADE: `.aurora-canvas-layer` transitions opacity
+ * 0→1 over `--duration-slow` (0.45 s) once `isArmed` flips, dissolving the palette-derived
+ * frame-0 ground into the live field. Until that completes a capture reads a blend of the
+ * two, which is what makes it medium-independent. 500 ms clears the 450 ms token with the
+ * margin for the frame the config write lands on.
+ *
+ * The clock is advanced by `requestAnimationFrame`, not `setTimeout`, so a backgrounded
+ * or parked surface never stamps a beacon it has not painted.
+ */
+export declare const AURORA_SETTLE_MS = 500;
 /**
  * Vue-side wrapper for the imperative `createAurora` runtime.
  *

package/dist/components/aurora/composables/useCursorInteraction.d.ts

@@ -1,6 +1,6 @@
 import { type Ref } from "vue";
-import { type ConfigSource } from "./configSource";
-import type { AuroraConfig } from "../constants/presets";
+import { type ConfigSource } from "./configSource.js";
+import type { AuroraConfig } from "../constants/presets.js";
 export interface CursorInteractionOptions {
     /** Fires `setCursor(x,y,strength)` for continuous swirl. */
     setCursor: (x: number, y: number, strength?: number) => void;

package/dist/components/aurora/composables/wgpuSetup.d.ts

@@ -12,11 +12,11 @@
  * `frameLoop`/`runtime.resize` exactly — the loop is substrate-AGNOSTIC, so the same
  * `getConfig`/`getReducedMotion`/`cursor` closures drive both backends.
  */
-import type { WebGPUCanvasFrame } from "../../../composables/glass/webgpu/useWebGPUCanvas";
-import { type AuroraCursorScalars } from "./frameLoop";
-import { type UploadableImageSource } from "../../../composables/glass/textureUpload";
-import type { AuroraConfig } from "../constants/presets";
-import type { UsePointerVelocityField } from "../../../composables/motion/pointer/usePointerVelocityField";
+import type { WebGPUCanvasFrame } from "../../../composables/glass/webgpu/useWebGPUCanvas.js";
+import { type AuroraCursorScalars } from "./frameLoop.js";
+import { type UploadableImageSource } from "./textureUpload.js";
+import { type AuroraConfig } from "../constants/presets.js";
+import type { UsePointerVelocityField } from "../../../composables/motion/pointer/usePointerVelocityField.js";
 export interface AuroraWGPUSetupDeps {
     canvas: HTMLCanvasElement;
     /** Live canvases present opaque; capture canvases retain premultiplied alpha. */

package/dist/components/aurora/constants/budget.d.ts

@@ -1,33 +1,5 @@
 /** Shared CPU-side ceilings for GPU surface work. Authored values are clamped at
  * upload so a configuration cannot exceed the frame or VRAM budget. */
-/**
- * The device-pixel-ratio clamp. A retina/4K display reports `devicePixelRatio`
- * 2–3+; rendering a full-viewport `backdrop-filter`-adjacent WebGL surface at
- * 3× is ~2.25× the fill of 2× for no perceptible gain on a drift background.
- * Cap the backing-store resolution at 2× — the single biggest VRAM/fill lever
- * after offscreen parking. Consumed by Aurora and Blob backing-store sizing.
- */
-export declare const AV_DPR_MAX = 2;
-/**
- * The Aurora decorative-wash DPR ceiling, distinct from the focal Blob's
- * {@link AV_DPR_MAX}. The aurora atmosphere is a
- * heavily-blurred drift background, not a sharp-silhouette creature: backing it at
- * full-viewport 2× (~2880×1800, ~21.8 MB native heap) is
- * visually indistinguishable from 1.5× on a drift wash (the per-pixel FBM is
- * already smoothed below the DPR-2 detail floor), so the 1.5× ceiling quarters the
- * GPU memory and composite raster cost without perceptible loss. The focal Blob
- * keeps {@link AV_DPR_MAX} = 2 because its silhouette is sharp; only Aurora
- * reads this sub-cap. This is the CPU-side backing-store DIMENSION only; it never
- * reaches the shader.
- */
-export declare const AV_AURORA_DPR_MAX = 1.5;
-/**
- * The maximum animated metaball nuclei (the goo-blob body + its satellites, or
- * an aurora field's count). The goo-blob shader hard-caps satellites at 4; this
- * is the authored-config soft cap (body + ≤2 satellites is the budget-safe
- * register, ≤3 the ceiling). A preset above this is clamped at upload.
- */
-export declare const AV_MAX_BLOBS = 3;
 /**
  * The maximum palette colors a budget-safe field mixes per frame. Aurora's
  * shader caps palette stops at {@link MAX_STOPS} (8) for authoring range; this
@@ -35,14 +7,6 @@ export declare const AV_MAX_BLOBS = 3;
  * cheap. Above this the gradient cost grows without perceptible richness.
  */
 export declare const AV_MAX_COLORS = 4;
-/**
- * The drift-loop duration band, in seconds. An animation that loops faster than
- * {@link AV_LOOP_DURATION_MIN_S} reads as nervous (and never lets the eye rest →
- * no battery reprieve); slower than {@link AV_LOOP_DURATION_MAX_S} reads as
- * static. The 8–15s band is the SOTA-named budget-safe drift window.
- */
-export declare const AV_LOOP_DURATION_MIN_S = 8;
-export declare const AV_LOOP_DURATION_MAX_S = 15;
 /** Clamp a numeric value into an inclusive `[min, max]` band. */
 export declare function clampBudget(value: number, min: number, max: number): number;
 /**

package/dist/components/aurora/constants/presets.d.ts

@@ -9,12 +9,12 @@
  * the shape and a minimum-viable DEFAULT_AURORA_CONFIG for the component's own
  * type-check ergonomics.
  */
-import type { OklchStop } from "../../../composables/color";
+import type { OklchStop } from "../../../composables/color/index.js";
 export type { OklchStop };
 import type { HueInterpolationMethod } from "@mkbabb/value.js/color";
 export type AuroraHuePath = HueInterpolationMethod;
 export type AuroraSource = "palette" | "image";
-import type { ImageInputSource } from "../../../composables/glass/textureUpload";
+import type { ImageInputSource } from "../composables/textureUpload.js";
 export type AuroraImageSource = ImageInputSource;
 export type { ImageInputSource };
 /** The per-fragment blur-radius band (uv units) the drifting zone lerps between. */
@@ -68,8 +68,13 @@ export type WarpMode = "fbm" | "cellular" | "hybrid" | "curl";
  * - `swirl`  — cursor-local warp and luminance lean on both engines.
  * - `amplitude` — sizes the transient burst folded into cursor strength on the CPU.
  * Every axis is suppressed under `prefers-reduced-motion` + the DockBackgroundToggle
- * pause (the master tempo scalar is the single suppression seam). The wispy-sky
- * default carries no `interactivity` (every axis OFF — the default stays static).
+ * pause (the master tempo scalar is the single suppression seam).
+ *
+ * `swirl` is ON by default — a config opts OUT with `swirl: false`. Every aurora is
+ * pointer-shapeable, and a capability parked behind an opt-in flag is a capability the
+ * surface does not have. `light` and `scroll` remain explicit opt-ins: `light` is only
+ * meaningful over a painterly body (smooth has no impasto to relight), and `scroll`
+ * re-times the shader clock against page position, which no surface should inherit.
  */
 export interface AuroraInteractivity {
     light?: boolean;
@@ -204,12 +209,46 @@ export interface AuroraConfig {
      */
     vividness?: number;
     /**
-     * Pointer/scroll interactivity opt-in (default OFF — the wispy-sky
-     * default stays static). Omitted = every
-     * axis off. Aliased on `/api` as part of the `AuroraConfig` surface.
+     * Pointer/scroll interactivity. `swirl` is ON unless a config says
+     * `swirl: false` — the pointer shapes every aurora by default, PRM-guarded by the
+     * master tempo scalar. `light` and `scroll` stay explicit opt-ins.
+     * Aliased on `/api` as part of the `AuroraConfig` surface.
      */
     interactivity?: AuroraInteractivity;
 }
+/**
+ * The per-axis liveness floor of the drift demand gate.
+ *
+ * The four drift axes do NOT share a domain — nuclei 0..0.05, palette 0..0.04, breath
+ * 0..0.15, warp 0..0.015 — so ONE flat epsilon over raw values would retire whole axes
+ * (any epsilon that reaches `paletteDrift` is above `warpDrift`'s entire range). Each
+ * axis therefore carries its own floor, seeded at 1% of that axis's authored domain.
+ *
+ * The floors are the SHAPE, not the cut. Cutting them where they would actually park a
+ * loop is a PAINT decision and it is `W-AURORA-FIELD`'s (π-FIELD), because the shipped
+ * configs do not separate in config space: the recessive shell field
+ * (`aurora-hero.ts` `nucleiDrift`/`paletteDrift` 0.012) and the focal studio default
+ * (0.015) sit 25% apart on both axes and are identical on the other two. What separates
+ * them is not the drift amplitude but the composited range their palettes can express —
+ * shell chroma ≤ 0.07 over an L span of 0.03 against the studio's C 0.16/0.13/0.095 —
+ * and that term is the field re-founding's to derive, not this gate's to guess.
+ */
+export declare const AURORA_DRIFT_FLOOR: {
+    readonly nucleiDrift: 0.0005;
+    readonly paletteDrift: 0.0004;
+    readonly breathDepth: 0.0015;
+    readonly warpDrift: 0.00015;
+};
+/**
+ * The demand gate over the four drift axes — the ONE predicate the WebGL2 frame loop
+ * and BOTH WGSL loops consume.
+ *
+ * It was three copies of a `!== 0` ladder, and they had already diverged: the image
+ * pipeline's copy omitted `breathDepth`, so an image-source aurora carrying breath and
+ * no drift parked its loop and never rendered the breath. Liveness is an AMPLITUDE
+ * question against each axis's own domain, never a literal comparison against zero.
+ */
+export declare function isAuroraDriftLive(config: AuroraConfig): boolean;
 /**
  * Pointer-cursor API exposed by `createAurora`. Values in 0..1 (CSS-top-origin).
  * Runtime flips Y and eases internally.

package/dist/components/aurora/constants/shaders/aurora-image.frag.d.ts

@@ -1,3 +1 @@
-export declare const IMAGE_BLUR_RINGS = 3;
-export declare const IMAGE_BLUR_SECTORS = 8;
 export declare const IMAGE_FRAGMENT_SRC: string;