From 3e9f0b9367a2fb2c42b0bfaa1161a56dc157470d Mon Sep 17 00:00:00 2001
From: PJ <ipriyanshujain@gmail.com>
Date: Mon, 1 Jun 2026 16:13:53 +0530
Subject: [PATCH] test(spec): verb matrix and warn-once semantics

---
 pkg/spec/test/verbs.test.ts | 72 +++++++++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 pkg/spec/test/verbs.test.ts

diff --git a/pkg/spec/test/verbs.test.ts b/pkg/spec/test/verbs.test.ts
new file mode 100644
index 0000000..9187a6c
--- /dev/null
+++ b/pkg/spec/test/verbs.test.ts
@@ -0,0 +1,72 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { supports, warnUnsupportedOnce, resetWarnings } from "../src/verbs.ts";
+import type { BuiltinVerb, Host } from "../src/action-tree.ts";
+
+const ALL_VERBS: BuiltinVerb[] = [
+  "taps",
+  "doubleTaps",
+  "longPresses",
+  "scrolls",
+  "typing",
+  "swipes",
+  "waitOnce",
+  "pressKeys",
+];
+
+function countingHost(platform: "android" | "ios" | "web"): Host & { calls: BuiltinVerb[] } {
+  const calls: BuiltinVerb[] = [];
+  return {
+    calls,
+    platform: () => platform,
+    queryCandidates: () => [],
+    reportUnsupported: (verb) => {
+      calls.push(verb);
+    },
+    seedHi: () => 0n,
+    seedLo: () => 0n,
+  };
+}
+
+test("every verb is supported on native platforms", () => {
+  for (const verb of ALL_VERBS) {
+    assert.equal(supports(verb, "android"), true, `android ${verb}`);
+    assert.equal(supports(verb, "ios"), true, `ios ${verb}`);
+  }
+});
+
+test("web supports the full builtin verb set (declared, not silently no-op)", () => {
+  for (const verb of ALL_VERBS) {
+    assert.equal(supports(verb, "web"), true, `web ${verb}`);
+  }
+});
+
+test("warn-once reports a verb exactly once per platform", () => {
+  resetWarnings();
+  const host = countingHost("web");
+  assert.equal(warnUnsupportedOnce(host, "swipes"), true);
+  assert.equal(warnUnsupportedOnce(host, "swipes"), false);
+  assert.equal(warnUnsupportedOnce(host, "swipes"), false);
+  assert.deepEqual(host.calls, ["swipes"]);
+});
+
+test("warn-once keys by verb@platform independently", () => {
+  resetWarnings();
+  const web = countingHost("web");
+  const android = countingHost("android");
+  warnUnsupportedOnce(web, "scrolls");
+  warnUnsupportedOnce(android, "scrolls");
+  warnUnsupportedOnce(web, "scrolls");
+  // Same verb on two platforms: one report each, suppressed on repeat.
+  assert.deepEqual(web.calls, ["scrolls"]);
+  assert.deepEqual(android.calls, ["scrolls"]);
+});
+
+test("resetWarnings re-arms reporting", () => {
+  resetWarnings();
+  const host = countingHost("web");
+  warnUnsupportedOnce(host, "longPresses");
+  resetWarnings();
+  warnUnsupportedOnce(host, "longPresses");
+  assert.deepEqual(host.calls, ["longPresses", "longPresses"]);
+});