@rezless/vm 0.1.0

package/dist/coverage.js

@@ -0,0 +1,221 @@
+/**
+ * Walks an AST and enumerates every coverable item.
+ * Coverage IDs are `loc.offset` — stable across the lifetime of a single
+ * parse, unique within a file, and cheap to use as Map keys.
+ */
+export function buildCoveragePlan(ast, filename, source) {
+    const statements = [];
+    const branches = [];
+    const functions = [];
+    const states = [];
+    const walkStatement = (s) => {
+        statements.push({
+            id: s.loc.offset,
+            line: s.loc.line,
+            col: s.loc.col,
+            kind: s.kind,
+        });
+        switch (s.kind) {
+            case 'BlockStatement':
+                for (const inner of s.body)
+                    walkStatement(inner);
+                return;
+            case 'IfStatement':
+                branches.push({
+                    id: s.loc.offset,
+                    line: s.loc.line,
+                    col: s.loc.col,
+                    kind: 'if',
+                    hasElse: s.alternate !== null,
+                });
+                walkStatement(s.consequent);
+                if (s.alternate)
+                    walkStatement(s.alternate);
+                return;
+            case 'WhileStatement':
+                branches.push({
+                    id: s.loc.offset,
+                    line: s.loc.line,
+                    col: s.loc.col,
+                    kind: 'while',
+                    hasElse: false,
+                });
+                walkStatement(s.body);
+                return;
+            case 'DoWhileStatement':
+                branches.push({
+                    id: s.loc.offset,
+                    line: s.loc.line,
+                    col: s.loc.col,
+                    kind: 'do-while',
+                    hasElse: false,
+                });
+                walkStatement(s.body);
+                return;
+            case 'ForStatement':
+                branches.push({
+                    id: s.loc.offset,
+                    line: s.loc.line,
+                    col: s.loc.col,
+                    kind: 'for',
+                    hasElse: false,
+                });
+                walkStatement(s.body);
+                return;
+            default:
+                return;
+        }
+    };
+    for (const fn of ast.functions) {
+        functions.push({
+            id: fn.loc.offset,
+            name: fn.name,
+            line: fn.loc.line,
+            col: fn.loc.col,
+            kind: 'function',
+        });
+        walkStatement(fn.body);
+    }
+    for (const state of ast.states) {
+        states.push({
+            id: state.loc.offset,
+            name: state.name,
+            line: state.loc.line,
+            col: state.loc.col,
+        });
+        for (const handler of state.handlers) {
+            functions.push({
+                id: handler.loc.offset,
+                name: handler.name,
+                line: handler.loc.line,
+                col: handler.loc.col,
+                kind: 'event',
+                state: state.name,
+            });
+            walkStatement(handler.body);
+        }
+    }
+    return { filename, source, statements, branches, functions, states };
+}
+/**
+ * Per-script hit counter. Lives on `ScriptState.coverage` when coverage is
+ * enabled; otherwise the field is null and hooks short-circuit.
+ *
+ * Counts are kept in plain Maps keyed by `loc.offset`. State coverage is
+ * keyed by state name — state changes name targets, not offsets.
+ */
+export class CoverageCollector {
+    plan;
+    statementHits = new Map();
+    branchHits = new Map();
+    functionHits = new Map();
+    stateHits = new Map();
+    constructor(plan) {
+        this.plan = plan;
+        for (const b of plan.branches) {
+            this.branchHits.set(b.id, [0, 0]);
+        }
+    }
+    hitStatement(loc) {
+        const id = loc.offset;
+        this.statementHits.set(id, (this.statementHits.get(id) ?? 0) + 1);
+    }
+    hitBranch(loc, taken) {
+        const pair = this.branchHits.get(loc.offset);
+        if (!pair)
+            return;
+        if (taken)
+            pair[0]++;
+        else
+            pair[1]++;
+    }
+    hitFunction(loc) {
+        const id = loc.offset;
+        this.functionHits.set(id, (this.functionHits.get(id) ?? 0) + 1);
+    }
+    hitState(name) {
+        this.stateHits.set(name, (this.stateHits.get(name) ?? 0) + 1);
+    }
+    /** Frozen snapshot suitable for serialization or assertions. */
+    snapshot() {
+        const statements = this.plan.statements.map((s) => ({
+            ...s,
+            hits: this.statementHits.get(s.id) ?? 0,
+        }));
+        const branches = this.plan.branches.map((b) => {
+            const pair = this.branchHits.get(b.id) ?? [0, 0];
+            return { ...b, hits: [pair[0], pair[1]] };
+        });
+        const functions = this.plan.functions.map((f) => ({
+            ...f,
+            hits: this.functionHits.get(f.id) ?? 0,
+        }));
+        const states = this.plan.states.map((s) => ({
+            ...s,
+            hits: this.stateHits.get(s.name) ?? 0,
+        }));
+        return {
+            filename: this.plan.filename,
+            source: this.plan.source,
+            statements,
+            branches,
+            functions,
+            states,
+        };
+    }
+}
+/**
+ * Merge multiple reports for the same filename into one. Used by the Vitest
+ * reporter when the same script is loaded across multiple tests in a run:
+ * planes match, hit counts union (sum).
+ *
+ * Throws if reports disagree on filename or plan shape — that signals a
+ * source change mid-run, which should fail loudly rather than be glossed.
+ */
+export function mergeReports(reports) {
+    if (reports.length === 0) {
+        throw new Error('mergeReports: empty input');
+    }
+    const head = reports[0];
+    for (const r of reports) {
+        if (r.filename !== head.filename) {
+            throw new Error(`mergeReports: filename mismatch ${head.filename} vs ${r.filename}`);
+        }
+        if (r.statements.length !== head.statements.length ||
+            r.branches.length !== head.branches.length ||
+            r.functions.length !== head.functions.length ||
+            r.states.length !== head.states.length) {
+            throw new Error(`mergeReports: plan size mismatch for ${head.filename}`);
+        }
+    }
+    const statements = head.statements.map((s, i) => ({
+        ...s,
+        hits: reports.reduce((acc, r) => acc + r.statements[i].hits, 0),
+    }));
+    const branches = head.branches.map((b, i) => {
+        let t = 0;
+        let f = 0;
+        for (const r of reports) {
+            t += r.branches[i].hits[0];
+            f += r.branches[i].hits[1];
+        }
+        return { ...b, hits: [t, f] };
+    });
+    const functions = head.functions.map((fn, i) => ({
+        ...fn,
+        hits: reports.reduce((acc, r) => acc + r.functions[i].hits, 0),
+    }));
+    const states = head.states.map((s, i) => ({
+        ...s,
+        hits: reports.reduce((acc, r) => acc + r.states[i].hits, 0),
+    }));
+    return {
+        filename: head.filename,
+        source: head.source,
+        statements,
+        branches,
+        functions,
+        states,
+    };
+}
+//# sourceMappingURL=coverage.js.map

package/dist/coverage.js.map

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

package/dist/dispatch.d.ts

@@ -0,0 +1,19 @@
+import type { BuiltinImpl, ScriptState } from './runtime.js';
+import type { LslValue } from './values/types.js';
+import type { BuiltinSpec } from './generated/functions.js';
+import type { Script } from './script.js';
+/** Look up the kwdb-derived spec for a function name, if any. */
+export declare function specFor(name: string): BuiltinSpec | undefined;
+export interface DispatchContext {
+    readonly state: ScriptState;
+    readonly mocks: Readonly<Record<string, BuiltinImpl>>;
+    readonly script: Script;
+}
+/**
+ * Resolve and invoke an `ll*` function call.
+ *
+ * Resolution order: user mock > real built-in > generated stub > error.
+ * Every successful call (including stubs) is appended to ScriptState.calls.
+ */
+export declare function callBuiltin(dctx: DispatchContext, name: string, args: ReadonlyArray<LslValue>): LslValue | undefined;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,WAAW,EAAE,MAAM,cAAc,CAAA;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAGjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,iEAAiE;AACjE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE7D;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,GAC5B,QAAQ,GAAG,SAAS,CAkBtB"}

package/dist/dispatch.js

@@ -0,0 +1,42 @@
+import { defaultValueFor } from './values/types.js';
+import { BUILTIN_SPECS } from './generated/functions.js';
+import { REAL_BUILTINS } from './builtins/index.js';
+/** Look up the kwdb-derived spec for a function name, if any. */
+export function specFor(name) {
+    return BUILTIN_SPECS[name];
+}
+/**
+ * Resolve and invoke an `ll*` function call.
+ *
+ * Resolution order: user mock > real built-in > generated stub > error.
+ * Every successful call (including stubs) is appended to ScriptState.calls.
+ */
+export function callBuiltin(dctx, name, args) {
+    const spec = specFor(name);
+    const impl = dctx.mocks[name] ?? REAL_BUILTINS[name] ?? makeStub(name);
+    const ctx = {
+        state: dctx.state,
+        spec,
+        script: dctx.script,
+        prim: dctx.script.host,
+        linkset: dctx.script.linkset,
+    };
+    const result = impl(ctx, args);
+    dctx.state.calls.push({ name, args, returned: result });
+    // Call log timestamps when the script invoked the function (pre-delay);
+    // advance the clock after the push so subsequent calls see the throttle.
+    if (spec && spec.delay > 0) {
+        dctx.state.clock.advance(spec.delay * 1000);
+    }
+    return result;
+}
+function makeStub(name) {
+    const spec = specFor(name);
+    if (!spec) {
+        return () => {
+            throw new Error(`unknown LSL function '${name}' (not in kwdb; use script.mock to provide it)`);
+        };
+    }
+    return () => defaultValueFor(spec.returnType);
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGnD,iEAAiE;AACjE,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAQ,aAA6C,CAAC,IAAI,CAAC,CAAA;AAC7D,CAAC;AAQD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,IAAqB,EACrB,IAAY,EACZ,IAA6B;IAE7B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAA;IACtE,MAAM,GAAG,GAAgB;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI;QACJ,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;QACtB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;KAC7B,CAAA;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;IACvD,wEAAwE;IACxE,yEAAyE;IACzE,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;IAC7C,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,GAAG,EAAE;YACV,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,gDAAgD,CAAC,CAAA;QAChG,CAAC,CAAA;IACH,CAAC;IACD,OAAO,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;AAC/C,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,33 @@
+import type { EvalResult, LslType } from './values/types.js';
+/**
+ * Lexical environment with a single parent pointer. The interpreter pushes
+ * a new env when entering a block / handler and discards on exit. Globals
+ * live at the bottom of the chain and persist for the lifetime of the script.
+ */
+export declare class Env {
+    private readonly parent;
+    private readonly slots;
+    constructor(parent?: Env | null);
+    /** Declare a new variable in the current scope. Coerces init to declared type. */
+    declare(name: string, type: LslType, init?: EvalResult): void;
+    /**
+     * Declare-or-reset: like `declare`, but if `name` already exists in this
+     * scope, overwrite its value (and type) instead of throwing. Used by the
+     * interpreter when a backward `jump` re-executes a VariableDeclaration —
+     * the slot already exists from the first pass and the declaration is
+     * effectively a re-initialization. The execBlock pre-scan still catches
+     * real source-level duplicate declarations.
+     */
+    declareOrReset(name: string, type: LslType, init?: EvalResult): void;
+    /** Get a variable's current value. Walks up the parent chain. */
+    get(name: string): EvalResult;
+    /** Assign to an existing variable. Coerces to declared type. */
+    set(name: string, value: EvalResult): EvalResult;
+    hasOwn(name: string): boolean;
+    /** Drop every slot in *this* scope; doesn't touch the parent chain. */
+    clear(): void;
+    /** Open a child scope. */
+    push(): Env;
+    private findSlot;
+}
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAS5D;;;;GAIG;AACH,qBAAa,GAAG;IAGF,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;gBAEnB,MAAM,GAAE,GAAG,GAAG,IAAW;IAEtD,kFAAkF;IAClF,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI;IAQ7D;;;;;;;OAOG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI;IAUpE,iEAAiE;IACjE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAM7B,gEAAgE;IAChE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU;IAOhD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7B,uEAAuE;IACvE,KAAK,IAAI,IAAI;IAIb,0BAA0B;IAC1B,IAAI,IAAI,GAAG;IAIX,OAAO,CAAC,QAAQ;CASjB"}

package/dist/env.js

@@ -0,0 +1,76 @@
+import { defaultEvalFor } from './values/types.js';
+import { coerce } from './values/coerce.js';
+/**
+ * Lexical environment with a single parent pointer. The interpreter pushes
+ * a new env when entering a block / handler and discards on exit. Globals
+ * live at the bottom of the chain and persist for the lifetime of the script.
+ */
+export class Env {
+    parent;
+    slots = new Map();
+    constructor(parent = null) {
+        this.parent = parent;
+    }
+    /** Declare a new variable in the current scope. Coerces init to declared type. */
+    declare(name, type, init) {
+        if (this.slots.has(name)) {
+            throw new Error(`variable '${name}' already declared in this scope`);
+        }
+        const value = init ? coerce(init, type) : defaultEvalFor(type);
+        this.slots.set(name, { type, value });
+    }
+    /**
+     * Declare-or-reset: like `declare`, but if `name` already exists in this
+     * scope, overwrite its value (and type) instead of throwing. Used by the
+     * interpreter when a backward `jump` re-executes a VariableDeclaration —
+     * the slot already exists from the first pass and the declaration is
+     * effectively a re-initialization. The execBlock pre-scan still catches
+     * real source-level duplicate declarations.
+     */
+    declareOrReset(name, type, init) {
+        const slot = this.slots.get(name);
+        if (slot) {
+            slot.type = type;
+            slot.value = init ? coerce(init, type) : defaultEvalFor(type);
+            return;
+        }
+        this.declare(name, type, init);
+    }
+    /** Get a variable's current value. Walks up the parent chain. */
+    get(name) {
+        const slot = this.findSlot(name);
+        if (!slot)
+            throw new Error(`undefined variable '${name}'`);
+        return slot.value;
+    }
+    /** Assign to an existing variable. Coerces to declared type. */
+    set(name, value) {
+        const slot = this.findSlot(name);
+        if (!slot)
+            throw new Error(`undefined variable '${name}'`);
+        slot.value = coerce(value, slot.type);
+        return slot.value;
+    }
+    hasOwn(name) {
+        return this.slots.has(name);
+    }
+    /** Drop every slot in *this* scope; doesn't touch the parent chain. */
+    clear() {
+        this.slots.clear();
+    }
+    /** Open a child scope. */
+    push() {
+        return new Env(this);
+    }
+    findSlot(name) {
+        let env = this;
+        while (env) {
+            const s = env.slots.get(name);
+            if (s)
+                return s;
+            env = env.parent;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAO3C;;;;GAIG;AACH,MAAM,OAAO,GAAG;IAGe;IAFZ,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAA;IAEhD,YAA6B,SAAqB,IAAI;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAE1D,kFAAkF;IAClF,OAAO,CAAC,IAAY,EAAE,IAAa,EAAE,IAAiB;QACpD,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,kCAAkC,CAAC,CAAA;QACtE,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;QAC9D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACvC,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,IAAY,EAAE,IAAa,EAAE,IAAiB;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;YAChB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;YAC7D,OAAM;QACR,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IAChC,CAAC;IAED,iEAAiE;IACjE,GAAG,CAAC,IAAY;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAChC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,GAAG,CAAC,CAAA;QAC1D,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,gEAAgE;IAChE,GAAG,CAAC,IAAY,EAAE,KAAiB;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAChC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,GAAG,CAAC,CAAA;QAC1D,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QACrC,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;IAED,uEAAuE;IACvE,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACpB,CAAC;IAED,0BAA0B;IAC1B,IAAI;QACF,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC;IAEO,QAAQ,CAAC,IAAY;QAC3B,IAAI,GAAG,GAAe,IAAI,CAAA;QAC1B,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YAC7B,IAAI,CAAC;gBAAE,OAAO,CAAC,CAAA;YACf,GAAG,GAAG,GAAG,CAAC,MAAM,CAAA;QAClB,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}