@ai-matrx/office 0.3.1 → 0.5.2

package/dist/docs-tools.js

@@ -0,0 +1,217 @@
+import {
+  markdownToUniverDoc
+} from "./chunk-PI473GES.js";
+import {
+  PX_PER_INCH
+} from "./chunk-MPKXXZZV.js";
+
+// src/docs/doc-tools-core.ts
+var BUILDING_BLOCKS = [
+  { id: "meeting-notes", label: "Meeting notes", description: "Date, attendees, agenda, decisions and action items.", markdown: "## Meeting notes\n\nDate: \nAttendees: \n\n### Agenda\n\n1. \n\n### Discussion\n\n### Decisions\n\n### Action items\n\n\u2610 Owner: Task, due date\n" },
+  { id: "project-tracker", label: "Project tracker", description: "Goal, milestones, owners, risks and status.", markdown: "## Project tracker\n\nGoal: \nOwner: \nStatus: On track\n\n### Milestones\n\n\u2610 Milestone, owner, due date\n\n### Risks\n\n### Next steps\n" },
+  { id: "email-draft", label: "Email draft", description: "To, subject and a three-part message ready to fill in.", markdown: "## Email draft\n\nTo: \nSubject: \n\nHi ,\n\nI am writing about .\n\nThe next step is .\n\nThanks,\n" },
+  { id: "weekly-status", label: "Weekly status", description: "Done, next, and blocked, for one week.", markdown: "## Weekly status\n\nWeek of: \n\n### Done this week\n\n### Next week\n\n### Blocked\n" },
+  { id: "decision-log", label: "Decision record", description: "Context, options, decision and consequences.", markdown: "## Decision record\n\nDate: \nDecider: \n\n### Context\n\n### Options considered\n\n### Decision\n\n### Consequences\n" },
+  { id: "pros-cons", label: "Pros and cons", description: "A side-by-side weighing of one choice.", markdown: "## Pros and cons\n\nChoice: \n\n### Pros\n\n### Cons\n\n### Verdict\n" }
+];
+function insertableBody(markdown) {
+  const body = markdownToUniverDoc(markdown).body ?? { dataStream: "" };
+  let stream = body.dataStream;
+  if (stream.endsWith("\n")) stream = stream.slice(0, -1);
+  const paragraphs = (body.paragraphs ?? []).filter((p) => p.startIndex < stream.length);
+  const textRuns = (body.textRuns ?? []).filter((r) => r.st < stream.length).map((r) => ({ ...r, ed: Math.min(r.ed, stream.length) }));
+  return { dataStream: stream, paragraphs, ...textRuns.length ? { textRuns } : {} };
+}
+function blockInsertPlan(dataStream, caret) {
+  const c = Math.max(0, Math.min(caret, dataStream.length));
+  const start = Math.max(dataStream.lastIndexOf("\r", c - 1), dataStream.lastIndexOf("\n", c - 1)) + 1;
+  let end = dataStream.indexOf("\r", c);
+  if (end < 0) end = dataStream.length;
+  const text = dataStream.slice(start, end).replace(/[\u0000-\u001f\u200b]/g, "").trim();
+  if (c === start || text === "") return { at: start, breakAt: null };
+  return { at: end + 1, breakAt: end };
+}
+var BOOKMARK_RANGE_TYPE = 3;
+var BOOKMARK_ANCHOR = "\u200B";
+function collectBookmarks(snapshot) {
+  const body = snapshot?.body;
+  const out = [];
+  for (const r of body?.customRanges ?? []) {
+    if (r.rangeType !== BOOKMARK_RANGE_TYPE) continue;
+    out.push({ id: r.rangeId, name: typeof r.properties?.name === "string" ? r.properties.name : "", offset: r.startIndex });
+  }
+  return out.sort((a, b) => a.offset - b.offset);
+}
+function bookmarkBody(id, name) {
+  return {
+    dataStream: BOOKMARK_ANCHOR,
+    customRanges: [{ startIndex: 0, endIndex: 0, rangeId: id, rangeType: BOOKMARK_RANGE_TYPE, properties: { name }, wholeEntity: true }]
+  };
+}
+function cleanBookmarkName(raw, existing) {
+  const name = raw.replace(/\s+/g, " ").trim().slice(0, 80);
+  if (!name) return { ok: false, why: "Give the bookmark a name." };
+  if (existing.some((b) => b.name.toLowerCase() === name.toLowerCase())) return { ok: false, why: `A bookmark named "${name}" already exists.` };
+  return { ok: true, name };
+}
+function bookmarkFromHash(hash) {
+  const m = /^#bookmark=(.+)$/.exec(hash);
+  if (!m) return null;
+  try {
+    return decodeURIComponent(m[1]);
+  } catch {
+    return null;
+  }
+}
+var bookmarkHash = (name) => `#bookmark=${encodeURIComponent(name)}`;
+var DASH = { solid: 1, dotted: 2, dashed: 3 };
+function paragraphBorderParams(c) {
+  const line = { color: { rgb: c.color }, width: c.width, dashStyle: DASH[c.dash], padding: c.padding };
+  return {
+    borderTop: c.side === "top" || c.side === "both" ? line : null,
+    borderBottom: c.side === "bottom" || c.side === "both" ? line : null
+  };
+}
+function rulerGeometry(a) {
+  const pageWidth = a.pageWidthPx * a.zoom;
+  const pageLeft = Math.max(0, (a.containerWidth - pageWidth) / 2);
+  const ticks = [];
+  const inches = a.pageWidthPx / PX_PER_INCH;
+  for (let eighth = 0; eighth <= Math.floor(inches * 8); eighth++) {
+    const x = pageLeft + eighth * PX_PER_INCH * a.zoom / 8;
+    if (eighth % 8 === 0) {
+      const marginInches = a.marginLeftPx / PX_PER_INCH;
+      ticks.push({ x, kind: "inch", ...eighth / 8 !== marginInches ? { label: String(Math.round(Math.abs(eighth / 8 - marginInches))) } : {} });
+    } else ticks.push({ x, kind: eighth % 4 === 0 ? "half" : "eighth" });
+  }
+  return { pageLeft, pageWidth, marginLeft: a.marginLeftPx * a.zoom, marginRight: a.marginRightPx * a.zoom, ticks };
+}
+var DOCUMENT_LANGUAGE_KEY = "matrxLanguage";
+var DOCUMENT_LANGUAGES = [
+  { code: "en-US", label: "English (United States)" },
+  { code: "en-GB", label: "English (United Kingdom)" },
+  { code: "es", label: "Spanish" },
+  { code: "fr", label: "French" },
+  { code: "de", label: "German" },
+  { code: "it", label: "Italian" },
+  { code: "pt-BR", label: "Portuguese (Brazil)" },
+  { code: "nl", label: "Dutch" },
+  { code: "ja", label: "Japanese" },
+  { code: "ko", label: "Korean" },
+  { code: "zh-CN", label: "Chinese (Simplified)" },
+  { code: "ar", label: "Arabic" },
+  { code: "hi", label: "Hindi" },
+  { code: "ru", label: "Russian" }
+];
+function readDocumentLanguage(documentStyle) {
+  const v = documentStyle?.[DOCUMENT_LANGUAGE_KEY];
+  return typeof v === "string" && DOCUMENT_LANGUAGES.some((l) => l.code === v) ? v : "en-US";
+}
+
+// src/docs/doc-edit-ops.ts
+function createDocEditOps(deps) {
+  const doc = () => deps.api()?.getActiveDocument?.() ?? null;
+  const snapshot = () => doc()?.save?.() ?? null;
+  const range = async () => {
+    const { DocSelectionManagerService } = await import("@univerjs/docs");
+    const live = deps.injector()?.get(DocSelectionManagerService)?.getActiveTextRange?.();
+    return live ?? null;
+  };
+  const exec = async (id, params) => await deps.api()?.executeCommand(id, params) !== false;
+  const toBlockStart = async () => {
+    const d = doc();
+    const r = await range();
+    const stream = snapshot()?.body?.dataStream;
+    if (!d || !r || typeof stream !== "string") return false;
+    const plan = blockInsertPlan(stream, r.startOffset);
+    if (plan.breakAt === null) {
+      d.setSelection?.(plan.at, plan.at);
+      return true;
+    }
+    d.setSelection?.(plan.breakAt, plan.breakAt);
+    return exec("doc.command.break-line", { unitId: d.getId() });
+  };
+  return {
+    snapshot,
+    async insertText(text) {
+      if (!text || !await range()) return false;
+      return exec("doc.command.insert-special-character", { value: text });
+    },
+    toBlockStart,
+    async insertMarkdown(markdown) {
+      const d = doc();
+      if (!d || !await toBlockStart()) return false;
+      return exec("doc.command.replace-selection", { unitId: d.getId(), body: insertableBody(markdown) });
+    },
+    bookmarks: () => collectBookmarks(snapshot()),
+    async addBookmark(name) {
+      const d = doc();
+      const r = await range();
+      if (!d || !r) return false;
+      d.setSelection?.(r.startOffset, r.startOffset);
+      const id = `bm_${Math.random().toString(36).slice(2, 10)}`;
+      return exec("doc.command.replace-selection", { unitId: d.getId(), body: bookmarkBody(id, name) });
+    },
+    async deleteBookmark(b) {
+      const d = doc();
+      if (!d) return false;
+      d.setSelection?.(b.offset + 1, b.offset + 1);
+      return exec("doc.command.delete-left", { unitId: d.getId() });
+    },
+    async setViewOnly(viewOnly) {
+      const perm = doc()?.getPermission?.();
+      if (!perm) return;
+      if (viewOnly) await perm.setReadOnly();
+      else await perm.setEditable(true);
+      const { IPermissionService } = await import("@univerjs/core");
+      deps.injector()?.get(IPermissionService)?.setShowComponents?.(!viewOnly);
+    },
+    async onEditDenied(cb) {
+      const { ErrorService } = await import("@univerjs/core");
+      const errors = deps.injector()?.get(ErrorService);
+      const sub = errors?.error$?.subscribe((e) => {
+        if (e.code === "PERMISSION_DENIED") cb();
+      });
+      return () => sub?.unsubscribe();
+    },
+    async openImagePanel() {
+      return exec("sidebar.operation.doc-image", { value: "doc-image" });
+    },
+    goTo(offset) {
+      doc()?.setSelection?.(offset, offset);
+    }
+  };
+}
+async function writeDocumentStyleKey(api, key, value) {
+  const doc = api.getActiveDocument?.();
+  if (!doc) return;
+  const style = doc.getDocumentDataModel?.()?.getSnapshot().documentStyle ?? {};
+  const old = style[key];
+  if (old === value) return;
+  const { JSONX } = await import("@univerjs/core");
+  const jsonX = JSONX.getInstance();
+  const path = ["documentStyle", key];
+  const action = old === void 0 ? jsonX.insertOp(path, value) : jsonX.replaceOp(path, old, value);
+  if (!action) return;
+  await api.executeCommand("doc.mutation.rich-text-editing", { unitId: doc.getId(), actions: action, textRanges: void 0 });
+}
+export {
+  BOOKMARK_ANCHOR,
+  BOOKMARK_RANGE_TYPE,
+  BUILDING_BLOCKS,
+  DOCUMENT_LANGUAGES,
+  DOCUMENT_LANGUAGE_KEY,
+  blockInsertPlan,
+  bookmarkBody,
+  bookmarkFromHash,
+  bookmarkHash,
+  cleanBookmarkName,
+  collectBookmarks,
+  createDocEditOps,
+  insertableBody,
+  paragraphBorderParams,
+  readDocumentLanguage,
+  rulerGeometry,
+  writeDocumentStyleKey
+};
+//# sourceMappingURL=docs-tools.js.map

package/dist/docs-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/docs/doc-tools-core.ts","../src/docs/doc-edit-ops.ts"],"sourcesContent":["/**\n * The pure half of the Docs tools: building blocks, bookmarks, paragraph borders, the ruler's\n * geometry and the document language. No Univer import, so each is proven on plain snapshots.\n */\n\nimport { PX_PER_INCH } from \"../core\";\nimport { markdownToUniverDoc } from \"./markdown-to-univer-doc\";\n\nexport interface BuildingBlock {\n  id: string;\n  label: string;\n  description: string;\n  markdown: string;\n}\n\nexport const BUILDING_BLOCKS: BuildingBlock[] = [\n  { id: \"meeting-notes\", label: \"Meeting notes\", description: \"Date, attendees, agenda, decisions and action items.\", markdown: \"## Meeting notes\\n\\nDate: \\nAttendees: \\n\\n### Agenda\\n\\n1. \\n\\n### Discussion\\n\\n### Decisions\\n\\n### Action items\\n\\n☐ Owner: Task, due date\\n\" },\n  { id: \"project-tracker\", label: \"Project tracker\", description: \"Goal, milestones, owners, risks and status.\", markdown: \"## Project tracker\\n\\nGoal: \\nOwner: \\nStatus: On track\\n\\n### Milestones\\n\\n☐ Milestone, owner, due date\\n\\n### Risks\\n\\n### Next steps\\n\" },\n  { id: \"email-draft\", label: \"Email draft\", description: \"To, subject and a three-part message ready to fill in.\", markdown: \"## Email draft\\n\\nTo: \\nSubject: \\n\\nHi ,\\n\\nI am writing about .\\n\\nThe next step is .\\n\\nThanks,\\n\" },\n  { id: \"weekly-status\", label: \"Weekly status\", description: \"Done, next, and blocked, for one week.\", markdown: \"## Weekly status\\n\\nWeek of: \\n\\n### Done this week\\n\\n### Next week\\n\\n### Blocked\\n\" },\n  { id: \"decision-log\", label: \"Decision record\", description: \"Context, options, decision and consequences.\", markdown: \"## Decision record\\n\\nDate: \\nDecider: \\n\\n### Context\\n\\n### Options considered\\n\\n### Decision\\n\\n### Consequences\\n\" },\n  { id: \"pros-cons\", label: \"Pros and cons\", description: \"A side-by-side weighing of one choice.\", markdown: \"## Pros and cons\\n\\nChoice: \\n\\n### Pros\\n\\n### Cons\\n\\n### Verdict\\n\" },\n];\n\nexport interface InsertableBody {\n  dataStream: string;\n  paragraphs: Array<{ startIndex: number; paragraphStyle?: Record<string, unknown> }>;\n  textRuns?: Array<{ st: number; ed: number; ts?: Record<string, unknown> }>;\n}\n\n/** Markdown to a body Univer can insert at the caret: the document-closing `\\n` is dropped. */\nexport function insertableBody(markdown: string): InsertableBody {\n  const body = (markdownToUniverDoc(markdown).body ?? { dataStream: \"\" }) as unknown as Partial<InsertableBody> & { dataStream: string };\n  let stream = body.dataStream;\n  if (stream.endsWith(\"\\n\")) stream = stream.slice(0, -1);\n  const paragraphs = (body.paragraphs ?? []).filter((p) => p.startIndex < stream.length);\n  const textRuns = (body.textRuns ?? []).filter((r) => r.st < stream.length).map((r) => ({ ...r, ed: Math.min(r.ed, stream.length) }));\n  return { dataStream: stream, paragraphs, ...(textRuns.length ? { textRuns } : {}) };\n}\n\n/**\n * Where a BLOCK (table of contents, building block) goes for a caret: never inside a paragraph's\n * text, so a heading is never split. Caret at the start of a paragraph (or in an empty one) →\n * insert right there; anywhere else → end the caret's paragraph with a new line and insert at the\n * start of that new paragraph. `dataStream` is Univer's body stream (paragraphs end in `\\r`).\n */\nexport function blockInsertPlan(dataStream: string, caret: number): { at: number; breakAt: number | null } {\n  const c = Math.max(0, Math.min(caret, dataStream.length));\n  const start = Math.max(dataStream.lastIndexOf(\"\\r\", c - 1), dataStream.lastIndexOf(\"\\n\", c - 1)) + 1;\n  let end = dataStream.indexOf(\"\\r\", c);\n  if (end < 0) end = dataStream.length;\n  // Field marks and anchors are zero-width: a paragraph holding only them is empty.\n  const text = dataStream.slice(start, end).replace(/[\\u0000-\\u001f\\u200b]/g, \"\").trim();\n  if (c === start || text === \"\") return { at: start, breakAt: null };\n  return { at: end + 1, breakAt: end };\n}\n\n/** Univer's CustomRangeType.BOOKMARK. */\nexport const BOOKMARK_RANGE_TYPE = 3;\n/** A bookmark is an invisible anchor: one zero-width character the custom range wraps. */\nexport const BOOKMARK_ANCHOR = \"​\";\n\nexport interface Bookmark {\n  id: string;\n  name: string;\n  offset: number;\n}\n\ninterface BodyWithRanges {\n  customRanges?: Array<{ rangeId: string; rangeType: number; startIndex: number; properties?: { name?: unknown } }>;\n}\n\nexport function collectBookmarks(snapshot: unknown): Bookmark[] {\n  const body = (snapshot as { body?: BodyWithRanges } | null)?.body;\n  const out: Bookmark[] = [];\n  for (const r of body?.customRanges ?? []) {\n    if (r.rangeType !== BOOKMARK_RANGE_TYPE) continue;\n    out.push({ id: r.rangeId, name: typeof r.properties?.name === \"string\" ? r.properties.name : \"\", offset: r.startIndex });\n  }\n  return out.sort((a, b) => a.offset - b.offset);\n}\n\nexport function bookmarkBody(id: string, name: string) {\n  return {\n    dataStream: BOOKMARK_ANCHOR,\n    customRanges: [{ startIndex: 0, endIndex: 0, rangeId: id, rangeType: BOOKMARK_RANGE_TYPE, properties: { name }, wholeEntity: true }],\n  };\n}\n\nexport function cleanBookmarkName(raw: string, existing: readonly Bookmark[]): { ok: true; name: string } | { ok: false; why: string } {\n  const name = raw.replace(/\\s+/g, \" \").trim().slice(0, 80);\n  if (!name) return { ok: false, why: \"Give the bookmark a name.\" };\n  if (existing.some((b) => b.name.toLowerCase() === name.toLowerCase())) return { ok: false, why: `A bookmark named \"${name}\" already exists.` };\n  return { ok: true, name };\n}\n\n/** `#bookmark=<name>` in the page address names a bookmark to jump to on open. */\nexport function bookmarkFromHash(hash: string): string | null {\n  const m = /^#bookmark=(.+)$/.exec(hash);\n  if (!m) return null;\n  try {\n    return decodeURIComponent(m[1]!);\n  } catch {\n    return null;\n  }\n}\nexport const bookmarkHash = (name: string) => `#bookmark=${encodeURIComponent(name)}`;\n\nexport type BorderSide = \"top\" | \"bottom\" | \"both\" | \"none\";\nexport type BorderDash = \"solid\" | \"dashed\" | \"dotted\";\n/** Univer's DashStyleType values. */\nconst DASH: Record<BorderDash, number> = { solid: 1, dotted: 2, dashed: 3 };\n\nexport interface BorderChoice {\n  side: BorderSide;\n  color: string;\n  width: number;\n  dash: BorderDash;\n  padding: number;\n}\n\n/** The `paragraph` argument of `doc-paragraph-setting.command` for a choice (Univer draws top and bottom paragraph borders). */\nexport function paragraphBorderParams(c: BorderChoice): Record<string, unknown> {\n  const line = { color: { rgb: c.color }, width: c.width, dashStyle: DASH[c.dash], padding: c.padding };\n  return {\n    borderTop: c.side === \"top\" || c.side === \"both\" ? line : null,\n    borderBottom: c.side === \"bottom\" || c.side === \"both\" ? line : null,\n  };\n}\n\nexport interface RulerGeometry {\n  pageLeft: number;\n  pageWidth: number;\n  marginLeft: number;\n  marginRight: number;\n  ticks: Array<{ x: number; kind: \"inch\" | \"half\" | \"eighth\"; label?: string }>;\n}\n\n/** The ruler above the page: inch ticks from the page's left edge (margins shaded), at the current zoom. */\nexport function rulerGeometry(a: { containerWidth: number; zoom: number; pageWidthPx: number; marginLeftPx: number; marginRightPx: number }): RulerGeometry {\n  const pageWidth = a.pageWidthPx * a.zoom;\n  const pageLeft = Math.max(0, (a.containerWidth - pageWidth) / 2);\n  const ticks: RulerGeometry[\"ticks\"] = [];\n  const inches = a.pageWidthPx / PX_PER_INCH;\n  for (let eighth = 0; eighth <= Math.floor(inches * 8); eighth++) {\n    const x = pageLeft + (eighth * PX_PER_INCH * a.zoom) / 8;\n    if (eighth % 8 === 0) {\n      const marginInches = a.marginLeftPx / PX_PER_INCH;\n      ticks.push({ x, kind: \"inch\", ...(eighth / 8 !== marginInches ? { label: String(Math.round(Math.abs(eighth / 8 - marginInches))) } : {}) });\n    } else ticks.push({ x, kind: eighth % 4 === 0 ? \"half\" : \"eighth\" });\n  }\n  return { pageLeft, pageWidth, marginLeft: a.marginLeftPx * a.zoom, marginRight: a.marginRightPx * a.zoom, ticks };\n}\n\n/** The key on the document style that carries the language (the slot the paper colour also uses). */\nexport const DOCUMENT_LANGUAGE_KEY = \"matrxLanguage\";\nexport const DOCUMENT_LANGUAGES: Array<{ code: string; label: string }> = [\n  { code: \"en-US\", label: \"English (United States)\" },\n  { code: \"en-GB\", label: \"English (United Kingdom)\" },\n  { code: \"es\", label: \"Spanish\" },\n  { code: \"fr\", label: \"French\" },\n  { code: \"de\", label: \"German\" },\n  { code: \"it\", label: \"Italian\" },\n  { code: \"pt-BR\", label: \"Portuguese (Brazil)\" },\n  { code: \"nl\", label: \"Dutch\" },\n  { code: \"ja\", label: \"Japanese\" },\n  { code: \"ko\", label: \"Korean\" },\n  { code: \"zh-CN\", label: \"Chinese (Simplified)\" },\n  { code: \"ar\", label: \"Arabic\" },\n  { code: \"hi\", label: \"Hindi\" },\n  { code: \"ru\", label: \"Russian\" },\n];\n\nexport function readDocumentLanguage(documentStyle: unknown): string {\n  const v = (documentStyle as Record<string, unknown> | undefined)?.[DOCUMENT_LANGUAGE_KEY];\n  return typeof v === \"string\" && DOCUMENT_LANGUAGES.some((l) => l.code === v) ? v : \"en-US\";\n}\n","/**\n * The Univer-facing half of the Docs tools: insert text, markdown and bookmarks at the caret, move\n * the selection, read the live snapshot, set view-only. Every operation is a real Univer command.\n */\n\nimport { blockInsertPlan, bookmarkBody, collectBookmarks, insertableBody, type Bookmark } from \"./doc-tools-core\";\n\ninterface ApiLike {\n  executeCommand(id: string, params?: object): Promise<unknown> | unknown;\n  getActiveDocument?(): {\n    getId(): string;\n    save?(): unknown;\n    setSelection?(a: number, b: number): void;\n    getPermission?(): { setReadOnly(): Promise<void>; setEditable(editable?: boolean): Promise<void> };\n  } | null;\n}\ninterface InjectorLike {\n  get<T>(token: unknown): T | undefined;\n}\ninterface TextRangeLike {\n  startOffset: number;\n  endOffset: number;\n}\n\nexport interface DocEditOps {\n  insertText(text: string): Promise<boolean>;\n  /** A block (building block) at a new paragraph, never mid-line. */\n  insertMarkdown(markdown: string): Promise<boolean>;\n  /** Move the caret to where a block goes (`blockInsertPlan`); false when there is no caret. */\n  toBlockStart(): Promise<boolean>;\n  bookmarks(): Bookmark[];\n  addBookmark(name: string): Promise<boolean>;\n  deleteBookmark(b: Bookmark): Promise<boolean>;\n  goTo(offset: number): void;\n  snapshot(): unknown;\n  setViewOnly(viewOnly: boolean): Promise<void>;\n  /** Calls back when Univer refuses an edit (Viewing mode); returns the unsubscribe. */\n  onEditDenied(cb: () => void): Promise<() => void>;\n  openImagePanel(): Promise<boolean>;\n}\n\nexport function createDocEditOps(deps: { api: () => ApiLike | null; injector: () => InjectorLike | null }): DocEditOps {\n  const doc = () => deps.api()?.getActiveDocument?.() ?? null;\n  const snapshot = () => doc()?.save?.() ?? null;\n  const range = async (): Promise<TextRangeLike | null> => {\n    const { DocSelectionManagerService } = await import(\"@univerjs/docs\");\n    const live = deps.injector()?.get<{ getActiveTextRange?(): TextRangeLike | null | undefined }>(DocSelectionManagerService)?.getActiveTextRange?.();\n    return live ?? null;\n  };\n  const exec = async (id: string, params: object) => (await deps.api()?.executeCommand(id, params)) !== false;\n  const toBlockStart = async (): Promise<boolean> => {\n    const d = doc();\n    const r = await range();\n    const stream = (snapshot() as { body?: { dataStream?: string } } | null)?.body?.dataStream;\n    if (!d || !r || typeof stream !== \"string\") return false;\n    const plan = blockInsertPlan(stream, r.startOffset);\n    if (plan.breakAt === null) {\n      d.setSelection?.(plan.at, plan.at);\n      return true;\n    }\n    d.setSelection?.(plan.breakAt, plan.breakAt);\n    return exec(\"doc.command.break-line\", { unitId: d.getId() });\n  };\n\n  return {\n    snapshot,\n    async insertText(text) {\n      if (!text || !(await range())) return false;\n      return exec(\"doc.command.insert-special-character\", { value: text });\n    },\n    toBlockStart,\n    async insertMarkdown(markdown) {\n      const d = doc();\n      if (!d || !(await toBlockStart())) return false;\n      return exec(\"doc.command.replace-selection\", { unitId: d.getId(), body: insertableBody(markdown) });\n    },\n    bookmarks: () => collectBookmarks(snapshot()),\n    async addBookmark(name) {\n      const d = doc();\n      const r = await range();\n      if (!d || !r) return false;\n      d.setSelection?.(r.startOffset, r.startOffset);\n      const id = `bm_${Math.random().toString(36).slice(2, 10)}`;\n      return exec(\"doc.command.replace-selection\", { unitId: d.getId(), body: bookmarkBody(id, name) });\n    },\n    async deleteBookmark(b) {\n      const d = doc();\n      if (!d) return false;\n      d.setSelection?.(b.offset + 1, b.offset + 1);\n      return exec(\"doc.command.delete-left\", { unitId: d.getId() });\n    },\n    async setViewOnly(viewOnly) {\n      const perm = doc()?.getPermission?.();\n      if (!perm) return;\n      if (viewOnly) await perm.setReadOnly();\n      else await perm.setEditable(true);\n      // Univer's own refusal notice (\"This content is protected…\") stays off while viewing; the\n      // editor shows ours through onEditDenied.\n      const { IPermissionService } = await import(\"@univerjs/core\");\n      deps.injector()?.get<{ setShowComponents?(show: boolean): void }>(IPermissionService)?.setShowComponents?.(!viewOnly);\n    },\n    async onEditDenied(cb) {\n      const { ErrorService } = await import(\"@univerjs/core\");\n      const errors = deps.injector()?.get<{ error$?: { subscribe(fn: (e: { code?: string }) => void): { unsubscribe(): void } } }>(ErrorService);\n      const sub = errors?.error$?.subscribe((e) => {\n        if (e.code === \"PERMISSION_DENIED\") cb();\n      });\n      return () => sub?.unsubscribe();\n    },\n    async openImagePanel() {\n      return exec(\"sidebar.operation.doc-image\", { value: \"doc-image\" });\n    },\n    goTo(offset) {\n      doc()?.setSelection?.(offset, offset);\n    },\n  };\n}\n\n/** Write one plain key onto the document style (it rides the snapshot like the paper colour does). */\nexport async function writeDocumentStyleKey(api: ApiLike, key: string, value: string): Promise<void> {\n  const doc = api.getActiveDocument?.();\n  if (!doc) return;\n  const style = (doc as unknown as { getDocumentDataModel?(): { getSnapshot(): { documentStyle?: Record<string, unknown> } } }).getDocumentDataModel?.()?.getSnapshot().documentStyle ?? {};\n  const old = style[key];\n  if (old === value) return;\n  const { JSONX } = await import(\"@univerjs/core\");\n  const jsonX = JSONX.getInstance();\n  const path = [\"documentStyle\", key];\n  const action = old === undefined ? jsonX.insertOp(path, value) : jsonX.replaceOp(path, old, value);\n  if (!action) return;\n  await api.executeCommand(\"doc.mutation.rich-text-editing\", { unitId: doc.getId(), actions: action, textRanges: undefined });\n}\n"],"mappings":";;;;;;;;AAeO,IAAM,kBAAmC;AAAA,EAC9C,EAAE,IAAI,iBAAiB,OAAO,iBAAiB,aAAa,wDAAwD,UAAU,wJAAmJ;AAAA,EACjR,EAAE,IAAI,mBAAmB,OAAO,mBAAmB,aAAa,+CAA+C,UAAU,kJAA6I;AAAA,EACtQ,EAAE,IAAI,eAAe,OAAO,eAAe,aAAa,0DAA0D,UAAU,uGAAuG;AAAA,EACnO,EAAE,IAAI,iBAAiB,OAAO,iBAAiB,aAAa,0CAA0C,UAAU,wFAAwF;AAAA,EACxM,EAAE,IAAI,gBAAgB,OAAO,mBAAmB,aAAa,gDAAgD,UAAU,yHAAyH;AAAA,EAChP,EAAE,IAAI,aAAa,OAAO,iBAAiB,aAAa,0CAA0C,UAAU,wEAAwE;AACtL;AASO,SAAS,eAAe,UAAkC;AAC/D,QAAM,OAAQ,oBAAoB,QAAQ,EAAE,QAAQ,EAAE,YAAY,GAAG;AACrE,MAAI,SAAS,KAAK;AAClB,MAAI,OAAO,SAAS,IAAI,EAAG,UAAS,OAAO,MAAM,GAAG,EAAE;AACtD,QAAM,cAAc,KAAK,cAAc,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,aAAa,OAAO,MAAM;AACrF,QAAM,YAAY,KAAK,YAAY,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,OAAO,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,KAAK,IAAI,EAAE,IAAI,OAAO,MAAM,EAAE,EAAE;AACnI,SAAO,EAAE,YAAY,QAAQ,YAAY,GAAI,SAAS,SAAS,EAAE,SAAS,IAAI,CAAC,EAAG;AACpF;AAQO,SAAS,gBAAgB,YAAoB,OAAuD;AACzG,QAAM,IAAI,KAAK,IAAI,GAAG,KAAK,IAAI,OAAO,WAAW,MAAM,CAAC;AACxD,QAAM,QAAQ,KAAK,IAAI,WAAW,YAAY,MAAM,IAAI,CAAC,GAAG,WAAW,YAAY,MAAM,IAAI,CAAC,CAAC,IAAI;AACnG,MAAI,MAAM,WAAW,QAAQ,MAAM,CAAC;AACpC,MAAI,MAAM,EAAG,OAAM,WAAW;AAE9B,QAAM,OAAO,WAAW,MAAM,OAAO,GAAG,EAAE,QAAQ,0BAA0B,EAAE,EAAE,KAAK;AACrF,MAAI,MAAM,SAAS,SAAS,GAAI,QAAO,EAAE,IAAI,OAAO,SAAS,KAAK;AAClE,SAAO,EAAE,IAAI,MAAM,GAAG,SAAS,IAAI;AACrC;AAGO,IAAM,sBAAsB;AAE5B,IAAM,kBAAkB;AAYxB,SAAS,iBAAiB,UAA+B;AAC9D,QAAM,OAAQ,UAA+C;AAC7D,QAAM,MAAkB,CAAC;AACzB,aAAW,KAAK,MAAM,gBAAgB,CAAC,GAAG;AACxC,QAAI,EAAE,cAAc,oBAAqB;AACzC,QAAI,KAAK,EAAE,IAAI,EAAE,SAAS,MAAM,OAAO,EAAE,YAAY,SAAS,WAAW,EAAE,WAAW,OAAO,IAAI,QAAQ,EAAE,WAAW,CAAC;AAAA,EACzH;AACA,SAAO,IAAI,KAAK,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM;AAC/C;AAEO,SAAS,aAAa,IAAY,MAAc;AACrD,SAAO;AAAA,IACL,YAAY;AAAA,IACZ,cAAc,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS,IAAI,WAAW,qBAAqB,YAAY,EAAE,KAAK,GAAG,aAAa,KAAK,CAAC;AAAA,EACrI;AACF;AAEO,SAAS,kBAAkB,KAAa,UAAwF;AACrI,QAAM,OAAO,IAAI,QAAQ,QAAQ,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,EAAE;AACxD,MAAI,CAAC,KAAM,QAAO,EAAE,IAAI,OAAO,KAAK,4BAA4B;AAChE,MAAI,SAAS,KAAK,CAAC,MAAM,EAAE,KAAK,YAAY,MAAM,KAAK,YAAY,CAAC,EAAG,QAAO,EAAE,IAAI,OAAO,KAAK,qBAAqB,IAAI,oBAAoB;AAC7I,SAAO,EAAE,IAAI,MAAM,KAAK;AAC1B;AAGO,SAAS,iBAAiB,MAA6B;AAC5D,QAAM,IAAI,mBAAmB,KAAK,IAAI;AACtC,MAAI,CAAC,EAAG,QAAO;AACf,MAAI;AACF,WAAO,mBAAmB,EAAE,CAAC,CAAE;AAAA,EACjC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AACO,IAAM,eAAe,CAAC,SAAiB,aAAa,mBAAmB,IAAI,CAAC;AAKnF,IAAM,OAAmC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,EAAE;AAWnE,SAAS,sBAAsB,GAA0C;AAC9E,QAAM,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,OAAO,WAAW,KAAK,EAAE,IAAI,GAAG,SAAS,EAAE,QAAQ;AACpG,SAAO;AAAA,IACL,WAAW,EAAE,SAAS,SAAS,EAAE,SAAS,SAAS,OAAO;AAAA,IAC1D,cAAc,EAAE,SAAS,YAAY,EAAE,SAAS,SAAS,OAAO;AAAA,EAClE;AACF;AAWO,SAAS,cAAc,GAA8H;AAC1J,QAAM,YAAY,EAAE,cAAc,EAAE;AACpC,QAAM,WAAW,KAAK,IAAI,IAAI,EAAE,iBAAiB,aAAa,CAAC;AAC/D,QAAM,QAAgC,CAAC;AACvC,QAAM,SAAS,EAAE,cAAc;AAC/B,WAAS,SAAS,GAAG,UAAU,KAAK,MAAM,SAAS,CAAC,GAAG,UAAU;AAC/D,UAAM,IAAI,WAAY,SAAS,cAAc,EAAE,OAAQ;AACvD,QAAI,SAAS,MAAM,GAAG;AACpB,YAAM,eAAe,EAAE,eAAe;AACtC,YAAM,KAAK,EAAE,GAAG,MAAM,QAAQ,GAAI,SAAS,MAAM,eAAe,EAAE,OAAO,OAAO,KAAK,MAAM,KAAK,IAAI,SAAS,IAAI,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,EAAG,CAAC;AAAA,IAC5I,MAAO,OAAM,KAAK,EAAE,GAAG,MAAM,SAAS,MAAM,IAAI,SAAS,SAAS,CAAC;AAAA,EACrE;AACA,SAAO,EAAE,UAAU,WAAW,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,EAAE,gBAAgB,EAAE,MAAM,MAAM;AAClH;AAGO,IAAM,wBAAwB;AAC9B,IAAM,qBAA6D;AAAA,EACxE,EAAE,MAAM,SAAS,OAAO,0BAA0B;AAAA,EAClD,EAAE,MAAM,SAAS,OAAO,2BAA2B;AAAA,EACnD,EAAE,MAAM,MAAM,OAAO,UAAU;AAAA,EAC/B,EAAE,MAAM,MAAM,OAAO,SAAS;AAAA,EAC9B,EAAE,MAAM,MAAM,OAAO,SAAS;AAAA,EAC9B,EAAE,MAAM,MAAM,OAAO,UAAU;AAAA,EAC/B,EAAE,MAAM,SAAS,OAAO,sBAAsB;AAAA,EAC9C,EAAE,MAAM,MAAM,OAAO,QAAQ;AAAA,EAC7B,EAAE,MAAM,MAAM,OAAO,WAAW;AAAA,EAChC,EAAE,MAAM,MAAM,OAAO,SAAS;AAAA,EAC9B,EAAE,MAAM,SAAS,OAAO,uBAAuB;AAAA,EAC/C,EAAE,MAAM,MAAM,OAAO,SAAS;AAAA,EAC9B,EAAE,MAAM,MAAM,OAAO,QAAQ;AAAA,EAC7B,EAAE,MAAM,MAAM,OAAO,UAAU;AACjC;AAEO,SAAS,qBAAqB,eAAgC;AACnE,QAAM,IAAK,gBAAwD,qBAAqB;AACxF,SAAO,OAAO,MAAM,YAAY,mBAAmB,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,IAAI;AACrF;;;ACvIO,SAAS,iBAAiB,MAAsF;AACrH,QAAM,MAAM,MAAM,KAAK,IAAI,GAAG,oBAAoB,KAAK;AACvD,QAAM,WAAW,MAAM,IAAI,GAAG,OAAO,KAAK;AAC1C,QAAM,QAAQ,YAA2C;AACvD,UAAM,EAAE,2BAA2B,IAAI,MAAM,OAAO,gBAAgB;AACpE,UAAM,OAAO,KAAK,SAAS,GAAG,IAAiE,0BAA0B,GAAG,qBAAqB;AACjJ,WAAO,QAAQ;AAAA,EACjB;AACA,QAAM,OAAO,OAAO,IAAY,WAAoB,MAAM,KAAK,IAAI,GAAG,eAAe,IAAI,MAAM,MAAO;AACtG,QAAM,eAAe,YAA8B;AACjD,UAAM,IAAI,IAAI;AACd,UAAM,IAAI,MAAM,MAAM;AACtB,UAAM,SAAU,SAAS,GAAiD,MAAM;AAChF,QAAI,CAAC,KAAK,CAAC,KAAK,OAAO,WAAW,SAAU,QAAO;AACnD,UAAM,OAAO,gBAAgB,QAAQ,EAAE,WAAW;AAClD,QAAI,KAAK,YAAY,MAAM;AACzB,QAAE,eAAe,KAAK,IAAI,KAAK,EAAE;AACjC,aAAO;AAAA,IACT;AACA,MAAE,eAAe,KAAK,SAAS,KAAK,OAAO;AAC3C,WAAO,KAAK,0BAA0B,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAAA,EAC7D;AAEA,SAAO;AAAA,IACL;AAAA,IACA,MAAM,WAAW,MAAM;AACrB,UAAI,CAAC,QAAQ,CAAE,MAAM,MAAM,EAAI,QAAO;AACtC,aAAO,KAAK,wCAAwC,EAAE,OAAO,KAAK,CAAC;AAAA,IACrE;AAAA,IACA;AAAA,IACA,MAAM,eAAe,UAAU;AAC7B,YAAM,IAAI,IAAI;AACd,UAAI,CAAC,KAAK,CAAE,MAAM,aAAa,EAAI,QAAO;AAC1C,aAAO,KAAK,iCAAiC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,eAAe,QAAQ,EAAE,CAAC;AAAA,IACpG;AAAA,IACA,WAAW,MAAM,iBAAiB,SAAS,CAAC;AAAA,IAC5C,MAAM,YAAY,MAAM;AACtB,YAAM,IAAI,IAAI;AACd,YAAM,IAAI,MAAM,MAAM;AACtB,UAAI,CAAC,KAAK,CAAC,EAAG,QAAO;AACrB,QAAE,eAAe,EAAE,aAAa,EAAE,WAAW;AAC7C,YAAM,KAAK,MAAM,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC;AACxD,aAAO,KAAK,iCAAiC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,aAAa,IAAI,IAAI,EAAE,CAAC;AAAA,IAClG;AAAA,IACA,MAAM,eAAe,GAAG;AACtB,YAAM,IAAI,IAAI;AACd,UAAI,CAAC,EAAG,QAAO;AACf,QAAE,eAAe,EAAE,SAAS,GAAG,EAAE,SAAS,CAAC;AAC3C,aAAO,KAAK,2BAA2B,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAAA,IAC9D;AAAA,IACA,MAAM,YAAY,UAAU;AAC1B,YAAM,OAAO,IAAI,GAAG,gBAAgB;AACpC,UAAI,CAAC,KAAM;AACX,UAAI,SAAU,OAAM,KAAK,YAAY;AAAA,UAChC,OAAM,KAAK,YAAY,IAAI;AAGhC,YAAM,EAAE,mBAAmB,IAAI,MAAM,OAAO,gBAAgB;AAC5D,WAAK,SAAS,GAAG,IAAiD,kBAAkB,GAAG,oBAAoB,CAAC,QAAQ;AAAA,IACtH;AAAA,IACA,MAAM,aAAa,IAAI;AACrB,YAAM,EAAE,aAAa,IAAI,MAAM,OAAO,gBAAgB;AACtD,YAAM,SAAS,KAAK,SAAS,GAAG,IAA6F,YAAY;AACzI,YAAM,MAAM,QAAQ,QAAQ,UAAU,CAAC,MAAM;AAC3C,YAAI,EAAE,SAAS,oBAAqB,IAAG;AAAA,MACzC,CAAC;AACD,aAAO,MAAM,KAAK,YAAY;AAAA,IAChC;AAAA,IACA,MAAM,iBAAiB;AACrB,aAAO,KAAK,+BAA+B,EAAE,OAAO,YAAY,CAAC;AAAA,IACnE;AAAA,IACA,KAAK,QAAQ;AACX,UAAI,GAAG,eAAe,QAAQ,MAAM;AAAA,IACtC;AAAA,EACF;AACF;AAGA,eAAsB,sBAAsB,KAAc,KAAa,OAA8B;AACnG,QAAM,MAAM,IAAI,oBAAoB;AACpC,MAAI,CAAC,IAAK;AACV,QAAM,QAAS,IAA+G,uBAAuB,GAAG,YAAY,EAAE,iBAAiB,CAAC;AACxL,QAAM,MAAM,MAAM,GAAG;AACrB,MAAI,QAAQ,MAAO;AACnB,QAAM,EAAE,MAAM,IAAI,MAAM,OAAO,gBAAgB;AAC/C,QAAM,QAAQ,MAAM,YAAY;AAChC,QAAM,OAAO,CAAC,iBAAiB,GAAG;AAClC,QAAM,SAAS,QAAQ,SAAY,MAAM,SAAS,MAAM,KAAK,IAAI,MAAM,UAAU,MAAM,KAAK,KAAK;AACjG,MAAI,CAAC,OAAQ;AACb,QAAM,IAAI,eAAe,kCAAkC,EAAE,QAAQ,IAAI,MAAM,GAAG,SAAS,QAAQ,YAAY,OAAU,CAAC;AAC5H;","names":[]}