@joewinke/jatui 0.35.0 → 0.36.2

package/dist/components/ListenControl.svelte.d.ts

@@ -2,9 +2,10 @@ export type { ListenSegment, ListenChapter, ListenVoice, ListenSegmentPage, List
 /**
      * ListenControl — "listen to this page" as one compact control.
      *
-     * A small pill that expands into a playback bar: play/pause, −15s/+15s and
-     * previous/next sentence, speed (0.75–2×), a voice picker, a document-wide
-     * progress bar with chapter/section ticks, time, close. Built for hosts
+     * A small pill that expands into a two-row playback bar: play/pause, the
+     * current sentence, one speed (0.75–2×) + voice menu, close; then
+     * previous/next sentence, −15s/+15s, a document-wide progress bar with
+     * chapter/section ticks, and time. Built for hosts
      * that synthesize audio per sentence (TTS): the host supplies an async
      * SEGMENT SOURCE — sentences/paragraphs with ids → audio URLs — and the
      * player starts on the first chunk while the rest synthesizes, hatching
@@ -22,6 +23,14 @@ export type { ListenSegment, ListenChapter, ListenVoice, ListenSegmentPage, List
      * reports them) lay the timeline out immediately; unknown ones are
      * measured on load and ESTIMATED until then, self-correcting as they land.
      *
+     * ── Layout: two rows (jatui-zl9dp) ──────────────────────────────────────
+     * Row 1 is what you're hearing: play/pause, the chapter chip + current
+     * sentence (it gets ALL the remaining width), ONE settings pill folding
+     * speed + voice into a small menu, close. Row 2 is where you are: prev
+     * sentence, −15s, +15s, next sentence, then the progress bar and the
+     * clock. The bar is `box-sizing: border-box` + `max-width: 100%` with
+     * `min-width: 0` down the flex chain, so it never overflows its host.
+     *
      * The transport row borrows VideoPlayer's `kind="audio"` / `transport=
      * "band"` shape (round primary play, ghost transport buttons, tabular
      * clock) and reuses its pure time formatting (`video/time.ts`); the

package/dist/components/ThumbnailGrid.svelte

@@ -21,12 +21,28 @@
 		max?: number;
 		/** Tile size. Default 'md'. */
 		size?: 'xs' | 'sm' | 'md' | 'lg';
-		/** Show remove (×) buttons on hover; requires `onRemove`. */
+		/** Show remove (×) buttons; requires `onRemove`. Visibility follows `removeMode`. */
 		removable?: boolean;
+		/**
+		 * When the remove × is visible. 'hover' (default) reveals it on
+		 * hover/focus and keeps it visible on coarse (touch) pointers — a
+		 * hover-only control is unusable on touch (the ContextMenuTrigger
+		 * pattern). 'always' pins it visible for touch-first flows.
+		 */
+		removeMode?: 'hover' | 'always';
 		/** Show the dashed add tile at the end; requires `onAdd`. */
 		addable?: boolean;
 		/** Tooltip / aria-label for the add tile. Default 'Add items'. */
 		addLabel?: string;
+		/**
+		 * Tailwind grid-cols classes for a responsive tile grid, e.g.
+		 * 'grid-cols-2 sm:grid-cols-4'. When set, the root renders as a CSS grid
+		 * (`grid {gridCols} gap-2`) instead of the fixed flex-wrap strip, and
+		 * tiles stretch to fill their column (height still follows `size`).
+		 */
+		gridCols?: string;
+		/** Extra classes for the root container, composed after the layout classes. */
+		class?: string;
 		/** Fired when a thumbnail is clicked. */
 		onSelect?: (item: ThumbnailItem) => void;
 		/** Fired when a remove (×) button is clicked. */
@@ -46,12 +62,15 @@
 		max = 8,
 		size = 'md',
 		removable = false,
+		removeMode = 'hover',
 		addable = false,
 		addLabel = 'Add items',
+		gridCols,
 		onSelect,
 		onRemove,
 		onAdd,
-		cell
+		cell,
+		class: className = ''
 	}: Props = $props();
 
 	const sizeClasses: Record<NonNullable<Props['size']>, string> = {
@@ -63,18 +82,26 @@
 
 	const visible = $derived(items.slice(0, max));
 	const overflow = $derived(Math.max(0, items.length - max));
+	/** Grid mode when the caller supplies grid-cols classes; tiles fill their column. */
+	const isGrid = $derived(Boolean(gridCols));
+	const fillClass = $derived(isGrid ? ' w-full' : '');
+	const removeVisibility = $derived(
+		removeMode === 'always'
+			? 'opacity-100'
+			: 'opacity-0 transition-opacity group-hover:opacity-100 focus-visible:opacity-100 pointer-coarse:opacity-100'
+	);
 
 	function shortLabel(alt: string): string {
 		return alt.length > 14 ? `${alt.slice(0, 14)}…` : alt;
 	}
 </script>
 
-<div class="flex flex-wrap items-center gap-2">
+<div class="{isGrid ? 'grid gap-2' : 'flex flex-wrap items-center gap-2'} {gridCols ?? ''} {className}">
 	{#each visible as item (item.id)}
 		<div class="group relative">
 			<button
 				type="button"
-				class="{sizeClasses[size]} cursor-pointer overflow-hidden rounded border transition-all duration-200
+				class="{sizeClasses[size]}{fillClass} cursor-pointer overflow-hidden rounded border transition-all duration-200
 					{removable ? 'border-2 border-accent' : 'border-base-300 hover:border-primary'}"
 				onclick={() => onSelect?.(item)}
 				title={item.alt}
@@ -96,7 +123,7 @@
 			{#if removable && onRemove}
 				<button
 					type="button"
-					class="absolute -top-1 -right-1 z-10 flex h-4 w-4 items-center justify-center rounded-full bg-error text-error-content opacity-0 transition-opacity group-hover:opacity-100"
+					class="absolute -top-1 -right-1 z-10 flex h-4 w-4 items-center justify-center rounded-full bg-error text-error-content {removeVisibility}"
 					onclick={(e) => {
 						e.stopPropagation();
 						onRemove(item);
@@ -114,7 +141,7 @@
 
 	{#if overflow > 0}
 		<div
-			class="{sizeClasses[size]} flex items-center justify-center rounded border border-base-300 bg-base-200"
+			class="{sizeClasses[size]}{fillClass} flex items-center justify-center rounded border border-base-300 bg-base-200"
 			title="{overflow} more item{overflow === 1 ? '' : 's'}"
 		>
 			<span class="text-xs opacity-70">+{overflow}</span>
@@ -124,7 +151,7 @@
 	{#if addable && onAdd}
 		<button
 			type="button"
-			class="{sizeClasses[size]} flex scale-90 cursor-pointer items-center justify-center rounded border-2 border-dashed border-primary/30 bg-primary/5 transition-all duration-200 hover:border-primary/50 hover:bg-primary/10"
+			class="{sizeClasses[size]}{fillClass} flex scale-90 cursor-pointer items-center justify-center rounded border-2 border-dashed border-primary/30 bg-primary/5 transition-all duration-200 hover:border-primary/50 hover:bg-primary/10"
 			onclick={onAdd}
 			title={addLabel}
 			aria-label={addLabel}

package/dist/components/ThumbnailGrid.svelte.d.ts

@@ -18,12 +18,28 @@ interface Props {
     max?: number;
     /** Tile size. Default 'md'. */
     size?: 'xs' | 'sm' | 'md' | 'lg';
-    /** Show remove (×) buttons on hover; requires `onRemove`. */
+    /** Show remove (×) buttons; requires `onRemove`. Visibility follows `removeMode`. */
     removable?: boolean;
+    /**
+     * When the remove × is visible. 'hover' (default) reveals it on
+     * hover/focus and keeps it visible on coarse (touch) pointers — a
+     * hover-only control is unusable on touch (the ContextMenuTrigger
+     * pattern). 'always' pins it visible for touch-first flows.
+     */
+    removeMode?: 'hover' | 'always';
     /** Show the dashed add tile at the end; requires `onAdd`. */
     addable?: boolean;
     /** Tooltip / aria-label for the add tile. Default 'Add items'. */
     addLabel?: string;
+    /**
+     * Tailwind grid-cols classes for a responsive tile grid, e.g.
+     * 'grid-cols-2 sm:grid-cols-4'. When set, the root renders as a CSS grid
+     * (`grid {gridCols} gap-2`) instead of the fixed flex-wrap strip, and
+     * tiles stretch to fill their column (height still follows `size`).
+     */
+    gridCols?: string;
+    /** Extra classes for the root container, composed after the layout classes. */
+    class?: string;
     /** Fired when a thumbnail is clicked. */
     onSelect?: (item: ThumbnailItem) => void;
     /** Fired when a remove (×) button is clicked. */

package/dist/index.d.ts

@@ -93,7 +93,7 @@ export { default as ResizablePanel } from './components/ResizablePanel.svelte';
 export { default as VoicePlayer } from './components/VoicePlayer.svelte';
 export { default as SpeechForm } from './components/SpeechForm.svelte';
 export { default as AudioRecorder } from './components/AudioRecorder.svelte';
-export type { AudioRecordingResult } from './utils/audioRecorderCore';
+export type { AudioRecordingResult, AudioRecorderChunk } from './utils/audioRecorderCore';
 export { createAudioRecorder } from './utils/audioRecorder';
 export type { AudioRecorder, AudioRecorderCore, AudioRecorderError, AudioRecorderErrorKind, AudioRecorderFrame, AudioRecorderMode, AudioRecorderOptions, AudioRecorderPhase, AudioRecorderSnapshot } from './utils/audioRecorderCore';
 export { default as ThemeSelector } from './components/ThemeSelector.svelte';
@@ -172,7 +172,8 @@ export { default as PipelineColumn } from './components/pipeline/PipelineColumn.
 export { default as PipelineCard } from './components/pipeline/PipelineCard.svelte';
 export type { PipelineStage, StageColors, PipelineItem, PipelineMetric, StageMetrics, PipelineViewMode, PipelineTableColumn, PipelineDragConfig, PipelineConfig, PipelineStageChangeEvent, PipelineItemClickEvent } from './types/pipeline';
 export { DEFAULT_DRAG_CONFIG, DEFAULT_PIPELINE_CONFIG } from './types/pipeline';
-export { parseMentions, renderMentionsAsHTML, createMentionString, extractPlainText, findMentionAtCursor, findPartialMention, replaceMentionInContent, escapeHTML, countMentions, setMentionUrlGenerator } from './utils/mentionParser';
+export { parseMentions, renderMentionsAsHTML, createMentionString, extractPlainText, findMentionAtCursor, findPartialMention, replaceMentionInContent, escapeHTML, countMentions, hasMentions, setMentionUrlGenerator, registerMentionType, extractAgentMentions, getUniqueMentionsByType, getMentionedUserIds, AGENT_MENTION_TYPE } from './utils/mentionParser';
+export type { MentionMatch, MentionUrlGenerator, MentionTypeConfig } from './utils/mentionParser';
 export { default as CommentThread } from './components/CommentThread.svelte';
 export type { Comment, CommentEntityType, CommentVisibility, CommentCreateInput, CommentCallbacks } from './types/comments';
 export { COMMENT_ENTITY_TYPES, COMMENT_VISIBILITIES } from './types/comments';
@@ -187,6 +188,7 @@ export type { MarkupTool, Point, MarkupShape, ArrowShape, RectangleShape, Ellips
 export type { Annotation, AnnotationProfile, AnnotationThread, AnnotationCallbacks, } from './types/annotation';
 export { default as KeyboardShortcutsOverlay } from './components/KeyboardShortcutsOverlay.svelte';
 export type { KeyboardShortcut, SectionEntry as KeyboardShortcutSectionEntry, ShortcutSection as KeyboardShortcutSection, } from './components/KeyboardShortcutsOverlay.svelte';
+export { keyboardShortcutHub, KEYBOARD_SHORTCUT_HUB_ID, type KeyboardShortcutHost, type ShortcutContribution, type ShortcutSectionLike, } from './utils/keyboardShortcutHub';
 export { createShortcutRegistry, getShortcutRegistry, formatShortcut, parseCombo as parseShortcutCombo, isTypingTarget, detectPlatform as detectShortcutPlatform, SIDEBAR_TOGGLE_KEY, normalizeCombo, comboFromEvent, validateCombo, localStorageBindingStore, BROWSER_RESERVED_COMBOS, } from './utils/keyboardShortcutRegistry';
 export type { ShortcutRegistry, ShortcutDefinition, ShortcutModifier, ShortcutPlatform, PushContextOptions as ShortcutContextOptions, RegistrySection as ShortcutRegistrySection, ToSectionsOptions as ShortcutSectionsOptions, ShortcutRegistryOptions, ShortcutEventTarget, ShortcutDeclaration, BindingOverrides, BindingStore, BindingInfo, ShortcutConflict, ShortcutConflictSeverity, FindConflictsTarget, AllConflictsOptions as ShortcutAllConflictsOptions, ReservedCombo, RebindResult, RebindOptions as ShortcutRebindOptions, RejectedBinding, RawShortcutHandler, ModifierState as ShortcutModifierState, } from './utils/keyboardShortcutRegistry';
 export { default as MapView } from './components/MapView.svelte';
@@ -200,7 +202,7 @@ export { staggerEntrance } from './actions/staggerEntrance';
 export type { StaggerEntranceOptions } from './actions/staggerEntrance';
 export { attention } from './actions/attention';
 export type { AttentionEffect, AttentionOptions } from './actions/attention';
-export { reveal, REVEAL_HIDDEN_CLASS, REVEAL_BASE_CLASS } from './actions/reveal';
+export { reveal, REVEAL_HIDDEN_CLASS, REVEAL_BASE_CLASS, REVEAL_OFF_SELECTOR, REVEAL_MAX_DELAY_SECONDS } from './actions/reveal';
 export type { RevealOptions, RevealVariant } from './actions/reveal';
 export { default as ThumbnailGrid } from './components/ThumbnailGrid.svelte';
 export type { ThumbnailItem } from './components/ThumbnailGrid.svelte';

package/dist/index.js

@@ -204,7 +204,7 @@ export { default as PipelineColumn } from './components/pipeline/PipelineColumn.
 export { default as PipelineCard } from './components/pipeline/PipelineCard.svelte';
 export { DEFAULT_DRAG_CONFIG, DEFAULT_PIPELINE_CONFIG } from './types/pipeline';
 // Utilities — mention parsing
-export { parseMentions, renderMentionsAsHTML, createMentionString, extractPlainText, findMentionAtCursor, findPartialMention, replaceMentionInContent, escapeHTML, countMentions, setMentionUrlGenerator } from './utils/mentionParser';
+export { parseMentions, renderMentionsAsHTML, createMentionString, extractPlainText, findMentionAtCursor, findPartialMention, replaceMentionInContent, escapeHTML, countMentions, hasMentions, setMentionUrlGenerator, registerMentionType, extractAgentMentions, getUniqueMentionsByType, getMentionedUserIds, AGENT_MENTION_TYPE } from './utils/mentionParser';
 // Components — Comments (universal threaded comments)
 export { default as CommentThread } from './components/CommentThread.svelte';
 export { COMMENT_ENTITY_TYPES, COMMENT_VISIBILITIES } from './types/comments';
@@ -220,6 +220,7 @@ export { default as AnnotationPanel } from './components/AnnotationPanel.svelte'
 export { MARKUP_COLORS, DEFAULT_STROKE_WIDTH, renderShape, renderAllShapes, nextShapeId, } from './components/markup';
 // Components — Keyboard Navigation
 export { default as KeyboardShortcutsOverlay } from './components/KeyboardShortcutsOverlay.svelte';
+export { keyboardShortcutHub, KEYBOARD_SHORTCUT_HUB_ID, } from './utils/keyboardShortcutHub';
 export { createShortcutRegistry, getShortcutRegistry, formatShortcut, parseCombo as parseShortcutCombo, isTypingTarget, detectPlatform as detectShortcutPlatform, SIDEBAR_TOGGLE_KEY, normalizeCombo, comboFromEvent, validateCombo, localStorageBindingStore, BROWSER_RESERVED_COMBOS, } from './utils/keyboardShortcutRegistry';
 // Components — Google Maps (DispatchMap fork + location primitives)
 export { default as MapView } from './components/MapView.svelte';
@@ -243,7 +244,7 @@ export { attention } from './actions/attention';
 // Scroll-reveal (jatui-m4uz3.3, chimaro port): IntersectionObserver
 // scroll-reveal whose variants live in styles/motion.css as jatui-reveal-*
 // classes on the --motion-* tokens — no shipped animista.css.
-export { reveal, REVEAL_HIDDEN_CLASS, REVEAL_BASE_CLASS } from './actions/reveal';
+export { reveal, REVEAL_HIDDEN_CLASS, REVEAL_BASE_CLASS, REVEAL_OFF_SELECTOR, REVEAL_MAX_DELAY_SECONDS } from './actions/reveal';
 // Thumbnail grid (jatui-m4uz3.3, chimaro port): generic {id,url,alt} strip
 // with overflow counter, remove/add affordances and a cell snippet override.
 export { default as ThumbnailGrid } from './components/ThumbnailGrid.svelte';

package/dist/motion/index.d.ts

@@ -13,5 +13,5 @@ export { createMotionLevelStore } from './store';
 export type { MotionState, MotionLevelStore, MotionLevelStoreOptions } from './store';
 export { glide } from '../transitions/glide';
 export type { GlideOrigin, GlideParams } from '../transitions/glide';
-export { reveal, REVEAL_HIDDEN_CLASS, REVEAL_BASE_CLASS } from '../actions/reveal';
+export { reveal, REVEAL_HIDDEN_CLASS, REVEAL_BASE_CLASS, REVEAL_OFF_SELECTOR, REVEAL_MAX_DELAY_SECONDS } from '../actions/reveal';
 export type { RevealOptions, RevealVariant } from '../actions/reveal';

package/dist/motion/index.js

@@ -8,4 +8,4 @@ export { cubicBezier, motionEasing } from './easing';
 export { motionFade, motionScale, motionSlide, resolveMotionTiming } from './transitions';
 export { createMotionLevelStore } from './store';
 export { glide } from '../transitions/glide';
-export { reveal, REVEAL_HIDDEN_CLASS, REVEAL_BASE_CLASS } from '../actions/reveal';
+export { reveal, REVEAL_HIDDEN_CLASS, REVEAL_BASE_CLASS, REVEAL_OFF_SELECTOR, REVEAL_MAX_DELAY_SECONDS } from '../actions/reveal';

package/dist/utils/audioRecorder.d.ts

@@ -1,5 +1,5 @@
 import type { AudioRecorderMode, AudioRecorderOptions, AudioRecorderPhase, AudioRecorderSnapshot } from './audioRecorderCore';
-export type { AudioRecorderError, AudioRecorderErrorKind, AudioRecorderFrame, AudioRecorderMode, AudioRecorderOptions, AudioRecorderPhase, AudioRecordingResult } from './audioRecorderCore';
+export type { AudioRecorderChunk, AudioRecorderError, AudioRecorderErrorKind, AudioRecorderFrame, AudioRecorderMode, AudioRecorderOptions, AudioRecorderPhase, AudioRecordingResult } from './audioRecorderCore';
 export interface AudioRecorder {
     /** False when the platform has no getUserMedia/MediaRecorder (SSR, Node). */
     readonly supported: boolean;
@@ -15,6 +15,11 @@ export interface AudioRecorder {
     readonly elapsedMs: number;
     /** Last error, or null. */
     readonly error: AudioRecorderSnapshot['error'];
+    /** Live mic MediaStream while the recorder holds it (starting/recording),
+     * else null (jatui-ft2ot). Reactive — read it in templates/effects. For
+     * hosts that attach the raw stream (WebRTC, a custom MediaRecorder with
+     * requestData()-driven streaming). */
+    readonly stream: MediaStream | null;
     start(): Promise<void>;
     stop(): void;
     pause(): void;

package/dist/utils/audioRecorder.js

@@ -13,6 +13,7 @@ export function createAudioRecorder(options = {}) {
 		snap.sizeBytes = s.sizeBytes;
 		snap.elapsedMs = s.elapsedMs;
 		snap.error = s.error;
+		snap.stream = s.stream;
 	});
 
 	return {
@@ -47,6 +48,10 @@ export function createAudioRecorder(options = {}) {
 		get error() {
 			return snap.error;
 		},
+
+		get stream() {
+			return snap.stream;
+		},
 		start: () => core.start(),
 		stop: () => core.stop(),
 		pause: () => core.pause(),

package/dist/utils/audioRecorderCore.d.ts

@@ -57,11 +57,32 @@ export interface AudioRecorderFrame {
     /** Time-domain bytes (from getByteTimeDomainData) — raw PCM-ish shape. */
     time: Uint8Array;
 }
+/** One MediaRecorder timeslice of audio, handed to `onChunk` as it arrives
+ * (jatui-ft2ot). The take keeps accumulating for `onStop` regardless — hosts
+ * that buffer chunks (restartable dictation, live transcription) consume
+ * both streams independently. */
+export interface AudioRecorderChunk {
+    /** The chunk blob — one MediaRecorder `dataavailable` payload. */
+    blob: Blob;
+    /** MIME type of the recording (same value `onStop` reports). */
+    mimeType: string;
+    /** Cumulative bytes captured so far in this take (all chunks, not just this one). */
+    sizeBytes: number;
+    /** Pause-adjusted elapsed ms at the moment this chunk arrived. */
+    elapsedMs: number;
+    /** 0-based index of this chunk within the take. Resets on a new take. */
+    index: number;
+}
 export interface AudioRecorderOptions {
     /** `'toggle'` (default) or `'push'` (hold-to-talk — see module header). */
     mode?: AudioRecorderMode;
     /** Auto-stop ceiling in ms. 0 (default) records until stopped manually. */
     maxDurationMs?: number;
+    /** Timeslice in ms passed to `MediaRecorder.start()` — chunks are emitted
+     * at least this often and delivered to `onChunk` (jatui-ft2ot). Default
+     * 1000 (the historical behavior). 0 records as a single blob until stop
+     * (no intermediate chunking). */
+    timesliceMs?: number;
     /** Fired once the mic stream is live and recording has started. */
     onStart?: () => void;
     onPause?: () => void;
@@ -77,6 +98,12 @@ export interface AudioRecorderOptions {
     /** Fired every animation frame while recording — analyser data for hosts
      * that draw their own waveform/level UI. Not fired while paused. */
     onFrame?: (frame: AudioRecorderFrame) => void;
+    /** Fired per MediaRecorder chunk as it arrives (every `timesliceMs`, plus
+     * a final shorter chunk at stop). The take still accumulates for `onStop` —
+     * hosts get the full take AND a live chunk stream (restartable dictation,
+     * streaming transcription). A throwing handler reports `handler-failed`
+     * but does NOT stop the recording. */
+    onChunk?: (chunk: AudioRecorderChunk) => void;
 }
 /** Injectable platform bindings — defaults resolve from globalThis lazily at factory time, so Node (no MediaRecorder) degrades to `supported: false` instead of throwing at import. */
 export interface AudioRecorderDeps {
@@ -104,11 +131,18 @@ export interface AudioRecorderSnapshot {
     elapsedMs: number;
     /** Last error, or null. */
     error: AudioRecorderError | null;
+    /** Live mic MediaStream while the recorder holds it (starting/recording),
+     * else null (jatui-ft2ot). For hosts that attach the raw stream — WebRTC,
+     * a custom MediaRecorder with requestData()-driven streaming. */
+    stream: MediaStream | null;
 }
 export interface AudioRecorderCore {
     /** False when the platform has no getUserMedia/MediaRecorder (SSR, Node). */
     readonly supported: boolean;
     readonly mode: AudioRecorderMode;
+    /** Live mic MediaStream while the recorder holds it, else null — same
+     * value as `snapshot().stream`, for hosts that read it imperatively. */
+    readonly stream: MediaStream | null;
     /** Current reactive-independent snapshot (the rune wrapper copies this into $state). */
     snapshot(): AudioRecorderSnapshot;
     /** Subscribe to snapshot changes. Returns an unsubscribe fn. */

package/dist/utils/audioRecorderCore.js

@@ -61,7 +61,7 @@ export function computeElapsedMs(startedAt, pausedTotalMs, pauseStartedAt, now)
     return Math.max(0, now - startedAt - pausedMs);
 }
 export function createAudioRecorderCore(options = {}, deps = {}) {
-    const { mode = 'toggle', maxDurationMs = 0, onStart, onPause, onResume, onStop, onCancel, onError, onFrame } = options;
+    const { mode = 'toggle', maxDurationMs = 0, timesliceMs = 1000, onStart, onPause, onResume, onStop, onCancel, onError, onFrame, onChunk } = options;
     // Lazy globalThis defaults — resolved per factory call, never at import time.
     const g = (v) => v;
     const getUserMedia = deps.getUserMedia ??
@@ -87,6 +87,8 @@ export function createAudioRecorderCore(options = {}, deps = {}) {
     let level = 0;
     let sizeBytes = 0;
     let error = null;
+    /** 0-based index of the next chunk in the current take. */
+    let chunkIndex = 0;
     // Recorder internals
     let recorder = null;
     let stream = null;
@@ -105,7 +107,15 @@ export function createAudioRecorderCore(options = {}, deps = {}) {
     let pendingCancel = false;
     const listeners = new Set();
     function snapshot() {
-        return { phase, paused, level, sizeBytes, elapsedMs: computeElapsedMs(startedAt, pausedTotalMs, pauseStartedAt, now()), error };
+        return {
+            phase,
+            paused,
+            level,
+            sizeBytes,
+            elapsedMs: computeElapsedMs(startedAt, pausedTotalMs, pauseStartedAt, now()),
+            error,
+            stream
+        };
     }
     function notify() {
         const s = snapshot();
@@ -273,11 +283,32 @@ export function createAudioRecorderCore(options = {}, deps = {}) {
         }
         chunks = [];
         sizeBytes = 0;
+        chunkIndex = 0;
         recorder.ondataavailable = (e) => {
             if (e.data && e.data.size > 0) {
-                chunks.push(e.data);
-                sizeBytes += e.data.size;
+                const blob = e.data;
+                chunks.push(blob);
+                sizeBytes += blob.size;
+                const chunk = {
+                    blob,
+                    mimeType,
+                    sizeBytes,
+                    elapsedMs: elapsed(),
+                    index: chunkIndex++
+                };
                 notify();
+                if (onChunk) {
+                    try {
+                        onChunk(chunk);
+                    }
+                    catch (err) {
+                        // A throwing chunk handler must not lose the take — report and keep capturing.
+                        fail({
+                            kind: 'handler-failed',
+                            message: `Chunk kept, but the onChunk handler failed: ${err instanceof Error ? err.message : String(err)}`
+                        });
+                    }
+                }
             }
         };
         recorder.onstop = () => {
@@ -300,7 +331,7 @@ export function createAudioRecorderCore(options = {}, deps = {}) {
                 analyser = null;
             }
         }
-        recorder.start(1000);
+        recorder.start(timesliceMs > 0 ? timesliceMs : undefined);
         startedAt = now();
         pausedTotalMs = 0;
         pauseStartedAt = 0;
@@ -381,7 +412,10 @@ export function createAudioRecorderCore(options = {}, deps = {}) {
         if (wasCancelled)
             return;
         if (chunks.length === 0) {
-            // Zero chunks (e.g. stopped before any data arrived) — fail loud, not a silent no-op.
+            // Zero chunks (e.g. stopped before any data arrived) — fail loud, not a
+            // silent no-op. Release the mic + audio graph like every other exit, so
+            // a failed take can't leave a hot microphone behind.
+            teardown();
             phase = 'idle';
             notify();
             fail({ kind: 'too-short', message: 'Recording was too short — nothing was captured. Try again.' });
@@ -434,6 +468,9 @@ export function createAudioRecorderCore(options = {}, deps = {}) {
             return supported;
         },
         mode,
+        get stream() {
+            return stream;
+        },
         snapshot,
         subscribe,
         start,

package/dist/utils/keyboardShortcutHub.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Keyboard shortcut hub — the "one overlay" coordination layer for
+ * KeyboardShortcutsOverlay's host/contributor mode.
+ *
+ * Page-level overlay instances usually self-render (the pre-existing
+ * non-host fallback path). But an app shell can mount ONE "global" host
+ * overlay; every other overlay on the page then becomes a contributor:
+ * instead of self-rendering it contributes its sections (under a
+ * `sectionTitle`) to the host's panel and forwards its `open` requests to
+ * the host, so exactly one `?`-overlay exists no matter how many surfaces
+ * mount the component.
+ *
+ * Pure TypeScript (no Svelte), subscriber-based like ShortcutRegistry —
+ * reactivity lives in the overlay components, which re-read on notify.
+ *
+ * Usage (app shell):
+ *
+ *   <KeyboardShortcutsOverlay mode="host" />           // owns the `?` toggle
+ *
+ * Usage (page / portal / contract page):
+ *
+ *   <KeyboardShortcutsOverlay
+ *     {sections}
+ *     sectionTitle="Inbox"
+ *     showHint={false}
+ *   />
+ *   // self-renders when no host exists; contributes when one does
+ */
+export interface ShortcutContribution {
+    /** Stable id for the contributing surface (page route, portal name…). */
+    id: string;
+    /** Label under which the contributed sections appear in the host panel. */
+    sectionTitle: string;
+    /** Contributed sections (same shape as KeyboardShortcutsOverlay's `sections`). */
+    sections: ShortcutSectionLike[];
+    /** Registry snapshot (context-keyed sections) — optional alternative to `sections`. */
+    registrySections?: ShortcutSectionLike[];
+}
+export interface ShortcutSectionLike {
+    title: string;
+    shortcuts: {
+        key: string;
+        description: string;
+        color?: string;
+    }[];
+}
+export interface KeyboardShortcutHost {
+    /** Toggle the host overlay open/closed. */
+    toggle: () => void;
+    /** Open the host overlay (idempotent while already open). */
+    open: () => void;
+}
+declare class KeyboardShortcutHub {
+    private host;
+    private contributions;
+    private listeners;
+    /** True when a host overlay is mounted (contributing instances defer to it). */
+    get hasHost(): boolean;
+    /** Mount the host. Returns the unmount function. */
+    registerHost(host: KeyboardShortcutHost): () => void;
+    /** Contribute sections from a page-level overlay instance. Returns unregister. */
+    contribute(contribution: ShortcutContribution): () => void;
+    /** Contributed sections in registration order, labelled by sectionTitle. */
+    getContributions(): ShortcutContribution[];
+    /** Ask the host overlay to open. No-op when there is no host. */
+    requestOpen(): boolean;
+    /** Subscribe to hub changes (host mount/unmount, contributions). */
+    subscribe(listener: () => void): () => void;
+    private notify;
+}
+export declare const keyboardShortcutHub: KeyboardShortcutHub;
+export declare const KEYBOARD_SHORTCUT_HUB_ID = "keyboard-shortcut-hub";
+export {};

package/dist/utils/keyboardShortcutHub.js

@@ -0,0 +1,89 @@
+/**
+ * Keyboard shortcut hub — the "one overlay" coordination layer for
+ * KeyboardShortcutsOverlay's host/contributor mode.
+ *
+ * Page-level overlay instances usually self-render (the pre-existing
+ * non-host fallback path). But an app shell can mount ONE "global" host
+ * overlay; every other overlay on the page then becomes a contributor:
+ * instead of self-rendering it contributes its sections (under a
+ * `sectionTitle`) to the host's panel and forwards its `open` requests to
+ * the host, so exactly one `?`-overlay exists no matter how many surfaces
+ * mount the component.
+ *
+ * Pure TypeScript (no Svelte), subscriber-based like ShortcutRegistry —
+ * reactivity lives in the overlay components, which re-read on notify.
+ *
+ * Usage (app shell):
+ *
+ *   <KeyboardShortcutsOverlay mode="host" />           // owns the `?` toggle
+ *
+ * Usage (page / portal / contract page):
+ *
+ *   <KeyboardShortcutsOverlay
+ *     {sections}
+ *     sectionTitle="Inbox"
+ *     showHint={false}
+ *   />
+ *   // self-renders when no host exists; contributes when one does
+ */
+const HUB_ID = 'keyboard-shortcut-hub';
+class KeyboardShortcutHub {
+    host = null;
+    contributions = new Map();
+    listeners = new Set();
+    /** True when a host overlay is mounted (contributing instances defer to it). */
+    get hasHost() {
+        return this.host !== null;
+    }
+    /** Mount the host. Returns the unmount function. */
+    registerHost(host) {
+        if (this.host && this.host !== host) {
+            // Two hosts — the later one wins (last-mounted). Warn loudly: a
+            // page accidentally mounting a second global overlay is a bug.
+            console.warn('[keyboardShortcutHub] replacing an existing host overlay — did you mount the global overlay twice?');
+        }
+        this.host = host;
+        this.notify();
+        return () => {
+            if (this.host === host) {
+                this.host = null;
+                this.notify();
+            }
+        };
+    }
+    /** Contribute sections from a page-level overlay instance. Returns unregister. */
+    contribute(contribution) {
+        this.contributions.set(contribution.id, contribution);
+        this.notify();
+        return () => {
+            if (this.contributions.get(contribution.id) === contribution) {
+                this.contributions.delete(contribution.id);
+                this.notify();
+            }
+        };
+    }
+    /** Contributed sections in registration order, labelled by sectionTitle. */
+    getContributions() {
+        return [...this.contributions.values()];
+    }
+    /** Ask the host overlay to open. No-op when there is no host. */
+    requestOpen() {
+        if (!this.host)
+            return false;
+        this.host.open();
+        return true;
+    }
+    /** Subscribe to hub changes (host mount/unmount, contributions). */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    notify() {
+        for (const l of this.listeners)
+            l();
+    }
+}
+export const keyboardShortcutHub = new KeyboardShortcutHub();
+export const KEYBOARD_SHORTCUT_HUB_ID = HUB_ID;