@joewinke/jatui 0.21.0 → 0.23.0

package/dist/history.js

@@ -0,0 +1,87 @@
+/**
+ * Snapshot undo/redo history. Forked from @wayflow/core's history.ts (see
+ * README.md) and generalized to any graph type `G` — this module only
+ * deep-clones snapshots, it never inspects node/edge shape.
+ *
+ * Adds two things upstream keeps outside `core` (in its DOM editor package):
+ * push-on-first-move (`beginChange`/`endChange`) so a drag/resize gesture
+ * pushes exactly one pre-change snapshot no matter how many move events it
+ * fires, and `untracked()` to run a compound multi-step mutation (e.g.
+ * paste = add nodes + add edges) without each step pushing its own entry.
+ *
+ * CANONICAL HOME: this is the shared copy (jatui-00jfh, rebuilding the lost
+ * jat-gjw72 upstream half). The JAT IDE (ide/src/lib/utils/history.ts) and
+ * JST (src/lib/workflows/core/history.ts) carry vendored copies that
+ * repoint their imports at 'jatui' and are deleted at the swap.
+ */
+export const MAX_UNDO_DEPTH = 50;
+/**
+ * Deep-clones plain JSON-shaped state. Not `structuredClone` — callers pass
+ * Svelte 5 `$state` proxies (e.g. the canvas's reactive nodes/edges arrays),
+ * and `structuredClone` throws `DataCloneError` on those in real browsers
+ * (verified in-browser). A JSON round-trip reads through the proxy's
+ * property getters like any other consumer and is safe for graph data (no
+ * Date/Map/Set/functions).
+ */
+function deepClone(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+export function createHistory() {
+    return { undoStack: [], redoStack: [], changing: false, suppressed: 0 };
+}
+/** Deep-clones `graph` onto the undo stack (capped at maxDepth) and clears redo. No-ops while suppressed. */
+export function pushState(history, graph, maxDepth = MAX_UNDO_DEPTH) {
+    if (history.suppressed > 0)
+        return;
+    if (history.undoStack.length >= maxDepth) {
+        history.undoStack.shift();
+    }
+    history.undoStack.push(deepClone(graph));
+    history.redoStack = [];
+}
+/**
+ * Push-on-first-move: call on every move event of a drag/resize gesture.
+ * Pushes the pre-gesture snapshot only the first time it's called since the
+ * last endChange() — a click that never drags won't add a history entry.
+ */
+export function beginChange(history, graph, maxDepth = MAX_UNDO_DEPTH) {
+    if (history.changing)
+        return;
+    history.changing = true;
+    pushState(history, graph, maxDepth);
+}
+/** Ends the current push-on-first-move gesture so the next beginChange() can push again. */
+export function endChange(history) {
+    history.changing = false;
+}
+/** Runs `fn` with history pushes suppressed — for compound ops that should land as zero or one entries (pair with a manual pushState before calling). */
+export function untracked(history, fn) {
+    history.suppressed++;
+    try {
+        fn();
+    }
+    finally {
+        history.suppressed--;
+    }
+}
+/** Pops the most recent undo entry, pushing `currentGraph` onto redo. Returns null if nothing to undo. */
+export function undo(history, currentGraph) {
+    if (history.undoStack.length === 0)
+        return null;
+    history.redoStack.push(deepClone(currentGraph));
+    return history.undoStack.pop();
+}
+/** Pops the most recent redo entry, pushing `currentGraph` onto undo. Returns null if nothing to redo. */
+export function redo(history, currentGraph) {
+    if (history.redoStack.length === 0)
+        return null;
+    history.undoStack.push(deepClone(currentGraph));
+    return history.redoStack.pop();
+}
+/** Clears both stacks and any in-progress gesture/suppression state. */
+export function clearHistory(history) {
+    history.undoStack = [];
+    history.redoStack = [];
+    history.changing = false;
+    history.suppressed = 0;
+}

package/dist/index.d.ts

@@ -56,6 +56,10 @@ export { createDirtyGuard } from './utils/dirtyGuard';
 export type { DirtyGuard, DirtyGuardOptions, BeforeNavigateFn } from './utils/dirtyGuard';
 export { default as MediaLightbox } from './components/MediaLightbox.svelte';
 export type { MediaItem } from './components/MediaLightbox.svelte';
+export { default as InfiniteGrid } from './components/InfiniteGrid.svelte';
+export { default as InfiniteSearchGrid } from './components/InfiniteSearchGrid.svelte';
+export { createInfiniteLoader } from './components/infiniteGridLoader';
+export type { InfinitePage, InfiniteLoadContext, InfiniteLoadFn, InfiniteLoader, InfiniteLoaderState, InfiniteStatus } from './components/infiniteGridLoader';
 export { default as Button } from './components/Button.svelte';
 export { default as Badge } from './components/Badge.svelte';
 export { default as Card } from './components/Card.svelte';
@@ -78,6 +82,8 @@ export { default as LazyImage } from './components/LazyImage.svelte';
 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 './components/AudioRecorder.svelte';
 export { default as ThemeSelector } from './components/ThemeSelector.svelte';
 export { default as Sparkline } from './components/Sparkline.svelte';
 export { default as BurndownChart } from './components/BurndownChart.svelte';
@@ -93,6 +99,8 @@ export type { FileDropzoneFile } from './components/FileDropzone.svelte';
 export { default as VariablePicker } from './components/VariablePicker.svelte';
 export type { TemplateVar, TemplateVarGroup } from './types/templateVars';
 export { default as EmojiPicker } from './components/EmojiPicker.svelte';
+export { default as IconSelector } from './components/IconSelector.svelte';
+export type { IconSelectorOption, IconComponentProps } from './components/IconSelector.svelte';
 export { EMOJI_DATA, ALL_EMOJIS, searchEmojis } from './data/emojis';
 export type { EmojiEntry, EmojiGroup } from './data/emojis';
 export { default as LinkShortener } from './components/LinkShortener.svelte';
@@ -166,6 +174,8 @@ 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 { createShortcutRegistry, getShortcutRegistry, formatShortcut, parseCombo as parseShortcutCombo, isTypingTarget, detectPlatform as detectShortcutPlatform, SIDEBAR_TOGGLE_KEY, } from './utils/keyboardShortcutRegistry';
+export type { ShortcutRegistry, ShortcutDefinition, ShortcutModifier, ShortcutPlatform, PushContextOptions as ShortcutContextOptions, RegistrySection as ShortcutRegistrySection, ToSectionsOptions as ShortcutSectionsOptions, ShortcutRegistryOptions, ShortcutEventTarget, } from './utils/keyboardShortcutRegistry';
 export { default as MapView } from './components/MapView.svelte';
 export { default as LocationMap } from './components/LocationMap.svelte';
 export { default as GPSTracker } from './components/GPSTracker.svelte';
@@ -177,6 +187,10 @@ 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 type { RevealOptions, RevealVariant } from './actions/reveal';
+export { default as ThumbnailGrid } from './components/ThumbnailGrid.svelte';
+export type { ThumbnailItem } from './components/ThumbnailGrid.svelte';
 export { floating, makeVirtualAnchor } from './actions/floating';
 export type { FloatingOptions, Placement } from './actions/floating';
 export { glide } from './transitions/glide';
@@ -225,3 +239,19 @@ export { computeActiveSection, DEFAULT_ACTIVATION_RATIO } from './components/bas
 export type { SectionRect, SpyViewport, SpyScrollState } from './components/basic/sectionNavSpy';
 export { default as Slider } from './components/basic/Slider.svelte';
 export { default as Pagination } from './components/basic/Pagination.svelte';
+export { MAX_UNDO_DEPTH, createHistory, pushState, beginChange, endChange, untracked, undo, redo, clearHistory } from './history';
+export type { History } from './history';
+export { default as BatchJobTable } from './components/batch/BatchJobTable.svelte';
+export type { JobContext, RowControls, BatchControls, BatchPhase } from './components/batch/BatchJobTable.svelte';
+export { default as QuotaMeter } from './components/batch/QuotaMeter.svelte';
+export { toJobRows, nextJobsToStart, isProcessLimitReached, moveJob, summarizeJobs, formatElapsed } from './components/batch/batchQueue';
+export type { JobRow, JobStatus, BatchSummary, DispatchLimits } from './components/batch/batchQueue';
+export { rollingAverage, estimateRemainingMs } from './components/batch/elapsedEstimate';
+export type { EtaInput } from './components/batch/elapsedEstimate';
+export { useElapsedEstimate } from './components/batch/useElapsedEstimate';
+export type { ElapsedEstimate } from './components/batch/useElapsedEstimate';
+export { pollOperation, PollTimeoutError } from './components/batch/pollOperation';
+export type { PollStep, PollContext, PollOptions } from './components/batch/pollOperation';
+export { default as VariantMatrixPicker } from './components/variant/VariantMatrixPicker.svelte';
+export { countCombinations, generateCombinations, generateVariantFilename, findVariantOption, variantCategoryMode } from './components/variant/variantCombinations';
+export type { VariantCategory, VariantOption, VariantSelection, VariantSelectionMode, VariantCombination } from './components/variant/variantCombinations';

package/dist/index.js

@@ -73,6 +73,10 @@ export { default as PresenceStack } from './components/PresenceStack.svelte';
 export { default as DirtyFormHost } from './components/DirtyFormHost.svelte';
 export { createDirtyGuard } from './utils/dirtyGuard';
 export { default as MediaLightbox } from './components/MediaLightbox.svelte';
+// Cursor-paged infinite-scroll grids, harvested from chimaro (jatui-m4uz3.4).
+export { default as InfiniteGrid } from './components/InfiniteGrid.svelte';
+export { default as InfiniteSearchGrid } from './components/InfiniteSearchGrid.svelte';
+export { createInfiniteLoader } from './components/infiniteGridLoader';
 // Components — from Flush
 export { default as Button } from './components/Button.svelte';
 export { default as Badge } from './components/Badge.svelte';
@@ -97,6 +101,7 @@ export { default as LazyImage } from './components/LazyImage.svelte';
 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';
 // Components — from Headcount
 export { default as ThemeSelector } from './components/ThemeSelector.svelte';
 export { default as Sparkline } from './components/Sparkline.svelte';
@@ -112,6 +117,8 @@ export { default as EntityPreviewCard } from './components/EntityPreviewCard.sve
 export { default as VariablePicker } from './components/VariablePicker.svelte';
 // Components — Emoji
 export { default as EmojiPicker } from './components/EmojiPicker.svelte';
+// Components — Icon selection
+export { default as IconSelector } from './components/IconSelector.svelte';
 // Emoji data
 export { EMOJI_DATA, ALL_EMOJIS, searchEmojis } from './data/emojis';
 // Components — from Meadow
@@ -183,6 +190,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 { createShortcutRegistry, getShortcutRegistry, formatShortcut, parseCombo as parseShortcutCombo, isTypingTarget, detectPlatform as detectShortcutPlatform, SIDEBAR_TOGGLE_KEY, } from './utils/keyboardShortcutRegistry';
 // Components — Google Maps (DispatchMap fork + location primitives)
 export { default as MapView } from './components/MapView.svelte';
 export { default as LocationMap } from './components/LocationMap.svelte';
@@ -202,6 +210,13 @@ export { loadGoogleMapsAPI, isGoogleMapsLoaded, isPlacesLoaded, isGeometryLoaded
 export { tooltip } from './actions/tooltip';
 export { staggerEntrance } from './actions/staggerEntrance';
 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';
+// 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';
 export { floating, makeVirtualAnchor } from './actions/floating';
 export { glide } from './transitions/glide';
 // View Transitions kit
@@ -260,3 +275,15 @@ export { default as SectionNav } from './components/basic/SectionNav.svelte';
 export { computeActiveSection, DEFAULT_ACTIVATION_RATIO } from './components/basic/sectionNavSpy';
 export { default as Slider } from './components/basic/Slider.svelte';
 export { default as Pagination } from './components/basic/Pagination.svelte';
+// Snapshot undo/redo history (wayflow-core) — also importable as 'jatui/history' (jatui-00jfh).
+export { MAX_UNDO_DEPTH, createHistory, pushState, beginChange, endChange, untracked, undo, redo, clearHistory } from './history';
+// Batch queue runner (harvested from vid-gen BatchGenerator — jatui-m4uz3.7).
+export { default as BatchJobTable } from './components/batch/BatchJobTable.svelte';
+export { default as QuotaMeter } from './components/batch/QuotaMeter.svelte';
+export { toJobRows, nextJobsToStart, isProcessLimitReached, moveJob, summarizeJobs, formatElapsed } from './components/batch/batchQueue';
+export { rollingAverage, estimateRemainingMs } from './components/batch/elapsedEstimate';
+export { useElapsedEstimate } from './components/batch/useElapsedEstimate';
+export { pollOperation, PollTimeoutError } from './components/batch/pollOperation';
+// Variant matrix picker + combination algebra (harvested from vid-gen FrameVariantGenerator — jatui-m4uz3.8).
+export { default as VariantMatrixPicker } from './components/variant/VariantMatrixPicker.svelte';
+export { countCombinations, generateCombinations, generateVariantFilename, findVariantOption, variantCategoryMode } from './components/variant/variantCombinations';

package/dist/styles/motion.css

@@ -44,3 +44,103 @@
 		scroll-behavior: auto !important;
 	}
 }
+
+/*
+ * Scroll-reveal (use:reveal) — ported from chimaro's animista-powered reveal
+ * action (jatui-m4uz3.3). The action toggles `.jatui-reveal-hidden` off and
+ * `.jatui-reveal jatui-reveal-<variant>` on when the element first intersects
+ * the viewport. Every class here reads ONLY the tokens above — animista.css
+ * is deliberately NOT shipped; the variants below are the remap.
+ */
+.jatui-reveal-hidden {
+	opacity: 0;
+}
+
+.jatui-reveal {
+	animation-duration: var(--motion-move);
+	animation-timing-function: var(--motion-glide);
+	animation-fill-mode: both; /* holds the from-state through any animation-delay */
+}
+
+.jatui-reveal-fade-in {
+	animation-name: jatui-reveal-fade-in;
+}
+.jatui-reveal-fade-in-bottom {
+	animation-name: jatui-reveal-fade-in-bottom;
+}
+.jatui-reveal-fade-in-top {
+	animation-name: jatui-reveal-fade-in-top;
+}
+.jatui-reveal-fade-in-left {
+	animation-name: jatui-reveal-fade-in-left;
+}
+.jatui-reveal-fade-in-right {
+	animation-name: jatui-reveal-fade-in-right;
+}
+.jatui-reveal-scale-in-center {
+	animation-name: jatui-reveal-scale-in-center;
+}
+
+@keyframes jatui-reveal-fade-in {
+	from {
+		opacity: 0;
+	}
+	to {
+		opacity: 1;
+	}
+}
+
+@keyframes jatui-reveal-fade-in-bottom {
+	from {
+		transform: translateY(24px);
+		opacity: 0;
+	}
+	to {
+		transform: translateY(0);
+		opacity: 1;
+	}
+}
+
+@keyframes jatui-reveal-fade-in-top {
+	from {
+		transform: translateY(-24px);
+		opacity: 0;
+	}
+	to {
+		transform: translateY(0);
+		opacity: 1;
+	}
+}
+
+@keyframes jatui-reveal-fade-in-left {
+	from {
+		transform: translateX(-24px);
+		opacity: 0;
+	}
+	to {
+		transform: translateX(0);
+		opacity: 1;
+	}
+}
+
+@keyframes jatui-reveal-fade-in-right {
+	from {
+		transform: translateX(24px);
+		opacity: 0;
+	}
+	to {
+		transform: translateX(0);
+		opacity: 1;
+	}
+}
+
+@keyframes jatui-reveal-scale-in-center {
+	from {
+		transform: scale(0.6);
+		opacity: 0;
+	}
+	to {
+		transform: scale(1);
+		opacity: 1;
+	}
+}

package/dist/utils/keyboardShortcutRegistry.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Keyboard shortcut registry — the data source `KeyboardShortcutsOverlay`
+ * was always missing (jatui-m4uz3.6, harvested from chimaro's
+ * keyboardShortcutManager with its app-specific default registrations
+ * stripped).
+ *
+ * One registry per app (or use the lazy `getShortcutRegistry()` singleton).
+ * Components register shortcuts against a CONTEXT and get back an
+ * unregister function, which is exactly what a Svelte `$effect` wants to
+ * return:
+ *
+ *   $effect(() => registry.register([
+ *     { key: 'j', description: 'Next item', context: 'list', action: next },
+ *     { key: 'mod+k', description: 'Search', action: openPalette, allowInInput: true },
+ *   ]));
+ *
+ * Contexts form a STACK. `global` is always the bottom. `pushContext()`
+ * returns a pop function. When a key is pressed the stack is walked from
+ * the top down and the first matching, enabled shortcut wins — so a
+ * context higher up shadows the same combo lower down. A context pushed
+ * with `{ modal: true }` stops the walk: everything beneath it (including
+ * `global`) is suppressed while it is on the stack — that is how a dialog
+ * keeps page shortcuts from firing behind it.
+ *
+ * Sharp edges handled here so every app doesn't re-learn them:
+ *  - Input focus: shortcuts don't fire while typing in a text input,
+ *    textarea, select or contenteditable (checkboxes/buttons/ranges don't
+ *    count as typing). Opt back in per shortcut with `allowInInput`.
+ *  - IME composition and already-handled (`defaultPrevented`) events are
+ *    ignored.
+ *  - Modifiers: `mod` is ⌘ on macOS and Ctrl elsewhere. Matching is exact —
+ *    `mod+k` does not fire on `mod+shift+k`. Shift is implied by printable
+ *    symbols (`?` is Shift+/ on most layouts), so `key: '?'` matches without
+ *    listing `shift`. macOS Option rewrites `event.key` (Alt+K → "˚"), so
+ *    alt combos fall back to `event.code`.
+ *  - Browser-reserved combos: Ctrl+B / Ctrl+T / Ctrl+W / Ctrl+N belong to the
+ *    browser (Chrome won't hand some of them to the page at all). The sidebar
+ *    convention across JAT apps is `mod+\` — see `SIDEBAR_TOGGLE_KEY`.
+ *
+ * Pure TypeScript, no Svelte runes and no DOM globals at import time, so it
+ * is SSR-safe and unit-testable under plain node.
+ */
+export type ShortcutModifier = 'mod' | 'meta' | 'ctrl' | 'shift' | 'alt' | 'cmd';
+export type ShortcutPlatform = 'mac' | 'other';
+export interface ShortcutDefinition {
+    /**
+     * `KeyboardEvent.key` value (case-insensitive for letters), optionally
+     * prefixed with modifiers: `'k'`, `'mod+k'`, `'shift+ArrowDown'`, `'?'`,
+     * `'mod+\\'`. Use `'+'` / `'mod++'` for the plus key itself.
+     */
+    key: string;
+    /** Extra modifiers, merged with any parsed from `key`. `cmd` is an alias of `mod`. */
+    modifiers?: ShortcutModifier | ShortcutModifier[];
+    /** Shown in the overlay. */
+    description: string;
+    action: (event: KeyboardEvent) => void | Promise<void>;
+    /** Context this shortcut belongs to. Default `'global'`. */
+    context?: string;
+    /** Live predicate — a disabled shortcut is skipped and the walk continues. */
+    enabled?: () => boolean;
+    /** Fire even while focus is in a text field. Default false. */
+    allowInInput?: boolean;
+    /** Fire on auto-repeat keydowns (held key). Default true. */
+    allowRepeat?: boolean;
+    /** Call `preventDefault()` when this shortcut fires. Default true. */
+    preventDefault?: boolean;
+    /** Overlay section title. Defaults to the context's label. */
+    group?: string;
+    /** Register but leave out of the overlay. */
+    hidden?: boolean;
+    /** Overrides the computed keycap label in the overlay (e.g. `'j / ↓'`). */
+    label?: string;
+}
+export interface PushContextOptions {
+    /** Suppress every context beneath this one (including `global`) while pushed. */
+    modal?: boolean;
+    /** Overlay section title for this context. Default: the context name. */
+    label?: string;
+}
+/** Same shape as `KeyboardShortcutsOverlay`'s `ShortcutSection`. */
+export interface RegistrySection {
+    title: string;
+    shortcuts: {
+        key: string;
+        description: string;
+    }[];
+}
+export interface ToSectionsOptions {
+    /**
+     * `'active'` (default) lists only contexts that can fire right now —
+     * the live part of the stack, top first. `'all'` lists every context
+     * with registrations.
+     */
+    scope?: 'active' | 'all';
+    /** Drop shortcuts whose `enabled()` currently returns false. Default false. */
+    onlyEnabled?: boolean;
+}
+export interface ShortcutRegistryOptions {
+    /** Force the platform (tests, SSR). Default: sniffed from `navigator`. */
+    platform?: ShortcutPlatform;
+    /** Overlay labels for contexts. `global` defaults to `'General'`. */
+    contextLabels?: Record<string, string>;
+    /** Called when an action throws or rejects. Default: `console.error`. */
+    onError?: (error: unknown, shortcut: ShortcutDefinition) => void;
+}
+/** Minimal event-target shape `attach()` needs (window, document, an element). */
+export interface ShortcutEventTarget {
+    addEventListener(type: 'keydown', listener: (e: KeyboardEvent) => void): void;
+    removeEventListener(type: 'keydown', listener: (e: KeyboardEvent) => void): void;
+}
+export interface ShortcutRegistry {
+    /** Register one or many shortcuts. Returns an unregister function. */
+    register(shortcuts: ShortcutDefinition | ShortcutDefinition[]): () => void;
+    /** Push a context onto the stack. Returns a pop function (idempotent). */
+    pushContext(name: string, options?: PushContextOptions): () => void;
+    /** Context names that can currently fire, top of stack first. */
+    activeContexts(): string[];
+    /** Listen for keydown on `target` (default `window`). Returns a detach function. */
+    attach(target?: ShortcutEventTarget): () => void;
+    /** Dispatch an event by hand. Returns true when a shortcut fired. */
+    handleKeydown(event: KeyboardEvent): boolean;
+    /** Shortcuts grouped for `KeyboardShortcutsOverlay`'s `sections` prop. */
+    toSections(options?: ToSectionsOptions): RegistrySection[];
+    /** Every registration, in registration order. */
+    list(): ShortcutDefinition[];
+    /** Keycap label for a shortcut on this registry's platform (`⌘K`, `Ctrl+K`). */
+    format(shortcut: ShortcutDefinition | string): string;
+    /** Notified after every register/unregister/push/pop. Returns unsubscribe. */
+    subscribe(listener: () => void): () => void;
+    readonly platform: ShortcutPlatform;
+}
+/** The sidebar-toggle convention. Ctrl+B is reserved by Chrome (bookmarks bar). */
+export declare const SIDEBAR_TOGGLE_KEY = "mod+\\";
+interface ParsedCombo {
+    key: string;
+    mod: boolean;
+    meta: boolean;
+    ctrl: boolean;
+    shift: boolean;
+    alt: boolean;
+}
+export declare function detectPlatform(): ShortcutPlatform;
+/** Parse `'mod+shift+k'` (plus any extra modifiers) into a normalized combo. */
+export declare function parseCombo(key: string, extra?: ShortcutModifier | ShortcutModifier[]): ParsedCombo;
+/** True when keystrokes on `target` are text entry (so bare-key shortcuts must not fire). */
+export declare function isTypingTarget(target: EventTarget | null | undefined): boolean;
+/** Keycap label: `⌘⇧K` on macOS, `Ctrl+Shift+K` elsewhere. */
+export declare function formatShortcut(shortcut: ShortcutDefinition | string, platform?: ShortcutPlatform): string;
+export declare function createShortcutRegistry(options?: ShortcutRegistryOptions): ShortcutRegistry;
+/** Lazily-created app-wide registry, for apps that want one without threading it through props. */
+export declare function getShortcutRegistry(): ShortcutRegistry;
+export {};