@pallasoft/ps-core-components 2.20.0 → 2.22.0

package/dist/components/ps-client-only.d.ts

@@ -0,0 +1,6 @@
+import type { ReactNode } from 'react';
+export interface PsClientOnlyProps {
+    children: () => ReactNode;
+    fallback?: ReactNode;
+}
+export declare const PsClientOnly: ({ children, fallback }: PsClientOnlyProps) => import("react").JSX.Element;

package/dist/components/ps-client-only.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsClientOnly = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const use_ps_hydrated_1 = require("../hooks/use-ps-hydrated");
+const PsClientOnly = ({ children, fallback = null }) => (0, use_ps_hydrated_1.usePsHydrated)() ? (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: children() }) : (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: fallback });
+exports.PsClientOnly = PsClientOnly;

package/dist/constants/ps-hydration-store.d.ts

@@ -0,0 +1,5 @@
+export declare const PsHydrationStore: {
+    readonly subscribe: () => (() => void);
+    readonly clientSnapshot: () => boolean;
+    readonly serverSnapshot: () => boolean;
+};

package/dist/constants/ps-hydration-store.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsHydrationStore = void 0;
+exports.PsHydrationStore = {
+    subscribe: () => () => undefined,
+    clientSnapshot: () => true,
+    serverSnapshot: () => false,
+};

package/dist/esm/components/ps-client-only.js

@@ -0,0 +1,3 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { usePsHydrated } from '../hooks/use-ps-hydrated';
+export const PsClientOnly = ({ children, fallback = null }) => usePsHydrated() ? _jsx(_Fragment, { children: children() }) : _jsx(_Fragment, { children: fallback });

package/dist/esm/constants/ps-hydration-store.js

@@ -0,0 +1,5 @@
+export const PsHydrationStore = {
+    subscribe: () => () => undefined,
+    clientSnapshot: () => true,
+    serverSnapshot: () => false,
+};

package/dist/esm/hooks/use-ps-change-queue.js

@@ -0,0 +1,31 @@
+import { useCallback, useEffect, useRef } from 'react';
+export const usePsChangeQueue = ({ onDrained, onFailed, send, }) => {
+    const pending = useRef([]);
+    const isRunning = useRef(false);
+    const latest = useRef({ onDrained, onFailed, send });
+    useEffect(() => {
+        latest.current = { onDrained, onFailed, send };
+    }, [onDrained, onFailed, send]);
+    const run = useCallback(async () => {
+        if (isRunning.current)
+            return;
+        isRunning.current = true;
+        await Promise.resolve();
+        while (pending.current.length > 0) {
+            const batch = pending.current;
+            pending.current = [];
+            await latest.current.send(batch).catch(() => {
+                const dropped = pending.current;
+                pending.current = [];
+                latest.current.onFailed(batch, dropped);
+            });
+        }
+        isRunning.current = false;
+        latest.current.onDrained();
+    }, []);
+    const enqueue = useCallback((change) => {
+        pending.current = [...pending.current, change];
+        void run();
+    }, [run]);
+    return { enqueue };
+};

package/dist/esm/hooks/use-ps-hydrated.js

@@ -0,0 +1,3 @@
+import { useSyncExternalStore } from 'react';
+import { PsHydrationStore } from '../constants/ps-hydration-store';
+export const usePsHydrated = () => useSyncExternalStore(PsHydrationStore.subscribe, PsHydrationStore.clientSnapshot, PsHydrationStore.serverSnapshot);

package/dist/esm/index.js

@@ -10,6 +10,7 @@ export * from './components/ps-pallasoft-mark';
 export * from './components/ps-pallasoft-sign-in-button';
 export * from './constants/ps-pallasoft-mark-config';
 export * from './components/ps-card';
+export * from './components/ps-client-only';
 export * from './components/ps-draggable-grid';
 export * from './components/ps-empty-state';
 export * from './components/ps-fab';
@@ -48,12 +49,16 @@ export * from './contexts/ps-layer-context';
 export * from './hooks/use-ps-layer-z-index';
 export * from './hooks/use-ps-route-loader-data';
 export * from './hooks/use-ps-element-size';
+export * from './hooks/use-ps-hydrated';
 export * from './hooks/use-ps-viewport';
 export * from './interfaces/ps-component-props';
 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-change-queue';
+export * from './interfaces/ps-change-queue-input';
+export * from './interfaces/ps-change-queue-result';
 export * from './hooks/use-ps-optimistic-rows';
 export * from './interfaces/ps-optimistic-rows-input';
 export * from './interfaces/ps-optimistic-rows-result';

package/dist/esm/interfaces/ps-change-queue-input.js

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

package/dist/esm/interfaces/ps-change-queue-result.js

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

package/dist/hooks/use-ps-change-queue.d.ts

@@ -0,0 +1,3 @@
+import type { PsChangeQueueInput } from '../interfaces/ps-change-queue-input';
+import type { PsChangeQueueResult } from '../interfaces/ps-change-queue-result';
+export declare const usePsChangeQueue: <Change>({ onDrained, onFailed, send, }: PsChangeQueueInput<Change>) => PsChangeQueueResult<Change>;

package/dist/hooks/use-ps-change-queue.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePsChangeQueue = void 0;
+const react_1 = require("react");
+const usePsChangeQueue = ({ onDrained, onFailed, send, }) => {
+    const pending = (0, react_1.useRef)([]);
+    const isRunning = (0, react_1.useRef)(false);
+    const latest = (0, react_1.useRef)({ onDrained, onFailed, send });
+    (0, react_1.useEffect)(() => {
+        latest.current = { onDrained, onFailed, send };
+    }, [onDrained, onFailed, send]);
+    const run = (0, react_1.useCallback)(async () => {
+        if (isRunning.current)
+            return;
+        isRunning.current = true;
+        await Promise.resolve();
+        while (pending.current.length > 0) {
+            const batch = pending.current;
+            pending.current = [];
+            await latest.current.send(batch).catch(() => {
+                const dropped = pending.current;
+                pending.current = [];
+                latest.current.onFailed(batch, dropped);
+            });
+        }
+        isRunning.current = false;
+        latest.current.onDrained();
+    }, []);
+    const enqueue = (0, react_1.useCallback)((change) => {
+        pending.current = [...pending.current, change];
+        void run();
+    }, [run]);
+    return { enqueue };
+};
+exports.usePsChangeQueue = usePsChangeQueue;

package/dist/hooks/use-ps-hydrated.d.ts

@@ -0,0 +1 @@
+export declare const usePsHydrated: () => boolean;

package/dist/hooks/use-ps-hydrated.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePsHydrated = void 0;
+const react_1 = require("react");
+const ps_hydration_store_1 = require("../constants/ps-hydration-store");
+const usePsHydrated = () => (0, react_1.useSyncExternalStore)(ps_hydration_store_1.PsHydrationStore.subscribe, ps_hydration_store_1.PsHydrationStore.clientSnapshot, ps_hydration_store_1.PsHydrationStore.serverSnapshot);
+exports.usePsHydrated = usePsHydrated;

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export * from './components/ps-pallasoft-mark';
 export * from './components/ps-pallasoft-sign-in-button';
 export * from './constants/ps-pallasoft-mark-config';
 export * from './components/ps-card';
+export * from './components/ps-client-only';
 export * from './components/ps-draggable-grid';
 export * from './components/ps-empty-state';
 export * from './components/ps-fab';
@@ -48,12 +49,16 @@ export * from './contexts/ps-layer-context';
 export * from './hooks/use-ps-layer-z-index';
 export * from './hooks/use-ps-route-loader-data';
 export * from './hooks/use-ps-element-size';
+export * from './hooks/use-ps-hydrated';
 export * from './hooks/use-ps-viewport';
 export * from './interfaces/ps-component-props';
 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-change-queue';
+export * from './interfaces/ps-change-queue-input';
+export * from './interfaces/ps-change-queue-result';
 export * from './hooks/use-ps-optimistic-rows';
 export * from './interfaces/ps-optimistic-rows-input';
 export * from './interfaces/ps-optimistic-rows-result';

package/dist/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./components/ps-pallasoft-mark"), exports);
 __exportStar(require("./components/ps-pallasoft-sign-in-button"), exports);
 __exportStar(require("./constants/ps-pallasoft-mark-config"), exports);
 __exportStar(require("./components/ps-card"), exports);
+__exportStar(require("./components/ps-client-only"), exports);
 __exportStar(require("./components/ps-draggable-grid"), exports);
 __exportStar(require("./components/ps-empty-state"), exports);
 __exportStar(require("./components/ps-fab"), exports);
@@ -64,12 +65,16 @@ __exportStar(require("./contexts/ps-layer-context"), exports);
 __exportStar(require("./hooks/use-ps-layer-z-index"), exports);
 __exportStar(require("./hooks/use-ps-route-loader-data"), exports);
 __exportStar(require("./hooks/use-ps-element-size"), exports);
+__exportStar(require("./hooks/use-ps-hydrated"), exports);
 __exportStar(require("./hooks/use-ps-viewport"), exports);
 __exportStar(require("./interfaces/ps-component-props"), exports);
 __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-change-queue"), exports);
+__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("./interfaces/ps-optimistic-rows-input"), exports);
 __exportStar(require("./interfaces/ps-optimistic-rows-result"), exports);

package/dist/interfaces/ps-change-queue-input.d.ts

@@ -0,0 +1,5 @@
+export interface PsChangeQueueInput<Change> {
+    onDrained: () => void;
+    onFailed: (failed: Change[], dropped: Change[]) => void;
+    send: (changes: Change[]) => Promise<unknown>;
+}

package/dist/interfaces/ps-change-queue-input.js

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

package/dist/interfaces/ps-change-queue-result.d.ts

@@ -0,0 +1,3 @@
+export interface PsChangeQueueResult<Change> {
+    enqueue: (change: Change) => void;
+}

package/dist/interfaces/ps-change-queue-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.20.0",
+	"version": "2.22.0",
 	"private": false,
 	"main": "./dist/index.js",
 	"module": "./dist/esm/index.js",