@bendyline/squisq-editor-react 2.9.0 → 2.10.1

package/dist/styles/index.css

@@ -7590,6 +7590,9 @@
 .squisq-toolbar-contextual--clipped {
   visibility: hidden;
 }
+.squisq-toolbar-button--overflowed {
+  visibility: hidden;
+}
 .squisq-toolbar-view-tab {
   padding: 8px 14px 4px;
   border: none;
@@ -9090,7 +9093,7 @@
   color: #dc2626;
 }
 .squisq-wysiwyg-container {
-  background: #dcd8d0;
+  background: var(--squisq-desk-bg);
 }
 .squisq-wysiwyg-editor {
   padding: 16px 24px;
@@ -10060,6 +10063,7 @@
   --squisq-input-bg: #fff;
   --squisq-text: #1f2937;
   --squisq-text-muted: #6b7280;
+  --squisq-desk-bg: #dcd8d0;
   --squisq-editor-background: #ffffff;
   --squisq-editor-foreground: #1f2937;
 }
@@ -10069,6 +10073,7 @@
   --squisq-input-bg: #374151;
   --squisq-text: #e5e7eb;
   --squisq-text-muted: #9ca3af;
+  --squisq-desk-bg: #0f1219;
   --squisq-editor-background: #1e1e1e;
   --squisq-editor-foreground: #d4d4d4;
 }
@@ -10344,9 +10349,6 @@
 .squisq-editor-shell[data-theme=dark] .squisq-status-error {
   color: #f87171;
 }
-.squisq-editor-shell[data-theme=dark] .squisq-wysiwyg-container {
-  background: #0f1219;
-}
 .squisq-editor-shell[data-theme=dark] .squisq-wysiwyg-editor {
   color: #e5e7eb;
   background: #111827;
@@ -11939,7 +11941,7 @@
   align-items: center;
   justify-content: center;
   padding: 12px 16px;
-  background: #dcd8d0;
+  background: var(--squisq-desk-bg);
   border-left: 1px solid #b0a99a;
   overflow: auto;
 }
@@ -11959,7 +11961,6 @@
   height: 100%;
 }
 .squisq-editor-shell[data-theme=dark] .squisq-block-preview-panel {
-  background: #0f1219;
   border-left-color: #2a3144;
 }
 .squisq-editor-shell[data-theme=dark] .squisq-block-preview-frame {
@@ -11970,7 +11971,7 @@
   flex-direction: column;
   height: 100%;
   min-height: 0;
-  background: #dcd8d0;
+  background: var(--squisq-desk-bg);
 }
 .squisq-block-card-body {
   flex: 1 1 auto;
@@ -12029,9 +12030,6 @@
 .squisq-block-card-add {
   margin-left: 8px;
 }
-.squisq-editor-shell[data-theme=dark] .squisq-block-card {
-  background: #0f1219;
-}
 .squisq-editor-shell[data-theme=dark] .squisq-block-card-body .squisq-wysiwyg-editor,
 .squisq-editor-shell[data-theme=dark] .squisq-block-card-body > .squisq-raw-editor-container {
   border-top-color: #2a3144;
@@ -12764,7 +12762,7 @@
 .squisq-editor-shell {
   --squisq-preview-accent: #6366f1;
   --squisq-preview-accent-muted: #94a3b8;
-  --squisq-preview-gutter-bg: #dcd8d0;
+  --squisq-preview-gutter-bg: var(--squisq-desk-bg);
   --squisq-preview-card-bg: #ffffff;
   --squisq-preview-card-border: #e5e7eb;
   --squisq-preview-card-shadow: 0 1px 2px rgba(15, 23, 42, 0.04);
@@ -12878,7 +12876,7 @@
 }
 .squisq-outline {
   padding: 12px 8px;
-  background: #dcd8d0;
+  background: var(--squisq-desk-bg);
   font-size: 13px;
   color: #1f2937;
   box-sizing: border-box;
@@ -13081,13 +13079,12 @@
   color: #f9fafb;
 }
 .squisq-editor-shell[data-theme=dark] .squisq-outline {
-  background: #0f1219;
   color: #d1d5db;
 }
 .squisq-editor-shell[data-theme=dark] {
   --squisq-preview-accent: #818cf8;
   --squisq-preview-accent-muted: #475569;
-  --squisq-preview-gutter-bg: #0f1219;
+  --squisq-preview-gutter-bg: var(--squisq-desk-bg);
   --squisq-preview-card-bg: #111827;
   --squisq-preview-card-border: #1f2937;
   --squisq-preview-card-shadow: 0 1px 2px rgba(0, 0, 0, 0.4);
@@ -17087,6 +17084,407 @@ button.squisq-ascii-timeline-track-name:focus-visible {
   }
 }
 
+/* src/styles/proofing.css */
+.squisq-proof-underline {
+  text-decoration-skip-ink: none;
+}
+.squisq-proof-underline--spelling {
+  text-decoration: underline wavy #d93025 1px;
+  text-decoration-skip-ink: none;
+}
+.squisq-proof-underline--grammar {
+  text-decoration: underline wavy #188038 1px;
+  text-decoration-skip-ink: none;
+}
+.squisq-proof-underline--style {
+  text-decoration: underline dotted #1a73e8 1.5px;
+  text-decoration-skip-ink: none;
+}
+.squisq-proof-dot {
+  display: inline-block;
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  flex: 0 0 auto;
+}
+.squisq-proof-dot--spelling {
+  background: #d93025;
+}
+.squisq-proof-dot--grammar {
+  background: #188038;
+}
+.squisq-proof-dot--style {
+  background: #1a73e8;
+}
+.squisq-proof-panel {
+  width: 240px;
+  flex: 0 0 240px;
+  display: flex;
+  flex-direction: column;
+  border-left: 1px solid #e0e0e0;
+  background: #fafafa;
+  min-height: 0;
+  font-size: 12px;
+}
+.squisq-proof-panel-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 8px 10px;
+  border-bottom: 1px solid #e0e0e0;
+}
+.squisq-proof-panel-title {
+  font-weight: 600;
+  color: #444;
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+}
+.squisq-proof-panel-count {
+  background: #e8e8e8;
+  color: #555;
+  border-radius: 8px;
+  padding: 0 6px;
+  font-weight: 500;
+}
+.squisq-proof-panel-actions {
+  display: inline-flex;
+  gap: 2px;
+}
+.squisq-proof-panel-button {
+  border: none;
+  background: transparent;
+  color: #666;
+  cursor: pointer;
+  border-radius: 4px;
+  padding: 2px 6px;
+  font-size: 12px;
+  line-height: 1.4;
+}
+.squisq-proof-panel-button:hover:not(:disabled) {
+  background: #ececec;
+  color: #222;
+}
+.squisq-proof-panel-button:disabled {
+  opacity: 0.4;
+  cursor: default;
+}
+.squisq-proof-panel-empty {
+  padding: 14px 12px;
+  color: #888;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  align-items: flex-start;
+}
+.squisq-proof-panel-retry {
+  border: 1px solid #ccc;
+  background: #fff;
+  border-radius: 4px;
+  padding: 2px 10px;
+  cursor: pointer;
+  font-size: 12px;
+}
+.squisq-proof-panel-list {
+  list-style: none;
+  margin: 0;
+  padding: 4px 0;
+  overflow-y: auto;
+  flex: 1 1 auto;
+  min-height: 0;
+}
+.squisq-proof-panel-row {
+  display: flex;
+  align-items: flex-start;
+  gap: 8px;
+  width: 100%;
+  border: none;
+  background: transparent;
+  text-align: left;
+  padding: 6px 10px;
+  cursor: pointer;
+  font: inherit;
+}
+.squisq-proof-panel-row:hover {
+  background: #f0f0f0;
+}
+.squisq-proof-panel-row--active {
+  background: #e7f0fe;
+}
+.squisq-proof-panel-row .squisq-proof-dot {
+  margin-top: 4px;
+}
+.squisq-proof-panel-row-body {
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+  min-width: 0;
+}
+.squisq-proof-panel-excerpt {
+  font-weight: 600;
+  color: #333;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.squisq-proof-panel-message {
+  color: #777;
+}
+.squisq-proof-menu {
+  min-width: 200px;
+  max-width: 320px;
+  background: #fff;
+  border: 1px solid #d5d5d5;
+  border-radius: 8px;
+  box-shadow: 0 6px 24px rgba(0, 0, 0, 0.14);
+  padding: 4px;
+  font-size: 13px;
+}
+.squisq-proof-menu-header {
+  display: flex;
+  align-items: flex-start;
+  gap: 7px;
+  padding: 6px 8px;
+  color: #666;
+  font-size: 12px;
+  border-bottom: 1px solid #eee;
+  margin-bottom: 4px;
+}
+.squisq-proof-menu-header .squisq-proof-dot {
+  margin-top: 3px;
+}
+.squisq-proof-menu-item {
+  display: block;
+  width: 100%;
+  border: none;
+  background: transparent;
+  text-align: left;
+  padding: 6px 10px;
+  border-radius: 5px;
+  cursor: pointer;
+  color: #333;
+  font: inherit;
+}
+.squisq-proof-menu-item:hover,
+.squisq-proof-menu-item:focus-visible {
+  background: #f0f4ff;
+  outline: none;
+}
+.squisq-proof-menu-suggestion {
+  font-weight: 600;
+}
+.squisq-proof-menu-empty {
+  padding: 6px 10px;
+  color: #999;
+  font-style: italic;
+}
+.squisq-proof-tooltip {
+  max-width: 320px;
+  background: #fff;
+  border: 1px solid #d5d5d5;
+  border-radius: 8px;
+  box-shadow: 0 6px 24px rgba(0, 0, 0, 0.14);
+  padding: 8px 10px;
+  font-size: 12px;
+  line-height: 1.4;
+  color: #333;
+}
+.squisq-proof-tooltip-head {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  margin-bottom: 3px;
+}
+.squisq-proof-tooltip-category {
+  font-weight: 600;
+  font-size: 11px;
+  letter-spacing: 0.03em;
+  text-transform: uppercase;
+  color: #666;
+}
+.squisq-proof-tooltip-message {
+  color: #222;
+}
+.squisq-proof-tooltip-suggestions {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 4px;
+  margin-top: 6px;
+}
+.squisq-proof-tooltip-chip {
+  border: 1px solid transparent;
+  padding: 2px 8px;
+  border-radius: 4px;
+  background: #f0f4ff;
+  color: #1a3d8f;
+  font: inherit;
+  font-weight: 600;
+  cursor: pointer;
+}
+.squisq-proof-tooltip-chip:hover,
+.squisq-proof-tooltip-chip:focus-visible {
+  background: #dfe8ff;
+  border-color: #b7c8f5;
+  outline: none;
+}
+.squisq-proof-tooltip-more {
+  border: none;
+  background: transparent;
+  padding: 2px 4px;
+  border-radius: 4px;
+  color: #777;
+  font: inherit;
+  font-size: 11px;
+  cursor: pointer;
+}
+.squisq-proof-tooltip-more:hover,
+.squisq-proof-tooltip-more:focus-visible {
+  color: #333;
+  background: #f0f0f0;
+  outline: none;
+}
+.squisq-proof-tooltip-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 2px;
+  margin-top: 6px;
+  padding-top: 5px;
+  border-top: 1px solid #eee;
+}
+.squisq-proof-tooltip-action {
+  border: none;
+  background: transparent;
+  padding: 3px 6px;
+  border-radius: 4px;
+  color: #666;
+  font: inherit;
+  font-size: 11px;
+  cursor: pointer;
+}
+.squisq-proof-tooltip-action:hover,
+.squisq-proof-tooltip-action:focus-visible {
+  background: #f0f0f0;
+  color: #222;
+  outline: none;
+}
+.squisq-proof-status {
+  cursor: pointer;
+  user-select: none;
+  border: none;
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  padding: 0;
+}
+.squisq-proof-status--error {
+  color: #d93025;
+}
+.squisq-editor-shell[data-theme=dark] .squisq-proof-underline--spelling {
+  text-decoration-color: #f28b82;
+}
+.squisq-editor-shell[data-theme=dark] .squisq-proof-underline--grammar {
+  text-decoration-color: #81c995;
+}
+.squisq-editor-shell[data-theme=dark] .squisq-proof-underline--style {
+  text-decoration-color: #8ab4f8;
+}
+.squisq-editor-shell[data-theme=dark] .squisq-proof-panel {
+  background: #1f1f1f;
+  border-left-color: #383838;
+}
+.squisq-editor-shell[data-theme=dark] .squisq-proof-panel-header {
+  border-bottom-color: #383838;
+}
+.squisq-editor-shell[data-theme=dark] .squisq-proof-panel-title {
+  color: #ccc;
+}
+.squisq-editor-shell[data-theme=dark] .squisq-proof-panel-count {
+  background: #333;
+  color: #bbb;
+}
+.squisq-editor-shell[data-theme=dark] .squisq-proof-panel-button {
+  color: #999;
+}
+.squisq-editor-shell[data-theme=dark] .squisq-proof-panel-button:hover:not(:disabled) {
+  background: #2e2e2e;
+  color: #ddd;
+}
+.squisq-editor-shell[data-theme=dark] .squisq-proof-panel-empty {
+  color: #888;
+}
+.squisq-editor-shell[data-theme=dark] .squisq-proof-panel-retry {
+  background: #2a2a2a;
+  border-color: #444;
+  color: #ccc;
+}
+.squisq-editor-shell[data-theme=dark] .squisq-proof-panel-row:hover {
+  background: #2a2a2a;
+}
+.squisq-editor-shell[data-theme=dark] .squisq-proof-panel-row--active {
+  background: #1c3a5e;
+}
+.squisq-editor-shell[data-theme=dark] .squisq-proof-panel-excerpt {
+  color: #ddd;
+}
+.squisq-editor-shell[data-theme=dark] .squisq-proof-panel-message {
+  color: #999;
+}
+.squisq-proof-menu[data-theme=dark] {
+  background: #262626;
+  border-color: #454545;
+  box-shadow: 0 6px 24px rgba(0, 0, 0, 0.5);
+}
+.squisq-proof-menu[data-theme=dark] .squisq-proof-menu-header {
+  color: #aaa;
+  border-bottom-color: #3a3a3a;
+}
+.squisq-proof-menu[data-theme=dark] .squisq-proof-menu-item {
+  color: #ddd;
+}
+.squisq-proof-menu[data-theme=dark] .squisq-proof-menu-item:hover,
+.squisq-proof-menu[data-theme=dark] .squisq-proof-menu-item:focus-visible {
+  background: #333f52;
+}
+.squisq-proof-menu[data-theme=dark] .squisq-proof-menu-empty {
+  color: #777;
+}
+.squisq-proof-tooltip[data-theme=dark] {
+  background: #262626;
+  border-color: #454545;
+  box-shadow: 0 6px 24px rgba(0, 0, 0, 0.5);
+  color: #ddd;
+}
+.squisq-proof-tooltip[data-theme=dark] .squisq-proof-tooltip-category {
+  color: #aaa;
+}
+.squisq-proof-tooltip[data-theme=dark] .squisq-proof-tooltip-message {
+  color: #eee;
+}
+.squisq-proof-tooltip[data-theme=dark] .squisq-proof-tooltip-chip {
+  background: #333f52;
+  color: #cddcff;
+}
+.squisq-proof-tooltip[data-theme=dark] .squisq-proof-tooltip-chip:hover,
+.squisq-proof-tooltip[data-theme=dark] .squisq-proof-tooltip-chip:focus-visible {
+  background: #3f4e68;
+  border-color: #56688a;
+}
+.squisq-proof-tooltip[data-theme=dark] .squisq-proof-tooltip-more,
+.squisq-proof-tooltip[data-theme=dark] .squisq-proof-tooltip-action {
+  color: #999;
+}
+.squisq-proof-tooltip[data-theme=dark] .squisq-proof-tooltip-more:hover,
+.squisq-proof-tooltip[data-theme=dark] .squisq-proof-tooltip-more:focus-visible,
+.squisq-proof-tooltip[data-theme=dark] .squisq-proof-tooltip-action:hover,
+.squisq-proof-tooltip[data-theme=dark] .squisq-proof-tooltip-action:focus-visible {
+  background: #333;
+  color: #eee;
+}
+.squisq-proof-tooltip[data-theme=dark] .squisq-proof-tooltip-actions {
+  border-top-color: #3a3a3a;
+}
+
 /* src/scene/scene.css */
 .squisq-scene-root {
   position: relative;

package/dist/teleprompter/index.d.ts

@@ -1,8 +1,8 @@
 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-Bk3mdW75.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-Bk3mdW75.js';
+import { o as TeleprompterRecordingDeps, g as NarrationStageHandle, T as TeleprompterController, c as FloatingWindowHandle } from '../useNarrationStage-B6r9Zlq-.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-B6r9Zlq-.js';
 import { NarrationTimingJsonV3, NarrationScript, NarrationAlignment } from '@bendyline/squisq/narration';
 import { ReactNode } from 'react';
 

package/dist/teleprompter/index.js

@@ -1,6 +1,6 @@
 import {
   TeleprompterView
-} from "../chunk-IQFPX2CE.js";
+} from "../chunk-ZZTB6BEQ.js";
 import {
   DEFAULT_TELEPROMPTER_PREFS,
   EYE_LINE_FRACTION,
@@ -31,7 +31,7 @@ import {
   useNarrationStage,
   useTeleprompter,
   vadConfigForSensitivity
-} from "../chunk-OWOKKZAU.js";
+} from "../chunk-IRPOMTYK.js";
 export {
   DEFAULT_TELEPROMPTER_PREFS,
   EYE_LINE_FRACTION,

package/dist/types-B_aHRuSc.d.ts

@@ -0,0 +1,156 @@
+import { ProofFinding, ProofDialect } from '@bendyline/squisq/proof';
+
+/**
+ * The proofing capability contract between an editor host and the shell.
+ *
+ * A host that wants grammar/spellcheck passes a {@link ProofingProvider}
+ * (or a factory) to `EditorShell`'s `proofing` prop — the same
+ * capability-injection semantics as `ffmpegWasm`: absent means the
+ * feature is off, and there is no CDN fallback. The provider surface is
+ * plain data end to end, deliberately free of harper.js types so the
+ * engine stays an optional peer dependency that never appears in this
+ * package's published declarations.
+ */
+
+/** Markup mode for one lint call. */
+type ProofingLanguage = 'plaintext' | 'markdown';
+interface ProofingLintOptions {
+    /** Defaults to `plaintext`. */
+    language?: ProofingLanguage;
+}
+/**
+ * An engine adapter the editor drives. Implementations must serialize
+ * their own engine access (calls may arrive while a previous one is in
+ * flight) and keep `lint` results resolvable by finding id until the
+ * next `lint` call.
+ */
+interface ProofingProvider {
+    /**
+     * Load the engine (module + WASM). Idempotent and safe to call
+     * repeatedly; a rejection is retryable — a later call attempts a
+     * fresh load. All expensive work belongs here, never in construction.
+     */
+    setup(): Promise<void>;
+    /** Lint `text`; finding offsets index into `text` (UTF-16 units). */
+    lint(text: string, options?: ProofingLintOptions): Promise<ProofFinding[]>;
+    /**
+     * Persistently ignore the finding's underlying lint — including any
+     * stacked same-span lints other rules reveal once the first is
+     * suppressed. `findingId` must come from the most recent `lint` call.
+     */
+    ignoreFinding(findingId: string): Promise<void>;
+    /**
+     * Accept one word into the APP-level dictionary — fires the host's
+     * `onDictionaryWord` so it can persist wherever it keeps user
+     * settings. Backs the menu's "Add to dictionary".
+     */
+    addWord(word: string): Promise<void>;
+    /**
+     * Accept words for this session without notifying the host. Used both
+     * to load a document's own word list at setup and to back the menu's
+     * "Add to document word list" (where the DOC's frontmatter, not the
+     * app, is the store of record).
+     */
+    addWords(words: readonly string[]): Promise<void>;
+    /**
+     * Whether app-level additions actually persist — i.e. the host wired
+     * `onDictionaryWord`. When `false`, the editor hides "Add to
+     * dictionary" so a word can never appear to be saved app-wide and
+     * then silently come back. `undefined` (a provider that doesn't
+     * report) is treated as capable.
+     */
+    readonly hasAppDictionary?: boolean;
+    /**
+     * The engine's ignored-findings state as an OPAQUE string — it holds
+     * context hashes as integers above 2^53, so it must never be
+     * JSON-parsed or rebuilt, only stored and handed back verbatim.
+     */
+    exportIgnored(): Promise<string>;
+    /** Merge previously exported ignored-findings state into the engine. */
+    importIgnored(json: string): Promise<void>;
+    /**
+     * Drop all ignored findings. The editor calls this when the engine's
+     * ignore set belongs to a different document than the one about to be
+     * linted — ignores are per-document, but an engine instance may be
+     * shared across documents and shells.
+     */
+    clearIgnored(): Promise<void>;
+    /** Switch English dialect. The caller re-lints afterwards. */
+    setDialect(dialect: ProofDialect): Promise<void>;
+    /** Release engine resources. Further calls reject. */
+    dispose(): void;
+}
+/**
+ * Deferred construction. When the shell receives a factory it creates
+ * the provider on first activation and disposes it on unmount; a host
+ * that passes an instance owns its lifetime (letting one warm engine
+ * survive shell remounts).
+ */
+type ProofingProviderFactory = () => ProofingProvider;
+/** What the `proofing` shell prop accepts. */
+type ProofingCapability = ProofingProvider | ProofingProviderFactory;
+/**
+ * Identifies the document a set of ignored findings belongs to. Hosts
+ * key their storage off whichever field suits them — usually the file
+ * path, falling back to the article id for unsaved buffers.
+ */
+interface ProofingDocumentRef {
+    /** The document's `articleId` (always present; `'untitled'` default). */
+    articleId: string;
+    /** The document's file name / path, when the host supplied one. */
+    fileName?: string;
+}
+/**
+ * Host-owned persistence for dismissed ("Ignore") findings.
+ *
+ * Ignores are deliberately never written into the document — they are
+ * one person's editing preference, and a doc travelling through git
+ * shouldn't carry them. Instead the editor hands the state to the host,
+ * scoped per document, and the host stores it wherever its user data
+ * lives (a settings file, IndexedDB, a per-workspace record keyed by
+ * path…). The payload is the engine's OPAQUE export: store it as a
+ * string, never parse it.
+ *
+ * Omit the store and Ignore still works — it just lasts for the
+ * session, which is often the right behavior for a scratch buffer.
+ */
+interface ProofingIgnoreStore {
+    /** Previously saved state for this document, if any. */
+    load(doc: ProofingDocumentRef): string | undefined | Promise<string | undefined>;
+    /** Persist this document's state. Called after every Ignore. */
+    save(doc: ProofingDocumentRef, ignoredJson: string): void | Promise<void>;
+}
+/** Configuration for {@link createHarperProofingProvider}. */
+interface HarperProofingConfig {
+    /**
+     * Same-origin URL of harper's WASM binary (the host serves
+     * `harper.js/dist/harper_wasm_bg.wasm` itself — see docs/proofing.md).
+     * When omitted, the `harper.js/binary` module default is used, which
+     * relies on the host bundler resolving the WASM as an asset.
+     */
+    wasmUrl?: string;
+    /** Initial dialect (default American). */
+    dialect?: ProofDialect;
+    /** App-level dictionary loaded during setup. */
+    initialWords?: readonly string[];
+    /**
+     * Fired when the user adds a word app-wide — persist it host-side.
+     * Its absence reports `hasAppDictionary: false`, which hides the
+     * "Add to dictionary" menu item.
+     *
+     * Note the asymmetry with ignores: a dictionary word is app-global
+     * (a proper noun is spelled the same everywhere), so it belongs on
+     * the engine's config. Ignores are per-document and go through
+     * `EditorShell`'s `proofingIgnoreStore` instead.
+     */
+    onDictionaryWord?: (word: string) => void;
+    /**
+     * Escape hatch: a preconstructed harper `BinaryModule`. Typed
+     * `unknown` so harper types stay out of published declarations
+     * (Node tests pass `binaryInlined` here — harper's `file://` loader
+     * is broken on Windows).
+     */
+    binary?: unknown;
+}
+
+export type { HarperProofingConfig as H, ProofingCapability as P, ProofingDocumentRef as a, ProofingIgnoreStore as b, ProofingLanguage as c, ProofingLintOptions as d, ProofingProvider as e, ProofingProviderFactory as f };