@pallasoft/ps-core-components 2.29.0 → 2.31.0

package/dist/components/ps-document-row.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+export interface PsDocumentRowProps {
+    actions?: ReactNode;
+    amount?: ReactNode;
+    badges?: ReactNode;
+    className?: string;
+    date?: string;
+    isSelected?: boolean;
+    note?: ReactNode;
+    onOpen?: () => void;
+    onPrefetch?: () => void;
+    select?: ReactNode;
+    subtitle?: string;
+    thumbnailAlt?: string;
+    thumbnailFallback?: ReactNode;
+    thumbnailSrc?: string | null;
+    title: string;
+}
+export declare const PsDocumentRow: ({ actions, amount, badges, className, date, isSelected, note, onOpen, onPrefetch, select, subtitle, thumbnailAlt, thumbnailFallback, thumbnailSrc, title, }: PsDocumentRowProps) => import("react").JSX.Element;

package/dist/components/ps-document-row.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsDocumentRow = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ps_design_system_1 = require("@pallasoft/ps-design-system");
+const PsDocumentRow = ({ actions, amount, badges, className, date, isSelected = false, note, onOpen, onPrefetch, select, subtitle, thumbnailAlt = '', thumbnailFallback, thumbnailSrc, title, }) => {
+    const Main = onOpen ? 'button' : 'div';
+    return ((0, jsx_runtime_1.jsxs)("div", { className: ps_design_system_1.PallasoftClassNameService.merge('flex min-w-0 flex-wrap items-center gap-x-3 gap-y-2 border-b border-line/70 px-3 py-3 transition-colors last:border-b-0 sm:flex-nowrap', isSelected ? 'bg-primary/5' : 'hover:bg-mist/40', className), children: [select ? (0, jsx_runtime_1.jsx)("span", { className: 'flex shrink-0 items-center', children: select }) : null, (0, jsx_runtime_1.jsxs)(Main, { className: 'ps-focus-ring grid min-w-0 flex-1 basis-0 grid-cols-[auto_minmax(0,1fr)] items-center gap-x-3 gap-y-1 rounded-ps-control text-left sm:grid-cols-[auto_minmax(0,1fr)_auto]', ...(onOpen
+                    ? {
+                        onClick: onOpen,
+                        onFocus: onPrefetch,
+                        onPointerEnter: onPrefetch,
+                        type: 'button',
+                    }
+                    : {}), children: [(0, jsx_runtime_1.jsx)("span", { className: 'row-span-2 flex h-14 w-11 shrink-0 items-center justify-center overflow-hidden rounded-ps-control border border-line/60 bg-mist/40 sm:row-span-1', children: thumbnailSrc ? ((0, jsx_runtime_1.jsx)("img", { alt: thumbnailAlt, className: 'h-full w-full object-cover object-top', decoding: 'async', loading: 'lazy', src: thumbnailSrc })) : (thumbnailFallback) }), (0, jsx_runtime_1.jsxs)("span", { className: 'flex min-w-0 flex-col gap-0.5', children: [(0, jsx_runtime_1.jsx)("span", { className: 'truncate text-sm font-semibold text-ink', children: title }), subtitle ? (0, jsx_runtime_1.jsx)("span", { className: 'truncate text-xs text-ink/55', children: subtitle }) : null, badges ? ((0, jsx_runtime_1.jsx)("span", { className: 'flex flex-wrap items-center gap-1.5 pt-1', children: badges })) : null, note ? ((0, jsx_runtime_1.jsx)("span", { className: 'line-clamp-2 break-words pt-0.5 text-xs text-ink/70', children: note })) : null] }), amount || date ? ((0, jsx_runtime_1.jsxs)("span", { className: 'col-start-2 flex items-baseline gap-2 sm:col-start-3 sm:flex-col sm:items-end sm:gap-0.5', children: [amount ? ((0, jsx_runtime_1.jsx)("span", { className: 'text-sm font-semibold tabular-nums text-ink', children: amount })) : null, date ? (0, jsx_runtime_1.jsx)("span", { className: 'text-xs tabular-nums text-ink/55', children: date }) : null] })) : null] }), actions ? ((0, jsx_runtime_1.jsx)("div", { className: 'flex w-full shrink-0 items-center justify-end gap-2 sm:w-auto', children: actions })) : null] }));
+};
+exports.PsDocumentRow = PsDocumentRow;

package/dist/components/ps-selection-bar.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from 'react';
+export interface PsSelectionBarProps {
+    children: ReactNode;
+    className?: string;
+    clearLabel: string;
+    countLabel: string;
+    onClear: () => void;
+}
+export declare const PsSelectionBar: ({ children, className, clearLabel, countLabel, onClear, }: PsSelectionBarProps) => import("react").JSX.Element;

package/dist/components/ps-selection-bar.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsSelectionBar = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ps_design_system_1 = require("@pallasoft/ps-design-system");
+const ps_icons_1 = require("@pallasoft/ps-icons");
+const PsSelectionBar = ({ children, className, clearLabel, countLabel, onClear, }) => ((0, jsx_runtime_1.jsxs)("div", { "aria-live": 'polite', className: ps_design_system_1.PallasoftClassNameService.merge('sticky bottom-3 z-10 flex min-w-0 flex-wrap items-center gap-x-3 gap-y-2 rounded-ps-card border border-line bg-surface px-4 py-2 shadow-lg', className), role: 'toolbar', children: [(0, jsx_runtime_1.jsx)("span", { className: 'text-sm font-semibold text-ink', children: countLabel }), (0, jsx_runtime_1.jsx)("div", { className: 'flex min-w-0 flex-1 flex-wrap items-center gap-2', children: children }), (0, jsx_runtime_1.jsx)("button", { "aria-label": clearLabel, className: 'ps-focus-ring ps-control-square inline-flex shrink-0 items-center justify-center rounded-ps-control text-ink/65 transition-colors hover:bg-ink/5 hover:text-ink', onClick: onClear, title: clearLabel, type: 'button', children: (0, jsx_runtime_1.jsx)(ps_icons_1.PsIcon, { "aria-hidden": 'true', className: 'size-4', iconKey: ps_icons_1.PsIconKey.Close }) })] }));
+exports.PsSelectionBar = PsSelectionBar;

package/dist/constants/ps-optimistic-config.d.ts

@@ -0,0 +1,3 @@
+export declare const PsOptimisticConfig: {
+    readonly pendingPrefix: "pending-";
+};

package/dist/constants/ps-optimistic-config.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsOptimisticConfig = void 0;
+exports.PsOptimisticConfig = {
+    pendingPrefix: 'pending-',
+};

package/dist/esm/components/ps-document-row.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { PallasoftClassNameService } from '@pallasoft/ps-design-system';
+export const PsDocumentRow = ({ actions, amount, badges, className, date, isSelected = false, note, onOpen, onPrefetch, select, subtitle, thumbnailAlt = '', thumbnailFallback, thumbnailSrc, title, }) => {
+    const Main = onOpen ? 'button' : 'div';
+    return (_jsxs("div", { className: PallasoftClassNameService.merge('flex min-w-0 flex-wrap items-center gap-x-3 gap-y-2 border-b border-line/70 px-3 py-3 transition-colors last:border-b-0 sm:flex-nowrap', isSelected ? 'bg-primary/5' : 'hover:bg-mist/40', className), children: [select ? _jsx("span", { className: 'flex shrink-0 items-center', children: select }) : null, _jsxs(Main, { className: 'ps-focus-ring grid min-w-0 flex-1 basis-0 grid-cols-[auto_minmax(0,1fr)] items-center gap-x-3 gap-y-1 rounded-ps-control text-left sm:grid-cols-[auto_minmax(0,1fr)_auto]', ...(onOpen
+                    ? {
+                        onClick: onOpen,
+                        onFocus: onPrefetch,
+                        onPointerEnter: onPrefetch,
+                        type: 'button',
+                    }
+                    : {}), children: [_jsx("span", { className: 'row-span-2 flex h-14 w-11 shrink-0 items-center justify-center overflow-hidden rounded-ps-control border border-line/60 bg-mist/40 sm:row-span-1', children: thumbnailSrc ? (_jsx("img", { alt: thumbnailAlt, className: 'h-full w-full object-cover object-top', decoding: 'async', loading: 'lazy', src: thumbnailSrc })) : (thumbnailFallback) }), _jsxs("span", { className: 'flex min-w-0 flex-col gap-0.5', children: [_jsx("span", { className: 'truncate text-sm font-semibold text-ink', children: title }), subtitle ? _jsx("span", { className: 'truncate text-xs text-ink/55', children: subtitle }) : null, badges ? (_jsx("span", { className: 'flex flex-wrap items-center gap-1.5 pt-1', children: badges })) : null, note ? (_jsx("span", { className: 'line-clamp-2 break-words pt-0.5 text-xs text-ink/70', children: note })) : null] }), amount || date ? (_jsxs("span", { className: 'col-start-2 flex items-baseline gap-2 sm:col-start-3 sm:flex-col sm:items-end sm:gap-0.5', children: [amount ? (_jsx("span", { className: 'text-sm font-semibold tabular-nums text-ink', children: amount })) : null, date ? _jsx("span", { className: 'text-xs tabular-nums text-ink/55', children: date }) : null] })) : null] }), actions ? (_jsx("div", { className: 'flex w-full shrink-0 items-center justify-end gap-2 sm:w-auto', children: actions })) : null] }));
+};

package/dist/esm/components/ps-selection-bar.js

@@ -0,0 +1,4 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { PallasoftClassNameService } from '@pallasoft/ps-design-system';
+import { PsIcon, PsIconKey } from '@pallasoft/ps-icons';
+export const PsSelectionBar = ({ children, className, clearLabel, countLabel, onClear, }) => (_jsxs("div", { "aria-live": 'polite', className: PallasoftClassNameService.merge('sticky bottom-3 z-10 flex min-w-0 flex-wrap items-center gap-x-3 gap-y-2 rounded-ps-card border border-line bg-surface px-4 py-2 shadow-lg', className), role: 'toolbar', children: [_jsx("span", { className: 'text-sm font-semibold text-ink', children: countLabel }), _jsx("div", { className: 'flex min-w-0 flex-1 flex-wrap items-center gap-2', children: children }), _jsx("button", { "aria-label": clearLabel, className: 'ps-focus-ring ps-control-square inline-flex shrink-0 items-center justify-center rounded-ps-control text-ink/65 transition-colors hover:bg-ink/5 hover:text-ink', onClick: onClear, title: clearLabel, type: 'button', children: _jsx(PsIcon, { "aria-hidden": 'true', className: 'size-4', iconKey: PsIconKey.Close }) })] }));

package/dist/esm/constants/ps-optimistic-config.js

@@ -0,0 +1,3 @@
+export const PsOptimisticConfig = {
+    pendingPrefix: 'pending-',
+};

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

@@ -33,7 +33,7 @@ export const usePsOptimisticFetcher = ({ apply, fetcher, isHolding = false, isSu
         settle.current = resolve;
         sawBusy.current = false;
         dataBefore.current = dataSeen.current;
-        void fetcher.submit(values, { method: 'post' });
+        void fetcher.submit(values, { defaultShouldRevalidate: false, method: 'post' });
     }), [fetcher]);
     const send = useCallback(async (queued) => {
         for (const submission of merge === undefined ? queued : merge(queued)) {

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

@@ -0,0 +1,17 @@
+import { useCallback } from 'react';
+import { PsOptimisticSaveService } from '../services/ps-optimistic-save-service';
+import { usePsOptimisticFetcher } from './use-ps-optimistic-fetcher';
+export const usePsOptimisticSave = ({ fetcher, isSuccess, revalidator, rows, scopeId, spec, }) => {
+    const apply = useCallback((base, changes) => PsOptimisticSaveService.apply(base, changes, spec), [spec]);
+    const optimistic = usePsOptimisticFetcher({
+        apply,
+        fetcher,
+        isSuccess,
+        revalidator,
+        rows,
+    });
+    const { submit } = optimistic;
+    const save = useCallback((values, existingId) => submit(PsOptimisticSaveService.saveValues(spec, values, existingId, scopeId)), [scopeId, spec, submit]);
+    const remove = useCallback((ids) => submit(PsOptimisticSaveService.removeValues(spec, ids)), [spec, submit]);
+    return { remove, rows: optimistic.rows, save };
+};

package/dist/esm/index.js

@@ -25,6 +25,8 @@ export * from './models/ps-sortable-list';
 export * from './components/ps-empty-state';
 export * from './components/ps-fab';
 export * from './components/ps-infinite-scroll';
+export * from './components/ps-document-row';
+export * from './components/ps-selection-bar';
 export * from './components/ps-list-tile';
 export * from './components/ps-metric-card';
 export * from './components/ps-pill';
@@ -76,6 +78,14 @@ export * from './interfaces/ps-change-queue-input';
 export * from './interfaces/ps-change-queue-result';
 export * from './hooks/use-ps-optimistic-rows';
 export * from './hooks/use-ps-optimistic-fetcher';
+export * from './hooks/use-ps-optimistic-save';
+export * from './constants/ps-optimistic-config';
+export * from './interfaces/ps-optimistic-save-input';
+export * from './interfaces/ps-optimistic-save-result';
+export * from './interfaces/ps-optimistic-save-spec';
+export * from './interfaces/ps-revalidation-args';
+export * from './services/ps-optimistic-save-service';
+export * from './services/ps-client-param-revalidation-service';
 export * from './interfaces/ps-fetcher-like';
 export * from './interfaces/ps-fetcher-submit-options';
 export * from './interfaces/ps-optimistic-fetcher-input';

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

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

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

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

package/dist/esm/interfaces/ps-optimistic-save-spec.js

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

package/dist/esm/interfaces/ps-revalidation-args.js

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

package/dist/esm/services/ps-client-param-revalidation-service.js

@@ -0,0 +1,26 @@
+export class PsClientParamRevalidationService {
+    static isClientOnlyChange(currentUrl, nextUrl, clientParams) {
+        if (currentUrl.href === nextUrl.href)
+            return false;
+        const without = (url) => {
+            const params = new URLSearchParams(url.search);
+            for (const name of clientParams)
+                params.delete(name);
+            params.sort();
+            return `${url.pathname}?${params.toString()}`;
+        };
+        return without(currentUrl) === without(nextUrl);
+    }
+    static shouldRevalidate({ currentUrl, defaultShouldRevalidate, formMethod, nextUrl }, clientParams) {
+        if (formMethod === undefined &&
+            PsClientParamRevalidationService.isClientOnlyChange(currentUrl, nextUrl, clientParams))
+            return false;
+        return defaultShouldRevalidate;
+    }
+    static shouldRevalidateAfterAction(args, quietPaths) {
+        if (args.formMethod === undefined || args.formAction === undefined)
+            return args.defaultShouldRevalidate;
+        const path = new URL(args.formAction, args.currentUrl).pathname;
+        return quietPaths.includes(path) ? false : args.defaultShouldRevalidate;
+    }
+}

package/dist/esm/services/ps-optimistic-save-service.js

@@ -0,0 +1,64 @@
+import { PsOptimisticConfig } from '../constants/ps-optimistic-config';
+export class PsOptimisticSaveService {
+    static isPending(id) {
+        return id.startsWith(PsOptimisticConfig.pendingPrefix);
+    }
+    static pendingId() {
+        return `${PsOptimisticConfig.pendingPrefix}${crypto.randomUUID()}`;
+    }
+    static saveValues(spec, values, existingId, scopeId) {
+        const fields = spec.isFlat
+            ? Object.fromEntries(Object.entries(values).map(([key, value]) => [key, String(value)]))
+            : { values: JSON.stringify(values) };
+        return {
+            ...fields,
+            [spec.idField]: existingId,
+            intent: spec.intent,
+            pendingId: PsOptimisticSaveService.pendingId(),
+            scopeId,
+        };
+    }
+    static removeValues(spec, ids) {
+        return spec.remove === undefined
+            ? {}
+            : { [spec.remove.idsField]: JSON.stringify(ids), intent: spec.remove.intent };
+    }
+    static apply(rows, changes, spec) {
+        return changes.reduce((current, change) => {
+            if (change.intent === spec.intent)
+                return PsOptimisticSaveService.saved(current, change, spec);
+            if (spec.remove !== undefined && change.intent === spec.remove.intent)
+                return PsOptimisticSaveService.removed(current, change, spec, spec.remove.idsField);
+            return current;
+        }, rows);
+    }
+    static read(raw) {
+        if (raw === undefined)
+            return null;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    static saved(rows, change, spec) {
+        const parsed = spec.isFlat ? change : PsOptimisticSaveService.read(change.values);
+        if (parsed === null || typeof parsed !== 'object')
+            return rows;
+        const existingId = change[spec.idField];
+        const id = existingId === '' ? change.pendingId : existingId;
+        const previous = rows.find((row) => spec.getId(row) === existingId);
+        const built = spec.build(parsed, id, previous === undefined ? null : previous, change.scopeId);
+        if (built === null)
+            return rows;
+        return previous === undefined
+            ? [...rows, built]
+            : rows.map((row) => (spec.getId(row) === existingId ? built : row));
+    }
+    static removed(rows, change, spec, idsField) {
+        const parsed = PsOptimisticSaveService.read(change[idsField]);
+        const ids = new Set(Array.isArray(parsed) ? parsed : []);
+        return rows.filter((row) => !ids.has(spec.getId(row)));
+    }
+}

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

@@ -36,7 +36,7 @@ const usePsOptimisticFetcher = ({ apply, fetcher, isHolding = false, isSuccess,
         settle.current = resolve;
         sawBusy.current = false;
         dataBefore.current = dataSeen.current;
-        void fetcher.submit(values, { method: 'post' });
+        void fetcher.submit(values, { defaultShouldRevalidate: false, method: 'post' });
     }), [fetcher]);
     const send = (0, react_1.useCallback)(async (queued) => {
         for (const submission of merge === undefined ? queued : merge(queued)) {

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

@@ -0,0 +1,3 @@
+import type { PsOptimisticSaveInput } from '../interfaces/ps-optimistic-save-input';
+import type { PsOptimisticSaveResult } from '../interfaces/ps-optimistic-save-result';
+export declare const usePsOptimisticSave: <Row, Values, Data>({ fetcher, isSuccess, revalidator, rows, scopeId, spec, }: PsOptimisticSaveInput<Row, Values, Data>) => PsOptimisticSaveResult<Row, Values>;

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePsOptimisticSave = void 0;
+const react_1 = require("react");
+const ps_optimistic_save_service_1 = require("../services/ps-optimistic-save-service");
+const use_ps_optimistic_fetcher_1 = require("./use-ps-optimistic-fetcher");
+const usePsOptimisticSave = ({ fetcher, isSuccess, revalidator, rows, scopeId, spec, }) => {
+    const apply = (0, react_1.useCallback)((base, changes) => ps_optimistic_save_service_1.PsOptimisticSaveService.apply(base, changes, spec), [spec]);
+    const optimistic = (0, use_ps_optimistic_fetcher_1.usePsOptimisticFetcher)({
+        apply,
+        fetcher,
+        isSuccess,
+        revalidator,
+        rows,
+    });
+    const { submit } = optimistic;
+    const save = (0, react_1.useCallback)((values, existingId) => submit(ps_optimistic_save_service_1.PsOptimisticSaveService.saveValues(spec, values, existingId, scopeId)), [scopeId, spec, submit]);
+    const remove = (0, react_1.useCallback)((ids) => submit(ps_optimistic_save_service_1.PsOptimisticSaveService.removeValues(spec, ids)), [spec, submit]);
+    return { remove, rows: optimistic.rows, save };
+};
+exports.usePsOptimisticSave = usePsOptimisticSave;

package/dist/index.d.ts

@@ -25,6 +25,8 @@ export * from './models/ps-sortable-list';
 export * from './components/ps-empty-state';
 export * from './components/ps-fab';
 export * from './components/ps-infinite-scroll';
+export * from './components/ps-document-row';
+export * from './components/ps-selection-bar';
 export * from './components/ps-list-tile';
 export * from './components/ps-metric-card';
 export * from './components/ps-pill';
@@ -76,6 +78,14 @@ export * from './interfaces/ps-change-queue-input';
 export * from './interfaces/ps-change-queue-result';
 export * from './hooks/use-ps-optimistic-rows';
 export * from './hooks/use-ps-optimistic-fetcher';
+export * from './hooks/use-ps-optimistic-save';
+export * from './constants/ps-optimistic-config';
+export * from './interfaces/ps-optimistic-save-input';
+export * from './interfaces/ps-optimistic-save-result';
+export * from './interfaces/ps-optimistic-save-spec';
+export * from './interfaces/ps-revalidation-args';
+export * from './services/ps-optimistic-save-service';
+export * from './services/ps-client-param-revalidation-service';
 export * from './interfaces/ps-fetcher-like';
 export * from './interfaces/ps-fetcher-submit-options';
 export * from './interfaces/ps-optimistic-fetcher-input';

package/dist/index.js

@@ -41,6 +41,8 @@ __exportStar(require("./models/ps-sortable-list"), exports);
 __exportStar(require("./components/ps-empty-state"), exports);
 __exportStar(require("./components/ps-fab"), exports);
 __exportStar(require("./components/ps-infinite-scroll"), exports);
+__exportStar(require("./components/ps-document-row"), exports);
+__exportStar(require("./components/ps-selection-bar"), exports);
 __exportStar(require("./components/ps-list-tile"), exports);
 __exportStar(require("./components/ps-metric-card"), exports);
 __exportStar(require("./components/ps-pill"), exports);
@@ -92,6 +94,14 @@ __exportStar(require("./interfaces/ps-change-queue-input"), exports);
 __exportStar(require("./interfaces/ps-change-queue-result"), exports);
 __exportStar(require("./hooks/use-ps-optimistic-rows"), exports);
 __exportStar(require("./hooks/use-ps-optimistic-fetcher"), exports);
+__exportStar(require("./hooks/use-ps-optimistic-save"), exports);
+__exportStar(require("./constants/ps-optimistic-config"), exports);
+__exportStar(require("./interfaces/ps-optimistic-save-input"), exports);
+__exportStar(require("./interfaces/ps-optimistic-save-result"), exports);
+__exportStar(require("./interfaces/ps-optimistic-save-spec"), exports);
+__exportStar(require("./interfaces/ps-revalidation-args"), exports);
+__exportStar(require("./services/ps-optimistic-save-service"), exports);
+__exportStar(require("./services/ps-client-param-revalidation-service"), exports);
 __exportStar(require("./interfaces/ps-fetcher-like"), exports);
 __exportStar(require("./interfaces/ps-fetcher-submit-options"), exports);
 __exportStar(require("./interfaces/ps-optimistic-fetcher-input"), exports);

package/dist/interfaces/ps-fetcher-submit-options.d.ts

@@ -1,3 +1,4 @@
 export interface PsFetcherSubmitOptions {
+    defaultShouldRevalidate: boolean;
     method: 'post';
 }

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

@@ -0,0 +1,11 @@
+import type { PsFetcherLike } from './ps-fetcher-like';
+import type { PsOptimisticSaveSpec } from './ps-optimistic-save-spec';
+import type { PsRevalidatorLike } from './ps-revalidator-like';
+export interface PsOptimisticSaveInput<Row, Values, Data> {
+    fetcher: PsFetcherLike<Data>;
+    isSuccess: (data: Data | undefined) => boolean;
+    revalidator: PsRevalidatorLike;
+    rows: Row[];
+    scopeId: string;
+    spec: PsOptimisticSaveSpec<Row, Values>;
+}

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

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

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

@@ -0,0 +1,5 @@
+export interface PsOptimisticSaveResult<Row, Values> {
+    remove: (ids: string[]) => void;
+    rows: Row[];
+    save: (values: Values, existingId: string) => void;
+}

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

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

package/dist/interfaces/ps-optimistic-save-spec.d.ts

@@ -0,0 +1,11 @@
+export interface PsOptimisticSaveSpec<Row, Values> {
+    build: (values: Values, id: string, previous: Row | null, scopeId: string) => Row | null;
+    getId: (row: Row) => string;
+    idField: string;
+    intent: string;
+    isFlat: boolean;
+    remove?: {
+        idsField: string;
+        intent: string;
+    };
+}

package/dist/interfaces/ps-optimistic-save-spec.js

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

package/dist/interfaces/ps-revalidation-args.d.ts

@@ -0,0 +1,7 @@
+export interface PsRevalidationArgs {
+    currentUrl: URL;
+    defaultShouldRevalidate: boolean;
+    formAction?: string;
+    formMethod?: string;
+    nextUrl: URL;
+}

package/dist/interfaces/ps-revalidation-args.js

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

package/dist/services/ps-client-param-revalidation-service.d.ts

@@ -0,0 +1,6 @@
+import type { PsRevalidationArgs } from '../interfaces/ps-revalidation-args';
+export declare class PsClientParamRevalidationService {
+    static isClientOnlyChange(currentUrl: URL, nextUrl: URL, clientParams: readonly string[]): boolean;
+    static shouldRevalidate({ currentUrl, defaultShouldRevalidate, formMethod, nextUrl }: PsRevalidationArgs, clientParams: readonly string[]): boolean;
+    static shouldRevalidateAfterAction(args: PsRevalidationArgs, quietPaths: readonly string[]): boolean;
+}

package/dist/services/ps-client-param-revalidation-service.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsClientParamRevalidationService = void 0;
+class PsClientParamRevalidationService {
+    static isClientOnlyChange(currentUrl, nextUrl, clientParams) {
+        if (currentUrl.href === nextUrl.href)
+            return false;
+        const without = (url) => {
+            const params = new URLSearchParams(url.search);
+            for (const name of clientParams)
+                params.delete(name);
+            params.sort();
+            return `${url.pathname}?${params.toString()}`;
+        };
+        return without(currentUrl) === without(nextUrl);
+    }
+    static shouldRevalidate({ currentUrl, defaultShouldRevalidate, formMethod, nextUrl }, clientParams) {
+        if (formMethod === undefined &&
+            PsClientParamRevalidationService.isClientOnlyChange(currentUrl, nextUrl, clientParams))
+            return false;
+        return defaultShouldRevalidate;
+    }
+    static shouldRevalidateAfterAction(args, quietPaths) {
+        if (args.formMethod === undefined || args.formAction === undefined)
+            return args.defaultShouldRevalidate;
+        const path = new URL(args.formAction, args.currentUrl).pathname;
+        return quietPaths.includes(path) ? false : args.defaultShouldRevalidate;
+    }
+}
+exports.PsClientParamRevalidationService = PsClientParamRevalidationService;

package/dist/services/ps-optimistic-save-service.d.ts

@@ -0,0 +1,11 @@
+import type { PsOptimisticSaveSpec } from '../interfaces/ps-optimistic-save-spec';
+export declare class PsOptimisticSaveService {
+    static isPending(id: string): boolean;
+    static pendingId(): string;
+    static saveValues<Row, Values>(spec: PsOptimisticSaveSpec<Row, Values>, values: Values, existingId: string, scopeId: string): Record<string, string>;
+    static removeValues<Row, Values>(spec: PsOptimisticSaveSpec<Row, Values>, ids: string[]): Record<string, string>;
+    static apply<Row, Values>(rows: Row[], changes: Record<string, string>[], spec: PsOptimisticSaveSpec<Row, Values>): Row[];
+    private static read;
+    private static saved;
+    private static removed;
+}

package/dist/services/ps-optimistic-save-service.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsOptimisticSaveService = void 0;
+const ps_optimistic_config_1 = require("../constants/ps-optimistic-config");
+class PsOptimisticSaveService {
+    static isPending(id) {
+        return id.startsWith(ps_optimistic_config_1.PsOptimisticConfig.pendingPrefix);
+    }
+    static pendingId() {
+        return `${ps_optimistic_config_1.PsOptimisticConfig.pendingPrefix}${crypto.randomUUID()}`;
+    }
+    static saveValues(spec, values, existingId, scopeId) {
+        const fields = spec.isFlat
+            ? Object.fromEntries(Object.entries(values).map(([key, value]) => [key, String(value)]))
+            : { values: JSON.stringify(values) };
+        return {
+            ...fields,
+            [spec.idField]: existingId,
+            intent: spec.intent,
+            pendingId: PsOptimisticSaveService.pendingId(),
+            scopeId,
+        };
+    }
+    static removeValues(spec, ids) {
+        return spec.remove === undefined
+            ? {}
+            : { [spec.remove.idsField]: JSON.stringify(ids), intent: spec.remove.intent };
+    }
+    static apply(rows, changes, spec) {
+        return changes.reduce((current, change) => {
+            if (change.intent === spec.intent)
+                return PsOptimisticSaveService.saved(current, change, spec);
+            if (spec.remove !== undefined && change.intent === spec.remove.intent)
+                return PsOptimisticSaveService.removed(current, change, spec, spec.remove.idsField);
+            return current;
+        }, rows);
+    }
+    static read(raw) {
+        if (raw === undefined)
+            return null;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    static saved(rows, change, spec) {
+        const parsed = spec.isFlat ? change : PsOptimisticSaveService.read(change.values);
+        if (parsed === null || typeof parsed !== 'object')
+            return rows;
+        const existingId = change[spec.idField];
+        const id = existingId === '' ? change.pendingId : existingId;
+        const previous = rows.find((row) => spec.getId(row) === existingId);
+        const built = spec.build(parsed, id, previous === undefined ? null : previous, change.scopeId);
+        if (built === null)
+            return rows;
+        return previous === undefined
+            ? [...rows, built]
+            : rows.map((row) => (spec.getId(row) === existingId ? built : row));
+    }
+    static removed(rows, change, spec, idsField) {
+        const parsed = PsOptimisticSaveService.read(change[idsField]);
+        const ids = new Set(Array.isArray(parsed) ? parsed : []);
+        return rows.filter((row) => !ids.has(spec.getId(row)));
+    }
+}
+exports.PsOptimisticSaveService = PsOptimisticSaveService;

package/package.json

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