@mgarlik/datastore 0.1.25 → 0.1.27

package/dist/index.d.cts

@@ -4,11 +4,28 @@ import { D as DataStoreStorage } from './storage-D_xv8gFb.cjs';
 
 type formTypes = "textInput" | "select" | "switch" | "dateTime" | "radio";
 
+type RemoteUpdateMode =
+    | "ignore"      // ignorovat změny z databáze
+    | "auto"        // automaticky aktualizovat pole
+    | "notify"      // pouze upozornit uživatele (bez přepsání)
+    | "confirm"     // zeptat se uživatele před přepsáním
+
+/**
+ * Režim odesílání formuláře, který určuje, kdy se data odešlou. Může být nastaven na "submit" (výchozí), "onBlur", "onChange", "onValid" nebo na objekt s režimem "debounce" a volitelným zpožděním v milisekundách. Tento režim umožňuje přizpůsobit chování odesílání formuláře podle potřeb aplikace a uživatelských preferencí.    
+ */
+type SubmitMode =
+    | "onSubmit"
+    | "onBlur"
+    | "onChange"
+    | "onValid"
+    | { mode: "debounce"; delay?: number };
+
+
 type textInputProps = {
     placeholder?: string;
     multiline?: boolean;
     numberOfLines?: number;
-    secure: boolean;
+    secure?: boolean;
 };
 
 type switchProps = {
@@ -120,6 +137,19 @@ type ProviderLayoutType = {
     title?: string;
     variant?: "grouped" | "insetGrouped" | "plain";
     tooltip?: string | React.ReactNode;
+    /**
+ * Režim odesílání formuláře, který určuje, kdy se data odešlou. Může být nastaven na "submit" (výchozí), "onBlur", "onChange", "onValid" nebo na objekt s režimem "debounce" a volitelným zpožděním v milisekundách. Tento režim umožňuje přizpůsobit chování odesílání formuláře podle potřeb aplikace a uživatelských preferencí.    
+ * 
+ * @type "submit" | "onBlur" | "onChange" | "onValid" | { mode: "debounce"; delay?: number }
+ * 
+ * - "submit": Odeslat pouze při stisknutí tlačítka submit. Toto je výchozí chování, které zajišťuje, že data se odešlou pouze tehdy, když uživatel explicitně dokončí úpravy a potvrdí je. Tlacitko submit může být povoleno pouze v případě, že formulář je validní a obsahuje změny (dirty). Toto nastavení minimalizuje riziko nechtěného odeslání dat a poskytuje uživateli jasnou kontrolu nad tím, kdy se data odešlou.
+ * - "onBlur": Odeslat po opuštění pole (onBlur). Data se odešlou, když uživatel opustí pole, což může být užitečné pro rychlé ukládání změn bez nutnosti explicitního potvrzení. Toto nastavení umožňuje průběžné ukládání dat, ale může vést k častějším odesláním, zejména pokud uživatel často přepíná mezi poli.
+ * - "onChange": Odeslat při jakékoliv změně (onChange). Data se odešlou okamžitě po každé změně hodnoty v poli. Toto nastavení poskytuje nejrychlejší zpětnou vazbu a zajišťuje, že data jsou vždy aktuální, ale může způsobit nadměrné odesílání dat, zejména u polí s častými změnami (např. textová pole).
+ * -    "onValid": Odeslat jakmile je formulář validní (bez ohledu na blur/change). Data se odešlou, jakmile celý formulář splní validační pravidla, bez ohledu na to, zda uživatel opustil pole nebo provedl změnu. Toto nastavení zajišťuje, že data se odešlou pouze tehdy, když jsou platná, ale může být méně předvídatelné pro uživatele, protože odesílání není vázáno na konkrétní akci.
+ * - { mode: "debounce"; delay?: number }: Odeslat při změně s zpožděním (debounce). Data se odešlou po určitém zpoždění od poslední změny, což pomáhá snížit počet odesílání u polí s častými změnami. Toto nastavení je užitečné pro optimalizaci výkonu a minimalizaci zbytečných odesílání, zejména u textových polí, kde uživatel může rychle zadávat data.
+ */
+    submitMode?: SubmitMode;
+    remoteUpdateMode?: RemoteUpdateMode;
     sections?: {
         id?: string;
         title?: string;
@@ -129,14 +159,20 @@ type ProviderLayoutType = {
         visible?: boolean | filterType;
         items: Array<string | {
             field: string;
-            form?: formType;
+            form?: formType | { type: FormTypes; props?: any };
             label?: string; // jen override
+            editable?: boolean;
             visible?: boolean | filterType;
             tooltip?: string | React.ReactNode;
+            /**
+             * Přepíše submitMode formuláře pro toto konkrétní pole.
+             * Pokud není uvedeno, použije se submitMode formuláře.
+            */
+            submitMode?: SubmitMode;
+            render?: (params: { item: any; onChange: (value: any) => void; value: any; editorState: FormStateType }) => React.ReactNode;
         }>;
     }[];
 };
-type ProviderLayoutsType = { [key: string]: ProviderLayoutType };
 
 type BasicProviderSchemaItemType = {
     /**

package/dist/index.d.ts

@@ -4,11 +4,28 @@ import { D as DataStoreStorage } from './storage-D_xv8gFb.js';
 
 type formTypes = "textInput" | "select" | "switch" | "dateTime" | "radio";
 
+type RemoteUpdateMode =
+    | "ignore"      // ignorovat změny z databáze
+    | "auto"        // automaticky aktualizovat pole
+    | "notify"      // pouze upozornit uživatele (bez přepsání)
+    | "confirm"     // zeptat se uživatele před přepsáním
+
+/**
+ * Režim odesílání formuláře, který určuje, kdy se data odešlou. Může být nastaven na "submit" (výchozí), "onBlur", "onChange", "onValid" nebo na objekt s režimem "debounce" a volitelným zpožděním v milisekundách. Tento režim umožňuje přizpůsobit chování odesílání formuláře podle potřeb aplikace a uživatelských preferencí.    
+ */
+type SubmitMode =
+    | "onSubmit"
+    | "onBlur"
+    | "onChange"
+    | "onValid"
+    | { mode: "debounce"; delay?: number };
+
+
 type textInputProps = {
     placeholder?: string;
     multiline?: boolean;
     numberOfLines?: number;
-    secure: boolean;
+    secure?: boolean;
 };
 
 type switchProps = {
@@ -120,6 +137,19 @@ type ProviderLayoutType = {
     title?: string;
     variant?: "grouped" | "insetGrouped" | "plain";
     tooltip?: string | React.ReactNode;
+    /**
+ * Režim odesílání formuláře, který určuje, kdy se data odešlou. Může být nastaven na "submit" (výchozí), "onBlur", "onChange", "onValid" nebo na objekt s režimem "debounce" a volitelným zpožděním v milisekundách. Tento režim umožňuje přizpůsobit chování odesílání formuláře podle potřeb aplikace a uživatelských preferencí.    
+ * 
+ * @type "submit" | "onBlur" | "onChange" | "onValid" | { mode: "debounce"; delay?: number }
+ * 
+ * - "submit": Odeslat pouze při stisknutí tlačítka submit. Toto je výchozí chování, které zajišťuje, že data se odešlou pouze tehdy, když uživatel explicitně dokončí úpravy a potvrdí je. Tlacitko submit může být povoleno pouze v případě, že formulář je validní a obsahuje změny (dirty). Toto nastavení minimalizuje riziko nechtěného odeslání dat a poskytuje uživateli jasnou kontrolu nad tím, kdy se data odešlou.
+ * - "onBlur": Odeslat po opuštění pole (onBlur). Data se odešlou, když uživatel opustí pole, což může být užitečné pro rychlé ukládání změn bez nutnosti explicitního potvrzení. Toto nastavení umožňuje průběžné ukládání dat, ale může vést k častějším odesláním, zejména pokud uživatel často přepíná mezi poli.
+ * - "onChange": Odeslat při jakékoliv změně (onChange). Data se odešlou okamžitě po každé změně hodnoty v poli. Toto nastavení poskytuje nejrychlejší zpětnou vazbu a zajišťuje, že data jsou vždy aktuální, ale může způsobit nadměrné odesílání dat, zejména u polí s častými změnami (např. textová pole).
+ * -    "onValid": Odeslat jakmile je formulář validní (bez ohledu na blur/change). Data se odešlou, jakmile celý formulář splní validační pravidla, bez ohledu na to, zda uživatel opustil pole nebo provedl změnu. Toto nastavení zajišťuje, že data se odešlou pouze tehdy, když jsou platná, ale může být méně předvídatelné pro uživatele, protože odesílání není vázáno na konkrétní akci.
+ * - { mode: "debounce"; delay?: number }: Odeslat při změně s zpožděním (debounce). Data se odešlou po určitém zpoždění od poslední změny, což pomáhá snížit počet odesílání u polí s častými změnami. Toto nastavení je užitečné pro optimalizaci výkonu a minimalizaci zbytečných odesílání, zejména u textových polí, kde uživatel může rychle zadávat data.
+ */
+    submitMode?: SubmitMode;
+    remoteUpdateMode?: RemoteUpdateMode;
     sections?: {
         id?: string;
         title?: string;
@@ -129,14 +159,20 @@ type ProviderLayoutType = {
         visible?: boolean | filterType;
         items: Array<string | {
             field: string;
-            form?: formType;
+            form?: formType | { type: FormTypes; props?: any };
             label?: string; // jen override
+            editable?: boolean;
             visible?: boolean | filterType;
             tooltip?: string | React.ReactNode;
+            /**
+             * Přepíše submitMode formuláře pro toto konkrétní pole.
+             * Pokud není uvedeno, použije se submitMode formuláře.
+            */
+            submitMode?: SubmitMode;
+            render?: (params: { item: any; onChange: (value: any) => void; value: any; editorState: FormStateType }) => React.ReactNode;
         }>;
     }[];
 };
-type ProviderLayoutsType = { [key: string]: ProviderLayoutType };
 
 type BasicProviderSchemaItemType = {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mgarlik/datastore",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "description": "Full DataStoreProvider package extracted from src/dataStore with REST and Socket support.",
   "license": "MIT",
   "type": "module",