@zealicsolutions/web-ui 1.0.140-beta.224 → 1.0.140-beta.226

package/dist/cjs/contexts/WebpageContext/WebpageContext.d.ts

@@ -92,5 +92,18 @@ export type WebpageContextType = {
      * The host application can decide what payload to support here.
      */
     openAIChat?: (options?: OpenAIChatOptions) => void | Promise<void>;
+    /**
+     * Dynamic context data published by molecules on the page.
+     * Molecules configured with `publishToWebpageContext` will add their resolved
+     * values here using `webpageContextKey` as the key.
+     * Any consumer (e.g., Cortex AI, analytics) can read this context.
+     */
+    dynamicContext?: Record<string, unknown>;
+    /**
+     * Callback for molecules to publish their resolved values to the webpage context.
+     * @param key - The context key (e.g., "studyId", "subjectId")
+     * @param value - The resolved value to store
+     */
+    setDynamicContextValue?: (key: string, value: unknown) => void;
 };
 export declare const WebpageContext: React.Context<WebpageContextType | undefined>;

package/dist/cjs/contexts/WebpageContext/WebpageContextProvider.d.ts

@@ -1,6 +1,12 @@
 import type { FC, ReactNode } from 'react';
 import { type WebpageContextType } from './WebpageContext';
-export interface WebpageContextProviderProps extends WebpageContextType {
+export interface WebpageContextProviderProps extends Omit<WebpageContextType, 'dynamicContext' | 'setDynamicContextValue'> {
     children: ReactNode;
+    /**
+     * Callback invoked when molecules publish context values.
+     * Used to notify parent components (e.g., CortexProvider) of dynamic context changes.
+     * @param context - The full dynamicContext object with all published values
+     */
+    onDynamicContextChange?: (context: Record<string, unknown>) => void;
 }
 export declare const WebpageContextProvider: FC<WebpageContextProviderProps>;

package/dist/cjs/contexts/WebpageContext/useWebpageContext.d.ts

@@ -1 +1,7 @@
-export declare const useWebpageContext: () => import("./WebpageContext").WebpageContextType;
+import { WebpageContextType } from './WebpageContext';
+export declare const useWebpageContext: () => WebpageContextType;
+/**
+ * Safe version of useWebpageContext that returns undefined if not within a provider.
+ * Use this in molecules that may render outside of a webpage context (e.g., Storybook).
+ */
+export declare const useWebpageContextSafe: () => WebpageContextType | undefined;