verikun 0.4.1

package/dist/ui/selector.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSelector = parseSelector;
+exports.matchElements = matchElements;
+exports.resolveOne = resolveOne;
+const errors_1 = require("../errors");
+const format_1 = require("./format");
+function parseSelector(raw, opts = {}) {
+    let kind = 'text';
+    let value = raw;
+    if (raw.startsWith('@')) {
+        kind = 'id';
+        value = raw.slice(1);
+    }
+    else {
+        const m = /^(id|text|desc|class):([\s\S]*)$/.exec(raw);
+        if (m) {
+            kind = m[1];
+            value = m[2];
+        }
+    }
+    if (!value)
+        throw new errors_1.CliError(`Empty selector value in '${raw}'`, 2);
+    return { kind, value, contains: !!opts.contains, index: opts.index, raw };
+}
+const norm = (s) => s.trim().toLowerCase();
+const strip = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, '');
+/** The ordered match tiers for a selector. First tier with a hit wins. */
+function tiers(sel) {
+    const nv = norm(sel.value);
+    const sv = strip(sel.value);
+    // exact -> partial -> normalized over a single text-like field.
+    const textField = (get) => [
+        { tier: 'exact', test: (el) => norm(get(el)) === nv },
+        { tier: 'partial', test: (el) => nv.length > 0 && norm(get(el)).includes(nv) },
+        { tier: 'normalized', test: (el) => sv.length > 0 && strip(get(el)).includes(sv) },
+    ];
+    let list;
+    switch (sel.kind) {
+        case 'id':
+            list = [
+                {
+                    tier: 'exact',
+                    test: (el) => norm(el.idShort) === nv || norm(el.id) === nv || norm(el.id).endsWith('/' + nv),
+                },
+                {
+                    tier: 'partial',
+                    test: (el) => nv.length > 0 && (norm(el.idShort).includes(nv) || norm(el.id).includes(nv)),
+                },
+                {
+                    tier: 'normalized',
+                    test: (el) => sv.length > 0 && (strip(el.idShort).includes(sv) || strip(el.id).includes(sv)),
+                },
+            ];
+            break;
+        case 'class':
+            list = [
+                {
+                    tier: 'exact',
+                    test: (el) => norm(el.type) === nv || norm(el.class) === nv || norm(el.class).endsWith('.' + nv),
+                },
+                {
+                    tier: 'partial',
+                    test: (el) => nv.length > 0 && (norm(el.type).includes(nv) || norm(el.class).includes(nv)),
+                },
+            ];
+            break;
+        case 'desc':
+            list = textField((el) => el.desc);
+            break;
+        case 'text':
+        default:
+            list = textField((el) => el.text);
+            break;
+    }
+    // --contains forces substring matching: drop the exact-only tier.
+    return sel.contains ? list.filter((t) => t.tier !== 'exact') : list;
+}
+function matchElements(elements, sel) {
+    for (const { tier, test } of tiers(sel)) {
+        const found = elements.filter(test);
+        if (found.length === 0)
+            continue;
+        if (sel.index !== undefined) {
+            const picked = found[sel.index];
+            return picked ? { matches: [picked], tier } : { matches: [], tier: null };
+        }
+        return { matches: found, tier };
+    }
+    // For text: selectors, if no text matches found, fall back to desc
+    if (sel.kind === 'text') {
+        const descSel = { ...sel, kind: 'desc' };
+        for (const { tier, test } of tiers(descSel)) {
+            const found = elements.filter(test);
+            if (found.length === 0)
+                continue;
+            if (sel.index !== undefined) {
+                const picked = found[sel.index];
+                return picked ? { matches: [picked], tier } : { matches: [], tier: null };
+            }
+            return { matches: found, tier };
+        }
+    }
+    return { matches: [], tier: null };
+}
+/** Resolve to exactly one element (with the tier it matched), or throw. */
+function resolveOne(elements, sel) {
+    const { matches, tier } = matchElements(elements, sel);
+    if (matches.length === 0) {
+        throw new errors_1.SelectorNotFoundError(`No element matched selector '${sel.raw}'. Run \`verikun ui\` to inspect the current screen.`);
+    }
+    if (matches.length > 1) {
+        const list = matches.map((m) => '  ' + (0, format_1.formatInline)(m)).join('\n');
+        throw new errors_1.AmbiguousSelectorError(`Selector '${sel.raw}' matched ${matches.length} elements; refine it or add --index N:\n${list}`, matches);
+    }
+    return { element: matches[0], tier: tier };
+}

package/dist/version.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+// GENERATED by scripts/gen-version.mjs from package.json's "version" at build time
+// (the `prebuild` script). Do NOT edit by hand; bump package.json instead.
+exports.VERSION = '0.4.1';

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "verikun",
+  "version": "0.4.1",
+  "description": "Drive Android emulators/devices (and later iOS simulators) for AI agents: tap, type, swipe, screenshot, and inspect the UI hierarchy by semantic identifiers — like Puppeteer for native apps.",
+  "keywords": [
+    "android",
+    "adb",
+    "ios",
+    "simulator",
+    "ui-automation",
+    "testing",
+    "puppeteer",
+    "ai-agent"
+  ],
+  "homepage": "https://github.com/ddikman/verikun#readme",
+  "bugs": {
+    "url": "https://github.com/ddikman/verikun/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ddikman/verikun.git"
+  },
+  "author": "David Dikman <ddikman@gmail.com>",
+  "bin": {
+    "verikun": "dist/bin/verikun.js",
+    "vk": "dist/bin/verikun.js"
+  },
+  "main": "dist/cli.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prebuild": "node scripts/gen-version.mjs",
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "verikun": "node dist/bin/verikun.js",
+    "test": "tsc -p tsconfig.test.json && node --test --test-reporter=spec .test-build/tests/*.test.js",
+    "test:ci": "mkdir -p test-results && tsc -p tsconfig.test.json && node --test --test-reporter=spec --test-reporter-destination=stdout --test-reporter=./scripts/github-test-summary.mjs --test-reporter-destination=test-results/summary.md .test-build/tests/*.test.js",
+    "test:watch": "tsc -p tsconfig.test.json && node --test --watch --test-reporter=spec .test-build/tests/*.test.js",
+    "prepare": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.4.0"
+  }
+}