@ankhorage/runtime 0.1.0 → 0.2.0

package/dist/runtimeRepeatEmptyState.d.ts

@@ -0,0 +1,7 @@
+import type { BindingValue, DataSourceDiagnostic } from '@ankhorage/contracts';
+export declare function shouldRenderRuntimeRepeatEmptyState(args: {
+    readonly diagnostics?: readonly DataSourceDiagnostic[];
+    readonly items?: readonly BindingValue[];
+    readonly status?: 'pending' | 'ready';
+}): boolean;
+//# sourceMappingURL=runtimeRepeatEmptyState.d.ts.map

package/dist/runtimeRepeatEmptyState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeRepeatEmptyState.d.ts","sourceRoot":"","sources":["../src/runtimeRepeatEmptyState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,wBAAgB,mCAAmC,CAAC,IAAI,EAAE;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CACvC,GAAG,OAAO,CAUV"}

package/dist/runtimeRepeatEmptyState.js

@@ -0,0 +1,10 @@
+export function shouldRenderRuntimeRepeatEmptyState(args) {
+    if (args.status !== 'ready') {
+        return false;
+    }
+    if (!Array.isArray(args.items) || args.items.length > 0) {
+        return false;
+    }
+    return !(args.diagnostics ?? []).some((diagnostic) => diagnostic.severity === 'error');
+}
+//# sourceMappingURL=runtimeRepeatEmptyState.js.map

package/dist/runtimeRepeatEmptyState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeRepeatEmptyState.js","sourceRoot":"","sources":["../src/runtimeRepeatEmptyState.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mCAAmC,CAAC,IAInD;IACC,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;AACzF,CAAC","sourcesContent":["import type { BindingValue, DataSourceDiagnostic } from '@ankhorage/contracts';\n\nexport function shouldRenderRuntimeRepeatEmptyState(args: {\n  readonly diagnostics?: readonly DataSourceDiagnostic[];\n  readonly items?: readonly BindingValue[];\n  readonly status?: 'pending' | 'ready';\n}): boolean {\n  if (args.status !== 'ready') {\n    return false;\n  }\n\n  if (!Array.isArray(args.items) || args.items.length > 0) {\n    return false;\n  }\n\n  return !(args.diagnostics ?? []).some((diagnostic) => diagnostic.severity === 'error');\n}\n"]}

package/dist/runtimeScreenLoaders.d.ts

@@ -0,0 +1,71 @@
+import type { ApiScreenDataLoaderDefinition, DataSourceDiagnostic, OperationScreenDataLoaderDefinition, ScreenSpec } from '@ankhorage/contracts';
+import { type RuntimeBindingOperationExecutor, type RuntimeBindingOperationResultCache, type RuntimeBindingResolutionContext } from './runtimeBindings';
+export interface RuntimeScreenOperationLoaderState {
+    readonly dependencyKey: string;
+    readonly diagnostics: readonly DataSourceDiagnostic[];
+    readonly operationResults: RuntimeBindingOperationResultCache;
+    readonly renderVersion: number;
+}
+export interface RuntimeScreenOperationLoaderExecutionResult {
+    readonly dependencyKey: string;
+    readonly diagnostics: readonly DataSourceDiagnostic[];
+    readonly operationResults: RuntimeBindingOperationResultCache;
+}
+export interface RuntimeScreenOperationLoaderLifecycle {
+    readonly activeRequestId: number;
+    readonly activeRequestKey: string | null;
+}
+export declare function resolveScreenApiLoaders(screen: ScreenSpec): readonly ApiScreenDataLoaderDefinition[];
+export declare function resolveScreenOperationLoaders(screen: ScreenSpec): readonly OperationScreenDataLoaderDefinition[];
+export declare function createRuntimeScreenLoaderRequestKey(args: {
+    readonly screenId: string;
+    readonly loaders: readonly OperationScreenDataLoaderDefinition[];
+    readonly bindingContext?: Record<string, unknown>;
+    readonly operationResults?: RuntimeBindingOperationResultCache;
+}): string;
+export declare function createRuntimeScreenOperationLoaderLifecycle(): RuntimeScreenOperationLoaderLifecycle;
+export declare function createIdleRuntimeScreenOperationLoaderState(args: {
+    readonly dependencyKey: string;
+    readonly previousState?: RuntimeScreenOperationLoaderState;
+}): RuntimeScreenOperationLoaderState;
+export declare function createPendingRuntimeScreenOperationLoaderState(args: {
+    readonly dependencyKey: string;
+    readonly previousState?: RuntimeScreenOperationLoaderState;
+}): RuntimeScreenOperationLoaderState;
+export declare function beginRuntimeScreenOperationLoaderRequest(args: {
+    readonly hasLoaders: boolean;
+    readonly lifecycle: RuntimeScreenOperationLoaderLifecycle;
+    readonly requestKey: string;
+    readonly state: RuntimeScreenOperationLoaderState;
+}): {
+    readonly lifecycle: RuntimeScreenOperationLoaderLifecycle;
+    readonly requestId?: number;
+    readonly shouldExecute: boolean;
+    readonly state: RuntimeScreenOperationLoaderState;
+};
+export declare function completeRuntimeScreenOperationLoaderRequest(args: {
+    readonly lifecycle: RuntimeScreenOperationLoaderLifecycle;
+    readonly requestId: number;
+    readonly result: RuntimeScreenOperationLoaderExecutionResult;
+    readonly state: RuntimeScreenOperationLoaderState;
+}): {
+    readonly accepted: boolean;
+    readonly state: RuntimeScreenOperationLoaderState;
+};
+export declare function executeRuntimeScreenOperationLoaders(args: {
+    readonly bindingContext?: Record<string, unknown>;
+    readonly dataSources?: RuntimeBindingResolutionContext['dataSources'];
+    readonly executeOperation?: RuntimeBindingOperationExecutor;
+    readonly operationResults?: RuntimeBindingOperationResultCache;
+    readonly screen: ScreenSpec;
+    readonly loaders: readonly OperationScreenDataLoaderDefinition[];
+}): Promise<RuntimeScreenOperationLoaderExecutionResult>;
+export declare function useRuntimeScreenOperationLoaders(args: {
+    readonly bindingContext?: Record<string, unknown>;
+    readonly dataSources?: RuntimeBindingResolutionContext['dataSources'];
+    readonly executeOperation?: RuntimeBindingOperationExecutor;
+    readonly operationResults?: RuntimeBindingOperationResultCache;
+    readonly onDiagnostics?: (diagnostics: readonly DataSourceDiagnostic[]) => void;
+    readonly screen: ScreenSpec;
+}): RuntimeScreenOperationLoaderState;
+//# sourceMappingURL=runtimeScreenLoaders.d.ts.map

package/dist/runtimeScreenLoaders.d.ts.map

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

package/dist/runtimeScreenLoaders.js

@@ -0,0 +1,309 @@
+import React from 'react';
+import { createRuntimeBindingOperationKey, resolveBindingInputMapSync, resolveRuntimeBindingOperationSelection, } from './runtimeBindings';
+const EMPTY_RUNTIME_SCREEN_OPERATION_LOADER_DIAGNOSTICS = Object.freeze([]);
+const EMPTY_RUNTIME_SCREEN_OPERATION_RESULTS = Object.freeze({});
+export function resolveScreenApiLoaders(screen) {
+    return (screen.dataLoaders ?? []).filter((loader) => loader.kind === 'api');
+}
+export function resolveScreenOperationLoaders(screen) {
+    return (screen.dataLoaders ?? []).filter((loader) => loader.kind === 'operation');
+}
+export function createRuntimeScreenLoaderRequestKey(args) {
+    return createRuntimeScreenOperationLoaderPlan({
+        bindingContext: args.bindingContext,
+        loaders: args.loaders,
+        operationResults: args.operationResults,
+        screenId: args.screenId,
+    }).requestKey;
+}
+export function createRuntimeScreenOperationLoaderLifecycle() {
+    return {
+        activeRequestId: 0,
+        activeRequestKey: null,
+    };
+}
+export function createIdleRuntimeScreenOperationLoaderState(args) {
+    return {
+        dependencyKey: args.dependencyKey,
+        diagnostics: EMPTY_RUNTIME_SCREEN_OPERATION_LOADER_DIAGNOSTICS,
+        operationResults: EMPTY_RUNTIME_SCREEN_OPERATION_RESULTS,
+        renderVersion: args.previousState?.renderVersion ?? 0,
+    };
+}
+export function createPendingRuntimeScreenOperationLoaderState(args) {
+    return {
+        dependencyKey: args.dependencyKey,
+        diagnostics: [],
+        operationResults: {},
+        renderVersion: (args.previousState?.renderVersion ?? -1) + 1,
+    };
+}
+export function beginRuntimeScreenOperationLoaderRequest(args) {
+    if (!args.hasLoaders) {
+        if (args.lifecycle.activeRequestKey === null) {
+            return {
+                lifecycle: args.lifecycle,
+                shouldExecute: false,
+                state: args.state,
+            };
+        }
+        return {
+            lifecycle: {
+                activeRequestId: args.lifecycle.activeRequestId + 1,
+                activeRequestKey: null,
+            },
+            shouldExecute: false,
+            state: args.state,
+        };
+    }
+    if (args.lifecycle.activeRequestKey === args.requestKey) {
+        return {
+            lifecycle: args.lifecycle,
+            shouldExecute: false,
+            state: args.state,
+        };
+    }
+    const requestId = args.lifecycle.activeRequestId + 1;
+    return {
+        lifecycle: {
+            activeRequestId: requestId,
+            activeRequestKey: args.requestKey,
+        },
+        requestId,
+        shouldExecute: true,
+        state: args.state.dependencyKey === args.requestKey
+            ? args.state
+            : createPendingRuntimeScreenOperationLoaderState({
+                dependencyKey: args.requestKey,
+                previousState: args.state,
+            }),
+    };
+}
+export function completeRuntimeScreenOperationLoaderRequest(args) {
+    if (args.lifecycle.activeRequestId !== args.requestId) {
+        return {
+            accepted: false,
+            state: args.state,
+        };
+    }
+    return {
+        accepted: true,
+        state: {
+            dependencyKey: args.result.dependencyKey,
+            diagnostics: args.result.diagnostics,
+            operationResults: args.result.operationResults,
+            renderVersion: args.state.renderVersion,
+        },
+    };
+}
+export async function executeRuntimeScreenOperationLoaders(args) {
+    const plan = createRuntimeScreenOperationLoaderPlan({
+        bindingContext: args.bindingContext,
+        loaders: args.loaders,
+        operationResults: args.operationResults,
+        screenId: args.screen.id,
+    });
+    return executePreparedRuntimeScreenOperationLoaders({
+        dataSources: args.dataSources,
+        executeOperation: args.executeOperation,
+        plan,
+        screen: args.screen,
+    });
+}
+function executePreparedRuntimeScreenOperationLoaders(args) {
+    const diagnostics = [...args.plan.diagnostics];
+    if (args.plan.loaders.length === 0) {
+        return Promise.resolve({
+            dependencyKey: args.plan.requestKey,
+            diagnostics,
+            operationResults: {},
+        });
+    }
+    if (args.executeOperation === undefined) {
+        diagnostics.push(...args.plan.loaders.map((preparedLoader) => createScreenOperationLoaderDiagnostic(preparedLoader.loader, 'missing-adapter', 'Screen operation loader requires an injected operation executor.')));
+        return Promise.resolve({
+            dependencyKey: args.plan.requestKey,
+            diagnostics,
+            operationResults: {},
+        });
+    }
+    const { executeOperation } = args;
+    return (async () => {
+        const operationResults = {};
+        for (const preparedLoader of args.plan.loaders) {
+            const selection = resolveRuntimeBindingOperationSelection(preparedLoader.loader.operation, args.dataSources, diagnostics);
+            if (selection === undefined) {
+                continue;
+            }
+            const result = await executeOperation({
+                dataSource: selection.dataSource,
+                endpoint: selection.endpoint,
+                input: preparedLoader.input,
+                node: args.screen.root,
+                operation: preparedLoader.loader.operation,
+            });
+            diagnostics.push(...(result.diagnostics ?? []));
+            if (!result.ok) {
+                continue;
+            }
+            operationResults[preparedLoader.operationKey] = result.data;
+        }
+        return {
+            dependencyKey: args.plan.requestKey,
+            diagnostics,
+            operationResults,
+        };
+    })();
+}
+export function useRuntimeScreenOperationLoaders(args) {
+    const loaders = React.useMemo(() => resolveScreenOperationLoaders(args.screen), [args.screen]);
+    const hasLoaders = loaders.length > 0;
+    const plan = React.useMemo(() => createRuntimeScreenOperationLoaderPlan({
+        bindingContext: args.bindingContext,
+        loaders,
+        operationResults: args.operationResults,
+        screenId: args.screen.id,
+    }), [args.bindingContext, args.operationResults, args.screen.id, loaders]);
+    const { requestKey } = plan;
+    const emptyState = React.useMemo(() => createIdleRuntimeScreenOperationLoaderState({
+        dependencyKey: requestKey,
+    }), [requestKey]);
+    const [state, setState] = React.useState(() => hasLoaders
+        ? createPendingRuntimeScreenOperationLoaderState({ dependencyKey: requestKey })
+        : emptyState);
+    const effectiveState = hasLoaders ? state : emptyState;
+    const lastDiagnosticsKeyRef = React.useRef(null);
+    const latestStateRef = React.useRef(state);
+    const lifecycleRef = React.useRef(createRuntimeScreenOperationLoaderLifecycle());
+    const executionArgsByRequestKeyRef = React.useRef({});
+    executionArgsByRequestKeyRef.current[requestKey] = {
+        dataSources: args.dataSources,
+        executeOperation: args.executeOperation,
+        plan,
+        screen: args.screen,
+    };
+    latestStateRef.current = state;
+    React.useEffect(() => {
+        const request = beginRuntimeScreenOperationLoaderRequest({
+            hasLoaders,
+            lifecycle: lifecycleRef.current,
+            requestKey,
+            state: latestStateRef.current,
+        });
+        lifecycleRef.current = request.lifecycle;
+        if (request.state !== latestStateRef.current) {
+            setState(request.state);
+        }
+        if (!request.shouldExecute || request.requestId === undefined) {
+            return;
+        }
+        const { requestId } = request;
+        void (async () => {
+            const executionArgs = executionArgsByRequestKeyRef.current[requestKey];
+            if (executionArgs === undefined) {
+                return;
+            }
+            const result = await executePreparedRuntimeScreenOperationLoaders(executionArgs);
+            setState((currentState) => {
+                const completion = completeRuntimeScreenOperationLoaderRequest({
+                    lifecycle: lifecycleRef.current,
+                    requestId,
+                    result,
+                    state: currentState,
+                });
+                return completion.accepted ? completion.state : currentState;
+            });
+        })();
+    }, [hasLoaders, requestKey]);
+    React.useEffect(() => {
+        if (effectiveState.diagnostics.length === 0) {
+            return;
+        }
+        const diagnosticsKey = stableSerialize(effectiveState.diagnostics);
+        if (lastDiagnosticsKeyRef.current === diagnosticsKey) {
+            return;
+        }
+        lastDiagnosticsKeyRef.current = diagnosticsKey;
+        args.onDiagnostics?.(effectiveState.diagnostics);
+    }, [args.onDiagnostics, effectiveState.diagnostics]);
+    return effectiveState;
+}
+function createRuntimeScreenOperationLoaderPlan(args) {
+    if (args.loaders.length === 0) {
+        return {
+            diagnostics: EMPTY_RUNTIME_SCREEN_OPERATION_LOADER_DIAGNOSTICS,
+            loaders: [],
+            requestKey: createRuntimeScreenOperationLoaderIdleKey(args.screenId),
+        };
+    }
+    const diagnostics = [];
+    const preparedLoaders = [];
+    const operationKeys = new Set();
+    for (const loader of args.loaders) {
+        const input = resolveBindingInputMapSync(loader.input, {
+            context: args.bindingContext,
+            operationResults: args.operationResults,
+        }, diagnostics);
+        const operationKey = createRuntimeBindingOperationKey(loader.operation);
+        if (operationKeys.has(operationKey)) {
+            diagnostics.push(createScreenOperationLoaderDiagnostic(loader, 'duplicate-operation-id', `Screen operation loaders must not reuse operation key '${operationKey}' on the same screen.`));
+            continue;
+        }
+        operationKeys.add(operationKey);
+        preparedLoaders.push({
+            input,
+            loader,
+            operationKey,
+        });
+    }
+    return {
+        diagnostics,
+        loaders: preparedLoaders,
+        requestKey: createRuntimeScreenOperationLoaderPlanRequestKey({
+            loaders: preparedLoaders,
+            screenId: args.screenId,
+        }),
+    };
+}
+function createRuntimeScreenOperationLoaderPlanRequestKey(args) {
+    return stableSerialize({
+        loaders: args.loaders.map((loader) => ({
+            id: loader.loader.id,
+            input: loader.input,
+            operation: loader.loader.operation,
+            operationKey: loader.operationKey,
+        })),
+        screenId: args.screenId,
+    });
+}
+function createScreenOperationLoaderDiagnostic(loader, code, message) {
+    return {
+        code,
+        dataSourceId: loader.operation.dataSourceId,
+        endpointId: loader.operation.endpointId,
+        operationId: loader.operation.operationId,
+        message,
+        severity: 'error',
+    };
+}
+function createRuntimeScreenOperationLoaderIdleKey(screenId) {
+    return `screen:${screenId}:no-operation-loaders`;
+}
+function stableSerialize(value) {
+    return JSON.stringify(sortSerializableValue(value));
+}
+function sortSerializableValue(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortSerializableValue);
+    }
+    if (typeof value !== 'object' || value === null) {
+        return value;
+    }
+    return Object.keys(value)
+        .sort((left, right) => left.localeCompare(right))
+        .reduce((result, key) => {
+        result[key] = sortSerializableValue(value[key]);
+        return result;
+    }, {});
+}
+//# sourceMappingURL=runtimeScreenLoaders.js.map

package/dist/runtimeScreenLoaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeScreenLoaders.js","sourceRoot":"","sources":["../src/runtimeScreenLoaders.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EACL,gCAAgC,EAChC,0BAA0B,EAC1B,uCAAuC,GAIxC,MAAM,mBAAmB,CAAC;AAoB3B,MAAM,iDAAiD,GAAG,MAAM,CAAC,MAAM,CACrE,EAAE,CACgC,CAAC;AACrC,MAAM,sCAAsC,GAAG,MAAM,CAAC,MAAM,CAC1D,EAAE,CACmC,CAAC;AAExC,MAAM,UAAU,uBAAuB,CACrC,MAAkB;IAElB,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CACtC,CAAC,MAAM,EAA2C,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAC3E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,MAAkB;IAElB,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CACtC,CAAC,MAAM,EAAiD,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,WAAW,CACvF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,IAKnD;IACC,OAAO,sCAAsC,CAAC;QAC5C,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC,UAAU,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,2CAA2C;IACzD,OAAO;QACL,eAAe,EAAE,CAAC;QAClB,gBAAgB,EAAE,IAAI;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2CAA2C,CAAC,IAG3D;IACC,OAAO;QACL,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,WAAW,EAAE,iDAAiD;QAC9D,gBAAgB,EAAE,sCAAsC;QACxD,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,aAAa,IAAI,CAAC;KACtD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8CAA8C,CAAC,IAG9D;IACC,OAAO;QACL,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,WAAW,EAAE,EAAE;QACf,gBAAgB,EAAE,EAAE;QACpB,aAAa,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wCAAwC,CAAC,IAKxD;IAMC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrB,IAAI,IAAI,CAAC,SAAS,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;YAC7C,OAAO;gBACL,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,aAAa,EAAE,KAAK;gBACpB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,SAAS,EAAE;gBACT,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,eAAe,GAAG,CAAC;gBACnD,gBAAgB,EAAE,IAAI;aACvB;YACD,aAAa,EAAE,KAAK;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,CAAC,gBAAgB,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QACxD,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,aAAa,EAAE,KAAK;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,GAAG,CAAC,CAAC;IAErD,OAAO;QACL,SAAS,EAAE;YACT,eAAe,EAAE,SAAS;YAC1B,gBAAgB,EAAE,IAAI,CAAC,UAAU;SAClC;QACD,SAAS;QACT,aAAa,EAAE,IAAI;QACnB,KAAK,EACH,IAAI,CAAC,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC,UAAU;YAC1C,CAAC,CAAC,IAAI,CAAC,KAAK;YACZ,CAAC,CAAC,8CAA8C,CAAC;gBAC7C,aAAa,EAAE,IAAI,CAAC,UAAU;gBAC9B,aAAa,EAAE,IAAI,CAAC,KAAK;aAC1B,CAAC;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2CAA2C,CAAC,IAK3D;IAIC,IAAI,IAAI,CAAC,SAAS,CAAC,eAAe,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;QACtD,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE;YACL,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;YACxC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;YACpC,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB;YAC9C,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa;SACxC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oCAAoC,CAAC,IAO1D;IACC,MAAM,IAAI,GAAG,sCAAsC,CAAC;QAClD,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE;KACzB,CAAC,CAAC;IAEH,OAAO,4CAA4C,CAAC;QAClD,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,IAAI;QACJ,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,4CAA4C,CAAC,IAKrD;IACC,MAAM,WAAW,GAA2B,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAEvE,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YACnC,WAAW;YACX,gBAAgB,EAAE,EAAE;SACrB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACxC,WAAW,CAAC,IAAI,CACd,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,cAAc,EAAE,EAAE,CAC1C,qCAAqC,CACnC,cAAc,CAAC,MAAM,EACrB,iBAAiB,EACjB,kEAAkE,CACnE,CACF,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YACnC,WAAW;YACX,gBAAgB,EAAE,EAAE;SACrB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAElC,OAAO,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,gBAAgB,GAA6C,EAAE,CAAC;QAEtE,KAAK,MAAM,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/C,MAAM,SAAS,GAAG,uCAAuC,CACvD,cAAc,CAAC,MAAM,CAAC,SAAS,EAC/B,IAAI,CAAC,WAAW,EAChB,WAAW,CACZ,CAAC;YACF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,SAAS;YACX,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;gBACpC,UAAU,EAAE,SAAS,CAAC,UAAU;gBAChC,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,KAAK,EAAE,cAAc,CAAC,KAAK;gBAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;gBACtB,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,SAAS;aAC3C,CAAC,CAAC;YACH,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC;YAEhD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBACf,SAAS;YACX,CAAC;YAED,gBAAgB,CAAC,cAAc,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;QAC9D,CAAC;QAED,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YACnC,WAAW;YACX,gBAAgB;SACjB,CAAC;IACJ,CAAC,CAAC,EAAE,CAAC;AACP,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,IAOhD;IACC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,6BAA6B,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/F,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CACxB,GAAG,EAAE,CACH,sCAAsC,CAAC;QACrC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,OAAO;QACP,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE;KACzB,CAAC,EACJ,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CACtE,CAAC;IACF,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAC5B,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAC9B,GAAG,EAAE,CACH,2CAA2C,CAAC;QAC1C,aAAa,EAAE,UAAU;KAC1B,CAAC,EACJ,CAAC,UAAU,CAAC,CACb,CAAC;IACF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAoC,GAAG,EAAE,CAC/E,UAAU;QACR,CAAC,CAAC,8CAA8C,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;QAC/E,CAAC,CAAC,UAAU,CACf,CAAC;IACF,MAAM,cAAc,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;IACvD,MAAM,qBAAqB,GAAG,KAAK,CAAC,MAAM,CAAgB,IAAI,CAAC,CAAC;IAChE,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAC/B,2CAA2C,EAAE,CAC9C,CAAC;IACF,MAAM,4BAA4B,GAAG,KAAK,CAAC,MAAM,CAE/C,EAAE,CAAC,CAAC;IAEN,4BAA4B,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG;QACjD,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,IAAI;QACJ,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;IACF,cAAc,CAAC,OAAO,GAAG,KAAK,CAAC;IAE/B,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,MAAM,OAAO,GAAG,wCAAwC,CAAC;YACvD,UAAU;YACV,SAAS,EAAE,YAAY,CAAC,OAAO;YAC/B,UAAU;YACV,KAAK,EAAE,cAAc,CAAC,OAAO;SAC9B,CAAC,CAAC;QAEH,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC;QAEzC,IAAI,OAAO,CAAC,KAAK,KAAK,cAAc,CAAC,OAAO,EAAE,CAAC;YAC7C,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAC9D,OAAO;QACT,CAAC;QACD,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;QAE9B,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,MAAM,aAAa,GAAG,4BAA4B,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACvE,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,4CAA4C,CAAC,aAAa,CAAC,CAAC;YAEjF,QAAQ,CAAC,CAAC,YAAY,EAAE,EAAE;gBACxB,MAAM,UAAU,GAAG,2CAA2C,CAAC;oBAC7D,SAAS,EAAE,YAAY,CAAC,OAAO;oBAC/B,SAAS;oBACT,MAAM;oBACN,KAAK,EAAE,YAAY;iBACpB,CAAC,CAAC;gBAEH,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC;YAC/D,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAE7B,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,cAAc,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,MAAM,cAAc,GAAG,eAAe,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QACnE,IAAI,qBAAqB,CAAC,OAAO,KAAK,cAAc,EAAE,CAAC;YACrD,OAAO;QACT,CAAC;QAED,qBAAqB,CAAC,OAAO,GAAG,cAAc,CAAC;QAC/C,IAAI,CAAC,aAAa,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IACnD,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC;IAErD,OAAO,cAAc,CAAC;AACxB,CAAC;AAqBD,SAAS,sCAAsC,CAAC,IAK/C;IACC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,WAAW,EAAE,iDAAiD;YAC9D,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,yCAAyC,CAAC,IAAI,CAAC,QAAQ,CAAC;SACrE,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,MAAM,eAAe,GAA2C,EAAE,CAAC;IACnE,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IAExC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,0BAA0B,CACtC,MAAM,CAAC,KAAK,EACZ;YACE,OAAO,EAAE,IAAI,CAAC,cAAc;YAC5B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;SACxC,EACD,WAAW,CACZ,CAAC;QACF,MAAM,YAAY,GAAG,gCAAgC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACxE,IAAI,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACpC,WAAW,CAAC,IAAI,CACd,qCAAqC,CACnC,MAAM,EACN,wBAAwB,EACxB,0DAA0D,YAAY,uBAAuB,CAC9F,CACF,CAAC;YACF,SAAS;QACX,CAAC;QAED,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAChC,eAAe,CAAC,IAAI,CAAC;YACnB,KAAK;YACL,MAAM;YACN,YAAY;SACb,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,WAAW;QACX,OAAO,EAAE,eAAe;QACxB,UAAU,EAAE,gDAAgD,CAAC;YAC3D,OAAO,EAAE,eAAe;YACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;KACH,CAAC;AACJ,CAAC;AAED,SAAS,gDAAgD,CAAC,IAGzD;IACC,OAAO,eAAe,CAAC;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACrC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE;YACpB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS;YAClC,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC,CAAC;QACH,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qCAAqC,CAC5C,MAA2C,EAC3C,IAAkC,EAClC,OAAe;IAEf,OAAO;QACL,IAAI;QACJ,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,YAAY;QAC3C,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,UAAU;QACvC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW;QACzC,OAAO;QACP,QAAQ,EAAE,OAAO;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,yCAAyC,CAAC,QAAgB;IACjE,OAAO,UAAU,QAAQ,uBAAuB,CAAC;AACnD,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;SACtB,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;SAChD,MAAM,CAA0B,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;QAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7E,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,EAAE,CAAC,CAAC;AACX,CAAC","sourcesContent":["import type {\n  ApiScreenDataLoaderDefinition,\n  BindingValue,\n  DataSourceDiagnostic,\n  OperationScreenDataLoaderDefinition,\n  ScreenSpec,\n} from '@ankhorage/contracts';\nimport React from 'react';\n\nimport {\n  createRuntimeBindingOperationKey,\n  resolveBindingInputMapSync,\n  resolveRuntimeBindingOperationSelection,\n  type RuntimeBindingOperationExecutor,\n  type RuntimeBindingOperationResultCache,\n  type RuntimeBindingResolutionContext,\n} from './runtimeBindings';\n\nexport interface RuntimeScreenOperationLoaderState {\n  readonly dependencyKey: string;\n  readonly diagnostics: readonly DataSourceDiagnostic[];\n  readonly operationResults: RuntimeBindingOperationResultCache;\n  readonly renderVersion: number;\n}\n\nexport interface RuntimeScreenOperationLoaderExecutionResult {\n  readonly dependencyKey: string;\n  readonly diagnostics: readonly DataSourceDiagnostic[];\n  readonly operationResults: RuntimeBindingOperationResultCache;\n}\n\nexport interface RuntimeScreenOperationLoaderLifecycle {\n  readonly activeRequestId: number;\n  readonly activeRequestKey: string | null;\n}\n\nconst EMPTY_RUNTIME_SCREEN_OPERATION_LOADER_DIAGNOSTICS = Object.freeze(\n  [],\n) as readonly DataSourceDiagnostic[];\nconst EMPTY_RUNTIME_SCREEN_OPERATION_RESULTS = Object.freeze(\n  {},\n) as RuntimeBindingOperationResultCache;\n\nexport function resolveScreenApiLoaders(\n  screen: ScreenSpec,\n): readonly ApiScreenDataLoaderDefinition[] {\n  return (screen.dataLoaders ?? []).filter(\n    (loader): loader is ApiScreenDataLoaderDefinition => loader.kind === 'api',\n  );\n}\n\nexport function resolveScreenOperationLoaders(\n  screen: ScreenSpec,\n): readonly OperationScreenDataLoaderDefinition[] {\n  return (screen.dataLoaders ?? []).filter(\n    (loader): loader is OperationScreenDataLoaderDefinition => loader.kind === 'operation',\n  );\n}\n\nexport function createRuntimeScreenLoaderRequestKey(args: {\n  readonly screenId: string;\n  readonly loaders: readonly OperationScreenDataLoaderDefinition[];\n  readonly bindingContext?: Record<string, unknown>;\n  readonly operationResults?: RuntimeBindingOperationResultCache;\n}): string {\n  return createRuntimeScreenOperationLoaderPlan({\n    bindingContext: args.bindingContext,\n    loaders: args.loaders,\n    operationResults: args.operationResults,\n    screenId: args.screenId,\n  }).requestKey;\n}\n\nexport function createRuntimeScreenOperationLoaderLifecycle(): RuntimeScreenOperationLoaderLifecycle {\n  return {\n    activeRequestId: 0,\n    activeRequestKey: null,\n  };\n}\n\nexport function createIdleRuntimeScreenOperationLoaderState(args: {\n  readonly dependencyKey: string;\n  readonly previousState?: RuntimeScreenOperationLoaderState;\n}): RuntimeScreenOperationLoaderState {\n  return {\n    dependencyKey: args.dependencyKey,\n    diagnostics: EMPTY_RUNTIME_SCREEN_OPERATION_LOADER_DIAGNOSTICS,\n    operationResults: EMPTY_RUNTIME_SCREEN_OPERATION_RESULTS,\n    renderVersion: args.previousState?.renderVersion ?? 0,\n  };\n}\n\nexport function createPendingRuntimeScreenOperationLoaderState(args: {\n  readonly dependencyKey: string;\n  readonly previousState?: RuntimeScreenOperationLoaderState;\n}): RuntimeScreenOperationLoaderState {\n  return {\n    dependencyKey: args.dependencyKey,\n    diagnostics: [],\n    operationResults: {},\n    renderVersion: (args.previousState?.renderVersion ?? -1) + 1,\n  };\n}\n\nexport function beginRuntimeScreenOperationLoaderRequest(args: {\n  readonly hasLoaders: boolean;\n  readonly lifecycle: RuntimeScreenOperationLoaderLifecycle;\n  readonly requestKey: string;\n  readonly state: RuntimeScreenOperationLoaderState;\n}): {\n  readonly lifecycle: RuntimeScreenOperationLoaderLifecycle;\n  readonly requestId?: number;\n  readonly shouldExecute: boolean;\n  readonly state: RuntimeScreenOperationLoaderState;\n} {\n  if (!args.hasLoaders) {\n    if (args.lifecycle.activeRequestKey === null) {\n      return {\n        lifecycle: args.lifecycle,\n        shouldExecute: false,\n        state: args.state,\n      };\n    }\n\n    return {\n      lifecycle: {\n        activeRequestId: args.lifecycle.activeRequestId + 1,\n        activeRequestKey: null,\n      },\n      shouldExecute: false,\n      state: args.state,\n    };\n  }\n\n  if (args.lifecycle.activeRequestKey === args.requestKey) {\n    return {\n      lifecycle: args.lifecycle,\n      shouldExecute: false,\n      state: args.state,\n    };\n  }\n\n  const requestId = args.lifecycle.activeRequestId + 1;\n\n  return {\n    lifecycle: {\n      activeRequestId: requestId,\n      activeRequestKey: args.requestKey,\n    },\n    requestId,\n    shouldExecute: true,\n    state:\n      args.state.dependencyKey === args.requestKey\n        ? args.state\n        : createPendingRuntimeScreenOperationLoaderState({\n            dependencyKey: args.requestKey,\n            previousState: args.state,\n          }),\n  };\n}\n\nexport function completeRuntimeScreenOperationLoaderRequest(args: {\n  readonly lifecycle: RuntimeScreenOperationLoaderLifecycle;\n  readonly requestId: number;\n  readonly result: RuntimeScreenOperationLoaderExecutionResult;\n  readonly state: RuntimeScreenOperationLoaderState;\n}): {\n  readonly accepted: boolean;\n  readonly state: RuntimeScreenOperationLoaderState;\n} {\n  if (args.lifecycle.activeRequestId !== args.requestId) {\n    return {\n      accepted: false,\n      state: args.state,\n    };\n  }\n\n  return {\n    accepted: true,\n    state: {\n      dependencyKey: args.result.dependencyKey,\n      diagnostics: args.result.diagnostics,\n      operationResults: args.result.operationResults,\n      renderVersion: args.state.renderVersion,\n    },\n  };\n}\n\nexport async function executeRuntimeScreenOperationLoaders(args: {\n  readonly bindingContext?: Record<string, unknown>;\n  readonly dataSources?: RuntimeBindingResolutionContext['dataSources'];\n  readonly executeOperation?: RuntimeBindingOperationExecutor;\n  readonly operationResults?: RuntimeBindingOperationResultCache;\n  readonly screen: ScreenSpec;\n  readonly loaders: readonly OperationScreenDataLoaderDefinition[];\n}): Promise<RuntimeScreenOperationLoaderExecutionResult> {\n  const plan = createRuntimeScreenOperationLoaderPlan({\n    bindingContext: args.bindingContext,\n    loaders: args.loaders,\n    operationResults: args.operationResults,\n    screenId: args.screen.id,\n  });\n\n  return executePreparedRuntimeScreenOperationLoaders({\n    dataSources: args.dataSources,\n    executeOperation: args.executeOperation,\n    plan,\n    screen: args.screen,\n  });\n}\n\nfunction executePreparedRuntimeScreenOperationLoaders(args: {\n  readonly dataSources?: RuntimeBindingResolutionContext['dataSources'];\n  readonly executeOperation?: RuntimeBindingOperationExecutor;\n  readonly plan: RuntimeScreenOperationLoaderPlan;\n  readonly screen: ScreenSpec;\n}): Promise<RuntimeScreenOperationLoaderExecutionResult> {\n  const diagnostics: DataSourceDiagnostic[] = [...args.plan.diagnostics];\n\n  if (args.plan.loaders.length === 0) {\n    return Promise.resolve({\n      dependencyKey: args.plan.requestKey,\n      diagnostics,\n      operationResults: {},\n    });\n  }\n\n  if (args.executeOperation === undefined) {\n    diagnostics.push(\n      ...args.plan.loaders.map((preparedLoader) =>\n        createScreenOperationLoaderDiagnostic(\n          preparedLoader.loader,\n          'missing-adapter',\n          'Screen operation loader requires an injected operation executor.',\n        ),\n      ),\n    );\n\n    return Promise.resolve({\n      dependencyKey: args.plan.requestKey,\n      diagnostics,\n      operationResults: {},\n    });\n  }\n  const { executeOperation } = args;\n\n  return (async () => {\n    const operationResults: Record<string, BindingValue | undefined> = {};\n\n    for (const preparedLoader of args.plan.loaders) {\n      const selection = resolveRuntimeBindingOperationSelection(\n        preparedLoader.loader.operation,\n        args.dataSources,\n        diagnostics,\n      );\n      if (selection === undefined) {\n        continue;\n      }\n\n      const result = await executeOperation({\n        dataSource: selection.dataSource,\n        endpoint: selection.endpoint,\n        input: preparedLoader.input,\n        node: args.screen.root,\n        operation: preparedLoader.loader.operation,\n      });\n      diagnostics.push(...(result.diagnostics ?? []));\n\n      if (!result.ok) {\n        continue;\n      }\n\n      operationResults[preparedLoader.operationKey] = result.data;\n    }\n\n    return {\n      dependencyKey: args.plan.requestKey,\n      diagnostics,\n      operationResults,\n    };\n  })();\n}\n\nexport function useRuntimeScreenOperationLoaders(args: {\n  readonly bindingContext?: Record<string, unknown>;\n  readonly dataSources?: RuntimeBindingResolutionContext['dataSources'];\n  readonly executeOperation?: RuntimeBindingOperationExecutor;\n  readonly operationResults?: RuntimeBindingOperationResultCache;\n  readonly onDiagnostics?: (diagnostics: readonly DataSourceDiagnostic[]) => void;\n  readonly screen: ScreenSpec;\n}): RuntimeScreenOperationLoaderState {\n  const loaders = React.useMemo(() => resolveScreenOperationLoaders(args.screen), [args.screen]);\n  const hasLoaders = loaders.length > 0;\n  const plan = React.useMemo(\n    () =>\n      createRuntimeScreenOperationLoaderPlan({\n        bindingContext: args.bindingContext,\n        loaders,\n        operationResults: args.operationResults,\n        screenId: args.screen.id,\n      }),\n    [args.bindingContext, args.operationResults, args.screen.id, loaders],\n  );\n  const { requestKey } = plan;\n  const emptyState = React.useMemo(\n    () =>\n      createIdleRuntimeScreenOperationLoaderState({\n        dependencyKey: requestKey,\n      }),\n    [requestKey],\n  );\n  const [state, setState] = React.useState<RuntimeScreenOperationLoaderState>(() =>\n    hasLoaders\n      ? createPendingRuntimeScreenOperationLoaderState({ dependencyKey: requestKey })\n      : emptyState,\n  );\n  const effectiveState = hasLoaders ? state : emptyState;\n  const lastDiagnosticsKeyRef = React.useRef<string | null>(null);\n  const latestStateRef = React.useRef(state);\n  const lifecycleRef = React.useRef<RuntimeScreenOperationLoaderLifecycle>(\n    createRuntimeScreenOperationLoaderLifecycle(),\n  );\n  const executionArgsByRequestKeyRef = React.useRef<\n    Record<string, RuntimeScreenPreparedExecutionArgs>\n  >({});\n\n  executionArgsByRequestKeyRef.current[requestKey] = {\n    dataSources: args.dataSources,\n    executeOperation: args.executeOperation,\n    plan,\n    screen: args.screen,\n  };\n  latestStateRef.current = state;\n\n  React.useEffect(() => {\n    const request = beginRuntimeScreenOperationLoaderRequest({\n      hasLoaders,\n      lifecycle: lifecycleRef.current,\n      requestKey,\n      state: latestStateRef.current,\n    });\n\n    lifecycleRef.current = request.lifecycle;\n\n    if (request.state !== latestStateRef.current) {\n      setState(request.state);\n    }\n\n    if (!request.shouldExecute || request.requestId === undefined) {\n      return;\n    }\n    const { requestId } = request;\n\n    void (async () => {\n      const executionArgs = executionArgsByRequestKeyRef.current[requestKey];\n      if (executionArgs === undefined) {\n        return;\n      }\n\n      const result = await executePreparedRuntimeScreenOperationLoaders(executionArgs);\n\n      setState((currentState) => {\n        const completion = completeRuntimeScreenOperationLoaderRequest({\n          lifecycle: lifecycleRef.current,\n          requestId,\n          result,\n          state: currentState,\n        });\n\n        return completion.accepted ? completion.state : currentState;\n      });\n    })();\n  }, [hasLoaders, requestKey]);\n\n  React.useEffect(() => {\n    if (effectiveState.diagnostics.length === 0) {\n      return;\n    }\n\n    const diagnosticsKey = stableSerialize(effectiveState.diagnostics);\n    if (lastDiagnosticsKeyRef.current === diagnosticsKey) {\n      return;\n    }\n\n    lastDiagnosticsKeyRef.current = diagnosticsKey;\n    args.onDiagnostics?.(effectiveState.diagnostics);\n  }, [args.onDiagnostics, effectiveState.diagnostics]);\n\n  return effectiveState;\n}\n\ninterface PreparedRuntimeScreenOperationLoader {\n  readonly input?: BindingValue;\n  readonly loader: OperationScreenDataLoaderDefinition;\n  readonly operationKey: string;\n}\n\ninterface RuntimeScreenOperationLoaderPlan {\n  readonly diagnostics: readonly DataSourceDiagnostic[];\n  readonly loaders: readonly PreparedRuntimeScreenOperationLoader[];\n  readonly requestKey: string;\n}\n\ninterface RuntimeScreenPreparedExecutionArgs {\n  readonly dataSources?: RuntimeBindingResolutionContext['dataSources'];\n  readonly executeOperation?: RuntimeBindingOperationExecutor;\n  readonly plan: RuntimeScreenOperationLoaderPlan;\n  readonly screen: ScreenSpec;\n}\n\nfunction createRuntimeScreenOperationLoaderPlan(args: {\n  readonly bindingContext?: Record<string, unknown>;\n  readonly loaders: readonly OperationScreenDataLoaderDefinition[];\n  readonly operationResults?: RuntimeBindingOperationResultCache;\n  readonly screenId: string;\n}): RuntimeScreenOperationLoaderPlan {\n  if (args.loaders.length === 0) {\n    return {\n      diagnostics: EMPTY_RUNTIME_SCREEN_OPERATION_LOADER_DIAGNOSTICS,\n      loaders: [],\n      requestKey: createRuntimeScreenOperationLoaderIdleKey(args.screenId),\n    };\n  }\n\n  const diagnostics: DataSourceDiagnostic[] = [];\n  const preparedLoaders: PreparedRuntimeScreenOperationLoader[] = [];\n  const operationKeys = new Set<string>();\n\n  for (const loader of args.loaders) {\n    const input = resolveBindingInputMapSync(\n      loader.input,\n      {\n        context: args.bindingContext,\n        operationResults: args.operationResults,\n      },\n      diagnostics,\n    );\n    const operationKey = createRuntimeBindingOperationKey(loader.operation);\n    if (operationKeys.has(operationKey)) {\n      diagnostics.push(\n        createScreenOperationLoaderDiagnostic(\n          loader,\n          'duplicate-operation-id',\n          `Screen operation loaders must not reuse operation key '${operationKey}' on the same screen.`,\n        ),\n      );\n      continue;\n    }\n\n    operationKeys.add(operationKey);\n    preparedLoaders.push({\n      input,\n      loader,\n      operationKey,\n    });\n  }\n\n  return {\n    diagnostics,\n    loaders: preparedLoaders,\n    requestKey: createRuntimeScreenOperationLoaderPlanRequestKey({\n      loaders: preparedLoaders,\n      screenId: args.screenId,\n    }),\n  };\n}\n\nfunction createRuntimeScreenOperationLoaderPlanRequestKey(args: {\n  readonly loaders: readonly PreparedRuntimeScreenOperationLoader[];\n  readonly screenId: string;\n}): string {\n  return stableSerialize({\n    loaders: args.loaders.map((loader) => ({\n      id: loader.loader.id,\n      input: loader.input,\n      operation: loader.loader.operation,\n      operationKey: loader.operationKey,\n    })),\n    screenId: args.screenId,\n  });\n}\n\nfunction createScreenOperationLoaderDiagnostic(\n  loader: OperationScreenDataLoaderDefinition,\n  code: DataSourceDiagnostic['code'],\n  message: string,\n): DataSourceDiagnostic {\n  return {\n    code,\n    dataSourceId: loader.operation.dataSourceId,\n    endpointId: loader.operation.endpointId,\n    operationId: loader.operation.operationId,\n    message,\n    severity: 'error',\n  };\n}\n\nfunction createRuntimeScreenOperationLoaderIdleKey(screenId: string): string {\n  return `screen:${screenId}:no-operation-loaders`;\n}\n\nfunction stableSerialize(value: unknown): string {\n  return JSON.stringify(sortSerializableValue(value));\n}\n\nfunction sortSerializableValue(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map(sortSerializableValue);\n  }\n\n  if (typeof value !== 'object' || value === null) {\n    return value;\n  }\n\n  return Object.keys(value)\n    .sort((left, right) => left.localeCompare(right))\n    .reduce<Record<string, unknown>>((result, key) => {\n      result[key] = sortSerializableValue((value as Record<string, unknown>)[key]);\n      return result;\n    }, {});\n}\n"]}

package/dist/runtimeStateAdapter.d.ts

@@ -0,0 +1,6 @@
+import type { StateAdapter, StateValue } from '@ankhorage/contracts';
+export interface RuntimeMemoryStateAdapterOptions {
+    readonly initialState?: Readonly<Record<string, StateValue>>;
+}
+export declare function createRuntimeMemoryStateAdapter(options?: RuntimeMemoryStateAdapterOptions): StateAdapter;
+//# sourceMappingURL=runtimeStateAdapter.d.ts.map

package/dist/runtimeStateAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeStateAdapter.d.ts","sourceRoot":"","sources":["../src/runtimeStateAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAMZ,UAAU,EACX,MAAM,sBAAsB,CAAC;AAK9B,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;CAC9D;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,gCAAqC,GAC7C,YAAY,CA+Ed"}

package/dist/runtimeStateAdapter.js

@@ -0,0 +1,162 @@
+export function createRuntimeMemoryStateAdapter(options = {}) {
+    let rootState = { ...(options.initialState ?? {}) };
+    const listeners = new Map();
+    const emit = (path, value) => {
+        const pathResult = normalizeStatePath(path);
+        if (!pathResult.ok)
+            return;
+        const listenersForPath = listeners.get(pathPartsToKey(pathResult.parts));
+        if (listenersForPath === undefined)
+            return;
+        for (const listener of listenersForPath) {
+            listener(value);
+        }
+    };
+    return {
+        capabilities: {
+            subscriptions: true,
+            computed: false,
+            persistence: false,
+        },
+        get(path) {
+            const pathResult = normalizeStatePath(path);
+            if (!pathResult.ok)
+                return pathResult;
+            return createStateDataResult(readStatePath(rootState, pathResult.parts));
+        },
+        set(path, value) {
+            const pathResult = normalizeStatePath(path);
+            if (!pathResult.ok)
+                return pathResult;
+            const nextStateResult = setStatePath(rootState, pathResult.parts, value);
+            if (!nextStateResult.ok)
+                return nextStateResult;
+            rootState = nextStateResult.data;
+            emit(path, value);
+            return { ok: true };
+        },
+        subscribe(path, listener) {
+            const pathResult = normalizeStatePath(path);
+            if (!pathResult.ok)
+                return pathResult;
+            const key = pathPartsToKey(pathResult.parts);
+            const listenersForPath = listeners.get(key) ?? new Set();
+            const wrappedListener = (value) => {
+                listener({ path, value: value });
+            };
+            listenersForPath.add(wrappedListener);
+            listeners.set(key, listenersForPath);
+            return createStateDataResult({
+                unsubscribe() {
+                    listenersForPath.delete(wrappedListener);
+                    if (listenersForPath.size === 0) {
+                        listeners.delete(key);
+                    }
+                },
+            });
+        },
+        delete(path) {
+            const pathResult = normalizeStatePath(path);
+            if (!pathResult.ok)
+                return pathResult;
+            const nextStateResult = deleteStatePath(rootState, pathResult.parts);
+            if (!nextStateResult.ok)
+                return nextStateResult;
+            rootState = nextStateResult.data;
+            emit(path, undefined);
+            return { ok: true };
+        },
+    };
+}
+function normalizeStatePath(path) {
+    const parts = typeof path === 'string' ? path.split('.') : [...path];
+    const normalized = parts.map((part) => part.trim()).filter(Boolean);
+    if (normalized.length === 0) {
+        return createStateError('invalid_path', 'State path must contain at least one segment.');
+    }
+    return {
+        ok: true,
+        parts: normalized,
+    };
+}
+function pathPartsToKey(parts) {
+    return parts.join('.');
+}
+function readStatePath(source, parts) {
+    let currentValue = source;
+    for (const part of parts) {
+        if (!isStateRecord(currentValue)) {
+            return undefined;
+        }
+        currentValue = currentValue[part];
+    }
+    return currentValue;
+}
+function setStatePath(source, parts, value) {
+    const [head, ...tail] = parts;
+    if (head === undefined) {
+        return createStateError('invalid_path', 'State path must contain at least one segment.');
+    }
+    if (tail.length === 0) {
+        return createStateDataResult({
+            ...source,
+            [head]: value,
+        });
+    }
+    const existing = source[head];
+    const child = existing === undefined ? {} : existing;
+    if (!isStateRecord(child)) {
+        return createStateError('path_conflict', `Cannot set nested state below non-object path segment "${head}".`);
+    }
+    const childResult = setStatePath(child, tail, value);
+    if (!childResult.ok)
+        return childResult;
+    return createStateDataResult({
+        ...source,
+        [head]: childResult.data,
+    });
+}
+function deleteStatePath(source, parts) {
+    const [head, ...tail] = parts;
+    if (head === undefined) {
+        return createStateError('invalid_path', 'State path must contain at least one segment.');
+    }
+    if (tail.length === 0) {
+        const nextState = {};
+        for (const [key, value] of Object.entries(source)) {
+            if (key !== head) {
+                nextState[key] = value;
+            }
+        }
+        return createStateDataResult(nextState);
+    }
+    const existing = source[head];
+    if (existing === undefined) {
+        return createStateDataResult(source);
+    }
+    if (!isStateRecord(existing)) {
+        return createStateError('path_conflict', `Cannot delete nested state below non-object path segment "${head}".`);
+    }
+    const childResult = deleteStatePath(existing, tail);
+    if (!childResult.ok)
+        return childResult;
+    return createStateDataResult({
+        ...source,
+        [head]: childResult.data,
+    });
+}
+function isStateRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function createStateError(code, message) {
+    const error = { code, message };
+    return { ok: false, error };
+}
+function createStateDataResult(data) {
+    const result = {
+        ok: true,
+        data,
+    };
+    return result;
+}
+//# sourceMappingURL=runtimeStateAdapter.js.map