handoff-app 2.0.0-11 → 2.0.0-13

package/components.json

@@ -1,21 +1,21 @@
 {
-    "$schema": "https://ui.shadcn.com/schema.json",
-    "style": "new-york",
-    "rsc": false,
-    "tsx": true,
-    "tailwind": {
-      "config": "tailwind.config.ts",
-      "css": "src/app/css/index.css",
-      "baseColor": "zinc",
-      "cssVariables": true,
-      "prefix": ""
-    },
-    "aliases": {
-      "components": "src/app/components",
-      "utils": "src/app/lib/utils",
-      "ui": "src/app/components/ui",
-      "lib": "src/app/lib",
-      "hooks": "src/app/hooks"
-    },
-    "iconLibrary": "lucide"
-  }
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "tailwind.config.ts",
+    "css": "src/app/css/index.css",
+    "baseColor": "zinc",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "src/app/components",
+    "utils": "src/app/lib/utils",
+    "ui": "src/app/components/ui",
+    "lib": "src/app/lib",
+    "hooks": "src/app/hooks"
+  },
+  "iconLibrary": "lucide"
+}

package/config/docs/foundations/colors/guidelines.md

@@ -1,7 +1,6 @@
 ---
 title: Color Guidelines
 description: How to apply the color palette consistently and accessibly across products.
-metaTitle: 'Color Guidelines | Handoff Design System'
 metaDescription: 'How to apply the color palette consistently and accessibly across products.'
 ---
 

package/config/docs/foundations/colors.md

@@ -2,6 +2,5 @@
 title: Colors
 description: Color system built out of main brand colors and adjusted for variety of interfaces.
 image: hero-colors
-metaTitle: 'Colors | Handoff Design System'
 metaDescription: 'Color system built out of main brand colors and adjusted for variety of interfaces.'
 ---

package/config/docs/foundations/effects/guidelines.md

@@ -1,7 +1,6 @@
 ---
 title: Effects Guidelines
 description: When and how to apply shadows, blurs, and elevation across the interface.
-metaTitle: 'Effects Guidelines | Handoff Design System'
 metaDescription: 'When and how to apply shadows, blurs, and elevation across the interface.'
 ---
 

package/config/docs/foundations/effects/resources.md

@@ -1,7 +1,6 @@
 ---
 title: Effects Resources
 description: Reference values and assets for reproducing the brand's effects in any tool.
-metaTitle: 'Effects Resources | Handoff Design System'
 metaDescription: 'Reference values and assets for reproducing effects in any tool.'
 ---
 

package/config/docs/foundations/effects.md

@@ -2,7 +2,6 @@
 title: Effects
 description: Effects are Drop Shadows, Inner Shadows and Blur Effects. 
 image: hero-effects
-metaTitle: 'Effects | Handoff Design System'
 metaDescription: 'Effects are Drop Shadows, Inner Shadows and Blur Effects.'
 ---
 

package/config/docs/foundations/fonts.md

@@ -1,7 +1,6 @@
 ---
 title: Fonts
 description: Approved library of font families that are approved and licensed for use across the organization.
-metaTitle: Fonts | Handoff Design System
 metaDescription: Font families are packaged as assets that can be used across platforms.
 ---
 

package/config/docs/foundations/grid.md

@@ -2,7 +2,6 @@
 title: Grid
 description: Layout grid and spacing system that keeps compositions aligned and balanced.
 image: hero-design
-metaTitle: 'Grid | Handoff Design System'
 metaDescription: 'Layout grid and spacing system that keeps compositions aligned and balanced.'
 ---
 

package/config/docs/foundations/icon.md

@@ -1,6 +1,5 @@
 ---
 title: Icon Library
 description: Set of icons used to provide users with a way to process information faster and instinctively recognize actions signified by the icon.
-metaTitle: 'Icon Library | Handoff Design System'
 metaDescription: 'Set of icons used to provide users with a way to process information faster and instinctively recognize actions signified by the icon.'
 ---

package/config/docs/foundations/icons/guidelines.md

@@ -1,7 +1,6 @@
 ---
 title: Icon Guidelines
 description: Sizing, spacing, and usage rules that keep the icon set consistent.
-metaTitle: 'Icon Guidelines | Handoff Design System'
 metaDescription: 'Sizing, spacing, and usage rules that keep the icon set consistent.'
 ---
 

package/config/docs/foundations/icons.md

@@ -1,6 +1,5 @@
 ---
 title: Icon Library
 description: Set of icons used to provide users with a way to process information faster and instinctively recognize actions signified by the icon.
-metaTitle: 'Icon Library | Handoff Design System'
 metaDescription: 'Set of icons used to provide users with a way to process information faster and instinctively recognize actions signified by the icon.'
 ---

package/config/docs/foundations/images/guidelines.md

@@ -1,7 +1,6 @@
 ---
 title: Image Guidelines
 description: How to select, crop, and treat imagery so it stays on brand.
-metaTitle: 'Image Guidelines | Handoff Design System'
 metaDescription: 'How to select, crop, and treat imagery so it stays on brand.'
 ---
 

package/config/docs/foundations/images/resources.md

@@ -1,7 +1,6 @@
 ---
 title: Image Resources
 description: Source files and downloads for approved photography and illustration.
-metaTitle: 'Image Resources | Handoff Design System'
 metaDescription: 'Source files and downloads for approved photography and illustration.'
 ---
 

package/config/docs/foundations/images.md

@@ -2,7 +2,6 @@
 title: Images
 description: Photography and illustration style that shapes how the brand looks and feels.
 image: hero-design
-metaTitle: 'Images | Handoff Design System'
 metaDescription: 'Photography and illustration style that shapes how the brand looks and feels.'
 ---
 

package/config/docs/foundations/logo/resources.md

@@ -1,7 +1,6 @@
 ---
 title: Logo Resources
 description: Downloadable logo files and everything teams need to represent the brand correctly.
-metaTitle: 'Logo Resources | Handoff Design System'
 metaDescription: 'Downloadable logo files and everything teams need to represent the brand correctly.'
 ---
 

package/config/docs/foundations/logo.md

@@ -2,6 +2,5 @@
 title: Logos
 description: Show the logos used for promoting public identification and recognition.
 image: react
-metaTitle: 'Logos | Handoff Design System'
 metaDescription: 'Show the logos used for promoting public identification and recognition.'
 ---

package/config/docs/foundations/typography/guidelines.md

@@ -1,7 +1,6 @@
 ---
 title: Typography Guidelines
 description: Best practices for type scale, hierarchy, and readability across the system.
-metaTitle: 'Typography Guidelines | Handoff Design System'
 metaDescription: 'Best practices for type scale, hierarchy, and readability across the system.'
 ---
 

package/config/docs/foundations/typography/resources.md

@@ -1,7 +1,6 @@
 ---
 title: Typography Resources
 description: Font files, licenses, and assets needed to work with the brand typography.
-metaTitle: 'Typography Resources | Handoff Design System'
 metaDescription: 'Font files, licenses, and assets needed to work with the brand typography.'
 ---
 

package/config/docs/foundations/typography.md

@@ -2,7 +2,6 @@
 title: Typography
 description: Typographic system establishes scale, sizes and weight of text.
 image: hero-design
-metaTitle: 'Typography | Handoff Design System'
 metaDescription: 'Typographic system establishes scale, sizes and weight of text.'
 ---
 

package/config/docs/foundations.md

@@ -4,7 +4,6 @@ description: Set of design principles and visual guidelines that define the bran
 weight: 0
 image: hero-design
 menuTitle: 'Foundations'
-metaTitle: 'Design Foundations | Handoff Design System'
 metaDescription: 'Set of design principles and visual guidelines that define the brand across every experience'
 enabled: true
 menu:

package/config/docs/guidelines.md

@@ -4,7 +4,6 @@ description: How to build out a robust project built on the designs, tokens, and
 weight: 10
 image: hero-components
 menuTitle: 'Guidelines'
-metaTitle: 'Guidelines | Handoff Design System'
 metaDescription: 'How to build out a robust project built on the designs, tokens, and components documented here.'
 enabled: true
 menu:

package/config/docs/index.md

@@ -3,7 +3,6 @@ title: 'Handoff Design System for building better user experiences.'
 description: This is a sample page where you could insert a style guide.
 weight: -5
 menuTitle: 'Handoff'
-metaTitle: 'Style Guide | Handoff Design System'
 metaDescription: 'A sample page in the handoff design system, in markdown'
 enabled: true
 ---

package/config/docs/system/tokens/foundations/colors.md

@@ -7,10 +7,6 @@ description: |
 weight: 5
 image: hero-components
 menuTitle: 'Colors'
-metaTitle: 'Colors | Handoff Design System'
-metaDescription: |
-  Element that represents a control that provides a menu of options, collection 
-  of UI components used.'
 enabled: true
 menu:
   - title: Design System

package/config/docs/system/tokens/foundations/effects.md

@@ -4,10 +4,6 @@ description: Effects are the shadows and insets pulled automatically from Figma
 weight: 5
 image: hero-components
 menuTitle: 'Effects'
-metaTitle: 'Effects | Handoff Design System'
-metaDescription: |
-  Element that represents a control that provides a menu of options, collection 
-  of UI components used.
 enabled: true
 menu:
   - title: Design System

package/config/docs/system/tokens/foundations/typography.md

@@ -9,8 +9,6 @@ description: |
 weight: 5
 image: hero-components
 menuTitle: 'Typography'
-metaTitle: 'Typography | Handoff Design System'
-metaDescription: 'Element that represents a control that provides a menu of options, collection of UI components used.'
 enabled: true
 menu:
   - title: Design System

package/config/docs/system.md

@@ -4,8 +4,6 @@ description: Library of production-ready UI components built to deliver consiste
 weight: 5
 image: hero-components
 menuTitle: 'Design System'
-metaTitle: 'Design System | Handoff Design System'
-metaDescription: 'Element that represents a control that provides a menu of options, collection of UI components used.'
 enabled: true
 menu:
   - title: Design System

package/config/templates/page.md

@@ -3,7 +3,8 @@ title: 'The visible title of the page.'
 description: A description of the page.
 weight: 0
 menuTitle: 'Menu Title'
-metaTitle: 'Meta Title'
+# metaTitle replaces the whole browser title. Without it, the title is "<title> | <app.title>".
+# metaTitle: 'Meta Title'
 metaDescription: 'Insert a meta description'
 enabled: true
 ---

package/config/templates/page.mdx

@@ -3,7 +3,8 @@ title: 'The visible title of the page.'
 description: A description of the page.
 weight: 0
 menuTitle: 'Menu Title'
-metaTitle: 'Meta Title'
+# metaTitle replaces the whole browser title. Without it, the title is "<title> | <app.title>".
+# metaTitle: 'Meta Title'
 metaDescription: 'Insert a meta description'
 enabled: true
 ---

package/dist/ai/define.d.ts

@@ -1,5 +1,5 @@
 /**
- * Typed identity helper for custom AI providers (mirrors `defineAssetStorage`): a consumer
+ * Typed identity helper for custom AI providers (mirrors `defineStorageProvider`): a consumer
  * default-exports its result from a **server-only** module and points a connection's `module` at
  * it. It must be its own module (not an inline `defineConfig` function) so the build can trace it
  * into the deployed registry. The default export may be the provider object, or a factory

package/dist/ai/define.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Typed identity helper for custom AI providers (mirrors `defineAssetStorage`): a consumer
+ * Typed identity helper for custom AI providers (mirrors `defineStorageProvider`): a consumer
  * default-exports its result from a **server-only** module and points a connection's `module` at
  * it. It must be its own module (not an inline `defineConfig` function) so the build can trace it
  * into the deployed registry. The default export may be the provider object, or a factory

package/dist/ai/types.d.ts

@@ -2,7 +2,7 @@
  * Server-only AI provider contract for connections that are not OpenAI-compatible.
  *
  * Every built-in connection speaks the OpenAI-compatible `/chat/completions` API and needs no
- * adapter — Ollama, LiteLLM, OpenRouter, vLLM, LM Studio and Azure OpenAI all serve it, and each of
+ * custom module — Ollama, LiteLLM, OpenRouter, vLLM, LM Studio and Azure OpenAI all serve it, and each of
  * them fronts Anthropic, Google and xAI models. A provider that fits nothing else names a
  * {@link defineAiProvider} module instead of a base URL.
  */

package/dist/ai/types.js

@@ -3,7 +3,7 @@
  * Server-only AI provider contract for connections that are not OpenAI-compatible.
  *
  * Every built-in connection speaks the OpenAI-compatible `/chat/completions` API and needs no
- * adapter — Ollama, LiteLLM, OpenRouter, vLLM, LM Studio and Azure OpenAI all serve it, and each of
+ * custom module — Ollama, LiteLLM, OpenRouter, vLLM, LM Studio and Azure OpenAI all serve it, and each of
  * them fronts Anthropic, Google and xAI models. A provider that fits nothing else names a
  * {@link defineAiProvider} module instead of a base URL.
  */

package/dist/app-builder/build.js

@@ -212,7 +212,7 @@ const cleanupAppDirectory = (handoff) => __awaiter(void 0, void 0, void 0, funct
  * @returns The path to the prepared application directory
  */
 const initializeProjectApp = (handoff_1, ...args_1) => __awaiter(void 0, [handoff_1, ...args_1], void 0, function* (handoff, options = {}) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
     const includeWorkspaceArtifacts = (_a = options.includeWorkspaceArtifacts) !== null && _a !== void 0 ? _a : true;
     const runtimeMode = (_e = (_b = options.runtimeModeOverride) !== null && _b !== void 0 ? _b : (_d = (_c = handoff.config) === null || _c === void 0 ? void 0 : _c.runtime) === null || _d === void 0 ? void 0 : _d.mode) !== null && _e !== void 0 ? _e : 'workspace';
     const srcPath = path_1.default.resolve(handoff.modulePath, 'src', 'app');
@@ -261,16 +261,16 @@ const initializeProjectApp = (handoff_1, ...args_1) => __awaiter(void 0, [handof
     const escapedMcpEnabled = escapeForSingleQuotedJsString(String((0, config_1.isMcpEnabled)(handoff.config)));
     const escapedRegistryDriver = escapeForSingleQuotedJsString((0, driver_1.resolveRegistryDriver)(handoff.config));
     const escapedDatabaseUrlEnv = escapeForSingleQuotedJsString((0, driver_1.resolveDatabaseUrlEnv)(handoff.config));
-    // Asset storage selection baked (adapter + module + options JSON with `{ $env }` references).
+    // Asset storage selection baked (provider + module + options JSON with `{ $env }` references).
     const assetStorage = (0, resolve_1.resolveAssetStorageFromConfig)(handoff.config);
-    const escapedAssetStorageAdapter = escapeForSingleQuotedJsString(assetStorage.adapterKind);
+    const escapedAssetStorageProvider = escapeForSingleQuotedJsString(assetStorage.provider);
     const escapedAssetStorageModule = escapeForSingleQuotedJsString((_j = assetStorage.module) !== null && _j !== void 0 ? _j : '');
     const escapedAssetStorageMaxInline = escapeForSingleQuotedJsString(String(assetStorage.maxInlineBytes));
     const escapedAssetStorageOptions = escapeForSingleQuotedJsString(JSON.stringify((_k = assetStorage.options) !== null && _k !== void 0 ? _k : {}));
     const email = (0, resolve_2.resolveEmailFromConfig)(handoff.config);
-    const escapedEmailProvider = escapeForSingleQuotedJsString(email.provider);
-    const escapedEmailFrom = escapeForSingleQuotedJsString((_l = email.from) !== null && _l !== void 0 ? _l : '');
-    const escapedEmailModule = escapeForSingleQuotedJsString((_m = email.module) !== null && _m !== void 0 ? _m : '');
+    const escapedEmailProvider = escapeForSingleQuotedJsString((_l = email.provider) !== null && _l !== void 0 ? _l : '');
+    const escapedEmailFrom = escapeForSingleQuotedJsString((_m = email.from) !== null && _m !== void 0 ? _m : '');
+    const escapedEmailModule = escapeForSingleQuotedJsString((_o = email.module) !== null && _o !== void 0 ? _o : '');
     const escapedEmailOptions = escapeForSingleQuotedJsString(JSON.stringify(email.options));
     // AI assistant selection baked (enabled flag + declared connections + default model). Connections
     // carry env-var names and non-secret options only; keys are read from their named env var at
@@ -278,7 +278,7 @@ const initializeProjectApp = (handoff_1, ...args_1) => __awaiter(void 0, [handof
     const ai = (0, connections_1.resolveAiFromConfig)(handoff.config);
     const escapedAiEnabled = escapeForSingleQuotedJsString(String(ai.enabled));
     const escapedAiConnections = escapeForSingleQuotedJsString(JSON.stringify(ai.connections));
-    const escapedAiDefaultModel = escapeForSingleQuotedJsString((_o = ai.defaultModel) !== null && _o !== void 0 ? _o : '');
+    const escapedAiDefaultModel = escapeForSingleQuotedJsString((_p = ai.defaultModel) !== null && _p !== void 0 ? _p : '');
     const placeholderValues = {
         '%HANDOFF_PROJECT_ID%': escapedProjectId,
         '%HANDOFF_APP_BASE_PATH%': escapedAppBasePath,
@@ -291,7 +291,7 @@ const initializeProjectApp = (handoff_1, ...args_1) => __awaiter(void 0, [handof
         '%HANDOFF_MCP_ENABLED%': escapedMcpEnabled,
         '%HANDOFF_REGISTRY_DRIVER%': escapedRegistryDriver,
         '%HANDOFF_REGISTRY_DATABASE_URL_ENV%': escapedDatabaseUrlEnv,
-        '%HANDOFF_ASSET_STORAGE_ADAPTER%': escapedAssetStorageAdapter,
+        '%HANDOFF_ASSET_STORAGE_PROVIDER%': escapedAssetStorageProvider,
         '%HANDOFF_ASSET_STORAGE_MODULE%': escapedAssetStorageModule,
         '%HANDOFF_ASSET_STORAGE_MAX_INLINE_BYTES%': escapedAssetStorageMaxInline,
         '%HANDOFF_ASSET_STORAGE_OPTIONS%': escapedAssetStorageOptions,
@@ -406,7 +406,7 @@ ${aiOptionEnvs.map((name) => `- \`${name}\` — read by a custom AI provider at
 merged over the list this build baked in, keyed by \`id\`. Use it to add or repoint a provider
 without rebuilding.
 `;
-    const assetStorageEnvs = assetStorage.adapterKind === 'custom' ? (0, from_env_1.envReferenceNames)(assetStorage.options) : [];
+    const assetStorageEnvs = assetStorage.provider === 'custom' ? (0, from_env_1.envReferenceNames)(assetStorage.options) : [];
     const emailEnvs = (0, from_env_1.envReferenceNames)(email.options);
     const emailSection = !email.from
         ? 'Email delivery is off because `runtime.registry.email.from` is not set. Invitation links are shown once to an administrator for manual delivery.'
@@ -427,7 +427,7 @@ and \`.next/static/\` already copied alongside so the server serves them.
 - \`${databaseUrlEnv}\` — PostgreSQL/Neon connection string, read at request time.
 - \`AUTH_SECRET\` — a long, random secret used to sign browser sessions.
 - \`AUTH_URL\` — the canonical public registry URL, including the configured base path.
-${assetStorageEnvs.map((name) => `- \`${name}\` — read by the custom asset storage adapter at request time.\n`).join('')}
+${assetStorageEnvs.map((name) => `- \`${name}\` — read by the custom asset storage provider at request time.\n`).join('')}
 ${emailSection}
 ${aiSection}
 ## Database migrations
@@ -498,8 +498,8 @@ For multi-instance self-hosting, front \`/_next/static\` with a CDN and configur
 
 ## Deploying to Vercel
 
-Vercel does **not** use \`output: 'standalone'\` — it ignores that setting and builds with its own
-adapter, so this pre-built bundle is **not** the artifact you deploy there. For Vercel, deploy the
+Vercel does **not** use \`output: 'standalone'\` — it ignores that setting and runs its
+own build, so this pre-built bundle is **not** the artifact you deploy there. For Vercel, deploy the
 registry app via Vercel's Git/CLI source build (it produces and serves the dynamic app itself) and
 supply the same environment variables above as project env vars. Use this standalone bundle for
 containers, custom Node servers, and other non-Vercel hosts.
@@ -510,7 +510,7 @@ containers, custom Node servers, and other non-Vercel hosts.
  * Resolve the set of npm packages the packaged registry app must be able to `require`/`import` at
  * runtime, given the configured database driver. `next`/`react`/`react-dom` run the server and React
  * runtime; `drizzle-orm` backs both the request-time DB client and the migration runner; the MCP SDK
- * (and its `zod` peer) is only needed when `/api/mcp/` is enabled; the driver package is
+ * is only needed when `/api/mcp/` is enabled; the driver package is
  * driver-specific (the Neon serverless driver also needs `ws` for its Node WebSocket transport); the
  * SMTP email provider needs `nodemailer`.
  */
@@ -520,7 +520,7 @@ const getRequiredRegistryRuntimeModules = (handoff) => {
     // The assistant runs the MCP tools in-process, so it needs the MCP SDK whether or not the HTTP
     // endpoint is served.
     if ((0, config_1.isMcpEnabled)(handoff.config) || ai.enabled) {
-        base.push('@modelcontextprotocol/sdk', 'zod');
+        base.push('@modelcontextprotocol/sdk');
     }
     if (ai.enabled) {
         base.push('ai', '@ai-sdk/openai-compatible');
@@ -559,7 +559,7 @@ const getCustomServerModules = (handoff) => {
     const assetStorage = (0, resolve_1.resolveAssetStorageFromConfig)(handoff.config);
     const email = (0, resolve_2.resolveEmailFromConfig)(handoff.config);
     const modules = [
-        assetStorage.adapterKind === 'custom' ? assetStorage.module : undefined,
+        assetStorage.provider === 'custom' ? assetStorage.module : undefined,
         email.provider === 'custom' ? email.module : undefined,
         ...(0, connections_1.resolveAiFromConfig)(handoff.config).connections.map((connection) => connection.module),
     ];
@@ -586,7 +586,7 @@ const copyCustomServerModules = (handoff, tracingRoot, entryDir) => __awaiter(vo
                 `Install the packages it imports so that they resolve from "${handoff.workingPath}".`);
         }
         if ([...fileList].some((file) => file.split(path_1.default.sep).join('/').endsWith('node_modules/handoff-app/dist/index.js'))) {
-            throw new HandoffBuildError(`The custom server module "${module}" imports "handoff-app", which loads the whole CLI. Import the define helpers from "handoff-app/define".`);
+            throw new HandoffBuildError(`The custom server module "${module}" imports "handoff-app", which loads the whole CLI. Import the define helpers from "handoff-app/providers".`);
         }
         fileList.forEach((file) => files.add(file));
     }

package/dist/app-builder/client-config.js

@@ -72,7 +72,7 @@ const buildServerRuntimeConfig = (config, modeOverride) => {
             databaseUrlEnv: (0, driver_1.resolveDatabaseUrlEnv)(config),
         },
         assetStorage: {
-            adapter: assetStorage.adapterKind,
+            provider: assetStorage.provider,
             module: assetStorage.module,
             maxInlineBytes: assetStorage.maxInlineBytes,
             options: assetStorage.options,

package/dist/config/loader.js

@@ -11,7 +11,6 @@ const mergeWith_1 = __importDefault(require("lodash/mergeWith"));
 const omit_1 = __importDefault(require("lodash/omit"));
 const module_1 = require("module");
 const path_1 = __importDefault(require("path"));
-const resolve_1 = require("../registry/email/resolve");
 const logger_1 = require("../utils/logger");
 const path_2 = require("../utils/path");
 const defaults_1 = require("./defaults");
@@ -179,7 +178,7 @@ const replaceValues = (destination, source) => {
  * the deep merge never mixes the settings of two providers.
  */
 const resetEmailOnProviderChange = (layers) => {
-    let provider = resolve_1.DEFAULT_EMAIL_PROVIDER;
+    let provider;
     let start = 0;
     layers.forEach((layer, index) => {
         var _a, _b, _c;

package/dist/index.d.ts

@@ -261,8 +261,8 @@ export { defineConfig } from './config';
 export { fromEnv } from './config/from-env';
 export type { EnvValue, EnvSecret, RuntimeEnvReference } from './config/from-env';
 export type { CatalogItem, CatalogItemEntries, CatalogItemInput, CatalogItemMeta, CatalogPreview, CompositionRef, Preview, SourceDescriptor, SourceFormat, RendererKind, } from './catalog';
-export { defineAssetStorage } from './registry/asset-storage/define';
-export type { AssetStorage, AssetStorageContext, AssetStorageFactory, AssetStorageInput, AssetStorageReadResult, AssetUpload, AssetUploadInput, } from './registry/asset-storage/types';
+export { defineStorageProvider } from './registry/asset-storage/define';
+export type { StorageProvider, StorageProviderContext, StorageProviderFactory, StorageInput, StorageReadResult, AssetUpload, AssetUploadInput, } from './registry/asset-storage/types';
 export { defineEmailProvider } from './registry/email/define';
 export type { EmailMessage, EmailProvider, EmailProviderContext, EmailProviderFactory } from './registry/email/types';
 export { defineAiProvider } from './ai/define';

package/dist/index.js

@@ -35,7 +35,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CoreTypes = exports.CoreTransformerUtils = exports.CoreTransformers = exports.defineAiProvider = exports.defineEmailProvider = exports.defineAssetStorage = exports.fromEnv = exports.defineConfig = void 0;
+exports.CoreTypes = exports.CoreTransformerUtils = exports.CoreTransformers = exports.defineAiProvider = exports.defineEmailProvider = exports.defineStorageProvider = exports.fromEnv = exports.defineConfig = void 0;
 require("./config/env");
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const handoff_core_1 = require("handoff-core");
@@ -643,7 +643,7 @@ Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function
 var from_env_1 = require("./config/from-env");
 Object.defineProperty(exports, "fromEnv", { enumerable: true, get: function () { return from_env_1.fromEnv; } });
 var define_1 = require("./registry/asset-storage/define");
-Object.defineProperty(exports, "defineAssetStorage", { enumerable: true, get: function () { return define_1.defineAssetStorage; } });
+Object.defineProperty(exports, "defineStorageProvider", { enumerable: true, get: function () { return define_1.defineStorageProvider; } });
 var define_2 = require("./registry/email/define");
 Object.defineProperty(exports, "defineEmailProvider", { enumerable: true, get: function () { return define_2.defineEmailProvider; } });
 var define_3 = require("./ai/define");

package/dist/nav/index.d.ts

@@ -78,6 +78,6 @@ export interface NavData {
 export { getNavData } from './resolver';
 export type { GetNavDataInput } from './resolver';
 export { getWorkspaceNavData } from './workspace';
-export type { WorkspaceNavAdapterOptions, WorkspaceNavLoaders } from './workspace';
+export type { WorkspaceNavOptions, WorkspaceNavLoaders } from './workspace';
 export { getRegistryNavData } from './registry';
-export type { RegistryNavAdapterOptions, RegistryNavRecords } from './registry';
+export type { RegistryNavOptions, RegistryNavRecords } from './registry';

package/dist/nav/registry.d.ts

@@ -5,11 +5,11 @@ export interface RegistryNavRecords {
     pages: NavPageRecord[];
     tokenSets: NavTokenSet[];
 }
-export interface RegistryNavAdapterOptions {
+export interface RegistryNavOptions {
     shell: SectionLink[];
     load: NavLoad;
     basePath?: string;
     fetchRecords: () => Promise<RegistryNavRecords>;
 }
-/** Registry adapter: shell-only initial load, or one best-effort runtime-record fetch on refresh. */
-export declare const getRegistryNavData: (options: RegistryNavAdapterOptions) => Promise<NavData>;
+/** Registry nav data: shell-only initial load, or one best-effort runtime-record fetch on refresh. */
+export declare const getRegistryNavData: (options: RegistryNavOptions) => Promise<NavData>;

package/dist/nav/registry.js

@@ -13,7 +13,7 @@ exports.getRegistryNavData = void 0;
 const menu_shell_1 = require("../utils/menu-shell");
 const resolver_1 = require("./resolver");
 const emptyRecords = () => ({ components: [], patterns: [], pages: [], tokenSets: [] });
-/** Registry adapter: shell-only initial load, or one best-effort runtime-record fetch on refresh. */
+/** Registry nav data: shell-only initial load, or one best-effort runtime-record fetch on refresh. */
 const getRegistryNavData = (options) => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
     let records = emptyRecords();

package/dist/nav/workspace.d.ts

@@ -6,13 +6,13 @@ export interface WorkspaceNavLoaders {
     pages: () => Awaitable<NavPageRecord[]>;
     tokenSets: () => Awaitable<NavTokenSet[]>;
 }
-export interface WorkspaceNavAdapterOptions {
+export interface WorkspaceNavOptions {
     docRoot: string;
     workingPagesDir?: string;
     basePath?: string;
     load?: NavLoad;
     loaders: WorkspaceNavLoaders;
 }
-/** Workspace/static adapter: live filesystem shell plus best-effort local snapshot loaders. */
-export declare const getWorkspaceNavData: (options: WorkspaceNavAdapterOptions) => Promise<NavData>;
+/** Workspace/static nav data: live filesystem shell plus best-effort local snapshot loaders. */
+export declare const getWorkspaceNavData: (options: WorkspaceNavOptions) => Promise<NavData>;
 export {};

package/dist/nav/workspace.js

@@ -64,7 +64,7 @@ const markdownTitle = (id, docRoot, workingPagesDir) => {
     }
     return undefined;
 };
-/** Workspace/static adapter: live filesystem shell plus best-effort local snapshot loaders. */
+/** Workspace/static nav data: live filesystem shell plus best-effort local snapshot loaders. */
 const getWorkspaceNavData = (options) => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
     const [loadedComponents, patterns, pages, loadedTokenSets] = yield Promise.all([

package/dist/providers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Define helpers for custom server modules: storage, email and AI providers. This entry point has no
+ * runtime dependencies, so a module that imports it does not pull the CLI into the registry bundle.
+ */
+export { defineAiProvider } from './ai/define';
+export type { AiProvider, AiProviderContext, AiProviderFactory } from './ai/types';
+export { defineStorageProvider } from './registry/asset-storage/define';
+export type { StorageProvider, StorageProviderContext, StorageProviderFactory, StorageInput, StorageReadResult, AssetUpload, AssetUploadInput, } from './registry/asset-storage/types';
+export { defineEmailProvider } from './registry/email/define';
+export type { EmailMessage, EmailProvider, EmailProviderContext, EmailProviderFactory } from './registry/email/types';

package/dist/{define.js → providers.js}

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineEmailProvider = exports.defineAssetStorage = exports.defineAiProvider = void 0;
+exports.defineEmailProvider = exports.defineStorageProvider = exports.defineAiProvider = void 0;
 /**
- * Define helpers for custom server modules. This entry point has no runtime dependencies, so a module
- * that imports it does not pull the CLI into the registry bundle.
+ * Define helpers for custom server modules: storage, email and AI providers. This entry point has no
+ * runtime dependencies, so a module that imports it does not pull the CLI into the registry bundle.
  */
 var define_1 = require("./ai/define");
 Object.defineProperty(exports, "defineAiProvider", { enumerable: true, get: function () { return define_1.defineAiProvider; } });
 var define_2 = require("./registry/asset-storage/define");
-Object.defineProperty(exports, "defineAssetStorage", { enumerable: true, get: function () { return define_2.defineAssetStorage; } });
+Object.defineProperty(exports, "defineStorageProvider", { enumerable: true, get: function () { return define_2.defineStorageProvider; } });
 var define_3 = require("./registry/email/define");
 Object.defineProperty(exports, "defineEmailProvider", { enumerable: true, get: function () { return define_3.defineEmailProvider; } });