@wildo-ai/saas-frontend-lib 1.0.1

package/dist/esm/core/runtime/start-application.frontend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-application.frontend.service.d.ts","sourceRoot":"","sources":["../../../../src/core/runtime/start-application.frontend.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AAEpG,OAAO,EAAE,sBAAsB,EAAE,MAAM,sEAAsE,CAAC;AAC9G,OAAO,EAAE,kCAAkC,EAAE,MAAM,0EAA0E,CAAC;AAC9H,OAAO,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC;AAE3E,OAAO,EACL,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,2CAA2C,EAC3C,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,oEAAoE,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAEnI,OAAO,EAAE,KAAK,uBAAuB,EAAgC,MAAM,6CAA6C,CAAC;AA0EzH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,+BAA+B,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC;;;OAGG;IACH,8CAA8C,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,2CAA2C,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC;IAE/H;;OAEG;IACH,oCAAoC,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAEjE;;OAEG;IACH,mCAAmC,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAE7D;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC;;;OAGG;IACH,kBAAkB,EAAE,yBAAyB,CAAC;IAE9C,0EAA0E;IAC1E,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAElD,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAE5C,2EAA2E;IAC3E,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,UAAU,EAAE,sBAAsB,CAAC;IACnC,kBAAkB,EAAE,kCAAkC,CAAC;IACvD,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,oBAAoB,EAAE,uBAAuB,CAAC;IAC9C,sFAAsF;IACtF,qBAAqB,EAAE,yBAAyB,CAAC;CAClD;AAED,qBAAa,+BAA+B;IAC1C,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,qBAAqB,CAA6C;IAC1E,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,QAAQ,CAA+E;IAIzF,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;YA4B7E,qBAAqB;IA+OnC;;OAEG;IACH,WAAW,IAAI,mBAAmB,GAAG,IAAI;IAIzC;;OAEG;IACH,wBAAwB,IAAI,OAAO;IAInC;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;YACW,gBAAgB;CAoB/B;AAUD,eAAO,MAAM,uBAAuB,EAAyD,+BAA+B,CAAC"}

package/dist/esm/core/runtime/start-application.frontend.service.js

@@ -0,0 +1,319 @@
+/**
+ * Start Application Frontend Service
+ * Handles application initialization and startup logic
+ */
+import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
+import { WildoBackendHttpClient_ManualCalls } from '../../core/requests/wildo-http-client-manual-calls.frontend.service.js';
+import { WildoBackendHttpClient } from '../../core/requests/wildo-http-client.frontend.service.js';
+import { ResourcesRepositoryFrontendService } from '../../core/resources/resources-repository.frontend.service.js';
+import { AppConfiguration_Frontend_Schema, } from '../../core/config/app-configuration-frontend.schemas.js';
+import { envLoader } from '../../core/runtime/env-variable-loader.frontend.service.js';
+import { applyFrontendConfigOverrides } from './app-config-overrides.frontend.definitions.js';
+import { verifyLauncherContent, reportLauncherVerificationResults } from '../../core/config/verify-launcher-content.js';
+import { verifyFrontendFeatureReferences } from '../../core/config/verify-feature-references.frontend.js';
+import { ComponentRegistryService } from '../../core/components-registry/component-registry.frontend.service.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function extractCauseMessage(error) {
+    if (!isRecord(error) || !('cause' in error)) {
+        return undefined;
+    }
+    const cause = error.cause;
+    if (cause instanceof Error) {
+        return cause.message;
+    }
+    if (typeof cause === 'string') {
+        return cause;
+    }
+    return undefined;
+}
+function normalizeInitializationFailure(error, baseDiagnostics) {
+    const normalizedError = error instanceof Error ? error : new Error(String(error));
+    const wildoError = isRecord(normalizedError) && isRecord(normalizedError.wildoError)
+        ? normalizedError.wildoError
+        : undefined;
+    normalizedError.initializationDiagnostics = {
+        ...baseDiagnostics,
+        errorName: normalizedError.name,
+        errorMessage: normalizedError.message,
+        stack: normalizedError.stack,
+        causeMessage: extractCauseMessage(normalizedError),
+        wildoError: wildoError ? {
+            type: wildoError.type,
+            customMessageReference: wildoError.customMessageReference,
+            context: isRecord(wildoError.context) ? wildoError.context : undefined,
+        } : undefined,
+    };
+    return normalizedError;
+}
+export class StartApplicationFrontendService {
+    services = null;
+    isInitialized = false;
+    initializationPromise = null;
+    logger = null;
+    logDebug = null;
+    async initializeApplication(options) {
+        if (this.isInitialized && this.services)
+            return this.services;
+        if (this.initializationPromise)
+            return this.initializationPromise;
+        // Freeze options snapshot to ensure stable initialization across dev StrictMode double-invoke
+        const snapshot = { ...options };
+        this.initializationPromise = this.performInitialization(snapshot);
+        try {
+            this.services = await this.initializationPromise;
+            this.isInitialized = true;
+            try {
+                options.onInitialized && options.onInitialized();
+            }
+            catch (error) {
+                this.logger.error('Failed to fire onInitialized callback', { error: error instanceof Error ? error.message : String(error) });
+            }
+            return this.services;
+        }
+        catch (error) {
+            this.initializationPromise = null;
+            throw error;
+        }
+    }
+    async performInitialization(options) {
+        const { config, autoAuth = true, preloadResources = [], onError, customShared_ResourcesConfigurationsFactoryMap, customShared_ResourceFieldIdentifier, customShared_ResourcesRelationships, componentLoader, } = options;
+        let currentPhase = 'startup preparation';
+        let envConfig;
+        if (!this.logger) {
+            this.logger = LoggerFrontendService.getLogger();
+            this.logDebug = this.logger.debugByType('StartApplicationFrontendService');
+            this.logger.setDebugTypeLogging('StartApplicationFrontendService', false);
+        }
+        this.logger.info('Starting application initialization...', {
+            autoAuth,
+        });
+        this.logDebug('Frontend initialization started with config', {
+            apiBaseUrl: config.apiBaseUrl,
+            autoAuth,
+        });
+        try {
+            // Initialize HTTP client
+            currentPhase = 'http client initialization';
+            this.logDebug('Initializing HTTP client...');
+            const httpClient = new WildoBackendHttpClient({ baseURL: config.apiBaseUrl });
+            // Fetch application configuration from backend
+            currentPhase = 'manual backend client setup';
+            this.logDebug('Fetching application configuration from backend...');
+            const manualCallsClient = new WildoBackendHttpClient_ManualCalls({ baseURL: config.apiBaseUrl });
+            try {
+                currentPhase = 'environment configuration loading';
+                envConfig = envLoader.loadEnvironmentConfig();
+                this.logDebug('Environment configuration loaded', {
+                    frontendServiceName: envConfig.frontendServiceName,
+                    apiBaseUrl: envConfig.apiBaseUrl,
+                    appName: envConfig.appName
+                });
+            }
+            catch (error) {
+                this.logger.error('Failed to load environment configuration', { error: error.message });
+                throw new Error(`Environment configuration failed: ${error.message}`);
+            }
+            let appConfigFromBackend;
+            try {
+                currentPhase = 'backend application configuration fetch';
+                // Retry logic for config retrieval
+                // Note: Keep this low to avoid long waits when backend is down
+                // HTTP client also has its own retry logic (3 attempts by default)
+                const CONFIG_RETRY_ATTEMPTS = 2; // Reduced from 10 to avoid long waits
+                const CONFIG_BASE_DELAY_MS = 2000; // 2 seconds between retries
+                const CONFIG_MAX_DELAY_MS = 5000;
+                let lastError = null;
+                for (let attempt = 1; attempt <= CONFIG_RETRY_ATTEMPTS; attempt++) {
+                    try {
+                        appConfigFromBackend = await manualCallsClient.getApplicationConfig(envConfig.frontendServiceName);
+                        break; // Success, exit retry loop
+                    }
+                    catch (error) {
+                        lastError = error instanceof Error ? error : new Error(String(error));
+                        if (attempt < CONFIG_RETRY_ATTEMPTS) {
+                            const delay = Math.min(CONFIG_BASE_DELAY_MS * Math.pow(2, attempt - 1), CONFIG_MAX_DELAY_MS);
+                            this.logDebug(`Config fetch attempt ${attempt}/${CONFIG_RETRY_ATTEMPTS} failed, retrying after ${delay}ms`, {
+                                error: lastError.message,
+                                attempt,
+                                totalAttempts: CONFIG_RETRY_ATTEMPTS
+                            });
+                            await new Promise(resolve => setTimeout(resolve, delay));
+                        }
+                        else {
+                            this.logger.error(`All ${CONFIG_RETRY_ATTEMPTS} config fetch attempts failed`, {
+                                error: lastError.message,
+                                totalAttempts: CONFIG_RETRY_ATTEMPTS
+                            });
+                            throw lastError;
+                        }
+                    }
+                }
+                this.logDebug('Application configuration fetched successfully', {
+                    hasAppIdentity: !!appConfigFromBackend.appIdentity,
+                    hasAppPreferences: !!appConfigFromBackend.appPreferences,
+                    hasRuntime: !!appConfigFromBackend.runtime,
+                    endpointsCount: Object.keys(appConfigFromBackend.runtime?.endPoints || {}).length
+                });
+                this.logDebug('Application configuration loaded from backend', {
+                    appName: appConfigFromBackend.appIdentity?.appName,
+                    version: appConfigFromBackend.appIdentity?.version,
+                    hasAuth: !!appConfigFromBackend.auth,
+                    hasSSOProviders: !!appConfigFromBackend.auth?.ssoProviders && Object.keys(appConfigFromBackend.auth.ssoProviders).length > 0,
+                    defaultLanguage: appConfigFromBackend.appPreferences?.languages?.defaultLanguage,
+                    enabledLanguages: appConfigFromBackend.appPreferences?.languages?.enabledLanguages,
+                    endpointsList: Object.keys(appConfigFromBackend.runtime?.endPoints || {}),
+                });
+            }
+            catch (error) {
+                this.logger.error('Failed to fetch application configuration from backend', {
+                    error: error.message,
+                    frontendServiceName: envConfig?.frontendServiceName,
+                    apiBaseUrl: config.apiBaseUrl
+                });
+                throw new Error(`Application configuration fetch failed: ${error.message}`);
+            }
+            // Resolve frontend configuration from app-provided base + overrides
+            // Frontend config is owned entirely by the frontend — not sent from backend
+            currentPhase = 'frontend configuration validation';
+            let resolvedFrontendConfig = {
+                ...options.baseFrontendConfig,
+            };
+            this.logDebug('Using app-provided base frontend configuration');
+            if (options.frontendConfigOverrides) {
+                resolvedFrontendConfig = applyFrontendConfigOverrides(resolvedFrontendConfig, options.frontendConfigOverrides);
+                this.logDebug('Applied frontend config overrides', { sections: Object.keys(options.frontendConfigOverrides) });
+            }
+            resolvedFrontendConfig = AppConfiguration_Frontend_Schema.parse(resolvedFrontendConfig);
+            this.logDebug('Frontend configuration resolved', {
+                frontendServiceName: envConfig.frontendServiceName,
+                finalConfig: {
+                    hasNavigationLayout: !!resolvedFrontendConfig.navigationLayout,
+                    hasAppComponentsConfiguration: !!resolvedFrontendConfig.appComponentsConfiguration,
+                    hasDesignSystem: !!resolvedFrontendConfig.designSystemConfiguration,
+                    hasTypography: !!resolvedFrontendConfig.designSystemConfiguration?.typography,
+                }
+            });
+            // Initialize resources repository
+            currentPhase = 'frontend resource registry initialization';
+            this.logDebug('Initializing resources repository...');
+            const resourceRepository = new ResourcesRepositoryFrontendService(httpClient);
+            await resourceRepository.initializeResources(customShared_ResourcesConfigurationsFactoryMap, customShared_ResourceFieldIdentifier, customShared_ResourcesRelationships, undefined, options.resourceUIBehavior);
+            const resourcesRegistry = resourceRepository.getResourcesRegistry();
+            // Initialize frontend component presets (app-provided registration)
+            currentPhase = 'component preset registration';
+            await componentLoader();
+            // DEV-mode: verify launcher/view declarations only after component
+            // registration so custom component refs can be checked deterministically.
+            if (envLoader.isDevelopment()) {
+                currentPhase = 'development launcher verification';
+                const verificationResult = verifyLauncherContent(resourcesRegistry, resolvedFrontendConfig, (componentRef) => ComponentRegistryService.hasComponentType(componentRef));
+                reportLauncherVerificationResults(verificationResult);
+                if (options.featureConfiguration) {
+                    const featureReferenceVerification = verifyFrontendFeatureReferences({
+                        resourcesRegistry,
+                        appConfig: resolvedFrontendConfig,
+                        featureConfiguration: options.featureConfiguration,
+                    });
+                    if (!featureReferenceVerification.isValid) {
+                        this.logger.warn(`Invalid frontend feature references detected:\n${featureReferenceVerification.warnings
+                            .map(warning => `  ⚠ ${warning}`)
+                            .join('\n')}`);
+                    }
+                }
+            }
+            // Preload resources if specified
+            if (preloadResources.length > 0) {
+                currentPhase = 'resource preload';
+                await this.preloadResources(preloadResources);
+            }
+            const services = {
+                logger: this.logger,
+                httpClient,
+                resourceRepository,
+                resourcesRegistry,
+                appConfigFromBackend,
+                frontendConfiguration: resolvedFrontendConfig,
+            };
+            this.logger.info('Application initialization completed successfully');
+            return services;
+        }
+        catch (error) {
+            const initializationFailure = normalizeInitializationFailure(error, {
+                phase: currentPhase,
+                apiBaseUrl: config.apiBaseUrl,
+                frontendServiceName: envConfig?.frontendServiceName,
+            });
+            if (this.logger) {
+                this.logger.error('Application initialization failed', {
+                    error: initializationFailure.message,
+                    stack: initializationFailure.stack,
+                    phase: currentPhase,
+                    apiBaseUrl: config.apiBaseUrl,
+                    frontendServiceName: envConfig?.frontendServiceName,
+                    initializationDiagnostics: initializationFailure.initializationDiagnostics,
+                });
+            }
+            else {
+                console.error('Application initialization failed:', initializationFailure);
+            }
+            if (onError) {
+                onError(initializationFailure);
+            }
+            throw initializationFailure;
+        }
+    }
+    /**
+     * Get the initialized services
+     */
+    getServices() {
+        return this.services;
+    }
+    /**
+     * Check if the application is initialized
+     */
+    isApplicationInitialized() {
+        return this.isInitialized;
+    }
+    /**
+     * Reset the initialization state (useful for testing)
+     */
+    reset() {
+        this.services = null;
+        this.isInitialized = false;
+        this.initializationPromise = null;
+        // Don't reset logger - keep singleton principle
+    }
+    /**
+     * Preload specified resources
+     */
+    async preloadResources(resources) {
+        if (!this.logger)
+            return;
+        this.logger.info('Preloading resources...', { resourceCount: resources.length });
+        try {
+            // TODO: Implement resource preloading logic
+            // This could involve fetching commonly used data, warming caches, etc.
+            await Promise.all(resources.map(async (resource) => {
+                this.logger.debug(`Preloading resource: ${resource}`);
+                // Implement specific preloading logic per resource type
+            }));
+            this.logger.info('Resource preloading completed successfully');
+        }
+        catch (error) {
+            this.logger.warn('Resource preloading failed', { error: error.message });
+            // Don't throw here - preloading failure shouldn't prevent app startup
+        }
+    }
+}
+/**
+ * Global instance of the start application service
+ */
+// Persist singleton across HMR/dev to avoid double initialization
+const __globalAny = (typeof globalThis !== 'undefined' ? globalThis : window);
+if (!__globalAny.__START_APPLICATION_FRONTEND_SERVICE__) {
+    __globalAny.__START_APPLICATION_FRONTEND_SERVICE__ = new StartApplicationFrontendService();
+}
+export const startApplicationService = __globalAny.__START_APPLICATION_FRONTEND_SERVICE__;
+//# sourceMappingURL=start-application.frontend.service.js.map

package/dist/esm/core/runtime/start-application.frontend.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-application.frontend.service.js","sourceRoot":"","sources":["../../../../src/core/runtime/start-application.frontend.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/runtime/useApplication.d.ts

@@ -0,0 +1,25 @@
+/**
+ * useApplication Hook
+ *
+ * ARCHITECTURE NOTE:
+ * This hook is separated from ApplicationMainContext.tsx for React Fast Refresh compatibility.
+ *
+ * React Fast Refresh requires files to export EITHER:
+ * - Only React components, OR
+ * - Only non-component values (hooks, utilities)
+ *
+ * Mixing both in a single file causes HMR invalidation loops because Vite cannot
+ * determine if the file should be hot-refreshed (components) or fully reloaded (utilities).
+ *
+ * By separating the hook:
+ * - ApplicationMainContext.tsx exports only components and types → Fast Refresh works
+ * - This file exports only the hook → Clean module boundary
+ */
+import { type ApplicationContextType } from './ApplicationContext.shared.js';
+/**
+ * Hook to access the Application context
+ * @returns ApplicationContextType with app configuration, services, and state
+ * @throws Error if used outside of ApplicationMainProvider
+ */
+export declare const useApplication: () => ApplicationContextType;
+//# sourceMappingURL=useApplication.d.ts.map

package/dist/esm/core/runtime/useApplication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApplication.d.ts","sourceRoot":"","sources":["../../../../src/core/runtime/useApplication.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAsB,KAAK,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE9F;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,sBAMjC,CAAC"}

package/dist/esm/core/runtime/useApplication.js

@@ -0,0 +1,32 @@
+/**
+ * useApplication Hook
+ *
+ * ARCHITECTURE NOTE:
+ * This hook is separated from ApplicationMainContext.tsx for React Fast Refresh compatibility.
+ *
+ * React Fast Refresh requires files to export EITHER:
+ * - Only React components, OR
+ * - Only non-component values (hooks, utilities)
+ *
+ * Mixing both in a single file causes HMR invalidation loops because Vite cannot
+ * determine if the file should be hot-refreshed (components) or fully reloaded (utilities).
+ *
+ * By separating the hook:
+ * - ApplicationMainContext.tsx exports only components and types → Fast Refresh works
+ * - This file exports only the hook → Clean module boundary
+ */
+import { useContext } from 'react';
+import { ApplicationContext } from './ApplicationContext.shared.js';
+/**
+ * Hook to access the Application context
+ * @returns ApplicationContextType with app configuration, services, and state
+ * @throws Error if used outside of ApplicationMainProvider
+ */
+export const useApplication = () => {
+    const context = useContext(ApplicationContext);
+    if (!context) {
+        throw new Error('useApplication must be used within an ApplicationMainProvider');
+    }
+    return context;
+};
+//# sourceMappingURL=useApplication.js.map

package/dist/esm/core/runtime/useApplication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApplication.js","sourceRoot":"","sources":["../../../../src/core/runtime/useApplication.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAA+B,MAAM,6BAA6B,CAAC;AAE9F;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAA2B,EAAE;IACzD,MAAM,OAAO,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/esm/core/scope/AppScopeContext.d.ts

@@ -0,0 +1,91 @@
+/**
+ * AppScopeContext
+ *
+ * The single source of truth for application scope state, including:
+ * - Primary scope values
+ * - Custom scope values (declared in top-level `appScope.fields`)
+ * - Dependency cascade handling
+ * - Context building for navigation and API calls
+ * - URL synchronization (automatic)
+ * - Scope validation (automatic)
+ *
+ * This context sits above `UserOrgsContext` in the provider tree and owns the
+ * canonical primary-scope snapshot. `UserOrgsContext` consumes it as a facade.
+ *
+ * Scope fields are declared in the app config (`appScope.fields`), not via schema
+ * decorators. Each field specifies a resourceType + fieldIdentifier pair, and the
+ * context resolves the resourcePrimaryScope at initialization.
+ *
+ * `appScope.fields` is the only supported declaration site for custom scope
+ * fields in this greenfield framework.
+ */
+import type { AppScopeFieldDefinition } from '../../core/resources/resources.frontend.schemas.js';
+import React, { type ReactNode } from 'react';
+import { AppScopePrimaryValues, AppScopeSessionMode, type AppScopeValue, PrimaryScopeFieldDefinition, type ScopeDependency, type SetScopeValueOptions } from './scope.frontend.schemas.js';
+/**
+ * The shape of the AppScopeContext value.
+ */
+export interface AppScopeContextValue {
+    /** All primary scope values */
+    primaryScopeValues: AppScopePrimaryValues;
+    /** All custom scope values */
+    customScopeValues: Record<string, AppScopeValue>;
+    /** All scope values merged (convenience accessor) */
+    allScopeValues: Record<string, AppScopeValue>;
+    /** Derived session discriminator for interpreting primary-scope state. */
+    sessionMode: AppScopeSessionMode;
+    /** Convenience aliases over primaryScopeValues. */
+    currentOrganizationId: string | null;
+    currentUserId: string | null;
+    currentApplicationId: string | null;
+    currentAnonymousUserId: string | null;
+    /** Primary scope field definitions (hardcoded) */
+    primaryScopeFields: PrimaryScopeFieldDefinition[];
+    /** App scope field definitions from the active app-scope source. */
+    customScopeFields: AppScopeFieldDefinition[];
+    /**
+     * Set a custom scope value.
+     * Primary scope values are framework-owned and should be changed through the
+     * dedicated organization facade APIs rather than this custom-scope setter.
+     */
+    setScopeValue: (fieldIdentifier: string, value: AppScopeValue, options?: SetScopeValueOptions) => void;
+    /**
+     * Clear all custom scope values (useful on primary scope change).
+     */
+    clearCustomScopeValues: (options?: SetScopeValueOptions) => void;
+    /** Scope dependencies derived from resource relationships */
+    dependencies: ScopeDependency[];
+    /**
+     * Get child scope fields that depend on a parent field.
+     */
+    getDependentFields: (parentFieldIdentifier: string) => string[];
+    /**
+     * Build context resource identifiers (keyed by resource type).
+     * Used for navigation.
+     */
+    buildContextResourceIdentifiers: () => Record<string, string>;
+    /**
+     * Build contextual parameters (keyed by field identifier).
+     * Used for API calls.
+     */
+    buildContextualParameters: () => Record<string, string | string[]>;
+    /** Whether the context is initialized and ready */
+    isReady: boolean;
+    /** Whether scope values are being loaded/validated */
+    isLoading: boolean;
+}
+export declare const AppScopeContext: React.Context<AppScopeContextValue>;
+interface AppScopeInternalContextValue {
+    commitOrganizationScopeValue: (organizationId: string | null) => void;
+}
+/**
+ * Internal hook for framework-owned contexts that need to delegate primary-scope
+ * commits to AppScope while keeping their public facade APIs stable.
+ */
+export declare function useAppScopeInternal(): AppScopeInternalContextValue;
+interface AppScopeProviderProps {
+    children: ReactNode;
+}
+export declare const AppScopeProvider: React.FC<AppScopeProviderProps>;
+export {};
+//# sourceMappingURL=AppScopeContext.d.ts.map

package/dist/esm/core/scope/AppScopeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppScopeContext.d.ts","sourceRoot":"","sources":["../../../../src/core/scope/AppScopeContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAWH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+DAA+D,CAAC;AAM7G,OAAO,KAAK,EAAE,EAOZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAWf,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,aAAa,EAClB,2BAA2B,EAE3B,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAE1B,MAAM,0BAA0B,CAAC;AAgBlC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IAGnC,+BAA+B;IAC/B,kBAAkB,EAAE,qBAAqB,CAAC;IAE1C,8BAA8B;IAC9B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAEjD,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAE9C,0EAA0E;IAC1E,WAAW,EAAE,mBAAmB,CAAC;IAEjC,mDAAmD;IACnD,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IAItC,kDAAkD;IAClD,kBAAkB,EAAE,2BAA2B,EAAE,CAAC;IAElD,oEAAoE;IACpE,iBAAiB,EAAE,uBAAuB,EAAE,CAAC;IAI7C;;;;OAIG;IACH,aAAa,EAAE,CACb,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,oBAAoB,KAC3B,IAAI,CAAC;IAEV;;OAEG;IACH,sBAAsB,EAAE,CAAC,OAAO,CAAC,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAIjE,6DAA6D;IAC7D,YAAY,EAAE,eAAe,EAAE,CAAC;IAEhC;;OAEG;IACH,kBAAkB,EAAE,CAAC,qBAAqB,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IAIhE;;;OAGG;IACH,+BAA+B,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9D;;;OAGG;IACH,yBAAyB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAInE,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IAEjB,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;CACpB;AAGD,eAAO,MAAM,eAAe,qCAA6D,CAAC;AAE1F,UAAU,4BAA4B;IACpC,4BAA4B,EAAE,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACvE;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,4BAA4B,CAMlE;AA4DD,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAi2B5D,CAAC"}