@atlaskit/editor-common 112.7.4 → 112.8.0

package/dist/types/lists/build-replacement-fragment.d.ts

@@ -0,0 +1,35 @@
+import type { Node as PMNode, Schema } from '@atlaskit/editor-prosemirror/model';
+import { Fragment } from '@atlaskit/editor-prosemirror/model';
+import type { FlattenedItem } from './flatten-list';
+export interface BuildResult {
+    /**
+     * For each element (by index), the offset within the fragment where the
+     * element's content begins.
+     *
+     * To get the absolute document position after `tr.replaceWith(rangeStart, …)`,
+     * add `rangeStart` to the offset.
+     */
+    contentStartOffsets: number[];
+    fragment: Fragment;
+}
+/** Rebuilds a list-like PM node from a flat array of items. */
+type RebuildFn = (items: FlattenedItem[], schema: Schema) => {
+    contentStartOffsets: number[];
+    node: PMNode;
+} | null;
+/** Extracts top-level content nodes from an item being broken out past the root list. */
+type ExtractContentFn = (item: FlattenedItem, schema: Schema) => PMNode[];
+interface BuildReplacementFragmentOptions {
+    extractContentFn: ExtractContentFn;
+    items: FlattenedItem[];
+    rebuildFn: RebuildFn;
+    schema: Schema;
+}
+/**
+ * Build a replacement Fragment from a flat array of items.
+ *
+ * Items with depth >= 0 are grouped and rebuilt via `rebuildFn`.
+ * Items with depth < 0 are extracted via `extractContentFn`.
+ */
+export declare function buildReplacementFragment({ items, schema, rebuildFn, extractContentFn, }: BuildReplacementFragmentOptions): BuildResult;
+export {};

package/dist/types/lists/flatten-list.d.ts

@@ -0,0 +1,47 @@
+import type { Attrs, Node as PMNode } from '@atlaskit/editor-prosemirror/model';
+export interface FlattenedItem {
+    depth: number;
+    isSelected: boolean;
+    listType: string;
+    node: PMNode;
+    parentListAttrs: Attrs | null;
+    pos: number;
+}
+export interface FlattenListOptions {
+    doc: PMNode;
+    indentDelta: number;
+    maxDepth?: number;
+    rootListStart: number;
+    rootListEnd: number;
+    selectionFrom: number;
+    selectionTo: number;
+}
+/**
+ * Type-specific predicates that vary between regular lists and task lists.
+ */
+interface FlattenListPredicates {
+    /** Returns true if `node` is a content-bearing item to include in the flattened output. */
+    isContentNode: (node: PMNode, parent: PMNode | null) => boolean;
+    /** Returns the selection bounds for an item, used to check selection intersection. */
+    getSelectionBounds: (node: PMNode, pos: number) => {
+        start: number;
+        end: number;
+    };
+    /** Computes the nesting depth for a node given its resolved depth and the root's depth. */
+    getDepth: (resolvedDepth: number, rootDepth: number) => number;
+}
+export interface FlattenListResult {
+    items: FlattenedItem[];
+    startIndex: number;
+    endIndex: number;
+}
+/**
+ * Flattens a list-like PM structure (regular list or task list) into an
+ * array of content-bearing items with computed depths.
+ *
+ * Uses `doc.nodesBetween` to walk the tree and delegates type-specific
+ * decisions to the provided predicates. The core algorithm — selection
+ * intersection, depth adjustment, index tracking — is shared.
+ */
+export declare function flattenList(options: FlattenListOptions, predicates: FlattenListPredicates): FlattenListResult | null;
+export {};

package/dist/types/lists/index.d.ts

@@ -3,5 +3,11 @@ export { moveTargetIntoList } from './replace-content';
 export { JoinDirection, isListNodeValidContent, joinSiblingLists, processNestedTaskListsInSameLevel, } from './node';
 export { getCommonListAnalyticsAttributes, countListItemsInSelection } from './analytics';
 export { hasValidListIndentationLevel } from './indentation';
+export { restoreSelection, computeSelectionOffsets } from './restore-selection';
+export { buildReplacementFragment } from './build-replacement-fragment';
+export type { BuildResult } from './build-replacement-fragment';
+export type { FlattenedItem } from './flatten-list';
+export { flattenList } from './flatten-list';
+export type { FlattenListOptions, FlattenListResult } from './flatten-list';
 export { isListNode, isListItemNode, isBulletList, isParagraphNode } from '../utils';
 export { messages } from './messages';

package/dist/types/lists/restore-selection.d.ts

@@ -0,0 +1,41 @@
+import type { Transaction } from '@atlaskit/editor-prosemirror/state';
+import { Selection } from '@atlaskit/editor-prosemirror/state';
+import type { FlattenedItem } from './flatten-list';
+interface ComputeSelectionOffsetsOptions {
+    contentStartOffsets: number[];
+    docSize: number;
+    endIndex: number;
+    items: FlattenedItem[];
+    originalFrom: number;
+    originalTo: number;
+    rootListStart: number;
+    startIndex: number;
+}
+interface RestoreSelectionOptions {
+    from: number;
+    originalSelection: Selection;
+    to: number;
+    tr: Transaction;
+}
+/**
+ * Compute the new selection offsets after list items have been moved/indented/outdented.
+ *
+ * Uses the content start offsets computed during fragment rebuild to map each
+ * selection endpoint to its new absolute position, accounting for the change
+ * in the list structure.
+ */
+export declare function computeSelectionOffsets({ items, startIndex, endIndex, originalFrom, originalTo, contentStartOffsets, rootListStart, docSize, }: ComputeSelectionOffsetsOptions): {
+    from: number;
+    to: number;
+};
+/**
+ * Restore the transaction's selection after a list structural change
+ * (indent/outdent of list items or task list items).
+ *
+ * Uses the content start offsets computed during fragment rebuild to
+ * map each selection endpoint to its new absolute position.
+ *
+ * Handles NodeSelection, GapCursorSelection, and TextSelection.
+ */
+export declare function restoreSelection({ tr, originalSelection, from, to, }: RestoreSelectionOptions): void;
+export {};

package/dist/types-ts4.5/lists/build-replacement-fragment.d.ts

@@ -0,0 +1,35 @@
+import type { Node as PMNode, Schema } from '@atlaskit/editor-prosemirror/model';
+import { Fragment } from '@atlaskit/editor-prosemirror/model';
+import type { FlattenedItem } from './flatten-list';
+export interface BuildResult {
+    /**
+     * For each element (by index), the offset within the fragment where the
+     * element's content begins.
+     *
+     * To get the absolute document position after `tr.replaceWith(rangeStart, …)`,
+     * add `rangeStart` to the offset.
+     */
+    contentStartOffsets: number[];
+    fragment: Fragment;
+}
+/** Rebuilds a list-like PM node from a flat array of items. */
+type RebuildFn = (items: FlattenedItem[], schema: Schema) => {
+    contentStartOffsets: number[];
+    node: PMNode;
+} | null;
+/** Extracts top-level content nodes from an item being broken out past the root list. */
+type ExtractContentFn = (item: FlattenedItem, schema: Schema) => PMNode[];
+interface BuildReplacementFragmentOptions {
+    extractContentFn: ExtractContentFn;
+    items: FlattenedItem[];
+    rebuildFn: RebuildFn;
+    schema: Schema;
+}
+/**
+ * Build a replacement Fragment from a flat array of items.
+ *
+ * Items with depth >= 0 are grouped and rebuilt via `rebuildFn`.
+ * Items with depth < 0 are extracted via `extractContentFn`.
+ */
+export declare function buildReplacementFragment({ items, schema, rebuildFn, extractContentFn, }: BuildReplacementFragmentOptions): BuildResult;
+export {};

package/dist/types-ts4.5/lists/flatten-list.d.ts

@@ -0,0 +1,47 @@
+import type { Attrs, Node as PMNode } from '@atlaskit/editor-prosemirror/model';
+export interface FlattenedItem {
+    depth: number;
+    isSelected: boolean;
+    listType: string;
+    node: PMNode;
+    parentListAttrs: Attrs | null;
+    pos: number;
+}
+export interface FlattenListOptions {
+    doc: PMNode;
+    indentDelta: number;
+    maxDepth?: number;
+    rootListStart: number;
+    rootListEnd: number;
+    selectionFrom: number;
+    selectionTo: number;
+}
+/**
+ * Type-specific predicates that vary between regular lists and task lists.
+ */
+interface FlattenListPredicates {
+    /** Returns true if `node` is a content-bearing item to include in the flattened output. */
+    isContentNode: (node: PMNode, parent: PMNode | null) => boolean;
+    /** Returns the selection bounds for an item, used to check selection intersection. */
+    getSelectionBounds: (node: PMNode, pos: number) => {
+        start: number;
+        end: number;
+    };
+    /** Computes the nesting depth for a node given its resolved depth and the root's depth. */
+    getDepth: (resolvedDepth: number, rootDepth: number) => number;
+}
+export interface FlattenListResult {
+    items: FlattenedItem[];
+    startIndex: number;
+    endIndex: number;
+}
+/**
+ * Flattens a list-like PM structure (regular list or task list) into an
+ * array of content-bearing items with computed depths.
+ *
+ * Uses `doc.nodesBetween` to walk the tree and delegates type-specific
+ * decisions to the provided predicates. The core algorithm — selection
+ * intersection, depth adjustment, index tracking — is shared.
+ */
+export declare function flattenList(options: FlattenListOptions, predicates: FlattenListPredicates): FlattenListResult | null;
+export {};

package/dist/types-ts4.5/lists/index.d.ts

@@ -3,5 +3,11 @@ export { moveTargetIntoList } from './replace-content';
 export { JoinDirection, isListNodeValidContent, joinSiblingLists, processNestedTaskListsInSameLevel, } from './node';
 export { getCommonListAnalyticsAttributes, countListItemsInSelection } from './analytics';
 export { hasValidListIndentationLevel } from './indentation';
+export { restoreSelection, computeSelectionOffsets } from './restore-selection';
+export { buildReplacementFragment } from './build-replacement-fragment';
+export type { BuildResult } from './build-replacement-fragment';
+export type { FlattenedItem } from './flatten-list';
+export { flattenList } from './flatten-list';
+export type { FlattenListOptions, FlattenListResult } from './flatten-list';
 export { isListNode, isListItemNode, isBulletList, isParagraphNode } from '../utils';
 export { messages } from './messages';

package/dist/types-ts4.5/lists/restore-selection.d.ts

@@ -0,0 +1,41 @@
+import type { Transaction } from '@atlaskit/editor-prosemirror/state';
+import { Selection } from '@atlaskit/editor-prosemirror/state';
+import type { FlattenedItem } from './flatten-list';
+interface ComputeSelectionOffsetsOptions {
+    contentStartOffsets: number[];
+    docSize: number;
+    endIndex: number;
+    items: FlattenedItem[];
+    originalFrom: number;
+    originalTo: number;
+    rootListStart: number;
+    startIndex: number;
+}
+interface RestoreSelectionOptions {
+    from: number;
+    originalSelection: Selection;
+    to: number;
+    tr: Transaction;
+}
+/**
+ * Compute the new selection offsets after list items have been moved/indented/outdented.
+ *
+ * Uses the content start offsets computed during fragment rebuild to map each
+ * selection endpoint to its new absolute position, accounting for the change
+ * in the list structure.
+ */
+export declare function computeSelectionOffsets({ items, startIndex, endIndex, originalFrom, originalTo, contentStartOffsets, rootListStart, docSize, }: ComputeSelectionOffsetsOptions): {
+    from: number;
+    to: number;
+};
+/**
+ * Restore the transaction's selection after a list structural change
+ * (indent/outdent of list items or task list items).
+ *
+ * Uses the content start offsets computed during fragment rebuild to
+ * map each selection endpoint to its new absolute position.
+ *
+ * Handles NodeSelection, GapCursorSelection, and TextSelection.
+ */
+export declare function restoreSelection({ tr, originalSelection, from, to, }: RestoreSelectionOptions): void;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-common",
-	"version": "112.7.4",
+	"version": "112.8.0",
 	"description": "A package that contains common classes and components for editor and renderer",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -81,8 +81,7 @@
 		"@atlaskit/status": "^3.1.0",
 		"@atlaskit/task-decision": "^19.3.0",
 		"@atlaskit/textfield": "^8.2.0",
-		"@atlaskit/theme": "^22.0.0",
-		"@atlaskit/tmp-editor-statsig": "^44.0.0",
+		"@atlaskit/tmp-editor-statsig": "^44.1.0",
 		"@atlaskit/tokens": "^11.1.0",
 		"@atlaskit/tooltip": "^21.0.0",
 		"@atlaskit/width-detector": "^5.0.0",