@mgarlik/datastore 0.1.10 → 0.1.12

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import React, { ReactNode } from 'react';
+import React$1, { ReactNode } from 'react';
 import { D as DataStoreStorage } from './storage-D_xv8gFb.cjs';
 
 type ProviderDataSourceType = {
@@ -59,6 +59,27 @@ type ProviderEditorType = {
     };
 };
 
+type ProviderLayoutType = {
+    title?: string;
+    variant?: "grouped" | "insetGrouped" | "plain";
+    tooltip?: string | React.ReactNode;
+    sections?: {
+        id: string;
+        title?: string;
+        description?: string;
+        footer?: string;
+        tooltip?: string | React.ReactNode;
+        visible?: boolean | JsonFilter;
+        items: Array<{
+            field: string;
+            form?: "textInput" | "select" | "switch" | "dateTime";
+            label?: string; // jen override
+            visible?: boolean | JsonFilter;
+            tooltip?: string | React.ReactNode;
+        }>;
+    }[];
+};
+
 type ProviderSchemaItemType = {
     /**
      * Zdrojove pole pro hodnotu (např. "name" nebo "price"). Pokud není uvedeno, očekává se, že hodnota bude přímo v kořenovém objektu.
@@ -90,8 +111,12 @@ type ProviderSchemaItemType = {
     mode?: "screen";
     title?: string;
     placeholder?: string;
-    dataSource?: { dataProvider: ProviderTypes };
-    itemRules?: string;
+    // Pro select a radio
+    options?: { value: any; label?: string, icon?: string }[] | {
+        dataProvider: ProviderTypes;
+        optionKeys?: { value: string; label: LabelProps | { title: string; icon: string } };
+        filter?: string | RuleType;
+    };
     description?: string;
     /** TODO: Divna definice labelu */
     optionKeys?: { value: string; label: LabelProps | { title: string; icon: string } };
@@ -124,6 +149,7 @@ type DataProviderType = {
     autoCreate?: boolean;
     schema?: { [key: string]: ProviderSchemaItemType };
     editor?: ProviderEditorType;
+    layout?: ProviderLayoutType;
     /**
      * Jake akce jsou povolene pro dataSource. Pokud neni uvedeno, jsou povolene vsechny
      */
@@ -131,12 +157,12 @@ type DataProviderType = {
     actions?: DataProviderActionType[]; //
 };
 
-type DataProvidersType = Record<string, DataProviderType>;
+type DataProvidersType = { [key: string]: DataProviderType };
 
 /** 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 | {
+type JSONType = string | number | boolean | null | {
     [x: string]: JSONType;
 } | Array<JSONType>;
 /** Konfigurace Socket.IO serveru používaná DataStoreProviderem. */
@@ -257,15 +283,15 @@ type DataStoreStableType = {
     getExternalProviders: () => Record<string, any>;
 };
 /** Meta informace (isLive, isSynchronizing, sockets, čítače). */
-declare const DataStoreContext: React.Context<DataStoreMetaType>;
+declare const DataStoreContext: React$1.Context<DataStoreMetaType>;
 /** Surová mapa dokumentů */
-declare const DataStoreDocumentsContext: React.Context<Record<string, any>>;
+declare const DataStoreDocumentsContext: React$1.Context<Record<string, any>>;
 /** Surová mapa providerů */
-declare const DataStoreProvidersContext: React.Context<Record<string, any>>;
+declare const DataStoreProvidersContext: React$1.Context<Record<string, any>>;
 /** Stabilní action callbacky */
-declare const DataStoreActionsContext: React.Context<DataStoreActionsType>;
+declare const DataStoreActionsContext: React$1.Context<DataStoreActionsType>;
 /** Stabilní datastore API pro provider-scoped subscriptions */
-declare const DataStoreStableContext: React.Context<DataStoreStableType>;
+declare const DataStoreStableContext: React$1.Context<DataStoreStableType>;
 /** Vrací všechny stabilní action callbacky. Komponenty s tímto hookem se nepřerenderují při změnách dokumentů. */
 declare const useDataStoreActions: () => DataStoreActionsType;
 /**
@@ -279,7 +305,7 @@ declare const useDataStoreActions: () => DataStoreActionsType;
  */
 declare const useFilteredDocuments: (filter: Record<string, any>) => {
     documents: any[] | Record<string, any>;
-    setFilter: React.Dispatch<React.SetStateAction<Record<string, any>>>;
+    setFilter: React$1.Dispatch<React$1.SetStateAction<Record<string, any>>>;
 };
 /**
  * Vrati objekt vsech dokumentu
@@ -340,13 +366,14 @@ type DataStoreRef = DataStoreActionsType;
  * 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>>;
+declare const DataStoreProvider: React$1.ForwardRefExoticComponent<DataStoreProps & React$1.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>;
+    layout?: ProviderLayoutType;
     /** Aktualizuje data providera pomocí výchozí update varianty. */
     update: (val: JSONType) => void;
     /** Aktualizuje položku/položky providera s volitelnou variantou a route parametry. */

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import React, { ReactNode } from 'react';
+import React$1, { ReactNode } from 'react';
 import { D as DataStoreStorage } from './storage-D_xv8gFb.js';
 
 type ProviderDataSourceType = {
@@ -59,6 +59,27 @@ type ProviderEditorType = {
     };
 };
 
+type ProviderLayoutType = {
+    title?: string;
+    variant?: "grouped" | "insetGrouped" | "plain";
+    tooltip?: string | React.ReactNode;
+    sections?: {
+        id: string;
+        title?: string;
+        description?: string;
+        footer?: string;
+        tooltip?: string | React.ReactNode;
+        visible?: boolean | JsonFilter;
+        items: Array<{
+            field: string;
+            form?: "textInput" | "select" | "switch" | "dateTime";
+            label?: string; // jen override
+            visible?: boolean | JsonFilter;
+            tooltip?: string | React.ReactNode;
+        }>;
+    }[];
+};
+
 type ProviderSchemaItemType = {
     /**
      * Zdrojove pole pro hodnotu (např. "name" nebo "price"). Pokud není uvedeno, očekává se, že hodnota bude přímo v kořenovém objektu.
@@ -90,8 +111,12 @@ type ProviderSchemaItemType = {
     mode?: "screen";
     title?: string;
     placeholder?: string;
-    dataSource?: { dataProvider: ProviderTypes };
-    itemRules?: string;
+    // Pro select a radio
+    options?: { value: any; label?: string, icon?: string }[] | {
+        dataProvider: ProviderTypes;
+        optionKeys?: { value: string; label: LabelProps | { title: string; icon: string } };
+        filter?: string | RuleType;
+    };
     description?: string;
     /** TODO: Divna definice labelu */
     optionKeys?: { value: string; label: LabelProps | { title: string; icon: string } };
@@ -124,6 +149,7 @@ type DataProviderType = {
     autoCreate?: boolean;
     schema?: { [key: string]: ProviderSchemaItemType };
     editor?: ProviderEditorType;
+    layout?: ProviderLayoutType;
     /**
      * Jake akce jsou povolene pro dataSource. Pokud neni uvedeno, jsou povolene vsechny
      */
@@ -131,12 +157,12 @@ type DataProviderType = {
     actions?: DataProviderActionType[]; //
 };
 
-type DataProvidersType = Record<string, DataProviderType>;
+type DataProvidersType = { [key: string]: DataProviderType };
 
 /** 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 | {
+type JSONType = string | number | boolean | null | {
     [x: string]: JSONType;
 } | Array<JSONType>;
 /** Konfigurace Socket.IO serveru používaná DataStoreProviderem. */
@@ -257,15 +283,15 @@ type DataStoreStableType = {
     getExternalProviders: () => Record<string, any>;
 };
 /** Meta informace (isLive, isSynchronizing, sockets, čítače). */
-declare const DataStoreContext: React.Context<DataStoreMetaType>;
+declare const DataStoreContext: React$1.Context<DataStoreMetaType>;
 /** Surová mapa dokumentů */
-declare const DataStoreDocumentsContext: React.Context<Record<string, any>>;
+declare const DataStoreDocumentsContext: React$1.Context<Record<string, any>>;
 /** Surová mapa providerů */
-declare const DataStoreProvidersContext: React.Context<Record<string, any>>;
+declare const DataStoreProvidersContext: React$1.Context<Record<string, any>>;
 /** Stabilní action callbacky */
-declare const DataStoreActionsContext: React.Context<DataStoreActionsType>;
+declare const DataStoreActionsContext: React$1.Context<DataStoreActionsType>;
 /** Stabilní datastore API pro provider-scoped subscriptions */
-declare const DataStoreStableContext: React.Context<DataStoreStableType>;
+declare const DataStoreStableContext: React$1.Context<DataStoreStableType>;
 /** Vrací všechny stabilní action callbacky. Komponenty s tímto hookem se nepřerenderují při změnách dokumentů. */
 declare const useDataStoreActions: () => DataStoreActionsType;
 /**
@@ -279,7 +305,7 @@ declare const useDataStoreActions: () => DataStoreActionsType;
  */
 declare const useFilteredDocuments: (filter: Record<string, any>) => {
     documents: any[] | Record<string, any>;
-    setFilter: React.Dispatch<React.SetStateAction<Record<string, any>>>;
+    setFilter: React$1.Dispatch<React$1.SetStateAction<Record<string, any>>>;
 };
 /**
  * Vrati objekt vsech dokumentu
@@ -340,13 +366,14 @@ type DataStoreRef = DataStoreActionsType;
  * 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>>;
+declare const DataStoreProvider: React$1.ForwardRefExoticComponent<DataStoreProps & React$1.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>;
+    layout?: ProviderLayoutType;
     /** Aktualizuje data providera pomocí výchozí update varianty. */
     update: (val: JSONType) => void;
     /** Aktualizuje položku/položky providera s volitelnou variantou a route parametry. */

package/dist/index.js

@@ -1997,6 +1997,79 @@ var DataStoreProvider_default = DataStoreProvider;
 
 // src/useDataProvider.tsx
 import { useCallback as useCallback2, useContext as useContext2, useEffect as useEffect2, useMemo as useMemo2, useState as useState2, useSyncExternalStore } from "react";
+var getDynamicOptionsConfig = (schema) => {
+  if (!schema) return [];
+  const configs = [];
+  Object.entries(schema).forEach(([fieldKey, schemaItem]) => {
+    if (!schemaItem || typeof schemaItem !== "object") return;
+    if (schemaItem.options && !Array.isArray(schemaItem.options) && typeof schemaItem.options === "object" && schemaItem.options.dataProvider) {
+      configs.push({
+        fieldKey,
+        dataProvider: schemaItem.options.dataProvider,
+        optionKeys: schemaItem.options.optionKeys,
+        filter: schemaItem.options.filter
+      });
+      return;
+    }
+    if (schemaItem.dataSource?.dataProvider) {
+      configs.push({
+        fieldKey,
+        dataProvider: schemaItem.dataSource.dataProvider,
+        optionKeys: schemaItem.optionKeys,
+        filter: schemaItem.filter
+      });
+    }
+  });
+  return configs;
+};
+var resolveProviderRef = (providerId, providers, presetProviders, params) => {
+  if (providers[providerId]) {
+    return {
+      templateId: providerId,
+      runtimeId: providerId
+    };
+  }
+  if (presetProviders[providerId]) {
+    const renderedProvider = renderJSONTemplate(presetProviders[providerId], params ?? void 0);
+    return {
+      templateId: providerId,
+      runtimeId: renderedProvider.id
+    };
+  }
+  return {
+    templateId: providerId,
+    runtimeId: providerId
+  };
+};
+var createOptionFromDocument = (doc, optionKeys) => {
+  const valuePath = optionKeys?.value || "id";
+  const optionValue = getValueByDotPath(doc, valuePath, doc.id);
+  const labelDefinition = optionKeys?.label;
+  let optionLabel = "";
+  let optionIcon;
+  if (typeof labelDefinition === "string") {
+    optionLabel = String(getValueByDotPath(doc, labelDefinition, optionValue ?? ""));
+  } else if (labelDefinition && typeof labelDefinition === "object") {
+    const labelPath = labelDefinition.title || "name";
+    optionLabel = String(getValueByDotPath(doc, labelPath, optionValue ?? ""));
+    if (labelDefinition.icon) {
+      optionIcon = getValueByDotPath(doc, labelDefinition.icon);
+    }
+  } else {
+    optionLabel = String(optionValue ?? "");
+  }
+  if (optionIcon) {
+    return {
+      value: optionValue,
+      label: optionLabel,
+      icon: optionIcon
+    };
+  }
+  return {
+    value: optionValue,
+    label: optionLabel
+  };
+};
 var useDataProvider = (id, params, dataFilter, settings) => {
   const [providerId, setProviderId] = useState2(null);
   const [filter, setFilter] = useState2(null);
@@ -2024,6 +2097,37 @@ var useDataProvider = (id, params, dataFilter, settings) => {
     }, [providerId, getProviderLastUpdate]),
     () => null
   );
+  const dependentProviders = useMemo2(() => {
+    const providers = getExternalProviders();
+    if (!providerId || !providers[providerId]?.schema) return [];
+    const schema = providers[providerId]?.schema;
+    const optionConfigs = getDynamicOptionsConfig(schema);
+    const uniqueProviders = {};
+    optionConfigs.forEach((cfg) => {
+      const resolved = resolveProviderRef(cfg.dataProvider, providers, presetProviders, params);
+      if (resolved.runtimeId === providerId) return;
+      uniqueProviders[resolved.runtimeId] = resolved;
+    });
+    return Object.values(uniqueProviders);
+  }, [providerId, providerVersion, getExternalProviders, presetProviders, params]);
+  const dependentProviderVersion = useSyncExternalStore(
+    useCallback2(
+      (onStoreChange) => {
+        if (dependentProviders.length === 0) return () => {
+        };
+        const unsubscribers = dependentProviders.map((providerRef) => subscribeToProvider(providerRef.runtimeId, onStoreChange));
+        return () => {
+          unsubscribers.forEach((unsubscribe) => unsubscribe?.());
+        };
+      },
+      [dependentProviders, subscribeToProvider]
+    ),
+    useCallback2(() => {
+      if (dependentProviders.length === 0) return "";
+      return dependentProviders.map((providerRef) => String(getProviderLastUpdate(providerRef.runtimeId) ?? "")).join("|");
+    }, [dependentProviders, getProviderLastUpdate]),
+    () => ""
+  );
   systemLog("usedp", `${id} - ${providerId}`);
   useEffect2(() => {
     if (id === void 0 || typeof id === "boolean" && id === false) return;
@@ -2063,6 +2167,45 @@ var useDataProvider = (id, params, dataFilter, settings) => {
       }
     };
   }, []);
+  useEffect2(() => {
+    if (dependentProviders.length === 0) return;
+    const currentProviders = getExternalProviders();
+    const incrementedProviders = [];
+    const createdProviders = [];
+    dependentProviders.forEach((providerRef) => {
+      if (providerRef.runtimeId === providerId) return;
+      if (currentProviders[providerRef.runtimeId]) {
+        if (!currentProviders[providerRef.runtimeId]?.isPermanent) {
+          updateProviderListeners(providerRef.runtimeId, 1);
+          incrementedProviders.push(providerRef.runtimeId);
+        }
+        return;
+      }
+      if (!presetProviders[providerRef.templateId]) {
+        systemLog("usedp", "Neznamy provider v schema.options", providerRef.templateId);
+        return;
+      }
+      const renderedProvider = renderJSONTemplate(presetProviders[providerRef.templateId], params ?? void 0);
+      dispatch("registerProvider", renderedProvider);
+      createdProviders.push({
+        templateId: providerRef.templateId,
+        runtimeId: renderedProvider.id
+      });
+    });
+    return () => {
+      incrementedProviders.forEach((id2) => {
+        updateProviderListeners(id2, -1);
+      });
+      if (createdProviders.length === 0) return;
+      const activeProviders = getExternalProviders();
+      createdProviders.forEach((providerRef) => {
+        const presetProvider = presetProviders[providerRef.templateId];
+        if (!presetProvider?.isPermanent && !activeProviders[providerRef.runtimeId]?.isPermanent) {
+          dispatch("unregisterProvider", providerRef.runtimeId);
+        }
+      });
+    };
+  }, [dependentProviders, providerId, getExternalProviders, updateProviderListeners, dispatch, presetProviders, params]);
   const update = (val) => {
     systemLog("usedp", "UPDATUJI: ", providerId, ", data: ", val);
     dispatch("updateDataStore", { id: providerId, data: val });
@@ -2115,16 +2258,61 @@ var useDataProvider = (id, params, dataFilter, settings) => {
       docs = filterDocuments(docs, filter);
       systemLog("usedp", "Konec filteru: ");
     }
+    const schema = providers[providerId].schema;
+    let resolvedSchema = schema;
+    if (schema) {
+      const optionConfigs = getDynamicOptionsConfig(schema);
+      if (optionConfigs.length > 0) {
+        resolvedSchema = { ...schema };
+        optionConfigs.forEach((cfg) => {
+          const providerRef = resolveProviderRef(cfg.dataProvider, providers, presetProviders, params);
+          const optionProvider = providers[providerRef.runtimeId];
+          if (!optionProvider) {
+            systemLog("usedp", "Nenalezen provider pro schema.options", cfg.dataProvider);
+            return;
+          }
+          let optionDocuments = (optionProvider.data || []).map((docId) => {
+            const docData = documents[docId];
+            if (!docData) return null;
+            return {
+              id: docId,
+              ...docData
+            };
+          }).filter((item) => !!item);
+          if (cfg.filter) {
+            optionDocuments = filterDocuments(optionDocuments, cfg.filter);
+          }
+          const computedOptions = optionDocuments.map((item) => createOptionFromDocument(item, cfg.optionKeys));
+          const nextItem = {
+            ...resolvedSchema[cfg.fieldKey],
+            options: computedOptions
+          };
+          resolvedSchema[cfg.fieldKey] = nextItem;
+        });
+      }
+    }
     return {
       ...providers[providerId],
-      data: docs
+      data: docs,
+      schema: resolvedSchema
     };
-  }, [providerId, providerVersion, settings?.document, settings?.documentId, getExternalProviders, getExternalDocuments]);
+  }, [
+    providerId,
+    providerVersion,
+    dependentProviderVersion,
+    settings?.document,
+    settings?.documentId,
+    getExternalProviders,
+    getExternalDocuments,
+    presetProviders,
+    params
+  ]);
   systemLog("usedp", `${providerId} END`);
   return {
     // provider,
     documents: provider.data,
     schema: provider.schema,
+    layout: provider.layout,
     // dispatch,
     update,
     updateItem,