document-content-model 7.12.0 → 7.13.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/index.cjs

@@ -207,12 +207,14 @@ exports.contentDocumentWithSchema = require_schema_io.contentDocumentWithSchema;
 exports.dashedBorderWeightForWidthPt = require_border_weight.dashedBorderWeightForWidthPt;
 exports.decompose = require_decompose.decompose;
 exports.denseTableRows = require_table_grid.denseTableRows;
+exports.describeTableGridFault = require_table_grid.describeTableGridFault;
 exports.documentFromJson = require_schema_io.documentFromJson;
 exports.documentSchemaKindOf = require_schema_io.documentSchemaKindOf;
 exports.documentTreeWithSchema = require_schema_io.documentTreeWithSchema;
 exports.factorStyles = require_factor_styles.factorStyles;
 exports.findConstructMarkerImbalance = require_content.findConstructMarkerImbalance;
 exports.findRunConstructFault = require_content.findRunConstructFault;
+exports.findTableGridFault = require_table_grid.findTableGridFault;
 exports.flattenTree = require_flatten.flattenTree;
 exports.isContentBlock = require_content.isContentBlock;
 exports.isContentConstructEnd = require_content.isContentConstructEnd;

package/dist/index.d.cts

@@ -18,8 +18,8 @@ import { assembleTree, factorStyles } from "./factor-styles.cjs";
 import { flattenTree } from "./flatten.cjs";
 import { FontFace, FontRegistryOptions, FontSubstitution, ProvidedFont } from "./font-port.cjs";
 import { LayoutMetadata, LayoutMetadataSchema } from "./metadata.cjs";
-import { AnchorTableRow, PositionedTableCell, PositionedTableRow, TableGridAnchor, TableGridCovered, TableGridPosition, denseTableRows, placeAnchorTableRows, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, walkTableGrid } from "./table-grid.cjs";
+import { AnchorTableRow, PositionedTableCell, PositionedTableRow, TableGridAnchor, TableGridCovered, TableGridFault, TableGridPosition, denseTableRows, describeTableGridFault, findTableGridFault, placeAnchorTableRows, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, walkTableGrid } from "./table-grid.cjs";
 import { ContentDocumentJson, DocumentJsonResult, DocumentPackageRenamedError, DocumentSchemaKind, DocumentTreeJson, LayoutSchemaDemotedError, SCHEMA_FILE_NAMES, SchemaVersionMismatchError, UnrecognizedDocumentSchemaError, contentDocumentWithSchema, documentFromJson, documentSchemaKindOf, documentTreeWithSchema, schemaUriFor } from "./schema-io.cjs";
 import { StyledFragment, StyledRun, TextMeasurer, UnderlineMetrics, WrapOptions, WrappedLine } from "./text-layout.cjs";
 import { MathAssembledGlyphs, MathBox, MathColor, MathFontMetrics, MathGlyphMetrics, MathGlyphPlacement, MathGlyphRun, MathLayoutItem, MathRule, MathStretchAxis, MathStretchGlyph, MathStretchResult, MathStroke, PositionedFormula } from "./math-layout.cjs";
-export { Alignment, AlignmentSchema, AnchorDescriptor, AnchorDescriptorSchema, AnchorTableRow, AnchorType, AnchorTypeSchema, BORDER_WIDTH_PT, BorderWeight, Box, BoxSchema, COLOR_BLACK, CONTENT_ANNOTATION_FIELDS, CONTENT_DEFS, CONTENT_DOCUMENT_URI, CellPosition, CellRange, Color, ColorSchema, ConstructDescriptor, ConstructDescriptorSchema, ConstructMarkerImbalance, ConstructMarkerImbalanceError, ContentBitmapFill, ContentBitmapFillSchema, ContentBlock, ContentBlockSchema, ContentBorder, ContentBorderSchema, ContentCellBorders, ContentCellBordersSchema, ContentCellFill, ContentCellFillSchema, ContentCellPatternType, ContentCellPatternTypeSchema, ContentCellValue, ContentCellValueSchema, ContentCodec, ContentConstructEnd, ContentConstructEndSchema, ContentConstructStart, ContentConstructStartSchema, ContentControlDescriptor, ContentControlDescriptorSchema, ContentControlLock, ContentControlLockSchema, ContentControlType, ContentControlTypeSchema, ContentDefinedName, ContentDefinedNameSchema, ContentDocument, ContentDocumentJson, ContentDocumentSchema, ContentDrawPage, ContentDrawPageSchema, ContentEmbeddedObject, ContentEmbeddedObjectBlock, ContentEmbeddedObjectBlockSchema, ContentEmbeddedObjectKind, ContentEmbeddedObjectSchema, ContentFillPattern, ContentFillPatternSchema, ContentFloatAlign, ContentFloatAlignSchema, ContentFloatAxis, ContentFloatAxisSchema, ContentFloatOrigin, ContentFloatOriginSchema, ContentFloatPosition, ContentFloatPositionSchema, ContentFont, ContentFontSchema, ContentFormula, ContentFormulaSchema, ContentGradientFill, ContentGradientFillSchema, ContentGradientStyle, ContentGradientStyleSchema, ContentHatchFill, ContentHatchFillSchema, ContentHatchStyle, ContentHatchStyleSchema, ContentImageBlock, ContentImageBlockSchema, ContentImageOriginal, ContentImageOriginalSchema, ContentInterpretation, ContentInterpretationSchema, ContentListMembership, ContentListMembershipSchema, ContentOrigin, ContentOriginSchema, ContentPageBreak, ContentPageBreakSchema, ContentPageFurniture, ContentPageFurnitureSchema, ContentParagraph, ContentParagraphBorders, ContentParagraphBordersSchema, ContentParagraphSchema, ContentPathPoint, ContentPathPointSchema, ContentPathSegment, ContentPathSegmentSchema, ContentRun, ContentRunSchema, ContentSection, ContentSectionSchema, ContentShape, ContentShapeSchema, ContentSheet, ContentSheetCell, ContentSheetCellComment, ContentSheetCellCommentSchema, ContentSheetCellSchema, ContentSheetColumn, ContentSheetColumnSchema, ContentSheetConditionalFormat, ContentSheetConditionalFormatSchema, ContentSheetConditionalFormatStyle, ContentSheetConditionalFormatStyleSchema, ContentSheetConditionalFormatValue, ContentSheetConditionalFormatValueSchema, ContentSheetDataValidation, ContentSheetDataValidationSchema, ContentSheetDataValidationType, ContentSheetDataValidationTypeSchema, ContentSheetImage, ContentSheetImageSchema, ContentSheetPrintRange, ContentSheetPrintRangeSchema, ContentSheetPrintSettings, ContentSheetPrintSettingsSchema, ContentSheetRange, ContentSheetRangeSchema, ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, ContentSlide, ContentSlideSchema, ContentStroke, ContentStrokeDash, ContentStrokeDashSchema, ContentStrokeSchema, ContentStrokeStyle, ContentStrokeStyleSchema, ContentSubpath, ContentSubpathSchema, ContentTable, ContentTableCell, ContentTableCellSchema, ContentTableRow, ContentTableRowSchema, ContentTableSchema, ContentTranscript, ContentTranscriptSchema, ContentVector, ContentVectorSchema, DEFAULT_LAYOUT_FONT, DecimalString, DecimalStringSchema, DefinitionEntry, DefinitionEntrySchema, DefinitionsTable, DefinitionsTableSchema, DimensionVector, DimensionVectorSchema, DivisionDescriptor, DivisionDescriptorSchema, DivisionSource, DivisionSourceSchema, DocumentJsonResult, DocumentPackageRenamedError, DocumentSchemaKind, DocumentTree, DocumentTreeJson, DocumentTreeSchema, DrawPageChild, DrawPageDescriptor, DrawPageDescriptorSchema, DrawPageGroupNode, DrawPageGroupSchema, EMBEDDED_OBJECT_KINDS, EvaluationValue, EvaluationValueSchema, ExactRational, ExactRationalSchema, FieldDescriptor, FieldDescriptorSchema, FontFace, FontRegistryOptions, FontSubstitution, FormulaBindings, FormulaBindingsSchema, FusedNode, HeadingGroupNode, HeadingGroupSchema, HeadingParagraph, HeadingParagraphSchema, IMAGE_FORMATS, ImageFormat, Interval, IntervalSchema, LayoutFont, LayoutFontSchema, LayoutFrame, LayoutFrameSchema, LayoutMetadata, LayoutMetadataSchema, LayoutSchemaDemotedError, LinkDescriptor, LinkDescriptorSchema, LinkTarget, LinkTargetSchema, ListChild, ListGroupNode, ListGroupSchema, ListParagraph, ListParagraphSchema, MAX_SAFE_INTEGER, Margins, MarginsSchema, MathApp, MathAppSchema, MathAssembledGlyphs, MathBox, MathColor, MathExpression, MathExpressionSchema, MathFontMetrics, MathGlyphMetrics, MathGlyphPlacement, MathGlyphRun, MathLayoutItem, MathMatrix, MathMatrixSchema, MathMlAttribute, MathMlAttributeSchema, MathMlCdata, MathMlCdataSchema, MathMlComment, MathMlCommentSchema, MathMlDeclaration, MathMlDeclarationSchema, MathMlElement, MathMlElementSchema, MathMlNode, MathMlNodeSchema, MathMlPi, MathMlPiSchema, MathMlText, MathMlTextSchema, MathNormalisationContext, MathNormalisationContextSchema, MathNum, MathNumSchema, MathPresentation, MathPresentationSchema, MathProd, MathProdSchema, MathProvenance, MathProvenanceSchema, MathQty, MathQtySchema, MathRule, MathStretchAxis, MathStretchGlyph, MathStretchResult, MathStroke, MathSum, MathSumSchema, MathSym, MathSymSchema, MathSymbolEntry, MathSymbolEntrySchema, MathUncertainty, MathUncertaintySchema, MathUnit, MathUnitSchema, MathUnparsed, MathUnparsedSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSize, PageSizeSchema, Point, PositionedFormula, PositionedTableCell, PositionedTableRow, ProvenanceChange, ProvenanceChangeSchema, ProvenanceDescriptor, ProvenanceDescriptorSchema, ProvidedFont, Quantity, QuantitySchema, RUN_FONT_PROPERTY_SHAPE, RunConstructExtent, RunConstructExtentSchema, RunConstructFault, SCHEMA_FILE_NAMES, SI_BASE_DIMENSIONS, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, SchemaVersionMismatchError, SectionChild, SectionConstructGroupNode, SectionConstructGroupSchema, SectionDescriptor, SectionDescriptorSchema, SectionGroupNode, SectionGroupSchema, ShapeChild, ShapeConstructGroupNode, ShapeConstructGroupSchema, ShapeDescriptor, ShapeDescriptorSchema, ShapeGroupNode, ShapeGroupSchema, SheetChild, SheetDescriptor, SheetDescriptorSchema, SheetGroupNode, SheetGroupSchema, SheetRuleOperator, SheetRuleOperatorSchema, SiBaseDimension, SlideDescriptor, SlideDescriptorSchema, SlideGroupNode, SlideGroupSchema, SourceFormat, SourceFormatSchema, SourceResidue, SourceResidueSchema, StyleEntry, StyleEntrySchema, StyleParagraphProperties, StyleParagraphPropertiesSchema, StyleRunProperties, StyleRunPropertiesSchema, StyledFragment, StyledRun, StylesTable, StylesTableSchema, SymbolTable, SymbolTableSchema, TableGridAnchor, TableGridCovered, TableGridPosition, TextDirection, TextDirectionSchema, TextMeasurer, TreeBlockLeaf, TreeBlockLeafSchema, type TreeChildren, TreeEmbeddedFont, TreeEmbeddedFontSchema, TreeGroup, TreeGroupSchema, TreeLeaf, TreeLeafSchema, TreeNode, TreeNodeSchema, UnderlineMetrics, UnrecognizedDocumentSchemaError, WrapOptions, WrappedLine, applyParagraphStyleProperties, applyRunStyleProperties, assembleTree, borderWeightForWidthPt, cellReference, clampHeadingLevel, colorToRgbHex, columnIndexToLetters, columnLettersToIndex, contentDocumentSharedFields, contentDocumentWithSchema, dashedBorderWeightForWidthPt, decompose, denseTableRows, documentFromJson, documentSchemaKindOf, documentTreeWithSchema, factorStyles, findConstructMarkerImbalance, findRunConstructFault, flattenTree, isContentBlock, isContentConstructEnd, isContentConstructStart, isDrawPageGroupNode, isHeadingGroupNode, isListGroupNode, isMathExpression, isMathMlNode, isRunConstructExtent, isSectionConstructGroupNode, isSectionGroupNode, isShapeConstructGroupNode, isShapeGroupNode, isSheetGroupNode, isSlideGroupNode, isTreeBlockLeaf, isTreeGroup, isTreeLeaf, isTreeNode, overlayStyleEntries, parseCellReference, parseRangeReference, placeAnchorTableRows, rangeReference, resolveCellFillColor, resolveStyleChain, rgbHexToColor, schemaUriFor, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, unrecognizedFillKind, walkTableGrid };
+export { Alignment, AlignmentSchema, AnchorDescriptor, AnchorDescriptorSchema, AnchorTableRow, AnchorType, AnchorTypeSchema, BORDER_WIDTH_PT, BorderWeight, Box, BoxSchema, COLOR_BLACK, CONTENT_ANNOTATION_FIELDS, CONTENT_DEFS, CONTENT_DOCUMENT_URI, CellPosition, CellRange, Color, ColorSchema, ConstructDescriptor, ConstructDescriptorSchema, ConstructMarkerImbalance, ConstructMarkerImbalanceError, ContentBitmapFill, ContentBitmapFillSchema, ContentBlock, ContentBlockSchema, ContentBorder, ContentBorderSchema, ContentCellBorders, ContentCellBordersSchema, ContentCellFill, ContentCellFillSchema, ContentCellPatternType, ContentCellPatternTypeSchema, ContentCellValue, ContentCellValueSchema, ContentCodec, ContentConstructEnd, ContentConstructEndSchema, ContentConstructStart, ContentConstructStartSchema, ContentControlDescriptor, ContentControlDescriptorSchema, ContentControlLock, ContentControlLockSchema, ContentControlType, ContentControlTypeSchema, ContentDefinedName, ContentDefinedNameSchema, ContentDocument, ContentDocumentJson, ContentDocumentSchema, ContentDrawPage, ContentDrawPageSchema, ContentEmbeddedObject, ContentEmbeddedObjectBlock, ContentEmbeddedObjectBlockSchema, ContentEmbeddedObjectKind, ContentEmbeddedObjectSchema, ContentFillPattern, ContentFillPatternSchema, ContentFloatAlign, ContentFloatAlignSchema, ContentFloatAxis, ContentFloatAxisSchema, ContentFloatOrigin, ContentFloatOriginSchema, ContentFloatPosition, ContentFloatPositionSchema, ContentFont, ContentFontSchema, ContentFormula, ContentFormulaSchema, ContentGradientFill, ContentGradientFillSchema, ContentGradientStyle, ContentGradientStyleSchema, ContentHatchFill, ContentHatchFillSchema, ContentHatchStyle, ContentHatchStyleSchema, ContentImageBlock, ContentImageBlockSchema, ContentImageOriginal, ContentImageOriginalSchema, ContentInterpretation, ContentInterpretationSchema, ContentListMembership, ContentListMembershipSchema, ContentOrigin, ContentOriginSchema, ContentPageBreak, ContentPageBreakSchema, ContentPageFurniture, ContentPageFurnitureSchema, ContentParagraph, ContentParagraphBorders, ContentParagraphBordersSchema, ContentParagraphSchema, ContentPathPoint, ContentPathPointSchema, ContentPathSegment, ContentPathSegmentSchema, ContentRun, ContentRunSchema, ContentSection, ContentSectionSchema, ContentShape, ContentShapeSchema, ContentSheet, ContentSheetCell, ContentSheetCellComment, ContentSheetCellCommentSchema, ContentSheetCellSchema, ContentSheetColumn, ContentSheetColumnSchema, ContentSheetConditionalFormat, ContentSheetConditionalFormatSchema, ContentSheetConditionalFormatStyle, ContentSheetConditionalFormatStyleSchema, ContentSheetConditionalFormatValue, ContentSheetConditionalFormatValueSchema, ContentSheetDataValidation, ContentSheetDataValidationSchema, ContentSheetDataValidationType, ContentSheetDataValidationTypeSchema, ContentSheetImage, ContentSheetImageSchema, ContentSheetPrintRange, ContentSheetPrintRangeSchema, ContentSheetPrintSettings, ContentSheetPrintSettingsSchema, ContentSheetRange, ContentSheetRangeSchema, ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, ContentSlide, ContentSlideSchema, ContentStroke, ContentStrokeDash, ContentStrokeDashSchema, ContentStrokeSchema, ContentStrokeStyle, ContentStrokeStyleSchema, ContentSubpath, ContentSubpathSchema, ContentTable, ContentTableCell, ContentTableCellSchema, ContentTableRow, ContentTableRowSchema, ContentTableSchema, ContentTranscript, ContentTranscriptSchema, ContentVector, ContentVectorSchema, DEFAULT_LAYOUT_FONT, DecimalString, DecimalStringSchema, DefinitionEntry, DefinitionEntrySchema, DefinitionsTable, DefinitionsTableSchema, DimensionVector, DimensionVectorSchema, DivisionDescriptor, DivisionDescriptorSchema, DivisionSource, DivisionSourceSchema, DocumentJsonResult, DocumentPackageRenamedError, DocumentSchemaKind, DocumentTree, DocumentTreeJson, DocumentTreeSchema, DrawPageChild, DrawPageDescriptor, DrawPageDescriptorSchema, DrawPageGroupNode, DrawPageGroupSchema, EMBEDDED_OBJECT_KINDS, EvaluationValue, EvaluationValueSchema, ExactRational, ExactRationalSchema, FieldDescriptor, FieldDescriptorSchema, FontFace, FontRegistryOptions, FontSubstitution, FormulaBindings, FormulaBindingsSchema, FusedNode, HeadingGroupNode, HeadingGroupSchema, HeadingParagraph, HeadingParagraphSchema, IMAGE_FORMATS, ImageFormat, Interval, IntervalSchema, LayoutFont, LayoutFontSchema, LayoutFrame, LayoutFrameSchema, LayoutMetadata, LayoutMetadataSchema, LayoutSchemaDemotedError, LinkDescriptor, LinkDescriptorSchema, LinkTarget, LinkTargetSchema, ListChild, ListGroupNode, ListGroupSchema, ListParagraph, ListParagraphSchema, MAX_SAFE_INTEGER, Margins, MarginsSchema, MathApp, MathAppSchema, MathAssembledGlyphs, MathBox, MathColor, MathExpression, MathExpressionSchema, MathFontMetrics, MathGlyphMetrics, MathGlyphPlacement, MathGlyphRun, MathLayoutItem, MathMatrix, MathMatrixSchema, MathMlAttribute, MathMlAttributeSchema, MathMlCdata, MathMlCdataSchema, MathMlComment, MathMlCommentSchema, MathMlDeclaration, MathMlDeclarationSchema, MathMlElement, MathMlElementSchema, MathMlNode, MathMlNodeSchema, MathMlPi, MathMlPiSchema, MathMlText, MathMlTextSchema, MathNormalisationContext, MathNormalisationContextSchema, MathNum, MathNumSchema, MathPresentation, MathPresentationSchema, MathProd, MathProdSchema, MathProvenance, MathProvenanceSchema, MathQty, MathQtySchema, MathRule, MathStretchAxis, MathStretchGlyph, MathStretchResult, MathStroke, MathSum, MathSumSchema, MathSym, MathSymSchema, MathSymbolEntry, MathSymbolEntrySchema, MathUncertainty, MathUncertaintySchema, MathUnit, MathUnitSchema, MathUnparsed, MathUnparsedSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSize, PageSizeSchema, Point, PositionedFormula, PositionedTableCell, PositionedTableRow, ProvenanceChange, ProvenanceChangeSchema, ProvenanceDescriptor, ProvenanceDescriptorSchema, ProvidedFont, Quantity, QuantitySchema, RUN_FONT_PROPERTY_SHAPE, RunConstructExtent, RunConstructExtentSchema, RunConstructFault, SCHEMA_FILE_NAMES, SI_BASE_DIMENSIONS, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, SchemaVersionMismatchError, SectionChild, SectionConstructGroupNode, SectionConstructGroupSchema, SectionDescriptor, SectionDescriptorSchema, SectionGroupNode, SectionGroupSchema, ShapeChild, ShapeConstructGroupNode, ShapeConstructGroupSchema, ShapeDescriptor, ShapeDescriptorSchema, ShapeGroupNode, ShapeGroupSchema, SheetChild, SheetDescriptor, SheetDescriptorSchema, SheetGroupNode, SheetGroupSchema, SheetRuleOperator, SheetRuleOperatorSchema, SiBaseDimension, SlideDescriptor, SlideDescriptorSchema, SlideGroupNode, SlideGroupSchema, SourceFormat, SourceFormatSchema, SourceResidue, SourceResidueSchema, StyleEntry, StyleEntrySchema, StyleParagraphProperties, StyleParagraphPropertiesSchema, StyleRunProperties, StyleRunPropertiesSchema, StyledFragment, StyledRun, StylesTable, StylesTableSchema, SymbolTable, SymbolTableSchema, TableGridAnchor, TableGridCovered, TableGridFault, TableGridPosition, TextDirection, TextDirectionSchema, TextMeasurer, TreeBlockLeaf, TreeBlockLeafSchema, type TreeChildren, TreeEmbeddedFont, TreeEmbeddedFontSchema, TreeGroup, TreeGroupSchema, TreeLeaf, TreeLeafSchema, TreeNode, TreeNodeSchema, UnderlineMetrics, UnrecognizedDocumentSchemaError, WrapOptions, WrappedLine, applyParagraphStyleProperties, applyRunStyleProperties, assembleTree, borderWeightForWidthPt, cellReference, clampHeadingLevel, colorToRgbHex, columnIndexToLetters, columnLettersToIndex, contentDocumentSharedFields, contentDocumentWithSchema, dashedBorderWeightForWidthPt, decompose, denseTableRows, describeTableGridFault, documentFromJson, documentSchemaKindOf, documentTreeWithSchema, factorStyles, findConstructMarkerImbalance, findRunConstructFault, findTableGridFault, flattenTree, isContentBlock, isContentConstructEnd, isContentConstructStart, isDrawPageGroupNode, isHeadingGroupNode, isListGroupNode, isMathExpression, isMathMlNode, isRunConstructExtent, isSectionConstructGroupNode, isSectionGroupNode, isShapeConstructGroupNode, isShapeGroupNode, isSheetGroupNode, isSlideGroupNode, isTreeBlockLeaf, isTreeGroup, isTreeLeaf, isTreeNode, overlayStyleEntries, parseCellReference, parseRangeReference, placeAnchorTableRows, rangeReference, resolveCellFillColor, resolveStyleChain, rgbHexToColor, schemaUriFor, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, unrecognizedFillKind, walkTableGrid };

package/dist/index.d.ts

@@ -18,8 +18,8 @@ import { assembleTree, factorStyles } from "./factor-styles.js";
 import { flattenTree } from "./flatten.js";
 import { FontFace, FontRegistryOptions, FontSubstitution, ProvidedFont } from "./font-port.js";
 import { LayoutMetadata, LayoutMetadataSchema } from "./metadata.js";
-import { AnchorTableRow, PositionedTableCell, PositionedTableRow, TableGridAnchor, TableGridCovered, TableGridPosition, denseTableRows, placeAnchorTableRows, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, walkTableGrid } from "./table-grid.js";
+import { AnchorTableRow, PositionedTableCell, PositionedTableRow, TableGridAnchor, TableGridCovered, TableGridFault, TableGridPosition, denseTableRows, describeTableGridFault, findTableGridFault, placeAnchorTableRows, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, walkTableGrid } from "./table-grid.js";
 import { ContentDocumentJson, DocumentJsonResult, DocumentPackageRenamedError, DocumentSchemaKind, DocumentTreeJson, LayoutSchemaDemotedError, SCHEMA_FILE_NAMES, SchemaVersionMismatchError, UnrecognizedDocumentSchemaError, contentDocumentWithSchema, documentFromJson, documentSchemaKindOf, documentTreeWithSchema, schemaUriFor } from "./schema-io.js";
 import { StyledFragment, StyledRun, TextMeasurer, UnderlineMetrics, WrapOptions, WrappedLine } from "./text-layout.js";
 import { MathAssembledGlyphs, MathBox, MathColor, MathFontMetrics, MathGlyphMetrics, MathGlyphPlacement, MathGlyphRun, MathLayoutItem, MathRule, MathStretchAxis, MathStretchGlyph, MathStretchResult, MathStroke, PositionedFormula } from "./math-layout.js";
-export { Alignment, AlignmentSchema, AnchorDescriptor, AnchorDescriptorSchema, AnchorTableRow, AnchorType, AnchorTypeSchema, BORDER_WIDTH_PT, BorderWeight, Box, BoxSchema, COLOR_BLACK, CONTENT_ANNOTATION_FIELDS, CONTENT_DEFS, CONTENT_DOCUMENT_URI, CellPosition, CellRange, Color, ColorSchema, ConstructDescriptor, ConstructDescriptorSchema, ConstructMarkerImbalance, ConstructMarkerImbalanceError, ContentBitmapFill, ContentBitmapFillSchema, ContentBlock, ContentBlockSchema, ContentBorder, ContentBorderSchema, ContentCellBorders, ContentCellBordersSchema, ContentCellFill, ContentCellFillSchema, ContentCellPatternType, ContentCellPatternTypeSchema, ContentCellValue, ContentCellValueSchema, ContentCodec, ContentConstructEnd, ContentConstructEndSchema, ContentConstructStart, ContentConstructStartSchema, ContentControlDescriptor, ContentControlDescriptorSchema, ContentControlLock, ContentControlLockSchema, ContentControlType, ContentControlTypeSchema, ContentDefinedName, ContentDefinedNameSchema, ContentDocument, ContentDocumentJson, ContentDocumentSchema, ContentDrawPage, ContentDrawPageSchema, ContentEmbeddedObject, ContentEmbeddedObjectBlock, ContentEmbeddedObjectBlockSchema, ContentEmbeddedObjectKind, ContentEmbeddedObjectSchema, ContentFillPattern, ContentFillPatternSchema, ContentFloatAlign, ContentFloatAlignSchema, ContentFloatAxis, ContentFloatAxisSchema, ContentFloatOrigin, ContentFloatOriginSchema, ContentFloatPosition, ContentFloatPositionSchema, ContentFont, ContentFontSchema, ContentFormula, ContentFormulaSchema, ContentGradientFill, ContentGradientFillSchema, ContentGradientStyle, ContentGradientStyleSchema, ContentHatchFill, ContentHatchFillSchema, ContentHatchStyle, ContentHatchStyleSchema, ContentImageBlock, ContentImageBlockSchema, ContentImageOriginal, ContentImageOriginalSchema, ContentInterpretation, ContentInterpretationSchema, ContentListMembership, ContentListMembershipSchema, ContentOrigin, ContentOriginSchema, ContentPageBreak, ContentPageBreakSchema, ContentPageFurniture, ContentPageFurnitureSchema, ContentParagraph, ContentParagraphBorders, ContentParagraphBordersSchema, ContentParagraphSchema, ContentPathPoint, ContentPathPointSchema, ContentPathSegment, ContentPathSegmentSchema, ContentRun, ContentRunSchema, ContentSection, ContentSectionSchema, ContentShape, ContentShapeSchema, ContentSheet, ContentSheetCell, ContentSheetCellComment, ContentSheetCellCommentSchema, ContentSheetCellSchema, ContentSheetColumn, ContentSheetColumnSchema, ContentSheetConditionalFormat, ContentSheetConditionalFormatSchema, ContentSheetConditionalFormatStyle, ContentSheetConditionalFormatStyleSchema, ContentSheetConditionalFormatValue, ContentSheetConditionalFormatValueSchema, ContentSheetDataValidation, ContentSheetDataValidationSchema, ContentSheetDataValidationType, ContentSheetDataValidationTypeSchema, ContentSheetImage, ContentSheetImageSchema, ContentSheetPrintRange, ContentSheetPrintRangeSchema, ContentSheetPrintSettings, ContentSheetPrintSettingsSchema, ContentSheetRange, ContentSheetRangeSchema, ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, ContentSlide, ContentSlideSchema, ContentStroke, ContentStrokeDash, ContentStrokeDashSchema, ContentStrokeSchema, ContentStrokeStyle, ContentStrokeStyleSchema, ContentSubpath, ContentSubpathSchema, ContentTable, ContentTableCell, ContentTableCellSchema, ContentTableRow, ContentTableRowSchema, ContentTableSchema, ContentTranscript, ContentTranscriptSchema, ContentVector, ContentVectorSchema, DEFAULT_LAYOUT_FONT, DecimalString, DecimalStringSchema, DefinitionEntry, DefinitionEntrySchema, DefinitionsTable, DefinitionsTableSchema, DimensionVector, DimensionVectorSchema, DivisionDescriptor, DivisionDescriptorSchema, DivisionSource, DivisionSourceSchema, DocumentJsonResult, DocumentPackageRenamedError, DocumentSchemaKind, DocumentTree, DocumentTreeJson, DocumentTreeSchema, DrawPageChild, DrawPageDescriptor, DrawPageDescriptorSchema, DrawPageGroupNode, DrawPageGroupSchema, EMBEDDED_OBJECT_KINDS, EvaluationValue, EvaluationValueSchema, ExactRational, ExactRationalSchema, FieldDescriptor, FieldDescriptorSchema, FontFace, FontRegistryOptions, FontSubstitution, FormulaBindings, FormulaBindingsSchema, FusedNode, HeadingGroupNode, HeadingGroupSchema, HeadingParagraph, HeadingParagraphSchema, IMAGE_FORMATS, ImageFormat, Interval, IntervalSchema, LayoutFont, LayoutFontSchema, LayoutFrame, LayoutFrameSchema, LayoutMetadata, LayoutMetadataSchema, LayoutSchemaDemotedError, LinkDescriptor, LinkDescriptorSchema, LinkTarget, LinkTargetSchema, ListChild, ListGroupNode, ListGroupSchema, ListParagraph, ListParagraphSchema, MAX_SAFE_INTEGER, Margins, MarginsSchema, MathApp, MathAppSchema, MathAssembledGlyphs, MathBox, MathColor, MathExpression, MathExpressionSchema, MathFontMetrics, MathGlyphMetrics, MathGlyphPlacement, MathGlyphRun, MathLayoutItem, MathMatrix, MathMatrixSchema, MathMlAttribute, MathMlAttributeSchema, MathMlCdata, MathMlCdataSchema, MathMlComment, MathMlCommentSchema, MathMlDeclaration, MathMlDeclarationSchema, MathMlElement, MathMlElementSchema, MathMlNode, MathMlNodeSchema, MathMlPi, MathMlPiSchema, MathMlText, MathMlTextSchema, MathNormalisationContext, MathNormalisationContextSchema, MathNum, MathNumSchema, MathPresentation, MathPresentationSchema, MathProd, MathProdSchema, MathProvenance, MathProvenanceSchema, MathQty, MathQtySchema, MathRule, MathStretchAxis, MathStretchGlyph, MathStretchResult, MathStroke, MathSum, MathSumSchema, MathSym, MathSymSchema, MathSymbolEntry, MathSymbolEntrySchema, MathUncertainty, MathUncertaintySchema, MathUnit, MathUnitSchema, MathUnparsed, MathUnparsedSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSize, PageSizeSchema, Point, PositionedFormula, PositionedTableCell, PositionedTableRow, ProvenanceChange, ProvenanceChangeSchema, ProvenanceDescriptor, ProvenanceDescriptorSchema, ProvidedFont, Quantity, QuantitySchema, RUN_FONT_PROPERTY_SHAPE, RunConstructExtent, RunConstructExtentSchema, RunConstructFault, SCHEMA_FILE_NAMES, SI_BASE_DIMENSIONS, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, SchemaVersionMismatchError, SectionChild, SectionConstructGroupNode, SectionConstructGroupSchema, SectionDescriptor, SectionDescriptorSchema, SectionGroupNode, SectionGroupSchema, ShapeChild, ShapeConstructGroupNode, ShapeConstructGroupSchema, ShapeDescriptor, ShapeDescriptorSchema, ShapeGroupNode, ShapeGroupSchema, SheetChild, SheetDescriptor, SheetDescriptorSchema, SheetGroupNode, SheetGroupSchema, SheetRuleOperator, SheetRuleOperatorSchema, SiBaseDimension, SlideDescriptor, SlideDescriptorSchema, SlideGroupNode, SlideGroupSchema, SourceFormat, SourceFormatSchema, SourceResidue, SourceResidueSchema, StyleEntry, StyleEntrySchema, StyleParagraphProperties, StyleParagraphPropertiesSchema, StyleRunProperties, StyleRunPropertiesSchema, StyledFragment, StyledRun, StylesTable, StylesTableSchema, SymbolTable, SymbolTableSchema, TableGridAnchor, TableGridCovered, TableGridPosition, TextDirection, TextDirectionSchema, TextMeasurer, TreeBlockLeaf, TreeBlockLeafSchema, type TreeChildren, TreeEmbeddedFont, TreeEmbeddedFontSchema, TreeGroup, TreeGroupSchema, TreeLeaf, TreeLeafSchema, TreeNode, TreeNodeSchema, UnderlineMetrics, UnrecognizedDocumentSchemaError, WrapOptions, WrappedLine, applyParagraphStyleProperties, applyRunStyleProperties, assembleTree, borderWeightForWidthPt, cellReference, clampHeadingLevel, colorToRgbHex, columnIndexToLetters, columnLettersToIndex, contentDocumentSharedFields, contentDocumentWithSchema, dashedBorderWeightForWidthPt, decompose, denseTableRows, documentFromJson, documentSchemaKindOf, documentTreeWithSchema, factorStyles, findConstructMarkerImbalance, findRunConstructFault, flattenTree, isContentBlock, isContentConstructEnd, isContentConstructStart, isDrawPageGroupNode, isHeadingGroupNode, isListGroupNode, isMathExpression, isMathMlNode, isRunConstructExtent, isSectionConstructGroupNode, isSectionGroupNode, isShapeConstructGroupNode, isShapeGroupNode, isSheetGroupNode, isSlideGroupNode, isTreeBlockLeaf, isTreeGroup, isTreeLeaf, isTreeNode, overlayStyleEntries, parseCellReference, parseRangeReference, placeAnchorTableRows, rangeReference, resolveCellFillColor, resolveStyleChain, rgbHexToColor, schemaUriFor, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, unrecognizedFillKind, walkTableGrid };
+export { Alignment, AlignmentSchema, AnchorDescriptor, AnchorDescriptorSchema, AnchorTableRow, AnchorType, AnchorTypeSchema, BORDER_WIDTH_PT, BorderWeight, Box, BoxSchema, COLOR_BLACK, CONTENT_ANNOTATION_FIELDS, CONTENT_DEFS, CONTENT_DOCUMENT_URI, CellPosition, CellRange, Color, ColorSchema, ConstructDescriptor, ConstructDescriptorSchema, ConstructMarkerImbalance, ConstructMarkerImbalanceError, ContentBitmapFill, ContentBitmapFillSchema, ContentBlock, ContentBlockSchema, ContentBorder, ContentBorderSchema, ContentCellBorders, ContentCellBordersSchema, ContentCellFill, ContentCellFillSchema, ContentCellPatternType, ContentCellPatternTypeSchema, ContentCellValue, ContentCellValueSchema, ContentCodec, ContentConstructEnd, ContentConstructEndSchema, ContentConstructStart, ContentConstructStartSchema, ContentControlDescriptor, ContentControlDescriptorSchema, ContentControlLock, ContentControlLockSchema, ContentControlType, ContentControlTypeSchema, ContentDefinedName, ContentDefinedNameSchema, ContentDocument, ContentDocumentJson, ContentDocumentSchema, ContentDrawPage, ContentDrawPageSchema, ContentEmbeddedObject, ContentEmbeddedObjectBlock, ContentEmbeddedObjectBlockSchema, ContentEmbeddedObjectKind, ContentEmbeddedObjectSchema, ContentFillPattern, ContentFillPatternSchema, ContentFloatAlign, ContentFloatAlignSchema, ContentFloatAxis, ContentFloatAxisSchema, ContentFloatOrigin, ContentFloatOriginSchema, ContentFloatPosition, ContentFloatPositionSchema, ContentFont, ContentFontSchema, ContentFormula, ContentFormulaSchema, ContentGradientFill, ContentGradientFillSchema, ContentGradientStyle, ContentGradientStyleSchema, ContentHatchFill, ContentHatchFillSchema, ContentHatchStyle, ContentHatchStyleSchema, ContentImageBlock, ContentImageBlockSchema, ContentImageOriginal, ContentImageOriginalSchema, ContentInterpretation, ContentInterpretationSchema, ContentListMembership, ContentListMembershipSchema, ContentOrigin, ContentOriginSchema, ContentPageBreak, ContentPageBreakSchema, ContentPageFurniture, ContentPageFurnitureSchema, ContentParagraph, ContentParagraphBorders, ContentParagraphBordersSchema, ContentParagraphSchema, ContentPathPoint, ContentPathPointSchema, ContentPathSegment, ContentPathSegmentSchema, ContentRun, ContentRunSchema, ContentSection, ContentSectionSchema, ContentShape, ContentShapeSchema, ContentSheet, ContentSheetCell, ContentSheetCellComment, ContentSheetCellCommentSchema, ContentSheetCellSchema, ContentSheetColumn, ContentSheetColumnSchema, ContentSheetConditionalFormat, ContentSheetConditionalFormatSchema, ContentSheetConditionalFormatStyle, ContentSheetConditionalFormatStyleSchema, ContentSheetConditionalFormatValue, ContentSheetConditionalFormatValueSchema, ContentSheetDataValidation, ContentSheetDataValidationSchema, ContentSheetDataValidationType, ContentSheetDataValidationTypeSchema, ContentSheetImage, ContentSheetImageSchema, ContentSheetPrintRange, ContentSheetPrintRangeSchema, ContentSheetPrintSettings, ContentSheetPrintSettingsSchema, ContentSheetRange, ContentSheetRangeSchema, ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, ContentSlide, ContentSlideSchema, ContentStroke, ContentStrokeDash, ContentStrokeDashSchema, ContentStrokeSchema, ContentStrokeStyle, ContentStrokeStyleSchema, ContentSubpath, ContentSubpathSchema, ContentTable, ContentTableCell, ContentTableCellSchema, ContentTableRow, ContentTableRowSchema, ContentTableSchema, ContentTranscript, ContentTranscriptSchema, ContentVector, ContentVectorSchema, DEFAULT_LAYOUT_FONT, DecimalString, DecimalStringSchema, DefinitionEntry, DefinitionEntrySchema, DefinitionsTable, DefinitionsTableSchema, DimensionVector, DimensionVectorSchema, DivisionDescriptor, DivisionDescriptorSchema, DivisionSource, DivisionSourceSchema, DocumentJsonResult, DocumentPackageRenamedError, DocumentSchemaKind, DocumentTree, DocumentTreeJson, DocumentTreeSchema, DrawPageChild, DrawPageDescriptor, DrawPageDescriptorSchema, DrawPageGroupNode, DrawPageGroupSchema, EMBEDDED_OBJECT_KINDS, EvaluationValue, EvaluationValueSchema, ExactRational, ExactRationalSchema, FieldDescriptor, FieldDescriptorSchema, FontFace, FontRegistryOptions, FontSubstitution, FormulaBindings, FormulaBindingsSchema, FusedNode, HeadingGroupNode, HeadingGroupSchema, HeadingParagraph, HeadingParagraphSchema, IMAGE_FORMATS, ImageFormat, Interval, IntervalSchema, LayoutFont, LayoutFontSchema, LayoutFrame, LayoutFrameSchema, LayoutMetadata, LayoutMetadataSchema, LayoutSchemaDemotedError, LinkDescriptor, LinkDescriptorSchema, LinkTarget, LinkTargetSchema, ListChild, ListGroupNode, ListGroupSchema, ListParagraph, ListParagraphSchema, MAX_SAFE_INTEGER, Margins, MarginsSchema, MathApp, MathAppSchema, MathAssembledGlyphs, MathBox, MathColor, MathExpression, MathExpressionSchema, MathFontMetrics, MathGlyphMetrics, MathGlyphPlacement, MathGlyphRun, MathLayoutItem, MathMatrix, MathMatrixSchema, MathMlAttribute, MathMlAttributeSchema, MathMlCdata, MathMlCdataSchema, MathMlComment, MathMlCommentSchema, MathMlDeclaration, MathMlDeclarationSchema, MathMlElement, MathMlElementSchema, MathMlNode, MathMlNodeSchema, MathMlPi, MathMlPiSchema, MathMlText, MathMlTextSchema, MathNormalisationContext, MathNormalisationContextSchema, MathNum, MathNumSchema, MathPresentation, MathPresentationSchema, MathProd, MathProdSchema, MathProvenance, MathProvenanceSchema, MathQty, MathQtySchema, MathRule, MathStretchAxis, MathStretchGlyph, MathStretchResult, MathStroke, MathSum, MathSumSchema, MathSym, MathSymSchema, MathSymbolEntry, MathSymbolEntrySchema, MathUncertainty, MathUncertaintySchema, MathUnit, MathUnitSchema, MathUnparsed, MathUnparsedSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSize, PageSizeSchema, Point, PositionedFormula, PositionedTableCell, PositionedTableRow, ProvenanceChange, ProvenanceChangeSchema, ProvenanceDescriptor, ProvenanceDescriptorSchema, ProvidedFont, Quantity, QuantitySchema, RUN_FONT_PROPERTY_SHAPE, RunConstructExtent, RunConstructExtentSchema, RunConstructFault, SCHEMA_FILE_NAMES, SI_BASE_DIMENSIONS, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, SchemaVersionMismatchError, SectionChild, SectionConstructGroupNode, SectionConstructGroupSchema, SectionDescriptor, SectionDescriptorSchema, SectionGroupNode, SectionGroupSchema, ShapeChild, ShapeConstructGroupNode, ShapeConstructGroupSchema, ShapeDescriptor, ShapeDescriptorSchema, ShapeGroupNode, ShapeGroupSchema, SheetChild, SheetDescriptor, SheetDescriptorSchema, SheetGroupNode, SheetGroupSchema, SheetRuleOperator, SheetRuleOperatorSchema, SiBaseDimension, SlideDescriptor, SlideDescriptorSchema, SlideGroupNode, SlideGroupSchema, SourceFormat, SourceFormatSchema, SourceResidue, SourceResidueSchema, StyleEntry, StyleEntrySchema, StyleParagraphProperties, StyleParagraphPropertiesSchema, StyleRunProperties, StyleRunPropertiesSchema, StyledFragment, StyledRun, StylesTable, StylesTableSchema, SymbolTable, SymbolTableSchema, TableGridAnchor, TableGridCovered, TableGridFault, TableGridPosition, TextDirection, TextDirectionSchema, TextMeasurer, TreeBlockLeaf, TreeBlockLeafSchema, type TreeChildren, TreeEmbeddedFont, TreeEmbeddedFontSchema, TreeGroup, TreeGroupSchema, TreeLeaf, TreeLeafSchema, TreeNode, TreeNodeSchema, UnderlineMetrics, UnrecognizedDocumentSchemaError, WrapOptions, WrappedLine, applyParagraphStyleProperties, applyRunStyleProperties, assembleTree, borderWeightForWidthPt, cellReference, clampHeadingLevel, colorToRgbHex, columnIndexToLetters, columnLettersToIndex, contentDocumentSharedFields, contentDocumentWithSchema, dashedBorderWeightForWidthPt, decompose, denseTableRows, describeTableGridFault, documentFromJson, documentSchemaKindOf, documentTreeWithSchema, factorStyles, findConstructMarkerImbalance, findRunConstructFault, findTableGridFault, flattenTree, isContentBlock, isContentConstructEnd, isContentConstructStart, isDrawPageGroupNode, isHeadingGroupNode, isListGroupNode, isMathExpression, isMathMlNode, isRunConstructExtent, isSectionConstructGroupNode, isSectionGroupNode, isShapeConstructGroupNode, isShapeGroupNode, isSheetGroupNode, isSlideGroupNode, isTreeBlockLeaf, isTreeGroup, isTreeLeaf, isTreeNode, overlayStyleEntries, parseCellReference, parseRangeReference, placeAnchorTableRows, rangeReference, resolveCellFillColor, resolveStyleChain, rgbHexToColor, schemaUriFor, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, unrecognizedFillKind, walkTableGrid };

package/dist/index.js

@@ -19,7 +19,7 @@ import { ConstructMarkerImbalanceError, decompose } from "./decompose.js";
 import { flattenTree } from "./flatten.js";
 import { assembleTree, factorStyles } from "./factor-styles.js";
 import "./font-port.js";
-import { denseTableRows, placeAnchorTableRows, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, walkTableGrid } from "./table-grid.js";
+import { denseTableRows, describeTableGridFault, findTableGridFault, placeAnchorTableRows, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, walkTableGrid } from "./table-grid.js";
 import "./text-layout.js";
 import "./math-layout.js";
-export { AlignmentSchema, AnchorDescriptorSchema, AnchorTypeSchema, BORDER_WIDTH_PT, BoxSchema, COLOR_BLACK, CONTENT_ANNOTATION_FIELDS, CONTENT_DEFS, CONTENT_DOCUMENT_URI, ColorSchema, ConstructDescriptorSchema, ConstructMarkerImbalanceError, ContentBitmapFillSchema, ContentBlockSchema, ContentBorderSchema, ContentCellBordersSchema, ContentCellFillSchema, ContentCellPatternTypeSchema, ContentCellValueSchema, ContentConstructEndSchema, ContentConstructStartSchema, ContentControlDescriptorSchema, ContentControlLockSchema, ContentControlTypeSchema, ContentDefinedNameSchema, ContentDocumentSchema, ContentDrawPageSchema, ContentEmbeddedObjectBlockSchema, ContentEmbeddedObjectSchema, ContentFillPatternSchema, ContentFloatAlignSchema, ContentFloatAxisSchema, ContentFloatOriginSchema, ContentFloatPositionSchema, ContentFontSchema, ContentFormulaSchema, ContentGradientFillSchema, ContentGradientStyleSchema, ContentHatchFillSchema, ContentHatchStyleSchema, ContentImageBlockSchema, ContentImageOriginalSchema, ContentInterpretationSchema, ContentListMembershipSchema, ContentOriginSchema, ContentPageBreakSchema, ContentPageFurnitureSchema, ContentParagraphBordersSchema, ContentParagraphSchema, ContentPathPointSchema, ContentPathSegmentSchema, ContentRunSchema, ContentSectionSchema, ContentShapeSchema, ContentSheetCellCommentSchema, ContentSheetCellSchema, ContentSheetColumnSchema, ContentSheetConditionalFormatSchema, ContentSheetConditionalFormatStyleSchema, ContentSheetConditionalFormatValueSchema, ContentSheetDataValidationSchema, ContentSheetDataValidationTypeSchema, ContentSheetImageSchema, ContentSheetPrintRangeSchema, ContentSheetPrintSettingsSchema, ContentSheetRangeSchema, ContentSheetRepeatRangeSchema, ContentSheetRowSchema, ContentSheetSchema, ContentSlideSchema, ContentStrokeDashSchema, ContentStrokeSchema, ContentStrokeStyleSchema, ContentSubpathSchema, ContentTableCellSchema, ContentTableRowSchema, ContentTableSchema, ContentTranscriptSchema, ContentVectorSchema, DEFAULT_LAYOUT_FONT, DecimalStringSchema, DefinitionEntrySchema, DefinitionsTableSchema, DimensionVectorSchema, DivisionDescriptorSchema, DivisionSourceSchema, DocumentPackageRenamedError, DocumentTreeSchema, DrawPageDescriptorSchema, DrawPageGroupSchema, EMBEDDED_OBJECT_KINDS, EvaluationValueSchema, ExactRationalSchema, FieldDescriptorSchema, FormulaBindingsSchema, HeadingGroupSchema, HeadingParagraphSchema, IMAGE_FORMATS, IntervalSchema, LayoutFontSchema, LayoutFrameSchema, LayoutMetadataSchema, LayoutSchemaDemotedError, LinkDescriptorSchema, LinkTargetSchema, ListGroupSchema, ListParagraphSchema, MAX_SAFE_INTEGER, MarginsSchema, MathAppSchema, MathExpressionSchema, MathMatrixSchema, MathMlAttributeSchema, MathMlCdataSchema, MathMlCommentSchema, MathMlDeclarationSchema, MathMlElementSchema, MathMlNodeSchema, MathMlPiSchema, MathMlTextSchema, MathNormalisationContextSchema, MathNumSchema, MathPresentationSchema, MathProdSchema, MathProvenanceSchema, MathQtySchema, MathSumSchema, MathSymSchema, MathSymbolEntrySchema, MathUncertaintySchema, MathUnitSchema, MathUnparsedSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSizeSchema, ProvenanceChangeSchema, ProvenanceDescriptorSchema, QuantitySchema, RUN_FONT_PROPERTY_SHAPE, RunConstructExtentSchema, SCHEMA_FILE_NAMES, SI_BASE_DIMENSIONS, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, SchemaVersionMismatchError, SectionConstructGroupSchema, SectionDescriptorSchema, SectionGroupSchema, ShapeConstructGroupSchema, ShapeDescriptorSchema, ShapeGroupSchema, SheetDescriptorSchema, SheetGroupSchema, SheetRuleOperatorSchema, SlideDescriptorSchema, SlideGroupSchema, SourceFormatSchema, SourceResidueSchema, StyleEntrySchema, StyleParagraphPropertiesSchema, StyleRunPropertiesSchema, StylesTableSchema, SymbolTableSchema, TextDirectionSchema, TreeBlockLeafSchema, TreeEmbeddedFontSchema, TreeGroupSchema, TreeLeafSchema, TreeNodeSchema, UnrecognizedDocumentSchemaError, applyParagraphStyleProperties, applyRunStyleProperties, assembleTree, borderWeightForWidthPt, cellReference, clampHeadingLevel, colorToRgbHex, columnIndexToLetters, columnLettersToIndex, contentDocumentSharedFields, contentDocumentWithSchema, dashedBorderWeightForWidthPt, decompose, denseTableRows, documentFromJson, documentSchemaKindOf, documentTreeWithSchema, factorStyles, findConstructMarkerImbalance, findRunConstructFault, flattenTree, isContentBlock, isContentConstructEnd, isContentConstructStart, isDrawPageGroupNode, isHeadingGroupNode, isListGroupNode, isMathExpression, isMathMlNode, isRunConstructExtent, isSectionConstructGroupNode, isSectionGroupNode, isShapeConstructGroupNode, isShapeGroupNode, isSheetGroupNode, isSlideGroupNode, isTreeBlockLeaf, isTreeGroup, isTreeLeaf, isTreeNode, overlayStyleEntries, parseCellReference, parseRangeReference, placeAnchorTableRows, rangeReference, resolveCellFillColor, resolveStyleChain, rgbHexToColor, schemaUriFor, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, unrecognizedFillKind, walkTableGrid };
+export { AlignmentSchema, AnchorDescriptorSchema, AnchorTypeSchema, BORDER_WIDTH_PT, BoxSchema, COLOR_BLACK, CONTENT_ANNOTATION_FIELDS, CONTENT_DEFS, CONTENT_DOCUMENT_URI, ColorSchema, ConstructDescriptorSchema, ConstructMarkerImbalanceError, ContentBitmapFillSchema, ContentBlockSchema, ContentBorderSchema, ContentCellBordersSchema, ContentCellFillSchema, ContentCellPatternTypeSchema, ContentCellValueSchema, ContentConstructEndSchema, ContentConstructStartSchema, ContentControlDescriptorSchema, ContentControlLockSchema, ContentControlTypeSchema, ContentDefinedNameSchema, ContentDocumentSchema, ContentDrawPageSchema, ContentEmbeddedObjectBlockSchema, ContentEmbeddedObjectSchema, ContentFillPatternSchema, ContentFloatAlignSchema, ContentFloatAxisSchema, ContentFloatOriginSchema, ContentFloatPositionSchema, ContentFontSchema, ContentFormulaSchema, ContentGradientFillSchema, ContentGradientStyleSchema, ContentHatchFillSchema, ContentHatchStyleSchema, ContentImageBlockSchema, ContentImageOriginalSchema, ContentInterpretationSchema, ContentListMembershipSchema, ContentOriginSchema, ContentPageBreakSchema, ContentPageFurnitureSchema, ContentParagraphBordersSchema, ContentParagraphSchema, ContentPathPointSchema, ContentPathSegmentSchema, ContentRunSchema, ContentSectionSchema, ContentShapeSchema, ContentSheetCellCommentSchema, ContentSheetCellSchema, ContentSheetColumnSchema, ContentSheetConditionalFormatSchema, ContentSheetConditionalFormatStyleSchema, ContentSheetConditionalFormatValueSchema, ContentSheetDataValidationSchema, ContentSheetDataValidationTypeSchema, ContentSheetImageSchema, ContentSheetPrintRangeSchema, ContentSheetPrintSettingsSchema, ContentSheetRangeSchema, ContentSheetRepeatRangeSchema, ContentSheetRowSchema, ContentSheetSchema, ContentSlideSchema, ContentStrokeDashSchema, ContentStrokeSchema, ContentStrokeStyleSchema, ContentSubpathSchema, ContentTableCellSchema, ContentTableRowSchema, ContentTableSchema, ContentTranscriptSchema, ContentVectorSchema, DEFAULT_LAYOUT_FONT, DecimalStringSchema, DefinitionEntrySchema, DefinitionsTableSchema, DimensionVectorSchema, DivisionDescriptorSchema, DivisionSourceSchema, DocumentPackageRenamedError, DocumentTreeSchema, DrawPageDescriptorSchema, DrawPageGroupSchema, EMBEDDED_OBJECT_KINDS, EvaluationValueSchema, ExactRationalSchema, FieldDescriptorSchema, FormulaBindingsSchema, HeadingGroupSchema, HeadingParagraphSchema, IMAGE_FORMATS, IntervalSchema, LayoutFontSchema, LayoutFrameSchema, LayoutMetadataSchema, LayoutSchemaDemotedError, LinkDescriptorSchema, LinkTargetSchema, ListGroupSchema, ListParagraphSchema, MAX_SAFE_INTEGER, MarginsSchema, MathAppSchema, MathExpressionSchema, MathMatrixSchema, MathMlAttributeSchema, MathMlCdataSchema, MathMlCommentSchema, MathMlDeclarationSchema, MathMlElementSchema, MathMlNodeSchema, MathMlPiSchema, MathMlTextSchema, MathNormalisationContextSchema, MathNumSchema, MathPresentationSchema, MathProdSchema, MathProvenanceSchema, MathQtySchema, MathSumSchema, MathSymSchema, MathSymbolEntrySchema, MathUncertaintySchema, MathUnitSchema, MathUnparsedSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSizeSchema, ProvenanceChangeSchema, ProvenanceDescriptorSchema, QuantitySchema, RUN_FONT_PROPERTY_SHAPE, RunConstructExtentSchema, SCHEMA_FILE_NAMES, SI_BASE_DIMENSIONS, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, SchemaVersionMismatchError, SectionConstructGroupSchema, SectionDescriptorSchema, SectionGroupSchema, ShapeConstructGroupSchema, ShapeDescriptorSchema, ShapeGroupSchema, SheetDescriptorSchema, SheetGroupSchema, SheetRuleOperatorSchema, SlideDescriptorSchema, SlideGroupSchema, SourceFormatSchema, SourceResidueSchema, StyleEntrySchema, StyleParagraphPropertiesSchema, StyleRunPropertiesSchema, StylesTableSchema, SymbolTableSchema, TextDirectionSchema, TreeBlockLeafSchema, TreeEmbeddedFontSchema, TreeGroupSchema, TreeLeafSchema, TreeNodeSchema, UnrecognizedDocumentSchemaError, applyParagraphStyleProperties, applyRunStyleProperties, assembleTree, borderWeightForWidthPt, cellReference, clampHeadingLevel, colorToRgbHex, columnIndexToLetters, columnLettersToIndex, contentDocumentSharedFields, contentDocumentWithSchema, dashedBorderWeightForWidthPt, decompose, denseTableRows, describeTableGridFault, documentFromJson, documentSchemaKindOf, documentTreeWithSchema, factorStyles, findConstructMarkerImbalance, findRunConstructFault, findTableGridFault, flattenTree, isContentBlock, isContentConstructEnd, isContentConstructStart, isDrawPageGroupNode, isHeadingGroupNode, isListGroupNode, isMathExpression, isMathMlNode, isRunConstructExtent, isSectionConstructGroupNode, isSectionGroupNode, isShapeConstructGroupNode, isShapeGroupNode, isSheetGroupNode, isSlideGroupNode, isTreeBlockLeaf, isTreeGroup, isTreeLeaf, isTreeNode, overlayStyleEntries, parseCellReference, parseRangeReference, placeAnchorTableRows, rangeReference, resolveCellFillColor, resolveStyleChain, rgbHexToColor, schemaUriFor, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, unrecognizedFillKind, walkTableGrid };

package/dist/schema-io.cjs

@@ -7,7 +7,7 @@ const SCHEMA_FILE_NAMES = {
 	ContentDocument: "content-document.schema.json"
 };
 function schemaUriFor(kind) {
-	return `https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/${SCHEMA_FILE_NAMES[kind]}`;
+	return `https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/${SCHEMA_FILE_NAMES[kind]}`;
 }
 const SCHEMA_URI_PATTERN = /^https:\/\/cdn\.jsdelivr\.net\/npm\/document-schema\.js@([^/]+)\/schemas\/(document-tree|document-package|content-document|layout-document)\.schema\.json$/;
 function parseSchemaUri(uri) {
@@ -102,7 +102,7 @@ function documentFromJson(value) {
 	if (parts.stem === "document-package") throw new DocumentPackageRenamedError(value.$schema);
 	const kind = kindForFileStem(parts.stem);
 	if (kind === void 0) throw new UnrecognizedDocumentSchemaError(value.$schema);
-	if (majorVersionOf(parts.version) !== majorVersionOf("7.12.0")) throw new SchemaVersionMismatchError(value.$schema, parts.version, "7.12.0");
+	if (majorVersionOf(parts.version) !== majorVersionOf("7.13.0")) throw new SchemaVersionMismatchError(value.$schema, parts.version, "7.13.0");
 	switch (kind) {
 		case "DocumentTree": return {
 			kind,

package/dist/schema-io.js

@@ -6,7 +6,7 @@ const SCHEMA_FILE_NAMES = {
 	ContentDocument: "content-document.schema.json"
 };
 function schemaUriFor(kind) {
-	return `https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/${SCHEMA_FILE_NAMES[kind]}`;
+	return `https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/${SCHEMA_FILE_NAMES[kind]}`;
 }
 const SCHEMA_URI_PATTERN = /^https:\/\/cdn\.jsdelivr\.net\/npm\/document-schema\.js@([^/]+)\/schemas\/(document-tree|document-package|content-document|layout-document)\.schema\.json$/;
 function parseSchemaUri(uri) {
@@ -101,7 +101,7 @@ function documentFromJson(value) {
 	if (parts.stem === "document-package") throw new DocumentPackageRenamedError(value.$schema);
 	const kind = kindForFileStem(parts.stem);
 	if (kind === void 0) throw new UnrecognizedDocumentSchemaError(value.$schema);
-	if (majorVersionOf(parts.version) !== majorVersionOf("7.12.0")) throw new SchemaVersionMismatchError(value.$schema, parts.version, "7.12.0");
+	if (majorVersionOf(parts.version) !== majorVersionOf("7.13.0")) throw new SchemaVersionMismatchError(value.$schema, parts.version, "7.13.0");
 	switch (kind) {
 		case "DocumentTree": return {
 			kind,

package/dist/table-grid.cjs

@@ -48,6 +48,89 @@ function walkTableGrid(table) {
 		};
 	}));
 }
+/** The span of a cell that occupies its own grid position only, which is what an absent `colSpan` or `rowSpan` means. */
+const UNMERGED_SPAN = 1;
+function widestRowLength(table) {
+	let width = 0;
+	for (const row of table.rows) width = Math.max(width, row.cells.length);
+	return width;
+}
+function coveredFault(position) {
+	const { rowIndex, columnIndex, anchorRowIndex, anchorColumnIndex, cell } = position;
+	if (cell.blocks.length > 0) return {
+		kind: "coveredContent",
+		rowIndex,
+		columnIndex,
+		anchorRowIndex,
+		anchorColumnIndex
+	};
+	if (tableCellColumnSpan(cell) > UNMERGED_SPAN || tableCellRowSpan(cell) > UNMERGED_SPAN) return {
+		kind: "coveredSpan",
+		rowIndex,
+		columnIndex,
+		anchorRowIndex,
+		anchorColumnIndex
+	};
+}
+function overlappedRegion(anchor, row) {
+	const footprintEnd = anchor.columnIndex + tableCellColumnSpan(anchor.cell);
+	for (const position of row.slice(anchor.columnIndex + 1, footprintEnd)) if (position.anchorRowIndex !== void 0 && position.anchorRowIndex < anchor.rowIndex) return position;
+}
+function anchorFault(anchor, row, rowCount) {
+	const { rowIndex, columnIndex, cell } = anchor;
+	if (columnIndex + tableCellColumnSpan(cell) > row.length) return {
+		kind: "anchorOverrunsColumns",
+		rowIndex,
+		columnIndex
+	};
+	if (rowIndex + tableCellRowSpan(cell) > rowCount) return {
+		kind: "anchorOverrunsRows",
+		rowIndex,
+		columnIndex
+	};
+	const overlapped = overlappedRegion(anchor, row);
+	if (overlapped !== void 0) return {
+		kind: "overlappingAnchors",
+		rowIndex,
+		columnIndex,
+		earlierAnchorRowIndex: overlapped.anchorRowIndex,
+		earlierAnchorColumnIndex: overlapped.anchorColumnIndex
+	};
+}
+/**
+* The first place `table` contradicts the grid rule, or `undefined` when it obeys it. It never throws: a caller decides what a fault means for it, the way findConstructMarkerImbalance leaves that decision to each consumer of a block list.
+*
+* Rows are compared with each other before any position is classified, since an anchor's footprint can only be measured against a grid every row shares; the positions are then checked in row-major order, so the fault returned is the earliest one in reading order.
+*
+* The check states the whole of the rule and nothing beyond it: a table with no rows, or whose rows are all empty, has no fault, and neither `columnWidthsPt` nor a cell's own properties other than its blocks and spans are consulted.
+*/
+function findTableGridFault(table) {
+	const gridColumnCount = widestRowLength(table);
+	for (const [rowIndex, row] of table.rows.entries()) if (row.cells.length !== gridColumnCount) return {
+		kind: "raggedRow",
+		rowIndex,
+		cellCount: row.cells.length,
+		gridColumnCount
+	};
+	const grid = walkTableGrid(table);
+	for (const row of grid) for (const position of row) {
+		const fault = position.anchorRowIndex === void 0 ? anchorFault(position, row, grid.length) : coveredFault(position);
+		if (fault !== void 0) return fault;
+	}
+}
+/**
+* One sentence stating a fault in words, for a writer that refuses or reports a table the grid rule does not admit: it names the fault by its position and, where the fault involves a second region, by that region's anchor. Indices are 0-based, matching every index in the descriptor. The sentence carries no entry point or format of its own, so each caller prefixes whatever names its own operation.
+*/
+function describeTableGridFault(fault) {
+	switch (fault.kind) {
+		case "raggedRow": return `row ${String(fault.rowIndex)} holds ${String(fault.cellCount)} cells where the widest row holds ${String(fault.gridColumnCount)}, but every row of a table covers the same grid`;
+		case "coveredContent": return `the cell at row ${String(fault.rowIndex)}, column ${String(fault.columnIndex)} lies inside the merged region anchored at row ${String(fault.anchorRowIndex)}, column ${String(fault.anchorColumnIndex)} but carries content of its own, and a merged region's content belongs to its anchor`;
+		case "coveredSpan": return `the cell at row ${String(fault.rowIndex)}, column ${String(fault.columnIndex)} lies inside the merged region anchored at row ${String(fault.anchorRowIndex)}, column ${String(fault.anchorColumnIndex)} but states a span of its own, and only a region's anchor carries a span`;
+		case "anchorOverrunsColumns": return `the merged region anchored at row ${String(fault.rowIndex)}, column ${String(fault.columnIndex)} spans past the last column of the grid`;
+		case "anchorOverrunsRows": return `the merged region anchored at row ${String(fault.rowIndex)}, column ${String(fault.columnIndex)} spans past the last row of the table`;
+		case "overlappingAnchors": return `the merged region anchored at row ${String(fault.rowIndex)}, column ${String(fault.columnIndex)} overlaps the region anchored at row ${String(fault.earlierAnchorRowIndex)}, column ${String(fault.earlierAnchorColumnIndex)}, but a grid position belongs to one region only`;
+	}
+}
 function placedGridWidth(rows, columnCount) {
 	let width = columnCount;
 	for (const row of rows) for (const { columnIndex, cell } of row.cells) width = Math.max(width, columnIndex + tableCellColumnSpan(cell));
@@ -112,6 +195,8 @@ function placeAnchorTableRows(rows, columnCount) {
 }
 //#endregion
 exports.denseTableRows = denseTableRows;
+exports.describeTableGridFault = describeTableGridFault;
+exports.findTableGridFault = findTableGridFault;
 exports.placeAnchorTableRows = placeAnchorTableRows;
 exports.tableCellColumnSpan = tableCellColumnSpan;
 exports.tableCellRowSpan = tableCellRowSpan;

package/dist/table-grid.d.cts

@@ -33,6 +33,52 @@ type TableGridPosition = TableGridAnchor | TableGridCovered;
  * This is the walk a consumer runs instead of accumulating spans itself. A writer targeting a format that stores only anchors (HTML's `<td colspan>`, a docx `w:tc` with `w:gridSpan`) keeps the anchors and drops the covered positions; a writer targeting a format that stores covered positions explicitly (ODF, pptx) writes both; a reader checks its own output against it.
  */
 declare function walkTableGrid(table: ContentTable): TableGridPosition[][];
+/**
+ * Where a table stops obeying the grid rule (ContentTableCell in src/content.ts states the rule; walkTableGrid derives the classification every check here is made against). Every variant names a position in the table's own row and column indices.
+ *
+ * - `raggedRow`: the row holds `cellCount` entries where the table's widest row holds `gridColumnCount`, so the rows do not all cover the same grid.
+ * - `coveredContent`: the position is covered by the region anchored at `anchorRowIndex`, `anchorColumnIndex` yet carries blocks of its own; the region's content belongs to its anchor, so a second copy has nowhere to go.
+ * - `coveredSpan`: the position is covered by the region anchored at `anchorRowIndex`, `anchorColumnIndex` yet carries a `colSpan` or `rowSpan` of its own. Spans are set on the anchor only and walkTableGrid never consults a covered entry's, so this is how a second anchor starting inside another's footprint shows up: the walk assigns each position to the first anchor covering it, which leaves the second entry classified as covered and its span ignored.
+ * - `anchorOverrunsColumns`: the anchor at this position has a `colSpan` reaching past the last grid column.
+ * - `anchorOverrunsRows`: the anchor at this position has a `rowSpan` reaching past the last row of the table.
+ * - `overlappingAnchors`: the anchor at this position starts outside every other region but its footprint reaches a position already covered by the region anchored at `earlierAnchorRowIndex`, `earlierAnchorColumnIndex`, so two regions claim one position.
+ *
+ * A `kind` tag discriminates rather than property presence, because the variants' required fields are not mutually exclusive: several variants' fields include another's.
+ */
+type TableGridFault = {
+  readonly kind: "raggedRow";
+  readonly rowIndex: number;
+  readonly cellCount: number;
+  readonly gridColumnCount: number;
+} | {
+  readonly kind: "coveredContent" | "coveredSpan";
+  readonly rowIndex: number;
+  readonly columnIndex: number;
+  readonly anchorRowIndex: number;
+  readonly anchorColumnIndex: number;
+} | {
+  readonly kind: "anchorOverrunsColumns" | "anchorOverrunsRows";
+  readonly rowIndex: number;
+  readonly columnIndex: number;
+} | {
+  readonly kind: "overlappingAnchors";
+  readonly rowIndex: number;
+  readonly columnIndex: number;
+  readonly earlierAnchorRowIndex: number;
+  readonly earlierAnchorColumnIndex: number;
+};
+/**
+ * The first place `table` contradicts the grid rule, or `undefined` when it obeys it. It never throws: a caller decides what a fault means for it, the way findConstructMarkerImbalance leaves that decision to each consumer of a block list.
+ *
+ * Rows are compared with each other before any position is classified, since an anchor's footprint can only be measured against a grid every row shares; the positions are then checked in row-major order, so the fault returned is the earliest one in reading order.
+ *
+ * The check states the whole of the rule and nothing beyond it: a table with no rows, or whose rows are all empty, has no fault, and neither `columnWidthsPt` nor a cell's own properties other than its blocks and spans are consulted.
+ */
+declare function findTableGridFault(table: ContentTable): TableGridFault | undefined;
+/**
+ * One sentence stating a fault in words, for a writer that refuses or reports a table the grid rule does not admit: it names the fault by its position and, where the fault involves a second region, by that region's anchor. Indices are 0-based, matching every index in the descriptor. The sentence carries no entry point or format of its own, so each caller prefixes whatever names its own operation.
+ */
+declare function describeTableGridFault(fault: TableGridFault): string;
 /** A cell together with the grid column it starts at, for a reader whose source format states that column directly. */
 interface PositionedTableCell {
   readonly columnIndex: number;
@@ -63,4 +109,4 @@ interface AnchorTableRow {
  */
 declare function placeAnchorTableRows(rows: readonly AnchorTableRow[], columnCount: number): ContentTableRow[];
 //#endregion
-export { AnchorTableRow, PositionedTableCell, PositionedTableRow, TableGridAnchor, TableGridCovered, TableGridPosition, denseTableRows, placeAnchorTableRows, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, walkTableGrid };
+export { AnchorTableRow, PositionedTableCell, PositionedTableRow, TableGridAnchor, TableGridCovered, TableGridFault, TableGridPosition, denseTableRows, describeTableGridFault, findTableGridFault, placeAnchorTableRows, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, walkTableGrid };

package/dist/table-grid.d.ts

@@ -33,6 +33,52 @@ type TableGridPosition = TableGridAnchor | TableGridCovered;
  * This is the walk a consumer runs instead of accumulating spans itself. A writer targeting a format that stores only anchors (HTML's `<td colspan>`, a docx `w:tc` with `w:gridSpan`) keeps the anchors and drops the covered positions; a writer targeting a format that stores covered positions explicitly (ODF, pptx) writes both; a reader checks its own output against it.
  */
 declare function walkTableGrid(table: ContentTable): TableGridPosition[][];
+/**
+ * Where a table stops obeying the grid rule (ContentTableCell in src/content.ts states the rule; walkTableGrid derives the classification every check here is made against). Every variant names a position in the table's own row and column indices.
+ *
+ * - `raggedRow`: the row holds `cellCount` entries where the table's widest row holds `gridColumnCount`, so the rows do not all cover the same grid.
+ * - `coveredContent`: the position is covered by the region anchored at `anchorRowIndex`, `anchorColumnIndex` yet carries blocks of its own; the region's content belongs to its anchor, so a second copy has nowhere to go.
+ * - `coveredSpan`: the position is covered by the region anchored at `anchorRowIndex`, `anchorColumnIndex` yet carries a `colSpan` or `rowSpan` of its own. Spans are set on the anchor only and walkTableGrid never consults a covered entry's, so this is how a second anchor starting inside another's footprint shows up: the walk assigns each position to the first anchor covering it, which leaves the second entry classified as covered and its span ignored.
+ * - `anchorOverrunsColumns`: the anchor at this position has a `colSpan` reaching past the last grid column.
+ * - `anchorOverrunsRows`: the anchor at this position has a `rowSpan` reaching past the last row of the table.
+ * - `overlappingAnchors`: the anchor at this position starts outside every other region but its footprint reaches a position already covered by the region anchored at `earlierAnchorRowIndex`, `earlierAnchorColumnIndex`, so two regions claim one position.
+ *
+ * A `kind` tag discriminates rather than property presence, because the variants' required fields are not mutually exclusive: several variants' fields include another's.
+ */
+type TableGridFault = {
+  readonly kind: "raggedRow";
+  readonly rowIndex: number;
+  readonly cellCount: number;
+  readonly gridColumnCount: number;
+} | {
+  readonly kind: "coveredContent" | "coveredSpan";
+  readonly rowIndex: number;
+  readonly columnIndex: number;
+  readonly anchorRowIndex: number;
+  readonly anchorColumnIndex: number;
+} | {
+  readonly kind: "anchorOverrunsColumns" | "anchorOverrunsRows";
+  readonly rowIndex: number;
+  readonly columnIndex: number;
+} | {
+  readonly kind: "overlappingAnchors";
+  readonly rowIndex: number;
+  readonly columnIndex: number;
+  readonly earlierAnchorRowIndex: number;
+  readonly earlierAnchorColumnIndex: number;
+};
+/**
+ * The first place `table` contradicts the grid rule, or `undefined` when it obeys it. It never throws: a caller decides what a fault means for it, the way findConstructMarkerImbalance leaves that decision to each consumer of a block list.
+ *
+ * Rows are compared with each other before any position is classified, since an anchor's footprint can only be measured against a grid every row shares; the positions are then checked in row-major order, so the fault returned is the earliest one in reading order.
+ *
+ * The check states the whole of the rule and nothing beyond it: a table with no rows, or whose rows are all empty, has no fault, and neither `columnWidthsPt` nor a cell's own properties other than its blocks and spans are consulted.
+ */
+declare function findTableGridFault(table: ContentTable): TableGridFault | undefined;
+/**
+ * One sentence stating a fault in words, for a writer that refuses or reports a table the grid rule does not admit: it names the fault by its position and, where the fault involves a second region, by that region's anchor. Indices are 0-based, matching every index in the descriptor. The sentence carries no entry point or format of its own, so each caller prefixes whatever names its own operation.
+ */
+declare function describeTableGridFault(fault: TableGridFault): string;
 /** A cell together with the grid column it starts at, for a reader whose source format states that column directly. */
 interface PositionedTableCell {
   readonly columnIndex: number;
@@ -63,4 +109,4 @@ interface AnchorTableRow {
  */
 declare function placeAnchorTableRows(rows: readonly AnchorTableRow[], columnCount: number): ContentTableRow[];
 //#endregion
-export { AnchorTableRow, PositionedTableCell, PositionedTableRow, TableGridAnchor, TableGridCovered, TableGridPosition, denseTableRows, placeAnchorTableRows, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, walkTableGrid };
+export { AnchorTableRow, PositionedTableCell, PositionedTableRow, TableGridAnchor, TableGridCovered, TableGridFault, TableGridPosition, denseTableRows, describeTableGridFault, findTableGridFault, placeAnchorTableRows, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, walkTableGrid };

package/dist/table-grid.js

@@ -47,6 +47,89 @@ function walkTableGrid(table) {
 		};
 	}));
 }
+/** The span of a cell that occupies its own grid position only, which is what an absent `colSpan` or `rowSpan` means. */
+const UNMERGED_SPAN = 1;
+function widestRowLength(table) {
+	let width = 0;
+	for (const row of table.rows) width = Math.max(width, row.cells.length);
+	return width;
+}
+function coveredFault(position) {
+	const { rowIndex, columnIndex, anchorRowIndex, anchorColumnIndex, cell } = position;
+	if (cell.blocks.length > 0) return {
+		kind: "coveredContent",
+		rowIndex,
+		columnIndex,
+		anchorRowIndex,
+		anchorColumnIndex
+	};
+	if (tableCellColumnSpan(cell) > UNMERGED_SPAN || tableCellRowSpan(cell) > UNMERGED_SPAN) return {
+		kind: "coveredSpan",
+		rowIndex,
+		columnIndex,
+		anchorRowIndex,
+		anchorColumnIndex
+	};
+}
+function overlappedRegion(anchor, row) {
+	const footprintEnd = anchor.columnIndex + tableCellColumnSpan(anchor.cell);
+	for (const position of row.slice(anchor.columnIndex + 1, footprintEnd)) if (position.anchorRowIndex !== void 0 && position.anchorRowIndex < anchor.rowIndex) return position;
+}
+function anchorFault(anchor, row, rowCount) {
+	const { rowIndex, columnIndex, cell } = anchor;
+	if (columnIndex + tableCellColumnSpan(cell) > row.length) return {
+		kind: "anchorOverrunsColumns",
+		rowIndex,
+		columnIndex
+	};
+	if (rowIndex + tableCellRowSpan(cell) > rowCount) return {
+		kind: "anchorOverrunsRows",
+		rowIndex,
+		columnIndex
+	};
+	const overlapped = overlappedRegion(anchor, row);
+	if (overlapped !== void 0) return {
+		kind: "overlappingAnchors",
+		rowIndex,
+		columnIndex,
+		earlierAnchorRowIndex: overlapped.anchorRowIndex,
+		earlierAnchorColumnIndex: overlapped.anchorColumnIndex
+	};
+}
+/**
+* The first place `table` contradicts the grid rule, or `undefined` when it obeys it. It never throws: a caller decides what a fault means for it, the way findConstructMarkerImbalance leaves that decision to each consumer of a block list.
+*
+* Rows are compared with each other before any position is classified, since an anchor's footprint can only be measured against a grid every row shares; the positions are then checked in row-major order, so the fault returned is the earliest one in reading order.
+*
+* The check states the whole of the rule and nothing beyond it: a table with no rows, or whose rows are all empty, has no fault, and neither `columnWidthsPt` nor a cell's own properties other than its blocks and spans are consulted.
+*/
+function findTableGridFault(table) {
+	const gridColumnCount = widestRowLength(table);
+	for (const [rowIndex, row] of table.rows.entries()) if (row.cells.length !== gridColumnCount) return {
+		kind: "raggedRow",
+		rowIndex,
+		cellCount: row.cells.length,
+		gridColumnCount
+	};
+	const grid = walkTableGrid(table);
+	for (const row of grid) for (const position of row) {
+		const fault = position.anchorRowIndex === void 0 ? anchorFault(position, row, grid.length) : coveredFault(position);
+		if (fault !== void 0) return fault;
+	}
+}
+/**
+* One sentence stating a fault in words, for a writer that refuses or reports a table the grid rule does not admit: it names the fault by its position and, where the fault involves a second region, by that region's anchor. Indices are 0-based, matching every index in the descriptor. The sentence carries no entry point or format of its own, so each caller prefixes whatever names its own operation.
+*/
+function describeTableGridFault(fault) {
+	switch (fault.kind) {
+		case "raggedRow": return `row ${String(fault.rowIndex)} holds ${String(fault.cellCount)} cells where the widest row holds ${String(fault.gridColumnCount)}, but every row of a table covers the same grid`;
+		case "coveredContent": return `the cell at row ${String(fault.rowIndex)}, column ${String(fault.columnIndex)} lies inside the merged region anchored at row ${String(fault.anchorRowIndex)}, column ${String(fault.anchorColumnIndex)} but carries content of its own, and a merged region's content belongs to its anchor`;
+		case "coveredSpan": return `the cell at row ${String(fault.rowIndex)}, column ${String(fault.columnIndex)} lies inside the merged region anchored at row ${String(fault.anchorRowIndex)}, column ${String(fault.anchorColumnIndex)} but states a span of its own, and only a region's anchor carries a span`;
+		case "anchorOverrunsColumns": return `the merged region anchored at row ${String(fault.rowIndex)}, column ${String(fault.columnIndex)} spans past the last column of the grid`;
+		case "anchorOverrunsRows": return `the merged region anchored at row ${String(fault.rowIndex)}, column ${String(fault.columnIndex)} spans past the last row of the table`;
+		case "overlappingAnchors": return `the merged region anchored at row ${String(fault.rowIndex)}, column ${String(fault.columnIndex)} overlaps the region anchored at row ${String(fault.earlierAnchorRowIndex)}, column ${String(fault.earlierAnchorColumnIndex)}, but a grid position belongs to one region only`;
+	}
+}
 function placedGridWidth(rows, columnCount) {
 	let width = columnCount;
 	for (const row of rows) for (const { columnIndex, cell } of row.cells) width = Math.max(width, columnIndex + tableCellColumnSpan(cell));
@@ -110,4 +193,4 @@ function placeAnchorTableRows(rows, columnCount) {
 	return denseTableRows(positionAnchorRows(rows), columnCount);
 }
 //#endregion
-export { denseTableRows, placeAnchorTableRows, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, walkTableGrid };
+export { denseTableRows, describeTableGridFault, findTableGridFault, placeAnchorTableRows, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, walkTableGrid };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document-content-model",
-  "version": "7.12.0",
+  "version": "7.13.0",
   "description": "The canonical, format-agnostic content and document-tree schemas shared by ooxml.js, odf.js, documents.js, pdf-codec, and markdown-codec, plus the structural transform between them -- no format-specific or I/O behaviour.",
   "type": "module",
   "repository": {

package/schemas/content-document.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/content-document.schema.json",
+  "$id": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/content-document.schema.json",
   "oneOf": [
     {
       "type": "object",
@@ -133,7 +133,7 @@
               "blocks": {
                 "type": "array",
                 "items": {
-                  "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/undefined#/$defs/schema2"
+                  "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/undefined#/$defs/schema2"
                 }
               },
               "breakType": {
@@ -151,19 +151,19 @@
                   "default": {
                     "type": "array",
                     "items": {
-                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/undefined#/$defs/schema2"
+                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/undefined#/$defs/schema2"
                     }
                   },
                   "even": {
                     "type": "array",
                     "items": {
-                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/undefined#/$defs/schema2"
+                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/undefined#/$defs/schema2"
                     }
                   },
                   "first": {
                     "type": "array",
                     "items": {
-                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/undefined#/$defs/schema2"
+                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/undefined#/$defs/schema2"
                     }
                   }
                 },
@@ -175,19 +175,19 @@
                   "default": {
                     "type": "array",
                     "items": {
-                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/undefined#/$defs/schema2"
+                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/undefined#/$defs/schema2"
                     }
                   },
                   "even": {
                     "type": "array",
                     "items": {
-                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/undefined#/$defs/schema2"
+                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/undefined#/$defs/schema2"
                     }
                   },
                   "first": {
                     "type": "array",
                     "items": {
-                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/undefined#/$defs/schema2"
+                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/undefined#/$defs/schema2"
                     }
                   }
                 },
@@ -199,19 +199,19 @@
                   "default": {
                     "type": "array",
                     "items": {
-                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/undefined#/$defs/schema2"
+                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/undefined#/$defs/schema2"
                     }
                   },
                   "even": {
                     "type": "array",
                     "items": {
-                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/undefined#/$defs/schema2"
+                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/undefined#/$defs/schema2"
                     }
                   },
                   "first": {
                     "type": "array",
                     "items": {
-                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/undefined#/$defs/schema2"
+                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/undefined#/$defs/schema2"
                     }
                   }
                 },
@@ -638,7 +638,7 @@
                     "blocks": {
                       "type": "array",
                       "items": {
-                        "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/undefined#/$defs/schema2"
+                        "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/undefined#/$defs/schema2"
                       }
                     }
                   },
@@ -2659,7 +2659,7 @@
                       ]
                     },
                     "document": {
-                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/content-document.schema.json"
+                      "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/content-document.schema.json"
                     },
                     "frame": {
                       "type": "object",
@@ -5021,7 +5021,7 @@
                     "blocks": {
                       "type": "array",
                       "items": {
-                        "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/undefined#/$defs/schema2"
+                        "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/undefined#/$defs/schema2"
                       }
                     }
                   },
@@ -8027,7 +8027,7 @@
           ]
         },
         "document": {
-          "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/content-document.schema.json"
+          "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/content-document.schema.json"
         },
         "frame": {
           "$ref": "#/$defs/Box"
@@ -10353,7 +10353,7 @@
           ]
         },
         "document": {
-          "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/content-document.schema.json"
+          "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/content-document.schema.json"
         },
         "frame": {
           "$ref": "#/$defs/Box"

package/schemas/document-tree.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/document-tree.schema.json",
+  "$id": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/document-tree.schema.json",
   "oneOf": [
     {
       "type": "object",
@@ -1993,7 +1993,7 @@
           ]
         },
         "document": {
-          "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/content-document.schema.json"
+          "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/content-document.schema.json"
         },
         "frame": {
           "$ref": "#/$defs/Box"
@@ -4319,7 +4319,7 @@
           ]
         },
         "document": {
-          "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.12.0/schemas/content-document.schema.json"
+          "$ref": "https://cdn.jsdelivr.net/npm/document-schema.js@7.13.0/schemas/content-document.schema.json"
         },
         "frame": {
           "$ref": "#/$defs/Box"