@k2b/ui 0.33.0 → 0.35.0

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

@@ -0,0 +1,113 @@
+export declare const textEditorMessages: import("@k2b/stdlib").Catalog<{
+    formatting: string;
+    formatted: string;
+    source: string;
+    view: string;
+    loading: string;
+    bold: string;
+    italic: string;
+    heading: string;
+    heading1: string;
+    heading2: string;
+    heading3: string;
+    strike: string;
+    codeBlock: string;
+    inlineCode: string;
+    column: (column: number) => string;
+    menuRow: (row: number) => string;
+    menuColumn: (name: string) => string;
+    menuAbove: string;
+    menuBelow: string;
+    menuUp: string;
+    menuDown: string;
+    menuInsertLeft: string;
+    menuInsertRight: string;
+    menuMoveLeft: string;
+    menuMoveRight: string;
+    menuDelete: string;
+    menuCopy: string;
+    menuMarkdown: string;
+    columnAlignment: (column: number) => string;
+    discardRecovery: string;
+    bulletList: string;
+    orderedList: string;
+    quote: string;
+    link: string;
+    code: string;
+    table: string;
+    insertTable: string;
+    rows: string;
+    columns: string;
+    insertSize: ({ rows, columns }: {
+        rows: number;
+        columns: number;
+    }) => string;
+    rule: string;
+    rowAbove: string;
+    rowBelow: string;
+    colLeft: string;
+    colRight: string;
+    deleteRow: string;
+    deleteCol: string;
+    moveRowUp: string;
+    moveRowDown: string;
+    moveColLeft: string;
+    moveColRight: string;
+    toggleHeader: string;
+    deleteTable: string;
+    alignment: string;
+    copyTable: string;
+    copyMarkdown: string;
+    copyingTable: string;
+    copiedTable: string;
+    copiedMarkdown: string;
+    copyFailed: string;
+    alignLeft: string;
+    alignCenter: string;
+    alignRight: string;
+    cellLabel: ({ row, column, name }: {
+        row: number;
+        column: number;
+        name?: string;
+    }) => string;
+    structureUnavailable: string;
+    recoveredInput: string;
+    cellRemoved: string;
+    structureFailed: string;
+    pasteTooLarge: string;
+    textTooLarge: string;
+    checkTable: string;
+    checkTableDetail: string;
+    checkSeparatorDetail: string;
+    reviewMarkdown: string;
+    imageHint: string;
+    dismiss: string;
+    tableMenu: string;
+    tableChanged: ({ rows, columns }: {
+        rows: number;
+        columns: number;
+    }) => string;
+    rowMenu: string;
+    columnMenu: string;
+    addRow: string;
+    emptyCell: string;
+    editMarkdown: string;
+    showTable: string;
+    done: string;
+    markdownValid: string;
+    markdownInvalid: string;
+    markdownLine: (line: number) => string;
+    markdownSeparator: ({ header, separator }: {
+        header: number;
+        separator: number;
+    }) => string;
+    markdownExtra: (line: number) => string;
+    applyingTable: string;
+    markdownApplyFailed: string;
+    markdownStructural: string;
+    markdownChanged: string;
+    discardMarkdown: string;
+    continueMarkdown: string;
+    addColumn: string;
+    completeColumns: string;
+}>;

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

@@ -0,0 +1,6 @@
+/** HTML clipboard content as Markdown; `null` when it is better pasted as plain text. */
+export declare const htmlToMarkdown: (html: string) => {
+    markdown: string;
+    droppedImages: number;
+} | null;
+export declare const cleanPaste: (onDroppedImages?: (count: number, files: File[]) => void, plain?: boolean) => import("@codemirror/state").Extension;

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/dist/types/widgets/Widget.d.ts

@@ -1,7 +1,8 @@
 import { type JSX } from "solid-js";
 /**
- * `standard` is 25rem high and `compact` 14rem; `fill` takes the height its container gives it, such as a grid cell,
- * and `content` has no fixed height. Every size except `content` scrolls body content taller than itself.
+ * `standard` is 25rem high and `compact` 14rem; `fill` takes the height and the width its container gives it, such as
+ * a grid cell, and does not size itself from its content; `content` has no fixed height. Every size except `content`
+ * scrolls body content taller than itself.
  */
 export type WidgetSize = "content" | "compact" | "standard" | "fill";
 export type WidgetProps = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k2b/ui",
-  "version": "0.33.0",
+  "version": "0.35.0",
   "description": "Production-ready components for SolidJS applications.",
   "repository": {
     "type": "git",
@@ -31,8 +31,24 @@
       "browser": "./dist/browser/chart-inspection.js",
       "default": "./dist/browser/chart-inspection.js"
     },
+    "./charts": {
+      "types": "./dist/types/charts.d.ts",
+      "browser": "./dist/browser/charts.js",
+      "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",
@@ -50,10 +66,16 @@
     "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",
     "qr-scanner": "1.4.2"
@@ -81,7 +103,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"