Separate portal from shared core entry

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Author: heswell

vuu-ui/packages/core/README.md

@@ -1,5 +1,10 @@
-# @vuu-ui/core portal
+# @vuu-ui/core
 
-Reusable VUU portal host and Module Federation integration components.
+Core VUU authentication and data-context APIs are exported from
+`@vuu-ui/core` and can be registered as a shared Module Federation dependency.
 
-See [DESIGN.md](./DESIGN.md) for the package design.
+Portal host and remote-module APIs are exported separately from
+`@vuu-ui/core/portal` so portal dependencies are not included in the shared
+module.
+
+See [the portal design](./docs/portal-design.md) for details.

vuu-ui/packages/core/docs/portal-design.md

@@ -2,7 +2,7 @@
 
 ## Purpose
 
-`@vuu-ui/core` provides the reusable components, types, and utilities
+`@vuu-ui/core/portal` provides the reusable components, types, and utilities
 needed to build VUU portals with Module Federation. It is the package boundary
 for portal host behavior and remote-module integration.
 
@@ -45,8 +45,9 @@ core/
 |   |-- portal-shell/
 |   |-- remote-module/
 |   |-- index.ts
+|   |-- portal.ts
 |   `-- RemoteModuleDescriptor.ts
-|-- DESIGN.md
+|-- docs/
 |-- README.md
 |-- package.json
 `-- tsconfig.json

vuu-ui/packages/core/package.json

@@ -6,6 +6,10 @@
     "docs"
   ],
   "main": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./portal": "./src/portal.ts"
+  },
   "author": "heswell",
   "license": "Apache-2.0",
   "type": "module",

vuu-ui/packages/core/src/index.ts

@@ -4,14 +4,3 @@ export {
   DataProvider,
   useData,
 } from "./context-definitions/DataProvider";
-export {
-  PortalHeader,
-  type PortalHeaderProps,
-} from "./portal-header/PortalHeader";
-export { PortalNav, type PortalNavProps } from "./portal-nav/PortalNav";
-export { PortalShell, type PortalShellProps } from "./portal-shell/PortalShell";
-export {
-  RemoteModule,
-  type RemoteModuleProps,
-} from "./remote-module/RemoteModule";
-export type { RemoteModuleDescriptor } from "./RemoteModuleDescriptor";

vuu-ui/packages/core/src/portal-header/PortalHeader.tsx

@@ -1,5 +1,5 @@
 import { Button, Toolbar, ToolbarContent, Tooltray } from "@salt-ds/core";
-import { useLogout } from "../auth";
+import { useLogout } from "@vuu-ui/core";
 import cx from "clsx";
 import type { HTMLAttributes } from "react";
 

vuu-ui/packages/core/src/portal.ts

@@ -0,0 +1,11 @@
+export {
+  PortalHeader,
+  type PortalHeaderProps,
+} from "./portal-header/PortalHeader";
+export { PortalNav, type PortalNavProps } from "./portal-nav/PortalNav";
+export { PortalShell, type PortalShellProps } from "./portal-shell/PortalShell";
+export {
+  RemoteModule,
+  type RemoteModuleProps,
+} from "./remote-module/RemoteModule";
+export type { RemoteModuleDescriptor } from "./RemoteModuleDescriptor";

vuu-ui/packages/core/src/remote-module/RemoteModule.tsx

@@ -1,4 +1,7 @@
-import { AuthenticationProvider, type RemoteModuleConnection } from "../auth";
+import {
+  AuthenticationProvider,
+  type RemoteModuleConnection,
+} from "@vuu-ui/core";
 import {
   loadRemote,
   registerRemotes,

vuu-ui/packages/vuu-shell/src/feature/Feature.tsx

@@ -1,7 +1,7 @@
-import { RemoteModule } from "@vuu-ui/core";
+import { RemoteModule } from "@vuu-ui/core/portal";
 import { registerComponent } from "@vuu-ui/vuu-utils";
 
-/** @deprecated Use RemoteModule from @vuu-ui/core. */
+/** @deprecated Use RemoteModule from @vuu-ui/core/portal. */
 export const Feature = RemoteModule;
 Feature.displayName = "Feature";
 registerComponent("Feature", Feature, "view");

vuu-ui/packages/vuu-shell/src/feature/index.ts

@@ -2,4 +2,4 @@ export * from "./Feature";
 export {
   RemoteModule,
   type RemoteModuleProps,
-} from "@vuu-ui/core";
+} from "@vuu-ui/core/portal";

vuu-ui/sample-apps/vuu-portal/src/App.tsx

@@ -4,7 +4,7 @@ import { registerComponent } from "@vuu-ui/vuu-utils";
 import { useEffect, useState } from "react";
 import { ConfirmSelectionPanel } from "./order-management/cancel-confirm-prompt/ConfirmSelectionPanel";
 import { BrowserRouter } from "react-router-dom";
-import { PortalShell, type RemoteModuleDescriptor } from "@vuu-ui/core";
+import { PortalShell, type RemoteModuleDescriptor } from "@vuu-ui/core/portal";
 import { getRegisteredModules } from "@vuu-ui/vuu-shell";
 
 import "./App.css";