@stll/folio-core 0.61.0 → 0.63.0

package/dist/docx/commentAnchorIndex.js

@@ -1,3 +1,4 @@
+import { cloneParagraphWithPropertySource } from "./paragraphPropertySource.js";
 import { visitInlineContentSlots } from "./paragraphTraversal.js";
 //#region src/docx/commentAnchorIndex.ts
 const visitCommentMarkers = (blocks, visit) => {
@@ -27,6 +28,240 @@ const visitCommentMarkers = (blocks, visit) => {
 	};
 	visitBlocks(blocks);
 };
+/** Remove every serialized anchor record for comments whose definitions are retired. */
+const removeCommentMarkers = (blocks, commentIds) => {
+	if (commentIds.size === 0) return blocks.slice();
+	const removals = /* @__PURE__ */ new Map();
+	visitCommentMarkers(blocks, ({ content, index, item }) => {
+		if (!commentIds.has(item.id)) return;
+		const indexes = removals.get(content) ?? [];
+		indexes.push(index);
+		removals.set(content, indexes);
+	});
+	if (removals.size === 0) return blocks.slice();
+	const rebuildArray = (content, rebuildItem) => {
+		const removed = removals.get(content);
+		let changed = removed !== void 0;
+		const result = [];
+		for (const [index, item] of content.entries()) {
+			if (removed?.includes(index) === true) continue;
+			const rebuilt = rebuildItem(item);
+			changed ||= rebuilt !== item;
+			result.push(rebuilt);
+		}
+		return changed ? result : content;
+	};
+	const rebuildHyperlink = (hyperlink) => {
+		const children = rebuildArray(hyperlink.children, rebuildHyperlinkContent);
+		return children === hyperlink.children ? hyperlink : {
+			...hyperlink,
+			children
+		};
+	};
+	const rebuildSimpleFieldContent = (item) => {
+		switch (item.type) {
+			case "hyperlink": return rebuildHyperlink(item);
+			case "insertion":
+			case "deletion":
+			case "moveFrom":
+			case "moveTo": return rebuildTrackedChange(item);
+			case "inlineWrapper": {
+				const content = rebuildParagraphContent(item.content);
+				return content === item.content ? item : {
+					...item,
+					content
+				};
+			}
+			case "run":
+			case "preservedInline": return item;
+		}
+	};
+	const rebuildSimpleField = (field) => {
+		const content = rebuildArray(field.content, rebuildSimpleFieldContent);
+		return content === field.content ? field : {
+			...field,
+			content
+		};
+	};
+	const rebuildInlineSdtContent = (item) => {
+		switch (item.type) {
+			case "hyperlink": return rebuildHyperlink(item);
+			case "simpleField": return rebuildSimpleField(item);
+			case "insertion":
+			case "deletion":
+			case "moveFrom":
+			case "moveTo": return rebuildTrackedChange(item);
+			case "inlineSdt": return rebuildInlineSdt(item);
+			case "inlineWrapper": {
+				const content = rebuildParagraphContent(item.content);
+				return content === item.content ? item : {
+					...item,
+					content
+				};
+			}
+			case "run":
+			case "complexField":
+			case "bookmarkStart":
+			case "bookmarkEnd":
+			case "commentRangeStart":
+			case "commentRangeEnd":
+			case "commentReference":
+			case "moveFromRangeStart":
+			case "moveFromRangeEnd":
+			case "moveToRangeStart":
+			case "moveToRangeEnd":
+			case "mathEquation":
+			case "preservedInline": return item;
+		}
+	};
+	const rebuildInlineSdt = (sdt) => {
+		const content = rebuildArray(sdt.content, rebuildInlineSdtContent);
+		return content === sdt.content ? sdt : {
+			...sdt,
+			content
+		};
+	};
+	const rebuildTrackedContent = (item) => {
+		switch (item.type) {
+			case "hyperlink": return rebuildHyperlink(item);
+			case "simpleField": return rebuildSimpleField(item);
+			case "insertion":
+			case "deletion":
+			case "moveFrom":
+			case "moveTo": return rebuildTrackedChange(item);
+			case "inlineSdt": return rebuildInlineSdt(item);
+			case "inlineWrapper": {
+				const content = rebuildParagraphContent(item.content);
+				return content === item.content ? item : {
+					...item,
+					content
+				};
+			}
+			case "run":
+			case "complexField":
+			case "bookmarkStart":
+			case "bookmarkEnd":
+			case "commentRangeStart":
+			case "commentRangeEnd":
+			case "commentReference":
+			case "moveFromRangeStart":
+			case "moveFromRangeEnd":
+			case "moveToRangeStart":
+			case "moveToRangeEnd":
+			case "mathEquation":
+			case "preservedInline": return item;
+		}
+	};
+	const rebuildTrackedChange = (change) => {
+		const content = rebuildArray(change.content, rebuildTrackedContent);
+		return content === change.content ? change : {
+			...change,
+			content
+		};
+	};
+	const rebuildParagraphItem = (item) => {
+		switch (item.type) {
+			case "hyperlink": return rebuildHyperlink(item);
+			case "simpleField": return rebuildSimpleField(item);
+			case "insertion":
+			case "deletion":
+			case "moveFrom":
+			case "moveTo": return rebuildTrackedChange(item);
+			case "inlineSdt": return rebuildInlineSdt(item);
+			case "inlineWrapper": {
+				const content = rebuildParagraphContent(item.content);
+				return content === item.content ? item : {
+					...item,
+					content
+				};
+			}
+			case "run":
+			case "complexField":
+			case "bookmarkStart":
+			case "bookmarkEnd":
+			case "commentRangeStart":
+			case "commentRangeEnd":
+			case "commentReference":
+			case "moveFromRangeStart":
+			case "moveFromRangeEnd":
+			case "moveToRangeStart":
+			case "moveToRangeEnd":
+			case "mathEquation":
+			case "preservedInline": return item;
+		}
+	};
+	const rebuildHyperlinkContent = (item) => {
+		switch (item.type) {
+			case "inlineWrapper": {
+				const content = rebuildParagraphContent(item.content);
+				return content === item.content ? item : {
+					...item,
+					content
+				};
+			}
+			case "run":
+			case "bookmarkStart":
+			case "bookmarkEnd":
+			case "commentRangeStart":
+			case "commentRangeEnd":
+			case "commentReference":
+			case "moveFromRangeStart":
+			case "moveFromRangeEnd":
+			case "moveToRangeStart":
+			case "moveToRangeEnd":
+			case "preservedInline": return item;
+		}
+	};
+	const rebuildParagraphContent = (content) => rebuildArray(content, rebuildParagraphItem);
+	const rebuildParagraph = (paragraph) => {
+		const content = rebuildParagraphContent(paragraph.content);
+		return content === paragraph.content ? paragraph : cloneParagraphWithPropertySource(paragraph, { content });
+	};
+	const rebuildCell = (cell) => {
+		const content = rebuildBlocks(cell.content);
+		return content === cell.content ? cell : {
+			...cell,
+			content
+		};
+	};
+	const rebuildRow = (row) => {
+		const cells = rebuildArray(row.cells, rebuildCell);
+		return cells === row.cells ? row : {
+			...row,
+			cells
+		};
+	};
+	const rebuildTable = (table) => {
+		const rows = rebuildArray(table.rows, rebuildRow);
+		return rows === table.rows ? table : {
+			...table,
+			rows
+		};
+	};
+	const rebuildBlock = (block) => {
+		switch (block.type) {
+			case "paragraph": return rebuildParagraph(block);
+			case "table": return rebuildTable(block);
+			case "blockSdt":
+			case "blockCustomXml": {
+				const content = rebuildBlocks(block.content);
+				return content === block.content ? block : {
+					...block,
+					content
+				};
+			}
+			case "preservedBlock":
+			case "bookmarkStart":
+			case "bookmarkEnd":
+			case "moveFromRangeStart":
+			case "moveFromRangeEnd":
+			case "moveToRangeStart":
+			case "moveToRangeEnd": return block;
+		}
+	};
+	const rebuildBlocks = (content) => rebuildArray(content, rebuildBlock);
+	return rebuildBlocks(blocks.slice());
+};
 /**
 * Comments that open a range anywhere in these blocks.
 *
@@ -47,4 +282,4 @@ const rangedCommentIds = (blocks) => {
 	return ids;
 };
 //#endregion
-export { rangedCommentIds, visitCommentMarkers };
+export { rangedCommentIds, removeCommentMarkers, visitCommentMarkers };

package/dist/docx/commentIdNormalization.d.ts

@@ -1,10 +1,9 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/docx/commentIdNormalization.d.ts
 /** The code this normalisation is reported under, owned here, not at the caller. */
-declare const DUPLICATE_COMMENT_ID_WARNING: "duplicate-comment-id";
-type NormalizeCommentIdsResult = {
+export declare const DUPLICATE_COMMENT_ID_WARNING: "duplicate-comment-id";
+export type NormalizeCommentIdsResult = {
   droppedDuplicateComments: number;
 };
-declare const normalizeCommentIds: (comments: document_d_exports.Comment[]) => NormalizeCommentIdsResult;
-//#endregion
-export { DUPLICATE_COMMENT_ID_WARNING, NormalizeCommentIdsResult, normalizeCommentIds };
+export declare const normalizeCommentIds: (comments: document_d_exports.Comment[]) => NormalizeCommentIdsResult;
+//#endregion

package/dist/docx/commentParser.d.ts

@@ -3,7 +3,7 @@ import { ParseContext } from "./parseContext.js";
 import { PreviewLedger } from "./previewBudget.js";
 import { StyleMap } from "./styleParser.js";
 //#region src/docx/commentParser.d.ts
-type CommentExtendedInfo = {
+export type CommentExtendedInfo = {
   parentParaId?: string;
   done?: boolean;
 };
@@ -21,7 +21,7 @@ type CommentExtendedInfo = {
  * `w15:paraIdParent` points at the parent thread's paraId; `w15:done`
  * (`"1"` / `"true"`) marks the thread resolved.
  */
-declare function parseCommentsExtended(xml: string): Map<string, CommentExtendedInfo>;
+export declare function parseCommentsExtended(xml: string): Map<string, CommentExtendedInfo>;
 /**
  * Parse comments.xml into an array of Comment objects.
  *
@@ -30,6 +30,5 @@ declare function parseCommentsExtended(xml: string): Map<string, CommentExtended
  * local time. If `commentsExtendedXml` is provided, reply-thread
  * parent links (`parentId`) and resolved state (`done`) are populated.
  */
-declare function parseComments(commentsXml: string | null, styles: StyleMap | null, theme: document_d_exports.Theme | null, rels: document_d_exports.RelationshipMap, media: Map<string, document_d_exports.MediaFile>, commentsExtensibleXml?: string | null, commentsExtendedXml?: string | null, context?: ParseContext, previews?: PreviewLedger): document_d_exports.Comment[];
-//#endregion
-export { CommentExtendedInfo, parseComments, parseCommentsExtended };
+export declare function parseComments(commentsXml: string | null, styles: StyleMap | null, theme: document_d_exports.Theme | null, rels: document_d_exports.RelationshipMap, media: Map<string, document_d_exports.MediaFile>, commentsExtensibleXml?: string | null, commentsExtendedXml?: string | null, context?: ParseContext, previews?: PreviewLedger): document_d_exports.Comment[];
+//#endregion

package/dist/docx/commentParser.js

@@ -151,7 +151,8 @@ function parseComments(commentsXml, styles, theme, rels, media, commentsExtensib
 	const root = parseXml(commentsXml);
 	const dateUtcByParaId = commentsExtensibleXml ? parseCommentsExtensible(commentsExtensibleXml) : /* @__PURE__ */ new Map();
 	const extendedByParaId = commentsExtendedXml ? parseCommentsExtended(commentsExtendedXml) : /* @__PURE__ */ new Map();
-	const children = getChildElements(findChild(root, "w", "comments") ?? root);
+	const commentsEl = findChild(root, "w", "comments") ?? root;
+	const children = getChildElements(commentsEl);
 	const parsed = [];
 	const commentIdByParaId = /* @__PURE__ */ new Map();
 	for (const child of children) {

package/dist/docx/commentRangeIntegrity.d.ts

@@ -5,7 +5,7 @@ import { document_d_exports } from "../types/document.js";
  * XML. Either half alone is invalid OOXML and anchors nothing: Word shows no
  * comment for a range that never opens.
  */
-declare const unbalancedCommentRangeIds: (xml: string) => Set<string>;
+export declare const unbalancedCommentRangeIds: (xml: string) => Set<string>;
 /**
  * Whether rewriting `originalXml` into `patchedXml` left a comment range with
  * only one half. A save patches the paragraphs an edit touched and keeps the
@@ -14,7 +14,8 @@ declare const unbalancedCommentRangeIds: (xml: string) => Set<string>;
  * start. Ranges the source already had unbalanced are not this save's doing
  * and stay tolerated.
  */
-declare const patchBreaksCommentRangeBalance: (originalXml: string, patchedXml: string) => boolean;
-declare const withoutOrphanCommentRanges: (doc: document_d_exports.Document) => document_d_exports.Document;
-//#endregion
-export { patchBreaksCommentRangeBalance, unbalancedCommentRangeIds, withoutOrphanCommentRanges };
+export declare const patchBreaksCommentRangeBalance: (originalXml: string, patchedXml: string) => boolean;
+export declare const withoutOrphanCommentRanges: (doc: document_d_exports.Document) => document_d_exports.Document;
+/** A save projection without exhausted definitions or any of their carriers. */
+export declare const withoutExhaustedComments: (doc: document_d_exports.Document) => document_d_exports.Document;
+//#endregion

package/dist/docx/commentRangeIntegrity.js

@@ -1,4 +1,6 @@
 import { cloneParagraphWithPropertySource } from "./paragraphPropertySource.js";
+import { setDocumentBodyComments } from "@stll/docx-core/model";
+import { survivingComments } from "@stll/docx-core/ops";
 //#region src/docx/commentRangeIntegrity.ts
 /**
 * A range marker under any prefix, or none: this is the guard a splice is
@@ -65,6 +67,20 @@ const withoutOrphanCommentRanges = (doc) => {
 		}
 	};
 };
+/** A save projection without exhausted definitions or any of their carriers. */
+const withoutExhaustedComments = (doc) => {
+	const comments = survivingComments(doc);
+	if (comments.length === (doc.package.document.comments ?? []).length) return doc;
+	const documentBody = { ...doc.package.document };
+	setDocumentBodyComments(documentBody, comments);
+	return withoutOrphanCommentRanges({
+		...doc,
+		package: {
+			...doc.package,
+			document: documentBody
+		}
+	});
+};
 const withoutOrphanDocumentBodyMarkers = (document, validCommentIds) => {
 	const content = withoutOrphanBlockMarkers(document.content, validCommentIds);
 	const comments = withoutOrphanCommentBodyMarkers(document.comments, validCommentIds);
@@ -233,4 +249,4 @@ const withoutOrphanParagraphMarkers = (paragraph, validCommentIds) => {
 };
 const isCommentMarker = (content) => content.type === "commentRangeStart" || content.type === "commentRangeEnd" || content.type === "commentReference";
 //#endregion
-export { patchBreaksCommentRangeBalance, unbalancedCommentRangeIds, withoutOrphanCommentRanges };
+export { patchBreaksCommentRangeBalance, unbalancedCommentRangeIds, withoutExhaustedComments, withoutOrphanCommentRanges };

package/dist/docx/commentRangeJoin.d.ts

@@ -4,6 +4,5 @@ import { document_d_exports } from "../types/document.js";
  * Collapse each comment's range markers to its first start and its last end.
  * Answers how many markers were dropped.
  */
-declare const joinCommentRangesAcrossParagraphs: (blocks: readonly document_d_exports.BlockContent[]) => number;
-//#endregion
-export { joinCommentRangesAcrossParagraphs };
+export declare const joinCommentRangesAcrossParagraphs: (blocks: readonly document_d_exports.BlockContent[]) => number;
+//#endregion

package/dist/docx/commentReferenceCompletion.d.ts

@@ -4,6 +4,5 @@ import { document_d_exports } from "../types/document.js";
  * Give every comment that a `commentRangeEnd` closes but no `commentReference`
  * names a reference after its last end. Answers how many were added.
  */
-declare const completeCommentReferences: (blocks: readonly document_d_exports.BlockContent[]) => number;
-//#endregion
-export { completeCommentReferences };
+export declare const completeCommentReferences: (blocks: readonly document_d_exports.BlockContent[]) => number;
+//#endregion

package/dist/docx/commentReferenceNormalization.d.ts

@@ -1,8 +1,8 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/docx/commentReferenceNormalization.d.ts
 /** The codes this normalisation is reported under, owned here, not at the caller. */
-declare const DANGLING_COMMENT_REFERENCE_WARNING: "dangling-comment-reference";
-declare const UNBALANCED_COMMENT_RANGE_WARNING: "unbalanced-comment-range";
+export declare const DANGLING_COMMENT_REFERENCE_WARNING: "dangling-comment-reference";
+export declare const UNBALANCED_COMMENT_RANGE_WARNING: "unbalanced-comment-range";
 type NormalizeCommentReferencesInput = {
   documentBody: document_d_exports.DocumentBody;
   comments: readonly document_d_exports.Comment[];
@@ -15,6 +15,6 @@ type NormalizeCommentReferencesResult = {
   removedDanglingReferences: number;
   reanchoredUnbalancedRanges: number;
 };
-declare const normalizeCommentReferences: ({ documentBody, comments, headers, footers, footnotes, endnotes }: NormalizeCommentReferencesInput) => NormalizeCommentReferencesResult;
+export declare const normalizeCommentReferences: ({ documentBody, comments, headers, footers, footnotes, endnotes }: NormalizeCommentReferencesInput) => NormalizeCommentReferencesResult;
 //#endregion
-export { DANGLING_COMMENT_REFERENCE_WARNING, UNBALANCED_COMMENT_RANGE_WARNING, normalizeCommentReferences };
+export {};

package/dist/docx/commentReplyMarkers.d.ts

@@ -6,7 +6,7 @@ import { document_d_exports } from "../types/document.js";
  * serialized. Idempotent and safe to call on both save paths. Returns the
  * number of markers injected.
  */
-declare const applyReplyThreadMarkers: (doc: document_d_exports.Document) => number;
+export declare const applyReplyThreadMarkers: (doc: document_d_exports.Document) => number;
 /**
  * Whether the model holds a reply comment that has no anchor of its own yet —
  * i.e. one that still needs {@link applyReplyThreadMarkers} to run. The
@@ -14,6 +14,5 @@ declare const applyReplyThreadMarkers: (doc: document_d_exports.Document) => num
  * that owns marker synthesis (selective only patches individually-changed
  * paragraphs, so it cannot add a reply's markers to the parent's paragraph).
  */
-declare const hasUnsynthesizedReplyRanges: (doc: document_d_exports.Document) => boolean;
-//#endregion
-export { applyReplyThreadMarkers, hasUnsynthesizedReplyRanges };
+export declare const hasUnsynthesizedReplyRanges: (doc: document_d_exports.Document) => boolean;
+//#endregion

package/dist/docx/commentTextParagraph.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/docx/commentTextParagraph.d.ts
 /** Plain comment text has no authored paragraph formatting. */
-declare const commentTextParagraph: (text: string) => document_d_exports.Paragraph;
-//#endregion
-export { commentTextParagraph };
+export declare const commentTextParagraph: (text: string) => document_d_exports.Paragraph;
+//#endregion

package/dist/docx/commentThreadKey.d.ts

@@ -13,6 +13,5 @@
  * paragraph than the parse would write a `commentsExtended.xml` whose entries
  * belong to other comments — so both call this instead of restating it.
  */
-declare const commentThreadParaId: (paragraphParaIds: Iterable<string | null | undefined>) => string | undefined;
-//#endregion
-export { commentThreadParaId };
+export declare const commentThreadParaId: (paragraphParaIds: Iterable<string | null | undefined>) => string | undefined;
+//#endregion

package/dist/docx/compatibility.d.ts

@@ -1,15 +1,15 @@
 import { document_d_exports } from "../types/document.js";
 import { DrawingSafetyClass } from "./imageRawXml.js";
 //#region src/docx/compatibility.d.ts
-type DocxCompatibilityReason = "opaqueDrawing" | "unsupportedAltChunk";
-type FolioDocxCompatibilityHost = "browser" | "server" | "unknown";
-type FolioDocxCompatibilityProfile = document_d_exports.DocxConformanceClass;
-type DocxCompatibilityContext = {
+export type DocxCompatibilityReason = "opaqueDrawing" | "unsupportedAltChunk";
+export type FolioDocxCompatibilityHost = "browser" | "server" | "unknown";
+export type FolioDocxCompatibilityProfile = document_d_exports.DocxConformanceClass;
+export type DocxCompatibilityContext = {
   host: FolioDocxCompatibilityHost;
   profile: FolioDocxCompatibilityProfile;
 };
-type InspectDocxCompatibilityOptions = Partial<DocxCompatibilityContext>;
-type DocxCompatibilityPart = {
+export type InspectDocxCompatibilityOptions = Partial<DocxCompatibilityContext>;
+export type DocxCompatibilityPart = {
   type: "document";
 } | {
   type: "header" | "footer";
@@ -18,17 +18,17 @@ type DocxCompatibilityPart = {
   type: "footnote" | "endnote";
   id: number;
 };
-type DocxCompatibilityLocation = {
+export type DocxCompatibilityLocation = {
   part: DocxCompatibilityPart;
   path: string;
   blockId?: string;
 };
-type DocxCompatibilityIssue = {
+export type DocxCompatibilityIssue = {
   code: DocxCompatibilityReason;
   location: DocxCompatibilityLocation;
 };
 /** A drawing and the fate the run serializer holds for it. */
-type DocxDrawingClassification = {
+export type DocxDrawingClassification = {
   class: DrawingSafetyClass;
   location: DocxCompatibilityLocation;
 };
@@ -37,7 +37,7 @@ type DocxDrawingClassification = {
  * {@link DocxDrawingClassification} and stopped reporting a replayable drawing
  * as an issue; `issues` now holds opaque drawings only.
  */
-type DocxCompatibility = {
+export type DocxCompatibility = {
   schemaVersion: 2;
   context: DocxCompatibilityContext;
   canSafelyEdit: boolean;
@@ -48,6 +48,5 @@ type DocxCompatibility = {
   reasons: DocxCompatibilityReason[];
   unsupportedContentCount: number;
 };
-declare const inspectDocxCompatibility: (doc: document_d_exports.Document, options?: InspectDocxCompatibilityOptions) => DocxCompatibility;
-//#endregion
-export { DocxCompatibility, DocxCompatibilityContext, DocxCompatibilityIssue, DocxCompatibilityLocation, DocxCompatibilityPart, DocxCompatibilityReason, DocxDrawingClassification, FolioDocxCompatibilityHost, FolioDocxCompatibilityProfile, InspectDocxCompatibilityOptions, inspectDocxCompatibility };
+export declare const inspectDocxCompatibility: (doc: document_d_exports.Document, options?: InspectDocxCompatibilityOptions) => DocxCompatibility;
+//#endregion

package/dist/docx/conformance.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/docx/conformance.d.ts
-declare const detectDocxConformanceClass: (documentXml: string | null) => document_d_exports.DocxConformanceClass;
-//#endregion
-export { detectDocxConformanceClass };
+export declare const detectDocxConformanceClass: (documentXml: string | null) => document_d_exports.DocxConformanceClass;
+//#endregion

package/dist/docx/conformance.js

@@ -4,7 +4,7 @@ import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
 //#region src/docx/conformance.ts
 const STRICT_MAIN_NAMESPACE = "http://purl.oclc.org/ooxml/wordprocessingml/main";
 const TRANSITIONAL_MAIN_NAMESPACE = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
-const ROOT_START_TAG_SCAN_LIMIT = 64 * 1024;
+const ROOT_START_TAG_SCAN_LIMIT = 65536;
 const XML_WHITESPACE = /\s/u;
 /**
 * Find the root start tag within a bounded prefix of `document.xml`,

package/dist/docx/containerChildren.d.ts

@@ -4,7 +4,7 @@ import { PreservedChild, PreservedMarkup } from "@stll/docx-core/model";
 import { SequenceContainer } from "@stll/docx-core/schema";
 //#region src/docx/containerChildren.d.ts
 /** Keep this child's markup verbatim, in place. */
-declare const CAPTURE = "capture";
+export declare const CAPTURE = "capture";
 /**
  * What a handler answers with: nothing when it took a typed value, and
  * {@link CAPTURE} when it took none, so the child's bytes are kept instead.
@@ -14,7 +14,7 @@ declare const CAPTURE = "capture";
  * walk, and neither can be decided by name: a map keyed by name cannot list
  * the values a reader will refuse, only the names it has never heard of.
  */
-declare const keptUnless: (taken: boolean) => typeof CAPTURE | undefined;
+export declare const keptUnless: (taken: boolean) => typeof CAPTURE | undefined;
 declare const OWNED_ELSEWHERE = "owned-elsewhere";
 /**
  * Who reads a child this walk skips: `<module>#<export>`.
@@ -24,7 +24,7 @@ declare const OWNED_ELSEWHERE = "owned-elsewhere";
  * element. Both halves are resolved by `scripts/container-ownership.test.ts`,
  * which imports every one of them.
  */
-type ChildOwnerRef = `${string}#${string}`;
+export type ChildOwnerRef = `${string}#${string}`;
 /**
  * Another reader owns this child, and re-emits it.
  *
@@ -46,14 +46,14 @@ type ChildOwnerRef = `${string}#${string}`;
  * key, and {@link ChildHandlers} binds them to it: an entry that names a child
  * other than the one it is filed under does not compile.
  */
-type OwnedElsewhere<Container extends DispatchedContainer = DispatchedContainer, Child extends string = string> = {
+export type OwnedElsewhere<Container extends DispatchedContainer = DispatchedContainer, Child extends string = string> = {
   readonly disposition: typeof OWNED_ELSEWHERE;
   readonly container: Container;
   readonly child: Child;
   readonly reader: ChildOwnerRef;
 };
 /** One handler map's claim that another reader owns one of its children. */
-type ChildOwnerClaim = {
+export type ChildOwnerClaim = {
   readonly container: DispatchedContainer;
   readonly child: string;
   readonly reader: ChildOwnerRef;
@@ -66,9 +66,9 @@ type ChildOwnerClaim = {
  * the claiming modules first, by scanning the sources for the call rather than
  * by keeping a list beside them.
  */
-declare const ownedElsewhereClaims: () => readonly ChildOwnerClaim[];
+export declare const ownedElsewhereClaims: () => readonly ChildOwnerClaim[];
 /** State that another reader takes this child, and who. */
-declare const ownedElsewhere: <Container extends DispatchedContainer, Child extends DeclaredChild<Container>>(claim: ChildOwnerClaim & {
+export declare const ownedElsewhere: <Container extends DispatchedContainer, Child extends DeclaredChild<Container>>(claim: ChildOwnerClaim & {
   container: Container;
   child: Child;
 }) => OwnedElsewhere<Container, Child>;
@@ -82,13 +82,13 @@ declare const ownedElsewhere: <Container extends DispatchedContainer, Child exte
  * in `specifications/container-contract/contract.json`, which is the whole
  * difference between this and a `default` that says nothing.
  */
-declare const DROPPED_WITH_ITS_WRAPPER = "dropped-with-its-wrapper";
+export declare const DROPPED_WITH_ITS_WRAPPER = "dropped-with-its-wrapper";
 /**
  * A handler that reads one child. `context` is the value the walk was given
  * (see {@link dispatchChildrenWithContext}), so a handler table can be built
  * once per module rather than as closures per element.
  */
-type ChildReader<Context = undefined> = (child: XmlElement, context: Context) => typeof CAPTURE | void;
+export type ChildReader<Context = undefined> = (child: XmlElement, context: Context) => typeof CAPTURE | void;
 /**
  * What a container does with one declared child.
  *
@@ -100,7 +100,7 @@ type ChildReader<Context = undefined> = (child: XmlElement, context: Context) =>
  * it by the outcome rather than by the name is what makes the decision total:
  * the map cannot list the values a reader will refuse.
  */
-type ChildDisposition<Container extends DispatchedContainer = DispatchedContainer, Child extends string = string, Context = undefined> = ChildReader<Context> | typeof CAPTURE | typeof DROPPED_WITH_ITS_WRAPPER | OwnedElsewhere<Container, Child>;
+export type ChildDisposition<Container extends DispatchedContainer = DispatchedContainer, Child extends string = string, Context = undefined> = ChildReader<Context> | typeof CAPTURE | typeof DROPPED_WITH_ITS_WRAPPER | OwnedElsewhere<Container, Child>;
 /**
  * A total decision per declared child.
  *
@@ -109,7 +109,7 @@ type ChildDisposition<Container extends DispatchedContainer = DispatchedContaine
  * type is keyed by the child it is filed under, so an {@link ownedElsewhere}
  * entry cannot name a different child than the one it decides.
  */
-type ChildHandlers<Container extends DispatchedContainer, Context = undefined> = Readonly<{ [Child in DeclaredChild<Container>]: ChildDisposition<Container, Child, Context>; }>;
+export type ChildHandlers<Container extends DispatchedContainer, Context = undefined> = Readonly<{ [Child in DeclaredChild<Container>]: ChildDisposition<Container, Child, Context>; }>;
 type DispatchChildrenOptions<Container extends DispatchedContainer, Context = undefined> = {
   /** The container element, as the source wrote it. */
   element: XmlElement;
@@ -168,7 +168,7 @@ type DispatchChildrenOptions<Container extends DispatchedContainer, Context = un
  * here, so a namespace cannot be paired in one place and forgotten in the
  * other.
  */
-declare const transitionalNamespaceOf: (namespace: string) => string;
+export declare const transitionalNamespaceOf: (namespace: string) => string;
 /**
  * Walk a container's children, handing each to its handler and the rest to the
  * sink.
@@ -177,12 +177,12 @@ declare const transitionalNamespaceOf: (namespace: string) => string;
  *   none — an empty record is never written, so a fully modelled container
  *   stays byte-identical in the model.
  */
-declare const dispatchChildren: <Container extends DispatchedContainer>(options: DispatchChildrenOptions<Container>) => PreservedMarkup | undefined;
+export declare const dispatchChildren: <Container extends DispatchedContainer>(options: DispatchChildrenOptions<Container>) => PreservedMarkup | undefined;
 /**
  * {@link dispatchChildren} for a handler table that reads into a value it is
  * handed rather than one it closes over, so the table is built once.
  */
-declare const dispatchChildrenWithContext: <Container extends DispatchedContainer, Context>({ element, handlers, capturePosition, undeclared, undeclaredNamespaces, context }: DispatchChildrenOptions<Container, Context> & {
+export declare const dispatchChildrenWithContext: <Container extends DispatchedContainer, Context>({ element, handlers, capturePosition, undeclared, undeclaredNamespaces, context }: DispatchChildrenOptions<Container, Context> & {
   context: Context;
 }) => PreservedMarkup | undefined;
 /**
@@ -195,11 +195,11 @@ declare const dispatchChildrenWithContext: <Container extends DispatchedContaine
  *
  * @param wrap turns one capture's markup into whatever the caller's list holds
  */
-declare const withPreservedChildren: <Item, Child extends PreservedChild = PreservedChild>(modelled: readonly Item[], preserved: {
+export declare const withPreservedChildren: <Item, Child extends PreservedChild = PreservedChild>(modelled: readonly Item[], preserved: {
   children?: Child[];
 } | undefined, wrap: (xml: string, child: Child) => Item) => Item[];
 /** {@link withPreservedChildren} for a caller that already holds markup. */
-declare const serializeWithPreservedChildren: (modelled: readonly string[], preserved: PreservedMarkup | undefined) => string;
+export declare const serializeWithPreservedChildren: (modelled: readonly string[], preserved: PreservedMarkup | undefined) => string;
 /**
  * Where each child sits in a container whose content model is one flat sequence.
  *
@@ -216,6 +216,6 @@ declare const serializeWithPreservedChildren: (modelled: readonly string[], pres
  * the same neighbour. One before every declared child takes position `-1`,
  * ahead of the sequence's first slot.
  */
-declare const sequencePositions: <Container extends SequenceContainer>(container: Container, element: XmlElement) => ((child: XmlElement) => number);
+export declare const sequencePositions: <Container extends SequenceContainer>(container: Container, element: XmlElement) => ((child: XmlElement) => number);
 //#endregion
-export { CAPTURE, ChildDisposition, ChildHandlers, ChildOwnerClaim, ChildOwnerRef, ChildReader, DROPPED_WITH_ITS_WRAPPER, OwnedElsewhere, dispatchChildren, dispatchChildrenWithContext, keptUnless, ownedElsewhere, ownedElsewhereClaims, sequencePositions, serializeWithPreservedChildren, transitionalNamespaceOf, withPreservedChildren };
+export {};