@softov/scena 0.1.2 → 0.1.3

package/dist/core/builtins.d.ts

@@ -0,0 +1,3 @@
+import type { Disposable } from '../sdk/disposable.js';
+import type { Scena } from '../sdk/scena.js';
+export declare function registerBuiltinFunctions(scena: Scena): Disposable;

package/dist/{runtime → core}/builtins.js

@@ -1,4 +1,4 @@
-import { combineDisposables } from '../core/disposable.js';
+import { combineDisposables } from '../sdk/disposable.js';
 // The 14 a2ui v0.10 basic-catalog functions, registered as commands at
 // createScena() time. All declare callableFrom: 'clientOnly' semantics
 // (dispatch: 'client' here — they don't round-trip through the socket).

package/dist/core/controls/command.d.ts

@@ -0,0 +1,18 @@
+import type { EventBus } from '../../sdk/events.js';
+import type { ReactiveStore, SocketBridge } from '../../sdk/reactive-store.js';
+import type { MountSurfaceRegistry } from '../../sdk/mount-surface.js';
+import type { CommandRegistry } from '../../sdk/command.js';
+import type { WhenEngine } from '../../sdk/when.js';
+import type { Scena } from '../../sdk/scena.js';
+import type { KeybindingRegistry } from '../../sdk/keybinding.js';
+interface Deps {
+    events: EventBus;
+    store: ReactiveStore;
+    surfaces: MountSurfaceRegistry;
+    when: WhenEngine;
+    socket?: SocketBridge;
+    keybindings: KeybindingRegistry;
+    getScena: () => Scena;
+}
+export declare function createCommandRegistry(deps: Deps): CommandRegistry;
+export {};

package/dist/{controls → core/controls}/command.js

@@ -1,5 +1,5 @@
-import { disposableFrom } from '../core/disposable.js';
-import { validateArgs } from '../runtime/args-schema.js';
+import { disposableFrom } from '../../sdk/disposable.js';
+import { validateArgs } from '../../sdk/args-schema.js';
 export function createCommandRegistry(deps) {
     const { events, store, surfaces, when, socket, keybindings, getScena } = deps;
     const commands = new Map();

package/dist/{controls → core/controls}/events.d.ts

@@ -1,3 +1,3 @@
-import type { EventBus, ScenaEventMap } from '../types/events.js';
+import type { EventBus, ScenaEventMap } from '../../sdk/events.js';
 export declare function createEventBus(): EventBus;
 export type { ScenaEventMap };

package/dist/{controls → core/controls}/events.js

@@ -1,4 +1,4 @@
-import { disposableFrom } from '../core/disposable.js';
+import { disposableFrom } from '../../sdk/disposable.js';
 export function createEventBus() {
     const subs = new Map();
     function emit(event, payload) {

package/dist/core/controls/keybinding.d.ts

@@ -0,0 +1,9 @@
+import type { EventBus } from '../../sdk/events.js';
+import type { KeybindingRegistry } from '../../sdk/keybinding.js';
+import type { WhenEngine } from '../../sdk/when.js';
+interface Deps {
+    events: EventBus;
+    when: WhenEngine;
+}
+export declare function createKeybindingRegistry(deps: Deps): KeybindingRegistry;
+export {};

package/dist/{controls → core/controls}/keybinding.js

@@ -1,4 +1,4 @@
-import { disposableFrom } from '../core/disposable.js';
+import { disposableFrom } from '../../sdk/disposable.js';
 function normalizeKey(input) {
     return input
         .trim()

package/dist/core/controls/layout.d.ts

@@ -0,0 +1,31 @@
+import type { EventBus } from '../../sdk/events.js';
+import type { ReactiveStore } from '../../sdk/reactive-store.js';
+import type { SurfaceName } from '../../sdk/mount-surface.js';
+import type { LayoutAPI, LayoutRegistry, LayoutStorage, ScenaLayout, SurfaceLayoutState } from '../../sdk/layout.js';
+interface LayoutDeps {
+    events: EventBus;
+    store: ReactiveStore;
+    initial?: ScenaLayout;
+    storage?: LayoutStorage;
+    surfaceDefaults?: Partial<Record<SurfaceName, SurfaceLayoutState>>;
+}
+/**
+ * How the nine surfaces scena's own DefaultShell draws start out.
+ *
+ * These are a convenience, not a claim about what surfaces exist: an app that
+ * has its own set passes `surfaceDefaults` to createScena and these are not
+ * used at all. Exported so an app that wants scena's nine *plus* its own can
+ * spread rather than retype them.
+ *
+ * They are deliberately the base rather than something `initialLayout` merges
+ * into, because the two answer different questions -- which surfaces this app
+ * has, versus what state to restore.
+ */
+export declare const DEFAULT_SURFACE_LAYOUTS: Partial<Record<SurfaceName, SurfaceLayoutState>>;
+export declare function createLayoutAPI(deps: LayoutDeps): LayoutAPI & {
+    setStorage(s: LayoutStorage | null): void;
+};
+export declare function createLayoutRegistry(deps: {
+    events: EventBus;
+}): LayoutRegistry;
+export {};

package/dist/{controls → core/controls}/layout.js

@@ -1,5 +1,17 @@
-import { disposableFrom } from '../core/disposable.js';
-const DEFAULT_SURFACE_LAYOUTS = {
+import { disposableFrom } from '../../sdk/disposable.js';
+/**
+ * How the nine surfaces scena's own DefaultShell draws start out.
+ *
+ * These are a convenience, not a claim about what surfaces exist: an app that
+ * has its own set passes `surfaceDefaults` to createScena and these are not
+ * used at all. Exported so an app that wants scena's nine *plus* its own can
+ * spread rather than retype them.
+ *
+ * They are deliberately the base rather than something `initialLayout` merges
+ * into, because the two answer different questions -- which surfaces this app
+ * has, versus what state to restore.
+ */
+export const DEFAULT_SURFACE_LAYOUTS = {
     titlebar: { visible: true, layout: 'bar' },
     activitybar: { visible: true, layout: 'rail' },
     'sidebar:left': { visible: true, layout: 'single', size: 240 },
@@ -10,8 +22,12 @@ const DEFAULT_SURFACE_LAYOUTS = {
     overlay: { visible: true, layout: 'floating' },
     detached: { visible: false, layout: 'single' },
 };
-function defaultLayout() {
-    return { surfaces: { ...DEFAULT_SURFACE_LAYOUTS } };
+function defaultLayout(defaults) {
+    // `?? DEFAULT_SURFACE_LAYOUTS`, not a merge: an app that passes its own set
+    // is saying those ARE its surfaces, and merging would put back the ones it
+    // just declined. An empty object is therefore a legitimate answer -- no
+    // surfaces until something calls setSurface.
+    return { surfaces: { ...(defaults ?? DEFAULT_SURFACE_LAYOUTS) } };
 }
 // Long enough to swallow a gesture, short enough that letting go of a splitter
 // and closing the tab keeps the size.
@@ -35,9 +51,10 @@ function surfaceBase(surface) {
 export function createLayoutAPI(deps) {
     const { events, store } = deps;
     let storage = deps.storage ?? null;
+    const base = () => defaultLayout(deps.surfaceDefaults);
     let state = deps.initial
-        ? applyDeep(defaultLayout(), deps.initial)
-        : defaultLayout();
+        ? applyDeep(base(), deps.initial)
+        : base();
     const subscribers = new Set();
     let saveTimer = null;
     // Only the surfaces that could have changed. `set` and `patch` can touch any
@@ -133,7 +150,7 @@ export function createLayoutAPI(deps) {
     if (storage) {
         void storage.load().then((loaded) => {
             if (loaded) {
-                state = applyDeep(defaultLayout(), loaded);
+                state = applyDeep(base(), loaded);
                 notify();
             }
         });

package/dist/core/controls/manifest.d.ts

@@ -0,0 +1,21 @@
+import type { EventBus } from '../../sdk/events.js';
+import type { ReactiveStore } from '../../sdk/reactive-store.js';
+import type { ComponentRegistry } from '../../sdk/component-registry.js';
+import type { CommandRegistry } from '../../sdk/command.js';
+import type { KeybindingRegistry } from '../../sdk/keybinding.js';
+import type { MountSurfaceRegistry } from '../../sdk/mount-surface.js';
+import type { ConverterRegistry } from '../../sdk/converter-registry.js';
+import type { PermissionEngine } from '../../sdk/permissions.js';
+import type { ManifestAPI } from '../../sdk/manifest.js';
+interface Deps {
+    events: EventBus;
+    store: ReactiveStore;
+    components: ComponentRegistry;
+    commands: CommandRegistry;
+    keybindings: KeybindingRegistry;
+    surfaces: MountSurfaceRegistry;
+    converters: ConverterRegistry;
+    permissions: PermissionEngine;
+}
+export declare function createManifestAPI(deps: Deps): ManifestAPI;
+export {};

package/dist/{controls → core/controls}/manifest.js

@@ -1,5 +1,5 @@
-import { combineDisposables, disposableFrom } from '../core/disposable.js';
-import { isPermissionPath } from '../runtime/args-schema.js';
+import { combineDisposables, disposableFrom } from '../../sdk/disposable.js';
+import { isPermissionPath } from '../../sdk/args-schema.js';
 // Validates an AuthorManifest. Returns a list of errors; empty = ok.
 //   - plugin component names must be `<slug>.<TypeName>`
 //   - plugin command ids must be `<slug>.<...>`

package/dist/core/controls/session.d.ts

@@ -0,0 +1,16 @@
+import type { EventBus } from '../../sdk/events.js';
+import type { ReactiveStore } from '../../sdk/reactive-store.js';
+import type { MountSurfaceRegistry } from '../../sdk/mount-surface.js';
+import type { SessionAPI, SessionStorage } from '../../sdk/session.js';
+import type { ComponentRegistry } from '../../sdk/component-registry.js';
+interface Deps {
+    events: EventBus;
+    store: ReactiveStore;
+    surfaces: MountSurfaceRegistry;
+    components: ComponentRegistry;
+    storage?: SessionStorage;
+}
+export declare function createSessionAPI(deps: Deps): SessionAPI & {
+    setStorage(s: SessionStorage | null): void;
+};
+export {};

package/dist/{controls → core/controls}/session.js

@@ -1,15 +1,4 @@
-import { disposableFrom } from '../core/disposable.js';
-const ALL_SURFACES = [
-    'titlebar',
-    'activitybar',
-    'sidebar:left',
-    'sidebar:right',
-    'main',
-    'panel:bottom',
-    'statusbar',
-    'overlay',
-    'detached',
-];
+import { disposableFrom } from '../../sdk/disposable.js';
 export function createSessionAPI(deps) {
     const { events, surfaces, components } = deps;
     let storage = deps.storage ?? null;
@@ -17,7 +6,10 @@ export function createSessionAPI(deps) {
     let autoPersistSub = null;
     function snapshot() {
         const mounts = [];
-        for (const surface of ALL_SURFACES) {
+        // Whatever is actually occupied, not a list of names this file was
+        // written with: an app-defined surface used to be dropped from the
+        // snapshot silently, and restore came back missing its mounts.
+        for (const surface of surfaces.listSurfaces()) {
             for (const m of surfaces.listAt(surface)) {
                 mounts.push({
                     key: m.key,

package/dist/{controls → core/controls}/shell.d.ts

@@ -1,5 +1,5 @@
-import type { EventBus } from '../types/events.js';
-import type { ShellRegistry } from '../types/shell.js';
+import type { EventBus } from '../../sdk/events.js';
+import type { ShellRegistry } from '../../sdk/shell.js';
 interface Deps {
     events: EventBus;
     initialId?: string;

package/dist/{controls → core/controls}/shell.js

@@ -1,4 +1,4 @@
-import { disposableFrom } from '../core/disposable.js';
+import { disposableFrom } from '../../sdk/disposable.js';
 export function createShellRegistry(deps) {
     const { events } = deps;
     const shells = new Map();

package/dist/{controls → core/controls}/storage/layout-local.d.ts

@@ -1,4 +1,4 @@
-import type { LayoutStorage } from '../../types/layout.js';
+import type { LayoutStorage } from '../../../sdk/layout.js';
 export interface LocalStorageLayoutStorageOptions {
     key?: string;
 }

package/dist/{controls → core/controls}/storage/session-local.d.ts

@@ -1,4 +1,4 @@
-import type { SessionStorage } from '../../types/session.js';
+import type { SessionStorage } from '../../../sdk/session.js';
 export interface LocalStorageSessionStorageOptions {
     key?: string;
 }

package/dist/{controls → core/controls}/when.d.ts

@@ -1,5 +1,5 @@
-import type { ReactiveStore } from '../types/reactive-store.js';
-import type { WhenEngine } from '../types/when.js';
+import type { ReactiveStore } from '../../sdk/reactive-store.js';
+import type { WhenEngine } from '../../sdk/when.js';
 interface Deps {
     store: ReactiveStore;
 }

package/dist/{controls → core/controls}/when.js

@@ -1,4 +1,4 @@
-import { combineDisposables, disposableFrom } from '../core/disposable.js';
+import { combineDisposables, disposableFrom } from '../../sdk/disposable.js';
 function tokenize(input) {
     const tokens = [];
     let i = 0;

package/dist/{converters → core/converters}/a2ui-v0.10.d.ts

@@ -1,4 +1,4 @@
-import type { Converter } from '../types/converter-registry.js';
+import type { Converter } from '../../sdk/converter-registry.js';
 export interface A2uiComponentSpec {
     id: string;
     component: string;

package/dist/core/{component-graph.d.ts → graph/component-graph.d.ts}

@@ -1,4 +1,4 @@
-import type { ComponentNode } from '../types/component-graph.js';
+import type { ComponentNode } from '../../sdk/component-graph.js';
 export declare function walk(node: ComponentNode, visit: (node: ComponentNode, parent: ComponentNode | null) => void): void;
 export declare function clone(node: ComponentNode): ComponentNode;
 export declare function addIds(node: ComponentNode): ComponentNode;

package/dist/core/{component-graph.js → graph/component-graph.js}

@@ -1,4 +1,4 @@
-import { isComponentNode } from '../types/component-graph.js';
+import { isComponentNode } from '../../sdk/component-graph.js';
 // Recursive tree walk. Visits the root, then every nested ComponentNode found
 // anywhere in its prop values (single child, child array, or deeper nesting).
 export function walk(node, visit) {

package/dist/core/{mount-menu.d.ts → graph/mount-menu.d.ts}

@@ -1,2 +1,2 @@
-import type { MountMenuRegistry } from '../types/mount-menu.js';
+import type { MountMenuRegistry } from '../../sdk/mount-menu.js';
 export declare function createMountMenuRegistry(): MountMenuRegistry;

package/dist/core/{mount-menu.js → graph/mount-menu.js}

@@ -1,4 +1,4 @@
-import { disposableFrom } from './disposable.js';
+import { disposableFrom } from '../../sdk/disposable.js';
 export function createMountMenuRegistry() {
     const bySlot = new Map();
     function register(slot, contributor) {

package/dist/core/graph/mount-surface.d.ts

@@ -0,0 +1,15 @@
+import type { EventBus } from '../../sdk/events.js';
+import type { MountSurfaceRegistry } from '../../sdk/mount-surface.js';
+import type { ComponentRegistry } from '../../sdk/component-registry.js';
+import type { WhenEngine } from '../../sdk/when.js';
+import type { BindingResolver } from '../../sdk/binding-resolver.js';
+import type { ReactiveStore } from '../../sdk/reactive-store.js';
+interface Deps {
+    events: EventBus;
+    when: WhenEngine;
+    bindings: BindingResolver;
+    store: ReactiveStore;
+    components: ComponentRegistry;
+}
+export declare function createMountSurfaceRegistry(deps: Deps): MountSurfaceRegistry;
+export {};

package/dist/core/{mount-surface.js → graph/mount-surface.js}

@@ -1,6 +1,6 @@
-import { isDataBinding } from '../types/component-graph.js';
-import { combineDisposables, disposableFrom } from './disposable.js';
-import { clearMountLocal } from './reactive-store.js';
+import { isDataBinding } from '../../sdk/component-graph.js';
+import { combineDisposables, disposableFrom } from '../../sdk/disposable.js';
+import { clearMountLocal } from '../store/reactive-store.js';
 const MISSING_NODE = {
     component: 'MissingComponent',
     reason: 'unbound',
@@ -179,6 +179,25 @@ export function createMountSurfaceRegistry(deps) {
             return;
         events.emit('scena:mount:focused', { key, surface: m.surface });
     }
+    // Which surfaces currently hold a visible mount.
+    //
+    // Anything that needs to sweep every surface has to ask, rather than iterate
+    // a list of names it was compiled with: a surface is whatever an app mounts
+    // to, so a hardcoded list silently skips the ones it has not heard of. The
+    // session snapshot used to do exactly that.
+    //
+    // Ordered by first mount, so a caller sweeping surfaces is deterministic.
+    function listSurfaces() {
+        const seen = new Set();
+        const out = [];
+        for (const m of [...mountsByKey.values()].sort((a, b) => a.openedAt - b.openedAt)) {
+            if (!visibleByKey.has(m.key) || seen.has(m.surface))
+                continue;
+            seen.add(m.surface);
+            out.push(m.surface);
+        }
+        return out;
+    }
     function listAt(surface) {
         const out = [];
         for (const m of mountsByKey.values()) {
@@ -210,5 +229,5 @@ export function createMountSurfaceRegistry(deps) {
             });
         }
     }
-    return { mount, open, openResource, close, focus, listAt, move };
+    return { mount, open, openResource, close, focus, listAt, listSurfaces, move };
 }

package/dist/core/{surface-presentation.d.ts → graph/surface-presentation.d.ts}

@@ -1,6 +1,6 @@
-import type { SurfaceName } from '../types/mount-surface.js';
-import type { SurfacePresentation } from '../types/layout.js';
-import type { ModusClass } from './backends/modus-backend.js';
+import type { SurfaceName } from '../../sdk/mount-surface.js';
+import type { SurfacePresentation } from '../../sdk/layout.js';
+import type { ModusClass } from '../store/backends/modus-backend.js';
 export type PresentationPolicy = Partial<Record<SurfaceName, Partial<Record<ModusClass, SurfacePresentation>>>>;
 export declare function resolveSurfacePresentation(surface: SurfaceName, modus: ModusClass, policy?: PresentationPolicy): SurfacePresentation;
 export declare function isOverlaid(presentation: SurfacePresentation): boolean;

package/dist/{i18n → core/i18n}/i18n-backend.d.ts

@@ -1,2 +1,2 @@
-import type { ScopeBackend } from '../types/scope-backend.js';
+import type { ScopeBackend } from '../../sdk/scope-backend.js';
 export declare function createI18nBackend(scope?: string): ScopeBackend;

package/dist/core/index.d.ts

@@ -1,44 +1,35 @@
-export * from '../types/index.js';
-export { combineDisposables, disposableFrom } from './disposable.js';
-export { walk, clone, addIds, findById, stripMeta } from './component-graph.js';
-export { createPermissionEngine } from './permissions.js';
-export { createReactiveStore, localPath, rewriteLocal, clearMountLocal, } from './reactive-store.js';
-export { createBindingResolver } from './binding-resolver.js';
-export { resolveLabel } from './label.js';
-export { createStorageBackend, createLocalStorageStorage, } from './backends/storage-backend.js';
-export type { BackendStorage } from './backends/storage-backend.js';
-export { createModusBackend, DEFAULT_MODUS_BREAKPOINTS, } from './backends/modus-backend.js';
-export type { ModusClass, ModusBreakpoints, ModusBackendOptions, } from './backends/modus-backend.js';
-export { resolveSurfacePresentation, isOverlaid } from './surface-presentation.js';
-export type { PresentationPolicy } from './surface-presentation.js';
-export { registerMessages, registerLocale, unregisterMessages, setLocale, getLocale, getLocaleInfo, listLocaleInfo, setFallbackLocale, listLocales, lookup, resolveMessage, translate, allKeys, subscribeI18n, clearMessages, } from '../i18n/registry.js';
-export type { TranslateOptions, MessageTree, LocaleInfo, RegisterMessagesExtra, } from '../i18n/registry.js';
-export { createI18nBackend } from '../i18n/i18n-backend.js';
-export { createComponentRegistry } from './component-registry.js';
-export { createConverterRegistry } from './converter-registry.js';
-export { createMountSurfaceRegistry } from './mount-surface.js';
+export * from '../sdk/index.js';
+export { combineDisposables, disposableFrom } from '../sdk/disposable.js';
+export { walk, clone, addIds, findById, stripMeta } from './graph/component-graph.js';
+export { createPermissionEngine } from './resolve/permissions.js';
+export { createReactiveStore, localPath, rewriteLocal, clearMountLocal, } from './store/reactive-store.js';
+export { createBindingResolver } from './resolve/binding-resolver.js';
+export { resolveLabel } from '../sdk/label.js';
+export { createStorageBackend, createLocalStorageStorage, } from './store/backends/storage-backend.js';
+export type { BackendStorage } from './store/backends/storage-backend.js';
+export { createModusBackend, DEFAULT_MODUS_BREAKPOINTS, } from './store/backends/modus-backend.js';
+export type { ModusClass, ModusBreakpoints, ModusBackendOptions, } from './store/backends/modus-backend.js';
+export { resolveSurfacePresentation, isOverlaid } from './graph/surface-presentation.js';
+export type { PresentationPolicy } from './graph/surface-presentation.js';
+export { registerMessages, registerLocale, unregisterMessages, setLocale, getLocale, getLocaleInfo, listLocaleInfo, setFallbackLocale, listLocales, lookup, resolveMessage, translate, allKeys, subscribeI18n, clearMessages, } from './i18n/registry.js';
+export type { TranslateOptions, MessageTree, LocaleInfo, RegisterMessagesExtra, } from './i18n/registry.js';
+export { createI18nBackend } from './i18n/i18n-backend.js';
+export { createComponentRegistry } from './registry/component-registry.js';
+export { createConverterRegistry } from './registry/converter-registry.js';
+export { createMountSurfaceRegistry } from './graph/mount-surface.js';
 export { createScena } from './scena.js';
-export { parsePath, joinAbsolute, joinSegments, hasWildcard, interpolatePath, readPath, writePath, scopeOf, } from './path-resolver.js';
-export { resolveDynamicValue, resolveDynamicString, resolveDynamicNumber, resolveDynamicBoolean, resolveDynamicStringList, resolveFunctionCall, resolveAction, writeDynamic, isWritableDynamic, } from './dynamic-resolver.js';
-export { createEventBus } from '../controls/events.js';
-export { createWhenEngine } from '../controls/when.js';
-export { createCommandRegistry } from '../controls/command.js';
-export { createKeybindingRegistry } from '../controls/keybinding.js';
-export { createLayoutAPI, createLayoutRegistry } from '../controls/layout.js';
-export { createSessionAPI } from '../controls/session.js';
-export { createShellRegistry } from '../controls/shell.js';
-export { createManifestAPI } from '../controls/manifest.js';
-export { createLocalStorageLayoutStorage, createNoopLayoutStorage, } from '../controls/storage/layout-local.js';
-export { createLocalStorageSessionStorage } from '../controls/storage/session-local.js';
-export { validateArgs, isPermissionPath } from '../runtime/args-schema.js';
-export type { ValidateArgsResult } from '../runtime/args-schema.js';
-export { createSurfaceBridge } from '../runtime/surface-bridge.js';
-export { registerClientHandler, getClientHandler, } from '../runtime/client-handlers.js';
-export { createInMemorySocket } from '../runtime/in-memory-socket.js';
-export type { InMemorySocket } from '../runtime/in-memory-socket.js';
-export { registerBuiltinFunctions } from '../runtime/builtins.js';
-export { registerLayoutCommands } from '../runtime/layout-commands.js';
-export { registerOpenerCommands } from '../runtime/opener-commands.js';
-export type { RegisterOpenerCommandsOptions } from '../runtime/opener-commands.js';
-export { a2uiV010Converter } from '../converters/a2ui-v0.10.js';
-export type { A2uiCreateSurface, A2uiComponentSpec, A2uiConverterInput, } from '../converters/a2ui-v0.10.js';
+export { parsePath, joinAbsolute, joinSegments, hasWildcard, interpolatePath, readPath, writePath, scopeOf, } from './resolve/path-resolver.js';
+export { resolveDynamicValue, resolveDynamicString, resolveDynamicNumber, resolveDynamicBoolean, resolveDynamicStringList, resolveFunctionCall, resolveAction, writeDynamic, isWritableDynamic, } from './resolve/dynamic-resolver.js';
+export { createEventBus } from './controls/events.js';
+export { createWhenEngine } from './controls/when.js';
+export { createCommandRegistry } from './controls/command.js';
+export { createKeybindingRegistry } from './controls/keybinding.js';
+export { createLayoutAPI, createLayoutRegistry, DEFAULT_SURFACE_LAYOUTS } from './controls/layout.js';
+export { createSessionAPI } from './controls/session.js';
+export { createShellRegistry } from './controls/shell.js';
+export { createManifestAPI } from './controls/manifest.js';
+export { createLocalStorageLayoutStorage, createNoopLayoutStorage, } from './controls/storage/layout-local.js';
+export { createLocalStorageSessionStorage } from './controls/storage/session-local.js';
+export { registerBuiltinFunctions } from './builtins.js';
+export { a2uiV010Converter } from './converters/a2ui-v0.10.js';
+export type { A2uiCreateSurface, A2uiComponentSpec, A2uiConverterInput, } from './converters/a2ui-v0.10.js';

package/dist/core/index.js

@@ -1,48 +1,45 @@
-// Public runtime entry — re-exports the type surface alongside the factory functions.
-export * from '../types/index.js';
-export { combineDisposables, disposableFrom } from './disposable.js';
-export { walk, clone, addIds, findById, stripMeta } from './component-graph.js';
-export { createPermissionEngine } from './permissions.js';
-export { createReactiveStore, localPath, rewriteLocal, clearMountLocal, } from './reactive-store.js';
-export { createBindingResolver } from './binding-resolver.js';
-// Pure Label resolver. `types/label.ts` documents this as the intended way to
+// The core barrel: the store, the graph, the resolvers and the registries,
+// re-exported alongside the sdk surface they implement. The runtime layer
+// (surface bridge, sockets, layout/opener commands) is added on top by
+// `src/index.ts`, which is what the package's root export points at.
+export * from '../sdk/index.js';
+export { combineDisposables, disposableFrom } from '../sdk/disposable.js';
+export { walk, clone, addIds, findById, stripMeta } from './graph/component-graph.js';
+export { createPermissionEngine } from './resolve/permissions.js';
+export { createReactiveStore, localPath, rewriteLocal, clearMountLocal, } from './store/reactive-store.js';
+export { createBindingResolver } from './resolve/binding-resolver.js';
+// Pure Label resolver. `sdk/label.ts` documents this as the intended way to
 // resolve a Label outside React (useLabel is the reactive counterpart), so it
 // belongs on the public surface.
-export { resolveLabel } from './label.js';
+export { resolveLabel } from '../sdk/label.js';
 // Reference ScopeBackend implementations. The Yjs backend is a deep import
-// (`core/backends/yjs-backend.js`) so the barrel never references `yjs`.
-export { createStorageBackend, createLocalStorageStorage, } from './backends/storage-backend.js';
+// (`core/store/backends/yjs-backend.js`) so the barrel never references `yjs`.
+export { createStorageBackend, createLocalStorageStorage, } from './store/backends/storage-backend.js';
 // `$/modus` — display environment (size class, orientation, pointer accuracy)
 // published as a scope so `when` clauses can gate surfaces on it.
-export { createModusBackend, DEFAULT_MODUS_BREAKPOINTS, } from './backends/modus-backend.js';
+export { createModusBackend, DEFAULT_MODUS_BREAKPOINTS, } from './store/backends/modus-backend.js';
 // Maps a `$/modus` size class to how each surface occupies space. The policy
 // is supplied by the app — scena ships the mechanism, not the opinion.
 // `isOverlaid` tells a shell whether to drop the splitter and draw a scrim.
-export { resolveSurfacePresentation, isOverlaid } from './surface-presentation.js';
+export { resolveSurfacePresentation, isOverlaid } from './graph/surface-presentation.js';
 // i18n — registry (source of truth + active locale) + the `$/t` ScopeBackend.
-export { registerMessages, registerLocale, unregisterMessages, setLocale, getLocale, getLocaleInfo, listLocaleInfo, setFallbackLocale, listLocales, lookup, resolveMessage, translate, allKeys, subscribeI18n, clearMessages, } from '../i18n/registry.js';
-export { createI18nBackend } from '../i18n/i18n-backend.js';
-export { createComponentRegistry } from './component-registry.js';
-export { createConverterRegistry } from './converter-registry.js';
-export { createMountSurfaceRegistry } from './mount-surface.js';
+export { registerMessages, registerLocale, unregisterMessages, setLocale, getLocale, getLocaleInfo, listLocaleInfo, setFallbackLocale, listLocales, lookup, resolveMessage, translate, allKeys, subscribeI18n, clearMessages, } from './i18n/registry.js';
+export { createI18nBackend } from './i18n/i18n-backend.js';
+export { createComponentRegistry } from './registry/component-registry.js';
+export { createConverterRegistry } from './registry/converter-registry.js';
+export { createMountSurfaceRegistry } from './graph/mount-surface.js';
 export { createScena } from './scena.js';
-export { parsePath, joinAbsolute, joinSegments, hasWildcard, interpolatePath, readPath, writePath, scopeOf, } from './path-resolver.js';
-export { resolveDynamicValue, resolveDynamicString, resolveDynamicNumber, resolveDynamicBoolean, resolveDynamicStringList, resolveFunctionCall, resolveAction, writeDynamic, isWritableDynamic, } from './dynamic-resolver.js';
-export { createEventBus } from '../controls/events.js';
-export { createWhenEngine } from '../controls/when.js';
-export { createCommandRegistry } from '../controls/command.js';
-export { createKeybindingRegistry } from '../controls/keybinding.js';
-export { createLayoutAPI, createLayoutRegistry } from '../controls/layout.js';
-export { createSessionAPI } from '../controls/session.js';
-export { createShellRegistry } from '../controls/shell.js';
-export { createManifestAPI } from '../controls/manifest.js';
-export { createLocalStorageLayoutStorage, createNoopLayoutStorage, } from '../controls/storage/layout-local.js';
-export { createLocalStorageSessionStorage } from '../controls/storage/session-local.js';
-export { validateArgs, isPermissionPath } from '../runtime/args-schema.js';
-export { createSurfaceBridge } from '../runtime/surface-bridge.js';
-export { registerClientHandler, getClientHandler, } from '../runtime/client-handlers.js';
-export { createInMemorySocket } from '../runtime/in-memory-socket.js';
-export { registerBuiltinFunctions } from '../runtime/builtins.js';
-export { registerLayoutCommands } from '../runtime/layout-commands.js';
-export { registerOpenerCommands } from '../runtime/opener-commands.js';
-export { a2uiV010Converter } from '../converters/a2ui-v0.10.js';
+export { parsePath, joinAbsolute, joinSegments, hasWildcard, interpolatePath, readPath, writePath, scopeOf, } from './resolve/path-resolver.js';
+export { resolveDynamicValue, resolveDynamicString, resolveDynamicNumber, resolveDynamicBoolean, resolveDynamicStringList, resolveFunctionCall, resolveAction, writeDynamic, isWritableDynamic, } from './resolve/dynamic-resolver.js';
+export { createEventBus } from './controls/events.js';
+export { createWhenEngine } from './controls/when.js';
+export { createCommandRegistry } from './controls/command.js';
+export { createKeybindingRegistry } from './controls/keybinding.js';
+export { createLayoutAPI, createLayoutRegistry, DEFAULT_SURFACE_LAYOUTS } from './controls/layout.js';
+export { createSessionAPI } from './controls/session.js';
+export { createShellRegistry } from './controls/shell.js';
+export { createManifestAPI } from './controls/manifest.js';
+export { createLocalStorageLayoutStorage, createNoopLayoutStorage, } from './controls/storage/layout-local.js';
+export { createLocalStorageSessionStorage } from './controls/storage/session-local.js';
+export { registerBuiltinFunctions } from './builtins.js';
+export { a2uiV010Converter } from './converters/a2ui-v0.10.js';

package/dist/core/{component-registry.d.ts → registry/component-registry.d.ts}

@@ -1,5 +1,5 @@
-import type { EventBus } from '../types/events.js';
-import type { ComponentRegistry } from '../types/component-registry.js';
+import type { EventBus } from '../../sdk/events.js';
+import type { ComponentRegistry } from '../../sdk/component-registry.js';
 interface Deps {
     events: EventBus;
 }

package/dist/core/{component-registry.js → registry/component-registry.js}

@@ -1,4 +1,4 @@
-import { disposableFrom } from './disposable.js';
+import { disposableFrom } from '../../sdk/disposable.js';
 export function createComponentRegistry(deps) {
     const { events } = deps;
     const defs = new Map();

package/dist/core/registry/converter-registry.d.ts

@@ -0,0 +1,2 @@
+import type { ConverterRegistry } from '../../sdk/converter-registry.js';
+export declare function createConverterRegistry(): ConverterRegistry;

package/dist/core/{converter-registry.js → registry/converter-registry.js}

@@ -1,4 +1,4 @@
-import { disposableFrom } from './disposable.js';
+import { disposableFrom } from '../../sdk/disposable.js';
 export function createConverterRegistry() {
     const converters = new Map();
     function inputMatches(matcher, input) {

package/dist/core/resolve/binding-resolver.d.ts

@@ -0,0 +1,7 @@
+import type { BindingResolver } from '../../sdk/binding-resolver.js';
+import type { ReactiveStore } from '../../sdk/reactive-store.js';
+interface Deps {
+    store: ReactiveStore;
+}
+export declare function createBindingResolver(deps: Deps): BindingResolver;
+export {};