@donotdev/core 0.0.18 → 0.0.19

package/server.d.ts

@@ -1089,6 +1089,26 @@ type KeyWithContext<Key, TOpt extends TOptions> = TOpt['context'] extends string
   ? `${Key & string}${_ContextSeparator}${TOpt['context']}`
   : Key;
 
+// helper that maps the configured fallbackNS value to the matching resources slice
+type FallbackResourcesOf<FallbackNS, R> = FallbackNS extends readonly (infer FN)[]
+  ? R[FN & keyof R]
+  : [FallbackNS] extends [false]
+    ? never
+    : R[Extract<FallbackNS, keyof R> & keyof R];
+
+/* reuse the parse helpers as top-level aliases (no nested type declarations) */
+type _PrimaryParse<
+  ActualKey,
+  PrimaryNS extends keyof Resources,
+  TOpt extends TOptions,
+> = ParseTReturn<ActualKey, Resources[PrimaryNS], TOpt>;
+
+type _FallbackParse<ActualKey, FallbackNS, TOpt extends TOptions> = [
+  FallbackResourcesOf<FallbackNS, Resources>,
+] extends [never]
+  ? never
+  : ParseTReturn<ActualKey, FallbackResourcesOf<FallbackNS, Resources>, TOpt>;
+
 type TFunctionReturn<
   Ns extends Namespace,
   Key,
@@ -1098,7 +1118,15 @@ type TFunctionReturn<
 > = $IsResourcesDefined extends true
   ? ActualKey extends `${infer Nsp}${_NsSeparator}${infer RestKey}`
     ? ParseTReturn<RestKey, Resources[Nsp & keyof Resources], TOpt>
-    : ParseTReturn<ActualKey, Resources[$FirstNamespace<ActualNS>], TOpt>
+    : $FirstNamespace<ActualNS> extends infer PrimaryNS
+      ? [PrimaryNS] extends [keyof Resources]
+        ? [_PrimaryParse<ActualKey, PrimaryNS & keyof Resources, TOpt>] extends [never]
+          ? [_FallbackParse<ActualKey, _FallbackNamespace, TOpt>] extends [never]
+            ? DefaultTReturn<TOpt>
+            : _FallbackParse<ActualKey, _FallbackNamespace, TOpt>
+          : _PrimaryParse<ActualKey, PrimaryNS & keyof Resources, TOpt>
+        : never
+      : never
   : DefaultTReturn<TOpt>;
 
 type TFunctionDetailedResult<T = string, TOpt extends TOptions = {}> = {
@@ -1201,17 +1229,24 @@ type KeyPrefix<Ns extends Namespace> = ResourceKeys<true>[$FirstNamespace<Ns>] |
 ///  ↆ selector ↆ  ///
 /// ////////////// ///
 
+type NsArg<Ns extends Namespace> = Ns[number] | readonly Ns[number][];
+
 interface TFunctionSelector<Ns extends Namespace, KPrefix, Source> extends Branded<Ns> {
   <
     Target extends ConstrainTarget<Opts>,
+    const NewNs extends NsArg<Ns> & Namespace,
     const Opts extends SelectorOptions<NewNs>,
-    NewNs extends Namespace,
     NewSrc extends GetSource<NewNs, KPrefix>,
   >(
     selector: SelectorFn<NewSrc, ApplyTarget<Target, Opts>, Opts>,
     options: Opts & InterpolationMap<Target> & { ns: NewNs },
   ): SelectorReturn<Target, Opts>;
-  <Target extends ConstrainTarget<Opts>, const Opts extends SelectorOptions<Ns>>(
+
+  <
+    Target extends ConstrainTarget<Opts>,
+    const NewNs extends NsArg<Ns> = Ns[number],
+    const Opts extends SelectorOptions<NewNs> = SelectorOptions<NewNs>,
+  >(
     selector: SelectorFn<Source, ApplyTarget<Target, Opts>, Opts>,
     options?: Opts & InterpolationMap<Target>,
   ): SelectorReturn<Target, Opts>;
@@ -2023,6 +2058,56 @@ declare function createMetadata(userId: string): {
     _updatedBy: string;
 };
 
+/**
+ * @fileoverview Currency Formatting Utilities
+ * @description Single mapping of ISO 4217 currency codes to locale and symbol. Top ~50 currencies.
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+/** Entry: 3-letter code → locale (for Intl) and display symbol */
+interface CurrencyEntry {
+    locale: string;
+    symbol: string;
+}
+/**
+ * Top ~50 currencies: 3-letter code, locale, symbol.
+ * Unknown codes: getCurrencyLocale → 'en-US', getCurrencySymbol → code as-is.
+ */
+declare const CURRENCY_MAP: Record<string, CurrencyEntry>;
+/**
+ * Returns the locale for a currency code (for Intl formatting).
+ * Unknown codes → 'en-US'.
+ *
+ * @param currencyCode - ISO 4217 currency code (e.g. 'EUR', 'USD')
+ * @returns Locale string
+ */
+declare function getCurrencyLocale(currencyCode: string): string;
+/**
+ * Returns the symbol for a currency code (e.g. EUR → '€').
+ * Unknown codes → code as-is (no validation).
+ *
+ * @param currencyCode - ISO 4217 currency code or any string
+ * @returns Symbol string or the code itself
+ */
+declare function getCurrencySymbol(currencyCode: string): string;
+/**
+ * Format currency value with proper locale based on currency code
+ *
+ * @param value - Numeric value to format
+ * @param currencyCode - ISO 4217 currency code
+ * @param options - Additional Intl.NumberFormat options
+ * @returns Formatted currency string
+ *
+ * @example
+ * ```typescript
+ * formatCurrency(12345, 'EUR') // → "12 345 €"
+ * formatCurrency(12345, 'USD') // → "$12,345"
+ * ```
+ */
+declare function formatCurrency(value: number | null | undefined, currencyCode: string, options?: Intl.NumberFormatOptions): string;
+
 /**
  * @fileoverview Partners Constants
  * @description Constants for partners domain. Defines partner icon mappings and partner-related constants.
@@ -4197,82 +4282,6 @@ interface DndevFrameworkConfig {
     /** Environment variables (VITE_* variables from .env files) */
     env?: Record<string, string>;
 }
-declare global {
-    interface Window {
-        /**
-         * Single source of truth for all DoNotDev framework configuration
-         * @description Set by platform detection and populated by discovery plugins
-         */
-        _DNDEV_CONFIG_?: DndevFrameworkConfig;
-        /**
-         * Global store registry for singleton Zustand stores
-         * @description Ensures single instance across code-split chunks
-         */
-        _DNDEV_STORES_?: Record<string, any>;
-        /** PapaParse CSV parser library (external) */
-        Papa?: {
-            parse: (input: string | File, config?: any) => any;
-            unparse: (data: any[], config?: any) => string;
-        };
-        /** Sentry error tracking library (external) */
-        Sentry?: {
-            captureException: (error: unknown) => void;
-            withScope: (callback: (scope: any) => void) => void;
-            getClient: () => {
-                close: () => Promise<boolean>;
-            } | undefined;
-        };
-        /**
-         * Google APIs (Maps, One Tap, etc.)
-         * @description Unified type for all Google services
-         */
-        google?: {
-            /** Google Maps API */
-            maps?: {
-                places?: {
-                    AutocompleteService: new () => any;
-                    PlacesService: new (element: HTMLElement) => any;
-                    PlacesServiceStatus: {
-                        OK: string;
-                    };
-                };
-                [key: string]: any;
-            };
-            /** Google Identity Services (One Tap) */
-            accounts?: {
-                id?: {
-                    initialize: (config: any) => void;
-                    prompt: (callback?: (notification: any) => void) => void;
-                    cancel?: () => void;
-                    disableAutoSelect?: () => void;
-                };
-            };
-            [key: string]: any;
-        };
-        /** FedCM Identity Credential API */
-        IdentityCredential?: any;
-    }
-    namespace NodeJS {
-        interface ProcessEnv {
-            /** Serialized framework config for Node.js environment */
-            _DNDEV_CONFIG_?: string;
-        }
-    }
-    namespace globalThis {
-        /** Framework configuration (same as window._DNDEV_CONFIG_) */
-        var _DNDEV_CONFIG_: DndevFrameworkConfig | undefined;
-        /** Store registry (same as window._DNDEV_STORES_) */
-        var _DNDEV_STORES_: Record<string, any> | undefined;
-        var __vite_plugin_react_preamble_installed__: boolean | undefined;
-        var __vite_hmr_port: number | undefined;
-        var __NEXT_DATA__: any | undefined;
-        var __REACT_QUERY_CLIENT__: any | undefined;
-        var __REACT_QUERY_PROVIDER__: any | undefined;
-        var __DNDEV_DEBUG: boolean | undefined;
-        var __FIREBASE_DEMO_MODE__: boolean | undefined;
-        var getAvailableThemes: (() => string[]) | undefined;
-    }
-}
 
 /**
  * @fileoverview Billing Constants
@@ -6720,7 +6729,7 @@ declare const DEFAULT_ENTITY_ACCESS: {
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
-declare const FIELD_TYPES: readonly ["address", "array", "avatar", "badge", "boolean", "checkbox", "color", "combobox", "date", "datetime-local", "document", "documents", "email", "file", "files", "gdprConsent", "geopoint", "hidden", "image", "images", "map", "month", "multiselect", "number", "password", "radio", "reference", "range", "reset", "richtext", "select", "submit", "switch", "tel", "text", "textarea", "time", "timestamp", "toggle", "url", "week", "year"];
+declare const FIELD_TYPES: readonly ["address", "array", "avatar", "badge", "boolean", "checkbox", "color", "combobox", "date", "datetime-local", "document", "documents", "email", "file", "files", "gdprConsent", "geopoint", "hidden", "image", "images", "map", "month", "multiselect", "number", "currency", "price", "password", "radio", "reference", "range", "rating", "reset", "richtext", "select", "submit", "switch", "tel", "text", "textarea", "time", "timestamp", "url", "week", "year"];
 
 /**
  * @fileoverview Schema-Related Type Definitions
@@ -6970,6 +6979,12 @@ type FieldTypeToValue = {
     month: string;
     multiselect: string[];
     number: number;
+    price: {
+        amount: number;
+        currency?: string;
+        vatIncluded?: boolean;
+        discountPercent?: number;
+    };
     password: string;
     radio: string;
     reference: string;
@@ -6982,7 +6997,6 @@ type FieldTypeToValue = {
     textarea: string;
     time: string;
     timestamp: string;
-    toggle: boolean;
     switch: string | boolean;
     url: string;
     week: string;
@@ -6997,6 +7011,16 @@ type FieldTypeToValue = {
  * @author AMBROISE PARK Consulting
  */
 type ValueTypeForField<T extends FieldType> = T extends keyof FieldTypeToValue ? FieldTypeToValue[T] : never;
+/**
+ * Any valid field value - includes built-in types plus custom registered types
+ * Uses `unknown` since consumers can register custom field types via RegisterFieldType
+ */
+type AnyFieldValue = unknown;
+/**
+ * Entity record type - a record where values are valid field values
+ * Accepts unknown since consumers can register custom field types
+ */
+type EntityRecord = Record<string, AnyFieldValue>;
 /**
  * Enhanced validation rules with type checking
  * @template T - The field type
@@ -7334,10 +7358,82 @@ interface BaseEntityFields {
      */
     status: EntityField<'select'>;
 }
+/**
+ * Unique key constraint definition for entity deduplication
+ * Enables automatic checking for duplicates on create/update operations
+ *
+ * @example
+ * ```typescript
+ * // Single field unique key with findOrCreate
+ * uniqueKeys: [{ fields: ['email'], findOrCreate: true }]
+ *
+ * // Composite unique key
+ * uniqueKeys: [{ fields: ['vin', 'make'], skipForDrafts: true }]
+ *
+ * // Multiple keys (OR logic - either can identify)
+ * uniqueKeys: [
+ *   { fields: ['email'], findOrCreate: true },
+ *   { fields: ['phone'], findOrCreate: true }
+ * ]
+ * ```
+ *
+ * @version 0.0.1
+ * @since 0.0.5
+ * @author AMBROISE PARK Consulting
+ */
+interface UniqueKeyDefinition {
+    /** Field names that together form the unique key (single or composite) */
+    fields: string[];
+    /** Custom error message when duplicate is found */
+    errorMessage?: string;
+    /** Skip validation for draft documents (default: true) */
+    skipForDrafts?: boolean;
+    /**
+     * Return existing document instead of throwing error on duplicate (default: false)
+     * When true, create operations will return the existing document if a match is found
+     */
+    findOrCreate?: boolean;
+}
+/**
+ * Multi-tenancy scope configuration for entities
+ * Enables automatic scoping of data by tenant/company/workspace
+ *
+ * @example
+ * ```typescript
+ * const clientEntity = defineEntity({
+ *   name: 'Client',
+ *   collection: 'clients',
+ *   scope: { field: 'companyId', provider: 'company' },
+ *   fields: { ... } // No need to manually define companyId
+ * });
+ * ```
+ *
+ * @version 0.0.4
+ * @since 0.0.4
+ * @author AMBROISE PARK Consulting
+ */
+interface ScopeConfig {
+    /**
+     * Field name that stores the scope ID (e.g., 'companyId', 'tenantId', 'workspaceId')
+     * This field will be auto-added to the entity with type 'reference'
+     */
+    field: string;
+    /**
+     * Name of the scope provider registered with registerScopeProvider()
+     * The provider function returns the current scope ID from app state
+     * @example 'company', 'tenant', 'workspace'
+     */
+    provider: string;
+    /**
+     * Collection being referenced (optional, defaults to field name without 'Id' suffix + 's')
+     * @example 'companies' for field 'companyId'
+     */
+    collection?: string;
+}
 /**
  * Definition of a business entity without base fields
  *
- * @version 0.0.3
+ * @version 0.0.4
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
@@ -7352,6 +7448,16 @@ interface BusinessEntity {
      * @default `entity-${name.toLowerCase()}`
      */
     namespace?: string;
+    /**
+     * Multi-tenancy scope configuration (optional)
+     * When set, the scope field is auto-added and CRUD operations auto-inject/filter by scope
+     *
+     * @example
+     * ```typescript
+     * scope: { field: 'companyId', provider: 'company' }
+     * ```
+     */
+    scope?: ScopeConfig;
     /** Field definitions - name and label are required */
     fields: Record<string, EntityField>;
     /** Form configuration for advanced forms */
@@ -7399,12 +7505,39 @@ interface BusinessEntity {
      * ```
      */
     access?: EntityAccessConfig;
+    /**
+     * Unique key constraints for deduplication
+     * Checked during create/update operations
+     *
+     * - Single field: `[{ fields: ['email'] }]`
+     * - Composite: `[{ fields: ['vin', 'make'] }]`
+     * - Multiple keys (OR): `[{ fields: ['email'] }, { fields: ['phone'] }]`
+     *
+     * @example
+     * ```typescript
+     * // Customer: email OR phone identifies (findOrCreate behavior)
+     * uniqueKeys: [
+     *   { fields: ['email'], findOrCreate: true },
+     *   { fields: ['phone'], findOrCreate: true }
+     * ]
+     *
+     * // Car: VIN is unique, skip for drafts
+     * uniqueKeys: [{ fields: ['vin'], skipForDrafts: true }]
+     * ```
+     */
+    uniqueKeys?: UniqueKeyDefinition[];
 }
 /**
  * Complete entity definition including base fields
  * Created by defineEntity() which merges defaults
  *
- * @version 0.0.2
+ * Extends BusinessEntity but overrides optional properties to required:
+ * - namespace: always computed (defaults to `entity-${name.toLowerCase()}`)
+ * - access: always merged with defaults
+ * - fields: includes base fields (id, createdAt, etc.)
+ * - scope: preserved if provided (for multi-tenancy)
+ *
+ * @version 0.0.4
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
@@ -7415,6 +7548,8 @@ interface Entity extends BusinessEntity {
     access: Required<EntityAccessConfig>;
     /** i18n namespace for translations (always present after defineEntity, defaults to `entity-${name.toLowerCase()}`) */
     namespace: string;
+    /** Multi-tenancy scope configuration (preserved from BusinessEntity if provided) */
+    scope?: ScopeConfig;
 }
 /**
  * Unified metadata structure for all schemas (CRUD, Functions, etc.)
@@ -7436,6 +7571,11 @@ interface SchemaMetadata {
         field: string;
         errorMessage?: string;
     }>;
+    /**
+     * Unique key constraints from entity definition
+     * Used by backend CRUD functions for deduplication
+     */
+    uniqueKeys?: UniqueKeyDefinition[];
     /** Custom validation function (for function validation) */
     customValidate?: (data: Record<string, any>, operation: 'create' | 'update') => Promise<void>;
 }
@@ -7638,6 +7778,178 @@ interface ListEntitiesResponse {
     hasMore: boolean;
 }
 
+/**
+ * @fileoverview CRUD Component Props Types
+ * @description Shared prop types for CRUD components used across UI, Templates, and CRUD packages
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+
+interface EntityListProps {
+    /** The entity definition */
+    entity: Entity;
+    /** Current user role (for UI toggle only - backend enforces security) */
+    userRole?: string;
+    /**
+     * Base path for view/edit/create. Default: `/${collection}`.
+     * View/Edit = `${basePath}/${id}`, Create = `${basePath}/new`.
+     */
+    basePath?: string;
+    /**
+     * Called when user clicks a row. If provided, overrides default navigation to basePath/:id (e.g. open sheet).
+     */
+    onClick?: (id: string) => void;
+    /** Hide filters section (default: false) */
+    hideFilters?: boolean;
+    /** Pagination mode: 'client' (default) or 'server' for massive datasets */
+    pagination?: 'client' | 'server';
+    /** Page size - passed to DataTable. If not provided, DataTable uses its default (12) */
+    pageSize?: number;
+    /** Optional query constraints (e.g. where companyId == currentCompanyId) passed to useCrudList */
+    queryOptions?: {
+        where?: Array<{
+            field: string;
+            operator: string;
+            value: unknown;
+        }>;
+        orderBy?: Array<{
+            field: string;
+            direction?: 'asc' | 'desc';
+        }>;
+        limit?: number;
+        startAfterId?: string;
+    };
+}
+interface EntityCardListProps {
+    /** The entity definition */
+    entity: Entity;
+    /**
+     * Base path for view. Default: `/${collection}`. View = `${basePath}/${id}`.
+     */
+    basePath?: string;
+    /**
+     * Called when user clicks a card. If provided, overrides default navigation to basePath/:id (e.g. open sheet).
+     */
+    onClick?: (id: string) => void;
+    /** Grid columns (responsive) - defaults to [1, 2, 3, 4] */
+    cols?: number | [number, number, number, number];
+    /** Cache stale time is ms - defaults to 30 mins */
+    staleTime?: number;
+    /** Optional filter function to filter items client-side */
+    filter?: (item: any) => boolean;
+    /** Hide filters section (default: false) */
+    hideFilters?: boolean;
+}
+interface EntityFormRendererProps<T extends EntityRecord = EntityRecord> {
+    /** Entity definition - pass the full entity from defineEntity() */
+    entity: Entity;
+    /** Form submission handler */
+    onSubmit: (data: T) => void | Promise<void>;
+    /** Translation function */
+    t?: (key: string, options?: Record<string, unknown>) => string;
+    /** Additional CSS classes */
+    className?: string;
+    /** Submit button text */
+    submitText?: string;
+    /**
+     * Whether form data is loading (shows loading overlay)
+     * Use this when fetching existing entity data for edit mode
+     */
+    loading?: boolean;
+    /** Initial form values */
+    defaultValues?: Partial<T>;
+    /** Submit button variant */
+    submitVariant?: 'primary' | 'destructive' | 'outline' | 'ghost' | 'link';
+    /** Secondary button text */
+    secondaryButtonText?: string;
+    /** Secondary button variant */
+    secondaryButtonVariant?: 'primary' | 'destructive' | 'outline' | 'ghost' | 'link';
+    /** Secondary button submission handler */
+    onSecondarySubmit?: (data: T) => void | Promise<void>;
+    /**
+     * Current viewer's role for editability checks
+     * @default 'admin'
+     */
+    viewerRole?: 'public' | 'guest' | 'user' | 'admin' | 'super';
+    /**
+     * Form operation type
+     * @default 'create' (or 'edit' if defaultValues provided)
+     */
+    operation?: 'create' | 'edit';
+    /**
+     * Enable auto-save to localStorage for crash recovery.
+     * @default true for create mode
+     */
+    autoSave?: boolean;
+    /**
+     * Optional form ID for tracking loading state.
+     * If not provided, one will be generated automatically.
+     */
+    formId?: string;
+    /**
+     * Cancel button text. If provided, shows a cancel button.
+     * If not provided but onCancel is provided, shows default "Cancel" text.
+     * Set to null to explicitly hide cancel button.
+     */
+    cancelText?: string | null;
+    /**
+     * Success path - full path to navigate after successful submit (e.g., `/products`).
+     * If not provided, navigates back (optimistic - user came from list, go back there).
+     */
+    successPath?: string;
+    /**
+     * Cancel path - full path (e.g., `/products`). If not provided, navigates back.
+     * If onCancel callback is provided, it takes precedence over cancelPath.
+     */
+    cancelPath?: string;
+    /**
+     * Callback when cancel is clicked (after confirmation if dirty).
+     * If not provided, cancel navigates to cancelPath or `/${collection}`.
+     * If provided, cancel button will show (with cancelText or default "Cancel").
+     */
+    onCancel?: () => void;
+    /**
+     * Whether to show unsaved changes warning when navigating away.
+     * @default true
+     */
+    warnOnUnsavedChanges?: boolean;
+    /**
+     * Custom message for unsaved changes confirmation.
+     */
+    unsavedChangesMessage?: string;
+    /**
+     * Hide visibility indicators (badges + View As toggle).
+     * When false (default), shows badge next to non-guest fields and View As role selector.
+     * @default false
+     */
+    hideVisibilityInfo?: boolean;
+}
+interface EntityDisplayRendererProps<T extends EntityRecord = EntityRecord> {
+    /** Entity definition - pass the full entity from defineEntity() */
+    entity: Entity;
+    /** Entity ID to fetch */
+    id: string;
+    /** Translation function (optional - auto-generated if not provided) */
+    t?: (key: string, options?: Record<string, unknown>) => string;
+    /** Additional CSS classes */
+    className?: string;
+    /** Backend to use */
+    backend?: 'firestore' | 'functions';
+    /** Custom loading message */
+    loadingMessage?: string;
+    /** Custom not found message */
+    notFoundMessage?: string;
+    /**
+     * Current viewer's role for visibility checks
+     * Used to determine which fields should be visible based on their visibility setting
+     * If not provided, defaults to 'guest' (most restrictive - shows only public fields)
+     * @default 'guest'
+     */
+    viewerRole?: UserRole;
+}
+
 type FieldValues = Record<string, any>;
 
 /**
@@ -7675,13 +7987,21 @@ interface CrudAPI<T = unknown> {
     /** Fetch single document by ID */
     get: (id: string) => Promise<T | null>;
     /** Set/replace document by ID */
-    set: (id: string, data: T) => Promise<void>;
+    set: (id: string, data: T, options?: {
+        showSuccessToast?: boolean;
+    }) => Promise<void>;
     /** Partial update document by ID */
-    update: (id: string, data: Partial<T>) => Promise<void>;
+    update: (id: string, data: Partial<T>, options?: {
+        showSuccessToast?: boolean;
+    }) => Promise<void>;
     /** Delete document by ID */
-    delete: (id: string) => Promise<void>;
+    delete: (id: string, options?: {
+        showSuccessToast?: boolean;
+    }) => Promise<void>;
     /** Add new document (auto-generated ID) */
-    add: (data: T) => Promise<string>;
+    add: (data: T, options?: {
+        showSuccessToast?: boolean;
+    }) => Promise<string>;
     /** Query collection with filters */
     query: (options: any) => Promise<T[]>;
     /** Subscribe to document changes */
@@ -9694,8 +10014,6 @@ interface AppMetadata {
     name?: string;
     /** Short application name for mobile/compact displays (defaults to name if not set) */
     shortName?: string;
-    /** Application URL (base URL for production, defaults to localhost in development) */
-    url?: string;
     /** Application description */
     description?: string;
     /** Social and external links */
@@ -9836,7 +10154,7 @@ interface AuthConfig {
 interface SEOConfig {
     /** Enable automatic SEO (default: true) */
     enabled?: boolean;
-    /** Base URL for SEO files (robots.txt, sitemap.xml) - defaults to appConfig.app.url (set at build time) */
+    /** Base URL for SEO files (robots.txt, sitemap.xml) - reads from VITE_APP_URL/NEXT_PUBLIC_APP_URL env var */
     baseUrl?: string;
     /** Site name for SEO - defaults to APP_NAME from app.ts */
     siteName?: string;
@@ -13301,6 +13619,8 @@ declare function parseServerCookie(cookieHeader: string | undefined, name: strin
  */
 //# sourceMappingURL=index.d.ts.map
 
+declare const index_d_CURRENCY_MAP: typeof CURRENCY_MAP;
+type index_d_CurrencyEntry = CurrencyEntry;
 declare const index_d_DEFAULT_ERROR_MESSAGES: typeof DEFAULT_ERROR_MESSAGES;
 type index_d_DateFormatOptions = DateFormatOptions;
 type index_d_DateFormatPreset = DateFormatPreset;
@@ -13325,11 +13645,14 @@ declare const index_d_createSingleton: typeof createSingleton;
 declare const index_d_createSingletonWithParams: typeof createSingletonWithParams;
 declare const index_d_detectErrorSource: typeof detectErrorSource;
 declare const index_d_filterVisibleFields: typeof filterVisibleFields;
+declare const index_d_formatCurrency: typeof formatCurrency;
 declare const index_d_formatDate: typeof formatDate;
 declare const index_d_formatRelativeTime: typeof formatRelativeTime;
 declare const index_d_generateCodeChallenge: typeof generateCodeChallenge;
 declare const index_d_generateCodeVerifier: typeof generateCodeVerifier;
 declare const index_d_generatePKCEPair: typeof generatePKCEPair;
+declare const index_d_getCurrencyLocale: typeof getCurrencyLocale;
+declare const index_d_getCurrencySymbol: typeof getCurrencySymbol;
 declare const index_d_getCurrentTimestamp: typeof getCurrentTimestamp;
 declare const index_d_getVisibleFields: typeof getVisibleFields;
 declare const index_d_getWeekFromISOString: typeof getWeekFromISOString;
@@ -13365,8 +13688,8 @@ declare const index_d_validateUrl: typeof validateUrl;
 declare const index_d_withErrorHandling: typeof withErrorHandling;
 declare const index_d_withGracefulDegradation: typeof withGracefulDegradation;
 declare namespace index_d {
-  export { index_d_DEFAULT_ERROR_MESSAGES as DEFAULT_ERROR_MESSAGES, index_d_DoNotDevError as DoNotDevError, index_d_SingletonManager as SingletonManager, index_d_addMonths as addMonths, index_d_addYears as addYears, index_d_calculateSubscriptionEndDate as calculateSubscriptionEndDate, index_d_captureErrorToSentry as captureErrorToSentry, index_d_commonErrorCodeMappings as commonErrorCodeMappings, index_d_compactToISOString as compactToISOString, index_d_createAsyncSingleton as createAsyncSingleton, index_d_createErrorHandler as createErrorHandler, index_d_createMetadata as createMetadata, index_d_createMethodProxy as createMethodProxy, index_d_createSingleton as createSingleton, index_d_createSingletonWithParams as createSingletonWithParams, index_d_detectErrorSource as detectErrorSource, index_d_filterVisibleFields as filterVisibleFields, index_d_formatDate as formatDate, index_d_formatRelativeTime as formatRelativeTime, index_d_generateCodeChallenge as generateCodeChallenge, index_d_generateCodeVerifier as generateCodeVerifier, index_d_generatePKCEPair as generatePKCEPair, index_d_getCurrentTimestamp as getCurrentTimestamp, index_d_getVisibleFields as getVisibleFields, index_d_getWeekFromISOString as getWeekFromISOString, index_d_handleError as handleError, index_d_hasRoleAccess as hasRoleAccess, index_d_hasTierAccess as hasTierAccess, index_d_isCompactDateString as isCompactDateString, index_d_isFieldVisible as isFieldVisible, index_d_isPKCESupported as isPKCESupported, index_d_isoToCompactString as isoToCompactString, index_d_lazyImport as lazyImport, index_d_mapToDoNotDevError as mapToDoNotDevError, index_d_maybeTranslate as maybeTranslate, index_d_normalizeToISOString as normalizeToISOString, index_d_parseDate as parseDate, index_d_parseDateToNoonUTC as parseDateToNoonUTC, index_d_parseISODate as parseISODate, index_d_parseServerCookie as parseServerCookie, index_d_showNotification as showNotification, index_d_timestampToISOString as timestampToISOString, index_d_toDateOnly as toDateOnly, index_d_toISOString as toISOString, index_d_translateArray as translateArray, index_d_translateArrayRange as translateArrayRange, index_d_translateArrayWithIndices as translateArrayWithIndices, index_d_translateObjectArray as translateObjectArray, index_d_updateMetadata as updateMetadata, index_d_validateCodeChallenge as validateCodeChallenge, index_d_validateCodeVerifier as validateCodeVerifier, index_d_validateEnvVar as validateEnvVar, index_d_validateMetadata as validateMetadata, index_d_validateUrl as validateUrl, index_d_withErrorHandling as withErrorHandling, index_d_withGracefulDegradation as withGracefulDegradation };
-  export type { index_d_DateFormatOptions as DateFormatOptions, index_d_DateFormatPreset as DateFormatPreset, index_d_ErrorHandlerConfig as ErrorHandlerConfig, index_d_ErrorHandlerFunction as ErrorHandlerFunction, index_d_HandleErrorOptions as HandleErrorOptions };
+  export { index_d_CURRENCY_MAP as CURRENCY_MAP, index_d_DEFAULT_ERROR_MESSAGES as DEFAULT_ERROR_MESSAGES, index_d_DoNotDevError as DoNotDevError, index_d_SingletonManager as SingletonManager, index_d_addMonths as addMonths, index_d_addYears as addYears, index_d_calculateSubscriptionEndDate as calculateSubscriptionEndDate, index_d_captureErrorToSentry as captureErrorToSentry, index_d_commonErrorCodeMappings as commonErrorCodeMappings, index_d_compactToISOString as compactToISOString, index_d_createAsyncSingleton as createAsyncSingleton, index_d_createErrorHandler as createErrorHandler, index_d_createMetadata as createMetadata, index_d_createMethodProxy as createMethodProxy, index_d_createSingleton as createSingleton, index_d_createSingletonWithParams as createSingletonWithParams, index_d_detectErrorSource as detectErrorSource, index_d_filterVisibleFields as filterVisibleFields, index_d_formatCurrency as formatCurrency, index_d_formatDate as formatDate, index_d_formatRelativeTime as formatRelativeTime, index_d_generateCodeChallenge as generateCodeChallenge, index_d_generateCodeVerifier as generateCodeVerifier, index_d_generatePKCEPair as generatePKCEPair, index_d_getCurrencyLocale as getCurrencyLocale, index_d_getCurrencySymbol as getCurrencySymbol, index_d_getCurrentTimestamp as getCurrentTimestamp, index_d_getVisibleFields as getVisibleFields, index_d_getWeekFromISOString as getWeekFromISOString, index_d_handleError as handleError, index_d_hasRoleAccess as hasRoleAccess, index_d_hasTierAccess as hasTierAccess, index_d_isCompactDateString as isCompactDateString, index_d_isFieldVisible as isFieldVisible, index_d_isPKCESupported as isPKCESupported, index_d_isoToCompactString as isoToCompactString, index_d_lazyImport as lazyImport, index_d_mapToDoNotDevError as mapToDoNotDevError, index_d_maybeTranslate as maybeTranslate, index_d_normalizeToISOString as normalizeToISOString, index_d_parseDate as parseDate, index_d_parseDateToNoonUTC as parseDateToNoonUTC, index_d_parseISODate as parseISODate, index_d_parseServerCookie as parseServerCookie, index_d_showNotification as showNotification, index_d_timestampToISOString as timestampToISOString, index_d_toDateOnly as toDateOnly, index_d_toISOString as toISOString, index_d_translateArray as translateArray, index_d_translateArrayRange as translateArrayRange, index_d_translateArrayWithIndices as translateArrayWithIndices, index_d_translateObjectArray as translateObjectArray, index_d_updateMetadata as updateMetadata, index_d_validateCodeChallenge as validateCodeChallenge, index_d_validateCodeVerifier as validateCodeVerifier, index_d_validateEnvVar as validateEnvVar, index_d_validateMetadata as validateMetadata, index_d_validateUrl as validateUrl, index_d_withErrorHandling as withErrorHandling, index_d_withGracefulDegradation as withGracefulDegradation };
+  export type { index_d_CurrencyEntry as CurrencyEntry, index_d_DateFormatOptions as DateFormatOptions, index_d_DateFormatPreset as DateFormatPreset, index_d_ErrorHandlerConfig as ErrorHandlerConfig, index_d_ErrorHandlerFunction as ErrorHandlerFunction, index_d_HandleErrorOptions as HandleErrorOptions };
 }
 
 /**
@@ -13478,6 +13801,34 @@ declare function getRegisteredSchemaTypes(): string[];
  * Clear all schema generators (testing)
  */
 declare function clearSchemaGenerators(): void;
+/**
+ * Schema generators exported for unified registry
+ * These are also auto-registered below for backward compatibility
+ */
+declare const textSchema: CustomSchemaGenerator;
+declare const emailSchema: CustomSchemaGenerator;
+declare const passwordSchema: CustomSchemaGenerator;
+declare const urlSchema: CustomSchemaGenerator;
+declare const numberSchema: CustomSchemaGenerator;
+declare const booleanSchema: CustomSchemaGenerator;
+declare const dateSchema: CustomSchemaGenerator;
+declare const fileSchema: CustomSchemaGenerator;
+declare const filesSchema: CustomSchemaGenerator;
+declare const pictureSchema: CustomSchemaGenerator;
+declare const picturesSchema: CustomSchemaGenerator;
+declare const geopointSchema: CustomSchemaGenerator;
+declare const addressSchema: CustomSchemaGenerator;
+declare const mapSchema: CustomSchemaGenerator;
+declare const arraySchema: CustomSchemaGenerator;
+declare const selectSchema: CustomSchemaGenerator;
+declare const multiselectSchema: CustomSchemaGenerator;
+declare const referenceSchema: CustomSchemaGenerator;
+declare const stringSchema: CustomSchemaGenerator;
+declare const telSchema: CustomSchemaGenerator;
+declare const neverSchema: CustomSchemaGenerator;
+declare const switchSchema: CustomSchemaGenerator;
+declare const gdprConsentSchema: CustomSchemaGenerator;
+declare const priceSchema: CustomSchemaGenerator;
 /**
  * Get Valibot schema for an entity field
  *
@@ -13863,5 +14214,130 @@ interface SelectOption {
  */
 declare function rangeOptions(start: number, end: number, step?: number, descending?: boolean): SelectOption[];
 
-export { AUTH_EVENTS, AUTH_PARTNERS, AUTH_PARTNER_STATE, AuthUserSchema, BACKEND_GENERATED_FIELD_NAMES, BILLING_EVENTS, BREAKPOINT_RANGES, BREAKPOINT_THRESHOLDS, COMMON_TIER_CONFIGS, CONFIDENCE_LEVELS, CONSENT_CATEGORY, CONTEXTS, CheckoutSessionMetadataSchema, CreateCheckoutSessionRequestSchema, CreateCheckoutSessionResponseSchema, CustomClaimsSchema, DEFAULT_ENTITY_ACCESS, DEFAULT_ERROR_MESSAGES, DEFAULT_LAYOUT_PRESET, DEFAULT_STATUS_OPTIONS, DEFAULT_STATUS_VALUE, DEFAULT_SUBSCRIPTION, DENSITY, DoNotDevError, ENVIRONMENTS, EntityHookError, FEATURES, FEATURE_CONSENT_MATRIX, FEATURE_STATUS, FIREBASE_ERROR_MAP, FIRESTORE_ID_PATTERN, GITHUB_PERMISSION_LEVELS, HIDDEN_STATUSES, LAYOUT_PRESET, OAUTH_EVENTS, OAUTH_PARTNERS, PARTNER_ICONS, PAYLOAD_EVENTS, PERMISSIONS, PLATFORMS, PWA_ASSET_TYPES, PWA_DISPLAY_MODES, ProductDeclarationSchema, ProductDeclarationsSchema, ROUTE_SOURCES, STORAGE_SCOPES, STORAGE_TYPES, STRIPE_EVENTS, STRIPE_MODES, SUBSCRIPTION_DURATIONS, SUBSCRIPTION_STATUS, SUBSCRIPTION_TIERS, index_d as ServerUtils, SingletonManager, StripeBackConfigSchema, StripeFrontConfigSchema, StripePaymentSchema, StripeSubscriptionSchema, SubscriptionClaimsSchema, SubscriptionDataSchema, TECHNICAL_FIELD_NAMES, USER_ROLES, UserSubscriptionSchema, WebhookEventSchema, addMonths, addYears, baseFields, calculateSubscriptionEndDate, captureErrorToSentry, checkGitHubAccessSchema, clearSchemaGenerators, commonErrorCodeMappings, compactToISOString, createAsyncSingleton, createDefaultSubscriptionClaims, createDefaultUserProfile, createEntitySchema, createErrorHandler, createMetadata, createMethodProxy, createSchemas, createSingleton, createSingletonWithParams, defineEntity, deleteEntitySchema, detectErrorSource, disconnectOAuthSchema, enhanceSchema, exchangeTokenSchema, filterVisibleFields, formatDate, formatRelativeTime, generateCodeChallenge, generateCodeVerifier, generatePKCEPair, getBreakpointFromWidth, getBreakpointUtils, getCollectionName, getConnectionsSchema, getCurrentTimestamp, getEntitySchema, getRegisteredSchemaTypes, getSchemaType, getVisibleFields, getWeekFromISOString, githubPermissionSchema, githubRepoConfigSchema, grantGitHubAccessSchema, handleError, hasCustomSchemaGenerator, hasMetadata, hasRoleAccess, hasTierAccess, isAuthPartnerId, isBackendGeneratedField, isBreakpoint, isCompactDateString, isFieldVisible, isFrameworkField, isOAuthPartnerId, isPKCESupported, isoToCompactString, lazyImport, listEntitiesSchema, mapToDoNotDevError, maybeTranslate, normalizeToISOString, overrideFeatures, overridePaymentModes, overridePermissions, overrideSubscriptionStatus, overrideSubscriptionTiers, overrideUserRoles, parseDate, parseDateToNoonUTC, parseISODate, parseServerCookie, rangeOptions, refreshTokenSchema, registerSchemaGenerator, registerUniqueConstraintValidator, revokeGitHubAccessSchema, showNotification, timestampToISOString, toDateOnly, toISOString, translateArray, translateArrayRange, translateArrayWithIndices, translateObjectArray, updateEntitySchema, updateMetadata, validateAuthPartners, validateAuthSchemas, validateAuthUser, validateBillingSchemas, validateCheckoutSessionMetadata, validateCodeChallenge, validateCodeVerifier, validateCreateCheckoutSessionRequest, validateCreateCheckoutSessionResponse, validateCustomClaims, validateDates, validateDocument, validateEnvVar, validateMetadata, validateOAuthPartners, validateStripeBackConfig, validateStripeFrontConfig, validateSubscriptionClaims, validateSubscriptionData, validateUniqueFields, validateUrl, validateUserSubscription, validateWebhookEvent, withErrorHandling, withGracefulDegradation };
-export type { AccountLinkResult, AccountLinkingInfo, AdminCheckHookResult, AdminClaims, AggregateConfig, AggregateFilterOperator, AggregateOperation, AggregateRequest, AggregateResponse, ApiResponse, AppConfig, AppCookieCategories, AppMetadata, AppProvidersProps, AssetsPluginConfig, AttemptRecord, AuthAPI, AuthActions, AuthConfig, AuthContextValue, AuthCoreHookResult, AuthError, AuthEventData, AuthEventKey, AuthEventName, AuthMethod, AuthPartner, AuthPartnerButton, AuthPartnerHookResult, AuthPartnerId, AuthPartnerResult, AuthPartnerState, AuthProvider, AuthProviderProps, AuthRedirectHookResult, AuthRedirectOperation, AuthRedirectOptions, AuthResult, AuthState, AuthStateStore, AuthStatus, AuthTokenHookResult, AuthUser, BackendGeneratedField, BaseActions, BaseCredentials, BaseDocument, BaseEntityFields, BasePartnerState, BaseState, BaseStoreActions, BaseStoreState, BaseUserProfile, BasicUserInfo, BillingAPI, BillingAdapter, BillingErrorCode, BillingEvent, BillingEventData, BillingEventKey, BillingEventName, BillingProvider, BillingProviderConfig, BillingRedirectOperation, Breakpoint, BreakpointUtils, BusinessEntity, CachedError, CanAPI, CheckGitHubAccessRequest, CheckoutMode, CheckoutOptions, CheckoutSessionMetadata, ColumnDef, CommonSubscriptionFeatures, CommonTranslations, ConfidenceLevel, ConsentAPI, ConsentActions, ConsentCategory, ConsentState, Context, CookieOptions, CreateCheckoutSessionRequest, CreateCheckoutSessionResponse, CreateEntityData, CreateEntityRequest, CreateEntityResponse, CrudAPI, CrudConfig, CustomClaims, CustomSchemaGenerator, CustomStoreConfig, DateFormatOptions, DateFormatPreset, DateValue, DeleteEntityRequest, DeleteEntityResponse, Density, DnDevOverride, DndevFrameworkConfig, DoNotDevCookieCategories, DynamicFormRule, Editable, EffectiveConnectionType, EmailVerificationHookResult, EmailVerificationStatus, Entity, EntityAccessConfig, EntityAccessDefaults, EntityField, EntityHookErrors, EntityMetadata, EntityTemplateProps, EntityTranslations, EnvironmentMode, ErrorCode, ErrorHandlerConfig, ErrorHandlerFunction, ErrorSeverity, ErrorSource, ExchangeTokenParams, ExchangeTokenRequest, FaviconConfig, Feature, FeatureAccessHookResult, FeatureConsentRequirement, FeatureHookResult, FeatureId, FeatureName, FeatureStatus, FeaturesConfig, FeaturesPluginConfig, FeaturesRequiringAnyConsent, FeaturesRequiringConsent, FeaturesWithoutConsent, FieldCondition, FieldType, FieldTypeToValue, FileAsset, FirebaseCallOptions, FirebaseConfig, FirestoreTimestamp, FirestoreUniqueConstraintValidator, FooterConfig, FooterZoneConfig, FormConfig, FormStep, FunctionCallConfig, FunctionCallContext, FunctionCallOptions, FunctionCallResult, FunctionClient, FunctionClientFactoryOptions, FunctionDefaults, FunctionEndpoint, FunctionError, FunctionLoader, FunctionMemory, FunctionMeta, FunctionPlatform, FunctionResponse, FunctionSchema, FunctionSchemas, FunctionSystem, FunctionTrigger, FunctionsConfig, GetCustomClaimsResponse, GetEntityData, GetEntityRequest, GetEntityResponse, GetUserAuthStatusResponse, GitHubPermission, GitHubRepoConfig, GrantGitHubAccessRequest, GroupByDefinition, HandleErrorOptions, HeaderZoneConfig, I18nConfig, I18nPluginConfig, I18nProviderProps, ID, INetworkManager, IStorageManager, IStorageStrategy, Invoice, InvoiceItem, LanguageInfo, LayoutConfig, LayoutPreset, LegalCompanyInfo, LegalConfig, LegalContactInfo, LegalDirectorInfo, LegalHostingInfo, LegalJurisdictionInfo, LegalSectionsConfig, LegalWebsiteInfo, ListEntitiesRequest, ListEntitiesResponse, ListEntityData, ListOptions, ListResponse, LoadingActions, LoadingState, MergedBarConfig, MetricDefinition, MobileBehaviorConfig, ModalActions, ModalState, MutationResponse, NavigationRoute, NetworkCheckConfig, NetworkConnectionType, NetworkReconnectCallback, NetworkState, NetworkStatus, NetworkStatusHookResult, OAuthAPI, OAuthApiRequestOptions, OAuthCallbackHookResult, OAuthConnection, OAuthConnectionInfo, OAuthConnectionRequest, OAuthConnectionStatus, OAuthCredentials, OAuthEventData, OAuthEventKey, OAuthEventName, OAuthPartner, OAuthPartnerButton, OAuthPartnerHookResult, OAuthPartnerId, OAuthPartnerResult, OAuthPartnerState, OAuthPurpose, OAuthRedirectOperation, OAuthRefreshRequest, OAuthRefreshResponse, OAuthResult, OAuthStoreActions, OAuthStoreState, Observable, OperationSchemas, OrderByClause, PWAAssetType, PWADisplayMode, PWAPluginConfig, PageAuth, PageMeta, PaginationOptions, PartnerButton, PartnerConnectionState, PartnerIconId, PartnerId, PartnerResult, PartnerType, PayloadCacheEventData, PayloadDocument, PayloadDocumentEventData, PayloadEventKey, PayloadEventName, PayloadGlobalEventData, PayloadMediaEventData, PayloadPageRegenerationEventData, PayloadRequest, PayloadUserEventData, PaymentEventData, PaymentMethod, PaymentMethodType, PaymentMode, Permission, Picture, Platform, PresetConfig, PresetRegistry, ProcessPaymentSuccessRequest, ProcessPaymentSuccessResponse, ProductDeclaration, ProviderInstances, QueryConfig, RateLimitConfig, RateLimitManager, RateLimitResult, RateLimitState, RateLimiter, ReadCallback, RedirectOperation, RedirectOverlayActions, RedirectOverlayConfig, RedirectOverlayPhase, RedirectOverlayState, Reference, RefreshSubscriptionRequest, RefreshSubscriptionResponse, RemoveCustomClaimsResponse, ResolvedLayoutConfig, RevokeGitHubAccessRequest, RouteMeta, RouteSource, RoutesPluginConfig, SEOConfig, SchemaMetadata, SchemaWithVisibility, SelectOption, SetCustomClaimsResponse, SidebarZoneConfig, SlotContent, StatusField, StorageOptions, StorageScope, StorageType, Store, StoreApi, StripeBackConfig, StripeCheckoutRequest, StripeCheckoutResponse, StripeCheckoutSessionEventData, StripeConfig, StripeCustomer, StripeCustomerEventData, StripeEventData, StripeEventKey, StripeEventName, StripeFrontConfig, StripeInvoice, StripeInvoiceEventData, StripePayment, StripePaymentIntentEventData, StripePaymentMethod, StripePrice, StripeProduct, StripeProvider, StripeSubscription, StripeSubscriptionData, StripeWebhookEvent, StripeWebhookEventData, Subscription, SubscriptionClaims, SubscriptionConfig, SubscriptionData, SubscriptionDuration, SubscriptionEventData, SubscriptionHookResult, SubscriptionInfo, SubscriptionStatus, SubscriptionTier, SupportedLanguage, TechnicalField, ThemeActions, ThemeInfo, ThemeMode, ThemeState, ThemesPluginConfig, TierAccessHookResult, Timestamp, TokenInfo, TokenResponse, TokenState, TokenStatus, TranslationOptions, TranslationResource, TypedBaseFields, UIFieldOptions, UniqueConstraintValidator, UnsubscribeFn, UpdateEntityData, UpdateEntityRequest, UpdateEntityResponse, UseFunctionsMutationOptions, UseFunctionsQueryOptions, UseTranslationOptionsEnhanced, UserContext, UserProfile, UserProviderData, UserRole, UserSubscription, ValidationRules, ValueTypeForField, Visibility, WebhookEvent, WebhookEventData, WhereClause, WhereOperator, WithMetadata, dndevSchema };
+/**
+ * @fileoverview Scope Provider Registry for Multi-Tenancy
+ * @description Global registry for scope providers that supply tenant/company/workspace IDs
+ * to CRUD operations. Apps register providers once, entities declare which provider to use.
+ *
+ * @example
+ * ```typescript
+ * // 1. App registers scope provider (once, at startup)
+ * import { registerScopeProvider } from '@donotdev/core';
+ * import { useCurrentCompanyStore } from './stores/currentCompanyStore';
+ *
+ * registerScopeProvider('company', () =>
+ *   useCurrentCompanyStore.getState().currentCompanyId
+ * );
+ *
+ * // 2. Entity declares scope
+ * const clientEntity = defineEntity({
+ *   name: 'Client',
+ *   collection: 'clients',
+ *   scope: { field: 'companyId', provider: 'company' },
+ *   fields: { ... }
+ * });
+ *
+ * // 3. CRUD operations auto-inject/filter by scope (transparent)
+ * const { add } = useCrud(clientEntity);
+ * await add({ name: 'Acme' }); // companyId auto-injected
+ * ```
+ *
+ * @version 0.0.4
+ * @since 0.0.4
+ * @author AMBROISE PARK Consulting
+ */
+/**
+ * Function that returns the current scope ID from app state
+ * Returns null if no scope is currently selected (e.g., no company selected)
+ */
+type ScopeProviderFn = () => string | null;
+/**
+ * Register a scope provider function
+ *
+ * Call this once at app startup to register scope providers.
+ * The provider function should return the current scope ID from your app's state.
+ *
+ * @param name - Provider name (e.g., 'company', 'tenant', 'workspace')
+ * @param provider - Function that returns the current scope ID
+ *
+ * @example
+ * ```typescript
+ * // Using Zustand store
+ * registerScopeProvider('company', () =>
+ *   useCurrentCompanyStore.getState().currentCompanyId
+ * );
+ *
+ * // Using React context (via ref)
+ * const companyIdRef = { current: null };
+ * registerScopeProvider('company', () => companyIdRef.current);
+ * // Update ref in your context provider
+ * ```
+ *
+ * @version 0.0.4
+ * @since 0.0.4
+ * @author AMBROISE PARK Consulting
+ */
+declare function registerScopeProvider(name: string, provider: ScopeProviderFn): void;
+/**
+ * Unregister a scope provider (for testing or cleanup)
+ *
+ * @param name - Provider name to unregister
+ *
+ * @version 0.0.4
+ * @since 0.0.4
+ * @author AMBROISE PARK Consulting
+ */
+declare function unregisterScopeProvider(name: string): void;
+/**
+ * Get the current scope value from a registered provider
+ *
+ * Used internally by CRUD operations to inject/filter by scope.
+ *
+ * @param providerName - Name of the registered provider
+ * @returns Current scope ID, or null if not available
+ *
+ * @example
+ * ```typescript
+ * const companyId = getScopeValue('company');
+ * if (!companyId) {
+ *   throw new Error('No company selected');
+ * }
+ * ```
+ *
+ * @version 0.0.4
+ * @since 0.0.4
+ * @author AMBROISE PARK Consulting
+ */
+declare function getScopeValue(providerName: string): string | null;
+/**
+ * Check if a scope provider is registered
+ *
+ * @param providerName - Name of the provider to check
+ * @returns True if provider is registered
+ *
+ * @version 0.0.4
+ * @since 0.0.4
+ * @author AMBROISE PARK Consulting
+ */
+declare function hasScopeProvider(providerName: string): boolean;
+/**
+ * Get all registered scope provider names (for debugging)
+ *
+ * @returns Array of registered provider names
+ *
+ * @version 0.0.4
+ * @since 0.0.4
+ * @author AMBROISE PARK Consulting
+ */
+declare function getRegisteredScopeProviders(): string[];
+/**
+ * Clear all scope providers (for testing)
+ *
+ * @version 0.0.4
+ * @since 0.0.4
+ * @author AMBROISE PARK Consulting
+ */
+declare function clearScopeProviders(): void;
+
+export { AUTH_EVENTS, AUTH_PARTNERS, AUTH_PARTNER_STATE, AuthUserSchema, BACKEND_GENERATED_FIELD_NAMES, BILLING_EVENTS, BREAKPOINT_RANGES, BREAKPOINT_THRESHOLDS, COMMON_TIER_CONFIGS, CONFIDENCE_LEVELS, CONSENT_CATEGORY, CONTEXTS, CURRENCY_MAP, CheckoutSessionMetadataSchema, CreateCheckoutSessionRequestSchema, CreateCheckoutSessionResponseSchema, CustomClaimsSchema, DEFAULT_ENTITY_ACCESS, DEFAULT_ERROR_MESSAGES, DEFAULT_LAYOUT_PRESET, DEFAULT_STATUS_OPTIONS, DEFAULT_STATUS_VALUE, DEFAULT_SUBSCRIPTION, DENSITY, DoNotDevError, ENVIRONMENTS, EntityHookError, FEATURES, FEATURE_CONSENT_MATRIX, FEATURE_STATUS, FIREBASE_ERROR_MAP, FIRESTORE_ID_PATTERN, GITHUB_PERMISSION_LEVELS, HIDDEN_STATUSES, LAYOUT_PRESET, OAUTH_EVENTS, OAUTH_PARTNERS, PARTNER_ICONS, PAYLOAD_EVENTS, PERMISSIONS, PLATFORMS, PWA_ASSET_TYPES, PWA_DISPLAY_MODES, ProductDeclarationSchema, ProductDeclarationsSchema, ROUTE_SOURCES, STORAGE_SCOPES, STORAGE_TYPES, STRIPE_EVENTS, STRIPE_MODES, SUBSCRIPTION_DURATIONS, SUBSCRIPTION_STATUS, SUBSCRIPTION_TIERS, index_d as ServerUtils, SingletonManager, StripeBackConfigSchema, StripeFrontConfigSchema, StripePaymentSchema, StripeSubscriptionSchema, SubscriptionClaimsSchema, SubscriptionDataSchema, TECHNICAL_FIELD_NAMES, USER_ROLES, UserSubscriptionSchema, WebhookEventSchema, addMonths, addYears, addressSchema, arraySchema, baseFields, booleanSchema, calculateSubscriptionEndDate, captureErrorToSentry, checkGitHubAccessSchema, clearSchemaGenerators, clearScopeProviders, commonErrorCodeMappings, compactToISOString, createAsyncSingleton, createDefaultSubscriptionClaims, createDefaultUserProfile, createEntitySchema, createErrorHandler, createMetadata, createMethodProxy, createSchemas, createSingleton, createSingletonWithParams, dateSchema, defineEntity, deleteEntitySchema, detectErrorSource, disconnectOAuthSchema, emailSchema, enhanceSchema, exchangeTokenSchema, fileSchema, filesSchema, filterVisibleFields, formatCurrency, formatDate, formatRelativeTime, gdprConsentSchema, generateCodeChallenge, generateCodeVerifier, generatePKCEPair, geopointSchema, getBreakpointFromWidth, getBreakpointUtils, getCollectionName, getConnectionsSchema, getCurrencyLocale, getCurrencySymbol, getCurrentTimestamp, getEntitySchema, getRegisteredSchemaTypes, getRegisteredScopeProviders, getSchemaType, getScopeValue, getVisibleFields, getWeekFromISOString, githubPermissionSchema, githubRepoConfigSchema, grantGitHubAccessSchema, handleError, hasCustomSchemaGenerator, hasMetadata, hasRoleAccess, hasScopeProvider, hasTierAccess, isAuthPartnerId, isBackendGeneratedField, isBreakpoint, isCompactDateString, isFieldVisible, isFrameworkField, isOAuthPartnerId, isPKCESupported, isoToCompactString, lazyImport, listEntitiesSchema, mapSchema, mapToDoNotDevError, maybeTranslate, multiselectSchema, neverSchema, normalizeToISOString, numberSchema, overrideFeatures, overridePaymentModes, overridePermissions, overrideSubscriptionStatus, overrideSubscriptionTiers, overrideUserRoles, parseDate, parseDateToNoonUTC, parseISODate, parseServerCookie, passwordSchema, pictureSchema, picturesSchema, priceSchema, rangeOptions, referenceSchema, refreshTokenSchema, registerSchemaGenerator, registerScopeProvider, registerUniqueConstraintValidator, revokeGitHubAccessSchema, selectSchema, showNotification, stringSchema, switchSchema, telSchema, textSchema, timestampToISOString, toDateOnly, toISOString, translateArray, translateArrayRange, translateArrayWithIndices, translateObjectArray, unregisterScopeProvider, updateEntitySchema, updateMetadata, urlSchema, validateAuthPartners, validateAuthSchemas, validateAuthUser, validateBillingSchemas, validateCheckoutSessionMetadata, validateCodeChallenge, validateCodeVerifier, validateCreateCheckoutSessionRequest, validateCreateCheckoutSessionResponse, validateCustomClaims, validateDates, validateDocument, validateEnvVar, validateMetadata, validateOAuthPartners, validateStripeBackConfig, validateStripeFrontConfig, validateSubscriptionClaims, validateSubscriptionData, validateUniqueFields, validateUrl, validateUserSubscription, validateWebhookEvent, withErrorHandling, withGracefulDegradation };
+export type { AccountLinkResult, AccountLinkingInfo, AdminCheckHookResult, AdminClaims, AggregateConfig, AggregateFilterOperator, AggregateOperation, AggregateRequest, AggregateResponse, AnyFieldValue, ApiResponse, AppConfig, AppCookieCategories, AppMetadata, AppProvidersProps, AssetsPluginConfig, AttemptRecord, AuthAPI, AuthActions, AuthConfig, AuthContextValue, AuthCoreHookResult, AuthError, AuthEventData, AuthEventKey, AuthEventName, AuthMethod, AuthPartner, AuthPartnerButton, AuthPartnerHookResult, AuthPartnerId, AuthPartnerResult, AuthPartnerState, AuthProvider, AuthProviderProps, AuthRedirectHookResult, AuthRedirectOperation, AuthRedirectOptions, AuthResult, AuthState, AuthStateStore, AuthStatus, AuthTokenHookResult, AuthUser, BackendGeneratedField, BaseActions, BaseCredentials, BaseDocument, BaseEntityFields, BasePartnerState, BaseState, BaseStoreActions, BaseStoreState, BaseUserProfile, BasicUserInfo, BillingAPI, BillingAdapter, BillingErrorCode, BillingEvent, BillingEventData, BillingEventKey, BillingEventName, BillingProvider, BillingProviderConfig, BillingRedirectOperation, Breakpoint, BreakpointUtils, BusinessEntity, CachedError, CanAPI, CheckGitHubAccessRequest, CheckoutMode, CheckoutOptions, CheckoutSessionMetadata, ColumnDef, CommonSubscriptionFeatures, CommonTranslations, ConfidenceLevel, ConsentAPI, ConsentActions, ConsentCategory, ConsentState, Context, CookieOptions, CreateCheckoutSessionRequest, CreateCheckoutSessionResponse, CreateEntityData, CreateEntityRequest, CreateEntityResponse, CrudAPI, CrudConfig, CurrencyEntry, CustomClaims, CustomSchemaGenerator, CustomStoreConfig, DateFormatOptions, DateFormatPreset, DateValue, DeleteEntityRequest, DeleteEntityResponse, Density, DnDevOverride, DndevFrameworkConfig, DoNotDevCookieCategories, DynamicFormRule, Editable, EffectiveConnectionType, EmailVerificationHookResult, EmailVerificationStatus, Entity, EntityAccessConfig, EntityAccessDefaults, EntityCardListProps, EntityDisplayRendererProps, EntityField, EntityFormRendererProps, EntityHookErrors, EntityListProps, EntityMetadata, EntityRecord, EntityTemplateProps, EntityTranslations, EnvironmentMode, ErrorCode, ErrorHandlerConfig, ErrorHandlerFunction, ErrorSeverity, ErrorSource, ExchangeTokenParams, ExchangeTokenRequest, FaviconConfig, Feature, FeatureAccessHookResult, FeatureConsentRequirement, FeatureHookResult, FeatureId, FeatureName, FeatureStatus, FeaturesConfig, FeaturesPluginConfig, FeaturesRequiringAnyConsent, FeaturesRequiringConsent, FeaturesWithoutConsent, FieldCondition, FieldType, FieldTypeToValue, FileAsset, FirebaseCallOptions, FirebaseConfig, FirestoreTimestamp, FirestoreUniqueConstraintValidator, FooterConfig, FooterZoneConfig, FormConfig, FormStep, FunctionCallConfig, FunctionCallContext, FunctionCallOptions, FunctionCallResult, FunctionClient, FunctionClientFactoryOptions, FunctionDefaults, FunctionEndpoint, FunctionError, FunctionLoader, FunctionMemory, FunctionMeta, FunctionPlatform, FunctionResponse, FunctionSchema, FunctionSchemas, FunctionSystem, FunctionTrigger, FunctionsConfig, GetCustomClaimsResponse, GetEntityData, GetEntityRequest, GetEntityResponse, GetUserAuthStatusResponse, GitHubPermission, GitHubRepoConfig, GrantGitHubAccessRequest, GroupByDefinition, HandleErrorOptions, HeaderZoneConfig, I18nConfig, I18nPluginConfig, I18nProviderProps, ID, INetworkManager, IStorageManager, IStorageStrategy, Invoice, InvoiceItem, LanguageInfo, LayoutConfig, LayoutPreset, LegalCompanyInfo, LegalConfig, LegalContactInfo, LegalDirectorInfo, LegalHostingInfo, LegalJurisdictionInfo, LegalSectionsConfig, LegalWebsiteInfo, ListEntitiesRequest, ListEntitiesResponse, ListEntityData, ListOptions, ListResponse, LoadingActions, LoadingState, MergedBarConfig, MetricDefinition, MobileBehaviorConfig, ModalActions, ModalState, MutationResponse, NavigationRoute, NetworkCheckConfig, NetworkConnectionType, NetworkReconnectCallback, NetworkState, NetworkStatus, NetworkStatusHookResult, OAuthAPI, OAuthApiRequestOptions, OAuthCallbackHookResult, OAuthConnection, OAuthConnectionInfo, OAuthConnectionRequest, OAuthConnectionStatus, OAuthCredentials, OAuthEventData, OAuthEventKey, OAuthEventName, OAuthPartner, OAuthPartnerButton, OAuthPartnerHookResult, OAuthPartnerId, OAuthPartnerResult, OAuthPartnerState, OAuthPurpose, OAuthRedirectOperation, OAuthRefreshRequest, OAuthRefreshResponse, OAuthResult, OAuthStoreActions, OAuthStoreState, Observable, OperationSchemas, OrderByClause, PWAAssetType, PWADisplayMode, PWAPluginConfig, PageAuth, PageMeta, PaginationOptions, PartnerButton, PartnerConnectionState, PartnerIconId, PartnerId, PartnerResult, PartnerType, PayloadCacheEventData, PayloadDocument, PayloadDocumentEventData, PayloadEventKey, PayloadEventName, PayloadGlobalEventData, PayloadMediaEventData, PayloadPageRegenerationEventData, PayloadRequest, PayloadUserEventData, PaymentEventData, PaymentMethod, PaymentMethodType, PaymentMode, Permission, Picture, Platform, PresetConfig, PresetRegistry, ProcessPaymentSuccessRequest, ProcessPaymentSuccessResponse, ProductDeclaration, ProviderInstances, QueryConfig, RateLimitConfig, RateLimitManager, RateLimitResult, RateLimitState, RateLimiter, ReadCallback, RedirectOperation, RedirectOverlayActions, RedirectOverlayConfig, RedirectOverlayPhase, RedirectOverlayState, Reference, RefreshSubscriptionRequest, RefreshSubscriptionResponse, RemoveCustomClaimsResponse, ResolvedLayoutConfig, RevokeGitHubAccessRequest, RouteMeta, RouteSource, RoutesPluginConfig, SEOConfig, SchemaMetadata, SchemaWithVisibility, ScopeConfig, ScopeProviderFn, SelectOption, SetCustomClaimsResponse, SidebarZoneConfig, SlotContent, StatusField, StorageOptions, StorageScope, StorageType, Store, StoreApi, StripeBackConfig, StripeCheckoutRequest, StripeCheckoutResponse, StripeCheckoutSessionEventData, StripeConfig, StripeCustomer, StripeCustomerEventData, StripeEventData, StripeEventKey, StripeEventName, StripeFrontConfig, StripeInvoice, StripeInvoiceEventData, StripePayment, StripePaymentIntentEventData, StripePaymentMethod, StripePrice, StripeProduct, StripeProvider, StripeSubscription, StripeSubscriptionData, StripeWebhookEvent, StripeWebhookEventData, Subscription, SubscriptionClaims, SubscriptionConfig, SubscriptionData, SubscriptionDuration, SubscriptionEventData, SubscriptionHookResult, SubscriptionInfo, SubscriptionStatus, SubscriptionTier, SupportedLanguage, TechnicalField, ThemeActions, ThemeInfo, ThemeMode, ThemeState, ThemesPluginConfig, TierAccessHookResult, Timestamp, TokenInfo, TokenResponse, TokenState, TokenStatus, TranslationOptions, TranslationResource, TypedBaseFields, UIFieldOptions, UniqueConstraintValidator, UniqueKeyDefinition, UnsubscribeFn, UpdateEntityData, UpdateEntityRequest, UpdateEntityResponse, UseFunctionsMutationOptions, UseFunctionsQueryOptions, UseTranslationOptionsEnhanced, UserContext, UserProfile, UserProviderData, UserRole, UserSubscription, ValidationRules, ValueTypeForField, Visibility, WebhookEvent, WebhookEventData, WhereClause, WhereOperator, WithMetadata, dndevSchema };