@mgarlik/datastore 0.1.1 → 0.1.2

package/dist/index.d.cts

@@ -1,4 +1,3 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 import { D as DataStoreStorage } from './storage-D_xv8gFb.cjs';
 
@@ -251,10 +250,38 @@ declare const useProviderDocuments: (provider: ProviderTypes, settings?: {
 declare const useProvider: (val: ProviderTypes) => any;
 /** 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;
+/**
+ * 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: ({ socketServer, restServer, usePersistentStorage, locale, storage, ...props }: DataStoreProps) => react_jsx_runtime.JSX.Element;
+declare const DataStoreProvider: React.ForwardRefExoticComponent<DataStoreProps & React.RefAttributes<DataStoreActionsType>>;
 
 interface UseDataProviderResult {
     /** Materializované dokumenty providera po vyhodnocení šablon a filtraci. */
@@ -425,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, 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 };
+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,4 +1,3 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 import { D as DataStoreStorage } from './storage-D_xv8gFb.js';
 
@@ -251,10 +250,38 @@ declare const useProviderDocuments: (provider: ProviderTypes, settings?: {
 declare const useProvider: (val: ProviderTypes) => any;
 /** 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;
+/**
+ * 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: ({ socketServer, restServer, usePersistentStorage, locale, storage, ...props }: DataStoreProps) => react_jsx_runtime.JSX.Element;
+declare const DataStoreProvider: React.ForwardRefExoticComponent<DataStoreProps & React.RefAttributes<DataStoreActionsType>>;
 
 interface UseDataProviderResult {
     /** Materializované dokumenty providera po vyhodnocení šablon a filtraci. */
@@ -425,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, 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 };
+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 };