@web-ppt/editor 0.5.0-beta.2 → 0.5.0

package/dist/adjustments.js

@@ -0,0 +1,300 @@
+import { resolvePresetAdjustmentHandles as m, dragPresetAdjustmentHandle as g } from "@web-ppt/core/geometry/handles";
+import { queryElementPresetGeometry as p, slideOfElement as f, elementFrameToSlidePoint as v, screenToSlidePoint as w, slideToElementFramePoint as E } from "@web-ppt/edit-core";
+const A = 3, d = (c) => c.pointerId ?? 0;
+class b {
+  constructor(t) {
+    this.active = null, this.root = t;
+  }
+  get isActive() {
+    return this.active !== null;
+  }
+  begin(t, e) {
+    var s, n;
+    this.cancel();
+    const r = { x: t.clientX, y: t.clientY };
+    this.active = {
+      pointerId: d(t),
+      startScreen: r,
+      snapshot: {
+        screen: r,
+        altKey: t.altKey,
+        ctrlKey: t.ctrlKey,
+        metaKey: t.metaKey,
+        shiftKey: t.shiftKey
+      },
+      gesture: e,
+      started: !1,
+      frame: null,
+      cursor: this.root.style.cursor
+    };
+    try {
+      (n = (s = this.root).setPointerCapture) == null || n.call(s, d(t));
+    } catch {
+    }
+  }
+  move(t) {
+    var r, s;
+    const e = this.active;
+    if (!(!e || d(t) !== e.pointerId)) {
+      this.updateSnapshot(e, t);
+      try {
+        (s = (r = e.gesture).observePointer) == null || s.call(r, e.snapshot);
+      } catch (n) {
+        throw this.clear(e), n;
+      }
+      if (!e.started) {
+        if (Math.hypot(
+          e.snapshot.screen.x - e.startScreen.x,
+          e.snapshot.screen.y - e.startScreen.y
+        ) < A) return;
+        e.started = !0;
+        try {
+          e.gesture.start();
+        } catch (i) {
+          throw this.clear(e), i;
+        }
+        this.root.style.cursor = e.gesture.cursor, this.root.dataset[e.gesture.dataset.name] = e.gesture.dataset.value;
+      }
+      t.preventDefault(), this.scheduleFrame(e);
+    }
+  }
+  finish(t) {
+    var s, n;
+    const e = this.active;
+    if (!e || d(t) !== e.pointerId) return "ignored";
+    this.updateSnapshot(e, t);
+    let r;
+    try {
+      (n = (s = e.gesture).observePointer) == null || n.call(s, e.snapshot), r = e.started ? e.gesture.finish(e.snapshot) : null;
+    } catch (i) {
+      throw this.clear(e), i;
+    }
+    return this.clear(e), r == null || r(), r && t.preventDefault(), e.started ? "gesture" : "click";
+  }
+  /** 键盘确认使用最后一次指针快照；先清理 capture/rAF，再执行提交，避免订阅回调重入活动手势。 */
+  commit() {
+    const t = this.active;
+    if (!t) return !1;
+    let e = null;
+    try {
+      e = t.started ? t.gesture.finish(t.snapshot) : null;
+    } catch (r) {
+      throw this.clear(t), r;
+    }
+    return this.clear(t), e == null || e(), t.started;
+  }
+  modifier(t) {
+    const e = this.active;
+    return !e || !["Shift", "Alt", "Control", "Meta"].includes(t.key) ? !1 : (e.snapshot = {
+      ...e.snapshot,
+      altKey: t.altKey,
+      ctrlKey: t.ctrlKey,
+      metaKey: t.metaKey,
+      shiftKey: t.shiftKey
+    }, e.started && this.scheduleFrame(e), !0);
+  }
+  cancel() {
+    this.active && this.clear(this.active);
+  }
+  cancelPointer(t) {
+    this.active && d(t) === this.active.pointerId && this.clear(this.active);
+  }
+  updateSnapshot(t, e) {
+    t.snapshot = {
+      screen: { x: e.clientX, y: e.clientY },
+      altKey: e.altKey,
+      ctrlKey: e.ctrlKey,
+      metaKey: e.metaKey,
+      shiftKey: e.shiftKey
+    };
+  }
+  scheduleFrame(t) {
+    if (t.frame !== null) return;
+    const e = this.root.ownerDocument.defaultView;
+    if (!(e != null && e.requestAnimationFrame)) {
+      try {
+        t.gesture.frame(t.snapshot);
+      } catch (r) {
+        throw this.clear(t), r;
+      }
+      return;
+    }
+    t.frame = e.requestAnimationFrame(() => {
+      if (t.frame = null, this.active === t)
+        try {
+          t.gesture.frame(t.snapshot);
+        } catch (r) {
+          throw this.clear(t), r;
+        }
+    });
+  }
+  clear(t) {
+    var r, s;
+    this.active = null;
+    const e = this.root.ownerDocument.defaultView;
+    t.frame !== null && (e != null && e.cancelAnimationFrame) && e.cancelAnimationFrame(t.frame);
+    try {
+      t.started && t.gesture.clear();
+    } finally {
+      this.root.style.cursor = t.cursor, delete this.root.dataset[t.gesture.dataset.name];
+      try {
+        (s = (r = this.root).hasPointerCapture) != null && s.call(r, t.pointerId) && this.root.releasePointerCapture(t.pointerId);
+      } catch {
+      }
+    }
+  }
+}
+const I = "http://www.w3.org/2000/svg";
+function y(c, t) {
+  return c.createElementNS(I, t);
+}
+class P {
+  constructor(t, e, r) {
+    var a;
+    if (this.session = t, this.view = e, this.options = r, this.activeId = null, this.preview = null, this.isDestroyed = !1, this.pointerDown = (o) => {
+      const h = o.target instanceof Element ? o.target.closest("[data-ppt-preset-handle]") : null;
+      if (!(!h || o.button !== 0 || o.isPrimary === !1))
+        try {
+          const u = this.geometry;
+          if (!u) return;
+          this.lifecycle.begin(o, this.gesture(Number(h.dataset.pptPresetHandle), u)), this.stop(o);
+        } catch (u) {
+          this.report(u);
+        }
+    }, this.pointerMove = (o) => {
+      if (this.lifecycle.isActive)
+        try {
+          this.lifecycle.move(o), this.stop(o);
+        } catch (h) {
+          this.report(h);
+        }
+    }, this.pointerUp = (o) => {
+      if (this.lifecycle.isActive)
+        try {
+          this.lifecycle.finish(o), this.stop(o);
+        } catch (h) {
+          this.report(h);
+        }
+    }, this.pointerCancel = (o) => {
+      this.lifecycle.isActive && (this.lifecycle.cancelPointer(o), this.stop(o));
+    }, this.keyDown = (o) => {
+      o.key !== "Escape" || !this.lifecycle.isActive || (this.lifecycle.cancel(), this.stop(o));
+    }, t.disposed || e.destroyed) throw new Error("不能挂载到已释放的编辑视图");
+    this.root = e.element;
+    const s = this.root.querySelector("[data-ppt-stage]"), n = this.root.querySelector('[data-ppt-layer="interaction"]'), i = this.root.querySelector('[data-ppt-layer="static"]');
+    if (!s || !n || !i) throw new Error("编辑视图缺少三层 DOM");
+    this.stage = s, this.layer = n, this.lifecycle = new b(this.root), this.root.addEventListener("pointerdown", this.pointerDown, !0), this.root.addEventListener("pointermove", this.pointerMove, !0), this.root.addEventListener("pointerup", this.pointerUp, !0), this.root.addEventListener("pointercancel", this.pointerCancel, !0), this.root.addEventListener("keydown", this.keyDown, !0), this.unsubscribe = t.editor.subscribe(() => this.render());
+    const l = ((a = this.root.ownerDocument.defaultView) == null ? void 0 : a.MutationObserver) ?? MutationObserver;
+    this.observer = new l(() => this.render()), this.observer.observe(i, { childList: !0 });
+  }
+  get elementId() {
+    return this.activeId;
+  }
+  get geometry() {
+    return !this.activeId || !this.session.editor.doc.elements[this.activeId] ? null : p(this.session.editor.doc, [this.activeId]).value;
+  }
+  get handles() {
+    const t = this.activeId, e = this.preview ?? this.geometry;
+    if (!t || !e) return [];
+    const r = this.session.editor.effectiveElement(t);
+    return m(e, r.w, r.h);
+  }
+  get destroyed() {
+    return this.isDestroyed;
+  }
+  start(t) {
+    this.assertAlive();
+    const e = this.session.editor.selection, r = t ?? (e.kind === "elements" && e.ids.length === 1 ? e.ids[0] : null);
+    return !r || this.view.mode !== "edit" || f(this.session.editor.doc, r) !== this.view.slideId || !p(this.session.editor.doc, [r]).value ? !1 : (this.activeId = r, this.preview = null, this.render(), !0);
+  }
+  end() {
+    var t;
+    this.lifecycle.cancel(), this.activeId = null, this.preview = null, (t = this.group()) == null || t.remove();
+  }
+  setPreset(t) {
+    this.assertAlive();
+    const e = this.session.editor.selection, r = this.activeId ?? (e.kind === "elements" && e.ids.length === 1 ? e.ids[0] : null);
+    if (!r || this.view.mode !== "edit") return !1;
+    try {
+      return this.session.editor.exec({ type: "SetPreset", id: r, preset: t }), this.activeId = r, this.preview = null, this.render(), !0;
+    } catch (s) {
+      return this.report(s), !1;
+    }
+  }
+  refresh() {
+    this.assertAlive(), this.render();
+  }
+  destroy() {
+    var t;
+    this.isDestroyed || (this.isDestroyed = !0, this.lifecycle.cancel(), this.unsubscribe(), this.observer.disconnect(), this.root.removeEventListener("pointerdown", this.pointerDown, !0), this.root.removeEventListener("pointermove", this.pointerMove, !0), this.root.removeEventListener("pointerup", this.pointerUp, !0), this.root.removeEventListener("pointercancel", this.pointerCancel, !0), this.root.removeEventListener("keydown", this.keyDown, !0), (t = this.group()) == null || t.remove(), this.activeId = null, this.preview = null);
+  }
+  assertAlive() {
+    if (this.isDestroyed || this.session.disposed || this.view.destroyed)
+      throw new Error("预设调节柄扩展已经释放");
+  }
+  group() {
+    return this.layer.querySelector("[data-ppt-preset-adjustments]");
+  }
+  render() {
+    var r;
+    (r = this.group()) == null || r.remove();
+    const t = this.activeId;
+    if (!t || this.isDestroyed || this.view.destroyed || this.view.mode !== "edit" || !this.session.editor.doc.elements[t] || f(this.session.editor.doc, t) !== this.view.slideId) return;
+    const e = y(this.layer.ownerDocument, "g");
+    e.dataset.pptPresetAdjustments = "", e.dataset.pptPresetElement = t;
+    for (const s of this.handles) {
+      const n = v(this.session.editor.doc, t, s), i = y(this.layer.ownerDocument, "circle");
+      i.dataset.pptPresetHandle = String(s.index), i.dataset.pptPresetKind = s.kind, i.setAttribute("cx", String(n.x)), i.setAttribute("cy", String(n.y)), i.setAttribute("r", String(6 / this.view.zoom)), i.setAttribute("fill", "#f59e0b"), i.setAttribute("stroke", "#fff"), i.setAttribute("stroke-width", String(2 / this.view.zoom)), i.style.pointerEvents = "all", i.style.cursor = "crosshair", e.append(i);
+    }
+    this.layer.append(e);
+  }
+  geometryAt(t, e, r) {
+    const s = this.activeId, n = this.stage.getBoundingClientRect(), i = w(t.screen, {
+      left: n.left,
+      top: n.top,
+      zoom: this.view.zoom
+    }), l = E(this.session.editor.doc, s, i), a = this.session.editor.effectiveElement(s);
+    return g(r, a.w, a.h, e, l);
+  }
+  gesture(t, e) {
+    let r = e;
+    const s = (n) => {
+      r = this.geometryAt(n, t, e), this.preview = r, this.render();
+    };
+    return {
+      cursor: "crosshair",
+      dataset: { name: "pptPresetDragging", value: String(t) },
+      start: () => {
+      },
+      frame: s,
+      finish: (n) => {
+        s(n);
+        const i = this.activeId, l = Object.entries(r.adj).filter(([a, o]) => e.adj[a] !== o);
+        return l.length ? () => {
+          this.preview = null, this.session.editor.transaction((a) => {
+            for (const [o, h] of l)
+              a.exec({ type: "SetAdj", id: i, name: o, value: h });
+          }, "拖动预设调节柄");
+        } : null;
+      },
+      clear: () => {
+        this.preview = null, this.render();
+      }
+    };
+  }
+  stop(t) {
+    t.preventDefault(), t.stopImmediatePropagation();
+  }
+  report(t) {
+    var e, r;
+    this.lifecycle.cancel(), (r = (e = this.options).onError) == null || r.call(e, t), this.options.onError || queueMicrotask(() => {
+      throw t;
+    });
+  }
+}
+function D(c, t, e = {}) {
+  return new P(c, t, e);
+}
+export {
+  D as createPresetAdjustmentEditor
+};

package/dist/canvas-accessibility.d.ts

@@ -0,0 +1,6 @@
+import type { EditorSession } from './session';
+import type { SlideEditor } from './slide-editor-types';
+/** 产品可在挂载后启用；不使用辅助对象目录的宿主不承担其模型遍历与 DOM 成本。 */
+export declare function createCanvasAccessibility(session: EditorSession, view: SlideEditor): {
+    dispose(): void;
+};

package/dist/chart/index.d.ts

@@ -0,0 +1,2 @@
+export { createChartDataEditor, listEditableCharts, queryChartData, } from '@web-ppt/edit-core/chart';
+export type { ChartCategory, ChartDataBinding, ChartDataEditor, ChartDataset, ChartFormulaBinding, ChartPlotKind, ChartPoint, ChartPointId, ChartSeries, ChartSeriesId, EditableChart, } from '@web-ppt/edit-core/chart';

package/dist/chart-shared/index.d.ts

@@ -0,0 +1,2 @@
+export { registerSharedChartEditing, createChartDataEditor, listEditableCharts, queryChartData, } from '@web-ppt/edit-core/chart-shared';
+export type { ChartCategory, ChartDataBinding, ChartDataEditor, ChartDataset, ChartFormulaBinding, ChartPlotKind, ChartPoint, ChartPointId, ChartSeries, ChartSeriesId, EditableChart, } from '@web-ppt/edit-core/chart-shared';

package/dist/chart-shared.js

@@ -0,0 +1,7 @@
+import { createChartDataEditor as a, listEditableCharts as e, queryChartData as i, registerSharedChartEditing as h } from "@web-ppt/edit-core/chart-shared";
+export {
+  a as createChartDataEditor,
+  e as listEditableCharts,
+  i as queryChartData,
+  h as registerSharedChartEditing
+};

package/dist/chart.js

@@ -0,0 +1,6 @@
+import { createChartDataEditor as r, listEditableCharts as e, queryChartData as h } from "@web-ppt/edit-core/chart";
+export {
+  r as createChartDataEditor,
+  e as listEditableCharts,
+  h as queryChartData
+};

package/dist/common-object-slide-commands.d.ts

@@ -0,0 +1,20 @@
+import type { AddSectionCommand, DistributeElementsCommand, Editor, ElementAltTextState, ElementId, SectionId, SectionRecord, SetAltTextCommand, SetSlideSizeCommand, SlideSizeState } from '@web-ppt/edit-core';
+/** 挂载视图与 headless adapter 共享同一套公共命令语义。 */
+export declare class CommonObjectSlideCommands {
+    private readonly editor;
+    constructor(editor: Editor);
+    distribute(enabled: boolean, axis: DistributeElementsCommand['axis'], ids?: readonly ElementId[]): boolean;
+    queryAltText(id?: ElementId): ElementAltTextState | null;
+    setAltText(enabled: boolean, value: Pick<SetAltTextCommand, 'title' | 'descr'>, id?: ElementId): boolean;
+    listSections(): SectionRecord[];
+    addSection(enabled: boolean, value: Omit<AddSectionCommand, 'type'>): SectionRecord | null;
+    renameSection(enabled: boolean, id: SectionId, name: string): boolean;
+    moveSection(enabled: boolean, id: SectionId, after: SectionId | null): boolean;
+    removeSection(enabled: boolean, id: SectionId): boolean;
+    querySlideSize(): SlideSizeState;
+    setSlideSize(enabled: boolean, value: Pick<SetSlideSizeCommand, 'w' | 'h' | 'fit'>): boolean;
+    private writable;
+    private exec;
+    private selectedElementId;
+}
+export declare function commonObjectSlideCommands(editor: Editor): CommonObjectSlideCommands;

package/dist/design/index.d.ts

@@ -0,0 +1,3 @@
+export { createDesignEditor } from '../design-editor';
+export type { DesignEditor, DesignEditorOptions } from '../design-editor-types';
+export { listLayouts, listMasters, queryLayout, queryMaster, toDesignCanvas, } from '@web-ppt/edit-core';

package/dist/design-editor-types.d.ts

@@ -0,0 +1,15 @@
+import type { DesignCommand, DesignTarget, TransactionResult } from '@web-ppt/edit-core';
+export interface DesignEditorOptions {
+    readonly target: DesignTarget;
+    readonly textMode?: 'auto' | 'html' | 'svg';
+}
+/** 版式 DOM 适配器只暴露设计目标命令，不混入页序、备注或动画入口。 */
+export interface DesignEditor {
+    readonly element: HTMLDivElement;
+    readonly target: DesignTarget;
+    readonly destroyed: boolean;
+    setTarget(target: DesignTarget): void;
+    exec(...commands: DesignCommand[]): TransactionResult;
+    render(): void;
+    destroy(): void;
+}

package/dist/design-editor.d.ts

@@ -0,0 +1,3 @@
+import type { DesignEditor, DesignEditorOptions } from './design-editor-types';
+import type { EditorSession } from './session';
+export declare function createDesignEditor(container: HTMLElement, session: EditorSession, options: DesignEditorOptions): DesignEditor;

package/dist/design.js

@@ -0,0 +1,108 @@
+import { renderSlideToSvg as u } from "@web-ppt/core";
+import { foreignObjectScalesCorrectly as f } from "@web-ppt/viewer-core";
+import { listLayouts as x, listMasters as T, queryLayout as M, queryMaster as b, toDesignCanvas as $ } from "@web-ppt/edit-core";
+function h(s, e) {
+  const t = [], r = (d) => {
+    for (const i of d) {
+      t.push(i);
+      const n = s.elements[i];
+      n && n.meta.editable !== "frame" && n.children && r(n.children);
+    }
+  };
+  return r(e), t;
+}
+function c(s, e) {
+  return [...s.nodeType === 1 && s.matches(e) ? [s] : [], ...s.querySelectorAll(e)];
+}
+function m(s, e, t) {
+  return c(s, "[data-edit-id]").find((r) => r.dataset[e] === t) ?? null;
+}
+function l(s, e, t) {
+  var d;
+  const r = c(s, "[data-el]");
+  if (r.length !== t.length) throw new Error("渲染节点与编辑投影的元素数量不一致");
+  r.forEach((i, n) => {
+    const o = t[n];
+    if (o === null) return;
+    const a = e.elements[o].src.id;
+    if ((a === void 0 ? "" : String(a)) !== i.dataset.el)
+      throw new Error(`渲染节点与编辑投影的顺序不一致：${o}`);
+    i.dataset.editId = o;
+  });
+  for (const i of t) {
+    if (i === null) continue;
+    const n = m(s, "editId", i);
+    if (!n) throw new Error(`渲染结果缺少编辑元素：${i}`);
+    const o = ((d = n.parentElement) == null ? void 0 : d.localName) === "a" ? n.parentElement : n;
+    o.dataset.editRoot = i;
+  }
+  for (const i of s.querySelectorAll("[data-r]"))
+    i.dataset.pptSearchR = i.dataset.r, delete i.dataset.r, i.dataset.from !== void 0 && (i.dataset.pptSearchFrom = i.dataset.from, delete i.dataset.from), i.dataset.to !== void 0 && (i.dataset.pptSearchTo = i.dataset.to, delete i.dataset.to);
+}
+function p(s, e, t) {
+  if (t.kind === "master") {
+    const i = e.masters[t.id];
+    if (!i) throw new Error(`找不到母版设计目标：${t.id}`);
+    l(s, e, h(e, i.children));
+    return;
+  }
+  const r = e.layouts[t.id];
+  if (!r) throw new Error(`找不到版式设计目标：${t.id}`);
+  const d = r.showMasterShapes === !1 ? void 0 : e.masters[r.origin.masterPart];
+  l(s, e, h(e, [
+    ...(d == null ? void 0 : d.children) ?? [],
+    ...r.children
+  ]));
+}
+let g = 0;
+class w {
+  constructor(e, t, r) {
+    if (this.session = t, this.isDestroyed = !1, t.disposed) throw new Error("不能挂载已经释放的编辑会话");
+    this.currentTarget = structuredClone(r.target), t.editor.toDesignCanvas(this.currentTarget), this.idPrefix = `${t.editor.doc.identity.prefix}design-view-${++g}-`, this.presentation = t.toPresentation(), this.textMode = r.textMode === "svg" || r.textMode === "html" ? r.textMode : f(e.ownerDocument) ? "html" : "svg", this.element = e.ownerDocument.createElement("div"), this.element.dataset.pptDesignEditor = this.currentTarget.kind, this.element.style.position = "relative", this.element.style.width = "100%", this.element.style.height = "100%", e.append(this.element), this.unsubscribe = t.editor.subscribe((d) => this.update(d)), this.render();
+  }
+  get target() {
+    return structuredClone(this.currentTarget);
+  }
+  get destroyed() {
+    return this.isDestroyed;
+  }
+  setTarget(e) {
+    this.assertAlive(), this.session.editor.toDesignCanvas(e), this.currentTarget = structuredClone(e), this.element.dataset.pptDesignEditor = e.kind, this.render();
+  }
+  exec(...e) {
+    return this.assertAlive(), this.session.editor.execDesign(this.currentTarget, ...e);
+  }
+  render() {
+    this.assertAlive(), this.element.innerHTML = u(
+      this.presentation,
+      this.session.editor.toDesignCanvas(this.currentTarget),
+      {
+        textMode: this.textMode,
+        idPrefix: `${this.idPrefix}${this.currentTarget.id}-`,
+        includeEditMarkers: !0
+      }
+    ), p(this.element, this.session.editor.doc, this.currentTarget);
+  }
+  destroy() {
+    this.isDestroyed || (this.isDestroyed = !0, this.unsubscribe(), this.element.remove());
+  }
+  assertAlive() {
+    if (this.isDestroyed || this.session.disposed) throw new Error("设计视图已经销毁");
+  }
+  update(e) {
+    if (e.source === "selection") return;
+    const t = this.session.editor.doc;
+    this.presentation.width = t.meta.width, this.presentation.height = t.meta.height, (e.createdSlides.size || e.removedSlides.size || e.movedSlides.size) && (this.presentation.slides = t.slideOrder.map((r) => this.session.editor.toSlide(r))), this.render();
+  }
+}
+function D(s, e, t) {
+  return new w(s, e, t);
+}
+export {
+  D as createDesignEditor,
+  x as listLayouts,
+  T as listMasters,
+  M as queryLayout,
+  b as queryMaster,
+  $ as toDesignCanvas
+};

package/dist/dom-identity.d.ts

@@ -1,9 +1,10 @@
-import type { EditDoc, ElementId, SlideId } from '@web-ppt/edit-core';
+import type { DesignTarget, EditDoc, ElementId, SlideId } from '@web-ppt/edit-core';
 export declare function elementIds(doc: EditDoc, roots: readonly ElementId[]): ElementId[];
 export declare function bindElementIdentities(root: ParentNode, doc: EditDoc, roots: readonly ElementId[]): void;
 /** 结构壳尚未挂孩子时只绑定容器本身，孩子沿用原分区身份。 */
 export declare function bindSingleElementIdentity(root: ParentNode, doc: EditDoc, id: ElementId): void;
 export declare function bindSlideIdentities(root: ParentNode, doc: EditDoc, slideId: SlideId): void;
+export declare function bindDesignIdentities(root: ParentNode, doc: EditDoc, target: DesignTarget): void;
 export declare function findElementPartition(root: ParentNode, id: ElementId): SVGElement | null;
 /**
  * visibility 会被后代的 visible 覆盖；显示元素时必须删除声明，让祖先隐藏继续继承。

package/dist/edit-context/geometry.d.ts

@@ -0,0 +1,8 @@
+import type { TextBody } from '@web-ppt/core';
+import type { NativeTextFormat } from './native';
+export declare function textRange(root: HTMLElement, text: TextBody, from: number, to: number): Range | null;
+export declare function textBounds(root: HTMLElement, text: TextBody, from: number, to: number): DOMRect;
+export declare function compositionDecoration(root: HTMLElement): {
+    update(text: TextBody, formats: readonly NativeTextFormat[]): void;
+    dispose(): void;
+};

package/dist/edit-context/index.d.ts

@@ -0,0 +1,8 @@
+import type { EditorSession } from '../session';
+import type { SlideEditor } from '../slide-editor-types';
+export interface EditContextEnhancement {
+    readonly supported: boolean;
+    dispose(): void;
+}
+/** 仅替换浏览器输入适配；格式、历史、IME 合并与协同重基仍经过既有文字控制器。 */
+export declare function enableEditContext(session: EditorSession, view: SlideEditor): EditContextEnhancement;

package/dist/edit-context/native.d.ts

@@ -0,0 +1,33 @@
+export interface NativeEditContext extends EventTarget {
+    readonly text: string;
+    readonly selectionStart: number;
+    readonly selectionEnd: number;
+    updateText(start: number, end: number, text: string): void;
+    updateSelection(start: number, end: number): void;
+    updateControlBounds(bounds: DOMRect): void;
+    updateSelectionBounds(bounds: DOMRect): void;
+    updateCharacterBounds(start: number, bounds: DOMRect[]): void;
+}
+export interface NativeTextUpdate extends Event {
+    readonly updateRangeStart: number;
+    readonly updateRangeEnd: number;
+    readonly text: string;
+    readonly selectionStart: number;
+    readonly selectionEnd: number;
+}
+export interface NativeTextFormat {
+    readonly rangeStart: number;
+    readonly rangeEnd: number;
+    readonly underlineStyle: string;
+    readonly underlineThickness: string;
+}
+export type EditContextWindow = Window & typeof globalThis & {
+    EditContext?: new (options: {
+        text: string;
+        selectionStart: number;
+        selectionEnd: number;
+    }) => NativeEditContext;
+};
+export type EditingHost = HTMLDivElement & {
+    editContext: NativeEditContext | null;
+};