@mgarlik/datastore 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -1,28 +1,13 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
-import * as SQL from 'expo-sqlite';
-
-declare class SQLite$1 {
-    dbName: string;
-    private db;
-    constructor(name?: string);
-    private initDB;
-    private getDb;
-    private createTable;
-    private createTables;
-    /**
-     * Smazani starych logu
-     */
-    private deleteLogs;
-    read<T>(query: string, args?: SQL.SQLiteBindParams): Promise<T[]>;
-    query<T>(query: string, args?: SQL.SQLiteBindParams): Promise<T[]>;
-    dropTable(table: string): Promise<SQL.SQLiteRunResult>;
-    emptyTable(table: string): Promise<SQL.SQLiteRunResult>;
-    getTables(): Promise<unknown[]>;
-    resetDatabase(): Promise<void>;
-}
+import { D as DataStoreStorage } from './storage-D_xv8gFb.cjs';
 
+/**
+ * String identifikátor providera (např. "brands" nebo "categories").
+ */
 type ProviderTypes = string;
+/**
+ * Definice zdroje popisující, odkud se mají data providera načítat.
+ */
 type ProviderDataSource = {
     uri?: string;
     crud?: {
@@ -43,6 +28,9 @@ type ProviderDataSource = {
     select?: any;
     file?: string;
 };
+/**
+ * Definice providera používaná při runtime registraci v DataStoreProvideru.
+ */
 type DataProvider = {
     id: ProviderTypes;
     dataSource?: ProviderDataSource;
@@ -54,21 +42,30 @@ type DataProvider = {
     editor?: Record<string, any>;
     actions?: string[];
 };
+/**
+ * Kolekce definic providerů indexovaná podle provider id.
+ */
 type DataProviders = Record<string, DataProvider>;
 
+/** Kanonický UUID řetězec používaný pro dokumenty a providery. */
 type Uuid = string;
+/** JSON-kompatibilní hodnota používaná v payloadu, filtrech a update operacích. */
 type JSONType = string | number | boolean | {
     [x: string]: JSONType;
 } | Array<JSONType>;
+/** Konfigurace Socket.IO serveru používaná DataStoreProviderem. */
 type SocketServerType = {
     url: string;
     params: Record<string, any>;
 };
+/** In-memory metadata aktivní socket místnosti. */
 type SocketItem = {
     listeners: number;
     data: any[];
 };
+/** Podporované akce zpracovávané interní frontou dispatcheru. */
 type DispatcherActionType = "registerProvider" | "unregisterProvider" | "updateDataStore" | "createDocument" | "updateDocument" | "updateDocuments" | "removeItem" | "deleteDocument" | "createProviderItem" | "deleteProviderItem";
+/** Interní struktura async fronty pro serializované datastore akce. */
 type DispatcherType = {
     isBussy: Boolean;
     actions: {
@@ -148,14 +145,22 @@ type ProductFiltersType = {
     };
 };
 interface DataStoreProps {
+    /** Předdefinovaní provideři dostupní pro registraci a hooky. */
     providers: DataProviders;
     /** Adresa REST/CRUD serveru  */
     restServer: string;
+    /** Socket.IO server používaný pro live aktualizace. */
     socketServer: SocketServerType;
+    /** Volitelná lokalizace pro hlavičku Accept-Language. Pokud chybí, použije se runtime locale. */
+    locale?: string;
+    /** Volitelný persistence adapter. Pokud není předán, balíček běží bez lokální persistence. */
+    storage?: DataStoreStorage | null;
     /** false - provider nebude cist/ukladat data do persistentniho uloziste */
     usePersistentStorage?: boolean;
+    /** React subtree obalená DataStoreProviderem. */
     children: ReactNode;
 }
+/** Veřejné runtime API vystavené přes useDataStore a související hooky. */
 interface DataStore {
     providers: Record<string, any>;
     documents: Record<string, any>;
@@ -184,7 +189,6 @@ interface DataStore {
     unregisterProviderSockets: (sockets: string | string[]) => void;
 }
 
-declare const SQLite: SQLite$1;
 type DataStoreMetaType = Pick<DataStore, "isLive" | "isSynchronizing" | "sockets" | "counterProviders" | "counterDocuments">;
 type DataStoreActionsType = Pick<DataStore, "dispatch" | "initProvider" | "resetProvider" | "registerProvider" | "unregisterProvider" | "updateProviderListeners" | "resetDataStore" | "startSockets" | "stopSockets" | "registerProviderSockets" | "unregisterProviderSockets" | "updateDocuments" | "presetProviders">;
 type DataStoreStableType = {
@@ -196,17 +200,17 @@ type DataStoreStableType = {
     getExternalDocuments: () => Record<string, any>;
     getExternalProviders: () => Record<string, any>;
 };
-/** Meta (isLive, isSynchronizing, sockets, counters) */
+/** Meta informace (isLive, isSynchronizing, sockets, čítače). */
 declare const DataStoreContext: React.Context<DataStoreMetaType>;
-/** Raw documents map */
+/** Surová mapa dokumentů */
 declare const DataStoreDocumentsContext: React.Context<Record<string, any>>;
-/** Raw providers map */
+/** Surová mapa providerů */
 declare const DataStoreProvidersContext: React.Context<Record<string, any>>;
-/** Stable action callbacks */
+/** Stabilní action callbacky */
 declare const DataStoreActionsContext: React.Context<DataStoreActionsType>;
-/** Stable datastore API for provider-scoped subscriptions */
+/** Stabilní datastore API pro provider-scoped subscriptions */
 declare const DataStoreStableContext: React.Context<DataStoreStableType>;
-/** Returns all stable action callbacks. Components using this hook never re-render due to document changes. */
+/** Vrací všechny stabilní action callbacky. Komponenty s tímto hookem se nepřerenderují při změnách dokumentů. */
 declare const useDataStoreActions: () => DataStoreActionsType;
 /**
  *
@@ -214,6 +218,9 @@ declare const useDataStoreActions: () => DataStoreActionsType;
  * @param resultType - "object"(default) | "array"
  * @returns {documents, filter}
  */
+/**
+ * Vyfiltruje všechny datastore dokumenty podle matcher objektu a vrátí reaktivní výsledek.
+ */
 declare const useFilteredDocuments: (filter: Record<string, any>) => {
     documents: any[] | Record<string, any>;
     setFilter: React.Dispatch<React.SetStateAction<Record<string, any>>>;
@@ -230,7 +237,6 @@ declare const useDocuments: () => {
  * Vrati object of documents daneho providera. Dokumenty lze vyfiltrovat
  *
  * @param {*} provider
- * @param {*} filter
  * @returns
  */
 declare const useProviderDocuments: (provider: ProviderTypes, settings?: {
@@ -240,18 +246,72 @@ declare const useProviderDocuments: (provider: ProviderTypes, settings?: {
 }) => {
     [key: string]: any;
 };
+/** Vrací surový stav providera podle provider id. */
 declare const useProvider: (val: ProviderTypes) => any;
-/** Full DataStore — merges all sub-contexts. Components using this re-render on any state change. */
+/** Kompletní DataStore - spojuje všechny sub-contexty. Komponenty s tímto hookem se přerenderují při jakékoliv změně stavu. */
 declare const useDataStore: () => DataStore;
-declare const DataStoreProvider: ({ socketServer, restServer, usePersistentStorage, ...props }: DataStoreProps) => react_jsx_runtime.JSX.Element;
+/**
+ * Imperativní API `DataStoreProvider` vystavené přes `ref`.
+ *
+ * Umožňuje volat akce DataStore přímo z rodiče (např. `App.tsx`)
+ * bez nutnosti použití `useDataStoreActions` hooku uvnitř stromové hierarchie.
+ *
+ * @example
+ * ```tsx
+ * const dsRef = useRef<DataStoreRef>(null);
+ *
+ * <DataStoreProvider ref={dsRef} ...>
+ *   <AppProvider
+ *     onLogin={({ userId }) => {
+ *       dsRef.current?.startSockets();
+ *       dsRef.current?.registerProviderSockets(userId);
+ *     }}
+ *     onLogout={({ userId }) => {
+ *       dsRef.current?.unregisterProviderSockets(userId);
+ *       dsRef.current?.stopSockets();
+ *     }}
+ *   />
+ * </DataStoreProvider>
+ * ```
+ */
+type DataStoreRef = DataStoreActionsType;
+/**
+ * Kořenový provider, který propojuje DataStore contexty, REST načítání, sockety a volitelnou persistenci.
+ *
+ * Podporuje volitelný `ref` (`DataStoreRef`) pro imperativní přístup k akcím
+ * přímo z rodičovské komponenty bez použití kontextového hooku.
+ */
+declare const DataStoreProvider: React.ForwardRefExoticComponent<DataStoreProps & React.RefAttributes<DataStoreActionsType>>;
 
+interface UseDataProviderResult {
+    /** Materializované dokumenty providera po vyhodnocení šablon a filtraci. */
+    documents: Array<Record<string, any>>;
+    /** Schéma providera, pokud je dostupné. */
+    schema?: Record<string, any>;
+    /** Aktualizuje data providera pomocí výchozí update varianty. */
+    update: (val: JSONType) => void;
+    /** Aktualizuje položku/položky providera s volitelnou variantou a route parametry. */
+    updateItem: (args: {
+        params?: JSONType;
+        data?: JSONType;
+        variant?: string;
+        documentId?: string;
+    }, callback?: (resp: JSONType) => void) => void;
+    /** Smaže položku/položky providera. */
+    deleteItem: (args: {
+        params?: JSONType;
+        data?: JSONType;
+    }, callback?: (resp: JSONType) => void) => void;
+    /** Vytvoří novou položku providera. */
+    createItem: (data: JSONType, callback?: () => void) => void;
+}
 /**
+ * Zaregistruje/zpřístupní providera a vrátí normalizované dokumenty spolu s CRUD helpery.
  *
- * @param id ID providera z ProviderTypes
- * @param params parametry pro doplneni URI adresy z dataProviders
- * @param dataFilter Filter dat providera
- * @param settings documentId ID dokumentu pouziteho k prepocitani dokumentu providera, document: JSON dokument k prepocitani dokumentu providera
- * @returns void
+ * @param id Provider id nebo inline definice providera.
+ * @param params Parametry šablony používané při renderu URI/definice.
+ * @param dataFilter Volitelný client-side filtr dokumentů providera.
+ * @param settings Volitelný závislý dokument použitý pro přepočet dat.
  */
 declare const useDataProvider: (
 /**
@@ -276,26 +336,9 @@ dataFilter?: JSONType | null,
 settings?: {
     documentId?: string;
     document?: JSONType;
-}) => {
-    documents: any;
-    schema: any;
-    update: (val: JSONType) => void;
-    updateItem: ({ params, data, variant, documentId }: {
-        params?: JSONType;
-        data?: JSONType;
-        variant?: string;
-        documentId?: string;
-    }, callback?: (resp: JSONType) => void) => void;
-    deleteItem: ({ params, data }: {
-        params?: JSONType;
-        data?: JSONType;
-    }, callback?: (resp: JSONType) => void) => void;
-    createItem: (data: JSONType, callback?: () => void) => void;
-};
+}) => UseDataProviderResult;
 
-/**
- * blabla
- */
+/** Vstupní parametry hooku useDocument. */
 interface UseDocumentParams {
     /**
      * UUID dokumentu
@@ -316,41 +359,40 @@ interface UseDocumentParams {
     allFields?: boolean;
 }
 interface UseDocumentResult {
-    /**
-     * Vraci neco
-     */
+    /** Materializovaný payload dokumentu z DataStore. */
     document: Record<string, any>;
 }
 /**
- * Provider dokumentu z DataProvider
+ * Vrátí jeden dokument a volitelně spustí lazy načtení chybějících polí.
  *
- * Example: useDocument({documentId: "123-123123-123123-12", model: "products", fields: ["name", "image"]})
- *
- * @param documentId - ID dokumentu
- * @param model - nazev modelu
- * @param provider - nazev providera
- * @param fields - seznam polozek dokumentu ktere chceme ziskat
- * @param allFields - kompletni dokument
- *
- * @returns - vraci dokument
+ * Example: useDocument({ documentId: "...", model: "products", fields: ["name", "image"] })
  */
 declare const useDocument: ({ documentId, model, provider, fields, allFields }: UseDocumentParams) => UseDocumentResult;
 
-declare const useProviderActions: (providerId: Uuid, data?: JSONType) => {
-    schema: any;
+interface UseProviderActionsResult {
+    /** Schéma providera, pokud je dostupné. */
+    schema?: Record<string, any>;
+    /** Aktualizuje data providera pomocí výchozí update varianty. */
     update: (val: JSONType) => void;
-    updateItem: ({ params, data, variant, documentId }: {
+    /** Aktualizuje položku/položky providera s volitelnou route variantou a parametry. */
+    updateItem: (args: {
         params?: JSONType;
         data?: any;
         variant?: string;
         documentId?: Uuid;
     }, callback?: (value: JSONType) => void) => void;
-    deleteItem: ({ params, data }: {
+    /** Smaže položku/položky providera. */
+    deleteItem: (args: {
         params: JSONType;
         data?: JSONType;
     }, callback?: () => void) => void;
+    /** Vytvoří novou položku providera. */
     createItem: (data: JSONType, callback?: (value: JSONType) => void) => void;
-};
+}
+/**
+ * Vrací action helpery pro známé provider id.
+ */
+declare const useProviderActions: (providerId: Uuid, data?: JSONType) => UseProviderActionsResult;
 
 declare function recalculateObjectWithDocument(obj: any, document: any): any;
 declare function getValueByRules(data: any, document: any, { mode, ruleId }: {
@@ -410,4 +452,4 @@ declare const COLOR_AXIOS = "\u001B[33m%s\u001B[0m";
 declare const COLOR_APP = "\u001B[34m%s\u001B[0m";
 declare const COLOR_DS = "\u001B[35m%s\u001B[0m";
 
-export { COLOR_APP, COLOR_AXIOS, COLOR_BLUE, COLOR_CONTEXT, COLOR_CYAN, COLOR_DS, COLOR_ERROR, COLOR_FUNCTION, COLOR_GREEN, COLOR_MAGENTA, COLOR_ORANGE, COLOR_PROVIDER, COLOR_RED, COLOR_RENDER, COLOR_SCREEN, COLOR_SOCKET, COLOR_SOCKETS, COLOR_WARNING, COLOR_WHITE, COLOR_YELLOW, type DataProvider, type DataProviders, type DataStore, DataStoreActionsContext, DataStoreContext, DataStoreDocumentsContext, type DataStoreProps, DataStoreProvider, DataStoreProvidersContext, DataStoreStableContext, type DispatcherActionType, type DispatcherType, type FilterType, type JSONType, type ProductFiltersType, type ProviderDataSource, type ProviderTypes, SQLite, type SchemaType, type SocketItem, type SocketServerType, type Uuid, dataStoreFilterObject, doesObjectMatchFilter, doesValueMatchFilter, filterDocuments, filterDocumentsAsync, type filterItemType, getValueByRules, isUuid, recalculateObjectWithDocument, useDataProvider, useDataStore, useDataStoreActions, useDocument, useDocuments, useFilteredDocuments, useProvider, useProviderActions, useProviderDocuments, uuid };
+export { COLOR_APP, COLOR_AXIOS, COLOR_BLUE, COLOR_CONTEXT, COLOR_CYAN, COLOR_DS, COLOR_ERROR, COLOR_FUNCTION, COLOR_GREEN, COLOR_MAGENTA, COLOR_ORANGE, COLOR_PROVIDER, COLOR_RED, COLOR_RENDER, COLOR_SCREEN, COLOR_SOCKET, COLOR_SOCKETS, COLOR_WARNING, COLOR_WHITE, COLOR_YELLOW, type DataProvider, type DataProviders, type DataStore, DataStoreActionsContext, DataStoreContext, DataStoreDocumentsContext, type DataStoreProps, DataStoreProvider, DataStoreProvidersContext, type DataStoreRef, DataStoreStableContext, DataStoreStorage, type DispatcherActionType, type DispatcherType, type FilterType, type JSONType, type ProductFiltersType, type ProviderDataSource, type ProviderTypes, type SchemaType, type SocketItem, type SocketServerType, type UseDataProviderResult, type UseProviderActionsResult, type Uuid, dataStoreFilterObject, doesObjectMatchFilter, doesValueMatchFilter, filterDocuments, filterDocumentsAsync, type filterItemType, getValueByRules, isUuid, recalculateObjectWithDocument, useDataProvider, useDataStore, useDataStoreActions, useDocument, useDocuments, useFilteredDocuments, useProvider, useProviderActions, useProviderDocuments, uuid };

package/dist/index.d.ts

@@ -1,28 +1,13 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
-import * as SQL from 'expo-sqlite';
-
-declare class SQLite$1 {
-    dbName: string;
-    private db;
-    constructor(name?: string);
-    private initDB;
-    private getDb;
-    private createTable;
-    private createTables;
-    /**
-     * Smazani starych logu
-     */
-    private deleteLogs;
-    read<T>(query: string, args?: SQL.SQLiteBindParams): Promise<T[]>;
-    query<T>(query: string, args?: SQL.SQLiteBindParams): Promise<T[]>;
-    dropTable(table: string): Promise<SQL.SQLiteRunResult>;
-    emptyTable(table: string): Promise<SQL.SQLiteRunResult>;
-    getTables(): Promise<unknown[]>;
-    resetDatabase(): Promise<void>;
-}
+import { D as DataStoreStorage } from './storage-D_xv8gFb.js';
 
+/**
+ * String identifikátor providera (např. "brands" nebo "categories").
+ */
 type ProviderTypes = string;
+/**
+ * Definice zdroje popisující, odkud se mají data providera načítat.
+ */
 type ProviderDataSource = {
     uri?: string;
     crud?: {
@@ -43,6 +28,9 @@ type ProviderDataSource = {
     select?: any;
     file?: string;
 };
+/**
+ * Definice providera používaná při runtime registraci v DataStoreProvideru.
+ */
 type DataProvider = {
     id: ProviderTypes;
     dataSource?: ProviderDataSource;
@@ -54,21 +42,30 @@ type DataProvider = {
     editor?: Record<string, any>;
     actions?: string[];
 };
+/**
+ * Kolekce definic providerů indexovaná podle provider id.
+ */
 type DataProviders = Record<string, DataProvider>;
 
+/** Kanonický UUID řetězec používaný pro dokumenty a providery. */
 type Uuid = string;
+/** JSON-kompatibilní hodnota používaná v payloadu, filtrech a update operacích. */
 type JSONType = string | number | boolean | {
     [x: string]: JSONType;
 } | Array<JSONType>;
+/** Konfigurace Socket.IO serveru používaná DataStoreProviderem. */
 type SocketServerType = {
     url: string;
     params: Record<string, any>;
 };
+/** In-memory metadata aktivní socket místnosti. */
 type SocketItem = {
     listeners: number;
     data: any[];
 };
+/** Podporované akce zpracovávané interní frontou dispatcheru. */
 type DispatcherActionType = "registerProvider" | "unregisterProvider" | "updateDataStore" | "createDocument" | "updateDocument" | "updateDocuments" | "removeItem" | "deleteDocument" | "createProviderItem" | "deleteProviderItem";
+/** Interní struktura async fronty pro serializované datastore akce. */
 type DispatcherType = {
     isBussy: Boolean;
     actions: {
@@ -148,14 +145,22 @@ type ProductFiltersType = {
     };
 };
 interface DataStoreProps {
+    /** Předdefinovaní provideři dostupní pro registraci a hooky. */
     providers: DataProviders;
     /** Adresa REST/CRUD serveru  */
     restServer: string;
+    /** Socket.IO server používaný pro live aktualizace. */
     socketServer: SocketServerType;
+    /** Volitelná lokalizace pro hlavičku Accept-Language. Pokud chybí, použije se runtime locale. */
+    locale?: string;
+    /** Volitelný persistence adapter. Pokud není předán, balíček běží bez lokální persistence. */
+    storage?: DataStoreStorage | null;
     /** false - provider nebude cist/ukladat data do persistentniho uloziste */
     usePersistentStorage?: boolean;
+    /** React subtree obalená DataStoreProviderem. */
     children: ReactNode;
 }
+/** Veřejné runtime API vystavené přes useDataStore a související hooky. */
 interface DataStore {
     providers: Record<string, any>;
     documents: Record<string, any>;
@@ -184,7 +189,6 @@ interface DataStore {
     unregisterProviderSockets: (sockets: string | string[]) => void;
 }
 
-declare const SQLite: SQLite$1;
 type DataStoreMetaType = Pick<DataStore, "isLive" | "isSynchronizing" | "sockets" | "counterProviders" | "counterDocuments">;
 type DataStoreActionsType = Pick<DataStore, "dispatch" | "initProvider" | "resetProvider" | "registerProvider" | "unregisterProvider" | "updateProviderListeners" | "resetDataStore" | "startSockets" | "stopSockets" | "registerProviderSockets" | "unregisterProviderSockets" | "updateDocuments" | "presetProviders">;
 type DataStoreStableType = {
@@ -196,17 +200,17 @@ type DataStoreStableType = {
     getExternalDocuments: () => Record<string, any>;
     getExternalProviders: () => Record<string, any>;
 };
-/** Meta (isLive, isSynchronizing, sockets, counters) */
+/** Meta informace (isLive, isSynchronizing, sockets, čítače). */
 declare const DataStoreContext: React.Context<DataStoreMetaType>;
-/** Raw documents map */
+/** Surová mapa dokumentů */
 declare const DataStoreDocumentsContext: React.Context<Record<string, any>>;
-/** Raw providers map */
+/** Surová mapa providerů */
 declare const DataStoreProvidersContext: React.Context<Record<string, any>>;
-/** Stable action callbacks */
+/** Stabilní action callbacky */
 declare const DataStoreActionsContext: React.Context<DataStoreActionsType>;
-/** Stable datastore API for provider-scoped subscriptions */
+/** Stabilní datastore API pro provider-scoped subscriptions */
 declare const DataStoreStableContext: React.Context<DataStoreStableType>;
-/** Returns all stable action callbacks. Components using this hook never re-render due to document changes. */
+/** Vrací všechny stabilní action callbacky. Komponenty s tímto hookem se nepřerenderují při změnách dokumentů. */
 declare const useDataStoreActions: () => DataStoreActionsType;
 /**
  *
@@ -214,6 +218,9 @@ declare const useDataStoreActions: () => DataStoreActionsType;
  * @param resultType - "object"(default) | "array"
  * @returns {documents, filter}
  */
+/**
+ * Vyfiltruje všechny datastore dokumenty podle matcher objektu a vrátí reaktivní výsledek.
+ */
 declare const useFilteredDocuments: (filter: Record<string, any>) => {
     documents: any[] | Record<string, any>;
     setFilter: React.Dispatch<React.SetStateAction<Record<string, any>>>;
@@ -230,7 +237,6 @@ declare const useDocuments: () => {
  * Vrati object of documents daneho providera. Dokumenty lze vyfiltrovat
  *
  * @param {*} provider
- * @param {*} filter
  * @returns
  */
 declare const useProviderDocuments: (provider: ProviderTypes, settings?: {
@@ -240,18 +246,72 @@ declare const useProviderDocuments: (provider: ProviderTypes, settings?: {
 }) => {
     [key: string]: any;
 };
+/** Vrací surový stav providera podle provider id. */
 declare const useProvider: (val: ProviderTypes) => any;
-/** Full DataStore — merges all sub-contexts. Components using this re-render on any state change. */
+/** Kompletní DataStore - spojuje všechny sub-contexty. Komponenty s tímto hookem se přerenderují při jakékoliv změně stavu. */
 declare const useDataStore: () => DataStore;
-declare const DataStoreProvider: ({ socketServer, restServer, usePersistentStorage, ...props }: DataStoreProps) => react_jsx_runtime.JSX.Element;
+/**
+ * Imperativní API `DataStoreProvider` vystavené přes `ref`.
+ *
+ * Umožňuje volat akce DataStore přímo z rodiče (např. `App.tsx`)
+ * bez nutnosti použití `useDataStoreActions` hooku uvnitř stromové hierarchie.
+ *
+ * @example
+ * ```tsx
+ * const dsRef = useRef<DataStoreRef>(null);
+ *
+ * <DataStoreProvider ref={dsRef} ...>
+ *   <AppProvider
+ *     onLogin={({ userId }) => {
+ *       dsRef.current?.startSockets();
+ *       dsRef.current?.registerProviderSockets(userId);
+ *     }}
+ *     onLogout={({ userId }) => {
+ *       dsRef.current?.unregisterProviderSockets(userId);
+ *       dsRef.current?.stopSockets();
+ *     }}
+ *   />
+ * </DataStoreProvider>
+ * ```
+ */
+type DataStoreRef = DataStoreActionsType;
+/**
+ * Kořenový provider, který propojuje DataStore contexty, REST načítání, sockety a volitelnou persistenci.
+ *
+ * Podporuje volitelný `ref` (`DataStoreRef`) pro imperativní přístup k akcím
+ * přímo z rodičovské komponenty bez použití kontextového hooku.
+ */
+declare const DataStoreProvider: React.ForwardRefExoticComponent<DataStoreProps & React.RefAttributes<DataStoreActionsType>>;
 
+interface UseDataProviderResult {
+    /** Materializované dokumenty providera po vyhodnocení šablon a filtraci. */
+    documents: Array<Record<string, any>>;
+    /** Schéma providera, pokud je dostupné. */
+    schema?: Record<string, any>;
+    /** Aktualizuje data providera pomocí výchozí update varianty. */
+    update: (val: JSONType) => void;
+    /** Aktualizuje položku/položky providera s volitelnou variantou a route parametry. */
+    updateItem: (args: {
+        params?: JSONType;
+        data?: JSONType;
+        variant?: string;
+        documentId?: string;
+    }, callback?: (resp: JSONType) => void) => void;
+    /** Smaže položku/položky providera. */
+    deleteItem: (args: {
+        params?: JSONType;
+        data?: JSONType;
+    }, callback?: (resp: JSONType) => void) => void;
+    /** Vytvoří novou položku providera. */
+    createItem: (data: JSONType, callback?: () => void) => void;
+}
 /**
+ * Zaregistruje/zpřístupní providera a vrátí normalizované dokumenty spolu s CRUD helpery.
  *
- * @param id ID providera z ProviderTypes
- * @param params parametry pro doplneni URI adresy z dataProviders
- * @param dataFilter Filter dat providera
- * @param settings documentId ID dokumentu pouziteho k prepocitani dokumentu providera, document: JSON dokument k prepocitani dokumentu providera
- * @returns void
+ * @param id Provider id nebo inline definice providera.
+ * @param params Parametry šablony používané při renderu URI/definice.
+ * @param dataFilter Volitelný client-side filtr dokumentů providera.
+ * @param settings Volitelný závislý dokument použitý pro přepočet dat.
  */
 declare const useDataProvider: (
 /**
@@ -276,26 +336,9 @@ dataFilter?: JSONType | null,
 settings?: {
     documentId?: string;
     document?: JSONType;
-}) => {
-    documents: any;
-    schema: any;
-    update: (val: JSONType) => void;
-    updateItem: ({ params, data, variant, documentId }: {
-        params?: JSONType;
-        data?: JSONType;
-        variant?: string;
-        documentId?: string;
-    }, callback?: (resp: JSONType) => void) => void;
-    deleteItem: ({ params, data }: {
-        params?: JSONType;
-        data?: JSONType;
-    }, callback?: (resp: JSONType) => void) => void;
-    createItem: (data: JSONType, callback?: () => void) => void;
-};
+}) => UseDataProviderResult;
 
-/**
- * blabla
- */
+/** Vstupní parametry hooku useDocument. */
 interface UseDocumentParams {
     /**
      * UUID dokumentu
@@ -316,41 +359,40 @@ interface UseDocumentParams {
     allFields?: boolean;
 }
 interface UseDocumentResult {
-    /**
-     * Vraci neco
-     */
+    /** Materializovaný payload dokumentu z DataStore. */
     document: Record<string, any>;
 }
 /**
- * Provider dokumentu z DataProvider
+ * Vrátí jeden dokument a volitelně spustí lazy načtení chybějících polí.
  *
- * Example: useDocument({documentId: "123-123123-123123-12", model: "products", fields: ["name", "image"]})
- *
- * @param documentId - ID dokumentu
- * @param model - nazev modelu
- * @param provider - nazev providera
- * @param fields - seznam polozek dokumentu ktere chceme ziskat
- * @param allFields - kompletni dokument
- *
- * @returns - vraci dokument
+ * Example: useDocument({ documentId: "...", model: "products", fields: ["name", "image"] })
  */
 declare const useDocument: ({ documentId, model, provider, fields, allFields }: UseDocumentParams) => UseDocumentResult;
 
-declare const useProviderActions: (providerId: Uuid, data?: JSONType) => {
-    schema: any;
+interface UseProviderActionsResult {
+    /** Schéma providera, pokud je dostupné. */
+    schema?: Record<string, any>;
+    /** Aktualizuje data providera pomocí výchozí update varianty. */
     update: (val: JSONType) => void;
-    updateItem: ({ params, data, variant, documentId }: {
+    /** Aktualizuje položku/položky providera s volitelnou route variantou a parametry. */
+    updateItem: (args: {
         params?: JSONType;
         data?: any;
         variant?: string;
         documentId?: Uuid;
     }, callback?: (value: JSONType) => void) => void;
-    deleteItem: ({ params, data }: {
+    /** Smaže položku/položky providera. */
+    deleteItem: (args: {
         params: JSONType;
         data?: JSONType;
     }, callback?: () => void) => void;
+    /** Vytvoří novou položku providera. */
     createItem: (data: JSONType, callback?: (value: JSONType) => void) => void;
-};
+}
+/**
+ * Vrací action helpery pro známé provider id.
+ */
+declare const useProviderActions: (providerId: Uuid, data?: JSONType) => UseProviderActionsResult;
 
 declare function recalculateObjectWithDocument(obj: any, document: any): any;
 declare function getValueByRules(data: any, document: any, { mode, ruleId }: {
@@ -410,4 +452,4 @@ declare const COLOR_AXIOS = "\u001B[33m%s\u001B[0m";
 declare const COLOR_APP = "\u001B[34m%s\u001B[0m";
 declare const COLOR_DS = "\u001B[35m%s\u001B[0m";
 
-export { COLOR_APP, COLOR_AXIOS, COLOR_BLUE, COLOR_CONTEXT, COLOR_CYAN, COLOR_DS, COLOR_ERROR, COLOR_FUNCTION, COLOR_GREEN, COLOR_MAGENTA, COLOR_ORANGE, COLOR_PROVIDER, COLOR_RED, COLOR_RENDER, COLOR_SCREEN, COLOR_SOCKET, COLOR_SOCKETS, COLOR_WARNING, COLOR_WHITE, COLOR_YELLOW, type DataProvider, type DataProviders, type DataStore, DataStoreActionsContext, DataStoreContext, DataStoreDocumentsContext, type DataStoreProps, DataStoreProvider, DataStoreProvidersContext, DataStoreStableContext, type DispatcherActionType, type DispatcherType, type FilterType, type JSONType, type ProductFiltersType, type ProviderDataSource, type ProviderTypes, SQLite, type SchemaType, type SocketItem, type SocketServerType, type Uuid, dataStoreFilterObject, doesObjectMatchFilter, doesValueMatchFilter, filterDocuments, filterDocumentsAsync, type filterItemType, getValueByRules, isUuid, recalculateObjectWithDocument, useDataProvider, useDataStore, useDataStoreActions, useDocument, useDocuments, useFilteredDocuments, useProvider, useProviderActions, useProviderDocuments, uuid };
+export { COLOR_APP, COLOR_AXIOS, COLOR_BLUE, COLOR_CONTEXT, COLOR_CYAN, COLOR_DS, COLOR_ERROR, COLOR_FUNCTION, COLOR_GREEN, COLOR_MAGENTA, COLOR_ORANGE, COLOR_PROVIDER, COLOR_RED, COLOR_RENDER, COLOR_SCREEN, COLOR_SOCKET, COLOR_SOCKETS, COLOR_WARNING, COLOR_WHITE, COLOR_YELLOW, type DataProvider, type DataProviders, type DataStore, DataStoreActionsContext, DataStoreContext, DataStoreDocumentsContext, type DataStoreProps, DataStoreProvider, DataStoreProvidersContext, type DataStoreRef, DataStoreStableContext, DataStoreStorage, type DispatcherActionType, type DispatcherType, type FilterType, type JSONType, type ProductFiltersType, type ProviderDataSource, type ProviderTypes, type SchemaType, type SocketItem, type SocketServerType, type UseDataProviderResult, type UseProviderActionsResult, type Uuid, dataStoreFilterObject, doesObjectMatchFilter, doesValueMatchFilter, filterDocuments, filterDocumentsAsync, type filterItemType, getValueByRules, isUuid, recalculateObjectWithDocument, useDataProvider, useDataStore, useDataStoreActions, useDocument, useDocuments, useFilteredDocuments, useProvider, useProviderActions, useProviderDocuments, uuid };