@ai-matrx/office 0.3.1 → 0.5.2

package/dist/docs-tools.cjs

@@ -0,0 +1,217 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunkO6FTSXHEcjs = require('./chunk-O6FTSXHE.cjs');
+
+
+var _chunk2UBGQUXWcjs = require('./chunk-2UBGQUXW.cjs');
+
+// 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 = _nullishCoalesce(_chunkO6FTSXHEcjs.markdownToUniverDoc.call(void 0, markdown).body, () => ( { dataStream: "" }));
+  let stream = body.dataStream;
+  if (stream.endsWith("\n")) stream = stream.slice(0, -1);
+  const paragraphs = (_nullishCoalesce(body.paragraphs, () => ( []))).filter((p) => p.startIndex < stream.length);
+  const textRuns = (_nullishCoalesce(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 = _optionalChain([snapshot, 'optionalAccess', _ => _.body]);
+  const out = [];
+  for (const r of _nullishCoalesce(_optionalChain([body, 'optionalAccess', _2 => _2.customRanges]), () => ( []))) {
+    if (r.rangeType !== BOOKMARK_RANGE_TYPE) continue;
+    out.push({ id: r.rangeId, name: typeof _optionalChain([r, 'access', _3 => _3.properties, 'optionalAccess', _4 => _4.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 (e2) {
+    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 / _chunk2UBGQUXWcjs.PX_PER_INCH;
+  for (let eighth = 0; eighth <= Math.floor(inches * 8); eighth++) {
+    const x = pageLeft + eighth * _chunk2UBGQUXWcjs.PX_PER_INCH * a.zoom / 8;
+    if (eighth % 8 === 0) {
+      const marginInches = a.marginLeftPx / _chunk2UBGQUXWcjs.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 = _optionalChain([documentStyle, 'optionalAccess', _5 => _5[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 = () => _nullishCoalesce(_optionalChain([deps, 'access', _6 => _6.api, 'call', _7 => _7(), 'optionalAccess', _8 => _8.getActiveDocument, 'optionalCall', _9 => _9()]), () => ( null));
+  const snapshot = () => _nullishCoalesce(_optionalChain([doc, 'call', _10 => _10(), 'optionalAccess', _11 => _11.save, 'optionalCall', _12 => _12()]), () => ( null));
+  const range = async () => {
+    const { DocSelectionManagerService } = await Promise.resolve().then(() => _interopRequireWildcard(require("@univerjs/docs")));
+    const live = _optionalChain([deps, 'access', _13 => _13.injector, 'call', _14 => _14(), 'optionalAccess', _15 => _15.get, 'call', _16 => _16(DocSelectionManagerService), 'optionalAccess', _17 => _17.getActiveTextRange, 'optionalCall', _18 => _18()]);
+    return _nullishCoalesce(live, () => ( null));
+  };
+  const exec = async (id, params) => await _optionalChain([deps, 'access', _19 => _19.api, 'call', _20 => _20(), 'optionalAccess', _21 => _21.executeCommand, 'call', _22 => _22(id, params)]) !== false;
+  const toBlockStart = async () => {
+    const d = doc();
+    const r = await range();
+    const stream = _optionalChain([snapshot, 'call', _23 => _23(), 'optionalAccess', _24 => _24.body, 'optionalAccess', _25 => _25.dataStream]);
+    if (!d || !r || typeof stream !== "string") return false;
+    const plan = blockInsertPlan(stream, r.startOffset);
+    if (plan.breakAt === null) {
+      _optionalChain([d, 'access', _26 => _26.setSelection, 'optionalCall', _27 => _27(plan.at, plan.at)]);
+      return true;
+    }
+    _optionalChain([d, 'access', _28 => _28.setSelection, 'optionalCall', _29 => _29(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;
+      _optionalChain([d, 'access', _30 => _30.setSelection, 'optionalCall', _31 => _31(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;
+      _optionalChain([d, 'access', _32 => _32.setSelection, 'optionalCall', _33 => _33(b.offset + 1, b.offset + 1)]);
+      return exec("doc.command.delete-left", { unitId: d.getId() });
+    },
+    async setViewOnly(viewOnly) {
+      const perm = _optionalChain([doc, 'call', _34 => _34(), 'optionalAccess', _35 => _35.getPermission, 'optionalCall', _36 => _36()]);
+      if (!perm) return;
+      if (viewOnly) await perm.setReadOnly();
+      else await perm.setEditable(true);
+      const { IPermissionService } = await Promise.resolve().then(() => _interopRequireWildcard(require("@univerjs/core")));
+      _optionalChain([deps, 'access', _37 => _37.injector, 'call', _38 => _38(), 'optionalAccess', _39 => _39.get, 'call', _40 => _40(IPermissionService), 'optionalAccess', _41 => _41.setShowComponents, 'optionalCall', _42 => _42(!viewOnly)]);
+    },
+    async onEditDenied(cb) {
+      const { ErrorService } = await Promise.resolve().then(() => _interopRequireWildcard(require("@univerjs/core")));
+      const errors = _optionalChain([deps, 'access', _43 => _43.injector, 'call', _44 => _44(), 'optionalAccess', _45 => _45.get, 'call', _46 => _46(ErrorService)]);
+      const sub = _optionalChain([errors, 'optionalAccess', _47 => _47.error$, 'optionalAccess', _48 => _48.subscribe, 'call', _49 => _49((e) => {
+        if (e.code === "PERMISSION_DENIED") cb();
+      })]);
+      return () => _optionalChain([sub, 'optionalAccess', _50 => _50.unsubscribe, 'call', _51 => _51()]);
+    },
+    async openImagePanel() {
+      return exec("sidebar.operation.doc-image", { value: "doc-image" });
+    },
+    goTo(offset) {
+      _optionalChain([doc, 'call', _52 => _52(), 'optionalAccess', _53 => _53.setSelection, 'optionalCall', _54 => _54(offset, offset)]);
+    }
+  };
+}
+async function writeDocumentStyleKey(api, key, value) {
+  const doc = _optionalChain([api, 'access', _55 => _55.getActiveDocument, 'optionalCall', _56 => _56()]);
+  if (!doc) return;
+  const style = _nullishCoalesce(_optionalChain([doc, 'access', _57 => _57.getDocumentDataModel, 'optionalCall', _58 => _58(), 'optionalAccess', _59 => _59.getSnapshot, 'call', _60 => _60(), 'access', _61 => _61.documentStyle]), () => ( {}));
+  const old = style[key];
+  if (old === value) return;
+  const { JSONX } = await Promise.resolve().then(() => _interopRequireWildcard(require("@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 });
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.BOOKMARK_ANCHOR = BOOKMARK_ANCHOR; exports.BOOKMARK_RANGE_TYPE = BOOKMARK_RANGE_TYPE; exports.BUILDING_BLOCKS = BUILDING_BLOCKS; exports.DOCUMENT_LANGUAGES = DOCUMENT_LANGUAGES; exports.DOCUMENT_LANGUAGE_KEY = DOCUMENT_LANGUAGE_KEY; exports.blockInsertPlan = blockInsertPlan; exports.bookmarkBody = bookmarkBody; exports.bookmarkFromHash = bookmarkFromHash; exports.bookmarkHash = bookmarkHash; exports.cleanBookmarkName = cleanBookmarkName; exports.collectBookmarks = collectBookmarks; exports.createDocEditOps = createDocEditOps; exports.insertableBody = insertableBody; exports.paragraphBorderParams = paragraphBorderParams; exports.readDocumentLanguage = readDocumentLanguage; exports.rulerGeometry = rulerGeometry; exports.writeDocumentStyleKey = writeDocumentStyleKey;
+//# sourceMappingURL=docs-tools.cjs.map

package/dist/docs-tools.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/aidream/aidream/apps/shared/office/dist/docs-tools.cjs","../src/docs/doc-tools-core.ts","../src/docs/doc-edit-ops.ts"],"names":[],"mappings":"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","file":"/home/runner/work/aidream/aidream/apps/shared/office/dist/docs-tools.cjs","sourcesContent":[null,"/**\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"]}

package/dist/docs-tools.d.cts

@@ -0,0 +1,150 @@
+/**
+ * The pure half of the Docs tools: building blocks, bookmarks, paragraph borders, the ruler's
+ * geometry and the document language. No Univer import, so each is proven on plain snapshots.
+ */
+interface BuildingBlock {
+    id: string;
+    label: string;
+    description: string;
+    markdown: string;
+}
+declare const BUILDING_BLOCKS: BuildingBlock[];
+interface InsertableBody {
+    dataStream: string;
+    paragraphs: Array<{
+        startIndex: number;
+        paragraphStyle?: Record<string, unknown>;
+    }>;
+    textRuns?: Array<{
+        st: number;
+        ed: number;
+        ts?: Record<string, unknown>;
+    }>;
+}
+/** Markdown to a body Univer can insert at the caret: the document-closing `\n` is dropped. */
+declare function insertableBody(markdown: string): InsertableBody;
+/**
+ * Where a BLOCK (table of contents, building block) goes for a caret: never inside a paragraph's
+ * text, so a heading is never split. Caret at the start of a paragraph (or in an empty one) →
+ * insert right there; anywhere else → end the caret's paragraph with a new line and insert at the
+ * start of that new paragraph. `dataStream` is Univer's body stream (paragraphs end in `\r`).
+ */
+declare function blockInsertPlan(dataStream: string, caret: number): {
+    at: number;
+    breakAt: number | null;
+};
+/** Univer's CustomRangeType.BOOKMARK. */
+declare const BOOKMARK_RANGE_TYPE = 3;
+/** A bookmark is an invisible anchor: one zero-width character the custom range wraps. */
+declare const BOOKMARK_ANCHOR = "\u200B";
+interface Bookmark {
+    id: string;
+    name: string;
+    offset: number;
+}
+declare function collectBookmarks(snapshot: unknown): Bookmark[];
+declare function bookmarkBody(id: string, name: string): {
+    dataStream: string;
+    customRanges: {
+        startIndex: number;
+        endIndex: number;
+        rangeId: string;
+        rangeType: number;
+        properties: {
+            name: string;
+        };
+        wholeEntity: boolean;
+    }[];
+};
+declare function cleanBookmarkName(raw: string, existing: readonly Bookmark[]): {
+    ok: true;
+    name: string;
+} | {
+    ok: false;
+    why: string;
+};
+/** `#bookmark=<name>` in the page address names a bookmark to jump to on open. */
+declare function bookmarkFromHash(hash: string): string | null;
+declare const bookmarkHash: (name: string) => string;
+type BorderSide = "top" | "bottom" | "both" | "none";
+type BorderDash = "solid" | "dashed" | "dotted";
+interface BorderChoice {
+    side: BorderSide;
+    color: string;
+    width: number;
+    dash: BorderDash;
+    padding: number;
+}
+/** The `paragraph` argument of `doc-paragraph-setting.command` for a choice (Univer draws top and bottom paragraph borders). */
+declare function paragraphBorderParams(c: BorderChoice): Record<string, unknown>;
+interface RulerGeometry {
+    pageLeft: number;
+    pageWidth: number;
+    marginLeft: number;
+    marginRight: number;
+    ticks: Array<{
+        x: number;
+        kind: "inch" | "half" | "eighth";
+        label?: string;
+    }>;
+}
+/** The ruler above the page: inch ticks from the page's left edge (margins shaded), at the current zoom. */
+declare function rulerGeometry(a: {
+    containerWidth: number;
+    zoom: number;
+    pageWidthPx: number;
+    marginLeftPx: number;
+    marginRightPx: number;
+}): RulerGeometry;
+/** The key on the document style that carries the language (the slot the paper colour also uses). */
+declare const DOCUMENT_LANGUAGE_KEY = "matrxLanguage";
+declare const DOCUMENT_LANGUAGES: Array<{
+    code: string;
+    label: string;
+}>;
+declare function readDocumentLanguage(documentStyle: unknown): string;
+
+/**
+ * The Univer-facing half of the Docs tools: insert text, markdown and bookmarks at the caret, move
+ * the selection, read the live snapshot, set view-only. Every operation is a real Univer command.
+ */
+
+interface ApiLike {
+    executeCommand(id: string, params?: object): Promise<unknown> | unknown;
+    getActiveDocument?(): {
+        getId(): string;
+        save?(): unknown;
+        setSelection?(a: number, b: number): void;
+        getPermission?(): {
+            setReadOnly(): Promise<void>;
+            setEditable(editable?: boolean): Promise<void>;
+        };
+    } | null;
+}
+interface InjectorLike {
+    get<T>(token: unknown): T | undefined;
+}
+interface DocEditOps {
+    insertText(text: string): Promise<boolean>;
+    /** A block (building block) at a new paragraph, never mid-line. */
+    insertMarkdown(markdown: string): Promise<boolean>;
+    /** Move the caret to where a block goes (`blockInsertPlan`); false when there is no caret. */
+    toBlockStart(): Promise<boolean>;
+    bookmarks(): Bookmark[];
+    addBookmark(name: string): Promise<boolean>;
+    deleteBookmark(b: Bookmark): Promise<boolean>;
+    goTo(offset: number): void;
+    snapshot(): unknown;
+    setViewOnly(viewOnly: boolean): Promise<void>;
+    /** Calls back when Univer refuses an edit (Viewing mode); returns the unsubscribe. */
+    onEditDenied(cb: () => void): Promise<() => void>;
+    openImagePanel(): Promise<boolean>;
+}
+declare function createDocEditOps(deps: {
+    api: () => ApiLike | null;
+    injector: () => InjectorLike | null;
+}): DocEditOps;
+/** Write one plain key onto the document style (it rides the snapshot like the paper colour does). */
+declare function writeDocumentStyleKey(api: ApiLike, key: string, value: string): Promise<void>;
+
+export { BOOKMARK_ANCHOR, BOOKMARK_RANGE_TYPE, BUILDING_BLOCKS, type Bookmark, type BorderChoice, type BorderDash, type BorderSide, type BuildingBlock, DOCUMENT_LANGUAGES, DOCUMENT_LANGUAGE_KEY, type DocEditOps, type InsertableBody, type RulerGeometry, blockInsertPlan, bookmarkBody, bookmarkFromHash, bookmarkHash, cleanBookmarkName, collectBookmarks, createDocEditOps, insertableBody, paragraphBorderParams, readDocumentLanguage, rulerGeometry, writeDocumentStyleKey };

package/dist/docs-tools.d.ts

@@ -0,0 +1,150 @@
+/**
+ * The pure half of the Docs tools: building blocks, bookmarks, paragraph borders, the ruler's
+ * geometry and the document language. No Univer import, so each is proven on plain snapshots.
+ */
+interface BuildingBlock {
+    id: string;
+    label: string;
+    description: string;
+    markdown: string;
+}
+declare const BUILDING_BLOCKS: BuildingBlock[];
+interface InsertableBody {
+    dataStream: string;
+    paragraphs: Array<{
+        startIndex: number;
+        paragraphStyle?: Record<string, unknown>;
+    }>;
+    textRuns?: Array<{
+        st: number;
+        ed: number;
+        ts?: Record<string, unknown>;
+    }>;
+}
+/** Markdown to a body Univer can insert at the caret: the document-closing `\n` is dropped. */
+declare function insertableBody(markdown: string): InsertableBody;
+/**
+ * Where a BLOCK (table of contents, building block) goes for a caret: never inside a paragraph's
+ * text, so a heading is never split. Caret at the start of a paragraph (or in an empty one) →
+ * insert right there; anywhere else → end the caret's paragraph with a new line and insert at the
+ * start of that new paragraph. `dataStream` is Univer's body stream (paragraphs end in `\r`).
+ */
+declare function blockInsertPlan(dataStream: string, caret: number): {
+    at: number;
+    breakAt: number | null;
+};
+/** Univer's CustomRangeType.BOOKMARK. */
+declare const BOOKMARK_RANGE_TYPE = 3;
+/** A bookmark is an invisible anchor: one zero-width character the custom range wraps. */
+declare const BOOKMARK_ANCHOR = "\u200B";
+interface Bookmark {
+    id: string;
+    name: string;
+    offset: number;
+}
+declare function collectBookmarks(snapshot: unknown): Bookmark[];
+declare function bookmarkBody(id: string, name: string): {
+    dataStream: string;
+    customRanges: {
+        startIndex: number;
+        endIndex: number;
+        rangeId: string;
+        rangeType: number;
+        properties: {
+            name: string;
+        };
+        wholeEntity: boolean;
+    }[];
+};
+declare function cleanBookmarkName(raw: string, existing: readonly Bookmark[]): {
+    ok: true;
+    name: string;
+} | {
+    ok: false;
+    why: string;
+};
+/** `#bookmark=<name>` in the page address names a bookmark to jump to on open. */
+declare function bookmarkFromHash(hash: string): string | null;
+declare const bookmarkHash: (name: string) => string;
+type BorderSide = "top" | "bottom" | "both" | "none";
+type BorderDash = "solid" | "dashed" | "dotted";
+interface BorderChoice {
+    side: BorderSide;
+    color: string;
+    width: number;
+    dash: BorderDash;
+    padding: number;
+}
+/** The `paragraph` argument of `doc-paragraph-setting.command` for a choice (Univer draws top and bottom paragraph borders). */
+declare function paragraphBorderParams(c: BorderChoice): Record<string, unknown>;
+interface RulerGeometry {
+    pageLeft: number;
+    pageWidth: number;
+    marginLeft: number;
+    marginRight: number;
+    ticks: Array<{
+        x: number;
+        kind: "inch" | "half" | "eighth";
+        label?: string;
+    }>;
+}
+/** The ruler above the page: inch ticks from the page's left edge (margins shaded), at the current zoom. */
+declare function rulerGeometry(a: {
+    containerWidth: number;
+    zoom: number;
+    pageWidthPx: number;
+    marginLeftPx: number;
+    marginRightPx: number;
+}): RulerGeometry;
+/** The key on the document style that carries the language (the slot the paper colour also uses). */
+declare const DOCUMENT_LANGUAGE_KEY = "matrxLanguage";
+declare const DOCUMENT_LANGUAGES: Array<{
+    code: string;
+    label: string;
+}>;
+declare function readDocumentLanguage(documentStyle: unknown): string;
+
+/**
+ * The Univer-facing half of the Docs tools: insert text, markdown and bookmarks at the caret, move
+ * the selection, read the live snapshot, set view-only. Every operation is a real Univer command.
+ */
+
+interface ApiLike {
+    executeCommand(id: string, params?: object): Promise<unknown> | unknown;
+    getActiveDocument?(): {
+        getId(): string;
+        save?(): unknown;
+        setSelection?(a: number, b: number): void;
+        getPermission?(): {
+            setReadOnly(): Promise<void>;
+            setEditable(editable?: boolean): Promise<void>;
+        };
+    } | null;
+}
+interface InjectorLike {
+    get<T>(token: unknown): T | undefined;
+}
+interface DocEditOps {
+    insertText(text: string): Promise<boolean>;
+    /** A block (building block) at a new paragraph, never mid-line. */
+    insertMarkdown(markdown: string): Promise<boolean>;
+    /** Move the caret to where a block goes (`blockInsertPlan`); false when there is no caret. */
+    toBlockStart(): Promise<boolean>;
+    bookmarks(): Bookmark[];
+    addBookmark(name: string): Promise<boolean>;
+    deleteBookmark(b: Bookmark): Promise<boolean>;
+    goTo(offset: number): void;
+    snapshot(): unknown;
+    setViewOnly(viewOnly: boolean): Promise<void>;
+    /** Calls back when Univer refuses an edit (Viewing mode); returns the unsubscribe. */
+    onEditDenied(cb: () => void): Promise<() => void>;
+    openImagePanel(): Promise<boolean>;
+}
+declare function createDocEditOps(deps: {
+    api: () => ApiLike | null;
+    injector: () => InjectorLike | null;
+}): DocEditOps;
+/** Write one plain key onto the document style (it rides the snapshot like the paper colour does). */
+declare function writeDocumentStyleKey(api: ApiLike, key: string, value: string): Promise<void>;
+
+export { BOOKMARK_ANCHOR, BOOKMARK_RANGE_TYPE, BUILDING_BLOCKS, type Bookmark, type BorderChoice, type BorderDash, type BorderSide, type BuildingBlock, DOCUMENT_LANGUAGES, DOCUMENT_LANGUAGE_KEY, type DocEditOps, type InsertableBody, type RulerGeometry, blockInsertPlan, bookmarkBody, bookmarkFromHash, bookmarkHash, cleanBookmarkName, collectBookmarks, createDocEditOps, insertableBody, paragraphBorderParams, readDocumentLanguage, rulerGeometry, writeDocumentStyleKey };