@loj-lang/rdsl-runtime 0.5.0 → 0.6.1

package/dist/hooks/resourceStore.js

@@ -1,164 +1 @@
-const resourceStores = new Map();
-const resourceClientIds = new WeakMap();
-let nextClientId = 1;
-function storeKey(client, api) {
-    const resourceClient = client;
-    let id = resourceClientIds.get(resourceClient);
-    if (!id) {
-        id = nextClientId;
-        nextClientId += 1;
-        resourceClientIds.set(resourceClient, id);
-    }
-    return `${id}:${api}`;
-}
-function notifyState(state) {
-    for (const listener of state.listeners) {
-        listener();
-    }
-}
-function resourceLeaf(api) {
-    const parts = api.split('/').filter(Boolean);
-    return parts[parts.length - 1] ?? 'record';
-}
-function syncNextId(api, state) {
-    const prefix = `${resourceLeaf(api)}-`;
-    let max = 0;
-    for (const item of state.items) {
-        if (!item.id.startsWith(prefix))
-            continue;
-        const suffix = Number(item.id.slice(prefix.length));
-        if (Number.isFinite(suffix) && suffix > max) {
-            max = suffix;
-        }
-    }
-    state.nextId = max + 1;
-}
-function createSyntheticId(api, state) {
-    const id = `${resourceLeaf(api)}-${state.nextId}`;
-    state.nextId += 1;
-    return id;
-}
-function createResourceStore(client, api) {
-    const state = {
-        items: [],
-        listeners: new Set(),
-        error: null,
-        pendingCount: 0,
-        resolvedOnce: false,
-        inFlightLoad: null,
-        nextId: 1,
-    };
-    async function runMutation(mutate) {
-        state.pendingCount += 1;
-        state.error = null;
-        notifyState(state);
-        try {
-            const result = await mutate();
-            state.resolvedOnce = true;
-            return result;
-        }
-        catch (error) {
-            state.error = error;
-            state.resolvedOnce = true;
-            throw error;
-        }
-        finally {
-            state.pendingCount = Math.max(0, state.pendingCount - 1);
-            notifyState(state);
-        }
-    }
-    return {
-        subscribe(listener) {
-            state.listeners.add(listener);
-            return () => {
-                state.listeners.delete(listener);
-            };
-        },
-        getSnapshot() {
-            return {
-                items: state.items,
-                error: state.error,
-                pendingCount: state.pendingCount,
-                resolvedOnce: state.resolvedOnce,
-            };
-        },
-        getById(id) {
-            return state.items.find((item) => item.id === id);
-        },
-        load(force = false) {
-            if (!force && state.resolvedOnce && !state.error) {
-                return Promise.resolve(state.items);
-            }
-            if (state.inFlightLoad) {
-                return state.inFlightLoad;
-            }
-            state.pendingCount += 1;
-            state.error = null;
-            notifyState(state);
-            state.inFlightLoad = client.list(api)
-                .then((items) => {
-                state.items = [...items];
-                state.error = null;
-                state.resolvedOnce = true;
-                syncNextId(api, state);
-                return state.items;
-            })
-                .catch((error) => {
-                state.error = error;
-                state.resolvedOnce = true;
-                throw error;
-            })
-                .finally(() => {
-                state.pendingCount = Math.max(0, state.pendingCount - 1);
-                state.inFlightLoad = null;
-                notifyState(state);
-            });
-            return state.inFlightLoad;
-        },
-        createItem(input) {
-            return runMutation(async () => {
-                const created = await client.create(api, input);
-                const nextRecord = {
-                    ...created,
-                    id: String(created.id ?? createSyntheticId(api, state)),
-                };
-                state.items = [...state.items, nextRecord];
-                syncNextId(api, state);
-                return nextRecord;
-            });
-        },
-        updateItem(id, input) {
-            return runMutation(async () => {
-                const current = state.items.find((item) => item.id === id);
-                const updated = await client.update(api, id, input);
-                const nextRecord = {
-                    ...current,
-                    ...input,
-                    ...updated,
-                    id: String(updated.id ?? id),
-                };
-                state.items = state.items.map((item) => item.id === id ? nextRecord : item);
-                return nextRecord;
-            });
-        },
-        deleteItem(id) {
-            return runMutation(async () => {
-                await client.delete(api, id);
-                state.items = state.items.filter((item) => item.id !== id);
-            });
-        },
-    };
-}
-export function getResourceStore(client, api) {
-    const key = storeKey(client, api);
-    const existing = resourceStores.get(key);
-    if (existing)
-        return existing;
-    const created = createResourceStore(client, api);
-    resourceStores.set(key, created);
-    return created;
-}
-export function resetResourceStoreTestState() {
-    resourceStores.clear();
-    nextClientId = 1;
-}
+export { clearResourceStores, getResourceStore, resetResourceStoreTestState, } from '../../../runtime-core/dist/resourceStore.js';

package/dist/hooks/resourceTarget.d.ts

@@ -1,2 +1,2 @@
-export declare function matchesResourceTarget(api: string, target: unknown): boolean;
+export { matchesResourceTarget } from '../../../runtime-core/dist/resourceTarget.js';
 //# sourceMappingURL=resourceTarget.d.ts.map

package/dist/hooks/resourceTarget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resourceTarget.d.ts","sourceRoot":"","sources":["../../src/hooks/resourceTarget.ts"],"names":[],"mappings":"AAUA,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAa3E"}
+{"version":3,"file":"resourceTarget.d.ts","sourceRoot":"","sources":["../../src/hooks/resourceTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC"}

package/dist/hooks/resourceTarget.js

@@ -1,22 +1 @@
-function normalizeTarget(target) {
-    return target.trim().replace(/^\/+|\/+$/g, '');
-}
-function apiLeaf(api) {
-    const normalized = normalizeTarget(api);
-    const parts = normalized.split('/').filter(Boolean);
-    return parts[parts.length - 1] ?? normalized;
-}
-export function matchesResourceTarget(api, target) {
-    if (typeof target !== 'string' || target.trim() === '')
-        return false;
-    const normalizedTarget = normalizeTarget(target);
-    const normalizedApi = normalizeTarget(api);
-    const leaf = apiLeaf(api);
-    return [
-        normalizedApi,
-        leaf,
-        `${leaf}.list`,
-        `resource.${leaf}`,
-        `resource.${leaf}.list`,
-    ].includes(normalizedTarget);
-}
+export { matchesResourceTarget } from '../../../runtime-core/dist/resourceTarget.js';

package/dist/hooks/serverListStore.d.ts

@@ -0,0 +1,3 @@
+export type { ServerListStore, ServerListStoreClient, ServerListStorePage, ServerListStoreQuery, ServerListStoreSnapshot, } from '../../../runtime-core/dist/serverListStore.js';
+export { clearServerListStores, getServerListStore, resetServerListStoreTestState, } from '../../../runtime-core/dist/serverListStore.js';
+//# sourceMappingURL=serverListStore.d.ts.map

package/dist/hooks/serverListStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverListStore.d.ts","sourceRoot":"","sources":["../../src/hooks/serverListStore.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,+CAA+C,CAAC;AACvD,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,6BAA6B,GAC9B,MAAM,+CAA+C,CAAC"}

package/dist/hooks/serverListStore.js

@@ -0,0 +1 @@
+export { clearServerListStores, getServerListStore, resetServerListStoreTestState, } from '../../../runtime-core/dist/serverListStore.js';

package/dist/hooks/sessionCaches.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Clears all cached resource data. Call on logout to prevent
+ * stale data from one user session leaking into the next.
+ */
+export declare function clearSessionCaches(): void;
+//# sourceMappingURL=sessionCaches.d.ts.map

package/dist/hooks/sessionCaches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionCaches.d.ts","sourceRoot":"","sources":["../../src/hooks/sessionCaches.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAKzC"}

package/dist/hooks/sessionCaches.js

@@ -0,0 +1,14 @@
+import { clearResourceClientCaches } from './resourceClient.js';
+import { clearReadModelStores } from './readModelStore.js';
+import { clearResourceStores } from './resourceStore.js';
+import { clearServerListStores } from './serverListStore.js';
+/**
+ * Clears all cached resource data. Call on logout to prevent
+ * stale data from one user session leaking into the next.
+ */
+export function clearSessionCaches() {
+    clearReadModelStores();
+    clearServerListStores();
+    clearResourceStores();
+    clearResourceClientCaches();
+}

package/dist/hooks/transitionedSetter.d.ts

@@ -0,0 +1,2 @@
+export declare function useTransitionedSetter<T>(setter: ((next: T) => void) | undefined): (next: T) => void;
+//# sourceMappingURL=transitionedSetter.d.ts.map

package/dist/hooks/transitionedSetter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitionedSetter.d.ts","sourceRoot":"","sources":["../../src/hooks/transitionedSetter.ts"],"names":[],"mappings":"AAEA,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAOnG"}

package/dist/hooks/transitionedSetter.js

@@ -0,0 +1,9 @@
+import React from 'react';
+export function useTransitionedSetter(setter) {
+    return React.useCallback((next) => {
+        if (!setter) {
+            return;
+        }
+        React.startTransition(() => setter(next));
+    }, [setter]);
+}

package/dist/hooks/useAuth.d.ts

@@ -3,8 +3,25 @@ export interface AuthUser {
     role?: string;
     [key: string]: unknown;
 }
+export interface AuthSession {
+    accessToken: string;
+    tokenType?: 'Bearer' | 'bearer' | string;
+}
+export interface AuthLoginProvider {
+    id: string;
+    label: string;
+}
 export interface AuthState {
     currentUser: AuthUser | null;
+    session?: AuthSession | null;
+    refreshSession?: (() => Promise<AuthSession | null>) | null;
+    onUnauthorized?: (() => void | Promise<void>) | null;
+    loginHref?: string | null;
+    loginProviders?: AuthLoginProvider[] | null;
+    beginLogin?: ((providerId: string) => void | Promise<void>) | null;
+    logout?: (() => void | Promise<void>) | null;
+    authPending?: boolean | null;
+    authError?: string | null;
 }
 interface AuthProviderProps {
     value: AuthState;
@@ -12,5 +29,6 @@ interface AuthProviderProps {
 }
 export declare function AuthProvider({ value, children }: AuthProviderProps): any;
 export declare function useAuth(): AuthState;
+export declare function useAuthAccessToken(): string;
 export {};
 //# sourceMappingURL=useAuth.d.ts.map

package/dist/hooks/useAuth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAuth.d.ts","sourceRoot":"","sources":["../../src/hooks/useAuth.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC9B;AAED,UAAU,iBAAiB;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAiBD,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,iBAAiB,OAElE;AAED,wBAAgB,OAAO,IAAI,SAAS,CAEnC"}
+{"version":3,"file":"useAuth.d.ts","sourceRoot":"","sources":["../../src/hooks/useAuth.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC1C;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAC5D,cAAc,CAAC,EAAE,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACrD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC;IAC5C,UAAU,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACnE,MAAM,CAAC,EAAE,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7C,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,UAAU,iBAAiB;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AA0BD,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,iBAAiB,OAoBlE;AAED,wBAAgB,OAAO,IAAI,SAAS,CAEnC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C"}

package/dist/hooks/useAuth.js

@@ -1,4 +1,6 @@
 import React from 'react';
+import { clearSessionCaches } from './sessionCaches.js';
+import { resolveAuthAccessToken, shouldClearSessionCaches, } from '../../../runtime-core/dist/auth.js';
 const AuthContext = React.createContext(undefined);
 function readGlobalAuth() {
     if (typeof window === 'undefined') {
@@ -8,13 +10,41 @@ function readGlobalAuth() {
     if (value && typeof value === 'object') {
         return {
             currentUser: value.currentUser ?? null,
+            session: value.session ?? null,
+            refreshSession: value.refreshSession ?? null,
+            onUnauthorized: value.onUnauthorized ?? null,
+            loginHref: value.loginHref ?? null,
+            loginProviders: value.loginProviders ?? null,
+            beginLogin: value.beginLogin ?? null,
+            logout: value.logout ?? null,
+            authPending: value.authPending ?? null,
+            authError: value.authError ?? null,
         };
     }
     return { currentUser: null };
 }
 export function AuthProvider({ value, children }) {
+    const prevUserIdRef = React.useRef(value.currentUser?.id);
+    const prevAccessTokenRef = React.useRef(value.session?.accessToken);
+    React.useEffect(() => {
+        const prevId = prevUserIdRef.current;
+        const nextId = value.currentUser?.id;
+        const prevAccessToken = prevAccessTokenRef.current;
+        const nextAccessToken = value.session?.accessToken;
+        prevUserIdRef.current = nextId;
+        prevAccessTokenRef.current = nextAccessToken;
+        // Clear caches when auth identity changes after the initial mount:
+        // logout, switch user, or token rotation for the same user.
+        if (shouldClearSessionCaches(prevId, nextId, prevAccessToken, nextAccessToken)) {
+            clearSessionCaches();
+        }
+    }, [value.currentUser?.id, value.session?.accessToken]);
     return React.createElement(AuthContext.Provider, { value }, children);
 }
 export function useAuth() {
     return React.useContext(AuthContext) ?? readGlobalAuth();
 }
+export function useAuthAccessToken() {
+    const auth = useAuth();
+    return resolveAuthAccessToken(auth.session);
+}

package/dist/hooks/useCollectionView.d.ts

@@ -1,11 +1,5 @@
-export interface CollectionPaginationState {
-    page: number;
-    totalPages: number;
-}
-export interface CollectionSortState {
-    field: string;
-    direction: 'asc' | 'desc';
-}
+import type { CollectionPaginationState, CollectionSortState } from '../../../runtime-core/dist/collectionView.js';
+export type { CollectionPaginationState, CollectionSortState, } from '../../../runtime-core/dist/collectionView.js';
 export interface UseCollectionViewOptions {
     pageSize?: number;
     paginate?: boolean;

package/dist/hooks/useCollectionView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCollectionView.d.ts","sourceRoot":"","sources":["../../src/hooks/useCollectionView.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IAC/D,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IACnD,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAC;IACpD,UAAU,EAAE,yBAAyB,CAAC;IACtC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAoCD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACxD,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAAC,CAAC,CAAC,CAoD5B"}
+{"version":3,"file":"useCollectionView.d.ts","sourceRoot":"","sources":["../../src/hooks/useCollectionView.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,yBAAyB,EACzB,mBAAmB,EACpB,MAAM,8CAA8C,CAAC;AACtD,YAAY,EACV,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,8CAA8C,CAAC;AAEtD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IAC/D,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IACnD,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAC;IACpD,UAAU,EAAE,yBAAyB,CAAC;IACtC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,wBAAgB,iBAAiB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACxD,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAAC,CAAC,CAAC,CAmD5B"}

package/dist/hooks/useCollectionView.js

@@ -1,46 +1,17 @@
 import React from 'react';
-function compareValues(left, right) {
-    if (typeof left === 'number' && typeof right === 'number') {
-        return left - right;
-    }
-    return String(left ?? '').localeCompare(String(right ?? ''));
-}
-function filterItems(items, filters) {
-    return items.filter((item) => Object.entries(filters).every(([key, rawFilter]) => {
-        const filterValue = rawFilter.trim();
-        if (filterValue === '')
-            return true;
-        const value = item[key];
-        return String(value ?? '').toLowerCase().includes(filterValue.toLowerCase());
-    }));
-}
-function sortItems(items, sort) {
-    if (!sort)
-        return [...items];
-    const sorted = [...items];
-    sorted.sort((left, right) => {
-        const comparison = compareValues(left[sort.field], right[sort.field]);
-        return sort.direction === 'asc' ? comparison : comparison * -1;
-    });
-    return sorted;
-}
+import { filterCollectionItems, paginateCollectionItems, sortCollectionItems, } from '../../../runtime-core/dist/collectionView.js';
 export function useCollectionView(items, options = {}) {
     const pageSize = options.pageSize ?? 20;
     const paginate = options.paginate ?? true;
     const [filters, setFiltersState] = React.useState({});
     const [sort, setSortState] = React.useState(null);
     const [page, setPage] = React.useState(1);
-    const filteredItems = React.useMemo(() => filterItems(items, filters), [items, filters]);
-    const sortedItems = React.useMemo(() => sortItems(filteredItems, sort), [filteredItems, sort]);
-    const totalPages = paginate ? Math.max(1, Math.ceil(sortedItems.length / pageSize)) : 1;
-    const currentPage = paginate ? Math.min(page, totalPages) : 1;
-    const data = React.useMemo(() => {
-        if (!paginate) {
-            return sortedItems;
-        }
-        const start = (currentPage - 1) * pageSize;
-        return sortedItems.slice(start, start + pageSize);
-    }, [currentPage, pageSize, paginate, sortedItems]);
+    const filteredItems = React.useMemo(() => filterCollectionItems(items, filters), [items, filters]);
+    const sortedItems = React.useMemo(() => sortCollectionItems(filteredItems, sort), [filteredItems, sort]);
+    const paged = React.useMemo(() => paginateCollectionItems(sortedItems, page, pageSize, paginate), [page, pageSize, paginate, sortedItems]);
+    const currentPage = paged.page;
+    const totalPages = paged.totalPages;
+    const data = paged.data;
     React.useEffect(() => {
         if (currentPage !== page) {
             setPage(currentPage);
@@ -67,6 +38,7 @@ export function useCollectionView(items, options = {}) {
         pagination: {
             page: currentPage,
             totalPages,
+            totalItems: paged.totalItems,
         },
         setPagination,
     };

package/dist/hooks/useDocumentMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDocumentMetadata.d.ts","sourceRoot":"","sources":["../../src/hooks/useDocumentMetadata.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CA8BpE"}
+{"version":3,"file":"useDocumentMetadata.d.ts","sourceRoot":"","sources":["../../src/hooks/useDocumentMetadata.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAmDpE"}

package/dist/hooks/useDocumentMetadata.js

@@ -6,6 +6,15 @@ export function useDocumentMetadata(metadata) {
             return;
         }
         const resolvedTitle = applyTitleTemplate(metadata.title, metadata.defaultTitle ?? null, metadata.titleTemplate ?? null);
+        const previousTitle = document.title;
+        const previousDescription = snapshotHeadElement(`meta[name="description"]`);
+        const previousRobots = snapshotHeadElement(`meta[name="robots"]`);
+        const previousOgTitle = snapshotHeadElement(`meta[property="og:title"]`);
+        const previousOgDescription = snapshotHeadElement(`meta[property="og:description"]`);
+        const previousOgImage = snapshotHeadElement(`meta[property="og:image"]`);
+        const previousOgSiteName = snapshotHeadElement(`meta[property="og:site_name"]`);
+        const previousCanonical = snapshotHeadElement('link[rel="canonical"]');
+        const previousFavicon = snapshotHeadElement('link[rel="icon"]');
         if (resolvedTitle) {
             document.title = resolvedTitle;
         }
@@ -17,6 +26,17 @@ export function useDocumentMetadata(metadata) {
         setPropertyMeta('og:site_name', metadata.siteName ?? null);
         setCanonicalHref(metadata.canonicalPath ?? null);
         setFaviconHref(metadata.favicon ?? null);
+        return () => {
+            document.title = previousTitle;
+            restoreHeadElement(previousDescription);
+            restoreHeadElement(previousRobots);
+            restoreHeadElement(previousOgTitle);
+            restoreHeadElement(previousOgDescription);
+            restoreHeadElement(previousOgImage);
+            restoreHeadElement(previousOgSiteName);
+            restoreHeadElement(previousCanonical);
+            restoreHeadElement(previousFavicon);
+        };
     }, [
         metadata.title,
         metadata.defaultTitle,
@@ -39,6 +59,43 @@ function applyTitleTemplate(title, defaultTitle, titleTemplate) {
     }
     return titleTemplate.replace(/\{title\}/g, effectiveTitle);
 }
+function snapshotHeadElement(selector) {
+    const element = document.head.querySelector(selector);
+    if (!element) {
+        return {
+            selector,
+            tagName: selector.startsWith('link[') ? 'link' : 'meta',
+            attributes: {},
+            existed: false,
+        };
+    }
+    return {
+        selector,
+        tagName: element.tagName.toLowerCase(),
+        attributes: readElementAttributes(element),
+        existed: true,
+    };
+}
+function restoreHeadElement(snapshot) {
+    const existing = document.head.querySelector(snapshot.selector);
+    if (!snapshot.existed) {
+        existing?.remove();
+        return;
+    }
+    const element = existing ?? document.createElement(snapshot.tagName);
+    for (const [name, value] of Object.entries(snapshot.attributes)) {
+        element.setAttribute(name, value);
+    }
+    if (!existing) {
+        document.head.appendChild(element);
+    }
+}
+function readElementAttributes(element) {
+    return Array.from(element.attributes).reduce((attributes, attribute) => {
+        attributes[attribute.name] = attribute.value;
+        return attributes;
+    }, {});
+}
 function setNamedMeta(name, content) {
     const selector = `meta[name="${name}"]`;
     let element = document.head.querySelector(selector);

package/dist/hooks/useGroupedCollectionView.d.ts

@@ -1,11 +1,6 @@
+import type { GroupedCollectionViewGroup } from '../../../runtime-core/dist/collectionView.js';
+export type { GroupedCollectionViewGroup } from '../../../runtime-core/dist/collectionView.js';
 import type { CollectionPaginationState, CollectionSortState } from './useCollectionView.js';
-export interface GroupedCollectionViewGroup<T extends {
-    id: string;
-}> {
-    id: string;
-    values: Record<string, unknown>;
-    rows: T[];
-}
 export interface UseGroupedCollectionViewOptions {
     pageSize?: number;
     paginate?: boolean;

package/dist/hooks/useGroupedCollectionView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGroupedCollectionView.d.ts","sourceRoot":"","sources":["../../src/hooks/useGroupedCollectionView.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7F,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,EAAE,CAAC;CACX;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,8BAA8B,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IACtE,MAAM,EAAE,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,SAAS,EAAE,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAC;IACpD,UAAU,EAAE,yBAAyB,CAAC;IACtC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAuDD,wBAAgB,wBAAwB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAC/D,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,GAAE,+BAAoC,GAC5C,8BAA8B,CAAC,CAAC,CAAC,CA4CnC"}
+{"version":3,"file":"useGroupedCollectionView.d.ts","sourceRoot":"","sources":["../../src/hooks/useGroupedCollectionView.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAC/F,YAAY,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAC/F,OAAO,KAAK,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7F,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,8BAA8B,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IACtE,MAAM,EAAE,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,SAAS,EAAE,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAC;IACpD,UAAU,EAAE,yBAAyB,CAAC;IACtC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,wBAAgB,wBAAwB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAC/D,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,GAAE,+BAAoC,GAC5C,8BAA8B,CAAC,CAAC,CAAC,CA2CnC"}

package/dist/hooks/useGroupedCollectionView.js

@@ -1,61 +1,16 @@
 import React from 'react';
-function compareValues(left, right) {
-    if (typeof left === 'number' && typeof right === 'number') {
-        return left - right;
-    }
-    return String(left ?? '').localeCompare(String(right ?? ''));
-}
-function sortItems(items, sort) {
-    if (!sort)
-        return [...items];
-    const sorted = [...items];
-    sorted.sort((left, right) => {
-        const comparison = compareValues(left[sort.field], right[sort.field]);
-        return sort.direction === 'asc' ? comparison : comparison * -1;
-    });
-    return sorted;
-}
-function groupItems(items, groupBy) {
-    if (groupBy.length === 0) {
-        return items.map((item) => ({
-            id: String(item.id),
-            values: {},
-            rows: [item],
-        }));
-    }
-    const groups = new Map();
-    for (const item of items) {
-        const values = Object.fromEntries(groupBy.map((field) => [field, item[field]]));
-        const id = JSON.stringify(groupBy.map((field) => [field, values[field]]));
-        const existing = groups.get(id);
-        if (existing) {
-            existing.rows.push(item);
-            continue;
-        }
-        groups.set(id, {
-            id,
-            values,
-            rows: [item],
-        });
-    }
-    return Array.from(groups.values());
-}
+import { groupCollectionItems, paginateCollectionItems, sortCollectionItems, } from '../../../runtime-core/dist/collectionView.js';
 export function useGroupedCollectionView(items, groupBy, options = {}) {
     const pageSize = options.pageSize ?? 20;
     const paginate = options.paginate ?? true;
     const [sort, setSortState] = React.useState(null);
     const [page, setPage] = React.useState(1);
-    const sortedItems = React.useMemo(() => sortItems(items, sort), [items, sort]);
-    const allGroups = React.useMemo(() => groupItems(sortedItems, groupBy), [sortedItems, groupBy]);
-    const totalPages = paginate ? Math.max(1, Math.ceil(allGroups.length / pageSize)) : 1;
-    const currentPage = paginate ? Math.min(page, totalPages) : 1;
-    const groups = React.useMemo(() => {
-        if (!paginate) {
-            return allGroups;
-        }
-        const start = (currentPage - 1) * pageSize;
-        return allGroups.slice(start, start + pageSize);
-    }, [allGroups, currentPage, pageSize, paginate]);
+    const sortedItems = React.useMemo(() => sortCollectionItems(items, sort), [items, sort]);
+    const allGroups = React.useMemo(() => groupCollectionItems(sortedItems, groupBy), [sortedItems, groupBy]);
+    const paged = React.useMemo(() => paginateCollectionItems(allGroups, page, pageSize, paginate), [allGroups, page, pageSize, paginate]);
+    const totalPages = paged.totalPages;
+    const currentPage = paged.page;
+    const groups = paged.data;
     React.useEffect(() => {
         if (currentPage !== page) {
             setPage(currentPage);
@@ -76,6 +31,7 @@ export function useGroupedCollectionView(items, groupBy, options = {}) {
         pagination: {
             page: currentPage,
             totalPages,
+            totalItems: paged.totalItems,
         },
         setPagination,
     };

package/dist/hooks/useI18n.d.ts

@@ -0,0 +1,21 @@
+import type { I18nBundle, I18nMessage, I18nMessageValue } from '../../../runtime-core/dist/i18n.js';
+export type { I18nBundle, I18nMessage, I18nMessageDescriptor, I18nMessageValue, } from '../../../runtime-core/dist/i18n.js';
+export interface I18nState {
+    locale: string;
+    messages?: I18nBundle;
+    setLocale?: (locale: string) => void | Promise<void>;
+}
+interface I18nProviderProps {
+    value: I18nState;
+    children?: React.ReactNode;
+}
+export declare function resolveMessageText<TValue = I18nMessageValue>(message: I18nMessage | unknown, fallback?: string): string;
+export declare function resolveMessageTextWithBundle<TValue = I18nMessageValue>(message: I18nMessage | unknown, messages?: I18nBundle, fallback?: string): string;
+export declare function humanizeEnumValue(value: string): string;
+export declare function resolveEnumValueText(value: string, keyPrefix?: string, labels?: Record<string, string>): string;
+export declare function resolveUnknownEnumValue(value: unknown, keyPrefix?: string, labels?: Record<string, string>): string;
+export declare function buildEnumValueRenderer(keyPrefix?: string, labels?: Record<string, string>): (value: unknown) => string;
+export declare function resolveWorkflowStepMessage(message: I18nMessage | unknown, step: unknown, fallback?: string | null): string | null;
+export declare function I18nProvider({ value, children }: I18nProviderProps): any;
+export declare function useI18n(): I18nState;
+//# sourceMappingURL=useI18n.d.ts.map

package/dist/hooks/useI18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useI18n.d.ts","sourceRoot":"","sources":["../../src/hooks/useI18n.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EAEX,gBAAgB,EACjB,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EACV,UAAU,EACV,WAAW,EACX,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oCAAoC,CAAC;AAE5C,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED,UAAU,iBAAiB;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAMD,wBAAgB,kBAAkB,CAAC,MAAM,GAAG,gBAAgB,EAC1D,OAAO,EAAE,WAAW,GAAG,OAAO,EAC9B,QAAQ,SAAK,GACZ,MAAM,CAER;AAED,wBAAgB,4BAA4B,CAAC,MAAM,GAAG,gBAAgB,EACpE,OAAO,EAAE,WAAW,GAAG,OAAO,EAC9B,QAAQ,CAAC,EAAE,UAAU,EACrB,QAAQ,SAAK,GACZ,MAAM,CAER;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAER;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAER;AAED,wBAAgB,sBAAsB,CACpC,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAE5B;AASD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,WAAW,GAAG,OAAO,EAC9B,IAAI,EAAE,OAAO,EACb,QAAQ,GAAE,MAAM,GAAG,IAAS,GAC3B,MAAM,GAAG,IAAI,CAwBf;AAED,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,iBAAiB,OAwBlE;AAED,wBAAgB,OAAO,IAAI,SAAS,CAKnC"}