@relkit/compiler 0.0.0

package/dist/discovery/evaluator-detectors.js

@@ -0,0 +1,54 @@
+import { installFileDetectors } from "./evaluator-detector-files.js";
+import { installNetworkDetectors } from "./evaluator-detector-network.js";
+import { installOutput, installTimers } from "./evaluator-detector-timers.js";
+/** Installs best-effort hooks for one candidate and restores them before framing. */
+export function installEvaluatorDetectors(options) {
+    const sideEffects = [];
+    const timersByHandle = new Map();
+    const restores = [];
+    let stdout = "";
+    let stderr = "";
+    let restored = false;
+    const record = (kind, operation, target) => {
+        sideEffects.push({ kind, operation, target });
+    };
+    const violate = (kind, operation, target) => {
+        record(kind, operation, target);
+        throw new Error(`Evaluator blocked ${kind} through ${operation}.`);
+    };
+    installTimers(timersByHandle, restores);
+    installOutput(restores, (stream, value) => {
+        record("direct-output", `${stream}.write`, stream);
+        if (stream === "stdout")
+            stdout += value;
+        else
+            stderr += value;
+    });
+    installFileDetectors(options, restores, violate);
+    installNetworkDetectors(options.networkAllowlist, restores, violate);
+    return {
+        finish() {
+            for (const [handle, timer] of timersByHandle) {
+                record("live-timer", timer.kind, timer.kind);
+                timer.cancel();
+                timersByHandle.delete(handle);
+            }
+            return {
+                sideEffects: Object.freeze([...sideEffects]),
+                stdout,
+                stderr,
+            };
+        },
+        restore() {
+            if (restored)
+                return;
+            restored = true;
+            for (const timer of timersByHandle.values())
+                timer.cancel();
+            timersByHandle.clear();
+            for (const restore of restores.reverse())
+                restore();
+        },
+    };
+}
+//# sourceMappingURL=evaluator-detectors.js.map

package/dist/discovery/evaluator-detectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator-detectors.js","sourceRoot":"","sources":["../../src/discovery/evaluator-detectors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAoB,MAAM,gCAAgC,CAAC;AAqBhG,qFAAqF;AACrF,MAAM,UAAU,yBAAyB,CACvC,OAAiC;IAEjC,MAAM,WAAW,GAA0B,EAAE,CAAC;IAC9C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAwB,CAAC;IACvD,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,MAAM,GAAG,CAAC,IAA6B,EAAE,SAAiB,EAAE,MAAc,EAAQ,EAAE;QACxF,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,IAA6B,EAAE,SAAiB,EAAE,MAAc,EAAS,EAAE;QAC1F,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,YAAY,SAAS,GAAG,CAAC,CAAC;IACrE,CAAC,CAAC;IAEF,aAAa,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IACxC,aAAa,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACxC,MAAM,CAAC,eAAe,EAAE,GAAG,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnD,IAAI,MAAM,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC;;YACpC,MAAM,IAAI,KAAK,CAAC;IACvB,CAAC,CAAC,CAAC;IACH,oBAAoB,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjD,uBAAuB,CAAC,OAAO,CAAC,gBAAgB,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAErE,OAAO;QACL,MAAM;YACJ,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,cAAc,EAAE,CAAC;gBAC7C,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7C,KAAK,CAAC,MAAM,EAAE,CAAC;gBACf,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YACD,OAAO;gBACL,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC;gBAC5C,MAAM;gBACN,MAAM;aACP,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,MAAM,EAAE;gBAAE,KAAK,CAAC,MAAM,EAAE,CAAC;YAC5D,cAAc,CAAC,KAAK,EAAE,CAAC;YACvB,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE;gBAAE,OAAO,EAAE,CAAC;QACtD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/discovery/evaluator-protocol.d.ts

@@ -0,0 +1,94 @@
+import type { JsonValue } from "@relkit/contracts";
+export declare const EVALUATOR_PROTOCOL: "relkit.evaluator";
+export declare const EVALUATOR_PROTOCOL_VERSION: 1;
+export declare const EVALUATOR_FRAME = "\u001Erelkit-evaluator-response:";
+export type EvaluatorFailureCode = "RELKIT_EVALUATOR_REQUEST_INVALID" | "RELKIT_EVALUATOR_ROOT_INVALID" | "RELKIT_EVALUATOR_IMPORT_FAILED" | "RELKIT_EVALUATOR_TIMEOUT" | "RELKIT_EVALUATOR_PROCESS_FAILED" | "RELKIT_EVALUATOR_PROTOCOL_INVALID" | "RELKIT_EVALUATOR_SIDE_EFFECT";
+export type EvaluatorSideEffectKind = "listening-socket" | "live-timer" | "write-outside-generated-sandbox" | "child-process" | "direct-output" | "unapproved-network";
+export interface EvaluatorSideEffect {
+    readonly kind: EvaluatorSideEffectKind;
+    readonly operation: string;
+    readonly target: string;
+}
+/**
+ * Coverage is deliberately explicit: these hooks are fault detectors, not a
+ * security sandbox. Unsupported bypasses still run inside the killed child.
+ */
+export declare const EVALUATOR_DETECTOR_COVERAGE: Readonly<{
+    supported: readonly string[];
+    unsupported: readonly string[];
+}>;
+export interface EvaluatorDetectorCoverage {
+    readonly supported: readonly string[];
+    readonly unsupported: readonly string[];
+}
+export interface EvaluatorCandidate {
+    readonly file: string;
+}
+export interface EvaluatorRequest {
+    readonly protocol: typeof EVALUATOR_PROTOCOL;
+    readonly version: typeof EVALUATOR_PROTOCOL_VERSION;
+    readonly generationId: string;
+    readonly projectRoot: string;
+    readonly candidates: readonly EvaluatorCandidate[];
+    readonly environmentAllowlist: readonly string[];
+    readonly generatedDirectory: string;
+    readonly networkAllowlist: readonly string[];
+    readonly sourceMaps: boolean;
+    readonly timeoutMs: number;
+}
+export interface EvaluatorManifestReference {
+    readonly generationId: string;
+    readonly descriptorId: string;
+    readonly kind: string;
+    readonly module: string;
+    readonly exportName: string;
+}
+export interface EvaluatorDescriptorSnapshot {
+    readonly kind: string;
+    readonly id: string;
+    readonly ref: {
+        readonly kind: string;
+        readonly id: string;
+    };
+    readonly metadata: JsonValue;
+}
+export interface EvaluatorExportSnapshot {
+    readonly exportName: string;
+    readonly descriptor: EvaluatorDescriptorSnapshot;
+}
+export interface EvaluatorModuleResult {
+    readonly file: string;
+    readonly exports: readonly EvaluatorExportSnapshot[];
+    readonly manifestReferences: readonly EvaluatorManifestReference[];
+}
+export interface EvaluatorFailure {
+    readonly code: EvaluatorFailureCode;
+    readonly message: string;
+    readonly generationId: string;
+    readonly module?: string;
+    readonly stack?: string;
+    readonly sideEffects?: readonly EvaluatorSideEffect[];
+    readonly exitCode?: number;
+    readonly timedOut?: boolean;
+    readonly stdout?: string;
+    readonly stderr?: string;
+}
+export interface EvaluatorResponse {
+    readonly protocol: typeof EVALUATOR_PROTOCOL;
+    readonly version: typeof EVALUATOR_PROTOCOL_VERSION;
+    readonly generationId: string;
+    readonly sourceMaps: boolean;
+    readonly detectorCoverage: EvaluatorDetectorCoverage;
+    readonly status: "ok" | "failed";
+    readonly modules: readonly EvaluatorModuleResult[];
+    readonly failures: readonly EvaluatorFailure[];
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export declare function encodeEvaluatorFrame(response: EvaluatorResponse): string;
+export declare function decodeEvaluatorFrame(stdout: string): {
+    readonly response: EvaluatorResponse;
+    readonly stdout: string;
+} | undefined;
+export declare function isEvaluatorRequest(value: unknown): value is EvaluatorRequest;
+//# sourceMappingURL=evaluator-protocol.d.ts.map

package/dist/discovery/evaluator-protocol.d.ts.map

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

package/dist/discovery/evaluator-protocol.js

@@ -0,0 +1,89 @@
+import { canonicalJson } from "@relkit/contracts";
+export const EVALUATOR_PROTOCOL = "relkit.evaluator";
+export const EVALUATOR_PROTOCOL_VERSION = 1;
+export const EVALUATOR_FRAME = "\u001erelkit-evaluator-response:";
+/**
+ * Coverage is deliberately explicit: these hooks are fault detectors, not a
+ * security sandbox. Unsupported bypasses still run inside the killed child.
+ */
+export const EVALUATOR_DETECTOR_COVERAGE = Object.freeze({
+    supported: Object.freeze([
+        "Bun and common Node socket/process/network entry points",
+        "global timers and direct stdout/stderr writes",
+        "common Node fs mutators and Bun.write",
+    ]),
+    unsupported: Object.freeze([
+        "native syscalls and APIs that bypass the patched entry points",
+        "pre-bound named imports from CommonJS built-ins",
+        "file-descriptor writes and filesystem symlink/race escapes",
+        "effects scheduled after evaluation returns or outside the child process",
+    ]),
+});
+export function encodeEvaluatorFrame(response) {
+    return `${EVALUATOR_FRAME}${canonicalJson(response)}\n`;
+}
+export function decodeEvaluatorFrame(stdout) {
+    const start = stdout.lastIndexOf(EVALUATOR_FRAME);
+    if (start < 0)
+        return undefined;
+    const payloadStart = start + EVALUATOR_FRAME.length;
+    const payloadEnd = stdout.indexOf("\n", payloadStart);
+    const payload = stdout.slice(payloadStart, payloadEnd < 0 ? stdout.length : payloadEnd);
+    try {
+        const value = JSON.parse(payload);
+        if (!isEvaluatorResponse(value))
+            return undefined;
+        return {
+            response: value,
+            stdout: `${stdout.slice(0, start)}${payloadEnd < 0 ? "" : stdout.slice(payloadEnd + 1)}`,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+export function isEvaluatorRequest(value) {
+    if (!isRecord(value))
+        return false;
+    return (value.protocol === EVALUATOR_PROTOCOL &&
+        value.version === EVALUATOR_PROTOCOL_VERSION &&
+        typeof value.generationId === "string" &&
+        typeof value.projectRoot === "string" &&
+        Array.isArray(value.candidates) &&
+        value.candidates.every(isCandidate) &&
+        Array.isArray(value.environmentAllowlist) &&
+        value.environmentAllowlist.every((name) => typeof name === "string") &&
+        typeof value.generatedDirectory === "string" &&
+        Array.isArray(value.networkAllowlist) &&
+        value.networkAllowlist.every((host) => typeof host === "string") &&
+        typeof value.sourceMaps === "boolean" &&
+        typeof value.timeoutMs === "number");
+}
+function isCandidate(value) {
+    return isRecord(value) && typeof value.file === "string";
+}
+function isEvaluatorResponse(value) {
+    if (!isRecord(value))
+        return false;
+    return (value.protocol === EVALUATOR_PROTOCOL &&
+        value.version === EVALUATOR_PROTOCOL_VERSION &&
+        typeof value.generationId === "string" &&
+        typeof value.sourceMaps === "boolean" &&
+        isDetectorCoverage(value.detectorCoverage) &&
+        (value.status === "ok" || value.status === "failed") &&
+        Array.isArray(value.modules) &&
+        Array.isArray(value.failures) &&
+        typeof value.stdout === "string" &&
+        typeof value.stderr === "string");
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isDetectorCoverage(value) {
+    return (isRecord(value) &&
+        Array.isArray(value.supported) &&
+        value.supported.every((entry) => typeof entry === "string") &&
+        Array.isArray(value.unsupported) &&
+        value.unsupported.every((entry) => typeof entry === "string"));
+}
+//# sourceMappingURL=evaluator-protocol.js.map

package/dist/discovery/evaluator-protocol.js.map

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

package/dist/discovery/evaluator-request.d.ts

@@ -0,0 +1,18 @@
+import { type EvaluatorRequest } from "./evaluator-protocol.js";
+export declare const DEFAULT_EVALUATOR_TIMEOUT_MS = 5000;
+export declare const DEFAULT_ENVIRONMENT_ALLOWLIST: readonly string[];
+export interface EvaluatorOptions {
+    readonly projectRoot: string;
+    readonly candidates: readonly (string | {
+        readonly fileName: string;
+    })[];
+    readonly generationId?: string;
+    readonly timeoutMs?: number;
+    readonly environmentAllowlist?: readonly string[];
+    readonly generatedDirectory?: string;
+    readonly networkAllowlist?: readonly string[];
+    readonly sourceMaps?: boolean;
+}
+export declare function createEvaluatorRequest(options: EvaluatorOptions): EvaluatorRequest;
+export declare function allowlistedEnvironment(names: readonly string[]): Record<string, string>;
+//# sourceMappingURL=evaluator-request.d.ts.map

package/dist/discovery/evaluator-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator-request.d.ts","sourceRoot":"","sources":["../../src/discovery/evaluator-request.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAEjC,eAAO,MAAM,4BAA4B,OAAQ,CAAC;AAClD,eAAO,MAAM,6BAA6B,mBAAgC,CAAC;AAE3E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,GAAG;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IACzE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAoClF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOvF"}

package/dist/discovery/evaluator-request.js

@@ -0,0 +1,49 @@
+import { normalizeSourcePath } from "@relkit/contracts";
+import { realpathSync } from "node:fs";
+import { isAbsolute, resolve } from "node:path";
+import { EVALUATOR_PROTOCOL, EVALUATOR_PROTOCOL_VERSION, } from "./evaluator-protocol.js";
+export const DEFAULT_EVALUATOR_TIMEOUT_MS = 5_000;
+export const DEFAULT_ENVIRONMENT_ALLOWLIST = Object.freeze([]);
+export function createEvaluatorRequest(options) {
+    if (!isAbsolute(options.projectRoot))
+        throw new TypeError("projectRoot must be absolute");
+    const projectRoot = realpathSync(resolve(options.projectRoot));
+    const timeoutMs = options.timeoutMs ?? DEFAULT_EVALUATOR_TIMEOUT_MS;
+    if (!Number.isInteger(timeoutMs) || timeoutMs < 1)
+        throw new TypeError("timeoutMs must be positive");
+    const generationId = options.generationId ?? crypto.randomUUID();
+    if (!/^[A-Za-z0-9._-]{1,128}$/.test(generationId))
+        throw new TypeError("generationId is invalid");
+    const environmentAllowlist = [...new Set(options.environmentAllowlist ?? [])].sort();
+    if (environmentAllowlist.some((name) => !/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)))
+        throw new TypeError("environmentAllowlist contains an invalid name");
+    const networkAllowlist = [...new Set(options.networkAllowlist ?? [])].sort();
+    if (networkAllowlist.some((host) => host.trim() === "" || /[\s/]/.test(host)))
+        throw new TypeError("networkAllowlist contains an invalid host");
+    const generatedDirectory = normalizeSourcePath(options.generatedDirectory ?? ".relkit/generated", projectRoot);
+    const candidates = options.candidates.map((candidate) => {
+        const file = typeof candidate === "string" ? candidate : candidate.fileName;
+        return { file: normalizeSourcePath(file, projectRoot) };
+    });
+    return {
+        protocol: EVALUATOR_PROTOCOL,
+        version: EVALUATOR_PROTOCOL_VERSION,
+        generationId,
+        projectRoot,
+        candidates: Object.freeze([
+            ...new Map(candidates.map((candidate) => [candidate.file, candidate])).values(),
+        ]),
+        environmentAllowlist: Object.freeze(environmentAllowlist),
+        generatedDirectory,
+        networkAllowlist: Object.freeze(networkAllowlist),
+        sourceMaps: options.sourceMaps ?? true,
+        timeoutMs,
+    };
+}
+export function allowlistedEnvironment(names) {
+    return Object.fromEntries(names.flatMap((name) => {
+        const value = process.env[name];
+        return value === undefined ? [] : [[name, value]];
+    }));
+}
+//# sourceMappingURL=evaluator-request.js.map

package/dist/discovery/evaluator-request.js.map

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

package/dist/discovery/evaluator-snapshot.d.ts

@@ -0,0 +1,12 @@
+import type { EvaluatorDescriptorSnapshot } from "./evaluator-protocol.js";
+/** Keeps descriptor identity while replacing executable values with JSON markers. */
+export declare function snapshotDescriptor(value: SnapshotDescriptorLike): EvaluatorDescriptorSnapshot;
+export interface SnapshotDescriptorLike {
+    readonly kind: string;
+    readonly id: string;
+    readonly ref: {
+        readonly kind: string;
+        readonly id: string;
+    };
+}
+//# sourceMappingURL=evaluator-snapshot.d.ts.map

package/dist/discovery/evaluator-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator-snapshot.d.ts","sourceRoot":"","sources":["../../src/discovery/evaluator-snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAG3E,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,sBAAsB,GAAG,2BAA2B,CAO7F;AA+CD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D"}

package/dist/discovery/evaluator-snapshot.js

@@ -0,0 +1,87 @@
+import { getJsonSchema } from "@relkit/schema";
+import { isErrorDescriptorLike } from "../normalize-utils.js";
+/** Keeps descriptor identity while replacing executable values with JSON markers. */
+export function snapshotDescriptor(value) {
+    return {
+        kind: value.kind,
+        id: value.id,
+        ref: { kind: value.ref.kind, id: value.ref.id },
+        metadata: snapshotValue(value, new WeakSet()),
+    };
+}
+function snapshotValue(value, seen, depth = 0) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return value;
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : marker("non-finite-number");
+    if (typeof value === "undefined")
+        return marker("undefined");
+    if (depth > 8)
+        return marker("depth-limit");
+    if (typeof value === "function") {
+        return isErrorDescriptorLike(value)
+            ? snapshotObject(value, seen, depth)
+            : marker("function", value.name);
+    }
+    if (typeof value === "symbol")
+        return marker("symbol", value.description);
+    if (typeof value === "bigint")
+        return marker("bigint");
+    const schema = snapshotSchema(value);
+    if (schema !== undefined)
+        return schema;
+    if (Array.isArray(value)) {
+        if (seen.has(value))
+            return marker("cycle");
+        seen.add(value);
+        try {
+            return value.map((entry) => snapshotValue(entry, seen, depth + 1));
+        }
+        finally {
+            seen.delete(value);
+        }
+    }
+    return snapshotObject(value, seen, depth);
+}
+function snapshotObject(value, seen, depth) {
+    if (seen.has(value))
+        return marker("cycle");
+    seen.add(value);
+    try {
+        const output = {};
+        for (const key of Object.keys(value).sort()) {
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
+            output[key] =
+                descriptor && "value" in descriptor
+                    ? snapshotValue(descriptor.value, seen, depth + 1)
+                    : marker("accessor");
+        }
+        return output;
+    }
+    finally {
+        seen.delete(value);
+    }
+}
+function snapshotSchema(value) {
+    if (!isRecord(value))
+        return undefined;
+    const standard = dataProperty(value, "~standard");
+    if (!isRecord(standard) || standard.version !== 1 || typeof standard.validate !== "function") {
+        return undefined;
+    }
+    const result = getJsonSchema(value);
+    return result.ok
+        ? { $relkit: "schema", jsonSchema: result.schema }
+        : { $relkit: "schema-unavailable", reason: result.reason };
+}
+function dataProperty(value, key) {
+    const descriptor = Object.getOwnPropertyDescriptor(value, key);
+    return descriptor && "value" in descriptor ? descriptor.value : undefined;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function marker(type, name) {
+    return name === undefined ? { $relkit: type } : { $relkit: type, name };
+}
+//# sourceMappingURL=evaluator-snapshot.js.map

package/dist/discovery/evaluator-snapshot.js.map

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

package/dist/discovery/evaluator.d.ts

@@ -0,0 +1,8 @@
+import { type EvaluatorResponse } from "./evaluator-protocol.js";
+import { type EvaluatorOptions } from "./evaluator-request.js";
+export * from "./evaluator-protocol.js";
+export { DEFAULT_ENVIRONMENT_ALLOWLIST, DEFAULT_EVALUATOR_TIMEOUT_MS, } from "./evaluator-request.js";
+export type { EvaluatorOptions } from "./evaluator-request.js";
+/** Evaluates only AST-prefilter candidates in a short-lived Bun child process. */
+export declare function evaluateCandidates(options: EvaluatorOptions): Promise<EvaluatorResponse>;
+//# sourceMappingURL=evaluator.d.ts.map

package/dist/discovery/evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../src/discovery/evaluator.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,iBAAiB,EAEvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAIhC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,kFAAkF;AAClF,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA6G9F"}

package/dist/discovery/evaluator.js

@@ -0,0 +1,123 @@
+import { canonicalJson } from "@relkit/contracts";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { EVALUATOR_DETECTOR_COVERAGE, EVALUATOR_PROTOCOL, EVALUATOR_PROTOCOL_VERSION, decodeEvaluatorFrame, } from "./evaluator-protocol.js";
+import { allowlistedEnvironment, createEvaluatorRequest, } from "./evaluator-request.js";
+import { appendDataModels, isolateDataModels } from "./data-model-isolation.js";
+export * from "./evaluator-protocol.js";
+export { DEFAULT_ENVIRONMENT_ALLOWLIST, DEFAULT_EVALUATOR_TIMEOUT_MS, } from "./evaluator-request.js";
+/** Evaluates only AST-prefilter candidates in a short-lived Bun child process. */
+export async function evaluateCandidates(options) {
+    let request;
+    const generationId = options.generationId ?? crypto.randomUUID();
+    const isolated = areAstCandidates(options.candidates)
+        ? isolateDataModels(options.candidates, generationId)
+        : { evaluated: options.candidates, modules: [] };
+    try {
+        request = createEvaluatorRequest({
+            ...options,
+            generationId,
+            candidates: isolated.evaluated,
+        });
+    }
+    catch (error) {
+        return failedResponse(options.generationId ?? "unknown", options.sourceMaps ?? true, failure("RELKIT_EVALUATOR_REQUEST_INVALID", errorMessage(error), options.generationId));
+    }
+    const childPath = evaluatorChildPath();
+    let child;
+    try {
+        child = Bun.spawn([process.execPath, "run", "--no-env-file", "--no-install", "--silent", childPath], {
+            cwd: request.projectRoot,
+            env: allowlistedEnvironment(request.environmentAllowlist),
+            stdin: "pipe",
+            stdout: "pipe",
+            stderr: "pipe",
+        });
+    }
+    catch (error) {
+        return failedResponse(request.generationId, request.sourceMaps, failure("RELKIT_EVALUATOR_PROCESS_FAILED", errorMessage(error), request.generationId));
+    }
+    const stdoutPromise = new Response(child.stdout).text();
+    const stderrPromise = new Response(child.stderr).text();
+    await child.stdin.write(canonicalJson(request));
+    child.stdin.end();
+    const exit = child.exited.then((exitCode) => ({ kind: "exit", exitCode }));
+    let timer;
+    const timeout = new Promise((resolveTimeout) => {
+        timer = setTimeout(() => resolveTimeout({ kind: "timeout" }), request.timeoutMs);
+    });
+    const outcome = await Promise.race([exit, timeout]);
+    clearTimeout(timer);
+    if (outcome.kind === "timeout")
+        child.kill();
+    const exitCode = outcome.kind === "exit" ? outcome.exitCode : await child.exited;
+    const [rawStdout, stderr] = await Promise.all([stdoutPromise, stderrPromise]);
+    const framed = decodeEvaluatorFrame(rawStdout);
+    if (framed === undefined) {
+        return failedResponse(request.generationId, request.sourceMaps, failure(outcome.kind === "timeout"
+            ? "RELKIT_EVALUATOR_TIMEOUT"
+            : "RELKIT_EVALUATOR_PROTOCOL_INVALID", outcome.kind === "timeout"
+            ? `Evaluator exceeded ${request.timeoutMs}ms and was killed.`
+            : "Evaluator exited without a valid versioned response frame.", request.generationId, { exitCode, timedOut: outcome.kind === "timeout", stdout: rawStdout, stderr }), rawStdout, stderr);
+    }
+    const response = {
+        ...framed.response,
+        stdout: joinOutput(framed.response.stdout, framed.stdout),
+        stderr: joinOutput(framed.response.stderr, stderr),
+    };
+    if (response.generationId !== request.generationId ||
+        (exitCode !== 0 && response.status === "ok")) {
+        return failedResponse(request.generationId, request.sourceMaps, failure("RELKIT_EVALUATOR_PROTOCOL_INVALID", "Evaluator response identity or exit status was invalid.", request.generationId, {
+            exitCode,
+            stdout: response.stdout,
+            stderr: response.stderr,
+        }), response.stdout, response.stderr);
+    }
+    return appendDataModels({
+        ...response,
+        failures: response.failures.map((entry) => ({
+            ...entry,
+            ...(response.stdout === "" ? {} : { stdout: response.stdout }),
+            ...(response.stderr === "" ? {} : { stderr: response.stderr }),
+        })),
+    }, isolated.modules);
+}
+function areAstCandidates(candidates) {
+    return candidates.every((candidate) => typeof candidate !== "string" && "factories" in candidate && "facts" in candidate);
+}
+function joinOutput(protocolOutput, rawOutput) {
+    return protocolOutput === ""
+        ? rawOutput
+        : rawOutput === ""
+            ? protocolOutput
+            : `${protocolOutput}${rawOutput}`;
+}
+function failedResponse(generationId, sourceMaps, entry, stdout = "", stderr = "") {
+    return {
+        protocol: EVALUATOR_PROTOCOL,
+        version: EVALUATOR_PROTOCOL_VERSION,
+        generationId,
+        sourceMaps,
+        status: "failed",
+        modules: [],
+        failures: [
+            { ...entry, ...(stdout === "" ? {} : { stdout }), ...(stderr === "" ? {} : { stderr }) },
+        ],
+        detectorCoverage: EVALUATOR_DETECTOR_COVERAGE,
+        stdout,
+        stderr,
+    };
+}
+function failure(code, message, generationId = "unknown", details = {}) {
+    return { code, message, generationId, ...details };
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function evaluatorChildPath() {
+    const compiledPath = fileURLToPath(new URL("./evaluator-child.js", import.meta.url));
+    return existsSync(compiledPath)
+        ? compiledPath
+        : fileURLToPath(new URL("./evaluator-child.ts", import.meta.url));
+}
+//# sourceMappingURL=evaluator.js.map

package/dist/discovery/evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../src/discovery/evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,0BAA0B,EAI1B,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GAEvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGhF,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAGhC,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAyB;IAChE,IAAI,OAAyB,CAAC;IAC9B,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;IACjE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC;QACnD,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC;QACrD,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACnD,IAAI,CAAC;QACH,OAAO,GAAG,sBAAsB,CAAC;YAC/B,GAAG,OAAO;YACV,YAAY;YACZ,UAAU,EAAE,QAAQ,CAAC,SAAS;SAC/B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,cAAc,CACnB,OAAO,CAAC,YAAY,IAAI,SAAS,EACjC,OAAO,CAAC,UAAU,IAAI,IAAI,EAC1B,OAAO,CAAC,kCAAkC,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CACvF,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IACvC,IAAI,KAA6C,CAAC;IAClD,IAAI,CAAC;QACH,KAAK,GAAG,GAAG,CAAC,KAAK,CACf,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,CAAC,EACjF;YACE,GAAG,EAAE,OAAO,CAAC,WAAW;YACxB,GAAG,EAAE,sBAAsB,CAAC,OAAO,CAAC,oBAAoB,CAAC;YACzD,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,MAAM;SACf,CACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,cAAc,CACnB,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,iCAAiC,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CACtF,CAAC;IACJ,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,aAAa,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IACpF,IAAI,KAAqC,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,OAAO,CAA+B,CAAC,cAAc,EAAE,EAAE;QAC3E,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,YAAY,CAAC,KAAK,CAAC,CAAC;IACpB,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC;IACjF,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,cAAc,CACnB,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,UAAU,EAClB,OAAO,CACL,OAAO,CAAC,IAAI,KAAK,SAAS;YACxB,CAAC,CAAC,0BAA0B;YAC5B,CAAC,CAAC,mCAAmC,EACvC,OAAO,CAAC,IAAI,KAAK,SAAS;YACxB,CAAC,CAAC,sBAAsB,OAAO,CAAC,SAAS,oBAAoB;YAC7D,CAAC,CAAC,4DAA4D,EAChE,OAAO,CAAC,YAAY,EACpB,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAC9E,EACD,SAAS,EACT,MAAM,CACP,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG;QACf,GAAG,MAAM,CAAC,QAAQ;QAClB,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;QACzD,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACvB,CAAC;IAC9B,IACE,QAAQ,CAAC,YAAY,KAAK,OAAO,CAAC,YAAY;QAC9C,CAAC,QAAQ,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,EAC5C,CAAC;QACD,OAAO,cAAc,CACnB,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,UAAU,EAClB,OAAO,CACL,mCAAmC,EACnC,yDAAyD,EACzD,OAAO,CAAC,YAAY,EACpB;YACE,QAAQ;YACR,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;SACxB,CACF,EACD,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,MAAM,CAChB,CAAC;IACJ,CAAC;IACD,OAAO,gBAAgB,CACrB;QACE,GAAG,QAAQ;QACX,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC1C,GAAG,KAAK;YACR,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC9D,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;SAC/D,CAAC,CAAC;KACJ,EACD,QAAQ,CAAC,OAAO,CACjB,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,UAA0C;IAE1C,OAAO,UAAU,CAAC,KAAK,CACrB,CAAC,SAAS,EAAE,EAAE,CACZ,OAAO,SAAS,KAAK,QAAQ,IAAI,WAAW,IAAI,SAAS,IAAI,OAAO,IAAI,SAAS,CACpF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,cAAsB,EAAE,SAAiB;IAC3D,OAAO,cAAc,KAAK,EAAE;QAC1B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,SAAS,KAAK,EAAE;YAChB,CAAC,CAAC,cAAc;YAChB,CAAC,CAAC,GAAG,cAAc,GAAG,SAAS,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,cAAc,CACrB,YAAoB,EACpB,UAAmB,EACnB,KAAuB,EACvB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EAAE;IAEX,OAAO;QACL,QAAQ,EAAE,kBAAkB;QAC5B,OAAO,EAAE,0BAA0B;QACnC,YAAY;QACZ,UAAU;QACV,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE;YACR,EAAE,GAAG,KAAK,EAAE,GAAG,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;SACzF;QACD,gBAAgB,EAAE,2BAA2B;QAC7C,MAAM;QACN,MAAM;KACP,CAAC;AACJ,CAAC;AACD,SAAS,OAAO,CACd,IAA8B,EAC9B,OAAe,EACf,YAAY,GAAG,SAAS,EACxB,UAAiF,EAAE;IAEnF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CAAC;AACrD,CAAC;AACD,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrF,OAAO,UAAU,CAAC,YAAY,CAAC;QAC7B,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/discovery/extract.d.ts

@@ -0,0 +1,21 @@
+import { type SourceLocation } from "@relkit/contracts";
+import type { EvaluatorDescriptorSnapshot, EvaluatorManifestReference, EvaluatorModuleResult, EvaluatorResponse } from "./evaluator-protocol.js";
+import { type ExportKind, type SourceMapEntry, type SourceMapOptions } from "./source-map.js";
+import type { ExportFact, ExportFacts } from "./source-map-utils.js";
+export interface ExtractOptions extends SourceMapOptions {
+    readonly generationId?: string;
+    readonly sourceMap?: readonly SourceMapEntry[];
+}
+export interface ExtractedDescriptor {
+    readonly descriptor: EvaluatorDescriptorSnapshot;
+    readonly exportName: string;
+    readonly exportKind: ExportKind;
+    readonly source: SourceLocation;
+    readonly facts?: ExportFacts;
+    readonly exportFact?: ExportFact;
+    readonly reference: EvaluatorManifestReference;
+}
+export type ExtractionInput = EvaluatorResponse | readonly EvaluatorModuleResult[];
+/** Extracts only evaluator snapshots and data-only executable reference instructions. */
+export declare function extractDescriptors(input: ExtractionInput, options?: ExtractOptions): readonly ExtractedDescriptor[];
+//# sourceMappingURL=extract.d.ts.map

package/dist/discovery/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/discovery/extract.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6C,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,KAAK,EACV,2BAA2B,EAE3B,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGrE,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;CAChD;AAED,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,SAAS,qBAAqB,EAAE,CAAC;AAEnF,yFAAyF;AACzF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,cAAmB,GAC3B,SAAS,mBAAmB,EAAE,CAkChC"}