haltija 1.12.1 → 1.12.2

package/CHANGELOG.md

@@ -1,5 +1,91 @@
 # Changelog
 
+## 1.12.2
+
+Two fixes, both from an agent driving real apps. Each is a case where haltija reported success — or
+green health — while quietly producing something you couldn't trust, which is the same thread the
+1.12.x line has been pulling on throughout.
+
+**[#26](https://github.com/tonioloewald/haltija/issues/26) remains open and is NOT a 1.12.0
+regression.** The reporter's own control run settled it: the known-bad version survived the original
+failing surface through seven hard navigations plus an HMR rebuild. A tab becoming permanently
+undrivable was really observed, so the issue stays open as a standing record — but neither of us can
+currently reproduce it on any version, and nothing here claims to fix it.
+
+
+### `--private` instances get their own Electron profile — [#31](https://github.com/tonioloewald/haltija/issues/31)
+
+Private mode isolated ports, the registry, retirement and teardown — but **not the Electron
+profile**, so every instance ran with the same `--user-data-dir`. Chromium's single-instance locking
+means the second one to launch can't take the profile lock and falls back to caches it cannot
+persist, losing the HTTP cache and the V8 code cache. A large app bundle is then fully re-parsed on
+every navigation: **roughly 10x slower page boots**.
+
+The damage isn't the slowness, it's that it **lies in the one workflow private mode exists for**.
+Comparing two versions side by side, the failure followed **launch order, not version** — 22.1s vs
+2.04s, the same version passing or failing depending only on which started first, and each fine
+alone. The reporter nearly wrote up a version regression that did not exist. Every health signal
+read green throughout, including `hj doctor` and a measured 120fps rAF cadence, because nothing was
+broken — it was just slow.
+
+Each private instance now gets `<tmpdir>/haltija-private-<pid>` as its `userData` and `sessionData`,
+set before `app.whenReady()` and before anything reads `preferences.json`.
+
+Two related leaks closed at the same time, both cases of "private" having meant *private ports*
+rather than *touches nothing of yours*:
+
+- **A private run no longer writes `~/.haltija/last-quit`.** That marker tells `hj`'s auto-launch the
+  user deliberately quit, so an automated run ending was suppressing auto-launch for the interactive
+  app a developer was using.
+- **Stale private scratch is swept** at the start of the next private run — profiles and the
+  port-files the launcher writes (175 had accumulated on one machine). Swept at startup rather than
+  on exit because Chromium flushes its caches *after* `will-quit`, so deleting the profile there
+  just gets it recreated. The sweep keys on whether the owning pid is still alive and **never
+  touches a live peer** — `EPERM` from `kill(pid, 0)` counts as alive, since the process exists and
+  merely belongs to someone else. That decision is a tested function (`src/private-state.ts`), not a
+  loop in the launcher, because deleting a running instance's profile would be far worse than the
+  litter it tidies.
+
+### The test-suite runner gains `drag`, and a `wait` can no longer pass without waiting — [#30](https://github.com/tonioloewald/haltija/issues/30)
+
+**`drag` is now a step action.** `hj drag` and `POST /drag` had shipped for releases; the runner's
+dispatcher simply had no case, so a perfectly reasonable suite failed with `Unsupported step action:
+drag`. Sliders, resize handles and drag-reorder lists are exactly the interactions you cannot cover
+another way — a synthetic keydown on a slider thumb is not a faithful substitute.
+
+The routine now lives in `src/drag.ts` and both `/drag` and the runner call it. Dragging is not one
+message to the widget (scroll into view → measure → mouseenter/over/move → mousedown → N
+interpolated mousemoves → mouseup), and a second copy in the runner's switch would have been the
+fifth instance this cycle of one idea with two implementations.
+
+**A `wait` step with nothing to wait for was reported as PASSING.** `{"action": "wait",
+"forElement": "tbody tr", "timeout": 10000}` fell out of the runner's chain to `break`, and since a
+step passes by default it looked green — so a guard that had never waited for anything let every
+assertion after it race the page. Two fixes: `forElement` is now accepted as an alias of `selector`
+(the name `/wait` uses, and the name **our own SKILL.md example used**, which means the documented
+example never waited), and a `wait` carrying none of `duration`/`ms`/`selector`/`forElement`/
+`forWindow`/`url` is now an **error**.
+
+This is the same defect as the CLI's `hj wait --hidden`, fixed in 1.12.0 — that fix landed in the
+CLI and never reached the runner.
+
+**`hj test validate` now rejects illegal steps before the suite runs**, with a "did you mean":
+
+```
+step 0: unknown step action "drg" — did you mean "drag"?. Legal actions: navigate, click, …
+step 1: wait step has nothing to wait for — give it `duration` (ms), `selector` (or `forElement`) …
+```
+
+Validation previously checked only that selectors resolved, so `{"action": "drag"}` validated clean
+and then died in CI.
+
+**And the list is published and enforced.** There was nowhere to look up the legal actions: `hj api`
+documents the HTTP endpoints, which reads as though the same verbs work as steps. The canonical list
+is now `TEST_STEP_ACTIONS` in `src/test-actions.ts`, printed in `SKILL.md`, `CLAUDE.md` and
+`docs/CI-INTEGRATION.md` — and a test asserts it matches the runner's `switch (step.action)` in
+**both** directions. Writing that guard immediately found `screenshot` documented in `SKILL.md` as a
+step action when the runner has never had one.
+
 ## 1.12.1
 
 A patch of fixes reported by an agent driving a real React + web-components admin app against

package/apps/desktop/main.js

@@ -44,6 +44,44 @@ const IS_PRIVATE = process.env.HALTIJA_PRIVATE === '1'
 // consumer (e.g. a dev-server test lane) can drive this instance.
 const CALLER_PORT_FILE = IS_PRIVATE ? (process.env.HALTIJA_PORT_FILE || null) : null
 
+// A PRIVATE INSTANCE GETS ITS OWN ELECTRON PROFILE.
+//
+// Private mode isolated the ports, the registry, retirement and teardown — but not the profile, so
+// every instance ran with the same `--user-data-dir`. Chromium single-instance locking means the
+// second one to launch cannot take the profile lock and falls back to caches it cannot persist,
+// losing the HTTP cache and the V8 code cache. A large app bundle is then fully re-parsed on every
+// navigation: measured at roughly 10x slower page boots (issue #31).
+//
+// The damage is not just slowness, it is a LIE in the one workflow private mode exists for. Running
+// two versions side by side, the failure followed LAUNCH ORDER rather than version — 22.1s vs 2.04s,
+// and the same version passed or failed depending only on which started first. The reporter nearly
+// wrote up a version regression that did not exist. Every health signal read green throughout,
+// including `hj doctor` and a 120fps rAF cadence, because nothing was broken; it was just slow.
+//
+// Keyed on pid, not port: the private ports are ephemeral and not known yet at this point, and pid
+// is unique across concurrent runs by construction. Set BEFORE `app.whenReady()` and before
+// anything reads `app.getPath('userData')` (preferences.json does), or the isolation is partial —
+// which is how this bug existed at all.
+let PRIVATE_USER_DATA = null
+if (IS_PRIVATE) {
+  PRIVATE_USER_DATA = path.join(os.tmpdir(), `haltija-private-${process.pid}`)
+  try {
+    fs.mkdirSync(PRIVATE_USER_DATA, { recursive: true })
+    app.setPath('userData', PRIVATE_USER_DATA)
+    // Also keep the disk cache with it, so nothing is left in the shared profile.
+    app.setPath('sessionData', PRIVATE_USER_DATA)
+  } catch (err) {
+    // Falling back to the shared profile is slow and pollutes it, but it still WORKS — so say so
+    // loudly rather than refusing to start a run over a temp-directory failure.
+    console.error(
+      `[Haltija Desktop] Could not create a private profile at ${PRIVATE_USER_DATA}: ${err.message}. ` +
+        `Falling back to the shared profile — concurrent private instances will be slow and are ` +
+        `NOT safe to compare against each other (see issue #31).`,
+    )
+    PRIVATE_USER_DATA = null
+  }
+}
+
 // Haltija server config
 let HALTIJA_PORT = IS_PRIVATE ? 0 : parseInt(process.env.HALTIJA_PORT || '8700')
 let HALTIJA_SERVER = `http://localhost:${HALTIJA_PORT}`
@@ -1694,11 +1732,24 @@ if (!gotTheLock) {
     }
     // Drop a marker so hj's auto-launch knows the user explicitly quit.
     // Cleared next time the user manually starts Haltija.
-    try {
-      const dir = path.join(os.homedir(), '.haltija')
-      fs.mkdirSync(dir, { recursive: true })
-      fs.writeFileSync(path.join(dir, 'last-quit'), String(Date.now()))
-    } catch {}
+    //
+    // NOT in private mode: `~/.haltija/last-quit` is SHARED state, and an automated run ending is
+    // not the user quitting anything. Writing it suppressed auto-launch for the interactive app the
+    // developer is actually using — the same class as the profile sharing above (#31), where
+    // "private" turned out to mean "private ports" rather than "touches nothing of yours".
+    if (!IS_PRIVATE) {
+      try {
+        const dir = path.join(os.homedir(), '.haltija')
+        fs.mkdirSync(dir, { recursive: true })
+        fs.writeFileSync(path.join(dir, 'last-quit'), String(Date.now()))
+      } catch {}
+    }
+
+    // NOTE: the private profile is deliberately NOT deleted here. Chromium flushes its caches
+    // AFTER 'will-quit', so removing the directory at this point just gets it recreated — measured:
+    // both dirs survived a clean shutdown. Stale profiles are swept at the START of the next
+    // private run instead (see sweepStalePrivateState in bin/tosijs-dev.mjs), keyed on whether the
+    // owning pid is still alive, which is immune to shutdown ordering.
   })
 
   // Handle certificate errors (for self-signed certs in dev)

package/apps/desktop/package.json

@@ -1,6 +1,6 @@
 {
   "name": "haltija-desktop",
-  "version": "1.12.1",
+  "version": "1.12.2",
   "private": true,
   "description": "Haltija Desktop - God Mode Browser for AI Agents",
   "homepage": "https://github.com/tonioloewald/haltija",

package/apps/desktop/resources/component.js

@@ -46,7 +46,7 @@
   });
 
   // src/version.ts
-  var VERSION = "1.12.1";
+  var VERSION = "1.12.2";
 
   // src/text-selector.ts
   var TEXT_PSEUDO_RE = /:(?:text-is|has-text|text)\(/;

package/bin/private-state.mjs

@@ -0,0 +1,29 @@
+/** ⚠️  AUTO-GENERATED FROM src/private-state.ts — DO NOT EDIT. Run: bun run build */
+// src/private-state.ts
+function stalePrivateEntries(names, deps) {
+  const out = [];
+  for (const name of names) {
+    const m = /^haltija-private-(\d+)(\.json)?$/.exec(name);
+    if (!m)
+      continue;
+    const pid = parseInt(m[1], 10);
+    if (!pid || pid === deps.selfPid)
+      continue;
+    if (deps.isAlive(pid))
+      continue;
+    out.push(name);
+  }
+  return out;
+}
+function pidIsAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (err) {
+    return err?.code === "EPERM";
+  }
+}
+export {
+  stalePrivateEntries,
+  pidIsAlive
+};

package/bin/tosijs-dev.mjs

@@ -13,10 +13,11 @@
  */
 
 import { spawn, execSync as execSyncImported } from 'child_process'
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs'
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, rmSync } from 'fs'
 import { homedir, platform, tmpdir } from 'os'
 import { fileURLToPath } from 'url'
 import { dirname, join } from 'path'
+import { stalePrivateEntries, pidIsAlive } from './private-state.mjs'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const serverPath = join(__dirname, '../dist/server.js')
@@ -452,8 +453,45 @@ if (privateMode) {
     ? args[portFileIdx + 1]
     : join(tmpdir(), `haltija-private-${process.pid}.json`)
   env.HALTIJA_PORT_FILE = privatePortFile
+  sweepStalePrivateState()
 }
 
+/**
+ * Remove the scratch left by private runs that are no longer alive.
+ *
+ * Two kinds accumulate in tmpdir, both named `haltija-private-<pid>`:
+ *   - the port-file (`<pid>.json`) this launcher writes
+ *   - the Electron profile directory (issue #31), several MB of cache per run
+ *
+ * Swept at STARTUP rather than on exit because Chromium flushes its caches AFTER Electron's
+ * 'will-quit' fires — deleting the profile there simply gets it recreated, which is what happened
+ * when this was first written that way. Liveness of the owning pid is the test, so a sweep can
+ * never touch a concurrent run: the whole point of private mode is that instances don't interfere,
+ * and a cleanup that deletes a live peer's profile would be a far worse bug than the litter.
+ *
+ * Runs for `--private --headless` too, since the launcher is common to both.
+ */
+function sweepStalePrivateState() {
+  const dir = tmpdir()
+  let entries
+  try {
+    entries = readdirSync(dir)
+  } catch {
+    return
+  }
+  // The decision lives in src/private-state.ts and is unit-tested: never sweep a live peer, never
+  // sweep ourselves, and treat EPERM from kill(pid,0) as ALIVE (the process exists, it is just not
+  // ours to signal). Getting that backwards would delete another user's running instance.
+  for (const name of stalePrivateEntries(entries, { selfPid: process.pid, isAlive: pidIsAlive })) {
+    try {
+      rmSync(join(dir, name), { recursive: true, force: true })
+    } catch {
+      // Best effort — the OS reaps tmpdir eventually, and failing to tidy must never stop a run.
+    }
+  }
+}
+
+
 /** Poll the private instance's port-file until it reports its ephemeral port. */
 /**
  * Wait for a private instance to report its ephemeral port. 30s because this may be waiting on a

package/bin/version.mjs

@@ -3,4 +3,4 @@
  * ⚠️  To change the version, update package.json and run: bun run build
  */
 
-export const HJ_VERSION = '1.12.1'
+export const HJ_VERSION = '1.12.2'

package/dist/api-schema.d.ts

@@ -68,30 +68,30 @@ export declare const tree: EndpointDef<{
     window?: string | undefined;
 }>;
 export declare const query: EndpointDef<{
-    selector?: string | undefined;
     ref?: string | undefined;
+    selector?: string | undefined;
     all?: boolean | undefined;
 }>;
 export declare const inspect: EndpointDef<{
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     fullStyles?: boolean | undefined;
     matchedRules?: boolean | undefined;
 }>;
 export declare const inspectAll: EndpointDef<{
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     fullStyles?: boolean | undefined;
     matchedRules?: boolean | undefined;
     limit?: number | undefined;
 }>;
 export declare const click: EndpointDef<{
     text?: string | undefined;
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     tag?: string | undefined;
     autoWait?: boolean | undefined;
     timeout?: number | undefined;
@@ -99,9 +99,9 @@ export declare const click: EndpointDef<{
     diffDelay?: number | undefined;
 }>;
 export declare const type: EndpointDef<{
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     autoWait?: boolean | undefined;
     timeout?: number | undefined;
     diff?: boolean | undefined;
@@ -117,9 +117,9 @@ export declare const type: EndpointDef<{
 }>;
 export declare const key: EndpointDef<{
     repeat?: number | undefined;
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     ctrlKey?: boolean | undefined;
     shiftKey?: boolean | undefined;
     altKey?: boolean | undefined;
@@ -128,30 +128,30 @@ export declare const key: EndpointDef<{
 }>;
 export declare const drag: EndpointDef<{
     duration?: number | undefined;
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     deltaX?: number | undefined;
     deltaY?: number | undefined;
 }>;
 export declare const highlight: EndpointDef<{
     duration?: number | undefined;
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     label?: string | undefined;
     color?: string | undefined;
 }>;
 export declare const unhighlight: EndpointDef<{}>;
 export declare const scroll: EndpointDef<{
     duration?: number | undefined;
+    ref?: string | undefined;
     selector?: string | undefined;
+    x?: number | undefined;
+    y?: number | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     deltaX?: number | undefined;
     deltaY?: number | undefined;
-    x?: number | undefined;
-    y?: number | undefined;
     easing?: string | undefined;
     block?: string | undefined;
 }>;
@@ -226,16 +226,16 @@ export declare const fetchUrl: EndpointDef<{
     url: string;
 }>;
 export declare const call: EndpointDef<{
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     args?: any[] | undefined;
     method: string;
 }>;
 export declare const screenshot: EndpointDef<{
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     delay?: number | undefined;
     canvas?: string | undefined;
     format?: string | undefined;
@@ -293,8 +293,8 @@ export declare const recordingStart: EndpointDef<{
 export declare const recordingStop: EndpointDef<{}>;
 export declare const recordingGenerate: EndpointDef<{
     url?: string | undefined;
-    minDelay?: number | undefined;
     events?: any[] | undefined;
+    minDelay?: number | undefined;
     name?: string | undefined;
     since?: number | undefined;
     description?: string | undefined;
@@ -388,21 +388,21 @@ export declare const endpoints: {
         window?: string | undefined;
     }>;
     readonly query: EndpointDef<{
-        selector?: string | undefined;
         ref?: string | undefined;
+        selector?: string | undefined;
         all?: boolean | undefined;
     }>;
     readonly inspect: EndpointDef<{
+        ref?: string | undefined;
         selector?: string | undefined;
         window?: string | undefined;
-        ref?: string | undefined;
         fullStyles?: boolean | undefined;
         matchedRules?: boolean | undefined;
     }>;
     readonly inspectAll: EndpointDef<{
+        ref?: string | undefined;
         selector?: string | undefined;
         window?: string | undefined;
-        ref?: string | undefined;
         fullStyles?: boolean | undefined;
         matchedRules?: boolean | undefined;
         limit?: number | undefined;
@@ -423,9 +423,9 @@ export declare const endpoints: {
     }>;
     readonly click: EndpointDef<{
         text?: string | undefined;
+        ref?: string | undefined;
         selector?: string | undefined;
         window?: string | undefined;
-        ref?: string | undefined;
         tag?: string | undefined;
         autoWait?: boolean | undefined;
         timeout?: number | undefined;
@@ -433,9 +433,9 @@ export declare const endpoints: {
         diffDelay?: number | undefined;
     }>;
     readonly type: EndpointDef<{
+        ref?: string | undefined;
         selector?: string | undefined;
         window?: string | undefined;
-        ref?: string | undefined;
         autoWait?: boolean | undefined;
         timeout?: number | undefined;
         diff?: boolean | undefined;
@@ -451,9 +451,9 @@ export declare const endpoints: {
     }>;
     readonly key: EndpointDef<{
         repeat?: number | undefined;
+        ref?: string | undefined;
         selector?: string | undefined;
         window?: string | undefined;
-        ref?: string | undefined;
         ctrlKey?: boolean | undefined;
         shiftKey?: boolean | undefined;
         altKey?: boolean | undefined;
@@ -462,30 +462,30 @@ export declare const endpoints: {
     }>;
     readonly drag: EndpointDef<{
         duration?: number | undefined;
+        ref?: string | undefined;
         selector?: string | undefined;
         window?: string | undefined;
-        ref?: string | undefined;
         deltaX?: number | undefined;
         deltaY?: number | undefined;
     }>;
     readonly highlight: EndpointDef<{
         duration?: number | undefined;
+        ref?: string | undefined;
         selector?: string | undefined;
         window?: string | undefined;
-        ref?: string | undefined;
         label?: string | undefined;
         color?: string | undefined;
     }>;
     readonly unhighlight: EndpointDef<{}>;
     readonly scroll: EndpointDef<{
         duration?: number | undefined;
+        ref?: string | undefined;
         selector?: string | undefined;
+        x?: number | undefined;
+        y?: number | undefined;
         window?: string | undefined;
-        ref?: string | undefined;
         deltaX?: number | undefined;
         deltaY?: number | undefined;
-        x?: number | undefined;
-        y?: number | undefined;
         easing?: string | undefined;
         block?: string | undefined;
     }>;
@@ -546,16 +546,16 @@ export declare const endpoints: {
         url: string;
     }>;
     readonly call: EndpointDef<{
+        ref?: string | undefined;
         selector?: string | undefined;
         window?: string | undefined;
-        ref?: string | undefined;
         args?: any[] | undefined;
         method: string;
     }>;
     readonly screenshot: EndpointDef<{
+        ref?: string | undefined;
         selector?: string | undefined;
         window?: string | undefined;
-        ref?: string | undefined;
         delay?: number | undefined;
         canvas?: string | undefined;
         format?: string | undefined;
@@ -613,8 +613,8 @@ export declare const endpoints: {
     readonly recordingStop: EndpointDef<{}>;
     readonly recordingGenerate: EndpointDef<{
         url?: string | undefined;
-        minDelay?: number | undefined;
         events?: any[] | undefined;
+        minDelay?: number | undefined;
         name?: string | undefined;
         since?: number | undefined;
         description?: string | undefined;
@@ -707,36 +707,36 @@ export declare const ALL_ENDPOINTS: (EndpointDef<{
     mode?: string | undefined;
     window?: string | undefined;
 }> | EndpointDef<{
-    selector?: string | undefined;
     ref?: string | undefined;
+    selector?: string | undefined;
     all?: boolean | undefined;
 }> | EndpointDef<{
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     fullStyles?: boolean | undefined;
     matchedRules?: boolean | undefined;
 }> | EndpointDef<{
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     fullStyles?: boolean | undefined;
     matchedRules?: boolean | undefined;
     limit?: number | undefined;
 }> | EndpointDef<{
     text?: string | undefined;
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     tag?: string | undefined;
     autoWait?: boolean | undefined;
     timeout?: number | undefined;
     diff?: boolean | undefined;
     diffDelay?: number | undefined;
 }> | EndpointDef<{
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     autoWait?: boolean | undefined;
     timeout?: number | undefined;
     diff?: boolean | undefined;
@@ -751,9 +751,9 @@ export declare const ALL_ENDPOINTS: (EndpointDef<{
     text: string;
 }> | EndpointDef<{
     repeat?: number | undefined;
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     ctrlKey?: boolean | undefined;
     shiftKey?: boolean | undefined;
     altKey?: boolean | undefined;
@@ -761,27 +761,27 @@ export declare const ALL_ENDPOINTS: (EndpointDef<{
     key: string;
 }> | EndpointDef<{
     duration?: number | undefined;
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     deltaX?: number | undefined;
     deltaY?: number | undefined;
 }> | EndpointDef<{
     duration?: number | undefined;
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     label?: string | undefined;
     color?: string | undefined;
 }> | EndpointDef<{}> | EndpointDef<{
     duration?: number | undefined;
+    ref?: string | undefined;
     selector?: string | undefined;
+    x?: number | undefined;
+    y?: number | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     deltaX?: number | undefined;
     deltaY?: number | undefined;
-    x?: number | undefined;
-    y?: number | undefined;
     easing?: string | undefined;
     block?: string | undefined;
 }> | EndpointDef<{
@@ -835,15 +835,15 @@ export declare const ALL_ENDPOINTS: (EndpointDef<{
     window?: string | undefined;
     url: string;
 }> | EndpointDef<{
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     args?: any[] | undefined;
     method: string;
 }> | EndpointDef<{
+    ref?: string | undefined;
     selector?: string | undefined;
     window?: string | undefined;
-    ref?: string | undefined;
     delay?: number | undefined;
     canvas?: string | undefined;
     format?: string | undefined;
@@ -886,8 +886,8 @@ export declare const ALL_ENDPOINTS: (EndpointDef<{
     name?: string | undefined;
 }> | EndpointDef<{}> | EndpointDef<{
     url?: string | undefined;
-    minDelay?: number | undefined;
     events?: any[] | undefined;
+    minDelay?: number | undefined;
     name?: string | undefined;
     since?: number | undefined;
     description?: string | undefined;

package/dist/component.d.ts

@@ -20,7 +20,7 @@
  * - Option+Tab toggles visibility (but active state always shows briefly)
  * - Localhost only by default
  */
-export declare const VERSION = "1.12.1";
+export declare const VERSION = "1.12.2";
 export declare class DevChannel extends HTMLElement {
     static get tagName(): string;
     static elementCreator(): () => DevChannel;

package/dist/component.esm.js

@@ -1,5 +1,5 @@
 // src/version.ts
-var VERSION = "1.12.1";
+var VERSION = "1.12.2";
 
 // src/text-selector.ts
 var TEXT_PSEUDO_RE = /:(?:text-is|has-text|text)\(/;

package/dist/component.js

@@ -46,7 +46,7 @@
   });
 
   // src/version.ts
-  var VERSION = "1.12.1";
+  var VERSION = "1.12.2";
 
   // src/text-selector.ts
   var TEXT_PSEUDO_RE = /:(?:text-is|has-text|text)\(/;