@stll/folio-core 0.61.0 → 0.63.0

package/dist/docx/bulletMarkers.d.ts

@@ -1,10 +1,15 @@
 //#region src/docx/bulletMarkers.d.ts
+/**
+ * Fonts whose single-byte codes name pictographs rather than Latin letters.
+ * A `w:lvlText` character below U+0100 only means a symbol glyph when the
+ * numbering level's `w:rFonts` selects one of these faces.
+ */
 type MarkerFontFamily = {
   ascii?: string | undefined;
   hAnsi?: string | undefined;
 };
 /** The face a bullet level's `w:rFonts` names for its (Latin-range) marker character. */
-declare const bulletMarkerFontName: (formatting: {
+export declare const bulletMarkerFontName: (formatting: {
   fontFamily?: MarkerFontFamily | undefined;
 } | null | undefined) => string | undefined;
 /**
@@ -15,6 +20,6 @@ declare const bulletMarkerFontName: (formatting: {
  * in a monospace face); without a named face the character is read as a
  * symbol-font code.
  */
-declare const convertBulletToUnicode: (bulletChar: string, fontName?: string) => string;
+export declare const convertBulletToUnicode: (bulletChar: string, fontName?: string) => string;
 //#endregion
-export { bulletMarkerFontName, convertBulletToUnicode };
+export {};

package/dist/docx/bulletMarkers.js

@@ -1,49 +1,9 @@
+import { isOoxmlSymbolFont, lookupOoxmlSymbolUnicodeTwin } from "../utils/ooxmlSymbol.js";
 //#region src/docx/bulletMarkers.ts
-const SYMBOL_BULLET_MAP = {
-	183: "•",
-	111: "○",
-	167: "■",
-	252: "✓",
-	110: "■",
-	113: "○",
-	117: "◆",
-	118: "❖",
-	168: "✓",
-	251: "✓",
-	254: "✓",
-	61623: "•",
-	61550: "■",
-	61551: "○",
-	61607: "■",
-	61692: "✓",
-	8226: "•",
-	9679: "●",
-	9675: "○",
-	9632: "■",
-	9633: "□",
-	9670: "◆",
-	9671: "◇",
-	8211: "–",
-	8212: "—",
-	62: ">",
-	45: "-"
-};
-/**
-* Fonts whose single-byte codes name pictographs rather than Latin letters.
-* A `w:lvlText` character below U+0100 only means a symbol glyph when the
-* numbering level's `w:rFonts` selects one of these faces.
-*/
-const SYMBOL_ENCODED_FONTS = /* @__PURE__ */ new Set([
-	"symbol",
-	"wingdings",
-	"wingdings 2",
-	"wingdings 3",
-	"webdings"
-]);
 /** The face a bullet level's `w:rFonts` names for its (Latin-range) marker character. */
 const bulletMarkerFontName = (formatting) => formatting?.fontFamily?.ascii ?? formatting?.fontFamily?.hAnsi;
 /** A printable Latin-1 character in a named, non-symbol face paints as itself. */
-const isTextFontCharacter = (charCode, fontName) => fontName !== void 0 && (charCode >= 32 && charCode < 127 || charCode >= 160 && charCode < 256) && !SYMBOL_ENCODED_FONTS.has(fontName.trim().toLowerCase());
+const isTextFontCharacter = (charCode, fontName) => fontName !== void 0 && (charCode >= 32 && charCode < 127 || charCode >= 160 && charCode < 256) && !isOoxmlSymbolFont(fontName);
 /**
 * Map a bullet level's `w:lvlText` to the character painted for it.
 *
@@ -57,7 +17,7 @@ const convertBulletToUnicode = (bulletChar, fontName) => {
 	const charCode = bulletChar.codePointAt(0);
 	if (charCode === void 0) return "•";
 	if (isTextFontCharacter(charCode, fontName)) return bulletChar;
-	const mapped = SYMBOL_BULLET_MAP[charCode];
+	const mapped = lookupOoxmlSymbolUnicodeTwin(charCode);
 	if (mapped !== void 0) return mapped;
 	if (charCode >= 57344 && charCode <= 63743) return "•";
 	if (charCode < 32 || charCode >= 127 && charCode < 160) return "•";

package/dist/docx/canonicalModel.d.ts

@@ -0,0 +1,2 @@
+import { setDocumentBodyComments } from "@stll/docx-core/model";
+export { setDocumentBodyComments };

package/dist/docx/canonicalModel.js

@@ -0,0 +1 @@
+export { setDocumentBodyComments } from "@stll/docx-core/model";

package/dist/docx/canonicalResourceSave.d.ts

@@ -3,7 +3,7 @@ import { CANONICAL_GAP } from "../types/canonicalCapabilities.js";
 import { SaveDiagnostic } from "./saveDiagnostics.js";
 //#region src/docx/canonicalResourceSave.d.ts
 declare const CanonicalResourceSaveRefusalError_base: import("better-result").TaggedErrorClass<"CanonicalResourceSaveRefusalError">;
-declare class CanonicalResourceSaveRefusalError extends CanonicalResourceSaveRefusalError_base<{
+export declare class CanonicalResourceSaveRefusalError extends CanonicalResourceSaveRefusalError_base<{
   message: string;
   gap: typeof CANONICAL_GAP.resourceReplacement;
   diagnostic: Extract<SaveDiagnostic, {
@@ -11,6 +11,6 @@ declare class CanonicalResourceSaveRefusalError extends CanonicalResourceSaveRef
   }>;
 }> {}
 /** Full and selective package writers preserve existing style/media source entries. */
-declare const canonicalResourceReplacementOf: (document: document_d_exports.Document) => string | undefined;
+export declare const canonicalResourceReplacementOf: (document: document_d_exports.Document) => string | undefined;
 //#endregion
-export { CanonicalResourceSaveRefusalError, canonicalResourceReplacementOf };
+export {};

package/dist/docx/canonicalSave.d.ts

@@ -7,7 +7,7 @@ import { FolioSelectiveSaveFlags } from "./selectiveSaveFlags.js";
 //#region src/docx/canonicalSave.d.ts
 declare const CanonicalSaveDiagnosticError_base: import("better-result").TaggedErrorClass<"CanonicalSaveDiagnosticError">;
 /** Forward a fidelity fallback through the adapters' existing error channel. */
-declare class CanonicalSaveDiagnosticError extends CanonicalSaveDiagnosticError_base<{
+export declare class CanonicalSaveDiagnosticError extends CanonicalSaveDiagnosticError_base<{
   message: string;
   gap: typeof CANONICAL_GAP.save;
   diagnostic: SaveDiagnostic;
@@ -18,7 +18,7 @@ type SerializeCanonicalSaveOptions = {
   featureFlags?: FolioSelectiveSaveFlags | undefined;
 };
 /** Model and change signals come from one committed snapshot, never from PM. */
-declare const serializeCanonicalSave: ({ snapshot, options, featureFlags }: SerializeCanonicalSaveOptions) => Promise<{
+export declare const serializeCanonicalSave: ({ snapshot, options, featureFlags }: SerializeCanonicalSaveOptions) => Promise<{
   buffer: ArrayBuffer;
   document: import("@stll/docx-core").Document;
   version: number;
@@ -26,4 +26,4 @@ declare const serializeCanonicalSave: ({ snapshot, options, featureFlags }: Seri
   tripwireResult: TripwireResult | null;
 }>;
 //#endregion
-export { CanonicalSaveDiagnosticError, serializeCanonicalSave };
+export {};

package/dist/docx/canonicalSessionInput.d.ts

@@ -1,11 +1,11 @@
 import { DocxInput } from "../utils/docxInput.js";
 //#region src/docx/canonicalSessionInput.d.ts
 declare const CanonicalDocxInputError_base: import("better-result").TaggedErrorClass<"CanonicalDocxInputError">;
-declare class CanonicalDocxInputError extends CanonicalDocxInputError_base<{
+export declare class CanonicalDocxInputError extends CanonicalDocxInputError_base<{
   message: string;
   cause?: unknown;
 }> {}
 /** Canonical seeding supports plaintext packages; refuse encryption before ZIP normalization. */
-declare const prepareCanonicalDocxInput: (input: DocxInput) => Promise<import("better-result").Err<ArrayBuffer, CanonicalDocxInputError> | import("better-result").Ok<Uint8Array<ArrayBufferLike>, CanonicalDocxInputError>>;
+export declare const prepareCanonicalDocxInput: (input: DocxInput) => Promise<import("better-result").Err<ArrayBuffer, CanonicalDocxInputError> | import("better-result").Ok<Uint8Array<ArrayBufferLike>, CanonicalDocxInputError>>;
 //#endregion
-export { CanonicalDocxInputError, prepareCanonicalDocxInput };
+export {};

package/dist/docx/canonicalStoryRepack.d.ts

@@ -5,6 +5,6 @@ type CanonicalStoryRepackOptions<T> = {
   repack: () => Promise<T>;
 };
 /** Authorize exact canonical section removals and references missing from the committed snapshot. */
-declare const repackWithCanonicalStoryRemovals: <T>({ document, repack }: CanonicalStoryRepackOptions<T>) => Promise<T>;
+export declare const repackWithCanonicalStoryRemovals: <T>({ document, repack }: CanonicalStoryRepackOptions<T>) => Promise<T>;
 //#endregion
-export { repackWithCanonicalStoryRemovals };
+export {};

package/dist/docx/chartPreview.d.ts

@@ -0,0 +1,6 @@
+import { document_d_exports } from "../types/document.js";
+import { XmlElement } from "./xmlParser.js";
+//#region src/docx/chartPreview.d.ts
+/** Describe a supported cached chart. AlternateContent fallbacks are resolved by the run parser. */
+export declare const parseChartPreview: (drawing: XmlElement, rels?: document_d_exports.RelationshipMap, media?: Map<string, document_d_exports.MediaFile>) => document_d_exports.Image | null;
+//#endregion

package/dist/docx/chartPreview.js

@@ -0,0 +1,302 @@
+import { decodeText } from "../utils/textEncoding.js";
+import "./diagramPreview.js";
+import { RELATIONSHIP_TYPES, resolveRelativePath } from "./relsParser.js";
+import { OFFICE_RELATIONSHIP_NAMESPACE_URIS, findChildByNamespaceUri, getAttribute, getAttributeByNamespaceUri, getChildElements, getLocalName, parseNumericAttribute, parseXmlDocument } from "./xmlParser.js";
+//#region src/docx/chartPreview.ts
+const DRAWINGML = /* @__PURE__ */ new Set(["http://schemas.openxmlformats.org/drawingml/2006/main", "http://purl.oclc.org/ooxml/drawingml/main"]);
+const CHART = /* @__PURE__ */ new Set(["http://schemas.openxmlformats.org/drawingml/2006/chart", "http://purl.oclc.org/ooxml/drawingml/chart"]);
+const WORD_DRAWING = /* @__PURE__ */ new Set(["http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing", "http://purl.oclc.org/ooxml/drawingml/wordprocessingDrawing"]);
+const DOCUMENT_PATH = "word/document.xml";
+const DEFAULT_COLORS = [
+	"4472C4",
+	"ED7D31",
+	"A5A5A5",
+	"FFC000",
+	"5B9BD5",
+	"70AD47"
+];
+const MAX_SERIES = 16;
+const MAX_POINTS = 64;
+const matches = (element, namespaces, localName) => element.namespaceUri !== void 0 && namespaces.has(element.namespaceUri) && getLocalName(element.name ?? "") === localName;
+const descendants = (root, namespaces, localName) => {
+	const found = [];
+	const visit = (element) => {
+		if (matches(element, namespaces, localName)) found.push(element);
+		for (const child of getChildElements(element)) visit(child);
+	};
+	visit(root);
+	return found;
+};
+const firstDescendant = (root, namespaces, localName) => descendants(root, namespaces, localName).at(0) ?? null;
+const child = (root, localName) => findChildByNamespaceUri(root, CHART, localName);
+const extentOf = (drawing) => {
+	const frame = firstDescendant(drawing, WORD_DRAWING, "inline") ?? firstDescendant(drawing, WORD_DRAWING, "anchor");
+	const extent = frame ? findChildByNamespaceUri(frame, WORD_DRAWING, "extent") : null;
+	return {
+		width: parseNumericAttribute(extent, null, "cx") ?? 0,
+		height: parseNumericAttribute(extent, null, "cy") ?? 0
+	};
+};
+const fileAt = (media, path) => {
+	const wanted = path.toLowerCase();
+	for (const [candidate, file] of media) if (candidate.toLowerCase() === wanted) return file;
+};
+const xmlAt = (media, path) => {
+	const file = fileAt(media, path);
+	return file ? parseXmlDocument(decodeText(new Uint8Array(file.data))) : null;
+};
+const cacheValues = (reference, cacheName) => {
+	const cache = reference ? firstDescendant(reference, CHART, cacheName) : null;
+	if (!cache) return null;
+	const declaredCount = parseNumericAttribute(child(cache, "ptCount"), null, "val");
+	if (declaredCount === void 0 || !Number.isInteger(declaredCount) || declaredCount <= 0) return null;
+	const values = Array(Math.min(declaredCount, MAX_POINTS));
+	const seen = /* @__PURE__ */ new Set();
+	for (const point of getChildElements(cache).filter((item) => matches(item, CHART, "pt"))) {
+		const index = parseNumericAttribute(point, null, "idx");
+		if (index === void 0 || !Number.isInteger(index) || index < 0 || index >= declaredCount || seen.has(index)) return null;
+		seen.add(index);
+		const text = child(point, "v")?.elements?.find((item) => item.type === "text")?.text;
+		if (text === void 0) return null;
+		if (index < values.length) values[index] = String(text);
+	}
+	return values;
+};
+const seriesColor = (series, index) => {
+	const properties = child(series, "spPr");
+	const fill = properties ? firstDescendant(properties, DRAWINGML, "solidFill") : null;
+	const color = fill ? firstDescendant(fill, DRAWINGML, "srgbClr") : null;
+	const value = getAttribute(color, null, "val");
+	return value && /^[0-9a-f]{6}$/iu.test(value) ? value : DEFAULT_COLORS[index % DEFAULT_COLORS.length] ?? "4472C4";
+};
+const cachedSeries = (chart) => {
+	const result = [];
+	const seriesElements = getChildElements(chart).filter((item) => matches(item, CHART, "ser")).slice(0, MAX_SERIES);
+	if (seriesElements.length === 0) return null;
+	for (const [index, series] of seriesElements.entries()) {
+		const categoryRef = child(series, "cat");
+		const categories = cacheValues(categoryRef, "strCache") ?? cacheValues(categoryRef, "numCache");
+		const rawValues = cacheValues(child(series, "val") ?? child(series, "yVal"), "numCache");
+		if (!categories || !rawValues || categories.length !== rawValues.length) return null;
+		const values = rawValues.map((value) => value === void 0 ? void 0 : Number(value));
+		if (values.some((value) => value !== void 0 && !Number.isFinite(value))) return null;
+		result.push({
+			values,
+			color: seriesColor(series, index)
+		});
+	}
+	return result;
+};
+const pushShape = (shapes, shape) => {
+	if (shapes.length >= 128) return;
+	if (shape.type !== "polygon" && shape.type !== "polyline" && (shape.x < 0 || shape.y < 0 || shape.width <= 0 || shape.height <= 0)) return;
+	if ((shape.type === "polygon" || shape.type === "polyline") && shape.points.length < 2) return;
+	shapes.push(shape);
+};
+const barShapes = (chart, series, width, height) => {
+	const shapes = [];
+	const plot = {
+		x: width * .08,
+		y: height * .08,
+		width: width * .86,
+		height: height * .84
+	};
+	const direction = getAttribute(child(chart, "barDir"), null, "val") ?? "col";
+	const stacked = (getAttribute(child(chart, "grouping"), null, "val") ?? "clustered") === "stacked";
+	const points = series.at(0)?.values.length ?? 0;
+	const magnitude = Math.max(...series.flatMap((item) => item.values.map((value) => Math.abs(value ?? 0))));
+	if (!(magnitude > 0)) return [];
+	const normalized = series.map((item) => item.values.map((value) => value && value / magnitude));
+	const positives = Array.from({ length: points }, (_, point) => stacked ? normalized.reduce((sum, values) => sum + Math.max(0, values[point] ?? 0), 0) : Math.max(...normalized.map((values) => Math.max(0, values[point] ?? 0))));
+	const negatives = Array.from({ length: points }, (_, point) => stacked ? normalized.reduce((sum, values) => sum + Math.min(0, values[point] ?? 0), 0) : Math.min(...normalized.map((values) => Math.min(0, values[point] ?? 0))));
+	const maximum = Math.max(0, ...positives);
+	const minimum = Math.min(0, ...negatives);
+	const range = maximum - minimum;
+	if (!(range > 0) || points === 0) return [];
+	for (let point = 0; point < points; point++) {
+		let positive = 0;
+		let negative = 0;
+		for (const [seriesIndex, item] of series.entries()) {
+			const value = normalized[seriesIndex]?.[point];
+			if (value === void 0) continue;
+			let start = 0;
+			if (stacked) start = value >= 0 ? positive : negative;
+			if (value >= 0) positive += value;
+			else negative += value;
+			const band = (direction === "bar" ? plot.height : plot.width) / points;
+			const crossCount = stacked ? 1 : series.length;
+			const cross = band * .8 / crossCount;
+			const offset = band * point + band * .1 + (stacked ? 0 : seriesIndex * cross);
+			const from = (start - minimum) / range;
+			const to = (start + value - minimum) / range;
+			if (value === 0) continue;
+			if (direction === "bar") pushShape(shapes, {
+				type: "rect",
+				x: plot.x + Math.min(from, to) * plot.width,
+				y: plot.y + offset,
+				width: Math.abs(to - from) * plot.width,
+				height: cross,
+				color: item.color
+			});
+			else {
+				const top = 1 - Math.max(from, to);
+				pushShape(shapes, {
+					type: "rect",
+					x: plot.x + offset,
+					y: plot.y + top * plot.height,
+					width: cross,
+					height: Math.abs(to - from) * plot.height,
+					color: item.color
+				});
+			}
+		}
+	}
+	return shapes;
+};
+const lineShapes = (chart, series, width, height) => {
+	const values = series.flatMap((item) => item.values).filter((value) => value !== void 0);
+	const magnitude = Math.max(...values.map(Math.abs));
+	if (!(magnitude > 0)) return [];
+	const normalizedSeries = series.map((item) => item.values.map((value) => value && value / magnitude));
+	const normalizedValues = normalizedSeries.flatMap((seriesValues) => seriesValues).filter((value) => value !== void 0);
+	const minimum = Math.min(...normalizedValues);
+	const range = Math.max(...normalizedValues) - minimum || 1;
+	const shapes = [];
+	const seriesElements = getChildElements(chart).filter((item) => matches(item, CHART, "ser"));
+	for (const [seriesIndex, item] of series.entries()) {
+		const denominator = Math.max(1, item.values.length - 1);
+		const runs = [];
+		let points = [];
+		for (const [index, value] of (normalizedSeries[seriesIndex] ?? []).entries()) {
+			if (value === void 0) {
+				if (points.length > 0) runs.push(points);
+				points = [];
+				continue;
+			}
+			points.push({
+				x: width * (.08 + .84 * index / denominator),
+				y: height * (.9 - .8 * (value - minimum) / range)
+			});
+		}
+		if (points.length > 0) runs.push(points);
+		for (const run of runs) pushShape(shapes, {
+			type: "polyline",
+			points: run,
+			color: item.color,
+			strokeWidth: Math.max(1, Math.min(width, height) * .008)
+		});
+		if (child(seriesElements.at(seriesIndex) ?? null, "marker")) {
+			const size = Math.max(1, Math.min(width, height) * .018);
+			for (const point of runs.flat()) pushShape(shapes, {
+				type: "rect",
+				x: point.x - size / 2,
+				y: point.y - size / 2,
+				width: size,
+				height: size,
+				color: item.color
+			});
+		}
+	}
+	return shapes;
+};
+const arcPoints = (center, radius, start, sweep, segments) => {
+	const points = [];
+	for (let step = 0; step <= segments; step += 1) {
+		const angle = start + sweep * step / segments;
+		points.push({
+			x: center.x + radius * Math.cos(angle),
+			y: center.y + radius * Math.sin(angle)
+		});
+	}
+	return points;
+};
+const pieShapes = (chart, series, width, height, doughnut) => {
+	const values = series.at(0)?.values ?? [];
+	if (values.some((value) => value !== void 0 && value < 0)) return [];
+	const magnitude = Math.max(...values.map((value) => Math.abs(value ?? 0)));
+	if (!(magnitude > 0)) return [];
+	const normalized = values.map((value) => value && value / magnitude);
+	let total = 0;
+	for (const value of normalized) total += value ?? 0;
+	if (!(total > 0)) return [];
+	const shapes = [];
+	const center = {
+		x: width / 2,
+		y: height / 2
+	};
+	const radius = Math.min(width, height) * .42;
+	const holePercent = parseNumericAttribute(child(chart, "holeSize"), null, "val") ?? 50;
+	const hole = doughnut ? radius * Math.min(.9, Math.max(.1, holePercent / 100)) : 0;
+	let angle = (parseNumericAttribute(child(chart, "firstSliceAng"), null, "val") ?? 0) * Math.PI / 180 - Math.PI / 2;
+	for (const [index, value] of normalized.entries()) {
+		if (value === void 0 || value === 0) continue;
+		const sweep = Math.PI * 2 * value / total;
+		const segments = Math.max(1, Math.min(32, Math.ceil(32 * value / total)));
+		const outer = arcPoints(center, radius, angle, sweep, segments);
+		const inner = hole > 0 ? arcPoints(center, hole, angle + sweep, -sweep, segments) : [center];
+		pushShape(shapes, {
+			type: "polygon",
+			points: [...outer, ...inner],
+			color: DEFAULT_COLORS[index % DEFAULT_COLORS.length] ?? "4472C4"
+		});
+		angle += sweep;
+	}
+	return shapes;
+};
+const chartPart = (drawing, rels, media) => {
+	const graphicData = firstDescendant(drawing, DRAWINGML, "graphicData");
+	if (!graphicData || !CHART.has(getAttribute(graphicData, null, "uri") ?? "")) return null;
+	const reference = firstDescendant(graphicData, CHART, "chart");
+	const id = getAttributeByNamespaceUri(reference, OFFICE_RELATIONSHIP_NAMESPACE_URIS, "id");
+	const relationship = id ? rels.get(id) : void 0;
+	if (!relationship || relationship.type !== RELATIONSHIP_TYPES.chart || !relationship.target) return null;
+	const path = resolveRelativePath(DOCUMENT_PATH, relationship.target);
+	const root = xmlAt(media, path);
+	return root ? {
+		root,
+		path
+	} : null;
+};
+/** Describe a supported cached chart. AlternateContent fallbacks are resolved by the run parser. */
+const parseChartPreview = (drawing, rels, media) => {
+	if (!rels || !media) return null;
+	const part = chartPart(drawing, rels, media);
+	const size = extentOf(drawing);
+	if (!part || size.width <= 0 || size.height <= 0) return null;
+	const plotArea = firstDescendant(part.root, CHART, "plotArea");
+	if (!plotArea) return null;
+	const supported = getChildElements(plotArea).find((item) => [
+		"barChart",
+		"lineChart",
+		"pieChart",
+		"doughnutChart"
+	].includes(getLocalName(item.name ?? "")) && CHART.has(item.namespaceUri ?? ""));
+	if (!supported) return null;
+	const series = cachedSeries(supported);
+	if (!series) return null;
+	const kind = getLocalName(supported.name ?? "");
+	let shapes;
+	if (kind === "barChart") shapes = barShapes(supported, series, size.width, size.height);
+	else if (kind === "lineChart") shapes = lineShapes(supported, series, size.width, size.height);
+	else shapes = pieShapes(supported, series, size.width, size.height, kind === "doughnutChart");
+	if (shapes.length === 0) return null;
+	if (shapes.reduce((total, shape) => total + (shape.type === "polygon" || shape.type === "polyline" ? shape.points.length : 0), 0) > 512) return null;
+	if (!shapes.every((shape) => shape.type === "polygon" || shape.type === "polyline" ? shape.points.every(({ x, y }) => Number.isFinite(x) && Number.isFinite(y)) : [
+		shape.x,
+		shape.y,
+		shape.width,
+		shape.height
+	].every(Number.isFinite))) return null;
+	return {
+		type: "image",
+		preview: {
+			kind: "chart",
+			extent: size,
+			shapes
+		},
+		size,
+		wrap: { type: "inline" }
+	};
+};
+//#endregion
+export { parseChartPreview };

package/dist/docx/commentAnchorIndex.d.ts

@@ -1,6 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/docx/commentAnchorIndex.d.ts
-type CommentMarkerSlot = {
+export type CommentMarkerSlot = {
   /** The inline-content array the marker sits in, so a caller can splice it. */
   content: document_d_exports.ParagraphContent[];
   index: number;
@@ -12,7 +12,9 @@ type CommentMarkerSlot = {
     type: "commentReference";
   }>;
 };
-declare const visitCommentMarkers: (blocks: readonly document_d_exports.BlockContent[], visit: (slot: CommentMarkerSlot) => void) => void;
+export declare const visitCommentMarkers: (blocks: readonly document_d_exports.BlockContent[], visit: (slot: CommentMarkerSlot) => void) => void;
+/** Remove every serialized anchor record for comments whose definitions are retired. */
+export declare const removeCommentMarkers: (blocks: readonly document_d_exports.BlockContent[], commentIds: ReadonlySet<number>) => document_d_exports.BlockContent[];
 /**
  * Comments that open a range anywhere in these blocks.
  *
@@ -25,6 +27,5 @@ declare const visitCommentMarkers: (blocks: readonly document_d_exports.BlockCon
  * whole story: a reference that trails the end of a range three paragraphs back
  * is still not a point comment.
  */
-declare const rangedCommentIds: (blocks: readonly document_d_exports.BlockContent[]) => ReadonlySet<number>;
-//#endregion
-export { CommentMarkerSlot, rangedCommentIds, visitCommentMarkers };
+export declare const rangedCommentIds: (blocks: readonly document_d_exports.BlockContent[]) => ReadonlySet<number>;
+//#endregion