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

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

@@ -1,176 +0,0 @@
-import { EditorState } from 'prosemirror-state';
-import { FlowBlock, Layout, Measure } from '@superdoc/contracts';
-import { PageGeometryHelper } from '@superdoc/layout-bridge';
-import { RemoteCursorState, PresenceOptions, AwarenessWithSetField } from '../types.js';
-/**
- * Minimal interface for collaboration provider with awareness.
- */
-type CollaborationProviderLike = {
-    awareness?: AwarenessWithSetField | null;
-    disconnect?: () => void;
-} | null;
-/**
- * Caret geometry in page-local layout space.
- */
-type CaretLayout = {
-    pageIndex: number;
-    x: number;
-    y: number;
-    height: number;
-};
-/**
- * Configuration options for RemoteCursorManager.
- */
-export type RemoteCursorManagerOptions = {
-    /** The host element where the editor is mounted (for scroll events) */
-    visibleHost: HTMLElement;
-    /** The overlay element to render cursors into */
-    remoteCursorOverlay: HTMLElement;
-    /** Presence configuration options */
-    presence?: PresenceOptions;
-    /** Collaboration provider with awareness support */
-    collaborationProvider?: CollaborationProviderLike;
-    /** Fallback color palette for users without custom colors */
-    fallbackColors: readonly string[];
-    /** Style constants for cursor rendering */
-    cursorStyles: CursorStylesLike;
-    /** Maximum selection rectangles per user (performance guardrail) */
-    maxSelectionRectsPerUser: number;
-    /** Default page height for coordinate calculations */
-    defaultPageHeight: number;
-};
-/**
- * Style constants for remote cursor rendering.
- */
-type CursorStylesLike = {
-    CARET_WIDTH: number;
-    LABEL_FONT_SIZE: number;
-    LABEL_PADDING: string;
-    LABEL_OFFSET: string;
-    SELECTION_BORDER_RADIUS: string;
-    MAX_LABEL_LENGTH: number;
-};
-/**
- * Dependencies required for rendering remote cursors.
- * These are passed from PresentationEditor as they change with layout updates.
- */
-export type RenderDependencies = {
-    layout: Layout | null;
-    blocks: FlowBlock[];
-    measures: Measure[];
-    pageGeometryHelper: PageGeometryHelper | null;
-    pageHeight: number;
-    computeCaretLayoutRect: (pos: number) => CaretLayout | null;
-    convertPageLocalToOverlayCoords: (pageIndex: number, x: number, y: number) => {
-        x: number;
-        y: number;
-    } | null;
-};
-/**
- * Telemetry payload for remote cursor render events.
- */
-export type RemoteCursorsTelemetry = {
-    collaboratorCount: number;
-    visibleCount: number;
-    renderTimeMs: number;
-};
-/**
- * Manages remote cursor state and rendering for collaborative editing.
- *
- * This class is designed to be instantiated by PresentationEditor and owns all
- * the state related to remote cursor rendering. It delegates actual rendering
- * to the helper functions in RemoteCursorAwareness.ts and RemoteCursorRendering.ts.
- */
-export declare class RemoteCursorManager {
-    #private;
-    constructor(options: RemoteCursorManagerOptions);
-    /**
-     * Get the current remote cursor state map.
-     * Useful for emitting cursor data to host consumers.
-     */
-    get state(): Map<number, RemoteCursorState>;
-    /**
-     * Get the cursor elements map for testing/debugging.
-     */
-    get elements(): Map<number, HTMLElement>;
-    /**
-     * Check if the manager is currently set up.
-     */
-    get isSetup(): boolean;
-    /**
-     * Set a telemetry callback to receive render metrics.
-     */
-    setTelemetryCallback(callback: ((data: RemoteCursorsTelemetry) => void) | null): void;
-    /**
-     * Set a callback to receive cursor update events.
-     */
-    setCursorsUpdateCallback(callback: ((cursors: RemoteCursorState[]) => void) | null): void;
-    /**
-     * Setup awareness event subscriptions for remote cursor tracking.
-     * Includes scroll listener for virtualization updates.
-     * Called after collaborationReady event when ySync plugin is initialized.
-     * Prevents double-initialization by cleaning up existing subscriptions first.
-     */
-    setup(): void;
-    /**
-     * Mark the cursor state as dirty, requiring a re-render.
-     */
-    markDirty(): void;
-    /**
-     * Schedule a remote cursor update using microtask + throttle-based rendering.
-     *
-     * Uses queueMicrotask to defer cursor normalization until after all
-     * synchronous code completes. This fixes a race condition where awareness events
-     * fire before the ProseMirror state is updated with Yjs document changes.
-     */
-    scheduleUpdate(): void;
-    /**
-     * Set the callback to invoke when a scheduled update fires.
-     * This allows PresentationEditor to provide the update logic with current state.
-     */
-    setUpdateCallback(callback: (() => void) | null): void;
-    /**
-     * Schedule a remote cursor re-render without re-normalizing awareness states.
-     * Performance optimization: avoids expensive Yjs position conversions on layout changes.
-     * Used when layout geometry changes but cursor positions haven't (e.g., zoom, scroll, reflow).
-     */
-    scheduleReRender(): void;
-    /**
-     * Set the callback to invoke when a scheduled re-render fires.
-     */
-    setReRenderCallback(callback: (() => void) | null): void;
-    /**
-     * Update remote cursor state by normalizing awareness states and rendering.
-     * Call this when awareness state has changed.
-     */
-    update(editorState: EditorState | null, deps: RenderDependencies): void;
-    /**
-     * Render remote cursors from existing state without normalization.
-     * Use this when only layout geometry has changed, not cursor positions.
-     */
-    render(deps: RenderDependencies): void;
-    /**
-     * Update local cursor position in awareness.
-     *
-     * CRITICAL FIX: The y-prosemirror cursor plugin only updates awareness when
-     * view.hasFocus() returns true. In PresentationEditor, the hidden PM EditorView
-     * may not have DOM focus. This method bypasses the focus check and manually
-     * updates awareness with the current selection position.
-     */
-    updateLocalCursor(editorState: EditorState | null): void;
-    /**
-     * Update presence options at runtime.
-     */
-    updatePresenceOptions(presence: PresenceOptions | undefined): void;
-    /**
-     * Check if there are any remote cursors to render.
-     */
-    hasRemoteCursors(): boolean;
-    /**
-     * Clean up all resources.
-     * Call this when destroying the PresentationEditor.
-     */
-    destroy(): void;
-}
-export {};
-//# sourceMappingURL=RemoteCursorManager.d.ts.map

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

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

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

@@ -1,122 +0,0 @@
-import { FlowBlock, Layout, Measure } from '@superdoc/contracts';
-import { PageGeometryHelper } from '@superdoc/layout-bridge';
-import { RemoteCursorState } from '../types.js';
-/**
- * Caret geometry in page-local layout space.
- */
-type CaretLayout = {
-    pageIndex: number;
-    x: number;
-    y: number;
-    height: number;
-};
-/**
- * Style constants for remote cursor rendering.
- *
- * @remarks
- * These values are centralized to ensure consistent visual appearance across all remote cursors.
- */
-type CursorStyles = {
-    /** Width of the caret line in pixels */
-    CARET_WIDTH: number;
-    /** Font size for user name labels in pixels */
-    LABEL_FONT_SIZE: number;
-    /** CSS padding value for labels (e.g., "2px 4px") */
-    LABEL_PADDING: string;
-    /** CSS offset value for label positioning (e.g., "-18px") */
-    LABEL_OFFSET: string;
-    /** CSS border-radius value for selection highlights */
-    SELECTION_BORDER_RADIUS: string;
-    /** Maximum character length for user name labels before truncation */
-    MAX_LABEL_LENGTH: number;
-};
-/**
- * Presence feature configuration options.
- *
- * @remarks
- * This type mirrors the public API's presence options but is defined locally to avoid
- * circular dependencies and maintain flexibility for internal implementation changes.
- */
-type PresenceOptionsLike = {
-    /** Whether presence rendering is enabled */
-    enabled?: boolean;
-    /** Maximum number of remote cursors to render simultaneously (performance guardrail) */
-    maxVisible?: number;
-    /** Whether to show user name labels above carets */
-    showLabels?: boolean;
-    /** Opacity value for selection highlights (0-1 range) */
-    highlightOpacity?: number;
-    /** Custom formatter for user name labels */
-    labelFormatter?: (user: RemoteCursorState['user']) => string;
-};
-/**
- * Renders all remote cursors and selections for collaborative editing.
- *
- * This function is the main entry point for rendering presence awareness. It orchestrates
- * the rendering of carets and selection highlights for all connected remote users, applying
- * performance guardrails and managing the lifecycle of DOM elements.
- *
- * @param options - Configuration object containing all dependencies and state
- *
- * @remarks
- * Performance guardrails:
- * - Limits the number of visible remote cursors using maxVisible (default: 20)
- * - Sorts cursors by most recent update to show the most active users
- * - Limits selection rectangles per user to prevent DOM explosion
- * - Uses GPU-accelerated transforms for smooth cursor movement
- * - Reuses existing DOM elements when possible to minimize DOM churn
- *
- * Rendering strategy:
- * - Clears old selection rectangles before rendering new state to prevent "stuck" selections
- * - Distinguishes between collapsed selections (caret-only) and range selections
- * - Removes DOM elements for clients that are no longer in the visible set
- * - Gracefully handles virtualized pages by fading out cursors on unmounted pages
- *
- * The function delegates to renderRemoteCaret for caret rendering and renderRemoteSelection
- * for selection highlight rendering, maintaining separation of concerns.
- *
- * @example
- * ```typescript
- * renderRemoteCursors({
- *   layout,
- *   blocks,
- *   measures,
- *   pageGeometryHelper,
- *   presence: { enabled: true, maxVisible: 10, showLabels: true },
- *   remoteCursorState: stateMap,
- *   remoteCursorElements: elementMap,
- *   remoteCursorOverlay: overlayElement,
- *   doc: document,
- *   computeCaretLayoutRect,
- *   convertPageLocalToOverlayCoords,
- *   fallbackColors,
- *   cursorStyles,
- *   maxSelectionRectsPerUser: 50,
- *   defaultPageHeight: 792,
- *   fallbackPageHeight: 792
- * });
- * ```
- */
-export declare function renderRemoteCursors(options: {
-    layout: Layout;
-    blocks: FlowBlock[];
-    measures: Measure[];
-    pageGeometryHelper: PageGeometryHelper | null;
-    presence: PresenceOptionsLike | undefined;
-    remoteCursorState: Map<number, RemoteCursorState>;
-    remoteCursorElements: Map<number, HTMLElement>;
-    remoteCursorOverlay: HTMLElement | null;
-    doc: Document;
-    computeCaretLayoutRect: (pos: number) => CaretLayout | null;
-    convertPageLocalToOverlayCoords: (pageIndex: number, x: number, y: number) => {
-        x: number;
-        y: number;
-    } | null;
-    fallbackColors: readonly string[];
-    cursorStyles: CursorStyles;
-    maxSelectionRectsPerUser: number;
-    defaultPageHeight: number;
-    fallbackPageHeight: number;
-}): void;
-export {};
-//# sourceMappingURL=RemoteCursorRendering.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"RemoteCursorRendering.d.ts","sourceRoot":"","sources":["../../../../../../../super-editor/src/core/presentation-editor/remote-cursors/RemoteCursorRendering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAQrD;;GAEG;AACH,KAAK,WAAW,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E;;;;;GAKG;AACH,KAAK,YAAY,GAAG;IAClB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,uBAAuB,EAAE,MAAM,CAAC;IAChC,sEAAsE;IACtE,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;GAMG;AACH,KAAK,mBAAmB,GAAG;IACzB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC;CAC9D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC9C,QAAQ,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC1C,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAClD,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/C,mBAAmB,EAAE,WAAW,GAAG,IAAI,CAAC;IACxC,GAAG,EAAE,QAAQ,CAAC;IACd,sBAAsB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;IAC5D,+BAA+B,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9G,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,YAAY,EAAE,YAAY,CAAC;IAC3B,wBAAwB,EAAE,MAAM,CAAC;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,IAAI,CAgFP"}

package/dist/super-editor/src/core/presentation-editor/selection/CaretGeometry.d.ts

@@ -1,53 +0,0 @@
-import { FlowBlock, Layout, Measure } from '@superdoc/contracts';
-/**
- * Represents the geometric layout information for a caret position.
- * @property pageIndex - The zero-based page index where the caret is located
- * @property x - The horizontal position in page-local coordinates (pixels)
- * @property y - The vertical position in page-local coordinates (pixels)
- * @property height - The height of the caret in pixels
- */
-export type CaretLayoutRect = {
-    pageIndex: number;
-    x: number;
-    y: number;
-    height: number;
-};
-/**
- * Dependencies required for computing caret geometry.
- */
-export type ComputeCaretLayoutRectGeometryDeps = {
-    layout: Layout | null;
-    blocks: FlowBlock[];
-    measures: Measure[];
-    painterHost: HTMLElement | null;
-    viewportHost: HTMLElement;
-    visibleHost: HTMLElement;
-    zoom: number;
-};
-/**
- * Computes the visual geometry for a caret at a given ProseMirror position.
- *
- * This function calculates the precise pixel coordinates and dimensions for rendering
- * a caret cursor, accounting for:
- * - Multi-page layouts with stacked pages
- * - List items with markers and first-line indent modes
- * - Table cells (delegates to DOM-based fallback)
- * - Virtualized content where DOM elements may not be mounted
- * - Zoom levels and coordinate transformations
- *
- * @param deps - Dependencies including layout, blocks, measures, and DOM elements
- * @param pos - The ProseMirror position where the caret should be placed
- * @param includeDomFallback - Whether to use DOM measurements as a fallback when available (default: true)
- * @returns Caret layout information or null if the position cannot be resolved
- *
- * @remarks
- * The function uses layout-engine measurements for geometry calculation, but can
- * fall back to DOM-based measurements when `includeDomFallback` is true and the
- * relevant DOM elements are available. This helps correct sub-pixel rendering
- * discrepancies that may occur between layout calculations and actual browser rendering.
- *
- * For table cells, the function always delegates to `computeTableCaretLayoutRectFromDom`
- * as table caret positioning requires complex cell boundary detection.
- */
-export declare function computeCaretLayoutRectGeometry({ layout, blocks, measures, painterHost, viewportHost, visibleHost, zoom }: ComputeCaretLayoutRectGeometryDeps, pos: number, includeDomFallback?: boolean): CaretLayoutRect | null;
-//# sourceMappingURL=CaretGeometry.d.ts.map

package/dist/super-editor/src/core/presentation-editor/selection/CaretGeometry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CaretGeometry.d.ts","sourceRoot":"","sources":["../../../../../../../super-editor/src/core/presentation-editor/selection/CaretGeometry.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,SAAS,EACT,MAAM,EAEN,OAAO,EAKR,MAAM,qBAAqB,CAAC;AAG7B;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAkD1F;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,WAAW,CAAC;IAC1B,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,8BAA8B,CAC5C,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,kCAAkC,EAC9G,GAAG,EAAE,MAAM,EACX,kBAAkB,UAAO,GACxB,eAAe,GAAG,IAAI,CA+HxB"}

package/dist/super-editor/src/core/presentation-editor/selection/CellSelectionOverlay.d.ts

@@ -1,80 +0,0 @@
-import { CellSelection } from 'prosemirror-tables';
-import { FlowBlock, Layout, Measure } from '@superdoc/contracts';
-/**
- * Coordinate pair in overlay space (absolute positioning within the selection overlay container).
- */
-type OverlayCoords = {
-    x: number;
-    y: number;
-};
-/**
- * Dependencies required to render cell selection overlays.
- *
- * @remarks
- * This type encapsulates all the state and helper functions needed to render visual highlights
- * for selected table cells. The separation of concerns allows the rendering logic to remain
- * pure and testable.
- */
-export type RenderCellSelectionOverlayDeps = {
-    /** ProseMirror CellSelection instance representing the selected cells */
-    selection: CellSelection;
-    /** Current layout state containing pages, fragments, and geometry information */
-    layout: Layout;
-    /** DOM element where selection highlight rectangles will be appended */
-    localSelectionLayer: HTMLElement;
-    /** Array of layout blocks (tables, paragraphs, etc.) */
-    blocks: FlowBlock[];
-    /** Array of measurement data corresponding to blocks (for row heights, column widths) */
-    measures: Measure[];
-    /** Optional table block ID hint to optimize table lookup */
-    cellAnchorTableBlockId?: string | null;
-    /** Function to convert page-local coordinates to overlay-absolute coordinates */
-    convertPageLocalToOverlayCoords: (pageIndex: number, x: number, y: number) => OverlayCoords | null;
-};
-/**
- * Renders visual highlighting for CellSelection (multiple table cells selected).
- *
- * This function creates semi-transparent blue overlay rectangles for each selected cell in a table,
- * accurately positioning them based on layout measurements. It handles complex table structures
- * including merged cells (colspan/rowspan), multi-page tables, and column boundary calculations.
- *
- * @param deps - Dependencies object containing selection state, layout data, and helper functions
- *
- * @remarks
- * Implementation details:
- * - Uses ProseMirror's TableMap to get accurate row/column positions for selected cells
- * - Accounts for colspan when calculating cell widths (sums multiple column boundaries)
- * - Accounts for rowspan when calculating cell heights (sums multiple row heights)
- * - Handles tables split across multiple pages via table fragments
- * - Uses table measures for precise row heights and column boundaries
- * - Falls back to estimated heights if measure data is unavailable
- * - Skips rendering cells on virtualized (unmounted) pages gracefully
- *
- * This function never throws; errors are caught and rendering gracefully degrades.
- * Invalid inputs or missing data result in warnings and early returns.
- *
- * Cell highlight styling:
- * - Position: absolute within localSelectionLayer
- * - Background: rgba(51, 132, 255, 0.35) (blue with 35% opacity)
- * - Pointer events: none (allows clicks to pass through)
- * - Class: 'presentation-editor__cell-selection-rect'
- *
- * @example
- * ```typescript
- * // Called during selection rendering cycle
- * if (selection instanceof CellSelection) {
- *   renderCellSelectionOverlay({
- *     selection,
- *     layout,
- *     localSelectionLayer,
- *     blocks,
- *     measures,
- *     cellAnchorTableBlockId,
- *     convertPageLocalToOverlayCoords
- *   });
- * }
- * ```
- */
-export declare function renderCellSelectionOverlay({ selection, layout, localSelectionLayer, blocks, measures, cellAnchorTableBlockId, convertPageLocalToOverlayCoords, }: RenderCellSelectionOverlayDeps): void;
-export {};
-//# sourceMappingURL=CellSelectionOverlay.d.ts.map

package/dist/super-editor/src/core/presentation-editor/selection/CellSelectionOverlay.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CellSelectionOverlay.d.ts","sourceRoot":"","sources":["../../../../../../../super-editor/src/core/presentation-editor/selection/CellSelectionOverlay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAA2C,MAAM,qBAAqB,CAAC;AAE/G;;GAEG;AACH,KAAK,aAAa,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,yEAAyE;IACzE,SAAS,EAAE,aAAa,CAAC;IACzB,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,mBAAmB,EAAE,WAAW,CAAC;IACjC,wDAAwD;IACxD,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,yFAAyF;IACzF,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,4DAA4D;IAC5D,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,iFAAiF;IACjF,+BAA+B,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,aAAa,GAAG,IAAI,CAAC;CACpG,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,SAAS,EACT,MAAM,EACN,mBAAmB,EACnB,MAAM,EACN,QAAQ,EACR,sBAAsB,EACtB,+BAA+B,GAChC,EAAE,8BAA8B,GAAG,IAAI,CAmMvC"}

package/dist/super-editor/src/core/presentation-editor/selection/LocalSelectionOverlayRendering.d.ts

@@ -1,103 +0,0 @@
-/**
- * Coordinates in overlay space (absolute positioning relative to the overlay container).
- */
-type OverlayCoords = {
-    x: number;
-    y: number;
-};
-/**
- * Represents a rectangular selection region in layout space.
- *
- * @remarks
- * Coordinates are in layout-space units and must be converted to overlay coordinates
- * for rendering. The pageIndex identifies which page the rectangle belongs to.
- */
-export type LayoutRect = {
-    pageIndex: number;
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-};
-/**
- * Represents a caret position in layout space.
- *
- * @remarks
- * Unlike LayoutRect, caret has no width (rendered as a 2px line). The height represents
- * the visual height of the caret at the insertion point.
- */
-export type CaretLayoutRect = {
-    pageIndex: number;
-    x: number;
-    y: number;
-    height: number;
-};
-/**
- * Dependencies required for rendering selection rectangles.
- */
-export type RenderSelectionRectsDeps = {
-    /** The DOM element that will contain the rendered selection rectangles */
-    localSelectionLayer: HTMLElement;
-    /** Array of layout-space rectangles representing the selection regions */
-    rects: LayoutRect[];
-    /** Height of each page in layout units */
-    pageHeight: number;
-    /** Vertical gap between pages in layout units */
-    pageGap: number;
-    /** Function to convert page-local coordinates to overlay coordinates, returns null if page is not visible */
-    convertPageLocalToOverlayCoords: (pageIndex: number, x: number, y: number) => OverlayCoords | null;
-};
-/**
- * Renders selection highlight rectangles by creating and appending DOM elements to the overlay layer.
- *
- * @param deps - Dependencies containing the selection layer, rectangles, and coordinate conversion function
- *
- * @remarks
- * This function creates individual div elements for each selection rectangle with:
- * - Semi-transparent blue background (rgba(51, 132, 255, 0.35))
- * - 2px border radius for visual polish
- * - Absolute positioning in overlay coordinates
- * - Pointer-events: none to allow interaction with underlying content
- *
- * Rectangles for pages that are not currently visible (convertPageLocalToOverlayCoords returns null)
- * are silently skipped. Width and height are in layout space; CSS transforms on the viewport
- * host handle scaling to screen coordinates.
- *
- * The function does not clear existing children from localSelectionLayer - callers should
- * clear it before calling if needed.
- */
-export declare function renderSelectionRects({ localSelectionLayer, rects, pageHeight, pageGap, convertPageLocalToOverlayCoords, }: RenderSelectionRectsDeps): void;
-/**
- * Dependencies required for rendering the caret overlay.
- */
-export type RenderCaretOverlayDeps = {
-    /** The DOM element that will contain the rendered caret */
-    localSelectionLayer: HTMLElement;
-    /** The caret position and dimensions in layout space */
-    caretLayout: CaretLayoutRect;
-    /** Function to convert page-local coordinates to overlay coordinates, returns null if page is not visible */
-    convertPageLocalToOverlayCoords: (pageIndex: number, x: number, y: number) => OverlayCoords | null;
-};
-/**
- * Renders the text cursor (caret) by creating and appending a DOM element to the overlay layer.
- *
- * @param deps - Dependencies containing the selection layer, caret position, and coordinate conversion function
- *
- * @remarks
- * This function creates a single div element representing the text cursor with:
- * - 2px width and height from caretLayout
- * - Black color (#000000)
- * - 1px border radius for visual polish
- * - Absolute positioning in overlay coordinates
- * - Pointer-events: none to allow interaction with underlying content
- *
- * If the caret's page is not currently visible (convertPageLocalToOverlayCoords returns null),
- * no caret element is created. The height is in layout space; CSS transforms on the viewport
- * host handle scaling to screen coordinates.
- *
- * The function does not clear existing children from localSelectionLayer - callers should
- * clear it before calling if a fresh render is needed.
- */
-export declare function renderCaretOverlay({ localSelectionLayer, caretLayout, convertPageLocalToOverlayCoords, }: RenderCaretOverlayDeps): void;
-export {};
-//# sourceMappingURL=LocalSelectionOverlayRendering.d.ts.map

package/dist/super-editor/src/core/presentation-editor/selection/LocalSelectionOverlayRendering.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"LocalSelectionOverlayRendering.d.ts","sourceRoot":"","sources":["../../../../../../../super-editor/src/core/presentation-editor/selection/LocalSelectionOverlayRendering.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,KAAK,aAAa,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpG;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1F;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,0EAA0E;IAC1E,mBAAmB,EAAE,WAAW,CAAC;IACjC,0EAA0E;IAC1E,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,6GAA6G;IAC7G,+BAA+B,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,aAAa,GAAG,IAAI,CAAC;CACpG,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,mBAAmB,EACnB,KAAK,EACL,UAAU,EACV,OAAO,EACP,+BAA+B,GAChC,EAAE,wBAAwB,GAAG,IAAI,CAuBjC;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,2DAA2D;IAC3D,mBAAmB,EAAE,WAAW,CAAC;IACjC,wDAAwD;IACxD,WAAW,EAAE,eAAe,CAAC;IAC7B,6GAA6G;IAC7G,+BAA+B,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,aAAa,GAAG,IAAI,CAAC;CACpG,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,mBAAmB,EACnB,WAAW,EACX,+BAA+B,GAChC,EAAE,sBAAsB,GAAG,IAAI,CAuB/B"}

package/dist/super-editor/src/core/presentation-editor/selection/SelectionDebug.d.ts

@@ -1,40 +0,0 @@
-export type SelectionDebugLogLevel = 'off' | 'error' | 'warn' | 'info' | 'verbose';
-export type SelectionDebugConfig = {
-    logLevel: SelectionDebugLogLevel;
-    hud: boolean;
-    dumpRects: boolean;
-    disableRectDedupe: boolean;
-};
-export type SelectionDebugHudState = {
-    docEpoch: number;
-    layoutEpoch: number;
-    selection: {
-        from: number;
-        to: number;
-    } | null;
-    lastPointer: {
-        clientX: number;
-        clientY: number;
-        x: number;
-        y: number;
-    } | null;
-    lastHit: {
-        source: 'dom' | 'geometry' | 'margin' | 'none';
-        pos: number | null;
-        layoutEpoch: number | null;
-        mappedPos: number | null;
-    } | null;
-};
-type SuperdocDebugRoot = {
-    selection?: Partial<SelectionDebugConfig>;
-};
-declare global {
-    interface Window {
-        superdocDebug?: SuperdocDebugRoot;
-    }
-}
-export declare function getSelectionDebugConfig(): SelectionDebugConfig;
-export declare function debugLog(level: Exclude<SelectionDebugLogLevel, 'off'>, message: string, data?: Record<string, unknown>): void;
-export declare function updateSelectionDebugHud(host: HTMLElement, state: SelectionDebugHudState): void;
-export {};
-//# sourceMappingURL=SelectionDebug.d.ts.map

package/dist/super-editor/src/core/presentation-editor/selection/SelectionDebug.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SelectionDebug.d.ts","sourceRoot":"","sources":["../../../../../../../super-editor/src/core/presentation-editor/selection/SelectionDebug.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEnF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/C,WAAW,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,GAAG,IAAI,CAAC;IACT,OAAO,EAAE;QACP,MAAM,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;QAC/C,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,GAAG,IAAI,CAAC;CACV,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC3C,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,aAAa,CAAC,EAAE,iBAAiB,CAAC;KACnC;CACF;AAgBD,wBAAgB,uBAAuB,IAAI,oBAAoB,CAe9D;AAED,wBAAgB,QAAQ,CACtB,KAAK,EAAE,OAAO,CAAC,sBAAsB,EAAE,KAAK,CAAC,EAC7C,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAWN;AAID,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAoD9F"}