document-schema 7.12.0 → 7.14.0

package/README.md

@@ -330,6 +330,12 @@ Well-formedness is a per-entry range check — `0 <= startRun <= endRun <= runs.
 
 Two harmonisations the inventories asked for are also deliberately absent. There is **no `fieldType` enum**: `instruction` is required and verbatim, so nothing is lost without one, and #24 asks for exactly one new vocabulary — `link`'s internal targets — rather than one per kind, with the four inventories' own corpus gate still standing before a field-type member set could be frozen honestly. And a **sheet-scoped named range** (xlsx defined names and tables, ODF `table:named-expressions`) is a definitions-table entry, not an `anchor`: a sheet group's children are its images and embedded documents, never a block flow, so there is no extent for an anchor to wrap — which is the odf inventory's own verdict for the identical construct.
 
+## The table grid rule
+
+A `ContentTable` row's `cells` array is dense: one entry per grid column, so a cell's index is its grid column. A merged region is an anchor entry carrying `colSpan`/`rowSpan` plus a block-less entry at every other position it covers, and `walkTableGrid` classifies every entry as an anchor or as covered. `ContentTableCell` states the rule in full; the schema cannot enforce it, since it is a property of a whole table and not of any one cell.
+
+`findTableGridFault(table)` is the one shared definition of when a table contradicts it, in the same way `findConstructMarkerImbalance` is for bracket balance. It never throws: it returns a descriptor of the first fault in reading order, or `undefined` for a conforming table. The faults are rows of differing lengths (`raggedRow`), blocks on a covered position (`coveredContent`), a span stated by a covered position (`coveredSpan`, which is how a second anchor starting inside another region shows up), an anchor reaching past the last column or row (`anchorOverrunsColumns`, `anchorOverrunsRows`), and an anchor reaching a position an earlier region already covers (`overlappingAnchors`). `describeTableGridFault` states a descriptor in one sentence for a writer that refuses or reports it, and every table writer in the family runs the check rather than deciding for itself what a covered position's blocks mean.
+
 ## The residue channel
 
 [#22](https://github.com/ExaDev/document-schema.js/issues/22)'s second channel, landed by [#718](https://github.com/ExaDev/documents.js/issues/718) (`src/source.ts`): a quarantined **`source: { format, xml }`** value for what has no cross-format meaning — a WordprocessingML proofing mark, a custom XML payload, a markdown raw-HTML block's remainder, a PDF XMP packet. `format` is a closed enum naming the producing format (one member per reader the workspace has today), so a consumer can tell residue it may restore from residue it must leave alone without reading the text; `xml` is that format's own serialisation, validated as opaque text and nothing more.

package/dist/codec.d.cts

@@ -1,4 +1,4 @@
-import { C as ContentDocument } from "./content-DnNAXdH_.cjs";
+import { C as ContentDocument } from "./content-BNUhgRbB.cjs";
 //#region src/codec.d.ts
 interface ContentCodec<TOptions = unknown> {
   read(bytes: Uint8Array, options?: TOptions): ContentDocument;

package/dist/codec.d.ts

@@ -1,4 +1,4 @@
-import { C as ContentDocument } from "./content-vx3Mbnjy.js";
+import { C as ContentDocument } from "./content-CYPkduUB.js";
 //#region src/codec.d.ts
 interface ContentCodec<TOptions = unknown> {
   read(bytes: Uint8Array, options?: TOptions): ContentDocument;

package/dist/{construct-C4XiF8OW.d.cts → construct-C9cYkjnd.d.cts}

@@ -1,12 +1,12 @@
 import { z } from "zod";
 //#region src/construct.d.ts
 declare const ContentControlTypeSchema: z.ZodEnum<{
-  date: "date";
   richText: "richText";
   plainText: "plainText";
   checkbox: "checkbox";
   dropDown: "dropDown";
   comboBox: "comboBox";
+  date: "date";
   picture: "picture";
   repeatingSection: "repeatingSection";
   button: "button";
@@ -23,12 +23,12 @@ type ContentControlLock = z.infer<typeof ContentControlLockSchema>;
 declare const ContentControlDescriptorSchema: z.ZodObject<{
   kind: z.ZodLiteral<"contentControl">;
   controlType: z.ZodEnum<{
-    date: "date";
     richText: "richText";
     plainText: "plainText";
     checkbox: "checkbox";
     dropDown: "dropDown";
     comboBox: "comboBox";
+    date: "date";
     picture: "picture";
     repeatingSection: "repeatingSection";
     button: "button";
@@ -94,19 +94,19 @@ declare const FieldDescriptorSchema: z.ZodObject<{
 }, z.core.$strict>;
 type FieldDescriptor = z.infer<typeof FieldDescriptorSchema>;
 declare const AnchorTypeSchema: z.ZodEnum<{
-  comment: "comment";
   bookmark: "bookmark";
   footnote: "footnote";
   endnote: "endnote";
+  comment: "comment";
 }>;
 type AnchorType = z.infer<typeof AnchorTypeSchema>;
 declare const AnchorDescriptorSchema: z.ZodObject<{
   kind: z.ZodLiteral<"anchor">;
   anchorType: z.ZodEnum<{
-    comment: "comment";
     bookmark: "bookmark";
     footnote: "footnote";
     endnote: "endnote";
+    comment: "comment";
   }>;
   name: z.ZodString;
   definition: z.ZodOptional<z.ZodString>;
@@ -252,12 +252,12 @@ type DivisionDescriptor = z.infer<typeof DivisionDescriptorSchema>;
 declare const ConstructDescriptorSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   kind: z.ZodLiteral<"contentControl">;
   controlType: z.ZodEnum<{
-    date: "date";
     richText: "richText";
     plainText: "plainText";
     checkbox: "checkbox";
     dropDown: "dropDown";
     comboBox: "comboBox";
+    date: "date";
     picture: "picture";
     repeatingSection: "repeatingSection";
     button: "button";
@@ -321,10 +321,10 @@ declare const ConstructDescriptorSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strict>, z.ZodObject<{
   kind: z.ZodLiteral<"anchor">;
   anchorType: z.ZodEnum<{
-    comment: "comment";
     bookmark: "bookmark";
     footnote: "footnote";
     endnote: "endnote";
+    comment: "comment";
   }>;
   name: z.ZodString;
   definition: z.ZodOptional<z.ZodString>;

package/dist/{construct-C4XiF8OW.d.ts → construct-C9cYkjnd.d.ts}

@@ -1,12 +1,12 @@
 import { z } from "zod";
 //#region src/construct.d.ts
 declare const ContentControlTypeSchema: z.ZodEnum<{
-  date: "date";
   richText: "richText";
   plainText: "plainText";
   checkbox: "checkbox";
   dropDown: "dropDown";
   comboBox: "comboBox";
+  date: "date";
   picture: "picture";
   repeatingSection: "repeatingSection";
   button: "button";
@@ -23,12 +23,12 @@ type ContentControlLock = z.infer<typeof ContentControlLockSchema>;
 declare const ContentControlDescriptorSchema: z.ZodObject<{
   kind: z.ZodLiteral<"contentControl">;
   controlType: z.ZodEnum<{
-    date: "date";
     richText: "richText";
     plainText: "plainText";
     checkbox: "checkbox";
     dropDown: "dropDown";
     comboBox: "comboBox";
+    date: "date";
     picture: "picture";
     repeatingSection: "repeatingSection";
     button: "button";
@@ -94,19 +94,19 @@ declare const FieldDescriptorSchema: z.ZodObject<{
 }, z.core.$strict>;
 type FieldDescriptor = z.infer<typeof FieldDescriptorSchema>;
 declare const AnchorTypeSchema: z.ZodEnum<{
-  comment: "comment";
   bookmark: "bookmark";
   footnote: "footnote";
   endnote: "endnote";
+  comment: "comment";
 }>;
 type AnchorType = z.infer<typeof AnchorTypeSchema>;
 declare const AnchorDescriptorSchema: z.ZodObject<{
   kind: z.ZodLiteral<"anchor">;
   anchorType: z.ZodEnum<{
-    comment: "comment";
     bookmark: "bookmark";
     footnote: "footnote";
     endnote: "endnote";
+    comment: "comment";
   }>;
   name: z.ZodString;
   definition: z.ZodOptional<z.ZodString>;
@@ -252,12 +252,12 @@ type DivisionDescriptor = z.infer<typeof DivisionDescriptorSchema>;
 declare const ConstructDescriptorSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   kind: z.ZodLiteral<"contentControl">;
   controlType: z.ZodEnum<{
-    date: "date";
     richText: "richText";
     plainText: "plainText";
     checkbox: "checkbox";
     dropDown: "dropDown";
     comboBox: "comboBox";
+    date: "date";
     picture: "picture";
     repeatingSection: "repeatingSection";
     button: "button";
@@ -321,10 +321,10 @@ declare const ConstructDescriptorSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strict>, z.ZodObject<{
   kind: z.ZodLiteral<"anchor">;
   anchorType: z.ZodEnum<{
-    comment: "comment";
     bookmark: "bookmark";
     footnote: "footnote";
     endnote: "endnote";
+    comment: "comment";
   }>;
   name: z.ZodString;
   definition: z.ZodOptional<z.ZodString>;

package/dist/construct.d.cts

@@ -1,2 +1,2 @@
-import { C as ProvenanceChange, E as ProvenanceDescriptorSchema, S as LinkTargetSchema, T as ProvenanceDescriptor, _ as FieldDescriptor, a as ConstructDescriptor, b as LinkDescriptorSchema, c as ContentControlDescriptorSchema, d as ContentControlType, f as ContentControlTypeSchema, g as DivisionSourceSchema, h as DivisionSource, i as AnchorTypeSchema, l as ContentControlLock, m as DivisionDescriptorSchema, n as AnchorDescriptorSchema, o as ConstructDescriptorSchema, p as DivisionDescriptor, r as AnchorType, s as ContentControlDescriptor, t as AnchorDescriptor, u as ContentControlLockSchema, v as FieldDescriptorSchema, w as ProvenanceChangeSchema, x as LinkTarget, y as LinkDescriptor } from "./construct-C4XiF8OW.cjs";
+import { C as ProvenanceChange, E as ProvenanceDescriptorSchema, S as LinkTargetSchema, T as ProvenanceDescriptor, _ as FieldDescriptor, a as ConstructDescriptor, b as LinkDescriptorSchema, c as ContentControlDescriptorSchema, d as ContentControlType, f as ContentControlTypeSchema, g as DivisionSourceSchema, h as DivisionSource, i as AnchorTypeSchema, l as ContentControlLock, m as DivisionDescriptorSchema, n as AnchorDescriptorSchema, o as ConstructDescriptorSchema, p as DivisionDescriptor, r as AnchorType, s as ContentControlDescriptor, t as AnchorDescriptor, u as ContentControlLockSchema, v as FieldDescriptorSchema, w as ProvenanceChangeSchema, x as LinkTarget, y as LinkDescriptor } from "./construct-C9cYkjnd.cjs";
 export { AnchorDescriptor, AnchorDescriptorSchema, AnchorType, AnchorTypeSchema, ConstructDescriptor, ConstructDescriptorSchema, ContentControlDescriptor, ContentControlDescriptorSchema, ContentControlLock, ContentControlLockSchema, ContentControlType, ContentControlTypeSchema, DivisionDescriptor, DivisionDescriptorSchema, DivisionSource, DivisionSourceSchema, FieldDescriptor, FieldDescriptorSchema, LinkDescriptor, LinkDescriptorSchema, LinkTarget, LinkTargetSchema, ProvenanceChange, ProvenanceChangeSchema, ProvenanceDescriptor, ProvenanceDescriptorSchema };

package/dist/construct.d.ts

@@ -1,2 +1,2 @@
-import { C as ProvenanceChange, E as ProvenanceDescriptorSchema, S as LinkTargetSchema, T as ProvenanceDescriptor, _ as FieldDescriptor, a as ConstructDescriptor, b as LinkDescriptorSchema, c as ContentControlDescriptorSchema, d as ContentControlType, f as ContentControlTypeSchema, g as DivisionSourceSchema, h as DivisionSource, i as AnchorTypeSchema, l as ContentControlLock, m as DivisionDescriptorSchema, n as AnchorDescriptorSchema, o as ConstructDescriptorSchema, p as DivisionDescriptor, r as AnchorType, s as ContentControlDescriptor, t as AnchorDescriptor, u as ContentControlLockSchema, v as FieldDescriptorSchema, w as ProvenanceChangeSchema, x as LinkTarget, y as LinkDescriptor } from "./construct-C4XiF8OW.js";
+import { C as ProvenanceChange, E as ProvenanceDescriptorSchema, S as LinkTargetSchema, T as ProvenanceDescriptor, _ as FieldDescriptor, a as ConstructDescriptor, b as LinkDescriptorSchema, c as ContentControlDescriptorSchema, d as ContentControlType, f as ContentControlTypeSchema, g as DivisionSourceSchema, h as DivisionSource, i as AnchorTypeSchema, l as ContentControlLock, m as DivisionDescriptorSchema, n as AnchorDescriptorSchema, o as ConstructDescriptorSchema, p as DivisionDescriptor, r as AnchorType, s as ContentControlDescriptor, t as AnchorDescriptor, u as ContentControlLockSchema, v as FieldDescriptorSchema, w as ProvenanceChangeSchema, x as LinkTarget, y as LinkDescriptor } from "./construct-C9cYkjnd.js";
 export { AnchorDescriptor, AnchorDescriptorSchema, AnchorType, AnchorTypeSchema, ConstructDescriptor, ConstructDescriptorSchema, ContentControlDescriptor, ContentControlDescriptorSchema, ContentControlLock, ContentControlLockSchema, ContentControlType, ContentControlTypeSchema, DivisionDescriptor, DivisionDescriptorSchema, DivisionSource, DivisionSourceSchema, FieldDescriptor, FieldDescriptorSchema, LinkDescriptor, LinkDescriptorSchema, LinkTarget, LinkTargetSchema, ProvenanceChange, ProvenanceChangeSchema, ProvenanceDescriptor, ProvenanceDescriptorSchema };