@threadlabs/looma 0.3.1 → 0.5.0

package/editor/table-overlay-DZFGHQDt.d.ts

@@ -1,138 +0,0 @@
-/** Canonical persisted colors shared by editor commands and table UI swatches. */
-declare const TABLE_CELL_BACKGROUND_PRESETS: {
-    readonly none: null;
-    readonly gray: "#f3f4f6";
-    readonly yellow: "#fef3c7";
-    readonly blue: "#dbeafe";
-    readonly green: "#dcfce7";
-    readonly red: "#fee2e2";
-};
-/** Ordered menu choices coupling each UI intent to its persisted color value. */
-declare const TABLE_CELL_BACKGROUND_OPTIONS: readonly [{
-    readonly action: "background-none";
-    readonly label: "Default";
-    readonly value: null;
-    readonly swatch: null;
-}, {
-    readonly action: "background-gray";
-    readonly label: "Gray";
-    readonly value: "#f3f4f6";
-    readonly swatch: "#f3f4f6";
-}, {
-    readonly action: "background-yellow";
-    readonly label: "Yellow";
-    readonly value: "#fef3c7";
-    readonly swatch: "#fef3c7";
-}, {
-    readonly action: "background-blue";
-    readonly label: "Blue";
-    readonly value: "#dbeafe";
-    readonly swatch: "#dbeafe";
-}, {
-    readonly action: "background-green";
-    readonly label: "Green";
-    readonly value: "#dcfce7";
-    readonly swatch: "#dcfce7";
-}, {
-    readonly action: "background-red";
-    readonly label: "Red";
-    readonly value: "#fee2e2";
-    readonly swatch: "#fee2e2";
-}];
-/** Background-only action vocabulary derived from the canonical menu choices. */
-type TableCellBackgroundAction = typeof TABLE_CELL_BACKGROUND_OPTIONS[number]["action"];
-
-/** Intent contracts shared by declarative table menus and editor adapters. */
-
-/**
- * Complete intent vocabulary emitted by table chrome for an adapter to execute.
- * Keeping this as data prevents the reusable menu from importing or mutating a
- * particular editor implementation.
- */
-type TableContextMenuAction = "align-left" | "align-center" | "align-right" | TableCellBackgroundAction | "add-row-before" | "add-row-after" | "add-column-before" | "add-column-after" | "delete-row" | "delete-column" | "delete-table" | "clear-cells" | "merge-cells" | "split-cell";
-/** Adapter-facing payload that keeps the menu independent of editor commands. */
-interface TableContextMenuActionEventDetail {
-    action: TableContextMenuAction;
-}
-
-/**
- * ui-editor-table-overlay — anticipatory table affordances.
- * Domain-neutral: it emits intent while the adapter owns editor commands.
- */
-/** Table-structure mutations addressed by a measured row/column boundary. */
-type TableInsertionAction = "add-row-before" | "add-row-after" | "add-column-before" | "add-column-after";
-/**
- * Intent vocabulary emitted by the headless table overlay.
- * UI stays independent of Tiptap/ProseMirror positions; adapters translate
- * these logical coordinates with `handleTableOverlayAction`.
- */
-type TableOverlayAction = TableInsertionAction | "select-row" | "select-column" | "open-cell-menu";
-/**
- * Discriminated action payload.
- * Boundary indices refer to entries in the measured boundary arrays. Cell
- * indices refer to the logical grid after row/column spans are expanded. The
- * menu anchor uses CSS-pixel viewport coordinates suitable for fixed surfaces.
- */
-type TableOverlayActionEventDetail = {
-    action: TableInsertionAction;
-    boundaryIndex: number;
-} | {
-    action: "select-row" | "select-column";
-    rowIndex: number;
-    columnIndex: number;
-} | {
-    action: "open-cell-menu";
-    rowIndex: number;
-    columnIndex: number;
-    anchor: {
-        left: number;
-        top: number;
-        right: number;
-        bottom: number;
-    };
-};
-/**
- * A cell rectangle relative to the table's border box, plus logical grid
- * coordinates. Width/height include spans because they come from the rendered
- * cell rather than an inferred uniform grid.
- */
-interface ActiveCellRect {
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-    rowIndex: number;
-    columnIndex: number;
-}
-/**
- * Replaceable geometry snapshot for overlay rendering.
- * Boundaries are CSS-pixel offsets relative to the table; callers should
- * remeasure after editor transactions or layout changes rather than mutate the
- * arrays in place.
- */
-interface TableOverlayGeometry {
-    rowBoundaries: number[];
-    columnBoundaries: number[];
-    activeCell: ActiveCellRect | null;
-    hoveredCell?: ActiveCellRect | null;
-}
-/**
- * Resolves a logical grid coordinate to its owning DOM cell.
- * A spanning cell can therefore be returned for more than one coordinate; this
- * is intentional and prevents overlay actions from inventing nonexistent cells.
- *
- * @contract Coordinates outside the expanded table grid return null; coordinates
- * covered by a span resolve to the single DOM cell that owns them.
- */
-declare function resolveTableCellAt(table: HTMLTableElement, rowIndex: number, columnIndex: number): HTMLTableCellElement | null;
-/**
- * Measures rendered boundaries rather than assuming a uniform table grid.
- * Returned offsets are table-relative and rounded to hundredths of a CSS pixel
- * to suppress observer churn without losing subpixel layout fidelity.
- *
- * @contract Active and hovered rectangles are returned only for cells contained
- * by the supplied table; detached or foreign cells are represented as null.
- */
-declare function measureTableOverlayGeometry(table: HTMLTableElement, activeCell: HTMLTableCellElement | null, hoveredCell?: HTMLTableCellElement | null): TableOverlayGeometry;
-
-export { type ActiveCellRect as A, TABLE_CELL_BACKGROUND_OPTIONS as T, TABLE_CELL_BACKGROUND_PRESETS as a, type TableCellBackgroundAction as b, type TableContextMenuAction as c, type TableContextMenuActionEventDetail as d, type TableInsertionAction as e, type TableOverlayAction as f, type TableOverlayActionEventDetail as g, type TableOverlayGeometry as h, measureTableOverlayGeometry as m, resolveTableCellAt as r };