@wildo-ai/saas-frontend-lib 1.0.1

package/dist/esm/core/events/notification-display-policy.frontend.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-display-policy.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/events/notification-display-policy.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAMnE;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC;IAEnB,4CAA4C;IAC5C,WAAW,EAAE,OAAO,CAAC;IAErB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B,6DAA6D;IAC7D,cAAc,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAEtD,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,8CAA8C;IAC9C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,gBAAgB,EAAE,2BAA2B,CAqB7F,CAAC;AAMF;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,EAAE,OAAO,CACjD,MAAM,CAAC,kBAAkB,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,CA4CpG,CAAC;AAMF;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,kBAAkB,EAC1B,cAAc,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,GACpD,2BAA2B,CAa7B;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAK1E,CAAC;AAEF;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAE5E"}

package/dist/esm/core/events/notification-display-policy.frontend.schemas.js

@@ -0,0 +1,160 @@
+/**
+ * Notification Display Policy
+ *
+ * Defines policy-driven notification display behavior, similar to HTTP_ERROR_BEHAVIOR_MATRIX.
+ * This provides a centralized, consistent approach to how notifications are displayed
+ * across the application.
+ *
+ * The policy determines:
+ * - Whether to show an ephemeral toast notification
+ * - Whether to add to the persistent notification center
+ * - Toast duration based on notification type
+ *
+ * ## Override Capabilities
+ *
+ * 1. **Source-level override**: Different sources (resource, custom) can have different behaviors
+ * 2. **Per-notification override**: Pass `overridePolicy` when calling notify methods
+ */
+import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
+const logger = LoggerFrontendService.getLogger();
+const logDebug = logger.debugByType('NotificationDisplayPolicy');
+logger.setDebugTypeLogging('NotificationDisplayPolicy', false);
+// ─────────────────────────────────────────────────────────────────────────────
+// Default Policy
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Default notification display policy by notification type
+ *
+ * Design principles:
+ * - Success notifications are ephemeral (toast only) - user doesn't need to review
+ * - Info notifications are ephemeral - informational, not actionable
+ * - Warning notifications persist - user may need to take action
+ * - Error notifications always persist - user needs to review and potentially act
+ */
+export const NOTIFICATION_DISPLAY_POLICY = {
+    success: {
+        showToast: true,
+        addToCenter: false, // Ephemeral only
+        toastDuration: 3000, // 3 seconds
+    },
+    info: {
+        showToast: true,
+        addToCenter: false, // Usually ephemeral
+        toastDuration: 4000, // 4 seconds
+    },
+    warning: {
+        showToast: true,
+        addToCenter: true, // Persist for user review
+        toastDuration: 5000, // 5 seconds
+    },
+    error: {
+        showToast: true,
+        addToCenter: true, // Always persist errors
+        toastDuration: 6000, // 6 seconds
+    },
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Source-Specific Overrides
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Source-specific overrides to the base policy
+ *
+ * Different notification sources may have different display behaviors.
+ * These overrides are merged with the base policy.
+ */
+export const NOTIFICATION_SOURCE_OVERRIDES = {
+    resource: {
+        // Resource success operations are always ephemeral (form submitted, operation completed)
+        success: {
+            addToCenter: false,
+        },
+        // Resource info (e.g., updates from other users) - ephemeral toast
+        info: {
+            addToCenter: false,
+        },
+        // Resource warnings (e.g., deletions) - persist
+        warning: {
+            addToCenter: true,
+        },
+        // Resource errors - always persist
+        error: {
+            addToCenter: true,
+        },
+    },
+    custom: {
+    // Custom notifications follow the base policy
+    // Can be overridden per-notification if needed
+    },
+    backend: {
+        // Backend-initiated notifications (via WebSocket) - typically important enough to persist
+        // These are direct messages from the server (export ready, payment received, etc.)
+        success: {
+            addToCenter: true, // Backend success notifications should persist (user wasn't expecting them)
+            toastDuration: 4000, // Slightly longer for unexpected notifications
+        },
+        info: {
+            addToCenter: true, // Backend info should persist - it's proactive communication
+            toastDuration: 5000,
+        },
+        warning: {
+            addToCenter: true,
+            toastDuration: 6000,
+        },
+        error: {
+            addToCenter: true, // Always persist backend errors
+            toastDuration: 8000,
+        },
+    },
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Policy Resolution
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Get the effective display behavior for a notification
+ *
+ * Resolution order:
+ * 1. Start with base policy for the notification type
+ * 2. Apply source-specific overrides
+ * 3. Apply per-notification overrides (if provided)
+ *
+ * @param type - The notification type (success, info, warning, error)
+ * @param source - The notification source (resource, custom)
+ * @param overridePolicy - Optional per-notification policy override
+ * @returns The resolved display behavior
+ */
+export function getNotificationDisplayBehavior(type, source, overridePolicy) {
+    // Start with base policy
+    const baseBehavior = NOTIFICATION_DISPLAY_POLICY[type];
+    // Apply source-specific override
+    const sourceOverride = NOTIFICATION_SOURCE_OVERRIDES[source]?.[type];
+    // Merge: base → source override → per-notification override
+    return {
+        ...baseBehavior,
+        ...sourceOverride,
+        ...overridePolicy,
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Default Messages (Fallback)
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Default fallback messages when i18n lookup fails
+ *
+ * These are used as last resort when:
+ * 1. No explicit message is provided
+ * 2. No notification identifier is available
+ * 3. i18n translation is not found
+ */
+export const DEFAULT_NOTIFICATION_MESSAGES = {
+    success: 'Operation completed successfully',
+    info: 'Information',
+    warning: 'Warning',
+    error: 'An error occurred',
+};
+/**
+ * Get default message for a notification type
+ */
+export function getDefaultNotificationMessage(type) {
+    return DEFAULT_NOTIFICATION_MESSAGES[type];
+}
+//# sourceMappingURL=notification-display-policy.frontend.schemas.js.map

package/dist/esm/core/events/notification-display-policy.frontend.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-display-policy.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/events/notification-display-policy.frontend.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/events/toast.d.ts

@@ -0,0 +1,2 @@
+export { toast } from 'sonner';
+//# sourceMappingURL=toast.d.ts.map

package/dist/esm/core/events/toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../../src/core/events/toast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC"}

package/dist/esm/core/events/toast.js

@@ -0,0 +1,2 @@
+export { toast } from 'sonner';
+//# sourceMappingURL=toast.js.map

package/dist/esm/core/events/toast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.js","sourceRoot":"","sources":["../../../../src/core/events/toast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC"}

package/dist/esm/core/events/useEventBus.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Event Bus Hooks
+ *
+ * Separated from EventBusContext.tsx for React Fast Refresh compatibility.
+ */
+import { useContext } from 'react';
+import { EventBusContext } from './EventBusContext.js';
+import { FrontendEvents, FrontendEventPayloads, SubscribeOptions } from './events.frontend.schemas.js';
+import { FrontendResourceOperationContext } from '../../core/resources/resources.frontend.schemas.js';
+type LoadingHelpersBaseReturn = {
+    isLoading: boolean;
+    offLoading: () => void;
+};
+type CustomLoadingHelpersReturn<TData = unknown> = LoadingHelpersBaseReturn & {
+    startLoading: (data?: TData) => void;
+    endLoading: (data?: TData) => void;
+};
+type ResourceLoadingHelpersReturn = LoadingHelpersBaseReturn & {
+    startLoading: () => void;
+    endLoading: () => void;
+};
+type ResourceLoadingParams = {
+    ctx: FrontendResourceOperationContext;
+    optionalDiscriminator?: string;
+};
+export declare const useEventBus: () => {
+    on: <K extends FrontendEvents>(event: K, handler: (payload: FrontendEventPayloads[K]) => void, filter?: FrontendEventPayloads[K] | ((payload: FrontendEventPayloads[K]) => boolean), opts?: SubscribeOptions<K>) => () => void;
+    emit: <K extends FrontendEvents>(event: K, payload: FrontendEventPayloads[K]) => void;
+    bus: ReturnType<typeof useContext<typeof EventBusContext>>;
+    customLoadingEvent: <TData = unknown>(identifier: string) => CustomLoadingHelpersReturn<TData>;
+    resourceLoadingEvent: (params: ResourceLoadingParams) => ResourceLoadingHelpersReturn;
+    resourceRefreshEvent: (params: ResourceLoadingParams) => {
+        readonly lastRefreshAt: number | null;
+        readonly offRefresh: () => void;
+        readonly refresh: () => void;
+    };
+    wholeAppRefreshEvent: () => {
+        readonly lastRefreshAt: number | null;
+        readonly offRefresh: () => void;
+        readonly refresh: () => void;
+    };
+};
+export declare const useEventEmit: () => (<K extends FrontendEvents>(event: K, payload: FrontendEventPayloads[K]) => void);
+export declare function useEventSubscription<K extends FrontendEvents>(event: K, handler: (payload: FrontendEventPayloads[K]) => void, filter?: FrontendEventPayloads[K] | ((payload: FrontendEventPayloads[K]) => boolean), opts?: SubscribeOptions<K>): void;
+export {};
+//# sourceMappingURL=useEventBus.d.ts.map

package/dist/esm/core/events/useEventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEventBus.d.ts","sourceRoot":"","sources":["../../../../src/core/events/useEventBus.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/events/useEventBus.js

@@ -0,0 +1,194 @@
+/**
+ * Event Bus Hooks
+ *
+ * Separated from EventBusContext.tsx for React Fast Refresh compatibility.
+ */
+import { useContext, useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import isEqual from 'lodash/isEqual';
+import { EventBusContext } from './EventBusContext.js';
+import { FrontendEvents } from './events.frontend.schemas.js';
+import { frontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
+// Normalize contextResourceIdentifiers to a plain record for schema compliance and compare
+function mapToRecord(m) {
+    if (!m)
+        return undefined;
+    return Object.fromEntries(Array.from(m.entries()));
+}
+function fieldsToComparableObject(f) {
+    if (!f)
+        return {};
+    if (f instanceof Map)
+        return Object.fromEntries(Array.from(f.entries()));
+    return f;
+}
+function normalizeLoadingContextResourceIdentifiers(identifiers) {
+    if (!identifiers) {
+        return {};
+    }
+    const normalized = {};
+    for (const [key, value] of Object.entries(identifiers)) {
+        const normalizedValue = typeof value === 'string'
+            ? value
+            : value.resourceId;
+        normalized[key] = normalizedValue;
+    }
+    return normalized;
+}
+export const useEventBus = () => {
+    const bus = useContext(EventBusContext);
+    const customLoadingEvent = useCallback(function (identifier) {
+        const [isLoading, setIsLoading] = useState(false);
+        const offStartRef = useRef(() => { });
+        const offEndRef = useRef(() => { });
+        useEffect(() => {
+            offStartRef.current = bus.on(FrontendEvents.LOADING_CUSTOM_START, () => setIsLoading(true), (p) => p.identifier === identifier);
+            offEndRef.current = bus.on(FrontendEvents.LOADING_CUSTOM_END, () => setIsLoading(false), (p) => p.identifier === identifier);
+            return () => {
+                offStartRef.current?.();
+                offEndRef.current?.();
+            };
+        }, [bus, identifier]);
+        const offLoading = useCallback(() => {
+            offStartRef.current?.();
+            offEndRef.current?.();
+        }, []);
+        const startLoading = useCallback((data) => {
+            bus.emit(FrontendEvents.LOADING_CUSTOM_START, { identifier, data });
+        }, [bus, identifier]);
+        const endLoading = useCallback((data) => {
+            bus.emit(FrontendEvents.LOADING_CUSTOM_END, { identifier, data });
+        }, [bus, identifier]);
+        return { isLoading, offLoading, startLoading, endLoading };
+    }, [bus]);
+    const resourceLoadingEvent = useCallback((params) => {
+        const { ctx, optionalDiscriminator } = params;
+        const [isLoading, setIsLoading] = useState(false);
+        const offStartRef = useRef(() => { });
+        const offEndRef = useRef(() => { });
+        const matches = useCallback((p) => {
+            const sameBase = (p.resourceType === ctx.resourceType &&
+                p.operationIdentifier === ctx.operationIdentifier &&
+                (p.variantKey ?? undefined) === (ctx.variantKey ?? undefined) &&
+                !!p.isBulkOperation === !!ctx.isBulkOperation &&
+                !!p.isOperationDefault === !!ctx.isOperationDefault);
+            const discrOk = (optionalDiscriminator === undefined) || p.optionalDiscriminator === optionalDiscriminator;
+            const fieldsOk = isEqual(normalizeLoadingContextResourceIdentifiers(ctx.contextResourceIdentifiers), p.contextResourceIdentifiers ?? {});
+            return sameBase && discrOk && fieldsOk;
+        }, [ctx.resourceType, ctx.operationIdentifier, ctx.variantKey, ctx.isBulkOperation, ctx.isOperationDefault, ctx.contextResourceIdentifiers, optionalDiscriminator]);
+        useEffect(() => {
+            offStartRef.current = bus.on(FrontendEvents.LOADING_RESOURCE_START, () => setIsLoading(true), (p) => matches(p));
+            offEndRef.current = bus.on(FrontendEvents.LOADING_RESOURCE_END, () => setIsLoading(false), (p) => matches(p));
+            return () => {
+                offStartRef.current?.();
+                offEndRef.current?.();
+            };
+        }, [bus, matches]);
+        const offLoading = useCallback(() => {
+            offStartRef.current?.();
+            offEndRef.current?.();
+        }, []);
+        const startLoading = useCallback(() => {
+            bus.emit(FrontendEvents.LOADING_RESOURCE_START, {
+                resourceType: ctx.resourceType,
+                operationIdentifier: ctx.operationIdentifier,
+                variantKey: ctx.variantKey,
+                isBulkOperation: ctx.isBulkOperation,
+                isOperationDefault: ctx.isOperationDefault,
+                contextResourceIdentifiers: normalizeLoadingContextResourceIdentifiers(ctx.contextResourceIdentifiers),
+                optionalDiscriminator,
+            });
+        }, [bus, ctx.resourceType, ctx.operationIdentifier, ctx.variantKey, ctx.isBulkOperation, ctx.isOperationDefault, ctx.contextResourceIdentifiers, optionalDiscriminator]);
+        const endLoading = useCallback(() => {
+            bus.emit(FrontendEvents.LOADING_RESOURCE_END, {
+                resourceType: ctx.resourceType,
+                operationIdentifier: ctx.operationIdentifier,
+                variantKey: ctx.variantKey,
+                isBulkOperation: ctx.isBulkOperation,
+                isOperationDefault: ctx.isOperationDefault,
+                contextResourceIdentifiers: normalizeLoadingContextResourceIdentifiers(ctx.contextResourceIdentifiers),
+                optionalDiscriminator,
+            });
+        }, [bus, ctx.resourceType, ctx.operationIdentifier, ctx.variantKey, ctx.isBulkOperation, ctx.isOperationDefault, ctx.contextResourceIdentifiers, optionalDiscriminator]);
+        return { isLoading, offLoading, startLoading, endLoading };
+    }, [bus]);
+    const resourceRefreshEvent = useCallback((params) => {
+        const { ctx, optionalDiscriminator } = params;
+        const [lastRefreshAt, setLastRefreshAt] = useState(null);
+        const offRef = useRef(() => { });
+        const matches = useCallback((p) => {
+            const ctxPrimaryResourceId = frontendResourceUtils.getPrimaryResourceIdentifier(ctx);
+            const pPrimaryResourceId = frontendResourceUtils.getPrimaryResourceIdentifier(p);
+            const sameBase = (pPrimaryResourceId === ctxPrimaryResourceId &&
+                p.operationIdentifier === ctx.operationIdentifier &&
+                (p.variantKey ?? undefined) === (ctx.variantKey ?? undefined) &&
+                !!p.isBulkOperation === !!ctx.isBulkOperation &&
+                !!p.isOperationDefault === !!ctx.isOperationDefault);
+            const discrOk = (optionalDiscriminator === undefined) || p.optionalDiscriminator === optionalDiscriminator;
+            const fieldsOk = isEqual(fieldsToComparableObject(ctx.contextResourceIdentifiers), fieldsToComparableObject(p.contextResourceIdentifiers));
+            return sameBase && discrOk && fieldsOk;
+        }, [frontendResourceUtils.getPrimaryResourceIdentifier(ctx), ctx.operationIdentifier, ctx.variantKey, ctx.isBulkOperation, ctx.isOperationDefault, ctx.contextResourceIdentifiers, optionalDiscriminator]);
+        useEffect(() => {
+            offRef.current = bus.on(FrontendEvents.RESOURCE_REFRESH, () => setLastRefreshAt(Date.now()), (p) => matches(p));
+            return () => {
+                offRef.current?.();
+            };
+        }, [bus, matches]);
+        const offRefresh = useCallback(() => {
+            offRef.current?.();
+        }, []);
+        const refresh = useCallback(() => {
+            bus.emit(FrontendEvents.RESOURCE_REFRESH, {
+                ...ctx,
+                contextResourceIdentifiers: mapToRecord(ctx.contextResourceIdentifiers),
+                optionalDiscriminator,
+            });
+        }, [bus, ctx, optionalDiscriminator]);
+        return { lastRefreshAt, offRefresh, refresh };
+    }, [bus]);
+    const wholeAppRefreshEvent = useCallback(() => {
+        const [lastRefreshAt, setLastRefreshAt] = useState(null);
+        const offRef = useRef(() => { });
+        useEffect(() => {
+            offRef.current = bus.on(FrontendEvents.WHOLE_APP_REFRESH, () => setLastRefreshAt(Date.now()));
+            return () => {
+                offRef.current?.();
+            };
+        }, [bus]);
+        const offRefresh = useCallback(() => {
+            offRef.current?.();
+        }, []);
+        const refresh = useCallback(() => {
+            bus.emit(FrontendEvents.WHOLE_APP_REFRESH, {});
+        }, [bus]);
+        return { lastRefreshAt, offRefresh, refresh };
+    }, [bus]);
+    const on = useCallback((event, handler, filter, opts) => bus.on(event, handler, filter, opts), [bus]);
+    const emit = useCallback((event, payload) => {
+        bus.emit(event, payload);
+    }, [bus]);
+    // Note: Return type is explicitly any-casted due to complex generic inference issues with FrontendEventPayloads
+    return useMemo(() => ({
+        on,
+        emit,
+        bus,
+        customLoadingEvent,
+        resourceLoadingEvent,
+        resourceRefreshEvent,
+        wholeAppRefreshEvent,
+    }), [on, emit, bus, customLoadingEvent, resourceLoadingEvent, resourceRefreshEvent, wholeAppRefreshEvent]);
+};
+// Simple helpers for emitting and subscribing with typing
+export const useEventEmit = () => {
+    const bus = useContext(EventBusContext);
+    return useCallback(function (event, payload) {
+        bus.emit(event, payload);
+    }, [bus]);
+};
+export function useEventSubscription(event, handler, filter, opts) {
+    const bus = useContext(EventBusContext);
+    useEffect(() => {
+        const off = bus.on(event, handler, filter, opts);
+        return () => off();
+    }, [bus, event, handler, filter, opts]);
+}
+//# sourceMappingURL=useEventBus.js.map

package/dist/esm/core/events/useEventBus.js.map

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

package/dist/esm/core/events/useNotification.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Notification Hook
+ *
+ * Separated from NotificationContext.tsx for React Fast Refresh compatibility.
+ */
+import { NotificationContextType } from './NotificationContext.js';
+export declare function useNotification(): NotificationContextType;
+//# sourceMappingURL=useNotification.d.ts.map

package/dist/esm/core/events/useNotification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNotification.d.ts","sourceRoot":"","sources":["../../../../src/core/events/useNotification.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAuB,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErF,wBAAgB,eAAe,IAAI,uBAAuB,CAMzD"}

package/dist/esm/core/events/useNotification.js

@@ -0,0 +1,15 @@
+/**
+ * Notification Hook
+ *
+ * Separated from NotificationContext.tsx for React Fast Refresh compatibility.
+ */
+import { useContext } from 'react';
+import { NotificationContext } from './NotificationContext.js';
+export function useNotification() {
+    const context = useContext(NotificationContext);
+    if (context === undefined) {
+        throw new Error('useNotification must be used within a NotificationProvider');
+    }
+    return context;
+}
+//# sourceMappingURL=useNotification.js.map

package/dist/esm/core/events/useNotification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNotification.js","sourceRoot":"","sources":["../../../../src/core/events/useNotification.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAA2B,MAAM,uBAAuB,CAAC;AAErF,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAChD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/esm/core/execution/ExecutionRuntimeContext.d.ts

@@ -0,0 +1,90 @@
+import React from 'react';
+import type { ExecutionViewDefinition } from '../../core/config/execution-view.schemas.js';
+import type { ResourceRegistryContextType } from '../../core/resources/ResourceRegistryContext.js';
+import type { NavigateOptions } from '../../core/navigation/useNavigationController.js';
+import type { NavigationContent, NavigationInitiatorContext, NavigationZone } from '../../core/navigation/navigation.schemas.js';
+export declare enum ExecutionAnchorSource {
+    PARENT_RESOURCE_REQUIREMENT = "parent-resource-requirement",
+    ADDITIONAL_RESOURCE_REQUIREMENT = "additional-resource-requirement"
+}
+/**
+ * Minimal resolved anchor for the first execution runtime slice.
+ *
+ * This anchor is intentionally conservative: it is only resolved from declared
+ * resource requirements that also have a concrete bound identifier in the
+ * execution context. Ambient primary scope alone is not enough to synthesize an
+ * anchor because primary scope identifies environment, not necessarily subject.
+ */
+export interface ExecutionAnchor {
+    mainResourceType: string;
+    mainResourceId: string;
+    bindingKey: string;
+    source: ExecutionAnchorSource;
+}
+export interface ExecutionLocalPaneState {
+    paneId: string;
+    payload?: unknown;
+}
+/**
+ * Minimal runtime state for the first routed execution host slice.
+ *
+ * This starts with only local pane state so the framework can already own one
+ * execution-local interaction channel without pretending the full slot/choreography
+ * runtime is finished.
+ */
+export interface ExecutionRuntimeState {
+    localPane: ExecutionLocalPaneState | null;
+}
+/**
+ * Minimal execution navigation contract for the first routed host slice.
+ *
+ * The execution runtime deliberately reuses the existing navigation controller
+ * instead of introducing a second navigation stack owner.
+ */
+export interface ExecutionNavigationValue {
+    delegateToParent: (options: {
+        content: NavigationContent;
+        urlPath?: string;
+        contextResourceIdentifiers?: Record<string, string>;
+        relationshipTransition?: NavigateOptions['relationshipTransition'];
+        initiator?: Omit<NavigationInitiatorContext, 'sourceZone'>;
+    }) => void;
+    openLocalPane: (paneId: string, payload?: unknown) => void;
+    closeLocalPane: () => void;
+}
+/**
+ * Minimal runtime context carried by the framework-owned execution host.
+ *
+ * This establishes the first real execution runtime seam:
+ * - view definition resolution
+ * - scope/context propagation
+ * - stable runtime-instance identity
+ * - conservative anchor resolution from explicit declared bindings
+ * - minimal framework-owned local pane state
+ * - reuse of the shared `doOperation()` abstraction
+ * - delegation to the existing navigation controller
+ */
+export interface ExecutionRuntimeContextValue {
+    viewDefinition: ExecutionViewDefinition;
+    contextResourceIdentifiers?: Record<string, string>;
+    runtimeInstanceId: string;
+    navigationZone: NavigationZone;
+    doOperation: ResourceRegistryContextType['doOperation'];
+    navigation: ExecutionNavigationValue;
+    anchor: ExecutionAnchor | null;
+    runtimeState: ExecutionRuntimeState;
+}
+export interface ExecutionRuntimeProviderProps {
+    children: React.ReactNode;
+    viewDefinition: ExecutionViewDefinition;
+    contextResourceIdentifiers?: Record<string, string>;
+    runtimeInstanceId: string;
+    navigationZone: NavigationZone;
+    doOperation: ResourceRegistryContextType['doOperation'];
+    navigation: ExecutionNavigationValue;
+    anchor: ExecutionAnchor | null;
+    runtimeState: ExecutionRuntimeState;
+}
+export declare const ExecutionRuntimeContext: React.Context<ExecutionRuntimeContextValue>;
+export declare const ExecutionRuntimeProvider: React.FC<ExecutionRuntimeProviderProps>;
+//# sourceMappingURL=ExecutionRuntimeContext.d.ts.map

package/dist/esm/core/execution/ExecutionRuntimeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionRuntimeContext.d.ts","sourceRoot":"","sources":["../../../../src/core/execution/ExecutionRuntimeContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiC,MAAM,OAAO,CAAC;AAEtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wDAAwD,CAAC;AACtG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4DAA4D,CAAC;AAC9G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6DAA6D,CAAC;AACnG,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AAE5I,oBAAY,qBAAqB;IAC/B,2BAA2B,gCAAgC;IAC3D,+BAA+B,oCAAoC;CACpE;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,EAAE,CAAC,OAAO,EAAE;QAC1B,OAAO,EAAE,iBAAiB,CAAC;QAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpD,sBAAsB,CAAC,EAAE,eAAe,CAAC,wBAAwB,CAAC,CAAC;QACnE,SAAS,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,YAAY,CAAC,CAAC;KAC5D,KAAK,IAAI,CAAC;IACX,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3D,cAAc,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,4BAA4B;IAC3C,cAAc,EAAE,uBAAuB,CAAC;IACxC,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,2BAA2B,CAAC,aAAa,CAAC,CAAC;IACxD,UAAU,EAAE,wBAAwB,CAAC;IACrC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,qBAAqB,CAAC;CACrC;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,cAAc,EAAE,uBAAuB,CAAC;IACxC,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,2BAA2B,CAAC,aAAa,CAAC,CAAC;IACxD,UAAU,EAAE,wBAAwB,CAAC;IACrC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,qBAAqB,CAAC;CACrC;AAED,eAAO,MAAM,uBAAuB,6CAAqE,CAAC;AAE1G,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,EAAE,CAAC,6BAA6B,CA2B5E,CAAC"}

package/dist/esm/core/execution/ExecutionRuntimeContext.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useMemo } from 'react';
+export var ExecutionAnchorSource;
+(function (ExecutionAnchorSource) {
+    ExecutionAnchorSource["PARENT_RESOURCE_REQUIREMENT"] = "parent-resource-requirement";
+    ExecutionAnchorSource["ADDITIONAL_RESOURCE_REQUIREMENT"] = "additional-resource-requirement";
+})(ExecutionAnchorSource || (ExecutionAnchorSource = {}));
+export const ExecutionRuntimeContext = createContext(undefined);
+export const ExecutionRuntimeProvider = ({ children, viewDefinition, contextResourceIdentifiers, runtimeInstanceId, navigationZone, doOperation, navigation, anchor, runtimeState, }) => {
+    const value = useMemo(() => ({
+        viewDefinition,
+        contextResourceIdentifiers,
+        runtimeInstanceId,
+        navigationZone,
+        doOperation,
+        navigation,
+        anchor,
+        runtimeState,
+    }), [viewDefinition, contextResourceIdentifiers, runtimeInstanceId, navigationZone, doOperation, navigation, anchor, runtimeState]);
+    return (_jsx(ExecutionRuntimeContext.Provider, { value: value, children: children }));
+};
+//# sourceMappingURL=ExecutionRuntimeContext.js.map

package/dist/esm/core/execution/ExecutionRuntimeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionRuntimeContext.js","sourceRoot":"","sources":["../../../../src/core/execution/ExecutionRuntimeContext.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAOtD,MAAM,CAAN,IAAY,qBAGX;AAHD,WAAY,qBAAqB;IAC/B,oFAA2D,CAAA;IAC3D,4FAAmE,CAAA;AACrE,CAAC,EAHW,qBAAqB,KAArB,qBAAqB,QAGhC;AAsFD,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAa,CAA2C,SAAS,CAAC,CAAC;AAE1G,MAAM,CAAC,MAAM,wBAAwB,GAA4C,CAAC,EAChF,QAAQ,EACR,cAAc,EACd,0BAA0B,EAC1B,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,UAAU,EACV,MAAM,EACN,YAAY,GACb,EAAE,EAAE;IACH,MAAM,KAAK,GAAG,OAAO,CAA+B,GAAG,EAAE,CAAC,CAAC;QACzD,cAAc;QACd,0BAA0B;QAC1B,iBAAiB;QACjB,cAAc;QACd,WAAW;QACX,UAAU;QACV,MAAM;QACN,YAAY;KACb,CAAC,EAAE,CAAC,cAAc,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAEpI,OAAO,CACL,KAAC,uBAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC3C,QAAQ,GACwB,CACpC,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/core/execution/execution-anchor.utils.d.ts

@@ -0,0 +1,12 @@
+import { type ExecutionViewDefinition } from '../../core/config/execution-view.schemas.js';
+import { type ExecutionAnchor } from './ExecutionRuntimeContext.js';
+/**
+ * Resolves the declared execution anchor from explicit navigation-time bindings.
+ *
+ * Important constraints:
+ * - the anchor contract must point to one stable declared binding key
+ * - merged ambient scope is intentionally ignored here
+ * - duplicate declared binding keys fail closed instead of picking by order
+ */
+export declare function resolveExecutionAnchor(viewDefinition: ExecutionViewDefinition, explicitContextResourceIdentifiers?: Record<string, string>): ExecutionAnchor | null;
+//# sourceMappingURL=execution-anchor.utils.d.ts.map

package/dist/esm/core/execution/execution-anchor.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-anchor.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/execution/execution-anchor.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,wDAAwD,CAAC;AAEhE,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAC;AAYnC;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,uBAAuB,EACvC,kCAAkC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1D,eAAe,GAAG,IAAI,CAqCxB"}