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

package/dist/runtime-binding.part01.js

@@ -0,0 +1,52 @@
+const RUNTIME_VIEW_BINDING_SOURCE_BRAND = Symbol('RuntimeViewBindingSource');
+const RUNTIME_COMMAND_INTENT_EMISSION_BRAND = Symbol('RuntimeCommandIntentEmission');
+const RUNTIME_COMMAND_INTENT_ROUTE_BRAND = Symbol('RuntimeCommandIntentRoute');
+function assertObjectRecord(value, scope, label = 'input') {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${scope}: ${label} must be an object`);
+    }
+}
+function normalizeRequiredText(options) {
+    if (typeof options.value !== 'string') {
+        throw new Error(`${options.scope}: ${options.field} must be a string`);
+    }
+    const normalized = options.value.trim();
+    if (normalized === '') {
+        throw new Error(`${options.scope}: ${options.field} is required`);
+    }
+    return normalized;
+}
+function freezeProviderAssignments(assignments) {
+    if (assignments === undefined) {
+        return undefined;
+    }
+    if (!Array.isArray(assignments)) {
+        throw new Error('runtime binding source: providerIds must be an array');
+    }
+    const seenRequirementIds = new Set();
+    return Object.freeze(assignments.map((assignment, index) => {
+        assertObjectRecord(assignment, 'runtime binding source', `provider assignment ${String(index)}`);
+        const requirementId = normalizeRequiredText({
+            scope: 'runtime binding source',
+            field: `provider assignment ${String(index)} requirementId`,
+            value: assignment['requirementId'],
+        });
+        if (seenRequirementIds.has(requirementId)) {
+            throw new Error(`runtime binding source: duplicate provider assignment ${requirementId}`);
+        }
+        seenRequirementIds.add(requirementId);
+        return Object.freeze({
+            requirementId,
+            providerId: normalizeRequiredText({
+                scope: 'runtime binding source',
+                field: `provider assignment ${String(index)} providerId`,
+                value: assignment['providerId'],
+            }),
+        });
+    }));
+}
+function brand(value, brandSymbol) {
+    Object.defineProperty(value, brandSymbol, { value: true });
+}
+export { RUNTIME_COMMAND_INTENT_EMISSION_BRAND, RUNTIME_COMMAND_INTENT_ROUTE_BRAND, RUNTIME_VIEW_BINDING_SOURCE_BRAND, assertObjectRecord, brand, freezeProviderAssignments };
+//# sourceMappingURL=runtime-binding.part01.js.map

package/dist/runtime-binding.part01.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-binding.part01.js","sourceRoot":"","sources":["../src/runtime-binding.part01.ts"],"names":[],"mappings":"AAGA,MAAM,iCAAiC,GAAkB,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAE5F,MAAM,qCAAqC,GAAkB,MAAM,CAAC,8BAA8B,CAAC,CAAC;AAEpG,MAAM,kCAAkC,GAAkB,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAoD9F,SAAS,kBAAkB,CACzB,KAAc,EACd,KAAa,EACb,KAAK,GAAG,OAAO;IAEf,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,KAAK,oBAAoB,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,OAI9B;IACC,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,mBAAmB,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,cAAc,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,yBAAyB,CAChC,WAAmE;IAEnE,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC7C,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE;QACzD,kBAAkB,CAChB,UAAU,EACV,wBAAwB,EACxB,uBAAuB,MAAM,CAAC,KAAK,CAAC,EAAE,CACvC,CAAC;QACF,MAAM,aAAa,GAAG,qBAAqB,CAAC;YAC1C,KAAK,EAAE,wBAAwB;YAC/B,KAAK,EAAE,uBAAuB,MAAM,CAAC,KAAK,CAAC,gBAAgB;YAC3D,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC;SACnC,CAAC,CAAC;QACH,IAAI,kBAAkB,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,yDAAyD,aAAa,EAAE,CACzE,CAAC;QACJ,CAAC;QAED,kBAAkB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,aAAa;YACb,UAAU,EAAE,qBAAqB,CAAC;gBAChC,KAAK,EAAE,wBAAwB;gBAC/B,KAAK,EAAE,uBAAuB,MAAM,CAAC,KAAK,CAAC,aAAa;gBACxD,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC;aAChC,CAAC;SACH,CAAC,CAAC;IACL,CAAC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,KAAK,CACZ,KAAY,EACZ,WAAkB;IAElB,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,OAAO,EAAE,qCAAqC,EAAE,kCAAkC,EAAE,iCAAiC,EAAE,kBAAkB,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/runtime-binding.part02.d.ts

@@ -0,0 +1,9 @@
+import { type DeepReadonly } from '@flyingrobots/bijou';
+import type { RuntimeViewBindingSource, RuntimeViewBindingSourceInput } from './runtime-binding.part01.js';
+export declare function runtimeViewBindingSource(input: RuntimeViewBindingSourceInput): RuntimeViewBindingSource;
+declare function deepFreeze<Payload>(value: Payload, seen?: WeakSet<object>): DeepReadonly<Payload>;
+declare function isRuntimePayloadArray(value: unknown): value is readonly unknown[];
+declare function isPlainObject(value: object): boolean;
+declare function objectKind(value: object): string;
+export { deepFreeze, isPlainObject, isRuntimePayloadArray, objectKind };
+//# sourceMappingURL=runtime-binding.part02.d.ts.map

package/dist/runtime-binding.part02.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-binding.part02.d.ts","sourceRoot":"","sources":["../src/runtime-binding.part02.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+C,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAErG,OAAO,KAAK,EAAE,wBAAwB,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAE3G,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,6BAA6B,GACnC,wBAAwB,CAuB1B;AAED,iBAAS,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;AAsB5F,iBAAS,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,OAAO,EAAE,CAE1E;AAED,iBAAS,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG7C;AAED,iBAAS,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,qBAAqB,EAAE,UAAU,EAAE,CAAC"}

package/dist/runtime-binding.part02.js

@@ -0,0 +1,47 @@
+import { isBindingLifecycleOwner, isViewDataContract } from '@flyingrobots/bijou';
+import { RUNTIME_VIEW_BINDING_SOURCE_BRAND, assertObjectRecord, brand, freezeProviderAssignments } from './runtime-binding.part01.js';
+export function runtimeViewBindingSource(input) {
+    assertObjectRecord(input, 'runtime binding source');
+    if (!isBindingLifecycleOwner(input.owner)) {
+        throw new Error('runtime binding source: owner was not created by defineBindingLifecycleOwner()');
+    }
+    if (!isViewDataContract(input.contract)) {
+        throw new Error('runtime binding source: contract was not created by defineViewData()');
+    }
+    const providerIds = freezeProviderAssignments(input.providerIds);
+    const source = {
+        owner: input.owner,
+        contract: input.contract,
+        ...(providerIds === undefined ? {} : { providerIds }),
+    };
+    brand(source, RUNTIME_VIEW_BINDING_SOURCE_BRAND);
+    return Object.freeze(source);
+}
+function deepFreeze(value, seen = new WeakSet()) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (seen.has(value)) {
+        return value;
+    }
+    seen.add(value);
+    for (const key of Reflect.ownKeys(value)) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (descriptor !== undefined && 'value' in descriptor) {
+            deepFreeze(descriptor.value, seen);
+        }
+    }
+    return Object.freeze(value);
+}
+function isRuntimePayloadArray(value) {
+    return Array.isArray(value);
+}
+function isPlainObject(value) {
+    const prototype = Reflect.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function objectKind(value) {
+    return Object.prototype.toString.call(value).slice(8, -1);
+}
+export { deepFreeze, isPlainObject, isRuntimePayloadArray, objectKind };
+//# sourceMappingURL=runtime-binding.part02.js.map

package/dist/runtime-binding.part02.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-binding.part02.js","sourceRoot":"","sources":["../src/runtime-binding.part02.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAqB,MAAM,qBAAqB,CAAC;AACrG,OAAO,EAAE,iCAAiC,EAAE,kBAAkB,EAAE,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAGtI,MAAM,UAAU,wBAAwB,CACtC,KAAoC;IAEpC,kBAAkB,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;IAEpD,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GAAG,yBAAyB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAEjE,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;KACtD,CAAC;IAEF,KAAK,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAID,SAAS,UAAU,CAAC,KAAc,EAAE,IAAI,GAAG,IAAI,OAAO,EAAE;IACtD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/D,IAAI,UAAU,KAAK,SAAS,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;YACtD,UAAU,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAChD,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,qBAAqB,EAAE,UAAU,EAAE,CAAC"}

package/dist/runtime-binding.part03.d.ts

@@ -0,0 +1,4 @@
+import type { DeepReadonly } from '@flyingrobots/bijou';
+declare function freezeRuntimePayload<Payload>(payload: Payload | undefined): DeepReadonly<Payload | undefined>;
+export { freezeRuntimePayload };
+//# sourceMappingURL=runtime-binding.part03.d.ts.map

package/dist/runtime-binding.part03.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-binding.part03.d.ts","sourceRoot":"","sources":["../src/runtime-binding.part03.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAoFxD,iBAAS,oBAAoB,CAAC,OAAO,EACnC,OAAO,EAAE,OAAO,GAAG,SAAS,GAC3B,YAAY,CAAC,OAAO,GAAG,SAAS,CAAC,CAMnC;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/runtime-binding.part03.js

@@ -0,0 +1,65 @@
+import { deepFreeze, isPlainObject, isRuntimePayloadArray, objectKind } from './runtime-binding.part02.js';
+function cloneRuntimePayload(value, path, seen = new WeakSet()) {
+    if (value === null
+        || typeof value === 'string'
+        || typeof value === 'number'
+        || typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'bigint' || typeof value === 'symbol' || typeof value === 'function') {
+        throw new Error(`runtime command intent payload: unsupported ${typeof value} at ${path}`);
+    }
+    if (value === undefined) {
+        throw new Error(`runtime command intent payload: unsupported undefined at ${path}`);
+    }
+    if (typeof value !== 'object') {
+        throw new Error(`runtime command intent payload: unsupported ${typeof value} at ${path}`);
+    }
+    const objectValue = value;
+    if (seen.has(objectValue)) {
+        throw new Error(`runtime command intent payload: circular reference at ${path}`);
+    }
+    seen.add(objectValue);
+    try {
+        if (isRuntimePayloadArray(value)) {
+            return value.map((item, index) => cloneRuntimePayload(item, `${path}[${String(index)}]`, seen));
+        }
+        if (!isPlainObject(value)) {
+            throw new Error(`runtime command intent payload: unsupported ${objectKind(value)} at ${path}`);
+        }
+        const clone = {};
+        if (Reflect.getPrototypeOf(value) === null) {
+            Object.setPrototypeOf(clone, null);
+        }
+        const descriptors = Object.getOwnPropertyDescriptors(value);
+        for (const key of Reflect.ownKeys(descriptors)) {
+            if (typeof key === 'symbol') {
+                throw new Error(`runtime command intent payload: unsupported symbol property at ${path}`);
+            }
+            const descriptor = descriptors[key];
+            const propertyPath = `${path}.${key}`;
+            if (descriptor === undefined) {
+                continue;
+            }
+            if (!descriptor.enumerable) {
+                throw new Error(`runtime command intent payload: unsupported non-enumerable property at ${propertyPath}`);
+            }
+            if ('get' in descriptor || 'set' in descriptor) {
+                throw new Error(`runtime command intent payload: unsupported accessor at ${propertyPath}`);
+            }
+            clone[key] = cloneRuntimePayload(descriptor.value, propertyPath, seen);
+        }
+        return clone;
+    }
+    finally {
+        seen.delete(objectValue);
+    }
+}
+function freezeRuntimePayload(payload) {
+    if (payload === undefined) {
+        return undefined;
+    }
+    return deepFreeze(cloneRuntimePayload(payload, 'payload'));
+}
+export { freezeRuntimePayload };
+//# sourceMappingURL=runtime-binding.part03.js.map

package/dist/runtime-binding.part03.js.map

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

package/dist/runtime-binding.part04.d.ts

@@ -0,0 +1,13 @@
+import { type CommandIntent } from '@flyingrobots/bijou';
+import type { RuntimeCommandBuffer } from './runtime-engine.js';
+import type { RuntimeCommandIntentEmission, RuntimeCommandIntentEmissionOptions, RuntimeCommandIntentRoute, RuntimeCommandIntentRouteInput } from './runtime-binding.part01.js';
+export declare function runtimeCommandIntentEmission(intent: CommandIntent): RuntimeCommandIntentEmission;
+export declare function runtimeCommandIntentEmission<Payload>(intent: CommandIntent<Payload>, payload: Payload, options?: RuntimeCommandIntentEmissionOptions): RuntimeCommandIntentEmission<Payload>;
+declare function hasOwnBrand(value: unknown, brandSymbol: symbol): boolean;
+export declare function isRuntimeCommandIntentEmission(value: unknown): value is RuntimeCommandIntentEmission;
+export declare function runtimeCommandIntentRoute<Payload, Command>(input: RuntimeCommandIntentRouteInput<Payload, Command>): RuntimeCommandIntentRoute<Payload, Command>;
+export declare function isRuntimeCommandIntentRoute(value: unknown): value is RuntimeCommandIntentRoute;
+declare function isRuntimeCommandIntentRouteList<Payload, Command>(value: readonly RuntimeCommandIntentRoute<Payload, Command>[]): value is readonly RuntimeCommandIntentRoute<Payload, Command>[];
+declare function isRuntimeCommandBuffer(value: unknown): value is RuntimeCommandBuffer;
+export { hasOwnBrand, isRuntimeCommandBuffer, isRuntimeCommandIntentRouteList };
+//# sourceMappingURL=runtime-binding.part04.d.ts.map

package/dist/runtime-binding.part04.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-binding.part04.d.ts","sourceRoot":"","sources":["../src/runtime-binding.part04.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACnG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,4BAA4B,EAAE,mCAAmC,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAGhL,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,aAAa,GACpB,4BAA4B,CAAC;AAEhC,wBAAgB,4BAA4B,CAAC,OAAO,EAClD,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,mCAAmC,GAC5C,4BAA4B,CAAC,OAAO,CAAC,CAAC;AA6BzC,iBAAS,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAOjE;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,4BAA4B,CAEvC;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,EACxD,KAAK,EAAE,8BAA8B,CAAC,OAAO,EAAE,OAAO,CAAC,GACtD,yBAAyB,CAAC,OAAO,EAAE,OAAO,CAAC,CAiB7C;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,yBAAyB,CAE9F;AAED,iBAAS,+BAA+B,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,yBAAyB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,IAAI,SAAS,yBAAyB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAiC;AAE3N,iBAAS,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAM7E;AAED,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,CAAC"}

package/dist/runtime-binding.part04.js

@@ -0,0 +1,55 @@
+import { isBindingLifecycleOwner, isCommandIntent } from '@flyingrobots/bijou';
+import { RUNTIME_COMMAND_INTENT_EMISSION_BRAND, RUNTIME_COMMAND_INTENT_ROUTE_BRAND, assertObjectRecord, brand } from './runtime-binding.part01.js';
+import { freezeRuntimePayload } from './runtime-binding.part03.js';
+export function runtimeCommandIntentEmission(intent, payload, options = {}) {
+    assertObjectRecord(options, 'runtime command intent emission', 'options');
+    if (!isCommandIntent(intent)) {
+        throw new Error('runtime command intent emission: intent was not created by commandIntent()');
+    }
+    const owner = options['owner'];
+    if (owner !== undefined && !isBindingLifecycleOwner(owner)) {
+        throw new Error('runtime command intent emission: owner was not created by defineBindingLifecycleOwner()');
+    }
+    const emission = {
+        intent,
+        payload: freezeRuntimePayload(payload),
+        owner,
+    };
+    brand(emission, RUNTIME_COMMAND_INTENT_EMISSION_BRAND);
+    return Object.freeze(emission);
+}
+function hasOwnBrand(value, brandSymbol) {
+    return (value !== null
+        && typeof value === 'object'
+        && Object.prototype.hasOwnProperty.call(value, brandSymbol)
+        && Reflect.get(value, brandSymbol) === true);
+}
+export function isRuntimeCommandIntentEmission(value) {
+    return hasOwnBrand(value, RUNTIME_COMMAND_INTENT_EMISSION_BRAND);
+}
+export function runtimeCommandIntentRoute(input) {
+    assertObjectRecord(input, 'runtime command intent route');
+    if (!isCommandIntent(input.intent)) {
+        throw new Error('runtime command intent route: intent was not created by commandIntent()');
+    }
+    if (typeof input.toCommand !== 'function') {
+        throw new Error('runtime command intent route: toCommand must be a function');
+    }
+    const route = {
+        intent: input.intent,
+        toCommand: input.toCommand,
+    };
+    brand(route, RUNTIME_COMMAND_INTENT_ROUTE_BRAND);
+    return Object.freeze(route);
+}
+export function isRuntimeCommandIntentRoute(value) {
+    return hasOwnBrand(value, RUNTIME_COMMAND_INTENT_ROUTE_BRAND);
+}
+function isRuntimeCommandIntentRouteList(value) { return Array.isArray(value); }
+function isRuntimeCommandBuffer(value) {
+    return Boolean(value
+        && typeof value === 'object'
+        && Array.isArray(Reflect.get(value, 'items')));
+}
+export { hasOwnBrand, isRuntimeCommandBuffer, isRuntimeCommandIntentRouteList };
+//# sourceMappingURL=runtime-binding.part04.js.map

package/dist/runtime-binding.part04.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-binding.part04.js","sourceRoot":"","sources":["../src/runtime-binding.part04.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAsB,MAAM,qBAAqB,CAAC;AAEnG,OAAO,EAAE,qCAAqC,EAAE,kCAAkC,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEnJ,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAYnE,MAAM,UAAU,4BAA4B,CAC1C,MAA8B,EAC9B,OAAiB,EACjB,UAA+C,EAAE;IAEjD,kBAAkB,CAAC,OAAO,EAAE,iCAAiC,EAAE,SAAS,CAAC,CAAC;IAE1E,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG;QACf,MAAM;QACN,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC;QACtC,KAAK;KACN,CAAC;IAEF,KAAK,CAAC,QAAQ,EAAE,qCAAqC,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,WAAmB;IACtD,OAAO,CACL,KAAK,KAAK,IAAI;WACX,OAAO,KAAK,KAAK,QAAQ;WACzB,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC;WACxD,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,KAAK,IAAI,CAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,KAAc;IAEd,OAAO,WAAW,CAAC,KAAK,EAAE,qCAAqC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAuD;IAEvD,kBAAkB,CAAC,KAAK,EAAE,8BAA8B,CAAC,CAAC;IAE1D,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;IAEF,KAAK,CAAC,KAAK,EAAE,kCAAkC,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,OAAO,WAAW,CAAC,KAAK,EAAE,kCAAkC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,+BAA+B,CAAmB,KAA6D,IAAqE,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE3N,SAAS,sBAAsB,CAAC,KAAc;IAC5C,OAAO,OAAO,CACZ,KAAK;WACA,OAAO,KAAK,KAAK,QAAQ;WACzB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAChD,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,CAAC"}

package/dist/runtime-binding.part05.d.ts

@@ -0,0 +1,8 @@
+import { type ActiveBindingCollection } from '@flyingrobots/bijou';
+import { type RuntimeStackLayer, type RuntimeViewStack } from './runtime-engine.js';
+import type { DispatchRuntimeCommandIntentInput, DispatchRuntimeCommandIntentResult, RuntimeBindingLayerModel, RuntimeViewBindingSource } from './runtime-binding.part01.js';
+export declare function dispatchRuntimeCommandIntent<Payload, Command>(input: DispatchRuntimeCommandIntentInput<Payload, Command>): DispatchRuntimeCommandIntentResult<Command>;
+export declare function isRuntimeViewBindingSource(value: unknown): value is RuntimeViewBindingSource;
+export declare function runtimeActiveBindingLayers<Model extends RuntimeBindingLayerModel>(stack: RuntimeViewStack<Model>): readonly RuntimeStackLayer<Model>[];
+export declare function collectRuntimeViewBindings<Model extends RuntimeBindingLayerModel>(stack: RuntimeViewStack<Model>): ActiveBindingCollection;
+//# sourceMappingURL=runtime-binding.part05.d.ts.map

package/dist/runtime-binding.part05.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-binding.part05.d.ts","sourceRoot":"","sources":["../src/runtime-binding.part05.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EAAyB,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE3G,OAAO,KAAK,EAAE,iCAAiC,EAAE,kCAAkC,EAAE,wBAAwB,EAA6B,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAGxM,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,EAC3D,KAAK,EAAE,iCAAiC,CAAC,OAAO,EAAE,OAAO,CAAC,GACzD,kCAAkC,CAAC,OAAO,CAAC,CAsC7C;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,wBAAwB,CAEnC;AAUD,wBAAgB,0BAA0B,CAAC,KAAK,SAAS,wBAAwB,EAC/E,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAC7B,SAAS,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAmBrC;AAED,wBAAgB,0BAA0B,CAAC,KAAK,SAAS,wBAAwB,EAC/E,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAC7B,uBAAuB,CA0BzB"}

package/dist/runtime-binding.part05.js

@@ -0,0 +1,79 @@
+import { collectActiveBindings } from '@flyingrobots/bijou';
+import { appendRuntimeCommands } from './runtime-engine.js';
+import { RUNTIME_COMMAND_INTENT_ROUTE_BRAND, RUNTIME_VIEW_BINDING_SOURCE_BRAND, assertObjectRecord } from './runtime-binding.part01.js';
+import { hasOwnBrand, isRuntimeCommandBuffer, isRuntimeCommandIntentEmission, isRuntimeCommandIntentRouteList } from './runtime-binding.part04.js';
+export function dispatchRuntimeCommandIntent(input) {
+    assertObjectRecord(input, 'runtime command intent dispatch');
+    if (!isRuntimeCommandIntentEmission(input.emission)) {
+        throw new Error('runtime command intent dispatch: emission was not created by runtimeCommandIntentEmission()');
+    }
+    if (!isRuntimeCommandIntentRouteList(input.routes)) {
+        throw new Error('runtime command intent dispatch: routes must be an array');
+    }
+    if (!isRuntimeCommandBuffer(input.buffer)) {
+        throw new Error('runtime command intent dispatch: buffer must be a RuntimeCommandBuffer');
+    }
+    let route;
+    input.routes.forEach((candidate, index) => {
+        if (!hasOwnBrand(candidate, RUNTIME_COMMAND_INTENT_ROUTE_BRAND)) {
+            throw new Error(`runtime command intent dispatch: route at index ${String(index)} was not created by runtimeCommandIntentRoute()`);
+        }
+        if (route === undefined && candidate.intent.id === input.emission.intent.id) {
+            route = candidate;
+        }
+    });
+    if (route === undefined) {
+        throw new Error(`runtime command intent dispatch: no route for intent ${input.emission.intent.id}`);
+    }
+    const command = route.toCommand(input.emission);
+    return Object.freeze({
+        command,
+        buffer: appendRuntimeCommands(input.buffer, [command]),
+    });
+}
+export function isRuntimeViewBindingSource(value) {
+    return hasOwnBrand(value, RUNTIME_VIEW_BINDING_SOURCE_BRAND);
+}
+function isRuntimeViewStack(value) {
+    return Boolean(value
+        && typeof value === 'object'
+        && Array.isArray(Reflect.get(value, 'layers')));
+}
+export function runtimeActiveBindingLayers(stack) {
+    if (!isRuntimeViewStack(stack)) {
+        throw new Error('runtime binding collection: stack must be a RuntimeViewStack');
+    }
+    const activeLayers = [];
+    for (let index = stack.layers.length - 1; index >= 0; index -= 1) {
+        const layer = stack.layers[index];
+        if (layer === undefined) {
+            continue;
+        }
+        activeLayers.unshift(layer);
+        if (layer.blocksBelow) {
+            break;
+        }
+    }
+    return Object.freeze(activeLayers);
+}
+export function collectRuntimeViewBindings(stack) {
+    const contracts = runtimeActiveBindingLayers(stack).flatMap((layer) => {
+        const bindingSources = layer.model?.bindingSources ?? [];
+        if (!Array.isArray(bindingSources)) {
+            throw new Error(`runtime binding collection: bindingSources for layer ${layer.id} must be an array`);
+        }
+        return bindingSources.map((source, index) => {
+            if (!isRuntimeViewBindingSource(source)) {
+                throw new Error(`runtime binding collection: source at layer ${layer.id} index ${String(index)} `
+                    + 'was not created by runtimeViewBindingSource()');
+            }
+            return {
+                owner: source.owner,
+                contract: source.contract,
+                providerIds: source.providerIds,
+            };
+        });
+    });
+    return collectActiveBindings({ contracts });
+}
+//# sourceMappingURL=runtime-binding.part05.js.map

package/dist/runtime-binding.part05.js.map

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

package/dist/runtime-buffers.d.ts

@@ -0,0 +1,13 @@
+import { type Surface } from '@flyingrobots/bijou';
+/** Own the two framebuffers and pooled differ output bytes. */
+export declare class RuntimeFramebuffers {
+    current: Surface;
+    next: Surface;
+    output: Uint8Array;
+    constructor(columns: number, rows: number);
+    reset(columns: number, rows: number, invalidateFront?: boolean): void;
+    ensure(columns: number, rows: number): void;
+    adoptTarget(surface: Surface): void;
+    replaceFront(surface: Surface): void;
+}
+//# sourceMappingURL=runtime-buffers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-buffers.d.ts","sourceRoot":"","sources":["../src/runtime-buffers.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EACb,MAAM,qBAAqB,CAAC;AAK7B,+DAA+D;AAC/D,qBAAa,mBAAmB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;gBAEP,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAMzC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,UAAQ,GAAG,IAAI;IAUnE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAW3C,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IASnC,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAIrC"}

package/dist/runtime-buffers.js

@@ -0,0 +1,55 @@
+import { createSurface, } from '@flyingrobots/bijou';
+const BYTES_PER_CELL = 96;
+const OUTPUT_SLACK = 8192;
+/** Own the two framebuffers and pooled differ output bytes. */
+export class RuntimeFramebuffers {
+    current;
+    next;
+    output;
+    constructor(columns, rows) {
+        this.current = createSurface(columns, rows);
+        this.next = createSurface(columns, rows);
+        this.output = allocateOutput(columns, rows);
+    }
+    reset(columns, rows, invalidateFront = false) {
+        this.current = invalidateFront
+            ? invalidatedSurface(columns, rows)
+            : createSurface(columns, rows);
+        this.next = createSurface(columns, rows);
+        if (this.output.byteLength < outputCapacity(columns, rows)) {
+            this.output = allocateOutput(columns, rows);
+        }
+    }
+    ensure(columns, rows) {
+        if (this.current.width !== columns
+            || this.current.height !== rows
+            || this.next.width !== columns
+            || this.next.height !== rows) {
+            this.reset(columns, rows);
+        }
+    }
+    adoptTarget(surface) {
+        const previousFront = this.current;
+        const previousBack = this.next;
+        this.current = surface;
+        this.next = surface === previousFront
+            ? previousBack
+            : previousFront;
+    }
+    replaceFront(surface) {
+        this.current = surface;
+        this.next = createSurface(surface.width, surface.height);
+    }
+}
+function allocateOutput(columns, rows) {
+    return new Uint8Array(outputCapacity(columns, rows));
+}
+function outputCapacity(columns, rows) {
+    return columns * rows * BYTES_PER_CELL + OUTPUT_SLACK;
+}
+function invalidatedSurface(columns, rows) {
+    const surface = createSurface(columns, rows);
+    surface.fill({ char: '\0', empty: false });
+    return surface;
+}
+//# sourceMappingURL=runtime-buffers.js.map

package/dist/runtime-buffers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-buffers.js","sourceRoot":"","sources":["../src/runtime-buffers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GAEd,MAAM,qBAAqB,CAAC;AAE7B,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,+DAA+D;AAC/D,MAAM,OAAO,mBAAmB;IAC9B,OAAO,CAAU;IACjB,IAAI,CAAU;IACd,MAAM,CAAa;IAEnB,YAAY,OAAe,EAAE,IAAY;QACvC,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAY,EAAE,eAAe,GAAG,KAAK;QAC1D,IAAI,CAAC,OAAO,GAAG,eAAe;YAC5B,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC;YACnC,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,MAAM,CAAC,OAAe,EAAE,IAAY;QAClC,IACE,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,OAAO;eAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,IAAI;eAC5B,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,OAAO;eAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,EAC5B,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,WAAW,CAAC,OAAgB;QAC1B,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC;QACnC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,OAAO,KAAK,aAAa;YACnC,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,aAAa,CAAC;IACpB,CAAC;IAED,YAAY,CAAC,OAAgB;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;CACF;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,IAAY;IACnD,OAAO,IAAI,UAAU,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,IAAY;IACnD,OAAO,OAAO,GAAG,IAAI,GAAG,cAAc,GAAG,YAAY,CAAC;AACxD,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAe,EAAE,IAAY;IACvD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3C,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/runtime-bus.d.ts

@@ -0,0 +1,6 @@
+import type { BijouContext, ClockPort } from '@flyingrobots/bijou';
+import { type EventBus } from './eventbus.js';
+import type { RunOptions, RuntimeIssue } from './types.js';
+/** Create the runtime bus with issue routing and error-reporting policy. */
+export declare function createRuntimeBus<M>(options: RunOptions<M> | undefined, clock: ClockPort, ctx: BijouContext, routeIssue: (issue: RuntimeIssue) => void): EventBus<M>;
+//# sourceMappingURL=runtime-bus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-bus.d.ts","sourceRoot":"","sources":["../src/runtime-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACb,MAAM,YAAY,CAAC;AAMpB,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,EAClC,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GACxC,QAAQ,CAAC,CAAC,CAAC,CA2Cb"}

package/dist/runtime-bus.js

@@ -0,0 +1,47 @@
+import { createEventBus, } from './eventbus.js';
+import { formatRuntimeDetail, writeErrorLine, } from './runtime-format.js';
+/** Create the runtime bus with issue routing and error-reporting policy. */
+export function createRuntimeBus(options, clock, ctx, routeIssue) {
+    return createEventBus({
+        clock,
+        commandBackpressureThreshold: options?.commandBackpressureThreshold,
+        onCommandBackpressure(info) {
+            const message = `Command backpressure: ${String(info.pendingCommands)} commands`
+                + ` pending (threshold ${String(info.backpressureThreshold)})`;
+            writeErrorLine(ctx.io, `[EventBus] ${message}\n`);
+            routeIssue({
+                level: 'warning',
+                source: 'command',
+                message,
+                atMs: info.atMs,
+            });
+        },
+        onCommandRejected(error) {
+            const message = error instanceof Error
+                ? `${error.name}: ${error.message}`
+                : formatRuntimeDetail(error);
+            writeErrorLine(ctx.io, `[EventBus] Command rejected: ${message}\n`);
+            routeIssue({
+                level: 'error',
+                source: 'command',
+                message,
+                atMs: clock.now(),
+                error,
+            });
+        },
+        onError(message, error) {
+            const detail = error instanceof Error
+                ? `${error.name}: ${error.message}`
+                : formatRuntimeDetail(error);
+            writeErrorLine(ctx.io, `${message} ${detail}\n`);
+            routeIssue({
+                level: 'warning',
+                source: 'eventbus',
+                message: `${message} ${detail}`,
+                atMs: clock.now(),
+                error,
+            });
+        },
+    });
+}
+//# sourceMappingURL=runtime-bus.js.map

package/dist/runtime-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-bus.js","sourceRoot":"","sources":["../src/runtime-bus.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,cAAc,GAEf,MAAM,eAAe,CAAC;AAKvB,OAAO,EACL,mBAAmB,EACnB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAC9B,OAAkC,EAClC,KAAgB,EAChB,GAAiB,EACjB,UAAyC;IAEzC,OAAO,cAAc,CAAC;QACpB,KAAK;QACL,4BAA4B,EAAE,OAAO,EAAE,4BAA4B;QACnE,qBAAqB,CAAC,IAAI;YACxB,MAAM,OAAO,GACX,yBAAyB,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW;kBAC9D,uBAAuB,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC;YACjE,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,cAAc,OAAO,IAAI,CAAC,CAAC;YAClD,UAAU,CAAC;gBACT,KAAK,EAAE,SAAS;gBAChB,MAAM,EAAE,SAAS;gBACjB,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;QACD,iBAAiB,CAAC,KAAK;YACrB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK;gBACpC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE;gBACnC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC/B,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,gCAAgC,OAAO,IAAI,CAAC,CAAC;YACpE,UAAU,CAAC;gBACT,KAAK,EAAE,OAAO;gBACd,MAAM,EAAE,SAAS;gBACjB,OAAO;gBACP,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE;gBACjB,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC,OAAO,EAAE,KAAK;YACpB,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK;gBACnC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE;gBACnC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC/B,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,OAAO,IAAI,MAAM,IAAI,CAAC,CAAC;YACjD,UAAU,CAAC;gBACT,KAAK,EAAE,SAAS;gBAChB,MAAM,EAAE,UAAU;gBAClB,OAAO,EAAE,GAAG,OAAO,IAAI,MAAM,EAAE;gBAC/B,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE;gBACjB,KAAK;aACN,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/runtime-commands.d.ts

@@ -0,0 +1,31 @@
+/** Sentinel symbol signaling that the application should quit. */
+export declare const QUIT: unique symbol;
+export type QuitSignal = typeof QUIT;
+/** Disposable cleanup handle returned by long-lived command effects. */
+export interface CmdDisposable {
+    dispose(): void;
+}
+export type CmdCleanup = CmdDisposable | (() => void);
+export type CmdResult<M> = M | QuitSignal | CmdCleanup | undefined;
+export declare function isCmdDisposable(value: unknown): value is CmdDisposable;
+export declare function isCmdCleanup(value: unknown): value is CmdCleanup;
+/** A side effect that can emit messages back to the application. */
+export type Cmd<M> = (emit: (msg: M) => void, capabilities: CmdCapabilities) => CmdResult<M> | Promise<CmdResult<M>>;
+/** Capabilities provided to commands by the runtime. */
+export interface CmdCapabilities {
+    onPulse(handler: (dt: number) => void): CmdDisposable;
+    sleep?(ms: number): Promise<void>;
+    defer?(): Promise<void>;
+    now?(): number;
+}
+export type RuntimeIssueLevel = 'warning' | 'error';
+export type RuntimeIssueSource = 'command' | 'eventbus' | 'runtime';
+/** Framework-level issue routed alongside normal app messages when supported. */
+export interface RuntimeIssue {
+    readonly level: RuntimeIssueLevel;
+    readonly source: RuntimeIssueSource;
+    readonly message: string;
+    readonly atMs: number;
+    readonly error?: unknown;
+}
+//# sourceMappingURL=runtime-commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-commands.d.ts","sourceRoot":"","sources":["../src/runtime-commands.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,IAAI,EAAE,OAAO,MAAuB,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC;AAErC,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;AACtD,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAEnE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAOtE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,oEAAoE;AACpE,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CACnB,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EACtB,YAAY,EAAE,eAAe,KAC1B,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1C,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,aAAa,CAAC;IACtD,KAAK,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,GAAG,CAAC,IAAI,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,OAAO,CAAC;AACpD,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAEpE,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/dist/runtime-commands.js

@@ -0,0 +1,12 @@
+/** Sentinel symbol signaling that the application should quit. */
+export const QUIT = Symbol('QUIT');
+export function isCmdDisposable(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'dispose' in value &&
+        typeof value.dispose === 'function');
+}
+export function isCmdCleanup(value) {
+    return typeof value === 'function' || isCmdDisposable(value);
+}
+//# sourceMappingURL=runtime-commands.js.map

package/dist/runtime-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-commands.js","sourceRoot":"","sources":["../src/runtime-commands.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,IAAI,GAAkB,MAAM,CAAC,MAAM,CAAC,CAAC;AAYlD,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,SAAS,IAAI,KAAK;QAClB,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU,CACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,UAAU,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC"}