@threadlabs/looma 0.1.0

package/editor/extensions/index.d.ts

@@ -0,0 +1,78 @@
+import * as _tiptap_core from '@tiptap/core';
+import { AnyExtension, Editor, Range } from '@tiptap/core';
+import { a as TableOverlayActionEventDetail } from '../table-overlay-DTr3KC9e.js';
+import * as _tiptap_extension_table_cell from '@tiptap/extension-table-cell';
+import * as _tiptap_extension_table_header from '@tiptap/extension-table-header';
+import * as _tiptap_extension_table from '@tiptap/extension-table';
+
+/**
+ * Default Tiptap extension preset for Looma editor.
+ * Uses Vanilla JS Tiptap API; apps install @tiptap/core and extensions and pass this to Editor.
+ */
+
+interface DefaultEditorExtensionsOptions {
+    placeholder?: string;
+    linkOpenOnClick?: boolean;
+    imageInline?: boolean;
+}
+/**
+ * Returns the default Looma editor extensions (Vanilla Tiptap).
+ * Use with new Editor({ extensions: getDefaultEditorExtensions(), ... }) or framework useEditor().
+ */
+declare function getDefaultEditorExtensions(options?: DefaultEditorExtensionsOptions): AnyExtension[];
+
+/**
+ * Table overlay action handler — maps boundaryIndex to Tiptap table commands.
+ * Use with looma-editor-table-overlay-action: call this from the adapter's handler.
+ */
+
+interface InsertTableAtRangeOptions {
+    rows?: number;
+    cols?: number;
+    withHeaderRow?: boolean;
+}
+/**
+ * Deletes a slash-command range (or other inline trigger text) and inserts a table.
+ * Use this when apps want a stable default `/table` behavior without owning table policy.
+ */
+declare function insertTableAtRange(editor: Editor, range: Range, options?: InsertTableAtRangeOptions): boolean;
+/**
+ * Reconciles rendered column widths back into table-cell colwidth attrs so a resized
+ * full-width table stays inside the editor width after resize completes.
+ */
+declare function normalizeActiveTableColumnWidths(editor: Editor, tableElement: HTMLTableElement, minWidth?: number): boolean;
+/**
+ * Handles a table overlay action by selecting the target cell and running the Tiptap command.
+ * Call this from your adapter's onTableOverlayAction handler.
+ *
+ * @example
+ * ```vue
+ * <EditorTableOverlay
+ *   :open="tableOverlayOpen"
+ *   :rows="tableRows"
+ *   :cols="tableCols"
+ *   @looma-editor-table-overlay-action="(e) => handleTableOverlayAction(editor, e.detail)"
+ * />
+ * ```
+ */
+declare function handleTableOverlayAction(editor: Editor, detail: TableOverlayActionEventDetail): boolean;
+
+type TableCellAlignment = "left" | "center" | "right";
+type TableCellBackground = string | null;
+declare const TABLE_CELL_BACKGROUND_PRESETS: {
+    readonly none: null;
+    readonly gray: "#f3f4f6";
+    readonly yellow: "#fef3c7";
+    readonly blue: "#dbeafe";
+    readonly green: "#dcfce7";
+    readonly red: "#fee2e2";
+};
+declare const LoomaTable: _tiptap_core.Node<_tiptap_extension_table.TableOptions, any>;
+declare const LoomaTableHeader: _tiptap_core.Node<_tiptap_extension_table_header.TableHeaderOptions, any>;
+declare const LoomaTableCell: _tiptap_core.Node<_tiptap_extension_table_cell.TableCellOptions, any>;
+declare function getActiveTableCellAlignment(editor: Editor): TableCellAlignment;
+declare function getActiveTableCellBackground(editor: Editor): TableCellBackground;
+declare function setActiveTableCellAlignment(editor: Editor, alignment: TableCellAlignment): boolean;
+declare function setActiveTableCellBackground(editor: Editor, backgroundColor: TableCellBackground): boolean;
+
+export { type DefaultEditorExtensionsOptions, type InsertTableAtRangeOptions, LoomaTable, LoomaTableCell, LoomaTableHeader, TABLE_CELL_BACKGROUND_PRESETS, type TableCellAlignment, type TableCellBackground, getActiveTableCellAlignment, getActiveTableCellBackground, getDefaultEditorExtensions, handleTableOverlayAction, insertTableAtRange, normalizeActiveTableColumnWidths, setActiveTableCellAlignment, setActiveTableCellBackground };

package/editor/extensions/index.js

@@ -0,0 +1,28 @@
+import {
+  LoomaTable,
+  LoomaTableCell,
+  LoomaTableHeader,
+  TABLE_CELL_BACKGROUND_PRESETS,
+  getActiveTableCellAlignment,
+  getActiveTableCellBackground,
+  getDefaultEditorExtensions,
+  handleTableOverlayAction,
+  insertTableAtRange,
+  normalizeActiveTableColumnWidths,
+  setActiveTableCellAlignment,
+  setActiveTableCellBackground
+} from "../chunk-JKRA4D4W.js";
+export {
+  LoomaTable,
+  LoomaTableCell,
+  LoomaTableHeader,
+  TABLE_CELL_BACKGROUND_PRESETS,
+  getActiveTableCellAlignment,
+  getActiveTableCellBackground,
+  getDefaultEditorExtensions,
+  handleTableOverlayAction,
+  insertTableAtRange,
+  normalizeActiveTableColumnWidths,
+  setActiveTableCellAlignment,
+  setActiveTableCellBackground
+};

package/editor/index.d.ts

@@ -0,0 +1,7 @@
+export { InsertTableEventDetail, SlashMenuAnchorRect, SlashMenuHighlightEventDetail, SlashMenuItem, SlashMenuSelectEventDetail, TableContextMenuAction, TableContextMenuActionEventDetail, TableContextMenuActionEventDetail as TableToolbarActionEventDetail } from './ui.js';
+export { T as TableOverlayAction, a as TableOverlayActionEventDetail } from './table-overlay-DTr3KC9e.js';
+export { DefaultEditorExtensionsOptions, InsertTableAtRangeOptions, LoomaTable, LoomaTableCell, LoomaTableHeader, TABLE_CELL_BACKGROUND_PRESETS, TableCellAlignment, TableCellBackground, getActiveTableCellAlignment, getActiveTableCellBackground, getDefaultEditorExtensions, handleTableOverlayAction, insertTableAtRange, normalizeActiveTableColumnWidths, setActiveTableCellAlignment, setActiveTableCellBackground } from './extensions/index.js';
+import '@tiptap/core';
+import '@tiptap/extension-table-cell';
+import '@tiptap/extension-table-header';
+import '@tiptap/extension-table';

package/editor/index.js

@@ -0,0 +1,29 @@
+import "./chunk-NOOV344H.js";
+import {
+  LoomaTable,
+  LoomaTableCell,
+  LoomaTableHeader,
+  TABLE_CELL_BACKGROUND_PRESETS,
+  getActiveTableCellAlignment,
+  getActiveTableCellBackground,
+  getDefaultEditorExtensions,
+  handleTableOverlayAction,
+  insertTableAtRange,
+  normalizeActiveTableColumnWidths,
+  setActiveTableCellAlignment,
+  setActiveTableCellBackground
+} from "./chunk-JKRA4D4W.js";
+export {
+  LoomaTable,
+  LoomaTableCell,
+  LoomaTableHeader,
+  TABLE_CELL_BACKGROUND_PRESETS,
+  getActiveTableCellAlignment,
+  getActiveTableCellBackground,
+  getDefaultEditorExtensions,
+  handleTableOverlayAction,
+  insertTableAtRange,
+  normalizeActiveTableColumnWidths,
+  setActiveTableCellAlignment,
+  setActiveTableCellBackground
+};

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

@@ -0,0 +1,12 @@
+/**
+ * ui-editor-table-overlay — table edge controls for row/column insertion.
+ * Emits looma-editor-table-overlay-action with insertion intent.
+ * Domain-neutral: no Tiptap dependency.
+ */
+type TableOverlayAction = "add-row-before" | "add-row-after" | "add-column-before" | "add-column-after";
+interface TableOverlayActionEventDetail {
+    action: TableOverlayAction;
+    boundaryIndex: number;
+}
+
+export type { TableOverlayAction as T, TableOverlayActionEventDetail as a };

package/editor/ui.d.ts

@@ -0,0 +1,48 @@
+export { T as TableOverlayAction, a as TableOverlayActionEventDetail } from './table-overlay-DTr3KC9e.js';
+
+/**
+ * ui-editor-table-context-menu — web component for table cell context menu.
+ * Emits custom events for each action; the adapter (Vue/React) wires Tiptap commands.
+ * Domain-neutral: no Tiptap dependency.
+ */
+type TableContextMenuAction = "align-left" | "align-center" | "align-right" | "background-none" | "background-gray" | "background-yellow" | "background-blue" | "background-green" | "background-red" | "add-row-before" | "add-row-after" | "add-column-before" | "add-column-after" | "delete-row" | "delete-column" | "delete-table" | "merge-cells" | "split-cell";
+interface TableContextMenuActionEventDetail {
+    action: TableContextMenuAction;
+}
+
+/**
+ * ui-editor-insert-table-grid — web component for picking table dimensions.
+ * Emits looma-editor-insert-table with { rows, cols, withHeaderRow }.
+ * Domain-neutral: no Tiptap dependency.
+ */
+interface InsertTableEventDetail {
+    rows: number;
+    cols: number;
+    withHeaderRow: boolean;
+}
+
+/**
+ * ui-editor-slash-menu — floating slash-command menu.
+ * Apps own the command list and suggestion state; Looma owns the chrome.
+ */
+interface SlashMenuItem {
+    title: string;
+    description: string;
+    icon: string;
+}
+interface SlashMenuHighlightEventDetail {
+    index: number;
+}
+interface SlashMenuSelectEventDetail {
+    index: number;
+}
+/**
+ * A viewport rectangle accepted by the slash-menu anchor.
+ *
+ * Browser DOMRect objects satisfy both variants. Plain rectangles from Tiptap
+ * and ProseMirror are also supported when they provide either edge coordinates
+ * or an origin plus dimensions.
+ */
+type SlashMenuAnchorRect = Pick<DOMRectReadOnly, "left" | "top" | "right" | "bottom"> | Pick<DOMRectReadOnly, "x" | "y" | "width" | "height">;
+
+export type { InsertTableEventDetail, SlashMenuAnchorRect, SlashMenuHighlightEventDetail, SlashMenuItem, SlashMenuSelectEventDetail, TableContextMenuAction, TableContextMenuActionEventDetail, TableContextMenuActionEventDetail as TableToolbarActionEventDetail };

package/editor/ui.js

@@ -0,0 +1 @@
+import "./chunk-NOOV344H.js";