@pallasoft/ps-core-components 2.18.0 → 2.19.0

package/dist/esm/hooks/use-ps-optimistic-rows.js

@@ -0,0 +1,16 @@
+import { useCallback, useMemo, useState } from 'react';
+export const usePsOptimisticRows = ({ apply, isHolding = false, isSaving, rows, }) => {
+    const [remembered, setRemembered] = useState({
+        base: rows,
+        changes: [],
+    });
+    const changes = remembered.base === rows || isSaving || isHolding ? remembered.changes : [];
+    const shown = useMemo(() => (changes.length === 0 ? rows : apply(rows, changes)), [apply, changes, rows]);
+    const remember = useCallback((change) => setRemembered((current) => ({
+        base: rows,
+        changes: [...(current.base === rows ? current.changes : []), change],
+    })), [rows]);
+    const forgetLast = useCallback(() => setRemembered((current) => ({ base: current.base, changes: current.changes.slice(0, -1) })), []);
+    const rollback = useCallback(() => setRemembered({ base: rows, changes: [] }), [rows]);
+    return { forgetLast, remember, rollback, rows: shown };
+};

package/dist/esm/index.js

@@ -54,6 +54,9 @@ export * from './models/ps-element-size';
 export * from './models/ps-voice-orb';
 export * from './models/ps-navigation-progress';
 export * from './hooks/use-ps-debounced-value';
+export * from './hooks/use-ps-optimistic-rows';
+export * from './interfaces/ps-optimistic-rows-input';
+export * from './interfaces/ps-optimistic-rows-result';
 export * from './hooks/use-ps-navigation-progress';
 export * from './models/ps-draggable-grid';
 export * from './constants/ps-draggable-grid';

package/dist/esm/interfaces/ps-optimistic-changes.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/interfaces/ps-optimistic-rows-input.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/interfaces/ps-optimistic-rows-result.js

@@ -0,0 +1 @@
+export {};

package/dist/hooks/use-ps-optimistic-rows.d.ts

@@ -0,0 +1,3 @@
+import type { PsOptimisticRowsInput } from '../interfaces/ps-optimistic-rows-input';
+import type { PsOptimisticRowsResult } from '../interfaces/ps-optimistic-rows-result';
+export declare const usePsOptimisticRows: <Row, Change>({ apply, isHolding, isSaving, rows, }: PsOptimisticRowsInput<Row, Change>) => PsOptimisticRowsResult<Row, Change>;

package/dist/hooks/use-ps-optimistic-rows.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePsOptimisticRows = void 0;
+const react_1 = require("react");
+const usePsOptimisticRows = ({ apply, isHolding = false, isSaving, rows, }) => {
+    const [remembered, setRemembered] = (0, react_1.useState)({
+        base: rows,
+        changes: [],
+    });
+    const changes = remembered.base === rows || isSaving || isHolding ? remembered.changes : [];
+    const shown = (0, react_1.useMemo)(() => (changes.length === 0 ? rows : apply(rows, changes)), [apply, changes, rows]);
+    const remember = (0, react_1.useCallback)((change) => setRemembered((current) => ({
+        base: rows,
+        changes: [...(current.base === rows ? current.changes : []), change],
+    })), [rows]);
+    const forgetLast = (0, react_1.useCallback)(() => setRemembered((current) => ({ base: current.base, changes: current.changes.slice(0, -1) })), []);
+    const rollback = (0, react_1.useCallback)(() => setRemembered({ base: rows, changes: [] }), [rows]);
+    return { forgetLast, remember, rollback, rows: shown };
+};
+exports.usePsOptimisticRows = usePsOptimisticRows;

package/dist/index.d.ts

@@ -54,6 +54,9 @@ export * from './models/ps-element-size';
 export * from './models/ps-voice-orb';
 export * from './models/ps-navigation-progress';
 export * from './hooks/use-ps-debounced-value';
+export * from './hooks/use-ps-optimistic-rows';
+export * from './interfaces/ps-optimistic-rows-input';
+export * from './interfaces/ps-optimistic-rows-result';
 export * from './hooks/use-ps-navigation-progress';
 export * from './models/ps-draggable-grid';
 export * from './constants/ps-draggable-grid';

package/dist/index.js

@@ -70,6 +70,9 @@ __exportStar(require("./models/ps-element-size"), exports);
 __exportStar(require("./models/ps-voice-orb"), exports);
 __exportStar(require("./models/ps-navigation-progress"), exports);
 __exportStar(require("./hooks/use-ps-debounced-value"), exports);
+__exportStar(require("./hooks/use-ps-optimistic-rows"), exports);
+__exportStar(require("./interfaces/ps-optimistic-rows-input"), exports);
+__exportStar(require("./interfaces/ps-optimistic-rows-result"), exports);
 __exportStar(require("./hooks/use-ps-navigation-progress"), exports);
 __exportStar(require("./models/ps-draggable-grid"), exports);
 __exportStar(require("./constants/ps-draggable-grid"), exports);

package/dist/interfaces/ps-optimistic-changes.d.ts

@@ -0,0 +1,4 @@
+export interface PsOptimisticChanges<Row, Change> {
+    base: Row[];
+    changes: Change[];
+}

package/dist/interfaces/ps-optimistic-changes.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/ps-optimistic-rows-input.d.ts

@@ -0,0 +1,6 @@
+export interface PsOptimisticRowsInput<Row, Change> {
+    apply: (rows: Row[], changes: Change[]) => Row[];
+    isHolding?: boolean;
+    isSaving: boolean;
+    rows: Row[];
+}

package/dist/interfaces/ps-optimistic-rows-input.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/ps-optimistic-rows-result.d.ts

@@ -0,0 +1,6 @@
+export interface PsOptimisticRowsResult<Row, Change> {
+    forgetLast: () => void;
+    remember: (change: Change) => void;
+    rollback: () => void;
+    rows: Row[];
+}

package/dist/interfaces/ps-optimistic-rows-result.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pallasoft/ps-core-components",
-	"version": "2.18.0",
+	"version": "2.19.0",
 	"private": false,
 	"main": "./dist/index.js",
 	"module": "./dist/esm/index.js",