@with-logic/elwood 0.1.3 → 0.2.0

package/dist/core/input/abort.d.ts

@@ -1,10 +1,41 @@
-/** Abort-aware timing and composer cleanup for queued input (PRD §5.3/§5.9). */
-/** The narrow PTY write surface the queued-input helpers drive. */
+/** Abort-aware timing, dialog holds, and composer cleanup for queued input (PRD §5.3/§5.9, C-API-56). */
+/**
+ * The narrow terminal surface the queued-input helpers drive. `settled` resolves once
+ * every PTY byte received so far has been rendered and observed, and `renderFailed`
+ * reports a render that did not happen; write-only test doubles omit both.
+ */
 export type InputTerminal = {
     sendInput(data: string | Uint8Array): void | Promise<void>;
+    settled?(): Promise<void>;
+    readonly renderFailed?: boolean;
 };
 export declare function waitForInput(ms: number, signal?: AbortSignal): Promise<void>;
+/** One bounded attempt to observe received output: sustained output or a render backlog can exceed it. */
+export declare const observeBudgetMs = 1000;
+/**
+ * Hold a queued write while it is unsafe (see `writeUnsafe`). The caller writes in the
+ * same turn this resolves, before any further PTY output can be delivered (C-API-56).
+ * Cancellation interrupts the wait; the caller then rejects instead of writing.
+ */
+export declare function holdWhileUnsafe(terminal: InputTerminal, guard?: {
+    readonly blocked?: () => boolean;
+}, signal?: AbortSignal): Promise<void>;
+/**
+ * True while a write must be withheld. `blocked` reads the last OBSERVED frame, and
+ * rendering is asynchronous (§4.1): a dialog can be received yet unrendered, where
+ * writing would type into it. So first observe everything received. When that cannot
+ * be done — observation does not complete within the budget, a render has failed,
+ * or the wait was cancelled — the screen cannot be
+ * vouched for and the answer is `true`: fail closed, never write through.
+ * Awaited ownership uses `waitForRender` to wait cancellably for the shared pass,
+ * rather than repeatedly timing out and retrying an unchanged render backlog.
+ */
+export declare function writeUnsafe(terminal: InputTerminal, guard?: {
+    readonly blocked?: () => boolean;
+}, signal?: AbortSignal, waitForRender?: boolean): Promise<boolean>;
 export declare function throwIfInputAborted(signal?: AbortSignal): void;
 export declare function inputAbortError(signal: AbortSignal): Error;
+/** Raw takeover of awaited turn input reports submission failure, preserving other errors (§5.3). */
+export declare function submissionError(error: unknown): unknown;
 export declare function clearStagedComposer(terminal: InputTerminal): Promise<void>;
 //# sourceMappingURL=abort.d.ts.map

package/dist/core/input/abort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../../src/core/input/abort.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG;IAAE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAE3F,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB5E;AAUD,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAE9D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAE1D;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhF"}
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../../src/core/input/abort.ts"],"names":[],"mappings":"AAAA,yGAAyG;AAOzG;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB5E;AAUD,0GAA0G;AAC1G,eAAO,MAAM,eAAe,OAAQ,CAAC;AAErC;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,EACvB,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAA;CAAE,EAC5C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,aAAa,EACvB,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAA;CAAE,EAC5C,MAAM,CAAC,EAAE,WAAW,EACpB,aAAa,UAAQ,GACpB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAE9D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAE1D;AAED,qGAAqG;AACrG,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIvD;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhF"}

package/dist/core/input/abort.js

@@ -1,4 +1,8 @@
-/** Abort-aware timing and composer cleanup for queued input (PRD §5.3/§5.9). */
+/** Abort-aware timing, dialog holds, and composer cleanup for queued input (PRD §5.3/§5.9, C-API-56). */
+import { elwoodError } from "../errors.js";
+import { isPickerIntervention } from "../models/intervention.js";
+import { composerClearKeys, unsafeWriteRetryMs } from "./constants.js";
+import { observeRender } from "./render-observation.js";
 export function waitForInput(ms, signal) {
     if (signal === undefined)
         return delayUnref(ms);
@@ -26,6 +30,36 @@ function delayUnref(ms) {
         timer.unref?.();
     });
 }
+/** One bounded attempt to observe received output: sustained output or a render backlog can exceed it. */
+export const observeBudgetMs = 1_000;
+/**
+ * Hold a queued write while it is unsafe (see `writeUnsafe`). The caller writes in the
+ * same turn this resolves, before any further PTY output can be delivered (C-API-56).
+ * Cancellation interrupts the wait; the caller then rejects instead of writing.
+ */
+export async function holdWhileUnsafe(terminal, guard, signal) {
+    while (!signal?.aborted && (await writeUnsafe(terminal, guard, signal))) {
+        await delayUnref(unsafeWriteRetryMs);
+    }
+}
+/**
+ * True while a write must be withheld. `blocked` reads the last OBSERVED frame, and
+ * rendering is asynchronous (§4.1): a dialog can be received yet unrendered, where
+ * writing would type into it. So first observe everything received. When that cannot
+ * be done — observation does not complete within the budget, a render has failed,
+ * or the wait was cancelled — the screen cannot be
+ * vouched for and the answer is `true`: fail closed, never write through.
+ * Awaited ownership uses `waitForRender` to wait cancellably for the shared pass,
+ * rather than repeatedly timing out and retrying an unchanged render backlog.
+ */
+export async function writeUnsafe(terminal, guard, signal, waitForRender = false) {
+    if (signal?.aborted)
+        return true; // an abort listener added now would never fire
+    if (terminal.settled &&
+        !(await observeRender(terminal.settled(), signal, waitForRender ? undefined : observeBudgetMs)))
+        return true;
+    return terminal.renderFailed === true || guard?.blocked?.() === true;
+}
 export function throwIfInputAborted(signal) {
     if (signal?.aborted)
         throw inputAbortError(signal);
@@ -33,9 +67,15 @@ export function throwIfInputAborted(signal) {
 export function inputAbortError(signal) {
     return signal.reason instanceof Error ? signal.reason : new Error("Submission aborted.");
 }
+/** Raw takeover of awaited turn input reports submission failure, preserving other errors (§5.3). */
+export function submissionError(error) {
+    return isPickerIntervention(error)
+        ? elwoodError("wait_timeout", "Raw input replaced the staged turn input.")
+        : error;
+}
 export async function clearStagedComposer(terminal) {
     try {
-        await terminal.sendInput("\u0015\u000b");
+        await terminal.sendInput(composerClearKeys);
     }
     catch {
         // Best-effort: preserve the cancellation as the primary outcome.

package/dist/core/input/abort.js.map

@@ -1 +1 @@
-{"version":3,"file":"abort.js","sourceRoot":"","sources":["../../../src/core/input/abort.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAKhF,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,MAAoB;IAC3D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC,EAAE,CAAC,CAAC;IAChD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;YAChC,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;QAClC,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAChB,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0FAA0F;AAC1F,SAAS,UAAU,CAAC,EAAU;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACtC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,IAAI,MAAM,EAAE,OAAO;QAAE,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,OAAO,MAAM,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAuB;IAC/D,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;IACnE,CAAC;AACH,CAAC"}
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../../../src/core/input/abort.ts"],"names":[],"mappings":"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"}

package/dist/core/input/clear-ack.d.ts

@@ -0,0 +1,10 @@
+/** Observe native consumption of owned clear keys before releasing input (C-API-56). */
+import { type InputTerminal } from "./abort.ts";
+/**
+ * Positive empty-composer evidence: reuse one token for each completed frame and
+ * return a distinct token only for a later completed frame, never for each poll.
+ * Return undefined when there is no completed, positively empty native composer.
+ */
+export type EmptyComposerObserver = () => object | undefined;
+export declare function clearAndObserveComposer(terminal: InputTerminal, blocked: () => boolean, observeEmpty: EmptyComposerObserver, signal: AbortSignal): Promise<void>;
+//# sourceMappingURL=clear-ack.d.ts.map

package/dist/core/input/clear-ack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-ack.d.ts","sourceRoot":"","sources":["../../../src/core/input/clear-ack.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,YAAY,CAAC;AAGpB;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,MAAM,GAAG,SAAS,CAAC;AAE7D,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,OAAO,EACtB,YAAY,EAAE,qBAAqB,EACnC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/core/input/clear-ack.js

@@ -0,0 +1,26 @@
+/** Observe native consumption of owned clear keys before releasing input (C-API-56). */
+import { observeBudgetMs, throwIfInputAborted, waitForInput, writeUnsafe, } from "./abort.js";
+import { composerClearKeys, unsafeWriteRetryMs } from "./constants.js";
+export async function clearAndObserveComposer(terminal, blocked, observeEmpty, signal) {
+    const before = observeEmpty();
+    throwIfInputAborted(signal);
+    await terminal.sendInput(composerClearKeys);
+    const deadline = new AbortController();
+    const timer = setTimeout(() => deadline.abort(new Error("Composer clear was not observed.")), observeBudgetMs);
+    const waiting = AbortSignal.any([signal, deadline.signal]);
+    try {
+        for (;;) {
+            throwIfInputAborted(waiting);
+            if (await writeUnsafe(terminal, { blocked }, waiting))
+                throw new Error("Composer observation is unsafe.");
+            const after = observeEmpty();
+            if (after !== undefined && after !== before)
+                return;
+            await waitForInput(unsafeWriteRetryMs, waiting);
+        }
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=clear-ack.js.map

package/dist/core/input/clear-ack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-ack.js","sourceRoot":"","sources":["../../../src/core/input/clear-ack.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAEL,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AASvE,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAAuB,EACvB,OAAsB,EACtB,YAAmC,EACnC,MAAmB;IAEnB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,QAAQ,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC,EACnE,eAAe,CAChB,CAAC;IACF,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,SAAS,CAAC;YACR,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAC7B,IAAI,MAAM,WAAW,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC;gBACnD,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACrD,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;YAC7B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,MAAM;gBAAE,OAAO;YACpD,MAAM,YAAY,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/core/input/composer-cleanup.d.ts

@@ -0,0 +1,33 @@
+import { type InputTerminal } from "./abort.ts";
+import { type EmptyComposerObserver } from "./clear-ack.ts";
+/** Register ComposerCleanup before staging; unregistered terminals deliberately record no ownership. */
+export declare function stageComposer(terminal: InputTerminal): AbortSignal | undefined;
+/** Mark submission after staging; this is also a no-op without prior registration. */
+export declare function submittedComposer(terminal: InputTerminal): void;
+/**
+ * Registered session cleanup is deferred beyond attachment finalizers, including
+ * clipboard restoration. Unregistered direct callers instead attempt an immediate,
+ * observed, unblocked best-effort clear; they have no retained ownership token.
+ */
+export declare function requestComposerCleanup(terminal: InputTerminal, blocked?: () => boolean): Promise<void>;
+export declare class ComposerCleanup {
+    private draft;
+    private baseline;
+    private stagedGeneration;
+    private readonly terminal;
+    private readonly blocked;
+    private readonly closing;
+    private readonly rawInputSignal;
+    private readonly observeEmpty;
+    /** Register this owner before any stage/submit hooks or queued operation. */
+    constructor(terminal: InputTerminal, blocked: () => boolean, closing: AbortSignal, rawInputSignal: () => AbortSignal, observeEmpty: EmptyComposerObserver);
+    stage(): AbortSignal;
+    submitted(): void;
+    defer(): void;
+    /** Preparation may cancel before work; once invoked exactly once, work owns its task lifetime. */
+    run(work: () => Promise<void>, preparationSignal: AbortSignal): Promise<void>;
+    private reconcileDraftOwnership;
+    private flush;
+    private clear;
+}
+//# sourceMappingURL=composer-cleanup.d.ts.map

package/dist/core/input/composer-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-cleanup.d.ts","sourceRoot":"","sources":["../../../src/core/input/composer-cleanup.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,aAAa,EAInB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAMrF,wGAAwG;AACxG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,WAAW,GAAG,SAAS,CAE9E;AACD,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAE/D;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,MAAM,OAAO,GACtB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,6EAA6E;gBAE3E,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,OAAO,EACtB,OAAO,EAAE,WAAW,EACpB,cAAc,EAAE,MAAM,WAAW,EACjC,YAAY,EAAE,qBAAqB;IAkBrC,KAAK,IAAI,WAAW;IAMpB,SAAS,IAAI,IAAI;IAMjB,KAAK,IAAI,IAAI;IAIb,kGAAkG;IAC5F,GAAG,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,iBAAiB,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBnF,OAAO,CAAC,uBAAuB;YAKjB,KAAK;YAiBL,KAAK;CAYpB"}

package/dist/core/input/composer-cleanup.js

@@ -0,0 +1,127 @@
+/** Deferred draft cleanup owns a safe queue boundary, never caller-owned edits (PRD §5.3, C-API-56). */
+import { elwoodError } from "../errors.js";
+import { clearStagedComposer, throwIfInputAborted, waitForInput, writeUnsafe, } from "./abort.js";
+import { clearAndObserveComposer } from "./clear-ack.js";
+import { unsafeWriteRetryMs } from "./constants.js";
+const owners = new WeakMap();
+/** Register ComposerCleanup before staging; unregistered terminals deliberately record no ownership. */
+export function stageComposer(terminal) {
+    return owners.get(terminal)?.stage();
+}
+/** Mark submission after staging; this is also a no-op without prior registration. */
+export function submittedComposer(terminal) {
+    owners.get(terminal)?.submitted();
+}
+/**
+ * Registered session cleanup is deferred beyond attachment finalizers, including
+ * clipboard restoration. Unregistered direct callers instead attempt an immediate,
+ * observed, unblocked best-effort clear; they have no retained ownership token.
+ */
+export async function requestComposerCleanup(terminal, blocked) {
+    const owner = owners.get(terminal);
+    if (owner)
+        owner.defer();
+    else if (!(await writeUnsafe(terminal, { blocked: () => blocked?.() === true })))
+        await clearStagedComposer(terminal);
+}
+export class ComposerCleanup {
+    draft;
+    baseline;
+    stagedGeneration;
+    terminal;
+    blocked;
+    closing;
+    rawInputSignal;
+    observeEmpty;
+    /** Register this owner before any stage/submit hooks or queued operation. */
+    constructor(terminal, blocked, closing, rawInputSignal, observeEmpty) {
+        this.terminal = terminal;
+        this.blocked = blocked;
+        this.closing = closing;
+        this.rawInputSignal = rawInputSignal;
+        this.observeEmpty = observeEmpty;
+        this.baseline = rawInputSignal();
+        owners.set(terminal, this);
+        closing.addEventListener("abort", () => {
+            this.draft = undefined;
+        }, { once: true });
+    }
+    stage() {
+        this.stagedGeneration = this.rawInputSignal();
+        if (this.stagedGeneration === this.baseline)
+            this.draft ??= { rawInputSignal: this.stagedGeneration, pending: false };
+        return this.stagedGeneration;
+    }
+    submitted() {
+        // Only an uninterrupted submission establishes a fresh composer after raw edits.
+        if (this.stagedGeneration === this.rawInputSignal())
+            this.baseline = this.stagedGeneration;
+        this.stagedGeneration = undefined;
+        this.draft = undefined;
+    }
+    defer() {
+        if (this.reconcileDraftOwnership())
+            this.draft.pending = true;
+    }
+    /** Preparation may cancel before work; once invoked exactly once, work owns its task lifetime. */
+    async run(work, preparationSignal) {
+        await this.flush(preparationSignal);
+        throwIfInputAborted(preparationSignal);
+        try {
+            await work();
+        }
+        catch (error) {
+            this.defer();
+            // Never wait for a dialog in a failed operation or retain the clipboard lock for it.
+            if (this.reconcileDraftOwnership() &&
+                !(await writeUnsafe(this.terminal, { blocked: this.blocked }, this.closing))) {
+                try {
+                    await this.clear();
+                }
+                catch {
+                    /* The next operation must retry or reject. */
+                }
+            }
+            throw error;
+        }
+    }
+    reconcileDraftOwnership() {
+        if (this.closing.aborted || this.draft?.rawInputSignal.aborted)
+            this.draft = undefined;
+        return this.draft !== undefined;
+    }
+    async flush(signal) {
+        while (this.reconcileDraftOwnership() && this.draft.pending) {
+            const observe = AbortSignal.any([signal, this.closing, this.draft.rawInputSignal]);
+            try {
+                if (!(await writeUnsafe(this.terminal, { blocked: this.blocked }, observe))) {
+                    await this.clear(observe);
+                    break;
+                }
+                await waitForInput(unsafeWriteRetryMs, observe);
+            }
+            catch (error) {
+                if (this.reconcileDraftOwnership())
+                    throw error;
+            }
+        }
+        throwIfInputAborted(signal);
+        throwIfInputAborted(this.closing);
+    }
+    async clear(preparationSignal = this.closing) {
+        if (!this.reconcileDraftOwnership())
+            return;
+        const draft = this.draft;
+        const signal = AbortSignal.any([preparationSignal, this.closing, draft.rawInputSignal]);
+        try {
+            await clearAndObserveComposer(this.terminal, this.blocked, this.observeEmpty, signal);
+        }
+        catch {
+            throwIfInputAborted(signal);
+            throw elwoodError("wait_timeout", "Could not clear the staged composer draft.");
+        }
+        if (this.draft === draft)
+            this.draft = undefined;
+    }
+}
+//# sourceMappingURL=composer-cleanup.js.map

package/dist/core/input/composer-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-cleanup.js","sourceRoot":"","sources":["../../../src/core/input/composer-cleanup.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,mBAAmB,EAEnB,mBAAmB,EACnB,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,uBAAuB,EAA8B,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,GAAG,IAAI,OAAO,EAAkC,CAAC;AAG7D,wGAAwG;AACxG,MAAM,UAAU,aAAa,CAAC,QAAuB;IACnD,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;AACvC,CAAC;AACD,sFAAsF;AACtF,MAAM,UAAU,iBAAiB,CAAC,QAAuB;IACvD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAuB,EACvB,OAAuB;IAEvB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,KAAK;QAAE,KAAK,CAAC,KAAK,EAAE,CAAC;SACpB,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9E,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,OAAO,eAAe;IAClB,KAAK,CAAoB;IACzB,QAAQ,CAAc;IACtB,gBAAgB,CAA0B;IACjC,QAAQ,CAAgB;IACxB,OAAO,CAAgB;IACvB,OAAO,CAAc;IACrB,cAAc,CAAoB;IAClC,YAAY,CAAwB;IACrD,6EAA6E;IAC7E,YACE,QAAuB,EACvB,OAAsB,EACtB,OAAoB,EACpB,cAAiC,EACjC,YAAmC;QAEnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,cAAc,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,gBAAgB,CACtB,OAAO,EACP,GAAG,EAAE;YACH,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACzB,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC9C,IAAI,IAAI,CAAC,gBAAgB,KAAK,IAAI,CAAC,QAAQ;YACzC,IAAI,CAAC,KAAK,KAAK,EAAE,cAAc,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC3E,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IACD,SAAS;QACP,iFAAiF;QACjF,IAAI,IAAI,CAAC,gBAAgB,KAAK,IAAI,CAAC,cAAc,EAAE;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC3F,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IACzB,CAAC;IACD,KAAK;QACH,IAAI,IAAI,CAAC,uBAAuB,EAAE;YAAE,IAAI,CAAC,KAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACjE,CAAC;IAED,kGAAkG;IAClG,KAAK,CAAC,GAAG,CAAC,IAAyB,EAAE,iBAA8B;QACjE,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACpC,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,IAAI,EAAE,CAAC;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,qFAAqF;YACrF,IACE,IAAI,CAAC,uBAAuB,EAAE;gBAC9B,CAAC,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,EAC5E,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;gBAAC,MAAM,CAAC;oBACP,8CAA8C;gBAChD,CAAC;YACH,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,uBAAuB;QAC7B,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO;YAAE,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvF,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC;IAClC,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,MAAmB;QACrC,OAAO,IAAI,CAAC,uBAAuB,EAAE,IAAI,IAAI,CAAC,KAAM,CAAC,OAAO,EAAE,CAAC;YAC7D,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAM,CAAC,cAAc,CAAC,CAAC,CAAC;YACpF,IAAI,CAAC;gBACH,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;oBAC5E,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBAC1B,MAAM;gBACR,CAAC;gBACD,MAAM,YAAY,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;YAClD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,IAAI,CAAC,uBAAuB,EAAE;oBAAE,MAAM,KAAK,CAAC;YAClD,CAAC;QACH,CAAC;QACD,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC5B,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC,OAAO;QAClD,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE;YAAE,OAAO;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAM,CAAC;QAC1B,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,iBAAiB,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;QACxF,IAAI,CAAC;YACH,MAAM,uBAAuB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACxF,CAAC;QAAC,MAAM,CAAC;YACP,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAC5B,MAAM,WAAW,CAAC,cAAc,EAAE,4CAA4C,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IACnD,CAAC;CACF"}

package/dist/core/input/constants.d.ts

@@ -0,0 +1,12 @@
+/** Shared composer keys and bounded input-recovery cadence (PRD §5.3, C-API-56). */
+export declare const bracketedPasteStart = "\u001B[200~";
+export declare const bracketedPasteEnd = "\u001B[201~";
+/** Ctrl+U kills to line start; Ctrl+K kills to line end, discarding staged composer content. */
+export declare const composerClearKeys = "\u0015\v";
+/** Recheck dialog, unobserved-output, and failed-render holds at the same cadence. */
+export declare const unsafeWriteRetryMs = 50;
+/** Maximum physical recovery Enters after the initial submitting Enter. */
+export declare const pasteNudgeAttempts = 2;
+/** Unknown/unsafe observations share one bounded recovery budget. */
+export declare const pasteObservationLimit = 4;
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/input/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/core/input/constants.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AACjD,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C,gGAAgG;AAChG,eAAO,MAAM,iBAAiB,aAAiB,CAAC;AAChD,sFAAsF;AACtF,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,IAAI,CAAC"}

package/dist/core/input/constants.js

@@ -0,0 +1,12 @@
+/** Shared composer keys and bounded input-recovery cadence (PRD §5.3, C-API-56). */
+export const bracketedPasteStart = "\u001b[200~";
+export const bracketedPasteEnd = "\u001b[201~";
+/** Ctrl+U kills to line start; Ctrl+K kills to line end, discarding staged composer content. */
+export const composerClearKeys = "\u0015\u000b";
+/** Recheck dialog, unobserved-output, and failed-render holds at the same cadence. */
+export const unsafeWriteRetryMs = 50;
+/** Maximum physical recovery Enters after the initial submitting Enter. */
+export const pasteNudgeAttempts = 2;
+/** Unknown/unsafe observations share one bounded recovery budget. */
+export const pasteObservationLimit = 4;
+//# sourceMappingURL=constants.js.map

package/dist/core/input/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/core/input/constants.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAE/C,gGAAgG;AAChG,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAChD,sFAAsF;AACtF,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC,qEAAqE;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC"}

package/dist/core/input/empty-frame.d.ts

@@ -0,0 +1,4 @@
+import type { ElwoodTerminal, TerminalSnapshot } from "../../terminal/headless.ts";
+/** The caller separately owns dialog blocking; this only observes the current input surface. */
+export declare function emptyInputFrame(terminal: ElwoodTerminal, matches: (rows: readonly string[], cursorRow: number) => boolean): TerminalSnapshot | undefined;
+//# sourceMappingURL=empty-frame.d.ts.map

package/dist/core/input/empty-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-frame.d.ts","sourceRoot":"","sources":["../../../src/core/input/empty-frame.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnF,gGAAgG;AAChG,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,GAC/D,gBAAgB,GAAG,SAAS,CAQ9B"}

package/dist/core/input/empty-frame.js

@@ -0,0 +1,15 @@
+/** Positive native input geometry, independent of turn activity (PRD §5.3, C-API-56). */
+import { cursorViewportRow } from "../../terminal/coordinates.js";
+import { currentRenderedFrame, settledCursorVisible } from "../../terminal/cursor.js";
+/** The caller separately owns dialog blocking; this only observes the current input surface. */
+export function emptyInputFrame(terminal, matches) {
+    const frame = currentRenderedFrame(terminal);
+    // Both native inputs place the caret after the two-cell "❯ " / "› " prefix.
+    if (!(frame && settledCursorVisible(terminal.xterm)) || frame.cursorX !== 2)
+        return undefined;
+    const buffer = terminal.xterm.buffer.active;
+    // cursorY is relative to the live buffer base; snapshot lines start at viewportY.
+    const viewportCursorRow = cursorViewportRow(frame.cursorY, buffer);
+    return matches(frame.lines, viewportCursorRow) ? frame : undefined;
+}
+//# sourceMappingURL=empty-frame.js.map

package/dist/core/input/empty-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-frame.js","sourceRoot":"","sources":["../../../src/core/input/empty-frame.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGtF,gGAAgG;AAChG,MAAM,UAAU,eAAe,CAC7B,QAAwB,EACxB,OAAgE;IAEhE,MAAM,KAAK,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC7C,4EAA4E;IAC5E,IAAI,CAAC,CAAC,KAAK,IAAI,oBAAoB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9F,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5C,kFAAkF;IAClF,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACnE,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC"}

package/dist/core/input/index.d.ts

@@ -3,35 +3,18 @@
  * Implements PRD §5.3 prompt and command submission semantics (C-API-31).
  */
 import type { ControlSubmitMode } from "../control-queue/index.ts";
+import type { ControlSubmitter } from "../control-queue/types.ts";
 import { type InputTerminal } from "./abort.ts";
-/** Adapter view of "the paste is still staged in the composer". */
-export type PasteGuard = {
-    readonly snapshot: () => string;
-    readonly staged: (screen: string, prompt: string) => boolean;
-    /**
-     * True when a blocking human-decision dialog is on screen. A dialog can
-     * appear during the paste-settle window; sending the submitting Enter then
-     * would confirm the dialog's highlighted option (e.g. approve a tool). The
-     * Enter is therefore held while this is true and retried once it clears.
-     */
-    readonly blocked?: () => boolean;
-};
+import type { PasteGuard } from "./paste-guard.ts";
+export type { PasteGuard, RecoveryComposer } from "./paste-guard.ts";
+export { sanitizePasteText } from "./sanitize.ts";
 export declare const commandEnterDelayMs = 150;
 export declare const pasteSettleDelayMs = 150;
 export declare const pasteNudgeDelayMs = 1000;
-export declare const pasteNudgeAttempts = 2;
-/** How often the submitting Enter re-checks a blocking dialog before firing. */
-export declare const blockedPollMs = 50;
+export { pasteNudgeAttempts } from "./constants.ts";
 /** Explicitly best-effort input for startup/recovery automation. */
 export declare function ignoreInputFailure(input: void | Promise<void>): void;
-/**
- * Neutralizes caller/model text before it is framed as a bracketed paste (§5.3).
- * Message text is data, so an embedded `ESC[201~` end sentinel (or a bare control
- * byte) MUST NOT terminate paste mode early and turn following bytes into live
- * keystrokes — e.g. an Enter that confirms a permission dialog. Tab, newline, and
- * carriage return survive as legitimate multi-line text; everything else is
- * stripped. `sendKeys` is the raw escape hatch and never goes through here.
- */
-export declare function sanitizePasteText(text: string): string;
-export declare function writeQueuedInput(terminal: InputTerminal, input: string, mode: ControlSubmitMode, guard?: PasteGuard, signal?: AbortSignal, enterDelayMs?: number): Promise<void>;
+export declare function writeQueuedInput(terminal: InputTerminal, input: string, mode: ControlSubmitMode, guard?: PasteGuard, signal?: AbortSignal, enterDelayMs?: number, onSubmitted?: () => void, beforeEnter?: (payload: string) => void): Promise<void>;
+/** Bind the session terminal while preserving physical-submission evidence (C-ATTN-02). */
+export declare function queuedInputSubmitter(terminal: InputTerminal, guard: PasteGuard): ControlSubmitter;
 //# sourceMappingURL=index.d.ts.map

package/dist/core/input/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/input/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAEL,KAAK,aAAa,EAGnB,MAAM,YAAY,CAAC;AAEpB,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7D;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,iBAAiB,OAAQ,CAAC;AACvC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,gFAAgF;AAChF,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAEpE;AASD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAwGD,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,iBAAiB,EACvB,KAAK,CAAC,EAAE,UAAU,EAClB,MAAM,CAAC,EAAE,WAAW,EACpB,YAAY,SAAsB,GACjC,OAAO,CAAC,IAAI,CAAC,CA6Bf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/input/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,EAEL,KAAK,aAAa,EAInB,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,iBAAiB,OAAQ,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAEpE;AAwFD,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,iBAAiB,EACvB,KAAK,CAAC,EAAE,UAAU,EAClB,MAAM,CAAC,EAAE,WAAW,EACpB,YAAY,SAAsB,EAClC,WAAW,CAAC,EAAE,MAAM,IAAI,EACxB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC,CAsDf;AAED,2FAA2F;AAC3F,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAYjG"}