caplink-saas-ui-shared-component-library 1.90.0 → 1.91.2

package/README.md

@@ -76,3 +76,7 @@ This is a project for the Caplink SaaS UI team. If you are a member of the team,
 4. Create a pull request
 
 Developing components with tests is a requirement for contributing to this project.
+
+## Release
+
+After merging the pull request the publish process will begin and a new version of the library will be created and then published to the NPM repository. To use the new version, update the projects to the recently published version and create a new pull request to send the updated version to the live environments.

package/dist/features/spreadsheet/core/clipboard/clipboard-manager.d.ts

@@ -1,3 +1,4 @@
+import { MatrixValue } from '../../model/matrix-value';
 import { ClipboardEventType, CopyOperationResult, PasteOperationResult } from './types';
 import type * as Matrix from '../../model/matrix';
 import type * as Spreadsheet from '../../model/spreadsheet';
@@ -9,7 +10,7 @@ import type * as Spreadsheet from '../../model/spreadsheet';
  */
 export declare function paste(event: ClipboardEventType, params: {
     targetPoint: Matrix.Point;
-    currentMatrix: Matrix.Matrix<unknown>;
+    currentMatrix: Matrix.Matrix<MatrixValue>;
     columns: Spreadsheet.Column[];
     selectedRanges: Matrix.PointRange[];
     isStaticRows: boolean;
@@ -22,14 +23,14 @@ export declare function paste(event: ClipboardEventType, params: {
  * @param currentMatrix - Current matrix state
  * @returns Result with clipboard text and success status
  */
-export declare function copySingleCellToClipboard(point: Matrix.Point, currentMatrix: Matrix.Matrix<unknown>): CopyOperationResult;
+export declare function copySingleCellToClipboard(point: Matrix.Point, currentMatrix: Matrix.Matrix<MatrixValue>): CopyOperationResult;
 /**
  * Copies multiple ranges to clipboard
  * @param ranges - The ranges to copy
  * @param currentMatrix - Current matrix state
  * @returns Result with clipboard text and success status
  */
-export declare function copyRangesToClipboard(ranges: Matrix.PointRange[], currentMatrix: Matrix.Matrix<unknown>): CopyOperationResult;
+export declare function copyRangesToClipboard(ranges: Matrix.PointRange[], currentMatrix: Matrix.Matrix<MatrixValue>): CopyOperationResult;
 /**
  * Writes text to system clipboard
  * @param text - The text to write

package/dist/features/spreadsheet/core/clipboard/operations/copy-single-cell.d.ts

@@ -1,6 +1,7 @@
+import { MatrixValue } from '../../../model/matrix-value';
 import { CopyOperationResult } from '../types';
 import type * as Matrix from '../../../model/matrix';
 /**
  * Handles copying a single cell value to clipboard
  */
-export declare function copySingleCell(point: Matrix.Point, currentMatrix: Matrix.Matrix<unknown>): CopyOperationResult;
+export declare function copySingleCell(point: Matrix.Point, currentMatrix: Matrix.Matrix<MatrixValue>): CopyOperationResult;

package/dist/features/spreadsheet/core/clipboard/services/clipboard-data-extractor.d.ts

@@ -1,3 +1,4 @@
+import { MatrixValue } from '../../../model/matrix-value';
 import { ClipboardEventType, ParsedClipboardData } from '../types';
 import * as Matrix from '../../../model/matrix';
 /**
@@ -12,7 +13,7 @@ export declare function extractAndParseClipboardData(event: ClipboardEventType):
  * @param data - Matrix data to format
  * @returns Formatted string ready for clipboard
  */
-export declare function formatMatrixForClipboard(data: Matrix.Matrix<unknown>): string;
+export declare function formatMatrixForClipboard(data: Matrix.Matrix<MatrixValue>): string;
 /**
  * Checks if parsed data represents a single cell
  * @param data - Parsed clipboard data

package/dist/features/spreadsheet/core/clipboard/types/index.d.ts

@@ -1,10 +1,11 @@
 import { ClipboardEvent } from 'react';
+import { MatrixCellChange, MatrixValue } from '../../../model/matrix-value';
 import type * as Matrix from '../../../model/matrix';
 import type * as Spreadsheet from '../../../model/spreadsheet';
 /**
  * Represents the result of parsing clipboard data into a matrix format
  */
-export type ParsedClipboardData = Matrix.Matrix<unknown>;
+export type ParsedClipboardData = Matrix.Matrix<MatrixValue>;
 /**
  * Unified type for clipboard events from both browser and React
  */
@@ -18,7 +19,7 @@ export interface PasteOperationConfig {
     /** The data to be pasted (already parsed into matrix format) */
     parsedData: ParsedClipboardData;
     /** Current matrix state */
-    currentMatrix: Matrix.Matrix<unknown>;
+    currentMatrix: Matrix.Matrix<MatrixValue>;
     /** Column definitions with metadata */
     columns: Spreadsheet.Column[];
     /** Currently selected ranges */
@@ -35,23 +36,16 @@ export interface PasteOperationConfig {
  */
 export interface PasteOperationResult {
     /** The updated matrix after paste */
-    updatedMatrix: Matrix.Matrix<unknown>;
+    updatedMatrix: Matrix.Matrix<MatrixValue>;
     /** History entries to track changes for undo */
     historyEntries: HistoryEntry[];
 }
 /**
  * Represents a single change in the spreadsheet for undo/redo
  */
-export interface HistoryEntry {
-    /** The cell position that changed */
-    point: Matrix.Point;
-    /** The value before the change */
-    oldValue: unknown;
-    /** The value after the change */
-    newValue: unknown;
-    /** Unique identifier to group related changes (e.g., all cells from one paste) */
+export type HistoryEntry = MatrixCellChange & {
     pastedId: string;
-}
+};
 /**
  * Determines which paste strategy to use
  */
@@ -70,7 +64,7 @@ export interface CopyOperationConfig {
     /** The ranges to copy from */
     sourceRanges: Matrix.PointRange[];
     /** Current matrix state */
-    currentMatrix: Matrix.Matrix<unknown>;
+    currentMatrix: Matrix.Matrix<MatrixValue>;
 }
 /**
  * Result of a copy operation

package/dist/features/spreadsheet/lib/insert-new-row.d.ts

@@ -1,9 +1,10 @@
+import { MatrixValue } from '../model/matrix-value';
 import type * as Matrix from '../model/matrix';
 import * as Spreadsheet from '../model/spreadsheet';
 type InsertNewRowArgs = {
-    matrix: Matrix.Matrix<unknown>;
+    matrix: Matrix.Matrix<MatrixValue>;
     columnsCount: number;
     columns: Spreadsheet.Column[];
 };
-export declare function insertNewRow({ columnsCount, matrix, columns, }: InsertNewRowArgs): Matrix.Matrix<unknown>;
+export declare function insertNewRow({ columnsCount, matrix, columns, }: InsertNewRowArgs): Matrix.Matrix<MatrixValue>;
 export {};

package/dist/features/spreadsheet/lib/show-row-by-condition/index.d.ts

@@ -1,6 +1,7 @@
+import { MatrixValue } from '../../model/matrix-value';
 import { Column } from '../../model/spreadsheet';
 type ShowRowByConditionArgs = {
-    row: unknown[];
+    row: (MatrixValue | undefined)[];
     columns: Column[];
 };
 export declare function showRowByCondition({ columns, row }: ShowRowByConditionArgs): boolean;

package/dist/features/spreadsheet/lib/sort-column.d.ts

@@ -1,11 +1,12 @@
 import { Matrix } from '../model/matrix';
+import { MatrixValue } from '../model/matrix-value';
 import { DataEditorType } from '../model/spreadsheet';
 import { ColumnOrderEnum } from './spreadsheet-filters';
 type SortMatrixByColumnArgs = {
     columnOrder: ColumnOrderEnum;
     columnIndex: number;
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     dataEditorType: DataEditorType;
 };
-export declare function sortMatrixByColumn({ columnIndex, columnOrder, dataEditorType, matrix, }: SortMatrixByColumnArgs): Matrix<unknown>;
+export declare function sortMatrixByColumn({ columnIndex, columnOrder, dataEditorType, matrix, }: SortMatrixByColumnArgs): Matrix<MatrixValue>;
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/apply-spreadsheet-filters.d.ts

@@ -1,11 +1,12 @@
 import { CommonFiltersEnum, DateFiltersEnum, NumericFiltersEnum, TextFiltersEnum } from '.';
 import { Matrix } from '../../model/matrix';
+import { MatrixValue } from '../../model/matrix-value';
 type ApplySpreadsheetFiltersArgs = {
     filterType: CommonFiltersEnum & TextFiltersEnum & NumericFiltersEnum & DateFiltersEnum;
     valueA: string;
     valueB?: string;
     columnIndex: number;
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
 };
-export declare function applySpreadsheetFilters({ filterType, valueA, valueB, columnIndex, matrix, }: ApplySpreadsheetFiltersArgs): Matrix<unknown>;
+export declare function applySpreadsheetFilters({ filterType, valueA, valueB, columnIndex, matrix, }: ApplySpreadsheetFiltersArgs): Matrix<MatrixValue>;
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/cell-inner.d.ts

@@ -0,0 +1,3 @@
+import { MatrixValue } from '../../model/matrix-value';
+export declare function cellInnerAt(row: (MatrixValue | undefined)[], columnIndex: number): unknown;
+export declare function numberCellAt(row: (MatrixValue | undefined)[], columnIndex: number): number;

package/dist/features/spreadsheet/lib/spreadsheet-filters/common/apply-common-filters.d.ts

@@ -1,9 +1,10 @@
 import { CommonFiltersEnum } from '..';
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type ApplyCommonFilters = {
     columnIndex: number;
     filterType: CommonFiltersEnum;
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
 };
-export declare function applyCommonFilters({ filterType, matrix, columnIndex }: ApplyCommonFilters): Matrix<unknown>;
+export declare function applyCommonFilters({ filterType, matrix, columnIndex }: ApplyCommonFilters): Matrix<MatrixValue>;
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/common/is-empty.d.ts

@@ -1,7 +1,8 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type IsEmptyArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
 };
-export declare function isEmpty({ columnIndex, matrix }: IsEmptyArgs): unknown[][];
+export declare function isEmpty({ columnIndex, matrix }: IsEmptyArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/common/is-not-empty.d.ts

@@ -1,7 +1,8 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type IsNotEmptyArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
 };
-export declare function isNotEmpty({ columnIndex, matrix }: IsNotEmptyArgs): unknown[][];
+export declare function isNotEmpty({ columnIndex, matrix }: IsNotEmptyArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/date/apply-date-filters.d.ts

@@ -1,10 +1,11 @@
 import { DateFiltersEnum } from '..';
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type ApplyDateFiltersArgs = {
     dateValue: string;
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     filterType: DateFiltersEnum;
 };
-export declare function applyDateFilters({ columnIndex, dateValue, matrix, filterType, }: ApplyDateFiltersArgs): Matrix<unknown>;
+export declare function applyDateFilters({ columnIndex, dateValue, matrix, filterType, }: ApplyDateFiltersArgs): Matrix<MatrixValue>;
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/date/date-is-after.d.ts

@@ -1,8 +1,9 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type DateIsBeforeArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     dateValue: string;
 };
-export declare function dateIsAfter({ columnIndex, matrix, dateValue }: DateIsBeforeArgs): unknown[][];
+export declare function dateIsAfter({ columnIndex, matrix, dateValue }: DateIsBeforeArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/date/date-is-before.d.ts

@@ -1,8 +1,9 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type DateIsBeforeArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     dateValue: string;
 };
-export declare function dateIsBefore({ columnIndex, matrix, dateValue }: DateIsBeforeArgs): unknown[][];
+export declare function dateIsBefore({ columnIndex, matrix, dateValue }: DateIsBeforeArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/date/date-is-equals-to.d.ts

@@ -1,8 +1,9 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type DateIsEqualsToArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     dateValue: string;
 };
-export declare function dateIsEqualsTo({ columnIndex, matrix, dateValue }: DateIsEqualsToArgs): unknown[][];
+export declare function dateIsEqualsTo({ columnIndex, matrix, dateValue }: DateIsEqualsToArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/numeric/apply-numeric-filters.d.ts

@@ -1,11 +1,12 @@
 import { NumericFiltersEnum } from '..';
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type ApplyDateFiltersArgs = {
     numberValueA: string;
     numberValueB?: string;
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     filterType: NumericFiltersEnum;
 };
-export declare function applyNumericFilters({ columnIndex, numberValueA, numberValueB, matrix, filterType, }: ApplyDateFiltersArgs): Matrix<unknown>;
+export declare function applyNumericFilters({ columnIndex, numberValueA, numberValueB, matrix, filterType, }: ApplyDateFiltersArgs): Matrix<MatrixValue>;
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/numeric/number-is-between.d.ts

@@ -1,9 +1,10 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type NumberIsBetweenArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     numberA: number;
     numberB: number;
 };
-export declare function numberIsBetween({ columnIndex, matrix, numberA, numberB }: NumberIsBetweenArgs): unknown[][];
+export declare function numberIsBetween({ columnIndex, matrix, numberA, numberB }: NumberIsBetweenArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/numeric/number-is-equals-to.d.ts

@@ -1,8 +1,9 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type NumberIsEqualsToArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     numberValue: number;
 };
-export declare function numberIsEqualsTo({ columnIndex, matrix, numberValue }: NumberIsEqualsToArgs): unknown[][];
+export declare function numberIsEqualsTo({ columnIndex, matrix, numberValue }: NumberIsEqualsToArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/numeric/number-is-greater-or-equals.d.ts

@@ -1,8 +1,9 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type NumberIsGreaterOrEqualsArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     numberValue: number;
 };
-export declare function numberIsGreaterOrEquals({ columnIndex, matrix, numberValue, }: NumberIsGreaterOrEqualsArgs): unknown[][];
+export declare function numberIsGreaterOrEquals({ columnIndex, matrix, numberValue, }: NumberIsGreaterOrEqualsArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/numeric/number-is-greater-than.d.ts

@@ -1,8 +1,9 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type NumberIsGreaterThanArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     numberValue: number;
 };
-export declare function numberIsGreaterThan({ columnIndex, matrix, numberValue }: NumberIsGreaterThanArgs): unknown[][];
+export declare function numberIsGreaterThan({ columnIndex, matrix, numberValue }: NumberIsGreaterThanArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/numeric/number-is-less-or-equals.d.ts

@@ -1,8 +1,9 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type NumberIsLessOrEqualsArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     numberValue: number;
 };
-export declare function numberIsLessOrEquals({ columnIndex, matrix, numberValue, }: NumberIsLessOrEqualsArgs): unknown[][];
+export declare function numberIsLessOrEquals({ columnIndex, matrix, numberValue, }: NumberIsLessOrEqualsArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/numeric/number-is-less-than.d.ts

@@ -1,8 +1,9 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type NumberIsLessThanArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     numberValue: number;
 };
-export declare function numberIsLessThan({ columnIndex, matrix, numberValue }: NumberIsLessThanArgs): unknown[][];
+export declare function numberIsLessThan({ columnIndex, matrix, numberValue }: NumberIsLessThanArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/numeric/number-is-not-between.d.ts

@@ -1,9 +1,10 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type NumberIsNotBetweenArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     numberA: number;
     numberB: number;
 };
-export declare function numberIsNotBetween({ columnIndex, matrix, numberA, numberB, }: NumberIsNotBetweenArgs): unknown[][];
+export declare function numberIsNotBetween({ columnIndex, matrix, numberA, numberB, }: NumberIsNotBetweenArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/numeric/number-is-not-equals-to.d.ts

@@ -1,8 +1,9 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type NumberNotIsEqualsToArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     numberValue: number;
 };
-export declare function numberIsNotEqualsTo({ columnIndex, matrix, numberValue }: NumberNotIsEqualsToArgs): unknown[][];
+export declare function numberIsNotEqualsTo({ columnIndex, matrix, numberValue }: NumberNotIsEqualsToArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/text/apply-text-filters.d.ts

@@ -1,10 +1,11 @@
 import { TextFiltersEnum } from '..';
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type ApplyDateFiltersArgs = {
     textValue: string;
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     filterType: TextFiltersEnum;
 };
-export declare function applyTextFilters({ columnIndex, textValue, matrix, filterType, }: ApplyDateFiltersArgs): Matrix<unknown>;
+export declare function applyTextFilters({ columnIndex, textValue, matrix, filterType, }: ApplyDateFiltersArgs): Matrix<MatrixValue>;
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/text/text-contains.d.ts

@@ -1,8 +1,9 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type TextContainsArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     textValue: string;
 };
-export declare function textContains({ columnIndex, matrix, textValue }: TextContainsArgs): unknown[][];
+export declare function textContains({ columnIndex, matrix, textValue }: TextContainsArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/text/text-ends-with.d.ts

@@ -1,8 +1,9 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type TextEndsWithArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     textValue: string;
 };
-export declare function textEndsWith({ columnIndex, matrix, textValue }: TextEndsWithArgs): unknown[][];
+export declare function textEndsWith({ columnIndex, matrix, textValue }: TextEndsWithArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/text/text-is-equals-to.d.ts

@@ -1,8 +1,9 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type TextContainsArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     textValue: string;
 };
-export declare function textIsEqualsTo({ columnIndex, matrix, textValue }: TextContainsArgs): unknown[][];
+export declare function textIsEqualsTo({ columnIndex, matrix, textValue }: TextContainsArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/text/text-not-contains.d.ts

@@ -1,8 +1,9 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type TextNotContainsArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     textValue: string;
 };
-export declare function textNotContains({ columnIndex, matrix, textValue }: TextNotContainsArgs): unknown[][];
+export declare function textNotContains({ columnIndex, matrix, textValue }: TextNotContainsArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/lib/spreadsheet-filters/text/text-starts-with.d.ts

@@ -1,8 +1,9 @@
 import { Matrix } from '../../../model/matrix';
+import { MatrixValue } from '../../../model/matrix-value';
 type TextStartsWithArgs = {
-    matrix: Matrix<unknown>;
+    matrix: Matrix<MatrixValue>;
     columnIndex: number;
     textValue: string;
 };
-export declare function textStartsWith({ columnIndex, matrix, textValue }: TextStartsWithArgs): unknown[][];
+export declare function textStartsWith({ columnIndex, matrix, textValue }: TextStartsWithArgs): (MatrixValue | undefined)[][];
 export {};

package/dist/features/spreadsheet/model/context.d.ts

@@ -1,4 +1,4 @@
 /// <reference types="react" />
 import * as Spreadsheet from './spreadsheet';
 export declare const SpreadsheetContext: import('react').Context<Spreadsheet.Context | null>;
-export declare function SpreadsheetContextProvider({ children, startingColumns, matrix: startingMatrix, staticRows, onMatrixChange, onExportData, onImportData, onOpenFullScreen, fullScreen, conditionalFormatting, enableCyclicPasteRepeat, }: Spreadsheet.ContextProvider): import("react/jsx-runtime").JSX.Element;
+export declare function SpreadsheetContextProvider({ children, startingColumns, matrix: legacyMatrix, matrixObject, staticRows, onMatrixChange, onExportData, onImportData, onOpenFullScreen, fullScreen, conditionalFormatting, enableCyclicPasteRepeat, }: Spreadsheet.ContextProvider): import("react/jsx-runtime").JSX.Element;

package/dist/features/spreadsheet/model/history-context.d.ts

@@ -1,8 +1,9 @@
+import { MatrixValue } from './matrix-value';
 /// <reference types="react" />
 import type * as Matrix from './matrix';
 import type * as Spreadsheet from './spreadsheet';
 export declare const HistoryContext: import('react').Context<Spreadsheet.HistoryContext | null>;
 export declare function HistoryContextProvider({ children, onMatrixChange, }: {
     children: React.ReactNode;
-    onMatrixChange?: (matrix: Matrix.Matrix<unknown>) => void;
+    onMatrixChange?: (matrix: Matrix.Matrix<MatrixValue>) => void;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/features/spreadsheet/model/matrix-value.d.ts

@@ -0,0 +1,21 @@
+import { Matrix, Point } from './matrix';
+export type LegacyMatrix = Array<Array<unknown | undefined>>;
+export type MatrixValue = {
+    value: unknown;
+    settings?: {
+        readonly?: boolean;
+    };
+};
+export type MatrixCellChange = {
+    point: Point;
+    oldCell: MatrixValue | undefined;
+    newCell: MatrixValue | undefined;
+    pastedId?: string;
+};
+export declare function normalizeToMatrixCell(raw: unknown): MatrixValue | undefined;
+export declare function getMatrixCellInner(cell: MatrixValue | undefined): unknown;
+export declare function mergeMatrixCell(prev: MatrixValue | undefined, nextInner: unknown): MatrixValue;
+export declare function isMatrixCellEmpty(inner: unknown): boolean;
+export declare function matrixFromLegacy(rows: LegacyMatrix): Matrix<MatrixValue>;
+export declare function normalizeMatrixInput(matrix?: LegacyMatrix, matrixObject?: Matrix<MatrixValue>): Matrix<MatrixValue>;
+export declare function toLegacyMatrix(m: Matrix<MatrixValue>): LegacyMatrix;

package/dist/features/spreadsheet/model/matrix.d.ts

@@ -1,3 +1,4 @@
+import { MatrixValue } from './matrix-value';
 /** A cell cordinates in matrix */
 export type Point = {
     row: number;
@@ -47,13 +48,13 @@ export declare function hasEntireRows(params: {
     row: number;
 }): boolean;
 /** Converts string value into an matrix */
-export declare function parseString(value: string): Matrix<unknown>;
+export declare function parseString(value: string): Matrix<MatrixValue>;
 /**
  * Overlaps a given Matrix B (mB) starting in a specific point into a given Matrix A (mA)
  * Matrix B (mB) always has priority when replacing cell values
  */
 export declare function overlap(params: {
-    mA: Matrix<unknown>;
-    mB: Matrix<unknown>;
+    mA: Matrix<MatrixValue>;
+    mB: Matrix<MatrixValue>;
     point: Point;
-}): Matrix<unknown>;
+}): Matrix<MatrixValue>;

package/dist/features/spreadsheet/model/spreadsheet.d.ts

@@ -1,6 +1,7 @@
 import { CSSProperties, ClipboardEvent, Dispatch, MouseEvent, PropsWithChildren, SetStateAction } from 'react';
 import { ConditionalFormattingRule } from '../lib/conditional-formatting';
 import { SpreadsheetProps } from '../ui/spreadsheet';
+import { MatrixCellChange, MatrixValue } from './matrix-value';
 import { ColumnCounterEnum, ColumnOrderEnum, CommonFiltersEnum, DateFiltersEnum, NumericFiltersEnum, TextFiltersEnum } from '../lib/spreadsheet-filters';
 import type * as Matrix from './matrix';
 export declare const COLUMN_STRING_LIMIT = 1200;
@@ -138,6 +139,8 @@ export declare enum SpreadsheetDisplayModeEnum {
 export type Cell = {
     /** The cell value */
     value?: unknown;
+    /** Cell-level readonly (matrix `settings.readonly`) */
+    cellReadonly?: boolean;
     /** Point coordinates of the cell */
     coordinates: Matrix.Point;
     width: number;
@@ -148,25 +151,20 @@ export type TemporaryValue = {
     point: Matrix.Point;
     value: unknown;
 };
-export type SpreadsheetHistory = {
-    point: Matrix.Point;
-    oldValue: unknown;
-    newValue: unknown;
-    pastedId?: string;
-};
+export type SpreadsheetHistory = MatrixCellChange;
 export type HistoryContext = {
     history: SpreadsheetHistory[];
     addToHistory: (historyItem: SpreadsheetHistory) => void;
-    undo: (matrix: Matrix.Matrix<unknown>, setMatrix: (matrix: Matrix.Matrix<unknown>) => void) => void;
+    undo: (matrix: Matrix.Matrix<MatrixValue>, setMatrix: (matrix: Matrix.Matrix<MatrixValue>) => void) => void;
 };
 export type RowFiltered = {
     originalIndex: number;
-    value: unknown[];
+    value: (MatrixValue | undefined)[];
 };
 export type Context = {
     size: Matrix.Size;
-    setMatrix: Dispatch<SetStateAction<Matrix.Matrix<unknown>>>;
-    matrix: Matrix.Matrix<unknown>;
+    setMatrix: Dispatch<SetStateAction<Matrix.Matrix<MatrixValue>>>;
+    matrix: Matrix.Matrix<MatrixValue>;
     temporaryValues: TemporaryValue[];
     columns: Column[];
     emptySize: boolean;
@@ -235,4 +233,7 @@ export type Context = {
     conditionalFormatting?: ConditionalFormattingRule[];
     filteredMatrix: RowFiltered[];
 };
-export type ContextProvider = Omit<PropsWithChildren<SpreadsheetProps>, 'className'>;
+/** Props for {@link SpreadsheetContextProvider}; `onMatrixChange` is the typed-matrix emit wired by {@link Spreadsheet}. */
+export type ContextProvider = Omit<PropsWithChildren<SpreadsheetProps>, 'className' | 'onMatrixChange' | 'onMatrixObjectChange'> & {
+    onMatrixChange?: (matrix: Matrix.Matrix<MatrixValue>) => void;
+};

package/dist/features/spreadsheet/ui/cell.d.ts

@@ -1,2 +1,2 @@
 import * as Spreadsheet from '../model/spreadsheet';
-export declare function Cell({ value, width, coordinates, className, style }: Spreadsheet.Cell): import("react/jsx-runtime").JSX.Element;
+export declare function Cell({ value, cellReadonly, width, coordinates, className, style, }: Spreadsheet.Cell): import("react/jsx-runtime").JSX.Element;

package/dist/features/spreadsheet/ui/columns.d.ts

@@ -1,6 +1,6 @@
-/// <reference types="react" />
-declare function ColumnsComponent({ rowValue, rowIndex }: {
-    rowValue: Array<unknown>;
+import { MatrixValue } from '../model/matrix-value';
+declare function ColumnsComponent({ rowValue, rowIndex, }: {
+    rowValue: Array<MatrixValue | undefined>;
     rowIndex: number;
 }): import("react/jsx-runtime").JSX.Element[];
 export declare const Columns: import('react').MemoExoticComponent<typeof ColumnsComponent>;