@rowsncolumns/utils 9.4.0 → 9.5.1

package/dist/cjs/index.d.ts

@@ -28,4 +28,6 @@ export * from "./formula-locale";
 export * from "./table-names";
 export * from "./table-totals";
 export * from "./sparkline-groups";
+export * from "./rich-text-html";
+export * from "./rich-text-links";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/cjs/index.js

@@ -31,3 +31,5 @@ tslib_1.__exportStar(require("./formula-locale"), exports);
 tslib_1.__exportStar(require("./table-names"), exports);
 tslib_1.__exportStar(require("./table-totals"), exports);
 tslib_1.__exportStar(require("./sparkline-groups"), exports);
+tslib_1.__exportStar(require("./rich-text-html"), exports);
+tslib_1.__exportStar(require("./rich-text-links"), exports);

package/dist/cjs/rich-text-html.d.ts

@@ -0,0 +1,82 @@
+import type { TextFormat, TextFormatRun } from "@rowsncolumns/common-types";
+/**
+ * Clipboard HTML → the engine's native rich-text shape.
+ *
+ * Google Sheets and Excel both put a cell's mixed formatting into `text/html`
+ * — Google as `<span style="…">` / `<a href>` runs inside a `<td>` (wrapped in
+ * `<google-sheets-html-origin>`), Excel as `<b>` / `<font color>` /
+ * `<font class="fontN">` (class rules in `<head><style>`) / `<span style>` /
+ * `<a href>` inside a `<td>`. This module is the ONE converter every paste
+ * target uses (the grid's cell paste in `spreadsheet-state/api/parse-html`,
+ * the formula bar and the in-cell editor in `ui/editor-pm`), so a rich cell
+ * lands identically wherever it is pasted:
+ *
+ * - `text` — the full text, whitespace normalized like `extractTextContent`
+ *   (source-newlines collapse to a space, `<br>` / block boundaries become
+ *   `\n`, outer whitespace trimmed).
+ * - `runs` — `TextFormatRun`s RELATIVE to `baseFormat` (only the properties a
+ *   segment changes), adjacent equal segments merged, empty formats dropped —
+ *   the same normal form `extractTextFormatRuns` produces from the editor.
+ *   `undefined` when the text is uniformly formatted (then `baseFormat`
+ *   already says everything).
+ * - `links` — every `<a href>` in document order, as `[start, end)` spans.
+ *   A link is also carried on its run as `format.link` (Google Sheets keeps
+ *   several links per cell), and the engines promote the first run link to the
+ *   cell-level `hyperlink` on commit (Excel keeps one link per cell).
+ * - `hyperlink` — the cell-level link: an anchor wrapping the whole text
+ *   (Excel), else the first link.
+ * - `baseFormat` — the container's own formatting (the `<td>` class / inline
+ *   style), i.e. the CELL-level text format of the source cell.
+ *
+ * Styles are read from the inline `style`, the tag semantics and
+ * `getComputedStyle` (the element must be mounted — see
+ * {@link mountClipboardHtml}) so Excel's class-based `<font class="fontN">`
+ * runs resolve. `<a>` elements read inline styles only: a browser's UA sheet
+ * would otherwise paint every pasted link `-webkit-link` blue.
+ */
+export type RichTextLink = {
+    startIndex: number;
+    endIndex: number;
+    uri: string;
+};
+export type ParsedRichText = {
+    text: string;
+    runs: TextFormatRun[] | undefined;
+    links: RichTextLink[];
+    hyperlink: string | undefined;
+    baseFormat: TextFormat;
+    /** Mixed formatting or at least one link — the reasons to prefer runs over flat text. */
+    isRich: boolean;
+};
+/**
+ * Parse an HTML clipboard payload into a hidden, mounted sandbox so
+ * `getComputedStyle` resolves the payload's own `<style>` rules (Excel's
+ * `.fontN` / `.xlNN` classes). Callers must `cleanup()` when done.
+ */
+export declare const mountClipboardHtml: (clipboardValue: string) => {
+    root: HTMLDivElement;
+    cleanup: () => void;
+};
+export declare const cssColorToHex: (value: string | null | undefined) => string | undefined;
+/** CSS font-size → points. `pt` verbatim, `px` at 96dpi, `em`/`rem` on a 16px base. */
+export declare const cssFontSizeToPt: (value: string | null | undefined) => number | undefined;
+/**
+ * Convert a mounted element (a clipboard `<td>`, or the sandbox wrapper for
+ * table-less HTML) into the engine's rich-text shape. See the module doc.
+ */
+export declare const htmlElementToRichText: (root: HTMLElement) => ParsedRichText;
+/**
+ * The element a single-cell clipboard payload's text lives in: the lone
+ * `<td>`/`<th>` of a one-cell table (Excel / Google Sheets), or the mounted
+ * wrapper for table-less HTML. `undefined` for a multi-cell table — that is a
+ * grid paste, not a rich-text one.
+ */
+export declare const findSingleClipboardCell: (root: HTMLElement) => HTMLElement | undefined;
+/**
+ * One-shot helper for the editor targets: mount the clipboard HTML, convert
+ * the single cell it carries, clean up. `undefined` when the payload is a
+ * multi-cell table or carries no formatting/links worth keeping (the caller
+ * then falls back to its plain-text handling).
+ */
+export declare const clipboardHtmlToRichText: (html: string) => ParsedRichText | undefined;
+//# sourceMappingURL=rich-text-html.d.ts.map

package/dist/cjs/rich-text-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-text-html.d.ts","sourceRoot":"","sources":["../../rich-text-html.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAK5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,EAAE,GAAG,SAAS,CAAC;IAClC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,yFAAyF;IACzF,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAgGF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,gBAAgB,MAAM;;;CAmBxD,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,KAC/B,MAAM,GAAG,SAkBX,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,KAC/B,MAAM,GAAG,SAoBX,CAAC;AA+SF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,WAAW,KAAG,cA+DzD,CAAC;AAgBF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,WAAW,KAChB,WAAW,GAAG,SAShB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,KACX,cAAc,GAAG,SAkBnB,CAAC"}