@flyingrobots/bijou-tui 7.1.0 → 8.0.0-rc.1

package/dist/runtime-loop.js

@@ -0,0 +1,90 @@
+import { getDefaultContext, installRuntimeViewportOverlay, readRuntimeViewport, resolveClock, surfaceToString, } from '@flyingrobots/bijou';
+import { installBCSSResolver } from './css/install.js';
+import { DISABLE_MOUSE, mouseModeSequence, resolveMouseMode } from './mouse-mode.js';
+import { enterScreen } from './screen.js';
+import { normalizeViewOutput } from './view-output.js';
+import { RuntimeFramebuffers } from './runtime-buffers.js';
+import { createRuntimeBus } from './runtime-bus.js';
+import { enterRuntimeCrashMode } from './runtime-crash.js';
+import { installRuntimeInput } from './runtime-input.js';
+import { createRuntimeRenderer } from './runtime-render.js';
+import { finalizeRuntime } from './runtime-shutdown.js';
+import { createRuntimeSession, synchronizeInitialViewport, } from './runtime-startup.js';
+export async function run(app, options) {
+    await runWithLifecycleHooks(app, options);
+}
+export async function runWithLifecycleHooks(app, options, hooks) {
+    const ctx = options?.ctx ?? getDefaultContext();
+    const clock = resolveClock(ctx);
+    installRuntimeViewportOverlay(ctx);
+    installBCSSResolver(ctx, options?.css);
+    const viewport = () => readRuntimeViewport(ctx.runtime);
+    const [initialModel, initCommands] = app.init();
+    if (ctx.mode !== 'interactive') {
+        const size = viewport();
+        const normalized = normalizeViewOutput(app.view(initialModel), {
+            width: size.columns,
+            height: size.rows,
+        });
+        ctx.io.write(surfaceToString(normalized.surface, ctx.style));
+        return;
+    }
+    const session = createRuntimeSession(initialModel);
+    const initialSize = viewport();
+    const buffers = new RuntimeFramebuffers(initialSize.columns, initialSize.rows);
+    const shutdown = (error) => {
+        if (error !== undefined && session.fatalError === null) {
+            session.fatalError = error;
+        }
+        if (!session.running)
+            return;
+        session.running = false;
+        session.resolveQuit?.();
+    };
+    const routeIssue = (issue) => {
+        const routed = app.routeRuntimeIssue?.(issue);
+        if (routed !== undefined)
+            bus.emit(routed);
+    };
+    const bus = createRuntimeBus(options, clock, ctx, routeIssue);
+    const crash = (phase, error, snapshot) => {
+        enterRuntimeCrashMode(phase, error, snapshot, session, buffers, ctx, bus, viewport, shutdown);
+    };
+    const renderer = createRuntimeRenderer({
+        app,
+        options,
+        hooks,
+        ctx,
+        clock,
+        bus,
+        session,
+        runtimeViewport: viewport,
+        routeRuntimeIssue: routeIssue,
+        crash,
+    }, buffers);
+    options?.middlewares?.forEach((middleware) => bus.use(middleware));
+    const mouseMode = resolveMouseMode(options);
+    const useMouse = mouseMode !== undefined;
+    const restoreScreen = (options?.altScreen ?? true)
+        || (options?.hideCursor ?? true);
+    if (restoreScreen)
+        enterScreen(ctx.io);
+    ctx.io.write(useMouse ? mouseModeSequence(mouseMode) : DISABLE_MOUSE);
+    bus.connectIO(ctx.io, { mouse: useMouse });
+    bus.onQuit(shutdown);
+    bus.startPulse(ctx.runtime.refreshRate);
+    const execute = installRuntimeInput(app, bus, ctx, clock, session, buffers, renderer, crash, shutdown);
+    const resizeCommands = synchronizeInitialViewport(app, session, viewport, buffers, crash);
+    if (!session.crashMode) {
+        renderer.render();
+        execute(initCommands);
+        execute(resizeCommands);
+    }
+    await new Promise((resolve) => {
+        session.resolveQuit = resolve;
+        if (!session.running)
+            resolve();
+    });
+    await finalizeRuntime(session, renderer, bus, clock, ctx, useMouse, restoreScreen);
+}
+//# sourceMappingURL=runtime-loop.js.map

package/dist/runtime-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-loop.js","sourceRoot":"","sources":["../src/runtime-loop.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,6BAA6B,EAC7B,mBAAmB,EACnB,YAAY,EACZ,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAG9B,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,GAAkB,EAClB,OAAuB;IAEvB,MAAM,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAkB,EAClB,OAAuB,EACvB,KAAoC;IAEpC,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAChD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAChC,6BAA6B,CAAC,GAAG,CAAC,CAAC;IACnC,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAChD,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE;YAC7D,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,MAAM,EAAE,IAAI,CAAC,IAAI;SAClB,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,QAAQ,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,mBAAmB,CACrC,WAAW,CAAC,OAAO,EACnB,WAAW,CAAC,IAAI,CACjB,CAAC;IACF,MAAM,QAAQ,GAAG,CAAC,KAAe,EAAQ,EAAE;QACzC,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YACvD,OAAO,CAAC,UAAU,GAAG,KAAK,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO;QAC7B,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;QACxB,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;IAC1B,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,CAAC,KAAmB,EAAQ,EAAE;QAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,MAAM,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,CACZ,KAAqC,EACrC,KAAc,EACd,QAAe,EACT,EAAE;QACR,qBAAqB,CACnB,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,EACP,OAAO,EACP,GAAG,EACH,GAAG,EACH,QAAQ,EACR,QAAQ,CACT,CAAC;IACJ,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,qBAAqB,CAAC;QACrC,GAAG;QACH,OAAO;QACP,KAAK;QACL,GAAG;QACH,KAAK;QACL,GAAG;QACH,OAAO;QACP,eAAe,EAAE,QAAQ;QACzB,iBAAiB,EAAE,UAAU;QAC7B,KAAK;KACN,EAAE,OAAO,CAAC,CAAC;IACZ,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,SAAS,KAAK,SAAS,CAAC;IACzC,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC;WAC7C,CAAC,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC;IACnC,IAAI,aAAa;QAAE,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACvC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACtE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3C,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrB,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,mBAAmB,CACjC,GAAG,EACH,GAAG,EACH,GAAG,EACH,KAAK,EACL,OAAO,EACP,OAAO,EACP,QAAQ,EACR,KAAK,EACL,QAAQ,CACT,CAAC;IACF,MAAM,cAAc,GAAG,0BAA0B,CAC/C,GAAG,EACH,OAAO,EACP,QAAQ,EACR,OAAO,EACP,KAAK,CACN,CAAC;IACF,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,YAAY,CAAC,CAAC;QACtB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1B,CAAC;IACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;IAClC,CAAC,CAAC,CAAC;IACH,MAAM,eAAe,CACnB,OAAO,EACP,QAAQ,EACR,GAAG,EACH,KAAK,EACL,GAAG,EACH,QAAQ,EACR,aAAa,CACd,CAAC;AACJ,CAAC"}

package/dist/runtime-messages.d.ts

@@ -0,0 +1,38 @@
+/** Represent a keyboard input event with key name and modifier flags. */
+export interface KeyMsg {
+    readonly type: 'key';
+    readonly key: string;
+    readonly ctrl: boolean;
+    readonly alt: boolean;
+    readonly shift: boolean;
+}
+/** Represent a terminal resize event with new dimensions. */
+export interface ResizeMsg {
+    readonly type: 'resize';
+    readonly columns: number;
+    readonly rows: number;
+}
+/** Represent a system animation pulse event. */
+export interface PulseMsg {
+    readonly type: 'pulse';
+    readonly dt: number;
+}
+export type MouseButton = 'left' | 'middle' | 'right' | 'none';
+export type MouseAction = 'press' | 'release' | 'move' | 'scroll-up' | 'scroll-down';
+export type MouseTrackingMode = 'press' | 'drag' | 'any';
+/** Mouse input event. */
+export interface MouseMsg {
+    readonly type: 'mouse';
+    readonly button: MouseButton;
+    readonly action: MouseAction;
+    readonly col: number;
+    readonly row: number;
+    readonly shift: boolean;
+    readonly alt: boolean;
+    readonly ctrl: boolean;
+}
+export declare function isKeyMsg(msg: unknown): msg is KeyMsg;
+export declare function isResizeMsg(msg: unknown): msg is ResizeMsg;
+export declare function isPulseMsg(msg: unknown): msg is PulseMsg;
+export declare function isMouseMsg(msg: unknown): msg is MouseMsg;
+//# sourceMappingURL=runtime-messages.d.ts.map

package/dist/runtime-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-messages.d.ts","sourceRoot":"","sources":["../src/runtime-messages.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,6DAA6D;AAC7D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,gDAAgD;AAChD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAC/D,MAAM,MAAM,WAAW,GACrB,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,aAAa,CAAC;AAC7D,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAEzD,yBAAyB;AACzB,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAEpD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,SAAS,CAE1D;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,QAAQ,CAExD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,QAAQ,CAExD"}

package/dist/runtime-messages.js

@@ -0,0 +1,19 @@
+export function isKeyMsg(msg) {
+    return messageType(msg) === 'key';
+}
+export function isResizeMsg(msg) {
+    return messageType(msg) === 'resize';
+}
+export function isPulseMsg(msg) {
+    return messageType(msg) === 'pulse';
+}
+export function isMouseMsg(msg) {
+    return messageType(msg) === 'mouse';
+}
+function messageType(msg) {
+    if (typeof msg !== 'object' || msg === null || !('type' in msg)) {
+        return undefined;
+    }
+    return msg.type;
+}
+//# sourceMappingURL=runtime-messages.js.map

package/dist/runtime-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-messages.js","sourceRoot":"","sources":["../src/runtime-messages.ts"],"names":[],"mappings":"AAuCA,MAAM,UAAU,QAAQ,CAAC,GAAY;IACnC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC;AACtC,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAC/B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC;QAChE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC"}

package/dist/runtime-pipeline.d.ts

@@ -0,0 +1,11 @@
+import { createPipeline } from './pipeline/pipeline.js';
+import type { App, RunOptions } from './types.js';
+import { RuntimeFramebuffers } from './runtime-buffers.js';
+import type { RuntimeSession } from './runtime-contract.js';
+export declare const FATAL_RENDER_ERROR_KEY = "__fatalRenderError";
+/** Build the programmable render pipeline around shared framebuffers. */
+export declare function createRuntimePipeline<Model, M>(app: App<Model, M>, options: RunOptions<M> | undefined, session: RuntimeSession<Model>, buffers: RuntimeFramebuffers, viewport: () => {
+    columns: number;
+    rows: number;
+}): ReturnType<typeof createPipeline>;
+//# sourceMappingURL=runtime-pipeline.d.ts.map

package/dist/runtime-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-pipeline.d.ts","sourceRoot":"","sources":["../src/runtime-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEf,MAAM,wBAAwB,CAAC;AAKhC,OAAO,KAAK,EACV,GAAG,EACH,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAE3D,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,CAAC,EAC5C,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAClB,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,EAClC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,EAC9B,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,MAAM;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD,UAAU,CAAC,OAAO,cAAc,CAAC,CAmCnC"}

package/dist/runtime-pipeline.js

@@ -0,0 +1,37 @@
+import { createPipeline, RENDER_LAYOUT_ROOT_KEY, } from './pipeline/pipeline.js';
+import { bcssMiddleware } from './pipeline/middleware/css.js';
+import { motionMiddleware } from './pipeline/middleware/motion.js';
+import { paintMiddleware } from './pipeline/middleware/paint.js';
+import { renderSurfaceFrame } from './screen.js';
+import { wrapViewOutputAsLayoutRoot } from './view-output.js';
+export const FATAL_RENDER_ERROR_KEY = '__fatalRenderError';
+/** Build the programmable render pipeline around shared framebuffers. */
+export function createRuntimePipeline(app, options, session, buffers, viewport) {
+    const pipeline = createPipeline();
+    pipeline.use('Layout', (state, next) => {
+        try {
+            const size = viewport();
+            state.data[RENDER_LAYOUT_ROOT_KEY] = wrapViewOutputAsLayoutRoot(app.view(session.model), { width: size.columns, height: size.rows });
+            next();
+        }
+        catch (error) {
+            state.data[FATAL_RENDER_ERROR_KEY] = error;
+        }
+    });
+    pipeline.use('Layout', motionMiddleware());
+    if (options?.css != null) {
+        pipeline.use('Layout', bcssMiddleware(options.css));
+    }
+    pipeline.use('Paint', paintMiddleware());
+    pipeline.use('Diff', (state, next) => {
+        renderSurfaceFrame(state.ctx.io, state.currentSurface, state.targetSurface, state.ctx.style, state.outBuf);
+        next();
+    });
+    pipeline.use('Output', (state, next) => {
+        buffers.adoptTarget(state.targetSurface);
+        next();
+    });
+    options?.configurePipeline?.(pipeline);
+    return pipeline;
+}
+//# sourceMappingURL=runtime-pipeline.js.map

package/dist/runtime-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-pipeline.js","sourceRoot":"","sources":["../src/runtime-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAKjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAI9D,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAE3D,yEAAyE;AACzE,MAAM,UAAU,qBAAqB,CACnC,GAAkB,EAClB,OAAkC,EAClC,OAA8B,EAC9B,OAA4B,EAC5B,QAAiD;IAEjD,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,0BAA0B,CAC7D,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EACvB,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,CAC3C,CAAC;YACF,IAAI,EAAE,CAAC;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,KAAK,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC3C,IAAI,OAAO,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;QACzB,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACnC,kBAAkB,CAChB,KAAK,CAAC,GAAG,CAAC,EAAE,EACZ,KAAK,CAAC,cAAc,EACpB,KAAK,CAAC,aAAa,EACnB,KAAK,CAAC,GAAG,CAAC,KAAK,EACf,KAAK,CAAC,MAAM,CACb,CAAC;QACF,IAAI,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACzC,IAAI,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,iBAAiB,EAAE,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/runtime-render.d.ts

@@ -0,0 +1,5 @@
+import { RuntimeFramebuffers } from './runtime-buffers.js';
+import type { InteractiveRuntimeInput, RuntimeRenderer } from './runtime-contract.js';
+/** Schedule coalesced renders against one shared runtime session. */
+export declare function createRuntimeRenderer<Model, M>(input: InteractiveRuntimeInput<Model, M>, buffers: RuntimeFramebuffers): RuntimeRenderer;
+//# sourceMappingURL=runtime-render.d.ts.map

package/dist/runtime-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-render.d.ts","sourceRoot":"","sources":["../src/runtime-render.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EACV,uBAAuB,EACvB,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAM/B,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,CAAC,EAC5C,KAAK,EAAE,uBAAuB,CAAC,KAAK,EAAE,CAAC,CAAC,EACxC,OAAO,EAAE,mBAAmB,GAC3B,eAAe,CAsGjB"}

package/dist/runtime-render.js

@@ -0,0 +1,115 @@
+import { getRenderStageTimings, } from './pipeline/pipeline.js';
+import { evaluateSurfaceBudget } from './surface-budget.js';
+import { createRuntimePipeline, FATAL_RENDER_ERROR_KEY, } from './runtime-pipeline.js';
+/** Schedule coalesced renders against one shared runtime session. */
+export function createRuntimeRenderer(input, buffers) {
+    const { session, clock, options, ctx } = input;
+    const pipeline = createRuntimePipeline(input.app, options, session, buffers, input.runtimeViewport);
+    const routedWarnings = new Set();
+    let renderScheduled = false;
+    const schedule = () => {
+        if (renderScheduled || session.renderInFlight)
+            return;
+        renderScheduled = true;
+        const ordering = { fired: false };
+        let handle = null;
+        const scheduledHandle = clock.setTimeout(() => {
+            ordering.fired = true;
+            renderScheduled = false;
+            session.renderHandle = null;
+            handle?.dispose();
+            handle = null;
+            if (!session.renderQueued)
+                return;
+            session.renderInFlight = true;
+            session.renderQueued = false;
+            try {
+                const before = input.hooks?.beforeRender?.(session.model);
+                if (before !== undefined)
+                    session.model = before;
+                const viewport = input.runtimeViewport();
+                buffers.ensure(viewport.columns, viewport.rows);
+                buffers.next.clear();
+                const state = {
+                    model: session.model,
+                    ctx,
+                    dt: session.currentDt,
+                    currentSurface: buffers.current,
+                    targetSurface: buffers.next,
+                    outBuf: buffers.output,
+                    layoutMap: new Map(),
+                    data: {},
+                };
+                pipeline.execute(state);
+                const fatal = state.data[FATAL_RENDER_ERROR_KEY];
+                if (fatal !== undefined) {
+                    input.crash('render', fatal, session.model);
+                    return;
+                }
+                const timings = getRenderStageTimings(state);
+                if (options?.surfaceBudget != null) {
+                    for (const warning of evaluateSurfaceBudget({
+                        surface: state.targetSurface,
+                        timings,
+                        thresholds: options.surfaceBudget,
+                    })) {
+                        if (routedWarnings.has(warning.message))
+                            continue;
+                        routedWarnings.add(warning.message);
+                        input.routeRuntimeIssue({
+                            level: 'warning',
+                            source: 'runtime',
+                            message: warning.message,
+                            atMs: clock.now(),
+                        });
+                    }
+                }
+                const after = input.hooks?.afterRender?.({
+                    model: session.model,
+                    dt: session.currentDt,
+                    timings,
+                    viewport,
+                });
+                if (after?.model !== undefined)
+                    session.model = after.model;
+                if (after?.requestRender === true)
+                    render();
+            }
+            catch (error) {
+                input.crash('render', error, session.model);
+            }
+            finally {
+                session.renderInFlight = false;
+                scheduleQueuedRender(session, schedule);
+            }
+        }, 0);
+        handle = scheduledHandle;
+        if (ordering.fired) {
+            scheduledHandle.dispose();
+            handle = null;
+        }
+        else {
+            session.renderHandle = scheduledHandle;
+        }
+    };
+    const render = () => {
+        if (!session.running)
+            return;
+        session.renderQueued = true;
+        schedule();
+    };
+    return {
+        render,
+        hasPendingRender: () => renderScheduled || session.renderInFlight,
+        dispose() {
+            renderScheduled = false;
+            session.renderHandle?.dispose();
+            session.renderHandle = null;
+        },
+    };
+}
+function scheduleQueuedRender(session, schedule) {
+    if (session.renderQueued)
+        schedule();
+}
+//# sourceMappingURL=runtime-render.js.map

package/dist/runtime-render.js.map

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

package/dist/runtime-shutdown.d.ts

@@ -0,0 +1,9 @@
+import type { BijouContext, ClockPort } from '@flyingrobots/bijou';
+import type { EventBus } from './eventbus.js';
+import type { RuntimeRenderer, RuntimeSession } from './runtime-contract.js';
+/** Flush scheduled work, drain commands with a deadline, and restore the TTY. */
+export declare function finalizeRuntime<Model, M>(session: RuntimeSession<Model>, renderer: RuntimeRenderer, bus: EventBus<M>, clock: ClockPort, ctx: BijouContext, useMouse: boolean, restoreScreen: boolean): Promise<void>;
+export declare function drainWithin(bus: {
+    drain(): Promise<void>;
+}, clock: ClockPort, timeout: number): Promise<'drained' | 'timed-out'>;
+//# sourceMappingURL=runtime-shutdown.d.ts.map

package/dist/runtime-shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-shutdown.d.ts","sourceRoot":"","sources":["../src/runtime-shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EAEV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACf,MAAM,uBAAuB,CAAC;AAQ/B,iFAAiF;AACjF,wBAAsB,eAAe,CAAC,KAAK,EAAE,CAAC,EAC5C,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,EAC9B,QAAQ,EAAE,eAAe,EACzB,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,EAChB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,OAAO,EACjB,aAAa,EAAE,OAAO,GACrB,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE;IAAE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,EAC/B,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,GAAG,WAAW,CAAC,CA2BlC"}

package/dist/runtime-shutdown.js

@@ -0,0 +1,65 @@
+import { DISABLE_MOUSE } from './mouse-mode.js';
+import { exitScreen } from './screen.js';
+import { formatRuntimeDetail, writeErrorLine, } from './runtime-format.js';
+const DRAIN_TIMEOUT_MS = 1000;
+/** Flush scheduled work, drain commands with a deadline, and restore the TTY. */
+export async function finalizeRuntime(session, renderer, bus, clock, ctx, useMouse, restoreScreen) {
+    if (renderer.hasPendingRender()) {
+        await new Promise((resolve) => {
+            let handle = null;
+            handle = clock.setTimeout(() => {
+                handle?.dispose();
+                handle = null;
+                resolve();
+            }, 0);
+        });
+    }
+    if (await drainWithin(bus, clock, DRAIN_TIMEOUT_MS) === 'timed-out') {
+        const message = `Timed out waiting ${String(DRAIN_TIMEOUT_MS)}ms for pending commands`
+            + ' to drain during shutdown.';
+        writeErrorLine(ctx.io, `[Runtime Warning] ${message}\n`);
+    }
+    renderer.dispose();
+    bus.stopPulse();
+    bus.dispose();
+    if (useMouse)
+        ctx.io.write(DISABLE_MOUSE);
+    if (restoreScreen)
+        exitScreen(ctx.io);
+    if (session.fatalError != null) {
+        throw session.fatalError instanceof Error
+            ? session.fatalError
+            : new Error(formatRuntimeDetail(session.fatalError));
+    }
+}
+export async function drainWithin(bus, clock, timeout) {
+    let handle = null;
+    try {
+        return await new Promise((resolve) => {
+            let settled = false;
+            const finish = (result) => {
+                if (settled)
+                    return;
+                settled = true;
+                handle?.dispose();
+                handle = null;
+                resolve(result);
+            };
+            handle = clock.setTimeout(() => {
+                finish('timed-out');
+            }, timeout);
+            void bus.drain().then(() => {
+                finish('drained');
+            }, () => {
+                finish('drained');
+            });
+        });
+    }
+    finally {
+        disposeHandle(handle);
+    }
+}
+function disposeHandle(handle) {
+    handle?.dispose();
+}
+//# sourceMappingURL=runtime-shutdown.js.map

package/dist/runtime-shutdown.js.map

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

package/dist/runtime-startup.d.ts

@@ -0,0 +1,10 @@
+import { RuntimeFramebuffers } from './runtime-buffers.js';
+import type { RuntimeSession } from './runtime-contract.js';
+import type { App, Cmd } from './types.js';
+export declare function createRuntimeSession<Model>(model: Model): RuntimeSession<Model>;
+/** Apply the initial viewport message and align both framebuffers afterward. */
+export declare function synchronizeInitialViewport<Model, M>(app: App<Model, M>, session: RuntimeSession<Model>, viewport: () => {
+    columns: number;
+    rows: number;
+}, buffers: RuntimeFramebuffers, crash: (phase: 'update' | 'render' | 'resize', error: unknown, snapshot: Model) => void): Cmd<M>[];
+//# sourceMappingURL=runtime-startup.d.ts.map

package/dist/runtime-startup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-startup.d.ts","sourceRoot":"","sources":["../src/runtime-startup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EACV,GAAG,EACH,GAAG,EAEJ,MAAM,YAAY,CAAC;AAEpB,wBAAgB,oBAAoB,CAAC,KAAK,EACxC,KAAK,EAAE,KAAK,GACX,cAAc,CAAC,KAAK,CAAC,CAavB;AAED,gFAAgF;AAChF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,CAAC,EACjD,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAClB,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,EAC9B,QAAQ,EAAE,MAAM;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACjD,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,CACL,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACrC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,KAAK,KACZ,IAAI,GACR,GAAG,CAAC,CAAC,CAAC,EAAE,CAiBV"}

package/dist/runtime-startup.js

@@ -0,0 +1,35 @@
+export function createRuntimeSession(model) {
+    return {
+        model,
+        running: true,
+        lastCtrlC: null,
+        currentDt: 0.016,
+        fatalError: null,
+        crashMode: false,
+        resolveQuit: null,
+        renderQueued: false,
+        renderInFlight: false,
+        renderHandle: null,
+    };
+}
+/** Apply the initial viewport message and align both framebuffers afterward. */
+export function synchronizeInitialViewport(app, session, viewport, buffers, crash) {
+    const size = viewport();
+    const resize = {
+        type: 'resize',
+        columns: size.columns,
+        rows: size.rows,
+    };
+    let commands = [];
+    try {
+        [session.model, commands] = app.update(resize, session.model);
+    }
+    catch (error) {
+        crash('resize', error, session.model);
+        return commands;
+    }
+    const postResize = viewport();
+    buffers.reset(postResize.columns, postResize.rows);
+    return commands;
+}
+//# sourceMappingURL=runtime-startup.js.map

package/dist/runtime-startup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-startup.js","sourceRoot":"","sources":["../src/runtime-startup.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,oBAAoB,CAClC,KAAY;IAEZ,OAAO;QACL,KAAK;QACL,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,KAAK;QAChB,UAAU,EAAE,IAAI;QAChB,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE,KAAK;QACnB,cAAc,EAAE,KAAK;QACrB,YAAY,EAAE,IAAI;KACnB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,0BAA0B,CACxC,GAAkB,EAClB,OAA8B,EAC9B,QAAiD,EACjD,OAA4B,EAC5B,KAIS;IAET,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;IACxB,MAAM,MAAM,GAAc;QACxB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;IACF,IAAI,QAAQ,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC;QACH,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,UAAU,GAAG,QAAQ,EAAE,CAAC;IAC9B,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/runtime.d.ts

@@ -1,38 +1,4 @@
-import type { App, RunOptions } from './types.js';
-import { type RenderStageTiming } from './pipeline/pipeline.js';
-export interface RuntimeRenderSummary<Model> {
-    readonly model: Model;
-    readonly dt: number;
-    readonly timings: readonly RenderStageTiming[];
-    readonly viewport: {
-        readonly columns: number;
-        readonly rows: number;
-    };
-}
-export interface RuntimePostRenderEffect<Model> {
-    readonly model?: Model;
-    readonly requestRender?: boolean;
-}
-export interface RuntimeLifecycleHooks<Model> {
-    beforeRender?(model: Model): Model | void;
-    afterRender?(summary: RuntimeRenderSummary<Model>): RuntimePostRenderEffect<Model> | void;
-}
-/**
- * Run a TEA application.
- *
- * In non-interactive modes (pipe/static/accessible), renders the initial view
- * once and exits. In interactive mode, enters the alt screen, starts the
- * keyboard event loop, and drives the model/update/view cycle.
- *
- * All input sources (keyboard, resize, commands) are unified through an
- * internal EventBus — a single subscription drives the update cycle.
- *
- * @template Model - The application model type.
- * @template M     - The message (action) type for the TEA update cycle.
- * @param app     - The TEA application definition (init, update, view).
- * @param options - Optional runtime configuration (context, alt screen, cursor, mouse).
- * @returns A promise that resolves when the application exits.
- */
-export declare function run<Model, M>(app: App<Model, M>, options?: RunOptions<M>): Promise<void>;
-export declare function runWithLifecycleHooks<Model, M>(app: App<Model, M>, options?: RunOptions<M>, hooks?: RuntimeLifecycleHooks<Model>): Promise<void>;
+/** Stable interactive runtime facade over focused lifecycle modules. */
+export { run, runWithLifecycleHooks, } from './runtime-loop.js';
+export type { RuntimeLifecycleHooks, RuntimePostRenderEffect, RuntimeRenderSummary, } from './runtime-contract.js';
 //# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,GAAG,EAAO,UAAU,EAAa,MAAM,YAAY,CAAC;AAIlE,OAAO,EAIL,KAAK,iBAAiB,EAEvB,MAAM,wBAAwB,CAAC;AAwBhC,MAAM,WAAW,oBAAoB,CAAC,KAAK;IACzC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB,CAAC,KAAK;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB,CAAC,KAAK;IAC1C,YAAY,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;IAC1C,WAAW,CAAC,CAAC,OAAO,EAAE,oBAAoB,CAAC,KAAK,CAAC,GAAG,uBAAuB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;CAC3F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,GAAG,CAAC,KAAK,EAAE,CAAC,EAChC,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAClB,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,CAAC,EAClD,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAClB,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EACvB,KAAK,CAAC,EAAE,qBAAqB,CAAC,KAAK,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CA4gBf"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,OAAO,EACL,GAAG,EACH,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}