@joewinke/jatui 0.35.0 → 0.36.1

package/dist/components/KeyboardShortcutsOverlay.svelte

@@ -39,9 +39,32 @@
 	 *   <KeyboardShortcutsOverlay {registry}>
 	 *     {#snippet extra()}<div>…custom footer…</div>{/snippet}
 	 *   </KeyboardShortcutsOverlay>
+	 *
+	 * ── Host / contributor mode ───────────────────────────────────────────
+	 *
+	 * An app shell can mount ONE global host overlay; every other instance
+	 * on the page then contributes its sections to the host instead of
+	 * self-rendering, so exactly one `?` overlay exists no matter how many
+	 * surfaces mount the component:
+	 *
+	 *   // App shell (layout.svelte):
+	 *   <KeyboardShortcutsOverlay mode="host" />
+	 *
+	 *   // A page with its own shortcut set:
+	 *   <KeyboardShortcutsOverlay {sections} sectionTitle="Inbox" />
+	 *
+	 * `mode` defaults to `'auto'`: the instance contributes to the host when
+	 * one is mounted, and self-renders when there isn't (the portal /
+	 * contract-page fallback). Force self-rendering with
+	 * `mode="standalone"`.
 	 */
 	import type { Snippet } from 'svelte';
 	import type { ShortcutRegistry } from '../utils/keyboardShortcutRegistry';
+	import {
+		keyboardShortcutHub,
+		type ShortcutContribution,
+		type ShortcutSectionLike
+	} from '../utils/keyboardShortcutHub';
 
 	export interface KeyboardShortcut {
 		key: string;
@@ -67,7 +90,27 @@
 		extraSections,
 		extra,
 		title = 'Keyboard Shortcuts',
-		open = $bindable(false)
+		open = $bindable(false),
+		/**
+		 * Host / contributor mode.
+		 *  - `'host'`: this instance IS the global overlay — it registers
+		 *    with the hub and aggregates contributions from other instances.
+		 *  - `'auto'` (default): contribute to the host when one exists,
+		 *    otherwise self-render (the portal / contract-page fallback).
+		 *  - `'standalone'`: never defer, always self-render.
+		 */
+		mode = 'auto',
+		/**
+		 * Label under which this instance's sections appear in the host
+		 * panel when contributing. Ignored when self-rendering.
+		 */
+		sectionTitle = 'Page shortcuts',
+		/**
+		 * Show the closed-state "press ?" hint pill (bottom-right).
+		 * `showHint={false}` opts out — e.g. on contributor instances that
+		 * defer to the host's own hint.
+		 */
+		showHint = true
 	}: {
 		shortcuts?: KeyboardShortcut[];
 		/**
@@ -97,6 +140,9 @@
 		extra?: Snippet;
 		title?: string;
 		open?: boolean;
+		mode?: 'auto' | 'host' | 'standalone';
+		sectionTitle?: string;
+		showHint?: boolean;
 	} = $props();
 
 	let isOpen = $state(open);
@@ -108,19 +154,103 @@
 		open = isOpen;
 	});
 
-	// Registry sections are snapshotted on open — BEFORE pushing the overlay's
-	// own modal context, which would otherwise hide every page context.
+	// ── Registry → sections ─────────────────────────────────────────────
+	// Registry sections are kept live via `registry.subscribe()` so the host
+	// panel always reflects the current context stack. The overlay pushes its
+	// own modal context while open, which hides the page contexts underneath —
+	// that push is what suppresses page shortcuts behind the modal.
 	let registrySections = $state<ShortcutSection[] | null>(null);
 	$effect(() => {
-		if (!isOpen || !registry) return;
+		if (!registry) return;
 		registrySections = registry.toSections();
+		return registry.subscribe(() => {
+			registrySections = registry.toSections();
+		});
+	});
+	$effect(() => {
+		if (!isOpen || !registry) return;
 		return registry.pushContext('keyboard-shortcuts-overlay', { modal: true });
 	});
 
-	const shownSections = $derived(
+	// ── Hub wiring ──────────────────────────────────────────────────────
+	let hubHasHost = $state(keyboardShortcutHub.hasHost);
+	let hubContributions = $state<ShortcutContribution[]>(keyboardShortcutHub.getContributions());
+	$effect(() => {
+		return keyboardShortcutHub.subscribe(() => {
+			hubHasHost = keyboardShortcutHub.hasHost;
+			hubContributions = keyboardShortcutHub.getContributions();
+		});
+	});
+
+	// A 'host' instance registers itself with the hub while mounted.
+	$effect(() => {
+		if (mode !== 'host') return;
+		return keyboardShortcutHub.registerHost({
+			open: () => {
+				isOpen = true;
+			},
+			toggle: () => {
+				isOpen = !isOpen;
+			}
+		});
+	});
+
+	// Whether this instance self-renders or defers to the host.
+	const isHost = $derived(mode === 'host');
+	const isContributor = $derived(mode !== 'host' && mode !== 'standalone' && hubHasHost);
+
+	// This instance's own sections (precedence: sections > registry > null).
+	const ownSections = $derived(
 		sections && sections.length > 0 ? sections : registry ? registrySections : null
 	);
 
+	// Contributing instances hand their sections to the hub. `extraSections`
+	// ride along too — they belong to the page, not the overlay itself.
+	const contributionId = `kso-${Math.random().toString(36).slice(2, 10)}`;
+	$effect(() => {
+		if (!isContributor) return;
+		const primary = ownSections ?? [];
+		if (primary.length === 0 && (!extraSections || extraSections.length === 0)) return;
+		const contribution: ShortcutContribution = {
+			id: contributionId,
+			sectionTitle,
+			sections: primary,
+			registrySections: extraSections ?? []
+		};
+		return keyboardShortcutHub.contribute(contribution);
+	});
+
+	// Contributing instances forward external `open` requests to the host —
+	// they can't open themselves.
+	$effect(() => {
+		if (!isContributor) return;
+		if (!open) return;
+		keyboardShortcutHub.requestOpen();
+		isOpen = false;
+	});
+
+	function flattenSections(secs: ShortcutSectionLike[]): SectionEntry[] {
+		return secs.flatMap((s) => s.shortcuts);
+	}
+
+	// Host panel content: own sections plus every contributor's sections,
+	// each grouped under its sectionTitle.
+	const hostSections = $derived.by(() => {
+		if (!isHost) return null;
+		const primary = ownSections ?? (shortcuts.length > 0 ? [{ title, shortcuts }] : []);
+		const contributed: ShortcutSection[] = hubContributions.flatMap((c) => [
+			{ title: c.sectionTitle, shortcuts: flattenSections(c.sections) },
+			...(c.registrySections ?? []).map((s) => ({ title: s.title, shortcuts: s.shortcuts }))
+		]);
+		return [...primary, ...contributed];
+	});
+
+	// What actually renders in the panel.
+	const shownSections = $derived(isHost ? hostSections : ownSections);
+	const shownFlatShortcuts = $derived(
+		isHost || (shownSections && shownSections.length > 0) ? [] : shortcuts
+	);
+
 	// Track which key label is currently depressed
 	let depressedKey = $state<string | null>(null);
 	let depressTimer: ReturnType<typeof setTimeout> | null = null;
@@ -143,6 +273,8 @@
 		if (e.key === '?') {
 			// `?` is always Shift+/. Don't trigger while typing — would swallow the char.
 			if (isTypingTarget(e.target)) return;
+			// A contributor doesn't own `?` — the host's own listener handles it.
+			if (isContributor) return;
 			e.preventDefault();
 			isOpen = !isOpen;
 			return;
@@ -236,7 +368,7 @@
 						{/each}
 					{/each}
 				{:else}
-					{#each shortcuts as { key, description }, i (key + '::' + i)}
+					{#each shownFlatShortcuts as { key, description }, i (key + '::' + i)}
 						<div class="kso-row">
 							<kbd
 								class="kso-key"
@@ -279,6 +411,13 @@
 			</div>
 		</div>
 	</div>
+{:else if showHint && !isContributor}
+	<!-- Closed-state hint — press ? to open. Contributors that defer to a
+	     host stay silent: the host renders its own hint. -->
+	<div class="kso-hint" aria-hidden="true">
+		<kbd class="kso-hint-key">?</kbd>
+		<span class="kso-hint-text">for shortcuts</span>
+	</div>
 {/if}
 
 <style>
@@ -419,6 +558,39 @@
 		border-color: oklch(0.45 0.06 240);
 	}
 
+	.kso-hint {
+		position: fixed;
+		right: 1rem;
+		bottom: 1rem;
+		z-index: 50;
+		display: flex;
+		align-items: center;
+		gap: 0.45rem;
+		padding: 0.3rem 0.65rem;
+		background: oklch(0.18 0.02 250 / 0.85);
+		border: 1px solid oklch(0.30 0.03 250);
+		border-radius: 0.5rem;
+		color: oklch(0.85 0.02 250);
+		font-size: 0.78rem;
+		pointer-events: none;
+		animation: kso-fade 0.15s ease-out;
+	}
+
+	.kso-hint-key {
+		font-family: ui-monospace, 'SF Mono', Menlo, Consolas, monospace;
+		font-size: 0.72rem;
+		background: oklch(0.25 0.02 250);
+		border: 1px solid oklch(0.35 0.02 250);
+		border-bottom-width: 2px;
+		border-radius: 0.3rem;
+		padding: 0.05rem 0.45rem;
+		color: oklch(0.93 0.02 250);
+	}
+
+	.kso-hint-text {
+		color: oklch(0.72 0.02 250);
+	}
+
 	@keyframes kso-fade {
 		from {
 			opacity: 0;
@@ -430,7 +602,8 @@
 
 	@media (prefers-reduced-motion: reduce) {
 		.kso-backdrop,
-		.kso-panel {
+		.kso-panel,
+		.kso-hint {
 			animation: none !important;
 		}
 		.kso-key {

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

@@ -38,6 +38,24 @@
      *   <KeyboardShortcutsOverlay {registry}>
      *     {#snippet extra()}<div>…custom footer…</div>{/snippet}
      *   </KeyboardShortcutsOverlay>
+     *
+     * ── Host / contributor mode ───────────────────────────────────────────
+     *
+     * An app shell can mount ONE global host overlay; every other instance
+     * on the page then contributes its sections to the host instead of
+     * self-rendering, so exactly one `?` overlay exists no matter how many
+     * surfaces mount the component:
+     *
+     *   // App shell (layout.svelte):
+     *   <KeyboardShortcutsOverlay mode="host" />
+     *
+     *   // A page with its own shortcut set:
+     *   <KeyboardShortcutsOverlay {sections} sectionTitle="Inbox" />
+     *
+     * `mode` defaults to `'auto'`: the instance contributes to the host when
+     * one is mounted, and self-renders when there isn't (the portal /
+     * contract-page fallback). Force self-rendering with
+     * `mode="standalone"`.
      */
 import type { Snippet } from 'svelte';
 import type { ShortcutRegistry } from '../utils/keyboardShortcutRegistry';
@@ -84,6 +102,9 @@ type $$ComponentProps = {
     extra?: Snippet;
     title?: string;
     open?: boolean;
+    mode?: 'auto' | 'host' | 'standalone';
+    sectionTitle?: string;
+    showHint?: boolean;
 };
 declare const KeyboardShortcutsOverlay: import("svelte").Component<$$ComponentProps, {}, "open">;
 type KeyboardShortcutsOverlay = ReturnType<typeof KeyboardShortcutsOverlay>;

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. */