@bendyline/squisq-editor-react 2.11.17 → 2.11.19

package/dist/speech/index.d.ts

@@ -0,0 +1,126 @@
+/**
+ * The speech-input (dictation) capability contract between an editor host and
+ * the shell.
+ *
+ * A host that can turn speech into text passes a {@link SpeechInputProvider}
+ * (or a factory) to `EditorShell`'s `speechInput` prop — the same
+ * capability-injection semantics as `proofing`: absent means the feature is
+ * off, no dictation code loads, and no microphone button renders.
+ *
+ * The editor owns everything up to the recognizer: microphone capture, phrase
+ * segmentation, WAV encoding, the toolbar button, the caret indicator and the
+ * literal-text insertion. The provider owns only recognition. Audio crosses
+ * the boundary as one self-contained mono 16-bit PCM WAV at 16 kHz per take,
+ * which every whisper.cpp build accepts and which keeps IPC payloads small.
+ * The surface is plain data end to end, so a provider can be a local engine
+ * behind IPC, a call to a service, or a test fake.
+ */
+/** Sample rate (Hz) of every WAV take handed to {@link SpeechInputProvider.transcribe}. */
+declare const SPEECH_INPUT_SAMPLE_RATE = 16000;
+/** Coarse readiness of a provider, as the editor's button presents it. */
+type SpeechInputReadinessState = 
+/** Dictation can start now. */
+'ready'
+/**
+ * The host needs a one-time setup (typically a model download) first.
+ * Clicking the microphone calls {@link SpeechInputProvider.requestSetup}
+ * instead of starting.
+ */
+ | 'download-required'
+/** Dictation can never work in this host/session. The button is hidden. */
+ | 'unavailable'
+/**
+ * The host still needs a permission (e.g. the OS microphone grant).
+ * Starting proceeds — the microphone request is what prompts for it.
+ */
+ | 'permission-required';
+interface SpeechInputReadiness {
+    readonly state: SpeechInputReadinessState;
+    /** Optional human-readable detail, shown in the button's tooltip/errors. */
+    readonly reason?: string;
+}
+interface SpeechInputTranscribeOptions {
+    /**
+     * The recent dictated text of this session (a word-aligned tail of at most
+     * 1,000 characters), for engines that accept a priming prompt — Whisper's
+     * `prompt`. Absent on the first take.
+     */
+    readonly prompt?: string;
+    /** BCP-47-ish language hint. The editor does not currently set it. */
+    readonly language?: string;
+    /**
+     * Aborted when the user cancels dictation or the editor unmounts. A
+     * provider should stop promptly; a rejection after abort is ignored.
+     */
+    readonly signal: AbortSignal;
+}
+interface SpeechInputTranscript {
+    /** Recognized text. Blank (or Whisper's `[BLANK_AUDIO]`) means silence. */
+    readonly text: string;
+}
+interface SpeechInputProvider {
+    /** Stable identifier, e.g. `whisper-local`. */
+    readonly id: string;
+    /** Human-readable name, e.g. `On-device speech recognition`. */
+    readonly label: string;
+    /**
+     * Current readiness. Called once when the editor mounts with the
+     * capability (to decide whether to render the microphone at all) and again
+     * each time the user starts dictation. Must be cheap.
+     */
+    status(): Promise<SpeechInputReadiness>;
+    /** Optional readiness push (e.g. a model finished downloading). Returns unsubscribe. */
+    onStatus?(listener: (readiness: SpeechInputReadiness) => void): () => void;
+    /** Called when the user starts dictation so the host can warm its engine; may reject. */
+    prepare?(signal: AbortSignal): Promise<void>;
+    /** Called when the user clicks the mic while readiness is 'download-required'; the host shows its own setup UI. */
+    requestSetup?(): void;
+    /** Transcribe one self-contained take: mono 16-bit PCM WAV at 16 kHz. */
+    transcribe(wav: ArrayBuffer, options: SpeechInputTranscribeOptions): Promise<SpeechInputTranscript>;
+    /** Release resources. Called by the editor only for a provider it created from a factory. */
+    dispose?(): void;
+}
+/**
+ * Deferred construction. The shell creates the provider when it mounts with
+ * the capability (it needs `status()` to decide whether to render the
+ * microphone) and disposes it on unmount or when the capability changes. A
+ * host that passes an instance owns its lifetime — which is what lets one warm
+ * engine survive shell remounts.
+ */
+type SpeechInputProviderFactory = () => SpeechInputProvider;
+/** What the `speechInput` shell prop accepts. */
+type SpeechInputCapability = SpeechInputProvider | SpeechInputProviderFactory;
+/**
+ * Resolve a capability to a provider instance. A factory is invoked (and the
+ * caller then owns — must dispose — what it returns); an instance is returned
+ * as-is and stays host-owned.
+ */
+declare function resolveSpeechInputProvider(capability: SpeechInputCapability): SpeechInputProvider;
+/**
+ * Whether a capability is a factory, i.e. whether the provider resolved from
+ * it is owned (and must be disposed) by the resolver's caller.
+ */
+declare function isSpeechInputProviderFactory(capability: SpeechInputCapability): capability is SpeechInputProviderFactory;
+/**
+ * Imperative dictation control on the editor context
+ * (`useEditorContext().dictation`), for a host component rendered inside the
+ * shell's slots — e.g. to drive dictation from a native menu command. `null`
+ * when the host injected no `speechInput` capability.
+ */
+interface DictationControl {
+    /** True from the moment dictation starts until its last take is inserted. */
+    readonly active: boolean;
+    /**
+     * True when `toggle()` would do something: the provider is not
+     * `unavailable` and a text-editing view (Write or Source) is showing.
+     */
+    readonly available: boolean;
+    /**
+     * Start dictation when idle (or ask the host to set up when readiness is
+     * `download-required`); finish and stop when listening; cancel while the
+     * microphone is still starting.
+     */
+    toggle(): void;
+}
+
+export { type DictationControl, SPEECH_INPUT_SAMPLE_RATE, type SpeechInputCapability, type SpeechInputProvider, type SpeechInputProviderFactory, type SpeechInputReadiness, type SpeechInputReadinessState, type SpeechInputTranscribeOptions, type SpeechInputTranscript, isSpeechInputProviderFactory, resolveSpeechInputProvider };

package/dist/speech/index.js

@@ -0,0 +1,10 @@
+import {
+  SPEECH_INPUT_SAMPLE_RATE,
+  isSpeechInputProviderFactory,
+  resolveSpeechInputProvider
+} from "../chunk-DNEVUOBZ.js";
+export {
+  SPEECH_INPUT_SAMPLE_RATE,
+  isSpeechInputProviderFactory,
+  resolveSpeechInputProvider
+};

package/dist/styles/index.css

@@ -7866,8 +7866,9 @@
 .squisq-toolbar-contextual--clipped {
   visibility: hidden;
 }
-.squisq-toolbar-button--overflowed {
-  visibility: hidden;
+.squisq-toolbar-button.squisq-toolbar-button--overflowed,
+.squisq-toolbar-group.squisq-toolbar-group--collapsed {
+  display: none;
 }
 .squisq-toolbar-view-tab {
   padding: 8px 14px 4px;
@@ -8145,6 +8146,131 @@
   text-overflow: ellipsis;
   white-space: nowrap;
 }
+.squisq-dictation {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  flex-shrink: 0;
+}
+.squisq-dictation-button--active,
+.squisq-dictation-button--active:hover {
+  background: var(--squisq-danger-soft);
+  color: var(--squisq-danger-strong);
+}
+.squisq-dictation-button--listening {
+  width: auto;
+  gap: 6px;
+  padding: 2px 8px 0;
+}
+.squisq-dictation-button[aria-busy=true] > i {
+  animation: squisq-dictation-pulse 1.2s ease-in-out infinite;
+}
+.squisq-dictation-meter {
+  display: inline-flex;
+  align-items: center;
+  gap: 1px;
+  height: 16px;
+}
+.squisq-dictation-meter-bar {
+  width: 2px;
+  min-height: 2px;
+  border-radius: 1px;
+  background: currentColor;
+  transition: height 0.05s linear;
+}
+.squisq-dictation-error {
+  position: absolute;
+  top: calc(100% + 6px);
+  right: 0;
+  z-index: 110;
+  display: flex;
+  align-items: flex-start;
+  gap: 8px;
+  width: max-content;
+  max-width: min(320px, calc(100vw - 24px));
+  padding: 8px 8px 8px 12px;
+  border: 1px solid var(--squisq-danger-border);
+  border-radius: 8px;
+  background: var(--squisq-surface);
+  box-shadow: var(--squisq-shadow-md);
+  color: var(--squisq-danger-text);
+  font-size: 12px;
+  font-weight: 500;
+  line-height: 1.4;
+  white-space: normal;
+}
+.squisq-dictation-error-text {
+  flex: 1;
+}
+.squisq-dictation-error-dismiss {
+  flex-shrink: 0;
+  padding: 0 2px;
+  border: 0;
+  background: transparent;
+  color: var(--squisq-text-muted);
+  cursor: pointer;
+  font-size: 12px;
+  line-height: 1.4;
+}
+.squisq-dictation-error-dismiss:hover {
+  color: var(--squisq-text-strong);
+}
+.squisq-dictation-interim {
+  display: inline-block;
+  margin-left: 2px;
+  padding: 0 6px;
+  border-radius: 999px;
+  background: var(--squisq-danger-soft);
+  color: var(--squisq-text-muted);
+  font-size: 0.78em;
+  font-style: italic;
+  font-weight: 400;
+  line-height: 1.5;
+  vertical-align: baseline;
+  white-space: nowrap;
+  user-select: none;
+  pointer-events: none;
+}
+.squisq-dictation-interim::before {
+  content: "";
+  display: inline-block;
+  width: 6px;
+  height: 6px;
+  margin-right: 5px;
+  border-radius: 50%;
+  background: var(--squisq-danger);
+  vertical-align: 0.1em;
+  animation: squisq-dictation-pulse 1.2s ease-in-out infinite;
+}
+.squisq-dictation-interim--source {
+  display: inline;
+  margin-left: 0.5ch;
+  padding: 0;
+  background: transparent;
+  font-size: inherit;
+  line-height: inherit;
+  opacity: 0.8;
+}
+.squisq-dictation-interim--source::before {
+  content: none;
+}
+@keyframes squisq-dictation-pulse {
+  0%, 100% {
+    opacity: 1;
+  }
+  50% {
+    opacity: 0.35;
+  }
+}
+@media (prefers-reduced-motion: reduce) {
+  .squisq-dictation-interim::before,
+  .squisq-dictation-button[aria-busy=true] > i {
+    animation: none;
+  }
+  .squisq-dictation-meter-bar {
+    transition: none;
+  }
+}
 
 /* src/styles/template-picker.css */
 .squisq-mermaid-type-menu {
@@ -9134,6 +9260,18 @@
   color: var(--squisq-text-muted);
   flex-shrink: 0;
   gap: 12px;
+  container: squisq-status-bar / inline-size;
+}
+@container squisq-status-bar (max-width: 520px) {
+  .squisq-status-chars,
+  .squisq-status-lines {
+    display: none;
+  }
+}
+@container squisq-status-bar (max-width: 300px) {
+  .squisq-status-blocks {
+    display: none;
+  }
 }
 .squisq-status-item {
   white-space: nowrap;
@@ -11323,7 +11461,8 @@
   color: var(--squisq-danger-strong);
   background: var(--squisq-danger-soft);
 }
-.squisq-version-history-empty {
+.squisq-version-history-empty,
+.squisq-version-history-note {
   padding: 16px 12px;
   font-size: 12px;
   color: var(--squisq-text-muted);

package/dist/teleprompter/index.d.ts

@@ -1,9 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Doc, Theme, MediaProvider } from '@bendyline/squisq/schemas';
 import { ContentContainer } from '@bendyline/squisq/storage';
-import { o as TeleprompterRecordingDeps, g as NarrationStageHandle, T as TeleprompterController, c as FloatingWindowHandle } from '../useNarrationStage-vKtk6H-V.js';
-export { C as CanvasSink, D as DEFAULT_TELEPROMPTER_PREFS, F as FloatOpenOptions, b as FloatTier, d as FloatingWindowManager, M as MicAnalysisHandle, e as MicAnalysisStatus, N as NarrationRecorderController, f as NarrationRecorderState, h as NarrationTake, P as PrompterTransport, J as TELEPROMPTER_PREF_LIMITS, n as TeleprompterPrefs, q as UseNarrationStageOptions, s as createFloatingWindowManager, t as detectFloatTiers, K as normalizeTeleprompterPrefs, z as useFloatingWindow, B as useMicAnalysis, E as useNarrationRecorder, G as useNarrationStage, H as useTeleprompter, I as vadConfigForSensitivity } from '../useNarrationStage-vKtk6H-V.js';
-import { NarrationTimingJsonV3, NarrationScript, NarrationAlignment } from '@bendyline/squisq/narration';
+import { o as TeleprompterRecordingDeps, g as NarrationStageHandle, T as TeleprompterController, c as FloatingWindowHandle } from '../useNarrationStage-CB8dynUg.js';
+export { C as CanvasSink, D as DEFAULT_TELEPROMPTER_PREFS, F as FloatOpenOptions, b as FloatTier, d as FloatingWindowManager, M as MicAnalysisHandle, e as MicAnalysisStatus, N as NarrationRecorderController, f as NarrationRecorderState, h as NarrationTake, P as PrompterTransport, J as TELEPROMPTER_PREF_LIMITS, n as TeleprompterPrefs, q as UseNarrationStageOptions, s as createFloatingWindowManager, t as detectFloatTiers, K as normalizeTeleprompterPrefs, z as useFloatingWindow, B as useMicAnalysis, E as useNarrationRecorder, G as useNarrationStage, H as useTeleprompter, I as vadConfigForSensitivity } from '../useNarrationStage-CB8dynUg.js';
+import { NarrationTimingJsonV3, NarrationScript, NarrationAlignment, NarrationTimingGenerator } from '@bendyline/squisq/narration';
 import { ReactNode } from 'react';
 
 interface TeleprompterViewProps {
@@ -88,10 +88,18 @@ interface NarrationSavePlanArgs {
     durationSec: number;
     audioExt: string;
     cameraExt: string | null;
-    baseWpm: number;
+    /** Speaking rate the take was paced at; recorded as `generator.baseWpm`. */
+    baseWpm?: number;
     cameraOffsetSec?: number;
     /** User-chosen filename base for the audio file; default timestamped `narration-…`. */
     audioBasename?: string;
+    /**
+     * Provenance written to the sidecar's `generator`. Defaults to the
+     * teleprompter aligner (`squisq-teleprompter` / `dsp-align`); a host that
+     * produced the timings itself names itself here — e.g.
+     * `{ name: 'my-tts', method: 'tts' }` for generated narration.
+     */
+    generator?: NarrationTimingGenerator;
 }
 interface NarrationSavePlan {
     audioRelativeName: string;
@@ -305,4 +313,4 @@ declare function prompterVarsFromTheme(theme: Theme): Record<string, string>;
 declare function ensureTeleprompterStyles(doc: Document): void;
 declare const TELEPROMPTER_CSS = "\n.squisq-teleprompter-root {\n  display: flex;\n  flex-direction: column;\n  width: 100%;\n  height: 100%;\n  min-height: 0;\n  background: var(--squisq-bg, #f5f5f5);\n  outline: none;\n}\n.squisq-teleprompter-stage {\n  position: relative;\n  flex: 1;\n  min-height: 0;\n  display: flex;\n}\n\n.squisq-teleprompter-surface {\n  position: relative;\n  flex: 1;\n  min-height: 0;\n  overflow: hidden;\n  background: var(--squisq-prompter-bg, #101014);\n  color: var(--squisq-prompter-text, #f5f5f2);\n  font-family: var(--squisq-prompter-font, system-ui, sans-serif);\n  user-select: none;\n}\n.squisq-teleprompter-flip {\n  position: absolute;\n  inset: 0;\n}\n.squisq-teleprompter-surface--mirrored .squisq-teleprompter-flip {\n  transform: scaleX(-1);\n}\n.squisq-teleprompter-scroll {\n  position: absolute;\n  left: 0;\n  right: 0;\n  top: 0;\n  will-change: transform;\n  padding: 40vh 8% 60vh;\n  box-sizing: border-box;\n}\n.squisq-teleprompter-line-guide {\n  position: absolute;\n  left: 0;\n  right: 0;\n  pointer-events: none;\n  z-index: 2;\n}\n.squisq-teleprompter-line-guide::before,\n.squisq-teleprompter-line-guide::after {\n  content: '';\n  position: absolute;\n  top: 50%;\n  border: 9px solid transparent;\n  transform: translateY(-50%);\n}\n.squisq-teleprompter-line-guide::before {\n  left: 6px;\n  border-left-color: var(--squisq-prompter-accent, #e8b64c);\n}\n.squisq-teleprompter-line-guide::after {\n  right: 6px;\n  border-right-color: var(--squisq-prompter-accent, #e8b64c);\n}\n.squisq-teleprompter-guide-band {\n  position: absolute;\n  left: 0;\n  right: 0;\n  background: color-mix(in srgb, var(--squisq-prompter-accent, #e8b64c) 9%, transparent);\n  pointer-events: none;\n  z-index: 1;\n}\n\n.squisq-teleprompter-block-marker {\n  display: block;\n  margin: 1.1em 0 0.35em;\n  font-size: 0.38em;\n  font-weight: 600;\n  letter-spacing: 0.14em;\n  text-transform: uppercase;\n  color: var(--squisq-prompter-muted, #9a9aa0);\n  border-top: 1px solid color-mix(in srgb, var(--squisq-prompter-muted, #9a9aa0) 35%, transparent);\n  padding-top: 0.6em;\n}\n.squisq-teleprompter-para {\n  margin: 0 0 0.55em;\n  line-height: 1.4;\n  font-weight: 500;\n}\n.squisq-teleprompter-word {\n  opacity: 0.45;\n  transition: color 0.1s linear, opacity 0.1s linear;\n}\n.squisq-teleprompter-word--read {\n  opacity: 0.9;\n}\n.squisq-teleprompter-word--active {\n  opacity: 1;\n  font-weight: 800;\n  color: var(--squisq-prompter-accent, #e8b64c);\n}\n\n.squisq-teleprompter-countdown {\n  position: absolute;\n  inset: 0;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  z-index: 3;\n  background: color-mix(in srgb, var(--squisq-prompter-bg, #101014) 72%, transparent);\n}\n.squisq-teleprompter-countdown-digit {\n  font-size: 18vmin;\n  font-weight: 800;\n  color: var(--squisq-prompter-accent, #e8b64c);\n  animation: squisq-prompter-pulse 1s ease-in-out infinite;\n}\n.squisq-teleprompter-recdot {\n  position: absolute;\n  top: 14px;\n  right: 16px;\n  z-index: 4;\n  width: 14px;\n  height: 14px;\n  border-radius: 50%;\n  background: #e5484d;\n  box-shadow: 0 0 0 3px color-mix(in srgb, #e5484d 30%, transparent);\n  animation: squisq-prompter-pulse 1.4s ease-in-out infinite;\n}\n/* Counter-flip overlays so they stay readable in mirror mode. */\n.squisq-teleprompter-surface--mirrored .squisq-teleprompter-countdown,\n.squisq-teleprompter-surface--mirrored .squisq-teleprompter-recdot {\n  transform: scaleX(-1);\n}\n\n.squisq-teleprompter-selfview {\n  position: absolute;\n  right: 14px;\n  bottom: 14px;\n  width: 160px;\n  border-radius: 8px;\n  border: 2px solid color-mix(in srgb, #e5484d 60%, transparent);\n  z-index: 5;\n  background: #000;\n}\n\n.squisq-teleprompter-review {\n  display: flex;\n  align-items: center;\n  flex-wrap: wrap;\n  gap: 10px;\n  padding: 8px 12px;\n  border-top: 1px solid var(--squisq-border, #e5e7eb);\n  background: var(--squisq-surface, var(--squisq-bg, #fff));\n  color: var(--squisq-text, #111827);\n  font-size: 12.5px;\n}\n.squisq-teleprompter-review audio {\n  height: 28px;\n  max-width: 260px;\n}\n.squisq-teleprompter-review button {\n  font: inherit;\n  color: inherit;\n  background: var(--squisq-input-bg, #fff);\n  border: 1px solid var(--squisq-border, #d1d5db);\n  border-radius: 6px;\n  padding: 4px 10px;\n  cursor: pointer;\n}\n\n.squisq-teleprompter-float-note {\n  flex: 1;\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  justify-content: center;\n  gap: 12px;\n  color: var(--squisq-text-muted, #4b5563);\n  font-size: 14px;\n}\n\n.squisq-teleprompter-controls {\n  display: flex;\n  align-items: center;\n  flex-wrap: wrap;\n  gap: 10px;\n  padding: 8px 12px;\n  border-top: 1px solid var(--squisq-border, #e5e7eb);\n  background: var(--squisq-surface, var(--squisq-bg, #fff));\n  color: var(--squisq-text, #111827);\n  font-size: 12.5px;\n}\n.squisq-teleprompter-controls .squisq-teleprompter-group {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  white-space: nowrap;\n}\n.squisq-teleprompter-controls button {\n  font: inherit;\n  color: inherit;\n  background: var(--squisq-input-bg, #fff);\n  border: 1px solid var(--squisq-border, #d1d5db);\n  border-radius: 6px;\n  padding: 4px 10px;\n  cursor: pointer;\n}\n.squisq-teleprompter-controls button:hover {\n  background: var(--squisq-surface-hover, #f3f4f6);\n}\n.squisq-teleprompter-controls button[aria-pressed='true'] {\n  background: var(--squisq-text, #111827);\n  color: var(--squisq-bg, #fff);\n  border-color: var(--squisq-text, #111827);\n}\n.squisq-teleprompter-controls select,\n.squisq-teleprompter-controls input[type='range'] {\n  font: inherit;\n  color: inherit;\n  background: var(--squisq-input-bg, #fff);\n  border: 1px solid var(--squisq-border, #d1d5db);\n  border-radius: 6px;\n  max-width: 170px;\n}\n.squisq-teleprompter-controls input[type='range'] {\n  border: none;\n  background: transparent;\n  width: 110px;\n}\n.squisq-teleprompter-meter {\n  position: relative;\n  width: 64px;\n  height: 8px;\n  border-radius: 4px;\n  overflow: hidden;\n  background: var(--squisq-border, #e5e7eb);\n}\n.squisq-teleprompter-meter-fill {\n  position: absolute;\n  inset: 0 auto 0 0;\n  background: #9ca3af;\n  transition: width 0.08s linear;\n}\n.squisq-teleprompter-meter--voice .squisq-teleprompter-meter-fill {\n  background: #30a46c;\n}\n\n@keyframes squisq-prompter-pulse {\n  0%, 100% { opacity: 1; }\n  50% { opacity: 0.45; }\n}\n@media (prefers-reduced-motion: reduce) {\n  .squisq-teleprompter-countdown-digit,\n  .squisq-teleprompter-recdot {\n    animation: none;\n  }\n  .squisq-teleprompter-word {\n    transition: none;\n  }\n}\n";
 
-export { EYE_LINE_FRACTION, FloatingWindowHandle, type NarrationSavePlan, type NarrationSaveResult, NarrationStage, NarrationStageHandle, type NarrationStageProps, PCM_WORKLET_NAME, PCM_WORKLET_SOURCE, TELEPROMPTER_CSS, TeleprompterController, TeleprompterControls, type TeleprompterControlsProps, TeleprompterRecordingDeps, TeleprompterSurface, type TeleprompterSurfaceProps, TeleprompterView, type TeleprompterViewProps, type TokenLineMap, buildNarrationSavePlan, cameraVideoLine, ensureTeleprompterStyles, executeNarrationSave, insertNarrationPreamble, measureTokenLines, narrationAnnotationLine, prompterVarsFromTheme, registerPcmWorklet, stepScroll, targetOffsetFor };
+export { EYE_LINE_FRACTION, type ExecuteNarrationSaveDeps, FloatingWindowHandle, type NarrationSavePlan, type NarrationSavePlanArgs, type NarrationSaveProgress, type NarrationSaveResult, NarrationStage, NarrationStageHandle, type NarrationStageProps, PCM_WORKLET_NAME, PCM_WORKLET_SOURCE, TELEPROMPTER_CSS, TeleprompterController, TeleprompterControls, type TeleprompterControlsProps, TeleprompterRecordingDeps, TeleprompterSurface, type TeleprompterSurfaceProps, TeleprompterView, type TeleprompterViewProps, type TokenLineMap, buildNarrationSavePlan, cameraVideoLine, ensureTeleprompterStyles, executeNarrationSave, insertNarrationPreamble, measureTokenLines, narrationAnnotationLine, prompterVarsFromTheme, registerPcmWorklet, stepScroll, targetOffsetFor };

package/dist/teleprompter/index.js

@@ -1,6 +1,6 @@
 import {
   TeleprompterView
-} from "../chunk-QZWFSSDE.js";
+} from "../chunk-DJS5I5NO.js";
 import {
   DEFAULT_TELEPROMPTER_PREFS,
   EYE_LINE_FRACTION,
@@ -31,7 +31,8 @@ import {
   useNarrationStage,
   useTeleprompter,
   vadConfigForSensitivity
-} from "../chunk-XZVMKR5Q.js";
+} from "../chunk-ZS6G2P57.js";
+import "../chunk-DNJ6HOES.js";
 export {
   DEFAULT_TELEPROMPTER_PREFS,
   EYE_LINE_FRACTION,

package/dist/{useNarrationStage-vKtk6H-V.d.ts → useNarrationStage-CB8dynUg.d.ts}

@@ -380,6 +380,13 @@ interface TeleprompterController {
     prefs: TeleprompterPrefs;
     setPrefs: (patch: Partial<TeleprompterPrefs>) => void;
     play: () => void;
+    /**
+     * `play()`, resolving when the prompter actually rolls: true once the
+     * countdown finishes (at once if there is none or it is already rolling),
+     * false if pause/restart/unmount cancels the countdown first. Capture
+     * awaits this so a take opens at "go", not on "3, 2, 1".
+     */
+    countIn: () => Promise<boolean>;
     pause: () => void;
     restart: () => void;
     /** Move by spoken words and re-anchor voice tracking. */
@@ -519,8 +526,15 @@ interface UseNarrationRecorderOptions {
     cameraRecorderOptions?: NarrationMediaRecorderOptions;
     /** Combined audio/camera soft stop threshold; defaults to 90 MiB. Final chunks are retained. */
     maxRecordingBytes?: number;
-    /** Fired when capture actually starts (View starts the prompter). */
+    /**
+     * Awaited once every device is live, immediately before the first byte is
+     * captured — the prompter's countdown. Resolving false cancels the start
+     * with nothing recorded.
+     */
+    countIn?: () => Promise<boolean>;
+    /** Fired once capture is running. */
     onRecordingStart?: () => void;
+    /** Fired on stop, including a stop while the start (or its count-in) is pending. */
     onRecordingStop?: () => void;
 }
 interface NarrationRecorderController {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq-editor-react",
-  "version": "2.11.17",
+  "version": "2.11.19",
   "description": "React editor shell with raw/WYSIWYG/preview modes for Squisq documents",
   "license": "MIT",
   "author": "Bendyline",
@@ -76,6 +76,10 @@
       "types": "./dist/review/index.d.ts",
       "import": "./dist/review/index.js"
     },
+    "./speech": {
+      "types": "./dist/speech/index.d.ts",
+      "import": "./dist/speech/index.js"
+    },
     "./styles": {
       "types": "./dist/styles/index.d.ts",
       "default": "./dist/styles/index.css"
@@ -98,12 +102,12 @@
     }
   },
   "dependencies": {
-    "@bendyline/squisq": "2.11.14",
+    "@bendyline/squisq": "2.11.16",
     "@bendyline/squisq-calc": "2.11.1",
-    "@bendyline/squisq-formats": "2.6.14",
-    "@bendyline/squisq-grid-react": "2.11.15",
-    "@bendyline/squisq-react": "2.11.16",
-    "@bendyline/squisq-video-react": "2.4.20",
+    "@bendyline/squisq-formats": "2.6.16",
+    "@bendyline/squisq-grid-react": "2.11.17",
+    "@bendyline/squisq-react": "2.11.18",
+    "@bendyline/squisq-video-react": "2.4.22",
     "@fortawesome/fontawesome-free": "7.2.0",
     "@tiptap/core": "2.27.3",
     "@tiptap/extension-heading": "2.27.3",