@joewinke/jatui 0.22.0 → 0.24.0

package/dist/stores/toast.d.ts

@@ -2,6 +2,12 @@ export type ToastType = 'info' | 'success' | 'warning' | 'error';
 export type ToastOptions = {
     type?: ToastType;
     message: string;
+    /** Extended detail text (e.g. a stack trace or error chain) — rendered by
+     *  ToastHost behind a collapsible "Details" toggle. Multiline-safe. */
+    details?: string;
+    /** Arbitrary structured context carried on the Toast for programmatic
+     *  access (getToasts()); not rendered by ToastHost. */
+    meta?: Record<string, unknown>;
     action?: {
         label: string;
         onClick: () => void;
@@ -13,6 +19,8 @@ export type Toast = {
     id: number;
     type: ToastType;
     message: string;
+    details?: string;
+    meta?: Record<string, unknown>;
     action?: {
         label: string;
         onClick: () => void;

package/dist/stores/toast.js

@@ -15,6 +15,8 @@ export function showToast(options) {
 		id,
 		type: options.type ?? 'info',
 		message: options.message,
+		details: options.details,
+		meta: options.meta,
 		action: options.action,
 		durationMs: options.durationMs ?? 5000,
 		onUndo: options.onUndo

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/audioRecorder.d.ts

@@ -0,0 +1,28 @@
+import type { AudioRecorderMode, AudioRecorderOptions, AudioRecorderPhase, AudioRecorderSnapshot } from './audioRecorderCore';
+export type { 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;
+    readonly mode: AudioRecorderMode;
+    readonly phase: AudioRecorderPhase;
+    /** True while recording is suspended (pause()). */
+    readonly paused: boolean;
+    /** 0–100 live mic level. */
+    readonly level: number;
+    /** Bytes captured so far. */
+    readonly sizeBytes: number;
+    /** Pause-adjusted wall-clock elapsed ms. */
+    readonly elapsedMs: number;
+    /** Last error, or null. */
+    readonly error: AudioRecorderSnapshot['error'];
+    start(): Promise<void>;
+    stop(): void;
+    pause(): void;
+    resume(): void;
+    cancel(): void;
+    /** Return a finished/errored recorder to idle so the host can record again. */
+    reset(): void;
+    /** Final teardown — releases mic + timers. Call from onDestroy. */
+    destroy(): void;
+}
+export declare function createAudioRecorder(options?: AudioRecorderOptions): AudioRecorder;

package/dist/utils/audioRecorder.js

@@ -0,0 +1,58 @@
+/* audioRecorder.svelte.js generated by Svelte v5.53.11 */
+import * as $ from 'svelte/internal/client';
+import { createAudioRecorderCore } from './audioRecorderCore';
+
+export function createAudioRecorder(options = {}) {
+	const core = createAudioRecorderCore(options);
+	const snap = $.proxy(core.snapshot());
+
+	core.subscribe((s) => {
+		snap.phase = s.phase;
+		snap.paused = s.paused;
+		snap.level = s.level;
+		snap.sizeBytes = s.sizeBytes;
+		snap.elapsedMs = s.elapsedMs;
+		snap.error = s.error;
+	});
+
+	return {
+		get supported() {
+			return core.supported;
+		},
+
+		get mode() {
+			return core.mode;
+		},
+
+		get phase() {
+			return snap.phase;
+		},
+
+		get paused() {
+			return snap.paused;
+		},
+
+		get level() {
+			return snap.level;
+		},
+
+		get sizeBytes() {
+			return snap.sizeBytes;
+		},
+
+		get elapsedMs() {
+			return snap.elapsedMs;
+		},
+
+		get error() {
+			return snap.error;
+		},
+		start: () => core.start(),
+		stop: () => core.stop(),
+		pause: () => core.pause(),
+		resume: () => core.resume(),
+		cancel: () => core.cancel(),
+		reset: () => core.reset(),
+		destroy: () => core.destroy()
+	};
+}

package/dist/utils/audioRecorderCore.d.ts

@@ -0,0 +1,132 @@
+/**
+ * createAudioRecorderCore — headless audio-capture primitive (jatui-is2ow.8).
+ *
+ * The capture pipeline of `AudioRecorder.svelte` (permission request, MIME
+ * negotiation, MediaRecorder state machine, pause-aware wall-clock timing,
+ * AnalyserNode level meter, blob out) factored into a dependency-injected,
+ * DOM-free core so any host can drive it from its own UI — mic buttons,
+ * push-to-talk keys, overlays — without importing the component.
+ *
+ * NO transcription here by design: hosts that transcribe (the jat IDE's
+ * VoiceMicButton/VoiceInput, wave 3.5 of the adoption audit jat-1alfp) keep
+ * their POST-local capture shape and consume `onStop`'s blob payload.
+ *
+ * Two layers:
+ *   • this plain module — every knob injectable via `deps` (tests drive a fake
+ *     MediaRecorder backend in node:test, no DOM);
+ *   • `audioRecorder.svelte.ts` — the `createAudioRecorder()` rune wrapper
+ *     that wires the core's snapshot into `$state` so Svelte 5 templates react
+ *     to it. Components and app code import the wrapper; tests import this.
+ *
+ * Modes:
+ *   • `'toggle'` (default) — click-style: `start()` begins, `stop()` ends.
+ *   • `'push'` — hold-to-talk: the host wires pointerdown → `start()`,
+ *     pointerup → `stop()`. A `stop()` that arrives while the mic stream is
+ *     still being acquired (a very quick tap) CANCELS — no blob, no error —
+ *     matching the jat IDE VoiceMicButton's pointerup-before-stream behavior.
+ *
+ * Phases: idle → starting → recording ⇄(pause/resume) → processing → done,
+ * with `cancel()` from recording returning straight to idle and `reset()`
+ * returning a finished/errored recorder to idle so the host can go again.
+ *
+ * Timer discipline (lesson from MediaCapture, mos-ow4q4.37): elapsed time is
+ * derived from the wall clock minus accumulated pause, never an incremented
+ * counter — a throttled background tab can't freeze it.
+ */
+export type AudioRecorderPhase = 'idle' | 'starting' | 'recording' | 'processing' | 'done';
+export type AudioRecorderMode = 'toggle' | 'push';
+/** Why a recording attempt failed. */
+export type AudioRecorderErrorKind = 'unsupported' | 'denied' | 'no-mic' | 'start-failed' | 'too-short' | 'handler-failed';
+export interface AudioRecorderError {
+    kind: AudioRecorderErrorKind;
+    message: string;
+}
+/** What a finished recording hands back to the host — mirrors MediaCaptureResult's shape for the audio kind. */
+export interface AudioRecordingResult {
+    blob: Blob;
+    mimeType: string;
+    durationSeconds: number;
+    sizeBytes: number;
+}
+/** One animation frame of analyser data, for hosts that render a visualization. */
+export interface AudioRecorderFrame {
+    /** 0–100 RMS level (same value exposed reactively as `level`). */
+    level: number;
+    /** Frequency-domain bytes (from getByteFrequencyData). */
+    frequency: Uint8Array;
+    /** Time-domain bytes (from getByteTimeDomainData) — raw PCM-ish shape. */
+    time: Uint8Array;
+}
+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;
+    /** Fired once the mic stream is live and recording has started. */
+    onStart?: () => void;
+    onPause?: () => void;
+    onResume?: () => void;
+    /** Fired with the finished recording. May return a Promise — the recorder
+     * stays in "processing" until it settles, so hosts can upload/transcribe
+     * without the user re-triggering a recording. */
+    onStop?: (result: AudioRecordingResult) => void | Promise<void>;
+    /** Fired when the recording is cancelled — no blob is produced. */
+    onCancel?: () => void;
+    /** Fired on recorder errors (permission denied, no mic, start failure, …). */
+    onError?: (error: AudioRecorderError) => void;
+    /** 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;
+}
+/** 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 {
+    getUserMedia?: (constraints?: MediaStreamConstraints) => Promise<MediaStream>;
+    MediaRecorder?: any;
+    AudioContext?: any;
+    requestAnimationFrame?: (cb: (t: number) => void) => number;
+    cancelAnimationFrame?: (id: number) => void;
+    setTimeout?: typeof setTimeout;
+    clearTimeout?: typeof clearTimeout;
+    setInterval?: typeof setInterval;
+    clearInterval?: typeof clearInterval;
+    /** Wall clock — injectable so tests can advance time deterministically. */
+    now?: () => number;
+}
+export interface AudioRecorderSnapshot {
+    phase: AudioRecorderPhase;
+    /** True while recording is suspended (pause()). */
+    paused: boolean;
+    /** 0–100 live mic level. */
+    level: number;
+    /** Bytes captured so far. */
+    sizeBytes: number;
+    /** Pause-adjusted wall-clock elapsed ms. */
+    elapsedMs: number;
+    /** Last error, or null. */
+    error: AudioRecorderError | null;
+}
+export interface AudioRecorderCore {
+    /** False when the platform has no getUserMedia/MediaRecorder (SSR, Node). */
+    readonly supported: boolean;
+    readonly mode: AudioRecorderMode;
+    /** Current reactive-independent snapshot (the rune wrapper copies this into $state). */
+    snapshot(): AudioRecorderSnapshot;
+    /** Subscribe to snapshot changes. Returns an unsubscribe fn. */
+    subscribe(fn: (snapshot: AudioRecorderSnapshot) => void): () => void;
+    start(): Promise<void>;
+    stop(): void;
+    pause(): void;
+    resume(): void;
+    cancel(): void;
+    /** Return a finished/errored recorder to idle so the host can record again. */
+    reset(): void;
+    /** Final teardown — releases mic + timers. Safe to call from any phase. */
+    destroy(): void;
+}
+/** First supported recording MIME type, or '' when none are. */
+export declare function pickAudioMimeType(isSupported?: (type: string) => boolean): string;
+/** RMS of the time-domain data scaled to the recorder's 0–100 meter range. */
+export declare function computeAudioLevel(timeData: ArrayLike<number> | null): number;
+/** Elapsed from the wall clock, pause-adjusted — see module header note. */
+export declare function computeElapsedMs(startedAt: number, pausedTotalMs: number, pauseStartedAt: number, now: number): number;
+export declare function createAudioRecorderCore(options?: AudioRecorderOptions, deps?: AudioRecorderDeps): AudioRecorderCore;