@harbour-enterprises/superdoc 1.9.0-next.1 → 1.9.0-next.2

package/dist/super-editor/src/core/presentation-editor/layout/EpochPositionMapper.d.ts

@@ -1,188 +0,0 @@
-import { Transaction } from 'prosemirror-state';
-/**
- * Represents a document version identifier.
- *
- * @remarks
- * Epochs are monotonically increasing integers. Each document-changing transaction
- * increments the epoch by one.
- */
-export type Epoch = number;
-/**
- * Reasons why position mapping might fail.
- *
- * - `invalid_epoch`: The fromEpoch or toEpoch is not a valid finite number, or fromEpoch > toEpoch
- * - `epoch_too_old`: The fromEpoch is older than the oldest retained epoch (exceeds maxEpochsToKeep)
- * - `missing_stepmap`: A StepMap for a required epoch is missing (should not happen in normal operation)
- * - `deleted`: The position was deleted by a transaction step
- * - `invalid_pos`: The position is not a valid finite non-negative number
- */
-export type MapPosFailureReason = 'invalid_epoch' | 'epoch_too_old' | 'missing_stepmap' | 'deleted' | 'invalid_pos';
-/**
- * Result of attempting to map a position from one epoch to another.
- *
- * @remarks
- * A discriminated union that either contains the successfully mapped position or
- * a failure reason explaining why mapping failed.
- */
-export type MapPosResult = {
-    ok: true;
-    pos: number;
-    fromEpoch: Epoch;
-    toEpoch: Epoch;
-} | {
-    ok: false;
-    reason: MapPosFailureReason;
-    fromEpoch: Epoch;
-    toEpoch: Epoch;
-};
-/**
- * Maps ProseMirror positions from past document epochs to the current epoch.
- *
- * @remarks
- * This class solves a critical problem in the layout-selection architecture: the layout engine
- * paints asynchronously, so DOM elements are tagged with positions from a past document epoch.
- * When the user interacts with the DOM (clicks, drags), we need to map those historical positions
- * to the current document state.
- *
- * The mapper maintains a sliding window of ProseMirror StepMaps (transform metadata) for recent
- * transactions. It can then apply these steps in sequence to map positions forward through time.
- *
- * Key design decisions:
- * - Epochs are simple monotonically increasing integers (not timestamps)
- * - Only document-changing transactions increment the epoch (no-op transactions are ignored)
- * - StepMaps are pruned in two ways:
- *   1. By age (maxEpochsToKeep, default 100)
- *   2. By layout completion (epochs older than the last painted layout are discarded)
- * - Mapping can fail for several reasons (position deleted, epoch too old, etc.)
- *
- * Typical usage pattern:
- * 1. Call recordTransaction() for each document change
- * 2. Call onLayoutComplete() when a layout is painted (enables aggressive pruning)
- * 3. Call mapPosFromLayoutToCurrent() to map DOM positions to current document positions
- */
-export declare class EpochPositionMapper {
-    #private;
-    /**
-     * Creates a new EpochPositionMapper.
-     *
-     * @param options - Configuration options
-     * @param options.maxEpochsToKeep - Maximum number of epoch transitions to retain, defaults to 100
-     *
-     * @remarks
-     * The maxEpochsToKeep value is clamped to a minimum of 1 and floored to an integer.
-     * This creates a sliding window of history - epochs older than (currentEpoch - maxEpochsToKeep)
-     * are automatically pruned.
-     *
-     * A value of 100 epochs is usually sufficient since:
-     * - Layouts typically complete within a few frames
-     * - Once a layout completes, even older epochs are pruned aggressively
-     * - Mapping from very old epochs is usually a sign of a stale layout
-     */
-    constructor(options?: {
-        maxEpochsToKeep?: number;
-    });
-    /**
-     * Gets the current document epoch.
-     *
-     * @returns The current epoch number
-     *
-     * @remarks
-     * The epoch starts at 0 and increments by 1 for each document-changing transaction.
-     * No-op transactions (tr.docChanged === false) do not increment the epoch.
-     */
-    getCurrentEpoch(): Epoch;
-    /**
-     * Records a transaction's StepMaps and advances the epoch if the document changed.
-     *
-     * @param tr - The ProseMirror transaction to record
-     *
-     * @remarks
-     * If the transaction did not change the document (tr.docChanged === false), this method
-     * returns early without recording anything or incrementing the epoch.
-     *
-     * For document-changing transactions:
-     * 1. Extracts the array of StepMaps from tr.mapping.maps
-     * 2. Associates these maps with the current epoch (the "from" epoch)
-     * 3. Increments the current epoch (the "to" epoch for this transition)
-     * 4. Prunes old epochs that exceed the retention window
-     *
-     * StepMaps capture how positions are transformed by each step in the transaction,
-     * including deletions, insertions, and replacements.
-     */
-    recordTransaction(tr: Transaction): void;
-    /**
-     * Notifies the mapper that a layout has completed, enabling aggressive pruning of old StepMaps.
-     *
-     * @param layoutEpoch - The document epoch that was just painted to the DOM
-     *
-     * @remarks
-     * Once a layout is painted, we should never see DOM interactions (clicks, selections) from
-     * older epochs, because the DOM represents the layoutEpoch state. Therefore, we can safely
-     * discard StepMaps for epochs strictly older than layoutEpoch.
-     *
-     * This is more aggressive than the sliding window pruning and helps keep memory usage low
-     * even if maxEpochsToKeep is large.
-     *
-     * Pruning steps:
-     * 1. Deletes all StepMaps with fromEpoch < layoutEpoch
-     * 2. Runs the standard sliding window pruning (based on currentEpoch - maxEpochsToKeep)
-     *
-     * Safe to call multiple times with the same or increasing layoutEpoch values.
-     */
-    onLayoutComplete(layoutEpoch: Epoch): void;
-    /**
-     * Maps a position from a layout epoch to the current document epoch (simple result).
-     *
-     * @param pos - The position in the layout epoch's coordinate space
-     * @param fromEpoch - The epoch when the layout was created
-     * @param assoc - Association direction for ambiguous positions (-1 for left, 1 for right), defaults to 1
-     * @returns The mapped position in current document coordinates, or null if mapping failed
-     *
-     * @remarks
-     * This is a convenience wrapper around mapPosFromLayoutToCurrentDetailed() that returns
-     * only the position (or null) without failure reason details.
-     *
-     * Use this when you only care whether mapping succeeded or failed, not why it failed.
-     * For detailed failure diagnostics, use mapPosFromLayoutToCurrentDetailed().
-     *
-     * See mapPosFromLayoutToCurrentDetailed() for full documentation of the mapping algorithm.
-     */
-    mapPosFromLayoutToCurrent(pos: number, fromEpoch: Epoch, assoc?: number): number | null;
-    /**
-     * Maps a position from a layout epoch to the current document epoch with detailed failure information.
-     *
-     * @param pos - The position in the layout epoch's coordinate space
-     * @param fromEpoch - The epoch when the layout was created
-     * @param assoc - Association direction for ambiguous positions (-1 for left, 1 for right), defaults to 1
-     * @returns A detailed result indicating success with the mapped position, or failure with a reason
-     *
-     * @remarks
-     * This method applies a sequence of ProseMirror StepMaps to transform a position from a past
-     * epoch to the current document state. The algorithm:
-     *
-     * 1. Validates inputs (pos and fromEpoch must be valid finite non-negative numbers)
-     * 2. Handles the trivial case (fromEpoch === currentEpoch returns pos unchanged)
-     * 3. Checks if fromEpoch is within the retention window
-     * 4. Iterates through epochs from fromEpoch to currentEpoch:
-     *    - Retrieves the StepMaps for each epoch transition
-     *    - Applies each StepMap to transform the position
-     *    - Detects if the position was deleted
-     * 5. Returns the final mapped position or a failure reason
-     *
-     * The assoc parameter controls behavior at position boundaries:
-     * - assoc = 1 (right): At insertion points, associates with content to the right
-     * - assoc = -1 (left): At insertion points, associates with content to the left
-     *
-     * Failure reasons:
-     * - `invalid_pos`: pos is not a valid finite non-negative number
-     * - `invalid_epoch`: fromEpoch is invalid, negative, or greater than currentEpoch
-     * - `epoch_too_old`: fromEpoch is older than the retention window
-     * - `missing_stepmap`: A required StepMap is missing (indicates a bug)
-     * - `deleted`: The position was deleted by a transaction
-     *
-     * Use this method when you need to diagnose why mapping failed (e.g., for logging or
-     * fallback behavior). For simple success/failure, use mapPosFromLayoutToCurrent().
-     */
-    mapPosFromLayoutToCurrentDetailed(pos: number, fromEpoch: Epoch, assoc?: number): MapPosResult;
-}
-//# sourceMappingURL=EpochPositionMapper.d.ts.map

package/dist/super-editor/src/core/presentation-editor/layout/EpochPositionMapper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"EpochPositionMapper.d.ts","sourceRoot":"","sources":["../../../../../../../super-editor/src/core/presentation-editor/layout/EpochPositionMapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAE3B;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,eAAe,GAAG,iBAAiB,GAAG,SAAS,GAAG,aAAa,CAAC;AAEpH;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,GAC3D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,mBAAmB;;IAK9B;;;;;;;;;;;;;;;OAeG;gBACS,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE;IAKlD;;;;;;;;OAQG;IACH,eAAe,IAAI,KAAK;IAIxB;;;;;;;;;;;;;;;;;OAiBG;IACH,iBAAiB,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI;IAYxC;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI;IAW1C;;;;;;;;;;;;;;;;OAgBG;IACH,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,GAAG,IAAI;IAK1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,iCAAiC,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAE,MAAU,GAAG,YAAY;CA+ClG"}

package/dist/super-editor/src/core/presentation-editor/layout/FootnotesBuilder.d.ts

@@ -1,28 +0,0 @@
-import { EditorState } from 'prosemirror-state';
-import { ConverterContext } from '@superdoc/pm-adapter';
-import { FootnoteReference, FootnotesLayoutInput } from '../types.js';
-export type { FootnoteReference, FootnotesLayoutInput };
-/** Minimal shape of a converter object containing footnote data. */
-export type ConverterLike = {
-    footnotes?: Array<{
-        id?: unknown;
-        content?: unknown[];
-    }>;
-};
-/**
- * Builds footnote layout input from editor state and converter data.
- *
- * Traverses the document to find footnote references, then builds layout
- * blocks for each referenced footnote with superscript markers prepended.
- *
- * No external side effects, no DOM access, no callbacks.
- * Note: Mutates blocks internally when adding footnote markers.
- *
- * @param editorState - The ProseMirror editor state
- * @param converter - Converter with footnote data
- * @param converterContext - Context with footnote numbering info
- * @param themeColors - Theme colors for styling
- * @returns FootnotesLayoutInput if footnotes exist, null otherwise
- */
-export declare function buildFootnotesInput(editorState: EditorState | null | undefined, converter: ConverterLike | null | undefined, converterContext: ConverterContext | undefined, themeColors: unknown): FootnotesLayoutInput | null;
-//# sourceMappingURL=FootnotesBuilder.d.ts.map

package/dist/super-editor/src/core/presentation-editor/layout/FootnotesBuilder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FootnotesBuilder.d.ts","sourceRoot":"","sources":["../../../../../../../super-editor/src/core/presentation-editor/layout/FootnotesBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAG3E,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;AAMxD,oEAAoE;AACpE,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;CAC1D,CAAC;AAwBF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EAC3C,SAAS,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EAC3C,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,EAC9C,WAAW,EAAE,OAAO,GACnB,oBAAoB,GAAG,IAAI,CA+D7B"}

package/dist/super-editor/src/core/presentation-editor/layout/LayoutOptionParsing.d.ts

@@ -1,32 +0,0 @@
-import { ColumnLayout } from '@superdoc/contracts';
-/**
- * Converts inches to pixels using standard 96 DPI conversion.
- *
- * @param value - Value in inches (will be coerced to number)
- * @returns Value in pixels, or undefined if input is not a finite number
- *
- * @remarks
- * Uses 96 DPI as the standard conversion rate (1 inch = 96 pixels).
- * This is the CSS/web standard for physical unit conversion.
- */
-export declare function inchesToPx(value: unknown): number | undefined;
-/**
- * Parses column layout configuration from raw input.
- *
- * Extracts column count and gap spacing from various possible property names,
- * normalizing to a standard ColumnLayout object. Returns undefined for single-column
- * layouts (count <= 1) since they don't require special column handling.
- *
- * @param raw - Raw column configuration object with properties like count, num, or numberOfColumns
- * @returns ColumnLayout with count and gap, or undefined if not multi-column or invalid
- *
- * @remarks
- * - Returns undefined if raw is not an object
- * - Accepts count from: 'count', 'num', or 'numberOfColumns' properties
- * - Returns undefined if count <= 1 (single column doesn't need layout)
- * - Accepts gap from: 'space' or 'gap' properties (converted from inches to pixels)
- * - Gap defaults to 0 if not provided or invalid
- * - Column count is floored to nearest integer and minimum of 1
- */
-export declare function parseColumns(raw: unknown): ColumnLayout | undefined;
-//# sourceMappingURL=LayoutOptionParsing.d.ts.map

package/dist/super-editor/src/core/presentation-editor/layout/LayoutOptionParsing.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"LayoutOptionParsing.d.ts","sourceRoot":"","sources":["../../../../../../../super-editor/src/core/presentation-editor/layout/LayoutOptionParsing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAK7D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAUnE"}

package/dist/super-editor/src/core/presentation-editor/layout/PresentationLayoutMetrics.d.ts

@@ -1,7 +0,0 @@
-import { FlowBlock, Layout } from '@superdoc/contracts';
-export declare function createLayoutMetrics(perf: Performance | undefined, startMark: number | undefined, layout: Layout, blocks: FlowBlock[]): {
-    durationMs: number;
-    blockCount: number;
-    pageCount: number;
-} | undefined;
-//# sourceMappingURL=PresentationLayoutMetrics.d.ts.map

package/dist/super-editor/src/core/presentation-editor/layout/PresentationLayoutMetrics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PresentationLayoutMetrics.d.ts","sourceRoot":"","sources":["../../../../../../../super-editor/src/core/presentation-editor/layout/PresentationLayoutMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7D,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,EAAE,GAClB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAU3E"}

package/dist/super-editor/src/core/presentation-editor/layout/SectionPageStyles.d.ts

@@ -1,24 +0,0 @@
-import { Layout } from '@superdoc/contracts';
-export type ConverterPageStyles = {
-    pageMargins?: {
-        left?: number;
-        right?: number;
-        top?: number;
-        bottom?: number;
-    };
-};
-export declare function getCurrentSectionPageStyles(layout: Layout | null, pageIndex: number, converterPageStyles?: ConverterPageStyles | null): {
-    pageSize: {
-        width: number;
-        height: number;
-    };
-    pageMargins: {
-        left: number;
-        right: number;
-        top: number;
-        bottom: number;
-    };
-    sectionIndex: number;
-    orientation: 'portrait' | 'landscape';
-};
-//# sourceMappingURL=SectionPageStyles.d.ts.map

package/dist/super-editor/src/core/presentation-editor/layout/SectionPageStyles.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SectionPageStyles.d.ts","sourceRoot":"","sources":["../../../../../../../super-editor/src/core/presentation-editor/layout/SectionPageStyles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChF,CAAC;AAEF,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,SAAS,EAAE,MAAM,EACjB,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAC/C;IACD,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,UAAU,GAAG,WAAW,CAAC;CACvC,CAoDA"}

package/dist/super-editor/src/core/presentation-editor/pointer-events/EditorInputManager.d.ts

@@ -1,178 +0,0 @@
-import { Editor } from '../../Editor.js';
-import { Layout, FlowBlock, Measure } from '@superdoc/contracts';
-import { CellAnchorState, PendingMarginClick, HeaderFooterRegion } from '../types.js';
-import { PositionHit, PageGeometryHelper, TableHitResult } from '@superdoc/layout-bridge';
-import { EpochPositionMapper } from '../layout/EpochPositionMapper.js';
-import { HeaderFooterSessionManager } from '../header-footer/HeaderFooterSessionManager.js';
-/**
- * Layout state provided by PresentationEditor.
- */
-export type LayoutState = {
-    layout: Layout | null;
-    blocks: FlowBlock[];
-    measures: Measure[];
-};
-/**
- * Dependencies injected from PresentationEditor.
- */
-export type EditorInputDependencies = {
-    /** Get the active editor (body or header/footer) */
-    getActiveEditor: () => Editor;
-    /** Get the main body editor */
-    getEditor: () => Editor;
-    /** Get current layout state */
-    getLayoutState: () => LayoutState;
-    /** Get the epoch mapper for position translation */
-    getEpochMapper: () => EpochPositionMapper;
-    /** Get viewport host element */
-    getViewportHost: () => HTMLElement;
-    /** Get visible host element (for scroll) */
-    getVisibleHost: () => HTMLElement;
-    /** Get header/footer session manager */
-    getHeaderFooterSession: () => HeaderFooterSessionManager | null;
-    /** Get page geometry helper */
-    getPageGeometryHelper: () => PageGeometryHelper | null;
-    /** Get layout options zoom */
-    getZoom: () => number;
-    /** Check if view is locked */
-    isViewLocked: () => boolean;
-    /** Get document mode */
-    getDocumentMode: () => 'editing' | 'viewing' | 'suggesting';
-    /** Get page element by index */
-    getPageElement: (pageIndex: number) => HTMLElement | null;
-    /** Check if selection-aware virtualization is enabled */
-    isSelectionAwareVirtualizationEnabled: () => boolean;
-};
-/**
- * Callbacks for events that the manager emits.
- * All callbacks are optional to allow incremental setup.
- */
-export type EditorInputCallbacks = {
-    /** Schedule selection update */
-    scheduleSelectionUpdate?: () => void;
-    /** Schedule rerender */
-    scheduleRerender?: () => void;
-    /** Set pending doc change flag */
-    setPendingDocChange?: () => void;
-    /** Update selection virtualization pins */
-    updateSelectionVirtualizationPins?: (options?: {
-        includeDragBuffer?: boolean;
-        extraPages?: number[];
-    }) => void;
-    /** Schedule a11y announcement */
-    scheduleA11ySelectionAnnouncement?: (options: {
-        immediate: boolean;
-    }) => void;
-    /** Go to anchor */
-    goToAnchor?: (href: string) => void;
-    /** Emit event */
-    emit?: (event: string, payload: unknown) => void;
-    /** Normalize client point to layout coordinates */
-    normalizeClientPoint?: (clientX: number, clientY: number) => {
-        x: number;
-        y: number;
-    } | null;
-    /** Hit test header/footer region */
-    hitTestHeaderFooterRegion?: (x: number, y: number) => HeaderFooterRegion | null;
-    /** Exit header/footer mode */
-    exitHeaderFooterMode?: () => void;
-    /** Activate header/footer region */
-    activateHeaderFooterRegion?: (region: HeaderFooterRegion) => void;
-    /** Create default header/footer */
-    createDefaultHeaderFooter?: (region: HeaderFooterRegion) => void;
-    /** Emit header/footer edit blocked */
-    emitHeaderFooterEditBlocked?: (reason: string) => void;
-    /** Find region for page */
-    findRegionForPage?: (kind: 'header' | 'footer', pageIndex: number) => HeaderFooterRegion | null;
-    /** Get current page index */
-    getCurrentPageIndex?: () => number;
-    /** Resolve descriptor for region */
-    resolveDescriptorForRegion?: (region: HeaderFooterRegion) => unknown | null;
-    /** Update selection debug HUD */
-    updateSelectionDebugHud?: () => void;
-    /** Clear hover region */
-    clearHoverRegion?: () => void;
-    /** Render hover region */
-    renderHoverRegion?: (region: HeaderFooterRegion) => void;
-    /** Focus editor after image selection */
-    focusEditorAfterImageSelection?: () => void;
-    /** Resolve field annotation from element */
-    resolveFieldAnnotationSelectionFromElement?: (el: HTMLElement) => {
-        node: unknown;
-        pos: number;
-    } | null;
-    /** Compute pending margin click */
-    computePendingMarginClick?: (pointerId: number, x: number, y: number) => PendingMarginClick | null;
-    /** Select word at position */
-    selectWordAt?: (pos: number) => boolean;
-    /** Select paragraph at position */
-    selectParagraphAt?: (pos: number) => boolean;
-    /** Finalize drag selection with DOM */
-    finalizeDragSelectionWithDom?: (pointer: {
-        clientX: number;
-        clientY: number;
-    }, dragAnchor: number, dragMode: 'char' | 'word' | 'para') => void;
-    /** Hit test table at coordinates */
-    hitTestTable?: (x: number, y: number) => TableHitResult | null;
-};
-export declare class EditorInputManager {
-    #private;
-    constructor();
-    /**
-     * Set dependencies from PresentationEditor.
-     */
-    setDependencies(deps: EditorInputDependencies): void;
-    /**
-     * Set callbacks for events.
-     */
-    setCallbacks(callbacks: EditorInputCallbacks): void;
-    /**
-     * Bind event listeners to DOM elements.
-     */
-    bind(): void;
-    /**
-     * Unbind event listeners.
-     */
-    unbind(): void;
-    /**
-     * Destroy the manager and clean up.
-     */
-    destroy(): void;
-    /** Whether currently dragging */
-    get isDragging(): boolean;
-    /** Current drag anchor position */
-    get dragAnchor(): number | null;
-    /** Cell anchor state for table selection */
-    get cellAnchor(): CellAnchorState | null;
-    /** Debug last pointer position */
-    get debugLastPointer(): {
-        clientX: number;
-        clientY: number;
-        x: number;
-        y: number;
-    } | null;
-    /** Debug last hit */
-    get debugLastHit(): {
-        source: 'dom' | 'geometry' | 'margin' | 'none';
-        pos: number | null;
-        layoutEpoch: number | null;
-        mappedPos: number | null;
-    } | null;
-    /** Last selected image block ID */
-    get lastSelectedImageBlockId(): string | null;
-    /** Drag anchor page index */
-    get dragAnchorPageIndex(): number | null;
-    /** Get the page index from the last raw hit during drag */
-    get dragLastHitPageIndex(): number | null;
-    /** Get the last raw hit during drag (for finalization) */
-    get dragLastRawHit(): PositionHit | null;
-    /**
-     * Clear cell anchor (used when document changes).
-     */
-    clearCellAnchor(): void;
-    /**
-     * Set suppress focus in flag (for draggable annotations).
-     */
-    setSuppressFocusInFromDraggable(value: boolean): void;
-}
-//# sourceMappingURL=EditorInputManager.d.ts.map

package/dist/super-editor/src/core/presentation-editor/pointer-events/EditorInputManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"EditorInputManager.d.ts","sourceRoot":"","sources":["../../../../../../../super-editor/src/core/presentation-editor/pointer-events/EditorInputManager.ts"],"names":[],"mappings":"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"}

package/dist/super-editor/src/core/presentation-editor/pointer-events/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Editor input handling module for PresentationEditor.
- */
-export { EditorInputManager } from './EditorInputManager.js';
-export type { LayoutState, EditorInputDependencies, EditorInputCallbacks } from './EditorInputManager.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/super-editor/src/core/presentation-editor/pointer-events/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../super-editor/src/core/presentation-editor/pointer-events/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/super-editor/src/core/presentation-editor/remote-cursors/RemoteCursorAwareness.d.ts

@@ -1,48 +0,0 @@
-import { EditorState } from 'prosemirror-state';
-import { RemoteCursorState } from '../types.js';
-/**
- * Minimal interface for Yjs awareness object.
- */
-type AwarenessLike = {
-    clientID?: number;
-    getStates?: () => Map<number, unknown>;
-};
-/**
- * Minimal interface for collaboration provider with awareness.
- */
-type CollaborationProviderLike = {
-    awareness?: AwarenessLike | null;
-} | null;
-/**
- * Normalizes Yjs awareness states into typed RemoteCursorState objects.
- *
- * Converts relative Yjs positions to absolute ProseMirror positions, validates and clamps
- * positions to document bounds, assigns fallback colors, and manages stale state cleanup.
- * Preserves timestamps for unchanged cursor positions to enable stable sorting and limit
- * enforcement without flickering.
- *
- * @param options - Configuration object
- * @param options.provider - Collaboration provider with awareness capability
- * @param options.editorState - Current ProseMirror editor state
- * @param options.previousState - Previous cursor states for timestamp preservation
- * @param options.fallbackColors - Array of fallback colors for users without custom colors
- * @param options.staleTimeoutMs - Milliseconds after which inactive cursor states are removed
- * @returns Map of client IDs to normalized remote cursor states
- *
- * @remarks
- * - Skips the local client (matching awareness.clientID)
- * - Skips states without cursor data or failed position conversions
- * - Clamps positions to valid document range [0, docSize]
- * - Preserves updatedAt timestamp if cursor position hasn't changed
- * - Removes stale entries (inactive beyond staleTimeoutMs) from previousState map
- * - Returns empty map if provider, awareness, editorState, or ySync plugin is unavailable
- */
-export declare function normalizeAwarenessStates(options: {
-    provider: CollaborationProviderLike;
-    editorState: EditorState | null;
-    previousState: Map<number, RemoteCursorState>;
-    fallbackColors: readonly string[];
-    staleTimeoutMs: number;
-}): Map<number, RemoteCursorState>;
-export {};
-//# sourceMappingURL=RemoteCursorAwareness.d.ts.map

package/dist/super-editor/src/core/presentation-editor/remote-cursors/RemoteCursorAwareness.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RemoteCursorAwareness.d.ts","sourceRoot":"","sources":["../../../../../../../super-editor/src/core/presentation-editor/remote-cursors/RemoteCursorAwareness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;GAEG;AACH,KAAK,aAAa,GAAG;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,KAAK,yBAAyB,GAAG;IAC/B,SAAS,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CAClC,GAAG,IAAI,CAAC;AAET;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,QAAQ,EAAE,yBAAyB,CAAC;IACpC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC9C,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAwFjC"}

package/dist/super-editor/src/core/presentation-editor/remote-cursors/RemoteCursorColors.d.ts

@@ -1,34 +0,0 @@
-/**
- * Gets a deterministic fallback color for a remote cursor based on client ID.
- *
- * Uses modulo arithmetic to cycle through the fallback color palette, ensuring
- * each client gets a consistent color across sessions while distributing colors
- * evenly when multiple clients are active.
- *
- * @param clientId - The Yjs client ID
- * @param fallbackColors - Array of fallback colors in hex format
- * @returns A hex color string from the fallback palette
- *
- * @remarks
- * Uses modulo to wrap client IDs to the palette size, providing deterministic
- * color assignment. The non-null assertion is safe because modulo guarantees
- * a valid index.
- */
-export declare function getFallbackCursorColor(clientId: number, fallbackColors: readonly string[]): string;
-/**
- * Validates a cursor color string and returns a fallback if invalid.
- *
- * Ensures the color is a valid 6-digit hex color (#RRGGBB). If validation fails,
- * returns a deterministic fallback color based on the client ID.
- *
- * @param color - The color string to validate
- * @param clientId - The Yjs client ID for fallback color selection
- * @param fallbackColors - Array of fallback colors in hex format
- * @returns The validated color, or a fallback if invalid
- *
- * @remarks
- * Only accepts uppercase or lowercase 6-digit hex format (#RRGGBB).
- * Does not accept shorthand hex (#RGB) or other color formats.
- */
-export declare function validateCursorColor(color: string, clientId: number, fallbackColors: readonly string[]): string;
-//# sourceMappingURL=RemoteCursorColors.d.ts.map

package/dist/super-editor/src/core/presentation-editor/remote-cursors/RemoteCursorColors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RemoteCursorColors.d.ts","sourceRoot":"","sources":["../../../../../../../super-editor/src/core/presentation-editor/remote-cursors/RemoteCursorColors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAElG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE9G"}