@reticlehq/browser 2.0.0

package/dist/actions/actions.js

@@ -0,0 +1,348 @@
+import { ActionType, ActionWarning, DANGEROUS_ACTION_CONFIRM_ARG, ElementState, isDangerousActionText, SettleReason, } from '@reticlehq/core';
+import { refs } from '../dom/refs.js';
+import { getAccessibleName, isVisible, getStates } from '../dom/a11y.js';
+import { elementHasHoverHandlers, identifyComponent } from '../registry/adapters.js';
+import { nativeSetTimeout, settle } from '../timers/native-timers.js';
+/**
+ * Set a value on a controlled input the way React expects (native setter + input event).
+ * Returns the `input` event's dispatchEvent result (defaultPrevented of the primary event).
+ */
+function setNativeValue(el, value) {
+    const proto = el instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype;
+    // eslint-disable-next-line @typescript-eslint/unbound-method -- setter is invoked via .call(el)
+    const setter = Object.getOwnPropertyDescriptor(proto, 'value')?.set;
+    if (setter !== undefined) {
+        setter.call(el, value);
+    }
+    else {
+        el.value = value;
+    }
+    const notPrevented = el.dispatchEvent(new Event('input', { bubbles: true, cancelable: true }));
+    el.dispatchEvent(new Event('change', { bubbles: true }));
+    return !notPrevented;
+}
+function asString(value, fallback = '') {
+    return typeof value === 'string' ? value : fallback;
+}
+function requireElement(ref) {
+    const el = refs.resolve(ref);
+    if (el === null)
+        throw new Error(`ref '${ref}' no longer resolves to an element`);
+    if (!(el instanceof HTMLElement))
+        throw new Error(`ref '${ref}' is not an HTMLElement`);
+    return el;
+}
+/**
+ * Capture an element's anchor BEFORE the action runs. Critical: a navigating/destructive action can
+ * unmount the target (login submit, a close button), after which it has no readable attribute — so
+ * reading the anchor post-settle would silently degrade the recorded step. We read it up front while
+ * the element is still mounted.
+ */
+function anchorOf(el) {
+    const testid = el.getAttribute('data-testid') ?? undefined;
+    if (testid !== undefined)
+        return { testid };
+    const info = identifyComponent(el);
+    const out = {};
+    const component = info?.componentStack[0];
+    if (component !== undefined)
+        out.component = component;
+    if (info?.source !== undefined)
+        out.source = info.source;
+    return out;
+}
+const result = (ref, action, effect, settled, settleReason, anchor, warning) => {
+    const base = {
+        ok: true,
+        ref,
+        action,
+        dispatched: true,
+        settled,
+        settleReason,
+        effect,
+    };
+    if (anchor.testid !== undefined) {
+        base.testid = anchor.testid;
+    }
+    else {
+        // No testid — carry the auto-anchor so the recorded step stays stable, not degraded.
+        if (anchor.component !== undefined)
+            base.component = anchor.component;
+        if (anchor.source !== undefined)
+            base.source = anchor.source;
+    }
+    if (warning !== undefined)
+        base.warning = warning;
+    return base;
+};
+const FILL_LIKE = new Set([ActionType.FILL, ActionType.TYPE, ActionType.CLEAR]);
+const isFillLike = (action) => FILL_LIKE.has(action);
+/** Actions that resolve to a point and so benefit from off-viewport scroll + occlusion hit-test. */
+const CLICK_LIKE = new Set([ActionType.CLICK, ActionType.DBLCLICK]);
+function dangerousActionContext(el) {
+    const form = el.closest('form');
+    return [
+        getAccessibleName(el),
+        el.textContent ?? '',
+        el.getAttribute('value') ?? '',
+        el.getAttribute('title') ?? '',
+        el.getAttribute('aria-label') ?? '',
+        el.getAttribute('href') ?? '',
+        form?.getAttribute('action') ?? '',
+        form?.textContent ?? '',
+    ].join(' ');
+}
+function requiresDangerousConfirmation(text) {
+    return isDangerousActionText(text);
+}
+function assertActionAllowed(el, action, args) {
+    const canTrigger = action === ActionType.CLICK ||
+        action === ActionType.DBLCLICK ||
+        action === ActionType.DRAG ||
+        action === ActionType.SUBMIT ||
+        (action === ActionType.PRESS && asString(args['key'], 'Enter') === 'Enter');
+    const dragTarget = action === ActionType.DRAG ? refs.resolve(asString(args['toRef'])) : null;
+    const context = dragTarget instanceof HTMLElement
+        ? `${dangerousActionContext(el)} ${dangerousActionContext(dragTarget)}`
+        : dangerousActionContext(el);
+    if (canTrigger &&
+        requiresDangerousConfirmation(context) &&
+        args[DANGEROUS_ACTION_CONFIRM_ARG] !== true) {
+        throw new Error(`potentially destructive action blocked; retry with args.${DANGEROUS_ACTION_CONFIRM_ARG}=true`);
+    }
+}
+/** Best-effort click-point geometry. All-false default when there is nothing measurable to test. */
+import { NO_GEOMETRY, fireClickSequence, clickGeometry, firePointer, firePointerNonBubbling, dragElement, } from './actions-dom.js';
+/** Derive `enabled` from the shared a11y state logic (disabled prop + aria-disabled). */
+function enabledOf(el) {
+    return !getStates(el).includes(ElementState.DISABLED);
+}
+/** Current value for inputs/textareas/selects, else undefined. */
+function valueOf(el) {
+    if (el instanceof HTMLInputElement ||
+        el instanceof HTMLTextAreaElement ||
+        el instanceof HTMLSelectElement) {
+        return el.value;
+    }
+    return undefined;
+}
+/** Ref of the currently-focused element, treating body/null as "no focus". */
+function activeRef(el) {
+    const active = el.ownerDocument.activeElement;
+    if (active === null || active === el.ownerDocument.body)
+        return null;
+    return refs.refFor(active);
+}
+/**
+ * Dispatch the action's events. Returns `defaultPrevented` of the primary cancelable event
+ * (false for actions whose primary event is non-cancelable or unobservable). Drag/hover-hold
+ * await internally; the probe wrapper builds the result once they resolve.
+ */
+async function dispatchFor(el, action, args) {
+    switch (action) {
+        case ActionType.CLICK:
+            // Full pointer/mouse sequence (not a bare click) so pointer- and focus-gated handlers fire
+            // the way they do for a real user. Returns the click event's defaultPrevented.
+            return fireClickSequence(el);
+        case ActionType.DBLCLICK:
+            return !el.dispatchEvent(new MouseEvent('dblclick', { bubbles: true, cancelable: true }));
+        case ActionType.HOVER: {
+            const doc = el.ownerDocument;
+            // Best-effort "previous" node for relatedTarget so React's enter/leave synthesis has a "from".
+            const from = doc.activeElement ?? doc.body;
+            // Bubbling over/move with relatedTarget so React's delegated root can synthesize enter/leave.
+            firePointer(el, 'pointerover', from);
+            el.dispatchEvent(new MouseEvent('mouseover', { bubbles: true, relatedTarget: from }));
+            // Non-bubbling enter pair (per spec) for direct enter/onMouseEnter listeners.
+            firePointerNonBubbling(el, 'pointerenter', from);
+            el.dispatchEvent(new MouseEvent('mouseenter', { relatedTarget: from }));
+            firePointer(el, 'pointermove', from);
+            const moved = el.dispatchEvent(new MouseEvent('mousemove', { bubbles: true, cancelable: true }));
+            // hover-dwell: keep "hovering" for holdMs so timer-gated reveals can mount.
+            const holdMs = typeof args['holdMs'] === 'number' ? args['holdMs'] : 0;
+            if (holdMs > 0)
+                await sleep(holdMs);
+            return !moved;
+        }
+        case ActionType.FOCUS:
+            el.focus();
+            el.dispatchEvent(new FocusEvent('focusin', { bubbles: true }));
+            return false; // FocusEvents are not cancelable.
+        case ActionType.BLUR:
+            // Fire a bubbling focusout so React 19's delegated root listener runs onBlur
+            // (commit-on-blur). el.blur() alone only works if the element was truly focused.
+            el.blur();
+            el.dispatchEvent(new FocusEvent('blur'));
+            el.dispatchEvent(new FocusEvent('focusout', { bubbles: true }));
+            return false;
+        case ActionType.FILL:
+            if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
+                el.focus(); // focus first so a later blur commits (onBlur editors)
+                return setNativeValue(el, asString(args['value']));
+            }
+            throw new Error(`cannot fill a <${el.tagName.toLowerCase()}>`);
+        case ActionType.TYPE:
+            if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
+                el.focus();
+                return setNativeValue(el, el.value + asString(args['text']));
+            }
+            throw new Error(`cannot type into a <${el.tagName.toLowerCase()}>`);
+        case ActionType.CLEAR:
+            if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
+                return setNativeValue(el, '');
+            }
+            return false;
+        case ActionType.SELECT:
+            if (el instanceof HTMLSelectElement) {
+                el.value = asString(args['value']);
+                el.dispatchEvent(new Event('change', { bubbles: true }));
+                return false; // change is not cancelable.
+            }
+            throw new Error(`cannot select on a <${el.tagName.toLowerCase()}>`);
+        case ActionType.CHECK:
+        case ActionType.UNCHECK:
+            if (el instanceof HTMLInputElement) {
+                el.checked = action === ActionType.CHECK;
+                el.dispatchEvent(new Event('change', { bubbles: true }));
+                return false;
+            }
+            throw new Error(`cannot (un)check a <${el.tagName.toLowerCase()}>`);
+        case ActionType.SUBMIT: {
+            const form = el instanceof HTMLFormElement ? el : el.closest('form');
+            if (form === null)
+                throw new Error('no form to submit');
+            form.requestSubmit();
+            return false; // requestSubmit() returns void; the internal submit event is unobservable.
+        }
+        case ActionType.PRESS: {
+            const key = asString(args['key'], 'Enter');
+            const down = el.dispatchEvent(new KeyboardEvent('keydown', { key, bubbles: true, cancelable: true }));
+            el.dispatchEvent(new KeyboardEvent('keyup', { key, bubbles: true }));
+            return !down;
+        }
+        case ActionType.SCROLL_INTO_VIEW:
+            el.scrollIntoView();
+            return false;
+        case ActionType.UPLOAD: {
+            if (!(el instanceof HTMLInputElement) || el.type !== 'file') {
+                throw new Error('upload target must be a <input type="file">');
+            }
+            const file = new File([asString(args['content'], 'reticle test file')], asString(args['name'], 'file.txt'), {
+                type: asString(args['type'], 'text/plain'),
+            });
+            const dt = new DataTransfer();
+            dt.items.add(file);
+            el.files = dt.files;
+            const inputOk = el.dispatchEvent(new Event('input', { bubbles: true, cancelable: true }));
+            el.dispatchEvent(new Event('change', { bubbles: true }));
+            return !inputOk;
+        }
+        case ActionType.DRAG: {
+            const toRef = asString(args['toRef']);
+            const resolved = toRef !== undefined ? refs.resolve(toRef) : null;
+            return await dragElement(el, resolved instanceof HTMLElement ? resolved : null, args['data']);
+        }
+        default:
+            throw new Error(`unknown action '${action}'`);
+    }
+}
+/**
+ * Execute a single action against a ref and probe for best-effort evidence of effect.
+ * Always async: the MutationObserver read needs a microtask + rAF after dispatch.
+ */
+export async function executeAction(ref, action, args = {}) {
+    const el = requireElement(ref);
+    assertActionAllowed(el, action, args);
+    // Capture the anchor while the element is still mounted — the action may unmount it (navigation).
+    const anchor = anchorOf(el);
+    const visible = isVisible(el);
+    const enabled = enabledOf(el);
+    const prevFocus = activeRef(el);
+    const valueBefore = valueOf(el);
+    // Click-like: scroll an off-viewport target in + hit-test the click point BEFORE installing the
+    // mutation observer (scroll/hit-test never mutate the DOM, but keep the probe window clean).
+    const geometry = CLICK_LIKE.has(action) ? clickGeometry(el) : NO_GEOMETRY;
+    let mutated = 0;
+    const obs = new MutationObserver((records) => {
+        mutated += records.length;
+    });
+    obs.observe(el.ownerDocument.documentElement, {
+        subtree: true,
+        childList: true,
+        attributes: true,
+        characterData: true,
+    });
+    let defaultPrevented = false;
+    let settled = false;
+    let settleReason = null;
+    try {
+        defaultPrevented = await dispatchFor(el, action, args);
+    }
+    finally {
+        // bounded settle — microtask + one BOUNDED frame so React's commit (and the resulting DOM
+        // mutations → dom.added/dom.text/dom.attr events) flush before we return, landing inside
+        // observe({ since }). Bounded so a throttled/background tab never hangs; a settle timeout NEVER
+        // rejects (only a real dispatch failure thrown above does). settle() can never throw.
+        const outcome = await settle();
+        settled = outcome.settled;
+        settleReason = outcome.settled ? null : SettleReason.TIMEOUT;
+        obs.disconnect();
+    }
+    const valueAfter = valueOf(el);
+    const nextFocus = activeRef(el);
+    const effect = {
+        dispatched: true,
+        targetMatched: el.isConnected,
+        visible,
+        enabled,
+        defaultPrevented,
+        focusMoved: prevFocus !== nextFocus ? `${prevFocus ?? 'null'}->${nextFocus ?? 'null'}` : null,
+        valueChanged: isFillLike(action) ? valueBefore !== valueAfter : false,
+        domMutatedWithin: mutated,
+        occluded: geometry.occluded,
+        occludedBy: geometry.occludedBy,
+        scrolledIntoView: geometry.scrolledIntoView,
+    };
+    // Honesty caveats: a visually-occluded click is reported even though synthetic dispatch landed;
+    // else synthetic hover may not fire framework enter/leave handlers (no native hit-test).
+    const warning = geometry.occluded
+        ? ActionWarning.CLICK_OCCLUDED
+        : action === ActionType.HOVER && elementHasHoverHandlers(el)
+            ? ActionWarning.HOVER_NATIVE_ENTER_LEAVE
+            : undefined;
+    return result(ref, action, effect, settled, settleReason, anchor, warning);
+}
+const sleep = (ms) => new Promise((r) => nativeSetTimeout(r, ms));
+/** Best-effort WebMCP passthrough: call a navigator.modelContext tool if the site exposes one. */
+export async function dispatchWebMcp(tool, params, confirmDangerous = false) {
+    if (requiresDangerousConfirmation(tool) && !confirmDangerous) {
+        throw new Error(`potentially destructive WebMCP tool blocked; retry with ${DANGEROUS_ACTION_CONFIRM_ARG}=true`);
+    }
+    const mc = navigator.modelContext;
+    if (mc === undefined || typeof mc.callTool !== 'function') {
+        throw new Error('WebMCP (navigator.modelContext) not available on this page');
+    }
+    return await mc.callTool(tool, params);
+}
+export async function executeSequence(steps) {
+    const effects = [];
+    const stepResults = [];
+    for (const step of steps) {
+        const res = await executeAction(step.ref, step.action, step.args ?? {});
+        effects.push(res.effect);
+        const stepBase = {
+            ref: res.ref,
+            action: res.action,
+            dispatched: res.dispatched,
+            settled: res.settled,
+            settleReason: res.settleReason,
+        };
+        if (res.testid !== undefined)
+            stepBase.testid = res.testid;
+        if (res.warning !== undefined)
+            stepBase.warning = res.warning;
+        stepResults.push(stepBase);
+    }
+    return { ok: true, count: steps.length, effects, steps: stepResults };
+}
+//# sourceMappingURL=actions.js.map

package/dist/actions/actions.js.map

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

package/dist/actions/scroll.d.ts

@@ -0,0 +1,19 @@
+/** Outcome of one container scroll — enough for the server to drive a find loop. */
+interface ScrollResult {
+    /** scrollTop actually moved (false ⇒ already at the end / not scrollable). */
+    scrolled: boolean;
+    scrollTop: number;
+    scrollHeight: number;
+    clientHeight: number;
+    /** At (or within 1px of) the bottom — no more rows to reveal by scrolling down. */
+    atEnd: boolean;
+}
+/**
+ * Scroll the container of `ref` (or the document) down by `dy` (default ~one viewport) so a
+ * virtualized list mounts its next window of rows. If `fraction` (0–1) is supplied, jumps
+ * directly to that fraction of scrollHeight instead of stepping — enables bisection for large
+ * lists where a specific row index is known (targetIndex / totalCount = fraction).
+ */
+export declare function scrollContainer(ref: string | undefined, dy: number | undefined, fraction?: number): ScrollResult;
+export {};
+//# sourceMappingURL=scroll.d.ts.map

package/dist/actions/scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.d.ts","sourceRoot":"","sources":["../../src/actions/scroll.ts"],"names":[],"mappings":"AAEA,oFAAoF;AACpF,UAAU,YAAY;IACpB,8EAA8E;IAC9E,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,KAAK,EAAE,OAAO,CAAC;CAChB;AAgBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,YAAY,CAwBd"}

package/dist/actions/scroll.js

@@ -0,0 +1,44 @@
+import { refs } from '../dom/refs.js';
+const FALLBACK_STEP_PX = 400;
+const VIEWPORT_FRACTION = 0.8;
+/** The nearest scrollable ancestor of `el` (inclusive), else the document scrolling element. */
+function nearestScrollable(el) {
+    let cur = el;
+    while (cur !== null && cur !== document.body) {
+        const oy = getComputedStyle(cur).overflowY;
+        if ((oy === 'auto' || oy === 'scroll') && cur.scrollHeight > cur.clientHeight)
+            return cur;
+        cur = cur.parentElement;
+    }
+    return document.scrollingElement ?? document.documentElement;
+}
+/**
+ * Scroll the container of `ref` (or the document) down by `dy` (default ~one viewport) so a
+ * virtualized list mounts its next window of rows. If `fraction` (0–1) is supplied, jumps
+ * directly to that fraction of scrollHeight instead of stepping — enables bisection for large
+ * lists where a specific row index is known (targetIndex / totalCount = fraction).
+ */
+export function scrollContainer(ref, dy, fraction) {
+    const base = ref !== undefined ? refs.resolve(ref) : null;
+    const target = base instanceof Element
+        ? nearestScrollable(base)
+        : (document.scrollingElement ?? document.documentElement);
+    const before = target.scrollTop;
+    if (fraction !== undefined && fraction >= 0 && fraction <= 1) {
+        target.scrollTop = Math.round(target.scrollHeight * fraction);
+    }
+    else {
+        const step = dy ?? (Math.round(target.clientHeight * VIEWPORT_FRACTION) || FALLBACK_STEP_PX);
+        target.scrollTop = before + step;
+    }
+    target.dispatchEvent(new Event('scroll', { bubbles: false }));
+    const after = target.scrollTop;
+    return {
+        scrolled: after !== before,
+        scrollTop: after,
+        scrollHeight: target.scrollHeight,
+        clientHeight: target.clientHeight,
+        atEnd: after + target.clientHeight >= target.scrollHeight - 1,
+    };
+}
+//# sourceMappingURL=scroll.js.map

package/dist/actions/scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.js","sourceRoot":"","sources":["../../src/actions/scroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAatC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,gGAAgG;AAChG,SAAS,iBAAiB,CAAC,EAAW;IACpC,IAAI,GAAG,GAAmB,EAAE,CAAC;IAC7B,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC7C,MAAM,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC;QAC3C,IAAI,CAAC,EAAE,KAAK,MAAM,IAAI,EAAE,KAAK,QAAQ,CAAC,IAAI,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY;YAAE,OAAO,GAAG,CAAC;QAC1F,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC;IAC1B,CAAC;IACD,OAAO,QAAQ,CAAC,gBAAgB,IAAI,QAAQ,CAAC,eAAe,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAuB,EACvB,EAAsB,EACtB,QAAiB;IAEjB,MAAM,IAAI,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,MAAM,MAAM,GACV,IAAI,YAAY,OAAO;QACrB,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC;QACzB,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,IAAI,QAAQ,CAAC,eAAe,CAAC,CAAC;IAE9D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC;IAChC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,GAAG,QAAQ,CAAC,CAAC;IAChE,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,GAAG,iBAAiB,CAAC,IAAI,gBAAgB,CAAC,CAAC;QAC7F,MAAM,CAAC,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;IACnC,CAAC;IACD,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC;IAE/B,OAAO;QACL,QAAQ,EAAE,KAAK,KAAK,MAAM;QAC1B,SAAS,EAAE,KAAK;QAChB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC;KAC9D,CAAC;AACJ,CAAC"}

package/dist/commands/commands.d.ts

@@ -0,0 +1,5 @@
+export type CommandHandler = (args: Record<string, unknown>) => unknown;
+export declare function resolveNavigationUrl(rawUrl: string, baseUrl: string): string | null;
+/** Map browser command names to handlers. Used by the transport on each COMMAND. */
+export declare function createCommandRegistry(): Map<string, CommandHandler>;
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands/commands.ts"],"names":[],"mappings":"AA+BA,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;AAsLxE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQnF;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CA2EnE"}