@valancex/valance 0.1.0

package/README.md

@@ -0,0 +1,16 @@
+# @valancex/valance
+
+The application-composition boundary over [NEXUS](https://github.com/ValanceX/Nexus) (behavior), [MESH](https://github.com/ValanceX/Mesh) (template semantics) and [PORT](https://github.com/ValanceX/Port) (target realization): one application, one NEXUS state, a view derived from it, MESH programs rendered to a PORT target.
+
+```ts
+import * as Valance from "@valancex/valance";           // define, start, mount, hydrate (+ ApplicationHandle, Mounted, TargetFactory)
+import * as Web from "@valancex/valance/web";           // Web.target, Web.history        (needs @valancex/port-web)
+import { renderToHtml } from "@valancex/valance/web/server";
+```
+
+- **Compatibility set (0.1.0):** `@valancex/nexus` ^0.10.1 (a dependency); peers `@valancex/mesh-runtime` ^0.7.0, `@valancex/port-web` ^0.2.2 (optional, for the Web entries) and `effect` ^3.10.0.
+- **Lifetimes:** the application lives in the caller's `Scope`; each mount lives in the caller's (separate) `Scope`.
+- **Status:** pre-1.0. `./internal` is the composition protocol for binding authors and tests, unstable by design.
+- **Architecture, ownership rules and evidence:** [`docs/FINDINGS.md`](https://github.com/ValanceX/Valance/blob/main/docs/FINDINGS.md) (see "Architectural checkpoint" and "Canonical lifecycle architecture"); constraints in [`docs/CONSTRAINTS.md`](https://github.com/ValanceX/Valance/blob/main/docs/CONSTRAINTS.md); release notes in [`docs/releases/v0.1.md`](https://github.com/ValanceX/Valance/blob/main/docs/releases/v0.1.md).
+
+MIT licensed.

package/dist/index.d.ts

@@ -0,0 +1,138 @@
+/**
+ * @valancex/valance: the application-composition boundary over NEXUS, MESH and PORT.
+ *
+ * It owns the composition that no substrate may own (NEXUS ARCHITECTURE §16, PORT CONTRACT "the composer"):
+ *
+ *   define(app)            data: program, state, scope, command bindings. No target, no platform.
+ *   start(app, options)    starts the NEXUS application in the CALLER's Scope; supplies the platform;
+ *                          creates the application's state and its MESH host; returns the application's handle:
+ *                          its `state` and `invoke`, and nothing of the composition (see ./internal).
+ *   mount / hydrate        connects a PORT target to a started application: draws (or adopts server
+ *                          server output for) the current render, follows later renders as updates, and
+ *                          dispatches each reported event with the render that was drawn.
+ *
+ * Command lifetime: commands admitted through `invoke` or MESH dispatch are owned by the application until they exit; closing the
+ * caller's Scope closes admission and drains them before NEXUS terminates and platform resources release (docs/FINDINGS.md, "Canonical lifecycle architecture").
+ *
+ * Nothing here is target-specific. A target is whatever satisfies `Target`, which is PORT's
+ * contract (draw / update / unmount, plus hydrate where a PORT has one) and nothing more.
+ */
+import type { BoundaryValue, RenderTree } from "@valancex/mesh-runtime";
+import * as Nexus from "@valancex/nexus";
+import { type DispatchExit } from "./internal.js";
+import { Effect, Exit, Schema, Scope } from "effect";
+/** What a command binding may require: only what the NEXUS application runtime itself provides. */
+export type Ambient = Nexus.Capability.EnvironmentShape | Nexus.Event.EventBusShape;
+/** One MESH program the application can show, and the manifest-shaped values it is rendered from. */
+export interface View<S> {
+    /** MESH program: templates compiled at build time, and the manifest's text. */
+    readonly program: Nexus.Mesh.Program;
+    /** State → the program root's scope values, shaped to the manifest. */
+    readonly scope: (state: S) => Record<string, unknown>;
+}
+export interface ApplicationDefinition<S, E, R extends Ambient, V extends string> {
+    readonly name: string;
+    /** The application's one NEXUS state. `initial` is the default; `start` may be given another (hydration). */
+    readonly state: {
+        readonly schema: Schema.Schema<S>;
+        readonly initial: S;
+    };
+    /** The MESH programs the application can show. The application's state outlives a change of program. */
+    readonly views: {
+        readonly [K in V]: View<S>;
+    };
+    /** Which program the current state shows. A function of application state: what the active view is, is the application's. */
+    readonly view: (state: S) => V;
+    /** Behavior: NEXUS commands over the state, bound to MESH command intents ("component/name"), for every view. */
+    readonly commands: (state: Nexus.State.StateHandle<S>) => Readonly<Record<string, Nexus.Mesh.Binding<E, R>>>;
+}
+/** The definition, typed. An application is data: defining one starts nothing. */
+export declare const define: <S, E, R extends Ambient, V extends string>(definition: ApplicationDefinition<S, E, R, V>) => ApplicationDefinition<S, E, R, V>;
+export type StartError = Nexus.Application.ApplicationInitError | Nexus.State.StateInitError;
+export interface StartOptions<S> {
+    /** Supplied to NEXUS `Application.start`, where platform services (capabilities, Clock, …) enter. */
+    readonly platform?: Nexus.Application.Platform;
+    /** Overrides the definition's initial state: the client's, from what the server embedded. */
+    readonly state?: S;
+}
+/**
+ * The application's external face: what code outside its definition, and outside any MESH render, may do with it.
+ * Whoever holds it (a host page, a custom producer, a headless host, one of Valance's own bindings) holds exactly this.
+ *
+ * It carries no runtime, no render, no dispatch, and no lifecycle: the application's lifetime is the `Scope` `start`
+ * ran in, and nothing here ends it, restarts it, or reports on it.
+ */
+export interface ApplicationHandle<S, E> {
+    /**
+     * The application's current state: one read, as of when it runs. A read, not a subscription: the state a host sees
+     * is the state commands have committed, whatever view is shown.
+     */
+    readonly state: Effect.Effect<S>;
+    /**
+     * Runs the command bound to `key` with the given arguments, exactly as a MESH intent for that key would:
+     * through the same table, so there is one way into application behavior. For input that does not come from a MESH
+     * render (a browser event, a host page, a headless caller).
+     *
+     * It executes in the application's own context, with the platform's FiberRefs, and nothing of that context flows
+     * back to the caller (NEXUS I44). The caller needs no runtime and provides no services: interrupting the returned
+     * effect interrupts the command, and typed failures and defects pass through unchanged.
+     */
+    readonly invoke: (key: string, args: ReadonlyArray<Nexus.Mesh.IntentArgument>) => Effect.Effect<unknown, Nexus.Mesh.UnmappedCommand | E>;
+}
+/**
+ * Starts the application. Its lifetime is the caller's `Scope`: closing it ends the application and its state, and
+ * Valance keeps nothing that outlives that scope. (NEXUS can also end an application early; that is the substrate's,
+ * is outside this model, and nothing here asks for it. The command drain below belongs to the Scope close, so that route does not pass it.)
+ */
+export declare const start: <S, E, R extends Ambient, V extends string>(app: ApplicationDefinition<S, E, R, V>, options?: StartOptions<S>) => Effect.Effect<ApplicationHandle<S, E>, StartError, Scope.Scope>;
+/** Reports what the user did: PORT's handler identifier and payload. */
+export type Report = (handler: string, payload?: BoundaryValue) => void;
+/** PORT's contract as the composer uses it. `draw`/`update` carry program continuity, which only the composer knows. */
+export interface Target {
+    draw(tree: RenderTree): void;
+    update(tree: RenderTree): void;
+    unmount(): void;
+}
+/** A target whose PORT can take over server output (a PORT with a `hydrate`). `H` is PORT's own result. */
+export interface HydratableTarget<H> extends Target {
+    hydrate(tree: RenderTree): H;
+}
+/** Builds a target that reports to `report`. */
+export type TargetFactory<T extends Target> = (report: Report) => T;
+/**
+ * What `mount` returns (and `hydrate` returns with `hydration` added): a host's view of ONE mount, owned by that mount's Scope. Every member is
+ * mount-owned information that no other public surface gives a host: `followed` is the only way to learn how the mount ended (the application ended, a render
+ * failed, or its Scope closed), `settled` the only way to wait for the event dispatches the mount made, `dispatched` the only record of their outcomes.
+ * Hosts that need none of them can ignore the value. The lifecycle of each member is stated in "Canonical lifecycle architecture" (docs/FINDINGS.md).
+ */
+export interface Mounted<E> {
+    /**
+     * The exit of every dispatch this mount made for a reported event, appended as each one settles (settle order, never removed, never reordered).
+     * The only place the outcome of an event-triggered command is recorded: a failure or a defect appears nowhere else (not in state, values or the render).
+     * It belongs to the mount that dispatched, so exits keep arriving after that mount closed (a command is the application's once admitted, and ends with
+     * the application at the latest). It is an observation facility for hosts and tests, not part of the application programming model: nothing in
+     * Valance reads it, and `ApplicationHandle` does not expose it. It lives as long as the `Mounted` value is held.
+     */
+    readonly dispatched: ReadonlyArray<DispatchExit<E>>;
+    /**
+     * A barrier: succeeds once every dispatch this OPEN mount has made so far has settled (and those made while it waits). It does not read `dispatched`.
+     * A closed mount holds no dispatches, so `settled` returns at once and does not wait for the exits that are still to arrive in `dispatched`.
+     */
+    readonly settled: Effect.Effect<void>;
+    /** Completes when Valance stops following renders: Success when the application ended, a Failure when a render failed, Interrupted when the scope closed. */
+    readonly followed: Effect.Effect<Exit.Exit<void, Nexus.Mesh.MeshDiagnostics>>;
+}
+/**
+ * Draws the application's current render on a target, and keeps it current. Ends with the caller's Scope: the mount's lifetime is that Scope's,
+ * whatever Scope it is. If the application ends first (its own Scope closed), the follower ends (`Mounted.followed` Success) but the target stays
+ * drawn, inert, until this Scope closes.
+ */
+export declare const mount: <S, E>(application: ApplicationHandle<S, E>, create: TargetFactory<Target>) => Effect.Effect<Mounted<E>, Nexus.Mesh.MeshDiagnostics, Scope.Scope>;
+/**
+ * Takes over server output with the client's own render (never the server's), then keeps it current.
+ * What adoption or mismatch means is PORT's: `hydration` is its result, unchanged.
+ */
+export declare const hydrate: <S, E, H>(application: ApplicationHandle<S, E>, create: TargetFactory<HydratableTarget<H>>) => Effect.Effect<Mounted<E> & {
+    readonly hydration: H;
+}, Nexus.Mesh.MeshDiagnostics, Scope.Scope>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,142 @@
+import * as Nexus from "@valancex/nexus";
+import { handleOf, runningOf } from "./internal.js";
+import { Deferred, Effect, Exit, Fiber, Layer, Stream } from "effect";
+/** The definition, typed. An application is data: defining one starts nothing. */
+export const define = (definition) => definition;
+/**
+ * Starts the application. Its lifetime is the caller's `Scope`: closing it ends the application and its state, and
+ * Valance keeps nothing that outlives that scope. (NEXUS can also end an application early; that is the substrate's,
+ * is outside this model, and nothing here asks for it. The command drain below belongs to the Scope close, so that route does not pass it.)
+ */
+export const start = (app, options = {}) => Effect.gen(function* () {
+    const definition = Nexus.Application.define({ name: app.name, runtime: Layer.empty });
+    const nexus = yield* Nexus.Application.start(definition, options.platform === undefined ? undefined : { platform: options.platform });
+    // Command lifetime: a command admitted through `inApplication` stays owned by the application until it exits. When the
+    // application's Scope closes, VALANCE closes admission and interrupts and awaits every admitted command BEFORE NEXUS
+    // terminates and the platform releases its resources. This finalizer is added right after `Application.start` registered
+    // NEXUS's own; Scope finalizers run in reverse order, so it runs first. It owns commands only, not daemons or escaped fibers.
+    const admitted = new Set();
+    let admissionClosed = false;
+    yield* Effect.addFinalizer(() => Effect.suspend(() => {
+        admissionClosed = true; // closes synchronously, before anything below can run
+        return Effect.forEach([...admitted], (command) => Fiber.interrupt(command), { discard: true }); // interrupts, and awaits each ACTUAL exit
+    }));
+    const state = yield* Nexus.Application.createState(nexus, app.state.schema, options.state ?? app.state.initial);
+    const commands = app.commands(state);
+    // One host per view, used to dispatch (render, handler) → intent → command. The one NEXUS state is shared by all of them.
+    const hosts = new Map(Object.entries(app.views).map(([name, view]) => [name, Nexus.Mesh.host({ program: view.program, scope: Nexus.Selector.define(state, view.scope), commands })]));
+    // The render of one given state. The adapter renders a host's scope value, not a value it is handed, and a
+    // sequential stream must render each emitted state exactly: a constant scope does that.
+    const renderOf = (value) => {
+        const view = app.view(value);
+        const snapshot = app.views[view].scope(value);
+        const scope = { value: Effect.succeed(snapshot), changes: Stream.empty, values: Stream.make(snapshot) };
+        return Nexus.Mesh.host({ program: app.views[view].program, scope, commands: {} }).render.pipe(Effect.map((render) => ({ view, render })));
+    };
+    // The one place an event enters the application's execution: its own fiber, with its own FiberRefs (NEXUS
+    // `runFork`: the handle holds none of them, so joining it imports nothing into the caller). The caller's
+    // interruption interrupts the event; results, typed failures and defects pass through unchanged.
+    // Admission: the command registers ITS OWN fiber as its first step. The admission check and the registration are one
+    // synchronous step inside that fiber (no gap in which the drain's snapshot could be taken between them); a refusal is a
+    // defect, by Effect's own means. The command leaves the registry on every exit.
+    const admit = (effect) => Effect.acquireUseRelease(Effect.withFiberRuntime((fiber) => Effect.sync(() => {
+        if (admissionClosed) {
+            throw new Error("VALANCE: admission is closed (draining)");
+        }
+        admitted.add(fiber);
+    })), () => effect, () => Effect.withFiberRuntime((fiber) => Effect.sync(() => { admitted.delete(fiber); })));
+    const inApplication = (effect) => Effect.suspend(() => {
+        const handle = Nexus.Runtime.runFork(nexus.runtime, admit(effect));
+        return Fiber.join(handle).pipe(Effect.onInterrupt(() => Fiber.interrupt(handle)));
+    });
+    const running = {
+        nexus,
+        render: Effect.flatMap(state.get, renderOf),
+        values: Stream.mapEffect(state.values, renderOf),
+        dispatch: (viewed, handler, payload) => {
+            const host = hosts.get(viewed.view);
+            return host === undefined ? Effect.die(new Error(`no view named ${viewed.view}`)) : inApplication(host.dispatch(viewed.render, handler, payload));
+        },
+        state: state.get,
+        states: state.values,
+        invoke: (key, args) => {
+            const binding = Object.hasOwn(commands, key) ? commands[key] : undefined;
+            const [component = "", name = ""] = key.split("/");
+            return binding === undefined ? Effect.fail({ _tag: "UnmappedCommand", component, name }) : inApplication(binding(args));
+        },
+    };
+    return handleOf(running);
+});
+const connect = (application, create, first) => Effect.gen(function* () {
+    const running = runningOf(application);
+    const scope = yield* Effect.scope;
+    // The render whose tree is drawn: the only render an event may be dispatched with (NEXUS M1, M2).
+    const drawn = { current: undefined };
+    const dispatched = [];
+    const pending = [];
+    const target = create((handler, payload) => {
+        const render = drawn.current;
+        if (render === undefined) {
+            throw new Error("the target reported an interaction before anything was drawn");
+        }
+        // `dispatch` runs inside the application (its platform's FiberRefs apply) and nothing flows back (NEXUS I44).
+        pending.push(Effect.runFork(Effect.exit(running.dispatch(render, handler, payload)).pipe(Effect.tap((exit) => Effect.sync(() => { dispatched.push(exit); })))));
+    });
+    // `running.values` is the render of the current state, then one per later commit, atomically (NEXUS 0.10): the
+    // first element is the first draw (or hydration), no commit can fall between. A later render of the SAME view is
+    // the same program: update. One of ANOTHER view is another program, and only the composer knows that: draw afresh.
+    // The follower is Valance's fiber, not NEXUS's (O15): the caller's scope owns it.
+    const firstDone = yield* Deferred.make();
+    const follower = yield* Stream.runForEach(running.values, (viewed) => Effect.suspend(() => {
+        if (drawn.current !== undefined) {
+            if (drawn.current.view === viewed.view) {
+                target.update(viewed.render.tree);
+            }
+            else {
+                target.draw(viewed.render.tree);
+            }
+            drawn.current = viewed;
+            return Effect.void;
+        }
+        // Draw or hydrate, and retain the render, in one synchronous step: no event can be reported in between.
+        const result = first(target, viewed.render.tree);
+        drawn.current = viewed;
+        return Deferred.succeed(firstDone, result);
+    })).pipe(
+    // Ending before the first render (a diagnostic, a failure of the target, an application that ended) is mount's failure.
+    Effect.onExit((exit) => Exit.match(exit, {
+        onFailure: (cause) => Deferred.failCause(firstDone, cause),
+        onSuccess: () => Deferred.die(firstDone, new Error("the application ended before its first render")),
+    })), Effect.forkIn(scope));
+    const result = yield* Deferred.await(firstDone);
+    // Scope finalizers run in reverse: this runs before the application ends.
+    yield* Effect.addFinalizer(() => Effect.gen(function* () {
+        yield* Fiber.interrupt(follower);
+        yield* Effect.sync(() => { target.unmount(); });
+        // A command an event started is the APPLICATION's once admitted (C20): closing the mount ends the follower and the target, not the command.
+        // The mount only lets go of the dispatch fibers it held; the application's registry still owns, drains and interrupts them (Stage 39).
+        yield* Effect.sync(() => { pending.splice(0); });
+    }));
+    // Dispatches may start more dispatches' worth of work only through the target, so draining until empty terminates.
+    const settled = Effect.suspend(() => pending.length === 0
+        ? Effect.void
+        : Effect.forEach(pending.splice(0), Fiber.await, { discard: true }).pipe(Effect.andThen(settled)));
+    return {
+        first: result,
+        dispatched,
+        settled,
+        followed: Fiber.await(follower),
+    };
+});
+/**
+ * Draws the application's current render on a target, and keeps it current. Ends with the caller's Scope: the mount's lifetime is that Scope's,
+ * whatever Scope it is. If the application ends first (its own Scope closed), the follower ends (`Mounted.followed` Success) but the target stays
+ * drawn, inert, until this Scope closes.
+ */
+export const mount = (application, create) => Effect.map(connect(application, create, (target, tree) => { target.draw(tree); }), ({ first: _, ...mounted }) => mounted);
+/**
+ * Takes over server output with the client's own render (never the server's), then keeps it current.
+ * What adoption or mismatch means is PORT's: `hydration` is its result, unchanged.
+ */
+export const hydrate = (application, create) => Effect.map(connect(application, create, (target, tree) => target.hydrate(tree)), ({ first, ...mounted }) => ({ ...mounted, hydration: first }));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/internal.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The composition protocol between Valance's core and the code that binds an application to something outside it
+ * (a PORT target, browser history, a server render, a test). It is NOT the application's face: the public handle
+ * (`ApplicationHandle`, from the package entry) carries only `state` and `invoke`, and does not reach this.
+ *
+ * `Running` is what `start` builds. A handle is registered against the `Running` it fronts in a module-private map,
+ * so nothing reachable from a handle leads here; only code that imports this module (the package's own bindings and,
+ * through the `./internal` entry, binding authors and tests) can resolve one. Unstable by design.
+ */
+import type * as Nexus from "@valancex/nexus";
+import type { Effect, Exit, Stream } from "effect";
+import type { ApplicationHandle } from "./index.js";
+/**
+ * How one event dispatch ended, as `Mounted.dispatched` records it: what MESH dispatched, or why it did not (a MESH diagnostic, an unmapped
+ * command, the command's own typed failure, a defect, interruption). A diagnostic type: it is not nameable from the package entry, which commits to
+ * no consumer of it (Stage 42); readers of `dispatched` use its structure.
+ */
+export type DispatchExit<E> = Exit.Exit<Nexus.Mesh.Dispatched, Nexus.Mesh.MeshDiagnostics | Nexus.Mesh.UnmappedCommand | E>;
+/** A MESH render, and which view's program made it. Program continuity is "same view as the drawn one". */
+export interface Viewed {
+    readonly view: string;
+    readonly render: Nexus.Mesh.Render;
+}
+export interface Running<S, E> {
+    /** The NEXUS application. Read only to observe the substrate (a test); never needed to deliver an event. */
+    readonly nexus: Nexus.Application.RunningApplication<never>;
+    /** The render of the current state, in the view the current state selects. */
+    readonly render: Effect.Effect<Viewed, Nexus.Mesh.MeshDiagnostics>;
+    /** The render of the state current at subscription, then one per later commit, in order, with no gap (NEXUS `State.values`). */
+    readonly values: Stream.Stream<Viewed, Nexus.Mesh.MeshDiagnostics>;
+    /**
+     * Dispatches an event against exactly the render it was reported on, through its own view's command table. It runs
+     * in the application, whoever calls it: the caller needs no runtime.
+     */
+    readonly dispatch: (viewed: Viewed, handler: string, payload?: Parameters<Nexus.Mesh.Host<never, never>["dispatch"]>[2]) => Effect.Effect<Nexus.Mesh.Dispatched, Nexus.Mesh.MeshDiagnostics | Nexus.Mesh.UnmappedCommand | E>;
+    /** The application's state, read only. */
+    readonly state: Effect.Effect<S>;
+    /** The state current at subscription, then every later commit, with no gap (NEXUS `State.values`). Read only. */
+    readonly states: Stream.Stream<S>;
+    /** Runs the command bound to `key`, in the application's own context (see `ApplicationHandle.invoke`). */
+    readonly invoke: (key: string, args: ReadonlyArray<Nexus.Mesh.IntentArgument>) => Effect.Effect<unknown, Nexus.Mesh.UnmappedCommand | E>;
+}
+/** The public face of a `Running`: its `state` and `invoke`, and nothing else. Registered, so bindings can resolve it. */
+export declare const handleOf: <S, E>(running: Running<S, E>) => ApplicationHandle<S, E>;
+/** The `Running` a handle fronts. For bindings (and tests): an application's caller never needs it. */
+export declare const runningOf: <S, E>(handle: ApplicationHandle<S, E>) => Running<S, E>;
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC;AAE5H,2GAA2G;AAC3G,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,OAAO,CAAC,CAAC,EAAE,CAAC;IAC3B,4GAA4G;IAC5G,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC5D,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnE,gIAAgI;IAChI,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC;IAC9N,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACjC,iHAAiH;IACjH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAClC,0GAA0G;IAC1G,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC;CAC1I;AAID,0HAA0H;AAC1H,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,EAAE,SAAS,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAM7E,CAAC;AAEF,uGAAuG;AACvG,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAQ7E,CAAC"}

package/dist/internal.js

@@ -0,0 +1,16 @@
+const registry = new WeakMap();
+/** The public face of a `Running`: its `state` and `invoke`, and nothing else. Registered, so bindings can resolve it. */
+export const handleOf = (running) => {
+    const handle = Object.freeze({ state: running.state, invoke: running.invoke });
+    registry.set(handle, running);
+    return handle;
+};
+/** The `Running` a handle fronts. For bindings (and tests): an application's caller never needs it. */
+export const runningOf = (handle) => {
+    const running = registry.get(handle);
+    if (running === undefined) {
+        throw new Error("not an application handle that Valance started");
+    }
+    return running;
+};
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AA8CA,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAiC,CAAC;AAE9D,0HAA0H;AAC1H,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAO,OAAsB,EAA2B,EAAE;IAChF,MAAM,MAAM,GAA4B,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAExG,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,OAA2C,CAAC,CAAC;IAElE,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,uGAAuG;AACvG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAO,MAA+B,EAAiB,EAAE;IAChF,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAErC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,OAAmC,CAAC;AAC7C,CAAC,CAAC"}

package/dist/web-server.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Server rendering for the Web target: start the application, take its current MESH render, and let
+ * PORT's server entry write it as HTML. The state is returned so the application can embed it for the
+ * client: serializing it into a page is the application's job, not NEXUS's, PORT's or Valance's.
+ */
+import type { Mesh } from "@valancex/nexus";
+import type { WebPrimitives } from "@valancex/port-web/server";
+import type { Ambient, ApplicationDefinition, StartError, StartOptions } from "./index.js";
+import { Effect } from "effect";
+export interface Served<S> {
+    readonly html: string;
+    readonly state: S;
+}
+/** Starts the application, renders it once, and ends it. No target object, no DOM. */
+export declare const renderToHtml: <S, E, R extends Ambient, V extends string>(app: ApplicationDefinition<S, E, R, V>, options: StartOptions<S> & {
+    readonly primitives: WebPrimitives;
+}) => Effect.Effect<Served<S>, StartError | Mesh.MeshDiagnostics>;
+//# sourceMappingURL=web-server.d.ts.map

package/dist/web-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-server.d.ts","sourceRoot":"","sources":["../src/web-server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG3F,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAKhC,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;CACnB;AAED,sFAAsF;AACtF,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,MAAM,EACpE,KAAK,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACtC,SAAS,YAAY,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAA;CAAE,KAChE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC,eAAe,CAMxD,CAAC"}

package/dist/web-server.js

@@ -0,0 +1,11 @@
+import { realizeHtml } from "@valancex/port-web/server";
+import { Effect } from "effect";
+import { runningOf } from "./internal.js";
+import { start } from "./index.js";
+/** Starts the application, renders it once, and ends it. No target object, no DOM. */
+export const renderToHtml = (app, options) => Effect.scoped(Effect.gen(function* () {
+    const running = runningOf(yield* start(app, options));
+    const viewed = yield* running.render;
+    return { html: realizeHtml(viewed.render.tree, options.primitives), state: yield* running.state };
+}));
+//# sourceMappingURL=web-server.js.map

package/dist/web-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-server.js","sourceRoot":"","sources":["../src/web-server.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAOnC,sFAAsF;AACtF,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,GAAsC,EACtC,OAAiE,EACJ,EAAE,CAC/D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAChC,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAErC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;AACpG,CAAC,CAAC,CAAC,CAAC"}

package/dist/web.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The Web target for Valance: the only module that names `@valancex/port-web`.
+ * It adds nothing to PORT: it fixes `container` and `primitives` (the application's Web realization
+ * table, which is target configuration, not part of the application) and hands PORT the report callback.
+ */
+import type { WebPort, WebPortOptions } from "@valancex/port-web";
+import type { BoundaryValue } from "@valancex/mesh-runtime";
+import type { ApplicationHandle, TargetFactory } from "./index.js";
+import { Effect, Scope } from "effect";
+export type { HydrationResult, WebPrimitives } from "@valancex/port-web";
+export { attribute, booleanAttribute, property, textProperty } from "@valancex/port-web";
+export declare const target: (options: Omit<WebPortOptions, "report">) => TargetFactory<WebPort>;
+export interface HistoryOptions<S> {
+    /** The window whose URL and history are kept in step with the application (the container's own: `container.ownerDocument.defaultView`). */
+    readonly window: Window;
+    /** The URL (path and query) the application is shown at for `state`. What a URL means is the application's. */
+    readonly urlOf: (state: S) => string;
+    /** What a URL says about the application: the one argument of the navigate binding. The application's, too. */
+    readonly stateOf: (url: URL) => BoundaryValue;
+    /** The binding key of the application's navigate command, the same entry a MESH intent uses. */
+    readonly navigate: string;
+}
+/**
+ * Keeps `location` and the application in step, in both directions, until the caller's Scope closes.
+ *
+ *   start         the first state's `urlOf` is the baseline; nothing is written.
+ *   later state   `urlOf(state)` differs from the last synchronized `urlOf` → `history.pushState`, which becomes the baseline.
+ *   popstate      `running.invoke(navigate, [stateOf(location)])`, then the resulting state's `urlOf` becomes the baseline. Never a write.
+ *
+ * The question it answers is "did the application's URL change?", never "does the browser's URL equal the
+ * application's?": a page sitting at a noncanonical URL (a history entry the application did not write) is left
+ * alone, and an unrelated state change is not a navigation. Canonicalizing the URL is the application's, before start.
+ *
+ * A popstate whose navigation fails, or leaves the state unchanged, is not repaired: nothing is written, the browser
+ * stays at the URL history gave it, the baseline is the (unchanged) state's own URL, and the failure is only logged.
+ * Browser URL and application URL then differ until the next application navigation; restoring one is the application's.
+ *
+ * Popstate is handled by the same fiber that watches state, in order, so the commit a popstate causes is seen after
+ * the baseline has been updated for it, not as a new navigation. It reads and writes the URL and knows nothing of
+ * what a URL means. PORT Web has no history API (it touches nothing outside its container), so this is Valance's.
+ */
+export declare const history: <S, E>(application: ApplicationHandle<S, E>, options: HistoryOptions<S>) => Effect.Effect<void, never, Scope.Scope>;
+//# sourceMappingURL=web.d.ts.map

package/dist/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAInE,OAAO,EAAE,MAAM,EAAgB,KAAK,EAAU,MAAM,QAAQ,CAAC;AAE7D,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEzF,eAAO,MAAM,MAAM,GAAI,SAAS,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,KAAG,aAAa,CAAC,OAAO,CAAsD,CAAC;AAE7I,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,2IAA2I;IAC3I,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+GAA+G;IAC/G,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACrC,+GAA+G;IAC/G,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,aAAa,CAAC;IAC9C,gGAAgG;IAChG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,CAAC,EAAE,aAAa,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CA4CnI,CAAC"}

package/dist/web.js

@@ -0,0 +1,57 @@
+import { createWebPort } from "@valancex/port-web";
+import { runningOf } from "./internal.js";
+import { Effect, Fiber, Queue, Stream } from "effect";
+export { attribute, booleanAttribute, property, textProperty } from "@valancex/port-web";
+export const target = (options) => (report) => createWebPort({ ...options, report });
+/**
+ * Keeps `location` and the application in step, in both directions, until the caller's Scope closes.
+ *
+ *   start         the first state's `urlOf` is the baseline; nothing is written.
+ *   later state   `urlOf(state)` differs from the last synchronized `urlOf` → `history.pushState`, which becomes the baseline.
+ *   popstate      `running.invoke(navigate, [stateOf(location)])`, then the resulting state's `urlOf` becomes the baseline. Never a write.
+ *
+ * The question it answers is "did the application's URL change?", never "does the browser's URL equal the
+ * application's?": a page sitting at a noncanonical URL (a history entry the application did not write) is left
+ * alone, and an unrelated state change is not a navigation. Canonicalizing the URL is the application's, before start.
+ *
+ * A popstate whose navigation fails, or leaves the state unchanged, is not repaired: nothing is written, the browser
+ * stays at the URL history gave it, the baseline is the (unchanged) state's own URL, and the failure is only logged.
+ * Browser URL and application URL then differ until the next application navigation; restoring one is the application's.
+ *
+ * Popstate is handled by the same fiber that watches state, in order, so the commit a popstate causes is seen after
+ * the baseline has been updated for it, not as a new navigation. It reads and writes the URL and knows nothing of
+ * what a URL means. PORT Web has no history API (it touches nothing outside its container), so this is Valance's.
+ */
+export const history = (application, options) => Effect.gen(function* () {
+    const running = runningOf(application);
+    const scope = yield* Effect.scope;
+    const { window: win } = options;
+    const popped = yield* Queue.unbounded();
+    // The application URL of the last state this mechanism has accounted for. Unset until the first state: the baseline.
+    let last;
+    const follower = yield* Stream.runForEach(Stream.merge(Stream.map(running.states, (state) => ({ _tag: "state", state })), Stream.map(Stream.fromQueue(popped), (href) => ({ _tag: "popstate", href }))), (event) => event._tag === "state"
+        ? Effect.sync(() => {
+            const url = options.urlOf(event.state);
+            if (last === undefined) {
+                last = url;
+            }
+            else if (url !== last) {
+                last = url;
+                win.history.pushState(null, "", url);
+            }
+        })
+        : Effect.gen(function* () {
+            // Through the application's own entry: it runs in the application, and a failure or defect is logged, never the follower's.
+            yield* running.invoke(options.navigate, [{ value: options.stateOf(new URL(event.href)) }]).pipe(Effect.catchAllCause((cause) => Effect.logError("popstate navigation failed", cause)));
+            // The state the popstate produced is the new baseline, whatever URL history happens to hold for it.
+            last = options.urlOf(yield* running.state);
+        })).pipe(Effect.forkIn(scope));
+    const onPopState = () => { Queue.unsafeOffer(popped, win.location.href); };
+    win.addEventListener("popstate", onPopState);
+    // Reverse order of the scope: before the application ends.
+    yield* Effect.addFinalizer(() => Effect.gen(function* () {
+        yield* Effect.sync(() => { win.removeEventListener("popstate", onPopState); });
+        yield* Fiber.interrupt(follower);
+    }));
+});
+//# sourceMappingURL=web.js.map

package/dist/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@valancex/valance",
+  "version": "0.1.0",
+  "description": "VALANCE application composition: starts a NEXUS application, renders it with MESH, and realizes it on a PORT target.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Jack Miller <jackmiller0899@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ValanceX/Valance.git",
+    "directory": "packages/valance"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./web": {
+      "types": "./dist/web.d.ts",
+      "default": "./dist/web.js"
+    },
+    "./web/server": {
+      "types": "./dist/web-server.d.ts",
+      "default": "./dist/web-server.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "default": "./dist/internal.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@valancex/nexus": "^0.10.1"
+  },
+  "peerDependencies": {
+    "@valancex/mesh-runtime": "^0.7.0",
+    "@valancex/port-web": "^0.2.2",
+    "effect": "^3.10.0"
+  },
+  "peerDependenciesMeta": {
+    "@valancex/port-web": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@valancex/mesh-runtime": "^0.7.0",
+    "@valancex/port-web": "^0.2.2",
+    "effect": "^3.10.0",
+    "typescript": "^5.6.0",
+    "vitest": "^3.2.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
+    "test": "vitest run"
+  }
+}