@rowsncolumns/utils 9.2.35

package/dist/esm/sort.js

@@ -0,0 +1,39 @@
+/**
+ * Sort sheets by index
+ * @param sheets
+ * @returns
+ */
+export const sortSheetsByIndex = (sheets, includeHidden) => {
+    const filtered = sheets
+        .filter(Boolean)
+        .filter((sheet) => includeHidden ? sheet.title : !sheet.hidden && sheet.title);
+    // Remove duplicate sheets with the same sheetId, keeping only the first occurrence
+    const seen = new Set();
+    const deduplicated = filtered.filter((sheet) => {
+        if (seen.has(sheet.sheetId)) {
+            return false;
+        }
+        seen.add(sheet.sheetId);
+        return true;
+    });
+    // Collect indices that are already defined
+    const usedIndices = new Set(deduplicated
+        .map((sheet) => sheet.index)
+        .filter((index) => index !== undefined && index !== null));
+    // Assign indices to sheets without one, starting from 0 and skipping used indices
+    let nextIndex = 0;
+    const getNextAvailableIndex = () => {
+        while (usedIndices.has(nextIndex)) {
+            nextIndex++;
+        }
+        return nextIndex++;
+    };
+    return deduplicated
+        .map((sheet) => {
+        return {
+            ...sheet,
+            index: sheet.index ?? getNextAvailableIndex(),
+        };
+    })
+        .sort((a, b) => (a.index ?? 0) - (b.index ?? 0));
+};

package/dist/esm/string.d.ts

@@ -0,0 +1,74 @@
+import type { CellInterface, GridRange } from "@rowsncolumns/common-types";
+/**
+ * Convert cell to bounds.
+ * Its better to use gridref.current.getCellBounds() instead as it caters
+ * to merged cells
+ * @param cell
+ * @returns
+ */
+export declare const convertCellToRange: (cell: CellInterface) => GridRange;
+/**
+ * Converts address string to CellInterface
+ * @param address
+ */
+export declare const addressToCell: (address: string, options?: {
+    position?: "start" | "end";
+    rowCount?: number;
+    columnCount?: number;
+}) => CellInterface | null;
+/**
+ * Gets column  from address $G => G
+ * @param address
+ */
+export declare const getColumnNameFromAddress: (address: string) => string | undefined;
+/**
+ * Gets rowIndex from address $1 => 1
+ * @param address
+ */
+export declare const getRowIndexFromAddress: (address: string) => string | undefined;
+/**
+ * Convert cellInterface to address string
+ * @param cell
+ */
+export declare const cellToAddress: (cell: CellInterface | null, isAbsoluteColumn?: boolean, isAbsoluteRow?: boolean, isFullColumn?: boolean, isFullRow?: boolean) => string | null;
+/**
+ * Convert a cell range to address
+ * @param sheetName
+ * @param range
+ * @returns
+ */
+export declare const cellRangeToAddress: (sheetName: string | undefined, range: GridRange) => string;
+export declare const sanitizeSheetName: (name: string | undefined) => string | undefined;
+/**
+ * Remove single quotes from sheetname
+ * 'Sheet Space!A4' => Sheet Space
+ * @param name
+ * @returns
+ */
+export declare const desanitizeSheetName: (name: string | undefined) => string | undefined;
+/**
+ * Escape special characters
+ * @param str
+ * @returns
+ */
+export declare const escapeCharacters: (str: string) => string;
+/**
+ * Get selection from start and end cell
+ * @param start
+ * @param end
+ * @param sheetName
+ * @returns
+ */
+export declare const selectionBoundsFromCells: (start: CellInterface, end?: CellInterface | null) => GridRange;
+export declare const supplant: (s: string, o: Record<string, any>) => string;
+/**
+ * Normalize an external hyperlink target for the browser. A stored URL
+ * without a scheme ("paradigm.xyz") would otherwise be resolved relative to
+ * the current page. Prefixes https:// unless the URL already has a scheme
+ * (https:, mailto:, tel:, …), is protocol-relative ("//host"), or is a
+ * fragment/path reference.
+ * @param url
+ * @returns
+ */
+export declare const normalizeExternalUrl: (url: string) => string;
+//# sourceMappingURL=string.d.ts.map

package/dist/esm/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../string.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAK3E;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,aAAa,KAAG,SAKvD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,MAAM,EACf,UAAS;IACP,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,KACL,aAAa,GAAG,IAuDlB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,uBAEvD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,uBAErD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,MAAM,aAAa,GAAG,IAAI,EAC1B,0BAAwB,EACxB,uBAAqB,EACrB,sBAAoB,EACpB,mBAAiB,KAChB,MAAM,GAAG,IAiBX,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,WAAW,MAAM,GAAG,SAAS,EAC7B,OAAO,SAAS,WAUjB,CAAC;AAGF,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,GAAG,SAAS,uBASzD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,GAAG,SAAS,uBAgB3D,CAAC;AAKF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,WAI3C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,aAAa,EACpB,MAAK,aAAa,GAAG,IAAY,KAChC,SAQF,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,WAKzD,CAAC;AAKF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,WAY/C,CAAC"}

package/dist/esm/string.js

@@ -0,0 +1,213 @@
+import { isNil } from "./typeguards";
+import { alpha2number, number2Alpha } from "./numbers";
+import { MAX_COLUMN_COUNT, MAX_ROW_COUNT } from "./selection";
+/**
+ * Convert cell to bounds.
+ * Its better to use gridref.current.getCellBounds() instead as it caters
+ * to merged cells
+ * @param cell
+ * @returns
+ */
+export const convertCellToRange = (cell) => ({
+    startRowIndex: cell.rowIndex,
+    startColumnIndex: cell.columnIndex,
+    endRowIndex: cell.rowIndex,
+    endColumnIndex: cell.columnIndex,
+});
+/**
+ * Converts address string to CellInterface
+ * @param address
+ */
+export const addressToCell = (address, options = {}) => {
+    const { position, rowCount, columnCount } = options;
+    const maxRow = typeof rowCount === "number"
+        ? Math.min(rowCount, MAX_ROW_COUNT)
+        : MAX_ROW_COUNT;
+    const maxColumn = typeof columnCount === "number"
+        ? Math.min(columnCount, MAX_COLUMN_COUNT)
+        : MAX_COLUMN_COUNT;
+    const regex = /\$?([A-Z]+)\$?(\d+)/gim;
+    let m;
+    const matches = [];
+    while ((m = regex.exec(address)) !== null) {
+        // This is necessary to avoid infinite loops with zero-width matches
+        if (m.index === regex.lastIndex) {
+            regex.lastIndex++;
+        }
+        // The result can be accessed through the `m`-variable.
+        m.forEach((match, groupIndex) => {
+            if (groupIndex > 0)
+                matches.push(match);
+        });
+    }
+    if (matches.length) {
+        const [columnAlpha, rowIndex] = matches;
+        return {
+            rowIndex: Math.min(parseInt(rowIndex), maxRow),
+            columnIndex: Math.min(alpha2number(columnAlpha), maxColumn),
+        };
+    }
+    // Column range
+    if (/^\$?([A-Z]+)$/gim.test(address) && rowCount !== undefined) {
+        const column = getColumnNameFromAddress(address);
+        if (!column) {
+            return null;
+        }
+        return {
+            rowIndex: position === "start" ? 1 : maxRow,
+            columnIndex: Math.min(alpha2number(column), maxColumn),
+        };
+    }
+    // Row range
+    if (/^\$?(\d+)$/gim.test(address) && columnCount !== undefined) {
+        const rowIndexString = getRowIndexFromAddress(address);
+        return {
+            rowIndex: Math.min(Number(rowIndexString), maxRow),
+            columnIndex: position === "start" ? 1 : maxColumn,
+        };
+    }
+    return null;
+};
+/**
+ * Gets column  from address $G => G
+ * @param address
+ */
+export const getColumnNameFromAddress = (address) => {
+    return /^\$?([A-Z]+)$/gim.exec(address)?.[1];
+};
+/**
+ * Gets rowIndex from address $1 => 1
+ * @param address
+ */
+export const getRowIndexFromAddress = (address) => {
+    return /^\$?(\d+)$/gim.exec(address)?.[1];
+};
+/**
+ * Convert cellInterface to address string
+ * @param cell
+ */
+export const cellToAddress = (cell, isAbsoluteColumn = false, isAbsoluteRow = false, isFullColumn = false, isFullRow = false) => {
+    if (!cell)
+        return null;
+    if (cell.columnIndex <= 0) {
+        // return null;
+    }
+    let columnAlpha = number2Alpha(Math.max(0, cell.columnIndex - 1));
+    let rowNumber = Math.max(0, cell.rowIndex);
+    if (isFullColumn) {
+        return columnAlpha;
+    }
+    if (isFullRow) {
+        return String(rowNumber);
+    }
+    return `${isAbsoluteColumn ? "$" : ""}${columnAlpha}${isAbsoluteRow ? "$" : ""}${rowNumber}`;
+};
+/**
+ * Convert a cell range to address
+ * @param sheetName
+ * @param range
+ * @returns
+ */
+export const cellRangeToAddress = (sheetName, range) => {
+    const sheetNameStr = sheetName ? sanitizeSheetName(sheetName) + "!" : "";
+    return `${sheetNameStr}${cellToAddress({
+        rowIndex: range.startRowIndex,
+        columnIndex: range.startColumnIndex,
+    })}:${cellToAddress({
+        rowIndex: range.endRowIndex,
+        columnIndex: range.endColumnIndex,
+    })}`;
+};
+/* Sanitize sheet names */
+export const sanitizeSheetName = (name) => {
+    if (name === void 0)
+        return void 0;
+    if (typeof name === "number")
+        return name;
+    if (/\s+|[^a-z|A-Z|0-9]/.test(name)) {
+        // Escape single quotes by doubling them for valid sheet references.
+        const escaped = name.replace(/'/g, "''");
+        return `'${escaped}'`;
+    }
+    return name;
+};
+/**
+ * Remove single quotes from sheetname
+ * 'Sheet Space!A4' => Sheet Space
+ * @param name
+ * @returns
+ */
+export const desanitizeSheetName = (name) => {
+    if (isNil(name)) {
+        return undefined;
+    }
+    if (typeof name === "number") {
+        return name;
+    }
+    let result = name;
+    const hasTrailingBang = result.endsWith("!");
+    if (hasTrailingBang) {
+        result = result.slice(0, -1);
+    }
+    if (result.startsWith("'") && result.endsWith("'")) {
+        result = result.slice(1, -1).replace(/''/g, "'");
+    }
+    return hasTrailingBang ? `${result}!` : result;
+};
+// Special character
+const SPECIAL_CHARACTERS = /([\\^$.*+?()[\]{}|])/gm;
+/**
+ * Escape special characters
+ * @param str
+ * @returns
+ */
+export const escapeCharacters = (str) => {
+    return SPECIAL_CHARACTERS.test(str)
+        ? str.replace(SPECIAL_CHARACTERS, "\\$1")
+        : str || "";
+};
+/**
+ * Get selection from start and end cell
+ * @param start
+ * @param end
+ * @param sheetName
+ * @returns
+ */
+export const selectionBoundsFromCells = (start, end = start) => {
+    if (!end)
+        end = start;
+    return {
+        startRowIndex: Math.min(start.rowIndex, end.rowIndex),
+        startColumnIndex: Math.min(start.columnIndex, end.columnIndex),
+        endColumnIndex: Math.max(start.columnIndex, end.columnIndex),
+        endRowIndex: Math.max(start.rowIndex, end.rowIndex),
+    };
+};
+export const supplant = (s, o) => {
+    return s.replace(/{([^{}]*)}/g, (a, b) => {
+        const r = o[b];
+        return typeof r === "string" ? r : a;
+    });
+};
+// RFC 3986 scheme: ALPHA *( ALPHA / DIGIT / "+" / "-" / "." ) ":"
+const URL_SCHEME = /^[a-zA-Z][a-zA-Z0-9+.-]*:/;
+/**
+ * Normalize an external hyperlink target for the browser. A stored URL
+ * without a scheme ("paradigm.xyz") would otherwise be resolved relative to
+ * the current page. Prefixes https:// unless the URL already has a scheme
+ * (https:, mailto:, tel:, …), is protocol-relative ("//host"), or is a
+ * fragment/path reference.
+ * @param url
+ * @returns
+ */
+export const normalizeExternalUrl = (url) => {
+    const trimmed = url.trim();
+    if (!trimmed ||
+        URL_SCHEME.test(trimmed) ||
+        trimmed.startsWith("//") ||
+        trimmed.startsWith("#") ||
+        trimmed.startsWith("/")) {
+        return trimmed;
+    }
+    return `https://${trimmed}`;
+};

package/dist/esm/table-styles.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Table styles and banded range utilities
+ * Shared between toolkit (import) and app (rendering)
+ */
+import type { ColorIndex } from "@rowsncolumns/common-types";
+export type Maybe<T> = T | null | undefined;
+export type ColorTheme = {
+    theme: ColorIndex;
+    tint?: Maybe<number>;
+};
+export type Color = string | ColorTheme;
+export type BorderStyle = "dotted" | "dashed" | "solid" | "thin" | "solid_medium" | "solid_thick" | "double";
+export type Border = {
+    style: BorderStyle;
+    width: number;
+    color?: Maybe<Color>;
+};
+export type Borders = {
+    top?: Maybe<Border>;
+    bottom?: Maybe<Border>;
+    left?: Maybe<Border>;
+    right?: Maybe<Border>;
+};
+export type BandingProperties = {
+    headerColor?: Maybe<Color>;
+    footerColor?: Maybe<Color>;
+    firstBandColor?: Maybe<Color>;
+    secondBandColor?: Maybe<Color>;
+    headerBorder?: Maybe<Borders>;
+    footerBorder?: Maybe<Borders>;
+    firstBandBorder?: Maybe<Borders>;
+    secondBandBorder?: Maybe<Borders>;
+    totalRowColor?: Maybe<Color>;
+    totalRowBorder?: Maybe<Borders>;
+};
+export type BandedDefinition = {
+    rowProperties?: Maybe<BandingProperties>;
+    columnProperties?: Maybe<BandingProperties>;
+};
+export type TableTheme = "None" | "TableStyleLight1" | "TableStyleLight2" | "TableStyleLight3" | "TableStyleLight4" | "TableStyleLight5" | "TableStyleLight6" | "TableStyleLight7" | "TableStyleLight8" | "TableStyleLight9" | "TableStyleLight10" | "TableStyleLight11" | "TableStyleLight12" | "TableStyleLight13" | "TableStyleLight14" | "TableStyleLight15" | "TableStyleLight16" | "TableStyleLight17" | "TableStyleLight18" | "TableStyleLight19" | "TableStyleLight20" | "TableStyleLight21" | "TableStyleMedium1" | "TableStyleMedium2" | "TableStyleMedium3" | "TableStyleMedium4" | "TableStyleMedium5" | "TableStyleMedium6" | "TableStyleMedium7" | "TableStyleMedium8" | "TableStyleMedium9" | "TableStyleMedium10" | "TableStyleMedium11" | "TableStyleMedium12" | "TableStyleMedium13" | "TableStyleMedium14" | "TableStyleMedium15" | "TableStyleMedium16" | "TableStyleMedium17" | "TableStyleMedium18" | "TableStyleMedium19" | "TableStyleMedium20" | "TableStyleMedium21" | "TableStyleMedium22" | "TableStyleMedium23" | "TableStyleMedium24" | "TableStyleMedium25" | "TableStyleMedium26" | "TableStyleMedium27" | "TableStyleMedium28" | "TableStyleDark1" | "TableStyleDark2" | "TableStyleDark3" | "TableStyleDark4" | "TableStyleDark5" | "TableStyleDark6" | "TableStyleDark7" | "TableStyleDark8" | "TableStyleDark9" | "TableStyleDark10" | "TableStyleDark11";
+type TableStyleEntry = [
+    theme: TableTheme,
+    firstBandStripeTint: number | undefined,
+    secondBandTint: number | undefined,
+    bandDefinition: BandedDefinition | undefined
+];
+/**
+ * Get table border styles map with all table themes and their banded definitions
+ */
+export declare const getTableBorderStyles: (showRowStripes: boolean | undefined, showColumnStripes: boolean | undefined) => Map<string, TableStyleEntry[]>;
+/**
+ * Find the banded definition for a given table theme
+ */
+export declare const findMatchingBandProperty: (tableTheme: TableTheme, showRowStripes: boolean | undefined, showColumnStripes: boolean | undefined) => BandedDefinition | undefined;
+export {};
+//# sourceMappingURL=table-styles.d.ts.map

package/dist/esm/table-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-styles.d.ts","sourceRoot":"","sources":["../../table-styles.ts"],"names":[],"mappings":"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"}