@supernal/interface 1.0.2 → 1.0.4

package/dist/esm/src/mcp/transport.js

@@ -0,0 +1,126 @@
+/**
+ * Stdio Transport for MCP
+ *
+ * Implements MCP transport over stdin/stdout for integration with
+ * Claude Desktop, Cursor, and other MCP clients.
+ */
+import { createInterface } from 'readline';
+/**
+ * Stdio transport implementation
+ *
+ * Reads JSON-RPC messages from stdin (one per line)
+ * Writes JSON-RPC responses to stdout (one per line)
+ */
+export class StdioTransport {
+    constructor() {
+        this.messageQueue = [];
+        this.waitingResolvers = [];
+        this.closed = false;
+        this.setupReadline();
+    }
+    /**
+     * Setup readline interface for stdin
+     */
+    setupReadline() {
+        this.readline = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            terminal: false
+        });
+        this.readline.on('line', (line) => {
+            try {
+                const message = JSON.parse(line);
+                // If someone is waiting for a message, give it to them immediately
+                if (this.waitingResolvers.length > 0) {
+                    const resolve = this.waitingResolvers.shift();
+                    resolve(message);
+                }
+                else {
+                    // Otherwise queue it
+                    this.messageQueue.push(message);
+                }
+            }
+            catch (error) {
+                console.error('[Stdio Transport] Failed to parse message:', error);
+                console.error('[Stdio Transport] Line:', line);
+            }
+        });
+        this.readline.on('close', () => {
+            this.closed = true;
+            // Reject all waiting resolvers
+            for (const resolve of this.waitingResolvers) {
+                resolve({
+                    jsonrpc: '2.0',
+                    method: '__transport_closed__'
+                });
+            }
+            this.waitingResolvers = [];
+        });
+    }
+    /**
+     * Send message to client (write to stdout)
+     */
+    async send(message) {
+        if (this.closed) {
+            throw new Error('Transport is closed');
+        }
+        const json = JSON.stringify(message);
+        process.stdout.write(json + '\n');
+    }
+    /**
+     * Receive message from client (read from stdin)
+     */
+    async receive() {
+        if (this.closed) {
+            throw new Error('Transport is closed');
+        }
+        // If we have queued messages, return the first one
+        if (this.messageQueue.length > 0) {
+            return this.messageQueue.shift();
+        }
+        // Otherwise wait for the next message
+        return new Promise((resolve) => {
+            this.waitingResolvers.push(resolve);
+        });
+    }
+    /**
+     * Close transport
+     */
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        if (this.readline) {
+            this.readline.close();
+            this.readline = undefined;
+        }
+        // Reject all waiting resolvers
+        for (const resolve of this.waitingResolvers) {
+            resolve({
+                jsonrpc: '2.0',
+                method: '__transport_closed__'
+            });
+        }
+        this.waitingResolvers = [];
+        this.messageQueue = [];
+    }
+}
+/**
+ * Create stdio transport
+ *
+ * @returns Stdio transport instance
+ *
+ * @example
+ * ```typescript
+ * import { createSupernalMCPServer, createStdioTransport } from '@supernal/interface';
+ *
+ * const server = createSupernalMCPServer();
+ * const transport = createStdioTransport();
+ *
+ * await server.start(transport);
+ * ```
+ */
+export function createStdioTransport() {
+    return new StdioTransport();
+}
+//# sourceMappingURL=transport.js.map

package/dist/esm/src/mcp/transport.js.map

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

package/dist/esm/src/mcp/types.d.ts

@@ -0,0 +1,175 @@
+/**
+ * MCP Protocol Types
+ *
+ * Type definitions for Model Context Protocol (MCP) integration.
+ * Based on @ai-sdk/mcp specification.
+ */
+/**
+ * MCP tool parameter schema
+ */
+export interface MCPToolParameter {
+    type: string;
+    description?: string;
+    required?: boolean;
+    properties?: Record<string, MCPToolParameter>;
+    items?: MCPToolParameter;
+    enum?: string[];
+    default?: any;
+}
+/**
+ * MCP tool definition
+ */
+export interface MCPTool {
+    /** Unique tool identifier (container.toolName format) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** JSON Schema for tool parameters */
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, MCPToolParameter>;
+        required?: string[];
+    };
+    /** Optional annotations for additional metadata */
+    annotations?: {
+        container?: string;
+        category?: string;
+        elementId?: string;
+        componentName?: string;
+        [key: string]: any;
+    };
+}
+/**
+ * MCP tools/list response
+ */
+export interface MCPToolsListResponse {
+    tools: MCPTool[];
+}
+/**
+ * MCP tools/call request
+ */
+export interface MCPToolCallRequest {
+    name: string;
+    arguments: Record<string, any>;
+}
+/**
+ * MCP content types
+ */
+export type MCPContentType = 'text' | 'image' | 'resource';
+/**
+ * MCP text content
+ */
+export interface MCPTextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * MCP image content
+ */
+export interface MCPImageContent {
+    type: 'image';
+    data: string;
+    mimeType: string;
+}
+/**
+ * MCP resource content
+ */
+export interface MCPResourceContent {
+    type: 'resource';
+    resource: {
+        uri: string;
+        mimeType?: string;
+        text?: string;
+    };
+}
+/**
+ * Union of all MCP content types
+ */
+export type MCPContent = MCPTextContent | MCPImageContent | MCPResourceContent;
+/**
+ * MCP tools/call response
+ */
+export interface MCPToolCallResponse {
+    content: MCPContent[];
+    isError?: boolean;
+}
+/**
+ * MCP server configuration
+ */
+export interface MCPServerConfig {
+    /** Server name */
+    name: string;
+    /** Server version */
+    version: string;
+    /** Optional description */
+    description?: string;
+    /** Optional capabilities */
+    capabilities?: {
+        tools?: {};
+        resources?: {};
+        prompts?: {};
+    };
+}
+/**
+ * MCP error codes
+ */
+export declare enum MCPErrorCode {
+    PARSE_ERROR = -32700,
+    INVALID_REQUEST = -32600,
+    METHOD_NOT_FOUND = -32601,
+    INVALID_PARAMS = -32602,
+    INTERNAL_ERROR = -32603,
+    TOOL_NOT_FOUND = -1,
+    TOOL_EXECUTION_FAILED = -2
+}
+/**
+ * MCP error
+ */
+export interface MCPError {
+    code: MCPErrorCode;
+    message: string;
+    data?: any;
+}
+/**
+ * MCP request
+ */
+export interface MCPRequest {
+    jsonrpc: '2.0';
+    id?: string | number;
+    method: string;
+    params?: any;
+}
+/**
+ * MCP response
+ */
+export interface MCPResponse {
+    jsonrpc: '2.0';
+    id?: string | number;
+    result?: any;
+    error?: MCPError;
+}
+/**
+ * MCP transport interface
+ */
+export interface MCPTransport {
+    /** Send message to client */
+    send(message: MCPResponse): Promise<void>;
+    /** Receive message from client */
+    receive(): Promise<MCPRequest>;
+    /** Close transport */
+    close(): Promise<void>;
+}
+/**
+ * MCP server interface
+ */
+export interface MCPServer {
+    /** Server configuration */
+    config: MCPServerConfig;
+    /** Start server (transport provided externally) */
+    start(transport: MCPTransport): Promise<void>;
+    /** Stop server */
+    stop(): Promise<void>;
+    /** Handle incoming request */
+    handle(request: MCPRequest): Promise<MCPResponse | null>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/src/mcp/types.d.ts.map

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

package/dist/esm/src/mcp/types.js

@@ -0,0 +1,20 @@
+/**
+ * MCP Protocol Types
+ *
+ * Type definitions for Model Context Protocol (MCP) integration.
+ * Based on @ai-sdk/mcp specification.
+ */
+/**
+ * MCP error codes
+ */
+export var MCPErrorCode;
+(function (MCPErrorCode) {
+    MCPErrorCode[MCPErrorCode["PARSE_ERROR"] = -32700] = "PARSE_ERROR";
+    MCPErrorCode[MCPErrorCode["INVALID_REQUEST"] = -32600] = "INVALID_REQUEST";
+    MCPErrorCode[MCPErrorCode["METHOD_NOT_FOUND"] = -32601] = "METHOD_NOT_FOUND";
+    MCPErrorCode[MCPErrorCode["INVALID_PARAMS"] = -32602] = "INVALID_PARAMS";
+    MCPErrorCode[MCPErrorCode["INTERNAL_ERROR"] = -32603] = "INTERNAL_ERROR";
+    MCPErrorCode[MCPErrorCode["TOOL_NOT_FOUND"] = -1] = "TOOL_NOT_FOUND";
+    MCPErrorCode[MCPErrorCode["TOOL_EXECUTION_FAILED"] = -2] = "TOOL_EXECUTION_FAILED";
+})(MCPErrorCode || (MCPErrorCode = {}));
+//# sourceMappingURL=types.js.map

package/dist/esm/src/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6HH;;GAEG;AACH,MAAM,CAAN,IAAY,YAQX;AARD,WAAY,YAAY;IACtB,kEAAoB,CAAA;IACpB,0EAAwB,CAAA;IACxB,4EAAyB,CAAA;IACzB,wEAAuB,CAAA;IACvB,wEAAuB,CAAA;IACvB,oEAAmB,CAAA;IACnB,kFAA0B,CAAA;AAC5B,CAAC,EARW,YAAY,KAAZ,YAAY,QAQvB"}

package/dist/esm/src/mcp-cli.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Supernal MCP CLI Entry Point
+ *
+ * Starts the Supernal MCP server with stdio transport for use with
+ * Claude Desktop, Cursor, and other MCP clients.
+ *
+ * Usage:
+ * ```bash
+ * npx @supernal/interface-mcp
+ * ```
+ *
+ * Or in Claude Desktop config:
+ * ```json
+ * {
+ *   "mcpServers": {
+ *     "supernal": {
+ *       "command": "npx",
+ *       "args": ["@supernal/interface-mcp"]
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export {};
+//# sourceMappingURL=mcp-cli.d.ts.map

package/dist/esm/src/mcp-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-cli.d.ts","sourceRoot":"","sources":["../../../src/mcp-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG"}

package/dist/esm/src/mcp-cli.js

@@ -0,0 +1,53 @@
+/**
+ * Supernal MCP CLI Entry Point
+ *
+ * Starts the Supernal MCP server with stdio transport for use with
+ * Claude Desktop, Cursor, and other MCP clients.
+ *
+ * Usage:
+ * ```bash
+ * npx @supernal/interface-mcp
+ * ```
+ *
+ * Or in Claude Desktop config:
+ * ```json
+ * {
+ *   "mcpServers": {
+ *     "supernal": {
+ *       "command": "npx",
+ *       "args": ["@supernal/interface-mcp"]
+ *     }
+ *   }
+ * }
+ * ```
+ */
+import { createSupernalMCPServer, createStdioTransport } from './mcp/index.js';
+async function main() {
+    const server = createSupernalMCPServer({
+        name: 'supernal-interface',
+        version: '1.0.0',
+        description: 'MCP server for Supernal Interface tools'
+    });
+    const transport = createStdioTransport();
+    console.error('[Supernal MCP] Starting server...');
+    try {
+        await server.start(transport);
+    }
+    catch (error) {
+        console.error('[Supernal MCP] Server error:', error);
+        process.exit(1);
+    }
+}
+// Handle shutdown gracefully
+const handleShutdown = () => {
+    console.error('[Supernal MCP] Shutting down...');
+    process.exit(0);
+};
+process.on('SIGINT', handleShutdown);
+process.on('SIGTERM', handleShutdown);
+// Start server
+main().catch((error) => {
+    console.error('[Supernal MCP] Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=mcp-cli.js.map

package/dist/esm/src/mcp-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-cli.js","sourceRoot":"","sources":["../../../src/mcp-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAEtE,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,uBAAuB,CAAC;QACrC,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,yCAAyC;KACvD,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IAEzC,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,6BAA6B;AAC7B,MAAM,cAAc,GAAG,GAAG,EAAE;IAC1B,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,OAAO,CAAC,EAAE,CAAC,QAAe,EAAE,cAAc,CAAC,CAAC;AAC5C,OAAO,CAAC,EAAE,CAAC,SAAgB,EAAE,cAAc,CAAC,CAAC;AAE7C,eAAe;AACf,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/esm/src/mcp-server.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP Server Entry Point (Node.js only)
+ *
+ * This file should ONLY be used in Node.js environments (MCP servers).
+ * DO NOT import this in browser code.
+ *
+ * For browser usage, import from '@supernal/interface' (without /mcp)
+ */
+export { createSupernalMCPServer, createStdioTransport, SupernalMCPServer, StdioTransport, type MCPServer, type MCPServerConfig, type MCPTransport, type MCPRequest, type MCPResponse, type MCPTool, type MCPToolsListResponse, type MCPToolCallRequest, type MCPToolCallResponse } from './mcp';
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/esm/src/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,OAAO,CAAC"}

package/dist/esm/src/mcp-server.js

@@ -0,0 +1,10 @@
+/**
+ * MCP Server Entry Point (Node.js only)
+ *
+ * This file should ONLY be used in Node.js environments (MCP servers).
+ * DO NOT import this in browser code.
+ *
+ * For browser usage, import from '@supernal/interface' (without /mcp)
+ */
+export { createSupernalMCPServer, createStdioTransport, SupernalMCPServer, StdioTransport } from './mcp/index.js';
+//# sourceMappingURL=mcp-server.js.map

package/dist/esm/src/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../../../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EAUf,MAAM,OAAO,CAAC"}

package/dist/esm/src/react/useNavigationHandler.d.ts

@@ -2,20 +2,28 @@
  * useNavigationHandler - React Hook for Automatic Navigation Setup
  *
  * Single-line hook that sets up navigation for any page.
- * Uses NavigationGraph to automatically resolve routes from container definitions.
+ * Now also tracks location in LocationContext for location-aware tools.
  *
- * This eliminates the need for manual route maps in every page component.
+ * This hook:
+ * 1. Tracks current page/route in LocationContext
+ * 2. Sets up navigation handler in NavigationGraph
+ * 3. Updates location when route changes
  */
 /**
  * Set up automatic navigation handler for the current page
  *
  * This hook:
- * 1. Gets routes from NavigationGraph (populated by container definitions)
- * 2. Creates a handler that resolves page names → routes
- * 3. Registers the handler with NavigationGraph
- * 4. Supports dynamic routes (e.g., "blog/post-slug")
- *
- * @param router - Next.js router or any router with a `push` method
+ * 1. Tracks current page/route in LocationContext for location-aware tools
+ * 2. Gets routes from NavigationGraph (populated by container definitions)
+ * 3. Creates a handler that resolves page names → routes
+ * 4. Registers the handler with NavigationGraph
+ * 5. Supports dynamic routes (e.g., "blog/post-slug")
+ *
+ * @param router - Next.js router or any router with `push`, `pathname`, `route`
+ * @param options - Optional configuration
+ * @param options.components - Currently mounted component IDs
+ * @param options.elements - Currently visible element IDs
+ * @param options.metadata - Additional location metadata
  *
  * @example
  * ```typescript
@@ -24,7 +32,8 @@
  *
  * export default function MyPage() {
  *   const router = useRouter();
- *   useNavigationHandler(router); // ← ONE LINE!
+ *   // Track location automatically
+ *   useNavigationHandler(router);
  *
  *   return <div>...</div>;
  * }
@@ -32,11 +41,20 @@
  *
  * @example
  * ```typescript
- * // Without a router (uses window.location as fallback)
- * useNavigationHandler();
+ * // With component tracking
+ * useNavigationHandler(router, {
+ *   components: ['blog-header', 'blog-editor'],
+ *   metadata: { userRole: 'editor' }
+ * });
  * ```
  */
 export declare function useNavigationHandler(router?: {
     push: (route: string) => any;
+    pathname?: string;
+    route?: string;
+}, options?: {
+    components?: string[];
+    elements?: string[];
+    metadata?: Record<string, any>;
 }): void;
 //# sourceMappingURL=useNavigationHandler.d.ts.map

package/dist/esm/src/react/useNavigationHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useNavigationHandler.d.ts","sourceRoot":"","sources":["../../../../src/react/useNavigationHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAA;CAAE,GACxC,IAAI,CAkDN"}
+{"version":3,"file":"useNavigationHandler.d.ts","sourceRoot":"","sources":["../../../../src/react/useNavigationHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE;IACP,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC,GACA,IAAI,CAkFN"}

package/dist/esm/src/react/useNavigationHandler.js

@@ -2,22 +2,31 @@
  * useNavigationHandler - React Hook for Automatic Navigation Setup
  *
  * Single-line hook that sets up navigation for any page.
- * Uses NavigationGraph to automatically resolve routes from container definitions.
+ * Now also tracks location in LocationContext for location-aware tools.
  *
- * This eliminates the need for manual route maps in every page component.
+ * This hook:
+ * 1. Tracks current page/route in LocationContext
+ * 2. Sets up navigation handler in NavigationGraph
+ * 3. Updates location when route changes
  */
 import { useEffect } from 'react';
 import { NavigationGraph } from '../background/navigation/NavigationGraph.js';
+import { LocationContext } from '../background/location/LocationContext.js';
 /**
  * Set up automatic navigation handler for the current page
  *
  * This hook:
- * 1. Gets routes from NavigationGraph (populated by container definitions)
- * 2. Creates a handler that resolves page names → routes
- * 3. Registers the handler with NavigationGraph
- * 4. Supports dynamic routes (e.g., "blog/post-slug")
+ * 1. Tracks current page/route in LocationContext for location-aware tools
+ * 2. Gets routes from NavigationGraph (populated by container definitions)
+ * 3. Creates a handler that resolves page names → routes
+ * 4. Registers the handler with NavigationGraph
+ * 5. Supports dynamic routes (e.g., "blog/post-slug")
  *
- * @param router - Next.js router or any router with a `push` method
+ * @param router - Next.js router or any router with `push`, `pathname`, `route`
+ * @param options - Optional configuration
+ * @param options.components - Currently mounted component IDs
+ * @param options.elements - Currently visible element IDs
+ * @param options.metadata - Additional location metadata
  *
  * @example
  * ```typescript
@@ -26,7 +35,8 @@ import { NavigationGraph } from '../background/navigation/NavigationGraph.js';
  *
  * export default function MyPage() {
  *   const router = useRouter();
- *   useNavigationHandler(router); // ← ONE LINE!
+ *   // Track location automatically
+ *   useNavigationHandler(router);
  *
  *   return <div>...</div>;
  * }
@@ -34,13 +44,28 @@ import { NavigationGraph } from '../background/navigation/NavigationGraph.js';
  *
  * @example
  * ```typescript
- * // Without a router (uses window.location as fallback)
- * useNavigationHandler();
+ * // With component tracking
+ * useNavigationHandler(router, {
+ *   components: ['blog-header', 'blog-editor'],
+ *   metadata: { userRole: 'editor' }
+ * });
  * ```
  */
-export function useNavigationHandler(router) {
+export function useNavigationHandler(router, options) {
     useEffect(() => {
         const graph = NavigationGraph.getInstance();
+        // Update LocationContext with current page/route
+        if (router) {
+            const page = router.pathname || '/';
+            const route = router.route || router.pathname || '/';
+            LocationContext.setCurrent({
+                page,
+                route,
+                components: options?.components,
+                elements: options?.elements,
+                metadata: options?.metadata
+            });
+        }
         const handler = (pageNameOrRoute) => {
             const pageName = typeof pageNameOrRoute === 'string' ? pageNameOrRoute : pageNameOrRoute?.name || pageNameOrRoute?.path;
             if (!pageName)
@@ -61,6 +86,14 @@ export function useNavigationHandler(router) {
                     else if (typeof window !== 'undefined') {
                         window.location.href = routePath;
                     }
+                    // Update location after navigation
+                    LocationContext.setCurrent({
+                        page: routePath,
+                        route: routePath,
+                        components: options?.components,
+                        elements: options?.elements,
+                        metadata: options?.metadata
+                    });
                 }
                 return;
             }
@@ -74,12 +107,20 @@ export function useNavigationHandler(router) {
             else if (typeof window !== 'undefined') {
                 window.location.href = routePath;
             }
+            // Update location after navigation
+            LocationContext.setCurrent({
+                page: routePath,
+                route: routePath,
+                components: options?.components,
+                elements: options?.elements,
+                metadata: options?.metadata
+            });
         };
         graph.setNavigationHandler(handler);
         return () => {
             // Clean up handler on unmount
             graph.setNavigationHandler(() => { });
         };
-    }, [router]);
+    }, [router, options?.components, options?.elements, options?.metadata]);
 }
 //# sourceMappingURL=useNavigationHandler.js.map

package/dist/esm/src/react/useNavigationHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"useNavigationHandler.js","sourceRoot":"","sources":["../../../../src/react/useNavigationHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAyC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,EAAE,CAAC;QAE5C,MAAM,OAAO,GAAG,CAAC,eAA6B,EAAE,EAAE;YAChD,MAAM,QAAQ,GAAG,OAAO,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,EAAE,IAAI,IAAI,eAAe,EAAE,IAAI,CAAC;YACxH,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAEtB,OAAO,CAAC,GAAG,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;YAEtD,uCAAuC;YACvC,IAAI,KAAK,GAAG,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YAE3C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,8CAA8C,QAAQ,EAAE,CAAC,CAAC;gBAEvE,sEAAsE;gBACtE,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC3B,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;oBACvE,OAAO,CAAC,GAAG,CAAC,8CAA8C,SAAS,EAAE,CAAC,CAAC;oBAEvE,gEAAgE;oBAChE,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;wBACjB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACzB,CAAC;yBAAM,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;wBACzC,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,SAAS,CAAC;oBACnC,CAAC;gBACH,CAAC;gBACD,OAAO;YACT,CAAC;YAED,8BAA8B;YAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,+BAA+B,QAAQ,MAAM,SAAS,EAAE,CAAC,CAAC;YAEtE,gEAAgE;YAChE,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;iBAAM,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;gBACzC,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,SAAS,CAAC;YACnC,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAEpC,OAAO,GAAG,EAAE;YACV,8BAA8B;YAC9B,KAAK,CAAC,oBAAoB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"useNavigationHandler.js","sourceRoot":"","sources":["../../../../src/react/useNavigationHandler.ts"],"names":[],"mappings":"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"}