@astrale-os/shell-react 0.2.0 → 0.2.1

package/src/navigation/link.tsx

@@ -16,10 +16,10 @@ import type {
  */
 import { useCallback, useEffect } from 'react'
 
-import type { NavTarget } from './snapshot'
+import type { NavTarget } from './snapshot.js'
 
-import { useNavCtx } from './scope.context'
-import { serializeTarget } from './snapshot'
+import { useNavCtx } from './scope.context.js'
+import { serializeTarget } from './snapshot.js'
 
 export interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
   to: NavTarget

package/src/navigation/location.ts

@@ -9,7 +9,7 @@ import { rawOf } from '@astrale-os/kernel-client/graph'
  */
 import { useEffect, useRef } from 'react'
 
-import type { SerializedLocation } from './history'
+import type { SerializedLocation } from './history.js'
 
 /**
  * The rich graph `Node`, derived from the memory's read envelope — kernel-client

package/src/navigation/scope.context.tsx

@@ -20,16 +20,16 @@ import {
   useSyncExternalStore,
 } from 'react'
 
-import type { NavAdapter } from './adapters/adapter'
-import type { NavSnapshot, SerializedLocation } from './history'
-import type { NavLocation } from './location'
-import type { NavTarget } from './snapshot'
+import type { NavAdapter } from './adapters/adapter.js'
+import type { NavSnapshot, SerializedLocation } from './history.js'
+import type { NavLocation } from './location.js'
+import type { NavTarget } from './snapshot.js'
 
-import { useMemory } from '../graph/memory/scope'
-import { memoryAdapter } from './adapters/memory.adapter'
-import { NavHistory, seedEntries } from './history'
-import { buildLocation, parentPath, pathHint, pathOf, useSettled } from './location'
-import { revalidateAndPrune, serializeTarget } from './snapshot'
+import { useMemory } from '../graph/memory/scope.js'
+import { memoryAdapter } from './adapters/memory.adapter.js'
+import { NavHistory, seedEntries } from './history.js'
+import { buildLocation, parentPath, pathHint, pathOf, useSettled } from './location.js'
+import { revalidateAndPrune, serializeTarget } from './snapshot.js'
 
 /** The imperative navigation surface (API §8.2). */
 export interface Navigate {

package/src/navigation/snapshot.ts

@@ -9,9 +9,9 @@ import type { GraphMemory } from '@astrale-os/kernel-client/store'
  */
 import { normalizeRef } from '@astrale-os/kernel-client'
 
-import type { NavHistory } from './history'
-import type { SerializedLocation } from './history'
-import type { Node, NodeId } from './location'
+import type { NavHistory } from './history.js'
+import type { SerializedLocation } from './history.js'
+import type { Node, NodeId } from './location.js'
 
 /** Everything `navigate()` / `Link` / `initial` accept (API §8.1). */
 export type NavTarget =

package/src/schema/bind-read.ts

@@ -29,14 +29,14 @@ import { compileDomain } from '@astrale-os/kernel-core/domain'
  */
 import { useCallback, useMemo, useRef, useSyncExternalStore } from 'react'
 
-import type { ReadState, ReadOptions } from '../graph/memory/read/envelope'
-import type { TypedChildrenResult, TypedNodeResult } from './types'
+import type { ReadState, ReadOptions } from '../graph/memory/read/envelope.js'
+import type { TypedChildrenResult, TypedNodeResult } from './types.js'
 
-import { useSessionKernel } from '../auth/session-kernel'
-import { idleReadState, isIdleInput } from '../graph/memory/read/idle'
-import { useMemory } from '../graph/memory/scope'
-import { bindingFor } from './binding'
-import { schemaOf, tagSchema } from './tag'
+import { useSessionKernel } from '../auth/session-kernel.js'
+import { idleReadState, isIdleInput } from '../graph/memory/read/idle.js'
+import { useMemory } from '../graph/memory/scope.js'
+import { bindingFor } from './binding.js'
+import { schemaOf, tagSchema } from './tag.js'
 
 // ── binder hooks ────────────────────────────────────────────────────────────────
 

package/src/schema/binding.ts

@@ -13,10 +13,10 @@ import type { Schema } from '@astrale-os/kernel-dsl'
 
 import { createSchemaBoundView } from '@astrale-os/kernel-client'
 
-import type { SessionView } from '../auth/act-as.context'
+import type { SessionView } from '../auth/act-as.context.js'
 
-import { tagSchema } from './tag'
-import { recordPath, writableFor } from './write'
+import { tagSchema } from './tag.js'
+import { recordPath, writableFor } from './write.js'
 
 type AnyBinding = SchemaBoundView<Schema, FnMap>
 

package/src/schema/domain.hook.ts

@@ -6,9 +6,9 @@
 import type { FnMap, SchemaBoundView } from '@astrale-os/kernel-client'
 import type { Schema } from '@astrale-os/kernel-dsl'
 
-import { useSessionKernel } from '../auth/session-kernel'
-import { useMemory } from '../graph/memory/scope'
-import { bindingFor } from './binding'
+import { useSessionKernel } from '../auth/session-kernel.js'
+import { useMemory } from '../graph/memory/scope.js'
+import { bindingFor } from './binding.js'
 
 /** The typed domain binding — `kernel.withSchema(schema)`, memoized per (session, schema). */
 export function useDomain<S extends Schema>(schema: S): SchemaBoundView<S, FnMap> {

package/src/schema/function.hook.ts

@@ -9,11 +9,11 @@ import { compileDomain } from '@astrale-os/kernel-core/domain'
  */
 import { useCallback, useMemo, useRef } from 'react'
 
-import type { Action } from '../graph/action'
-import type { FunctionNames, FunctionParams, FunctionResult } from './types'
+import type { Action } from '../graph/action.js'
+import type { FunctionNames, FunctionParams, FunctionResult } from './types.js'
 
-import { useAction } from '../graph/action'
-import { useDomain } from './domain.hook'
+import { useAction } from '../graph/action.js'
+import { useDomain } from './domain.hook.js'
 
 export interface FunctionOptions {
   /** Extra failure channel; the action still rejects and records `.error`. */

package/src/schema/index.ts

@@ -1,13 +1,19 @@
 // schema — the typing substrate (API §6). Typed kernel/domain bindings, typed
 // reads, method/function dispatch. See SHELL_REACT_API.md.
-export { useKernel } from './kernel.hook'
-export { useDomain } from './domain.hook'
-export { useNode, useChildren, useBoundNode, useBoundNodes, useBoundEndpoints } from './bind-read'
-export { useOut, useIn } from '../graph/query/neighbors.hook'
-export { useMethod } from './method.hook'
-export type { MethodOptions } from './method.hook'
-export { useFunction } from './function.hook'
-export type { FunctionOptions } from './function.hook'
+export { useKernel } from './kernel.hook.js'
+export { useDomain } from './domain.hook.js'
+export {
+  useNode,
+  useChildren,
+  useBoundNode,
+  useBoundNodes,
+  useBoundEndpoints,
+} from './bind-read.js'
+export { useOut, useIn } from '../graph/query/neighbors.hook.js'
+export { useMethod } from './method.hook.js'
+export type { MethodOptions } from './method.hook.js'
+export { useFunction } from './function.hook.js'
+export type { FunctionOptions } from './function.hook.js'
 export type {
   AutoMethodAction,
   BoundMethodAction,
@@ -22,4 +28,4 @@ export type {
   TargetedMethodAction,
   TypedChildrenResult,
   TypedNodeResult,
-} from './types'
+} from './types.js'

package/src/schema/kernel.hook.ts

@@ -7,9 +7,9 @@ import type { FnMap, SchemaBoundView } from '@astrale-os/kernel-client'
 
 import { KernelSchema } from '@astrale-os/kernel-core'
 
-import { useSessionKernel } from '../auth/session-kernel'
-import { useMemory } from '../graph/memory/scope'
-import { bindingFor } from './binding'
+import { useSessionKernel } from '../auth/session-kernel.js'
+import { useMemory } from '../graph/memory/scope.js'
+import { bindingFor } from './binding.js'
 
 /** The typed kernel — `kernel.withSchema(KernelSchema)`, memoized (§4-scoped). */
 export function useKernel(): SchemaBoundView<typeof KernelSchema, FnMap> {

package/src/schema/method.hook.ts

@@ -12,11 +12,11 @@ import { resolveAllMethods } from '@astrale-os/kernel-dsl'
  */
 import { useCallback, useMemo, useRef } from 'react'
 
-import type { Action } from '../graph/action'
-import type { AutoMethodAction, BoundMethodAction, MethodNames } from './types'
+import type { Action } from '../graph/action.js'
+import type { AutoMethodAction, BoundMethodAction, MethodNames } from './types.js'
 
-import { useAction } from '../graph/action'
-import { useDomain } from './domain.hook'
+import { useAction } from '../graph/action.js'
+import { useDomain } from './domain.hook.js'
 
 export interface MethodOptions {
   /** Bind the action to this node — dispatch as `action(params)`. */

package/src/schema/types.ts

@@ -23,8 +23,8 @@ import type {
   Schema,
 } from '@astrale-os/kernel-dsl'
 
-import type { Action } from '../graph/action'
-import type { ReadState, Windowed } from '../graph/memory/read/envelope'
+import type { Action } from '../graph/action.js'
+import type { ReadState, Windowed } from '../graph/memory/read/envelope.js'
 
 // ── Read envelopes ──────────────────────────────────────────────────────────────
 

package/src/schema/write.ts

@@ -10,7 +10,7 @@ import type { CredentialInput } from '@astrale-os/kernel-client'
 import type { PathLike, Properties } from '@astrale-os/kernel-client/graph'
 import type { GraphMemory } from '@astrale-os/kernel-client/store'
 
-import type { SessionView } from '../auth/act-as.context'
+import type { SessionView } from '../auth/act-as.context.js'
 
 /**
  * One memory-backed writable kernel per (effective) session view, plus the

package/src/selection/index.ts

@@ -1,5 +1,5 @@
 // selection — API §9. SelectionScope + useSelection: an insertion-ordered id set
 // with an anchor, projected to LIVE memory nodes.
-export { SelectionScope } from './scope.context'
-export type { Selection, SelectionScopeProps } from './scope.context'
-export { useSelection } from './selection.hook'
+export { SelectionScope } from './scope.context.js'
+export type { Selection, SelectionScopeProps } from './scope.context.js'
+export { useSelection } from './selection.hook.js'

package/src/selection/live.ts

@@ -10,7 +10,7 @@ import type { GraphMemory, ReadOptions, ShapeInput } from '@astrale-os/kernel-cl
  */
 import { useCallback, useContext, useRef, useSyncExternalStore } from 'react'
 
-import { GraphContext } from '../graph/graph.context'
+import { GraphContext } from '../graph/graph.context.js'
 
 /** A live memory node — the non-null projection of a point read. */
 export type SelectionNode = NonNullable<ReturnType<GraphMemory['getSnapshot']>['node']>

package/src/selection/scope.context.tsx

@@ -8,9 +8,9 @@ import type { ReactElement, ReactNode } from 'react'
  */
 import { createContext, useCallback, useEffect, useMemo, useReducer, useRef } from 'react'
 
-import type { NodeId, SelectionNode } from './live'
+import type { NodeId, SelectionNode } from './live.js'
 
-import { useLiveNodes, useMemory } from './live'
+import { useLiveNodes, useMemory } from './live.js'
 
 /** The value `useSelection()` returns (API §9). */
 export interface Selection {

package/src/selection/selection.hook.ts

@@ -4,9 +4,9 @@
  */
 import { useContext } from 'react'
 
-import type { Selection } from './scope.context'
+import type { Selection } from './scope.context.js'
 
-import { SelectionContext } from './scope.context'
+import { SelectionContext } from './scope.context.js'
 
 /** The nearest selection scope. Throws outside a `<SelectionScope>`. */
 export function useSelection(): Selection {

package/src/session/boot/boot.ts

@@ -5,7 +5,7 @@
  */
 import type { Shell, ShellConfig } from '@astrale-os/shell'
 
-import type { SelfNode } from '../session.context'
+import type { SelfNode } from '../session.context.js'
 
 export function isShellConfig(config: ShellConfig | Shell): config is ShellConfig {
   return 'mode' in config

package/src/session/boot/status.ts

@@ -3,7 +3,7 @@
  * `connecting → ready` (with the resolved runtime) or `connecting → error`. The
  * reducer is the single transition table children render behind.
  */
-import type { ShellRuntime } from '../session.context'
+import type { ShellRuntime } from '../session.context.js'
 
 export type BootStatus = 'connecting' | 'ready' | 'error'
 

package/src/session/connection/connection.hook.ts

@@ -5,10 +5,10 @@
  */
 import { useSyncExternalStore } from 'react'
 
-import type { ConnectionValue } from './connection.store'
+import type { ConnectionValue } from './connection.store.js'
 
-import { useShell } from '../shell.hook'
-import { connectionStore } from './connection.store'
+import { useShell } from '../shell.hook.js'
+import { connectionStore } from './connection.store.js'
 
 export function useConnection(): ConnectionValue {
   const store = connectionStore(useShell())

package/src/session/index.ts

@@ -1,8 +1,8 @@
 // session — API §2 (provider) + §3 (session hooks). See SHELL_REACT_API.md.
-export { ShellProvider } from './provider'
-export type { ShellError, ShellProviderProps } from './provider'
-export { useShell } from './shell.hook'
-export { useKernelClient } from './kernel-client.hook'
-export { useKernelInstance } from './kernel-instance.hook'
-export type { KernelInstance } from './kernel-instance.hook'
-export { useConnection } from './connection/connection.hook'
+export { ShellProvider } from './provider.js'
+export type { ShellError, ShellProviderProps } from './provider.js'
+export { useShell } from './shell.hook.js'
+export { useKernelClient } from './kernel-client.hook.js'
+export { useKernelInstance } from './kernel-instance.hook.js'
+export type { KernelInstance } from './kernel-instance.hook.js'
+export { useConnection } from './connection/connection.hook.js'

package/src/session/kernel-client.hook.ts

@@ -5,7 +5,7 @@
  */
 import type { KernelClient } from '@astrale-os/shell'
 
-import { useShell } from './shell.hook'
+import { useShell } from './shell.hook.js'
 
 /** `shell.kernel` — the raw bound kernel view, untouched (untyped floor). */
 export function useKernelClient(): KernelClient {

package/src/session/kernel-instance.hook.ts

@@ -1,6 +1,6 @@
 import { useMemo } from 'react'
 
-import { useKernelClient } from './kernel-client.hook'
+import { useKernelClient } from './kernel-client.hook.js'
 
 export interface KernelInstance {
   /** Kernel envelope endpoint this shell is bound to. */

package/src/session/provider.tsx

@@ -13,18 +13,18 @@ import { createShell } from '@astrale-os/shell'
  */
 import { useCallback, useEffect, useMemo, useReducer, useRef, useState } from 'react'
 
-import type { GraphMemory } from '../graph/graph.context'
-import type { BootRef } from './boot/ownership'
-import type { SelfNode } from './session.context'
-
-import { primeUser } from '../application/user/user.store'
-import { GraphContext } from '../graph/graph.context'
-import { baseMemoryFor, setMemoryErrorSink } from '../graph/memory/base'
-import { configIdentity, isShellConfig, resolveSelf } from './boot/boot'
-import { cancelTeardown, disposeShell, scheduleTeardown } from './boot/ownership'
-import { bootReducer, INITIAL_BOOT } from './boot/status'
-import { connectionStore } from './connection/connection.store'
-import { ShellContext } from './session.context'
+import type { GraphMemory } from '../graph/graph.context.js'
+import type { BootRef } from './boot/ownership.js'
+import type { SelfNode } from './session.context.js'
+
+import { primeUser } from '../application/user/user.store.js'
+import { GraphContext } from '../graph/graph.context.js'
+import { baseMemoryFor, setMemoryErrorSink } from '../graph/memory/base.js'
+import { configIdentity, isShellConfig, resolveSelf } from './boot/boot.js'
+import { cancelTeardown, disposeShell, scheduleTeardown } from './boot/ownership.js'
+import { bootReducer, INITIAL_BOOT } from './boot/status.js'
+import { connectionStore } from './connection/connection.store.js'
+import { ShellContext } from './session.context.js'
 
 /** Global error channel payload (API §2). */
 export type ShellError =

package/src/session/shell.hook.ts

@@ -7,7 +7,7 @@ import type { Shell } from '@astrale-os/shell'
  */
 import { useContext } from 'react'
 
-import { ShellContext } from './session.context'
+import { ShellContext } from './session.context.js'
 
 /** The live shell for this subtree. Throws outside a `<ShellProvider>`. */
 export function useShell(): Shell {

package/src/window/adopt.ts

@@ -6,8 +6,8 @@
  */
 import type { Window } from '@astrale-os/shell'
 
-import type { WindowState } from './lifecycle/states'
-import type { StageSlot } from './placement'
+import type { WindowState } from './lifecycle/states.js'
+import type { StageSlot } from './placement.js'
 
 export interface AdoptRecord {
   readonly windowId: string

package/src/window/hooks/close-guard.hook.ts

@@ -9,7 +9,7 @@ import type { Shell } from '@astrale-os/shell'
  */
 import { useEffect, useRef } from 'react'
 
-import { useShell } from '../../session/shell.hook'
+import { useShell } from '../../session/shell.hook.js'
 
 export type CloseVerdict = 'ack' | 'refuse' | { readonly refuse: string }
 export type CloseGuard = () => CloseVerdict | Promise<CloseVerdict>

package/src/window/hooks/target-node.hook.ts

@@ -11,11 +11,11 @@ import type { KernelClient } from '@astrale-os/shell'
  */
 import { useCallback, useEffect, useRef, useState } from 'react'
 
-import type { ReadState } from '../../graph/memory/read/envelope'
-import type { Node } from '../lifecycle/mount'
+import type { ReadState } from '../../graph/memory/read/envelope.js'
+import type { Node } from '../lifecycle/mount.js'
 
-import { idleReadState } from '../../graph/memory/read/idle'
-import { useShell } from '../../session/shell.hook'
+import { idleReadState } from '../../graph/memory/read/idle.js'
+import { useShell } from '../../session/shell.hook.js'
 
 export interface NodeResult extends ReadState {
   readonly node: Node | null

package/src/window/hooks/views-for.hook.ts

@@ -9,11 +9,11 @@ import { K } from '@astrale-os/kernel-core'
  */
 import { useMemo } from 'react'
 
-import type { ReadState } from '../../graph/memory/read/envelope'
-import type { Node, ViewDescriptor } from '../lifecycle/mount'
+import type { ReadState } from '../../graph/memory/read/envelope.js'
+import type { Node, ViewDescriptor } from '../lifecycle/mount.js'
 
-import { useAsyncResource } from '../../graph/async'
-import { useKernelClient } from '../../session/kernel-client.hook'
+import { useAsyncResource } from '../../graph/async.js'
+import { useKernelClient } from '../../session/kernel-client.hook.js'
 
 export interface ViewsForResult extends ReadState {
   readonly views: readonly ViewDescriptor[]

package/src/window/hooks/window.hook.ts

@@ -4,10 +4,10 @@
  */
 import { useMemo, useSyncExternalStore } from 'react'
 
-import type { WindowView } from '../hub'
+import type { WindowView } from '../hub.js'
 
-import { useShell } from '../../session/shell.hook'
-import { getStageHub } from '../hub'
+import { useShell } from '../../session/shell.hook.js'
+import { getStageHub } from '../hub.js'
 
 /** One window's live phase + shell `Window` (null id / unknown id → no window). */
 export function useWindow(windowId: string | null): WindowView {

package/src/window/hooks/windows.hook.ts

@@ -9,8 +9,8 @@ import type { Window } from '@astrale-os/shell'
  */
 import { useMemo, useSyncExternalStore } from 'react'
 
-import { useShell } from '../../session/shell.hook'
-import { getStageHub } from '../hub'
+import { useShell } from '../../session/shell.hook.js'
+import { getStageHub } from '../hub.js'
 
 /** Every host-mounted window in this shell's tree, keyed by windowId. Reactive. */
 export function useWindows(): ReadonlyMap<string, Window> {

package/src/window/host.tsx

@@ -27,21 +27,21 @@ import {
   useState,
 } from 'react'
 
-import type { AdoptRecord } from './adopt'
-import type { ViewSource } from './lifecycle/mount'
-import type { WindowState } from './lifecycle/states'
-import type { SlotRect, StageController, StageSlot } from './placement'
+import type { AdoptRecord } from './adopt.js'
+import type { ViewSource } from './lifecycle/mount.js'
+import type { WindowState } from './lifecycle/states.js'
+import type { SlotRect, StageController, StageSlot } from './placement.js'
 
-import { useShell } from '../session/shell.hook'
-import { getStageHub } from './hub'
+import { useShell } from '../session/shell.hook.js'
+import { getStageHub } from './hub.js'
 import {
   isFallbackableHandshakeError,
   refToId,
   resolveSource,
   sendSetTarget,
   sourceKey,
-} from './lifecycle/mount'
-import { rectOf, sameRect } from './placement'
+} from './lifecycle/mount.js'
+import { rectOf, sameRect } from './placement.js'
 
 /** Imperative handle on a mounted `ViewHost` (API §10). */
 export interface ViewHostHandle {

package/src/window/hub.ts

@@ -7,11 +7,11 @@
  */
 import type { Shell, Window } from '@astrale-os/shell'
 
-import type { AdoptRecord } from './adopt'
-import type { WindowState } from './lifecycle/states'
-import type { StageController } from './placement'
+import type { AdoptRecord } from './adopt.js'
+import type { WindowState } from './lifecycle/states.js'
+import type { StageController } from './placement.js'
 
-import { createAdoptStash } from './adopt'
+import { createAdoptStash } from './adopt.js'
 
 // ── Window registry (reactive store behind useWindows/useWindow) ─────────────
 

package/src/window/index.ts

@@ -1,17 +1,17 @@
 // window — API §10. ViewStage/ViewHost (the physical iframe-slot layer + a host
 // that projects placement into a slot), the reactive window hooks, the child-side
 // target-node + close-guard, and the (G5) view-resolution hook.
-export { ViewStage } from './stage'
-export { ViewHost } from './host'
-export type { ViewHostProps, ViewHostHandle } from './host'
-export { useWindows, useWindowList } from './hooks/windows.hook'
-export type { WindowListEntry } from './hooks/windows.hook'
-export { useWindow } from './hooks/window.hook'
-export type { WindowView } from './hub'
-export { useViewsFor } from './hooks/views-for.hook'
-export type { ViewsForResult } from './hooks/views-for.hook'
-export { useTargetNode } from './hooks/target-node.hook'
-export { useCloseGuard } from './hooks/close-guard.hook'
-export type { CloseGuard, CloseVerdict } from './hooks/close-guard.hook'
-export type { ViewDescriptor, ViewSource, Node } from './lifecycle/mount'
-export type { WindowState } from './lifecycle/states'
+export { ViewStage } from './stage.js'
+export { ViewHost } from './host.js'
+export type { ViewHostProps, ViewHostHandle } from './host.js'
+export { useWindows, useWindowList } from './hooks/windows.hook.js'
+export type { WindowListEntry } from './hooks/windows.hook.js'
+export { useWindow } from './hooks/window.hook.js'
+export type { WindowView } from './hub.js'
+export { useViewsFor } from './hooks/views-for.hook.js'
+export type { ViewsForResult } from './hooks/views-for.hook.js'
+export { useTargetNode } from './hooks/target-node.hook.js'
+export { useCloseGuard } from './hooks/close-guard.hook.js'
+export type { CloseGuard, CloseVerdict } from './hooks/close-guard.hook.js'
+export type { ViewDescriptor, ViewSource, Node } from './lifecycle/mount.js'
+export type { WindowState } from './lifecycle/states.js'

package/src/window/stage.tsx

@@ -9,9 +9,9 @@ import type { CSSProperties, ReactElement } from 'react'
  */
 import { useEffect, useMemo, useRef } from 'react'
 
-import { useShell } from '../session/shell.hook'
-import { getStageHub } from './hub'
-import { createStageController } from './placement'
+import { useShell } from '../session/shell.hook.js'
+import { getStageHub } from './hub.js'
+import { createStageController } from './placement.js'
 
 /**
  * A full-viewport overlay that does not intercept pointer events — individual