@arbidocs/blocks 0.4.111 → 0.4.112

package/node_modules/@arbidocs/coedit/dist/server.cjs

@@ -4,6 +4,8 @@ var awareness = require('y-protocols/awareness');
 var automation = require('@docx-editor.dev/core/automation');
 var replication = require('@docx-editor.dev/core/collaboration/replication');
 var store = require('@docx-editor.dev/core/store');
+var layout = require('@docx-editor.dev/core/layout');
+var fflate = require('fflate');
 var Y3 = require('yjs');
 var collaboration = require('@docx-editor.dev/core/collaboration');
 
@@ -29,8 +31,528 @@ var Y3__namespace = /*#__PURE__*/_interopNamespace(Y3);
 
 // src/server.ts
 
+// src/commands/read.ts
+var DEFINED_TERM_STYLE = "DefinedTerm";
+var CROSS_REFERENCE_STYLE = "CrossReference";
+var BROKEN_CROSS_REFERENCE_STYLE = "CrossReferenceBroken";
+var WATCHED_STYLES = /* @__PURE__ */ new Set([BROKEN_CROSS_REFERENCE_STYLE]);
+var attr = (node, name) => node.attributes?.find((a) => a.localName === name)?.value;
+var FIELD_ATOM = "\uFFFC";
+var HEADING_STYLE = /^(heading|berschrift|titre|t[ií]tulo|titolo|kop)\s*\d/i;
+function readParagraphs(root) {
+  const out = [];
+  const body = root.children?.find((n) => n.kind === "body") ?? root;
+  const visit = (node, topLevel, pending) => {
+    for (const child of node.children ?? []) {
+      if (child.kind === "paragraph") {
+        out.push(readParagraph(child, topLevel, pending.splice(0)));
+      } else if (child.localName === "bookmarkStart") {
+        const name = attr(child, "name");
+        if (name) pending.push(name);
+      } else if (child.localName === "tbl" || child.localName === "tr" || child.localName === "tc") {
+        visit(child, false, pending);
+      } else if (child.localName === "sdt" || child.localName === "sdtContent") {
+        visit(child, topLevel, pending);
+      }
+    }
+  };
+  visit(body, true, []);
+  return out;
+}
+function readParagraph(node, topLevel, bookmarks) {
+  let text = "";
+  const links = [];
+  let styleId;
+  let outline = false;
+  let fieldDepth = 0;
+  const marks = [];
+  let runStyle;
+  const fields = [];
+  const notes = [];
+  let current = null;
+  const field = (c) => {
+    const type = attr(c, "fldCharType");
+    if (type === "begin") {
+      if (fieldDepth === 0) {
+        current = { offset: text.length, instruction: "", result: "", inResult: false };
+        text += FIELD_ATOM;
+      }
+      fieldDepth++;
+    } else if (type === "separate" && fieldDepth === 1 && current) current.inResult = true;
+    else if (type === "end") {
+      fieldDepth = Math.max(0, fieldDepth - 1);
+      if (fieldDepth === 0 && current) {
+        const { offset, instruction, result } = current;
+        fields.push({ offset, instruction: instruction.trim(), result });
+        current = null;
+      }
+    }
+  };
+  const walk = (n, link) => {
+    for (const c of n.children ?? []) {
+      if (c.localName === "fldChar") {
+        field(c);
+        continue;
+      }
+      if (c.localName === "fldSimple") {
+        if (fieldDepth === 0) text += FIELD_ATOM;
+        continue;
+      }
+      if (c.localName === "instrText") {
+        if (fieldDepth === 1 && current)
+          current.instruction += (c.children ?? []).map((t) => t.value ?? "").join("");
+        continue;
+      }
+      if (c.kind === "paragraphProperties" || c.localName === "pPr") {
+        for (const p of c.children ?? []) {
+          if (p.localName === "pStyle") styleId = attr(p, "val");
+          if (p.localName === "outlineLvl" && Number(attr(p, "val")) < 9) outline = true;
+        }
+        continue;
+      }
+      if (c.localName === "delText" || c.localName === "del" || c.localName === "rPr") continue;
+      if (c.localName === "r") {
+        const rStyle = c.children?.find((x) => x.localName === "rPr")?.children?.find((x) => x.localName === "rStyle");
+        const watched = rStyle && attr(rStyle, "val");
+        runStyle = watched && WATCHED_STYLES.has(watched) ? watched : void 0;
+        walk(c, link);
+        runStyle = void 0;
+        continue;
+      }
+      if ((c.localName === "footnoteReference" || c.localName === "endnoteReference") && fieldDepth === 0) {
+        notes.push({
+          offset: text.length,
+          kind: c.localName === "footnoteReference" ? "footnote" : "endnote",
+          id: attr(c, "id") ?? ""
+        });
+        text += FIELD_ATOM;
+        continue;
+      }
+      if (c.localName === "bookmarkStart") {
+        const name = attr(c, "name");
+        if (name) bookmarks.push(name);
+        continue;
+      }
+      if (c.localName === "hyperlink") {
+        const anchor = attr(c, "anchor");
+        const next = anchor ? { anchor, text: "", offset: text.length } : void 0;
+        walk(c, next ?? link);
+        if (next) links.push(next);
+        continue;
+      }
+      if (c.kind === "textValue") {
+        if (fieldDepth > 0) {
+          const open = current;
+          if (fieldDepth === 1 && open?.inResult) open.result += c.value ?? "";
+          continue;
+        }
+        if (runStyle && c.value) {
+          const last = marks[marks.length - 1];
+          if (last && last.styleId === runStyle && last.offset + last.text.length === text.length)
+            last.text += c.value;
+          else marks.push({ styleId: runStyle, offset: text.length, text: c.value });
+        }
+        text += c.value ?? "";
+        if (link) link.text += c.value ?? "";
+        continue;
+      }
+      if (c.localName === "tab" && fieldDepth === 0) text += "	";
+      walk(c, link);
+    }
+  };
+  walk(node);
+  const paraId = attr(node, "paraId");
+  return {
+    id: node.id,
+    ...paraId ? { paraId } : {},
+    text,
+    heading: outline || !!styleId && HEADING_STYLE.test(styleId),
+    styleId,
+    topLevel,
+    bookmarks,
+    links,
+    ...fields.length ? { fields } : {},
+    ...marks.length ? { marks } : {},
+    ...notes.length ? { notes } : {}
+  };
+}
+function documentNumbering(source) {
+  let numbering;
+  let cascade;
+  const index = () => {
+    if (!numbering) {
+      cascade = layout.buildStyleCascadeTable(
+        source.stylesRoot(),
+        void 0,
+        source.settingsRoot()
+      );
+      numbering = layout.withNumberingStyleLinks(
+        layout.buildNumberingIndex(source.numberingRoot()),
+        cascade
+      );
+    }
+    return numbering;
+  };
+  return {
+    listItems: () => {
+      const body = source.root().children?.find((n) => n.kind === "body");
+      const items = layout.resolveStoryListItems(
+        body?.children ?? [],
+        index(),
+        cascade
+      );
+      const out = /* @__PURE__ */ new Map();
+      for (const [id, item] of items)
+        out.set(id, {
+          numId: item.numId,
+          ilvl: item.ilvl,
+          markerText: item.markerText,
+          numFmt: item.numFmt
+        });
+      return out;
+    },
+    levelOf: (numId, ilvl) => {
+      const level = layout.resolveNumberingLevel(index(), numId, ilvl)?.level;
+      return level ? { lvlText: level.lvlText, numFmt: level.numFmt } : null;
+    }
+  };
+}
+var W_NAMESPACES = 'xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"';
+var INVALID_XML = /[\u0000-\u0008\u000B\u000C\u000E-\u001F￾￿]/g;
+var esc = (text) => text.replace(INVALID_XML, "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+var documentXml = (body) => `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<w:document ${W_NAMESPACES}><w:body>${body}</w:body></w:document>`;
+var stylesXml = (defaults, styles) => `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<w:styles xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">${defaults}${styles}</w:styles>`;
+var CONTENT_TYPES = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentType="application/xml"/><Override PartName="/word/document.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"/><Override PartName="/word/styles.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml"/><Override PartName="/docProps/core.xml" ContentType="application/vnd.openxmlformats-package.core-properties+xml"/></Types>`;
+var ROOT_RELS = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="word/document.xml"/><Relationship Id="rId2" Type="http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties" Target="docProps/core.xml"/></Relationships>`;
+var documentRels = (more = "") => `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles" Target="styles.xml"/>${more}</Relationships>`;
+var coreXml = (title, at) => `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<cp:coreProperties xmlns:cp="http://schemas.openxmlformats.org/package/2006/metadata/core-properties" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><dc:title>${esc(
+  title
+)}</dc:title><dcterms:created xsi:type="dcterms:W3CDTF">${at}</dcterms:created><dcterms:modified xsi:type="dcterms:W3CDTF">${at}</dcterms:modified></cp:coreProperties>`;
+function docxPackage(parts) {
+  const at = new Date(parts.at ?? Date.now()).toISOString().replace(/\.\d{3}Z$/, "Z");
+  return fflate.zipSync({
+    "[Content_Types].xml": fflate.strToU8(CONTENT_TYPES),
+    "_rels/.rels": fflate.strToU8(ROOT_RELS),
+    "docProps/core.xml": fflate.strToU8(coreXml(parts.title, at)),
+    "word/document.xml": fflate.strToU8(parts.document),
+    "word/styles.xml": fflate.strToU8(parts.styles),
+    "word/_rels/document.xml.rels": fflate.strToU8(documentRels(parts.relationships))
+  });
+}
+
+// src/commands/references.ts
+var RUN_PARTS = /* @__PURE__ */ new Set(["rPr", "t", "tab", "br", "lastRenderedPageBreak"]);
+var SKIPPED = /* @__PURE__ */ new Set(["pPr", "bookmarkStart", "bookmarkEnd", "proofErr", "permStart", "permEnd"]);
+function serialize(node) {
+  if (node.kind === "textValue") return esc(node.value ?? "");
+  const name = `${node.prefix ?? "w"}:${node.localName}`;
+  const attrs = (node.attributes ?? []).map((a) => ` ${a.prefix ? `${a.prefix}:` : ""}${a.localName}="${esc(a.value)}"`).join("");
+  const children = (node.children ?? []).map((c) => serialize(c)).join("");
+  return children ? `<${name}${attrs}>${children}</${name}>` : `<${name}${attrs}/>`;
+}
+function paragraphRunsXml(paragraph) {
+  const runs = [];
+  for (const child of paragraph.children ?? []) {
+    if (child.localName && SKIPPED.has(child.localName)) continue;
+    if (child.localName !== "r") return null;
+    if ((child.children ?? []).some((c) => !c.localName || !RUN_PARTS.has(c.localName))) return null;
+    runs.push(serialize(child));
+  }
+  return runs.length ? runs.join("") : null;
+}
+var W_NS = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+var TemplateError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "TemplateError";
+  }
+};
+function parse(xml, part = "part") {
+  const read = store.readXml(xml, { maxBytes: 64 * 1024 * 1024, maxElements: 2e6 });
+  if (!read.ok) throw new TemplateError(`${part} is not readable XML (${read.reason})`);
+  const convert = (node) => node.type === "text" ? node.value : { name: node.name, attrs: { ...node.attributes }, children: node.children.map(convert) };
+  const root = read.nodes.map(convert).find((n) => typeof n !== "string");
+  if (!root) throw new TemplateError(`${part} has no root element`);
+  const w = root.attrs["xmlns:w"];
+  if (w !== void 0 && w !== W_NS) throw new TemplateError(`${part} binds w: to ${w}`);
+  return root;
+}
+var escText = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+var escAttr = (s) => escText(s).replace(/"/g, "&quot;");
+function serialize2(root) {
+  const out = ['<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n'];
+  const walk = (node) => {
+    if (typeof node === "string") return void out.push(escText(node));
+    out.push("<", node.name);
+    for (const [k, v] of Object.entries(node.attrs)) out.push(" ", k, '="', escAttr(v), '"');
+    if (node.children.length === 0) return void out.push("/>");
+    out.push(">");
+    node.children.forEach(walk);
+    out.push("</", node.name, ">");
+  };
+  walk(root);
+  return out.join("");
+}
+var el = (name, attrs = {}, children = []) => ({
+  name,
+  attrs,
+  children
+});
+var isEl = (n) => typeof n === "object" && n !== null;
+var kids = (e, name) => e.children.filter((c) => isEl(c) && (name === void 0 || c.name === name));
+var kid = (e, name) => e ? kids(e, name)[0] : void 0;
+
+// src/template/pkg.ts
+var REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+var RT = {
+  officeDocument: `${REL}/officeDocument`};
+var Pkg = class _Pkg {
+  files;
+  types;
+  constructor(files) {
+    this.files = files;
+    const ct = this.find("[Content_Types].xml");
+    if (!ct) throw new TemplateError("not a Word package: no [Content_Types].xml");
+    this.types = parse(fflate.strFromU8(files.get(ct)), "[Content_Types].xml");
+  }
+  static read(bytes) {
+    let files;
+    try {
+      files = fflate.unzipSync(bytes);
+    } catch {
+      throw new TemplateError("not a Word package: not a zip");
+    }
+    return new _Pkg(new Map(Object.entries(files).filter(([n]) => !n.endsWith("/"))));
+  }
+  write() {
+    this.files.set(
+      this.find("[Content_Types].xml") ?? "[Content_Types].xml",
+      fflate.strToU8(serialize2(this.types))
+    );
+    return fflate.zipSync(Object.fromEntries(this.files), { level: 6 });
+  }
+  /** The stored name of a part, matched case-insensitively as OPC does. */
+  find(name) {
+    const key = name.replace(/^\//, "").toLowerCase();
+    for (const n of this.files.keys()) if (n.toLowerCase() === key) return n;
+    return void 0;
+  }
+  has(name) {
+    return this.find(name) !== void 0;
+  }
+  text(name) {
+    const n = this.find(name);
+    return n === void 0 ? void 0 : fflate.strFromU8(this.files.get(n));
+  }
+  xml(name) {
+    const t = this.text(name);
+    return t === void 0 ? void 0 : parse(t, name);
+  }
+  setXml(name, root, contentType) {
+    this.files.set(this.find(name) ?? name, fflate.strToU8(serialize2(root)));
+    if (contentType) this.setContentType(name, contentType);
+  }
+  setBytes(name, bytes, contentType) {
+    this.files.set(this.find(name) ?? name, bytes);
+    if (contentType) this.setContentType(name, contentType);
+  }
+  remove(name) {
+    const n = this.find(name);
+    if (n === void 0) return;
+    this.files.delete(n);
+    this.types.children = this.types.children.filter(
+      (c) => !(typeof c !== "string" && c.name === "Override" && c.attrs.PartName.toLowerCase() === `/${n.toLowerCase()}`)
+    );
+    this.files.delete(relsName(n));
+  }
+  contentType(name) {
+    const part = `/${name.replace(/^\//, "")}`.toLowerCase();
+    const override = kids(this.types, "Override").find(
+      (o) => o.attrs.PartName.toLowerCase() === part
+    );
+    if (override) return override.attrs.ContentType;
+    const ext = part.slice(part.lastIndexOf(".") + 1);
+    return kids(this.types, "Default").find((d) => d.attrs.Extension.toLowerCase() === ext)?.attrs.ContentType;
+  }
+  setContentType(name, type) {
+    const part = `/${name.replace(/^\//, "")}`;
+    const override = kids(this.types, "Override").find(
+      (o) => o.attrs.PartName.toLowerCase() === part.toLowerCase()
+    );
+    if (override) override.attrs.ContentType = type;
+    else this.types.children.push(el("Override", { PartName: part, ContentType: type }));
+  }
+  /** A `Default` for an extension (media), unless one exists. */
+  ensureDefault(ext, type) {
+    if (!kids(this.types, "Default").some(
+      (d) => d.attrs.Extension.toLowerCase() === ext.toLowerCase()
+    ))
+      this.types.children.unshift(el("Default", { Extension: ext, ContentType: type }));
+  }
+  rels(owner) {
+    const root = this.xml(relsName(owner));
+    if (!root) return [];
+    return kids(root, "Relationship").map((r) => ({
+      id: r.attrs.Id,
+      type: r.attrs.Type,
+      target: r.attrs.Target,
+      external: r.attrs.TargetMode === "External"
+    }));
+  }
+  setRels(owner, rels) {
+    const root = el(
+      "Relationships",
+      { xmlns: "http://schemas.openxmlformats.org/package/2006/relationships" },
+      rels.map(
+        (r) => el("Relationship", {
+          Id: r.id,
+          Type: r.type,
+          Target: r.target,
+          ...r.external ? { TargetMode: "External" } : {}
+        })
+      )
+    );
+    this.setXml(relsName(owner), root);
+  }
+  /** Add a relationship from `owner`; returns its new id. */
+  addRel(owner, type, target, external = false) {
+    const rels = this.rels(owner);
+    const id = freshId(new Set(rels.map((r) => r.id)), "rIdT");
+    rels.push({ id, type, target, external });
+    this.setRels(owner, rels);
+    return id;
+  }
+  /** The part a relationship of `owner` points at (internal targets only). */
+  target(owner, rel) {
+    return resolveTarget(owner, rel.target);
+  }
+  /** The first internal part of a relationship type from `owner`. */
+  partOf(owner, type) {
+    const rel = this.rels(owner).find((r) => r.type === type && !r.external);
+    return rel && this.find(this.target(owner, rel));
+  }
+  /** The main document part (`word/document.xml` by convention). */
+  get main() {
+    const main = this.partOf("", RT.officeDocument);
+    if (!main) throw new TemplateError("not a Word package: no main document part");
+    return main;
+  }
+};
+function relsName(owner) {
+  const slash = owner.lastIndexOf("/");
+  return `${owner.slice(0, slash + 1)}_rels/${owner.slice(slash + 1)}.rels`;
+}
+function resolveTarget(owner, target) {
+  if (target.startsWith("/")) return target.slice(1);
+  const base = owner.slice(0, owner.lastIndexOf("/") + 1).split("/").filter(Boolean);
+  for (const seg of target.split("/")) {
+    if (seg === "..") base.pop();
+    else if (seg !== "." && seg !== "") base.push(seg);
+  }
+  return base.join("/");
+}
+function freshId(taken, prefix) {
+  for (let i = 1; ; i++) if (!taken.has(`${prefix}${i}`)) return `${prefix}${i}`;
+}
+
+// src/template/track.ts
+var TRACKED = /* @__PURE__ */ new Set(["w:ins", "w:del", "w:moveFrom", "w:moveTo"]);
+function trackInsertion(fragment, revision, covered) {
+  const pkg = Pkg.read(fragment);
+  const main = pkg.main;
+  const root = pkg.xml(main);
+  const body = kid(root, "w:body");
+  if (!root || !body) return fragment;
+  const attrs = { "w:id": "1", "w:author": revision.author, "w:date": revision.date };
+  const lastParagraph = body.children.filter(isEl).findLast((c) => c.name === "w:p");
+  const visit = (node) => {
+    node.children = node.children.map((child) => {
+      if (!isEl(child)) return child;
+      if (child.name === "w:r") return TRACKED.has(node.name) ? child : el("w:ins", attrs, [child]);
+      if (TRACKED.has(child.name)) return child;
+      if (child.name === "w:tr") {
+        markRow(child, attrs);
+        return child;
+      }
+      visit(child);
+      if (child.name === "w:p" && (covered || child !== lastParagraph)) markParagraph(child, attrs);
+      return child;
+    });
+  };
+  visit(body);
+  pkg.setXml(main, root);
+  return pkg.write();
+}
+function markParagraph(p, attrs) {
+  let pPr = kid(p, "w:pPr");
+  if (!pPr) p.children.unshift(pPr = el("w:pPr"));
+  let rPr = kid(pPr, "w:rPr");
+  if (!rPr) {
+    rPr = el("w:rPr");
+    const at = pPr.children.findIndex(
+      (c) => isEl(c) && (c.name === "w:sectPr" || c.name === "w:pPrChange")
+    );
+    pPr.children.splice(at < 0 ? pPr.children.length : at, 0, rPr);
+  }
+  if (!kid(rPr, "w:ins")) rPr.children.unshift(el("w:ins", attrs));
+}
+function markRow(tr, attrs) {
+  let trPr = kid(tr, "w:trPr");
+  if (!trPr) {
+    trPr = el("w:trPr");
+    const after = tr.children.findIndex((c) => isEl(c) && c.name === "w:tblPrEx");
+    tr.children.splice(after + 1, 0, trPr);
+  }
+  if (kid(trPr, "w:ins")) return;
+  const at = trPr.children.findIndex((c) => isEl(c) && c.name === "w:trPrChange");
+  trPr.children.splice(at < 0 ? trPr.children.length : at, 0, el("w:ins", attrs));
+}
+
+// src/commands/fragment.ts
+var CHARACTER_STYLES = {
+  [DEFINED_TERM_STYLE]: `<w:style w:type="character" w:customStyle="1" w:styleId="${DEFINED_TERM_STYLE}"><w:name w:val="Defined Term"/><w:rPr><w:u w:val="dotted" w:color="7F7F7F"/></w:rPr></w:style>`,
+  [CROSS_REFERENCE_STYLE]: `<w:style w:type="character" w:customStyle="1" w:styleId="${CROSS_REFERENCE_STYLE}"><w:name w:val="Cross Reference"/><w:rPr><w:color w:val="1F4E79"/><w:u w:val="dotted" w:color="8EA9C1"/></w:rPr></w:style>`,
+  [BROKEN_CROSS_REFERENCE_STYLE]: `<w:style w:type="character" w:customStyle="1" w:styleId="${BROKEN_CROSS_REFERENCE_STYLE}"><w:name w:val="Cross Reference Broken"/><w:basedOn w:val="${CROSS_REFERENCE_STYLE}"/><w:rPr><w:color w:val="C00000"/><w:u w:val="wave" w:color="C00000"/></w:rPr></w:style>`
+};
+function stylesUsed(body) {
+  return [...new Set([...body.matchAll(/<w:rStyle w:val="([^"]+)"/g)].map((m) => m[1]))];
+}
+var fragmentStyles = (ids) => stylesXml(
+  "",
+  `<w:style w:type="paragraph" w:default="1" w:styleId="Normal"><w:name w:val="Normal"/><w:qFormat/></w:style>${ids.map((id) => CHARACTER_STYLES[id] ?? "").join("")}`
+);
+function fragmentPackage(body, covered, {
+  revision,
+  relationships,
+  styles = stylesUsed(body)
+} = {}) {
+  const untracked = docxPackage({
+    document: documentXml(body),
+    styles: fragmentStyles(styles),
+    title: "Defined terms",
+    relationships
+  });
+  return revision ? trackInsertion(untracked, revision, covered) : untracked;
+}
+var attr2 = (node, name) => node.attributes?.find((a) => a.localName === name)?.value;
+function documentStyleIds(root) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const style of root?.children ?? [])
+    if (style.localName === "style") {
+      const id = attr2(style, "styleId");
+      if (id) ids.add(id);
+    }
+  return ids;
+}
+
 // src/rich.ts
-var WML = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+var WML2 = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
 var WRAPPERS = /* @__PURE__ */ new Set([
   "ins",
   "del",
@@ -45,24 +567,24 @@ var WRAPPERS = /* @__PURE__ */ new Set([
   "sdtContent"
 ]);
 var TEXT_ELEMENTS = /* @__PURE__ */ new Set(["t", "delText", "instrText"]);
-var isEl = (n) => typeof n !== "string";
-var isWml = (el, local) => el.ns === WML && el.local === local;
-function describe(el) {
-  const desc = { ns: el.ns, local: el.local, attrs: el.attrs, bindings: el.bindings };
-  if (el.prefix !== void 0) desc.prefix = el.prefix;
+var isEl2 = (n) => typeof n !== "string";
+var isWml = (el2, local) => el2.ns === WML2 && el2.local === local;
+function describe(el2) {
+  const desc = { ns: el2.ns, local: el2.local, attrs: el2.attrs, bindings: el2.bindings };
+  if (el2.prefix !== void 0) desc.prefix = el2.prefix;
   return desc;
 }
 function withChildren(desc, children, id) {
-  const el = {
+  const el2 = {
     ns: desc.ns,
     local: desc.local,
     attrs: desc.attrs,
     bindings: desc.bindings,
     children
   };
-  if (desc.prefix !== void 0) el.prefix = desc.prefix;
-  if (id !== void 0) el._id = id;
-  return el;
+  if (desc.prefix !== void 0) el2.prefix = desc.prefix;
+  if (id !== void 0) el2._id = id;
+  return el2;
 }
 var counter = 0;
 function newRunId() {
@@ -79,7 +601,7 @@ function encodeRun(run, wrappers, out) {
   let rPr = null;
   let start = 0;
   const first = children[0];
-  if (first !== void 0 && isEl(first) && isWml(first, "rPr")) {
+  if (first !== void 0 && isEl2(first) && isWml(first, "rPr")) {
     rPr = first;
     start = 1;
   }
@@ -87,9 +609,9 @@ function encodeRun(run, wrappers, out) {
   let produced = false;
   for (let i = start; i < children.length; i++) {
     const child = children[i];
-    if (!isEl(child)) fail();
+    if (!isEl2(child)) fail();
     const only = child.children[0];
-    if (child.ns === WML && TEXT_ELEMENTS.has(child.local) && child.children.length === 1 && typeof only === "string" && only.length > 0) {
+    if (child.ns === WML2 && TEXT_ELEMENTS.has(child.local) && child.children.length === 1 && typeof only === "string" && only.length > 0) {
       const tx = describe(child);
       for (let c = 0; c < only.length; c++) out.push({ v: only[c], a: { ...base, tx, k: null } });
     } else {
@@ -99,16 +621,16 @@ function encodeRun(run, wrappers, out) {
   }
   if (!produced)
     out.push({
-      v: { x: { ns: WML, local: "e", attrs: [], bindings: [], children: [] } },
+      v: { x: { ns: WML2, local: "e", attrs: [], bindings: [], children: [] } },
       a: { ...base, tx: null, k: "e" }
     });
 }
 function encodeInline(children, wrappers, out) {
   for (const child of children) {
-    if (!isEl(child)) fail();
-    if (child.ns === WML && child.local === "r") {
+    if (!isEl2(child)) fail();
+    if (child.ns === WML2 && child.local === "r") {
       encodeRun(child, wrappers, out);
-    } else if (child.ns === WML && WRAPPERS.has(child.local)) {
+    } else if (child.ns === WML2 && WRAPPERS.has(child.local)) {
       const before = out.length;
       const desc = { ...describe(child), head: [], id: child._id ?? newRunId() };
       let ok = true;
@@ -124,10 +646,10 @@ function encodeInline(children, wrappers, out) {
         out.length = before;
         out.push(atom(child, wrappers));
       }
-    } else if (child.ns === WML && child.local === "sdt") {
+    } else if (child.ns === WML2 && child.local === "sdt") {
       const last = child.children[child.children.length - 1];
       const head = child.children.slice(0, -1);
-      if (last !== void 0 && isEl(last) && isWml(last, "sdtContent") && head.every(isEl)) {
+      if (last !== void 0 && isEl2(last) && isWml(last, "sdtContent") && head.every(isEl2)) {
         const before = out.length;
         const sdt = {
           ...describe(child),
@@ -154,14 +676,14 @@ function encodeInline(children, wrappers, out) {
     }
   }
 }
-function atom(el, wrappers) {
-  return { v: { x: el }, a: { r: null, ra: null, ri: null, w: wrappers, tx: null, k: "a" } };
+function atom(el2, wrappers) {
+  return { v: { x: el2 }, a: { r: null, ra: null, ri: null, w: wrappers, tx: null, k: "a" } };
 }
 function encodeParagraph(children) {
   const head = [];
   let start = 0;
   const first = children[0];
-  if (first !== void 0 && isEl(first) && isWml(first, "pPr")) {
+  if (first !== void 0 && isEl2(first) && isWml(first, "pPr")) {
     head.push(first);
     start = 1;
   }
@@ -338,8 +860,8 @@ function writeUnits(text, units) {
 function isRichParagraph(map) {
   return map.has("inline");
 }
-function isParagraphEl(el) {
-  return el.ns === WML && el.local === "p";
+function isParagraphEl(el2) {
+  return el2.ns === WML2 && el2.local === "p";
 }
 function fieldsOf(map, xml) {
   map.set("ns", xml.ns);
@@ -361,7 +883,7 @@ function createRichParagraph(xml, encoded) {
   const map = new Y3__namespace.Map();
   fieldsOf(map, xml);
   const children = new Y3__namespace.Array();
-  children.push(encoded.head.map((el) => xmlToLive(el)));
+  children.push(encoded.head.map((el2) => xmlToLive(el2)));
   map.set("children", children);
   const inline = new Y3__namespace.Text();
   writeUnits(inline, encoded.units);
@@ -400,14 +922,14 @@ function liveToXml(map) {
 var escapeText = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 var escapeAttr = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/\t/g, "&#9;").replace(/\n/g, "&#10;").replace(/\r/g, "&#13;");
 var qualified = (prefix, local) => prefix ? `${prefix}:${local}` : local;
-function serializeXml(el, scope) {
+function serializeXml(el2, scope) {
   const inScope = new Map(scope);
-  for (const b of el.bindings) inScope.set(b.prefix, b.ns);
-  let out = `<${qualified(el.prefix, el.local)}`;
-  for (const b of el.bindings) {
+  for (const b of el2.bindings) inScope.set(b.prefix, b.ns);
+  let out = `<${qualified(el2.prefix, el2.local)}`;
+  for (const b of el2.bindings) {
     out += b.prefix === "" ? ` xmlns="${escapeAttr(b.ns)}"` : ` xmlns:${b.prefix}="${escapeAttr(b.ns)}"`;
   }
-  for (const a of el.attrs) {
+  for (const a of el2.attrs) {
     let p = a.prefix;
     if (a.ns !== "" && !p) {
       for (const [candidate, uri] of inScope) {
@@ -419,20 +941,20 @@ function serializeXml(el, scope) {
     }
     out += ` ${qualified(p, a.local)}="${escapeAttr(a.value)}"`;
   }
-  if (el.children.length === 0) return `${out}/>`;
+  if (el2.children.length === 0) return `${out}/>`;
   out += ">";
-  for (const child of el.children) {
+  for (const child of el2.children) {
     out += typeof child === "string" ? escapeText(child) : serializeXml(child, inScope);
   }
-  return `${out}</${qualified(el.prefix, el.local)}>`;
+  return `${out}</${qualified(el2.prefix, el2.local)}>`;
 }
-function serializeLive(el, scope) {
-  if (isRichParagraph(el)) return serializeXml(liveToXml(el), scope);
-  const prefix = el.get("prefix");
-  const local = el.get("local");
-  const bindings = el.get("bindings").toArray();
-  const attrs = el.get("attrs").toArray();
-  const children = el.get("children").toArray();
+function serializeLive(el2, scope) {
+  if (isRichParagraph(el2)) return serializeXml(liveToXml(el2), scope);
+  const prefix = el2.get("prefix");
+  const local = el2.get("local");
+  const bindings = el2.get("bindings").toArray();
+  const attrs = el2.get("attrs").toArray();
+  const children = el2.get("children").toArray();
   const inScope = new Map(scope);
   for (const b of bindings) inScope.set(b.prefix, b.ns);
   let out = `<${qualified(prefix, local)}`;
@@ -480,8 +1002,8 @@ function canonicalToXml(node) {
   if (node.prefix !== void 0) xml.prefix = node.prefix;
   return xml;
 }
-function encodeElement(el) {
-  return xmlToLive(canonicalToXml(el));
+function encodeElement(el2) {
+  return xmlToLive(canonicalToXml(el2));
 }
 function bootstrap(doc, pkg) {
   doc.transact(() => {
@@ -666,14 +1188,14 @@ function materialize(doc, cache, changed = null) {
         sinkSafe: store.validateExternalTarget(r.rawTarget).ok
       });
     }
-    const relsName = store.relsPartNameFor(owner);
+    const relsName2 = store.relsPartNameFor(owner);
     const read = store.readOoxmlPart(relationshipsXml(records), {
-      name: relsName,
+      name: relsName2,
       contentType: RELS_CONTENT_TYPE
     });
     if (!read.ok)
       throw new MaterializeError(`relationships of ${owner} are not valid: ${read.reason}`);
-    parts.set(relsName, read.part);
+    parts.set(relsName2, read.part);
   }
   const contentTypes = {
     defaults: new Map(doc.getMap("ctDefaults")),
@@ -739,14 +1261,14 @@ var RegistryError = class extends Error {
     this.name = "RegistryError";
   }
 };
-function childrenOf(el) {
-  return el.get("children");
+function childrenOf(el2) {
+  return el2.get("children");
 }
-function attrsOf(el) {
-  return el.get("attrs");
+function attrsOf(el2) {
+  return el2.get("attrs");
 }
-function bindingsOf(el) {
-  return el.get("bindings");
+function bindingsOf(el2) {
+  return el2.get("bindings");
 }
 var IDENTIFIED = /* @__PURE__ */ new Set([
   "r",
@@ -773,7 +1295,7 @@ function plainToXml(node) {
     children: node.children.map(plainToXml)
   };
   if (node.prefix !== void 0) xml.prefix = node.prefix;
-  if (node.ns === WML && IDENTIFIED.has(node.local)) {
+  if (node.ns === WML2 && IDENTIFIED.has(node.local)) {
     node.rid ??= newRunId();
     xml._id = node.rid;
   }
@@ -974,7 +1496,7 @@ var NodeRegistry = class {
     const stored = head.toArray().map((child) => liveToXml(child));
     if (JSON.stringify(stored) !== JSON.stringify(encoded.head)) {
       head.delete(0, head.length);
-      head.push(encoded.head.map((el) => xmlToLive(el)));
+      head.push(encoded.head.map((el2) => xmlToLive(el2)));
     }
     const inline = live.get("inline");
     applyUnits(inline, readUnits(inline), encoded.units);
@@ -1108,14 +1630,14 @@ function attrJson(qname, value) {
 function setAttribute(registry, id, qname, value) {
   const entry = registry.require(id);
   if ("plain" in entry) {
-    const el = asPlainElement(entry.plain, id);
-    const index2 = el.attrs.findIndex((a) => sameAttr(a, qname));
+    const el2 = asPlainElement(entry.plain, id);
+    const index2 = el2.attrs.findIndex((a) => sameAttr(a, qname));
     if (value === null) {
-      if (index2 >= 0) el.attrs.splice(index2, 1);
+      if (index2 >= 0) el2.attrs.splice(index2, 1);
     } else if (index2 >= 0) {
-      el.attrs[index2] = attrJson(qname, value);
+      el2.attrs[index2] = attrJson(qname, value);
     } else {
-      el.attrs.push(attrJson(qname, value));
+      el2.attrs.push(attrJson(qname, value));
     }
     return;
   }
@@ -1131,12 +1653,12 @@ function setNamespaceBinding(registry, id, prefix, uri) {
   const entry = registry.require(id);
   const binding = uri === null ? null : { prefix, ns: uri };
   if ("plain" in entry) {
-    const el = asPlainElement(entry.plain, id);
-    const index2 = el.bindings.findIndex((b) => b.prefix === prefix);
-    if (index2 >= 0) el.bindings.splice(index2, 1);
+    const el2 = asPlainElement(entry.plain, id);
+    const index2 = el2.bindings.findIndex((b) => b.prefix === prefix);
+    if (index2 >= 0) el2.bindings.splice(index2, 1);
     if (binding) {
-      if (index2 >= 0) el.bindings.splice(index2, 0, binding);
-      else el.bindings.push(binding);
+      if (index2 >= 0) el2.bindings.splice(index2, 0, binding);
+      else el2.bindings.push(binding);
     }
     return;
   }
@@ -1859,8 +2381,8 @@ function openRoomStore(options) {
     return {
       store: store$1,
       session,
-      transact(build) {
-        const result = store$1.transact({ kind: "body" }, build, {
+      transact(build, scope = { kind: "body" }) {
+        const result = store$1.transact(scope, build, {
           origin: store.ORIGIN_IDS.mutationAgent,
           actorId: options.identity.actorId,
           recordsHistory: false
@@ -1893,6 +2415,93 @@ function openRoomStore(options) {
     throw error;
   }
 }
+function roomCommandsPort(room, { revision, actorId } = {}) {
+  const view = () => room.view();
+  const root = () => view().part().root;
+  const numbering = () => documentNumbering({
+    root,
+    stylesRoot: () => view().stylesRoot(),
+    numberingRoot: () => view().numberingRoot(),
+    settingsRoot: () => view().settingsRoot()
+  });
+  let caret = null;
+  const at = () => {
+    if (!caret) throw new Error("No position to write at.");
+    return caret;
+  };
+  const apply = (op) => {
+    const result = room.transact((ctx) => {
+      ctx.apply(op);
+    });
+    if (!result.ok) throw new Error(`The editor refused the change (${op.op}).`);
+  };
+  const find = (node, id) => {
+    if (node.id === id) return node;
+    for (const child of node.children ?? []) {
+      const found = find(child, id);
+      if (found) return found;
+    }
+    return void 0;
+  };
+  return {
+    paragraphs: () => readParagraphs(root()),
+    caret: () => caret,
+    setCaret: (point) => {
+      caret = point;
+    },
+    deleteRange: (from, to) => {
+      if (from.paragraphId !== to.paragraphId) throw new Error("A deletion stays in one paragraph.");
+      apply({
+        op: "deleteText",
+        paragraphId: from.paragraphId,
+        start: from.offset,
+        end: to.offset,
+        ...revision ? { revision } : {}
+      });
+    },
+    paste: (body, _text, covered, relationships) => {
+      const point = at();
+      const defined = documentStyleIds(view().stylesRoot());
+      const styles = stylesUsed(body).filter((id) => !defined.has(id));
+      const result = room.store.applyFragmentPaste(
+        { kind: "body" },
+        {
+          paragraphId: point.paragraphId,
+          offset: point.offset,
+          fragmentBytes: fragmentPackage(body, covered, { revision, relationships, styles }),
+          lastMarkCovered: covered,
+          actorId
+        }
+      );
+      if (result.ok) room.flush();
+      return result.ok;
+    },
+    splitParagraph: () => {
+      const point = at();
+      apply({ op: "splitParagraph", paragraphId: point.paragraphId, offset: point.offset });
+      const paragraphs = readParagraphs(root());
+      const next = paragraphs[paragraphs.findIndex((p) => p.id === point.paragraphId) + 1];
+      caret = next ? { paragraphId: next.id, offset: 0 } : point;
+    },
+    typeText: (text) => {
+      const point = at();
+      apply({
+        op: "insertText",
+        paragraphId: point.paragraphId,
+        offset: point.offset,
+        text,
+        ...revision ? { revision } : {}
+      });
+      caret = { paragraphId: point.paragraphId, offset: point.offset + text.length };
+    },
+    listItems: () => numbering().listItems(),
+    levelOf: (numId, ilvl) => numbering().levelOf(numId, ilvl),
+    runsXml: (paragraphId) => {
+      const node = find(root(), paragraphId);
+      return node ? paragraphRunsXml(node) : null;
+    }
+  };
+}
 
 exports.COLLAB_PROTOCOL = COLLAB_PROTOCOL;
 exports.CollaborationCompatibilityError = CollaborationCompatibilityError;
@@ -1903,6 +2512,7 @@ exports.normalizeDocx = normalizeDocx;
 exports.openRoomAutomation = openRoomAutomation;
 exports.openRoomStore = openRoomStore;
 exports.readRoom = readRoom;
+exports.roomCommandsPort = roomCommandsPort;
 exports.seedRoom = seedRoom;
 //# sourceMappingURL=server.cjs.map
 //# sourceMappingURL=server.cjs.map