Make the module navigation capability an optional context member

ModuleUiHostContext.navigation is now `navigation?: ModuleUiNavigation | undefined`, so the public context change is source-compatible: a context built before navigation existed (without the member) still compiles unchanged, as 0.x patch releases require. The Dashboard supplies navigation; hosts without addressable pages, including the display host, omit the member; modules feature-detect it. Existing hosts' tests are restored to their pre-PR shape, and a module-ui-sdk test proves a pre-navigation context still satisfies ModuleUiHostContext (and fails if the member is ever made required). Runtime behaviour, manifest v8/v9 compatibility, and security rules are unchanged. ADR 0063 and the module development guide say so. Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-15 09:13:03 -05:00
parent ae360ef318
commit c78f1318b4
13 changed files with 60 additions and 37 deletions
@@ -569,7 +569,7 @@ describe("module UI host context", () => {
    expect(context.display?.url).toBe("https://api.example.test/display/example");
  });

-  it("exposes exactly the eight contract members and the browser principal", () => {
+  it("exposes exactly the seven contract members and the browser principal", () => {
    const { implementation } = recordingFetch();

    const context = contextFor(implementation);
@@ -579,14 +579,14 @@ describe("module UI host context", () => {
      "contributions",
      "display",
      "moduleId",
-      "navigation",
      "permissions",
      "principal",
      "realtime",
    ]);
    expect(context.moduleId).toBe("example");
-    // Navigation comes only from a host with addressable pages (ADR 0063); this one supplies none.
-    expect(context.navigation).toBeUndefined();
+    // Navigation comes only from a host with addressable pages (ADR 0063). Without it the member is
+    // omitted, so the context is exactly the shape it was before navigation existed.
+    expect("navigation" in context).toBe(false);
    expect(context.principal).toEqual({ kind: "authenticated", userId: "user-1" });
  });