@rowsncolumns/ui 15.0.38

package/dist/cjs/editor-pm/helpers.d.ts

@@ -0,0 +1,197 @@
+import type { ParsedToken } from "@rowsncolumns/calculator";
+import { Node, Schema } from "prosemirror-model";
+import { EditorState } from "prosemirror-state";
+import { EditorView } from "prosemirror-view";
+import { TextFormatRun } from "./types";
+export type LeafDecorator = {
+    cursor?: boolean;
+    color?: string;
+    bold?: boolean;
+};
+/**
+ * Converts string to ProseMirror document
+ * @param str
+ * @param schema
+ * @returns
+ */
+export declare const deserializeString: (str: string, schema: any) => any;
+export declare const tryParseRichText: (str: any) => any;
+/**
+ * Converts ProseMirror document to string
+ * @param doc
+ * @returns
+ */
+export declare const serializeEditorValue: (doc: Node) => string;
+/**
+ * Extracts text format runs from ProseMirror document
+ * @param doc ProseMirror document node
+ * @returns Array of TextFormatRun objects
+ */
+export declare const extractTextFormatRuns: (doc?: Node) => TextFormatRun[] | undefined | null;
+/**
+ * Applies text format runs to create a ProseMirror document
+ * @param text The plain text content
+ * @param formatRuns Array of TextFormatRun objects
+ * @param schema ProseMirror schema
+ * @returns ProseMirror document node
+ */
+/**
+ * Resolves a run color to a CSS string. `TextFormat.color` can be a theme
+ * reference object (`{ theme, tint }`) rather than a plain string — the
+ * editor's color mark renders `color: <value>` verbatim, so an unresolved
+ * object paints nothing and the cell's base color shows through (the
+ * "everything turns red on edit" report). Hosts pass a theme-aware resolver;
+ * without one, only string colors produce a mark.
+ */
+export type RunColorResolver = (color: unknown) => string | undefined;
+export declare const applyTextFormatRuns: (text: string, formatRuns: TextFormatRun[] | undefined | null, schema: Schema, resolveColor?: RunColorResolver) => Node;
+/** The run-level subset of `TextFormat` a text run can carry. */
+type RunTextFormat = Partial<Extract<TextFormatRun, {
+    nodeType: "text";
+}>["format"]>;
+/**
+ * Applies a `TextFormat` patch to the editor's CURRENT SELECTION as marks —
+ * the per-run counterpart of the toolbar's cell-level `onChangeFormatting`.
+ * This is what makes the toolbar's bold/superscript/font-size controls format
+ * just the selected span while the cell editor is open, the way Cmd+B already
+ * does through the keymap.
+ *
+ * Semantics per key (only keys PRESENT on `format` are touched):
+ * - `bold`/`italic`/`underline`/`strikethrough`: TOGGLE against the
+ *   selection's own mark state (same rule as prosemirror-commands
+ *   `toggleMark`: any marked text in range → remove, else add) — the caller's
+ *   cell-level boolean is ignored because it describes the cell, not the span.
+ * - `baselineOffset`: if the selection already carries the target offset the
+ *   pair is cleared; otherwise the target replaces both (mutually exclusive).
+ * - `fontSize`/`fontFamily`/`color`: SET to the given value (clear on nullish).
+ *   Theme-object colors resolve through `resolveColor`.
+ *
+ * A collapsed selection applies the change to the stored marks, so it affects
+ * what is typed next — Google Sheets behavior.
+ *
+ * Returns `false` (and dispatches nothing) when `format` carries none of the
+ * run-representable keys, so the caller can fall back to cell-level formatting.
+ */
+export declare const applyTextFormatToSelection: (state: EditorState, dispatch: ((tr: EditorState["tr"]) => void) | undefined, format: RunTextFormat, schema: Schema, resolveColor?: RunColorResolver) => boolean;
+/**
+ * Effective fontSize (pt) of the current selection, or `null` when the
+ * selection carries no fontSize mark. A collapsed selection reads the stored
+ * marks (what the next typed character would get); a range reads the marks of
+ * the first text node in the range, matching how the run is rendered.
+ */
+export declare const getSelectionFontSize: (state: EditorState) => number | null;
+/**
+ * Get current cursor position
+ * @param state
+ * @returns
+ */
+export declare const getCursorPosition: (state: EditorState) => number | undefined;
+/**
+ * Get currently focused token
+ * @param position
+ * @param tokens
+ * @returns
+ */
+export declare const getActiveToken: (position: number, tokens: ParsedToken[]) => ParsedToken | undefined;
+export declare const enableCellSelection: (position: number, cursorPos: number, tokens: ParsedToken[]) => boolean;
+/**
+ * Get prev, current and next tokens using a position
+ * @param position
+ * @param tokens
+ * @returns
+ */
+export declare const getSurroundingTokens: (position: number, tokens: ParsedToken[]) => (ParsedToken | undefined)[];
+/**
+ * Get the previous token from the current position
+ * @param position
+ * @param tokens
+ * @returns
+ */
+export declare const getPreviousToken: (position: number, tokens: ParsedToken[]) => ParsedToken | undefined;
+/**
+ * Get next token from position
+ * @param position
+ * @param tokens
+ * @returns
+ */
+export declare const getNextToken: (position: number, tokens: ParsedToken[], activeToken?: ParsedToken) => ParsedToken | undefined;
+/**
+ * Is current token a cell token
+ * @param token
+ * @returns
+ */
+export declare const isCellToken: (token: ParsedToken) => boolean | undefined;
+export declare const isTableColumnToken: (token: ParsedToken) => boolean;
+export declare const isTableNameToken: (token: ParsedToken) => boolean;
+export declare const isNamedRangeToken: (token: ParsedToken) => boolean;
+export declare const isStringToken: (token: ParsedToken) => boolean;
+export declare const isNumberToken: (token: ParsedToken) => boolean;
+/**
+ * Check if token is a cell reference with property (e.g., A1.title or A1.)
+ * @param token
+ * @returns
+ */
+export declare const getPropertyStartIndex: (token: ParsedToken | undefined) => number;
+export declare const hasPropertyReference: (token: ParsedToken | undefined) => boolean;
+/**
+ * Get current active function
+ * @param curToken
+ * @param tokens
+ */
+export declare const getActiveFunctionToken: (curToken: ParsedToken | undefined, tokens: ParsedToken[]) => ParsedToken | undefined;
+/**
+ * get selection index from activetoken
+ * @param activeToken
+ * @returns
+ */
+export declare const getActiveSelectionIndex: (activeToken: ParsedToken | undefined) => number;
+/**
+ * Suggestion token
+ * @param position
+ * @param activeToken
+ * @param view
+ * @returns
+ */
+export declare const getActiveSuggestionToken: (position: number, activeToken: ParsedToken | undefined, view: EditorView) => ParsedToken | undefined;
+export declare const resolveCellPropertyToken: (activeToken: ParsedToken | undefined, tokens: ParsedToken[]) => ParsedToken | undefined;
+/**
+ * Get active table token
+ * @param position
+ * @param activeToken
+ * @param tokens
+ * @param view
+ * @param isEdge
+ * @returns
+ */
+export declare const getActiveTableToken: (position: number, activeToken: ParsedToken | undefined, tokens: ParsedToken[], view: EditorView, isEdge: boolean) => ParsedToken | undefined;
+/**
+ * Get current parameter index that use is focused on
+ * @param curToken
+ * @param functionToken
+ * @param tokens
+ */
+export declare const getParameterIndex: (curToken: ParsedToken | undefined, functionToken: ParsedToken | undefined, tokens: ParsedToken[]) => number;
+export declare const getFunctionParameters: (input: string, functionToken: ParsedToken | undefined) => {
+    parameters: string[];
+    ranges: {
+        start: number;
+        end: number;
+    }[];
+};
+/**
+ * Get content and offset for tokenization, handling both single and multi-line scenarios
+ * @param state ProseMirror editor state
+ * @param cursorPos Current cursor position
+ * @returns Object with line content and offset within that content
+ */
+export declare const getTokenizationContent: (state: EditorState, cursorPos: number) => {
+    line: string;
+    offsetInLine: number;
+};
+/**
+ * Cleanup function token to remove parentheses
+ * @param text
+ */
+export declare const cleanFunctionToken: (text: string) => string;
+export {};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/cjs/editor-pm/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../editor-pm/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,EAAQ,IAAI,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAW,aAAa,EAAE,MAAM,SAAS,CAAC;AAOjD,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,EAAE,QAAQ,GAAG,QA8BzD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,KAAK,GAAG,QAQxC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,IAAI,WAqB7C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,IAAI,KACT,aAAa,EAAE,GAAG,SAAS,GAAG,IAuHhC,CAAC;AAEF;;;;;;GAMG;AACH;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;AAEtE,eAAO,MAAM,mBAAmB,GAC9B,MAAM,MAAM,EACZ,YAAY,aAAa,EAAE,GAAG,SAAS,GAAG,IAAI,EAC9C,QAAQ,MAAM,EACd,eAAe,gBAAgB,KAC9B,IAsKF,CAAC;AAEF,iEAAiE;AACjE,KAAK,aAAa,GAAG,OAAO,CAC1B,OAAO,CAAC,aAAa,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,QAAQ,CAAC,CACvD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,0BAA0B,GACrC,OAAO,WAAW,EAClB,UAAU,CAAC,CAAC,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,EACvD,QAAQ,aAAa,EACrB,QAAQ,MAAM,EACd,eAAe,gBAAgB,KAC9B,OA2EF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,WAAW,KAAG,MAAM,GAAG,IAkBlE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,WAAW,uBAqBnD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,QAAQ,WAAW,EAAE,4BAErE,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,UAAU,MAAM,EAChB,WAAW,MAAM,EACjB,QAAQ,WAAW,EAAE,YAkHtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,MAAM,EAChB,QAAQ,WAAW,EAAE,gCAQtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,QAAQ,WAAW,EAAE,KACpB,WAAW,GAAG,SAehB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,EAChB,QAAQ,WAAW,EAAE,EACrB,cAAc,WAAW,KACxB,WAAW,GAAG,SAWhB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,WAAW,wBACyB,CAAC;AAExE,eAAO,MAAM,kBAAkB,GAAI,OAAO,WAAW,YACU,CAAC;AAEhE,eAAO,MAAM,gBAAgB,GAAI,OAAO,WAAW,YACM,CAAC;AAE1D,eAAO,MAAM,iBAAiB,GAAI,OAAO,WAAW,YACA,CAAC;AAErD,eAAO,MAAM,aAAa,GAAI,OAAO,WAAW,YACM,CAAC;AAEvD,eAAO,MAAM,aAAa,GAAI,OAAO,WAAW,YACM,CAAC;AAavD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,WAAW,GAAG,SAAS,KAC7B,MAsBF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,WAAW,GAAG,SAAS,KAC7B,OAGF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,WAAW,GAAG,SAAS,EACjC,QAAQ,WAAW,EAAE,4BAsBtB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,aAAa,WAAW,GAAG,SAAS,WAOrC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,MAAM,EAChB,aAAa,WAAW,GAAG,SAAS,EACpC,MAAM,UAAU,4BAwFjB,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,aAAa,WAAW,GAAG,SAAS,EACpC,QAAQ,WAAW,EAAE,4BAyBtB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,MAAM,EAChB,aAAa,WAAW,GAAG,SAAS,EACpC,QAAQ,WAAW,EAAE,EACrB,MAAM,UAAU,EAChB,QAAQ,OAAO,4BA2FhB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,WAAW,GAAG,SAAS,EACjC,eAAe,WAAW,GAAG,SAAS,EACtC,QAAQ,WAAW,EAAE,WAwCtB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,OAAO,MAAM,EACb,eAAe,WAAW,GAAG,SAAS,KACrC;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAyFlE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,WAAW,EAClB,WAAW,MAAM;;;CA6ElB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,WAE9C,CAAC"}