@nomix-ai/nomix-harness 0.2.5 → 0.2.6

package/dist/kernel/client-ui-renderer/lib/index.js

@@ -0,0 +1,6 @@
+//#region lib/types/index.js
+/** Host loader entry for the browser-only UI renderer. */
+/** Provides no host-side behavior. */
+function apply() {}
+//#endregion
+export { apply };

package/dist/kernel/client-ui-renderer/lib/invariant.js

@@ -0,0 +1,23 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@nomix-ai/nomix-client-ui-renderer`.
+* @module @nomix-ai/nomix-client-ui-renderer/invariant
+*/
+const PACKAGE_NAME = "@nomix-ai/nomix-client-ui-renderer";
+/** Cordis companion plugin name. */
+const name = "client-ui-renderer-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: the package installs the render adapter and provides a
+* mount callback but owns no event stream or mutable cross-plugin data relation.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/dist/kernel/{client-web/lib/types → client-ui-renderer/lib/types/client}/DocumentTitle.d.ts

@@ -1,13 +1,13 @@
-/** Props for the shell-owned browser title projection. */
+/** Props for the browser title projection. */
 export interface DocumentTitleProps {
     /** Durable title of the selected session, or undefined for the product title. */
     title?: string;
 }
 /**
  * Project the selected durable session title into the browser title and
- * restore the shell's original product title when unmounted.
- * @param props - selected session title projection.
- * @returns no rendered content.
+ * restore the build-selected product title when unmounted.
+ * @param props - Selected session title projection.
+ * @returns No rendered content.
  */
 export declare function DocumentTitle({ title }: DocumentTitleProps): null;
 //# sourceMappingURL=DocumentTitle.d.ts.map

package/dist/kernel/client-ui-renderer/lib/types/client/DocumentTitle.js

@@ -0,0 +1,17 @@
+import { useEffect } from 'react';
+const DEFAULT_CLIENT_TITLE = 'NOMIX Local Build';
+/**
+ * Project the selected durable session title into the browser title and
+ * restore the build-selected product title when unmounted.
+ * @param props - Selected session title projection.
+ * @returns No rendered content.
+ */
+export function DocumentTitle({ title }) {
+    const productTitle = process.env.NOMIX_CLIENT_TITLE ?? DEFAULT_CLIENT_TITLE;
+    useEffect(() => {
+        document.title = title === undefined ? productTitle : `${title} — ${productTitle}`;
+        return () => { document.title = productTitle; };
+    }, [productTitle, title]);
+    return null;
+}
+//# sourceMappingURL=DocumentTitle.js.map

package/dist/kernel/client-ui-renderer/lib/types/client/app.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Real-UI assembly closure. The whole layout tree hangs from the built-in
+ * `root` slot, which is the only ctx-level slot render in the application.
+ */
+import type { ReactNode } from 'react';
+import type { Context } from '../../../../cordis/lib/index.js';
+/** Inputs available after the UI renderer's inject set activates. */
+export interface AssemblyDeps {
+    /** Client context carrying the slots and sessions services. */
+    ctx: Context;
+}
+/**
+ * Build the assembled application factory.
+ * @param deps - Active UI-renderer dependencies.
+ * @returns Factory producing the application React tree.
+ */
+export declare function buildRenderApp(deps: AssemblyDeps): () => ReactNode;
+//# sourceMappingURL=app.d.ts.map

package/dist/kernel/{client-web/lib/types → client-ui-renderer/lib/types/client}/app.js

@@ -1,16 +1,16 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { bindSnapshotSelector } from '../../../client-web-react/lib/index.js';
+import { bindSnapshotSelector } from "./bind.js";
 import { DocumentTitle } from "./DocumentTitle.js";
 /**
- * Build the renderApp factory the app-shell plugin provides to AppRoot.
- * @param deps - assembly inputs.
- * @returns factory producing the real UI tree (called once per AppRoot render after settled).
+ * Build the assembled application factory.
+ * @param deps - Active UI-renderer dependencies.
+ * @returns Factory producing the application React tree.
  */
 export function buildRenderApp(deps) {
     const { ctx } = deps;
     const sessions = ctx.get('sessions');
     if (sessions === undefined)
-        throw new Error('shell assembly: sessions service unavailable');
+        throw new Error('ui renderer: sessions service unavailable');
     const useSessions = bindSnapshotSelector(sessions.list);
     const SessionDocumentTitle = () => {
         const title = useSessions((state) => {

package/dist/kernel/{client-web-react/lib/types → client-ui-renderer/lib/types/client}/bind.d.ts

@@ -1,4 +1,4 @@
-import type { HostObservable, SnapshotSelectorHook } from '../../../client-ui-slots/lib/index.js';
+import type { HostObservable, SnapshotSelectorHook } from '../../../../client-ui-slots/lib/index.js';
 /**
  * Bind a bare observable source to a typed uSES selector hook.
  * subscribe/getSnapshot are captured once per source into stable closures

package/dist/kernel/client-ui-renderer/lib/types/client/index.d.ts

@@ -0,0 +1,29 @@
+import type { Context } from '../../../../cordis/lib/index.js';
+import type { SnapshotSelectorHook } from '../../../../client-ui-slots/lib/index.js';
+/** Selector hook over a session's conversation snapshot. */
+export type UseSession<Snap extends object = object> = SnapshotSelectorHook<Snap>;
+export type { ChainRenderOpts, HostObservable, RenderOpts, SessionProvideInfo, SnapshotSelectorHook, SlotRenderer, SlotRendererHost, StoreInstanceLike, } from '../../../../client-ui-slots/lib/index.js';
+export type { SessionProviderProps } from './session-provider.tsx';
+/** Mount operation exposed to the framework-free boot kernel. */
+export interface UiRendererService {
+    /**
+     * Mount the assembled application into the supplied element.
+     * @param container - Application mount point.
+     * @returns Disposer that unmounts the React root.
+     */
+    mount: (container: HTMLElement) => () => void;
+}
+declare module '@nomix-ai/cordis' {
+    interface Context {
+        /** Mount face provided after the UI renderer activates. */
+        uiRenderer: UiRendererService;
+    }
+}
+/** Services required before application assembly. */
+export declare const inject: string[];
+/**
+ * Install the slot renderer and provide the application mount face.
+ * @param ctx - Plugin context.
+ */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/kernel/client-ui-renderer/lib/types/client/index.js

@@ -0,0 +1,51 @@
+/**
+ * Browser UI renderer. It installs the slot renderer after its Cordis
+ * dependencies activate and exposes the mount operation used by the web boot
+ * kernel after the complete client roster settles.
+ */
+import { createElement, useLayoutEffect, useState } from 'react';
+import { flushSync } from 'react-dom';
+import { createRoot, hydrateRoot } from 'react-dom/client';
+import { createSlotRenderer } from "./scoped-slots.js";
+import { buildRenderApp } from "./app.js";
+/** Services required before application assembly. */
+export const inject = ['slots', 'sessions'];
+/** Hydrate the kernel-owned loading DOM before replacing it with the application. */
+function BootHandoff(props) {
+    const [ready, setReady] = useState(false);
+    useLayoutEffect(() => { setReady(true); }, []);
+    if (ready)
+        return props.app();
+    return createElement('div', {
+        className: props.boot.className,
+        'data-nomix-boot': '',
+        dangerouslySetInnerHTML: { __html: props.boot.html },
+    });
+}
+/** Mount React while preserving the framework-free boot DOM through hydration. */
+function mountApp(container, app) {
+    const boot = container.querySelector(':scope > [data-nomix-boot]');
+    if (boot !== null) {
+        return hydrateRoot(container, createElement(BootHandoff, {
+            app,
+            boot: { className: boot.className, html: boot.innerHTML },
+        }));
+    }
+    const root = createRoot(container);
+    flushSync(() => { root.render(app()); });
+    return root;
+}
+/**
+ * Install the slot renderer and provide the application mount face.
+ * @param ctx - Plugin context.
+ */
+export function apply(ctx) {
+    ctx.slots.install(createSlotRenderer());
+    ctx.reflect.provide('uiRenderer', {
+        mount: (container) => {
+            const root = mountApp(container, buildRenderApp({ ctx }));
+            return () => { root.unmount(); };
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/kernel/{client-web-react/lib/types → client-ui-renderer/lib/types/client}/scoped-slots.d.ts

@@ -1,4 +1,4 @@
-import { type SlotRenderer } from '../../../client-ui-slots/lib/index.js';
+import { type SlotRenderer } from '../../../../client-ui-slots/lib/index.js';
 /**
  * Build the renderer the shell installs into the runtime SlotRegistry
  * (ctx.slots.install(createSlotRenderer()) at boot; the service owns the

package/dist/kernel/{client-web-react/lib/types → client-ui-renderer/lib/types/client}/scoped-slots.js

@@ -4,7 +4,7 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
  * authorization, and entry boundaries contain registrant failures.
  */
 import { Component, useMemo, useState, useSyncExternalStore } from 'react';
-import { SlotOwnershipError, StaleAuthorizationError, } from '../../../client-ui-slots/lib/index.js';
+import { SlotOwnershipError, StaleAuthorizationError, } from '../../../../client-ui-slots/lib/index.js';
 import { HostContext, SessionMaybeProvider, SessionProvider, SlotAssemblyError, maybeObservableHook, observableHook, projectionHook, useHost, useSessionMaybeProvideInfo, } from "./session-provider.js";
 /**
  * Per-entry renderSlot bindings. The binding is identity-stable per entry

package/dist/kernel/{client-web-react/lib/types → client-ui-renderer/lib/types/client}/session-provider.d.ts

@@ -1,6 +1,6 @@
 /** Internal React bindings for the renderer host and active session provide bundle. */
 import { type ReactNode } from 'react';
-import type { HostObservable, MaybeSnapshotSelectorHook, SessionMaybeProvideInfo, SessionProvideInfo, SlotRendererHost, SnapshotSelectorHook } from '../../../client-ui-slots/lib/index.js';
+import type { HostObservable, MaybeSnapshotSelectorHook, SessionMaybeProvideInfo, SessionProvideInfo, SlotRendererHost, SnapshotSelectorHook } from '../../../../client-ui-slots/lib/index.js';
 /**
  * A missing-provider assembly error: the shell wired the tree wrong. The slot
  * error boundary rethrows this class so misassembly stays fail-loud while

package/dist/kernel/client-ui-renderer/lib/types/index.d.ts

@@ -0,0 +1,4 @@
+/** Host loader entry for the browser-only UI renderer. */
+/** Provides no host-side behavior. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/kernel/client-ui-renderer/lib/types/index.js

@@ -0,0 +1,4 @@
+/** Host loader entry for the browser-only UI renderer. */
+/** Provides no host-side behavior. */
+export function apply() { }
+//# sourceMappingURL=index.js.map

package/dist/kernel/{client-web-react → client-ui-renderer}/lib/types/invariant.d.ts

@@ -1,10 +1,10 @@
 /**
- * Package-owned invariant companion for `@nomix-ai/nomix-client-web-react`.
- * @module @nomix-ai/nomix-client-web-react/invariant
+ * Package-owned invariant companion for `@nomix-ai/nomix-client-ui-renderer`.
+ * @module @nomix-ai/nomix-client-ui-renderer/invariant
  */
 import type { Context } from '../../../cordis/lib/index.js';
 /** Cordis companion plugin name. */
-export declare const name = "client-web-react-invariant";
+export declare const name = "client-ui-renderer-invariant";
 /** Service required before the companion can reserve package ownership. */
 export declare const inject: string[];
 /**

package/dist/kernel/client-ui-renderer/lib/types/invariant.js

@@ -0,0 +1,22 @@
+/**
+ * Package-owned invariant companion for `@nomix-ai/nomix-client-ui-renderer`.
+ * @module @nomix-ai/nomix-client-ui-renderer/invariant
+ */
+const PACKAGE_NAME = '@nomix-ai/nomix-client-ui-renderer';
+/** Cordis companion plugin name. */
+export const name = 'client-ui-renderer-invariant';
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants'];
+/**
+ * No runtime invariant: the package installs the render adapter and provides a
+ * mount callback but owns no event stream or mutable cross-plugin data relation.
+ */
+const install = () => { };
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+/* jscpd:ignore-end */
+//# sourceMappingURL=invariant.js.map

package/dist/kernel/client-ui-renderer/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@nomix-ai/nomix-client-ui-renderer",
+  "description": "Browser UI renderer: React slot bindings, ctx.uiRenderer, and the assembled application root",
+  "version": "0.2.6",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ditgaldev/nomix-harness.git",
+    "directory": "packages/client/ui-renderer"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "nomix": {
+    "client": {
+      "inject": [
+        "@nomix-ai/nomix-client-runtime"
+      ],
+      "platform": "web",
+      "immediately": true
+    }
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "use-sync-external-store": "1.2.0"
+  },
+  "peerDependencies": {
+    "@nomix-ai/nomix-client-runtime": "workspace:^",
+    "@nomix-ai/nomix-invariants": "workspace:^",
+    "@nomix-ai/cordis": "workspace:^"
+  },
+  "devDependencies": {
+    "@nomix-ai/nomix-client-runtime": "workspace:^",
+    "@nomix-ai/nomix-client-test-runtime": "workspace:^",
+    "@nomix-ai/nomix-client-ui-slots": "workspace:^",
+    "@nomix-ai/nomix-invariants": "workspace:^",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
+    "@nomix-ai/cordis": "workspace:^",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ]
+}