@servicetitan/web-components 36.3.1 → 36.4.0

package/dist/utils/get-bundle-info.js

@@ -43,12 +43,12 @@ export async function getBundleInfo({ cache, mainPackageUrl, fallbackPackageUrl,
         const embed = !mismatch && supportLightBundles;
         resolvedBundleType = embed ? 'light' : 'full';
     }
-    const withBaseUrl = (path)=>`${exactPackageUrl}/dist/bundle/${resolvedBundleType}/${path}`;
+    const bundleBaseUrl = `${exactPackageUrl}/dist/bundle/${resolvedBundleType}`;
     let entrypoints;
     if ((_metadata_entrypoints = metadata.entrypoints) === null || _metadata_entrypoints === void 0 ? void 0 : _metadata_entrypoints[resolvedBundleType]) {
         entrypoints = metadata.entrypoints[resolvedBundleType];
     } else {
-        entrypoints = await getEntrypoints(withBaseUrl('entrypoints.json'), requestCache);
+        entrypoints = await getEntrypoints(`${bundleBaseUrl}/entrypoints.json`, requestCache);
     }
     const disposer = ()=>{
         if (resolvedBundleType === 'light') {
@@ -58,9 +58,16 @@ export async function getBundleInfo({ cache, mainPackageUrl, fallbackPackageUrl,
             }
         }
     };
+    let baseUrl = bundleBaseUrl;
+    // Per-MFE dev-server port only happens during local development
+    if (process.env.NODE_ENV !== 'production' && entrypoints.port) {
+        const url = new URL(baseUrl);
+        url.port = String(entrypoints.port);
+        baseUrl = url.toString();
+    }
     const urls = {
-        css: entrypoints.css.map(withBaseUrl),
-        js: entrypoints.js.map(withBaseUrl)
+        css: entrypoints.css.map((path)=>`${baseUrl}/${path}`),
+        js: entrypoints.js.map((path)=>`${baseUrl}/${path}`)
     };
     const elementName = resolvedBundleType === 'headless' ? `headless-${name}` : name;
     return {

package/dist/utils/get-bundle-info.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/get-bundle-info.ts"],"sourcesContent":["import { ExposedDependencies, getVersionMismatches } from '@servicetitan/startup-utils';\nimport get from 'lodash.get';\nimport semver from 'semver';\nimport { ExposedInstanceDependencies, getJson, GetJsonError } from '../common';\nimport type { Metadata } from '../types';\nimport { getCacheSetting } from './get-cache-setting';\nimport { getCachedMetadata } from './get-cached-metadata';\nimport { EntryPoints, getEntrypoints } from './get-entry-points';\nimport { getMFEHasCompatibleLaunchDarklyVersion } from './get-mfe-has-compatible-launchdarkly-version';\nimport { getMFEHasUniqueChunkNamespace } from './get-mfe-has-unique-chunk-namespace';\nimport { getMFESupportsRerendering } from './get-mfe-supports-rerendering';\n\nexport type BundleInfo = Awaited<ReturnType<typeof getBundleInfo>>;\n\ninterface GetBundleInfoProps {\n    cache: boolean | number;\n    exposedDependencies?: ExposedDependencies;\n    exposedInstanceDependencies?: ExposedInstanceDependencies;\n    fallbackPackageUrl?: string;\n    isHeadless?: boolean;\n    mainPackageUrl: string;\n    onRequestError?: (error: GetJsonError) => void;\n    retries?: number;\n    signal?: AbortSignal;\n}\n\nexport async function getBundleInfo({\n    cache,\n    mainPackageUrl,\n    fallbackPackageUrl,\n    exposedDependencies = {},\n    exposedInstanceDependencies = {},\n    isHeadless,\n    signal,\n    retries,\n    onRequestError,\n}: GetBundleInfoProps) {\n    const {\n        cacheHit,\n        data: metadata,\n        url: packageUrl,\n    } = await getCachedMetadata({\n        cache,\n        fallbackPackageUrl,\n        mainPackageUrl,\n        onRequestError,\n        retries,\n        signal,\n    });\n\n    const { bundledWith, name, sharedDependencies } = metadata;\n    const exactPackageUrl = packageUrl.replace('/dist/metadata.json', '');\n    const requestCache = getCacheSetting(exactPackageUrl);\n\n    let dependencies: NonNullable<Metadata['dependencies']>;\n    if (metadata.dependencies) {\n        dependencies = metadata.dependencies;\n    } else {\n        const { data: packageJson } = await getJson(`${exactPackageUrl}/package.json`, {\n            cache: requestCache,\n            retries,\n            signal,\n        });\n\n        dependencies = packageJson.dependencies;\n    }\n\n    let mismatch: ReturnType<typeof getVersionMismatches>;\n    let resolvedBundleType: 'headless' | 'light' | 'full';\n\n    if (isHeadless) {\n        resolvedBundleType = 'headless';\n    } else {\n        mismatch = getVersionMismatches(exposedDependencies, dependencies, sharedDependencies);\n        const startupVersion = bundledWith?.['@servicetitan/startup'];\n        const supportLightBundles = !!startupVersion && semver.gte(startupVersion, '17.0.0');\n        const embed = !mismatch && supportLightBundles;\n        resolvedBundleType = embed ? 'light' : 'full';\n    }\n\n    const withBaseUrl = (path: string) =>\n        `${exactPackageUrl}/dist/bundle/${resolvedBundleType}/${path}`;\n\n    let entrypoints: EntryPoints;\n    if (metadata.entrypoints?.[resolvedBundleType]) {\n        entrypoints = metadata.entrypoints[resolvedBundleType];\n    } else {\n        entrypoints = await getEntrypoints(withBaseUrl('entrypoints.json'), requestCache);\n    }\n\n    const disposer = () => {\n        if (resolvedBundleType === 'light') {\n            const path = Object.values<string>(sharedDependencies).shift();\n            if (path) {\n                get(window, path).getStorage().clear(name);\n            }\n        }\n    };\n\n    const urls: EntryPoints = {\n        css: entrypoints.css.map(withBaseUrl),\n        js: entrypoints.js.map(withBaseUrl),\n    };\n\n    const elementName = resolvedBundleType === 'headless' ? `headless-${name}` : name;\n\n    return {\n        bundledWith,\n        cacheHit,\n        disposer,\n        mfeSupportsRerendering: getMFESupportsRerendering(bundledWith, dependencies),\n        mfeHasUniqueChunkNamespace: getMFEHasUniqueChunkNamespace(bundledWith),\n        mfeHasCompatibleLaunchDarklyVersion: getMFEHasCompatibleLaunchDarklyVersion(\n            bundledWith,\n            exposedInstanceDependencies\n        ),\n        mismatch,\n        resolvedBundleType,\n        urls,\n        WebComponent: elementName,\n        version: metadata.version,\n        module: entrypoints.module,\n    };\n}\n"],"names":["getVersionMismatches","get","semver","getJson","getCacheSetting","getCachedMetadata","getEntrypoints","getMFEHasCompatibleLaunchDarklyVersion","getMFEHasUniqueChunkNamespace","getMFESupportsRerendering","getBundleInfo","cache","mainPackageUrl","fallbackPackageUrl","exposedDependencies","exposedInstanceDependencies","isHeadless","signal","retries","onRequestError","metadata","cacheHit","data","url","packageUrl","bundledWith","name","sharedDependencies","exactPackageUrl","replace","requestCache","dependencies","packageJson","mismatch","resolvedBundleType","startupVersion","supportLightBundles","gte","embed","withBaseUrl","path","entrypoints","disposer","Object","values","shift","window","getStorage","clear","urls","css","map","js","elementName","mfeSupportsRerendering","mfeHasUniqueChunkNamespace","mfeHasCompatibleLaunchDarklyVersion","WebComponent","version","module"],"mappings":"AAAA,SAA8BA,oBAAoB,QAAQ,8BAA8B;AACxF,OAAOC,SAAS,aAAa;AAC7B,OAAOC,YAAY,SAAS;AAC5B,SAAsCC,OAAO,QAAsB,YAAY;AAE/E,SAASC,eAAe,QAAQ,sBAAsB;AACtD,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAAsBC,cAAc,QAAQ,qBAAqB;AACjE,SAASC,sCAAsC,QAAQ,gDAAgD;AACvG,SAASC,6BAA6B,QAAQ,uCAAuC;AACrF,SAASC,yBAAyB,QAAQ,iCAAiC;AAgB3E,OAAO,eAAeC,cAAc,EAChCC,KAAK,EACLC,cAAc,EACdC,kBAAkB,EAClBC,sBAAsB,CAAC,CAAC,EACxBC,8BAA8B,CAAC,CAAC,EAChCC,UAAU,EACVC,MAAM,EACNC,OAAO,EACPC,cAAc,EACG;QAgDbC;IA/CJ,MAAM,EACFC,QAAQ,EACRC,MAAMF,QAAQ,EACdG,KAAKC,UAAU,EAClB,GAAG,MAAMnB,kBAAkB;QACxBM;QACAE;QACAD;QACAO;QACAD;QACAD;IACJ;IAEA,MAAM,EAAEQ,WAAW,EAAEC,IAAI,EAAEC,kBAAkB,EAAE,GAAGP;IAClD,MAAMQ,kBAAkBJ,WAAWK,OAAO,CAAC,uBAAuB;IAClE,MAAMC,eAAe1B,gBAAgBwB;IAErC,IAAIG;IACJ,IAAIX,SAASW,YAAY,EAAE;QACvBA,eAAeX,SAASW,YAAY;IACxC,OAAO;QACH,MAAM,EAAET,MAAMU,WAAW,EAAE,GAAG,MAAM7B,QAAQ,GAAGyB,gBAAgB,aAAa,CAAC,EAAE;YAC3EjB,OAAOmB;YACPZ;YACAD;QACJ;QAEAc,eAAeC,YAAYD,YAAY;IAC3C;IAEA,IAAIE;IACJ,IAAIC;IAEJ,IAAIlB,YAAY;QACZkB,qBAAqB;IACzB,OAAO;QACHD,WAAWjC,qBAAqBc,qBAAqBiB,cAAcJ;QACnE,MAAMQ,iBAAiBV,wBAAAA,kCAAAA,WAAa,CAAC,wBAAwB;QAC7D,MAAMW,sBAAsB,CAAC,CAACD,kBAAkBjC,OAAOmC,GAAG,CAACF,gBAAgB;QAC3E,MAAMG,QAAQ,CAACL,YAAYG;QAC3BF,qBAAqBI,QAAQ,UAAU;IAC3C;IAEA,MAAMC,cAAc,CAACC,OACjB,GAAGZ,gBAAgB,aAAa,EAAEM,mBAAmB,CAAC,EAAEM,MAAM;IAElE,IAAIC;IACJ,KAAIrB,wBAAAA,SAASqB,WAAW,cAApBrB,4CAAAA,qBAAsB,CAACc,mBAAmB,EAAE;QAC5CO,cAAcrB,SAASqB,WAAW,CAACP,mBAAmB;IAC1D,OAAO;QACHO,cAAc,MAAMnC,eAAeiC,YAAY,qBAAqBT;IACxE;IAEA,MAAMY,WAAW;QACb,IAAIR,uBAAuB,SAAS;YAChC,MAAMM,OAAOG,OAAOC,MAAM,CAASjB,oBAAoBkB,KAAK;YAC5D,IAAIL,MAAM;gBACNvC,IAAI6C,QAAQN,MAAMO,UAAU,GAAGC,KAAK,CAACtB;YACzC;QACJ;IACJ;IAEA,MAAMuB,OAAoB;QACtBC,KAAKT,YAAYS,GAAG,CAACC,GAAG,CAACZ;QACzBa,IAAIX,YAAYW,EAAE,CAACD,GAAG,CAACZ;IAC3B;IAEA,MAAMc,cAAcnB,uBAAuB,aAAa,CAAC,SAAS,EAAER,MAAM,GAAGA;IAE7E,OAAO;QACHD;QACAJ;QACAqB;QACAY,wBAAwB7C,0BAA0BgB,aAAaM;QAC/DwB,4BAA4B/C,8BAA8BiB;QAC1D+B,qCAAqCjD,uCACjCkB,aACAV;QAEJkB;QACAC;QACAe;QACAQ,cAAcJ;QACdK,SAAStC,SAASsC,OAAO;QACzBC,QAAQlB,YAAYkB,MAAM;IAC9B;AACJ"}
+{"version":3,"sources":["../../src/utils/get-bundle-info.ts"],"sourcesContent":["import { ExposedDependencies, getVersionMismatches } from '@servicetitan/startup-utils';\nimport get from 'lodash.get';\nimport semver from 'semver';\nimport { ExposedInstanceDependencies, getJson, GetJsonError } from '../common';\nimport type { Metadata } from '../types';\nimport { getCacheSetting } from './get-cache-setting';\nimport { getCachedMetadata } from './get-cached-metadata';\nimport { EntryPoints, getEntrypoints } from './get-entry-points';\nimport { getMFEHasCompatibleLaunchDarklyVersion } from './get-mfe-has-compatible-launchdarkly-version';\nimport { getMFEHasUniqueChunkNamespace } from './get-mfe-has-unique-chunk-namespace';\nimport { getMFESupportsRerendering } from './get-mfe-supports-rerendering';\n\nexport type BundleInfo = Awaited<ReturnType<typeof getBundleInfo>>;\n\ninterface GetBundleInfoProps {\n    cache: boolean | number;\n    exposedDependencies?: ExposedDependencies;\n    exposedInstanceDependencies?: ExposedInstanceDependencies;\n    fallbackPackageUrl?: string;\n    isHeadless?: boolean;\n    mainPackageUrl: string;\n    onRequestError?: (error: GetJsonError) => void;\n    retries?: number;\n    signal?: AbortSignal;\n}\n\nexport async function getBundleInfo({\n    cache,\n    mainPackageUrl,\n    fallbackPackageUrl,\n    exposedDependencies = {},\n    exposedInstanceDependencies = {},\n    isHeadless,\n    signal,\n    retries,\n    onRequestError,\n}: GetBundleInfoProps) {\n    const {\n        cacheHit,\n        data: metadata,\n        url: packageUrl,\n    } = await getCachedMetadata({\n        cache,\n        fallbackPackageUrl,\n        mainPackageUrl,\n        onRequestError,\n        retries,\n        signal,\n    });\n\n    const { bundledWith, name, sharedDependencies } = metadata;\n    const exactPackageUrl = packageUrl.replace('/dist/metadata.json', '');\n    const requestCache = getCacheSetting(exactPackageUrl);\n\n    let dependencies: NonNullable<Metadata['dependencies']>;\n    if (metadata.dependencies) {\n        dependencies = metadata.dependencies;\n    } else {\n        const { data: packageJson } = await getJson(`${exactPackageUrl}/package.json`, {\n            cache: requestCache,\n            retries,\n            signal,\n        });\n\n        dependencies = packageJson.dependencies;\n    }\n\n    let mismatch: ReturnType<typeof getVersionMismatches>;\n    let resolvedBundleType: 'headless' | 'light' | 'full';\n\n    if (isHeadless) {\n        resolvedBundleType = 'headless';\n    } else {\n        mismatch = getVersionMismatches(exposedDependencies, dependencies, sharedDependencies);\n        const startupVersion = bundledWith?.['@servicetitan/startup'];\n        const supportLightBundles = !!startupVersion && semver.gte(startupVersion, '17.0.0');\n        const embed = !mismatch && supportLightBundles;\n        resolvedBundleType = embed ? 'light' : 'full';\n    }\n\n    const bundleBaseUrl = `${exactPackageUrl}/dist/bundle/${resolvedBundleType}`;\n\n    let entrypoints: EntryPoints;\n    if (metadata.entrypoints?.[resolvedBundleType]) {\n        entrypoints = metadata.entrypoints[resolvedBundleType];\n    } else {\n        entrypoints = await getEntrypoints(`${bundleBaseUrl}/entrypoints.json`, requestCache);\n    }\n\n    const disposer = () => {\n        if (resolvedBundleType === 'light') {\n            const path = Object.values<string>(sharedDependencies).shift();\n            if (path) {\n                get(window, path).getStorage().clear(name);\n            }\n        }\n    };\n\n    let baseUrl = bundleBaseUrl;\n    // Per-MFE dev-server port only happens during local development\n    if (process.env.NODE_ENV !== 'production' && entrypoints.port) {\n        const url = new URL(baseUrl);\n        url.port = String(entrypoints.port);\n        baseUrl = url.toString();\n    }\n\n    const urls: EntryPoints = {\n        css: entrypoints.css.map(path => `${baseUrl}/${path}`),\n        js: entrypoints.js.map(path => `${baseUrl}/${path}`),\n    };\n\n    const elementName = resolvedBundleType === 'headless' ? `headless-${name}` : name;\n\n    return {\n        bundledWith,\n        cacheHit,\n        disposer,\n        mfeSupportsRerendering: getMFESupportsRerendering(bundledWith, dependencies),\n        mfeHasUniqueChunkNamespace: getMFEHasUniqueChunkNamespace(bundledWith),\n        mfeHasCompatibleLaunchDarklyVersion: getMFEHasCompatibleLaunchDarklyVersion(\n            bundledWith,\n            exposedInstanceDependencies\n        ),\n        mismatch,\n        resolvedBundleType,\n        urls,\n        WebComponent: elementName,\n        version: metadata.version,\n        module: entrypoints.module,\n    };\n}\n"],"names":["getVersionMismatches","get","semver","getJson","getCacheSetting","getCachedMetadata","getEntrypoints","getMFEHasCompatibleLaunchDarklyVersion","getMFEHasUniqueChunkNamespace","getMFESupportsRerendering","getBundleInfo","cache","mainPackageUrl","fallbackPackageUrl","exposedDependencies","exposedInstanceDependencies","isHeadless","signal","retries","onRequestError","metadata","cacheHit","data","url","packageUrl","bundledWith","name","sharedDependencies","exactPackageUrl","replace","requestCache","dependencies","packageJson","mismatch","resolvedBundleType","startupVersion","supportLightBundles","gte","embed","bundleBaseUrl","entrypoints","disposer","path","Object","values","shift","window","getStorage","clear","baseUrl","process","env","NODE_ENV","port","URL","String","toString","urls","css","map","js","elementName","mfeSupportsRerendering","mfeHasUniqueChunkNamespace","mfeHasCompatibleLaunchDarklyVersion","WebComponent","version","module"],"mappings":"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"}

package/dist/utils/get-entry-points.d.ts

@@ -2,6 +2,7 @@ export interface EntryPoints {
     css: string[];
     js: string[];
     module?: true;
+    port?: number;
 }
 export declare function getEntrypoints(url: string, cache: 'no-store' | undefined, signal?: AbortSignal): Promise<EntryPoints>;
 //# sourceMappingURL=get-entry-points.d.ts.map

package/dist/utils/get-entry-points.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-entry-points.d.ts","sourceRoot":"","sources":["../../src/utils/get-entry-points.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IACxB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,MAAM,CAAC,EAAE,IAAI,CAAC;CACjB;AAED,wBAAsB,cAAc,CAChC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,WAAW,CAAC,CAWtB"}
+{"version":3,"file":"get-entry-points.d.ts","sourceRoot":"","sources":["../../src/utils/get-entry-points.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IACxB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,cAAc,CAChC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,WAAW,CAAC,CAWtB"}

package/dist/utils/get-entry-points.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/get-entry-points.ts"],"sourcesContent":["import { getJson } from '../common';\n\nexport interface EntryPoints {\n    css: string[];\n    js: string[];\n    module?: true;\n}\n\nexport async function getEntrypoints(\n    url: string,\n    cache: 'no-store' | undefined,\n    signal?: AbortSignal\n): Promise<EntryPoints> {\n    try {\n        return (\n            await getJson(url, {\n                cache,\n                signal,\n            })\n        ).data;\n    } catch {\n        return { css: ['index.css'], js: ['index.js'] };\n    }\n}\n"],"names":["getJson","getEntrypoints","url","cache","signal","data","css","js"],"mappings":"AAAA,SAASA,OAAO,QAAQ,YAAY;AAQpC,OAAO,eAAeC,eAClBC,GAAW,EACXC,KAA6B,EAC7BC,MAAoB;IAEpB,IAAI;QACA,OAAO,AACH,CAAA,MAAMJ,QAAQE,KAAK;YACfC;YACAC;QACJ,EAAC,EACHC,IAAI;IACV,EAAE,eAAM;QACJ,OAAO;YAAEC,KAAK;gBAAC;aAAY;YAAEC,IAAI;gBAAC;aAAW;QAAC;IAClD;AACJ"}
+{"version":3,"sources":["../../src/utils/get-entry-points.ts"],"sourcesContent":["import { getJson } from '../common';\n\nexport interface EntryPoints {\n    css: string[];\n    js: string[];\n    module?: true;\n    port?: number;\n}\n\nexport async function getEntrypoints(\n    url: string,\n    cache: 'no-store' | undefined,\n    signal?: AbortSignal\n): Promise<EntryPoints> {\n    try {\n        return (\n            await getJson(url, {\n                cache,\n                signal,\n            })\n        ).data;\n    } catch {\n        return { css: ['index.css'], js: ['index.js'] };\n    }\n}\n"],"names":["getJson","getEntrypoints","url","cache","signal","data","css","js"],"mappings":"AAAA,SAASA,OAAO,QAAQ,YAAY;AASpC,OAAO,eAAeC,eAClBC,GAAW,EACXC,KAA6B,EAC7BC,MAAoB;IAEpB,IAAI;QACA,OAAO,AACH,CAAA,MAAMJ,QAAQE,KAAK;YACfC;YACAC;QACJ,EAAC,EACHC,IAAI;IACV,EAAE,eAAM;QACJ,OAAO;YAAEC,KAAK;gBAAC;aAAY;YAAEC,IAAI;gBAAC;aAAW;QAAC;IAClD;AACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@servicetitan/web-components",
-    "version": "36.3.1",
+    "version": "36.4.0",
     "description": "Framework to build, register, and load Microfrontends into host applications",
     "homepage": "https://docs.st.dev/docs/frontend/uikit/web-components",
     "repository": {
@@ -10,24 +10,35 @@
     },
     "main": "./dist/index.js",
     "typings": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./register-headless": {
+            "types": "./dist/register-headless.d.ts",
+            "default": "./dist/register-headless.js"
+        },
+        "./*": "./dist/*.js"
+    },
     "sideEffects": false,
     "files": [
         "dist",
         "src"
     ],
     "dependencies": {
-        "@servicetitan/error-boundary": "36.3.1",
-        "@servicetitan/startup-utils": "36.3.1",
+        "@servicetitan/error-boundary": "36.4.0",
+        "@servicetitan/startup-utils": "36.4.0",
         "lodash.get": "~4.4.2",
         "mitt": "~3.0.1",
-        "semver": "~7.8.0"
+        "semver": "~7.8.1"
     },
     "devDependencies": {
-        "@servicetitan/anvil2": "^3.0.6",
+        "@servicetitan/anvil2": "^3.0.8",
         "@servicetitan/design-system": "~14.5.3",
-        "@servicetitan/launchdarkly-service": "36.3.1",
-        "@servicetitan/log-service": "36.3.1",
-        "@servicetitan/react-ioc": "36.3.1",
+        "@servicetitan/launchdarkly-service": "36.4.0",
+        "@servicetitan/log-service": "36.4.0",
+        "@servicetitan/react-ioc": "36.4.0",
         "@testing-library/dom": "^10.4.1",
         "@testing-library/jest-dom": "^6.9.1",
         "@testing-library/react": "^16.3.2",
@@ -45,9 +56,9 @@
     "peerDependencies": {
         "@servicetitan/anvil2": ">=1.5.0",
         "@servicetitan/design-system": ">=14.5.3",
-        "@servicetitan/launchdarkly-service": "36.3.1",
-        "@servicetitan/log-service": "36.3.1",
-        "@servicetitan/react-ioc": "36.3.1",
+        "@servicetitan/launchdarkly-service": "36.4.0",
+        "@servicetitan/log-service": "36.4.0",
+        "@servicetitan/react-ioc": "36.4.0",
         "history": "~4.10.1",
         "react": ">=17.0.2",
         "react-dom": ">=17.0.2"
@@ -69,5 +80,5 @@
     "cli": {
         "webpack": false
     },
-    "gitHead": "93a049ba1e5cb737afb7bc95c06020736bc61a38"
+    "gitHead": "8beab9ae3a70ce381e8cd53f2de8691640e96c6e"
 }

package/src/__mocks__/register-anvil2-harness.tsx

@@ -0,0 +1,49 @@
+import { render } from '@testing-library/react';
+import { MockComponent, registerComponent } from './index';
+
+/* Wrapper components injected by each optional library. */
+export const optionalLibraryWrappers: Record<string, string[]> = {
+    '@servicetitan/anvil2': ['PortalProvider'],
+    '@servicetitan/design-system': [
+        'DefaultPortalContext.Provider',
+        'TablePopupPropsContext.Provider',
+    ],
+};
+
+export interface RegisterHarness {
+    Page: {
+        readonly componentShadowRoot: ShadowRoot;
+        readonly portalShadowRoot: ShadowRoot;
+    };
+    subject: () => ReturnType<typeof render>;
+}
+
+export function createRegisterHarness(
+    componentName: string,
+    options?: Parameters<typeof registerComponent>[2]
+): RegisterHarness {
+    const Page = {
+        get componentShadowRoot() {
+            return document.querySelector(componentName)!.shadowRoot!;
+        },
+        get portalShadowRoot() {
+            return document.querySelector('body')!.lastElementChild!.shadowRoot!;
+        },
+    };
+
+    beforeAll(() => {
+        registerComponent(MockComponent, componentName, {
+            sharedDependenciesNames: ['@servicetitan/anvil2'],
+            ...options,
+        });
+    });
+
+    const subject = () => {
+        jest.spyOn(console, 'error').mockImplementation(jest.fn()); // suppress "ReactDOM.render deprecated" error
+        const Component: any = componentName;
+        const handleRef = (wc: any) => wc?.provide({ foo: 'bar' }); // triggers rendering
+        return render(<Component ref={handleRef} />);
+    };
+
+    return { Page, subject };
+}

package/src/__mocks__/test-component.tsx

@@ -1,13 +1,20 @@
 import { TablePopupPropsContext } from '@servicetitan/design-system';
-import { FC, useContext } from 'react';
+import { createContext, FC, useContext } from 'react';
 import { useMFEDataContext, useMFEMetadataContext } from '../contexts';
 
 jest.mock('@progress/kendo-licensing', () => ({ validatePackage: jest.fn() }));
 
+const FallbackContext = createContext(undefined);
+
 export const MockComponent: FC<Record<string, any>> = props => {
     const data = useMFEDataContext();
     const metadata = useMFEMetadataContext();
-    const popupProps = useContext(TablePopupPropsContext);
+    /*
+     * TablePopupPropsContext is undefined when a test mocks
+     * @servicetitan/design-system as an empty object. Fall back to
+     * a no-op context so the component renders without it.
+     */
+    const popupProps = useContext(TablePopupPropsContext ?? FallbackContext);
     const appendTo = popupProps?.({}).appendTo;
 
     return (

package/src/__tests__/loader.test.tsx

@@ -403,6 +403,38 @@ describe('[web-components] Loader', () => {
             () => `${baseUrl}/dist/bundle/light/${metadata.entrypoints!.light.css[0]}`
         );
 
+        describe('when the entrypoint specifies a dev-server port', () => {
+            const port = 3000;
+
+            beforeEach(() => {
+                Object.assign(metadata.entrypoints!.light, { port });
+            });
+
+            function withPort(url: string) {
+                const result = new URL(url);
+                result.port = String(port);
+                return String(result);
+            }
+
+            itAddsJsEntrypointToWebComponent(
+                'entrypoint with dev-server port',
+                () => `${withPort(baseUrl)}/dist/bundle/light/${metadata.entrypoints!.light.js[0]}`
+            );
+
+            describe('when NODE_ENV is production', () => {
+                const originalNodeEnv = process.env.NODE_ENV;
+
+                beforeEach(() => (process.env.NODE_ENV = 'production'));
+
+                afterEach(() => (process.env.NODE_ENV = originalNodeEnv));
+
+                itAddsJsEntrypointToWebComponent(
+                    'entrypoint without dev-server port',
+                    () => `${baseUrl}/dist/bundle/light/${metadata.entrypoints!.light.js[0]}`
+                );
+            });
+        });
+
         describe('when entrypoint has module: true', () => {
             beforeEach(() => {
                 metadata.entrypoints!.light.module = true;

package/src/__tests__/register-anvil2.test.tsx

@@ -1,7 +1,11 @@
 import '@testing-library/jest-dom';
-import { render, within } from '@testing-library/react';
+import { within } from '@testing-library/react';
 import { Fragment } from 'react';
-import { expectStylesInDom, MockComponent, registerComponent } from '../__mocks__';
+import { expectStylesInDom } from '../__mocks__';
+import {
+    createRegisterHarness,
+    optionalLibraryWrappers,
+} from '../__mocks__/register-anvil2-harness';
 
 function mockComponent(name: string) {
     return {
@@ -37,30 +41,7 @@ jest.mock('@servicetitan/design-system', () => ({
 }));
 
 describe('[web-components] register', () => {
-    const componentName = 'mock-anvil2-app';
-
-    class Page {
-        static get componentShadowRoot() {
-            return document.querySelector(componentName)!.shadowRoot!;
-        }
-
-        static get portalShadowRoot() {
-            return document.querySelector('body')!.lastElementChild!.shadowRoot!;
-        }
-    }
-
-    beforeAll(() => {
-        registerComponent(MockComponent, componentName, {
-            sharedDependenciesNames: ['@servicetitan/anvil2'],
-        });
-    });
-
-    const subject = () => {
-        jest.spyOn(console, 'error').mockImplementation(jest.fn()); // suppress "ReactDOM.render deprecated" error
-        const Component: any = componentName;
-        const handleRef = (webComponent: any) => webComponent?.provide({ foo: 'bar' }); // triggers rendering
-        return render(<Component ref={handleRef} />);
-    };
+    const { Page, subject } = createRegisterHarness('mock-anvil2-app');
 
     describe('when Anvil2 bundle is present in the DOM', () => {
         let cssLink: HTMLLinkElement;
@@ -90,44 +71,28 @@ describe('[web-components] register', () => {
         });
     });
 
-    function itWrapsComponentWithin(name: string, expected: boolean = true) {
-        test(`${expected ? 'wraps' : 'does not wrap'} component within ${name}`, () => {
+    for (const [library, wrappers] of Object.entries(optionalLibraryWrappers)) {
+        test.each(wrappers)(`wraps component within %s`, name => {
             subject();
 
             const element = within(Page.componentShadowRoot as any).queryByText(`<${name}>`);
-            if (expected) {
-                expect(element).toBeInTheDocument();
-            } else {
-                expect(element).not.toBeInTheDocument();
-            }
+            expect(element).toBeInTheDocument();
         });
-    }
-
-    ['PortalProvider', 'DefaultPortalContext.Provider', 'TablePopupPropsContext.Provider'].forEach(
-        name => itWrapsComponentWithin(name)
-    );
 
-    describe('when @servicetitan/anvil2 is not present', () => {
-        beforeAll(() => {
-            jest.resetModules();
-            jest.mock('@servicetitan/anvil2', () => {
-                throw new Error('Cannot find module');
+        describe(`when ${library} is not present`, () => {
+            beforeAll(() => {
+                jest.resetModules();
+                jest.mock(library, () => {
+                    throw new Error('Cannot find module');
+                });
             });
-        });
 
-        itWrapsComponentWithin('PortalProvider', false);
-    });
+            test.each(wrappers)('does not wrap component within %s', name => {
+                subject();
 
-    describe('when @servicetitan/design-system is not present', () => {
-        beforeAll(() => {
-            jest.resetModules();
-            jest.mock('@servicetitan/design-system', () => {
-                throw new Error('Cannot find module');
+                const element = within(Page.componentShadowRoot as any).queryByText(`<${name}>`);
+                expect(element).not.toBeInTheDocument();
             });
         });
-
-        ['DefaultPortalContext.Provider', 'TablePopupPropsContext.Provider'].forEach(name =>
-            itWrapsComponentWithin(name, false)
-        );
-    });
+    }
 });

package/src/css-injector/__tests__/mfe-style-registry.test.ts

@@ -0,0 +1,163 @@
+import { MfeStyleRegistry } from '../mfe-style-registry';
+
+beforeAll(() => {
+    if (!CSSStyleSheet.prototype.replaceSync) {
+        CSSStyleSheet.prototype.replaceSync = jest.fn();
+    }
+});
+
+describe('[web-components] MfeStyleRegistry', () => {
+    const createRoot = () => {
+        const root = document.createElement('div').attachShadow({ mode: 'open' });
+        root.adoptedStyleSheets = [];
+        return root;
+    };
+
+    beforeEach(() => {
+        delete globalThis.__mfeStyles__;
+    });
+
+    describe(MfeStyleRegistry.for.name, () => {
+        test('initializes globalThis.__mfeStyles__', () => {
+            MfeStyleRegistry.for('test-mfe');
+
+            expect(globalThis.__mfeStyles__).toBeDefined();
+        });
+
+        test('returns the same registry for the same component', () => {
+            const a = MfeStyleRegistry.for('test-mfe');
+            const b = MfeStyleRegistry.for('test-mfe');
+
+            expect(a).toBe(b);
+        });
+
+        test('returns different registries for different components', () => {
+            const a = MfeStyleRegistry.for('mfe-a');
+            const b = MfeStyleRegistry.for('mfe-b');
+
+            expect(a).not.toBe(b);
+        });
+    });
+
+    describe('injectSheet', () => {
+        const defaultCss = '.foo { color: red; }';
+        const defaultSheetId = 'sheet-1';
+
+        let registry: MfeStyleRegistry;
+
+        beforeEach(() => {
+            registry = MfeStyleRegistry.for('test-mfe');
+        });
+
+        const subject = (sheetId = defaultSheetId, css = defaultCss) =>
+            registry.injectSheet(sheetId, css);
+
+        test('creates a new CSSStyleSheet and stores it', () => {
+            subject();
+
+            const sheet = registry.sheets.get('sheet-1');
+            expect(sheet).toBeInstanceOf(CSSStyleSheet);
+            expect(sheet!.replaceSync).toHaveBeenCalledWith(defaultCss);
+        });
+
+        test('adopts new sheets into observed roots', () => {
+            const root = createRoot();
+            registry.observeRoot(root);
+
+            subject();
+
+            expect(root.adoptedStyleSheets).toContain(registry.sheets.get('sheet-1'));
+        });
+
+        describe('when sheet with the same ID already exists', () => {
+            beforeEach(() => {
+                subject();
+            });
+
+            test('updates existing sheet in place via replaceSync', () => {
+                const sheet = registry.sheets.get(defaultSheetId)!;
+
+                const newCSS = '.foo { color: blue; }';
+                subject(defaultSheetId, newCSS);
+
+                expect(registry.sheets.get(defaultSheetId)).toBe(sheet);
+                expect(sheet.replaceSync).toHaveBeenLastCalledWith(newCSS);
+            });
+        });
+    });
+
+    describe('observeRoot', () => {
+        let registry: MfeStyleRegistry;
+
+        beforeEach(() => {
+            registry = MfeStyleRegistry.for('test-mfe');
+        });
+
+        test('adds root to the roots set', () => {
+            const root = createRoot();
+
+            registry.observeRoot(root);
+
+            expect(registry.roots.has(root)).toBe(true);
+        });
+
+        describe('when root is already observed', () => {
+            let root: ShadowRoot;
+
+            beforeEach(() => {
+                registry.injectSheet('a', '.a {}');
+                root = createRoot();
+                registry.observeRoot(root);
+            });
+
+            test('does not duplicate sheets', () => {
+                registry.observeRoot(root);
+
+                expect(root.adoptedStyleSheets).toHaveLength(1);
+            });
+        });
+
+        test('adopts all existing sheets into the root', () => {
+            registry.injectSheet('a', '.a {}');
+            registry.injectSheet('b', '.b {}');
+            const root = createRoot();
+
+            registry.observeRoot(root);
+
+            expect(root.adoptedStyleSheets).toEqual([...registry.sheets.values()]);
+        });
+    });
+
+    describe('unobserveRoot', () => {
+        let registry: MfeStyleRegistry;
+        let root: ShadowRoot;
+
+        beforeEach(() => {
+            registry = MfeStyleRegistry.for('test-mfe');
+            root = createRoot();
+            const defaultSheetId = 'sheet-1';
+            registry.injectSheet(defaultSheetId, '.foo {}');
+            registry.observeRoot(root);
+        });
+
+        test('removes root from the roots set', () => {
+            registry.unobserveRoot(root);
+
+            expect(registry.roots.has(root)).toBe(false);
+        });
+
+        test('removes adopted sheets from the root', () => {
+            registry.unobserveRoot(root);
+
+            expect(root.adoptedStyleSheets).toHaveLength(0);
+        });
+
+        test('stops receiving newly adopted sheets', () => {
+            registry.unobserveRoot(root);
+
+            registry.injectSheet('sheet-2', '.bar {}');
+
+            expect(root.adoptedStyleSheets).toHaveLength(0);
+        });
+    });
+});