superdoc 2.22.0-next.9 → 2.22.1-next.1

package/dist/chunks/{create-super-doc-ui-Dos1KQcL.es.js → create-super-doc-ui-DmGX1w-i.es.js}

@@ -3992,6 +3992,65 @@ var INCREMENTAL_DEPENDENCY_CERTIFICATE_CLASSES = Object.freeze([
 ]);
 new Set(INCREMENTAL_DEPENDENCY_CERTIFICATE_CLASSES);
 //#endregion
+//#region ../document-api/src/types/story.types.ts
+/** All recognized story types. */
+var STORY_TYPES = [
+	"body",
+	"headerFooterSlot",
+	"headerFooterPart",
+	"footnote",
+	"endnote",
+	"textbox"
+];
+/** Valid header/footer story kinds. */
+var STORY_HEADER_FOOTER_KINDS = ["header", "footer"];
+/** Valid header/footer slot variants. */
+var STORY_HEADER_FOOTER_VARIANTS = [
+	"default",
+	"first",
+	"even"
+];
+/** Valid header/footer slot resolution modes. */
+var STORY_HEADER_FOOTER_RESOLUTIONS = ["effective", "explicit"];
+/** Valid header/footer slot write modes. */
+var STORY_HEADER_FOOTER_ON_WRITE_VALUES = [
+	"materializeIfInherited",
+	"editResolvedPart",
+	"error"
+];
+/**
+* Type guard: returns `true` if `value` is a valid {@link StoryLocator}.
+*
+* Checks the full discriminated-union shape so malformed partial locators do
+* not leak through validation and fail later with raw property-access errors.
+*/
+function isStoryLocator(value) {
+	if (!isObjectRecord(value) || value.kind !== "story" || !isStringEnumMember(value.storyType, STORY_TYPES)) return false;
+	switch (value.storyType) {
+		case "body": return true;
+		case "headerFooterSlot": return isSectionAddress(value.section) && isStringEnumMember(value.headerFooterKind, STORY_HEADER_FOOTER_KINDS) && isStringEnumMember(value.variant, STORY_HEADER_FOOTER_VARIANTS) && isOptionalStringEnumMember(value.resolution, STORY_HEADER_FOOTER_RESOLUTIONS) && isOptionalStringEnumMember(value.onWrite, STORY_HEADER_FOOTER_ON_WRITE_VALUES);
+		case "headerFooterPart": return isNonEmptyString(value.refId);
+		case "footnote":
+		case "endnote": return isNonEmptyString(value.noteId);
+		case "textbox": return isNonEmptyString(value.textboxId);
+	}
+}
+function isObjectRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function isNonEmptyString(value) {
+	return typeof value === "string" && value.length > 0;
+}
+function isStringEnumMember(value, allowed) {
+	return typeof value === "string" && allowed.includes(value);
+}
+function isOptionalStringEnumMember(value, allowed) {
+	return value === void 0 || isStringEnumMember(value, allowed);
+}
+function isSectionAddress(value) {
+	return isObjectRecord(value) && value.kind === "section" && typeof value.sectionId === "string" && value.sectionId.length > 0;
+}
+//#endregion
 //#region ../document-api/src/format/inline-run-patch.ts
 var schemaBooleanOrNull = () => ({ oneOf: [{ type: "boolean" }, { type: "null" }] });
 var schemaStringOrNull = () => ({ oneOf: [{
@@ -5702,6 +5761,13 @@ function selectionTargetFromTextTarget(target) {
 		...story ? { story } : {}
 	};
 }
+function capturedTableCellTarget(value) {
+	if (!value || typeof value !== "object") return null;
+	const target = value;
+	if (target.kind !== "selection" || target.coordinateSpace !== void 0 && target.coordinateSpace !== "visible" && target.coordinateSpace !== "tracked" || target.story !== void 0 && !isStoryLocator(target.story)) return null;
+	for (const point of [target.start, target.end]) if (!point || point.kind !== "text" || typeof point.blockId !== "string" || point.blockId.length === 0 || !Number.isInteger(point.offset) || point.offset < 0 || point.story !== void 0 && !isStoryLocator(point.story)) return null;
+	return value;
+}
 function selectionTargetForRestore(capture) {
 	if (capture.selectionTarget) return capture.selectionTarget;
 	return selectionTargetFromTextTarget(capture.target);
@@ -7041,11 +7107,11 @@ function createSuperDocUI(options) {
 	};
 	const selectionScopedAsyncReadKeys = (selection) => {
 		const signature = selectionSignature(selection);
-		const effectiveUniformitySignature = selectionEffectiveUniformitySignature(selection);
+		const effectiveUniformityKey = effectiveInlineUniformityCacheKey(selection);
 		return /* @__PURE__ */ new Set([
 			`contentControls:inRange:${signature}`,
 			`query:${signature}`,
-			...effectiveUniformitySignature ? [`effInline:${effectiveUniformitySignature}`] : []
+			...effectiveUniformityKey ? [effectiveUniformityKey] : []
 		]);
 	};
 	const pruneSelectionScopedAsyncReads = (selection) => {
@@ -7939,7 +8005,7 @@ function createSuperDocUI(options) {
 		if (!sawWholeRun) return {};
 		return collapseMarkSets(wholeSets);
 	};
-	const completeProjectedInlineValues = (selection, direct) => {
+	const completeProjectedInlineValues = (selection, direct, effectiveInput = effectiveInlineUniformityInput(selection)) => {
 		if (direct.fontFamily !== void 0 && direct.fontSize !== void 0 && direct.color !== void 0 && direct.highlight !== void 0) return {
 			values: direct,
 			effectiveUniformityStatus: "ready"
@@ -7953,7 +8019,7 @@ function createSuperDocUI(options) {
 			...direct
 		};
 		if (!selection.empty && (combined.fontFamily === void 0 || combined.fontSize === void 0)) {
-			const uniformity = resolveEffectiveInlineUniformityValues(selection);
+			const uniformity = resolveEffectiveInlineUniformityValues(selection, effectiveInput);
 			if (uniformity.values) {
 				if (combined.fontFamily === void 0 && uniformity.values.fontFamily !== void 0) combined.fontFamily = uniformity.values.fontFamily;
 				if (combined.fontSize === void 0 && uniformity.values.fontSize !== void 0) combined.fontSize = uniformity.values.fontSize;
@@ -7983,9 +8049,23 @@ function createSuperDocUI(options) {
 		"underline",
 		"strikethrough"
 	];
-	const readEffectiveInlineUniformityCached = (selection) => {
-		const target = selection.selectionTarget;
-		if (!target) return {
+	function effectiveInlineUniformityInput(selection) {
+		const cellTarget = currentCellSelectionTarget();
+		const target = cellTarget ?? selection.selectionTarget;
+		if (!target) return null;
+		const tableCellSelection = cellTarget ? tableCellSelectionForTarget(cellTarget) : null;
+		return {
+			target,
+			offsetSpace: "selection",
+			...tableCellSelection ? { tableCellSelection } : {}
+		};
+	}
+	function effectiveInlineUniformityCacheKey(selection, input = effectiveInlineUniformityInput(selection)) {
+		if (!input) return null;
+		return `effInline:${input.tableCellSelection ? `${selectionKey({ selectionTarget: input.target })}|cells:${JSON.stringify(input.tableCellSelection)}` : selectionEffectiveUniformitySignature(selection) ?? selectionSignature(selection)}`;
+	}
+	const readEffectiveInlineUniformityCached = (selection, input = effectiveInlineUniformityInput(selection)) => {
+		if (!input) return {
 			value: null,
 			status: "ready"
 		};
@@ -7994,15 +8074,13 @@ function createSuperDocUI(options) {
 			value: null,
 			status: "ready"
 		};
-		const signature = selectionEffectiveUniformitySignature(selection) ?? selectionSignature(selection);
-		return readAsync(`effInline:${signature}`, contentToken(), () => op({
-			target,
-			offsetSpace: "selection",
+		return readAsync(effectiveInlineUniformityCacheKey(selection, input), contentToken(), () => op({
+			...input,
 			keys: EFFECTIVE_INLINE_UNIFORMITY_KEYS
 		}), (raw) => raw && typeof raw === "object" ? raw : null);
 	};
-	const resolveEffectiveInlineUniformityValues = (selection) => {
-		const { value, status } = readEffectiveInlineUniformityCached(selection);
+	const resolveEffectiveInlineUniformityValues = (selection, input = effectiveInlineUniformityInput(selection)) => {
+		const { value, status } = readEffectiveInlineUniformityCached(selection, input);
 		if (!value || value.success !== true) return {
 			values: null,
 			status
@@ -8056,16 +8134,12 @@ function createSuperDocUI(options) {
 		const fromWorker = values?.[key];
 		return fromWorker !== void 0 ? fromWorker : null;
 	};
-	const readEffectiveInlineUniformityNow = async (selection) => {
-		const target = selection.selectionTarget;
-		if (!target) return null;
+	const readEffectiveInlineUniformityNow = async (input) => {
+		if (!input) return null;
 		const op = resolveDocOperation(getDoc(), "format.readEffectiveInlineUniformity");
 		if (!op) return null;
 		try {
-			const raw = await Promise.resolve(op({
-				target,
-				offsetSpace: "selection"
-			}));
+			const raw = await Promise.resolve(op(input));
 			return raw && typeof raw === "object" && raw.success === true ? raw : null;
 		} catch {
 			return null;
@@ -8080,8 +8154,8 @@ function createSuperDocUI(options) {
 			else delete projected[key];
 		}
 	};
-	const projectSelectionInlineValuesWithStatus = (selection) => completeProjectedInlineValues(selection, projectInlineValuesFromQueryItem(resolveSelectionTextQueryItem(selection), selection));
-	const projectSelectionInlineValues = (selection) => projectSelectionInlineValuesWithStatus(selection).values;
+	const projectSelectionInlineValuesWithStatus = (selection, effectiveInput = effectiveInlineUniformityInput(selection)) => completeProjectedInlineValues(selection, projectInlineValuesFromQueryItem(resolveSelectionTextQueryItem(selection), selection), effectiveInput);
+	const projectSelectionInlineValues = (selection, effectiveInput = effectiveInlineUniformityInput(selection)) => projectSelectionInlineValuesWithStatus(selection, effectiveInput).values;
 	/**
 	* Read command-critical inline values for format-painter capture. Reactive
 	* command state intentionally serves stale values while its worker read is
@@ -8090,20 +8164,21 @@ function createSuperDocUI(options) {
 	* without changing the non-blocking toolbar snapshot policy.
 	*/
 	const readFormatPainterInlineValues = async (selection) => {
+		const effectiveInput = effectiveInlineUniformityInput(selection);
 		const query = getDoc()?.query;
 		const request = selectionTextQueryRequest(selection);
-		if (typeof query?.match !== "function" || !request) return projectSelectionInlineValues(selection);
+		if (typeof query?.match !== "function" || !request) return projectSelectionInlineValues(selection, effectiveInput);
 		try {
 			const raw = await Promise.resolve(query.match(request));
 			const direct = projectInlineValuesFromQueryItem(pickSelectionTextQueryItem(raw && typeof raw === "object" ? raw : null, selection), selection);
-			const completed = completeProjectedInlineValues(selection, direct);
+			const completed = completeProjectedInlineValues(selection, direct, effectiveInput);
 			if (completed.effectiveUniformityStatus !== "ready" && (direct.fontFamily === void 0 || direct.fontSize === void 0)) {
-				const effective = await readEffectiveInlineUniformityNow(selection);
+				const effective = await readEffectiveInlineUniformityNow(effectiveInput);
 				if (effective) applyEffectiveInlineUniformity(completed.values, direct, effective);
 			}
 			return completed.values;
 		} catch {
-			return projectSelectionInlineValues(selection);
+			return projectSelectionInlineValues(selection, effectiveInput);
 		}
 	};
 	const readBlockNode = async (address) => {
@@ -8346,7 +8421,7 @@ function createSuperDocUI(options) {
 				supported: true,
 				reason: lockReason
 			}, "builtin");
-			const enabled = selectionBlockIds(selection).length > 0 || resolveInlineSelectionTarget(selection) != null;
+			const enabled = selectionBlockIds(selection).length > 0 || resolveInlineCommandTarget(selection) != null;
 			return normalizeCommandState({
 				enabled,
 				active: false,
@@ -8400,7 +8475,7 @@ function createSuperDocUI(options) {
 			value,
 			reason: SUPERDOC_UI_REASONS.documentReadonly
 		}, "builtin");
-		if (descriptor.inline && !resolveInlineSelectionTarget(selection)) {
+		if (descriptor.inline && !resolveInlineCommandTarget(selection)) {
 			const lockReason = contentControlLockReason(lockModesById);
 			if (lockReason) return normalizeCommandState({
 				enabled: false,
@@ -10355,9 +10430,32 @@ function createSuperDocUI(options) {
 	* option is not part of public `MutationOptions`; this is the same cast
 	* pattern the delete/replace callers use.
 	*/
-	const callInlineFormatMutation = (route, op, input, selection = state.selection) => {
+	function currentCellSelectionTarget() {
+		const handles = safeCall(() => getHost()?.getHandles?.(), null);
+		if (!(handles?.selection?.getSnapshot?.())?.tableCells) return null;
+		const resolved = handles?.selection?.toSelectionTarget?.();
+		return resolved?.kind === "ok" && resolved.mode === "range" ? capturedTableCellTarget(resolved.target) : null;
+	}
+	function resolveInlineCommandTarget(selection) {
+		return currentCellSelectionTarget() ?? resolveInlineSelectionTarget(selection);
+	}
+	function tableCellSelectionForTarget(target) {
+		const cellTarget = currentCellSelectionTarget();
+		const candidate = target;
+		if (!cellTarget || candidate?.start?.blockId !== cellTarget.start.blockId || candidate?.end?.blockId !== cellTarget.end.blockId || candidate?.start?.offset !== cellTarget.start.offset || candidate?.end?.offset !== cellTarget.end.offset) return null;
+		return {
+			anchorBlockId: cellTarget.start.blockId,
+			focusBlockId: cellTarget.end.blockId
+		};
+	}
+	const callInlineFormatMutation = (route, op, input, selection = state.selection, tableCellSelection = tableCellSelectionForTarget(input?.target)) => {
 		const options = editorMutationOptionsForRoute(route);
 		if (options && options.success === false) return options;
+		if (tableCellSelection) return op(input, {
+			...options,
+			offsetSpace: "selection",
+			tableCellSelection
+		});
 		if (!selection.selectionTarget) return options ? op(input, options) : op(input);
 		return op(input, {
 			...options,
@@ -10463,7 +10561,7 @@ function createSuperDocUI(options) {
 			}
 		};
 		const defaultStyleId = getStyleCatalog().cache?.full.defaults.paragraphStyleId ?? DEFAULT_PARAGRAPH_STYLE_ID;
-		const rangeTarget = resolveInlineSelectionTarget(state.selection);
+		const rangeTarget = resolveInlineCommandTarget(state.selection);
 		if (rangeTarget) {
 			const inlineOp = resolveDocOperation(doc, "format.apply");
 			if (inlineOp) try {
@@ -11060,8 +11158,8 @@ function createSuperDocUI(options) {
 		if (state.selection.status !== "ready") return false;
 		if (trackDecisionCommand(id)?.scope === "id") return true;
 		if (!descriptor || descriptor.disposition !== "routed") return true;
-		if (descriptor.inline?.kind === "clear") return selectionBlockIds(state.selection).length > 0 || resolveInlineSelectionTarget(state.selection) != null;
-		if (descriptor.inline) return resolveInlineSelectionTarget(state.selection) != null || canStorePendingInlineFormat(state.selection);
+		if (descriptor.inline?.kind === "clear") return selectionBlockIds(state.selection).length > 0 || resolveInlineCommandTarget(state.selection) != null;
+		if (descriptor.inline) return resolveInlineCommandTarget(state.selection) != null || canStorePendingInlineFormat(state.selection);
 		if (descriptor.blockParagraph || descriptor.list) return selectionBlockIds(state.selection).length > 0;
 		if (descriptor.link) return linkPayloadHasExplicitTarget(payload) || selectionTextAddresses(state.selection).length > 0 || collapsedTextAddressFromSelection(state.selection) != null || commandActiveState(descriptor, getDoc(), state.selection);
 		return true;
@@ -11125,7 +11223,7 @@ function createSuperDocUI(options) {
 		if (descriptor.inline) {
 			const { lockModesById } = computeActiveContentControlLockModes(doc?.contentControls, state.selection);
 			if (contentControlLockReason(lockModesById)) return false;
-			const target = resolveInlineSelectionTarget(state.selection);
+			const target = resolveInlineCommandTarget(state.selection);
 			if (!target) {
 				if (!canStorePendingInlineFormat(state.selection)) return settleCommandExecution(false);
 				return settleCommandExecution(storePendingInlineFormat(descriptor, normalized));
@@ -11133,6 +11231,8 @@ function createSuperDocUI(options) {
 			const active = commandActiveState(descriptor, doc, state.selection);
 			const input = buildInlineFormatInput(descriptor.inline, target, normalized, active);
 			if (!input) return false;
+			const commandSelection = state.selection;
+			const tableCellSelection = tableCellSelectionForTarget(target);
 			let releaseScheduledMutation = null;
 			try {
 				const commandEditor = getEditor();
@@ -11140,7 +11240,7 @@ function createSuperDocUI(options) {
 				const commandMode = readDocumentMode();
 				const mutate = () => {
 					if (getEditor() !== commandEditor || commandEditor?.doc !== commandDocSource || readDocumentMode() !== commandMode) return false;
-					return callInlineFormatMutation(route, op, input);
+					return callInlineFormatMutation(route, op, input, commandSelection, tableCellSelection);
 				};
 				const selectionSignature = selectionInlineValueSignature(state.selection) ?? selectionKey(state.selection);
 				const scheduledMutation = descriptor.inline.kind === "toggle" ? scheduleInlineToggleMutation(`${descriptor.id}:${selectionSignature}`, mutate) : null;
@@ -11451,34 +11551,42 @@ function createSuperDocUI(options) {
 		if (painter.pointerSelecting || painter.keyboardSelecting) return;
 		const selectionApi = getDoc()?.selection;
 		const readSelection = async () => {
+			const cellTarget = currentCellSelectionTarget();
+			const tableCellSelection = tableCellSelectionForTarget(cellTarget);
 			const rawSelection = typeof selectionApi?.["current"] === "function" ? await Promise.resolve(selectionApi["current"]({ includeText: true })) : readSelectionInfoLive().value;
-			return normalizeSelectionInfo(rawSelection);
+			return {
+				selection: normalizeSelectionInfo(rawSelection),
+				cellTarget,
+				tableCellSelection
+			};
 		};
 		const waitForSelectionSettle = () => new Promise((resolve) => setTimeout(resolve, 16));
 		const MAX_SELECTION_ATTEMPTS = 8;
-		let sel = null;
+		let selectionRead = null;
 		let key = "";
 		for (let attempt = 0; attempt < MAX_SELECTION_ATTEMPTS; attempt += 1) {
 			if (attempt > 0) await waitForSelectionSettle();
 			if (painter.mode === "idle" || painter.pointerSelecting || painter.keyboardSelecting) return;
-			sel = await readSelection();
+			selectionRead = await readSelection();
+			const sel = selectionRead.selection;
 			if (!sel || sel["empty"]) continue;
 			key = selectionKey(sel);
 			if (key === painter.sourceSelectionKey) continue;
 			break;
 		}
-		if (sel && !sel["empty"] && key !== painter.sourceSelectionKey) {
-			await applyFormatPainter(sel);
+		if (selectionRead?.selection && !selectionRead.selection["empty"] && key !== painter.sourceSelectionKey) {
+			await applyFormatPainter(selectionRead.selection, selectionRead.cellTarget, selectionRead.tableCellSelection);
 			return;
 		}
 		if (painter.snapshot?.paragraph) {
-			const caretSel = await readSelection();
+			const caretRead = await readSelection();
+			const caretSel = caretRead.selection;
 			if (!caretSel) return;
 			if (selectionKey(caretSel) === painter.sourceSelectionKey) return;
-			await applyFormatPainter(caretSel);
+			await applyFormatPainter(caretSel, caretRead.cellTarget, caretRead.tableCellSelection);
 		}
 	};
-	const applyFormatPainter = async (selection) => {
+	const applyFormatPainter = async (selection, cellTarget, tableCellSelection) => {
 		const snap = painter.snapshot;
 		if (!snap) {
 			if (painter.mode === "armed") exitFormatPainter();
@@ -11493,14 +11601,14 @@ function createSuperDocUI(options) {
 			return;
 		}
 		const selTarget = selection["target"];
-		const selectionTarget = selection["selectionTarget"];
+		const selectionTarget = cellTarget ?? selection.selectionTarget;
 		if (!(selection["empty"] === true) && Object.keys(snap.inline).length > 0) {
 			const inlineOp = resolveDocOperation(doc, "format.apply");
 			if (inlineOp && selectionTarget) try {
 				if (!commandResultSucceeded(commandResultFromOperationResult(await Promise.resolve(callInlineFormatMutation("format.apply", inlineOp, {
 					target: selectionTarget,
 					inline: snap.inline
-				}, selection))))) {
+				}, selection, tableCellSelection))))) {
 					recompute();
 					return;
 				}
@@ -11689,10 +11797,13 @@ function createSuperDocUI(options) {
 		current: () => readSelectionInfoLive().value,
 		capture: () => {
 			const snapshot = selectionSub.get();
-			if (snapshot.empty || !snapshot.target && !snapshot.selectionTarget) return null;
+			if (snapshot.empty) return null;
+			const cells = currentCellSelectionTarget();
+			if (!snapshot.target && !snapshot.selectionTarget && !cells) return null;
 			return {
 				...snapshot,
-				capturedAt: Date.now()
+				capturedAt: Date.now(),
+				...cells ? { _tableCellSelectionTarget: cells } : {}
 			};
 		},
 		restore: (capture) => {
@@ -11711,7 +11822,13 @@ function createSuperDocUI(options) {
 				ok: false,
 				reason: SUPERDOC_UI_REASONS.notReady
 			});
-			const target = selectionTargetForRestore(capture);
+			const hasCellTarget = "_tableCellSelectionTarget" in capture;
+			const cellTarget = hasCellTarget ? capturedTableCellTarget(capture._tableCellSelectionTarget) : null;
+			if (hasCellTarget && !cellTarget) return done({
+				ok: false,
+				reason: SUPERDOC_UI_REASONS.targetUnresolved
+			});
+			const target = cellTarget ?? selectionTargetForRestore(capture);
 			if (!target) return done({
 				ok: false,
 				reason: SUPERDOC_UI_REASONS.targetUnresolved
@@ -11722,7 +11839,7 @@ function createSuperDocUI(options) {
 				reason: resolved.reason
 			});
 			try {
-				return done(normalizeHostSelectionApplyResult(resolved.helper.apply(target)));
+				return done(normalizeHostSelectionApplyResult(cellTarget ? resolved.helper.apply(target, { tableCells: true }) : resolved.helper.apply(target)));
 			} catch {
 				return done({
 					ok: false,