superdoc 2.27.0-next.2 → 2.27.0-next.3

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.27.0-next.2",
+	superdocVersion: "2.27.0-next.3",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.27.0-next.2",
+	superdocVersion: "2.27.0-next.3",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/index.d.ts

@@ -169,7 +169,7 @@ export type { ParagraphsAdapter, ParagraphFormatApi, ParagraphStylesApi } from '
 export type { ParagraphTarget, ParagraphBlockType, ParagraphMutationResult, ParagraphMutationSuccess, ParagraphMutationFailure, MutationResolution, ParagraphAlignment, TabStopAlignment, TabStopLeader, BorderSide, ClearBorderSide, LineRule, ParagraphsSetStyleInput, ParagraphSemanticStyleRole, ParagraphsSetStyleRefInput, ParagraphsClearStyleInput, ParagraphsResetDirectFormattingInput, ParagraphsSetAlignmentInput, ParagraphsClearAlignmentInput, ParagraphsSetIndentationInput, ParagraphsClearIndentationInput, ParagraphsSetSpacingInput, ParagraphsClearSpacingInput, ParagraphsSetKeepOptionsInput, ParagraphsSetOutlineLevelInput, ParagraphsSetFlowOptionsInput, ParagraphsSetTabStopInput, ParagraphsClearTabStopInput, ParagraphsClearAllTabStopsInput, ParagraphsSetBorderInput, ParagraphsClearBorderInput, ParagraphsSetShadingInput, ParagraphsClearShadingInput, ParagraphsSetMarkRunPropsInput, ParagraphsSetDirectionInput, ParagraphsClearDirectionInput, ParagraphsSetNumberingInput, ParagraphDirection, AlignmentPolicy, } from './paragraphs/paragraphs.js';
 export { PARAGRAPH_ALIGNMENTS, TAB_STOP_ALIGNMENTS, TAB_STOP_LEADERS, BORDER_SIDES, CLEAR_BORDER_SIDES, LINE_RULES, PARAGRAPH_DIRECTIONS, ALIGNMENT_POLICIES, } from './paragraphs/paragraphs.js';
 export type { BlockAddress, BlockRange, CanContinueReason, CanJoinReason, JoinDirection, ListInsertInput, ListItemAddress, ListItemInfo, ListKind, ListsAttachInput, ListsCanContinuePreviousInput, ListsCanContinuePreviousResult, ListsCanJoinInput, ListsCanJoinResult, ListsConvertToTextInput, ListsConvertToTextResult, ListsContinuePreviousInput, ListsCreateInput, ListsCreateResult, ListsDetachInput, ListsDetachResult, ListsDeleteInput, ListsDeleteResult, ListsFailureCode, ListsGetInput, ListsInsertResult, ListsJoinInput, ListsJoinResult, ListsListQuery, ListsListResult, ListsMutateItemResult, ListsSeparateInput, ListsSeparateResult, ListsMergeInput, ListsMergeResult, ListsSplitInput, ListsSplitResult, ListsSetLevelInput, ListsSetLevelRestartInput, ListsSetValueInput, ListTargetInput, MutationScope, LevelAlignment, TrailingCharacter, ListPresetId, ListPresetMarker, ListLevelTemplate, ListTemplate, ListsApplyTemplateInput, ListsApplyPresetInput, ListsCaptureTemplateInput, ListsCaptureTemplateResult, ListsCaptureTemplateSuccessResult, ListsSetLevelNumberingInput, ListsSetLevelBulletInput, ListsSetLevelPictureBulletInput, ListsSetLevelAlignmentInput, ListsSetLevelIndentsInput, ListsSetLevelTrailingCharacterInput, ListsSetLevelMarkerFontInput, ListsClearLevelOverridesInput, ListsSetTypeInput, ListStyle, ListLevelStyle, ListLevelLayout, ListsGetStyleInput, ListsGetStyleResult, ListsGetStyleSuccessResult, ListsApplyStyleInput, ListsRestartAtInput, ListsSetLevelNumberStyleInput, ListsSetLevelTextInput, ListsSetLevelStartInput, ListsSetLevelLayoutInput, ListsGetStateInput, ListsGetStateResult, ListsApplyInput, ListsContinueV2Input, ListsRestartV2Input, ListsRemoveV2Input, } from './lists/lists.types.js';
-export { LIST_KINDS, LIST_INSERT_POSITIONS, JOIN_DIRECTIONS, MUTATION_SCOPES, LEVEL_ALIGNMENTS, TRAILING_CHARACTERS, LIST_PRESET_IDS, LIST_PRESET_MARKERS, } from './lists/lists.types.js';
+export { LIST_KINDS, LIST_INSERT_POSITIONS, JOIN_DIRECTIONS, MUTATION_SCOPES, LEVEL_ALIGNMENTS, TRAILING_CHARACTERS, LIST_PRESET_IDS, LIST_PRESET_MARKERS, LIST_CUSTOM_NUMBERING_FORMATS, } from './lists/lists.types.js';
 export type { CreateSectionBreakInput, CreateSectionBreakResult, DocumentMutationResult, SectionAddress, SectionBorderSpec, SectionBreakCreateLocation, SectionBreakRepresentation, SectionBreakType, SectionColumns, SectionDirection, SectionDomain, SectionHeaderFooterKind, SectionHeaderFooterMargins, SectionHeaderFooterRefs, SectionHeaderFooterVariant, SectionInfo, SectionLineNumbering, SectionLineNumberRestart, SectionMutationResult, SectionOrientation, SectionPageBorders, SectionPageMargins, SectionPageNumbering, SectionPageNumberingChapterSeparator, SectionPageNumberingFormat, SectionPageSetup, SectionRangeDomain, SectionTargetInput, SectionVerticalAlign, SectionsClearHeaderFooterRefInput, SectionsClearPageBordersInput, SectionsGetInput, SectionsListQuery, SectionsListResult, SectionsSetBreakTypeInput, SectionsSetColumnsInput, SectionsSetHeaderFooterMarginsInput, SectionsSetHeaderFooterRefInput, SectionsSetLineNumberingInput, SectionsSetLinkToPreviousInput, SectionsSetOddEvenHeadersFootersInput, SectionsSetPageBordersInput, SectionsSetPageMarginsInput, SectionsSetPageNumberingInput, SectionsSetPageSetupInput, SectionsSetSectionDirectionInput, SectionsSetTitlePageInput, SectionsSetVerticalAlignInput, } from './sections/sections.types.js';
 export type { CommentsCreateReceipt, CommentsCreateInput, CommentCreateAttributionInput, CommentsPatchInput, CommentsDeleteInput, CommentsAdapter, CommentsApi, GetCommentInput, TrackedChangeCommentTarget, TrackedChangeCommentTargetSide, TextSearchCommentTarget, AddCommentInput, EditCommentInput, ReplyToCommentInput, MoveCommentInput, ResolveCommentInput, ReopenCommentInput, RemoveCommentInput, SetCommentInternalInput, GoToCommentInput, SetCommentActiveInput, } from './comments/comments.js';
 export { executeCommentsCreate, executeCommentsPatch, executeCommentsDelete, executeGetComment, executeListComments, } from './comments/comments.js';

package/dist/document-api/src/lists/lists.types.d.ts

@@ -206,10 +206,12 @@ export interface ListsConvertToTextInput {
     target: ListItemAddress;
     includeMarker?: boolean;
 }
+export declare const LIST_CUSTOM_NUMBERING_FORMATS: readonly ["01, 02, 03, ...", "001, 002, 003, ...", "0001, 0002, 0003, ..."];
 /** A captured snapshot of one level's formatting properties. */
 export interface ListLevelTemplate {
     level: number;
     numFmt?: string;
+    customFormat?: string;
     lvlText?: string;
     start?: number;
     alignment?: LevelAlignment;
@@ -274,6 +276,7 @@ export interface ListsSetLevelNumberingInput {
     target: ListItemAddress;
     level: number;
     numFmt: string;
+    customFormat?: string;
     lvlText: string;
     start?: number;
     /** Format numeric placeholders as decimal. False removes legal numbering; omit to preserve it. */

package/dist/layout-engine/contracts/src/direction-context.d.ts

@@ -197,8 +197,7 @@ export declare function getParagraphInlineDirection(attrs: {
  *
  * Prefers the resolved {@link TableDirectionContext} when present, falls
  * back to the legacy `tableProperties.rightToLeft` (or `bidiVisual` alias)
- * for compatibility. The AIDEV-NOTE on the fallback branch names the
- * retirement signal.
+ * for compatibility.
  *
  * Per ECMA-376 §17.4.1, `w:bidiVisual` affects only cell ordering and
  * table-visual properties. Cell paragraph inline direction is independent;

package/dist/layout-engine/contracts/src/resolved-layout.d.ts

@@ -111,8 +111,6 @@ export type ResolvedGroupItem = {
 /**
  * A resolved fragment wrapper item.
  * Carries positioning and metadata needed to create the fragment's DOM wrapper.
- * Inner content rendering is delegated to the Fragment-based render path via
- * fragmentIndex; see the compat-fallback note on that field.
  */
 export type ResolvedFragmentItem = {
     kind: 'fragment';
@@ -138,14 +136,6 @@ export type ResolvedFragmentItem = {
     fragment: Fragment;
     /** Block ID. Written to data-block-id. */
     blockId: string;
-    /**
-     * Index back into page.fragments.
-     *
-     * AIDEV-NOTE: compat-fallback. The painter currently reads inner content from
-     * Fragment via this index because ResolvedFragmentItem does not carry full
-     * content yet. Becomes unused once paint items are self-describing; do not
-     * promote this to a permanent API surface.
-     */
     fragmentIndex: number;
     /** ProseMirror start position for click-to-position mapping. */
     pmStart?: number;
@@ -280,14 +270,6 @@ export type ResolvedTableItem = {
     zIndex?: number;
     /** Block ID — written to data-block-id. */
     blockId: string;
-    /**
-     * Index back into page.fragments.
-     *
-     * AIDEV-NOTE: compat-fallback. The painter currently reads inner content from
-     * Fragment via this index because ResolvedFragmentItem does not carry full
-     * content yet. Becomes unused once paint items are self-describing; do not
-     * promote this to a permanent API surface.
-     */
     fragmentIndex: number;
     /** Source TableFragment back-pointer (see ResolvedFragmentItem.fragment). */
     fragment: Fragment;
@@ -357,14 +339,6 @@ export type ResolvedImageItem = {
     zIndex?: number;
     /** Block ID — written to data-block-id. */
     blockId: string;
-    /**
-     * Index back into page.fragments.
-     *
-     * AIDEV-NOTE: compat-fallback. The painter currently reads inner content from
-     * Fragment via this index because ResolvedFragmentItem does not carry full
-     * content yet. Becomes unused once paint items are self-describing; do not
-     * promote this to a permanent API surface.
-     */
     fragmentIndex: number;
     /** Source ImageFragment back-pointer (see ResolvedFragmentItem.fragment). */
     fragment: Fragment;
@@ -426,14 +400,6 @@ export type ResolvedDrawingItem = {
     zIndex?: number;
     /** Block ID — written to data-block-id. */
     blockId: string;
-    /**
-     * Index back into page.fragments.
-     *
-     * AIDEV-NOTE: compat-fallback. The painter currently reads inner content from
-     * Fragment via this index because ResolvedFragmentItem does not carry full
-     * content yet. Becomes unused once paint items are self-describing; do not
-     * promote this to a permanent API surface.
-     */
     fragmentIndex: number;
     /** Source DrawingFragment back-pointer (see ResolvedFragmentItem.fragment). */
     fragment: Fragment;

package/dist/layout-engine/layout-bridge/src/neutral-hit.d.ts

@@ -35,13 +35,6 @@ export type LayoutHit = {
     sourceAnchor?: SourceAnchor;
     /** Diagnostics for partially supported or rejected hits. */
     diagnostics?: LayoutHitDiagnostic[];
-    /**
-     * Legacy PM-shaped position hit.
-     *
-     * AIDEV-NOTE: compat-fallback - callers may still consume `pmPosition`.
-     * Retire once providers stop relying on PM positions to map this hit back to
-     * a document ref. Do not gate new editor-neutral behavior on this field.
-     */
     legacyPm?: PositionHit;
 };
 export type LayoutHitDiagnostic = {

package/dist/layout-engine/layout-engine/src/index.d.ts

@@ -302,7 +302,6 @@ export type LayoutDocumentContinuation = {
     }): Promise<LayoutContinuationBatch>;
     dispose(): void;
 };
-/** AIDEV-NOTE: The handle owns one live paginator; advancing never replays a stopped prefix. */
 export declare function createLayoutDocumentContinuation(blocks: FlowBlock[], measures: Measure[], options?: LayoutOptions, execution?: LayoutExecutionControl): LayoutDocumentContinuation;
 export type LayoutRangeBoundaryPolicy = 'conservative-context' | 'overscan' | 'degraded-on-incomplete-state';
 export type LayoutRangeExactness = 'exact' | 'pending-layout' | 'degraded-unsupported' | 'stale';

package/dist/layout-engine/painters/dom/src/features/inline-direction/run-direction.d.ts

@@ -26,9 +26,6 @@ export declare const RTL_DATE_LIKE_TOKEN_RE: RegExp;
  * FE70-FEFF Arabic-B). The block range covers Hebrew, Arabic, Syriac, NKo,
  * etc.; the Script properties add presentation forms without including
  * noncharacters (FDD0-FDEF) or the BOM (FEFF).
- *
- * AIDEV-NOTE: also used by editing/runtime mixed-bidi handling. Consolidating
- * crosses a layer boundary; tracked under SD-3169 follow-ups.
  */
 export declare const STRONG_RTL_CHAR_RE: RegExp;
 /**

package/dist/superdoc.cjs

@@ -260,7 +260,7 @@ var v_click_outside_default = {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.27.0-next.2";
+		return "2.27.0-next.3";
 	} catch {
 		return "unknown";
 	}
@@ -46242,7 +46242,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.27.0-next.2";
+		this.version = "2.27.0-next.3";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];

package/dist/superdoc.es.js

@@ -258,7 +258,7 @@ var v_click_outside_default = {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.27.0-next.2";
+		return "2.27.0-next.3";
 	} catch {
 		return "unknown";
 	}
@@ -46172,7 +46172,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.27.0-next.2";
+		this.version = "2.27.0-next.3";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];