@powerhousedao/builder-tools 6.2.3-dev.4 → 6.2.3-dev.41

package/dist/index.d.mts

@@ -1,17 +1,17 @@
+import { DYNAMIC_BASE_PLACEHOLDER } from "@powerhousedao/shared/connect";
 import { CommonServerOptions, HtmlTagDescriptor, InlineConfig, Plugin } from "vite";
 import { PowerhouseConfig, PowerhousePackage } from "@powerhousedao/config";
-import { PHConnectRuntimeConfig } from "@powerhousedao/shared/clis";
-
+import { PHConnectRuntimeConfig, PowerhouseConfig as PowerhouseConfig$1 } from "@powerhousedao/shared/clis";
 //#region connect-utils/constants.d.ts
-declare const EXTERNAL_PACKAGES_IMPORT = "PH:EXTERNAL_PACKAGES";
-declare const IMPORT_SCRIPT_FILE = "external-packages.js";
-declare const LOCAL_PACKAGE_ID = "ph:local-package";
-declare const PH_DIR_NAME = ".ph";
+export declare const EXTERNAL_PACKAGES_IMPORT = "PH:EXTERNAL_PACKAGES";
+export declare const IMPORT_SCRIPT_FILE = "external-packages.js";
+export declare const LOCAL_PACKAGE_ID = "ph:local-package";
+export declare const PH_DIR_NAME = ".ph";
 //#endregion
 //#region connect-utils/vite-plugins/build-hash.d.ts
 /** Name of the build-identity file emitted into the build output. */
-declare const BUILD_HASH_FILE: "build-hash.json";
-interface BuildHashInput {
+export declare const BUILD_HASH_FILE: "build-hash.json";
+export interface BuildHashInput {
   /** Monorepo workspace git SHA (CI/dev builds); empty outside the monorepo. */
   workspaceGitSha: string;
   /** Monorepo workspace version (CI/dev builds); empty outside it. */
@@ -38,8 +38,8 @@ interface BuildHashInput {
  * (define `PH_CONNECT_BUILD_HASH`) to `build-hash.json`, which the build
  * emits alongside the app and the server must serve no-cache.
  */
-declare function computeBuildHash(input: BuildHashInput): string;
-declare function buildHashFromBuildOptions(options: {
+export declare function computeBuildHash(input: BuildHashInput): string;
+export declare function buildHashFromBuildOptions(options: {
   dirname: string;
   phConfig: unknown;
   packages: ReadonlyArray<{
@@ -57,13 +57,13 @@ declare function buildHashFromBuildOptions(options: {
  * Build-only: dev (studio) never runs generateBundle, and the SPA check
  * treats a missing file as "nothing to compare" and stays silent.
  */
-declare function connectBuildHashPlugin(buildHash: string): Plugin;
+export declare function connectBuildHashPlugin(buildHash: string): Plugin;
 //#endregion
 //#region connect-utils/externalize-vendor.d.ts
-interface VendorPrebuildOptions {
-  /** Project root (the reactor-project dir). */
+export interface VendorPrebuildOptions {
+  /** Project root the vendor deps resolve from. */
   dirname: string;
-  /** Bare specifiers to bundle into the vendor (defaults to the heavy libs). */
+  /** Specifiers to prebuild into the vendor (defaults to the dev set). */
   include?: string[];
   /** Specifiers left external to the build (defaults to the React family). */
   external?: string[];
@@ -73,35 +73,68 @@ interface VendorPrebuildOptions {
   errorRef?: {
     message?: string;
   };
+  /**
+   * The APP's base — the same string the app build uses (the dynamic-base
+   * placeholder, or a normalized deploy base like "/app/"). The vendor's own
+   * build base is this plus the vendor segment, so emitted asset URLs land
+   * under <app-base>__vendor__/. Default: the dynamic placeholder + segment
+   * (dev behavior). Import-map values stay base-relative; the production
+   * build strips the leading slash (values then resolve against the page URL
+   * under any deploy base), the dev flow prefixes its own base.
+   */
+  base?: string;
+  /** NODE_ENV define for the vendor build (default "development"). */
+  nodeEnv?: "development" | "production";
 }
 /**
  * The stable Connect libraries worth prebuilding. The React family is NOT here —
  * it's externalized from the build (see `VENDOR_EXTERNAL`) so the vendor shares
  * the dev server's single React instance via the import map.
  */
-declare const DEFAULT_VENDOR_INCLUDE: string[];
+export declare const DEFAULT_VENDOR_INCLUDE: string[];
 /**
  * React-family specifiers kept external to the vendor build. The vendor's chunks
  * emit bare imports for these; `devReactImportmapPlugin`'s import map resolves
  * them to Vite's pre-bundled React, so there is exactly one React instance.
  */
-declare const VENDOR_EXTERNAL: string[];
-interface PrebuiltVendor {
+export declare const VENDOR_EXTERNAL: string[];
+export interface PrebuiltVendor {
   vendorDir: string;
-  /** import map: bare specifier -> "/__vendor__/<entry>.js". */
+  /** import map: bare specifier -> "/__vendor__/<entry>.js" (base-relative). */
   imports: Record<string, string>;
+  /** Resolved versions of every included + external package. */
+  versions: Record<string, string>;
 }
 /** URL prefix the vendor bundle is served under by the dev middleware. */
-declare const VENDOR_URL_PREFIX = "/__vendor__/";
+export declare const VENDOR_URL_PREFIX = "/__vendor__/";
 /**
  * Build the prebuilt vendor (once, in a throwaway subprocess) and return its dir
  * + import map. Idempotent: reuses a cached vendor built for the same dep set.
  * Returns null on any failure (caller falls back to a normal dev server).
  */
-declare function prebuildConnectVendor(options: VendorPrebuildOptions): Promise<PrebuiltVendor | null>;
+export declare function prebuildConnectVendor(options: VendorPrebuildOptions): Promise<PrebuiltVendor | null>;
+/**
+ * The published specifiers whose entry file the vendor build never emitted.
+ * URLs are base-less (`/__vendor__/x.js`) and resolve inside `vendorDir`.
+ */
+export declare function missingVendorEntries(vendorDir: string, imports: Record<string, string>): {
+  spec: string;
+  url: string;
+}[];
+/**
+ * Rebase the vendor's base-less entry URLs (`/__vendor__/x.js`) onto the
+ * deploy base, so a consumer that resolves them against the page origin lands
+ * under that base rather than the server root. A dynamic-base build keeps its
+ * placeholder, which the runtime substitutes.
+ *
+ * `base` is the app base from `prebuildConnectVendor` callers, but the
+ * VENDOR_DYNAMIC_BASE default already carries the vendor segment — that
+ * trailing segment is dropped first so it is never doubled.
+ */
+export declare function withVendorBase(imports: Record<string, string>, base: string): Record<string, string>;
 //#endregion
 //#region connect-utils/types.d.ts
-type IConnectOptions = {
+export type IConnectOptions = {
   mode: string;
   dirname: string;
   envDir?: string;
@@ -127,8 +160,18 @@ type IConnectOptions = {
   cliPackageRegistryUrl?: string;
   dynamicBase?: boolean;
   favicon?: string;
+  /**
+   * Production vendor: the prebuilt shared-dependency bundle's import map and
+   * version table (from `prebuildConnectVendor`). When set on a production
+   * build, the shared specifiers are externalized from the app bundle and
+   * merged into the page import map. Build input only.
+   */
+  vendor?: {
+    imports: Record<string, string>;
+    versions: Record<string, string>;
+  };
 };
-type ConnectCommonOptions = {
+export type ConnectCommonOptions = {
   base?: string;
   mode?: string;
   configFile?: string;
@@ -138,71 +181,71 @@ type ConnectCommonOptions = {
   defaultDrivesUrl?: string[];
   drivesPreserveStrategy?: "preserve-all" | "preserve-by-url-and-detach";
 };
-type ViteDevOptions = Pick<CommonServerOptions, "port" | "host" | "open" | "cors" | "strictPort"> & {
+export type ViteDevOptions = Pick<CommonServerOptions, "port" | "host" | "open" | "cors" | "strictPort"> & {
   force?: boolean;
 };
-type ConnectStudioOptions = ConnectCommonOptions & {
+export type ConnectStudioOptions = ConnectCommonOptions & {
   devServerOptions?: ViteDevOptions;
   printUrls?: boolean;
   bindCLIShortcuts?: boolean;
 };
-type ConnectBuildOptions = ConnectCommonOptions & {
+export type ConnectBuildOptions = ConnectCommonOptions & {
   outDir?: string;
 };
-type ConnectPreviewOptions = ConnectCommonOptions & Omit<ViteDevOptions, "cors"> & {
+export type ConnectPreviewOptions = ConnectCommonOptions & Omit<ViteDevOptions, "cors"> & {
   outDir?: string;
   printUrls?: boolean;
   bindCLIShortcuts?: boolean;
 };
 //#endregion
 //#region connect-utils/helpers.d.ts
-declare const DEFAULT_CONNECT_OUTDIR: ".ph/connect-build/dist/";
-declare function resolveViteConfigPath(options: Pick<ConnectCommonOptions, "projectRoot" | "viteConfigFile">): string;
-declare function resolvePackage(packageName: string, root?: string): string;
-declare function resolveConnectPackageJson(root?: string): JSON | null;
+export declare const DEFAULT_CONNECT_OUTDIR: ".ph/connect-build/dist/";
+export declare function resolveViteConfigPath(options: Pick<ConnectCommonOptions, "projectRoot" | "viteConfigFile">): string;
+export declare function resolvePackage(packageName: string, root?: string): string;
+export declare function resolveConnectPackageJson(root?: string): JSON | null;
 /**
  * Finds the dist dir of Connect on the local machine
  */
-declare function resolveConnectBundle(root?: string): string;
-declare function resolveConnectPublicDir(root?: string): string;
+export declare function resolveConnectBundle(root?: string): string;
+export declare function resolveConnectPublicDir(root?: string): string;
 /**
  * Copies the Connect dist dir to the target path
  */
-declare function copyConnect(sourcePath: string, targetPath: string): void;
+export declare function copyConnect(sourcePath: string, targetPath: string): void;
 /**
  * Backs up the index.html file
  *
  * Needed when running the Connect Studio dev server on Windows
  */
-declare function backupIndexHtml(appPath: string, restore?: boolean): void;
-declare function removeBase64EnvValues(appPath: string): void;
-declare function readJsonFile(filePath: string): PowerhouseConfig | null;
+export declare function backupIndexHtml(appPath: string, restore?: boolean): void;
+export declare function removeBase64EnvValues(appPath: string): void;
+export declare function readJsonFile(filePath: string): PowerhouseConfig | null;
 /**
  * Takes a list of Powerhouse project packages and optionally local Powerhouse packages and outputs a js file which exports those packages for use in Connect Studio.
  */
-declare function makeImportScriptFromPackages(args: {
+export declare function makeImportScriptFromPackages(args: {
   packages: string[];
   importStyles?: boolean;
   localJsPath?: string;
   localCssPath?: string;
 }): string;
-declare function ensureNodeVersion(minVersion?: string): void;
-declare function runShellScriptPlugin(scriptName: string, connectPath: string): Plugin;
+export declare function ensureNodeVersion(minVersion?: string): void;
+export declare function runShellScriptPlugin(scriptName: string, connectPath: string): Plugin;
 /**
  * Appends the contents to the <head> tag of the index.html file
  */
-declare function appendToHtmlHead(pathToHtml: string, contents: string): Promise<void>;
+export declare function appendToHtmlHead(pathToHtml: string, contents: string): Promise<void>;
 /**
  * Prepends the contents to the <head> tag of the index.html file
  */
-declare function prependToHtmlHead(pathToHtml: string, contents: string): Promise<void>;
-declare function runTsc(outDir: string): void;
-declare function stripVersionFromPackage(packageName: string): string;
+export declare function prependToHtmlHead(pathToHtml: string, contents: string): Promise<void>;
+export declare function runTsc(outDir: string): void;
+export declare function stripVersionFromPackage(packageName: string): string;
 //#endregion
 //#region connect-utils/runtime-config-schema.d.ts
-declare const RUNTIME_CONFIG_SCHEMA_ID = "https://powerhouse.inc/schemas/powerhouse.config.json";
-declare const RUNTIME_CONFIG_SCHEMA_URL = "https://raw.githubusercontent.com/powerhouse-inc/powerhouse/main/packages/builder-tools/connect-utils/runtime-config.schema.json";
-declare const runtimeConfigSchema: {
+export declare const RUNTIME_CONFIG_SCHEMA_ID = "https://powerhouse.inc/schemas/powerhouse.config.json";
+export declare const RUNTIME_CONFIG_SCHEMA_URL = "https://raw.githubusercontent.com/powerhouse-inc/powerhouse/main/packages/builder-tools/connect-utils/runtime-config.schema.json";
+export declare const runtimeConfigSchema: {
   readonly $schema: "http://json-schema.org/draft-07/schema#";
   readonly $id: "https://powerhouse.inc/schemas/powerhouse.config.json";
   readonly title: "Powerhouse Connect runtime configuration";
@@ -315,6 +358,10 @@ declare const runtimeConfigSchema: {
               readonly description: "Studio mode. Enables builder-only capabilities: Connect loads the vetra package and exposes DocumentModel (and vetra spec types) as creatable documents. Forced on by `ph vetra` / `ph connect studio`; false by default.";
               readonly default: false;
             };
+            readonly workflowsEnabled: {
+              readonly type: "boolean";
+              readonly description: "Powerhouse workflows in Connect. When true the tab loads the @powerhousedao/workflow package (workflow + connection documents, their editors and Workflow Studio) and the reactor worker registers its document models. Falls back to the top-level `workflows.enabled`; set it to override that for Connect. Independent of studioMode. False when neither is set.";
+            };
           };
         };
         readonly ai: {
@@ -406,7 +453,7 @@ declare const runtimeConfigSchema: {
             readonly preserveStrategy: {
               readonly type: "string";
               readonly enum: readonly ["preserve-all", "preserve-by-url-and-detach"];
-              readonly description: "Strategy applied when defaultDrives change between deploys. 'preserve-all' keeps user-added drives untouched; 'preserve-by-url-and-detach' detaches removed default drives. No schema default \u2014 opt-in only.";
+              readonly description: "Strategy applied when defaultDrives change between deploys. 'preserve-all' keeps user-added drives untouched; 'preserve-by-url-and-detach' detaches removed default drives. No schema default — opt-in only.";
             };
             readonly sections: {
               readonly type: "object";
@@ -557,6 +604,32 @@ declare const runtimeConfigSchema: {
             };
           };
         };
+        readonly openPanel: {
+          readonly type: "object";
+          readonly additionalProperties: false;
+          readonly description: "OpenPanel product analytics. Set `clientId` to enable; an empty `clientId` disables it. Events are only sent after the user accepts analytics cookies. Takes precedence over the build-time PH_CONNECT_OPENPANEL_* env vars.";
+          readonly properties: {
+            readonly clientId: {
+              readonly type: "string";
+              readonly description: "OpenPanel client id. Empty string disables OpenPanel entirely.";
+              readonly default: "";
+            };
+            readonly apiUrl: {
+              readonly type: "string";
+              readonly description: "OpenPanel API URL for self-hosted instances (e.g. 'https://openpanel.example/api'). Omit to use OpenPanel's hosted API.";
+            };
+            readonly trackUiEvents: {
+              readonly type: "boolean";
+              readonly description: "Track UI events.";
+              readonly default: true;
+            };
+            readonly trackOperations: {
+              readonly type: "boolean";
+              readonly description: "Track document operations.";
+              readonly default: true;
+            };
+          };
+        };
         readonly instance: {
           readonly type: "object";
           readonly additionalProperties: false;
@@ -607,12 +680,24 @@ declare const runtimeConfigSchema: {
                 };
               };
             };
+            readonly createSignaturePolicy: {
+              readonly type: "string";
+              readonly enum: readonly ["legacy", "v2-required"];
+              readonly description: "What new documents are created as. `v2-required` documents accept only v2 action signatures and take content-addressed ids; set `legacy` while any peer Connect syncs with predates them. Existing documents keep their policy.";
+              readonly default: "v2-required";
+            };
+            readonly unsupportedStoredDocuments: {
+              readonly type: "string";
+              readonly enum: readonly ["refuse", "read-only"];
+              readonly description: "What the reactor does when this browser's store holds documents at protocol versions this build does not run. `refuse` fails the boot and names the versions; `read-only` boots and keeps those documents read-only.";
+              readonly default: "refuse";
+            };
           };
         };
         readonly pwa: {
           readonly type: "object";
           readonly additionalProperties: false;
-          readonly description: "Progressive-web-app / service-worker overrides, layered on Connect's built-in PWA defaults at build time. Scalar fields deep-merge (this layer wins); the array members (icons, file_handlers, globs, runtimeCaching and denylist patterns) are additive; maximumFileSizeToCacheInBytes takes the max across contributors. (categories is not set here \u2014 it is derived from the manifest's category field.) Only applied when connect.app.offline is true.";
+          readonly description: "Progressive-web-app / service-worker overrides, layered on Connect's built-in PWA defaults at build time. Scalar fields deep-merge (this layer wins); the array members (icons, file_handlers, globs, runtimeCaching and denylist patterns) are additive; maximumFileSizeToCacheInBytes takes the max across contributors. (categories is not set here — it is derived from the manifest's category field.) Only applied when connect.app.offline is true.";
           readonly properties: {
             readonly manifest: {
               readonly type: "object";
@@ -677,7 +762,7 @@ declare const runtimeConfigSchema: {
                     readonly properties: {
                       readonly accept: {
                         readonly type: "object";
-                        readonly description: "MIME type \u2192 file extensions. Each extension must start with '.'; browsers ignore entries without it.";
+                        readonly description: "MIME type → file extensions. Each extension must start with '.'; browsers ignore entries without it.";
                         readonly additionalProperties: {
                           readonly type: "array";
                           readonly items: {
@@ -862,7 +947,7 @@ declare const runtimeConfigSchema: {
 };
 //#endregion
 //#region connect-utils/vite-config.d.ts
-declare function getConnectHtmlTags(options?: {
+export declare function getConnectHtmlTags(options?: {
   registryUrl?: string | null;
   injectTo?: HtmlTagDescriptor["injectTo"];
 }): [{
@@ -871,84 +956,74 @@ declare function getConnectHtmlTags(options?: {
     readonly "http-equiv": "Content-Security-Policy";
     readonly content: `script-src 'self' 'unsafe-inline' 'unsafe-eval'${string}; worker-src 'self' blob:; object-src 'none'; base-uri 'self';`;
   };
-  readonly injectTo: "head" | "body" | "head-prepend" | "body-prepend";
+  readonly injectTo: "body" | "body-prepend" | "head" | "head-prepend";
 }, {
   readonly tag: "meta";
   readonly attrs: {
     readonly property: "og:title";
     readonly content: "Connect";
   };
-  readonly injectTo: "head" | "body" | "head-prepend" | "body-prepend";
+  readonly injectTo: "body" | "body-prepend" | "head" | "head-prepend";
 }, {
   readonly tag: "meta";
   readonly attrs: {
     readonly property: "og:type";
     readonly content: "website";
   };
-  readonly injectTo: "head" | "body" | "head-prepend" | "body-prepend";
+  readonly injectTo: "body" | "body-prepend" | "head" | "head-prepend";
 }, {
   readonly tag: "meta";
   readonly attrs: {
     readonly property: "og:url";
     readonly content: "https://apps.powerhouse.io/powerhouse/connect/";
   };
-  readonly injectTo: "head" | "body" | "head-prepend" | "body-prepend";
+  readonly injectTo: "body" | "body-prepend" | "head" | "head-prepend";
 }, {
   readonly tag: "meta";
   readonly attrs: {
     readonly property: "og:description";
     readonly content: "Navigate your organisation’s toughest operational challenges and steer your contributors to success with Connect. A navigation, collaboration and reporting tool for decentralised and open organisation.";
   };
-  readonly injectTo: "head" | "body" | "head-prepend" | "body-prepend";
+  readonly injectTo: "body" | "body-prepend" | "head" | "head-prepend";
 }, {
   readonly tag: "meta";
   readonly attrs: {
     readonly property: "og:image";
     readonly content: "https://cf-ipfs.com/ipfs/bafkreigrmclndf2jpbolaq22535q2sw5t44uad3az3dpvkzrnt4lpjt63e";
   };
-  readonly injectTo: "head" | "body" | "head-prepend" | "body-prepend";
+  readonly injectTo: "body" | "body-prepend" | "head" | "head-prepend";
 }, {
   readonly tag: "meta";
   readonly attrs: {
     readonly name: "twitter:card";
     readonly content: "summary_large_image";
   };
-  readonly injectTo: "head" | "body" | "head-prepend" | "body-prepend";
+  readonly injectTo: "body" | "body-prepend" | "head" | "head-prepend";
 }, {
   readonly tag: "meta";
   readonly attrs: {
     readonly name: "twitter:image";
     readonly content: "https://cf-ipfs.com/ipfs/bafkreigrmclndf2jpbolaq22535q2sw5t44uad3az3dpvkzrnt4lpjt63e";
   };
-  readonly injectTo: "head" | "body" | "head-prepend" | "body-prepend";
+  readonly injectTo: "body" | "body-prepend" | "head" | "head-prepend";
 }, {
   readonly tag: "meta";
   readonly attrs: {
     readonly name: "twitter:title";
     readonly content: "Connect";
   };
-  readonly injectTo: "head" | "body" | "head-prepend" | "body-prepend";
+  readonly injectTo: "body" | "body-prepend" | "head" | "head-prepend";
 }, {
   readonly tag: "meta";
   readonly attrs: {
     readonly name: "twitter:description";
     readonly content: "Navigate your organisation’s toughest operational challenges and steer your contributors to success with Connect. A navigation, collaboration and reporting tool for decentralised and open organisation.";
   };
-  readonly injectTo: "head" | "body" | "head-prepend" | "body-prepend";
+  readonly injectTo: "body" | "body-prepend" | "head" | "head-prepend";
 }];
-declare function getConnectBaseViteConfig(options: IConnectOptions): InlineConfig;
+export declare function getConnectBaseViteConfig(options: IConnectOptions): InlineConfig;
 //#endregion
 //#region connect-utils/vite-plugins/dynamic-base.d.ts
-/**
- * Placeholder base used when Connect is built in dynamic-base mode. The Vite
- * `base` option is set to this token; this plugin rewrites it in the emitted
- * output so the effective base is resolved at serve time from a global instead
- * of being baked at build time.
- *
- * Trailing slash matches `normalizeBasePath` output, so the token sits in the
- * same syntactic position as a concrete base would.
- */
-declare const DYNAMIC_BASE_PLACEHOLDER = "/__PH_DYNAMIC_BASE__/";
 /**
  * Rewrites the placeholder base in emitted JS chunks to a runtime expression so
  * one built `dist/connect` serves under any subpath. Rolldown-native: per-match
@@ -977,17 +1052,19 @@ declare const DYNAMIC_BASE_PLACEHOLDER = "/__PH_DYNAMIC_BASE__/";
  * they need no rewrite once the stylesheet itself is loaded from the right
  * prefix (which the HTML substitution handles).
  */
-declare function connectDynamicBasePlugin(options?: {
+export declare function connectDynamicBasePlugin(options?: {
   forWorker?: boolean;
   workerStripPrefix?: string;
 }): Plugin;
-declare function escapeForRegExp(s: string): string;
+export declare function escapeForRegExp(s: string): string;
 //#endregion
 //#region connect-utils/vite-plugins/ph-config.d.ts
-type PhConfigPluginOptions = {
+export type PhConfigPluginOptions = {
   packages: PowerhousePackage[];
   projectRoot?: string;
   connect?: PHConnectRuntimeConfig;
+  /** The source's top-level `workflows` block; `connect.app.workflowsEnabled` falls back to it. */
+  workflows?: PowerhouseConfig$1["workflows"];
   /**
    * Project-wide package registry URL — the effective value (CLI override
    * `??` source) the caller has already resolved. Copied verbatim into the
@@ -1002,7 +1079,7 @@ type PhConfigPluginOptions = {
    */
   cliConnectOverride?: PHConnectRuntimeConfig;
 };
-declare function phConfigPlugin(options: PhConfigPluginOptions): Plugin;
+export declare function phConfigPlugin(options: PhConfigPluginOptions): Plugin;
 //#endregion
 //#region connect-utils/vite-plugins/theme-boot.d.ts
 /**
@@ -1010,13 +1087,21 @@ declare function phConfigPlugin(options: PhConfigPluginOptions): Plugin;
  * ph-clint connect proxy) and this plugin both check it, so the script is
  * applied exactly once no matter which layer runs first.
  */
-declare const THEME_BOOT_MARKER = "data-ph-theme-boot";
+export declare const THEME_BOOT_MARKER = "data-ph-theme-boot";
 /**
  * Injects the theme boot script at the top of `<head>` of every emitted
  * index.html, so built Connect apps render the stored theme from first paint
  * without depending on a serve-time injector.
  */
-declare function connectThemeBootPlugin(): Plugin;
+export declare function connectThemeBootPlugin(): Plugin;
+//#endregion
+//#region connect-utils/vite-plugins/vendor-import-map.d.ts
+export type VendorImportMapOptions = {
+  /** bare specifier -> URL (already base-prefixed by the caller). */
+  imports: Record<string, string>;
+};
+export declare function vendorImportMapPlugin(options: VendorImportMapOptions): Plugin;
 //#endregion
-export { BUILD_HASH_FILE, BuildHashInput, ConnectBuildOptions, ConnectCommonOptions, ConnectPreviewOptions, ConnectStudioOptions, DEFAULT_CONNECT_OUTDIR, DEFAULT_VENDOR_INCLUDE, DYNAMIC_BASE_PLACEHOLDER, EXTERNAL_PACKAGES_IMPORT, IConnectOptions, IMPORT_SCRIPT_FILE, LOCAL_PACKAGE_ID, PH_DIR_NAME, PhConfigPluginOptions, PrebuiltVendor, RUNTIME_CONFIG_SCHEMA_ID, RUNTIME_CONFIG_SCHEMA_URL, THEME_BOOT_MARKER, VENDOR_EXTERNAL, VENDOR_URL_PREFIX, VendorPrebuildOptions, ViteDevOptions, appendToHtmlHead, backupIndexHtml, buildHashFromBuildOptions, computeBuildHash, connectBuildHashPlugin, connectDynamicBasePlugin, connectThemeBootPlugin, copyConnect, ensureNodeVersion, escapeForRegExp, getConnectBaseViteConfig, getConnectHtmlTags, makeImportScriptFromPackages, phConfigPlugin, prebuildConnectVendor, prependToHtmlHead, readJsonFile, removeBase64EnvValues, resolveConnectBundle, resolveConnectPackageJson, resolveConnectPublicDir, resolvePackage, resolveViteConfigPath, runShellScriptPlugin, runTsc, runtimeConfigSchema, stripVersionFromPackage };
+export { DYNAMIC_BASE_PLACEHOLDER };
+export {};
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../connect-utils/constants.ts","../connect-utils/vite-plugins/build-hash.ts","../connect-utils/externalize-vendor.ts","../connect-utils/types.ts","../connect-utils/helpers.ts","../connect-utils/runtime-config-schema.ts","../connect-utils/vite-config.ts","../connect-utils/vite-plugins/dynamic-base.ts","../connect-utils/vite-plugins/ph-config.ts","../connect-utils/vite-plugins/theme-boot.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../connect-utils/constants.ts","../connect-utils/vite-plugins/build-hash.ts","../connect-utils/externalize-vendor.ts","../connect-utils/types.ts","../connect-utils/helpers.ts","../connect-utils/runtime-config-schema.ts","../connect-utils/vite-config.ts","../connect-utils/vite-plugins/dynamic-base.ts","../connect-utils/vite-plugins/ph-config.ts","../connect-utils/vite-plugins/theme-boot.ts","../connect-utils/vite-plugins/vendor-import-map.ts"],"mappings":";;;;;qBAAa;qBACA;qBACA;qBACA;;;;qBCGA;iBAEI;;EAEf;;EAEA;;;EAGA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;;;;;wBAWc,iBAAiB,OAAO;wBAyCxB,0BAA0B;EACxC;EACA;EACA,UAAU;IACR;IACA;IACA;;EAEF;EACA;EACA;;;;;;;;wBAsBc,uBAAuB,oBAAoB;;;iBC3D1C;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;IAAa;;;;;;;;;;;EAUb;;EAEA;;;;;;;qBAQW;;;;;;qBAcA;iBAYI;EACf;;EAEA,SAAS;;EAET,UAAU;;;qBAIC;;;;;;wBAWS,sBACpB,SAAS,wBACR,QAAQ;;;;;wBAsYK,qBACd,mBACA,SAAS;EACN;EAAc;;;;;;;;;;;;wBAoBH,eACd,SAAS,wBACT,eACC;;;YC5hBS;EACV;EACA;EACA;EACA,mBAAmB;EACnB;;;;;;;;;;;;EAYA,qBAAqB;;;;;;EAMrB;EAGA;EAIA;;;;;;;EAOA;IACE,SAAS;IACT,UAAU;;;YAIF;EAEV;EAEA;EAEA;EAEA;EAEA;EAEA;EAEA;EAEA;;YAGU,iBAAiB,KAC3B;EAEI;;YAEM,uBAAuB;EACjC,mBAAmB;EACnB;EACA;;YAGU,sBAAsB;EAEhC;;YAGU,wBAAwB,uBAClC,KAAK;EAEH;EACA;EACA;;;;qBC5ES;wBAEG,sBACd,SAAS,KAAK;wBAMA,eAAe,qBAAqB;wBAMpC,0BAA0B,gBAAoB;;;;wBAiB9C,qBAAqB;wBASrB,wBAAwB;;;;wBAWxB,YAAY,oBAAoB;;;;;;wBAiBhC,gBAAgB,iBAAiB;wBAWjC,sBAAsB;wBAmCtB,aAAa,mBAAmB;;;;wBAchC,6BAA6B;EAC3C;EACA;EACA;EACA;;wBAsDc,kBAAkB;wBAclB,qBACd,oBACA,sBACC;;;;wBAwCmB,iBAAiB,oBAAoB,mBAAgB;;;;wBAYrD,kBAAkB,oBAAoB,mBAAgB;wBAS5D,OAAO;wBAMP,wBAAwB;;;qBC5Q3B;qBAOA;qBAGA;WACX;WACA;WACA;WACA;WAEA;WACA;WACA;WACA;aACE;eACE;eACA;;aAGF;eACE;eACA;;aAGF;eACE;eACA;eAEA;;;;;;;;;;;;;;;;;;;;;;;;;aAEF;eACE;eACA;;aAGF;eACE;eAEA;iBACI;;iBAEA;iBACA;iBACA;iBACA;mBACE;qBAAQ;;mBACR;qBAAW;;;;;aAKnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBCzBY,mBACd;EACE;EACA,WAAW;;WAMJ;;aAEH;aACA;;;;WAKG;;aAEH;aACA;;;;WAKG;;aAEH;aACA;;;;WAKG;;aAEH;aACA;;;;WAKG;;aAEH;aACA;;;;WAMG;;aAEH;aACA;;;;WAMG;;aAEH;aACA;;;;WAKG;;aAEH;aACA;;;;WAMG;;aAEH;aACA;;;;WAKG;;aAEH;aACA;;;;wBA6DQ,yBAAyB,SAAS,kBAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBC/GjD,yBACd;EAAW;EAAqB;IAC/B;wBAuDa,gBAAgB;;;YC5HpB;EACV,UAAU;EACV;EACA,UAAU;;EAEV,YAAY;;;;;;;EAOZ;;;;;;EAMA,qBAAqB;;wBAsBP,eAAe,SAAS,wBAAwB;;;;;;;;qBCjDnD;;;;;;wBAuBG,0BAA0B;;;YCnB9B;;EAEV,SAAS;;wBA4BK,sBAAsB,SAAS,yBAAyB"}