@shadow-garden/bapbong-model 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Le Phuoc Minh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,27 @@
+# @shadow-garden/bapbong-model
+
+The ProseMirror **document schema** for bapbong, plus list-numbering helpers.
+This is the canonical in-memory document — `importDocx` produces it, the layout
+engine consumes it, and the hidden editor edits it.
+
+- **Scope:** `scope:model`
+- **Depends on:** `prosemirror-model`
+
+## What it provides
+
+- **`schema`** — the main document `Schema`: `doc` (with undoable `attrs`
+  `numbering` / `sections` / `comments`), `paragraph`, `text`, `image`, `table`,
+  `hardBreak`, …; marks `strong`, `em`, `underline`, `strike`, `link`, `color`,
+  `highlight`, `vertAlign`, `footnote { num }`, `comment { ids }`.
+- **`commentSchema`** — a tiny schema for comment bodies: `doc` / `paragraph` /
+  `text` + an inline **`mention`** atom (`{ id, label }`) with `leafText`/`toDOM`.
+- **`createNumberingCounter(defs)`** — resolves live list markers (decimal,
+  bullet, multilevel) from `doc.attrs.numbering`.
+- Types: `BapbongSchema`, `CommentSchema`, `Align`.
+
+## Build / test
+
+```sh
+pnpm nx build @shadow-garden/bapbong-model
+pnpm nx test  @shadow-garden/bapbong-model
+```

package/dist/index.cjs

@@ -0,0 +1,441 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/model/src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  commentSchema: () => commentSchema,
+  createNumberingCounter: () => createNumberingCounter,
+  schema: () => schema
+});
+module.exports = __toCommonJS(index_exports);
+
+// packages/model/src/lib/model.ts
+var import_prosemirror_model = require("prosemirror-model");
+var schema = new import_prosemirror_model.Schema({
+  nodes: {
+    doc: {
+      content: "block+",
+      attrs: {
+        // NumberingDefs (numbering.ts) — list markers are recomputed from
+        // these at layout time, so edits renumber live. Importer-set.
+        numbering: { default: null },
+        // SectionConfig[] (contracts) — per-section column flow, delimited by
+        // w:sectPr breaks. null/absent → one implicit single-column section.
+        sections: { default: null },
+        // CommentNode[] (contracts) — comment threads keyed to `comment` marks.
+        // Edited via setDocAttribute so add/reply/resolve/delete undo cleanly.
+        comments: { default: null }
+      }
+    },
+    paragraph: {
+      group: "block",
+      content: "inline*",
+      // `list` is null for normal paragraphs, or ListInfo for list items.
+      // DOCX stores lists flat (each w:p carries w:numPr), so we keep them
+      // flat and let the marker be computed by the numbering counter.
+      //
+      // `align` mirrors w:jc ('left'|'center'|'right'|'justify'), null = default.
+      // `indent` mirrors w:ind, all measured in CSS px (Indent | null):
+      //   { left, right, firstLine, hanging }. firstLine and hanging are
+      //   mutually exclusive in OOXML; hanging wins if both appear.
+      attrs: {
+        list: { default: null },
+        align: { default: null },
+        indent: { default: null },
+        // Heading level 1–6 (maps to a Word "Heading N" style on export, and to
+        // an <h1>–<h6> in toDOM so the a11y mirror is semantic), or null for a
+        // body paragraph.
+        heading: { default: null },
+        // w:tabs — [{ pos, val: 'left'|'right'|'center'|'decimal', leader? }]
+        // in px from the paragraph's content left edge, or null. Importer-set.
+        tabs: { default: null },
+        // w:spacing — { before?, after?, line?, lineRule? }, or null.
+        spacing: { default: null },
+        // w:pageBreakBefore — start this paragraph on a new page.
+        pageBreakBefore: { default: false }
+      },
+      // No getAttrs: nothing in the pipeline parses paragraphs from the DOM
+      // yet (the importer builds nodes directly). align/indent still round-trip
+      // out through toDOM. Revisit when HTML paste lands.
+      parseDOM: [{ tag: "p" }],
+      toDOM(node) {
+        const attrs = node.attrs;
+        const style = paragraphStyle(attrs);
+        const tag = attrs.heading ? `h${attrs.heading}` : "p";
+        return [tag, style ? { style } : {}, 0];
+      }
+    },
+    text: { group: "inline" },
+    // A soft line break inside a paragraph (w:br) — forces a new line without
+    // ending the paragraph. Occupies one PM position, like an image atom.
+    hard_break: {
+      inline: true,
+      group: "inline",
+      selectable: false,
+      parseDOM: [{ tag: "br" }],
+      toDOM: () => ["br"]
+    },
+    // Inline image. `src` is typically a data URL (the importer inlines the
+    // embedded media); width/height are CSS pixels, null if unspecified.
+    image: {
+      inline: true,
+      group: "inline",
+      draggable: true,
+      attrs: {
+        src: {},
+        alt: { default: "" },
+        width: { default: null },
+        height: { default: null },
+        // wp:anchor (floating image): { wrap: 'square'|'topAndBottom'|'none',
+        // hAlign?, hOffset?, hRel?, vOffset?, vRel?, distL?, distR?, distT?,
+        // distB? } in px, or null for inline images. Importer-set.
+        float: { default: null },
+        // Drawn vector shape (wps rect / straight connector) riding this box:
+        // { kind: 'rect'|'line', stroke?, strokeWidth?, fill?, flipV? } — src
+        // is then '' and the box paints as vector. Null for real bitmaps.
+        shape: { default: null },
+        // Textbox (wps:txbx) content riding a shape: { paragraphs: <paragraph
+        // node JSON>[], inset?: {l,t,r,b} px }. The layout engine flows the
+        // paragraphs inside the shape's box (paint-only, not editable v1).
+        textbox: { default: null },
+        // Clockwise rotation in degrees around the box center (a:xfrm@rot).
+        // Paint-only: the layout box stays axis-aligned.
+        rotation: { default: 0 }
+      },
+      toDOM(node) {
+        const a = node.attrs;
+        const attrs = { src: a["src"], alt: a["alt"] };
+        if (a["width"] != null) attrs["width"] = String(a["width"]);
+        if (a["height"] != null) attrs["height"] = String(a["height"]);
+        return ["img", attrs];
+      }
+    },
+    // PAGE / NUMPAGES fields: atoms whose text is computed per page at paint
+    // time. `kind` is 'page' (current page number) or 'pages' (total count).
+    page_field: {
+      inline: true,
+      group: "inline",
+      atom: true,
+      attrs: { kind: {} },
+      parseDOM: [{ tag: "span[data-page-field]" }],
+      toDOM: (node) => [
+        "span",
+        { "data-page-field": String(node.attrs["kind"]) },
+        node.attrs["kind"] === "pages" ? "##" : "#"
+      ]
+    },
+    // Tables: kept structural (table → row → cell → block+). Horizontal spans
+    // map to colspan; vertical merges aren't collapsed yet (rowspan default 1).
+    table: {
+      group: "block",
+      content: "table_row+",
+      isolating: true,
+      attrs: {
+        // w:tblCellMar overrides (px: {left,right,top,bottom}), or null for
+        // Word defaults. Importer-set (same rationale as paragraph attrs).
+        cellPadding: { default: null },
+        // w:tblBorders visibility { top, bottom, left, right, insideH,
+        // 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 }
+      },
+      parseDOM: [{ tag: "table" }],
+      toDOM: (node) => ["table", node.attrs["borders"] ? { "data-borders": "1" } : {}, ["tbody", 0]]
+    },
+    table_row: {
+      content: "table_cell+",
+      attrs: {
+        header: { default: false },
+        // w:trPr/w:tblHeader — repeat on every page
+        // w:trPr/w:cantSplit — the row must not break across pages. Absent
+        // (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 }
+      },
+      // No getAttrs (same rationale as paragraph): the importer sets attrs
+      // directly; revisit when HTML paste lands.
+      parseDOM: [{ tag: "tr" }],
+      toDOM: (node) => node.attrs["header"] ? ["tr", { "data-header": "true" }, 0] : ["tr", 0]
+    },
+    table_cell: {
+      content: "block+",
+      isolating: true,
+      attrs: {
+        colspan: { default: 1 },
+        rowspan: { default: 1 },
+        colwidth: { default: null },
+        // px widths of the spanned columns, or null
+        background: { default: null },
+        // w:shd w:fill — cell fill "#RRGGBB"
+        vAlign: { default: null },
+        // w:vAlign — 'center' | 'bottom' (top default)
+        borders: { default: null }
+        // w:tcBorders per-side visibility override
+      },
+      parseDOM: [{ tag: "td" }, { tag: "th" }],
+      toDOM(node) {
+        const attrs = {};
+        if (node.attrs["colspan"] !== 1) attrs["colspan"] = String(node.attrs["colspan"]);
+        if (node.attrs["rowspan"] !== 1) attrs["rowspan"] = String(node.attrs["rowspan"]);
+        if (node.attrs["background"]) attrs["style"] = `background-color: ${node.attrs["background"]}`;
+        return ["td", attrs, 0];
+      }
+    }
+  },
+  marks: {
+    // w:b
+    strong: {
+      parseDOM: [{ tag: "strong" }, { tag: "b" }],
+      toDOM: () => ["strong", 0]
+    },
+    // w:i
+    em: {
+      parseDOM: [{ tag: "em" }, { tag: "i" }],
+      toDOM: () => ["em", 0]
+    },
+    // w:u
+    underline: {
+      parseDOM: [{ tag: "u" }],
+      toDOM: () => ["u", 0]
+    },
+    // w:strike
+    strike: {
+      parseDOM: [{ tag: "s" }, { tag: "strike" }],
+      toDOM: () => ["s", 0]
+    },
+    // w:color — hex "#RRGGBB"
+    textColor: {
+      attrs: { color: {} },
+      parseDOM: [{ style: "color", getAttrs: (value) => ({ color: value }) }],
+      toDOM(mark) {
+        return ["span", { style: `color: ${mark.attrs["color"]}` }, 0];
+      }
+    },
+    // w:sz — size in points
+    fontSize: {
+      attrs: { size: {} },
+      parseDOM: [
+        {
+          style: "font-size",
+          getAttrs: (value) => {
+            const pt = parseFloat(value);
+            return Number.isNaN(pt) ? false : { size: pt };
+          }
+        }
+      ],
+      toDOM(mark) {
+        return ["span", { style: `font-size: ${mark.attrs["size"]}pt` }, 0];
+      }
+    },
+    // w:vertAlign — superscript / subscript
+    vertAlign: {
+      attrs: { value: {} },
+      // 'super' | 'sub'
+      parseDOM: [
+        { tag: "sup", getAttrs: () => ({ value: "super" }) },
+        { tag: "sub", getAttrs: () => ({ value: "sub" }) }
+      ],
+      toDOM: (mark) => [mark.attrs["value"] === "sub" ? "sub" : "sup", 0]
+    },
+    // w:highlight / w:shd w:fill — run background color ("#RRGGBB")
+    highlight: {
+      attrs: { color: {} },
+      parseDOM: [
+        { style: "background-color", getAttrs: (value) => ({ color: value }) }
+      ],
+      toDOM(mark) {
+        return ["span", { style: `background-color: ${mark.attrs["color"]}` }, 0];
+      }
+    },
+    // w:rFonts — font family
+    fontFamily: {
+      attrs: { family: {} },
+      parseDOM: [{ style: "font-family", getAttrs: (value) => ({ family: value }) }],
+      toDOM(mark) {
+        return ["span", { style: `font-family: ${mark.attrs["family"]}` }, 0];
+      }
+    },
+    // w:hyperlink — external URL or "#anchor"
+    link: {
+      attrs: { href: {} },
+      inclusive: false,
+      toDOM(mark) {
+        return ["a", { href: mark.attrs["href"], rel: "noopener", target: "_blank" }, 0];
+      }
+    },
+    // w:footnoteReference — the carrier text is the superscript number; `num`
+    // lets the layout engine match the reference to its page-bottom body.
+    footnote: {
+      attrs: { num: {} },
+      inclusive: false,
+      parseDOM: [
+        {
+          tag: "sup[data-footnote]",
+          // `el` is an HTMLElement at runtime; this package has no DOM lib, so
+          // narrow structurally rather than naming the type.
+          getAttrs: (el) => ({
+            num: Number(el.getAttribute("data-footnote")) || 0
+          })
+        }
+      ],
+      toDOM(mark) {
+        return ["sup", { "data-footnote": String(mark.attrs["num"]) }, 0];
+      }
+    }
+    // The `comment` mark (w:commentRangeStart/End) is contributed by the comment
+    // plugin (@shadow-garden/bapbong-comments) via the editor's schema
+    // composition — it is NOT part of the base document schema, so a build
+    // without comments stays free of comment marks. The `comments` doc attr
+    // above is inert storage the plugin populates when present.
+  }
+});
+var commentSchema = new import_prosemirror_model.Schema({
+  nodes: {
+    doc: { content: "block+" },
+    paragraph: { group: "block", content: "inline*", parseDOM: [{ tag: "p" }], toDOM: () => ["p", 0] },
+    text: { group: "inline" },
+    // @mention: an inline atom carrying the mentioned user's id + display name.
+    // `leafText` lets textContent include "@Name" (search / plain-text preview).
+    mention: {
+      group: "inline",
+      inline: true,
+      atom: true,
+      selectable: false,
+      attrs: { id: {}, label: {} },
+      leafText: (node) => `@${node.attrs["label"]}`,
+      toDOM: (node) => [
+        "span",
+        { class: "mention", "data-id": String(node.attrs["id"]) },
+        `@${node.attrs["label"]}`
+      ],
+      parseDOM: [
+        {
+          tag: "span.mention",
+          getAttrs: (el) => {
+            const e = el;
+            return { id: e.getAttribute("data-id"), label: (e.textContent ?? "").replace(/^@/, "") };
+          }
+        }
+      ]
+    }
+  },
+  marks: {}
+});
+function paragraphStyle(attrs) {
+  const parts = [];
+  if (attrs.align) parts.push(`text-align: ${attrs.align}`);
+  const ind = attrs.indent;
+  if (ind) {
+    if (ind.left) parts.push(`margin-left: ${ind.left}px`);
+    if (ind.right) parts.push(`margin-right: ${ind.right}px`);
+    if (ind.hanging) parts.push(`text-indent: ${-ind.hanging}px`);
+    else if (ind.firstLine) parts.push(`text-indent: ${ind.firstLine}px`);
+  }
+  const sp = attrs.spacing;
+  if (sp) {
+    if (sp.before) parts.push(`margin-top: ${sp.before}px`);
+    if (sp.after) parts.push(`margin-bottom: ${sp.after}px`);
+    if (sp.line && sp.lineRule === "auto") parts.push(`line-height: ${sp.line}`);
+    else if (sp.line) parts.push(`line-height: ${sp.line}px`);
+  }
+  return parts.join("; ");
+}
+
+// packages/model/src/lib/numbering.ts
+function toLetters(n) {
+  let s = "";
+  let x = n;
+  while (x > 0) {
+    const rem = (x - 1) % 26;
+    s = String.fromCharCode(65 + rem) + s;
+    x = Math.floor((x - 1) / 26);
+  }
+  return s || "A";
+}
+function toRoman(n) {
+  if (n <= 0) return String(n);
+  const table = [
+    [1e3, "M"],
+    [900, "CM"],
+    [500, "D"],
+    [400, "CD"],
+    [100, "C"],
+    [90, "XC"],
+    [50, "L"],
+    [40, "XL"],
+    [10, "X"],
+    [9, "IX"],
+    [5, "V"],
+    [4, "IV"],
+    [1, "I"]
+  ];
+  let x = n;
+  let out = "";
+  for (const [v, sym] of table) {
+    while (x >= v) {
+      out += sym;
+      x -= v;
+    }
+  }
+  return out;
+}
+function formatCounter(n, fmt) {
+  switch (fmt) {
+    case "lowerLetter":
+      return toLetters(n).toLowerCase();
+    case "upperLetter":
+      return toLetters(n);
+    case "lowerRoman":
+      return toRoman(n).toLowerCase();
+    case "upperRoman":
+      return toRoman(n);
+    default:
+      return String(n);
+  }
+}
+function createNumberingCounter(defs) {
+  const counters = /* @__PURE__ */ new Map();
+  function next(numId, level) {
+    const def = defs?.[numId];
+    if (!def) return "";
+    const startOf = (lvl) => def.levels[lvl]?.start ?? 1;
+    const arr = counters.get(def.key) ?? [];
+    arr[level] = (arr[level] ?? startOf(level) - 1) + 1;
+    for (let l = level + 1; l < arr.length; l++) arr[l] = void 0;
+    counters.set(def.key, arr);
+    const lvlDef = def.levels[level];
+    if (!lvlDef || lvlDef.numFmt === "none") return "";
+    if (lvlDef.numFmt === "bullet") return lvlDef.lvlText || "\u2022";
+    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");
+    });
+  }
+  return { next };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  commentSchema,
+  createNumberingCounter,
+  schema
+});

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,412 @@
+// packages/model/src/lib/model.ts
+import { Schema } from "prosemirror-model";
+var schema = new Schema({
+  nodes: {
+    doc: {
+      content: "block+",
+      attrs: {
+        // NumberingDefs (numbering.ts) — list markers are recomputed from
+        // these at layout time, so edits renumber live. Importer-set.
+        numbering: { default: null },
+        // SectionConfig[] (contracts) — per-section column flow, delimited by
+        // w:sectPr breaks. null/absent → one implicit single-column section.
+        sections: { default: null },
+        // CommentNode[] (contracts) — comment threads keyed to `comment` marks.
+        // Edited via setDocAttribute so add/reply/resolve/delete undo cleanly.
+        comments: { default: null }
+      }
+    },
+    paragraph: {
+      group: "block",
+      content: "inline*",
+      // `list` is null for normal paragraphs, or ListInfo for list items.
+      // DOCX stores lists flat (each w:p carries w:numPr), so we keep them
+      // flat and let the marker be computed by the numbering counter.
+      //
+      // `align` mirrors w:jc ('left'|'center'|'right'|'justify'), null = default.
+      // `indent` mirrors w:ind, all measured in CSS px (Indent | null):
+      //   { left, right, firstLine, hanging }. firstLine and hanging are
+      //   mutually exclusive in OOXML; hanging wins if both appear.
+      attrs: {
+        list: { default: null },
+        align: { default: null },
+        indent: { default: null },
+        // Heading level 1–6 (maps to a Word "Heading N" style on export, and to
+        // an <h1>–<h6> in toDOM so the a11y mirror is semantic), or null for a
+        // body paragraph.
+        heading: { default: null },
+        // w:tabs — [{ pos, val: 'left'|'right'|'center'|'decimal', leader? }]
+        // in px from the paragraph's content left edge, or null. Importer-set.
+        tabs: { default: null },
+        // w:spacing — { before?, after?, line?, lineRule? }, or null.
+        spacing: { default: null },
+        // w:pageBreakBefore — start this paragraph on a new page.
+        pageBreakBefore: { default: false }
+      },
+      // No getAttrs: nothing in the pipeline parses paragraphs from the DOM
+      // yet (the importer builds nodes directly). align/indent still round-trip
+      // out through toDOM. Revisit when HTML paste lands.
+      parseDOM: [{ tag: "p" }],
+      toDOM(node) {
+        const attrs = node.attrs;
+        const style = paragraphStyle(attrs);
+        const tag = attrs.heading ? `h${attrs.heading}` : "p";
+        return [tag, style ? { style } : {}, 0];
+      }
+    },
+    text: { group: "inline" },
+    // A soft line break inside a paragraph (w:br) — forces a new line without
+    // ending the paragraph. Occupies one PM position, like an image atom.
+    hard_break: {
+      inline: true,
+      group: "inline",
+      selectable: false,
+      parseDOM: [{ tag: "br" }],
+      toDOM: () => ["br"]
+    },
+    // Inline image. `src` is typically a data URL (the importer inlines the
+    // embedded media); width/height are CSS pixels, null if unspecified.
+    image: {
+      inline: true,
+      group: "inline",
+      draggable: true,
+      attrs: {
+        src: {},
+        alt: { default: "" },
+        width: { default: null },
+        height: { default: null },
+        // wp:anchor (floating image): { wrap: 'square'|'topAndBottom'|'none',
+        // hAlign?, hOffset?, hRel?, vOffset?, vRel?, distL?, distR?, distT?,
+        // distB? } in px, or null for inline images. Importer-set.
+        float: { default: null },
+        // Drawn vector shape (wps rect / straight connector) riding this box:
+        // { kind: 'rect'|'line', stroke?, strokeWidth?, fill?, flipV? } — src
+        // is then '' and the box paints as vector. Null for real bitmaps.
+        shape: { default: null },
+        // Textbox (wps:txbx) content riding a shape: { paragraphs: <paragraph
+        // node JSON>[], inset?: {l,t,r,b} px }. The layout engine flows the
+        // paragraphs inside the shape's box (paint-only, not editable v1).
+        textbox: { default: null },
+        // Clockwise rotation in degrees around the box center (a:xfrm@rot).
+        // Paint-only: the layout box stays axis-aligned.
+        rotation: { default: 0 }
+      },
+      toDOM(node) {
+        const a = node.attrs;
+        const attrs = { src: a["src"], alt: a["alt"] };
+        if (a["width"] != null) attrs["width"] = String(a["width"]);
+        if (a["height"] != null) attrs["height"] = String(a["height"]);
+        return ["img", attrs];
+      }
+    },
+    // PAGE / NUMPAGES fields: atoms whose text is computed per page at paint
+    // time. `kind` is 'page' (current page number) or 'pages' (total count).
+    page_field: {
+      inline: true,
+      group: "inline",
+      atom: true,
+      attrs: { kind: {} },
+      parseDOM: [{ tag: "span[data-page-field]" }],
+      toDOM: (node) => [
+        "span",
+        { "data-page-field": String(node.attrs["kind"]) },
+        node.attrs["kind"] === "pages" ? "##" : "#"
+      ]
+    },
+    // Tables: kept structural (table → row → cell → block+). Horizontal spans
+    // map to colspan; vertical merges aren't collapsed yet (rowspan default 1).
+    table: {
+      group: "block",
+      content: "table_row+",
+      isolating: true,
+      attrs: {
+        // w:tblCellMar overrides (px: {left,right,top,bottom}), or null for
+        // Word defaults. Importer-set (same rationale as paragraph attrs).
+        cellPadding: { default: null },
+        // w:tblBorders visibility { top, bottom, left, right, insideH,
+        // 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 }
+      },
+      parseDOM: [{ tag: "table" }],
+      toDOM: (node) => ["table", node.attrs["borders"] ? { "data-borders": "1" } : {}, ["tbody", 0]]
+    },
+    table_row: {
+      content: "table_cell+",
+      attrs: {
+        header: { default: false },
+        // w:trPr/w:tblHeader — repeat on every page
+        // w:trPr/w:cantSplit — the row must not break across pages. Absent
+        // (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 }
+      },
+      // No getAttrs (same rationale as paragraph): the importer sets attrs
+      // directly; revisit when HTML paste lands.
+      parseDOM: [{ tag: "tr" }],
+      toDOM: (node) => node.attrs["header"] ? ["tr", { "data-header": "true" }, 0] : ["tr", 0]
+    },
+    table_cell: {
+      content: "block+",
+      isolating: true,
+      attrs: {
+        colspan: { default: 1 },
+        rowspan: { default: 1 },
+        colwidth: { default: null },
+        // px widths of the spanned columns, or null
+        background: { default: null },
+        // w:shd w:fill — cell fill "#RRGGBB"
+        vAlign: { default: null },
+        // w:vAlign — 'center' | 'bottom' (top default)
+        borders: { default: null }
+        // w:tcBorders per-side visibility override
+      },
+      parseDOM: [{ tag: "td" }, { tag: "th" }],
+      toDOM(node) {
+        const attrs = {};
+        if (node.attrs["colspan"] !== 1) attrs["colspan"] = String(node.attrs["colspan"]);
+        if (node.attrs["rowspan"] !== 1) attrs["rowspan"] = String(node.attrs["rowspan"]);
+        if (node.attrs["background"]) attrs["style"] = `background-color: ${node.attrs["background"]}`;
+        return ["td", attrs, 0];
+      }
+    }
+  },
+  marks: {
+    // w:b
+    strong: {
+      parseDOM: [{ tag: "strong" }, { tag: "b" }],
+      toDOM: () => ["strong", 0]
+    },
+    // w:i
+    em: {
+      parseDOM: [{ tag: "em" }, { tag: "i" }],
+      toDOM: () => ["em", 0]
+    },
+    // w:u
+    underline: {
+      parseDOM: [{ tag: "u" }],
+      toDOM: () => ["u", 0]
+    },
+    // w:strike
+    strike: {
+      parseDOM: [{ tag: "s" }, { tag: "strike" }],
+      toDOM: () => ["s", 0]
+    },
+    // w:color — hex "#RRGGBB"
+    textColor: {
+      attrs: { color: {} },
+      parseDOM: [{ style: "color", getAttrs: (value) => ({ color: value }) }],
+      toDOM(mark) {
+        return ["span", { style: `color: ${mark.attrs["color"]}` }, 0];
+      }
+    },
+    // w:sz — size in points
+    fontSize: {
+      attrs: { size: {} },
+      parseDOM: [
+        {
+          style: "font-size",
+          getAttrs: (value) => {
+            const pt = parseFloat(value);
+            return Number.isNaN(pt) ? false : { size: pt };
+          }
+        }
+      ],
+      toDOM(mark) {
+        return ["span", { style: `font-size: ${mark.attrs["size"]}pt` }, 0];
+      }
+    },
+    // w:vertAlign — superscript / subscript
+    vertAlign: {
+      attrs: { value: {} },
+      // 'super' | 'sub'
+      parseDOM: [
+        { tag: "sup", getAttrs: () => ({ value: "super" }) },
+        { tag: "sub", getAttrs: () => ({ value: "sub" }) }
+      ],
+      toDOM: (mark) => [mark.attrs["value"] === "sub" ? "sub" : "sup", 0]
+    },
+    // w:highlight / w:shd w:fill — run background color ("#RRGGBB")
+    highlight: {
+      attrs: { color: {} },
+      parseDOM: [
+        { style: "background-color", getAttrs: (value) => ({ color: value }) }
+      ],
+      toDOM(mark) {
+        return ["span", { style: `background-color: ${mark.attrs["color"]}` }, 0];
+      }
+    },
+    // w:rFonts — font family
+    fontFamily: {
+      attrs: { family: {} },
+      parseDOM: [{ style: "font-family", getAttrs: (value) => ({ family: value }) }],
+      toDOM(mark) {
+        return ["span", { style: `font-family: ${mark.attrs["family"]}` }, 0];
+      }
+    },
+    // w:hyperlink — external URL or "#anchor"
+    link: {
+      attrs: { href: {} },
+      inclusive: false,
+      toDOM(mark) {
+        return ["a", { href: mark.attrs["href"], rel: "noopener", target: "_blank" }, 0];
+      }
+    },
+    // w:footnoteReference — the carrier text is the superscript number; `num`
+    // lets the layout engine match the reference to its page-bottom body.
+    footnote: {
+      attrs: { num: {} },
+      inclusive: false,
+      parseDOM: [
+        {
+          tag: "sup[data-footnote]",
+          // `el` is an HTMLElement at runtime; this package has no DOM lib, so
+          // narrow structurally rather than naming the type.
+          getAttrs: (el) => ({
+            num: Number(el.getAttribute("data-footnote")) || 0
+          })
+        }
+      ],
+      toDOM(mark) {
+        return ["sup", { "data-footnote": String(mark.attrs["num"]) }, 0];
+      }
+    }
+    // The `comment` mark (w:commentRangeStart/End) is contributed by the comment
+    // plugin (@shadow-garden/bapbong-comments) via the editor's schema
+    // composition — it is NOT part of the base document schema, so a build
+    // without comments stays free of comment marks. The `comments` doc attr
+    // above is inert storage the plugin populates when present.
+  }
+});
+var commentSchema = new Schema({
+  nodes: {
+    doc: { content: "block+" },
+    paragraph: { group: "block", content: "inline*", parseDOM: [{ tag: "p" }], toDOM: () => ["p", 0] },
+    text: { group: "inline" },
+    // @mention: an inline atom carrying the mentioned user's id + display name.
+    // `leafText` lets textContent include "@Name" (search / plain-text preview).
+    mention: {
+      group: "inline",
+      inline: true,
+      atom: true,
+      selectable: false,
+      attrs: { id: {}, label: {} },
+      leafText: (node) => `@${node.attrs["label"]}`,
+      toDOM: (node) => [
+        "span",
+        { class: "mention", "data-id": String(node.attrs["id"]) },
+        `@${node.attrs["label"]}`
+      ],
+      parseDOM: [
+        {
+          tag: "span.mention",
+          getAttrs: (el) => {
+            const e = el;
+            return { id: e.getAttribute("data-id"), label: (e.textContent ?? "").replace(/^@/, "") };
+          }
+        }
+      ]
+    }
+  },
+  marks: {}
+});
+function paragraphStyle(attrs) {
+  const parts = [];
+  if (attrs.align) parts.push(`text-align: ${attrs.align}`);
+  const ind = attrs.indent;
+  if (ind) {
+    if (ind.left) parts.push(`margin-left: ${ind.left}px`);
+    if (ind.right) parts.push(`margin-right: ${ind.right}px`);
+    if (ind.hanging) parts.push(`text-indent: ${-ind.hanging}px`);
+    else if (ind.firstLine) parts.push(`text-indent: ${ind.firstLine}px`);
+  }
+  const sp = attrs.spacing;
+  if (sp) {
+    if (sp.before) parts.push(`margin-top: ${sp.before}px`);
+    if (sp.after) parts.push(`margin-bottom: ${sp.after}px`);
+    if (sp.line && sp.lineRule === "auto") parts.push(`line-height: ${sp.line}`);
+    else if (sp.line) parts.push(`line-height: ${sp.line}px`);
+  }
+  return parts.join("; ");
+}
+
+// packages/model/src/lib/numbering.ts
+function toLetters(n) {
+  let s = "";
+  let x = n;
+  while (x > 0) {
+    const rem = (x - 1) % 26;
+    s = String.fromCharCode(65 + rem) + s;
+    x = Math.floor((x - 1) / 26);
+  }
+  return s || "A";
+}
+function toRoman(n) {
+  if (n <= 0) return String(n);
+  const table = [
+    [1e3, "M"],
+    [900, "CM"],
+    [500, "D"],
+    [400, "CD"],
+    [100, "C"],
+    [90, "XC"],
+    [50, "L"],
+    [40, "XL"],
+    [10, "X"],
+    [9, "IX"],
+    [5, "V"],
+    [4, "IV"],
+    [1, "I"]
+  ];
+  let x = n;
+  let out = "";
+  for (const [v, sym] of table) {
+    while (x >= v) {
+      out += sym;
+      x -= v;
+    }
+  }
+  return out;
+}
+function formatCounter(n, fmt) {
+  switch (fmt) {
+    case "lowerLetter":
+      return toLetters(n).toLowerCase();
+    case "upperLetter":
+      return toLetters(n);
+    case "lowerRoman":
+      return toRoman(n).toLowerCase();
+    case "upperRoman":
+      return toRoman(n);
+    default:
+      return String(n);
+  }
+}
+function createNumberingCounter(defs) {
+  const counters = /* @__PURE__ */ new Map();
+  function next(numId, level) {
+    const def = defs?.[numId];
+    if (!def) return "";
+    const startOf = (lvl) => def.levels[lvl]?.start ?? 1;
+    const arr = counters.get(def.key) ?? [];
+    arr[level] = (arr[level] ?? startOf(level) - 1) + 1;
+    for (let l = level + 1; l < arr.length; l++) arr[l] = void 0;
+    counters.set(def.key, arr);
+    const lvlDef = def.levels[level];
+    if (!lvlDef || lvlDef.numFmt === "none") return "";
+    if (lvlDef.numFmt === "bullet") return lvlDef.lvlText || "\u2022";
+    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");
+    });
+  }
+  return { next };
+}
+export {
+  commentSchema,
+  createNumberingCounter,
+  schema
+};

package/dist/lib/model.d.ts

@@ -0,0 +1,55 @@
+import { Schema } from 'prosemirror-model';
+/**
+ * bapbong's ProseMirror document schema.
+ *
+ * Deliberately minimal for M1 (DOCX import vertical slice): block paragraphs
+ * of inline text with the four common character toggles. Lists, tables,
+ * headings, images, etc. are added in later milestones — when they land they
+ * 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">;
+/** Concrete schema type, handy for typing Node/Mark across packages. */
+export type BapbongSchema = typeof schema;
+/**
+ * Minimal schema for composing a comment body (the comment sidebar's little
+ * editors). Rich enough for paragraphs of text plus an inline `mention` atom
+ * (@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 type CommentSchema = typeof commentSchema;
+/** Paragraph horizontal alignment (mirrors w:jc). */
+export type Align = 'left' | 'center' | 'right' | 'justify';
+/** Paragraph indentation in CSS px (mirrors w:ind). `firstLine` and `hanging`
+ *  are mutually exclusive; if both are present, `hanging` takes precedence. */
+export interface Indent {
+    left?: number;
+    right?: number;
+    firstLine?: number;
+    hanging?: number;
+}
+/** Shape of the paragraph node's attrs (for typed toDOM/serialization). */
+export interface Spacing {
+    before?: number;
+    after?: number;
+    line?: number;
+    lineRule?: 'auto' | 'exact' | 'atLeast';
+}
+export interface ParagraphAttrs {
+    list: ListInfo | null;
+    align: Align | null;
+    indent: Indent | null;
+    spacing?: Spacing | null;
+    heading?: number | null;
+}
+/** Value of a list paragraph's `list` attribute. The marker string ("1.",
+ *  "2.a", "•") is NOT stored — it's recomputed at layout time from the doc's
+ *  numbering defs, so edits renumber live. `marker` remains only for legacy
+ *  callers that pass pre-resolved markers straight to the layout engine. */
+export interface ListInfo {
+    numId: string;
+    level: number;
+    marker?: string;
+}
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/lib/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,2PAyRjB,CAAC;AAEH,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG,OAAO,MAAM,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,aAAa,yDA+BxB,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;CACzB;AAyBD;;;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

@@ -0,0 +1,27 @@
+/**
+ * Live list numbering. The document stores WHAT a paragraph is (numId +
+ * level) and the numbering definitions (on the doc node's `numbering` attr);
+ * marker strings ("1.", "2.a.", "•") are recomputed by walking the document —
+ * the layout engine does this every pass, so inserting/deleting/reordering
+ * list items renumbers everything, like Word.
+ */
+/** One w:lvl of an abstract numbering definition (plain data — attr-safe). */
+export interface NumberingLevelDef {
+    numFmt: string;
+    lvlText: string;
+    start: number;
+}
+/** Definitions keyed by numId. `key` groups numIds that share one abstract
+ *  definition (their counters advance together, mirroring w:abstractNumId). */
+export interface NumberingDefs {
+    [numId: string]: {
+        key: string;
+        levels: Record<number, NumberingLevelDef>;
+    };
+}
+/** Stateful counter: call `next` once per list paragraph, in document order. */
+export interface NumberingCounter {
+    next(numId: string, level: number): string;
+}
+export declare function createNumberingCounter(defs: NumberingDefs | null | undefined): NumberingCounter;
+//# sourceMappingURL=numbering.d.ts.map

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

@@ -0,0 +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;AA8CD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,CA2B/F"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@shadow-garden/bapbong-model",
+  "version": "0.1.0",
+  "description": "bapbong — ProseMirror document model / schema",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shadowgarden-app/bapbong.git",
+    "directory": "packages/model"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@shadow-garden/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "nx": {
+    "tags": [
+      "scope:model"
+    ],
+    "targets": {
+      "build": {
+        "executor": "@nx/esbuild:esbuild",
+        "outputs": [
+          "{options.outputPath}"
+        ],
+        "options": {
+          "outputPath": "packages/model/dist",
+          "main": "packages/model/src/index.ts",
+          "tsConfig": "packages/model/tsconfig.lib.json",
+          "format": [
+            "esm",
+            "cjs"
+          ],
+          "declarationRootDir": "packages/model/src",
+          "generatePackageJson": false
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "prosemirror-model": "^1.25.7"
+  }
+}