@donotdev/ui 0.0.9 → 0.0.10

package/dist/utils/index.d.ts

@@ -8,6 +8,7 @@
  */
 export * from './assetResolver';
 export * from './useAuthSafe';
+export * from './useFormStoreSafe';
 export * from './useAuthVisibility';
 export * from './useStripeBillingSafe';
 export * from './useBillingVisibility';

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}

package/dist/utils/index.js

@@ -9,6 +9,7 @@
  */
 export * from './assetResolver';
 export * from './useAuthSafe';
+export * from './useFormStoreSafe';
 export * from './useAuthVisibility';
 export * from './useStripeBillingSafe';
 export * from './useBillingVisibility';

package/dist/utils/useFormStoreSafe.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Degraded FormStore state - returned when CRUD package not installed
+ * Matches FormStoreState & FormStoreActions interface
+ */
+declare const DEGRADED_FORM_STORE_STATE: {
+    readonly forms: {};
+    readonly startSubmit: () => void;
+    readonly setUploading: () => void;
+    readonly setValidating: () => void;
+    readonly setSubmitting: () => void;
+    readonly setSuccess: () => void;
+    readonly setError: () => void;
+    readonly reset: () => void;
+    readonly cleanup: () => void;
+    readonly setIsDirty: () => void;
+    readonly hasDirtyForms: () => boolean;
+    readonly getDirtyFormIds: () => never[];
+    readonly getStatus: () => "idle";
+    readonly isLoading: () => boolean;
+    readonly getUploadProgress: () => number;
+    readonly getError: () => null;
+    readonly getIsDirty: () => boolean;
+};
+/**
+ * Check if FormStore is available
+ */
+export declare const isFormStoreAvailable: boolean;
+/**
+ * Safe access to FormStore.
+ * Returns degraded state selector result if CRUD package not installed.
+ *
+ * @param selector - Zustand selector function
+ * @returns Selected state, or degraded state selection if CRUD not available
+ *
+ * @example
+ * ```tsx
+ * const hasDirtyForms = useFormStoreSafe((state) => state.hasDirtyForms());
+ * // Always safe to call - returns false when degraded
+ * ```
+ */
+export declare function useFormStoreSafe<T>(selector: (state: any) => T): T;
+export declare namespace useFormStoreSafe {
+    var getState: () => typeof DEGRADED_FORM_STORE_STATE;
+}
+/**
+ * Check if any forms are dirty (safe version).
+ * Returns false if CRUD package not available.
+ */
+export declare function useHasDirtyFormsSafe(): boolean;
+/**
+ * Check if navigation should be blocked (safe version).
+ * Returns a function that checks FormStore and shows confirmation if needed.
+ *
+ * @param message - Confirmation message
+ * @returns Promise<boolean> - true if navigation should proceed
+ */
+export declare function checkFormNavigationSafe(message?: string): Promise<boolean>;
+export {};
+//# sourceMappingURL=useFormStoreSafe.d.ts.map

package/dist/utils/useFormStoreSafe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormStoreSafe.d.ts","sourceRoot":"","sources":["../../src/utils/useFormStoreSafe.ts"],"names":[],"mappings":"AA8BA;;;GAGG;AACH,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;CAqBrB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,oBAAoB,SAAyC,CAAC;AAE3E;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAKlE;yBALe,gBAAgB;wBAmBA,OAAO,yBAAyB;;AAOhE;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAG9C;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,SAA4C,GAClD,OAAO,CAAC,OAAO,CAAC,CAUlB"}

package/dist/utils/useFormStoreSafe.js

@@ -0,0 +1,115 @@
+// packages/ui/src/utils/useFormStoreSafe.ts
+/**
+ * @fileoverview Safe FormStore access for graceful degradation
+ * @description Provides FormStore functionality when @donotdev/crud is installed,
+ * gracefully degrades when not installed.
+ *
+ * ## CRITICAL: DO NOT USE DYNAMIC IMPORTS
+ *
+ * This file MUST use sync `import * as crudModule from '@donotdev/crud'`
+ * at module level. DO NOT refactor to use async `import('@donotdev/crud').then(...)`.
+ *
+ * @see packages/ui/src/utils/useAuthSafe.ts for pattern reference
+ * @see docs/development/GRACEFUL_DEGRADATION.md
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import * as crudModule from '@donotdev/crud';
+// Sync import - bundler aliases to empty module if not installed
+// Decision made ONCE at module load time, never changes
+// Extract useFormStore if available (undefined if package not installed/aliased)
+// Zustand stores have both the hook and getState method
+const realUseFormStore = crudModule?.useFormStore;
+/**
+ * Degraded FormStore state - returned when CRUD package not installed
+ * Matches FormStoreState & FormStoreActions interface
+ */
+const DEGRADED_FORM_STORE_STATE = {
+    forms: {},
+    // State transitions (no-ops)
+    startSubmit: () => { },
+    setUploading: () => { },
+    setValidating: () => { },
+    setSubmitting: () => { },
+    setSuccess: () => { },
+    setError: () => { },
+    reset: () => { },
+    cleanup: () => { },
+    // Dirty state management
+    setIsDirty: () => { },
+    hasDirtyForms: () => false, // Key method - returns false when degraded
+    getDirtyFormIds: () => [],
+    // Getters
+    getStatus: () => 'idle',
+    isLoading: () => false,
+    getUploadProgress: () => 0,
+    getError: () => null,
+    getIsDirty: () => false,
+};
+/**
+ * Check if FormStore is available
+ */
+export const isFormStoreAvailable = typeof realUseFormStore === 'function';
+/**
+ * Safe access to FormStore.
+ * Returns degraded state selector result if CRUD package not installed.
+ *
+ * @param selector - Zustand selector function
+ * @returns Selected state, or degraded state selection if CRUD not available
+ *
+ * @example
+ * ```tsx
+ * const hasDirtyForms = useFormStoreSafe((state) => state.hasDirtyForms());
+ * // Always safe to call - returns false when degraded
+ * ```
+ */
+export function useFormStoreSafe(selector) {
+    if (realUseFormStore) {
+        return realUseFormStore(selector);
+    }
+    return selector(DEGRADED_FORM_STORE_STATE);
+}
+/**
+ * Get FormStore state directly (non-hook version).
+ * Use this in non-React contexts or for one-time checks.
+ *
+ * @returns FormStore state, or degraded state if CRUD not available
+ *
+ * @example
+ * ```tsx
+ * const state = useFormStoreSafe.getState();
+ * const hasDirty = state.hasDirtyForms(); // Always safe to call
+ * ```
+ */
+useFormStoreSafe.getState = () => {
+    if (realUseFormStore && typeof realUseFormStore.getState === 'function') {
+        return realUseFormStore.getState();
+    }
+    return DEGRADED_FORM_STORE_STATE;
+};
+/**
+ * Check if any forms are dirty (safe version).
+ * Returns false if CRUD package not available.
+ */
+export function useHasDirtyFormsSafe() {
+    const hasDirtyForms = useFormStoreSafe((state) => state.hasDirtyForms());
+    return hasDirtyForms();
+}
+/**
+ * Check if navigation should be blocked (safe version).
+ * Returns a function that checks FormStore and shows confirmation if needed.
+ *
+ * @param message - Confirmation message
+ * @returns Promise<boolean> - true if navigation should proceed
+ */
+export async function checkFormNavigationSafe(message = 'You have unsaved changes. Discard them?') {
+    const state = useFormStoreSafe.getState();
+    const hasDirtyForms = state.hasDirtyForms();
+    if (!hasDirtyForms)
+        return true; // No dirty forms = allow navigation
+    if (typeof window !== 'undefined' && window.confirm) {
+        return window.confirm(message);
+    }
+    return true;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donotdev/ui",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "type": "module",
   "private": false,
   "license": "SEE LICENSE IN LICENSE.md",
@@ -55,10 +55,10 @@
     "@donotdev/adv-comps": "^0.0.8",
     "@donotdev/auth": "^0.0.5",
     "@donotdev/billing": "^0.0.5",
-    "@donotdev/components": "^0.0.12",
-    "@donotdev/core": "^0.0.12",
-    "@donotdev/crud": "^0.0.5",
-    "@donotdev/firebase": "^0.0.5",
+    "@donotdev/components": "^0.0.13",
+    "@donotdev/core": "^0.0.17",
+    "@donotdev/crud": "^0.0.8",
+    "@donotdev/firebase": "^0.0.6",
     "@donotdev/oauth": "^0.0.5",
     "firebase": "^12.5.0",
     "lucide-react": "^0.562.0",