@phreshos/core 0.1.1 → 0.1.2

package/README.md

@@ -220,6 +220,13 @@ from its Client; its stable capability addresses the Client's current, live
 presentation state and rejects reads or mutations while that Client is
 absent.
 
+`LaunchClient.title` supplies a dynamic initial title when starting a declared
+Client. The system resolves it with the remaining launch shape before the
+Client is announced, so the first rendered Window already has its final title.
+Omission uses the Program declaration; `window.changeTitle()` remains the live
+operation after startup. Window operations are never queued while the Client
+is absent.
+
 Core also defines the independent, environment-neutral `FileWallpaper` and
 `DesktopWallpaper` contracts. The desktop variant additionally accepts a
 Program and the deliberately narrow `WallpaperLaunch`, containing only `name`,
@@ -231,10 +238,9 @@ persistence, upload, Process creation, or rendering implementation.
 
 `client.window.surface` addresses the optional host-rendered material belonging
 to one Window. Its source of truth is authoritative, server-owned Window state,
-not iframe state. `snapshot()` explicitly reads the current target, while the
-ordinary `change` subscription receives only replacements published after that
-subscription exists. A `null` target means no Surface exists in the render
-tree.
+not iframe state. Program endpoints may explicitly replace or remove that
+target, but cannot read or subscribe to it. A `null` target means no Surface
+exists in the render tree.
 
 Only Windows currently occupying the `under` or `over` layer may call `set()`
 or `remove()`; `window` and `wallpaper` layers reject those operations. Calling

package/dist/launch.d.ts

@@ -19,6 +19,8 @@ export type Layer = "window" | "under" | "over";
 export declare const layers: readonly Layer[];
 /** Per-Process overrides used when starting a Client and its Window. */
 export type LaunchClient = Readonly<{
+    /** Initial Window title for this Client incarnation. */
+    title?: string;
     /** Initial Window size for this Process. */
     size?: Size;
     /** Initial Window position for this Process. */

package/dist/main.d.ts

@@ -18,6 +18,6 @@ export { Server, type AnswerCapture, type AnswerMessage, type AnswerObserver, ty
 export { Client, type ClientTraffic } from "./client.js";
 export { Process, type Exit, type ProcessEvents } from "./process.js";
 export { Program, type ClientDeclaration, type EndpointDeclaration, type ProgramEvents, type ProgramIconSize, type ProgramProcessExit } from "./program.js";
-export { type Window, type WindowEvents, type WindowLayer, type WindowState, type WindowSurface, type WindowSurfaceEasing, type WindowSurfaceEvents, type WindowSurfaceSettings, type WindowSurfaceTransaction } from "./window.js";
+export { type Window, type WindowEvents, type WindowLayer, type WindowState, type WindowSurface, type WindowSurfaceEasing, type WindowSurfaceSettings, type WindowSurfaceTransaction } from "./window.js";
 export { layers, type Launch, type LaunchClient, type Layer, type Position, type Size } from "./launch.js";
 export { defineConfig, type ClientConfig, type ClientDevelopment, type Config, type ServerConfig, type ServerDevelopment } from "./config.js";

package/dist/window.d.ts

@@ -21,15 +21,8 @@ export type WindowSurfaceSettings = Readonly<{
     /** Optional motion from the currently rendered values to this target. */
     transaction?: WindowSurfaceTransaction;
 }>;
-/** Live changes emitted by one Window Surface capability. */
-export type WindowSurfaceEvents = {
-    /** The authoritative target changed, including immediate removal as null. */
-    change: WindowSurfaceSettings | null;
-};
 /** Optional host-rendered material owned by one authoritative Window. */
-export interface WindowSurface extends Subscribable<WindowSurfaceEvents, never> {
-    /** Explicitly reads the authoritative target, or null when no Surface exists. */
-    snapshot(): Promise<WindowSurfaceSettings | null>;
+export interface WindowSurface {
     /** Creates or replaces the authoritative target. Omission creates the default Surface. */
     set(settings?: WindowSurfaceSettings): Promise<void>;
     /** Immediately removes the authoritative Surface. */
@@ -64,8 +57,6 @@ export type WindowState = Readonly<{
     layer: WindowLayer;
     /** Current page beneath the declared Client location. */
     location: string;
-    /** Current authoritative host Surface target, or null when absent. */
-    surface: WindowSurfaceSettings | null;
 }>;
 /** Presentation capability owned by one Client handle. */
 export interface Window extends Subscribable<WindowEvents, never> {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/core",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Environment-neutral contracts and domain objects for PhreshOS Programs.",
   "type": "module",
   "sideEffects": false,