@rowsncolumns/spreadsheet-state 28.0.66

package/dist/esm/hooks/use-sheet-state.d.ts

@@ -0,0 +1,17 @@
+import { type CellInterface, type SelectionArea } from "@rowsncolumns/grid";
+import type { CellData, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+export declare const useSheetState: <U extends Sheet, T extends CellData>({ sheets, onChangeSheets, }: {
+    sheets: U[];
+    onChangeSheets: UseSpreadsheetProps<T, U>["onChangeSheets"];
+}) => {
+    activeCell: CellInterface;
+    selections: SelectionArea<SelectionAttributes>[];
+    onChangeActiveSheet: (sheetId: number) => void;
+    onChangeActiveCell: (sheetId: number, activeCell: CellInterface) => void;
+    onChangeSelections: (sheetId: number, selections: SelectionArea<SelectionAttributes>[]) => void;
+    activeSheetId: number;
+    activeCellBySheetId: Record<number, CellInterface>;
+    selectionsBySheetId: Record<number, SelectionArea<SelectionAttributes>[]>;
+};
+//# sourceMappingURL=use-sheet-state.d.ts.map

package/dist/esm/hooks/use-sheet-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sheet-state.d.ts","sourceRoot":"","sources":["../../../hooks/use-sheet-state.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAEnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAUnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AA0DnE,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,QAAQ,EAAE,6BAGhE;IACD,MAAM,EAAE,CAAC,EAAE,CAAC;IACZ,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;CAC7D;;;mCA+CmD,MAAM;kCAS5C,MAAM,cAAc,aAAa;kCAWjC,MAAM,cAAc,aAAa,CAAC,mBAAmB,CAAC,EAAE;mBAhIrD,MAAM;yBACA,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;yBAC7B,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;CAgJ1E,CAAC"}

package/dist/esm/hooks/use-sheet-state.js

@@ -0,0 +1,102 @@
+import { useIsomorphicLayoutEffect, } from "@rowsncolumns/grid";
+import { createNewSheet as createNewSheetHelper } from "@rowsncolumns/spreadsheet";
+import { DEFAULT_ACTIVE_CELL, DEFAULT_ARRAY, getInitialActiveSheetId, } from "@rowsncolumns/spreadsheet";
+import { sortSheetsByIndex } from "@rowsncolumns/utils";
+import { useCallback, useMemo, useReducer, useRef } from "react";
+const sheetStateReducer = (state, actions) => {
+    switch (actions.type) {
+        case "CHANGE_SHEET":
+            return {
+                ...state,
+                activeSheetId: actions.sheetId,
+            };
+        case "CHANGE_ACTIVE_CELL":
+            return {
+                ...state,
+                activeCellBySheetId: {
+                    ...state.activeCellBySheetId,
+                    [actions.sheetId]: actions.activeCell,
+                },
+            };
+        case "CHANGE_SELECTIONS":
+            return {
+                ...state,
+                selectionsBySheetId: {
+                    ...state.selectionsBySheetId,
+                    [actions.sheetId]: actions.selections,
+                },
+            };
+        default:
+            return state;
+    }
+};
+export const useSheetState = ({ sheets, onChangeSheets, }) => {
+    const [state, dispatch] = useReducer(sheetStateReducer, {
+        activeSheetId: getInitialActiveSheetId(sheets),
+        activeCellBySheetId: {},
+        selectionsBySheetId: {},
+    });
+    const activeSheetId = state.activeSheetId;
+    // always keep activeSheetId in sync with sheets
+    const sheetIds = useMemo(() => sortSheetsByIndex(sheets).map((sheet) => sheet.sheetId), [sheets]);
+    const activeSheetIdRef = useRef(activeSheetId);
+    // Tracks whether the user has explicitly picked a sheet. Until they do, we
+    // keep activeSheetId in sync with sheetIds[0] so a locally-created placeholder
+    // doesn't stick when YJS hydrates (the placeholder's id may still be present
+    // in the hydrated array, which would otherwise pass an `includes` check).
+    const userPickedSheetRef = useRef(false);
+    useIsomorphicLayoutEffect(() => {
+        activeSheetIdRef.current = activeSheetId;
+    }, [activeSheetId]);
+    // Side effects
+    useIsomorphicLayoutEffect(() => {
+        if (!sheetIds.length)
+            return;
+        const firstSheetId = sheetIds[0];
+        if (!userPickedSheetRef.current) {
+            if (activeSheetIdRef.current !== firstSheetId) {
+                dispatch({ type: "CHANGE_SHEET", sheetId: firstSheetId });
+            }
+            return;
+        }
+        if (!sheetIds.includes(activeSheetIdRef.current)) {
+            dispatch({ type: "CHANGE_SHEET", sheetId: firstSheetId });
+        }
+    }, [sheetIds]);
+    // Always add placeholder sheet
+    useIsomorphicLayoutEffect(() => {
+        if (!sheets.length) {
+            const newSheet = createNewSheetHelper(1, "Sheet1");
+            onChangeSheets?.([newSheet]);
+        }
+    }, [sheets]);
+    const onChangeActiveSheet = useCallback((sheetId) => {
+        userPickedSheetRef.current = true;
+        dispatch({
+            type: "CHANGE_SHEET",
+            sheetId,
+        });
+    }, []);
+    const onChangeActiveCell = useCallback((sheetId, activeCell) => {
+        dispatch({
+            type: "CHANGE_ACTIVE_CELL",
+            activeCell,
+            sheetId,
+        });
+    }, []);
+    const onChangeSelections = useCallback((sheetId, selections) => {
+        dispatch({
+            type: "CHANGE_SELECTIONS",
+            selections,
+            sheetId,
+        });
+    }, []);
+    return {
+        ...state,
+        activeCell: state.activeCellBySheetId[activeSheetId] ?? DEFAULT_ACTIVE_CELL,
+        selections: state.selectionsBySheetId[activeSheetId] ?? DEFAULT_ARRAY,
+        onChangeActiveSheet,
+        onChangeActiveCell,
+        onChangeSelections,
+    };
+};

package/dist/esm/hooks/use-sheetdata-subscriber.d.ts

@@ -0,0 +1,10 @@
+import { Subject } from "rxjs";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+export declare const sheetDataSubscriber: Subject<boolean>;
+export declare const onSheetChange: (callback: () => void) => void;
+type UseSheetDataSubscriberProps = {
+    sheetData: UseSpreadsheetProps["sheetData"];
+};
+export declare const useSheetDataSubscriber: ({ sheetData, }: UseSheetDataSubscriberProps) => void;
+export {};
+//# sourceMappingURL=use-sheetdata-subscriber.d.ts.map

package/dist/esm/hooks/use-sheetdata-subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sheetdata-subscriber.d.ts","sourceRoot":"","sources":["../../../hooks/use-sheetdata-subscriber.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,OAAO,EAAE,MAAM,MAAM,CAAC;AAEtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,eAAO,MAAM,mBAAmB,kBAAyB,CAAC;AAE1D,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,IAAI,SAKjD,CAAC;AAEF,KAAK,2BAA2B,GAAG;IACjC,SAAS,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC;CAC7C,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,gBAEpC,2BAA2B,SAI7B,CAAC"}

package/dist/esm/hooks/use-sheetdata-subscriber.js

@@ -0,0 +1,14 @@
+import { useIsomorphicLayoutEffect } from "@rowsncolumns/spreadsheet";
+import { first, Subject } from "rxjs";
+export const sheetDataSubscriber = new Subject();
+export const onSheetChange = (callback) => {
+    const subscriber = sheetDataSubscriber.pipe(first()).subscribe(() => {
+        callback();
+        subscriber.unsubscribe();
+    });
+};
+export const useSheetDataSubscriber = ({ sheetData, }) => {
+    useIsomorphicLayoutEffect(() => {
+        sheetDataSubscriber.next(true);
+    }, [sheetData]);
+};

package/dist/esm/hooks/use-slicers.d.ts

@@ -0,0 +1,19 @@
+import type { Slicer } from "@rowsncolumns/spreadsheet";
+import { type CellData } from "@rowsncolumns/spreadsheet";
+import type { OnCommand } from "../commands";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SpreadsheetPatch } from "./use-undo-redo";
+export type UseOnSlicersProps<T extends CellData> = {
+    onChangeSlicers: UseSpreadsheetProps<T>["onChangeSlicers"];
+    createHistory(): (patches: SpreadsheetPatch) => void;
+    onCommand?: OnCommand;
+};
+export declare const useSlicers: <T extends CellData>({ onChangeSlicers, createHistory, onCommand, }: UseOnSlicersProps<T>) => {
+    onDeleteSlicer: (slicerId: string | number) => void;
+    onMoveSlicer: (slicerId: string | number, sheetId: number, anchorCell: import("@rowsncolumns/grid").CellInterface, offsetXPixels: number, offsetYPixels: number) => void;
+    onResizeSlicer: (slicerId: string | number, sheetId: number, anchorCell: import("@rowsncolumns/grid").CellInterface, offsetXPixels: number, offsetYPixels: number, width: number, height: number) => void;
+    onCreateSlicer: (spec: Slicer) => void;
+    onUpdateSlicer: (slicer: Slicer) => void;
+    onRequestEditSlicer: (slicer: Slicer) => void;
+};
+//# sourceMappingURL=use-slicers.d.ts.map

package/dist/esm/hooks/use-slicers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-slicers.d.ts","sourceRoot":"","sources":["../../../hooks/use-slicers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQ7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,QAAQ,IAAI;IAClD,eAAe,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC3D,aAAa,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,QAAQ,EAAE,gDAI5C,iBAAiB,CAAC,CAAC,CAAC;;;;2BAyGZ,MAAM;6BAjFJ,MAAM;kCA6FgC,MAAM;CAaxD,CAAC"}

package/dist/esm/hooks/use-slicers.js

@@ -0,0 +1,83 @@
+import { useFocusSheet, } from "@rowsncolumns/spreadsheet";
+import { useCallback } from "react";
+import { createSlicer, deleteSlicer, moveSlicer, resizeSlicer, updateSlicer, } from "../interface/slicers";
+export const useSlicers = ({ onChangeSlicers, createHistory, onCommand, }) => {
+    const focusSheet = useFocusSheet();
+    // Delete
+    const onDeleteSlicer = useCallback((slicerId) => {
+        if (onChangeSlicers) {
+            deleteSlicer({
+                onChangeSlicers,
+                createHistory,
+            })(slicerId);
+        }
+        focusSheet?.();
+        onCommand?.({ command: "delete-slicer", slicerId });
+    }, [onChangeSlicers, createHistory, focusSheet, onCommand]);
+    // Update
+    const onUpdateSlicer = useCallback((slicer) => {
+        if (onChangeSlicers) {
+            updateSlicer({
+                onChangeSlicers,
+                createHistory,
+            })(slicer);
+        }
+        focusSheet?.();
+        onCommand?.({ command: "update-slicer", slicer });
+    }, [onChangeSlicers, createHistory, focusSheet, onCommand]);
+    const onMoveSlicer = useCallback((slicerId, sheetId, anchorCell, offsetXPixels, offsetYPixels) => {
+        if (onChangeSlicers) {
+            moveSlicer({
+                onChangeSlicers,
+                createHistory,
+            })(slicerId, sheetId, anchorCell, offsetXPixels, offsetYPixels);
+        }
+        onCommand?.({
+            command: "move-slicer",
+            slicerId,
+            sheetId,
+            anchorCell,
+            offsetXPixels,
+            offsetYPixels,
+        });
+    }, [onChangeSlicers, createHistory, onCommand]);
+    const onResizeSlicer = useCallback((slicerId, sheetId, anchorCell, offsetXPixels, offsetYPixels, width, height) => {
+        if (onChangeSlicers) {
+            resizeSlicer({
+                onChangeSlicers,
+                createHistory,
+            })(slicerId, sheetId, anchorCell, offsetXPixels, offsetYPixels, width, height);
+        }
+        onCommand?.({
+            command: "resize-slicer",
+            slicerId,
+            sheetId,
+            anchorCell,
+            offsetXPixels,
+            offsetYPixels,
+            width,
+            height,
+        });
+    }, [onChangeSlicers, createHistory, onCommand]);
+    // Create slicer
+    const onCreateSlicer = useCallback((spec) => {
+        createSlicer({
+            createHistory,
+            onChangeSlicers,
+        })(spec);
+        onCommand?.({ command: "create-slicer", slicer: spec });
+    }, [onChangeSlicers, createHistory, onCommand]);
+    // Request edit slicer
+    const onRequestEditSlicer = useCallback((slicer) => {
+        // TODO: Add edit dialog support if needed
+        console.log("Edit slicer:", slicer);
+    }, []);
+    return {
+        onDeleteSlicer,
+        onMoveSlicer,
+        onResizeSlicer,
+        onCreateSlicer,
+        onUpdateSlicer,
+        onRequestEditSlicer,
+    };
+};

package/dist/esm/hooks/use-split-text-to-columns.d.ts

@@ -0,0 +1,19 @@
+import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
+import type { CellData, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
+import type { useCalculation } from "./use-calculation";
+import type { useSheetProperties } from "./use-sheet-properties";
+import type { useSheetState } from "./use-sheet-state";
+import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SpreadsheetPatch } from "./use-undo-redo";
+import type { OnCommand } from "../commands";
+export type UseSplitTextToColumnsProps<T extends CellData, S extends Sheet> = {
+    locale?: string;
+    getFormattedValue: ReturnType<typeof useSheetProperties>["getFormattedValue"];
+    enqueueCalculation: ReturnType<typeof useCalculation>["enqueueCalculation"];
+    createHistory: () => (patches: SpreadsheetPatch) => void;
+    onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
+    onChangeSelections: ReturnType<typeof useSheetState>["onChangeSelections"];
+    onCommand?: OnCommand;
+};
+export declare const useSplitTextToColumns: <T extends CellData, S extends Sheet>({ locale, getFormattedValue, onChangeSheetData, enqueueCalculation, createHistory, onChangeSelections, onCommand, }: UseSplitTextToColumnsProps<T, S>) => (sheetId: number, activeCell: CellInterface, selections?: SelectionArea<SelectionAttributes>[], delimiter?: string) => void;
+//# sourceMappingURL=use-split-text-to-columns.d.ts.map

package/dist/esm/hooks/use-split-text-to-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-split-text-to-columns.d.ts","sourceRoot":"","sources":["../../../hooks/use-split-text-to-columns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,0BAA0B,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC9E,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,kBAAkB,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC3E,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,qHAQxE,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,eAGpB,MAAM,cACH,aAAa,eACZ,aAAa,CAAC,mBAAmB,CAAC,EAAE,6BA+BtD,CAAC"}

package/dist/esm/hooks/use-split-text-to-columns.js

@@ -0,0 +1,30 @@
+import { useCallback } from "react";
+import { splitText } from "../interface/split-text";
+export const useSplitTextToColumns = ({ locale, getFormattedValue, onChangeSheetData, enqueueCalculation, createHistory, onChangeSelections, onCommand, }) => {
+    return useCallback((sheetId, activeCell, selections, delimiter = ",") => {
+        splitText({
+            locale,
+            getFormattedValue,
+            enqueueCalculation,
+            onChangeSheetData,
+            createHistory,
+            onChangeSelections,
+        })(sheetId, activeCell, selections, delimiter);
+        // Stream the semantic command so an engine consumer re-splits + recomputes.
+        onCommand?.({
+            command: "split-text-to-columns",
+            sheetId,
+            activeCell,
+            selections: selections ?? [],
+            delimiter,
+        });
+    }, [
+        locale,
+        getFormattedValue,
+        onChangeSheetData,
+        enqueueCalculation,
+        createHistory,
+        onChangeSelections,
+        onCommand,
+    ]);
+};