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

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/application/apps/domains.hook.ts

@@ -1,37 +0,0 @@
-import type { DomainSearchResult } from '@astrale-os/shell'
-
-import { useMemo } from 'react'
-
-import type { ReadState } from '../../graph/memory/read/envelope.js'
-
-import { useAsyncResource } from '../../graph/async.js'
-import { useShell } from '../../session/shell.hook.js'
-import { isOsPlaneAvailable } from '../user/user.store.js'
-
-const NO_DOMAINS: readonly DomainSearchResult[] = []
-
-export interface DomainsResult extends ReadState {
-  readonly domains: readonly DomainSearchResult[]
-}
-
-export function useInstalledDomains(): DomainsResult {
-  const shell = useShell()
-  const available = isOsPlaneAvailable(shell)
-  const result = useAsyncResource<readonly DomainSearchResult[]>(
-    available ? () => shell.apps.searchDomains() : null,
-    NO_DOMAINS,
-    [shell, available],
-  )
-
-  return useMemo(
-    () => ({
-      domains: result.data,
-      pending: result.pending,
-      error: result.error,
-      live: false,
-      seq: 0,
-      refetch: result.refetch,
-    }),
-    [result],
-  )
-}

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>
-  )
-}