@sametalmdr/word-editor 0.2.0-alpha → 0.3.0-alpha

package/dist/state/editor-state.js

@@ -1,109 +1,109 @@
-import { createContainer, createDoc, createParagraph, createRun } from "../model/node.js";
-import { collapsedSelection, createPosition, isCollapsed } from "../model/position.js";
-
-/**
- * Everything the editor knows, as plain data. Holds no DOM references — the
- * renderer and selection controller project it, they do not own it.
- *
- * @typedef {object} EditorState
- * @property {import("../model/node.js").Doc} doc
- * @property {import("../model/position.js").Selection} selection
- * @property {import("../model/node.js").Marks | null} storedMarks
- *   Pending formatting at a collapsed cursor: press Ctrl+B with nothing selected
- *   and the *next* typed text uses these marks instead of inheriting from the
- *   position. `null` means "inherit".
- */
-
-/**
- * @param {import("../model/node.js").Doc} doc
- * @param {import("../model/position.js").Selection} [selection]
- * @returns {EditorState}
- */
-export function createEditorState(doc, selection) {
-  const firstContainer = doc.content[0];
-  return {
-    doc,
-    selection:
-      selection ??
-      collapsedSelection(createPosition(firstContainer.id, firstContainer.content[0].id, 0)),
-    storedMarks: null,
-  };
-}
-
-/**
- * A document holding one container with one empty paragraph. The container has
- * no layout entry — it is content, not a positioned box; geometry arrives from
- * DOCX import or from `createBox`.
- * @param {import("../model/ids.js").IdFactory} ids
- * @returns {import("../model/node.js").Doc}
- */
-export function createEmptyDoc(ids) {
-  const docId = ids.next();
-  const containerId = ids.next();
-  return createDoc(docId, [
-    createContainer(containerId, [createParagraph(ids.next(), [createRun("")])]),
-  ]);
-}
-
-/**
- * Folds a transaction into the state.
- *
- * `storedMarks` is cleared unless the transaction sets it explicitly. The rules,
- * in order:
- *   1. an explicit value on the transaction wins;
- *   2. undo/redo clears it — pending formatting from before the undo is stale;
- *   3. any transaction that changed the document consumed it;
- *   4. otherwise it carries over;
- *   5. and it never survives a non-collapsed selection.
- *
- * The remaining clearing rule — a user-driven selection change — lives in
- * `selection/controller.js` (`withSelection`'s default, no `keepStoredMarks`),
- * because only that layer can tell a real cursor move from our own
- * programmatic restore. ⚠ "...and blur" — BUGÜN DOĞRU DEĞİL, bkz.
- * `docs/SESSION-LOG.md` Ek 56: no blur-triggered clearing exists anywhere
- * (`grep -n "blur" src/selection/controller.js` is empty) — measured harmless
- * in practice (`handleSelectionChange`'s own "outside the editor" guard
- * already keeps a blur from corrupting `state.selection` at all, so
- * `storedMarks` never needed a separate rule for it), but the sentence itself
- * was always aspirational, not a description of real code.
- *
- * @param {EditorState} state
- * @param {import("../model/transaction.js").Transaction} tr
- * @returns {EditorState}
- */
-export function applyTransaction(state, tr) {
-  /** @type {import("../model/node.js").Marks | null} */
-  let storedMarks;
-
-  if (tr.storedMarks !== undefined) {
-    storedMarks = tr.storedMarks;
-  } else if (tr.origin === "history" || tr.steps.length > 0) {
-    storedMarks = null;
-  } else {
-    storedMarks = state.storedMarks;
-  }
-
-  if (storedMarks !== null && !isCollapsed(tr.selectionAfter)) {
-    storedMarks = null;
-  }
-
-  return { doc: tr.doc, selection: tr.selectionAfter, storedMarks };
-}
-
-/**
- * Replaces the selection without touching the document. Used when adopting a
- * selection the browser already applied, so it deliberately produces no
- * transaction and no history entry.
- * @param {EditorState} state
- * @param {import("../model/position.js").Selection} selection
- * @param {{ keepStoredMarks?: boolean }} [options]
- * @returns {EditorState}
- */
-export function withSelection(state, selection, options = {}) {
-  const keep = options.keepStoredMarks === true && isCollapsed(selection);
-  return {
-    doc: state.doc,
-    selection,
-    storedMarks: keep ? state.storedMarks : null,
-  };
-}
+import { createContainer, createDoc, createParagraph, createRun } from "../model/node.js";
+import { collapsedSelection, createPosition, isCollapsed } from "../model/position.js";
+
+/**
+ * Everything the editor knows, as plain data. Holds no DOM references — the
+ * renderer and selection controller project it, they do not own it.
+ *
+ * @typedef {object} EditorState
+ * @property {import("../model/node.js").Doc} doc
+ * @property {import("../model/position.js").Selection} selection
+ * @property {import("../model/node.js").Marks | null} storedMarks
+ *   Pending formatting at a collapsed cursor: press Ctrl+B with nothing selected
+ *   and the *next* typed text uses these marks instead of inheriting from the
+ *   position. `null` means "inherit".
+ */
+
+/**
+ * @param {import("../model/node.js").Doc} doc
+ * @param {import("../model/position.js").Selection} [selection]
+ * @returns {EditorState}
+ */
+export function createEditorState(doc, selection) {
+  const firstContainer = doc.content[0];
+  return {
+    doc,
+    selection:
+      selection ??
+      collapsedSelection(createPosition(firstContainer.id, firstContainer.content[0].id, 0)),
+    storedMarks: null,
+  };
+}
+
+/**
+ * A document holding one container with one empty paragraph. The container has
+ * no layout entry — it is content, not a positioned box; geometry arrives from
+ * DOCX import or from `createBox`.
+ * @param {import("../model/ids.js").IdFactory} ids
+ * @returns {import("../model/node.js").Doc}
+ */
+export function createEmptyDoc(ids) {
+  const docId = ids.next();
+  const containerId = ids.next();
+  return createDoc(docId, [
+    createContainer(containerId, [createParagraph(ids.next(), [createRun("")])]),
+  ]);
+}
+
+/**
+ * Folds a transaction into the state.
+ *
+ * `storedMarks` is cleared unless the transaction sets it explicitly. The rules,
+ * in order:
+ *   1. an explicit value on the transaction wins;
+ *   2. undo/redo clears it — pending formatting from before the undo is stale;
+ *   3. any transaction that changed the document consumed it;
+ *   4. otherwise it carries over;
+ *   5. and it never survives a non-collapsed selection.
+ *
+ * The remaining clearing rule — a user-driven selection change — lives in
+ * `selection/controller.js` (`withSelection`'s default, no `keepStoredMarks`),
+ * because only that layer can tell a real cursor move from our own
+ * programmatic restore. ⚠ "...and blur" — BUGÜN DOĞRU DEĞİL, bkz.
+ * `docs/SESSION-LOG.md` Ek 56: no blur-triggered clearing exists anywhere
+ * (`grep -n "blur" src/selection/controller.js` is empty) — measured harmless
+ * in practice (`handleSelectionChange`'s own "outside the editor" guard
+ * already keeps a blur from corrupting `state.selection` at all, so
+ * `storedMarks` never needed a separate rule for it), but the sentence itself
+ * was always aspirational, not a description of real code.
+ *
+ * @param {EditorState} state
+ * @param {import("../model/transaction.js").Transaction} tr
+ * @returns {EditorState}
+ */
+export function applyTransaction(state, tr) {
+  /** @type {import("../model/node.js").Marks | null} */
+  let storedMarks;
+
+  if (tr.storedMarks !== undefined) {
+    storedMarks = tr.storedMarks;
+  } else if (tr.origin === "history" || tr.steps.length > 0) {
+    storedMarks = null;
+  } else {
+    storedMarks = state.storedMarks;
+  }
+
+  if (storedMarks !== null && !isCollapsed(tr.selectionAfter)) {
+    storedMarks = null;
+  }
+
+  return { doc: tr.doc, selection: tr.selectionAfter, storedMarks };
+}
+
+/**
+ * Replaces the selection without touching the document. Used when adopting a
+ * selection the browser already applied, so it deliberately produces no
+ * transaction and no history entry.
+ * @param {EditorState} state
+ * @param {import("../model/position.js").Selection} selection
+ * @param {{ keepStoredMarks?: boolean }} [options]
+ * @returns {EditorState}
+ */
+export function withSelection(state, selection, options = {}) {
+  const keep = options.keepStoredMarks === true && isCollapsed(selection);
+  return {
+    doc: state.doc,
+    selection,
+    storedMarks: keep ? state.storedMarks : null,
+  };
+}

package/dist/styles.css

@@ -1,66 +1,66 @@
-/* word-editor styles.
- *
- * Screen styling is deliberately NOT here: how a page surface looks (paper
- * colour, shadow, gutter) is the host's decision, and the renderer writes
- * every box's geometry as inline style from the layout axis. Anything this
- * file said about position/size would fight it.
- *
- * What IS here is Tier 0 print (ARCHITECTURE.md §7) and the numPr marker rule
- * below — both ship with the package because they are PRODUCT concerns
- * (printing correctly; a bulleted paragraph looking bulleted), not demo ones.
- * The numPr rule is NOT print-only: without it, on screen too, a numPr
- * paragraph renders with no visible marker at all.
- */
-
-/* --- numPr markers (bullets / ordinal-format placeholders) --------------
- *
- * `dom.js`'s `applyParagraphStyle` writes `data-we-marker` + this class on a
- * numPr paragraph's own <p> — never a child node (see dom.js's own comment
- * on NUM_MARKER_KEY for why: a real child would shift renderer.js's
- * runIndex-based tier-2 fast path and inflate dom-map.js's caret offsets,
- * both of which walk/index a paragraph's children with no marker-awareness
- * at all). `content: attr(...)` is CSS generated content — by spec, never a
- * DOM node, so neither of those is ever at risk from it.
- */
-.we-num-marker::before {
-  content: attr(data-we-marker);
-}
-
-/* --- Tier 0 PDF: the BROWSER's print-to-PDF, not our writer -------------
- *
- * Tier 0 is `window.print()` + this stylesheet; the user picks "Save as PDF".
- * Tier 1 (our own writer, embedded fonts, ARCHITECTURE §7) is still P7 — this
- * file makes no claim about font embedding or byte-level output.
- *
- * The SHEET size is not set here on purpose. `@page` is static CSS and cannot
- * read `doc.page`, and the corpus is not one size: 43 of 46 documents are A4
- * portrait, one is A4 LANDSCAPE and one is A5 (docs/viewer-measurement.md §4).
- * A hardcoded `size: A4` would mis-fit the last two. The host writes a
- * per-document rule instead:
- *
- *     @media print { @page { size: <doc.page.width>pt <doc.page.height>pt;
- *                            margin: 0; } }
- *
- * See examples/static/viewer.html's setPrintPageSize() for a working one.
- */
-@media print {
-  .we-page {
-    /* Screen affordances that must not reach paper. */
-    box-shadow: none;
-    margin: 0;
-    /* One document page per sheet. Both spellings: the older
-     * page-break-after is still what some engines honour. */
-    break-after: page;
-    page-break-after: always;
-  }
-
-  .we-page:last-child {
-    break-after: auto;
-    page-break-after: auto;
-  }
-
-  /* Boxes are absolutely positioned inside .we-page and their geometry is
-   * inline style from the renderer. NOTHING here may touch position, size or
-   * z-index — the only thing Tier 0 promises is that paper matches screen,
-   * and a rule that nudged a box would break exactly that. */
-}
+/* word-editor styles.
+ *
+ * Screen styling is deliberately NOT here: how a page surface looks (paper
+ * colour, shadow, gutter) is the host's decision, and the renderer writes
+ * every box's geometry as inline style from the layout axis. Anything this
+ * file said about position/size would fight it.
+ *
+ * What IS here is Tier 0 print (ARCHITECTURE.md §7) and the numPr marker rule
+ * below — both ship with the package because they are PRODUCT concerns
+ * (printing correctly; a bulleted paragraph looking bulleted), not demo ones.
+ * The numPr rule is NOT print-only: without it, on screen too, a numPr
+ * paragraph renders with no visible marker at all.
+ */
+
+/* --- numPr markers (bullets / ordinal-format placeholders) --------------
+ *
+ * `dom.js`'s `applyParagraphStyle` writes `data-we-marker` + this class on a
+ * numPr paragraph's own <p> — never a child node (see dom.js's own comment
+ * on NUM_MARKER_KEY for why: a real child would shift renderer.js's
+ * runIndex-based tier-2 fast path and inflate dom-map.js's caret offsets,
+ * both of which walk/index a paragraph's children with no marker-awareness
+ * at all). `content: attr(...)` is CSS generated content — by spec, never a
+ * DOM node, so neither of those is ever at risk from it.
+ */
+.we-num-marker::before {
+  content: attr(data-we-marker);
+}
+
+/* --- Tier 0 PDF: the BROWSER's print-to-PDF, not our writer -------------
+ *
+ * Tier 0 is `window.print()` + this stylesheet; the user picks "Save as PDF".
+ * Tier 1 (our own writer, embedded fonts, ARCHITECTURE §7) is still P7 — this
+ * file makes no claim about font embedding or byte-level output.
+ *
+ * The SHEET size is not set here on purpose. `@page` is static CSS and cannot
+ * read `doc.page`, and the corpus is not one size: 43 of 46 documents are A4
+ * portrait, one is A4 LANDSCAPE and one is A5 (docs/viewer-measurement.md §4).
+ * A hardcoded `size: A4` would mis-fit the last two. The host writes a
+ * per-document rule instead:
+ *
+ *     @media print { @page { size: <doc.page.width>pt <doc.page.height>pt;
+ *                            margin: 0; } }
+ *
+ * See examples/static/viewer.html's setPrintPageSize() for a working one.
+ */
+@media print {
+  .we-page {
+    /* Screen affordances that must not reach paper. */
+    box-shadow: none;
+    margin: 0;
+    /* One document page per sheet. Both spellings: the older
+     * page-break-after is still what some engines honour. */
+    break-after: page;
+    page-break-after: always;
+  }
+
+  .we-page:last-child {
+    break-after: auto;
+    page-break-after: auto;
+  }
+
+  /* Boxes are absolutely positioned inside .we-page and their geometry is
+   * inline style from the renderer. NOTHING here may touch position, size or
+   * z-index — the only thing Tier 0 promises is that paper matches screen,
+   * and a rule that nudged a box would break exactly that. */
+}

package/package.json

@@ -1,93 +1,94 @@
-{
-  "name": "@sametalmdr/word-editor",
-  "version": "0.2.0-alpha",
-  "description": "Page-canvas editor for absolutely positioned DOCX text boxes, and a DOM-free DOCX template filler. Zero runtime dependencies.",
-  "license": "MIT",
-  "type": "module",
-  "sideEffects": false,
-  "author": "Alrosoft Ltd",
-  "keywords": [
-    "editor",
-    "word-processor",
-    "wysiwyg",
-    "docx",
-    "docx-template"
-  ],
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md"
-  ],
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./element": {
-      "types": "./dist/element.d.ts",
-      "default": "./dist/element.js"
-    },
-    "./docx": {
-      "types": "./dist/docx.d.ts",
-      "default": "./dist/docx.js"
-    },
-    "./react": {
-      "types": "./dist/react/index.d.ts",
-      "default": "./dist/react/index.js"
-    },
-    "./styles.css": "./dist/styles.css"
-  },
-  "types": "./dist/index.d.ts",
-  "main": "./dist/index.js",
-  "dependencies": {},
-  "publishConfig": {
-    "access": "public"
-  },
-  "peerDependencies": {
-    "react": ">=18"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@types/react": "^18.3.3",
-    "docxtemplater": "3.50.0",
-    "pizzip": "3.1.7",
-    "react": "^18.3.1",
-    "typescript": "^5.5.4"
-  },
-  "scripts": {
-    "test": "node scripts/test-clean.js",
-    "build": "node scripts/build.js",
-    "prepack": "npm run build",
-    "pack:smoke": "node scripts/pack-smoke.mjs",
-    "check": "tsc --noEmit -p tsconfig.json && tsc -p tsconfig.templates.json",
-    "verify": "node scripts/verify.js",
-    "templates:manifest": "node scripts/templates/manifest.mjs",
-    "templates:build": "node scripts/templates/build.mjs",
-    "corpus:manifest": "node scripts/corpus-manifest.js",
-    "corpus:verify": "node scripts/verify-corpus.js",
-    "corpus:check": "node scripts/corpus-check.js",
-    "corpus:names": "node scripts/corpus-names.js",
-    "corpus:pages": "node scripts/corpus-pages.js",
-    "corpus:paraprops": "python scripts/measure-paragraph-properties.py",
-    "corpus:styleinherit": "python scripts/measure-style-inheritance.py",
-    "corpus:bodypr": "python scripts/measure-body-properties.py",
-    "corpus:slots": "python scripts/measure-fill-slots.py",
-    "corpus:canvas": "node scripts/corpus-to-canvas.js",
-    "probe:report": "node scripts/probe-report.js",
-    "mutate": "node scripts/mutate.js",
-    "ci": "npm run check && npm run build && npm test && npm run verify && npm run corpus:verify",
-    "serve": "node scripts/serve-examples.js",
-    "e2e:stage": "node scripts/e2e/stage.mjs",
-    "e2e:sink": "node scripts/e2e/sink.mjs",
-    "e2e:word": "node scripts/e2e/run-word.mjs",
-    "e2e:seal": "node scripts/e2e/seal-evidence.mjs"
-  },
-  "engines": {
-    "node": "^20.12.0 || >=21.2.0"
-  }
-}
+{
+  "name": "@sametalmdr/word-editor",
+  "version": "0.3.0-alpha",
+  "description": "Page-canvas editor for absolutely positioned DOCX text boxes, and a DOM-free DOCX template filler. Zero runtime dependencies.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "author": "Alrosoft Ltd",
+  "keywords": [
+    "editor",
+    "word-processor",
+    "wysiwyg",
+    "docx",
+    "docx-template"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./element": {
+      "types": "./dist/element.d.ts",
+      "default": "./dist/element.js"
+    },
+    "./docx": {
+      "types": "./dist/docx.d.ts",
+      "default": "./dist/docx.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "dependencies": {},
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.3",
+    "docxtemplater": "3.50.0",
+    "pizzip": "3.1.7",
+    "react": "^18.3.1",
+    "typescript": "^5.5.4"
+  },
+  "scripts": {
+    "test": "node scripts/test-clean.js",
+    "build": "node scripts/build.js",
+    "prepack": "npm run build",
+    "pack:smoke": "node scripts/pack-smoke.mjs",
+    "check": "tsc --noEmit -p tsconfig.json && tsc -p tsconfig.templates.json",
+    "verify": "node scripts/verify.js",
+    "templates:manifest": "node scripts/templates/manifest.mjs",
+    "templates:build": "node scripts/templates/build.mjs",
+    "fonts:widths": "py -X utf8 scripts/fonts/widths.py",
+    "corpus:manifest": "node scripts/corpus-manifest.js",
+    "corpus:verify": "node scripts/verify-corpus.js",
+    "corpus:check": "node scripts/corpus-check.js",
+    "corpus:names": "node scripts/corpus-names.js",
+    "corpus:pages": "node scripts/corpus-pages.js",
+    "corpus:paraprops": "python scripts/measure-paragraph-properties.py",
+    "corpus:styleinherit": "python scripts/measure-style-inheritance.py",
+    "corpus:bodypr": "python scripts/measure-body-properties.py",
+    "corpus:slots": "python scripts/measure-fill-slots.py",
+    "corpus:canvas": "node scripts/corpus-to-canvas.js",
+    "probe:report": "node scripts/probe-report.js",
+    "mutate": "node scripts/mutate.js",
+    "ci": "npm run check && npm run build && npm test && npm run verify && npm run corpus:verify",
+    "serve": "node scripts/serve-examples.js",
+    "e2e:stage": "node scripts/e2e/stage.mjs",
+    "e2e:sink": "node scripts/e2e/sink.mjs",
+    "e2e:word": "node scripts/e2e/run-word.mjs",
+    "e2e:seal": "node scripts/e2e/seal-evidence.mjs"
+  },
+  "engines": {
+    "node": "^20.12.0 || >=21.2.0"
+  }
+}