@frontmcp/uipack 0.12.2 → 1.0.0-beta.2

package/README.md

@@ -1,15 +1,9 @@
 # @frontmcp/uipack
 
-React-free build utilities, theming, runtime helpers, and platform adapters for FrontMCP UI development.
+HTML shell builder, pluggable import resolver, and NPM component loader for MCP UI development. React-free core.
 
 [![NPM](https://img.shields.io/npm/v/@frontmcp/uipack.svg)](https://www.npmjs.com/package/@frontmcp/uipack)
-
-## Package Split
-
-| Package            | Purpose                                                               | React Required |
-| ------------------ | --------------------------------------------------------------------- | -------------- |
-| `@frontmcp/uipack` | Themes, runtime helpers, build/render pipelines, validation, adapters | No             |
-| `@frontmcp/ui`     | HTML/React components, layouts, widgets, web components               | Yes (peer dep) |
+[![License](https://img.shields.io/npm/l/@frontmcp/uipack.svg)](../../LICENSE)
 
 ## Install
 
@@ -17,75 +11,386 @@ React-free build utilities, theming, runtime helpers, and platform adapters for
 npm install @frontmcp/uipack
 ```
 
-## Features
+No React required. The only runtime dependency is `zod`.
+
+## Quick Start
+
+### Build an HTML Shell
+
+```ts
+import { buildShell } from '@frontmcp/uipack/shell';
+
+const result = buildShell('<div id="root"></div>', {
+  toolName: 'get_weather',
+  input: { city: 'London' },
+  output: { temp: 18 },
+  includeBridge: true,
+  csp: { connectDomains: ['https://api.weather.com'] },
+});
+
+// result.html  -> full HTML document with CSP, data injection, bridge IIFE
+// result.hash  -> fast 32-bit content hash
+// result.size  -> byte length
+```
+
+### Render an NPM Component
+
+```ts
+import { renderComponent } from '@frontmcp/uipack/component';
+
+const result = await renderComponent(
+  { source: { npm: 'my-weather-widget', exportName: 'WeatherCard' } },
+  { toolName: 'get_weather', output: { temp: 18 }, includeBridge: true },
+);
+```
+
+### Resolve Imports to CDN URLs
+
+```ts
+import { createEsmShResolver, createImportMap } from '@frontmcp/uipack/resolver';
+
+const resolver = createEsmShResolver({ providerOrder: ['cloudflare', 'jsdelivr'] });
+const result = resolver.resolve('chart.js');
+// -> { value: 'https://cdnjs.cloudflare.com/ajax/libs/Chart.js/4.5.1/chart.umd.min.js', type: 'url' }
+```
+
+### Generate Bridge IIFE
+
+```ts
+import { generateBridgeIIFE, UNIVERSAL_BRIDGE_SCRIPT } from '@frontmcp/uipack/bridge-runtime';
+
+// Use pre-generated universal script
+const script = `<script>${UNIVERSAL_BRIDGE_SCRIPT}</script>`;
 
-- **Theme system** — Tailwind-style palettes, fonts, CDN assets, platform-aware inlining ([docs][docs-theme])
-- **Build API** — compile tool templates with esbuild/SWC, emit static widgets, cached manifests ([docs][docs-build])
-- **Build modes** — static, dynamic, or hybrid rendering; multi-platform bundler helpers ([docs][docs-build-modes])
-- **Runtime helpers** — wrap HTML/React/MDX with CSP, sanitize content, expose MCP Bridge metadata ([docs][docs-runtime])
-- **Platform adapters** — OpenAI/Claude/Gemini discovery metadata, serving modes, host capabilities ([docs][docs-adapters])
-- **Validation** — schema path extraction, Handlebars template validation, error boxes ([docs][docs-validation])
-- **Bundler/cache** — filesystem and Redis caches, transpile/render caches, hashing utilities ([docs][docs-bundler])
+// Or generate with custom options
+const iife = generateBridgeIIFE({ debug: true, minify: false });
+```
 
-## Quick Example
+### Fetch TypeScript Definitions
 
 ```ts
-import { buildToolUI } from '@frontmcp/uipack/build';
+import { createTypeFetcher } from '@frontmcp/uipack/typings';
 
-const result = await buildToolUI({
-  template: '<div>{{output.temperature}} C</div>',
-  context: { input: { location: 'London' }, output: { temperature: 18 } },
-  platform: 'openai',
+const fetcher = createTypeFetcher({
+  allowedPackages: ['react', 'zod', '@frontmcp/*'],
+  maxDepth: 3,
 });
+
+const result = await fetcher.fetchBatch({
+  imports: ["import { z } from 'zod'"],
+});
+// result.results[0].files -> TypeFile[] with virtual node_modules/ paths
 ```
 
-> Full guide: [UI Overview][docs-overview]
+## Features
+
+- **Shell builder** — Full HTML documents with CSP, data injection, and bridge runtime
+- **Import resolver** — Pluggable CDN resolution (esm.sh, Cloudflare, jsDelivr, unpkg)
+- **Component loader** — 4 source modes: npm, file, URL, inline function
+- **Bridge IIFE** — Platform-aware vanilla JS bridge (OpenAI, ExtApps, Claude, Gemini, Generic)
+- **Type fetching** — Download `.d.ts` from esm.sh with recursive dependency resolution
+- **XSS utilities** — `escapeHtml`, `safeJsonForScript`, `escapeScriptClose`, and more
+- **Custom shells** — Load shell templates from npm, URL, or inline HTML
+- **Standalone types** — SDK-independent type definitions for widget configuration
 
 ## Entry Points
 
-| Path                          | Purpose                                                  |
-| ----------------------------- | -------------------------------------------------------- |
-| `@frontmcp/uipack/theme`      | Theme system, platform definitions, CDN helpers          |
-| `@frontmcp/uipack/runtime`    | MCP Bridge runtime, CSP utilities, sanitizers            |
-| `@frontmcp/uipack/build`      | Build API, static widget compiler, serving-mode resolver |
-| `@frontmcp/uipack/adapters`   | Discovery metadata + platform adapters                   |
-| `@frontmcp/uipack/pages`      | Prebuilt page templates (consent/error/success)          |
-| `@frontmcp/uipack/validation` | Component + template validation helpers                  |
-| `@frontmcp/uipack/bundler`    | esbuild/SWC bundler and cache utilities                  |
-| `@frontmcp/uipack/registry`   | Tool UI registry, URI helpers, render functions          |
-| `@frontmcp/uipack/types`      | Shared template/context types                            |
-| `@frontmcp/uipack/utils`      | Escaping, safe stringify, helper utilities               |
-
-## Docs
-
-| Topic             | Link                            |
-| ----------------- | ------------------------------- |
-| Overview          | [UI Overview][docs-overview]    |
-| Theme system      | [Theming][docs-theme]           |
-| Build API         | [Build Tools][docs-build]       |
-| Build modes       | [Build Modes][docs-build-modes] |
-| Runtime helpers   | [Runtime][docs-runtime]         |
-| Platform adapters | [Adapters][docs-adapters]       |
-| Validation        | [Validation][docs-validation]   |
-| Bundler           | [Bundler][docs-bundler]         |
+| Path                              | Purpose                              |
+| --------------------------------- | ------------------------------------ |
+| `@frontmcp/uipack`                | Main barrel (re-exports all modules) |
+| `@frontmcp/uipack/resolver`       | Pluggable import resolution          |
+| `@frontmcp/uipack/shell`          | HTML shell builder                   |
+| `@frontmcp/uipack/component`      | Polymorphic component loader         |
+| `@frontmcp/uipack/bridge-runtime` | Platform bridge IIFE generator       |
+| `@frontmcp/uipack/typings`        | TypeScript .d.ts fetching engine     |
+| `@frontmcp/uipack/types`          | Standalone type definitions          |
+| `@frontmcp/uipack/utils`          | XSS-safe escaping utilities          |
+
+## Module Exports
+
+### Resolver
+
+| Export                                         | Type     | Purpose                                                           |
+| ---------------------------------------------- | -------- | ----------------------------------------------------------------- |
+| `createEsmShResolver(opts?)`                   | function | Default resolver using esm.sh with CDN registry fallback          |
+| `DEFAULT_CDN_REGISTRY`                         | constant | Pre-configured entries for react, react-dom, chart.js, d3, lodash |
+| `parseImports(source)`                         | function | Parse source code for named, default, namespace, dynamic imports  |
+| `rewriteImports(source, resolver, overrides?)` | function | Rewrite bare specifiers to CDN URLs                               |
+| `createImportMap(overrides?)`                  | function | Generate browser-standard import map                              |
+| `mergeImportMaps(...maps)`                     | function | Deep-merge multiple import maps                                   |
+| `generateImportMapScriptTag(map)`              | function | `<script type="importmap">` generation                            |
+| `lookupPackage(name)`                          | function | Query the CDN registry for a package                              |
+| `getPackageCDNUrl(name, provider?)`            | function | Resolve package to best CDN URL                                   |
+| `extractExternalPackages(code)`                | function | Extract external package names from source                        |
+
+### Shell
+
+| Export                                                | Type     | Purpose                                                               |
+| ----------------------------------------------------- | -------- | --------------------------------------------------------------------- |
+| `buildShell(content, config)`                         | function | Main entry point -> `ShellResult`                                     |
+| `buildCSPMetaTag(config?)`                            | function | Generate `<meta>` CSP tag                                             |
+| `buildCSPDirectives(config?)`                         | function | Merge custom domains with defaults                                    |
+| `buildDataInjectionScript(toolName, input?, output?)` | function | `<script>` setting `window.__mcp*` globals                            |
+| `createTemplateHelpers(toolName)`                     | function | `escapeHtml`, `formatDate`, `formatCurrency`, `uniqueId`, `jsonEmbed` |
+| `resolveShellTemplate(opts)`                          | function | Resolve custom shell from npm/URL/inline                              |
+| `applyShellTemplate(template, values)`                | function | Apply values to resolved template                                     |
+| `validateShellTemplate(template)`                     | function | Validate a custom shell template                                      |
+| `DEFAULT_CDN_DOMAINS`                                 | constant | jsDelivr, Cloudflare, Google Fonts                                    |
+
+### Component
+
+| Export                                                              | Type     | Purpose                                            |
+| ------------------------------------------------------------------- | -------- | -------------------------------------------------- |
+| `renderComponent(config, shell)`                                    | function | Top-level compositor -> `ShellResult`              |
+| `resolveUISource(source, opts)`                                     | function | Resolve any source to `ResolvedComponent`          |
+| `generateMountScript(resolved, data)`                               | function | ES module mount script for React/module components |
+| `isNpmSource`, `isFileSource`, `isImportSource`, `isFunctionSource` | guards   | Type narrowing helpers                             |
+
+### Bridge Runtime
+
+| Export                             | Type     | Purpose                                                                |
+| ---------------------------------- | -------- | ---------------------------------------------------------------------- |
+| `generateBridgeIIFE(opts?)`        | function | Generate the bridge IIFE string                                        |
+| `generatePlatformBundle(platform)` | function | Platform-specific bundles (`chatgpt`, `claude`, `gemini`, `universal`) |
+| `UNIVERSAL_BRIDGE_SCRIPT`          | constant | Pre-generated script with all adapters                                 |
+| `BRIDGE_SCRIPT_TAGS`               | constant | `{ universal, chatgpt, claude, gemini }` pre-wrapped `<script>` tags   |
+
+### Typings
+
+| Export                        | Type     | Purpose                                                       |
+| ----------------------------- | -------- | ------------------------------------------------------------- |
+| `createTypeFetcher(opts?)`    | function | Factory creating a `TypeFetcher` instance                     |
+| `TypeFetcher`                 | class    | Main fetcher with caching and recursive dependency resolution |
+| `MemoryTypeCache`             | class    | LRU cache with TTL support                                    |
+| `globalTypeCache`             | constant | Module-level singleton cache (500 entries, 1h TTL)            |
+| `parseDtsImports(content)`    | function | Parse `.d.ts` files for imports/references                    |
+| `combineDtsContents(results)` | function | Combine multiple `.d.ts` files into one                       |
+
+### Utils
+
+| Export                         | Type     | Purpose                                                                      |
+| ------------------------------ | -------- | ---------------------------------------------------------------------------- |
+| `escapeHtml(str)`              | function | Escape `&`, `<`, `>`, `"`, `'`, U+2028/2029                                  |
+| `escapeHtmlAttr(str)`          | function | Lighter escape for attributes                                                |
+| `escapeJsString(str)`          | function | Escape for JS string literals                                                |
+| `escapeScriptClose(str)`       | function | Replace `</` with `<\/` to prevent `</script>` breakout                      |
+| `safeJsonForScript(value)`     | function | JSON serialize safe for `<script>` embedding (handles BigInt, circular refs) |
+| `safeStringify(value, space?)` | function | `JSON.stringify` with circular reference detection                           |
+
+## Shell HTML Structure
+
+Annotated output of `buildShell` with `withShell: true` and `includeBridge: true`:
+
+```html
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>get_weather</title>
+
+    <!-- CSP: default CDN domains + custom connectDomains/resourceDomains -->
+    <meta
+      http-equiv="Content-Security-Policy"
+      content="default-src 'self'; script-src 'self' 'unsafe-inline' https://cdn.jsdelivr.net ..."
+    />
+
+    <!-- Data injection: tool context as window globals -->
+    <script>
+      window.__mcpToolName = 'get_weather';
+      window.__mcpToolInput = { city: 'London' };
+      window.__mcpToolOutput = { temp: 18 };
+      window.__mcpStructuredContent = null;
+    </script>
+
+    <!-- Bridge IIFE: auto-detects platform, exposes window.FrontMcpBridge -->
+    <script>
+      (function () {
+        /* ... adapters, FrontMcpBridge class ... */
+      })();
+    </script>
+  </head>
+  <body>
+    <!-- Content from resolver + component -->
+    <script type="importmap">
+      { "imports": { "react": "https://esm.sh/react@19" } }
+    </script>
+    <div id="root"></div>
+    <script type="module">
+      import { WeatherCard } from 'https://esm.sh/my-weather-widget';
+      /* mount logic */
+    </script>
+  </body>
+</html>
+```
+
+## Component Source Modes
+
+| Mode       | Config Shape                                      | Description                        |
+| ---------- | ------------------------------------------------- | ---------------------------------- |
+| **npm**    | `{ npm: 'my-chart', exportName?, version? }`      | Resolved via CDN registry / esm.sh |
+| **file**   | `{ file: './widget.html', inline? }`              | Local file path                    |
+| **import** | `{ import: 'https://cdn.example.com/widget.js' }` | Direct URL passthrough             |
+| **inline** | `(input, output) => '<div>...</div>'`             | Function returning HTML string     |
+
+## Bridge API
+
+The bridge IIFE exposes `window.FrontMcpBridge` with the following API:
+
+| Method                      | Description                          |
+| --------------------------- | ------------------------------------ |
+| `callTool(name, args)`      | Invoke an MCP tool from the widget   |
+| `getToolOutput()`           | Read injected tool output data       |
+| `getToolInput()`            | Read injected tool input data        |
+| `sendMessage(content)`      | Send message to host                 |
+| `openLink(url)`             | Open a URL via platform adapter      |
+| `requestDisplayMode(mode)`  | Switch inline / fullscreen / pip     |
+| `setWidgetState(state)`     | Persist widget state to localStorage |
+| `onContextChange(callback)` | Subscribe to host context changes    |
+| `onToolResult(callback)`    | Subscribe to tool result events      |
+| `hasCapability(cap)`        | Check adapter capabilities           |
+| `getTheme()`                | Get current theme from host          |
+| `getDisplayMode()`          | Get current display mode             |
+| `getHostContext()`          | Get host context metadata            |
+
+## Contributing
+
+### Architecture
+
+```mermaid
+graph TD
+    subgraph "@frontmcp/uipack"
+        IDX["index.ts<br/><i>Main barrel exports</i>"]
+
+        subgraph bridge-runtime["bridge-runtime/"]
+            BR_IIFE["iife-generator.ts<br/>5 platform adapters:<br/>OpenAI, ExtApps, Claude,<br/>Gemini, Generic"]
+        end
+
+        subgraph component["component/"]
+            CO_TYPES["types.ts<br/>NpmSource, FileSource,<br/>ImportSource, FunctionSource"]
+            CO_LOAD["loader.ts<br/>resolveUISource(),<br/>generateMountScript()"]
+            CO_REND["renderer.ts<br/>renderComponent()"]
+        end
+
+        subgraph resolver["resolver/"]
+            RE_CDN["cdn-registry.ts<br/>DEFAULT_CDN_REGISTRY,<br/>lookupPackage()"]
+            RE_ESM["esm-sh.resolver.ts<br/>createEsmShResolver()"]
+            RE_PARSE["import-parser.ts<br/>parseImports()"]
+            RE_REWRITE["import-rewriter.ts<br/>rewriteImports()"]
+            RE_MAP["import-map.ts<br/>createImportMap(),<br/>mergeImportMaps()"]
+        end
+
+        subgraph shell["shell/"]
+            SH_BUILD["builder.ts<br/>buildShell()"]
+            SH_CSP["csp.ts<br/>CSP directives + meta tag"]
+            SH_DATA["data-injector.ts<br/>window.__mcp* globals"]
+            SH_CUSTOM["custom-shell-*.ts<br/>Resolve, validate, apply<br/>custom shell templates"]
+        end
+
+        subgraph types["types/"]
+            TY_CFG["ui-config.ts<br/>UITemplateConfig,<br/>WidgetServingMode"]
+            TY_RT["ui-runtime.ts<br/>UIType, WidgetManifest,<br/>WidgetConfig"]
+        end
+
+        subgraph typings["typings/"]
+            TP_FETCH["type-fetcher.ts<br/>TypeFetcher class"]
+            TP_DTS["dts-parser.ts<br/>parseDtsImports()"]
+            TP_SCHEMA["schemas.ts<br/>Zod validation"]
+            TP_CACHE["cache/<br/>MemoryTypeCache (LRU + TTL)"]
+        end
+
+        subgraph utils["utils/"]
+            UT["escapeHtml, safeJsonForScript,<br/>escapeScriptClose, safeStringify"]
+        end
+    end
+```
+
+### Module Dependency Graph
+
+```mermaid
+graph BT
+    utils["utils<br/><i>foundation, zero deps</i>"]
+    resolver["resolver<br/><i>import resolution</i>"]
+    shell["shell<br/><i>HTML shell builder</i>"]
+    bridge["bridge-runtime<br/><i>IIFE generator, standalone</i>"]
+    component["component<br/><i>polymorphic loader</i>"]
+    types["types<br/><i>standalone, no internal deps</i>"]
+    typings["typings<br/><i>standalone, uses zod</i>"]
+
+    resolver --> utils
+    shell --> utils
+    shell --> resolver
+    shell --> bridge
+    component --> utils
+    component --> resolver
+    component --> shell
+```
+
+### How @frontmcp/uipack works with @frontmcp/ui
+
+`@frontmcp/uipack` runs **server-side** (Node.js) and produces complete HTML documents. `@frontmcp/ui` runs **browser-side** and provides React components and hooks that mount inside those documents.
+
+**Bridge contract:** uipack generates a vanilla JS IIFE that creates `window.FrontMcpBridge`. The `@frontmcp/ui` bridge module wraps this same API in a React-friendly class and hooks (`useCallTool`, etc.). The ui package re-exports bridge IIFE generators from uipack via `@frontmcp/ui/bridge/runtime`.
+
+**Dependency direction:** `@frontmcp/ui` optionally depends on `@frontmcp/uipack` (optional dependency). They can be used independently — uipack alone for vanilla JS widgets, or together for React-based widgets.
+
+**End-to-end data flow:**
+
+```mermaid
+sequenceDiagram
+    participant Dev as Developer
+    participant SDK as @frontmcp/sdk
+    participant UP as @frontmcp/uipack
+    participant Browser
+    participant UI as @frontmcp/ui
+
+    Dev->>SDK: @Tool({ ui: { npm: '...' } })
+    SDK->>UP: renderComponent(config, shellConfig)
+    UP->>UP: resolve deps (esm.sh)
+    UP->>UP: build shell (CSP + data injection)
+    UP->>UP: inject bridge IIFE
+    UP-->>SDK: ShellResult { html, hash, size }
+
+    Browser->>SDK: readResource("ui://widget/tool.html")
+    SDK-->>Browser: cached HTML
+
+    Browser->>Browser: Load @frontmcp/ui via esm.sh
+    Browser->>UI: Mount React components
+    UI->>UI: Bridge hooks read window.__mcp* globals
+    UI->>Browser: Interactive widget rendered
+```
+
+### Development
+
+```bash
+# Build
+nx build uipack
+
+# Test
+nx test uipack
+
+# Lint
+nx lint uipack
+```
+
+### Testing
+
+- 95%+ coverage required across statements, branches, functions, lines
+- **XSS tests** are critical — test all escaping functions with malicious input
+- **CSP tests** — verify generated Content-Security-Policy headers are correct
+- Test all 4 component source modes (npm, file, import, inline)
+- Test bridge IIFE generation for each platform
+
+## Requirements
+
+- Node.js >= 22.0.0
 
 ## Related Packages
 
-- [`@frontmcp/ui`](../ui) — React components that consume these helpers
-- [`@frontmcp/sdk`](../sdk) — core framework and decorators
-- [`@frontmcp/testing`](../testing) — UI assertions for automated testing
+- [`@frontmcp/ui`](../ui) — React components, hooks, and renderers that consume uipack output
+- [`@frontmcp/sdk`](../sdk) — Core FrontMCP SDK with `ToolUIRegistry`
+- [`@frontmcp/testing`](../testing) — UI test assertions
 
 ## License
 
 Apache-2.0 — see [LICENSE](../../LICENSE).
-
-<!-- links -->
-
-[docs-overview]: https://docs.agentfront.dev/frontmcp/ui/overview
-[docs-theme]: https://docs.agentfront.dev/frontmcp/ui/theming
-[docs-build]: https://docs.agentfront.dev/frontmcp/ui/build-tools
-[docs-build-modes]: https://docs.agentfront.dev/frontmcp/ui/build-modes
-[docs-runtime]: https://docs.agentfront.dev/frontmcp/ui/runtime
-[docs-adapters]: https://docs.agentfront.dev/frontmcp/ui/adapters
-[docs-validation]: https://docs.agentfront.dev/frontmcp/ui/validation
-[docs-bundler]: https://docs.agentfront.dev/frontmcp/ui/bundler

package/adapters/base-template.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Base Template
+ *
+ * Creates default base template for resources/read responses.
+ * Uses buildShell() from uipack/shell with bridge IIFE.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Options for creating a default base template.
+ */
+export interface DefaultBaseTemplateOptions {
+    /** Tool name for data injection */
+    toolName: string;
+}
+/**
+ * Create a default base template for `resources/read` responses.
+ *
+ * Returns a full HTML document with:
+ * - CSP meta tag
+ * - Data injection placeholders (window globals)
+ * - Bridge runtime IIFE for `ui/initialize` handshake
+ * - A root element for widget rendering
+ *
+ * The bridge handles:
+ * - `ui/initialize` handshake with the host
+ * - `ui/notifications/tool-result` data injection from host
+ */
+export declare function createDefaultBaseTemplate(options: DefaultBaseTemplateOptions): string;
+//# sourceMappingURL=base-template.d.ts.map

package/adapters/base-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-template.d.ts","sourceRoot":"","sources":["../../src/adapters/base-template.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CAoCrF"}

package/adapters/cdn-info.d.ts

@@ -0,0 +1,34 @@
+/**
+ * CDN Info Builder
+ *
+ * Returns CDN dependency info for a given UI type.
+ *
+ * @packageDocumentation
+ */
+import type { UIType } from '../types/ui-runtime';
+/**
+ * CDN info for a UI type, describing base CDN and required dependencies.
+ */
+export interface CDNInfo {
+    /** Base CDN URL */
+    base: string;
+    /** Dependencies required for this UI type */
+    dependencies: CDNDependencyInfo[];
+}
+/**
+ * Individual CDN dependency.
+ */
+export interface CDNDependencyInfo {
+    /** Package name */
+    name: string;
+    /** CDN URL */
+    url: string;
+}
+/**
+ * Build CDN info for a given UI type.
+ *
+ * @param uiType - The UI type to get CDN info for
+ * @returns CDN info object with base URL and dependencies
+ */
+export declare function buildCDNInfoForUIType(uiType: UIType | string): CDNInfo;
+//# sourceMappingURL=cdn-info.d.ts.map

package/adapters/cdn-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn-info.d.ts","sourceRoot":"","sources":["../../src/adapters/cdn-info.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,YAAY,EAAE,iBAAiB,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AASD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CA4BtE"}

package/adapters/constants.d.ts

@@ -0,0 +1,18 @@
+/**
+ * MCP Apps Protocol Constants
+ *
+ * Aligned with the MCP Apps specification:
+ * https://modelcontextprotocol.io/extensions/apps/overview
+ *
+ * @packageDocumentation
+ */
+/**
+ * MIME type for MCP Apps HTML content.
+ * Per the MCP Apps spec: `text/html;profile=mcp-app`
+ */
+export declare const MCP_APPS_MIME_TYPE: "text/html;profile=mcp-app";
+/**
+ * Extension ID for MCP Apps in capabilities.experimental.
+ */
+export declare const MCP_APPS_EXTENSION_ID: "io.modelcontextprotocol/ui";
+//# sourceMappingURL=constants.d.ts.map

package/adapters/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/adapters/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAG,2BAAoC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAG,4BAAqC,CAAC"}

package/adapters/content-detector.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Content Type Detector
+ *
+ * Auto-detects the content type from a template result value.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Detected content types from template output.
+ */
+export type DetectedContentType = 'chart' | 'mermaid' | 'pdf' | 'html' | 'text' | 'json';
+/**
+ * Detect content type from a template result value.
+ *
+ * @param value - The raw template output
+ * @returns The detected content type
+ */
+export declare function detectContentType(value: unknown): DetectedContentType;
+//# sourceMappingURL=content-detector.d.ts.map

package/adapters/content-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-detector.d.ts","sourceRoot":"","sources":["../../src/adapters/content-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAyBzF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAsCrE"}

package/adapters/content-renderers.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Content Renderers
+ *
+ * Content-type-specific HTML generators using CDN imports.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Build HTML for a Chart.js chart.
+ */
+export declare function buildChartHtml(chartJson: Record<string, unknown>): string;
+/**
+ * Build HTML for a Mermaid diagram.
+ */
+export declare function buildMermaidHtml(mermaidCode: string): string;
+/**
+ * Build HTML for a PDF rendered via PDF.js canvas (sandbox-safe).
+ */
+export declare function buildPdfHtml(base64: string): string;
+/**
+ * Auto-detect content type and wrap in appropriate HTML.
+ *
+ * @param value - The raw template output
+ * @returns HTML string or undefined if value is plain text/json (no wrapping needed)
+ */
+export declare function wrapDetectedContent(value: unknown): string | undefined;
+//# sourceMappingURL=content-renderers.d.ts.map

package/adapters/content-renderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-renderers.d.ts","sourceRoot":"","sources":["../../src/adapters/content-renderers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAqBzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAoB5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAoCnD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAiBtE"}

package/adapters/index.d.ts

@@ -1,13 +1,20 @@
 /**
- * @frontmcp/ui Adapters
+ * @frontmcp/uipack/adapters
  *
- * Platform-specific adapters for building UI metadata.
- * These adapters are SDK-independent and can be used by external systems
- * like AgentLink without requiring @frontmcp/sdk.
+ * SDK integration layer for the UI pipeline.
+ * Provides rendering, serving mode resolution, and response formatting
+ * aligned with the MCP Apps protocol specification.
  *
  * @packageDocumentation
  */
-export { type AIPlatformType, type ExtAppsMimeTypeVariant, type UIMetadata, type BuildUIMetaOptions, type BuildToolDiscoveryMetaOptions, buildUIMeta, buildToolDiscoveryMeta, buildOpenAICSP, buildFrontMCPCSP, getExtAppsMimeType, isExtAppsMimeType, } from './platform-meta';
-export { type ResolvedServingMode, type ResolveServingModeOptions, resolveServingMode, isPlatformModeSupported, getDefaultServingMode, platformUsesStructuredContent, platformSupportsWidgets, } from './serving-mode';
-export { type TextContentBlock, type BuildToolResponseOptions, type ToolResponseContent, buildToolResponseContent, } from './response-builder';
+export { MCP_APPS_MIME_TYPE, MCP_APPS_EXTENSION_ID } from './constants';
+export { resolveServingMode, type ResolveServingModeOptions, type ServingModeResult, type AdapterPlatformType, } from './serving-mode';
+export { buildToolResponseContent, type ToolResponseContent, type BuildToolResponseContentOptions, } from './response-builder';
+export { isUIRenderFailure, type UIRenderFailure } from './render-failure';
+export { renderToolTemplate, type RenderToolTemplateOptions, type RenderToolTemplateResult } from './template-renderer';
+export { detectContentType, type DetectedContentType } from './content-detector';
+export { buildChartHtml, buildMermaidHtml, buildPdfHtml, wrapDetectedContent } from './content-renderers';
+export { createDefaultBaseTemplate, type DefaultBaseTemplateOptions } from './base-template';
+export { buildCDNInfoForUIType, type CDNInfo, type CDNDependencyInfo } from './cdn-info';
+export { detectUIType } from './type-detector';
 //# sourceMappingURL=index.d.ts.map

package/adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAE3B,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,6BAA6B,EAElC,WAAW,EACX,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAEhB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAE9B,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,6BAA6B,EAC7B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EAExB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAKxE,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EACL,wBAAwB,EACxB,KAAK,mBAAmB,EACxB,KAAK,+BAA+B,GACrC,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAK3E,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,KAAK,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAKxH,OAAO,EAAE,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAK1G,OAAO,EAAE,yBAAyB,EAAE,KAAK,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAK7F,OAAO,EAAE,qBAAqB,EAAE,KAAK,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKzF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}