@stll/folio-core 0.66.1 → 0.66.2

package/dist/ai-edits/batch-claims.d.ts

@@ -26,6 +26,12 @@ type PositionRange = {
   from: number;
   to: number;
 };
+/** A paragraph before a deleted one that ends its container; see `paragraphsBefore`. */
+type ParagraphBefore = {
+  block: number;
+  /** Its break is not already pending deletion. */
+  keepsBreak: boolean;
+};
 /** The text an operation rewrites (`text`), only marks (`annotation`), or breaks (`split`). */
 type InlineClaim = {
   type: "text" | "annotation" | "split";
@@ -55,6 +61,17 @@ export type BatchClaim = InlineClaim |
    * any other does — see `followedByInsertion`.
    */
   keepsParagraph: boolean;
+  /** The paragraph ends its container, before anything the batch adds. */
+  endsContainer: boolean;
+  /**
+   * Tracked, the paragraphs before one that ends its container, nearest
+   * first, up to the container's start or a block that is not one. The
+   * nearest the batch keeps, when its break stays, is the one whose break
+   * the deletion retires: accepting runs it into this paragraph with its
+   * own properties, as applied directly this one goes. Empty applied
+   * directly, and for a paragraph that ends nothing.
+   */
+  paragraphsBefore: readonly ParagraphBefore[];
 } |
 /**
  * Joins `block` with the block starting at `next`, where `block` ends.
@@ -128,6 +145,15 @@ export declare class BatchClaims {
   private readonly columnInsertions;
   /** Accepted deletions that keep their paragraph, by where the paragraph starts and ends. */
   private readonly keptParagraphs;
+  /**
+   * Whether a tracked deletion of a paragraph that ends its container retires
+   * the break of the paragraph before, given the claims accepted so far: the
+   * nearest paragraph before it the batch does not delete keeps its break,
+   * and no merge of the batch deletes that break first.
+   */
+  private retiresBreakBefore;
+  /** `role` with what it takes from the batch's other claims settled. */
+  private settled;
   /** `claim`'s roles, given the insertions accepted so far. */
   private rolesOf;
   /**

package/dist/ai-edits/batch-claims.js

@@ -43,7 +43,10 @@ const blockRolesOf = (claim) => {
 			block: claim.block,
 			role: {
 				kind: "deleteBlock",
-				keepsParagraph: claim.keepsParagraph
+				keepsParagraph: claim.keepsParagraph,
+				endsContainer: claim.endsContainer,
+				paragraphsBefore: claim.paragraphsBefore,
+				retiresBreakBefore: false
 			}
 		}];
 		case "merge": return [{
@@ -105,7 +108,7 @@ const rolesConflict = (left, right) => {
 	if (ROLE_RANK[right.kind] > ROLE_RANK[left.kind]) return rolesConflict(right, left);
 	switch (left.kind) {
 		case "deleteBlock": switch (right.kind) {
-			case "paragraphProperties": return !left.keepsParagraph;
+			case "paragraphProperties": return left.endsContainer && (!left.keepsParagraph || left.retiresBreakBefore);
 			case "mergeNext": return false;
 			default: return true;
 		}
@@ -122,7 +125,7 @@ const rolesConflict = (left, right) => {
 			case "mergeNext": return false;
 			default: return true;
 		}
-		case "mergeNext": return right.kind === "paragraphProperties" && (left.joinsNow || left.setsProperties);
+		case "mergeNext": return right.kind === "paragraphProperties" && left.setsProperties;
 		case "paragraphProperties": return right.kind === "split" || right.kind === "paragraphProperties";
 		case "split":
 		case "text":
@@ -155,6 +158,27 @@ var BatchClaims = class {
 	columnInsertions = /* @__PURE__ */ new Map();
 	/** Accepted deletions that keep their paragraph, by where the paragraph starts and ends. */
 	keptParagraphs = /* @__PURE__ */ new Map();
+	/**
+	* Whether a tracked deletion of a paragraph that ends its container retires
+	* the break of the paragraph before, given the claims accepted so far: the
+	* nearest paragraph before it the batch does not delete keeps its break,
+	* and no merge of the batch deletes that break first.
+	*/
+	retiresBreakBefore(role) {
+		for (const { block, keepsBreak } of role.paragraphsBefore) {
+			const entries = this.blocks.get(block) ?? [];
+			if (entries.some((entry) => entry.role.kind === "deleteBlock")) continue;
+			return keepsBreak && !entries.some((entry) => entry.role.kind === "mergeOwn");
+		}
+		return false;
+	}
+	/** `role` with what it takes from the batch's other claims settled. */
+	settled(role) {
+		return role.kind === "deleteBlock" ? {
+			...role,
+			retiresBreakBefore: this.retiresBreakBefore(role)
+		} : role;
+	}
 	/** `claim`'s roles, given the insertions accepted so far. */
 	rolesOf(claim) {
 		return blockRolesOf(claim).map(({ block, role }) => role.kind === "deleteBlock" && role.keepsParagraph && claim.type === "deleteBlock" && (this.insertions.has(claim.end) || this.insertions.has(claim.block)) ? {
@@ -184,8 +208,9 @@ var BatchClaims = class {
 	* conflicts with none.
 	*/
 	conflictOf(claim) {
-		for (const { block, role } of this.rolesOf(claim)) {
-			for (const entry of this.blocks.get(block) ?? []) if (rolesConflict(entry.role, role)) return entry.operationId;
+		for (const { block, role: claimed } of this.rolesOf(claim)) {
+			const role = this.settled(claimed);
+			for (const entry of this.blocks.get(block) ?? []) if (rolesConflict(this.settled(entry.role), role)) return entry.operationId;
 			const fold = this.foldAt(block);
 			if (fold !== null) return fold;
 			if (role.kind === "deleteBlock") continue;

package/dist/ai-edits/headless.d.ts

@@ -383,6 +383,12 @@ export declare class FolioDocxReviewer {
    * the anchor map the apply layer resolves operations against.
    */
   snapshot(): FolioAIEditSnapshot;
+  /**
+   * The numbering ids every story but `story` defines: the package's and the
+   * lists each story started. Numbering ids are package-wide, while a story's
+   * state completes its numbering from its own paragraphs only.
+   */
+  private numberingIdsOutside;
   /** Every suggestion id the document's stories still carry. */
   private activeSuggestionIds;
   /** Export staged AI operations for storage by the host, outside the DOCX. */

package/dist/ai-edits/headless.js

@@ -2,7 +2,7 @@ import { matchInlineAtoms } from "../compare/inline-atoms.js";
 import { matchInlineProvenance } from "../compare/inline-provenance.js";
 import { stageSectionBoundaryProperties } from "../compare/section-boundary-properties.js";
 import { importReferencedStyleDefinitions, styleClosureNumberingReferences } from "../compare/style-resources.js";
-import { applyFolioDocumentOperations } from "../document-operations.js";
+import { applyFolioDocumentOperationsInPackage } from "../document-operations.js";
 import { removeCommentMarkers } from "../docx/commentAnchorIndex.js";
 import { applyReplyThreadMarkers } from "../docx/commentReplyMarkers.js";
 import { commentTextParagraph } from "../docx/commentTextParagraph.js";
@@ -620,6 +620,26 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	snapshot() {
 		return createStateSnapshot(this.state);
 	}
+	/**
+	* The numbering ids every story but `story` defines: the package's and the
+	* lists each story started. Numbering ids are package-wide, while a story's
+	* state completes its numbering from its own paragraphs only.
+	*/
+	numberingIdsOutside(story) {
+		const key = editableStoryKey(story);
+		const states = [...story.type === "main" ? [] : [this.state], ...[...this.secondaryStoryStates.values()].filter(({ handle }) => editableStoryKey(handle) !== key).map(({ state }) => state)];
+		const numIds = /* @__PURE__ */ new Set();
+		const abstractNumIds = /* @__PURE__ */ new Set();
+		for (const state of states) {
+			const definitions = getDocumentNumbering(state)?.definitions;
+			for (const { numId } of definitions?.nums ?? []) numIds.add(numId);
+			for (const { abstractNumId } of definitions?.abstractNums ?? []) abstractNumIds.add(abstractNumId);
+		}
+		return {
+			numIds,
+			abstractNumIds
+		};
+	}
 	/** Every suggestion id the document's stories still carry. */
 	activeSuggestionIds() {
 		const active = new Set(getSuggestions(this.state).map(({ suggestionId }) => suggestionId));
@@ -904,7 +924,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 				view.state = view.state.apply(transaction);
 			}
 		};
-		const result = applyFolioDocumentOperations({
+		const result = applyFolioDocumentOperationsInPackage({
 			view,
 			snapshot: sourceSnapshot,
 			batch,
@@ -915,6 +935,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			...tableTemplates !== void 0 && { tableTemplates },
 			...replacementBackground !== void 0 && { replacementBackground },
 			undefinedReferences,
+			numberingIdsElsewhere: this.numberingIdsOutside(story),
 			...restagesSuggestions === true ? { restagesSuggestions } : { pendingSuggestionIds: this.activeSuggestionIds() },
 			createCommentId: (text) => {
 				const comment = createReviewerComment({
@@ -1577,9 +1598,10 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 					view.state = view.state.apply(transaction);
 				}
 			};
-			const applied = applyFolioDocumentOperations({
+			const applied = applyFolioDocumentOperationsInPackage({
 				undefinedReferences: "refuse",
 				restagesSuggestions: true,
+				numberingIdsElsewhere: this.numberingIdsOutside(story),
 				view,
 				snapshot,
 				batch: {

package/dist/ai-edits/newListNumbering.d.ts

@@ -1,3 +1,4 @@
+import { NumberingIdsInUse } from "../docx/numberingIds.js";
 import { FolioContentStatedNumbering } from "../compare/content-types.js";
 import { ListKind } from "../docx/listNumberingInstances.js";
 import { FolioAIEditOperation, FolioAIListNumbering, FolioAINewListReference, FolioAIResolvedEditOperation } from "./types.js";
@@ -23,6 +24,8 @@ export declare const stageNewListOperations: (operations: readonly FolioAIEditOp
  * Replace every new-list request with a reference to an instance minted for
  * its operation: one instance per operation and kind. `numbering` is the map
  * the batch applies against; the result's map adds the minted instances.
+ * `elsewhere` holds the ids the package's other stories define, which no
+ * minted instance takes.
  */
-export declare const resolveNewListOperations: (operations: readonly FolioAIStagedEditOperation[], numbering: NumberingMap | null) => ResolvedNewLists;
+export declare const resolveNewListOperations: (operations: readonly FolioAIStagedEditOperation[], numbering: NumberingMap | null, elsewhere: NumberingIdsInUse) => ResolvedNewLists;
 export {};

package/dist/ai-edits/newListNumbering.js

@@ -82,8 +82,10 @@ const stageNewListOperations = (operations) => deferNewListRequests(operations);
 * Replace every new-list request with a reference to an instance minted for
 * its operation: one instance per operation and kind. `numbering` is the map
 * the batch applies against; the result's map adds the minted instances.
+* `elsewhere` holds the ids the package's other stories define, which no
+* minted instance takes.
 */
-const resolveNewListOperations = (operations, numbering) => {
+const resolveNewListOperations = (operations, numbering, elsewhere) => {
 	let definitions = numbering?.definitions;
 	let minted = false;
 	return {
@@ -94,7 +96,7 @@ const resolveNewListOperations = (operations, numbering) => {
 				if (value.kind !== "deferredNewList") return value;
 				let numId = instances.get(value.allocation);
 				if (numId === void 0) {
-					const instance = mintListInstance(definitions, { kind: value.allocation.format });
+					const instance = mintListInstance(definitions, { kind: value.allocation.format }, elsewhere);
 					definitions = instance.definitions;
 					minted = true;
 					numId = instance.numId;

package/dist/ai-edits/types.d.ts

@@ -654,7 +654,7 @@ export type FolioAIEditSkipReason = "missingBlock" | "changedBlock" | "ambiguous
  * next to it.
  */
 "pendingDeletion" |
-/** Resolve the removed paragraph mark before editing its properties separately. */
+/** Resolve the removed paragraph mark before editing its properties separately, or before inserting a paragraph between it and a table. */
 "pendingParagraphMarkDeletion";
 export type FolioAIEditAppliedOperation = {
   id: string;

package/dist/document-operations.d.ts

@@ -1,3 +1,4 @@
+import { NumberingIdsInUse } from "./docx/numberingIds.js";
 import { document_d_exports } from "./types/document.js";
 import { FolioTableTemplates } from "./ai-edits/table-template.js";
 import { FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditNormalization, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAITextRangeHandle } from "./ai-edits/types.js";
@@ -313,5 +314,16 @@ export type ApplyFolioDocumentOperationsOptions = {
    */
   restagesSuggestions?: boolean;
 };
-export declare const applyFolioDocumentOperations: ({ view, snapshot, batch, story, author, createCommentId, createUndoHandle, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedReferences, pendingSuggestionIds, restagesSuggestions }: ApplyFolioDocumentOperationsOptions) => FolioDocumentOperationResult;
+export declare const applyFolioDocumentOperations: (input: ApplyFolioDocumentOperationsOptions) => FolioDocumentOperationResult;
+/**
+ * Options of a caller that holds every story of the package: the numbering
+ * ids (`w:num`, `w:abstractNum`) the other stories define. A list the batch
+ * starts takes none of them, so its id names it in every story and survives a
+ * save.
+ */
+type ApplyFolioDocumentOperationsInPackageOptions = ApplyFolioDocumentOperationsOptions & {
+  numberingIdsElsewhere: NumberingIdsInUse;
+};
+/** {@link applyFolioDocumentOperations} for a caller holding every story. Internal. */
+export declare const applyFolioDocumentOperationsInPackage: ({ view, snapshot, batch, story, author, createCommentId, createUndoHandle, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedReferences, pendingSuggestionIds, numberingIdsElsewhere, restagesSuggestions }: ApplyFolioDocumentOperationsInPackageOptions) => FolioDocumentOperationResult;
 export {};

package/dist/document-operations.js

@@ -1,6 +1,7 @@
-import { applyFolioAIEditOperations, previewFolioAIEditOperationsWithResult } from "./ai-edits/apply.js";
+import { applyFolioAIEditOperationsInPackage, previewFolioAIEditOperationsWithResult } from "./ai-edits/apply.js";
 import { describeModelError, findIntroducedModelErrors } from "./ai-edits/result-validation.js";
 import { LIST_KINDS } from "./docx/listNumberingInstances.js";
+import { NO_NUMBERING_IDS_IN_USE } from "./docx/numberingIds.js";
 import { getSuggestions } from "./prosemirror/commands/comments.js";
 import { completeNumberingForDoc } from "./prosemirror/listInstanceReferences.js";
 import { outlineLevelFromAttrValue } from "./prosemirror/outlineLevelAttr.js";
@@ -1290,7 +1291,12 @@ const inOperationOrder = (operations, skipped) => {
 	const indexById = new Map(operations.map(({ id }, index) => [id, index]));
 	return [...skipped].sort((left, right) => (indexById.get(left.id) ?? -1) - (indexById.get(right.id) ?? -1));
 };
-const applyFolioDocumentOperations = ({ view, snapshot, batch, story = "main", author, createCommentId, createUndoHandle, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedReferences, pendingSuggestionIds, restagesSuggestions }) => {
+const applyFolioDocumentOperations = (input) => applyFolioDocumentOperationsInPackage({
+	...input,
+	numberingIdsElsewhere: NO_NUMBERING_IDS_IN_USE
+});
+/** {@link applyFolioDocumentOperations} for a caller holding every story. Internal. */
+const applyFolioDocumentOperationsInPackage = ({ view, snapshot, batch, story = "main", author, createCommentId, createUndoHandle, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedReferences, pendingSuggestionIds, numberingIdsElsewhere, restagesSuggestions }) => {
 	const validatedBatch = parseFolioDocumentOperationBatch(batch);
 	const parsedBatch = restagesSuggestions === true ? validatedBatch : withDistinctSuggestionIds(validatedBatch, /* @__PURE__ */ new Set([...getSuggestions(view.state).map(({ suggestionId }) => suggestionId), ...pendingSuggestionIds ?? []]));
 	const isAtomic = parsedBatch.atomic === true;
@@ -1306,6 +1312,7 @@ const applyFolioDocumentOperations = ({ view, snapshot, batch, story = "main", a
 			...wordDiff !== void 0 && { wordDiff },
 			...tableTemplates !== void 0 && { tableTemplates },
 			...replacementBackground !== void 0 && { replacementBackground },
+			numberingIdsElsewhere,
 			undefinedReferences
 		};
 		if (preview) return {
@@ -1319,7 +1326,7 @@ const applyFolioDocumentOperations = ({ view, snapshot, batch, story = "main", a
 		const held = {};
 		const commentIds = [];
 		return {
-			outcome: applyFolioAIEditOperations({
+			outcome: applyFolioAIEditOperationsInPackage({
 				...common,
 				view: {
 					state: view.state,
@@ -1510,4 +1517,4 @@ const applyFolioDocumentOperations = ({ view, snapshot, batch, story = "main", a
 		undoHandle: result.applied.length > 0 && createUndoHandle !== void 0 ? createUndoHandle() : null
 	};
 };
-export { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PAGE_BREAK_CLEAR_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOperationReceiptsForStory, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch };
+export { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PAGE_BREAK_CLEAR_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, applyFolioDocumentOperationsInPackage, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOperationReceiptsForStory, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch };

package/dist/docx/listNumberingInstances.d.ts

@@ -1,3 +1,4 @@
+import { NumberingIdsInUse } from "./numberingIds.js";
 import { document_d_exports } from "../types/document.js";
 /** The two kinds of list a command can create. */
 export declare const LIST_KINDS: readonly ["bullet", "numbered"];
@@ -23,10 +24,11 @@ type MintedListInstance = {
 /**
  * Define a new list: a new `w:abstractNum` of the requested kind and the
  * `w:num` naming it. `definitions` must already hold every instance the
- * document references (see {@link completeListNumbering}), so the new ids
- * collide with none of them.
+ * story references (see {@link completeListNumbering}), and `elsewhere` the
+ * ids the package's other stories define, so the new ids collide with none of
+ * them.
  */
-export declare const mintListInstance: (definitions: document_d_exports.NumberingDefinitions | null | undefined, { kind, format, start }: NewListDefinition) => MintedListInstance;
+export declare const mintListInstance: (definitions: document_d_exports.NumberingDefinitions | null | undefined, { kind, format, start }: NewListDefinition, elsewhere: NumberingIdsInUse) => MintedListInstance;
 type RestartListInstanceOptions = {
   abstractNumId: number;
   ilvl: number;
@@ -38,7 +40,7 @@ type RestartListInstanceOptions = {
  * makes a consumer count the instance on its own rather than continue the
  * other instances of the same definition.
  */
-export declare const restartListInstance: (definitions: document_d_exports.NumberingDefinitions | null | undefined, { abstractNumId, ilvl, start }: RestartListInstanceOptions) => MintedListInstance;
+export declare const restartListInstance: (definitions: document_d_exports.NumberingDefinitions | null | undefined, { abstractNumId, ilvl, start }: RestartListInstanceOptions, elsewhere: NumberingIdsInUse) => MintedListInstance;
 /** One paragraph's numbering reference and the rendering it resolved to. */
 export type ListInstanceReference = {
   numId: number;

package/dist/docx/listNumberingInstances.js

@@ -117,25 +117,26 @@ const EMPTY_DEFINITIONS = {
 	nums: []
 };
 /** A fresh `w:numId` for `definitions`; zero is reserved for "no numbering". */
-const nextNumId = (definitions) => mintNumberingId({
+const nextNumId = (definitions, elsewhere) => mintNumberingId({
 	kind: "num",
-	existingIds: (definitions?.nums ?? []).map(({ numId }) => numId)
+	existingIds: [...(definitions?.nums ?? []).map(({ numId }) => numId), ...elsewhere.numIds]
 });
 /** A fresh `w:abstractNumId` for `definitions`. */
-const nextAbstractNumId = (definitions) => mintNumberingId({
+const nextAbstractNumId = (definitions, elsewhere) => mintNumberingId({
 	kind: "abstract",
-	existingIds: (definitions?.abstractNums ?? []).map(({ abstractNumId }) => abstractNumId)
+	existingIds: [...(definitions?.abstractNums ?? []).map(({ abstractNumId }) => abstractNumId), ...elsewhere.abstractNumIds]
 });
 /**
 * Define a new list: a new `w:abstractNum` of the requested kind and the
 * `w:num` naming it. `definitions` must already hold every instance the
-* document references (see {@link completeListNumbering}), so the new ids
-* collide with none of them.
+* story references (see {@link completeListNumbering}), and `elsewhere` the
+* ids the package's other stories define, so the new ids collide with none of
+* them.
 */
-const mintListInstance = (definitions, { kind, format, start }) => {
+const mintListInstance = (definitions, { kind, format, start }, elsewhere) => {
 	const current = definitions ?? EMPTY_DEFINITIONS;
-	const numId = nextNumId(current);
-	const abstractNumId = nextAbstractNumId(current);
+	const numId = nextNumId(current, elsewhere);
+	const abstractNumId = nextAbstractNumId(current, elsewhere);
 	const levelOverrides = levelZeroStart(start);
 	const instance = {
 		numId,
@@ -161,9 +162,9 @@ const mintListInstance = (definitions, { kind, format, start }) => {
 * makes a consumer count the instance on its own rather than continue the
 * other instances of the same definition.
 */
-const restartListInstance = (definitions, { abstractNumId, ilvl, start }) => {
+const restartListInstance = (definitions, { abstractNumId, ilvl, start }, elsewhere) => {
 	const current = definitions ?? EMPTY_DEFINITIONS;
-	const numId = nextNumId(current);
+	const numId = nextNumId(current, elsewhere);
 	const instance = {
 		numId,
 		abstractNumId,

package/dist/docx/numberingIds.d.ts

@@ -1,4 +1,14 @@
 type NumberingKind = "num" | "abstract";
+/**
+ * Numbering ids (`w:num`, `w:abstractNum`) defined outside the numbering a
+ * caller allocates against: the lists the package's other stories define. The
+ * ids are package-wide, so a list minted in one story takes none of them.
+ */
+export type NumberingIdsInUse = {
+  numIds: ReadonlySet<number>;
+  abstractNumIds: ReadonlySet<number>;
+};
+export declare const NO_NUMBERING_IDS_IN_USE: NumberingIdsInUse;
 type MintNumberingIdOptions = {
   kind: NumberingKind;
   existingIds: Iterable<number>;

package/dist/docx/numberingIds.js

@@ -1,5 +1,9 @@
 import { createNumericIdAllocator } from "./numericIdAllocator.js";
 // src/docx/numberingIds.ts
+const NO_NUMBERING_IDS_IN_USE = {
+	numIds: /* @__PURE__ */ new Set(),
+	abstractNumIds: /* @__PURE__ */ new Set()
+};
 /** Independent offline packages can allocate deterministically without retaining realm state. */
 const createNumberingIdAllocator = (kind, existingIds) => {
 	const allocator = createNumericIdAllocator({
@@ -12,4 +16,4 @@ const createNumberingIdAllocator = (kind, existingIds) => {
 const mintNumberingId = ({ kind, existingIds }) => {
 	return createNumberingIdAllocator(kind, existingIds).next();
 };
-export { createNumberingIdAllocator, mintNumberingId };
+export { NO_NUMBERING_IDS_IN_USE, createNumberingIdAllocator, mintNumberingId };

package/dist/docx/paragraphParser.js

@@ -168,6 +168,19 @@ function paragraphStartsWithRenderedPageBreak(node) {
 	if (outcome === "forced") return sawRenderedPageBreak;
 	return outcome === "visible" && sawRenderedPageBreak;
 }
+/**
+* How each revision's content is read. A deletion's runs spell their text
+* `w:delText` (ISO/IEC 29500-1 §17.3.3.7), read here as the text it stands
+* for. A move source's runs spell it `w:t` (§17.13.5.22), which that reading
+* leaves as it is; it also accepts the `w:delText` some writers put there, so
+* both spellings give the same model, which the serializer writes as `w:t`.
+*/
+const TRACKED_CHANGE_PARSE_CONTEXT = {
+	insertion: "default",
+	deletion: "deletion",
+	moveFrom: "deletion",
+	moveTo: "default"
+};
 function replaceLocalName(name, localName) {
 	if (!name) return `w:${localName}`;
 	const colonIndex = name.indexOf(":");
@@ -405,7 +418,7 @@ const linkedRevisionContent = (wrapped, linkOver) => {
 	return content;
 };
 const hoistRevision = (wrapper) => (child, { styles, theme, rels, media, previews, inScopeXmlns, items, linkOver }) => {
-	const wrapped = parseParagraphContents(child, styles, theme, null, rels, media, previews, wrapper === "deletion" || wrapper === "moveFrom" ? "deletion" : "default", inScopeXmlns, "hyperlink");
+	const wrapped = parseParagraphContents(child, styles, theme, null, rels, media, previews, TRACKED_CHANGE_PARSE_CONTEXT[wrapper], inScopeXmlns, "hyperlink");
 	const content = linkedRevisionContent(wrapped, linkOver);
 	items.push({
 		type: "hoistedRevision",
@@ -537,7 +550,7 @@ const fieldInlineWrapper = (element) => (child, context) => {
 };
 /** Read a field's revision with the same ownership rules as a paragraph revision. */
 const fieldTrackedChange = (type) => (child, { push, styles, theme, rels, media, previews, inScopeXmlns }) => {
-	const parsedContent = parseParagraphContents(child, styles, theme, null, rels, media, previews, type === "deletion" || type === "moveFrom" ? "deletion" : "default", inScopeXmlns);
+	const parsedContent = parseParagraphContents(child, styles, theme, null, rels, media, previews, TRACKED_CHANGE_PARSE_CONTEXT[type], inScopeXmlns);
 	if (parsedContent.length === 0 || !parsedContent.every(isTrackedChangeWrapperChild)) {
 		push(preserveInlineChild(child));
 		return;
@@ -901,7 +914,7 @@ const PARAGRAPH_CONTENT_UNDECLARED_NAMESPACES = { [OMML_NAMESPACE]: (child, { co
 /** All revision wrappers retain typed review ownership while parsing their children. */
 const trackedParagraphRevision = (type) => (child, { contents, styles, theme, rels, media, previews, inScopeXmlns, inlineScope }) => {
 	const resolutionJoins = parseResolutionJoins(child);
-	const parsedContent = parseParagraphContents(child, styles, theme, null, rels, media, previews, type === "deletion" || type === "moveFrom" ? "deletion" : "default", inScopeXmlns, inlineScope);
+	const parsedContent = parseParagraphContents(child, styles, theme, null, rels, media, previews, TRACKED_CHANGE_PARSE_CONTEXT[type], inScopeXmlns, inlineScope);
 	pushTrackedChangeSegments({
 		contents,
 		type,

package/dist/docx/paragraphProperties.js

@@ -1,3 +1,4 @@
+import { hangingFirstLineIndent } from "../utils/units.js";
 import { readAttributeBag } from "./attributeRemainder.js";
 import { parseBorderSpec } from "./borderParser.js";
 import { CAPTURE, dispatchChildrenWithContext, ownedElsewhere, sequencePositions } from "./containerChildren.js";
@@ -296,7 +297,7 @@ const readParagraphIndentation = (ind, formatting) => {
 	if (firstLine !== void 0) formatting.indentFirstLine = firstLine;
 	const hanging = parseNumericAttribute(ind, "w", "hanging");
 	if (hanging !== void 0) {
-		formatting.indentFirstLine = -hanging;
+		formatting.indentFirstLine = hangingFirstLineIndent(hanging);
 		formatting.hangingIndent = true;
 	}
 	if (!(left !== void 0 || right !== void 0 || firstLine !== void 0 || hanging !== void 0)) return false;