@powerhousedao/builder-tools 6.2.0-dev.5 → 6.2.0-dev.50

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;
   /**
@@ -31,6 +74,7 @@ type IConnectOptions = {
    * value in the emitted runtime config.
    */
   cliPackageRegistryUrl?: string;
+  dynamicBase?: boolean;
 };
 type ConnectCommonOptions = {
   base?: string;
@@ -361,6 +405,24 @@ declare const runtimeConfigSchema: {
             };
           };
         };
+        readonly instance: {
+          readonly type: "object";
+          readonly additionalProperties: false;
+          readonly required: readonly ["namespace", "reactorWorker"];
+          readonly description: "Per-instance identity. Lets one origin host multiple isolated Connect instances, each with its own storage + SharedWorker namespace.";
+          readonly properties: {
+            readonly namespace: {
+              readonly type: readonly ["string", "null"];
+              readonly description: "Explicit storage/SharedWorker namespace for this instance. `null` derives it from the base path (and, later, the configured endpoint), so root deployments stay byte-identical.";
+              readonly default: null;
+            };
+            readonly reactorWorker: {
+              readonly type: "boolean";
+              readonly description: "Host the reactor in a shared worker instead of on the main thread. Off by default; the main-thread reactor stays the proven path until cutover is verified.";
+              readonly default: false;
+            };
+          };
+        };
       };
     };
   };
@@ -374,7 +436,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";
 }, {
@@ -443,6 +505,50 @@ declare function getConnectHtmlTags(options?: {
 }];
 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
+ * MagicString edits in `renderChunk`, no AST splicing (the SWC byte-offset
+ * splicing in vite-plugin-dynamic-base corrupts Rolldown chunks). Each edited
+ * chunk returns a hires sourcemap that the bundler composes into the chunk's
+ * map chain, so the emitted `.map` files track the rewrite (and the worker
+ * prelude's line shift).
+ *
+ * What gets rewritten in JS, all of which emit the base as a quoted string
+ * literal beginning with the placeholder:
+ *   - asset URLs (`new URL("/__PH_DYNAMIC_BASE__/assets/x.png", ...)`)
+ *   - dynamic-import / lazy-chunk preload URLs
+ *   - the inlined `import.meta.env.BASE_URL` (drives Connect's router basename
+ *     and BASE_URL-relative fetches such as `${BASE_URL}ph-packages.json`)
+ *
+ * A literal `"/__PH_DYNAMIC_BASE__/foo"` becomes `((globalThis.__PH_DYNAMIC_BASE__||"/")+"foo")`;
+ * a bare `"/__PH_DYNAMIC_BASE__/"` (the BASE_URL value) becomes `(globalThis.__PH_DYNAMIC_BASE__||"/")`.
+ *
+ * HTML is left untouched: the entry `<script>`/`<link>` tags keep the literal
+ * placeholder so the proxy substitutes it with the concrete base at serve time
+ * (the same proxy also sets the runtime global for the JS rewrite). See the
+ * plugin's module doc / report for the exact serve-time contract.
+ *
+ * CSS `url(...)` references resolve relative to the stylesheet's own URL, so
+ * they need no rewrite once the stylesheet itself is loaded from the right
+ * prefix (which the HTML substitution handles).
+ */
+declare function connectDynamicBasePlugin(options?: {
+  forWorker?: boolean;
+  workerStripPrefix?: string;
+}): Plugin;
+//#endregion
 //#region connect-utils/vite-plugins/ph-config.d.ts
 type PhConfigPluginOptions = {
   packages: PowerhousePackage[];
@@ -464,5 +570,5 @@ type PhConfigPluginOptions = {
 };
 declare function phConfigPlugin(options: PhConfigPluginOptions): Plugin;
 //#endregion
-export { ConnectBuildOptions, ConnectCommonOptions, ConnectPreviewOptions, ConnectStudioOptions, DEFAULT_CONNECT_OUTDIR, 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, 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/ph-config.ts"],"mappings":";;;;;cAAa,wBAAA;AAAA,cACA,kBAAA;AAAA,cACA,gBAAA;AAAA,cACA,WAAA;;;KCCD,eAAA;EACV,IAAA;EACA,OAAA;EACA,MAAA;EACA,gBAAA,GAAmB,gBAAA;EACnB,YAAA;EDTmC;AACrC;;;;;AACA;;;ECiBE,kBAAA,GAAqB,sBAAA;EDjBM;AAC7B;;;;ECsBE,qBAAA;AAAA;AAAA,KAGU,oBAAA;EAEV,IAAA;EAEA,IAAA;EAEA,UAAA;EAEA,WAAA;EAEA,cAAA;EAEA,mBAAA;EAEA,gBAAA;EAEA,sBAAA;AAAA;AAAA,KAGU,cAAA,GAAiB,IAAA,CAC3B,mBAAA;EAEI,KAAA;AAAA;AAAA,KAEM,oBAAA,GAAuB,oBAAA;EACjC,gBAAA,GAAmB,cAAA;EACnB,SAAA;EACA,gBAAA;AAAA;AAAA,KAGU,mBAAA,GAAsB,oBAAA;EAEhC,MAAA;AAAA;AAAA,KAGU,qBAAA,GAAwB,oBAAA,GAClC,IAAA,CAAK,cAAA;EAEH,MAAA;EACA,SAAA;EACA,gBAAA;AAAA;;;cCzDS,sBAAA;AAAA,iBAEG,qBAAA,CACd,OAAA,EAAS,IAAA,CAAK,oBAAA;AAAA,iBAMA,cAAA,CAAe,WAAA,UAAqB,IAAA;AAAA,iBAMpC,yBAAA,CAA0B,IAAA,YAAoB,IAAA;;;;iBAiB9C,oBAAA,CAAqB,IAAA;AAAA,iBASrB,uBAAA,CAAwB,IAAA;;;;iBAWxB,WAAA,CAAY,UAAA,UAAoB,UAAA;;;;;AF5DhD;iBE6EgB,eAAA,CAAgB,OAAA,UAAiB,OAAA;AAAA,iBAWjC,qBAAA,CAAsB,OAAA;AAAA,iBAmCtB,YAAA,CAAa,QAAA,WAAmB,gBAAA;;;;iBAchC,4BAAA,CAA6B,IAAA;EAC3C,QAAA;EACA,YAAA;EACA,WAAA;EACA,YAAA;AAAA;AAAA,iBAsDc,iBAAA,CAAkB,UAAA;AAAA,iBAclB,oBAAA,CACd,UAAA,UACA,WAAA,WACC,MAAA;;;;iBAwCmB,gBAAA,CAAiB,UAAA,UAAoB,QAAA,WAAgB,OAAA;;;;iBAYrD,iBAAA,CAAkB,UAAA,UAAoB,QAAA,WAAgB,OAAA;AAAA,iBAS5D,MAAA,CAAO,MAAA;AAAA,iBAMP,uBAAA,CAAwB,WAAA;;;cC5Q3B,wBAAA;AAAA,cAOA,yBAAA;AAAA,cAGA,mBAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBCkBG,kBAAA,CACd,OAAA;EACE,WAAA;EACA,QAAA,GAAW,iBAAA;AAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiJC,wBAAA,CAAyB,OAAA,EAAS,eAAA,GAAe,YAAA;;;KClLrD,qBAAA;EACV,QAAA,EAAU,iBAAA;EACV,WAAA;EACA,OAAA,GAAU,sBAAA;;;;ALdZ;;;EKqBE,kBAAA;ELrB6B;AAC/B;;;;EK0BE,kBAAA,GAAqB,sBAAA;AAAA;AAAA,iBAsBP,cAAA,CAAe,OAAA,EAAS,qBAAA,GAAwB,MAAA"}
+{"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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"}