@donotdev/ui 0.0.7 → 0.0.9

package/dist/utils/assetResolver.d.ts

@@ -139,5 +139,5 @@ export declare function resolveLogo(customPath?: string): string;
  * @author AMBROISE PARK Consulting
  */
 export declare function resolveFaviconSet(): FaviconSet;
-export default AssetResolver;
+export {};
 //# sourceMappingURL=assetResolver.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"assetResolver.d.ts","sourceRoot":"","sources":["../../src/utils/assetResolver.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,cAAc;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,GAAG,CAAC,EAAE,UAAU,CAAC;KAClB,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,CAAC,EAAE;QACd,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAKD;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAA0B;IAE9C;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,cAAc;IAyC1C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAmBlC;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAYzC;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAM/C;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAKzC;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IAe/C;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAgB/B;;;OAGG;IACH,MAAM,CAAC,iBAAiB,IAAI,UAAU;IA6DtC;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM;IAuB/B;;;OAGG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IASzB;;OAEG;IACH,MAAM,CAAC,YAAY;;;;;;;;CAQpB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAE9C;AAgBD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"assetResolver.d.ts","sourceRoot":"","sources":["../../src/utils/assetResolver.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,cAAc;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,GAAG,CAAC,EAAE,UAAU,CAAC;KAClB,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,CAAC,EAAE;QACd,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAKD;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAA0B;IAE9C;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,cAAc;IAyC1C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAmBlC;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAYzC;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAM/C;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAKzC;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IAe/C;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAgB/B;;;OAGG;IACH,MAAM,CAAC,iBAAiB,IAAI,UAAU;IA6DtC;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM;IAuB/B;;;OAGG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IASzB;;OAEG;IACH,MAAM,CAAC,YAAY;;;;;;;;CAQpB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAE9C"}

package/dist/utils/assetResolver.js

@@ -287,5 +287,4 @@ if (isDev()) {
         });
     }
 }
-// Re-export for convenience
-export default AssetResolver;
+// Named export only (no default export needed)

package/dist/utils/index.d.ts

@@ -11,7 +11,6 @@ export * from './useAuthSafe';
 export * from './useAuthVisibility';
 export * from './useStripeBillingSafe';
 export * from './useBillingVisibility';
-export * from './useCrudSafe';
 export * from './useOAuthSafe';
 export * from './tList';
 //# sourceMappingURL=index.d.ts.map

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;AACvC,cAAc,eAAe,CAAC;AAC9B,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,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}

package/dist/utils/index.js

@@ -12,6 +12,5 @@ export * from './useAuthSafe';
 export * from './useAuthVisibility';
 export * from './useStripeBillingSafe';
 export * from './useBillingVisibility';
-export * from './useCrudSafe';
 export * from './useOAuthSafe';
 export * from './tList';

package/dist/utils/tList.d.ts

@@ -1,5 +1,5 @@
-import type { LucideIcon } from 'lucide-react';
 import type { TFunction } from 'i18next';
+import type { LucideIcon } from 'lucide-react';
 import type { ReactNode } from 'react';
 /**
  * Renders a translated array as a List with optional icon

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

@@ -1 +1 @@
-{"version":3,"file":"tList.d.ts","sourceRoot":"","sources":["../../src/utils/tList.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAevC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,KAAK,CACnB,CAAC,EAAE,SAAS,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,UAAU,GAAG,IAAmB,EACtC,IAAI,GAAE,MAAqB,GAC1B,SAAS,CAUX"}
+{"version":3,"file":"tList.d.ts","sourceRoot":"","sources":["../../src/utils/tList.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAYvC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,KAAK,CACnB,CAAC,EAAE,SAAS,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,UAAU,GAAG,IAAmB,EACtC,IAAI,GAAE,MAAqB,GAC1B,SAAS,CAUX"}

package/dist/utils/useAuthSafe.d.ts

@@ -1,36 +1,3 @@
-/**
- * @fileoverview Safe useAuth wrapper for graceful degradation
- * @description Provides auth functionality when @donotdev/auth is installed,
- * gracefully degrades to no-op when not installed.
- *
- * ## CRITICAL: DO NOT USE DYNAMIC IMPORTS
- *
- * This file MUST use sync `import * as authModule from '@donotdev/auth'`
- * at module level. DO NOT refactor to use async `import('@donotdev/auth').then(...)`.
- *
- * ### Why sync import is required:
- *
- * 1. **Bundler aliasing**: Vite/webpack alias missing packages to empty modules
- *    at BUILD TIME. The import completes immediately (no async).
- *
- * 2. **Rules of Hooks**: If we use async dynamic import:
- *    - First render: `realUseAuth = null` → uses stub (0 hooks)
- *    - Async completes: `realUseAuth = useAuth` → now has hooks
- *    - Next render: React sees different hook count → CRASH
- *
- * 3. **Monorepo gotcha**: Dynamic imports resolve workspace packages even when
- *    the consuming app doesn't have them as dependencies. This causes the
- *    real hook to activate unexpectedly → Rules of Hooks violation.
- *
- * 4. **Decision is immutable**: With sync import, `authModule?.useAuth` is
- *    evaluated ONCE at module load. It's either the real hook or undefined.
- *    This never changes during the app lifecycle.
- *
- * @see docs/development/GRACEFUL_DEGRADATION.md
- * @version 0.0.4
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
 import type { AuthAPI } from '@donotdev/core';
 /**
  * Safe wrapper for useAuth hook.

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

@@ -1 +1 @@
-{"version":3,"file":"useAuthSafe.d.ts","sourceRoot":"","sources":["../../src/utils/useAuthSafe.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAoB9C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAKvE;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,SAAoC,CAAC"}
+{"version":3,"file":"useAuthSafe.d.ts","sourceRoot":"","sources":["../../src/utils/useAuthSafe.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAmB9C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAKvE;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,SAAoC,CAAC"}

package/dist/utils/useAuthSafe.js

@@ -1,8 +1,41 @@
 // packages/ui/src/utils/useAuthSafe.ts
+/**
+ * @fileoverview Safe useAuth wrapper for graceful degradation
+ * @description Provides auth functionality when @donotdev/auth is installed,
+ * gracefully degrades to no-op when not installed.
+ *
+ * ## CRITICAL: DO NOT USE DYNAMIC IMPORTS
+ *
+ * This file MUST use sync `import * as authModule from '@donotdev/auth'`
+ * at module level. DO NOT refactor to use async `import('@donotdev/auth').then(...)`.
+ *
+ * ### Why sync import is required:
+ *
+ * 1. **Bundler aliasing**: Vite/webpack alias missing packages to empty modules
+ *    at BUILD TIME. The import completes immediately (no async).
+ *
+ * 2. **Rules of Hooks**: If we use async dynamic import:
+ *    - First render: `realUseAuth = null` → uses stub (0 hooks)
+ *    - Async completes: `realUseAuth = useAuth` → now has hooks
+ *    - Next render: React sees different hook count → CRASH
+ *
+ * 3. **Monorepo gotcha**: Dynamic imports resolve workspace packages even when
+ *    the consuming app doesn't have them as dependencies. This causes the
+ *    real hook to activate unexpectedly → Rules of Hooks violation.
+ *
+ * 4. **Decision is immutable**: With sync import, `authModule?.useAuth` is
+ *    evaluated ONCE at module load. It's either the real hook or undefined.
+ *    This never changes during the app lifecycle.
+ *
+ * @see docs/development/GRACEFUL_DEGRADATION.md
+ * @version 0.0.4
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import * as authModule from '@donotdev/auth';
 import { DEGRADED_AUTH_API } from '@donotdev/core';
 // Sync import - bundler aliases to empty module if not installed
 // Decision made ONCE at module load time, never changes
-import * as authModule from '@donotdev/auth';
 // Extract useAuth if available (undefined if package not installed/aliased)
 const realUseAuth = authModule?.useAuth;
 /**

package/dist/utils/useCrudSafe.d.ts

@@ -1,8 +1,11 @@
-import type { CrudAPI, dndevSchema } from '@donotdev/core';
+import type { CrudAPI, dndevSchema, Entity } from '@donotdev/core';
 type BackendType = 'firestore' | 'functions';
-interface UseCrudOptions<T> {
+interface UseCrudSafeOptions<T> {
     backend?: BackendType;
     schema?: dndevSchema<T>;
+    entity?: Entity;
+    staleTime?: number;
+    noCache?: boolean;
 }
 /**
  * Safe wrapper for useCrud hook.
@@ -10,17 +13,20 @@ interface UseCrudOptions<T> {
  * - If @donotdev/crud installed → uses real hook (handles Firebase/consent internally)
  * - If not installed → returns degraded API values
  *
- * @param collection - Collection name
+ * @param entityOrCollection - Entity definition or collection name
  * @param options - Options including backend type and schema
  * @returns CRUD operations and state, or degraded API if crud unavailable
  *
  * @example
  * ```typescript
- * const crud = useCrudSafe('users', { backend: 'firestore', schema: UserSchema });
- * const { data, status, error, get, set } = crud;
+ * // With entity
+ * const { add, update } = useCrudSafe(carEntity);
+ *
+ * // With collection string
+ * const { get, set } = useCrudSafe('users', { schema: UserSchema });
  * ```
  */
-export declare function useCrudSafe<T = unknown>(collection: string, options?: UseCrudOptions<T>): CrudAPI<T>;
+export declare function useCrudSafe<T = unknown>(entityOrCollection: Entity | string, options?: UseCrudSafeOptions<T>): CrudAPI<T>;
 /**
  * Check if CRUD module is available (for conditional UI rendering)
  */

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

@@ -1 +1 @@
-{"version":3,"file":"useCrudSafe.d.ts","sourceRoot":"","sources":["../../src/utils/useCrudSafe.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAK3D,KAAK,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;AAE7C,UAAU,cAAc,CAAC,CAAC;IACxB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CACzB;AAeD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EACrC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,cAAc,CAAC,CAAC,CAAM,GAC9B,OAAO,CAAC,CAAC,CAAC,CAKZ;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,SAAoC,CAAC"}
+{"version":3,"file":"useCrudSafe.d.ts","sourceRoot":"","sources":["../../src/utils/useCrudSafe.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAInE,KAAK,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;AAE7C,UAAU,kBAAkB,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAkBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EACrC,kBAAkB,EAAE,MAAM,GAAG,MAAM,EACnC,OAAO,GAAE,kBAAkB,CAAC,CAAC,CAAM,GAClC,OAAO,CAAC,CAAC,CAAC,CAKZ;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,SAAoC,CAAC"}

package/dist/utils/useCrudSafe.js

@@ -2,7 +2,8 @@
 /**
  * @fileoverview Safe useCrud wrapper for graceful degradation
  * @description Provides CRUD functionality when @donotdev/crud is installed,
- * gracefully degrades to no-op when not installed.
+ * gracefully degrades to no-op when not installed. This is the recommended
+ * way to use CRUD in optional/plugin contexts.
  *
  * ## CRITICAL: DO NOT USE DYNAMIC IMPORTS
  *
@@ -28,7 +29,7 @@
  *    This never changes during the app lifecycle.
  *
  * @see docs/development/GRACEFUL_DEGRADATION.md
- * @version 0.0.4
+ * @version 0.0.6
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
@@ -49,19 +50,22 @@ function useCrudStub() {
  * - If @donotdev/crud installed → uses real hook (handles Firebase/consent internally)
  * - If not installed → returns degraded API values
  *
- * @param collection - Collection name
+ * @param entityOrCollection - Entity definition or collection name
  * @param options - Options including backend type and schema
  * @returns CRUD operations and state, or degraded API if crud unavailable
  *
  * @example
  * ```typescript
- * const crud = useCrudSafe('users', { backend: 'firestore', schema: UserSchema });
- * const { data, status, error, get, set } = crud;
+ * // With entity
+ * const { add, update } = useCrudSafe(carEntity);
+ *
+ * // With collection string
+ * const { get, set } = useCrudSafe('users', { schema: UserSchema });
  * ```
  */
-export function useCrudSafe(collection, options = {}) {
+export function useCrudSafe(entityOrCollection, options = {}) {
     if (realUseCrud) {
-        return realUseCrud(collection, options);
+        return realUseCrud(entityOrCollection, options);
     }
     return useCrudStub();
 }

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

@@ -1 +1 @@
-{"version":3,"file":"useOAuthSafe.d.ts","sourceRoot":"","sources":["../../src/utils/useOAuthSafe.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAkB/C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAK1E;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,SAAqC,CAAC"}
+{"version":3,"file":"useOAuthSafe.d.ts","sourceRoot":"","sources":["../../src/utils/useOAuthSafe.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAiB/C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAK1E;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,SAAqC,CAAC"}

package/dist/utils/useStripeBillingSafe.d.ts

@@ -1,38 +1,5 @@
-/**
- * @fileoverview Safe useStripeBilling wrapper for graceful degradation
- * @description Provides billing functionality when @donotdev/billing is installed,
- * gracefully degrades to no-op when not installed.
- *
- * ## CRITICAL: DO NOT USE DYNAMIC IMPORTS
- *
- * This file MUST use sync `import * as billingModule from '@donotdev/billing'`
- * at module level. DO NOT refactor to use async `import('@donotdev/billing').then(...)`.
- *
- * ### Why sync import is required:
- *
- * 1. **Bundler aliasing**: Vite/webpack alias missing packages to empty modules
- *    at BUILD TIME. The import completes immediately (no async).
- *
- * 2. **Rules of Hooks**: If we use async dynamic import:
- *    - First render: `realUseStripeBilling = null` → uses stub (0 hooks)
- *    - Async completes: `realUseStripeBilling = useStripeBilling` → now has hooks
- *    - Next render: React sees different hook count → CRASH
- *
- * 3. **Monorepo gotcha**: Dynamic imports resolve workspace packages even when
- *    the consuming app doesn't have them as dependencies. This causes the
- *    real hook to activate unexpectedly → Rules of Hooks violation.
- *
- * 4. **Decision is immutable**: With sync import, `billingModule?.useStripeBilling`
- *    is evaluated ONCE at module load. It's either the real hook or undefined.
- *    This never changes during the app lifecycle.
- *
- * @see docs/development/GRACEFUL_DEGRADATION.md
- * @version 0.0.4
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-import type { BillingAPI } from '@donotdev/core';
 import type { BillingAuthState } from '@donotdev/billing';
+import type { BillingAPI } from '@donotdev/core';
 export type { BillingAuthState } from '@donotdev/billing';
 /**
  * Safe wrapper for useStripeBilling hook.

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

@@ -1 +1 @@
-{"version":3,"file":"useStripeBillingSafe.d.ts","sourceRoot":"","sources":["../../src/utils/useStripeBillingSafe.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAIjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAoB1D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,UAAU,EAC7D,GAAG,EAAE,CAAC,EACN,SAAS,CAAC,EAAE,gBAAgB,GAC3B,UAAU,CAAC,CAAC,CAAC,CAKf;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,SAA6C,CAAC"}
+{"version":3,"file":"useStripeBillingSafe.d.ts","sourceRoot":"","sources":["../../src/utils/useStripeBillingSafe.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAIjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAoB1D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,UAAU,EAC7D,GAAG,EAAE,CAAC,EACN,SAAS,CAAC,EAAE,gBAAgB,GAC3B,UAAU,CAAC,CAAC,CAAC,CAKf;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,SAA6C,CAAC"}

package/dist/utils/useStripeBillingSafe.js

@@ -1,6 +1,39 @@
 // packages/ui/src/utils/useStripeBillingSafe.ts
-import { DEGRADED_BILLING_API } from '@donotdev/core';
+/**
+ * @fileoverview Safe useStripeBilling wrapper for graceful degradation
+ * @description Provides billing functionality when @donotdev/billing is installed,
+ * gracefully degrades to no-op when not installed.
+ *
+ * ## CRITICAL: DO NOT USE DYNAMIC IMPORTS
+ *
+ * This file MUST use sync `import * as billingModule from '@donotdev/billing'`
+ * at module level. DO NOT refactor to use async `import('@donotdev/billing').then(...)`.
+ *
+ * ### Why sync import is required:
+ *
+ * 1. **Bundler aliasing**: Vite/webpack alias missing packages to empty modules
+ *    at BUILD TIME. The import completes immediately (no async).
+ *
+ * 2. **Rules of Hooks**: If we use async dynamic import:
+ *    - First render: `realUseStripeBilling = null` → uses stub (0 hooks)
+ *    - Async completes: `realUseStripeBilling = useStripeBilling` → now has hooks
+ *    - Next render: React sees different hook count → CRASH
+ *
+ * 3. **Monorepo gotcha**: Dynamic imports resolve workspace packages even when
+ *    the consuming app doesn't have them as dependencies. This causes the
+ *    real hook to activate unexpectedly → Rules of Hooks violation.
+ *
+ * 4. **Decision is immutable**: With sync import, `billingModule?.useStripeBilling`
+ *    is evaluated ONCE at module load. It's either the real hook or undefined.
+ *    This never changes during the app lifecycle.
+ *
+ * @see docs/development/GRACEFUL_DEGRADATION.md
+ * @version 0.0.4
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
 import * as billingModule from '@donotdev/billing';
+import { DEGRADED_BILLING_API } from '@donotdev/core';
 // Check if real hook exists (will be undefined if Vite aliased to empty module)
 const realUseStripeBilling = billingModule?.useStripeBilling;
 /**

package/dist/vite-routing/AppRoutes.d.ts

@@ -1,4 +1,4 @@
-import { type LayoutConfig } from '@donotdev/core';
+import type { LayoutConfig } from '@donotdev/core';
 /**
  * Route group from useRouteDiscovery
  */

package/dist/vite-routing/AppRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppRoutes.d.ts","sourceRoot":"","sources":["../../src/vite-routing/AppRoutes.tsx"],"names":[],"mappings":"AAoDA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAsFlE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,GAAG,CAAC;QACf,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,UAAU,sBAAsB;IAC9B,4CAA4C;IAC5C,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,yCA8D9D"}
+{"version":3,"file":"AppRoutes.d.ts","sourceRoot":"","sources":["../../src/vite-routing/AppRoutes.tsx"],"names":[],"mappings":"AAoDA,OAAO,KAAK,EAAY,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAyF7D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,GAAG,CAAC;QACf,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,UAAU,sBAAsB;IAC9B,4CAA4C;IAC5C,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,yCA8D9D"}

package/dist/vite-routing/AppRoutes.js

@@ -48,7 +48,6 @@ import { jsx as _jsx } from "react/jsx-runtime";
  */
 import { lazy, Suspense } from 'react';
 import { createBrowserRouter } from 'react-router-dom';
-import {} from '@donotdev/core';
 import { RootLayout } from './RootLayout';
 import Loader from '../components/common/Loader';
 import { AuthGuard } from '../routing/AuthGuard';

package/dist/vite-routing/RootLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RootLayout.d.ts","sourceRoot":"","sources":["../../src/vite-routing/RootLayout.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAuLnD;;GAEG;AACH,UAAU,oBAAoB;IAC5B,2BAA2B;IAC3B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,oBAAoB,2CA6B1D"}
+{"version":3,"file":"RootLayout.d.ts","sourceRoot":"","sources":["../../src/vite-routing/RootLayout.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA0LnD;;GAEG;AACH,UAAU,oBAAoB;IAC5B,2BAA2B;IAC3B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,oBAAoB,2CAgC1D"}

package/dist/vite-routing/RootLayout.js

@@ -12,11 +12,9 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
-import { Suspense, lazy, useEffect, useRef } from 'react';
-import { useLayoutEffect } from 'react';
+import { Suspense, lazy, useEffect, useLayoutEffect, useRef } from 'react';
 import { Outlet, useLocation } from 'react-router-dom';
-import { globalEmitter, isClient } from '@donotdev/core';
-import Loader from '../components/common/Loader';
+import { globalEmitter, isClient, QueryProviders } from '@donotdev/core';
 import { DnDevLayout } from '../internal/layout/DnDevLayout';
 import { UIProviders } from '../internal/providers/UIProviders';
 // Only lazy load non-critical components (not in render path)
@@ -32,6 +30,9 @@ const PWAUpdateNotification = lazy(() => import('../internal/layout/components/P
 const LicenseWatermark = lazy(() => import('../components/license/LicenseWatermark').then((m) => ({
     default: m.LicenseWatermark,
 })));
+const RedirectOverlay = lazy(() => import('../components/common/RedirectOverlay').then((m) => ({
+    default: m.RedirectOverlay,
+})));
 /**
  * CustomScrollRestoration - Scroll restoration for custom scroll containers
  *
@@ -62,7 +63,6 @@ function CustomScrollRestoration() {
             return;
         // Save current scroll position before navigating
         const currentKey = location.key;
-        const currentScroll = mainElement.scrollTop;
         // Check if this is a back/forward navigation (location.state can indicate this)
         // For now, we'll use a simple heuristic: if we have a saved position, it's likely POP
         const savedPosition = scrollPositions.current.get(currentKey);
@@ -206,5 +206,5 @@ function RouteReadySignal({ children }) {
  * @author AMBROISE PARK Consulting
  */
 export function RootLayout({ layout }) {
-    return (_jsxs(UIProviders, { children: [_jsx(Suspense, { fallback: null, children: _jsx(AutoMetaTags, {}) }), _jsxs(FrameworkReadySignal, { children: [_jsx(DnDevLayout, { layout: layout, children: _jsx(RouteReadySignal, { children: _jsx(Outlet, {}) }) }), _jsx(CustomScrollRestoration, {}), _jsxs(Suspense, { fallback: null, children: [_jsx(ConsentBanner, {}), _jsx(PWAUpdateNotification, {}), _jsx(LicenseWatermark, {})] })] })] }));
+    return (_jsx(QueryProviders, { children: _jsxs(UIProviders, { children: [_jsx(Suspense, { fallback: null, children: _jsx(AutoMetaTags, {}) }), _jsxs(FrameworkReadySignal, { children: [_jsx(DnDevLayout, { layout: layout, children: _jsx(RouteReadySignal, { children: _jsx(Outlet, {}) }) }), _jsx(CustomScrollRestoration, {}), _jsxs(Suspense, { fallback: null, children: [_jsx(ConsentBanner, {}), _jsx(PWAUpdateNotification, {}), _jsx(LicenseWatermark, {}), _jsx(RedirectOverlay, {})] })] })] }) }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donotdev/ui",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "type": "module",
   "private": false,
   "license": "SEE LICENSE IN LICENSE.md",
@@ -52,14 +52,14 @@
     "react-hook-form": "^7.71.0"
   },
   "peerDependencies": {
-    "@donotdev/adv-comps": "0.0.7",
-    "@donotdev/auth": "0.0.7",
-    "@donotdev/billing": "0.0.7",
-    "@donotdev/components": "0.0.7",
-    "@donotdev/core": "0.0.7",
-    "@donotdev/crud": "0.0.7",
-    "@donotdev/firebase": "0.0.7",
-    "@donotdev/oauth": "0.0.7",
+    "@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/oauth": "^0.0.5",
     "firebase": "^12.5.0",
     "lucide-react": "^0.562.0",
     "react": "^19.2.3",