@loj-lang/rdsl-runtime 0.5.0

package/dist/hooks/useAuth.js

@@ -0,0 +1,20 @@
+import React from 'react';
+const AuthContext = React.createContext(undefined);
+function readGlobalAuth() {
+    if (typeof window === 'undefined') {
+        return { currentUser: null };
+    }
+    const value = window.__RDSL_AUTH__;
+    if (value && typeof value === 'object') {
+        return {
+            currentUser: value.currentUser ?? null,
+        };
+    }
+    return { currentUser: null };
+}
+export function AuthProvider({ value, children }) {
+    return React.createElement(AuthContext.Provider, { value }, children);
+}
+export function useAuth() {
+    return React.useContext(AuthContext) ?? readGlobalAuth();
+}

package/dist/hooks/useCollectionView.d.ts

@@ -0,0 +1,28 @@
+export interface CollectionPaginationState {
+    page: number;
+    totalPages: number;
+}
+export interface CollectionSortState {
+    field: string;
+    direction: 'asc' | 'desc';
+}
+export interface UseCollectionViewOptions {
+    pageSize?: number;
+    paginate?: boolean;
+}
+export interface UseCollectionViewResult<T extends {
+    id: string;
+}> {
+    data: T[];
+    allData: T[];
+    filters: Record<string, string>;
+    setFilters: (next: Record<string, string>) => void;
+    sort: CollectionSortState | null;
+    setSort: (next: CollectionSortState | null) => void;
+    pagination: CollectionPaginationState;
+    setPagination: (page: number) => void;
+}
+export declare function useCollectionView<T extends {
+    id: string;
+}>(items: readonly T[], options?: UseCollectionViewOptions): UseCollectionViewResult<T>;
+//# sourceMappingURL=useCollectionView.d.ts.map

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

@@ -0,0 +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"}

package/dist/hooks/useCollectionView.js

@@ -0,0 +1,73 @@
+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;
+}
+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]);
+    React.useEffect(() => {
+        if (currentPage !== page) {
+            setPage(currentPage);
+        }
+    }, [currentPage, page]);
+    const setFilters = React.useCallback((next) => {
+        setFiltersState(next);
+        setPage(1);
+    }, []);
+    const setSort = React.useCallback((next) => {
+        setSortState(next);
+        setPage(1);
+    }, []);
+    const setPagination = React.useCallback((nextPage) => {
+        setPage(paginate ? Math.max(1, nextPage) : 1);
+    }, [paginate]);
+    return {
+        data,
+        allData: items,
+        filters,
+        setFilters,
+        sort,
+        setSort,
+        pagination: {
+            page: currentPage,
+            totalPages,
+        },
+        setPagination,
+    };
+}

package/dist/hooks/useDocumentMetadata.d.ts

@@ -0,0 +1,13 @@
+export interface DocumentMetadata {
+    title?: string | null;
+    defaultTitle?: string | null;
+    titleTemplate?: string | null;
+    description?: string | null;
+    canonicalPath?: string | null;
+    image?: string | null;
+    favicon?: string | null;
+    noIndex?: boolean;
+    siteName?: string | null;
+}
+export declare function useDocumentMetadata(metadata: DocumentMetadata): void;
+//# sourceMappingURL=useDocumentMetadata.d.ts.map

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

@@ -0,0 +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"}

package/dist/hooks/useDocumentMetadata.js

@@ -0,0 +1,111 @@
+import React from 'react';
+import { prefixAppBasePath } from './navigation.js';
+export function useDocumentMetadata(metadata) {
+    React.useEffect(() => {
+        if (typeof document === 'undefined') {
+            return;
+        }
+        const resolvedTitle = applyTitleTemplate(metadata.title, metadata.defaultTitle ?? null, metadata.titleTemplate ?? null);
+        if (resolvedTitle) {
+            document.title = resolvedTitle;
+        }
+        setNamedMeta('description', metadata.description ?? null);
+        setNamedMeta('robots', metadata.noIndex ? 'noindex,nofollow' : null);
+        setPropertyMeta('og:title', resolvedTitle);
+        setPropertyMeta('og:description', metadata.description ?? null);
+        setPropertyMeta('og:image', toAbsoluteUrl(metadata.image ?? null));
+        setPropertyMeta('og:site_name', metadata.siteName ?? null);
+        setCanonicalHref(metadata.canonicalPath ?? null);
+        setFaviconHref(metadata.favicon ?? null);
+    }, [
+        metadata.title,
+        metadata.defaultTitle,
+        metadata.titleTemplate,
+        metadata.description,
+        metadata.canonicalPath,
+        metadata.image,
+        metadata.favicon,
+        metadata.noIndex,
+        metadata.siteName,
+    ]);
+}
+function applyTitleTemplate(title, defaultTitle, titleTemplate) {
+    const effectiveTitle = title && title.trim().length > 0 ? title : defaultTitle;
+    if (!effectiveTitle) {
+        return null;
+    }
+    if (!titleTemplate || !titleTemplate.includes('{title}')) {
+        return effectiveTitle;
+    }
+    return titleTemplate.replace(/\{title\}/g, effectiveTitle);
+}
+function setNamedMeta(name, content) {
+    const selector = `meta[name="${name}"]`;
+    let element = document.head.querySelector(selector);
+    if (!content) {
+        element?.remove();
+        return;
+    }
+    if (!element) {
+        element = document.createElement('meta');
+        element.setAttribute('name', name);
+        document.head.appendChild(element);
+    }
+    element.setAttribute('content', content);
+}
+function setPropertyMeta(name, content) {
+    const selector = `meta[property="${name}"]`;
+    let element = document.head.querySelector(selector);
+    if (!content) {
+        element?.remove();
+        return;
+    }
+    if (!element) {
+        element = document.createElement('meta');
+        element.setAttribute('property', name);
+        document.head.appendChild(element);
+    }
+    element.setAttribute('content', content);
+}
+function setCanonicalHref(path) {
+    const selector = 'link[rel="canonical"]';
+    let element = document.head.querySelector(selector);
+    if (!path) {
+        element?.remove();
+        return;
+    }
+    if (!element) {
+        element = document.createElement('link');
+        element.setAttribute('rel', 'canonical');
+        document.head.appendChild(element);
+    }
+    element.setAttribute('href', toAbsoluteUrl(path) ?? path);
+}
+function setFaviconHref(path) {
+    const selector = 'link[rel="icon"]';
+    let element = document.head.querySelector(selector);
+    if (!path) {
+        element?.remove();
+        return;
+    }
+    if (!element) {
+        element = document.createElement('link');
+        element.setAttribute('rel', 'icon');
+        document.head.appendChild(element);
+    }
+    element.setAttribute('href', path);
+}
+function toAbsoluteUrl(path) {
+    if (!path || typeof window === 'undefined') {
+        return path;
+    }
+    if (/^https?:\/\//.test(path)) {
+        return path;
+    }
+    try {
+        return new URL(path.startsWith('/') ? prefixAppBasePath(path) : path, window.location.origin).toString();
+    }
+    catch {
+        return path;
+    }
+}

package/dist/hooks/useGroupedCollectionView.d.ts

@@ -0,0 +1,26 @@
+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;
+}
+export interface UseGroupedCollectionViewResult<T extends {
+    id: string;
+}> {
+    groups: Array<GroupedCollectionViewGroup<T>>;
+    allGroups: Array<GroupedCollectionViewGroup<T>>;
+    sort: CollectionSortState | null;
+    setSort: (next: CollectionSortState | null) => void;
+    pagination: CollectionPaginationState;
+    setPagination: (page: number) => void;
+}
+export declare function useGroupedCollectionView<T extends {
+    id: string;
+}>(items: readonly T[], groupBy: readonly string[], options?: UseGroupedCollectionViewOptions): UseGroupedCollectionViewResult<T>;
+//# sourceMappingURL=useGroupedCollectionView.d.ts.map

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

@@ -0,0 +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"}

package/dist/hooks/useGroupedCollectionView.js

@@ -0,0 +1,82 @@
+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());
+}
+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]);
+    React.useEffect(() => {
+        if (currentPage !== page) {
+            setPage(currentPage);
+        }
+    }, [currentPage, page]);
+    const setSort = React.useCallback((next) => {
+        setSortState(next);
+        setPage(1);
+    }, []);
+    const setPagination = React.useCallback((nextPage) => {
+        setPage(paginate ? Math.max(1, nextPage) : 1);
+    }, [paginate]);
+    return {
+        groups,
+        allGroups,
+        sort,
+        setSort,
+        pagination: {
+            page: currentPage,
+            totalPages,
+        },
+        setPagination,
+    };
+}

package/dist/hooks/useReadModel.d.ts

@@ -0,0 +1,16 @@
+export interface UseReadModelOptions {
+    enabled?: boolean;
+}
+export interface UseReadModelResult<T extends {
+    id: string;
+}> {
+    data: T[];
+    allData: T[];
+    loading: boolean;
+    error: unknown;
+    refresh: () => Promise<void>;
+}
+export declare function useReadModel<T extends {
+    id: string;
+}>(api: string, query: Record<string, string>, options?: UseReadModelOptions): UseReadModelResult<T>;
+//# sourceMappingURL=useReadModel.d.ts.map

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

@@ -0,0 +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"}

package/dist/hooks/useReadModel.js

@@ -0,0 +1,104 @@
+import React from 'react';
+import { useResourceClient } from './resourceClient.js';
+import { matchesResourceTarget } from './resourceTarget.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readModelLeaf(api) {
+    const parts = api.split('/').filter(Boolean);
+    return parts[parts.length - 1] ?? 'item';
+}
+function normalizeReadModelItems(api, payload) {
+    const rows = Array.isArray(payload)
+        ? payload
+        : isRecord(payload) && Array.isArray(payload.items)
+            ? payload.items
+            : isRecord(payload) && Array.isArray(payload.data)
+                ? payload.data
+                : null;
+    if (!rows) {
+        throw new Error(`Invalid read-model response for ${api}: expected an array or { items: [] }`);
+    }
+    const syntheticPrefix = readModelLeaf(api);
+    return rows.map((row, index) => {
+        if (!isRecord(row)) {
+            throw new Error(`Invalid read-model row for ${api}: expected an object`);
+        }
+        return {
+            ...row,
+            id: row.id == null ? `${syntheticPrefix}-${index + 1}` : String(row.id),
+        };
+    });
+}
+function buildReadModelUrl(api, query) {
+    const params = new URLSearchParams();
+    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;
+    }
+    return api.includes('?') ? `${api}&${queryString}` : `${api}?${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);
+        }
+        catch (nextError) {
+            setAllData([]);
+            setError(nextError);
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [api, client, enabled, requestUrl]);
+    React.useEffect(() => {
+        void load();
+    }, [load]);
+    React.useEffect(() => {
+        if (typeof window === 'undefined')
+            return undefined;
+        const handleRefresh = (event) => {
+            const target = event.detail?.target;
+            if (matchesResourceTarget(api, target)) {
+                void load();
+            }
+        };
+        window.addEventListener('rdsl:refresh', handleRefresh);
+        window.addEventListener('rdsl:invalidate', handleRefresh);
+        return () => {
+            window.removeEventListener('rdsl:refresh', handleRefresh);
+            window.removeEventListener('rdsl:invalidate', handleRefresh);
+        };
+    }, [api, load]);
+    const refresh = React.useCallback(async () => {
+        await load();
+    }, [load]);
+    return {
+        data: allData,
+        allData,
+        loading,
+        error,
+        refresh,
+    };
+}

package/dist/hooks/useResource.d.ts

@@ -0,0 +1,36 @@
+export interface ResourcePaginationState {
+    page: number;
+    totalPages: number;
+}
+export interface UseResourceOptions {
+    pageSize?: number;
+}
+export interface UseResourceResult<T extends {
+    id: string;
+}> {
+    data: T[];
+    allData: T[];
+    loading: boolean;
+    error: unknown;
+    filters: Record<string, string>;
+    setFilters: (next: Record<string, string>) => void;
+    sort: {
+        field: string;
+        direction: 'asc' | 'desc';
+    } | null;
+    setSort: (next: {
+        field: string;
+        direction: 'asc' | 'desc';
+    } | null) => void;
+    pagination: ResourcePaginationState;
+    setPagination: (page: number) => void;
+    getById: (id: string) => T | undefined;
+    createItem: (input: Partial<T>) => Promise<T>;
+    updateItem: (id: string, input: Partial<T>) => Promise<T>;
+    deleteItem: (id: string) => Promise<void>;
+    refresh: () => void | Promise<void>;
+}
+export declare function useResource<T extends {
+    id: string;
+}>(api: string, options?: UseResourceOptions): UseResourceResult<T>;
+//# sourceMappingURL=useResource.d.ts.map

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

@@ -0,0 +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"}

package/dist/hooks/useResource.js

@@ -0,0 +1,69 @@
+import React from 'react';
+import { useResourceClient } from './resourceClient.js';
+import { getResourceStore } from './resourceStore.js';
+import { matchesResourceTarget } from './resourceTarget.js';
+import { useCollectionView } from './useCollectionView.js';
+export function useResource(api, options = {}) {
+    const pageSize = options.pageSize ?? 20;
+    const client = useResourceClient();
+    const store = React.useMemo(() => getResourceStore(client, api), [api, client]);
+    const [, setRevision] = React.useState(0);
+    React.useEffect(() => {
+        return store.subscribe(() => {
+            setRevision((value) => value + 1);
+        });
+    }, [store]);
+    React.useEffect(() => {
+        void store.load(false).catch(() => undefined);
+    }, [store]);
+    React.useEffect(() => {
+        if (typeof window === 'undefined')
+            return undefined;
+        const handleRefresh = (event) => {
+            const target = event?.detail?.target;
+            if (matchesResourceTarget(api, target)) {
+                void store.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, store]);
+    const snapshot = store.getSnapshot();
+    const collection = useCollectionView(snapshot.items, { pageSize, paginate: true });
+    const getById = React.useCallback((id) => {
+        return store.getById(id);
+    }, [store]);
+    const createItem = React.useCallback((input) => {
+        return store.createItem(input);
+    }, [store]);
+    const updateItem = React.useCallback((id, input) => {
+        return store.updateItem(id, input);
+    }, [store]);
+    const deleteItem = React.useCallback((id) => {
+        return store.deleteItem(id);
+    }, [store]);
+    const refresh = React.useCallback(() => {
+        return store.load(true).then(() => undefined);
+    }, [store]);
+    return {
+        data: collection.data,
+        allData: snapshot.items,
+        loading: snapshot.pendingCount > 0 || !snapshot.resolvedOnce,
+        error: snapshot.error,
+        filters: collection.filters,
+        setFilters: collection.setFilters,
+        sort: collection.sort,
+        setSort: collection.setSort,
+        pagination: collection.pagination,
+        setPagination: collection.setPagination,
+        getById,
+        createItem,
+        updateItem,
+        deleteItem,
+        refresh,
+    };
+}

package/dist/hooks/useToast.d.ts

@@ -0,0 +1,18 @@
+import type { MessageDescriptor, MessageDescriptorValue, MessageLike } from '@loj-lang/shared-contracts';
+export type ToastMessageValue = MessageDescriptorValue;
+export type ToastMessageDescriptor = MessageDescriptor<ToastMessageValue>;
+export type ToastMessage = MessageLike<ToastMessageValue>;
+export interface ToastApi {
+    success: (message: ToastMessage) => void;
+    error: (message: ToastMessage) => void;
+    info: (message: ToastMessage) => void;
+}
+interface ToastProviderProps {
+    value: ToastApi;
+    children?: React.ReactNode;
+}
+export declare function resolveToastMessage(message: ToastMessage): string;
+export declare function ToastProvider({ value, children }: ToastProviderProps): any;
+export declare function useToast(): ToastApi;
+export {};
+//# sourceMappingURL=useToast.d.ts.map

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

@@ -0,0 +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"}

package/dist/hooks/useToast.js

@@ -0,0 +1,31 @@
+import React from 'react';
+import { resolveMessageText } from '@loj-lang/shared-contracts';
+const ToastContext = React.createContext(undefined);
+export function resolveToastMessage(message) {
+    return resolveMessageText(message);
+}
+function emitToast(level, message) {
+    const resolvedMessage = resolveToastMessage(message);
+    if (typeof window !== 'undefined') {
+        window.dispatchEvent(new CustomEvent('rdsl:toast', {
+            detail: {
+                level,
+                message: resolvedMessage,
+                descriptor: typeof message === 'string' ? undefined : message,
+            },
+        }));
+    }
+    const logger = level === 'error' ? console.error : console.info;
+    logger(`[rdsl:${level}] ${resolvedMessage}`);
+}
+const fallbackToastApi = {
+    success: (message) => emitToast('success', message),
+    error: (message) => emitToast('error', message),
+    info: (message) => emitToast('info', message),
+};
+export function ToastProvider({ value, children }) {
+    return React.createElement(ToastContext.Provider, { value }, children);
+}
+export function useToast() {
+    return React.useContext(ToastContext) ?? fallbackToastApi;
+}