@appshell/loader 1.0.0-alpha.14 → 1.0.0-alpha.17

package/dist/types/config/src/types.d.ts

@@ -46,7 +46,7 @@ export type ComparisonTarget = {
 export type CliConfig = Record<string, string> & {
     apiKey: string;
     registry: string;
-    environment: string;
+    application: string;
     scopeId: string;
     authIssuer: string;
     clientId: string;
@@ -60,14 +60,14 @@ export type AppshellConfigRemote<TMetadata = Metadata> = {
 export type AppshellConfig<TMetadata = Metadata> = {
     name?: string;
     remotes?: Record<string, AppshellConfigRemote<TMetadata>>;
-    environment?: Record<string, unknown>;
+    vars?: Record<string, unknown>;
     overrides?: AppshellOverrides;
 };
 export type AppshellTemplate<TMetadata = Metadata> = {
     name?: string;
     remotes?: Record<string, AppshellConfigRemote<TMetadata>>;
     module: ModuleFederationPluginOptions;
-    environment?: Record<string, unknown>;
+    vars?: Record<string, unknown>;
     overrides?: AppshellOverrides;
 };
 /** Appshell manifest types */
@@ -81,40 +81,35 @@ export type AppshellRemote<TMetadata = Metadata> = {
     metadata: TMetadata;
 };
 export type AppshellOverrides = {
-    environment: Record<string, Record<string, string | number | undefined>>;
+    vars: Record<string, Record<string, string | number | undefined>>;
 };
 export type AppshellManifest<TMetadata = Metadata> = {
     remotes: Record<string, AppshellRemote<TMetadata>>;
     modules: Record<string, ModuleFederationPluginOptions>;
-    environment: Record<string, Record<string, string | number | undefined>>;
+    vars: Record<string, Record<string, string | number | undefined>>;
     overrides?: AppshellOverrides;
 };
 export type AppshellIndex = Record<string, string>;
 export type Metadata = Record<string, unknown>;
-export type AppshellGlobalConfig<TMetadata = Metadata> = {
-    index: AppshellIndex;
-    metadata?: Record<string, TMetadata>;
-    overrides?: AppshellOverrides;
-};
 /** An `AppshellRemote` the registry already resolved, so the browser needs no manifest fetch. */
 export type ResolvedRemote<TMetadata = Metadata> = AppshellRemote<TMetadata>;
 /**
  * The wire contract for `window.__appshell_config__`. Deliberately not an
  * `AppshellManifest`: that is a build artifact, and reusing it left it unclear
  * which fields the browser actually needs. `modules` is build-time webpack
- * config and never crosses the wire; `environment` arrives already merged with
- * the environment's overrides, leaving the browser only local overrides to apply.
+ * config and never crosses the wire; `vars` arrives already merged with the
+ * application's overrides, leaving the browser only local overrides to apply.
  */
 export type AppshellComposition<TMetadata = Metadata> = {
     /** `scope/name` — makes the payload self-describing for fetch-on-miss and for `env diff`. */
-    environmentId: string;
+    applicationId: string;
     revision: number;
     /** The remote key the host mounts at the root, and the props it is given. */
     root: string;
     rootProps: Record<string, unknown>;
     index: AppshellIndex;
     remotes: Record<string, ResolvedRemote<TMetadata>>;
-    environment: Record<string, Record<string, string | number | undefined>>;
+    vars: Record<string, Record<string, string | number | undefined>>;
     /**
      * Present whenever a per-developer overlay changed anything about this render — a
      * redirected remote, a different shell bundle, or both. The shell is expected to
@@ -306,4 +301,3 @@ export interface ModuleFederationPluginOptions {
      */
     shared?: (string | SharedObject)[] | SharedObject;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/types/config/src/utils/blur.d.ts

@@ -1,3 +1,2 @@
 declare const _default: (token?: string, chars?: number) => string;
 export default _default;
-//# sourceMappingURL=blur.d.ts.map

package/dist/types/config/src/utils/compare.d.ts

@@ -5,4 +5,3 @@ export declare const compareDependencies: (sample: ComparisonTarget, baseline: C
 export declare const compareSharedDependencies: (packageSpec: PackageSpec, sharedModule: SharedModuleSpec) => ComparisonResults;
 export declare const compareSharedModules: (sampleSpec: SharedModuleSpec, baselineSpec: SharedModuleSpec) => ComparisonResults;
 export declare const printResults: (results: ComparisonResults) => void;
-//# sourceMappingURL=compare.d.ts.map

package/dist/types/config/src/utils/config.d.ts

@@ -3,4 +3,3 @@ import { CliConfig } from '../types';
 export declare const readConfig: (configPath: string) => CliConfig;
 export declare const writeConfig: (configPath: string, config: CliConfig) => void;
 export declare const mergeConfigWithArgs: (config: CliConfig, argv: yargs.ArgumentsCamelCase<unknown>) => void;
-//# sourceMappingURL=config.d.ts.map

package/dist/types/config/src/utils/copy.d.ts

@@ -8,4 +8,3 @@ declare const _default: (pattern: {
     to: string;
 }) => void;
 export default _default;
-//# sourceMappingURL=copy.d.ts.map

package/dist/types/config/src/utils/index.d.ts

@@ -2,9 +2,5 @@ export { default as blur } from './blur';
 export { compareDependencies, compareDependency, compareSharedDependencies, compareSharedModules, extractDependencies, printResults, } from './compare';
 export { mergeConfigWithArgs, readConfig, writeConfig } from './config';
 export { default as copy } from './copy';
-export { default as isValidUrl } from './isValidUrl';
 export { default as list } from './list';
 export { default as load, loadAll } from './load';
-export { default as loadJson } from './loadJson';
-export { default as merge } from './merge';
-//# sourceMappingURL=index.d.ts.map

package/dist/types/config/src/utils/list.d.ts

@@ -7,4 +7,3 @@
  */
 declare const list: (dirPath: string, depth?: number, target?: string | RegExp) => string[];
 export default list;
-//# sourceMappingURL=list.d.ts.map

package/dist/types/config/src/utils/load.d.ts

@@ -11,4 +11,3 @@ declare const load: <TSchema>(configPath: string) => TSchema;
  */
 export declare const loadAll: <TSchema>(...paths: string[]) => TSchema[];
 export default load;
-//# sourceMappingURL=load.d.ts.map

package/dist/types/config/src/validators/AppshellTemplateValidator.d.ts

@@ -1,4 +1,3 @@
 import { ConfigValidator } from '../types';
 declare const _default: ConfigValidator;
 export default _default;
-//# sourceMappingURL=AppshellTemplateValidator.d.ts.map

package/dist/types/config/src/validators/index.d.ts

@@ -1,4 +1 @@
-export { default as AppshellGlobalConfigValidator } from './AppshellGlobalConfigValidator';
-export { default as AppshellManifestValidator } from './AppshellManifestValidator';
 export { default as AppshellTemplateValidator } from './AppshellTemplateValidator';
-//# sourceMappingURL=index.d.ts.map

package/dist/types/loader/src/index.d.ts

@@ -3,4 +3,3 @@ export type { RemoteLoaderOptions } from './remoteLoader';
 export * from './resolvers';
 export * from './types';
 export default remoteLoader;
-//# sourceMappingURL=index.d.ts.map

package/dist/types/loader/src/loadAppshellComponent.d.ts

@@ -1,3 +1,2 @@
 declare const _default: <TComponent>(scope: string, module: string, remoteEntryUrl: string, shareScope?: string) => Promise<TComponent>;
 export default _default;
-//# sourceMappingURL=loadAppshellComponent.d.ts.map

package/dist/types/loader/src/remoteLoader.d.ts

@@ -1,8 +1,7 @@
-import type { AppshellComposition, AppshellGlobalConfig } from '@appshell/config';
+import type { AppshellComposition } from '@appshell/config';
 import { type RemoteResolver } from './resolvers';
 declare global {
     interface Window {
-        [key: string]: unknown;
         __appshell_config__?: AppshellComposition;
     }
 }
@@ -11,6 +10,5 @@ export type RemoteLoaderOptions = {
     /** Replaces the resolver chain outright; a seam for tests and embedders. */
     resolver?: RemoteResolver;
 };
-declare const _default: (config: AppshellGlobalConfig, options?: RemoteLoaderOptions) => <TComponent>(key: string) => Promise<readonly [Awaited<TComponent>, import("@appshell/config").AppshellManifest]>;
+declare const _default: (options?: RemoteLoaderOptions) => <TComponent>(key: string) => Promise<readonly [Awaited<TComponent>, import("@appshell/config").ResolvedRemote]>;
 export default _default;
-//# sourceMappingURL=remoteLoader.d.ts.map

package/dist/types/loader/src/resolvers.d.ts

@@ -1,20 +1,12 @@
-import type { AppshellComposition, AppshellGlobalConfig, AppshellManifest, ResolvedRemote } from '@appshell/config';
+import type { AppshellComposition, ResolvedRemote } from '@appshell/config';
 export type RemoteResolution = {
     remote: ResolvedRemote;
-    /** Already merged with the environment's overrides — nothing left for the browser to layer on. */
-    environment: Record<string, string | number | undefined>;
-    /** Back-compat payload for `ManifestProvider`; synthesized when the source was a composition. */
-    manifest: AppshellManifest;
+    /** Already merged with the application's overrides — nothing left for the browser to layer on. */
+    vars: Record<string, string | number | undefined>;
 };
 export type RemoteResolver = (key: string) => Promise<RemoteResolution | undefined>;
 /** The registry inlined the composition into the page, so no network call is needed. */
 export declare const inlineResolver: (composition?: AppshellComposition) => RemoteResolver;
-/** Fetch-on-miss: covers an app activated after this page was served. */
+/** Fetch-on-miss: covers a package activated after this page was served. */
 export declare const registryResolver: (composition?: AppshellComposition, origin?: string) => RemoteResolver;
-/**
- * Pre-registry hosts: follow `index[key]` to the app's own manifest. The override
- * merge stays here because in this mode no server has done it.
- */
-export declare const legacyManifestResolver: (config: AppshellGlobalConfig) => RemoteResolver;
 export declare const chainResolvers: (...resolvers: RemoteResolver[]) => RemoteResolver;
-//# sourceMappingURL=resolvers.d.ts.map

package/dist/types/loader/src/types.d.ts

@@ -8,4 +8,3 @@ export interface ModuleContainer<TComponent> {
     init(shareScope: ShareScope<TComponent>): Promise<void>;
     get(module: string): Promise<() => Record<string, TComponent>>;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/types/runtime/src/errors.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A package asked for vars that were never delivered.
+ *
+ * Almost always one of three things: the package was loaded outside `remoteLoader`
+ * (a test, a storybook, a direct import), the host and the package resolved separate
+ * copies of `@appshell/runtime` because one of them failed to declare it as a
+ * singleton, or the scope compiled into the package is not the scope the registry
+ * knows it by.
+ */
+export declare class MissingVarsError extends Error {
+    readonly scope: string;
+    constructor(scope: string, known: string[]);
+}
+/**
+ * Something tried to replace vars that were already delivered for a scope.
+ *
+ * The first write wins and is final. Within one page load a scope has exactly one
+ * vars object — both resolvers read it from the same `composition.vars[scope]` — so a
+ * differing second write is a bug or a package reaching for a scope that is not its own,
+ * and neither should be applied quietly.
+ */
+export declare class VarsConflictError extends Error {
+    readonly scope: string;
+    constructor(scope: string);
+}

package/dist/types/runtime/src/index.d.ts

@@ -0,0 +1,3 @@
+export { MissingVarsError, VarsConflictError } from './errors';
+export { hasVars, readVars, resetVars, setVars } from './store';
+export type { Vars } from './types';

package/dist/types/runtime/src/store.d.ts

@@ -0,0 +1,25 @@
+import type { Vars } from './types';
+/**
+ * Delivers a scope's vars. Called by `@appshell/loader` immediately before the remote
+ * is loaded, so they are in place before the package's modules evaluate.
+ *
+ * The first write for a scope wins and is frozen. Re-delivering the identical vars is a
+ * no-op — the same remote can be mounted more than once — but replacing them throws.
+ * That is what keeps one package from overwriting another's: by the time any package
+ * evaluates, the host has already written for it.
+ *
+ * It does not make a scope's vars *private*. Any code on the page can still read another
+ * scope by name, and nothing short of a separate realm would change that.
+ */
+export declare const setVars: (scope: string, vars: Vars) => void;
+/**
+ * Reads a scope's vars, throwing rather than handing back an empty object — a package
+ * that silently renders with no configuration is the failure this replaced.
+ *
+ * Prefer `getVars()` from `@appshell/vars`, which supplies the scope for you.
+ */
+export declare const readVars: <TVars extends Vars = Vars>(scope: string) => TVars;
+/** Whether a scope has been delivered, for callers that want to branch instead of catch. */
+export declare const hasVars: (scope: string) => boolean;
+/** Test seam. Not part of the contract a package should build on. */
+export declare const resetVars: () => void;

package/dist/types/runtime/src/types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A package's runtime configuration, already merged by the registry — a package's
+ * declared vars, then the application's `overrides.vars`.
+ *
+ * Structurally identical to `AppshellComposition['vars'][scope]` in `@appshell/config`,
+ * but declared here rather than imported. This package is a shared singleton loaded
+ * into every micro-frontend on the page, so it carries no dependencies at all.
+ */
+export type Vars = Record<string, string | number | undefined>;

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@appshell/loader",
-  "version": "1.0.0-alpha.14",
+  "version": "1.0.0-alpha.17",
   "description": "Utility for loading Appshell components",
   "main": "dist/main.js",
   "types": "dist/loader/src/index.d.ts",
-  "repository": "https://github.com/appshell-org/appshell.git",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/appshellhq/appshell.git"
+  },
   "author": "Robert Hamilton <rh@navaris.com>",
   "publishConfig": {
     "access": "public",
@@ -18,6 +21,9 @@
     "start": "webpack --watch --mode development && npm run build:types",
     "stats": "webpack --json > stats.json"
   },
+  "files": [
+    "dist"
+  ],
   "keywords": [
     "module federation",
     "micro-frontends",
@@ -25,7 +31,8 @@
   ],
   "license": "MIT",
   "dependencies": {
+    "@appshell/runtime": "^1.0.0-alpha.17",
     "@module-federation/enhanced": "^2.8.2"
   },
-  "gitHead": "7dc77badfed56201b3e177f62e55609a360f7e0e"
+  "gitHead": "98c549b896365c997a8a37b75a6c366b9211ec16"
 }

package/CHANGELOG.md

@@ -1,227 +0,0 @@
-# Change Log
-
-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-
-# [1.0.0-alpha.14](https://github.com/appshell-org/appshell/compare/v1.0.0-alpha.13...v1.0.0-alpha.14) (2026-08-23)
-
-**Note:** Version bump only for package @appshell/loader
-
-# [1.0.0-alpha.13](https://github.com/appshell-org/appshell/compare/v1.0.0-alpha.12...v1.0.0-alpha.13) (2026-08-22)
-
-### Bug Fixes
-
-- **loader,react:** stop forcing a full page reload on remote updates ([36b96c4](https://github.com/appshell-org/appshell/commit/36b96c471dcedf1d29847ef5e41fb21c04864d45))
-
-### Features
-
-- **hmr:** checkpoint current composed app hot reload work ([165788d](https://github.com/appshell-org/appshell/commit/165788d2f276e5f82b750d84abf6cab2e73f8f64))
-
-# [1.0.0-alpha.12](https://github.com/appshell-org/appshell/compare/v1.0.0-alpha.11...v1.0.0-alpha.12) (2026-08-21)
-
-### Bug Fixes
-
-- improve local federation HMR and shell share behavior ([463d85c](https://github.com/appshell-org/appshell/commit/463d85ce0f18f6111a09b5d94d39d24fb813abc8))
-
-# [1.0.0-alpha.11](https://github.com/appshell-org/appshell/compare/v1.0.0-alpha.10...v1.0.0-alpha.11) (2026-08-20)
-
-### Features
-
-- **loader:** migrate remote loading to @module-federation/enhanced runtime ([fda2d5d](https://github.com/appshell-org/appshell/commit/fda2d5ddfa5487f9aae55669392a08e55a491461)), closes [#RUNTIME-010](https://github.com/appshell-org/appshell/issues/RUNTIME-010)
-
-# [1.0.0-alpha.10](https://github.com/appshell-org/appshell/compare/v1.0.0-alpha.9...v1.0.0-alpha.10) (2026-08-19)
-
-**Note:** Version bump only for package @appshell/loader
-
-# [1.0.0-alpha.9](https://github.com/appshell-org/appshell/compare/v1.0.0-alpha.8...v1.0.0-alpha.9) (2026-08-19)
-
-### Bug Fixes
-
-- **example:** resolve CSP/module-federation issues blocking local dev ([f8de4e1](https://github.com/appshell-org/appshell/commit/f8de4e1cfe495a7d4ae8e6374189384847c21309))
-
-# [1.0.0-alpha.8](https://github.com/appshell-org/appshell/compare/v1.0.0-alpha.7...v1.0.0-alpha.8) (2026-08-19)
-
-**Note:** Version bump only for package @appshell/loader
-
-# [1.0.0-alpha.7](https://github.com/appshell-org/appshell/compare/v1.0.0-alpha.6...v1.0.0-alpha.7) (2026-08-18)
-
-**Note:** Version bump only for package @appshell/loader
-
-**Note:** Version bump only for package @appshell/loader
-
-# [1.0.0-alpha.6](https://github.com/appshell-org/appshell/compare/v1.0.0-alpha.5...v1.0.0-alpha.6) (2026-08-18)
-
-**Note:** Version bump only for package @appshell/loader
-
-# [1.0.0-alpha.5](https://github.com/appshell-org/appshell/compare/v1.0.0-alpha.4...v1.0.0-alpha.5) (2026-08-18)
-
-**Note:** Version bump only for package @appshell/loader
-
-**Note:** Version bump only for package @appshell/loader
-
-# [1.0.0-alpha.4](https://github.com/appshell-org/appshell/compare/v1.0.0-alpha.3...v1.0.0-alpha.4) (2026-08-18)
-
-**Note:** Version bump only for package @appshell/loader
-
-**Note:** Version bump only for package @appshell/loader
-
-# [1.0.0-alpha.3](https://github.com/appshell-org/appshell/compare/v1.0.0-alpha.2...v1.0.0-alpha.3) (2026-08-18)
-
-**Note:** Version bump only for package @appshell/loader
-
-# 0.12.0-alpha.0 (2026-04-20)
-
-### Bug Fixes
-
-- appshell loader override check ([aedda4a](https://github.com/appshell-org/appshell/commit/aedda4abf81560297dce03df09fba68e8785242f))
-- configurable api key header support, minor fixes ([2f0bf02](https://github.com/appshell-org/appshell/commit/2f0bf027b92398f91b8e8cbfbf543d61fe37b7a0))
-- hot module replacement support, example updates ([a67d230](https://github.com/appshell-org/appshell/commit/a67d2303b40f5911373225cc0b4ccf9b67c33d11))
-- registry projection, enable env overwrite, refactor docker workflow, consolidate env names ([33a28fe](https://github.com/appshell-org/appshell/commit/33a28fe76b58e05c5b6b6b33d4b402e52bb29e70))
-- rename @appshell/react-federated-component package to @appshell/react ([0b74498](https://github.com/appshell-org/appshell/commit/0b74498bf17ba73db4d936c8a012af1d3b111a28))
-- replace config intermediate file with template ([9b79e65](https://github.com/appshell-org/appshell/commit/9b79e65b355686a0cca273c89c7164bb031e8437))
-- update repository URLs from navaris/appshell to appshell-org/appshell ([506a90d](https://github.com/appshell-org/appshell/commit/506a90d94a6f6e10f463987d408550f48624bfd0))
-
-### Features
-
-- api key support ([9cdcbee](https://github.com/appshell-org/appshell/commit/9cdcbee36e44b8a179b49768d74a25767f1cc5f2))
-- appshell cli api key support, init sync and outdated commands ([#6](https://github.com/appshell-org/appshell/issues/6)) ([acc5fa2](https://github.com/appshell-org/appshell/commit/acc5fa234f91a167038161d5080481c43f8eb8b4))
-- AppshellComponent impl ([2b82621](https://github.com/appshell-org/appshell/commit/2b82621c13302f790a8e1c457f9a82f39903fc1f))
-- consolidate runtime artifacts ([#26](https://github.com/appshell-org/appshell/issues/26)) ([a29479a](https://github.com/appshell-org/appshell/commit/a29479a49f0c5ec1273c9f8e4c7384096f2d4ba0))
-- environment variable override for federated components ([#27](https://github.com/appshell-org/appshell/issues/27)) ([d32de0b](https://github.com/appshell-org/appshell/commit/d32de0b0d1cbb1792715e1b363c80ed4600df155))
-- foundation refactor wip ([339b930](https://github.com/appshell-org/appshell/commit/339b9306accaa9aba1712f3a0dee6c4cab7ed273))
-
-## [0.5.1-alpha.0](https://github.com/appshell-org/appshell/compare/@appshell/loader@0.5.0...@appshell/loader@0.5.1-alpha.0) (2026-04-20)
-
-### Bug Fixes
-
-- update repository URLs from navaris/appshell to appshell-org/appshell ([506a90d](https://github.com/appshell-org/appshell/commit/506a90d94a6f6e10f463987d408550f48624bfd0))
-
-# [0.5.0](https://github.com/navaris/appshell/compare/@appshell/loader@0.4.0...@appshell/loader@0.5.0) (2025-08-12)
-
-### Bug Fixes
-
-- configurable api key header support, minor fixes ([2f0bf02](https://github.com/navaris/appshell/commit/2f0bf027b92398f91b8e8cbfbf543d61fe37b7a0))
-
-### Features
-
-- appshell cli api key support, init sync and outdated commands ([#6](https://github.com/navaris/appshell/issues/6)) ([acc5fa2](https://github.com/navaris/appshell/commit/acc5fa234f91a167038161d5080481c43f8eb8b4))
-
-# [0.5.0-alpha.0](https://github.com/navaris/appshell/compare/@appshell/loader@0.4.0...@appshell/loader@0.5.0-alpha.0) (2025-08-10)
-
-### Bug Fixes
-
-- include credentials when fetching the manifests ([4e0ee79](https://github.com/navaris/appshell/commit/4e0ee79b4ba93d34fd6a0e1a5f6bf2fc9f3994cc))
-
-### Features
-
-- appshell cli api key support, init sync and outdated commands ([#6](https://github.com/navaris/appshell/issues/6)) ([acc5fa2](https://github.com/navaris/appshell/commit/acc5fa234f91a167038161d5080481c43f8eb8b4))
-
-# [0.4.0](https://github.com/navaris/appshell/compare/@appshell/loader@0.3.0...@appshell/loader@0.4.0) (2024-09-24)
-
-### Features
-
-- api key support ([9cdcbee](https://github.com/navaris/appshell/commit/9cdcbee36e44b8a179b49768d74a25767f1cc5f2))
-
-# [0.4.0-alpha.0](https://github.com/navaris/appshell/compare/@appshell/loader@0.3.1-alpha.0...@appshell/loader@0.4.0-alpha.0) (2024-09-05)
-
-### Features
-
-- api key support ([8c91e62](https://github.com/navaris/appshell/commit/8c91e6240b3d879af9bdd5949924865da0e0f8a1))
-
-## [0.3.1-alpha.0](https://github.com/navaris/appshell/compare/@appshell/loader@0.3.0...@appshell/loader@0.3.1-alpha.0) (2024-08-31)
-
-### Bug Fixes
-
-- bump pipeline ([8bb63bc](https://github.com/navaris/appshell/commit/8bb63bcae1928c01bb6bc853d88010939e686af5))
-
-# [0.3.0](https://github.com/navaris/appshell/compare/@appshell/loader@0.2.1...@appshell/loader@0.3.0) (2024-01-25)
-
-### Features
-
-- AppshellComponent impl ([2b82621](https://github.com/navaris/appshell/commit/2b82621c13302f790a8e1c457f9a82f39903fc1f))
-
-## [0.2.1](https://github.com/navaris/appshell/compare/@appshell/loader@0.2.0...@appshell/loader@0.2.1) (2023-08-29)
-
-### Bug Fixes
-
-- appshell loader override check ([aedda4a](https://github.com/navaris/appshell/commit/aedda4abf81560297dce03df09fba68e8785242f))
-
-# [0.2.0](https://github.com/navaris/appshell/compare/@appshell/loader@0.2.0-alpha.1...@appshell/loader@0.2.0) (2023-08-28)
-
-**Note:** Version bump only for package @appshell/loader
-
-# [0.2.0-alpha.1](https://github.com/navaris/appshell/compare/@appshell/loader@0.2.0-alpha.0...@appshell/loader@0.2.0-alpha.1) (2023-08-28)
-
-### Features
-
-- environment variable override for federated components ([#27](https://github.com/navaris/appshell/issues/27)) ([d32de0b](https://github.com/navaris/appshell/commit/d32de0b0d1cbb1792715e1b363c80ed4600df155))
-
-# [0.2.0-alpha.0](https://github.com/navaris/appshell/compare/@appshell/loader@0.1.0...@appshell/loader@0.2.0-alpha.0) (2023-08-23)
-
-### Features
-
-- consolidate runtime artifacts ([#26](https://github.com/navaris/appshell/issues/26)) ([a29479a](https://github.com/navaris/appshell/commit/a29479a49f0c5ec1273c9f8e4c7384096f2d4ba0))
-
-# [0.1.0](https://github.com/navaris/appshell/compare/@appshell/loader@0.1.0-alpha.1...@appshell/loader@0.1.0) (2023-07-11)
-
-### Bug Fixes
-
-- registry projection, enable env overwrite, refactor docker workflow, consolidate env names ([33a28fe](https://github.com/navaris/appshell/commit/33a28fe76b58e05c5b6b6b33d4b402e52bb29e70))
-- rename @appshell/react-federated-component package to @appshell/react ([0b74498](https://github.com/navaris/appshell/commit/0b74498bf17ba73db4d936c8a012af1d3b111a28))
-- replace config intermediate file with template ([9b79e65](https://github.com/navaris/appshell/commit/9b79e65b355686a0cca273c89c7164bb031e8437))
-
-# [0.1.0-alpha.1](https://github.com/navaris/appshell/compare/@appshell/loader@0.0.3...@appshell/loader@0.1.0-alpha.1) (2023-07-05)
-
-### Features
-
-- foundation refactor wip ([339b930](https://github.com/navaris/appshell/commit/339b9306accaa9aba1712f3a0dee6c4cab7ed273))
-
-# [0.1.0-alpha.0](https://github.com/navaris/appshell/compare/@appshell/loader@0.0.3...@appshell/loader@0.1.0-alpha.0) (2023-07-05)
-
-### Features
-
-- registry index ([8e6ee0a](https://github.com/navaris/appshell/commit/8e6ee0a6a377584efa2ee702168025f46108b8c5))
-
-## [0.0.3](https://github.com/navaris/appshell/compare/@appshell/loader@0.0.3-alpha.2...@appshell/loader@0.0.3) (2023-06-29)
-
-**Note:** Version bump only for package @appshell/loader
-
-## [0.0.3-alpha.2](https://github.com/navaris/appshell/compare/@appshell/loader@0.0.2...@appshell/loader@0.0.3-alpha.2) (2023-06-29)
-
-**Note:** Version bump only for package @appshell/loader
-
-## [0.0.3-alpha.1](https://github.com/navaris/appshell/compare/@appshell/loader@0.0.3-alpha.0...@appshell/loader@0.0.3-alpha.1) (2023-06-29)
-
-### Bug Fixes
-
-- update npm package visibility ([1ef4119](https://github.com/navaris/appshell/commit/1ef411903dd038dfc781e8ce0700811e5460c903))
-
-## [0.0.3-alpha.0](https://github.com/navaris/appshell/compare/@appshell/loader@0.0.2-alpha.0...@appshell/loader@0.0.3-alpha.0) (2023-06-29)
-
-**Note:** Version bump only for package @appshell/loader
-
-## [0.0.2](https://github.com/navaris/appshell/compare/@appshell/loader@0.0.2-alpha.0...@appshell/loader@0.0.2) (2023-06-29)
-
-**Note:** Version bump only for package @appshell/loader
-
-## [0.0.2-alpha.0](https://github.com/navaris/appshell/compare/@appshell/loader@0.0.1...@appshell/loader@0.0.2-alpha.0) (2023-06-15)
-
-### Bug Fixes
-
-- hot module replacement support, example updates ([a67d230](https://github.com/navaris/appshell/commit/a67d2303b40f5911373225cc0b4ccf9b67c33d11))
-
-=======
-
-## 0.0.1 (2023-06-15)
-
-**Note:** Version bump only for package @appshell/loader
-
-## [0.0.1-alpha.1](https://github.com/navaris/appshell/compare/@appshell/loader@0.0.1-alpha.0...@appshell/loader@0.0.1-alpha.1) (2023-06-15)
-
-### Bug Fixes
-
-- hot module replacement support, example updates ([a67d230](https://github.com/navaris/appshell/commit/a67d2303b40f5911373225cc0b4ccf9b67c33d11))
-
-## 0.0.1-alpha.0 (2023-03-19)
-
-**Note:** Version bump only for package @appshell/loader

package/__tests__/fixtures/TestComponent.ts

@@ -1,3 +0,0 @@
-const TestComponent = () => 'test component';
-
-export default TestComponent;

package/__tests__/loadAppshellComponent.spec.ts

@@ -1,68 +0,0 @@
-/** @jest-environment jsdom */
-
-jest.mock('@module-federation/enhanced/runtime', () => ({
-  init: jest.fn(),
-  getInstance: jest.fn(() => null),
-  registerRemotes: jest.fn(),
-  loadRemote: jest.fn(),
-}));
-
-type ComponentType = () => string;
-const TestComponent: ComponentType = () => 'test component';
-
-describe('loadAppshellComponent', () => {
-  beforeEach(() => {
-    jest.resetModules();
-  });
-
-  it('should load the Appshell component via the federation runtime', async () => {
-    const runtime = await import('@module-federation/enhanced/runtime');
-    (runtime.loadRemote as jest.Mock).mockResolvedValue({ default: TestComponent });
-    const loadAppshellComponent = (await import('../src/loadAppshellComponent')).default;
-
-    const Component = await loadAppshellComponent<ComponentType>(
-      'TestModule',
-      './TestComponent',
-      'http://test.com/remoteEntry.js',
-    );
-
-    expect(Component).toBe(TestComponent);
-    expect(runtime.registerRemotes).toHaveBeenCalledWith([
-      { name: 'TestModule', entry: 'http://test.com/remoteEntry.js' },
-    ]);
-    expect(runtime.loadRemote).toHaveBeenCalledWith('TestModule/TestComponent');
-  });
-
-  it('should initialize the runtime and register each scope only once', async () => {
-    const runtime = await import('@module-federation/enhanced/runtime');
-    (runtime.loadRemote as jest.Mock).mockResolvedValue({ default: TestComponent });
-    const loadAppshellComponent = (await import('../src/loadAppshellComponent')).default;
-
-    await loadAppshellComponent('TestModule', './TestComponent', 'http://test.com/remoteEntry.js');
-    await loadAppshellComponent('TestModule', './TestComponent', 'http://test.com/remoteEntry.js');
-
-    expect(runtime.init).toHaveBeenCalledTimes(1);
-    expect(runtime.registerRemotes).toHaveBeenCalledTimes(1);
-  });
-
-  it('should throw if the remote module cannot be loaded', async () => {
-    const runtime = await import('@module-federation/enhanced/runtime');
-    (runtime.loadRemote as jest.Mock).mockResolvedValue(null);
-    const loadAppshellComponent = (await import('../src/loadAppshellComponent')).default;
-
-    await expect(
-      loadAppshellComponent('TestModule', './TestComponent', 'http://test.com/remoteEntry.js'),
-    ).rejects.toThrow(/Failed to find module container/i);
-  });
-
-  it('should not call init when a host federation instance already exists', async () => {
-    const runtime = await import('@module-federation/enhanced/runtime');
-    (runtime.getInstance as jest.Mock).mockReturnValue({});
-    (runtime.loadRemote as jest.Mock).mockResolvedValue({ default: TestComponent });
-    const loadAppshellComponent = (await import('../src/loadAppshellComponent')).default;
-
-    await loadAppshellComponent('TestModule', './TestComponent', 'http://test.com/remoteEntry.js');
-
-    expect(runtime.init).not.toHaveBeenCalled();
-  });
-});