@shadow-garden/bapbong-model 0.5.0 → 0.7.0

package/dist/index.cjs

@@ -20,12 +20,55 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // packages/model/src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  anchorName: () => anchorName,
+  bookmarkLabel: () => bookmarkLabel,
   commentSchema: () => commentSchema,
   createNumberingCounter: () => createNumberingCounter,
+  fieldAt: () => fieldAt,
+  findBookmark: () => findBookmark,
   schema: () => schema
 });
 module.exports = __toCommonJS(index_exports);
 
+// packages/model/src/lib/bookmarks.ts
+function anchorName(href) {
+  return href && href.startsWith("#") && href.length > 1 ? href.slice(1) : null;
+}
+function findBookmark(doc, name) {
+  let found = null;
+  doc.descendants((node, pos) => {
+    if (found !== null) return false;
+    if (node.type.name !== "paragraph") return true;
+    const names = node.attrs["bookmarks"];
+    if (names?.includes(name)) found = pos + 1;
+    return false;
+  });
+  return found;
+}
+function bookmarkLabel(doc, name, max = 60) {
+  const pos = findBookmark(doc, name);
+  if (pos === null) return null;
+  const para = doc.nodeAt(pos - 1);
+  const text = (para?.textContent ?? "").replace(/^[\s.:–—-]+/, "").trim();
+  if (!text) return null;
+  return text.length > max ? `${text.slice(0, max - 1)}\u2026` : text;
+}
+function fieldAt(doc, pos) {
+  let hit = null;
+  let run = null;
+  doc.forEach((node, offset) => {
+    const f = node.attrs["field"];
+    if (f && run && run.field === f) {
+      run.to = offset + node.nodeSize;
+    } else {
+      if (run && hit === run) return;
+      run = f ? { field: f, from: offset, to: offset + node.nodeSize } : null;
+    }
+    if (run && hit === null && pos >= run.from && pos <= run.to) hit = run;
+  });
+  return hit;
+}
+
 // packages/model/src/lib/model.ts
 var import_prosemirror_model = require("prosemirror-model");
 function dataJson(el, name) {
@@ -43,7 +86,8 @@ function pastedParagraphAttrs(el, heading) {
   return {
     heading,
     align: m ? m[1].toLowerCase() : null,
-    borders: dataJson(el, "data-borders")
+    borders: dataJson(el, "data-borders"),
+    carry: dataJson(el, "data-carry")
   };
 }
 function pastedImageAttrs(el) {
@@ -80,7 +124,8 @@ function pastedCellAttrs(el) {
     background: bg ? bg[1].trim() : null,
     vAlign: e.getAttribute("data-valign"),
     borders: dataJson(el, "data-borders"),
-    padding: dataJson(el, "data-padding")
+    padding: dataJson(el, "data-padding"),
+    carry: dataJson(el, "data-carry")
   };
 }
 var schema = new import_prosemirror_model.Schema({
@@ -132,11 +177,33 @@ var schema = new import_prosemirror_model.Schema({
         tabs: { default: null },
         // w:spacing — { before?, after?, line?, lineRule? }, or null.
         spacing: { default: null },
+        // w:bookmarkStart names anchored in this paragraph (["_Toc89595219"]),
+        // or null. Link hrefs of the form "#name" resolve against these —
+        // paragraph-level is the right altitude: Word's TOC bookmarks wrap a
+        // heading's text, and jumping to the heading is what a reader wants.
+        bookmarks: { default: null },
+        // The generated field this paragraph belongs to ({ kind: 'toc',
+        // instr } for a TOC entry), or null for ordinary content. Word paints
+        // such content with field shading and regenerates it on update.
+        field: { default: null },
         // w:pageBreakBefore — start this paragraph on a new page.
         pageBreakBefore: { default: false },
+        // w:keepNext — stay on the same page as the next block's first line.
+        keepNext: { default: false },
+        // w:keepLines — never split this paragraph across pages.
+        keepLines: { default: false },
+        // w:widowControl — Word's default is ON; false only when the document
+        // explicitly disables widow/orphan control for this paragraph.
+        widowControl: { default: true },
         // w:pBdr — { top?, bottom?, left?, right? } of BorderSide, or null.
         // Importer-set; painted as a box around the paragraph's lines.
-        borders: { default: null }
+        borders: { default: null },
+        // Carry-through fidelity (docx round-trip): OOXML paragraph
+        // properties the model does NOT represent, preserved verbatim so a
+        // customer's save never drops them. { pPr?: string, markRPr?: string }
+        // — raw XML fragments (pPr extras / the paragraph-mark w:rPr), or
+        // null. Importer-set; the exporter splices them back into w:pPr.
+        carry: { default: null }
       },
       // HTML paste path: recover heading level from h1–h6 and alignment from
       // inline style. Other attrs (list/indent/tabs/spacing) stay importer-only
@@ -156,6 +223,8 @@ var schema = new import_prosemirror_model.Schema({
         if (attrs.styleId) dom["data-style"] = attrs.styleId;
         if (node.attrs["borders"])
           dom["data-borders"] = JSON.stringify(node.attrs["borders"]);
+        if (node.attrs["carry"])
+          dom["data-carry"] = JSON.stringify(node.attrs["carry"]);
         return [tag, dom, 0];
       }
     },
@@ -237,7 +306,12 @@ var schema = new import_prosemirror_model.Schema({
         // insideV }, or null — OOXML tables are borderless unless declared.
         borders: { default: null },
         // w:tblPr/w:jc — 'center' | 'right' table alignment, or null (left).
-        align: { default: null }
+        align: { default: null },
+        // Carry-through fidelity: unmodelled w:tblPr children (tblStyle,
+        // tblLayout, tblLook, tblInd, floating tblpPr, …) as one raw XML
+        // string ({ tblPr: string }), or null. Importer-set; the exporter
+        // splices it back so a save never drops them.
+        carry: { default: null }
       },
       // Complex attrs round-trip as data-* JSON — ProseMirror's clipboard is
       // a toDOM → parseDOM pass, so without this an internal copy/paste
@@ -248,7 +322,8 @@ var schema = new import_prosemirror_model.Schema({
           getAttrs: (el) => ({
             borders: dataJson(el, "data-borders"),
             cellPadding: dataJson(el, "data-cell-padding"),
-            align: el.getAttribute("data-align")
+            align: el.getAttribute("data-align"),
+            carry: dataJson(el, "data-carry")
           })
         }
       ],
@@ -259,6 +334,7 @@ var schema = new import_prosemirror_model.Schema({
         if (a["cellPadding"])
           dom["data-cell-padding"] = JSON.stringify(a["cellPadding"]);
         if (a["align"]) dom["data-align"] = String(a["align"]);
+        if (a["carry"]) dom["data-carry"] = JSON.stringify(a["carry"]);
         return ["table", dom, ["tbody", 0]];
       }
     },
@@ -271,7 +347,10 @@ var schema = new import_prosemirror_model.Schema({
         // (Word's default) means the paginator may split the row mid-content.
         cantSplit: { default: false },
         // w:trHeight — { value: px, exact: boolean } or null (auto).
-        height: { default: null }
+        height: { default: null },
+        // Carry-through fidelity: unmodelled w:trPr children ({ trPr: string
+        // } — gridBefore/wBefore, cnfStyle, …), or null. Importer-set.
+        carry: { default: null }
       },
       parseDOM: [
         {
@@ -279,7 +358,8 @@ var schema = new import_prosemirror_model.Schema({
           getAttrs: (el) => ({
             header: el.getAttribute("data-header") === "true",
             cantSplit: el.getAttribute("data-cant-split") === "true",
-            height: dataJson(el, "data-height")
+            height: dataJson(el, "data-height"),
+            carry: dataJson(el, "data-carry")
           })
         }
       ],
@@ -289,6 +369,8 @@ var schema = new import_prosemirror_model.Schema({
         if (node.attrs["cantSplit"]) dom["data-cant-split"] = "true";
         if (node.attrs["height"])
           dom["data-height"] = JSON.stringify(node.attrs["height"]);
+        if (node.attrs["carry"])
+          dom["data-carry"] = JSON.stringify(node.attrs["carry"]);
         return ["tr", dom, 0];
       }
     },
@@ -306,8 +388,11 @@ var schema = new import_prosemirror_model.Schema({
         // w:vAlign — 'center' | 'bottom' (top default)
         borders: { default: null },
         // w:tcBorders per-side visibility override
-        padding: { default: null }
+        padding: { default: null },
         // w:tcMar per-side margin override (px)
+        // Carry-through fidelity: unmodelled w:tcPr children ({ tcPr: string
+        // } — textDirection, noWrap, tcFitText, …), or null. Importer-set.
+        carry: { default: null }
       },
       parseDOM: [
         { tag: "td", getAttrs: pastedCellAttrs },
@@ -329,6 +414,8 @@ var schema = new import_prosemirror_model.Schema({
           attrs["data-borders"] = JSON.stringify(node.attrs["borders"]);
         if (node.attrs["padding"])
           attrs["data-padding"] = JSON.stringify(node.attrs["padding"]);
+        if (node.attrs["carry"])
+          attrs["data-carry"] = JSON.stringify(node.attrs["carry"]);
         return ["td", attrs, 0];
       }
     }
@@ -354,6 +441,32 @@ var schema = new import_prosemirror_model.Schema({
       parseDOM: [{ tag: "s" }, { tag: "strike" }],
       toDOM: () => ["s", 0]
     },
+    // w:dstrike — double strikethrough
+    dstrike: {
+      parseDOM: [
+        {
+          style: "text-decoration-style=double",
+          getAttrs: (value) => value === "double" ? {} : false
+        }
+      ],
+      toDOM: () => [
+        "span",
+        {
+          style: "text-decoration: line-through; text-decoration-style: double"
+        },
+        0
+      ]
+    },
+    // w:smallCaps
+    smallCaps: {
+      parseDOM: [
+        {
+          style: "font-variant-caps",
+          getAttrs: (value) => value === "small-caps" ? {} : false
+        }
+      ],
+      toDOM: () => ["span", { style: "font-variant-caps: small-caps" }, 0]
+    },
     // w:color — hex "#RRGGBB"
     textColor: {
       attrs: { color: {} },
@@ -475,6 +588,28 @@ var schema = new import_prosemirror_model.Schema({
           0
         ];
       }
+    },
+    // Carry-through fidelity (docx round-trip): run properties the model does
+    // NOT represent (w:rtl, w:kern, w:szCs, …), preserved verbatim as one raw
+    // XML fragment so saving a customer's file never drops them. Invisible —
+    // no rendering; the docx exporter splices `xml` back into the run's rPr.
+    // Typing inside/at the edge of a carried run extends the mark (inclusive
+    // default), which is the faithful behavior for properties like w:rtl.
+    carryRPr: {
+      attrs: { xml: {} },
+      toDOM(mark) {
+        return ["span", { "data-carry-rpr": String(mark.attrs["xml"]) }, 0];
+      },
+      parseDOM: [
+        {
+          tag: "span[data-carry-rpr]",
+          getAttrs: (el) => ({
+            xml: el.getAttribute(
+              "data-carry-rpr"
+            ) ?? ""
+          })
+        }
+      ]
     }
     // The `comment` mark (w:commentRangeStart/End) is contributed by the comment
     // plugin (@shadow-garden/bapbong-comments) via the editor's schema
@@ -614,14 +749,19 @@ function createNumberingCounter(defs) {
     return lvlDef.lvlText.replace(/%(\d)/g, (_match, digit) => {
       const lvl = Number(digit) - 1;
       const value = arr[lvl] ?? startOf(lvl);
-      return formatCounter(value, def.levels[lvl]?.numFmt ?? "decimal");
+      const fmt = lvlDef.isLgl ? "decimal" : def.levels[lvl]?.numFmt ?? "decimal";
+      return formatCounter(value, fmt);
     });
   }
-  return { next };
+  return { next, def: (numId, level) => defs?.[numId]?.levels[level] };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  anchorName,
+  bookmarkLabel,
   commentSchema,
   createNumberingCounter,
+  fieldAt,
+  findBookmark,
   schema
 });

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './lib/bookmarks.js';
 export * from './lib/model.js';
 export * from './lib/numbering.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,3 +1,42 @@
+// packages/model/src/lib/bookmarks.ts
+function anchorName(href) {
+  return href && href.startsWith("#") && href.length > 1 ? href.slice(1) : null;
+}
+function findBookmark(doc, name) {
+  let found = null;
+  doc.descendants((node, pos) => {
+    if (found !== null) return false;
+    if (node.type.name !== "paragraph") return true;
+    const names = node.attrs["bookmarks"];
+    if (names?.includes(name)) found = pos + 1;
+    return false;
+  });
+  return found;
+}
+function bookmarkLabel(doc, name, max = 60) {
+  const pos = findBookmark(doc, name);
+  if (pos === null) return null;
+  const para = doc.nodeAt(pos - 1);
+  const text = (para?.textContent ?? "").replace(/^[\s.:–—-]+/, "").trim();
+  if (!text) return null;
+  return text.length > max ? `${text.slice(0, max - 1)}\u2026` : text;
+}
+function fieldAt(doc, pos) {
+  let hit = null;
+  let run = null;
+  doc.forEach((node, offset) => {
+    const f = node.attrs["field"];
+    if (f && run && run.field === f) {
+      run.to = offset + node.nodeSize;
+    } else {
+      if (run && hit === run) return;
+      run = f ? { field: f, from: offset, to: offset + node.nodeSize } : null;
+    }
+    if (run && hit === null && pos >= run.from && pos <= run.to) hit = run;
+  });
+  return hit;
+}
+
 // packages/model/src/lib/model.ts
 import { Schema } from "prosemirror-model";
 function dataJson(el, name) {
@@ -15,7 +54,8 @@ function pastedParagraphAttrs(el, heading) {
   return {
     heading,
     align: m ? m[1].toLowerCase() : null,
-    borders: dataJson(el, "data-borders")
+    borders: dataJson(el, "data-borders"),
+    carry: dataJson(el, "data-carry")
   };
 }
 function pastedImageAttrs(el) {
@@ -52,7 +92,8 @@ function pastedCellAttrs(el) {
     background: bg ? bg[1].trim() : null,
     vAlign: e.getAttribute("data-valign"),
     borders: dataJson(el, "data-borders"),
-    padding: dataJson(el, "data-padding")
+    padding: dataJson(el, "data-padding"),
+    carry: dataJson(el, "data-carry")
   };
 }
 var schema = new Schema({
@@ -104,11 +145,33 @@ var schema = new Schema({
         tabs: { default: null },
         // w:spacing — { before?, after?, line?, lineRule? }, or null.
         spacing: { default: null },
+        // w:bookmarkStart names anchored in this paragraph (["_Toc89595219"]),
+        // or null. Link hrefs of the form "#name" resolve against these —
+        // paragraph-level is the right altitude: Word's TOC bookmarks wrap a
+        // heading's text, and jumping to the heading is what a reader wants.
+        bookmarks: { default: null },
+        // The generated field this paragraph belongs to ({ kind: 'toc',
+        // instr } for a TOC entry), or null for ordinary content. Word paints
+        // such content with field shading and regenerates it on update.
+        field: { default: null },
         // w:pageBreakBefore — start this paragraph on a new page.
         pageBreakBefore: { default: false },
+        // w:keepNext — stay on the same page as the next block's first line.
+        keepNext: { default: false },
+        // w:keepLines — never split this paragraph across pages.
+        keepLines: { default: false },
+        // w:widowControl — Word's default is ON; false only when the document
+        // explicitly disables widow/orphan control for this paragraph.
+        widowControl: { default: true },
         // w:pBdr — { top?, bottom?, left?, right? } of BorderSide, or null.
         // Importer-set; painted as a box around the paragraph's lines.
-        borders: { default: null }
+        borders: { default: null },
+        // Carry-through fidelity (docx round-trip): OOXML paragraph
+        // properties the model does NOT represent, preserved verbatim so a
+        // customer's save never drops them. { pPr?: string, markRPr?: string }
+        // — raw XML fragments (pPr extras / the paragraph-mark w:rPr), or
+        // null. Importer-set; the exporter splices them back into w:pPr.
+        carry: { default: null }
       },
       // HTML paste path: recover heading level from h1–h6 and alignment from
       // inline style. Other attrs (list/indent/tabs/spacing) stay importer-only
@@ -128,6 +191,8 @@ var schema = new Schema({
         if (attrs.styleId) dom["data-style"] = attrs.styleId;
         if (node.attrs["borders"])
           dom["data-borders"] = JSON.stringify(node.attrs["borders"]);
+        if (node.attrs["carry"])
+          dom["data-carry"] = JSON.stringify(node.attrs["carry"]);
         return [tag, dom, 0];
       }
     },
@@ -209,7 +274,12 @@ var schema = new Schema({
         // insideV }, or null — OOXML tables are borderless unless declared.
         borders: { default: null },
         // w:tblPr/w:jc — 'center' | 'right' table alignment, or null (left).
-        align: { default: null }
+        align: { default: null },
+        // Carry-through fidelity: unmodelled w:tblPr children (tblStyle,
+        // tblLayout, tblLook, tblInd, floating tblpPr, …) as one raw XML
+        // string ({ tblPr: string }), or null. Importer-set; the exporter
+        // splices it back so a save never drops them.
+        carry: { default: null }
       },
       // Complex attrs round-trip as data-* JSON — ProseMirror's clipboard is
       // a toDOM → parseDOM pass, so without this an internal copy/paste
@@ -220,7 +290,8 @@ var schema = new Schema({
           getAttrs: (el) => ({
             borders: dataJson(el, "data-borders"),
             cellPadding: dataJson(el, "data-cell-padding"),
-            align: el.getAttribute("data-align")
+            align: el.getAttribute("data-align"),
+            carry: dataJson(el, "data-carry")
           })
         }
       ],
@@ -231,6 +302,7 @@ var schema = new Schema({
         if (a["cellPadding"])
           dom["data-cell-padding"] = JSON.stringify(a["cellPadding"]);
         if (a["align"]) dom["data-align"] = String(a["align"]);
+        if (a["carry"]) dom["data-carry"] = JSON.stringify(a["carry"]);
         return ["table", dom, ["tbody", 0]];
       }
     },
@@ -243,7 +315,10 @@ var schema = new Schema({
         // (Word's default) means the paginator may split the row mid-content.
         cantSplit: { default: false },
         // w:trHeight — { value: px, exact: boolean } or null (auto).
-        height: { default: null }
+        height: { default: null },
+        // Carry-through fidelity: unmodelled w:trPr children ({ trPr: string
+        // } — gridBefore/wBefore, cnfStyle, …), or null. Importer-set.
+        carry: { default: null }
       },
       parseDOM: [
         {
@@ -251,7 +326,8 @@ var schema = new Schema({
           getAttrs: (el) => ({
             header: el.getAttribute("data-header") === "true",
             cantSplit: el.getAttribute("data-cant-split") === "true",
-            height: dataJson(el, "data-height")
+            height: dataJson(el, "data-height"),
+            carry: dataJson(el, "data-carry")
           })
         }
       ],
@@ -261,6 +337,8 @@ var schema = new Schema({
         if (node.attrs["cantSplit"]) dom["data-cant-split"] = "true";
         if (node.attrs["height"])
           dom["data-height"] = JSON.stringify(node.attrs["height"]);
+        if (node.attrs["carry"])
+          dom["data-carry"] = JSON.stringify(node.attrs["carry"]);
         return ["tr", dom, 0];
       }
     },
@@ -278,8 +356,11 @@ var schema = new Schema({
         // w:vAlign — 'center' | 'bottom' (top default)
         borders: { default: null },
         // w:tcBorders per-side visibility override
-        padding: { default: null }
+        padding: { default: null },
         // w:tcMar per-side margin override (px)
+        // Carry-through fidelity: unmodelled w:tcPr children ({ tcPr: string
+        // } — textDirection, noWrap, tcFitText, …), or null. Importer-set.
+        carry: { default: null }
       },
       parseDOM: [
         { tag: "td", getAttrs: pastedCellAttrs },
@@ -301,6 +382,8 @@ var schema = new Schema({
           attrs["data-borders"] = JSON.stringify(node.attrs["borders"]);
         if (node.attrs["padding"])
           attrs["data-padding"] = JSON.stringify(node.attrs["padding"]);
+        if (node.attrs["carry"])
+          attrs["data-carry"] = JSON.stringify(node.attrs["carry"]);
         return ["td", attrs, 0];
       }
     }
@@ -326,6 +409,32 @@ var schema = new Schema({
       parseDOM: [{ tag: "s" }, { tag: "strike" }],
       toDOM: () => ["s", 0]
     },
+    // w:dstrike — double strikethrough
+    dstrike: {
+      parseDOM: [
+        {
+          style: "text-decoration-style=double",
+          getAttrs: (value) => value === "double" ? {} : false
+        }
+      ],
+      toDOM: () => [
+        "span",
+        {
+          style: "text-decoration: line-through; text-decoration-style: double"
+        },
+        0
+      ]
+    },
+    // w:smallCaps
+    smallCaps: {
+      parseDOM: [
+        {
+          style: "font-variant-caps",
+          getAttrs: (value) => value === "small-caps" ? {} : false
+        }
+      ],
+      toDOM: () => ["span", { style: "font-variant-caps: small-caps" }, 0]
+    },
     // w:color — hex "#RRGGBB"
     textColor: {
       attrs: { color: {} },
@@ -447,6 +556,28 @@ var schema = new Schema({
           0
         ];
       }
+    },
+    // Carry-through fidelity (docx round-trip): run properties the model does
+    // NOT represent (w:rtl, w:kern, w:szCs, …), preserved verbatim as one raw
+    // XML fragment so saving a customer's file never drops them. Invisible —
+    // no rendering; the docx exporter splices `xml` back into the run's rPr.
+    // Typing inside/at the edge of a carried run extends the mark (inclusive
+    // default), which is the faithful behavior for properties like w:rtl.
+    carryRPr: {
+      attrs: { xml: {} },
+      toDOM(mark) {
+        return ["span", { "data-carry-rpr": String(mark.attrs["xml"]) }, 0];
+      },
+      parseDOM: [
+        {
+          tag: "span[data-carry-rpr]",
+          getAttrs: (el) => ({
+            xml: el.getAttribute(
+              "data-carry-rpr"
+            ) ?? ""
+          })
+        }
+      ]
     }
     // The `comment` mark (w:commentRangeStart/End) is contributed by the comment
     // plugin (@shadow-garden/bapbong-comments) via the editor's schema
@@ -586,13 +717,18 @@ function createNumberingCounter(defs) {
     return lvlDef.lvlText.replace(/%(\d)/g, (_match, digit) => {
       const lvl = Number(digit) - 1;
       const value = arr[lvl] ?? startOf(lvl);
-      return formatCounter(value, def.levels[lvl]?.numFmt ?? "decimal");
+      const fmt = lvlDef.isLgl ? "decimal" : def.levels[lvl]?.numFmt ?? "decimal";
+      return formatCounter(value, fmt);
     });
   }
-  return { next };
+  return { next, def: (numId, level) => defs?.[numId]?.levels[level] };
 }
 export {
+  anchorName,
+  bookmarkLabel,
   commentSchema,
   createNumberingCounter,
+  fieldAt,
+  findBookmark,
   schema
 };

package/dist/lib/bookmarks.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Bookmarks and generated fields — the two things that make a table of
+ * contents behave like Word's rather than like a list of ordinary links.
+ *
+ * A `w:bookmarkStart` names a place in the document; a hyperlink whose href
+ * is `#name` points at it. Word's TOC wires every entry this way, with
+ * machine-generated `_Toc…` names it never shows the reader. Bookmarks ride
+ * the paragraph that contains them (see model.ts `bookmarks`), so they move
+ * with their heading through edits instead of decaying into stale offsets.
+ */
+import type { Node as PMNode } from 'prosemirror-model';
+/** A generated field's identity, as it rides a paragraph's `field` attr. */
+export interface FieldInfo {
+    /** Field kind — only 'toc' is modelled today. */
+    kind: string;
+    /** The field instruction, e.g. `TOC \o "1-3" \h \z \u`. */
+    instr: string;
+}
+/** An href pointing inside this document (`#name`) → the bookmark name, or
+ *  null for external/absent links. */
+export declare function anchorName(href: string | null | undefined): string | null;
+/** Position of the paragraph anchoring `name`, or null when no paragraph
+ *  claims it (a stale link, or a bookmark outside a paragraph). The position
+ *  is the paragraph's first content slot — where a caret should land. */
+export declare function findBookmark(doc: PMNode, name: string): number | null;
+/** The text a reader should see for an internal link — the target paragraph's
+ *  own text, trimmed to `max` — or null when the target is missing. Beats the
+ *  raw `_Toc89595219`, which is machine bookkeeping. */
+export declare function bookmarkLabel(doc: PMNode, name: string, max?: number): string | null;
+/** The field a position sits inside, with the full paragraph range it spans,
+ *  or null. A field covers CONSECUTIVE paragraphs carrying the same `field`
+ *  attr object — the importer stamps one shared object per field, so identity
+ *  distinguishes two adjacent TOCs. */
+export declare function fieldAt(doc: PMNode, pos: number): {
+    field: FieldInfo;
+    from: number;
+    to: number;
+} | null;
+//# sourceMappingURL=bookmarks.d.ts.map

package/dist/lib/bookmarks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookmarks.d.ts","sourceRoot":"","sources":["../../src/lib/bookmarks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAExD,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf;AAED;sCACsC;AACtC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAEzE;AAED;;yEAEyE;AACzE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUrE;AAED;;wDAEwD;AACxD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,GAAG,SAAK,GACP,MAAM,GAAG,IAAI,CAUf;AAED;;;uCAGuC;AACvC,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkBvD"}

package/dist/lib/model.d.ts

@@ -8,7 +8,7 @@ import { Schema } from 'prosemirror-model';
  * extend THIS schema so the importer, layout engine, and (canvas) painter all
  * agree on one document model.
  */
-export declare const schema: Schema<"doc" | "paragraph" | "text" | "hard_break" | "image" | "page_field" | "table" | "table_row" | "table_cell", "strong" | "em" | "underline" | "strike" | "textColor" | "fontSize" | "vertAlign" | "highlight" | "fontFamily" | "link" | "footnote">;
+export declare const schema: Schema<"paragraph" | "doc" | "text" | "hard_break" | "image" | "page_field" | "table" | "table_row" | "table_cell", "strong" | "em" | "underline" | "strike" | "dstrike" | "smallCaps" | "textColor" | "fontSize" | "vertAlign" | "highlight" | "fontFamily" | "link" | "footnote" | "carryRPr">;
 /** Concrete schema type, handy for typing Node/Mark across packages. */
 export type BapbongSchema = typeof schema;
 /**
@@ -17,7 +17,7 @@ export type BapbongSchema = typeof schema;
  * (@user). Comment bodies are stored as this schema's JSON on the comment
  * thread, kept separate from the document schema.
  */
-export declare const commentSchema: Schema<"doc" | "paragraph" | "text" | "mention", never>;
+export declare const commentSchema: Schema<"paragraph" | "doc" | "text" | "mention", never>;
 export type CommentSchema = typeof commentSchema;
 /** Paragraph horizontal alignment (mirrors w:jc). */
 export type Align = 'left' | 'center' | 'right' | 'justify';

package/dist/lib/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/lib/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAgF3C;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,2PAiZjB,CAAC;AAEH,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG,OAAO,MAAM,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,aAAa,yDA0CxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAEjD,qDAAqD;AACrD,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5D;+EAC+E;AAC/E,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2EAA2E;AAC3E,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAAC;CACvC;AA0BD;;;4EAG4E;AAC5E,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/lib/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAkF3C;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,kSAgfjB,CAAC;AAEH,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG,OAAO,MAAM,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,aAAa,yDA0CxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAEjD,qDAAqD;AACrD,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5D;+EAC+E;AAC/E,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2EAA2E;AAC3E,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAAC;CACvC;AA0BD;;;4EAG4E;AAC5E,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/lib/numbering.d.ts

@@ -5,11 +5,28 @@
  * the layout engine does this every pass, so inserting/deleting/reordering
  * list items renumbers everything, like Word.
  */
+/** Label (marker) run formatting from the lvl's w:rPr (plain data). */
+export interface MarkerRunProps {
+    bold?: boolean;
+    italic?: boolean;
+    sizePt?: number;
+    family?: string;
+    color?: string;
+}
 /** One w:lvl of an abstract numbering definition (plain data — attr-safe). */
 export interface NumberingLevelDef {
     numFmt: string;
     lvlText: string;
     start: number;
+    /** Label alignment against its anchor (w:lvlJc); 'left' when omitted. */
+    jc?: 'center' | 'right';
+    /** What separates the label from the text (w:suff); 'tab' when omitted. */
+    suff?: 'space' | 'nothing';
+    /** Legal numbering (w:isLgl): every %n placeholder renders as decimal
+     *  regardless of the referenced level's own numFmt. */
+    isLgl?: boolean;
+    /** Label formatting (w:lvl > w:rPr) — the number/bullet's own font. */
+    rPr?: MarkerRunProps;
 }
 /** Definitions keyed by numId. `key` groups numIds that share one abstract
  *  definition (their counters advance together, mirroring w:abstractNumId). */
@@ -22,6 +39,8 @@ export interface NumberingDefs {
 /** Stateful counter: call `next` once per list paragraph, in document order. */
 export interface NumberingCounter {
     next(numId: string, level: number): string;
+    /** The level's definition (label styling for the layout), if any. */
+    def(numId: string, level: number): NumberingLevelDef | undefined;
 }
 export declare function createNumberingCounter(defs: NumberingDefs | null | undefined): NumberingCounter;
 //# sourceMappingURL=numbering.d.ts.map

package/dist/lib/numbering.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"numbering.d.ts","sourceRoot":"","sources":["../../src/lib/numbering.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;+EAC+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,CAAC,KAAK,EAAE,MAAM,GAAG;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;KAC3C,CAAC;CACH;AAED,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5C;AA2DD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,GACrC,gBAAgB,CA2BlB"}
+{"version":3,"file":"numbering.d.ts","sourceRoot":"","sources":["../../src/lib/numbering.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACxB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B;2DACuD;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uEAAuE;IACvE,GAAG,CAAC,EAAE,cAAc,CAAC;CACtB;AAED;+EAC+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,CAAC,KAAK,EAAE,MAAM,GAAG;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;KAC3C,CAAC;CACH;AAED,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,qEAAqE;IACrE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;CAClE;AA2DD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,GACrC,gBAAgB,CA+BlB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shadow-garden/bapbong-model",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "bapbong — ProseMirror document model / schema",
   "license": "MIT",
   "repository": {