@mkbabb/glass-ui 8.0.0 → 10.0.0

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

@@ -1,2 +1,2 @@
 export { default as SegmentedTabs } from "./SegmentedTabs.vue.js";
-export type { SegmentedTabOption, SegmentedTabsVariant, SegmentedTabsSemantics, SegmentedTabsActivation, SegmentedTabsOrientation, SegmentedTabsProps, SegmentedTabsResponsive, } from "./SegmentedTabs.vue.js";
+export type { SegmentedTabOption, SegmentedTabsVariant, SegmentedTabsSemantics, SegmentedTabsActivation, SegmentedTabsOrientation, SegmentedTabsProps, SegmentedTabsResponsive, } from "./types.js";

package/dist/components/tabs/styles/drag.css

@@ -1 +1 @@
-.glass-drag-grabbable{cursor: grab;touch-action: none;}.glass-drag-lift{cursor: grabbing;will-change: transform;}.segmented-tabs:has(.segmented-indicator.glass-drag-grabbable) .segmented-tab[data-active]{pointer-events: none;}.segmented-indicator.glass-drag-lift{z-index: 30;}
+@layer components{.glass-drag-grabbable{cursor: grab;touch-action: none;}.glass-drag-lift{cursor: grabbing;will-change: transform;}.segmented-tabs:has(.segmented-indicator.glass-drag-grabbable) .segmented-tab[data-active]{pointer-events: none;}.segmented-indicator.glass-drag-lift{z-index: 30;}}

package/dist/components/tabs/styles/segmented.css

@@ -1 +1 @@
-.segmented-tabs{--bouncy-track-trim: 0.1875rem;--bouncy-slider-radius: var(--radius-tab);--bouncy-track-radius: calc(var(--bouncy-slider-radius) + var(--bouncy-track-trim));--stretch: 1;position: relative;display: inline-grid;grid-auto-flow: column;grid-auto-columns: 1fr;padding: var(--bouncy-track-trim);border-radius: var(--bouncy-track-radius);overflow: visible;}.segmented-tabs--vertical{display: inline-flex;flex-direction: column;grid-auto-flow: unset;grid-auto-columns: unset;align-items: stretch;--bouncy-slider-radius: var(--radius-strip);--radius-ctx: var(--bouncy-track-radius);--radius-inset: var(--bouncy-track-trim);}.segmented-tabs--vertical .segmented-indicator{border-radius: max( var(--radius-floor),calc(var(--radius-ctx) - var(--radius-inset)) );}@media (min-width: 640px){.segmented-tabs{--bouncy-track-trim: 0.25rem;}}.segmented-indicator{position: absolute;z-index: 0;border-radius: var(--bouncy-slider-radius);transform-origin: var(--eyeglass-origin,50%) center;scale: var(--eyeglass-span,var(--stretch)) var(--eyeglass-swell,1);}.segmented-tabs--vertical .segmented-indicator{transform-origin: center var(--eyeglass-origin,50%);scale: var(--eyeglass-swell,1) var(--eyeglass-span,var(--stretch));}.segmented-tabs--underline .segmented-indicator{background: none;border-radius: 0;border-block-end: var(--paper-ink-mark-weight) solid var(--paper-ink-mark-color);scale: var(--stretch) 1;}.segmented-tabs--underline.segmented-tabs--vertical .segmented-indicator{border-block-end: none;border-inline-start: var(--paper-ink-mark-weight) solid var(--paper-ink-mark-color);scale: 1 var(--stretch);}.segmented-tabs:not(.segmented-tabs--underline){--eyeglass-span-max: 1.6;--eyeglass-cascade-annotation: 100ms;--eyeglass-light-clock: var(--engage-control-engage-release);transition: background var(--eyeglass-light-clock) var(--ease-standard);}.segmented-tabs:not(.segmented-tabs--underline) .segmented-indicator{box-shadow: var(--glass-rim-top),var(--glass-rim-bottom),inset 0 1px 2px var(--tab-track-recess-ink);}.segmented-tabs[data-eyeglass-wake]:not(.segmented-tabs--underline){--eyeglass-light-clock: var(--engage-control-engage-attack);background: color-mix( in oklab,var(--glass-plate-quiet),var(--glass-capsule-warm) var(--glass-capsule-warm-floor) );}.segmented-tabs[data-eyeglass-wake]:not(.segmented-tabs--underline) .segmented-indicator{box-shadow: var(--glass-rim-top),var(--glass-rim-bottom),var(--glass-shadow-capsule);}.segmented-indicator[data-eyeglass-clamped]{--eyeglass-swell: 1.22;}@media (prefers-reduced-motion: no-preference){.segmented-indicator--js{transition: translate var(--tab-indicator-duration) var(--spring-dock),width var(--tab-indicator-duration) var(--spring-dock),height var(--tab-indicator-duration) var(--spring-dock),scale var(--tab-indicator-duration) var(--ease-cartoon-punch),box-shadow var(--eyeglass-light-clock,var(--duration-fast)) var(--ease-standard),opacity var(--duration-fast) ease;}}.segmented-tab{position: relative;z-index: 10;border: none;background: none;font-weight: 500;cursor: pointer;white-space: nowrap;padding: 0.25rem 0.625rem;border-radius: var(--bouncy-slider-radius);font: inherit;font-size: var(--type-caption);color: color-mix(in oklab,var(--muted-foreground),var(--glass-capsule-warm) 12%);transition: color var(--duration-fast) ease;scale: 1;translate: 0;}@media (min-width: 640px){.segmented-tab{padding: 0.3125rem 0.75rem;font-size: var(--type-small);}}.segmented-tab[data-active]{color: var(--foreground);transition-delay: var(--eyeglass-cascade-annotation,0s);}.segmented-tab.is-disabled{opacity: 0.4;cursor: not-allowed;pointer-events: none;filter: blur(0.5px);}.segmented-tabs--underline{display: flex;grid-auto-flow: unset;grid-auto-columns: unset;gap: 0.25rem;padding: 0;background: none;-webkit-backdrop-filter: none;backdrop-filter: none;box-shadow: none;border-radius: 0;border-block-end: 1px solid var(--border);}.segmented-tabs--underline.segmented-tabs--vertical{flex-direction: column;align-items: stretch;border-block-end: none;border-inline-start: 1px solid var(--border);}.segmented-tabs--underline .segmented-tab{padding: 0.375rem 0.75rem;font-size: var(--type-subheading);letter-spacing: var(--type-tracking-display);border-radius: var(--bouncy-slider-radius);transition: color var(--duration-fast) ease;}.segmented-tabs--underline.segmented-tabs--vertical .segmented-tab{text-align: start;}.segmented-tabs--underline .segmented-tab:hover{color: color-mix(in oklab,var(--foreground) 70%,transparent);}
+@layer components{.segmented-tabs{--bouncy-track-trim: 0.1875rem;--bouncy-slider-radius: var(--radius-tab);--bouncy-track-radius: calc(var(--bouncy-slider-radius) + var(--bouncy-track-trim));--stretch: 1;position: relative;display: inline-grid;grid-auto-flow: column;grid-auto-columns: 1fr;padding: var(--bouncy-track-trim);border-radius: var(--bouncy-track-radius);overflow: visible;}.segmented-tabs--vertical{display: inline-flex;flex-direction: column;grid-auto-flow: unset;grid-auto-columns: unset;align-items: stretch;--bouncy-slider-radius: var(--radius-strip);--radius-ctx: var(--bouncy-track-radius);--radius-inset: var(--bouncy-track-trim);}.segmented-tabs--vertical .segmented-indicator{border-radius: max( var(--radius-floor),calc(var(--radius-ctx) - var(--radius-inset)) );}@media (min-width: 640px){.segmented-tabs{--bouncy-track-trim: 0.25rem;}}.segmented-indicator{position: absolute;z-index: 0;border-radius: var(--bouncy-slider-radius);transform-origin: var(--eyeglass-origin,50%) center;scale: var(--eyeglass-span,var(--stretch)) var(--eyeglass-swell,1);}.segmented-tabs--vertical .segmented-indicator{transform-origin: center var(--eyeglass-origin,50%);scale: var(--eyeglass-swell,1) var(--eyeglass-span,var(--stretch));}.segmented-tabs--underline .segmented-indicator{background: none;border-radius: 0;border-block-end: var(--paper-ink-mark-weight) solid var(--paper-ink-mark-color);scale: var(--stretch) 1;}.segmented-tabs--underline.segmented-tabs--vertical .segmented-indicator{border-block-end: none;border-inline-start: var(--paper-ink-mark-weight) solid var(--paper-ink-mark-color);scale: 1 var(--stretch);}.segmented-tabs:not(.segmented-tabs--underline){--eyeglass-span-max: 1.6;--eyeglass-cascade-annotation: 100ms;--eyeglass-light-clock: var(--engage-control-engage-release);transition: background var(--eyeglass-light-clock) var(--ease-standard);}.segmented-tabs:not(.segmented-tabs--underline) .segmented-indicator{box-shadow: var(--glass-rim-top),var(--glass-rim-bottom),inset 0 1px 2px var(--tab-track-recess-ink);}.segmented-tabs[data-eyeglass-wake]:not(.segmented-tabs--underline){--eyeglass-light-clock: var(--engage-control-engage-attack);background: color-mix( in oklab,var(--glass-plate-quiet),var(--glass-capsule-warm) var(--glass-capsule-warm-floor) );}.segmented-tabs[data-eyeglass-wake]:not(.segmented-tabs--underline) .segmented-indicator{box-shadow: var(--glass-rim-top),var(--glass-rim-bottom),var(--glass-shadow-capsule);}.segmented-indicator[data-eyeglass-clamped]{--eyeglass-swell: 1.22;}@media (prefers-reduced-motion: no-preference){.segmented-indicator--js{transition: translate var(--tab-indicator-duration) var(--spring-dock),width var(--tab-indicator-duration) var(--spring-dock),height var(--tab-indicator-duration) var(--spring-dock),scale var(--tab-indicator-duration) var(--ease-cartoon-punch),box-shadow var(--eyeglass-light-clock,var(--duration-fast)) var(--ease-standard),opacity var(--duration-fast) ease;}}.segmented-tab{position: relative;z-index: 10;border: none;background: none;font-weight: 500;cursor: pointer;white-space: nowrap;padding: 0.25rem 0.625rem;border-radius: var(--bouncy-slider-radius);font: inherit;font-size: var(--type-caption);color: color-mix(in oklab,var(--muted-foreground),var(--glass-capsule-warm) 12%);transition: color var(--duration-fast) ease;scale: 1;translate: 0;}@media (min-width: 640px){.segmented-tab{padding: 0.3125rem 0.75rem;font-size: var(--type-small);}}.segmented-tab[data-active]{color: var(--foreground);transition-delay: var(--eyeglass-cascade-annotation,0s);}.segmented-tab.is-disabled{opacity: 0.4;cursor: not-allowed;pointer-events: none;filter: blur(0.5px);}.segmented-tabs--underline{display: flex;grid-auto-flow: unset;grid-auto-columns: unset;gap: 0.25rem;padding: 0;background: none;-webkit-backdrop-filter: none;backdrop-filter: none;box-shadow: none;border-radius: 0;border-block-end: 1px solid var(--border);}.segmented-tabs--underline.segmented-tabs--vertical{flex-direction: column;align-items: stretch;border-block-end: none;border-inline-start: 1px solid var(--border);}.segmented-tabs--underline .segmented-tab{padding: 0.375rem 0.75rem;font-size: var(--type-subheading);letter-spacing: var(--type-tracking-display);border-radius: var(--bouncy-slider-radius);transition: color var(--duration-fast) ease;}.segmented-tabs--underline.segmented-tabs--vertical .segmented-tab{text-align: start;}.segmented-tabs--underline .segmented-tab:not([data-active]){color: var(--muted-foreground);}.segmented-tabs--underline .segmented-tab:hover{color: color-mix(in oklab,var(--foreground) 70%,transparent);}}

package/dist/components/tabs/types.d.ts

@@ -0,0 +1,85 @@
+import type { HTMLAttributes } from "vue";
+import type { Motion } from "../_shared/axes.js";
+import type { TabActivation } from "./composables/useTabRovingFocus.js";
+/** The canonical tab/option shape — one descriptor across both materials. */
+export interface SegmentedTabOption<V extends string = string> {
+    label: string;
+    value: V;
+    icon?: string;
+    disabled?: boolean;
+    /**
+     * The `id` of the tabpanel this option reveals. When set and semantics resolve to
+     * `tabs`, it is emitted as the tab's `aria-controls`, completing the APG
+     * tablist↔tabpanel linkage for consumers that own a panel. Ignored in `toggle`
+     * semantics (a toggle group mutates a shared surface, not a distinct panel).
+     */
+    controls?: string;
+}
+/** The two materials: `pill` is the default glass eyeglass; `underline` is the paper ink hairline. */
+export type SegmentedTabsVariant = "pill" | "underline";
+/** The interaction semantic, independent of material. `toggle` exposes a
+ *  group of pressed buttons; `tabs` exposes a tablist with selected tabs. */
+export type SegmentedTabsSemantics = "toggle" | "tabs";
+/** Whether focus movement also selects. Manual activation waits for Enter/Space. */
+export type SegmentedTabsActivation = TabActivation;
+/** The orientation axis — `horizontal` (default) lays children in a row + tracks
+ *  the indicator on the inline axis; `vertical` stacks a column + tracks the
+ *  block axis (the vertical underline is the leading-edge ink rail). */
+export type SegmentedTabsOrientation = "horizontal" | "vertical";
+export interface SegmentedTabsResponsive<V extends string = string> {
+    /**
+     * CSS length consumed inside `(min-width: <breakpoint>)`. BELOW it the
+     * strip collapses to a `<Select>`; at/above it renders the tab strip.
+     * Defaults to `"640px"` (Tailwind `sm:`).
+     */
+    breakpoint?: string;
+    /**
+     * Optional subset shown in the desktop strip (the mobile Select keeps the
+     * full option list). Falls back to `options`.
+     */
+    desktopOptions?: SegmentedTabOption<V>[] | null;
+    /** Accessible name for the mobile `<SelectTrigger>`. */
+    ariaLabel?: string;
+    /** Class merged onto the mobile `<SelectTrigger>` only. */
+    triggerClass?: HTMLAttributes["class"];
+}
+export interface SegmentedTabsProps<V extends string = string> {
+    options: SegmentedTabOption<V>[];
+    /** Accessible name shared by the desktop strip and responsive Select. */
+    ariaLabel?: string;
+    /**
+     * The material — `pill` (DEFAULT, the glass eyeglass) or `underline` (the paper
+     * ink-hairline rule). TWO, and the eyeglass is not a third: it is what `pill`
+     * IS. A "million variants that are essentially the same thing" is the failure
+     * mode this axis exists to refuse.
+     */
+    variant?: SegmentedTabsVariant;
+    /**
+     * Interaction semantics, independent of `variant`. When omitted, preserves the
+     * historical mapping: `pill` → `toggle`, `underline` → `tabs`.
+     */
+    semantics?: SegmentedTabsSemantics;
+    /** Selection follows focus by default; manual mode activates with Enter/Space. */
+    activation?: SegmentedTabsActivation;
+    /**
+     * Orientation — `horizontal` (default) or `vertical`. Axis-derived on the
+     * one indicator engine.
+     */
+    orientation?: SegmentedTabsOrientation;
+    /**
+     * Responsive collapse — below the breakpoint the strip becomes a `<Select>`.
+     * `true` uses defaults; an object tunes the breakpoint, desktop subset, and
+     * accessible name.
+     */
+    responsive?: boolean | SegmentedTabsResponsive<V>;
+    /**
+     * Motion weight. `full` (default) lets the pill indicator follow a pointer,
+     * squash with drag velocity, and settle to the nearest tab. Drag supplements the
+     * fully operable click and keyboard path; it is never the sole selection method.
+     * `reduced` and `off` use the click-only strip while preserving roving focus.
+     * Underline has no deformable indicator. Reduced-motion preference forces
+     * `full → reduced`.
+     */
+    motion?: Motion;
+    class?: HTMLAttributes["class"];
+}

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

@@ -1,2 +1,4 @@
 export { default as Timeline } from "./Timeline.vue.js";
 export type { TimelineProps, TimelineSegment, TimelineSegmentState, } from "./types.js";
+export { accentFor, HUE_OFFSET, HUE_STRIDE, HUE_STOPS } from "./geometry.js";
+export type { TimelineSpan } from "./geometry.js";

package/dist/components/toast/Toast.vue.d.ts

@@ -35,18 +35,18 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_base: import("vue").DefineComponent<ToastProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     pause: () => any;
+    resume: () => any;
     "update:open": (value: boolean) => any;
     escapeKeyDown: (event: KeyboardEvent) => any;
-    resume: () => any;
     swipeStart: (event: ToastSwipeEvent) => any;
     swipeMove: (event: ToastSwipeEvent) => any;
     swipeCancel: (event: ToastSwipeEvent) => any;
     swipeEnd: (event: ToastSwipeEvent) => any;
 }, string, import("vue").PublicProps, Readonly<ToastProps> & Readonly<{
     onPause?: (() => any) | undefined;
+    onResume?: (() => any) | undefined;
     "onUpdate:open"?: ((value: boolean) => any) | undefined;
     onEscapeKeyDown?: ((event: KeyboardEvent) => any) | undefined;
-    onResume?: (() => any) | undefined;
     onSwipeStart?: ((event: ToastSwipeEvent) => any) | undefined;
     onSwipeMove?: ((event: ToastSwipeEvent) => any) | undefined;
     onSwipeCancel?: ((event: ToastSwipeEvent) => any) | undefined;

package/dist/composables/color/index.d.ts

@@ -4,15 +4,6 @@ export interface OklchStop {
     C: number;
     h: number;
 }
-/**
- * A color seam: resolves a CSS color string to a GAMMA-sRGB triple in [0,1].
- * `defaultBlobColorResolver` is the default. A general-purpose injection type for
- * consumers that theme a substrate through an external color pipeline — the
- * `<FourierField>` ambient background takes it as an optional `colorResolver` prop
- * (paired with the `color` token seam). The goo-blob resolves color internally through
- * `cssToOklch → oklchToGammaRgb` without dependency injection.
- */
-export type ColorResolver = (css: string) => [number, number, number];
 /**
  * OKLCh stop → LINEAR-sRGB in [0,1] — aurora's bundle-canonical bake target (the
  * shader ACES-tonemaps in linear, so the LUT stays linear).
@@ -61,12 +52,6 @@ export declare function oklchToGammaRgb(stop: OklchStop): [number, number, numbe
 export declare function cssToOklch(css: string): OklchStop;
 /** OKLCh stop → `#rrggbb` gamma hex through value.js `toRgba8`. */
 export declare function oklchStopToHex(s: OklchStop): string;
-/**
- * Default `ColorResolver`: `(css) => gamma [r,g,b]` through
- * `cssToOklch → oklchToGammaRgb`. `<FourierField>` can pass it as its
- * `colorResolver`; Blob uses the same body internally without a DI seam.
- */
-export declare const defaultBlobColorResolver: ColorResolver;
 /**
  * Harmony schemes for the OKLCh palette derivers. Each maps the seed hue onto the
  * derived stops differently:

package/dist/composables/dark/darkModeSyncScript.d.ts

@@ -8,6 +8,48 @@ export interface DarkModeSyncScriptOptions {
      * uses. Override ONLY if a consumer reconfigured the vueuse storage key.
      */
     storageKey?: string;
+    /**
+     * What an ABSENT or `"auto"` stored mode resolves to. `"os"` (the default)
+     * follows `prefers-color-scheme`, which is right for an app. `false`/`true`
+     * resolve DETERMINISTICALLY, which is right for a document that must not flip
+     * with the projector's OS theme — a briefing, a print target, a capture.
+     *
+     * The scalar forms answer BOTH cases at once. The object form answers them
+     * SEPARATELY, which is the only way to say "a first visit is a deliberate
+     * light document, but a reader who chose `auto` gets their platform":
+     *
+     * ```ts
+     * darkModeSyncScript({ defaultDark: { absent: false, auto: "os" } });
+     * ```
+     *
+     * No scalar reproduces that pair — `false` makes `auto` mean light and `"os"`
+     * makes a first visit follow the OS — which is why a consumer with the split
+     * policy hand-rolls the whole `<head>` block instead of calling this.
+     *
+     * [2026-09-22 · register-wave N-3 — an UNREADABLE store (a throwing
+     * `localStorage` accessor or `getItem`) counts as ABSENT: the scalar forms
+     * fall to their one arm, the object form to `absent`.]
+     */
+    defaultDark?: boolean | "os" | {
+        absent: boolean | "os";
+        auto: boolean | "os";
+    };
+    /**
+     * Honour `?light` / `?dark` in the query string, above storage and above the
+     * default. This is the capture-forcing seam: a screenshot pipeline asks for a
+     * mode in the URL rather than driving a toggle and hoping.
+     */
+    queryOverride?: boolean;
+    /**
+     * Write the RESOLVED mode back to storage, so an absent or `"auto"` value
+     * becomes a concrete `"dark"`/`"light"` at first paint and the runtime
+     * composable and the stamp cannot disagree about what `auto` meant.
+     *
+     * The write is emitted AFTER the stamp, so a storage that throws on write
+     * (quota, privacy mode, a sandboxed origin) costs the write-back and nothing
+     * else — the page is already themed when it fails.
+     */
+    normalize?: boolean;
 }
 /**
  * Return the inline `<head>` script STRING that resolves dark/light at parse

package/dist/composables/dom/useResolveTokenColor.d.ts

@@ -14,7 +14,7 @@ export interface ResolveTokenColorCache {
  *
  * @param css the color string (a `var(--token)` wrapper or a literal)
  * @param el  the element to resolve the cascade against (the host wrapper)
- * @returns the concrete color string the `ColorResolver` can parse
+ * @returns the concrete color string a `(css) => rgb` resolver can parse
  */
 export declare function resolveTokenColor(css: string, el: HTMLElement | null): string;
 /**

package/dist/composables/glass/index.d.ts

@@ -1,5 +1,7 @@
 export { useSpecularTracking, createSpecularWriter, } from "./useSpecularTracking.js";
 export type { UseSpecularTracking, SpecularWriter, } from "./useSpecularTracking.js";
 export { vSpecular } from "./vSpecular.js";
+export type { RendererStatus } from "./webgpu/rendererStatus.js";
+export type { GpuBackend } from "./webgpu/useGpuSubstrate.js";
 export { useCanvas2D, resolveCanvasColor } from "./canvas2d/index.js";
 export type { Canvas2DFrame, Canvas2DHandle, Canvas2DOptions, Canvas2DSuspendReason, } from "./canvas2d/index.js";

package/dist/composables/keyboard/useKeyboardShortcuts.d.ts

@@ -18,6 +18,17 @@ export interface RegisteredShortcut {
     handler: (e: KeyboardEvent) => void;
     options: ShortcutOptions;
 }
+/**
+ * A registration the help UI can render: the element type of
+ * `useRegisteredShortcuts()`, which filters on the label the registrar supplied.
+ * Type-only narrowing — `options.label` is the field the runtime guarantees, so
+ * that is the field the type promises.
+ */
+export interface LabeledShortcut extends RegisteredShortcut {
+    options: ShortcutOptions & {
+        label: string;
+    };
+}
 export interface ShortcutCombo {
     key: string;
     ctrl: boolean;
@@ -29,5 +40,40 @@ export interface ShortcutCombo {
 export declare const isMac: boolean;
 export declare function formatComboParts(raw: string): string[];
 export declare function formatCombo(raw: string): string;
+/**
+ * The spoken form of a combo, for an `aria-label` beside the `<kbd>` glyphs.
+ * `"mod+shift+z"` → "Control Shift Z" (or "Command Shift Z" on a Mac);
+ * `"delete"` → "Delete or Backspace".
+ */
+export declare function formatComboLabel(raw: string): string;
 export declare function registerShortcut(combo: string, handler: (e: KeyboardEvent) => void, options?: ShortcutOptions): () => void;
-export declare function useRegisteredShortcuts(): ComputedRef<RegisteredShortcut[]>;
+/**
+ * Quiet every shortcut registered SO FAR for non-Escape keys, and return the
+ * release. A modal owns the keyboard while it is open: the nineteen app-level
+ * accelerators behind it must not fire, and nothing but the modal's own bindings
+ * should answer a keystroke aimed at it.
+ *
+ * ORDERING — call this BEFORE the modal registers its own bindings. The barrier is
+ * `seq > topBarrier`, so anything registered after the call is still live and
+ * anything registered before is not; suspending afterwards would silence the modal
+ * along with the app. The in-house overlays wire it in that order.
+ *
+ * Content that stays mounted across a close (`force-mount`, `unmount-on-hide="false"`,
+ * a reopen inside the exit spring) keeps the registration seq it took at mount and
+ * so falls BELOW the next barrier. Register on open and release on close, as the
+ * in-house overlays do — ExpandableContainer registers its Escape inside its open
+ * watch, not at mount.
+ *
+ * Escape is exempt by design and keeps its reversed LIFO walk, so the top-most
+ * overlay is always dismissable. Within a layer the forward first-registered-wins
+ * order is untouched, so a late registrant cannot shadow a destructive binding.
+ *
+ * `useRegisteredShortcuts()` is NOT barrier-filtered, deliberately: it is the
+ * reference list of what the app answers to, not a live capability probe. A help
+ * overlay is itself a modal, and filtering would hand it an empty list.
+ *
+ * The returned release is idempotent and order-free — it splices out its own
+ * barrier by identity, so nested suspensions can resume in any order.
+ */
+export declare function suspendShortcuts(): () => void;
+export declare function useRegisteredShortcuts(): ComputedRef<LabeledShortcut[]>;

package/dist/composables/motion/pointer/pointerFieldMappings.d.ts

@@ -20,47 +20,6 @@ export interface PointerFieldSnapshot {
     /** The smoothed active-engagement envelope (0..1). */
     engagement: number;
 }
-/** The default bias gain — the curve advances at most ±BIAS_GAIN faster/slower (≤0.15). */
-export declare const FOURIER_BIAS_GAIN = 0.15;
-/** The default centroid-lean fraction (the subtle lean). */
-export declare const FOURIER_FOLLOW_LEAN = 0.15;
-export interface FourierLeanGeometry {
-    /** The canvas backing aspect (w/h) — the model→clip fit inverse. */
-    aspect: number;
-    /** The fit scale (`model = center + clip·aspect / scale`). */
-    scale: number;
-    /**
-     * The head→cursor direction in CLIP space (the renderer computes it from the head
-     * model position + the cursor clip position). Its dot with the head's travel tangent
-     * is the draw-bias alignment. Omit (or zero) → no draw-bias (phaseRateMul = 1).
-     */
-    headToCursor?: PointerVec2;
-    /** The head's travel TANGENT (clip space), for the draw-bias alignment. Omit → no bias. */
-    headTangent?: PointerVec2;
-}
-export interface FourierLeanOptions {
-    /** The centroid-lean fraction (default {@link FOURIER_FOLLOW_LEAN}). */
-    lean?: number;
-    /** The draw-bias gain (default {@link FOURIER_BIAS_GAIN}; clamped ≤0.15). */
-    biasGain?: number;
-}
-export interface FourierLeanResult {
-    /** The MODEL-space centroid lean the setups subtract from `fit.center`. */
-    leanX: number;
-    leanY: number;
-    /**
-     * The clock phase-rate multiplier (1 = neutral). >1 draws toward the cursor a hair
-     * faster; <1 a hair slower. Bounded [1-biasGain, 1+biasGain].
-     */
-    phaseRateMul: number;
-}
-/**
- * The fourier draw-bias + subtle-lean mapping (PURE). The lean uses the SAME [0,1]→clip
- * (y-inverted) → model math the renderer inverts, at the subtle FOLLOW_LEAN (NOT the retired
- * FOLLOW_REACH teleport), scaled by engagement. The draw-bias modulates the clock phase-rate
- * by the head-tangent · head→cursor alignment, bounded by biasGain.
- */
-export declare function fourierLeanMapping(snap: PointerFieldSnapshot, geom: FourierLeanGeometry, options?: FourierLeanOptions): FourierLeanResult;
 /** The steady velocity-lead gain (the body anticipates the heading). */
 export declare const BLOB_LEAD_K = 0.09;
 /** The pseudopod stretch gain off |acceleration| (capped LOW so it swells, never taffies). */

package/dist/{components/search/composables → composables/search}/index.d.ts

@@ -1,5 +1,5 @@
 export { useFuzzySearch } from "./useFuzzySearch.js";
 export type { UseFuzzySearchOptions } from "./useFuzzySearch.js";
-export { buildIndex, searchIndex, fuzzyMatch, clearSearchCache } from "./fuzzySearchIndex.js";
-export type { SearchIndex } from "./fuzzySearchIndex.js";
+export { buildIndex, searchIndex, fuzzyMatch, clearSearchCache } from "./match.js";
+export type { SearchIndex } from "./match.js";
 export type { SearchableItem, SearchResult, FuzzySearchState } from "./types.js";

package/dist/{components/search/composables/fuzzySearchIndex.d.ts → composables/search/match.d.ts}

@@ -1,7 +1,12 @@
 /**
- * Generic fuzzy search index — builds a flat searchable index from items
- * and scores queries with VSCode-style fuzzy matching.
- * Pure functions, no Vue reactivity.
+ * The engine's matcher — builds a flat searchable index from items and scores queries
+ * with VSCode-style fuzzy matching. Pure functions, no Vue reactivity.
+ *
+ * [2026-08-25 · BK #42 W-SEARCH] Landed here from
+ * `src/components/search/composables/fuzzySearchIndex.ts`. The name lost its
+ * `fuzzySearchIndex` prefix with the directory: under `composables/search/` the words
+ * "search" and "fuzzy" are the path, and a file called `search/fuzzySearchIndex.ts`
+ * says them twice.
  */
 import type { SearchableItem, SearchResult } from "./types.js";
 interface IndexEntry<T extends SearchableItem> {

package/dist/composables/sidebar/types.d.ts

@@ -14,7 +14,11 @@ export interface SectionHierarchy {
     depth: number;
     /** ID of the root-level ancestor (self.id when depth === 0). */
     rootId: string;
-    /** Direct parent ID (self.id for root nodes). */
+    /**
+     * Direct parent ID (null for root nodes). [2026-09-22 · O-32 §3.4: the index used
+     * to write self.id for roots and the root id at every depth; read `rootId` for the
+     * root-level ancestor.]
+     */
     parentId: string | null;
     /** Index within root-level nodes. */
     rootIndex: number;