js.documents 8.0.1 → 10.0.0

package/dist/table-grid-Xbaddzz3.d.cts

@@ -0,0 +1,49 @@
+import { ContentTable, ContentTableCell } from "document-schema.js";
+//#region src/edit/table-grid.d.ts
+/**
+ * One position of a live table's grid, resolved to the live cell that owns it.
+ *
+ * A merged region owns every position it covers, so `cell` is the region's anchor cell wherever the position lies inside the region, and `isAnchor` tells the anchor's own top-left position (the one a view draws the region's content at) from the positions it covers.
+ */
+interface TableGridCell<C> {
+  readonly cell: C;
+  readonly isAnchor: boolean;
+}
+/**
+ * The rows of a live table's grid: `rows[r][c]` is the position at grid row r and grid column c, and every row is as wide as the table's grid.
+ *
+ * An entry is `undefined` only where the source has no cell at all for a position and no merged region covers it, which is how a row shorter than its table's grid reads.
+ */
+type TableGridRows<C> = readonly (readonly (TableGridCell<C> | undefined)[])[];
+/** A live cell as the editing layer holds it: the grid column its own element starts at, and the spans that element states (an absent span is a span of one). */
+interface PlacedLiveCell<C> {
+  readonly columnIndex: number;
+  readonly cell: C;
+  readonly colSpan: number | undefined;
+  readonly rowSpan: number | undefined;
+}
+/** A live table's grid: its width in columns and the resolved rows. */
+interface LiveTableGrid<C> {
+  readonly columnCount: number;
+  readonly rows: TableGridRows<C>;
+}
+/**
+ * Resolve the cells a live table holds into its dense grid.
+ *
+ * A live table stores fewer cells than it has grid positions wherever its format omits the positions a merge covers (a docx `w:tc` per `w:gridSpan` region, an ODF row's real cells beside its covered ones), so the position of a cell is not its index in its row. This lays the cells out as the content pivot would, through the same `walkTableGrid` classification, so that coverage is derived from the anchors' spans and never re-derived here.
+ *
+ * `declaredColumnCount` is the grid width the source states on its own (a docx `w:tblGrid`); the result is that wide, or wider if a row places a cell past it.
+ */
+declare function resolveLiveTableGrid<C>(rows: readonly (readonly PlacedLiveCell<C>[])[], declaredColumnCount: number): LiveTableGrid<C>;
+/**
+ * Resolve a live table that is itself a ContentTable (an editor holding the content pivot directly rather than an XML tree) into its grid, wrapping each entry of a row in the live cell view `wrap` builds.
+ *
+ * A pivot table's rows are already dense, so an entry's index is its grid column and no width needs deriving; what this adds is the resolution of a covered position to the anchor that owns it, which is the same resolution the XML-backed editors need.
+ */
+declare function resolvePivotTableGrid<C>(table: ContentTable, wrap: (cell: ContentTableCell) => C): LiveTableGrid<C>;
+/**
+ * Throws when `table` breaks the grid rule (ContentTableCell in document-schema.js), naming `entryPoint` and the fault. The edit layer's builders write a covered position as a marker with no content of its own (a docx vertical-merge continuation, an ODF `table:covered-table-cell`, a pptx `hMerge`/`vMerge` cell), so a table whose covered positions carry blocks or spans, whose rows disagree about the grid, or whose regions run past the grid or into each other has no faithful spelling: the builder would drop what a covered position held, or guess which of two regions a position belongs to.
+ */
+declare function assertTableObeysGridRule(table: ContentTable, entryPoint: string): void;
+//#endregion
+export { assertTableObeysGridRule as a, TableGridRows as i, PlacedLiveCell as n, resolveLiveTableGrid as o, TableGridCell as r, resolvePivotTableGrid as s, LiveTableGrid as t };

package/dist/table-grid-Xbaddzz3.d.ts

@@ -0,0 +1,49 @@
+import { ContentTable, ContentTableCell } from "document-schema.js";
+//#region src/edit/table-grid.d.ts
+/**
+ * One position of a live table's grid, resolved to the live cell that owns it.
+ *
+ * A merged region owns every position it covers, so `cell` is the region's anchor cell wherever the position lies inside the region, and `isAnchor` tells the anchor's own top-left position (the one a view draws the region's content at) from the positions it covers.
+ */
+interface TableGridCell<C> {
+  readonly cell: C;
+  readonly isAnchor: boolean;
+}
+/**
+ * The rows of a live table's grid: `rows[r][c]` is the position at grid row r and grid column c, and every row is as wide as the table's grid.
+ *
+ * An entry is `undefined` only where the source has no cell at all for a position and no merged region covers it, which is how a row shorter than its table's grid reads.
+ */
+type TableGridRows<C> = readonly (readonly (TableGridCell<C> | undefined)[])[];
+/** A live cell as the editing layer holds it: the grid column its own element starts at, and the spans that element states (an absent span is a span of one). */
+interface PlacedLiveCell<C> {
+  readonly columnIndex: number;
+  readonly cell: C;
+  readonly colSpan: number | undefined;
+  readonly rowSpan: number | undefined;
+}
+/** A live table's grid: its width in columns and the resolved rows. */
+interface LiveTableGrid<C> {
+  readonly columnCount: number;
+  readonly rows: TableGridRows<C>;
+}
+/**
+ * Resolve the cells a live table holds into its dense grid.
+ *
+ * A live table stores fewer cells than it has grid positions wherever its format omits the positions a merge covers (a docx `w:tc` per `w:gridSpan` region, an ODF row's real cells beside its covered ones), so the position of a cell is not its index in its row. This lays the cells out as the content pivot would, through the same `walkTableGrid` classification, so that coverage is derived from the anchors' spans and never re-derived here.
+ *
+ * `declaredColumnCount` is the grid width the source states on its own (a docx `w:tblGrid`); the result is that wide, or wider if a row places a cell past it.
+ */
+declare function resolveLiveTableGrid<C>(rows: readonly (readonly PlacedLiveCell<C>[])[], declaredColumnCount: number): LiveTableGrid<C>;
+/**
+ * Resolve a live table that is itself a ContentTable (an editor holding the content pivot directly rather than an XML tree) into its grid, wrapping each entry of a row in the live cell view `wrap` builds.
+ *
+ * A pivot table's rows are already dense, so an entry's index is its grid column and no width needs deriving; what this adds is the resolution of a covered position to the anchor that owns it, which is the same resolution the XML-backed editors need.
+ */
+declare function resolvePivotTableGrid<C>(table: ContentTable, wrap: (cell: ContentTableCell) => C): LiveTableGrid<C>;
+/**
+ * Throws when `table` breaks the grid rule (ContentTableCell in document-schema.js), naming `entryPoint` and the fault. The edit layer's builders write a covered position as a marker with no content of its own (a docx vertical-merge continuation, an ODF `table:covered-table-cell`, a pptx `hMerge`/`vMerge` cell), so a table whose covered positions carry blocks or spans, whose rows disagree about the grid, or whose regions run past the grid or into each other has no faithful spelling: the builder would drop what a covered position held, or guess which of two regions a position belongs to.
+ */
+declare function assertTableObeysGridRule(table: ContentTable, entryPoint: string): void;
+//#endregion
+export { assertTableObeysGridRule as a, TableGridRows as i, PlacedLiveCell as n, resolveLiveTableGrid as o, TableGridCell as r, resolvePivotTableGrid as s, LiveTableGrid as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js.documents",
-  "version": "8.0.1",
+  "version": "10.0.0",
   "description": "Bidirectional docx/pptx <-> PDF conversion and a read+write editable OOXML document model, built on ooxml.js and Zod 4 codecs.",
   "type": "module",
   "repository": {
@@ -77,21 +77,21 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "archive-codec": "1.11.8",
+    "archive-codec": "1.11.9",
     "byte-codec": "1.7.0",
-    "doc-codec": "4.0.1",
-    "document-schema.js": "7.12.0",
-    "epub-codec": "3.0.1",
+    "doc-codec": "5.0.0",
+    "document-schema.js": "7.13.0",
+    "epub-codec": "4.0.0",
     "fflate": "0.8.3",
-    "markdown-codec": "8.0.1",
-    "odf.js": "8.0.3",
-    "ooxml.js": "10.0.1",
-    "pdf-codec": "5.2.2",
-    "ppt-codec": "2.0.3",
-    "rtf-codec": "6.0.1",
+    "markdown-codec": "9.0.0",
+    "odf.js": "10.0.0",
+    "ooxml.js": "11.0.0",
+    "pdf-codec": "5.2.3",
+    "ppt-codec": "2.0.4",
+    "rtf-codec": "7.0.0",
     "temml": "0.13.4",
-    "wpd-codec": "5.0.1",
-    "xls-codec": "4.15.14",
+    "wpd-codec": "5.0.2",
+    "xls-codec": "4.15.15",
     "zod": "4.4.3"
   },
   "devDependencies": {