@loj-lang/rdsl-runtime 0.5.0 → 0.6.1

package/dist/hooks/useI18n.js

@@ -0,0 +1,86 @@
+import React from 'react';
+import { humanizeEnumValue as humanizeEnumValueCore, resolveEnumValueText as resolveEnumValueTextCore, resolveMessageTextWithBundle as resolveMessageTextWithBundleCore, } from '../../../runtime-core/dist/i18n.js';
+const I18nContext = React.createContext(undefined);
+let activeI18nState = null;
+const activeI18nProviders = [];
+export function resolveMessageText(message, fallback = '') {
+    return resolveMessageTextWithBundle(message, activeI18nState?.messages, fallback);
+}
+export function resolveMessageTextWithBundle(message, messages, fallback = '') {
+    return resolveMessageTextWithBundleCore(message, messages, fallback);
+}
+export function humanizeEnumValue(value) {
+    return humanizeEnumValueCore(value);
+}
+export function resolveEnumValueText(value, keyPrefix, labels) {
+    return resolveEnumValueTextCore(value, keyPrefix, labels, activeI18nState?.messages);
+}
+export function resolveUnknownEnumValue(value, keyPrefix, labels) {
+    return typeof value === 'string' ? resolveEnumValueText(value, keyPrefix, labels) : String(value);
+}
+export function buildEnumValueRenderer(keyPrefix, labels) {
+    return (value) => resolveUnknownEnumValue(value, keyPrefix, labels);
+}
+function resolveWorkflowStepName(step) {
+    if (typeof step === 'object' && step !== null && 'name' in step) {
+        return step.name;
+    }
+    return step;
+}
+export function resolveWorkflowStepMessage(message, step, fallback = '') {
+    const stepName = resolveWorkflowStepName(step);
+    if (stepName === null || stepName === undefined) {
+        return fallback;
+    }
+    if (typeof message === 'string') {
+        return resolveMessageText({
+            defaultMessage: message,
+            values: {
+                step: stepName,
+            },
+        }, fallback ?? '');
+    }
+    if (typeof message === 'object' && message !== null && !Array.isArray(message)) {
+        const descriptor = message;
+        return resolveMessageText({
+            ...descriptor,
+            values: {
+                ...(descriptor.values ?? {}),
+                step: stepName,
+            },
+        }, fallback ?? '');
+    }
+    return resolveMessageText(message, fallback ?? '');
+}
+export function I18nProvider({ value, children }) {
+    const providerTokenRef = React.useRef(null);
+    if (!providerTokenRef.current) {
+        providerTokenRef.current = Symbol('rdsl-i18n-provider');
+    }
+    activeI18nState = value;
+    React.useEffect(() => {
+        const token = providerTokenRef.current;
+        const existingIndex = activeI18nProviders.findIndex((entry) => entry.token === token);
+        if (existingIndex >= 0) {
+            activeI18nProviders[existingIndex] = { token, value };
+        }
+        else {
+            activeI18nProviders.push({ token, value });
+        }
+        activeI18nState = value;
+        return () => {
+            const index = activeI18nProviders.findIndex((entry) => entry.token === token);
+            if (index >= 0) {
+                activeI18nProviders.splice(index, 1);
+            }
+            activeI18nState = activeI18nProviders[activeI18nProviders.length - 1]?.value ?? null;
+        };
+    }, [value]);
+    return React.createElement(I18nContext.Provider, { value }, children);
+}
+export function useI18n() {
+    return React.useContext(I18nContext) ?? {
+        locale: 'en',
+        messages: {},
+    };
+}

package/dist/hooks/useReadModel.d.ts

@@ -1,5 +1,16 @@
 export interface UseReadModelOptions {
     enabled?: boolean;
+    pageSize?: number;
+    serverListView?: boolean;
+}
+export interface ReadModelSortState {
+    field: string;
+    direction: 'asc' | 'desc';
+}
+export interface ReadModelPaginationState {
+    page: number;
+    totalPages: number;
+    totalItems: number;
 }
 export interface UseReadModelResult<T extends {
     id: string;
@@ -8,6 +19,10 @@ export interface UseReadModelResult<T extends {
     allData: T[];
     loading: boolean;
     error: unknown;
+    sort: ReadModelSortState | null;
+    setSort: (next: ReadModelSortState | null) => void;
+    pagination: ReadModelPaginationState;
+    setPagination: (page: number) => void;
     refresh: () => Promise<void>;
 }
 export declare function useReadModel<T extends {

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

@@ -1 +1 @@
-{"version":3,"file":"useReadModel.d.ts","sourceRoot":"","sources":["../../src/hooks/useReadModel.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IAC1D,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAmDD,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACnD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CAAC,CAAC,CAAC,CA2DvB"}
+{"version":3,"file":"useReadModel.d.ts","sourceRoot":"","sources":["../../src/hooks/useReadModel.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IAC1D,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD,UAAU,EAAE,wBAAwB,CAAC;IACrC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAgHD,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACnD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CAAC,CAAC,CAAC,CAoHvB"}

package/dist/hooks/useReadModel.js

@@ -1,5 +1,6 @@
 import React from 'react';
 import { useResourceClient } from './resourceClient.js';
+import { getReadModelStore } from './readModelStore.js';
 import { matchesResourceTarget } from './resourceTarget.js';
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
@@ -30,58 +31,127 @@ function normalizeReadModelItems(api, payload) {
         };
     });
 }
-function buildReadModelUrl(api, query) {
-    const params = new URLSearchParams();
+function normalizeReadModelPagePayload(api, payload, fallbackPage, fallbackSize) {
+    const items = normalizeReadModelItems(api, payload);
+    const payloadRecord = isRecord(payload) ? payload : null;
+    const paginationRecord = payloadRecord && isRecord(payloadRecord.pagination) ? payloadRecord.pagination : null;
+    const page = Number((paginationRecord && paginationRecord.page)
+        ?? payloadRecord?.page
+        ?? fallbackPage);
+    const size = Number((paginationRecord && paginationRecord.size)
+        ?? payloadRecord?.size
+        ?? fallbackSize);
+    const totalItems = Number((paginationRecord && paginationRecord.totalItems)
+        ?? payloadRecord?.totalItems
+        ?? items.length);
+    const totalPages = Number((paginationRecord && paginationRecord.totalPages)
+        ?? payloadRecord?.totalPages
+        ?? Math.max(1, Math.ceil((Number.isFinite(totalItems) ? totalItems : items.length) / Math.max(1, Number.isFinite(size) ? size : fallbackSize))));
+    return {
+        items,
+        page: Number.isFinite(page) && page > 0 ? page : fallbackPage,
+        size: Number.isFinite(size) && size > 0 ? size : fallbackSize,
+        totalItems: Number.isFinite(totalItems) && totalItems >= 0 ? totalItems : items.length,
+        totalPages: Number.isFinite(totalPages) && totalPages > 0 ? totalPages : 1,
+    };
+}
+function buildReadModelUrl(api, query, list) {
+    const parts = api.split('?');
+    const path = parts[0] ?? api;
+    const params = new URLSearchParams(parts[1] ?? '');
     for (const [key, value] of Object.entries(query)) {
         const trimmed = String(value ?? '').trim();
         if (trimmed !== '') {
             params.set(key, trimmed);
         }
     }
-    const queryString = params.toString();
-    if (queryString === '') {
-        return api;
+    if (list?.page !== undefined) {
+        params.set('page', String(list.page));
+    }
+    if (list?.size !== undefined) {
+        params.set('size', String(list.size));
+    }
+    if (list?.sort?.field) {
+        params.set('sort', `${list.sort.field},${list.sort.direction}`);
+    }
+    else {
+        params.delete('sort');
     }
-    return api.includes('?') ? `${api}&${queryString}` : `${api}?${queryString}`;
+    const queryString = params.toString();
+    return queryString === '' ? path : `${path}?${queryString}`;
 }
 export function useReadModel(api, query, options = {}) {
     const client = useResourceClient();
     const enabled = options.enabled ?? true;
-    const [allData, setAllData] = React.useState([]);
-    const [loading, setLoading] = React.useState(false);
-    const [error, setError] = React.useState(null);
-    const requestUrl = React.useMemo(() => buildReadModelUrl(api, query), [api, query]);
-    const load = React.useCallback(async () => {
-        if (!enabled) {
-            setAllData([]);
-            setLoading(false);
-            setError(null);
-            return;
-        }
-        setLoading(true);
-        try {
-            const payload = await client.get(requestUrl);
-            setAllData(normalizeReadModelItems(api, payload));
-            setError(null);
+    const pageSize = options.pageSize ?? 20;
+    const serverListView = options.serverListView ?? false;
+    const [sort, setSortState] = React.useState(null);
+    const [page, setPageState] = React.useState(1);
+    const querySignature = JSON.stringify(query);
+    const queryState = React.useMemo(() => query, [querySignature]);
+    const requestUrl = React.useMemo(() => buildReadModelUrl(api, queryState, serverListView ? { page, size: pageSize, sort } : undefined), [api, page, pageSize, queryState, serverListView, sort]);
+    const readModelStore = React.useMemo(() => getReadModelStore(client, requestUrl, async () => {
+        const payload = await client.get(requestUrl);
+        if (serverListView) {
+            const listPage = normalizeReadModelPagePayload(api, payload, page, pageSize);
+            return {
+                items: listPage.items,
+                page: listPage.page,
+                totalItems: listPage.totalItems,
+                totalPages: listPage.totalPages,
+            };
         }
-        catch (nextError) {
-            setAllData([]);
-            setError(nextError);
-        }
-        finally {
-            setLoading(false);
-        }
-    }, [api, client, enabled, requestUrl]);
+        const items = normalizeReadModelItems(api, payload);
+        return {
+            items,
+            page: 1,
+            totalItems: items.length,
+            totalPages: 1,
+        };
+    }), [api, client, page, pageSize, requestUrl, serverListView]);
+    const [, setRevision] = React.useState(0);
+    React.useEffect(() => {
+        if (!serverListView)
+            return;
+        setPageState(1);
+    }, [querySignature, serverListView]);
+    React.useEffect(() => {
+        if (!enabled)
+            return undefined;
+        return readModelStore.subscribe(() => {
+            setRevision((value) => value + 1);
+        });
+    }, [enabled, readModelStore]);
+    React.useEffect(() => {
+        if (!enabled)
+            return;
+        void readModelStore.load(false).catch(() => undefined);
+    }, [enabled, readModelStore]);
+    const snapshot = enabled
+        ? readModelStore.getSnapshot()
+        : {
+            result: null,
+            error: null,
+            pendingCount: 0,
+            resolvedOnce: true,
+        };
     React.useEffect(() => {
-        void load();
-    }, [load]);
+        if (!enabled || !serverListView)
+            return;
+        const resolvedPage = snapshot.result?.page;
+        if (!resolvedPage || resolvedPage === page)
+            return;
+        setPageState(resolvedPage);
+    }, [enabled, page, serverListView, snapshot.result?.page]);
     React.useEffect(() => {
+        if (!enabled || typeof window === 'undefined')
+            return undefined;
         if (typeof window === 'undefined')
             return undefined;
         const handleRefresh = (event) => {
             const target = event.detail?.target;
             if (matchesResourceTarget(api, target)) {
-                void load();
+                void readModelStore.load(true).catch(() => undefined);
             }
         };
         window.addEventListener('rdsl:refresh', handleRefresh);
@@ -90,15 +160,32 @@ export function useReadModel(api, query, options = {}) {
             window.removeEventListener('rdsl:refresh', handleRefresh);
             window.removeEventListener('rdsl:invalidate', handleRefresh);
         };
-    }, [api, load]);
+    }, [api, enabled, readModelStore]);
     const refresh = React.useCallback(async () => {
-        await load();
-    }, [load]);
+        if (!enabled)
+            return;
+        await readModelStore.load(true);
+    }, [enabled, readModelStore]);
+    const setSort = React.useCallback((next) => {
+        setSortState(next);
+        setPageState(1);
+    }, []);
+    const setPagination = React.useCallback((nextPage) => {
+        setPageState(Math.max(1, nextPage));
+    }, []);
     return {
-        data: allData,
-        allData,
-        loading,
-        error,
+        data: snapshot.result?.items ?? [],
+        allData: snapshot.result?.items ?? [],
+        loading: enabled && (snapshot.pendingCount > 0 || !snapshot.resolvedOnce),
+        error: snapshot.error,
+        sort,
+        setSort,
+        pagination: {
+            page: snapshot.result?.page ?? page,
+            totalPages: snapshot.result?.totalPages ?? 1,
+            totalItems: snapshot.result?.totalItems ?? 0,
+        },
+        setPagination,
         refresh,
     };
 }

package/dist/hooks/useResource.d.ts

@@ -1,9 +1,14 @@
+import type { ResourceExportPayload, ResourceListQuery } from './resourceClient.js';
 export interface ResourcePaginationState {
     page: number;
     totalPages: number;
+    totalItems: number;
 }
 export interface UseResourceOptions {
     pageSize?: number;
+    serverListView?: boolean;
+    projectionFields?: string[];
+    baseFilters?: Record<string, string>;
 }
 export interface UseResourceResult<T extends {
     id: string;
@@ -28,6 +33,8 @@ export interface UseResourceResult<T extends {
     createItem: (input: Partial<T>) => Promise<T>;
     updateItem: (id: string, input: Partial<T>) => Promise<T>;
     deleteItem: (id: string) => Promise<void>;
+    batchDelete: (ids: string[]) => Promise<void>;
+    exportList: (format: string, query?: ResourceListQuery) => Promise<ResourceExportPayload>;
     refresh: () => void | Promise<void>;
 }
 export declare function useResource<T extends {

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

@@ -1 +1 @@
-{"version":3,"file":"useResource.d.ts","sourceRoot":"","sources":["../../src/hooks/useResource.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IACzD,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,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;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1D,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7E,UAAU,EAAE,uBAAuB,CAAC;IACpC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC;IACvC,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9C,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1D,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAYD,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAClD,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAAC,CAAC,CAAC,CAwEtB"}
+{"version":3,"file":"useResource.d.ts","sourceRoot":"","sources":["../../src/hooks/useResource.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAMpF,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IACzD,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,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;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1D,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7E,UAAU,EAAE,uBAAuB,CAAC;IACpC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC;IACvC,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9C,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1D,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC1F,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAaD,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAClD,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAAC,CAAC,CAAC,CA0PtB"}

package/dist/hooks/useResource.js

@@ -1,22 +1,141 @@
 import React from 'react';
 import { useResourceClient } from './resourceClient.js';
 import { getResourceStore } from './resourceStore.js';
+import { getServerListStore } from './serverListStore.js';
 import { matchesResourceTarget } from './resourceTarget.js';
 import { useCollectionView } from './useCollectionView.js';
 export function useResource(api, options = {}) {
     const pageSize = options.pageSize ?? 20;
+    const serverListView = options.serverListView ?? false;
+    const projectionSignature = JSON.stringify(options.projectionFields ?? []);
+    const projectionFields = React.useMemo(() => (options.projectionFields ?? []).map((field) => String(field ?? '').trim()).filter((field) => field !== ''), [projectionSignature]);
+    const baseFilterSignature = JSON.stringify(options.baseFilters ?? {});
+    const baseFilters = React.useMemo(() => Object.fromEntries(Object.entries(options.baseFilters ?? {})
+        .map(([key, value]) => [String(key ?? '').trim(), String(value ?? '').trim()])
+        .filter(([key, value]) => key !== '' && value !== '')), [baseFilterSignature]);
     const client = useResourceClient();
+    const [serverFilters, setServerFiltersState] = React.useState({});
+    const [serverSort, setServerSortState] = React.useState(null);
+    const [serverPage, setServerPage] = React.useState(1);
     const store = React.useMemo(() => getResourceStore(client, api), [api, client]);
     const [, setRevision] = React.useState(0);
+    const requestFilters = React.useMemo(() => ({ ...baseFilters, ...serverFilters }), [baseFilters, serverFilters]);
+    const serverProjectionSignature = JSON.stringify(projectionFields);
+    const serverFilterSignature = JSON.stringify(requestFilters);
+    const serverSortSignature = JSON.stringify(serverSort);
+    const serverStore = React.useMemo(() => getServerListStore(client, api, {
+        page: serverPage,
+        size: pageSize,
+        sort: serverSort,
+        filters: requestFilters,
+        projections: projectionFields,
+    }), [api, client, pageSize, serverFilterSignature, serverPage, serverProjectionSignature, serverSortSignature]);
     React.useEffect(() => {
+        if (!serverListView)
+            return undefined;
+        return serverStore.subscribe(() => {
+            setRevision((value) => value + 1);
+        });
+    }, [serverListView, serverStore]);
+    React.useEffect(() => {
+        if (!serverListView)
+            return undefined;
+        void serverStore.load(false).catch(() => undefined);
+    }, [serverListView, serverStore]);
+    const serverSnapshot = serverStore.getSnapshot();
+    React.useEffect(() => {
+        if (!serverListView)
+            return;
+        const resolvedPage = serverSnapshot.page?.page;
+        if (!resolvedPage || resolvedPage === serverPage)
+            return;
+        setServerPage(resolvedPage);
+    }, [serverListView, serverPage, serverSnapshot.page?.page]);
+    React.useEffect(() => {
+        if (!serverListView || typeof window === 'undefined')
+            return undefined;
+        const handleRefresh = (event) => {
+            const target = event?.detail?.target;
+            if (matchesResourceTarget(api, target)) {
+                void serverStore.load(true).catch(() => undefined);
+            }
+        };
+        window.addEventListener('rdsl:refresh', handleRefresh);
+        window.addEventListener('rdsl:invalidate', handleRefresh);
+        return () => {
+            window.removeEventListener('rdsl:refresh', handleRefresh);
+            window.removeEventListener('rdsl:invalidate', handleRefresh);
+        };
+    }, [api, serverListView, serverStore]);
+    const invalidateServerLists = React.useCallback(() => {
+        if (typeof window === 'undefined') {
+            void serverStore.load(true).catch(() => undefined);
+            return;
+        }
+        window.dispatchEvent(new CustomEvent('rdsl:invalidate', { detail: { target: api } }));
+    }, [api, serverStore]);
+    const serverCreateItem = React.useCallback(async (input) => {
+        const created = await client.create(api, input);
+        invalidateServerLists();
+        return created;
+    }, [api, client, invalidateServerLists]);
+    const serverUpdateItem = React.useCallback(async (id, input) => {
+        const updated = await client.update(api, id, input);
+        invalidateServerLists();
+        return updated;
+    }, [api, client, invalidateServerLists]);
+    const serverDeleteItem = React.useCallback(async (id) => {
+        await client.delete(api, id);
+        invalidateServerLists();
+    }, [api, client, invalidateServerLists]);
+    const serverBatchDelete = React.useCallback(async (ids) => {
+        const normalizedIds = ids.map((id) => String(id)).filter((id) => id !== '');
+        if (normalizedIds.length === 0)
+            return;
+        await client.batch(api, 'delete', normalizedIds);
+        invalidateServerLists();
+    }, [api, client, invalidateServerLists]);
+    const serverRefresh = React.useCallback(() => {
+        return serverStore.load(true).then(() => undefined);
+    }, [serverStore]);
+    const exportList = React.useCallback((format, query = {}) => {
+        const mergedFilters = { ...baseFilters, ...(query.filters ?? {}) };
+        const mergedProjections = query.projections ?? projectionFields;
+        return client.export(api, format, {
+            ...query,
+            filters: mergedFilters,
+            projections: mergedProjections,
+        });
+    }, [api, baseFilters, client, projectionFields]);
+    const serverGetById = React.useCallback((id) => {
+        return serverSnapshot.page?.items.find((item) => item.id === id);
+    }, [serverSnapshot.page?.items]);
+    const setServerFilters = React.useCallback((next) => {
+        setServerFiltersState(next);
+        setServerPage(1);
+    }, []);
+    const setServerSort = React.useCallback((next) => {
+        setServerSortState(next);
+        setServerPage(1);
+    }, []);
+    const setServerPagination = React.useCallback((nextPage) => {
+        setServerPage(Math.max(1, nextPage));
+    }, []);
+    React.useEffect(() => {
+        if (serverListView)
+            return undefined;
         return store.subscribe(() => {
             setRevision((value) => value + 1);
         });
-    }, [store]);
+    }, [serverListView, store]);
     React.useEffect(() => {
+        if (serverListView)
+            return undefined;
         void store.load(false).catch(() => undefined);
-    }, [store]);
+    }, [serverListView, store]);
     React.useEffect(() => {
+        if (serverListView || typeof window === 'undefined')
+            return undefined;
         if (typeof window === 'undefined')
             return undefined;
         const handleRefresh = (event) => {
@@ -31,7 +150,7 @@ export function useResource(api, options = {}) {
             window.removeEventListener('rdsl:refresh', handleRefresh);
             window.removeEventListener('rdsl:invalidate', handleRefresh);
         };
-    }, [api, store]);
+    }, [api, serverListView, store]);
     const snapshot = store.getSnapshot();
     const collection = useCollectionView(snapshot.items, { pageSize, paginate: true });
     const getById = React.useCallback((id) => {
@@ -46,9 +165,44 @@ export function useResource(api, options = {}) {
     const deleteItem = React.useCallback((id) => {
         return store.deleteItem(id);
     }, [store]);
+    const batchDelete = React.useCallback(async (ids) => {
+        const normalizedIds = ids.map((id) => String(id)).filter((id) => id !== '');
+        if (normalizedIds.length === 0)
+            return;
+        if (typeof store.batchDelete === 'function') {
+            await store.batchDelete(normalizedIds);
+            return;
+        }
+        await Promise.all(normalizedIds.map((id) => store.deleteItem(id)));
+    }, [store]);
     const refresh = React.useCallback(() => {
         return store.load(true).then(() => undefined);
     }, [store]);
+    if (serverListView) {
+        return {
+            data: serverSnapshot.page?.items ?? [],
+            allData: serverSnapshot.page?.items ?? [],
+            loading: serverSnapshot.pendingCount > 0 || !serverSnapshot.resolvedOnce,
+            error: serverSnapshot.error,
+            filters: serverFilters,
+            setFilters: setServerFilters,
+            sort: serverSort,
+            setSort: setServerSort,
+            pagination: {
+                page: serverSnapshot.page?.page ?? serverPage,
+                totalPages: serverSnapshot.page?.totalPages ?? 1,
+                totalItems: serverSnapshot.page?.totalItems ?? 0,
+            },
+            setPagination: setServerPagination,
+            getById: serverGetById,
+            createItem: serverCreateItem,
+            updateItem: serverUpdateItem,
+            deleteItem: serverDeleteItem,
+            batchDelete: serverBatchDelete,
+            exportList,
+            refresh: serverRefresh,
+        };
+    }
     return {
         data: collection.data,
         allData: snapshot.items,
@@ -64,6 +218,8 @@ export function useResource(api, options = {}) {
         createItem,
         updateItem,
         deleteItem,
+        batchDelete,
+        exportList,
         refresh,
     };
 }

package/dist/hooks/useStoredState.d.ts

@@ -0,0 +1,15 @@
+import { type BrowserStorageKind } from './browserStorage.js';
+export type StoredStateStorageKind = 'memory' | BrowserStorageKind;
+export interface StoredStateOptions<T> {
+    key: string;
+    initialValue: T;
+    storage?: StoredStateStorageKind;
+    parse: (parsed: unknown) => T;
+}
+export interface StoredStateResult<T> {
+    value: T;
+    setValue: (value: T | ((current: T) => T)) => void;
+    clearValue: () => void;
+}
+export declare function useStoredState<T>({ key, initialValue, storage, parse, }: StoredStateOptions<T>): StoredStateResult<T>;
+//# sourceMappingURL=useStoredState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useStoredState.d.ts","sourceRoot":"","sources":["../../src/hooks/useStoredState.ts"],"names":[],"mappings":"AACA,OAAO,EAA6C,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzG,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,kBAAkB,CAAC;AAEnE,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC;IACnD,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAChC,GAAG,EACH,YAAY,EACZ,OAAkB,EAClB,KAAK,GACN,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CA6B9C"}

package/dist/hooks/useStoredState.js

@@ -0,0 +1,28 @@
+import React from 'react';
+import { readStoredJsonValue, writeStoredJsonValue } from './browserStorage.js';
+export function useStoredState({ key, initialValue, storage = 'memory', parse, }) {
+    const readValue = React.useCallback(() => {
+        if (storage === 'memory') {
+            return initialValue;
+        }
+        return readStoredJsonValue(key, parse, { storage }) ?? initialValue;
+    }, [initialValue, key, parse, storage]);
+    const [value, setValue] = React.useState(() => readValue());
+    React.useEffect(() => {
+        if (storage === 'memory') {
+            return;
+        }
+        writeStoredJsonValue(key, value, { storage });
+    }, [key, storage, value]);
+    const clearValue = React.useCallback(() => {
+        if (storage !== 'memory') {
+            writeStoredJsonValue(key, null, { storage });
+        }
+        setValue(initialValue);
+    }, [initialValue, key, storage]);
+    return {
+        value,
+        setValue,
+        clearValue,
+    };
+}

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

@@ -1 +1 @@
-{"version":3,"file":"useToast.d.ts","sourceRoot":"","sources":["../../src/hooks/useToast.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzG,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,CAAC;AACvD,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;AAC1E,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC;AAE1D,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACzC,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACvC,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CACvC;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAID,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAEjE;AAuBD,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,kBAAkB,OAEpE;AAED,wBAAgB,QAAQ,IAAI,QAAQ,CAEnC"}
+{"version":3,"file":"useToast.d.ts","sourceRoot":"","sources":["../../src/hooks/useToast.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAGzG,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,CAAC;AACvD,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;AAC1E,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC;AAE1D,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACzC,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACvC,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CACvC;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAID,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAEjE;AAuBD,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,kBAAkB,OAEpE;AAED,wBAAgB,QAAQ,IAAI,QAAQ,CAEnC"}

package/dist/hooks/useToast.js

@@ -1,5 +1,5 @@
 import React from 'react';
-import { resolveMessageText } from '@loj-lang/shared-contracts';
+import { resolveMessageText } from './useI18n.js';
 const ToastContext = React.createContext(undefined);
 export function resolveToastMessage(message) {
     return resolveMessageText(message);

package/dist/hooks/workflowTransition.d.ts

@@ -0,0 +1,21 @@
+interface WorkflowTransitionClient {
+    post<T>(path: string): Promise<T>;
+}
+interface WorkflowTransitionResource {
+    refresh(): Promise<unknown> | unknown;
+}
+export declare function useWorkflowTransitionHandler(options: {
+    resourceApi: string;
+    id: string;
+    resourceClient: WorkflowTransitionClient;
+    resourceView: WorkflowTransitionResource;
+    workflowTransitionTargets: Record<string, string | null | undefined>;
+    resolveNextWorkflowSurfaceHref: (stateName: string) => string | null;
+    setPreconditionError: (value: string | null) => void;
+    updatedMessage: string;
+    preconditionMessage: string;
+    invalidTransitionMessage: string;
+    updateFailedMessage: string;
+}): (transitionName: string) => Promise<void>;
+export {};
+//# sourceMappingURL=workflowTransition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflowTransition.d.ts","sourceRoot":"","sources":["../../src/hooks/workflowTransition.ts"],"names":[],"mappings":"AAKA,UAAU,wBAAwB;IAChC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACnC;AAED,UAAU,0BAA0B;IAClC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACvC;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,wBAAwB,CAAC;IACzC,YAAY,EAAE,0BAA0B,CAAC;IACzC,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACrE,8BAA8B,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACrE,oBAAoB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;CAC7B,GAAG,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAgD5C"}