@astrale-os/shell-react 0.2.0 → 0.2.2

package/src/navigation/adapters/url.adapter.ts

@@ -3,8 +3,8 @@
  * query string (URL form → `<a href>`), owning the nav query keys (`param`,
  * `view`, the location's `params`).
  */
-import type { SerializedLocation } from '../history'
-import type { NavAdapter } from './adapter'
+import type { SerializedLocation } from '../history.js'
+import type { NavAdapter } from './adapter.js'
 
 const VIEW_KEY = 'view'
 

package/src/navigation/hooks/ancestors.hook.ts

@@ -8,14 +8,14 @@ import type { LiveResult, ShapeInput } from '@astrale-os/kernel-client/store'
  */
 import { useMemo } from 'react'
 
-import type { ReadState } from '../../graph/memory/read/envelope'
-import type { Node } from '../location'
+import type { ReadState } from '../../graph/memory/read/envelope.js'
+import type { Node } from '../location.js'
 
-import { idleReadState } from '../../graph/memory/read/idle'
-import { useMemory } from '../../graph/memory/scope'
-import { chainPaths, pathHint, pathOf } from '../location'
-import { useHistoryVersion, useOptionalNavCtx, useMemoryShape } from '../scope.context'
-import { serializeTarget } from '../snapshot'
+import { idleReadState } from '../../graph/memory/read/idle.js'
+import { useMemory } from '../../graph/memory/scope.js'
+import { chainPaths, pathHint, pathOf } from '../location.js'
+import { useHistoryVersion, useOptionalNavCtx, useMemoryShape } from '../scope.context.js'
+import { serializeTarget } from '../snapshot.js'
 
 /**
  * The root-first ancestor chain (inclusive of the node itself), live: a move

package/src/navigation/hooks/location.hook.ts

@@ -4,10 +4,10 @@
  */
 import { useMemo } from 'react'
 
-import type { NavLocation } from '../location'
+import type { NavLocation } from '../location.js'
 
-import { buildLocation, useSettled } from '../location'
-import { useHistoryVersion, useNavCtx, useMemoryShape } from '../scope.context'
+import { buildLocation, useSettled } from '../location.js'
+import { useHistoryVersion, useNavCtx, useMemoryShape } from '../scope.context.js'
 
 /** The nearest scope's live location. Throws outside any {@link NavScope}. */
 export function useLocation(): NavLocation {

package/src/navigation/hooks/navigate.hook.ts

@@ -5,9 +5,9 @@
  */
 import { useMemo } from 'react'
 
-import type { MutableNavigate, NavCtx, Navigate } from '../scope.context'
+import type { MutableNavigate, NavCtx, Navigate } from '../scope.context.js'
 
-import { useHistoryVersion, useNavCtx } from '../scope.context'
+import { useHistoryVersion, useNavCtx } from '../scope.context.js'
 
 /** The nearest scope's imperative navigation surface. Throws outside a scope. */
 export function useNavigate(): Navigate {

package/src/navigation/hooks/scope.hook.ts

@@ -5,13 +5,13 @@
  */
 import { useCallback, useMemo } from 'react'
 
-import type { NavSnapshot } from '../history'
-import type { NavLocation } from '../location'
-import type { Navigate } from '../scope.context'
+import type { NavSnapshot } from '../history.js'
+import type { NavLocation } from '../location.js'
+import type { Navigate } from '../scope.context.js'
 
-import { buildLocation, useSettled } from '../location'
-import { useNavCtx, useMemoryShape } from '../scope.context'
-import { useNavigateHandle } from './navigate.hook'
+import { buildLocation, useSettled } from '../location.js'
+import { useNavCtx, useMemoryShape } from '../scope.context.js'
+import { useNavigateHandle } from './navigate.hook.js'
 
 /** The nearest scope, for chrome/persistence (API §8.2). */
 export interface NavScopeHandle {

package/src/navigation/index.ts

@@ -1,17 +1,17 @@
 // navigation — API §8 (NavScope, useLocation, useNavigate, Link, useAncestors,
 // useNavScope, adapters). See SHELL_REACT_API.md.
-export { NavScope } from './scope.context'
-export type { MissingPolicy, NavScopeProps, Navigate } from './scope.context'
-export { useLocation } from './hooks/location.hook'
-export { useNavigate } from './hooks/navigate.hook'
-export { useAncestors } from './hooks/ancestors.hook'
-export { useNavScope } from './hooks/scope.hook'
-export type { NavScopeHandle } from './hooks/scope.hook'
-export { Link } from './link'
-export type { LinkProps } from './link'
-export { memoryAdapter } from './adapters/memory.adapter'
-export { urlAdapter } from './adapters/url.adapter'
-export type { NavAdapter } from './adapters/adapter'
-export type { NavLocation } from './location'
-export type { NavSnapshot, SerializedLocation } from './history'
-export type { NavTarget } from './snapshot'
+export { NavScope } from './scope.context.js'
+export type { MissingPolicy, NavScopeProps, Navigate } from './scope.context.js'
+export { useLocation } from './hooks/location.hook.js'
+export { useNavigate } from './hooks/navigate.hook.js'
+export { useAncestors } from './hooks/ancestors.hook.js'
+export { useNavScope } from './hooks/scope.hook.js'
+export type { NavScopeHandle } from './hooks/scope.hook.js'
+export { Link } from './link.js'
+export type { LinkProps } from './link.js'
+export { memoryAdapter } from './adapters/memory.adapter.js'
+export { urlAdapter } from './adapters/url.adapter.js'
+export type { NavAdapter } from './adapters/adapter.js'
+export type { NavLocation } from './location.js'
+export type { NavSnapshot, SerializedLocation } from './history.js'
+export type { NavTarget } from './snapshot.js'

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,15 +13,13 @@ 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'
-
-type AnyBinding = SchemaBoundView<Schema, FnMap>
+import { tagSchema } from './tag.js'
+import { recordPath, writableFor } from './write.js'
 
 /** One tagged binding per (kernel, schema) — shared across the whole tree. */
-const bindingCache = new WeakMap<object, WeakMap<Schema, AnyBinding>>()
+const bindingCache = new WeakMap<object, WeakMap<Schema, unknown>>()
 
 /**
  * Resolve (and memoize) the tagged schema-bound handle for `schema` on `kernel`.
@@ -39,28 +37,26 @@ export function bindingFor<S extends Schema>(
     bySchema = new WeakMap()
     bindingCache.set(kernel, bySchema)
   }
-  let binding = bySchema.get(schema)
-  if (binding === undefined) {
-    const { writable, pathIndex } = writableFor(kernel, memory)
-    binding = tagBinding(createSchemaBoundView(writable, schema) as AnyBinding, schema, pathIndex)
-    bySchema.set(schema, binding)
-  }
-  return binding as SchemaBoundView<S, FnMap>
+  const cached = bySchema.get(schema)
+  if (cached !== undefined) return cached as SchemaBoundView<S, FnMap>
+
+  const { writable, pathIndex } = writableFor(kernel, memory)
+  const binding = tagBinding(createSchemaBoundView(writable, schema), schema, pathIndex)
+  bySchema.set(schema, binding)
+  return binding
 }
 
 /**
  * Wrap a binding so `bind`/`bindAny`/`as` outputs carry a schema tag, and every
  * bound wire node's `id → tree path` is recorded (the write cap's index); the
- * bare-call dispatch and every other member pass straight through.
+ * class handles and every other member pass straight through.
  */
-function tagBinding(
-  binding: AnyBinding,
-  schema: Schema,
+function tagBinding<S extends Schema>(
+  binding: SchemaBoundView<S, FnMap>,
+  schema: S,
   pathIndex: Map<string, string>,
-): AnyBinding {
-  const handler: ProxyHandler<AnyBinding> = {
-    apply: (target, _thisArg, args) =>
-      (target as unknown as (...a: unknown[]) => unknown)(...(args as unknown[])),
+): SchemaBoundView<S, FnMap> {
+  const handler: ProxyHandler<SchemaBoundView<S, FnMap>> = {
     get: (target, prop, receiver) => {
       const value = Reflect.get(target, prop, receiver) as unknown
       if (prop === 'bind') {
@@ -79,8 +75,9 @@ function tagBinding(
         }
       }
       if (prop === 'as') {
-        return (credential: unknown) =>
-          tagBinding((value as (c: unknown) => AnyBinding)(credential), schema, pathIndex)
+        const as = value as SchemaBoundView<S, FnMap>['as']
+        return (credential: Parameters<typeof as>[0]) =>
+          tagBinding(as(credential), schema, pathIndex)
       }
       return value
     },

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)`. */
@@ -45,7 +45,7 @@ export function useMethod<S extends Schema, T extends TypeNames<S>, M extends Me
   method: M,
   opts?: MethodOptions,
 ): Action<never[], unknown> {
-  const binding = useDomain(schema) as unknown as Dispatcher
+  const binding = useDomain(schema) as unknown as DynamicBinding
   const on = opts?.on
   const isStatic = useMemo(() => detectStatic(schema, type, String(method)), [schema, type, method])
 
@@ -70,26 +70,26 @@ export function useMethod<S extends Schema, T extends TypeNames<S>, M extends Me
   return useAction(call)
 }
 
-/** The bare-call dispatch signature of a `SchemaBoundView`, address-only. */
-type Dispatcher = (type: string, ref?: NodeRefInput) => unknown
+type DynamicClassHandle = Dispatch & ((ref: NodeRefInput) => Dispatch)
+type DynamicBinding = { classes: Record<string, DynamicClassHandle> }
 
 function staticCall(
-  binding: Dispatcher,
+  binding: DynamicBinding,
   type: string,
   method: string,
   params: unknown,
 ): Promise<unknown> {
-  return (binding(type) as unknown as Dispatch)[method]!(params)
+  return binding.classes[type]![method]!(params)
 }
 
 function instance(
-  binding: Dispatcher,
+  binding: DynamicBinding,
   type: string,
   ref: NodeRefInput,
   method: string,
   params: unknown,
 ): Promise<unknown> {
-  return (binding(type, ref) as unknown as Dispatch)[method]!(params)
+  return binding.classes[type]!(ref)[method]!(params)
 }
 
 /** Read the method's `static` flag from the schema (own + inherited). */

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
@@ -52,8 +52,7 @@ function withMemoryWrites(
     as(cred: CredentialInput | (() => CredentialInput)): SessionView
   }
   const rawUpdate = base.updateNode.bind(base)
-  return {
-    ...(kernel as object),
+  return extendCapabilities(kernel, {
     updateNode: (cls: PathLike, ref: PathLike, props: Properties): Promise<void> => {
       const path = treePathFor(pathIndex, ref)
       return path !== null ? memory.update(path, props) : rawUpdate(cls, ref, props)
@@ -62,7 +61,18 @@ function withMemoryWrites(
       memory.create(cls, at, props),
     // Credential rebind stays on the raw kernel-client floor (§6 note).
     as: (cred: CredentialInput | (() => CredentialInput)): SessionView => base.as(cred),
-  } as unknown as SessionView
+  })
+}
+
+/** Clone the complete session capability object before overlaying memory writes. */
+function extendCapabilities<Base extends object, Extension extends object>(
+  base: Base,
+  extension: Extension,
+): Base & Extension {
+  const result = Object.create(Object.getPrototypeOf(base)) as Base & Extension
+  Object.defineProperties(result, Object.getOwnPropertyDescriptors(base))
+  Object.defineProperties(result, Object.getOwnPropertyDescriptors(extension))
+  return result
 }
 
 /** The tree path an `@<id>` write ref maps to, via the bind-time index; else null. */

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 =