@elliemae/pui-app-bridge 2.28.3 → 2.28.4

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

@@ -49,18 +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:
-     * - Preserves manifest order (CDN and local scripts stay in their original sequence)
+     * - 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
-     * - Inserts script tags synchronously in batches so the browser can fetch in parallel
-     * - Relies on module script execution order (document order) within each batch
-     * - Waits for global.js before inserting dependent bundles, then syncs webpack public path
+     * - 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', '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/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

@@ -2,5 +2,16 @@
  * @param {Window | null | undefined} [targetWindow] - Guest document defaultView whose webpack runtime should be synced.
  */
 export declare const syncWebpackPublicPathFromAssetPath: (targetWindow?: Window | null) => void;
-/** Matches guest global.js / global-prod.js URLs. */
-export declare const GLOBAL_SCRIPT_PATTERN: RegExp;
+/**
+ * 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;