@astrale-os/shell-react 0.2.10-beta.2 → 0.2.10-beta.3

package/dist/components/astrale.d.ts

@@ -0,0 +1,14 @@
+import type { Shell, ShellConfig } from '@astrale-os/shell';
+import type { ReactElement, ReactNode } from 'react';
+import type { ShellProviderProps } from '../session/provider.js';
+export interface AstraleProps {
+    /** Defaults to the child-side sandbox handshake; pass a Shell for an embedded host or test. */
+    readonly config?: ShellConfig | Shell;
+    readonly fallback?: ReactNode;
+    readonly errorFallback?: ShellProviderProps['errorFallback'];
+    readonly onError?: (error: unknown) => void;
+    readonly children: ReactNode;
+}
+/** Complete Astrale runtime root without taking ownership of application routing. */
+export declare function Astrale(props: AstraleProps): ReactElement;
+//# sourceMappingURL=astrale.d.ts.map

package/dist/components/astrale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"astrale.d.ts","sourceRoot":"","sources":["../../src/components/astrale.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAIpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAQhE,MAAM,WAAW,YAAY;IAC3B,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,KAAK,CAAA;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAA;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;CAC7B;AAED,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAgBzD"}

package/dist/components/astrale.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Suspense } from 'react';
+import { ShellProvider } from '../session/provider.js';
+import { ViewStage } from '../window/stage.js';
+import { defaultViewError, defaultViewLoading, ViewErrorBoundary } from './boundaries.js';
+const SANDBOXED_SHELL = Object.freeze({ mode: 'sandboxed' });
+/** Complete Astrale runtime root without taking ownership of application routing. */
+export function Astrale(props) {
+    const loading = props.fallback ?? defaultViewLoading();
+    const errorFallback = props.errorFallback ?? defaultViewError;
+    return (_jsxs(ShellProvider, { config: props.config ?? SANDBOXED_SHELL, fallback: loading, errorFallback: errorFallback, onError: ({ error }) => props.onError?.(error), children: [_jsx(ViewErrorBoundary, { fallback: errorFallback, onError: props.onError, children: _jsx(Suspense, { fallback: loading, children: props.children }) }), _jsx(ViewStage, {})] }));
+}

package/dist/components/index.d.ts

@@ -1,7 +1,6 @@
 export { Can } from './can.js';
 export { ConnectionBoundary, CredentialBoundary, defaultViewError, defaultViewLoading, GraphBoundary, ViewErrorBoundary, ViewBoundary, } from './boundaries.js';
 export type { ViewErrorBoundaryProps } from './boundaries.js';
-export { ViewApp } from './view-app.js';
-export { mountDomainFrontend } from './mount-domain-frontend.js';
-export type { MountedDomainFrontend, MountDomainFrontendOptions } from './mount-domain-frontend.js';
+export { Astrale } from './astrale.js';
+export type { AstraleProps } from './astrale.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,YAAY,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA"}

package/dist/components/index.js

@@ -1,4 +1,3 @@
 export { Can } from './can.js';
 export { ConnectionBoundary, CredentialBoundary, defaultViewError, defaultViewLoading, GraphBoundary, ViewErrorBoundary, ViewBoundary, } from './boundaries.js';
-export { ViewApp } from './view-app.js';
-export { mountDomainFrontend } from './mount-domain-frontend.js';
+export { Astrale } from './astrale.js';

package/dist/index.d.ts

@@ -18,8 +18,8 @@ export type { ExternalOpenApi, HostDialogApi, NotifyApi, OpenViewApi, RequestAcc
 export { HostCapabilityUnavailableError } from './host/index.js';
 export { useEmitIntent, useIntent, useSendIntent } from './intents/index.js';
 export type { EmitIntent, IntentCtx, IntentPayload, IntentReply, SendIntent, } from './intents/index.js';
-export { Can, ConnectionBoundary, CredentialBoundary, defaultViewError, defaultViewLoading, GraphBoundary, mountDomainFrontend, ViewApp, ViewBoundary, ViewErrorBoundary, } from './components/index.js';
-export type { MountedDomainFrontend, MountDomainFrontendOptions, ViewErrorBoundaryProps, } from './components/index.js';
+export { Can, ConnectionBoundary, CredentialBoundary, defaultViewError, defaultViewLoading, GraphBoundary, Astrale, ViewBoundary, ViewErrorBoundary, } from './components/index.js';
+export type { AstraleProps, ViewErrorBoundaryProps } from './components/index.js';
 export { AppHost, AppLogo, useApps, useCurrentSpace, useInstalledDomains, useOpenApp, useSpace, useSpaces, useUser, } from './application/index.js';
 export type { AppHostFallbackState, AppHostProps, AppLogoProps, AppsResult, CurrentSpaceResult, DomainsResult, SpaceResult, SpacesResult, } from './application/index.js';
 export { NodeId } from '@astrale-os/sdk/graph/node';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAG1F,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,QAAQ,GACT,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACxF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACjE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG/D,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,OAAO,EACP,aAAa,EACb,QAAQ,EACR,SAAS,GACV,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,oBAAoB,EACpB,YAAY,EACZ,aAAa,GACd,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,SAAS,EACT,WAAW,GACZ,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GAChB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,IAAI,EACJ,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,aAAa,EACb,UAAU,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,SAAS,EACT,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,WAAW,EACX,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,kBAAkB,EAClB,aAAa,GACd,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnE,YAAY,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAG1E,OAAO,EACL,QAAQ,EACR,SAAS,EACT,aAAa,EACb,aAAa,EACb,aAAa,EACb,WAAW,EACX,SAAS,EACT,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,eAAe,EACf,WAAW,EACX,UAAU,GACX,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,UAAU,EACV,UAAU,EACV,MAAM,EACN,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,WAAW,EACX,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,eAAe,EACf,aAAa,EACb,SAAS,EACT,WAAW,EACX,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC5E,YAAY,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,WAAW,EACX,UAAU,GACX,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EACL,GAAG,EACH,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,OAAO,EACP,YAAY,EACZ,iBAAiB,GAClB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EACL,OAAO,EACP,OAAO,EACP,OAAO,EACP,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,SAAS,EACT,OAAO,GACR,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,YAAY,GACb,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAA;AAC3D,YAAY,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAA;AACtD,YAAY,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAC1D,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AAC5F,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAG3E,YAAY,EACV,eAAe,EACf,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,UAAU,EACV,KAAK,EACL,WAAW,EACX,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,MAAM,GACP,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -15,7 +15,7 @@ export { HostDialog, NestedView, Notify, RequestAccess, useExternalOpen, useHost
 export { HostCapabilityUnavailableError } from './host/index.js';
 export { useEmitIntent, useIntent, useSendIntent } from './intents/index.js';
 // Headless composition kit.
-export { Can, ConnectionBoundary, CredentialBoundary, defaultViewError, defaultViewLoading, GraphBoundary, mountDomainFrontend, ViewApp, ViewBoundary, ViewErrorBoundary, } from './components/index.js';
+export { Can, ConnectionBoundary, CredentialBoundary, defaultViewError, defaultViewLoading, GraphBoundary, Astrale, ViewBoundary, ViewErrorBoundary, } from './components/index.js';
 // Shell application conveniences.
 export { AppHost, AppLogo, useApps, useCurrentSpace, useInstalledDomains, useOpenApp, useSpace, useSpaces, useUser, } from './application/index.js';
 // Canonical identity carriers used by View props and rich hooks.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/shell-react",
-  "version": "0.2.10-beta.2",
+  "version": "0.2.10-beta.3",
   "description": "Astrale shell-react — the React face of the shell (provider, hooks, view components)",
   "license": "Apache-2.0",
   "repository": {
@@ -25,14 +25,19 @@
     "access": "public"
   },
   "dependencies": {
-    "@astrale-os/kernel-client": ">=0.6.0-beta.4 <1.0.0",
-    "@astrale-os/sdk": ">=0.5.0-beta.4 <1.0.0",
     "jose": "^6.2.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@astrale-os/kernel-client": ">=0.6.0-beta.8 <1.0.0",
+    "@astrale-os/kernel-core": ">=0.9.0-beta.7 <1.0.0",
+    "@astrale-os/kernel-dsl": ">=0.2.0-beta.5 <1.0.0",
+    "@astrale-os/kernel-protocol": ">=0.5.0-beta.7 <1.0.0",
+    "@astrale-os/kernel-server": ">=0.5.0-beta.8 <1.0.0",
+    "@astrale-os/sdk": ">=0.5.0-beta.14 <1.0.0",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.3.0",
+    "@types/node": "^26.0.0",
     "@types/react": "^19.2.0",
     "@types/react-dom": "^19.2.0",
     "@typescript/native-preview": "latest",
@@ -43,10 +48,16 @@
     "typescript": "~6.0.1-rc",
     "vite": "^7.3.6",
     "vitest": "^3.2.4",
-    "@astrale-os/shell": "0.3.8-beta.2"
+    "@astrale-os/shell": "0.3.8-beta.3"
   },
   "peerDependencies": {
-    "@astrale-os/shell": ">=0.3.8-beta.2 <1.0.0",
+    "@astrale-os/kernel-client": ">=0.6.0-beta.8 <1.0.0",
+    "@astrale-os/kernel-core": ">=0.9.0-beta.7 <1.0.0",
+    "@astrale-os/kernel-dsl": ">=0.2.0-beta.5 <1.0.0",
+    "@astrale-os/kernel-protocol": ">=0.5.0-beta.7 <1.0.0",
+    "@astrale-os/kernel-server": ">=0.5.0-beta.8 <1.0.0",
+    "@astrale-os/sdk": ">=0.5.0-beta.14 <1.0.0",
+    "@astrale-os/shell": ">=0.3.8-beta.3 <1.0.0",
     "react": ">=18",
     "react-dom": ">=18"
   },

package/src/components/astrale.tsx

@@ -0,0 +1,40 @@
+import type { Shell, ShellConfig } from '@astrale-os/shell'
+import type { ReactElement, ReactNode } from 'react'
+
+import { Suspense } from 'react'
+
+import type { ShellProviderProps } from '../session/provider.js'
+
+import { ShellProvider } from '../session/provider.js'
+import { ViewStage } from '../window/stage.js'
+import { defaultViewError, defaultViewLoading, ViewErrorBoundary } from './boundaries.js'
+
+const SANDBOXED_SHELL = Object.freeze({ mode: 'sandboxed' as const })
+
+export interface AstraleProps {
+  /** Defaults to the child-side sandbox handshake; pass a Shell for an embedded host or test. */
+  readonly config?: ShellConfig | Shell
+  readonly fallback?: ReactNode
+  readonly errorFallback?: ShellProviderProps['errorFallback']
+  readonly onError?: (error: unknown) => void
+  readonly children: ReactNode
+}
+
+/** Complete Astrale runtime root without taking ownership of application routing. */
+export function Astrale(props: AstraleProps): ReactElement {
+  const loading = props.fallback ?? defaultViewLoading()
+  const errorFallback = props.errorFallback ?? defaultViewError
+  return (
+    <ShellProvider
+      config={props.config ?? SANDBOXED_SHELL}
+      fallback={loading}
+      errorFallback={errorFallback}
+      onError={({ error }) => props.onError?.(error)}
+    >
+      <ViewErrorBoundary fallback={errorFallback} onError={props.onError}>
+        <Suspense fallback={loading}>{props.children}</Suspense>
+      </ViewErrorBoundary>
+      <ViewStage />
+    </ShellProvider>
+  )
+}

package/src/components/index.ts

@@ -9,6 +9,5 @@ export {
   ViewBoundary,
 } from './boundaries.js'
 export type { ViewErrorBoundaryProps } from './boundaries.js'
-export { ViewApp } from './view-app.js'
-export { mountDomainFrontend } from './mount-domain-frontend.js'
-export type { MountedDomainFrontend, MountDomainFrontendOptions } from './mount-domain-frontend.js'
+export { Astrale } from './astrale.js'
+export type { AstraleProps } from './astrale.js'

package/src/index.ts

@@ -166,16 +166,11 @@ export {
   defaultViewError,
   defaultViewLoading,
   GraphBoundary,
-  mountDomainFrontend,
-  ViewApp,
+  Astrale,
   ViewBoundary,
   ViewErrorBoundary,
 } from './components/index.js'
-export type {
-  MountedDomainFrontend,
-  MountDomainFrontendOptions,
-  ViewErrorBoundaryProps,
-} from './components/index.js'
+export type { AstraleProps, ViewErrorBoundaryProps } from './components/index.js'
 
 // Shell application conveniences.
 export {

package/dist/components/mount-domain-frontend.d.ts

@@ -1,22 +0,0 @@
-import type { ReactRouteModule } from '@astrale-os/sdk/react';
-import type { schema } from '@astrale-os/sdk/schema';
-import type { Shell, ShellConfig } from '@astrale-os/shell';
-import type { ReactNode } from 'react';
-type ViewName<S extends schema.DomainSchema> = Extract<keyof ReactRouteModule<S>['routes'], string>;
-export interface MountDomainFrontendOptions<S extends schema.DomainSchema, Name extends ViewName<S>> {
-    readonly root: Element | string;
-    readonly module: ReactRouteModule<S>;
-    readonly view: Name;
-    /** Defaults to the child-side sandbox handshake. A prebuilt Shell is the full-app escape hatch. */
-    readonly config?: ShellConfig | Shell;
-    readonly fallback?: ReactNode;
-    readonly errorFallback?: (error: unknown, retry: () => void) => ReactNode;
-    readonly onError?: (error: unknown) => void;
-}
-export interface MountedDomainFrontend {
-    unmount(): void;
-}
-/** Browser bootstrap used by SDK-generated route entries and custom full React apps alike. */
-export declare function mountDomainFrontend<const S extends schema.DomainSchema, const Name extends ViewName<S>>(options: MountDomainFrontendOptions<S, Name>): MountedDomainFrontend;
-export {};
-//# sourceMappingURL=mount-domain-frontend.d.ts.map

package/dist/components/mount-domain-frontend.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mount-domain-frontend.d.ts","sourceRoot":"","sources":["../../src/components/mount-domain-frontend.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAmC,MAAM,uBAAuB,CAAA;AAC9F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAoD,SAAS,EAAE,MAAM,OAAO,CAAA;AAWxF,KAAK,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,YAAY,IAAI,OAAO,CAAC,MAAM,gBAAgB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAA;AAMnG,MAAM,WAAW,0BAA0B,CACzC,CAAC,SAAS,MAAM,CAAC,YAAY,EAC7B,IAAI,SAAS,QAAQ,CAAC,CAAC,CAAC;IAExB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IACpC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,mGAAmG;IACnG,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,KAAK,CAAA;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAA;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAC5C;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,8FAA8F;AAC9F,wBAAgB,mBAAmB,CACjC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,YAAY,EACnC,KAAK,CAAC,IAAI,SAAS,QAAQ,CAAC,CAAC,CAAC,EAC9B,OAAO,EAAE,0BAA0B,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,qBAAqB,CAgCrE"}

package/dist/components/mount-domain-frontend.js

@@ -1,85 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { createElement, lazy, Suspense } from 'react';
-import { createRoot } from 'react-dom/client';
-import { useHistoryVersion, useOptionalNavCtx } from '../navigation/scope.context.js';
-import { useDomain } from '../schema/domain.hook.js';
-import { useTargetPath } from '../window/hooks/target-node.hook.js';
-import { defaultViewError, defaultViewLoading, ViewErrorBoundary } from './boundaries.js';
-import { ViewApp } from './view-app.js';
-/** Browser bootstrap used by SDK-generated route entries and custom full React apps alike. */
-export function mountDomainFrontend(options) {
-    const rootElement = typeof options.root === 'string' ? document.querySelector(options.root) : options.root;
-    if (rootElement === null)
-        throw new Error(`React frontend root '${options.root}' was not found.`);
-    const route = options.module.routes[options.view];
-    if (route === undefined)
-        throw new Error(`React View '${options.view}' is not implemented.`);
-    const loading = options.fallback ?? defaultViewLoading();
-    const errorFallback = options.errorFallback ?? defaultViewError;
-    const routeRuntime = createRouteRuntime();
-    const root = createRoot(rootElement);
-    root.render(_jsx(ViewApp, { config: options.config ?? { mode: 'sandboxed' }, fallback: loading, errorFallback: errorFallback, onError: ({ error }) => options.onError?.(error), children: _jsx(ViewErrorBoundary, { fallback: errorFallback, onError: options.onError, children: (generation) => (_jsx(Suspense, { fallback: loading, children: _jsx(DomainRoute, { module: options.module, name: options.view, generation: generation, runtime: routeRuntime }) })) }) }));
-    return Object.freeze({ unmount: () => root.unmount() });
-}
-function DomainRoute(props) {
-    const domain = useDomain(props.module.schema);
-    const navigation = useOptionalNavCtx();
-    useHistoryVersion(navigation?.history ?? null);
-    const view = domain[props.name];
-    // Domain's schema-indexed conditional retains the exact authored View type,
-    // while the runtime member has Core's common rich Definition shape.
-    const runtimeView = view;
-    const targetPath = useTargetPath();
-    const implementation = props.module.routes[props.name];
-    const Component = props.runtime.component(props.generation, implementation);
-    const declaration = runtimeView.definition;
-    const target = declaration.target.kind === 'domain'
-        ? Object.freeze({ kind: 'domain', origin: runtimeView.origin })
-        : targetPath === null
-            ? missingTarget(runtimeView.name)
-            : targetPath;
-    const current = new URL(window.location.href);
-    const routeParams = navigation?.history.current?.params ?? directRouteParams(current);
-    const route = Object.freeze({
-        name: props.name,
-        href: current.href,
-        params: Object.freeze({ ...routeParams }),
-    });
-    return createElement(Component, { view, target, route });
-}
-function directRouteParams(url) {
-    const params = {};
-    const prefix = 'astrale.param.';
-    for (const key of new Set(url.searchParams.keys())) {
-        if (!key.startsWith(prefix))
-            continue;
-        const name = key.slice(prefix.length);
-        if (name.length === 0 || /token|credential|authorization|secret/i.test(name)) {
-            throw new TypeError(`React View route param '${name}' is invalid.`);
-        }
-        const values = url.searchParams.getAll(key);
-        if (values.length !== 1)
-            throw new TypeError(`React View route param '${name}' is duplicated.`);
-        params[name] = values[0];
-    }
-    return Object.freeze(params);
-}
-function createRouteRuntime() {
-    const generations = new Map();
-    return {
-        component(generation, implementation) {
-            let Component = generations.get(generation);
-            if (Component === undefined) {
-                Component = lazy(async () => {
-                    const loaded = await implementation.component();
-                    return { default: loaded.default };
-                });
-                generations.set(generation, Component);
-            }
-            return Component;
-        },
-    };
-}
-function missingTarget(name) {
-    throw new Error(`React View '${name}' requires a resource target from the Shell handshake.`);
-}

package/dist/components/view-app.d.ts

@@ -1,16 +0,0 @@
-import type { Shell, ShellConfig } from '@astrale-os/shell';
-import type { ReactElement, ReactNode } from 'react';
-import type { NavAdapter } from '../navigation/adapters/adapter.js';
-import type { NavTarget } from '../navigation/snapshot.js';
-import type { ShellProviderProps } from '../session/provider.js';
-/** One generated/default root; custom React apps may compose the lower-level providers directly. */
-export declare function ViewApp(props: {
-    readonly config: ShellConfig | Shell;
-    readonly navigation?: NavAdapter;
-    readonly initial?: NavTarget;
-    readonly fallback?: ReactNode;
-    readonly errorFallback?: ShellProviderProps['errorFallback'];
-    readonly onError?: ShellProviderProps['onError'];
-    readonly children: ReactNode;
-}): ReactElement;
-//# sourceMappingURL=view-app.d.ts.map

package/dist/components/view-app.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"view-app.d.ts","sourceRoot":"","sources":["../../src/components/view-app.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAShE,oGAAoG;AACpG,wBAAgB,OAAO,CAAC,KAAK,EAAE;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAAA;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAA;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAA;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAA;IAChD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;CAC7B,GAAG,YAAY,CAWf"}

package/dist/components/view-app.js

@@ -1,16 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { memoryAdapter } from '../navigation/adapters/memory.adapter.js';
-import { urlAdapter } from '../navigation/adapters/url.adapter.js';
-import { NavScope } from '../navigation/scope.context.js';
-import { ShellProvider } from '../session/provider.js';
-import { useShell } from '../session/shell.hook.js';
-import { ViewStage } from '../window/stage.js';
-/** One generated/default root; custom React apps may compose the lower-level providers directly. */
-export function ViewApp(props) {
-    return (_jsx(ShellProvider, { config: props.config, fallback: props.fallback, errorFallback: props.errorFallback, onError: props.onError, children: _jsx(ViewAppRuntime, { ...props }) }));
-}
-function ViewAppRuntime(props) {
-    const shell = useShell();
-    const defaultAdapter = shell.hostCapabilities.navigation.history === 'browser' ? urlAdapter() : memoryAdapter();
-    return (_jsxs(NavScope, { adapter: props.navigation ?? defaultAdapter, initial: props.initial, children: [props.children, _jsx(ViewStage, {})] }));
-}

package/src/components/mount-domain-frontend.tsx

@@ -1,158 +0,0 @@
-import type { Domain, Definition } from '@astrale-os/sdk/domain'
-import type { ReactRouteModule, ReactViewModule, ReactViewProps } from '@astrale-os/sdk/react'
-import type { schema } from '@astrale-os/sdk/schema'
-import type { Shell, ShellConfig } from '@astrale-os/shell'
-import type { ComponentType, LazyExoticComponent, ReactElement, ReactNode } from 'react'
-
-import { createElement, lazy, Suspense } from 'react'
-import { createRoot } from 'react-dom/client'
-
-import { useHistoryVersion, useOptionalNavCtx } from '../navigation/scope.context.js'
-import { useDomain } from '../schema/domain.hook.js'
-import { useTargetPath } from '../window/hooks/target-node.hook.js'
-import { defaultViewError, defaultViewLoading, ViewErrorBoundary } from './boundaries.js'
-import { ViewApp } from './view-app.js'
-
-type ViewName<S extends schema.DomainSchema> = Extract<keyof ReactRouteModule<S>['routes'], string>
-type ViewOf<S extends schema.DomainSchema, Name extends ViewName<S>> = Extract<
-  Domain<S>[Name],
-  Definition<'view'>
->
-
-export interface MountDomainFrontendOptions<
-  S extends schema.DomainSchema,
-  Name extends ViewName<S>,
-> {
-  readonly root: Element | string
-  readonly module: ReactRouteModule<S>
-  readonly view: Name
-  /** Defaults to the child-side sandbox handshake. A prebuilt Shell is the full-app escape hatch. */
-  readonly config?: ShellConfig | Shell
-  readonly fallback?: ReactNode
-  readonly errorFallback?: (error: unknown, retry: () => void) => ReactNode
-  readonly onError?: (error: unknown) => void
-}
-
-export interface MountedDomainFrontend {
-  unmount(): void
-}
-
-/** Browser bootstrap used by SDK-generated route entries and custom full React apps alike. */
-export function mountDomainFrontend<
-  const S extends schema.DomainSchema,
-  const Name extends ViewName<S>,
->(options: MountDomainFrontendOptions<S, Name>): MountedDomainFrontend {
-  const rootElement =
-    typeof options.root === 'string' ? document.querySelector(options.root) : options.root
-  if (rootElement === null) throw new Error(`React frontend root '${options.root}' was not found.`)
-  const route = options.module.routes[options.view]
-  if (route === undefined) throw new Error(`React View '${options.view}' is not implemented.`)
-  const loading = options.fallback ?? defaultViewLoading()
-  const errorFallback = options.errorFallback ?? defaultViewError
-  const routeRuntime = createRouteRuntime()
-  const root = createRoot(rootElement)
-  root.render(
-    <ViewApp
-      config={options.config ?? { mode: 'sandboxed' }}
-      fallback={loading}
-      errorFallback={errorFallback}
-      onError={({ error }) => options.onError?.(error)}
-    >
-      <ViewErrorBoundary fallback={errorFallback} onError={options.onError}>
-        {(generation) => (
-          <Suspense fallback={loading}>
-            <DomainRoute
-              module={options.module}
-              name={options.view}
-              generation={generation}
-              runtime={routeRuntime}
-            />
-          </Suspense>
-        )}
-      </ViewErrorBoundary>
-    </ViewApp>,
-  )
-  return Object.freeze({ unmount: () => root.unmount() })
-}
-
-function DomainRoute<S extends schema.DomainSchema, Name extends ViewName<S>>(props: {
-  readonly module: ReactRouteModule<S>
-  readonly name: Name
-  readonly generation: number
-  readonly runtime: RouteRuntime
-}): ReactElement {
-  const domain = useDomain(props.module.schema)
-  const navigation = useOptionalNavCtx()
-  useHistoryVersion(navigation?.history ?? null)
-  const view = domain[props.name] as ViewOf<S, Name>
-  // Domain's schema-indexed conditional retains the exact authored View type,
-  // while the runtime member has Core's common rich Definition shape.
-  const runtimeView = view as unknown as Definition<'view'>
-  const targetPath = useTargetPath()
-  const implementation = props.module.routes[props.name]!
-  const Component = props.runtime.component<ViewOf<S, Name>>(props.generation, implementation)
-  const declaration = runtimeView.definition as { readonly target: { readonly kind: string } }
-  const target =
-    declaration.target.kind === 'domain'
-      ? Object.freeze({ kind: 'domain' as const, origin: runtimeView.origin })
-      : targetPath === null
-        ? missingTarget(runtimeView.name)
-        : targetPath
-  const current = new URL(window.location.href)
-  const routeParams = navigation?.history.current?.params ?? directRouteParams(current)
-  const route = Object.freeze({
-    name: props.name,
-    href: current.href,
-    params: Object.freeze({ ...routeParams }),
-  })
-  return createElement(Component, { view, target, route } as unknown as ReactViewProps<
-    ViewOf<S, Name>
-  >)
-}
-
-function directRouteParams(url: URL): Readonly<Record<string, string>> {
-  const params: Record<string, string> = {}
-  const prefix = 'astrale.param.'
-  for (const key of new Set(url.searchParams.keys())) {
-    if (!key.startsWith(prefix)) continue
-    const name = key.slice(prefix.length)
-    if (name.length === 0 || /token|credential|authorization|secret/i.test(name)) {
-      throw new TypeError(`React View route param '${name}' is invalid.`)
-    }
-    const values = url.searchParams.getAll(key)
-    if (values.length !== 1) throw new TypeError(`React View route param '${name}' is duplicated.`)
-    params[name] = values[0]!
-  }
-  return Object.freeze(params)
-}
-
-interface RouteRuntime {
-  component<View extends Definition<'view'>>(
-    generation: number,
-    implementation: { readonly component: () => Promise<ReactViewModule<View>> },
-  ): ComponentType<ReactViewProps<View>>
-}
-
-function createRouteRuntime(): RouteRuntime {
-  const generations = new Map<number, LazyExoticComponent<ComponentType<ReactViewProps<never>>>>()
-  return {
-    component<View extends Definition<'view'>>(
-      generation: number,
-      implementation: { readonly component: () => Promise<ReactViewModule<View>> },
-    ): ComponentType<ReactViewProps<View>> {
-      let Component = generations.get(generation)
-      if (Component === undefined) {
-        Component = lazy(async () => {
-          const loaded = await implementation.component()
-          return { default: loaded.default as ComponentType<ReactViewProps<never>> }
-        })
-        generations.set(generation, Component)
-      }
-      return Component as unknown as ComponentType<ReactViewProps<View>>
-    },
-  }
-}
-
-function missingTarget(name: string): never {
-  throw new Error(`React View '${name}' requires a resource target from the Shell handshake.`)
-}

package/src/components/view-app.tsx

@@ -1,49 +0,0 @@
-import type { Shell, ShellConfig } from '@astrale-os/shell'
-import type { ReactElement, ReactNode } from 'react'
-
-import type { NavAdapter } from '../navigation/adapters/adapter.js'
-import type { NavTarget } from '../navigation/snapshot.js'
-import type { ShellProviderProps } from '../session/provider.js'
-
-import { memoryAdapter } from '../navigation/adapters/memory.adapter.js'
-import { urlAdapter } from '../navigation/adapters/url.adapter.js'
-import { NavScope } from '../navigation/scope.context.js'
-import { ShellProvider } from '../session/provider.js'
-import { useShell } from '../session/shell.hook.js'
-import { ViewStage } from '../window/stage.js'
-
-/** One generated/default root; custom React apps may compose the lower-level providers directly. */
-export function ViewApp(props: {
-  readonly config: ShellConfig | Shell
-  readonly navigation?: NavAdapter
-  readonly initial?: NavTarget
-  readonly fallback?: ReactNode
-  readonly errorFallback?: ShellProviderProps['errorFallback']
-  readonly onError?: ShellProviderProps['onError']
-  readonly children: ReactNode
-}): ReactElement {
-  return (
-    <ShellProvider
-      config={props.config}
-      fallback={props.fallback}
-      errorFallback={props.errorFallback}
-      onError={props.onError}
-    >
-      <ViewAppRuntime {...props} />
-    </ShellProvider>
-  )
-}
-
-function ViewAppRuntime(
-  props: Omit<Parameters<typeof ViewApp>[0], 'config' | 'fallback'>,
-): ReactElement {
-  const shell = useShell()
-  const defaultAdapter =
-    shell.hostCapabilities.navigation.history === 'browser' ? urlAdapter() : memoryAdapter()
-  return (
-    <NavScope adapter={props.navigation ?? defaultAdapter} initial={props.initial}>
-      {props.children}
-      <ViewStage />
-    </NavScope>
-  )
-}