smartrte-react 0.3.5 → 1.0.0-beta.10

package/dist/theme.js

@@ -18,8 +18,8 @@ export const SRTE_DEFAULT_CSS = `
   --srte-input-border: var(--srte-border);
   --srte-modal-backdrop: rgba(0, 0, 0, 0.35);
   --srte-modal-backdrop-filter: blur(2px);
-  --srte-modal-bg: #ffffff;
-  --srte-modal-text: #000000;
+  --srte-modal-bg: var(--card, #ffffff);
+  --srte-modal-text: var(--foreground, #000000);
   --srte-menu-bg: var(--srte-background);
   --srte-menu-text: var(--srte-foreground);
   --srte-menu-shadow: 0 8px 24px rgba(0, 0, 0, 0.18);
@@ -27,7 +27,11 @@ export const SRTE_DEFAULT_CSS = `
   --srte-accent-bg: rgba(2, 132, 199, 0.12);
   --srte-danger: #dc2626;
   --srte-primary: #2563eb;
-  --srte-surface-subtle: #f3f4f6;
+  /* --srte-primary on --srte-accent-bg measures 4.43:1, under WCAG AA's
+     4.5:1 for normal text - used only for the pressed toolbar-button state
+     (see .srte-tool-button[aria-pressed="true"]), not a replacement for
+     --srte-primary generally. */
+  --srte-primary-pressed: #1d4ed8;
   --srte-on-primary: #ffffff;
   --srte-cancel-bg: #f3f4f6;
   --srte-code-bg: #f6f8fa;
@@ -51,8 +55,8 @@ export const SRTE_DEFAULT_CSS = `
   --srte-input-border: var(--srte-border);
   --srte-modal-backdrop: rgba(0, 0, 0, 0.22);
   --srte-modal-backdrop-filter: blur(10px) saturate(0.9);
-  --srte-modal-bg: #1e293b;
-  --srte-modal-text: #e0e0e0;
+  --srte-modal-bg: var(--card, #1e293b);
+  --srte-modal-text: var(--foreground, #e0e0e0);
   --srte-menu-bg: var(--srte-background);
   --srte-menu-text: var(--srte-foreground);
   --srte-menu-shadow: 0 8px 24px rgba(0, 0, 0, 0.4);
@@ -60,7 +64,7 @@ export const SRTE_DEFAULT_CSS = `
   --srte-accent-bg: rgba(56, 189, 248, 0.16);
   --srte-danger: #ef4444;
   --srte-primary: #3b82f6;
-  --srte-surface-subtle: #333333;
+  --srte-primary-pressed: var(--srte-primary);
   --srte-on-primary: #ffffff;
   --srte-cancel-bg: #333333;
   --srte-code-bg: #111827;
@@ -71,6 +75,18 @@ export const SRTE_DEFAULT_CSS = `
   font-family: "IBM Plex Sans", ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
   container: srte-editor / inline-size;
 }
+.srte-canonical-authority > .srte-editor[contenteditable] {
+  width: 100%;
+  padding: 16px 20px;
+  box-sizing: border-box;
+  border: 1px solid var(--srte-border);
+  border-radius: 0 0 var(--srte-radius) var(--srte-radius);
+  outline: none;
+  background: var(--srte-canvas);
+  color: var(--srte-foreground);
+  caret-color: var(--srte-foreground);
+  line-height: 1.6;
+}
 .srte-toolbar {
   display: flex;
   flex-wrap: wrap;
@@ -134,7 +150,12 @@ export const SRTE_DEFAULT_CSS = `
 }
 .srte-tool-button.srte-active,
 .srte-tool-button[aria-pressed="true"] {
-  color: var(--srte-primary);
+  /* var(--srte-primary) (#2563eb) on var(--srte-accent-bg) measured 4.43:1,
+     just under WCAG AA's 4.5:1 for normal text (axe-core, Phase 11 Tier 3) -
+     a dedicated, darker pressed-state color keeps the same hue family
+     while clearing the threshold, without changing --srte-primary's other,
+     already-compliant usages (e.g. against solid backgrounds). */
+  color: var(--srte-primary-pressed);
   background: var(--srte-accent-bg);
   border-color: color-mix(in srgb, var(--srte-primary) 35%, transparent);
 }
@@ -173,6 +194,20 @@ export const SRTE_DEFAULT_CSS = `
   color: var(--srte-menu-text);
   box-shadow: var(--srte-menu-shadow);
 }
+/*
+ * ToolbarDropdown's own menu panel (docs/bugs/
+ * toolbar-dropdown-clipped-by-host-overflow-hidden.md): position:fixed with
+ * JS-measured left/top (ToolbarPrimitives.tsx) instead of the default
+ * position:absolute above, so it always escapes an ancestor host container's
+ * own overflow:hidden regardless of DOM depth - MobileMoreMenu's overflow
+ * menu (no data-srte-menu-fixed attribute) is unaffected and keeps its
+ * existing position:absolute/right-anchored behavior.
+ */
+.srte-menu[data-srte-menu-fixed="true"] {
+  position: fixed;
+  top: 0;
+  left: 0;
+}
 .srte-menu-item {
   display: flex;
   align-items: center;
@@ -241,6 +276,56 @@ export const SRTE_DEFAULT_CSS = `
 .srte-editor [contenteditable] ol[data-srte-list-preset="ordered-decimal-paren"][data-srte-list-depth="3"] > li::marker {
   content: counter(list-item, lower-roman) ")  ";
 }
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-decimal"][data-srte-list-depth="0"] > li::marker {
+  content: counter(list-item, decimal) ".  ";
+}
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-decimal"][data-srte-list-depth="1"] > li::marker {
+  content: counter(list-item, lower-alpha) ".  ";
+}
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-decimal"][data-srte-list-depth="2"] > li::marker,
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-decimal"][data-srte-list-depth="3"] > li::marker {
+  content: counter(list-item, lower-roman) ".  ";
+}
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-upper-alpha"][data-srte-list-depth="0"] > li::marker {
+  content: counter(list-item, upper-alpha) ".  ";
+}
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-upper-alpha"][data-srte-list-depth="1"] > li::marker {
+  content: counter(list-item, lower-alpha) ".  ";
+}
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-upper-alpha"][data-srte-list-depth="2"] > li::marker,
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-upper-alpha"][data-srte-list-depth="3"] > li::marker {
+  content: counter(list-item, lower-roman) ".  ";
+}
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-upper-roman"][data-srte-list-depth="0"] > li::marker {
+  content: counter(list-item, upper-roman) ".  ";
+}
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-upper-roman"][data-srte-list-depth="1"] > li::marker {
+  content: counter(list-item, upper-alpha) ".  ";
+}
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-upper-roman"][data-srte-list-depth="2"] > li::marker,
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-upper-roman"][data-srte-list-depth="3"] > li::marker {
+  content: counter(list-item, decimal) ".  ";
+}
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-leading-zero"][data-srte-list-depth="0"] > li::marker {
+  content: counter(list-item, decimal-leading-zero) ".  ";
+}
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-leading-zero"][data-srte-list-depth="1"] > li::marker {
+  content: counter(list-item, lower-alpha) ".  ";
+}
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-leading-zero"][data-srte-list-depth="2"] > li::marker,
+.srte-editor [contenteditable] ol[data-srte-list-preset="ordered-leading-zero"][data-srte-list-depth="3"] > li::marker {
+  content: counter(list-item, lower-roman) ".  ";
+}
+.srte-editor [contenteditable] ul[data-srte-list-preset="bullet-disc"][data-srte-list-depth="0"] > li::marker {
+  content: "●  ";
+}
+.srte-editor [contenteditable] ul[data-srte-list-preset="bullet-disc"][data-srte-list-depth="1"] > li::marker {
+  content: "○  ";
+}
+.srte-editor [contenteditable] ul[data-srte-list-preset="bullet-disc"][data-srte-list-depth="2"] > li::marker,
+.srte-editor [contenteditable] ul[data-srte-list-preset="bullet-disc"][data-srte-list-depth="3"] > li::marker {
+  content: "■  ";
+}
 .srte-editor [contenteditable] ol[data-srte-list-preset="ordered-outline"] > li::marker {
   content: counters(list-item, ".") ".  ";
 }
@@ -267,11 +352,26 @@ export const SRTE_DEFAULT_CSS = `
   justify-content: center;
   width: 1.1em;
   height: 1.6em;
+  min-width: 0;
+  box-sizing: border-box;
+  padding: 0;
+  border: 0;
+  border-radius: 0;
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  cursor: pointer;
+  appearance: none;
+  outline: none;
   margin: 0;
   line-height: 1.6;
   vertical-align: top;
   position: relative;
 }
+.srte-editor [contenteditable] ul[data-srte-checklist="true"] > li > [data-srte-check]:focus-visible {
+  outline: 2px solid var(--srte-ring);
+  outline-offset: 2px;
+}
 .srte-editor [contenteditable] ul[data-srte-checklist="true"] > li > [data-srte-check]::before {
   content: "";
   width: .9em;
@@ -307,34 +407,32 @@ export const SRTE_DEFAULT_CSS = `
   border-color: var(--srte-ring) !important;
   box-shadow: 0 0 0 2px color-mix(in srgb, var(--srte-ring) 18%, transparent);
 }
-@media (max-width: 639px) {
-  .srte-toolbar { gap: 3px; padding: 6px; }
-  .srte-tool-button, .srte-toolbar select { height: 40px; min-width: 40px; }
-  .srte-toolbar-group[data-srte-priority="3"] { display: none; }
-  .srte-toolbar-menu[data-srte-priority="2"] { display: none; }
-  .srte-mobile-more { display: block; }
-  .srte-mobile-more .srte-menu {
-    left: auto;
-    right: 0;
-    width: min(280px, calc(100vw - 16px));
-    min-width: 0;
-    max-height: min(70dvh, 480px);
-    overflow-x: hidden;
-    overflow-y: auto;
-    overscroll-behavior: contain;
-    -webkit-overflow-scrolling: touch;
-  }
-  .srte-menu-item { height: 40px; }
-}
+/*
+ * @container (element width), not @media (viewport width): a host can embed
+ * the editor at any fraction of the browser window - a split pane next to a
+ * preview panel is the case that surfaced this (docs/bugs/
+ * toolbar-wide-promotion-fires-on-viewport-width-not-container-width.md). A
+ * plain @media breakpoint here would fire based on the *window*, wrongly
+ * switching tiers for an editor instance that's actually much narrower (or
+ * wider) than the window - .srte-editor already establishes its own
+ * container: srte-editor / inline-size (see the .srte-editor rule above),
+ * so @container always reflects this specific instance's real rendered width regardless of host
+ * layout, with no @media fallback needed (container queries have full
+ * support across this project's three target engines).
+ */
 @container srte-editor (max-width: 639px) {
   .srte-toolbar { gap: 3px; padding: 6px; }
   .srte-tool-button, .srte-toolbar select { height: 40px; min-width: 40px; }
   .srte-toolbar-group[data-srte-priority="3"],
   .srte-toolbar-menu[data-srte-priority="2"] { display: none; }
   .srte-mobile-more { display: block; }
+  /* left/top are no longer set here - ToolbarPrimitives.tsx now computes
+     them via inline style (JS-measured, position:fixed, viewport-clamped;
+     see MobileMoreMenu's own doc comment), which always wins over any
+     value set here regardless of specificity or source order. Sizing/
+     scroll behavior stays defined here since inline positioning doesn't
+     touch those properties. */
   .srte-mobile-more .srte-menu {
-    left: auto;
-    right: 0;
     width: min(280px, calc(100vw - 16px));
     min-width: 0;
     max-height: min(70dvh, 480px);
@@ -345,11 +443,61 @@ export const SRTE_DEFAULT_CSS = `
   }
   .srte-menu-item { height: 40px; }
 }
+/*
+ * Wide-viewport promotion (docs/bugs/toolbar-priority-collapse-fixed-threshold-no-wide-promotion.md):
+ * below this, the single 639px breakpoint above was this system's ONLY
+ * threshold - every dropdown-grouped tool stayed hidden inside its dropdown
+ * at every width from 640px up to and past a 2200px+ desktop, since nothing
+ * ever measured or scaled with the extra room. A handful of tools frequent
+ * enough to matter once there's genuinely spare room (Superscript,
+ * Subscript, Text colour, Background colour, Font size, Font family, Remove
+ * link, Insert formula, Special characters) get a standalone always-visible
+ * ToolbarButton copy (data-srte-wide-promote, rendered directly in the
+ * toolbar row) that appears past this breakpoint, while their existing
+ * dropdown/mobile-menu ToolbarMenuItem copy (the exact same
+ * data-srte-wide-promote attribute, on the .srte-menu-item element instead)
+ * hides so the tool isn't offered twice. Below this breakpoint - including
+ * all of mobile AND the 640-1439px tablet/typical-laptop band, which keeps
+ * today's grouped-dropdown layout unchanged - the standalone copy stays
+ * hidden and the dropdown copy is what's reachable.
+ *
+ * 1440px, not 1280px: Playwright's own default test viewport is exactly
+ * 1280x720, and the vast majority of this suite's toolbar interactions run
+ * at that default without ever calling page.setViewportSize - a 1280px
+ * threshold would have flipped nearly every existing toolbar test's
+ * dropdown-item locators (role=menuitem) over to CSS display:none out from
+ * under them. 1440px clears that default with room to spare while still
+ * comfortably covering "wide desktop" (the ~2264px width the original
+ * report was filed against).
+ *
+ * @container only, no @media fallback - same reasoning as the mobile tier
+ * above (docs/bugs/toolbar-wide-promotion-fires-on-viewport-width-not-container-width.md):
+ * a plain @media(min-width:1440px) fired whenever the *browser window* was
+ * wide, even when this editor instance was embedded in a much narrower
+ * split pane - promoting 9 extra buttons into a group with no room for
+ * them, which squeezed/overlapped the group's existing buttons instead of
+ * wrapping cleanly.
+ */
+.srte-tool-button[data-srte-wide-promote="true"] { display: none; }
+@container srte-editor (min-width: 1440px) {
+  .srte-tool-button[data-srte-wide-promote="true"] { display: inline-flex; }
+  .srte-menu-item[data-srte-wide-promote="true"] { display: none; }
+}
 .srte-editor [contenteditable] blockquote {
   border-left: 4px solid var(--srte-accent);
   margin: 0.75em 0;
   padding: 0.5em 1em;
-  background: var(--srte-surface-subtle);
+  /* --srte-muted, not the retired --srte-surface-subtle (docs/bugs/
+     srte-surface-subtle-not-host-theme-aware.md): every other neutral
+     surface/text token here (--srte-background, --srte-foreground,
+     --srte-muted, --srte-border) is defined as var(--host-token, fallback)
+     so it correctly follows a host's OWN light/dark state even if
+     .srte-dark never gets applied for some host-side wiring reason -
+     --srte-surface-subtle was the one exception, a bare hardcoded hex with
+     no host integration, which is exactly what let a real host (dark mode,
+     .srte-dark not reaching this editor instance) render this blockquote
+     with a light-mode background and dark-mode text simultaneously. */
+  background: var(--srte-muted);
   color: var(--srte-text);
 }
 .srte-editor [contenteditable] p,
@@ -419,8 +567,16 @@ export const SRTE_DEFAULT_CSS = `
   border: 1px solid var(--srte-border);
   vertical-align: top;
 }
+.srte-editor [contenteditable] [data-smart-cell-selected="true"] {
+  background: color-mix(in srgb, var(--srte-primary) 12%, var(--srte-canvas));
+  box-shadow: inset 0 0 0 2px color-mix(in srgb, var(--srte-primary) 65%, transparent);
+}
+.srte-editor [contenteditable][data-smart-cell-selection-active] ::selection {
+  background: transparent;
+  color: inherit;
+}
 .srte-editor [contenteditable] th {
-  background: var(--srte-surface-subtle);
+  background: var(--srte-muted);
   font-weight: 600;
   text-align: left;
 }
@@ -481,6 +637,39 @@ export const SRTE_DEFAULT_CSS = `
 .srte-editor [contenteditable] sup {
   line-height: 0;
 }
+/*
+ * A page break has no native visual meaning in a continuously-scrolling
+ * web editor - its entire purpose is what happens at export/print time
+ * (see atom/formats.ts's atomToHtml doc comment). This gives it a clearly
+ * distinct live-editor appearance from the plain solid <hr> a horizontal
+ * line renders as by default, so the two are never confused: a dashed
+ * line with an explicit "Page break" label, per the feature's own design
+ * decision.
+ */
+.srte-editor [contenteditable] [data-smart-type="page_break"] {
+  display: block;
+  position: relative;
+  height: 0;
+  margin: 1.5em 0;
+  border: none;
+  border-top: 2px dashed var(--srte-border);
+  cursor: default;
+}
+.srte-editor [contenteditable] [data-smart-type="page_break"]::after {
+  content: "Page break";
+  position: absolute;
+  top: -0.7em;
+  left: 50%;
+  transform: translateX(-50%);
+  background: var(--srte-canvas);
+  padding: 0 0.6em;
+  font-size: 11px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--srte-text-muted);
+  white-space: nowrap;
+}
 `;
 const SRTE_STYLE_ID = 'srte-theme-defaults';
 export function ensureStyleSheet() {

package/dist/toolbarTools.d.ts

@@ -0,0 +1,95 @@
+/**
+ * A named, per-tool toolbar-visibility toggle - "developers should be able
+ * to hide tools they don't want their users to see" (e.g. Version History,
+ * Review, Video, Audio), without wrapping/overriding the component or
+ * patching it with CSS. This is a UI-visibility layer, distinct from and
+ * composed with (never replacing) two existing, deeper mechanisms:
+ *
+ * - `EditorCapabilityPreset` (capabilityPresets.ts) controls real document
+ *   *capability* - which plugins the schema itself is built with (today,
+ *   only `table`). Excluding a plugin there already, correctly, hides its
+ *   toolbar entry (`tablesEnabled`) - this file does not duplicate that.
+ * - Provider presence (`mediaProvider`, `versionProvider`, `commentProvider`,
+ *   `suggestionProvider`) already gates whether a feature can function at
+ *   all. `tools` never turns a tool ON when its required provider is
+ *   absent - see `resolveToolbarTools`'s own doc comment.
+ *
+ * `tools` is for the remaining, larger set of toolbar entries that have no
+ * other on/off mechanism at all today (Bold, Italic, Video, Audio, Special
+ * characters, Version history, ...) - a host that wants to hide any of
+ * these previously had no supported way to do so.
+ *
+ * Deliberately NOT covered by individual keys (scoping decision, not an
+ * oversight): purely contextual actions that only ever act on something
+ * already selected - block move/indent, list-item indent/move/restart
+ * numbering, table row/column/cell operations, and the selected-media
+ * edit/resize/delete actions. None of these have independent product
+ * meaning (there is no real case for "let people insert a table but hide
+ * its 'Add row' action") - they stay governed solely by their owning
+ * top-level tool (`insertTable`, `bulletedList`/`numberedList`/`checklist`,
+ * `link`, `image`/`video`/`audio`).
+ */
+export interface ToolbarTools {
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+    strikethrough: boolean;
+    code: boolean;
+    superscript: boolean;
+    subscript: boolean;
+    textColor: boolean;
+    backgroundColor: boolean;
+    fontSize: boolean;
+    fontFamily: boolean;
+    /** The Paragraph/Heading 1-6/Code block <select>. */
+    blockType: boolean;
+    alignLeft: boolean;
+    alignCenter: boolean;
+    alignRight: boolean;
+    alignJustify: boolean;
+    /** The line-spacing dropdown (1/1.15/1.5/2/2.5 presets plus a custom value). */
+    lineHeight: boolean;
+    quote: boolean;
+    bulletedList: boolean;
+    numberedList: boolean;
+    checklist: boolean;
+    /** The named multi-level marker preset picker (decimal/alpha/roman/outline/bullet-glyph) - independent of the plain list-type toggles above. */
+    listPreset: boolean;
+    link: boolean;
+    removeLink: boolean;
+    /** Requires `mediaProvider` to actually render - see resolveToolbarTools. */
+    image: boolean;
+    /** Requires `mediaProvider` to actually render - see resolveToolbarTools. */
+    video: boolean;
+    /** Requires `mediaProvider` to actually render - see resolveToolbarTools. */
+    audio: boolean;
+    insertFormula: boolean;
+    specialCharacters: boolean;
+    /** Inserts a `divider` atom (a horizontal rule) - see docs/bugs/ for the toolbar-tools feature this was added alongside. */
+    horizontalLine: boolean;
+    /** Inserts a `page_break` atom - a print/export pagination marker, distinct from `horizontalLine`. */
+    pageBreak: boolean;
+    /** Requires the schema to actually have the table plugin (EditorCapabilityPreset) - see resolveToolbarTools. */
+    insertTable: boolean;
+    import: boolean;
+    saveAsHtml: boolean;
+    saveAsMarkdown: boolean;
+    saveAsWord: boolean;
+    saveAsPdf: boolean;
+    saveAsSmartRte: boolean;
+    /** Requires `versionProvider` to actually render. */
+    versionHistory: boolean;
+    /** Bundles "Add comment" and the Comments panel toggle - requires `commentProvider` to actually render. */
+    comments: boolean;
+    /** Bundles Suggest insertion/deletion/removal, the Suggestions panel toggle, and "Show edits" (track changes) - requires `suggestionProvider` to actually render. */
+    suggestions: boolean;
+    undo: boolean;
+    redo: boolean;
+}
+/** Every tool defaults to visible - an existing consumer who never passes `tools` sees 100% unchanged behavior. */
+export declare const DEFAULT_TOOLBAR_TOOLS: ToolbarTools;
+/**
+ * Merges a host's partial `tools` override onto the all-enabled default -
+ * a host only ever needs to name the tools they want OFF.
+ */
+export declare const resolveToolbarTools: (tools?: Partial<ToolbarTools>) => ToolbarTools;

package/dist/toolbarTools.js

@@ -0,0 +1,17 @@
+/** Every tool defaults to visible - an existing consumer who never passes `tools` sees 100% unchanged behavior. */
+export const DEFAULT_TOOLBAR_TOOLS = {
+    bold: true, italic: true, underline: true, strikethrough: true, code: true,
+    superscript: true, subscript: true, textColor: true, backgroundColor: true, fontSize: true, fontFamily: true,
+    blockType: true, alignLeft: true, alignCenter: true, alignRight: true, alignJustify: true, lineHeight: true, quote: true,
+    bulletedList: true, numberedList: true, checklist: true, listPreset: true,
+    link: true, removeLink: true, image: true, video: true, audio: true, insertFormula: true, specialCharacters: true,
+    horizontalLine: true, pageBreak: true, insertTable: true,
+    import: true, saveAsHtml: true, saveAsMarkdown: true, saveAsWord: true, saveAsPdf: true, saveAsSmartRte: true,
+    versionHistory: true, comments: true, suggestions: true,
+    undo: true, redo: true,
+};
+/**
+ * Merges a host's partial `tools` override onto the all-enabled default -
+ * a host only ever needs to name the tools they want OFF.
+ */
+export const resolveToolbarTools = (tools) => ({ ...DEFAULT_TOOLBAR_TOOLS, ...tools });

package/dist/versionProvider.d.ts

@@ -0,0 +1,29 @@
+import type { DocumentVersion } from "smartrte-core/foundation";
+/**
+ * The listing-cheap projection of a `DocumentVersion` - a host's backend
+ * shouldn't have to ship every saved version's full document body just to
+ * render a history list. Mirrors `MediaProvider.search` returning
+ * `MediaItem` (metadata) rather than raw asset bytes.
+ */
+export interface VersionListEntry {
+    readonly id: string;
+    readonly label?: string;
+    readonly createdAt: number;
+    readonly authorId?: string;
+}
+/**
+ * Host-owned version-storage boundary, mirroring `MediaProvider`'s shape
+ * and its "the editor never persists anything itself" contract: the host
+ * backend is the source of truth, and `save`/`list`/`load`/`remove` are
+ * the entire boundary. There is deliberately no shipped default
+ * implementation, exactly like `MediaProvider` - when a host doesn't
+ * supply one, the version-history feature is simply unavailable, the same
+ * way the media toolbar buttons are disabled when `mediaProvider` is
+ * absent.
+ */
+export interface VersionProvider {
+    save(version: DocumentVersion): Promise<VersionListEntry>;
+    list(): Promise<readonly VersionListEntry[]>;
+    load(id: string): Promise<DocumentVersion>;
+    remove(id: string): Promise<void>;
+}

package/dist/versionProvider.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,15 +1,26 @@
 {
   "name": "smartrte-react",
-  "version": "0.3.5",
+  "version": "1.0.0-beta.10",
   "description": "A powerful, feature-rich Rich Text Editor for React with support for tables, mathematical formulas (LaTeX/KaTeX), and media management",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./standalone/classic-editor-embed": {
+      "types": "./dist/standalone/classic-editor-embed.d.ts",
+      "import": "./dist/standalone/classic-editor-embed.js"
+    }
+  },
   "files": [
     "dist",
     "!dist/**/*.test.js",
     "!dist/**/*.test.d.ts",
+    "!dist/test-harness/**",
     "README.md",
     "CHANGELOG.md"
   ],
@@ -41,16 +52,6 @@
   },
   "author": "Smart RTE Contributors",
   "license": "MIT",
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "prepublishOnly": "npm run build",
-    "dev": "pnpm build",
-    "lint": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run --passWithNoTests",
-    "storybook": "storybook dev -p 6006",
-    "build-storybook": "storybook build",
-    "e2e": "playwright test --pass-with-no-tests"
-  },
   "publishConfig": {
     "access": "public"
   },
@@ -60,16 +61,18 @@
     "react-dom": ">=18"
   },
   "devDependencies": {
+    "@axe-core/playwright": "^4.12.1",
     "@playwright/test": "^1.48.2",
     "@storybook/addon-essentials": "^8.6.14",
     "@storybook/react": "^8.6.14",
     "@storybook/react-vite": "^8.6.14",
+    "@types/node": "^22",
     "@types/pdfjs-dist": "^2.10.377",
     "@types/react": "^18.3.4",
     "@types/react-dom": "^18.3.0",
+    "jsdom": "^25.0.1",
     "react": "18.3.1",
     "react-dom": "18.3.1",
-    "jsdom": "^25.0.1",
     "storybook": "^8.6.14",
     "typescript": "^5.6.2",
     "vite": "^5.4.8",
@@ -77,8 +80,19 @@
   },
   "dependencies": {
     "jszip": "^3.10.1",
+    "katex": "^0.18.4",
+    "lucide-react": "^1.35.0",
     "mammoth": "^1.11.0",
     "pdfjs-dist": "^5.4.530",
-    "smartrte-core": "^0.2.1"
+    "smartrte-core": "^1.0.0-beta.5"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json",
+    "dev": "pnpm build",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build",
+    "e2e": "pnpm --filter smartrte-core build && pnpm build && playwright test --pass-with-no-tests"
   }
-}
+}

package/dist/adapters/canonicalInlineCommandBridge.d.ts

@@ -1,15 +0,0 @@
-import { inlineToolDeclarations, type Attrs, type SmartMark } from "smartrte-core";
-export type CanonicalInlineToolId = typeof inlineToolDeclarations[number]["id"];
-export type CanonicalInlineIntent = "apply" | "remove" | "toggle" | "setAttrs" | "clearAll" | "editLink";
-export interface CanonicalInlineExecution {
-    readonly changed: boolean;
-    readonly operations: number;
-    readonly coverage: "all" | "partial" | "none";
-}
-export declare const executeCanonicalInlineTool: (root: HTMLElement, id: CanonicalInlineToolId, intent?: CanonicalInlineIntent, attrs?: Attrs) => CanonicalInlineExecution;
-/** Consumes adapter stored marks for ordinary text input. Composition remains
- * owned by the canonical surface; atom-aware composition is explicitly Phase 7. */
-export declare const installCanonicalInlineStoredMarkInput: (root: HTMLElement) => (() => void);
-export declare const canonicalInlineStoredMarks: (root: HTMLElement) => readonly SmartMark[];
-export declare const hasCanonicalInlineStoredMarkOverride: (root: HTMLElement) => boolean;
-export declare const describeCanonicalInlineCoverage: (root: HTMLElement) => Readonly<Record<string, "all" | "partial">>;