@powerhousedao/builder-tools 6.2.0-dev.8 → 6.2.0-rc.0

package/dist/index.d.mts

@@ -8,6 +8,47 @@ declare const IMPORT_SCRIPT_FILE = "external-packages.js";
 declare const LOCAL_PACKAGE_ID = "ph:local-package";
 declare const PH_DIR_NAME = ".ph";
 //#endregion
+//#region connect-utils/externalize-vendor.d.ts
+interface VendorPrebuildOptions {
+  /** Project root (the reactor-project dir). */
+  dirname: string;
+  /** Bare specifiers to bundle into the vendor (defaults to the heavy libs). */
+  include?: string[];
+  /** Specifiers left external to the build (defaults to the React family). */
+  external?: string[];
+  /** Directory to hold the static vendor bundle + import map. */
+  vendorDir?: string;
+  /** Filled with the failure cause when the prebuild returns null. */
+  errorRef?: {
+    message?: string;
+  };
+}
+/**
+ * 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[];
+/**
+ * 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 {
+  vendorDir: string;
+  /** import map: bare specifier -> "/__vendor__/<entry>.js". */
+  imports: Record<string, string>;
+}
+/** URL prefix the vendor bundle is served under by the dev middleware. */
+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>;
+//#endregion
 //#region connect-utils/types.d.ts
 type IConnectOptions = {
   mode: string;
@@ -21,8 +62,10 @@ type IConnectOptions = {
    * from `ph connect build`'s `--json` + individual `--flag` parsing.
    *
    * Order: DEFAULT_CONNECT_CONFIG < source.connect < cliConnectOverride.
-   * Env vars are NOT part of this merge; they only seed the dist file at
-   * container start (set-if-absent) via the Docker entrypoint.
+   * Env vars are NOT part of this merge; PH_CONNECT_CONFIG_JSON is applied
+   * to the dist file at container start by the Docker entrypoint
+   * (operator-wins: concrete values override the baked file, null/omitted
+   * keep it; connect.app.basePath excluded).
    */
   cliConnectOverride?: PHConnectRuntimeConfig;
   /**
@@ -375,7 +418,7 @@ declare function getConnectHtmlTags(options?: {
   readonly tag: "meta";
   readonly attrs: {
     readonly "http-equiv": "Content-Security-Policy";
-    readonly content: `script-src 'self' 'unsafe-inline' 'unsafe-eval' https://esm.sh${string}; worker-src 'self' blob:; object-src 'none'; base-uri 'self';`;
+    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";
 }, {
@@ -485,6 +528,7 @@ declare const DYNAMIC_BASE_PLACEHOLDER = "/__PH_DYNAMIC_BASE__/";
  */
 declare function connectDynamicBasePlugin(options?: {
   forWorker?: boolean;
+  workerStripPrefix?: string;
 }): Plugin;
 //#endregion
 //#region connect-utils/vite-plugins/ph-config.d.ts
@@ -508,5 +552,5 @@ type PhConfigPluginOptions = {
 };
 declare function phConfigPlugin(options: PhConfigPluginOptions): Plugin;
 //#endregion
-export { ConnectBuildOptions, ConnectCommonOptions, ConnectPreviewOptions, ConnectStudioOptions, DEFAULT_CONNECT_OUTDIR, DYNAMIC_BASE_PLACEHOLDER, EXTERNAL_PACKAGES_IMPORT, IConnectOptions, IMPORT_SCRIPT_FILE, LOCAL_PACKAGE_ID, PH_DIR_NAME, PhConfigPluginOptions, RUNTIME_CONFIG_SCHEMA_ID, RUNTIME_CONFIG_SCHEMA_URL, ViteDevOptions, appendToHtmlHead, backupIndexHtml, connectDynamicBasePlugin, copyConnect, ensureNodeVersion, getConnectBaseViteConfig, getConnectHtmlTags, makeImportScriptFromPackages, phConfigPlugin, prependToHtmlHead, readJsonFile, removeBase64EnvValues, resolveConnectBundle, resolveConnectPackageJson, resolveConnectPublicDir, resolvePackage, resolveViteConfigPath, runShellScriptPlugin, runTsc, runtimeConfigSchema, stripVersionFromPackage };
+export { 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, VENDOR_EXTERNAL, VENDOR_URL_PREFIX, VendorPrebuildOptions, ViteDevOptions, appendToHtmlHead, backupIndexHtml, connectDynamicBasePlugin, copyConnect, ensureNodeVersion, getConnectBaseViteConfig, getConnectHtmlTags, makeImportScriptFromPackages, phConfigPlugin, prebuildConnectVendor, prependToHtmlHead, readJsonFile, removeBase64EnvValues, resolveConnectBundle, resolveConnectPackageJson, resolveConnectPublicDir, resolvePackage, resolveViteConfigPath, runShellScriptPlugin, runTsc, runtimeConfigSchema, stripVersionFromPackage };
 //# 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/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"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../connect-utils/constants.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"],"mappings":"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"}