@hosty-sdk/app 0.26.0 → 0.27.22

package/dist/ui-types.d.ts

@@ -68,6 +68,7 @@ export type PresentationResult = {
     requestId: string;
     target: PanelTarget;
     readiness: SurfaceReadiness;
+    presentationId?: string;
 } | {
     status: "blocked" | "unsupported" | "rejected" | "uncertain" | "unknown";
     requestId: string;
@@ -77,6 +78,7 @@ export type PresentationOptions = {
     placement: "side";
     requestId: string;
     signal?: AbortSignal;
+    reuse?: "exact" | "new";
 };
 export type UiEvent = {
     type: "environment";
@@ -97,3 +99,89 @@ export declare function isSurfaceRoute(route: unknown): route is string;
 export declare function routeWithin(route: string, declared: string): boolean;
 /** Constructs navigation only. Core must advertise pinnedOpen and revalidate at redemption. */
 export declare function buildSurfaceOpenUrl(coreOrigin: string, destination: AppSurfaceRef): string;
+export declare const UI_COMPOSITION_CAPABILITY = "ui.composition.v1";
+export type UiChromeOverrides = {
+    navigation?: "show" | "hide";
+    tools?: {
+        enabled?: boolean;
+        launcher?: "show" | "hide";
+    };
+};
+export type UiChromePolicy = Readonly<{
+    navigation: "show" | "hide";
+    tools: Readonly<{
+        enabled: boolean;
+        launcher: "show" | "hide";
+        owner: "local" | "host" | "unavailable";
+    }>;
+}>;
+export type UiChromeSource = "host" | "url" | "app" | "legacy" | "default";
+export type UiChromeSnapshot = UiChromePolicy & Readonly<{
+    revision: number;
+    hostRevision: number;
+    rootDisabled: boolean;
+    stale: boolean;
+    connection: UiEnvironment["connection"];
+    capabilities: readonly string[];
+    sources: Readonly<{
+        navigation: UiChromeSource;
+        enabled: UiChromeSource;
+        launcher: UiChromeSource;
+    }>;
+}>;
+export type UiNavigationTarget = {
+    appId: string;
+    installationId: string;
+    entryKey: string;
+};
+export type UiNavigationEntry = Readonly<{
+    key: string;
+    label: string;
+    icon: string | null;
+    endpoint: string | null;
+    origin: string | null;
+    route: string | null;
+    available: boolean;
+    state: string;
+    standaloneHref: string | null;
+}>;
+export type UiNavigationCatalog = Readonly<{
+    appId: string;
+    installationId: string;
+    revision: string;
+    entries: readonly UiNavigationEntry[];
+}>;
+export type UiNavigationSnapshot = Readonly<{
+    status: "loading" | "ready" | "unavailable";
+    catalog: UiNavigationCatalog | null;
+    entries: readonly UiNavigationEntry[];
+    activeKey: string | null;
+    code?: string;
+}>;
+export type UiResolvedNavigation = {
+    target: UiNavigationTarget;
+    surface: UiFrameSurface | null;
+    available: boolean;
+    state: string;
+    standaloneHref: string | null;
+};
+export type UiActionOptions = {
+    requestId: string;
+    signal?: AbortSignal;
+};
+export type UiActionResult = {
+    status: "accepted";
+    requestId: string;
+} | {
+    status: "blocked" | "unsupported" | "rejected" | "uncertain" | "unknown";
+    requestId: string;
+    code: string;
+};
+export type UiNavigationResult = UiActionResult;
+export type UiToolPickerResult = UiActionResult;
+export type UiRouterAdapter = {
+    endpoint?: string;
+    getRoute(): string;
+    subscribe(listener: () => void): () => void;
+    navigate(route: string): void | Promise<void>;
+};

package/dist/ui-types.js

@@ -41,3 +41,4 @@ export function buildSurfaceOpenUrl(coreOrigin, destination) {
     url.searchParams.set("route", destination.route);
     return url.href;
 }
+export const UI_COMPOSITION_CAPABILITY = "ui.composition.v1";

package/dist/ui-workspaces.d.ts

@@ -0,0 +1,54 @@
+import type { PanelTarget, UiChromeOverrides, UiFrameSurface, UiResolvedPanel, SurfaceReadiness } from "./ui-types.js";
+export declare const DEFAULT_WORKSPACE = "default";
+export declare const ROOT_VIEW = "root";
+export type UiPresentation = {
+    key: string;
+    presentationId: string;
+    workspaceId: string;
+    target: PanelTarget;
+    resolved: UiResolvedPanel;
+    readiness: SurfaceReadiness;
+    attention: number;
+    currentRoute: string | null;
+    focusedAt: number;
+};
+export type UiWorkspaceSnapshot = {
+    workspaceId: string;
+    selectedId: string | null;
+    expanded: boolean;
+    width: number;
+};
+/** Adapters retain frames in one layer; present is also used for movement to another region. */
+export type UiWorkspaceRenderer = {
+    present(instance: UiPresentation, signal: AbortSignal): Promise<"accepted" | "unavailable">;
+    focus(presentationId: string): void;
+    collapse(): void;
+    release(presentationId: string): void;
+    showToolPicker(signal: AbortSignal): Promise<"accepted" | "unavailable">;
+    /** Only matching stable layer identities can move frames without recreating their document. */
+    frameLayer?: object;
+};
+export type UiViewDescriptor = {
+    viewId: string;
+    workspaceId: string;
+    chrome?: UiChromeOverrides;
+    presentationId?: string;
+    navigate?: (surface: UiFrameSurface) => void | Promise<void>;
+};
+export type UiPlacementResolver = (request: {
+    source: Readonly<{
+        viewId: string;
+        workspaceId: string;
+    }>;
+    target: PanelTarget;
+    presentations: readonly UiPresentation[];
+}) => {
+    workspaceId: string;
+    presentationId?: string;
+};
+export type UiWorkspace = UiWorkspaceSnapshot & {
+    generation: number;
+    renderer?: UiWorkspaceRenderer;
+    owner?: object;
+};
+export declare const workspace: (workspaceId: string) => UiWorkspace;

package/dist/ui-workspaces.js

@@ -0,0 +1,3 @@
+export const DEFAULT_WORKSPACE = "default";
+export const ROOT_VIEW = "root";
+export const workspace = (workspaceId) => ({ workspaceId, selectedId: null, expanded: false, width: 360, generation: 0 });

package/dist/ui.d.ts

@@ -1,7 +1,13 @@
-import type { PanelTarget, PresentationOptions, PresentationResult, UiEnvironment, UiEvent } from "@hosty-sdk/app/ui/types";
+import type { UiChromeSnapshot, UiNavigationSnapshot, UiActionOptions, UiActionResult, PanelTarget, PresentationOptions, PresentationResult, UiEnvironment, UiEvent } from "@hosty-sdk/app/ui/types";
 export * from "@hosty-sdk/app/ui/types";
 export interface UiClient {
     getEnvironment(): UiEnvironment;
+    getChrome(): UiChromeSnapshot;
+    subscribeChrome(listener: () => void): () => void;
+    getNavigation(): UiNavigationSnapshot;
+    subscribeNavigation(listener: () => void): () => void;
+    navigate(entryKey: string, options: UiActionOptions): Promise<UiActionResult>;
+    openToolPicker(options: UiActionOptions): Promise<UiActionResult>;
     openSurface(target: PanelTarget, options: PresentationOptions): Promise<PresentationResult>;
     getPresentation(requestId: string, options?: {
         signal?: AbortSignal;

package/dist/ui.js

@@ -1,11 +1,19 @@
+import { INITIAL_CHROME, INITIAL_NAVIGATION } from "./ui-composition.js";
 export * from "@hosty-sdk/app/ui/types";
 let active = null;
 const listeners = new Set();
 const unavailable = (requestId) => ({ status: "unsupported", requestId, code: "host_unavailable" });
+const chromeListeners = new Set(), navigationListeners = new Set();
 const initial = { mode: "standalone", connection: "connecting" };
 /** One document-local facade shared by domain apps; it never selects a provider or opens popups. */
 export const ui = {
     getEnvironment: () => active?.getEnvironment() ?? initial,
+    getChrome: () => active?.getChrome() ?? INITIAL_CHROME,
+    subscribeChrome(listener) { chromeListeners.add(listener); return () => { chromeListeners.delete(listener); }; },
+    getNavigation: () => active?.getNavigation() ?? INITIAL_NAVIGATION,
+    subscribeNavigation(listener) { navigationListeners.add(listener); return () => { navigationListeners.delete(listener); }; },
+    navigate: (key, options) => active?.navigate(key, options) ?? Promise.resolve({ status: "unsupported", requestId: options.requestId, code: "host_unavailable" }),
+    openToolPicker: options => active?.openToolPicker(options) ?? Promise.resolve({ status: "unsupported", requestId: options.requestId, code: "host_unavailable" }),
     openSurface: (target, options) => active?.openSurface(target, options) ?? Promise.resolve(unavailable(options.requestId)),
     getPresentation: (id, options) => active?.getPresentation(id, options) ?? Promise.resolve(unavailable(id)),
     subscribe(listener) { listeners.add(listener); listener({ type: "environment", value: ui.getEnvironment() }); return () => { listeners.delete(listener); }; },
@@ -16,12 +24,26 @@ export function bindUiClient(client) {
     if (active && active !== client)
         throw new Error("Mount one Hosty UI root per document.");
     active = client;
+    const releaseChrome = client.subscribeChrome(() => { for (const l of chromeListeners)
+        l(); });
+    const releaseNavigation = client.subscribeNavigation(() => { for (const l of navigationListeners)
+        l(); });
+    for (const l of chromeListeners)
+        l();
+    for (const l of navigationListeners)
+        l();
     const release = client.subscribe(event => { for (const listener of listeners)
         listener(event); });
     return () => {
         release();
+        releaseChrome();
+        releaseNavigation();
         if (active === client) {
             active = null;
+            for (const listener of chromeListeners)
+                listener();
+            for (const listener of navigationListeners)
+                listener();
             for (const listener of listeners)
                 listener({ type: "environment", value: initial });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hosty-sdk/app",
-  "version": "0.26.0",
+  "version": "0.27.22",
   "description": "Hosty app auth: session state machine, recovery bridge, Core revalidation, and the embedder responder.",
   "license": "AGPL-3.0-only",
   "type": "module",
@@ -116,6 +116,10 @@
     "./continuity/browser": {
       "types": "./dist/continuity-browser.d.ts",
       "default": "./dist/continuity-browser.js"
+    },
+    "./next": {
+      "types": "./dist/next.d.ts",
+      "default": "./dist/next.js"
     }
   },
   "scripts": {