@elliemae/pui-app-bridge 2.28.2 → 2.28.4

package/dist/types/lib/loaders/script.d.ts

@@ -39,7 +39,7 @@ export declare class ScriptLoader {
     #private;
     constructor(logger: Logger);
     /**
-     * Loads multiple script assets sequentially, with CDN scripts loaded before non-CDN scripts.
+     * Loads multiple script assets in manifest order, like HTML module script tags.
      * @param assets - Array of script URLs (either full HTTP/HTTPS URLs or relative paths)
      * @param options - Configuration options for loading the scripts
      * @param options.name - The name of the application (used for generating script IDs)
@@ -49,20 +49,18 @@ export declare class ScriptLoader {
      * @returns A promise that resolves with an array of script element IDs when all scripts are loaded
      * @remarks
      * This method:
-     * - Partitions assets into CDN (HTTP/HTTPS) and non-CDN (relative) arrays in a single pass
+     * - Stages external (CDN) scripts before local guest-host scripts
+     * - Preserves manifest order within each origin group
      * - Creates modulepreload links for all assets for performance optimization
-     * - Appends all script elements to the DOM synchronously so the browser
-     *   can download them in parallel
-     * - Execution order is preserved by the spec: type="module" scripts
-     *   execute in document order; dynamic async=false scripts execute in
-     *   insertion order
+     * - Inserts script tags synchronously per stage so the browser can fetch in parallel
+     * - Syncs webpack public path from hostUrl (or guest _ASSET_PATH) before local scripts run
      * @example
      * ```typescript
      * const scriptIds = await scriptLoader.load(
-     *   ['https://cdn.example.com/lib.js', 'app.js', 'config.js'],
+     *   ['https://cdn.example.com/lib.js', 'global.js', 'runtime~app.js'],
      *   {
      *     name: 'myApp',
-     *     hostUrl: 'https://example.com',
+     *     hostUrl: 'https://example.com/my-app/',
      *     documentEle: document,
      *     isESMModule: true
      *   }

package/dist/types/lib/tests/utils/script-origin.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/lib/tests/utils/webpack-public-path.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/lib/utils/script-origin.d.ts

@@ -0,0 +1,22 @@
+export type ScriptRef = {
+    id: string;
+    href: string;
+};
+/**
+ * True when href is an absolute URL outside the guest app's hostUrl origin.
+ * @param {string} href - Resolved script URL.
+ * @param {string} hostUrl - Guest application base URL.
+ * @returns {boolean} Whether the script is hosted outside the guest app.
+ */
+export declare const isExternalScriptHref: (href: string, hostUrl: string) => boolean;
+/**
+ * Splits scripts into external (CDN) and local (guest host) groups while
+ * preserving manifest order within each group.
+ * @param {ScriptRef[]} scripts - Ordered script entries to partition.
+ * @param {string} hostUrl - Guest application base URL.
+ * @returns {{ external: ScriptRef[]; local: ScriptRef[] }} Partitioned script groups.
+ */
+export declare const partitionScriptsByOrigin: (scripts: ScriptRef[], hostUrl: string) => {
+    external: ScriptRef[];
+    local: ScriptRef[];
+};

package/dist/types/lib/utils/webpack-public-path.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @param {Window | null | undefined} [targetWindow] - Guest document defaultView whose webpack runtime should be synced.
+ */
+export declare const syncWebpackPublicPathFromAssetPath: (targetWindow?: Window | null) => void;
+/**
+ * Derives webpack public path from the guest hostUrl when _ASSET_PATH is not yet available.
+ * @param {Window | null | undefined} [targetWindow] - Guest document defaultView.
+ * @param {string} [hostUrl] - Guest application base URL from load options.
+ */
+export declare const syncWebpackPublicPathFromHost: (targetWindow?: Window | null, hostUrl?: string) => void;
+/**
+ * Prefers guest _ASSET_PATH when present, otherwise falls back to hostUrl.
+ * @param {Window | null | undefined} [targetWindow] - Guest document defaultView.
+ * @param {string} [hostUrl] - Guest application base URL from load options.
+ * @returns {void}
+ */
+export declare const syncWebpackPublicPath: (targetWindow?: Window | null, hostUrl?: string) => void;