@appshell/react 1.0.0-alpha.67 → 1.0.0-alpha.69

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

@@ -14,8 +14,9 @@ import { AppshellTemplate } from './types';
  */
 export declare const manifestFrom: <TMetadata extends Record<string, unknown>>(template: AppshellTemplate) => {
     vars: Record<string, Record<string, string | number | undefined>>;
-    remotes: Record<string, import("./types").PublishedRemote<TMetadata>>;
-    modules: Record<string, import("./types").ModuleFederationPluginOptions>;
+    components: Record<string, import("./types").PublishedRemote<TMetadata>>;
+    remotes?: string[];
+    shared?: import("./types").SharedContract;
     tokens?: Record<string, import("./types").AppshellTokenUsage>;
     overrides?: import("./types").AppshellOverrides;
 };
@@ -26,8 +27,9 @@ export declare const manifestFrom: <TMetadata extends Record<string, unknown>>(t
  */
 declare const _default: <TMetadata extends Record<string, unknown>>(templatePath: string) => Promise<{
     vars: Record<string, Record<string, string | number | undefined>>;
-    remotes: Record<string, import("./types").PublishedRemote<TMetadata>>;
-    modules: Record<string, import("./types").ModuleFederationPluginOptions>;
+    components: Record<string, import("./types").PublishedRemote<TMetadata>>;
+    remotes?: string[];
+    shared?: import("./types").SharedContract;
     tokens?: Record<string, import("./types").AppshellTokenUsage>;
     overrides?: import("./types").AppshellOverrides;
 } | null>;

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

@@ -1,8 +1,9 @@
-import { AppshellTemplate, ConfigMap, PublishedRemote } from '../types';
+import { AppshellTemplate, ConfigMap, PublishedRemote, SharedContract } from '../types';
 export declare const toAppshellManifest: <TMetadata extends Record<string, unknown>>(template: AppshellTemplate, args: ConfigMap) => {
     vars: Record<string, Record<string, string | number | undefined>>;
-    remotes: Record<string, PublishedRemote<TMetadata>>;
-    modules: Record<string, import("../types").ModuleFederationPluginOptions>;
+    components: Record<string, PublishedRemote<TMetadata>>;
+    remotes?: string[];
+    shared?: SharedContract;
     tokens?: Record<string, import("../types").AppshellTokenUsage>;
     overrides?: import("../types").AppshellOverrides;
 };

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

@@ -93,7 +93,28 @@ export type AppshellConfig<TMetadata = Metadata> = {
      * content changing identity.
      */
     visibility?: 'public' | 'private';
-    remotes?: Record<string, AppshellConfigRemote<TMetadata>>;
+    /**
+     * What this package publishes, keyed by federation entrypoint.
+     *
+     * Appshell's own word rather than a framework's. It was `remotes`, which is MF's word
+     * for the opposite — what a package consumes — so the file read inverted to anyone who
+     * knew the framework. `exposes` would fix that and put MF's vocabulary at the top level
+     * of appshell's model, which is what the loader recipe exists to prevent.
+     */
+    components?: Record<string, AppshellConfigRemote<TMetadata>>;
+    /**
+     * What this package consumes, by the name it refers to them by.
+     *
+     * A flat list because a referenced remote is required by definition: unbound, the region
+     * renders an error. `RemoteSlot`'s `fallback` is a loading placeholder — it shows while
+     * the remote arrives, not when it is absent — so unlike a design token's `var()`
+     * fallback it describes no degraded-but-working state.
+     *
+     * The application binds each name to a registry address, so a package never states the
+     * scope its siblings were published into — which it cannot know, since scope is assigned
+     * by whoever publishes.
+     */
+    remotes?: string[];
     vars?: Record<string, unknown>;
     overrides?: AppshellOverrides;
 };
@@ -101,7 +122,8 @@ export type AppshellTemplate<TMetadata = Metadata> = {
     name?: string;
     /** Carried from the yaml for publish to read; never mapped into the manifest. */
     visibility?: 'public' | 'private';
-    remotes?: Record<string, AppshellConfigRemote<TMetadata>>;
+    components?: Record<string, AppshellConfigRemote<TMetadata>>;
+    remotes?: string[];
     module: ModuleFederationPluginOptions;
     vars?: Record<string, unknown>;
     tokens?: Record<string, AppshellTokenUsage>;
@@ -142,9 +164,28 @@ export type AppshellTokenUsage = {
     required: string[];
     optional: string[];
 };
+/** A shared-dependency contract, named as one framework's model among possible models. */
+export type SharedContract = {
+    apiVersion: 'federation.appshell.org/v1';
+    kind: 'ModuleFederation';
+    /** Keyed by share scope, as Module Federation groups them. */
+    scopes: Record<string, SharedObject>;
+};
 export type AppshellManifest<TMetadata = Metadata> = {
-    remotes: Record<string, PublishedRemote<TMetadata>>;
-    modules: Record<string, ModuleFederationPluginOptions>;
+    /** What this package publishes, keyed by federation entrypoint. */
+    components: Record<string, PublishedRemote<TMetadata>>;
+    /** What it consumes, by local name; the application binds each to an address. */
+    remotes?: string[];
+    /**
+     * The shared-dependency contract this package was built against.
+     *
+     * Tagged like the loader recipe, and for the same reason: share scopes, singletons and
+     * version ranges are Module Federation's model of the problem, which single-spa and
+     * import maps solve differently. This replaced `modules`, which stored MF's plugin
+     * options verbatim — one reader took two fields from it, while its source paths and
+     * type-generation flags sat inside the package digest.
+     */
+    shared?: SharedContract;
     vars: Record<string, Record<string, string | number | undefined>>;
     /** Keyed by federation scope, so a merged manifest still says which package needs what. */
     tokens?: Record<string, AppshellTokenUsage>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appshell/react",
-  "version": "1.0.0-alpha.67",
+  "version": "1.0.0-alpha.69",
   "description": "React utilities for building micro-frontends with Appshell and Module Federation",
   "main": "dist/main.js",
   "types": "dist/types/react/src/index.d.ts",
@@ -34,8 +34,8 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
-  "gitHead": "4939e80b0e0bd445b44dc7a1ebdb6fe6d80f5b34",
+  "gitHead": "a245de9d4419fd2ea66625b1f269e8bf06993797",
   "dependencies": {
-    "@appshell/runtime": "^1.0.0-alpha.67"
+    "@appshell/runtime": "^1.0.0-alpha.69"
   }
 }