@bleedingdev/modern-js-mcp-apps 0.0.0-stage → 3.11.3-ultramodern.2

package/dist/types/manifest.d.ts

@@ -0,0 +1,38 @@
+import type { McpUiResourceMeta } from '@modelcontextprotocol/ext-apps';
+export type UiMetadata = McpUiResourceMeta;
+export interface McpViewsConfig extends UiMetadata {
+    /** Default deployed MF remote for expose views. Individual views may override it. */
+    remote?: string;
+    /** A component path, an expose of this application, or an expose of a deployed remote. */
+    views: Record<string, string | {
+        expose: string;
+        remote?: string;
+    }>;
+}
+export interface UiManifest {
+    version: 1;
+    assetBase: string;
+    remotes: Record<string, {
+        entry: string;
+        shell: string;
+    }>;
+    views: Record<string, ({
+        html: string;
+    } | {
+        remote: string;
+        expose: string;
+    }) & {
+        ui: UiMetadata;
+    }>;
+}
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function validateUiMetadata(value: unknown): asserts value is UiMetadata;
+export declare function validateViewsConfig(value: unknown): asserts value is McpViewsConfig;
+/**
+ * A deployed MF remote must be a manifest URL. The MF runtime finds the
+ * container through the manifest only for `.json` entries. Any other entry
+ * would need the remote's real MF name.
+ */
+export declare function assertRemoteManifest(remote: string): void;
+export declare function assertHttpUrl(source: string): URL;
+export declare function validateUiManifest(value: unknown): asserts value is UiManifest;

package/dist/types/server/context.d.ts

@@ -0,0 +1,2 @@
+import type { RegisterUiOptions } from './resources.js';
+export declare const requestUiOptions: WeakMap<Request, Pick<RegisterUiOptions, "manifest" | "mode">>;

package/dist/types/server/index.d.ts

@@ -0,0 +1,34 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+export type { UiManifest, UiMetadata } from '../manifest.js';
+export type { RegisterUiOptions } from './resources.js';
+export { registerUiResources } from './resources.js';
+export type McpServerFactory = (request: Request) => McpServer | Promise<McpServer>;
+export interface FetchHandlerOptions {
+    allowedOrigins?: string[];
+    onError?: (error: Error) => void;
+}
+/** The parts of the Hono request context used by BFF handlers. */
+export interface HonoLikeContext {
+    req: {
+        raw: Request;
+    };
+    get(key: 'locals'): Record<string, unknown> | undefined;
+}
+export interface BffHandlerOptions extends FetchHandlerOptions {
+    /** Returns the current Hono context. Defaults to `useHonoContext` from `@modern-js/server-runtime`. */
+    useContext?: () => HonoLikeContext;
+}
+/** Stateless HTTP adapter. Tool registration and validation belong to the SDK. */
+export declare function createFetchHandler(createServer: McpServerFactory, options?: FetchHandlerOptions): (request: Request) => Promise<Response>;
+/** Export these functions from api/lambda/mcp.ts to expose /api/mcp. */
+export declare function createBffHandlers(createServer: McpServerFactory, options?: BffHandlerOptions): {
+    POST: (input: {
+        data?: unknown;
+    }) => Promise<Response>;
+    GET: (input: {
+        data?: unknown;
+    }) => Promise<Response>;
+    DELETE: (input: {
+        data?: unknown;
+    }) => Promise<Response>;
+};

package/dist/types/server/resources.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+export interface RegisterUiOptions {
+    request?: Request;
+    /** Runtime mode. Standalone services default to production. */
+    mode?: 'development' | 'production';
+    /** Manifest file path or HTTP(S) URL. Provided by the Modern.js server plugin or explicitly by the caller. */
+    manifest?: string | URL;
+    /** Public deployment root, including any path prefix. */
+    assetBase?: string;
+}
+export declare function requestOrigin(request: Request): string;
+export declare function registerUiResources(server: Pick<McpServer, 'registerResource'>, options?: RegisterUiOptions): Promise<Record<string, string>>;

package/dist/types/ui/mf-entry.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/ui/mf.d.ts

@@ -0,0 +1,10 @@
+import * as JsxDevRuntime from 'react/jsx-dev-runtime';
+export interface MfViewConfig {
+    name: string;
+    entry: string;
+    expose: string;
+    /** The view name, reported to the host as the app name like local cards. */
+    view: string;
+}
+/** Executed in the application build, so the shell and exposes share its React. */
+export declare function createMfView(config: MfViewConfig): () => JsxDevRuntime.JSX.Element;

package/dist/types/ui/react.d.ts

@@ -0,0 +1,25 @@
+import type { App } from '@modelcontextprotocol/ext-apps';
+import { type UseAppOptions } from '@modelcontextprotocol/ext-apps/react';
+import { type ComponentType } from 'react';
+export type { App } from '@modelcontextprotocol/ext-apps';
+export { useApp, useDocumentTheme, useHostFonts, useHostStyles, useHostStyleVariables, } from '@modelcontextprotocol/ext-apps/react';
+export type McpCapabilities = NonNullable<UseAppOptions['capabilities']>;
+export type McpViewProps<T extends object = Record<string, unknown>> = Omit<T, 'mcpApp'> & {
+    mcpApp: App;
+};
+export declare function useMcpApp(options: Omit<UseAppOptions, 'onAppCreated'>): {
+    app: App | null;
+    isConnected: boolean;
+    error: Error | null;
+    result?: import("@modelcontextprotocol/server").CallToolResult;
+    cancelled: boolean;
+    viewProps: Record<string, unknown>;
+};
+export declare function createMcpView<P extends object>(View: ComponentType<P>, appInfo: {
+    name: string;
+    version: string;
+}, capabilities?: McpCapabilities): () => import("react").DetailedReactHTMLElement<{
+    role: "alert";
+}, HTMLElement> | import("react").DetailedReactHTMLElement<{
+    role: "status";
+}, HTMLElement> | import("react").ReactElement<P, string | import("react").JSXElementConstructor<any>> | null;

package/dist/types/ui/state.d.ts

@@ -0,0 +1,13 @@
+import type { CallToolResult } from '@modelcontextprotocol/server';
+export interface ViewState {
+    result?: CallToolResult;
+    cancelled: boolean;
+}
+export type ViewEvent = {
+    type: 'input' | 'cancelled' | 'teardown';
+} | {
+    type: 'result';
+    result: CallToolResult;
+};
+export declare function reduceViewState(_state: ViewState, event: ViewEvent): ViewState;
+export declare function resultProps(result?: CallToolResult): Record<string, unknown>;

package/package.json

@@ -1,6 +1,111 @@
 {
   "name": "@bleedingdev/modern-js-mcp-apps",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "3.11.3-ultramodern.2",
+  "description": "Build, serve and render MCP Apps in Modern.js applications",
+  "license": "MIT",
+  "homepage": "https://github.com/ultramodernjs/ultramodern.js#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ultramodernjs/ultramodern.js.git",
+    "directory": "packages/toolkit/mcp-apps"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": [
+    "./src/ui/mf-entry.ts",
+    "./dist/esm/mf-entry.mjs"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    "./cli": {
+      "types": "./dist/types/cli/index.d.ts",
+      "import": "./dist/esm-node/cli.mjs",
+      "require": "./dist/cjs/cli.cjs"
+    },
+    "./server-plugin": {
+      "types": "./dist/types/cli/server-plugin.d.ts",
+      "import": "./dist/esm-node/server-plugin.mjs",
+      "require": "./dist/cjs/server-plugin.cjs"
+    },
+    "./server": {
+      "types": "./dist/types/server/index.d.ts",
+      "import": "./dist/esm-node/server.mjs",
+      "require": "./dist/cjs/server.cjs"
+    },
+    "./react": {
+      "types": "./dist/types/ui/react.d.ts",
+      "import": "./dist/esm/react.mjs",
+      "default": "./dist/esm/react.mjs"
+    }
+  },
+  "dependencies": {
+    "@rsbuild/core": "2.3.2"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/ext-apps": "^2.0.4",
+    "@modelcontextprotocol/server": "^2.3.1",
+    "@modern-js/server-runtime": "3.11.3-ultramodern.2",
+    "@module-federation/enhanced": "npm:@bleedingdev/mf-enhanced@2.9.3",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@modern-js/server-runtime": {
+      "optional": true
+    },
+    "@module-federation/enhanced": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/client": "2.3.1",
+    "@modelcontextprotocol/ext-apps": "2.0.4",
+    "@modelcontextprotocol/server": "2.3.1",
+    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.11.3-ultramodern.2",
+    "@modern-js/server-runtime": "npm:@bleedingdev/modern-js-server-runtime@3.11.3-ultramodern.2",
+    "@module-federation/enhanced": "npm:@bleedingdev/mf-enhanced@2.9.3",
+    "@rslib/core": "1.0.3",
+    "@scripts/rstest-config": "2.66.7",
+    "@types/node": "^26.6.5",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "typescript": "7.0.2",
+    "zod": "^4.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "typesVersions": {
+    "*": {
+      "cli": [
+        "./dist/types/cli/index.d.ts"
+      ],
+      "server-plugin": [
+        "./dist/types/cli/server-plugin.d.ts"
+      ],
+      "server": [
+        "./dist/types/server/index.d.ts"
+      ],
+      "react": [
+        "./dist/types/ui/react.d.ts"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "rslib build",
+    "test": "rstest",
+    "typecheck": "node ../../../scripts/with-effect-tsrs.mjs --project tsconfig.json --noEmit"
+  },
+  "bugs": {
+    "url": "https://github.com/ultramodernjs/ultramodern.js/issues"
+  },
+  "ultramodern": {
+    "sourceName": "@modern-js/mcp-apps"
+  }
+}