@k2b/ui 0.34.0 → 0.36.0

package/dist/types/text-editor/table.d.ts

@@ -0,0 +1,81 @@
+import { EditorState, type Extension, Facet } from "@codemirror/state";
+import { EditorView } from "@codemirror/view";
+import { type InlineFormat } from "./format";
+import * as T from "./markdown-table";
+export type TableTarget = {
+    tableFrom: number;
+    rowFrom: number;
+    columnFrom: number;
+    row: number;
+    column: number;
+};
+/** Resolve a server-returned identity against the current document immediately before focus. */
+export type TableFocusTarget = () => TableTarget | null;
+export type TableHost = {
+    undo: () => void;
+    redo: () => void;
+    boundary: () => void;
+    cellLabel: (row: number, column: number, name?: string) => string;
+    sourceLabels?: () => {
+        edit: string;
+        valid: string;
+        invalid: string;
+        changed: string;
+        structural: string;
+        applying?: string;
+        applyFailed?: string;
+        done: string;
+        discard: string;
+        continue: string;
+        line?: (line: number) => string;
+        separator?: (header: number, separator: number) => string;
+        extra?: (line: number) => string;
+        complete?: string;
+    };
+    actionLabel?: (action: "rowMenu" | "columnMenu" | "addRow" | "addColumn" | "emptyCell") => string;
+    /** Respect a host's personal Tab-for-focus preference inside cells too. */
+    tabMovesFocus?: () => boolean;
+    /** Capture durable anchors synchronously, then send the action to the owning server. */
+    structure?: {
+        available: () => boolean;
+        perform: (action: MenuAction, target: TableTarget) => Promise<TableFocusTarget | void>;
+        /** Resolves only after the confirmed update is applied; rejects without discarding the draft. */
+        replaceSource?: (target: TableTarget, expected: string, source: string, caret: {
+            row: number;
+            column: number;
+        }) => Promise<TableFocusTarget | void>;
+    };
+    onError: (code: "structureUnavailable" | "structureFailed" | "pasteTooLarge" | "textTooLarge" | "cellRemoved") => void;
+    onRecovery: (text: string) => void;
+    /** Cell focus is separate from CodeMirror contentDOM focus; collaboration maps these offsets to its own cursor. */
+    onCellSelection?: (selection: {
+        anchor: number;
+        head: number;
+    } | null) => void;
+    onDroppedImages?: (count: number, files: File[]) => void;
+    maxLength: number;
+    maxPasteCells: number;
+    /** App-owned presentation, e.g. formula results. Called only outside the active cell. */
+    renderCell?: (element: HTMLElement, raw: string, table: T.Table, row: number, column: number) => void;
+};
+export type MenuAction = "completeColumns" | "rowAbove" | "rowBelow" | "colLeft" | "colRight" | "deleteRow" | "deleteCol" | "moveRowUp" | "moveRowDown" | "moveColLeft" | "moveColRight" | "toggleHeader" | "deleteTable" | "alignLeft" | "alignCenter" | "alignRight";
+export declare const tableHost: Facet<TableHost, TableHost | null>;
+export declare const tablesIn: (state: EditorState) => T.Table[];
+/** A local source draft for one table. Invalid drafts never replace shared text.
+ * Collaborative structure changes require the host's confirmed anchored action. */
+export declare const editTableSource: (view: EditorView, wrap: HTMLElement) => void;
+export declare const tableActionEnabled: (view: EditorView, wrap: HTMLElement, action: MenuAction) => boolean;
+/** Copy the visible table through the browser clipboard, with spreadsheet and rich-text payloads. */
+export declare const copyTable: (view: EditorView, wrap: HTMLElement, format: "table" | "markdown") => Promise<void>;
+export declare const runMenuAction: (view: EditorView, wrap: HTMLElement, action: MenuAction) => void;
+/** Structural actions also work in source mode, without a mounted table widget. */
+export declare const runTableAction: (view: EditorView, tableFrom: number, r: number, c: number, action: MenuAction, 
+/** `false` when the gesture already moved the caret out of the table: the result must not pull it back. */
+options?: {
+    follow?: boolean;
+}) => void;
+/** Route formatting to the active cell instead of the hidden outer-editor caret. */
+export declare const formatActiveCell: (view: EditorView, name: InlineFormat) => boolean;
+/** First `<table>` of pasted HTML as a grid (Excel, Sheets, Word, web pages). */
+export declare const htmlTableGrid: (html: string) => string[][] | null;
+export declare const tableGrid: () => Extension;

package/dist/types/text-editor.d.ts

@@ -0,0 +1,4 @@
+export { createTextEditor, type TextEditorController, type TextEditorMode, type TextEditorOptions } from "./text-editor/engine";
+export { commands as textEditorCommands, formatLabels as textEditorFormatLabels, type InlineFormat } from "./text-editor/format";
+export { TableSizePicker, type TableSizePickerProps, TextEditor, type TextEditorControls, type TextEditorProps, } from "./text-editor/TextEditor";
+export { editTableSource, type MenuAction, runMenuAction, runTableAction, type TableFocusTarget, type TableHost, type TableTarget, tableGrid, tableHost, } from "./text-editor/table";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k2b/ui",
-  "version": "0.34.0",
+  "version": "0.36.0",
   "description": "Production-ready components for SolidJS applications.",
   "repository": {
     "type": "git",
@@ -37,7 +37,18 @@
       "default": "./dist/ssr/charts.js"
     },
     "./package.json": "./package.json",
-    "./map-glyphs/*": "./map-glyphs/*"
+    "./map-glyphs/*": "./map-glyphs/*",
+    "./text-editor": {
+      "types": "./dist/types/text-editor.d.ts",
+      "browser": "./dist/browser/text-editor.js",
+      "import": "./dist/ssr/text-editor.js",
+      "default": "./dist/ssr/text-editor.js"
+    },
+    "./text-editor/model": {
+      "types": "./dist/types/text-editor/markdown-table.d.ts",
+      "import": "./dist/ssr/text-editor/markdown-table.js",
+      "default": "./dist/ssr/text-editor/markdown-table.js"
+    }
   },
   "files": [
     "dist",
@@ -55,12 +66,19 @@
     "prepack": "bun run build"
   },
   "dependencies": {
+    "@codemirror/commands": "6.10.4",
+    "@codemirror/language": "6.12.4",
+    "@codemirror/state": "6.7.1",
+    "@codemirror/view": "6.43.7",
     "@fontsource/ibm-plex-mono": "5.3.0",
     "@fontsource/ibm-plex-sans": "5.3.0",
     "@k2b/stdlib": "0.30.0",
+    "@lezer/markdown": "1.7.2",
     "@tabler/icons-webfont": "3.48.0",
+    "dompurify": "3.4.17",
     "maplibre-gl": "6.14.0",
     "marked": "18.0.14",
+    "pbf": "5.1.2",
     "qr-scanner": "1.4.2"
   },
   "peerDependencies": {
@@ -86,7 +104,10 @@
     "typescript": "7.0.2",
     "@typescript/typescript6": "6.0.2",
     "@maplibre/maplibre-gl-style-spec": "26.4.4",
-    "fontnik": "0.7.7"
+    "fontnik": "0.7.7",
+    "yjs": "13.6.33",
+    "y-codemirror.next": "0.3.6",
+    "y-protocols": "1.0.7"
   },
   "publishConfig": {
     "access": "public"