@frontmcp/uipack 0.6.1 → 0.6.2

package/CLAUDE.md

@@ -2,17 +2,17 @@
 
 ## Overview
 
-`@frontmcp/uipack` provides **bundling, build tools, HTML components, and platform adapters** for MCP UI development - all without requiring React.
+`@frontmcp/uipack` provides **bundling, build tools, platform adapters, and theming** for MCP UI development - all without requiring React.
 
 This is the React-free core package. For React components and hooks, use `@frontmcp/ui`.
 
 **Key Principles:**
 
 - Zero React dependency
-- Pure HTML string generation
-- Zod schema validation for all component inputs
 - Platform-aware theming and CDN configuration
-- HTMX support for dynamic interactions
+- Build tools for Tool UI generation
+- esbuild/SWC bundling utilities
+- Zod schema validation
 
 ## Architecture
 
@@ -20,17 +20,15 @@ This is the React-free core package. For React components and hooks, use `@front
 libs/uipack/src/
 ├── adapters/           # Platform adapters (OpenAI, Claude, etc.)
 ├── base-template/      # Default HTML wrappers with polyfills
-├── bridge/             # Multi-platform MCP bridge
+├── bridge-runtime/     # MCP bridge runtime generation
 ├── build/              # Build-time API (buildToolUI, etc.)
-├── bundler/            # esbuild/SWC bundling
-├── components/         # HTML string components (button, card, etc.)
+├── bundler/            # esbuild/SWC bundling, caching, sandbox
 ├── dependency/         # CDN resolution and import maps
 ├── handlebars/         # Handlebars template engine
-├── layouts/            # Page layout templates
-├── pages/              # Pre-built pages (consent, error)
+├── preview/            # Preview server utilities
 ├── registry/           # Tool UI registry
-├── renderers/          # HTML/MDX renderers
-├── runtime/            # Runtime utilities (template helpers)
+├── renderers/          # HTML/MDX client renderers
+├── runtime/            # Runtime utilities (wrapper, sanitizer, CSP)
 ├── styles/             # Style variant definitions
 ├── theme/              # Theme system and CDN config
 ├── tool-template/      # Tool template utilities
@@ -38,103 +36,52 @@ libs/uipack/src/
 ├── typings/            # .d.ts type fetching
 ├── utils/              # Utilities (escapeHtml, safeStringify)
 ├── validation/         # Zod validation utilities
-├── web-components/     # Custom HTML elements
-├── widgets/            # OpenAI widget utilities
 └── index.ts            # Main barrel exports
 ```
 
 ## Package Split
 
-| Package            | Purpose                                                   | React Required |
-| ------------------ | --------------------------------------------------------- | -------------- |
-| `@frontmcp/uipack` | Bundling, build tools, HTML components, platform adapters | No             |
-| `@frontmcp/ui`     | React components, hooks, SSR rendering                    | Yes            |
+| Package            | Purpose                                                 | React Required |
+| ------------------ | ------------------------------------------------------- | -------------- |
+| `@frontmcp/uipack` | Bundling, build tools, platform adapters, theme         | No             |
+| `@frontmcp/ui`     | React components, hooks, SSR rendering, HTML components | Yes            |
 
 ## Entry Points
 
-| Path                              | Purpose                               |
-| --------------------------------- | ------------------------------------- |
-| `@frontmcp/uipack`                | Main exports                          |
-| `@frontmcp/uipack/adapters`       | Platform adapters and meta builders   |
-| `@frontmcp/uipack/base-template`  | Default HTML templates with polyfills |
-| `@frontmcp/uipack/bridge`         | MCP bridge for multiple platforms     |
-| `@frontmcp/uipack/build`          | Build-time API                        |
-| `@frontmcp/uipack/bundler`        | esbuild/SWC bundling                  |
-| `@frontmcp/uipack/components`     | HTML string components                |
-| `@frontmcp/uipack/dependency`     | CDN resolution                        |
-| `@frontmcp/uipack/handlebars`     | Handlebars integration                |
-| `@frontmcp/uipack/layouts`        | Page layouts                          |
-| `@frontmcp/uipack/pages`          | Pre-built pages                       |
-| `@frontmcp/uipack/registry`       | Tool UI registry                      |
-| `@frontmcp/uipack/renderers`      | HTML/MDX renderers                    |
-| `@frontmcp/uipack/runtime`        | Runtime utilities                     |
-| `@frontmcp/uipack/styles`         | Style variants                        |
-| `@frontmcp/uipack/theme`          | Theme system                          |
-| `@frontmcp/uipack/types`          | Type definitions                      |
-| `@frontmcp/uipack/utils`          | Utilities                             |
-| `@frontmcp/uipack/validation`     | Zod validation                        |
-| `@frontmcp/uipack/web-components` | Custom elements                       |
-| `@frontmcp/uipack/widgets`        | OpenAI widgets                        |
-
-## Component Development
-
-### 1. Create Schema First
-
-Every component must have a Zod schema with `.strict()` mode:
+| Path                             | Purpose                               |
+| -------------------------------- | ------------------------------------- |
+| `@frontmcp/uipack`               | Main exports                          |
+| `@frontmcp/uipack/adapters`      | Platform adapters and meta builders   |
+| `@frontmcp/uipack/base-template` | Default HTML templates with polyfills |
+| `@frontmcp/uipack/build`         | Build-time API (buildToolUI)          |
+| `@frontmcp/uipack/bundler`       | esbuild/SWC bundling, cache, sandbox  |
+| `@frontmcp/uipack/dependency`    | CDN resolution and import maps        |
+| `@frontmcp/uipack/handlebars`    | Handlebars integration                |
+| `@frontmcp/uipack/preview`       | Preview server utilities              |
+| `@frontmcp/uipack/registry`      | Tool UI registry                      |
+| `@frontmcp/uipack/renderers`     | HTML/MDX client renderers             |
+| `@frontmcp/uipack/runtime`       | Runtime utilities (wrapper, CSP)      |
+| `@frontmcp/uipack/styles`        | Style variants                        |
+| `@frontmcp/uipack/theme`         | Theme system and platform config      |
+| `@frontmcp/uipack/types`         | Type definitions                      |
+| `@frontmcp/uipack/typings`       | TypeScript definition fetching        |
+| `@frontmcp/uipack/utils`         | Utilities                             |
+| `@frontmcp/uipack/validation`    | Zod validation                        |
 
-```typescript
-// component.schema.ts
-import { z } from 'zod';
-
-export const ComponentOptionsSchema = z
-  .object({
-    variant: z.enum(['primary', 'secondary']).optional(),
-    size: z.enum(['sm', 'md', 'lg']).optional(),
-    disabled: z.boolean().optional(),
-    className: z.string().optional(),
-    htmx: z
-      .object({
-        get: z.string().optional(),
-        post: z.string().optional(),
-        target: z.string().optional(),
-        swap: z.string().optional(),
-      })
-      .strict()
-      .optional(),
-  })
-  .strict(); // IMPORTANT: Reject unknown properties
-
-export type ComponentOptions = z.infer<typeof ComponentOptionsSchema>;
-```
-
-### 2. Validate Inputs in Component
+## Build API
 
 ```typescript
-// component.ts
-import { validateOptions } from '../validation';
-import { ComponentOptionsSchema, type ComponentOptions } from './component.schema';
-
-export function component(content: string, options: ComponentOptions = {}): string {
-  const validation = validateOptions<ComponentOptions>(options, {
-    schema: ComponentOptionsSchema,
-    componentName: 'component',
-  });
-
-  if (!validation.success) {
-    return validation.error; // Returns styled error box HTML
-  }
-
-  const { variant = 'primary', size = 'md' } = validation.data;
-  return `<div class="...">${escapeHtml(content)}</div>`;
-}
-```
-
-### 3. Always Escape User Content
+import { buildToolUI, getOutputModeForClient } from '@frontmcp/uipack/build';
 
-```typescript
-import { escapeHtml } from '../utils';
+// Build tool UI HTML
+const html = await buildToolUI({
+  template: '<div>{{output.data}}</div>',
+  context: { input: {}, output: { data: 'Hello' } },
+  platform: 'openai',
+});
 
-const html = `<div title="${escapeHtml(title)}">${escapeHtml(content)}</div>`;
+// Get output mode for client
+const mode = getOutputModeForClient('openai');
 ```
 
 ## Theme System
@@ -190,20 +137,56 @@ const scripts = buildCdnScriptsFromTheme(DEFAULT_THEME, { inline: false });
 const inlineScripts = buildCdnScriptsFromTheme(DEFAULT_THEME, { inline: true });
 ```
 
-## Build API
+## Renderers
+
+### HTML Renderer
 
 ```typescript
-import { buildToolUI, getOutputModeForClient } from '@frontmcp/uipack/build';
+import { htmlRenderer, HtmlRenderer } from '@frontmcp/uipack/renderers';
 
-// Build tool UI HTML
-const html = await buildToolUI({
-  template: '<div>{{output.data}}</div>',
-  context: { input: {}, output: { data: 'Hello' } },
-  platform: 'openai',
+// Render HTML template
+const html = await htmlRenderer.render(template, context);
+```
+
+### MDX Client Renderer (CDN-based)
+
+```typescript
+import { mdxClientRenderer, MdxClientRenderer } from '@frontmcp/uipack/renderers';
+
+// Render MDX using CDN-based React (no bundled React)
+const html = await mdxClientRenderer.render(mdxContent, context);
+```
+
+> **Note:** For server-side MDX rendering with bundled React, use `@frontmcp/ui/renderers`.
+
+## Bundler Utilities
+
+```typescript
+import { BundlerCache, hashContent, createCacheKey, validateSource, executeCode } from '@frontmcp/uipack/bundler';
+
+// Create cache for bundled results
+const cache = new BundlerCache({ maxSize: 100, ttl: 60000 });
+
+// Hash content for cache keys
+const hash = hashContent(sourceCode);
+
+// Validate source code security
+const violations = validateSource(code, policy);
+```
+
+## Validation
+
+```typescript
+import { validateOptions, createErrorBox } from '@frontmcp/uipack/validation';
+
+const result = validateOptions(options, {
+  schema: MySchema,
+  componentName: 'MyComponent',
 });
 
-// Get output mode for client
-const mode = getOutputModeForClient('openai');
+if (!result.success) {
+  return result.error; // HTML error box
+}
 ```
 
 ## Testing Requirements
@@ -241,6 +224,6 @@ Note: No React dependency!
 
 ## Related Packages
 
-- **@frontmcp/ui** - React components, hooks, SSR rendering
+- **@frontmcp/ui** - React components, hooks, SSR rendering, HTML components
 - **@frontmcp/sdk** - Core FrontMCP SDK
 - **@frontmcp/testing** - E2E testing utilities

package/README.md

@@ -23,6 +23,7 @@ yarn add @frontmcp/uipack
 
 - **Theme system** – Configure Tailwind-style palettes, fonts, and CDN assets, then inline or externalize scripts per platform.
 - **Build API** – Compile tool templates with esbuild/SWC, emit static widgets, and ship cached manifests for serverless environments.
+- **Build modes** – Choose static, dynamic, or hybrid rendering plus multi-platform bundler helpers so the same widget rehydrates on OpenAI, Claude, and Gemini.
 - **Runtime helpers** – Wrap HTML/React/MDX templates with CSP, sanitize user content, and expose MCP Bridge metadata.
 - **Platform adapters** – Generate OpenAI/Claude/Gemini discovery metadata, resolve serving modes, and understand host capabilities.
 - **Validation** – Extract schema paths, validate Handlebars templates, and render error boxes before code hits production.

package/adapters/index.d.ts

@@ -7,7 +7,7 @@
  *
  * @packageDocumentation
  */
-export { type AIPlatformType, type UIMetadata, type BuildUIMetaOptions, type BuildToolDiscoveryMetaOptions, buildUIMeta, buildToolDiscoveryMeta, buildOpenAICSP, } from './platform-meta';
+export { type AIPlatformType, type UIMetadata, type BuildUIMetaOptions, type BuildToolDiscoveryMetaOptions, buildUIMeta, buildToolDiscoveryMeta, buildOpenAICSP, buildFrontMCPCSP, } 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';
 //# 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,EAEnB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,6BAA6B,EAElC,WAAW,EACX,sBAAsB,EACtB,cAAc,GACf,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;AAEH,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,6BAA6B,EAElC,WAAW,EACX,sBAAsB,EACtB,cAAc,EACd,gBAAgB,GACjB,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"}

package/adapters/index.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // libs/uipack/src/adapters/index.ts
 var adapters_exports = {};
 __export(adapters_exports, {
+  buildFrontMCPCSP: () => buildFrontMCPCSP,
   buildOpenAICSP: () => buildOpenAICSP,
   buildToolDiscoveryMeta: () => buildToolDiscoveryMeta,
   buildToolResponseContent: () => buildToolResponseContent,
@@ -107,6 +108,15 @@ function buildClaudeMeta(meta, uiConfig) {
   if (uiConfig.widgetDescription) {
     meta["claude/widgetDescription"] = uiConfig.widgetDescription;
   }
+  if (uiConfig.displayMode) {
+    meta["claude/displayMode"] = uiConfig.displayMode;
+  }
+  if (uiConfig.widgetAccessible) {
+    meta["claude/widgetAccessible"] = true;
+  }
+  if (uiConfig.prefersBorder !== void 0) {
+    meta["claude/prefersBorder"] = uiConfig.prefersBorder;
+  }
   return meta;
 }
 function buildGeminiMeta(meta, uiConfig) {
@@ -121,12 +131,34 @@ function buildIDEMeta(meta, uiConfig) {
   }
   return meta;
 }
+function buildFrontMCPCSP(csp) {
+  const result = {};
+  if (csp.connectDomains?.length) {
+    result.connectDomains = csp.connectDomains;
+  }
+  if (csp.resourceDomains?.length) {
+    result.resourceDomains = csp.resourceDomains;
+  }
+  return result;
+}
 function buildGenericMeta(meta, uiConfig) {
   if (uiConfig.widgetAccessible) {
-    meta["openai/widgetAccessible"] = true;
+    meta["frontmcp/widgetAccessible"] = true;
   }
   if (uiConfig.csp) {
-    meta["openai/widgetCSP"] = buildOpenAICSP(uiConfig.csp);
+    meta["frontmcp/widgetCSP"] = buildFrontMCPCSP(uiConfig.csp);
+  }
+  if (uiConfig.displayMode) {
+    meta["frontmcp/displayMode"] = uiConfig.displayMode;
+  }
+  if (uiConfig.widgetDescription) {
+    meta["frontmcp/widgetDescription"] = uiConfig.widgetDescription;
+  }
+  if (uiConfig.prefersBorder !== void 0) {
+    meta["frontmcp/prefersBorder"] = uiConfig.prefersBorder;
+  }
+  if (uiConfig.sandboxDomain) {
+    meta["frontmcp/domain"] = uiConfig.sandboxDomain;
   }
   return meta;
 }
@@ -450,6 +482,7 @@ ${htmlContent}
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  buildFrontMCPCSP,
   buildOpenAICSP,
   buildToolDiscoveryMeta,
   buildToolResponseContent,

package/adapters/platform-meta.d.ts

@@ -58,6 +58,27 @@ export interface UIMetadata {
     'openai/toolInvocation/invoked'?: string;
     /** Claude: Widget description */
     'claude/widgetDescription'?: string;
+    /** Claude: Display mode preference */
+    'claude/displayMode'?: string;
+    /** Claude: Whether widget can invoke tools (informational) */
+    'claude/widgetAccessible'?: boolean;
+    /** Claude: Whether to show border around UI */
+    'claude/prefersBorder'?: boolean;
+    /** FrontMCP: Whether widget can invoke tools */
+    'frontmcp/widgetAccessible'?: boolean;
+    /** FrontMCP: CSP configuration */
+    'frontmcp/widgetCSP'?: {
+        connectDomains?: string[];
+        resourceDomains?: string[];
+    };
+    /** FrontMCP: Display mode preference */
+    'frontmcp/displayMode'?: string;
+    /** FrontMCP: Widget description */
+    'frontmcp/widgetDescription'?: string;
+    /** FrontMCP: Whether to show border around UI */
+    'frontmcp/prefersBorder'?: boolean;
+    /** FrontMCP: Dedicated sandbox domain */
+    'frontmcp/domain'?: string;
     /** Gemini: Widget description */
     'gemini/widgetDescription'?: string;
     /** IDE: Resource URI for widget template */
@@ -127,6 +148,14 @@ export declare function buildOpenAICSP(csp: UIContentSecurityPolicy): {
     connect_domains?: string[];
     resource_domains?: string[];
 };
+/**
+ * Build FrontMCP CSP format (camelCase like MCP Apps spec).
+ * Used for generic-mcp platform metadata.
+ */
+export declare function buildFrontMCPCSP(csp: UIContentSecurityPolicy): {
+    connectDomains?: string[];
+    resourceDomains?: string[];
+};
 /**
  * Build metadata for tool discovery (tools/list response).
  * This includes fields that should be present at discovery time,

package/adapters/platform-meta.d.ts.map

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

package/base-template/default-base-template.d.ts

@@ -11,7 +11,6 @@
  * - OpenAI Apps SDK (window.openai.toolOutput)
  * - Claude Artifacts
  * - Custom hosts using MCP protocol
- * - ngrok/iframe scenarios
  */
 import { type ThemeConfig } from '../theme';
 import { type McpSession } from './polyfills';

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

@@ -1 +1 @@
-{"version":3,"file":"default-base-template.d.ts","sourceRoot":"","sources":["../../src/base-template/default-base-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAE3D,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,sDAAsD;IACtD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,oCAAoC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAyW9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,CAQ3F"}
+{"version":3,"file":"default-base-template.d.ts","sourceRoot":"","sources":["../../src/base-template/default-base-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAE3D,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,sDAAsD;IACtD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,oCAAoC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAyW9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,CAQ3F"}

package/base-template/index.js

@@ -78,9 +78,6 @@ var scriptCache = /* @__PURE__ */ new Map();
 function getCachedScript(url) {
   return scriptCache.get(url);
 }
-function isScriptCached(url) {
-  return scriptCache.has(url);
-}
 function buildScriptTag(url, integrity, options = {}) {
   const attrs = [`src="${url}"`];
   if (integrity) {
@@ -111,8 +108,9 @@ function buildCdnScriptsFromTheme(theme, options = {}) {
   const iconsConfig = theme.cdn?.icons?.script ?? CDN.icons;
   if (inline) {
     if (tailwind) {
-      if (isScriptCached(tailwindUrl)) {
-        scripts.push(buildInlineScriptTag(getCachedScript(tailwindUrl)));
+      const cached = getCachedScript(tailwindUrl);
+      if (cached) {
+        scripts.push(buildInlineScriptTag(cached));
       } else {
         console.warn(
           "[frontmcp/ui] Inline mode requested but Tailwind script not cached. Call fetchAndCacheScriptsFromTheme() first."
@@ -120,8 +118,9 @@ function buildCdnScriptsFromTheme(theme, options = {}) {
       }
     }
     if (htmx) {
-      if (isScriptCached(htmxConfig.url)) {
-        scripts.push(buildInlineScriptTag(getCachedScript(htmxConfig.url)));
+      const cached = getCachedScript(htmxConfig.url);
+      if (cached) {
+        scripts.push(buildInlineScriptTag(cached));
       } else {
         console.warn(
           "[frontmcp/ui] Inline mode requested but HTMX script not cached. Call fetchAndCacheScriptsFromTheme() first."
@@ -129,8 +128,9 @@ function buildCdnScriptsFromTheme(theme, options = {}) {
       }
     }
     if (alpine) {
-      if (isScriptCached(alpineConfig.url)) {
-        scripts.push(buildInlineScriptTag(getCachedScript(alpineConfig.url)));
+      const cached = getCachedScript(alpineConfig.url);
+      if (cached) {
+        scripts.push(buildInlineScriptTag(cached));
       } else {
         console.warn(
           "[frontmcp/ui] Inline mode requested but Alpine.js script not cached. Call fetchAndCacheScriptsFromTheme() first."
@@ -138,8 +138,9 @@ function buildCdnScriptsFromTheme(theme, options = {}) {
       }
     }
     if (icons) {
-      if (isScriptCached(iconsConfig.url)) {
-        scripts.push(buildInlineScriptTag(getCachedScript(iconsConfig.url)));
+      const cached = getCachedScript(iconsConfig.url);
+      if (cached) {
+        scripts.push(buildInlineScriptTag(cached));
       } else {
         console.warn(
           "[frontmcp/ui] Inline mode requested but icons script not cached. Call fetchAndCacheScriptsFromTheme() first."
@@ -163,26 +164,6 @@ function buildCdnScriptsFromTheme(theme, options = {}) {
   return scripts.join("\n  ");
 }
 
-// libs/uipack/src/theme/platforms.ts
-var CLAUDE_PLATFORM = {
-  id: "claude",
-  name: "Claude (Artifacts)",
-  supportsWidgets: true,
-  supportsTailwind: true,
-  supportsHtmx: false,
-  // Network blocked, HTMX won't work for API calls
-  networkMode: "blocked",
-  scriptStrategy: "inline",
-  maxInlineSize: 100 * 1024,
-  // 100KB limit for artifacts
-  cspRestrictions: ["script-src 'unsafe-inline'", "connect-src 'none'"],
-  options: {
-    mode: "artifacts",
-    framework: "react"
-    // Claude artifacts prefer React
-  }
-};
-
 // libs/uipack/src/theme/presets/github-openai.ts
 var GITHUB_OPENAI_THEME = {
   name: "github-openai",
@@ -343,17 +324,31 @@ function emitColorScale(lines, name, scale) {
     if (value) lines.push(`--color-${name}-${shade}: ${value};`);
   }
 }
+var OPACITY_VARIANTS = [10, 20, 30, 50, 70, 90];
+function emitColorWithOpacityVariants(lines, name, value) {
+  lines.push(`--color-${name}: ${value};`);
+  for (const opacity of OPACITY_VARIANTS) {
+    lines.push(`--color-${name}-${opacity}: color-mix(in oklch, ${value} ${opacity}%, transparent);`);
+  }
+}
+function emitBrandColorWithVariants(lines, name, value) {
+  lines.push(`--color-${name}: ${value};`);
+  lines.push(`--color-${name}-hover: color-mix(in oklch, ${value} 85%, black);`);
+  for (const opacity of OPACITY_VARIANTS) {
+    lines.push(`--color-${name}-${opacity}: color-mix(in oklch, ${value} ${opacity}%, transparent);`);
+  }
+}
 function buildThemeCss(theme) {
   const lines = [];
   const semantic = theme.colors.semantic;
   if (typeof semantic.primary === "string") {
-    lines.push(`--color-primary: ${semantic.primary};`);
+    emitBrandColorWithVariants(lines, "primary", semantic.primary);
   } else if (semantic.primary) {
     emitColorScale(lines, "primary", semantic.primary);
   }
   if (semantic.secondary) {
     if (typeof semantic.secondary === "string") {
-      lines.push(`--color-secondary: ${semantic.secondary};`);
+      emitBrandColorWithVariants(lines, "secondary", semantic.secondary);
     } else {
       emitColorScale(lines, "secondary", semantic.secondary);
     }
@@ -372,10 +367,10 @@ function buildThemeCss(theme) {
       emitColorScale(lines, "neutral", semantic.neutral);
     }
   }
-  if (semantic.success) lines.push(`--color-success: ${semantic.success};`);
-  if (semantic.warning) lines.push(`--color-warning: ${semantic.warning};`);
-  if (semantic.danger) lines.push(`--color-danger: ${semantic.danger};`);
-  if (semantic.info) lines.push(`--color-info: ${semantic.info};`);
+  if (semantic.success) emitColorWithOpacityVariants(lines, "success", semantic.success);
+  if (semantic.warning) emitColorWithOpacityVariants(lines, "warning", semantic.warning);
+  if (semantic.danger) emitColorWithOpacityVariants(lines, "danger", semantic.danger);
+  if (semantic.info) emitColorWithOpacityVariants(lines, "info", semantic.info);
   const surface = theme.colors.surface;
   if (surface?.background) lines.push(`--color-background: ${surface.background};`);
   if (surface?.surface) lines.push(`--color-surface: ${surface.surface};`);