@north-light/crouter 0.3.170 → 0.3.172

package/dist/web/ViewChrome.d.ts

@@ -1,7 +0,0 @@
-import type { JSX, ReactNode } from 'react';
-import type { ChromeState } from '../core/view/contract.js';
-export declare function ViewChrome({ chrome, title, children }: {
-    chrome: ChromeState;
-    title: string;
-    children: ReactNode;
-}): JSX.Element;

package/dist/web/ViewChrome.js

@@ -1,28 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { deriveState } from '../core/view/chrome.js';
-const CHIP_LABEL = {
-    working: 'working',
-    blocked: 'blocked',
-    attention: 'attention',
-    ready: 'ready',
-    idle: 'idle',
-};
-const CHIP_DOT = {
-    working: 'bg-blue-500',
-    blocked: 'bg-red-500',
-    attention: 'bg-amber-500',
-    ready: 'bg-green-500',
-    idle: 'bg-slate-400',
-};
-const BANNER_BAR = {
-    info: 'bg-slate-100 text-slate-800 border-slate-300',
-    action: 'bg-amber-100 text-amber-900 border-amber-300',
-    error: 'bg-red-100 text-red-900 border-red-300',
-};
-export function ViewChrome({ chrome, title, children }) {
-    // deriveState's contract: an explicit interaction mode overrides the derived
-    // chip, and each target's renderer applies that precedence. Web keeps the mode
-    // as its own header pill (the §4.1 web idiom) AND lets it win the chip.
-    const chip = chrome.mode ? 'attention' : deriveState(chrome);
-    return (_jsxs("div", { className: "min-h-screen bg-white text-slate-900", children: [_jsxs("header", { className: "flex items-center gap-3 border-b border-slate-200 px-4 py-2", children: [_jsx("h1", { className: "font-mono text-sm font-semibold", children: title }), chrome.subtitle ? (_jsxs("span", { className: "font-mono text-xs text-slate-400", children: ["\u00B7 ", chrome.subtitle] })) : null, chrome.mode ? (_jsx("span", { className: "rounded-full bg-slate-800 px-2 py-0.5 text-xs text-white", children: chrome.mode })) : null, _jsxs("span", { className: "ml-auto flex items-center gap-2 text-xs text-slate-500", children: [chrome.busy ? (_jsx("span", { className: "inline-block h-3 w-3 animate-spin rounded-full border-2 border-slate-300 border-t-slate-600" })) : null, _jsx("span", { className: `inline-block h-2 w-2 rounded-full ${CHIP_DOT[chip]}` }), _jsx("span", { children: CHIP_LABEL[chip] })] })] }), chrome.banner ? (_jsx("div", { className: `border-b px-4 py-1.5 font-mono text-xs ${BANNER_BAR[chrome.banner.level]}`, children: chrome.banner.msg })) : null, _jsx("main", { className: "px-4 py-3", children: children }), chrome.status ? (_jsx("footer", { className: "border-t border-slate-200 px-4 py-1.5 font-mono text-xs text-slate-500", children: chrome.status })) : null] }));
-}

package/dist/web/ViewPane.d.ts

@@ -1,39 +0,0 @@
-import type { JSX, FunctionComponent } from 'react';
-import type { ViewCore, ChromeState } from '../core/view/contract.js';
-import { type IntentTap } from './runtime.js';
-type ViewPropsWeb = {
-    state: unknown;
-    dispatch: (intent: string, payload?: unknown) => void;
-    chrome: ChromeState;
-};
-type WebComponent = FunctionComponent<ViewPropsWeb>;
-export interface UseViewCoreOptions {
-    /** Frozen options map handed to core.init. */
-    options?: Record<string, string>;
-    /** Bridge endpoint for the HTTP transport; defaults to /__crtr/source. */
-    endpoint?: string;
-    /** The host TAP (§5): observe/intercept dispatched intents. */
-    onIntent?: IntentTap;
-}
-export interface ViewCoreHandle {
-    state: unknown;
-    chrome: ChromeState;
-    dispatch: (intent: string, payload?: unknown) => void;
-    /** Force an immediate refresh — the seam the shell calls on an SSE
-     *  invalidation (Wave 3). */
-    refresh: () => void;
-}
-/** Run a view core client-side and bind it to React. Returns the live state +
- *  chrome + a dispatch (and a refresh seam). The onIntent tap is read fresh on
- *  every render, so a parent can change it without tearing down the view. */
-export declare function useViewCore(core: ViewCore, opts?: UseViewCoreOptions): ViewCoreHandle;
-/** Host any dual-target view as a React component: its web component wrapped in
- *  <ViewChrome>, driven by useViewCore. Pass onIntent to tap its intents. */
-export declare function ViewPane({ core, View, options, endpoint, onIntent }: {
-    core: ViewCore;
-    View: WebComponent;
-    options?: Record<string, string>;
-    endpoint?: string;
-    onIntent?: IntentTap;
-}): JSX.Element;
-export {};

package/dist/web/ViewPane.js

@@ -1,48 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-// ViewPane.tsx — the React surface for a dual-target view. <ViewPane> and its
-// useViewCore hook are the composable replacement for the deleted imperative
-// mount(): the shell hosts many views as ordinary React components instead of
-// imperative createRoot calls.
-//
-// useViewCore wraps a createViewStore (runtime.tsx) — the framework-free dispatch
-// loop — with the React lifecycle: it creates the store once (a ref), keeps the
-// onIntent TAP fresh per render WITHOUT restarting, re-renders off the store's
-// external-store surface (useSyncExternalStore), and starts/stops the auto-poll
-// on mount/unmount.
-//
-// <ViewPane> = useViewCore + <ViewChrome> + the view's web component. When
-// onIntent is undefined a ViewPane is byte-identical to the old standalone mount
-// — the hosted view never knows it is in a shell.
-import { createElement, useEffect, useRef, useSyncExternalStore } from 'react';
-import { ViewChrome } from './ViewChrome.js';
-import { createViewStore } from './runtime.js';
-/** Run a view core client-side and bind it to React. Returns the live state +
- *  chrome + a dispatch (and a refresh seam). The onIntent tap is read fresh on
- *  every render, so a parent can change it without tearing down the view. */
-export function useViewCore(core, opts = {}) {
-    const storeRef = useRef(null);
-    if (storeRef.current === null) {
-        storeRef.current = createViewStore(core, { options: opts.options, endpoint: opts.endpoint });
-    }
-    const store = storeRef.current;
-    // Keep the TAP fresh without recreating the store (which would restart the
-    // dispatch loop and lose state).
-    store.onIntent = opts.onIntent;
-    useSyncExternalStore(store.subscribe, store.getVersion, store.getVersion);
-    useEffect(() => {
-        store.start();
-        return () => store.stop();
-    }, [store]);
-    return {
-        state: store.getState(),
-        chrome: store.getChrome(),
-        dispatch: store.dispatch,
-        refresh: store.refresh,
-    };
-}
-/** Host any dual-target view as a React component: its web component wrapped in
- *  <ViewChrome>, driven by useViewCore. Pass onIntent to tap its intents. */
-export function ViewPane({ core, View, options, endpoint, onIntent }) {
-    const { state, chrome, dispatch } = useViewCore(core, { options, endpoint, onIntent });
-    return (_jsx(ViewChrome, { chrome: chrome, title: core.manifest.title, children: createElement(View, { state, dispatch, chrome }) }));
-}

package/dist/web/index.d.ts

@@ -1,8 +0,0 @@
-export { ViewPane, useViewCore } from './ViewPane.js';
-export type { UseViewCoreOptions, ViewCoreHandle } from './ViewPane.js';
-export { createViewStore } from './runtime.js';
-export type { ViewStore, ViewStoreOptions, IntentTap } from './runtime.js';
-export { ViewChrome } from './ViewChrome.js';
-export { Loading, Empty, ErrorState, NotReady } from './states.js';
-export { findRefTokens, formatRefToken, findRefTokenAtCaret, } from '../core/memory/inline-ref-grammar.js';
-export type { RefToken, RefCaretToken } from '../core/memory/inline-ref-grammar.js';

package/dist/web/index.js

@@ -1,22 +0,0 @@
-// index.ts — the public barrel for crtr's web runtime, published as the package
-// `exports` subpath `@north-light/crouter/web` (→ ./dist/web/index.js).
-//
-// A dual-target view's `web.jsx` imports the shared four-state vocabulary +
-// (if it needs them) the chrome wrapper from here, via that stable specifier —
-// NOT a relative path from builtin-views, which would break for user/project
-// views living outside the package tree. The shell + dev Vite resolve this
-// subpath against crouter's own built barrel.
-//
-// The web shell composes views via <ViewPane>/useViewCore (the React surface)
-// over createViewStore (the framework-free dispatch loop + the onIntent tap +
-// the refresh() SSE seam).
-export { ViewPane, useViewCore } from './ViewPane.js';
-export { createViewStore } from './runtime.js';
-export { ViewChrome } from './ViewChrome.js';
-export { Loading, Empty, ErrorState, NotReady } from './states.js';
-// Inline memory-reference grammar (spec §4.1) — zero-import, browser-safe.
-// The web client imports THIS re-export (never a mirrored copy) so its
-// highlighting/completion use byte-identical logic to the broker's
-// resolution/guidance and the terminal attach viewer. See
-// `src/core/memory/inline-ref-grammar.ts` for the algorithm.
-export { findRefTokens, formatRefToken, findRefTokenAtCaret, } from '../core/memory/inline-ref-grammar.js';

package/dist/web/runtime.d.ts

@@ -1,39 +0,0 @@
-import type { ViewCore, ChromeState } from '../core/view/contract.js';
-/** Host-level pre-dispatch hook: observes every dispatched intent + its payload
- *  against a snapshot of state, before the view's own handler runs. The shell
- *  taps the small documented shell-intent vocabulary (`activate`, `open`) and
- *  lets everything else pass through untouched. */
-export type IntentTap = (name: string, payload: unknown, state: unknown) => void;
-export interface ViewStoreOptions {
-    /** Frozen options map handed to core.init (e.g. forwarded --target). */
-    options?: Record<string, string>;
-    /** Bridge endpoint for the HTTP transport; defaults to /__crtr/source. */
-    endpoint?: string;
-    /** The host TAP (§5). Omit ⇒ standalone, byte-identical to no shell. */
-    onIntent?: IntentTap;
-}
-export interface ViewStore {
-    /** Snapshot of the current view state (read after a subscribe fires). */
-    getState(): unknown;
-    /** Snapshot of the current chrome record. */
-    getChrome(): ChromeState;
-    /** Dispatch a named intent — runs the TAP, then the core handler. */
-    dispatch(intent: string, payload?: unknown): Promise<void>;
-    /** Force an immediate, busy-guarded refresh (auto-poll cb + the SSE seam). */
-    refresh(): void;
-    /** External-store subscribe (for useSyncExternalStore). */
-    subscribe(listener: () => void): () => void;
-    /** Monotonic version the external store snapshots on. */
-    getVersion(): number;
-    /** Run the first refresh + start the refreshMs auto-poll. Idempotent. */
-    start(): void;
-    /** Stop the auto-poll. Idempotent. */
-    stop(): void;
-    /** The host TAP — mutable so the React layer keeps it fresh per render
-     *  WITHOUT restarting the store. */
-    onIntent?: IntentTap;
-}
-/** Build the running store for one view (its core + the HTTP transport). The
- *  React layer (useViewCore) owns lifecycle (start on mount, stop on unmount)
- *  and re-renders off subscribe/getVersion; this factory is React-free. */
-export declare function createViewStore(core: ViewCore, opts?: ViewStoreOptions): ViewStore;

package/dist/web/runtime.js

@@ -1,232 +0,0 @@
-// runtime.tsx — the framework-agnostic dispatch-loop STORE for a dual-target
-// view. It is what <ViewPane>/useViewCore (ViewPane.tsx) are built from.
-//
-// createViewStore() seeds state from core.init, builds the IntentCtx
-// (set/resolve/execute/signal/dispatch/connect) over the HTTP transport, runs
-// the dispatch loop with the busy-guarded refreshMs auto-poll, and exposes a
-// tiny external-store surface (subscribe/getVersion) the React layer binds via
-// useSyncExternalStore. The core it drives is byte-identical to the TUI's; only
-// the injected Transport differs.
-import { initialChrome } from '../core/view/chrome.js';
-import { createHttpTransport } from './transport-http.js';
-/** Build the running store for one view (its core + the HTTP transport). The
- *  React layer (useViewCore) owns lifecycle (start on mount, stop on unmount)
- *  and re-renders off subscribe/getVersion; this factory is React-free. */
-export function createViewStore(core, opts = {}) {
-    const transport = createHttpTransport(opts.endpoint);
-    const initOptions = Object.freeze({ ...(opts.options ?? {}) });
-    let state = core.init(initOptions);
-    let chrome = initialChrome();
-    let onIntentTap = opts.onIntent;
-    // External store: a version counter the React tree subscribes to. state and
-    // chrome are read via the getters on each render; bumping `version` re-renders.
-    let version = 0;
-    const listeners = new Set();
-    const emit = () => { version += 1; for (const l of listeners)
-        l(); };
-    const subscribe = (l) => { listeners.add(l); return () => { listeners.delete(l); }; };
-    const setChrome = (patch) => { chrome = { ...chrome, ...patch }; emit(); };
-    const signal = {
-        setStatus: (msg) => setChrome({ status: msg }),
-        setBanner: (msg, level) => setChrome({ banner: { msg, level } }),
-        clearBanner: () => setChrome({ banner: null }),
-        setSubtitle: (s) => setChrome({ subtitle: s }),
-        setMode: (mode) => setChrome({ mode }),
-        // Web has no pane to leave; closing the tab is up to the user. No-op.
-        quit: () => { },
-    };
-    const streams = new Set();
-    let generation = 0;
-    let started = false;
-    let timer = null;
-    let busyDepth = 0;
-    let drainingQueue = false;
-    let dispatchQueue = [];
-    const makeCtx = () => ({
-        get state() { return state; },
-        set(next) {
-            state = typeof next === 'function' ? next(state) : next;
-            emit();
-        },
-        async resolve(source, args) {
-            const raw = await transport.send(source.request(args));
-            return source.parse(raw);
-        },
-        async execute(command, args) {
-            const raw = await transport.send(command.request(args));
-            return command.parse(raw);
-        },
-        connect(source, args) {
-            const capturedGeneration = generation;
-            let channel;
-            channel = transport.open(source.request(args), {
-                onFrame(frame) {
-                    if (capturedGeneration !== generation)
-                        return;
-                    void enqueueDispatch(source.onFrame, frame);
-                },
-                onClose(reason) {
-                    if (capturedGeneration !== generation)
-                        return;
-                    streams.delete(channel);
-                    if (source.onClose)
-                        void enqueueDispatch(source.onClose, { reason, channelId: channel.id });
-                },
-                onError(err) {
-                    if (capturedGeneration !== generation)
-                        return;
-                    setChrome({ banner: { msg: err.display.headline, level: err.display.level } });
-                },
-            });
-            streams.add(channel);
-            if (source.onOpen)
-                void enqueueDispatch(source.onOpen, channel);
-            return channel;
-        },
-        signal,
-        dispatch(intent, payload) {
-            return runIntent(intent, payload);
-        },
-    });
-    function scheduleDrain() {
-        if (drainingQueue)
-            return;
-        drainingQueue = true;
-        void drainQueue();
-    }
-    async function drainQueue() {
-        try {
-            while (started && dispatchQueue.length > 0) {
-                if (busyDepth > 0)
-                    return;
-                const job = dispatchQueue.shift();
-                try {
-                    await runIntent(job.intent, job.payload);
-                    job.resolve();
-                }
-                catch (err) {
-                    job.reject(err);
-                }
-            }
-        }
-        finally {
-            drainingQueue = false;
-            if (started && dispatchQueue.length > 0 && busyDepth === 0)
-                scheduleDrain();
-        }
-    }
-    function enqueueDispatch(intent, payload) {
-        if (!started)
-            return Promise.resolve();
-        return new Promise((resolve, reject) => {
-            dispatchQueue.push({ intent, payload, resolve, reject });
-            scheduleDrain();
-        });
-    }
-    function settleAfterIntent(intentName) {
-        if (intentName === 'refresh') {
-            chrome = { ...chrome, busy: busyDepth > 0, loaded: true, lastRefresh: Date.now() };
-            emit();
-            return;
-        }
-        chrome = { ...chrome, busy: busyDepth > 0 };
-        emit();
-    }
-    async function runIntent(intent, payload) {
-        if (!started) {
-            // The store is stopped; ignore stray external work.
-            return;
-        }
-        onIntentTap?.(intent, payload, state);
-        const fn = core.intents[intent];
-        if (!fn) {
-            // eslint-disable-next-line no-console
-            console.warn(`[crtr view] unknown intent: ${intent}`);
-            return;
-        }
-        let result;
-        try {
-            result = fn(makeCtx(), payload);
-        }
-        catch (e) {
-            // eslint-disable-next-line no-console
-            console.warn(`[crtr view] intent ${intent} threw:`, e);
-            throw e;
-        }
-        if (result instanceof Promise) {
-            const wasBusy = busyDepth > 0;
-            busyDepth += 1;
-            if (!wasBusy)
-                setChrome({ busy: true });
-            try {
-                await result;
-            }
-            finally {
-                busyDepth -= 1;
-                chrome = { ...chrome, busy: busyDepth > 0, loaded: chrome.loaded || intent === 'refresh', lastRefresh: Date.now() };
-                emit();
-                if (busyDepth === 0 && started && dispatchQueue.length > 0)
-                    scheduleDrain();
-            }
-            return;
-        }
-        settleAfterIntent(intent);
-    }
-    const refresh = () => {
-        if (busyDepth === 0)
-            void enqueueDispatch('refresh');
-    };
-    function start() {
-        if (started)
-            return;
-        started = true;
-        generation += 1;
-        state = core.init(initOptions);
-        chrome = initialChrome();
-        dispatchQueue = [];
-        drainingQueue = false;
-        void enqueueDispatch('refresh');
-        const cadence = core.manifest.refreshMs;
-        if (typeof cadence === 'number' && cadence > 0)
-            timer = setInterval(refresh, cadence);
-    }
-    function stop() {
-        if (!started)
-            return;
-        started = false;
-        generation += 1;
-        const openChannels = Array.from(streams);
-        for (const channel of openChannels) {
-            try {
-                channel.close();
-            }
-            catch {
-                /* ignore */
-            }
-        }
-        streams.clear();
-        if (timer) {
-            clearInterval(timer);
-            timer = null;
-        }
-        if (dispatchQueue.length > 0) {
-            const err = new Error('view stopped');
-            for (const job of dispatchQueue)
-                job.reject(err);
-            dispatchQueue = [];
-        }
-        drainingQueue = false;
-    }
-    return {
-        getState: () => state,
-        getChrome: () => chrome,
-        dispatch: enqueueDispatch,
-        refresh,
-        subscribe,
-        getVersion: () => version,
-        start,
-        stop,
-        get onIntent() { return onIntentTap; },
-        set onIntent(v) { onIntentTap = v; },
-    };
-}

package/dist/web/states.d.ts

@@ -1,24 +0,0 @@
-import type { JSX } from 'react';
-/** Initial load, before the first source resolves. */
-export declare function Loading({ label }: {
-    label?: string;
-}): JSX.Element;
-/** Resolved, but nothing to show. */
-export declare function Empty({ label }: {
-    label?: string;
-}): JSX.Element;
-/** A non-blocking-or-blocking failure — renders a SourceError.display verbatim. */
-export declare function ErrorState({ headline, explanation, nextStep, onRetry }: {
-    headline: string;
-    explanation?: string;
-    nextStep?: string;
-    onRetry?: () => void;
-}): JSX.Element;
-/** A precondition isn't met (e.g. not a repo / unauthed) — same shape as
- *  ErrorState but named for the "not ready to run here" case. */
-export declare function NotReady({ headline, explanation, nextStep, onRetry }: {
-    headline?: string;
-    explanation?: string;
-    nextStep?: string;
-    onRetry?: () => void;
-}): JSX.Element;

package/dist/web/states.js

@@ -1,24 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-function Center({ children }) {
-    return (_jsx("div", { className: "flex min-h-[40vh] flex-col items-center justify-center gap-2 p-8 text-center font-mono text-sm text-slate-600", children: children }));
-}
-/** Initial load, before the first source resolves. */
-export function Loading({ label = 'Loading…' }) {
-    return (_jsxs(Center, { children: [_jsx("span", { className: "inline-block h-3 w-3 animate-spin rounded-full border-2 border-slate-300 border-t-slate-600" }), _jsx("span", { children: label })] }));
-}
-/** Resolved, but nothing to show. */
-export function Empty({ label = 'Nothing here yet.' }) {
-    return (_jsx(Center, { children: _jsx("span", { className: "text-slate-400", children: label }) }));
-}
-/** A non-blocking-or-blocking failure — renders a SourceError.display verbatim. */
-export function ErrorState({ headline, explanation, nextStep, onRetry }) {
-    return (_jsxs(Center, { children: [_jsx("div", { className: "font-semibold text-red-700", children: headline }), explanation ? _jsx("div", { className: "text-slate-600", children: explanation }) : null, nextStep ? _jsx("div", { className: "text-slate-500", children: nextStep }) : null, onRetry ? _jsx(RetryButton, { onRetry: onRetry }) : null] }));
-}
-/** A precondition isn't met (e.g. not a repo / unauthed) — same shape as
- *  ErrorState but named for the "not ready to run here" case. */
-export function NotReady({ headline = 'Not ready', explanation, nextStep, onRetry }) {
-    return (_jsxs(Center, { children: [_jsx("div", { className: "font-semibold text-amber-700", children: headline }), explanation ? _jsx("div", { className: "text-slate-600", children: explanation }) : null, nextStep ? _jsx("div", { className: "text-slate-500", children: nextStep }) : null, onRetry ? _jsx(RetryButton, { onRetry: onRetry }) : null] }));
-}
-function RetryButton({ onRetry }) {
-    return (_jsx("button", { type: "button", onClick: onRetry, className: "mt-2 rounded border border-slate-300 px-3 py-1 text-slate-700 hover:bg-slate-100", children: "Retry" }));
-}

package/dist/web/transport-http.d.ts

@@ -1,5 +0,0 @@
-import type { Transport } from '../core/view/transport.js';
-/** Browser Transport → POST <endpoint> {SourceRequest} → RawResponse. Never
- *  throws: a network/bridge failure becomes a transport-level RawResponse
- *  (ok:false + stderr), exactly like the local transport's spawn failures. */
-export declare function createHttpTransport(endpoint?: string): Transport;

package/dist/web/transport-http.js

@@ -1,34 +0,0 @@
-// transport-http.ts — the browser-side Transport. send() posts declarative
-// SourceRequests to the local bridge server (`crtr view serve`'s /__crtr/source)
-// and open() connects browser stream requests to the same-origin WS relay.
-//
-// P2 DEFERRAL (Stage-C, plan C-1/C-5): the browser data plane still rides
-// `/__crtr/source` (the dev-shell bridge), NOT crtrd `/v1`. Moving the SPA onto
-// the crtrd API is a settled P2 deferral, not a P1 defect — leave as-is.
-import { openBrowserStream } from './transport-stream.js';
-/** Browser Transport → POST <endpoint> {SourceRequest} → RawResponse. Never
- *  throws: a network/bridge failure becomes a transport-level RawResponse
- *  (ok:false + stderr), exactly like the local transport's spawn failures. */
-export function createHttpTransport(endpoint = '/__crtr/source') {
-    return {
-        async send(req) {
-            try {
-                const res = await fetch(endpoint, {
-                    method: 'POST',
-                    headers: { 'content-type': 'application/json' },
-                    body: JSON.stringify(req),
-                });
-                if (!res.ok) {
-                    return { ok: false, stdout: '', stderr: `bridge ${res.status} ${res.statusText}` };
-                }
-                return (await res.json());
-            }
-            catch (e) {
-                return { ok: false, stdout: '', stderr: e instanceof Error ? e.message : String(e) };
-            }
-        },
-        open(req, handlers) {
-            return openBrowserStream(req, handlers);
-        },
-    };
-}

package/dist/web/transport-stream.d.ts

@@ -1,3 +0,0 @@
-import type { StreamRequest, StreamChannel } from '../core/view/contract.js';
-import type { StreamHandlers } from '../core/view/transport.js';
-export declare function openBrowserStream(req: StreamRequest, handlers: StreamHandlers): StreamChannel;