@goliapkg/smix 0.1.0

package/src/__tests__/Locator.test.ts

@@ -0,0 +1,128 @@
+// v7.5 c3 — Locator poll loop tests, mirror Kotlin LocatorMockTest +
+// Swift LocatorMockTests.
+
+import { describe, expect, test } from 'vitest'
+import {
+  bundleId,
+  ExpectationFailure,
+  literal,
+  MockSelectorResolver,
+  MockSimRuntime,
+  Selector,
+  Smix,
+  type A11yNode,
+} from '../index.js'
+
+describe('Locator.toBeVisible', () => {
+  test('succeeds when initially visible', async () => {
+    const node: A11yNode = {
+      rawType: 'button',
+      identifier: 'btn-x',
+      label: 'x',
+      bounds: { x: 0, y: 0, w: 10, h: 10 },
+      visible: true,
+    }
+    const tree: A11yNode = {
+      rawType: 'other',
+      bounds: { x: 0, y: 0, w: 100, h: 100 },
+      visible: true,
+      children: [node],
+    }
+    const runtime = new MockSimRuntime({ snapshotResult: tree })
+    const resolver = new MockSelectorResolver()
+    resolver.registerHit('{"id":"btn-x"}', 'btn-x')
+    const app = await Smix.launchApp(bundleId('dev.smix.fixture'), runtime, resolver.resolve)
+    await app.find(Selector.id('btn-x')).toBeVisible({ timeoutMs: 500 })
+  })
+
+  test('timeout when never matches', async () => {
+    const tree: A11yNode = {
+      rawType: 'other',
+      bounds: { x: 0, y: 0, w: 100, h: 100 },
+      visible: true,
+      children: [],
+    }
+    const runtime = new MockSimRuntime({ snapshotResult: tree })
+    const resolver = new MockSelectorResolver()
+    const app = await Smix.launchApp(bundleId('dev.smix.fixture'), runtime, resolver.resolve)
+    await expect(
+      app.find(Selector.id('btn-missing')).toBeVisible({ timeoutMs: 300 }),
+    ).rejects.toMatchObject({
+      name: 'ExpectationFailure',
+      code: 'timeout',
+    })
+  })
+
+  test('wrongState when matched but hidden', async () => {
+    const node: A11yNode = {
+      rawType: 'button',
+      identifier: 'btn-y',
+      label: 'y',
+      bounds: { x: 0, y: 0, w: 10, h: 10 },
+      visible: false,
+    }
+    const tree: A11yNode = {
+      rawType: 'other',
+      bounds: { x: 0, y: 0, w: 100, h: 100 },
+      visible: true,
+      children: [node],
+    }
+    const runtime = new MockSimRuntime({ snapshotResult: tree })
+    const resolver = new MockSelectorResolver()
+    resolver.registerHit('{"id":"btn-y"}', 'btn-y')
+    const app = await Smix.launchApp(bundleId('dev.smix.fixture'), runtime, resolver.resolve)
+    await expect(
+      app.find(Selector.id('btn-y')).toBeVisible({ timeoutMs: 200 }),
+    ).rejects.toMatchObject({
+      name: 'ExpectationFailure',
+      code: 'wrongState',
+    })
+  })
+})
+
+describe('Locator.toContainText', () => {
+  test('succeeds when label matches', async () => {
+    const node: A11yNode = {
+      rawType: 'staticText',
+      identifier: 'msg',
+      label: 'Welcome back, Alice!',
+      bounds: { x: 0, y: 0, w: 100, h: 24 },
+      visible: true,
+    }
+    const tree: A11yNode = {
+      rawType: 'other',
+      bounds: { x: 0, y: 0, w: 100, h: 100 },
+      children: [node],
+    }
+    const runtime = new MockSimRuntime({ snapshotResult: tree })
+    const resolver = new MockSelectorResolver()
+    resolver.registerHit('{"id":"msg"}', 'msg')
+    const app = await Smix.launchApp(bundleId('dev.smix.fixture'), runtime, resolver.resolve)
+    await app.find(Selector.id('msg')).toContainText('Alice', { timeoutMs: 500 })
+  })
+
+  test('timeout when never matches', async () => {
+    const node: A11yNode = {
+      rawType: 'staticText',
+      identifier: 'msg',
+      label: 'Hello, World',
+      bounds: { x: 0, y: 0, w: 100, h: 24 },
+      visible: true,
+    }
+    const tree: A11yNode = {
+      rawType: 'other',
+      bounds: { x: 0, y: 0, w: 100, h: 100 },
+      children: [node],
+    }
+    const runtime = new MockSimRuntime({ snapshotResult: tree })
+    const resolver = new MockSelectorResolver()
+    resolver.registerHit('{"id":"msg"}', 'msg')
+    const app = await Smix.launchApp(bundleId('dev.smix.fixture'), runtime, resolver.resolve)
+    await expect(
+      app.find(Selector.id('msg')).toContainText('Goodbye', { timeoutMs: 200 }),
+    ).rejects.toMatchObject({ code: 'timeout' })
+  })
+})
+
+// v7.6 c1 update: toHaveLabel + toHaveCount stubs replaced — see
+// LocatorToHave.test.ts for the c1 replacement tests.

package/src/__tests__/LocatorToHave.test.ts

@@ -0,0 +1,118 @@
+// v7.6 c1 — Locator.toHaveCount + toHaveLabel mock-based vitest tests.
+
+import { describe, expect, test } from 'vitest'
+import {
+  bundleId,
+  literal,
+  MockLabelsResolver,
+  MockSelectorResolver,
+  MockSimRuntime,
+  Selector,
+  Smix,
+  type A11yNode,
+} from '../index.js'
+
+describe('Locator.toHaveCount', () => {
+  test('succeeds when match count equals expected', async () => {
+    const tree: A11yNode = {
+      rawType: 'other',
+      bounds: { x: 0, y: 0, w: 100, h: 100 },
+      visible: true,
+      children: [],
+    }
+    const runtime = new MockSimRuntime({ snapshotResult: tree })
+    const resolver = new MockSelectorResolver()
+    const labelsResolver = new MockLabelsResolver()
+    labelsResolver.registerLabels('{"label":"Item"}', ['Item', 'Item', 'Item'])
+    const app = await Smix.launchApp(
+      bundleId('dev.smix.fixture'),
+      runtime,
+      resolver.resolve,
+      labelsResolver.resolve,
+    )
+    await app.find(Selector.label('Item')).toHaveCount(3, { timeoutMs: 500 })
+  })
+
+  test('throws wrongState when count mismatch', async () => {
+    const tree: A11yNode = {
+      rawType: 'other',
+      bounds: { x: 0, y: 0, w: 100, h: 100 },
+      visible: true,
+      children: [],
+    }
+    const runtime = new MockSimRuntime({ snapshotResult: tree })
+    const resolver = new MockSelectorResolver()
+    const labelsResolver = new MockLabelsResolver()
+    labelsResolver.registerLabels('{"label":"Item"}', ['Item'])  // 1 match, expect 3
+    const app = await Smix.launchApp(
+      bundleId('dev.smix.fixture'),
+      runtime,
+      resolver.resolve,
+      labelsResolver.resolve,
+    )
+    await expect(
+      app.find(Selector.label('Item')).toHaveCount(3, { timeoutMs: 200 }),
+    ).rejects.toMatchObject({
+      name: 'ExpectationFailure',
+      code: 'wrongState',
+    })
+  })
+})
+
+describe('Locator.toHaveLabel', () => {
+  test('succeeds when matched node label equals expected', async () => {
+    const node: A11yNode = {
+      rawType: 'button',
+      identifier: 'btn-x',
+      label: 'Submit',
+      bounds: { x: 0, y: 0, w: 10, h: 10 },
+      visible: true,
+    }
+    const tree: A11yNode = {
+      rawType: 'other',
+      bounds: { x: 0, y: 0, w: 100, h: 100 },
+      visible: true,
+      children: [node],
+    }
+    const runtime = new MockSimRuntime({ snapshotResult: tree })
+    const resolver = new MockSelectorResolver()
+    resolver.registerHit('{"id":"btn-x"}', 'btn-x')
+    const app = await Smix.launchApp(
+      bundleId('dev.smix.fixture'),
+      runtime,
+      resolver.resolve,
+      new MockLabelsResolver().resolve,
+    )
+    await app.find(Selector.id('btn-x')).toHaveLabel('Submit', { timeoutMs: 500 })
+  })
+
+  test('timeout when label never matches', async () => {
+    const node: A11yNode = {
+      rawType: 'button',
+      identifier: 'btn-x',
+      label: 'Cancel',
+      bounds: { x: 0, y: 0, w: 10, h: 10 },
+      visible: true,
+    }
+    const tree: A11yNode = {
+      rawType: 'other',
+      bounds: { x: 0, y: 0, w: 100, h: 100 },
+      visible: true,
+      children: [node],
+    }
+    const runtime = new MockSimRuntime({ snapshotResult: tree })
+    const resolver = new MockSelectorResolver()
+    resolver.registerHit('{"id":"btn-x"}', 'btn-x')
+    const app = await Smix.launchApp(
+      bundleId('dev.smix.fixture'),
+      runtime,
+      resolver.resolve,
+      new MockLabelsResolver().resolve,
+    )
+    await expect(
+      app.find(Selector.id('btn-x')).toHaveLabel('Submit', { timeoutMs: 200 }),
+    ).rejects.toMatchObject({
+      code: 'timeout',
+    })
+  })
+})

package/src/__tests__/MvpApiShape.test.ts

@@ -0,0 +1,117 @@
+// v7.5 c1 — MVP shape JVM vitest tests.
+//
+// Mirror Kotlin MvpApiShapeTest + Swift MvpApiShapeTests. Verifies
+// the SDK exposes the right TypeScript types + constructors and that
+// stub surface throws SmixNotImplementedError with explicit stage
+// markers.
+
+import { describe, expect, test } from 'vitest'
+import {
+  App,
+  ExpectationFailure,
+  FAILURE_CODES,
+  literal,
+  MockSelectorResolver,
+  MockSimRuntime,
+  Selector,
+  Smix,
+  SmixNotImplementedError,
+  appPath,
+  bundleId,
+  type A11yRole,
+  type FailureCode,
+} from '../index.js'
+
+describe('Selector base cases', () => {
+  test('selector base cases exhaustive', () => {
+    const cases: Selector[] = [
+      Selector.id('btn-login'),
+      Selector.text(literal('Sign In')),
+      Selector.label('Settings'),
+      Selector.role('button'),
+      Selector.role('button', literal('Submit')),
+    ]
+    expect(cases.length).toBe(5)
+  })
+
+  test('Selector.id encodes as {"id":...}', () => {
+    const sel = Selector.id('btn-login')
+    expect(sel.data.kind).toBe('id')
+    if (sel.data.kind === 'id') expect(sel.data.id).toBe('btn-login')
+  })
+})
+
+describe('A11yRole', () => {
+  test('camelCase wire values exposed as type union', () => {
+    const roles: A11yRole[] = [
+      'button', 'link', 'textField', 'secureTextField', 'searchField',
+      'switch', 'toggle', 'checkBox', 'radio', 'image', 'staticText',
+      'tab', 'tabBar', 'navigationBar', 'cell', 'alert', 'dialog',
+      'slider', 'progressBar', 'picker', 'menu', 'menuItem',
+      'scrollView', 'segmentedControl', 'table', 'collectionView',
+      'webView', 'keyboard',
+    ]
+    expect(roles.length).toBe(28)
+  })
+})
+
+describe('FailureCode', () => {
+  test('6 cases exposed', () => {
+    expect(FAILURE_CODES.length).toBe(6)
+    const expected = new Set<FailureCode>([
+      'notFound', 'ambiguous', 'notInteractable',
+      'timeout', 'wrongState', 'unknown',
+    ])
+    expect(new Set(FAILURE_CODES)).toEqual(expected)
+  })
+
+  test('toJson() emits stable keys', () => {
+    const failure = new ExpectationFailure({
+      code: 'notFound',
+      message: 'no candidates',
+      selectorJson: '{"id":"btn"}',
+      suggestions: ['check id'],
+      timestamp: 1_780_000_000_000,
+    })
+    const json = failure.toJson()
+    for (const key of ['code', 'message', 'selector', 'visibleElements', 'suggestions', 'timestamp']) {
+      const count = json.split(`"${key}":`).length - 1
+      expect(count, `key '${key}' should appear exactly once`).toBe(1)
+    }
+  })
+
+  test('toJson() camelCase FailureCode raw value', () => {
+    for (const code of FAILURE_CODES) {
+      const f = new ExpectationFailure({ code, message: '' })
+      expect(f.toJson()).toContain(`"${code}"`)
+    }
+  })
+})
+
+// v7.6 c1 update: toHaveLabel + toHaveCount stubs replaced with real
+// wires via dedicated FFI resolve_selector_count / resolve_selector_labels.
+// All SDK API stubs from v7.5 c1 are now wired.
+
+describe('Smix.launchApp wire (v7.5 c1)', () => {
+  test('launchApp(.bundleId) calls runtime.launch', async () => {
+    const runtime = new MockSimRuntime()
+    await Smix.launchApp(bundleId('dev.smix.target'), runtime, new MockSelectorResolver().resolve)
+    expect(runtime.launchCalls).toEqual(['dev.smix.target'])
+  })
+
+  test('launchApp(.appPath) dispatches to launchFromPath (mirror Swift v7.2 c5)', async () => {
+    const runtime = new MockSimRuntime()
+    const app = await Smix.launchApp(appPath('/tmp/Foo.apk'), runtime, new MockSelectorResolver().resolve)
+    expect(runtime.launchFromPathCalls).toEqual(['/tmp/Foo.apk'])
+    expect(runtime.launchCalls).toEqual([])
+    expect(app.bundleId).toBe('/tmp/Foo.apk')
+  })
+
+  test('relaunch issues terminate + launch', async () => {
+    const runtime = new MockSimRuntime()
+    const app = await Smix.launchApp(bundleId('dev.smix.target'), runtime, new MockSelectorResolver().resolve)
+    await app.relaunch()
+    expect(runtime.launchCalls).toEqual(['dev.smix.target', 'dev.smix.target'])
+    expect(runtime.terminateCalls).toEqual(['dev.smix.target'])
+  })
+})

package/src/__tests__/SelectorFullSchema.test.ts

@@ -0,0 +1,161 @@
+// v7.5 c1 — Selector full 7-case + Modifiers flatten + Pattern + fluent
+// chaining roundtrip + Rust-compatible wire shape tests.
+//
+// Mirror Kotlin SelectorFullSchemaTest + Swift SelectorFullSchemaTests.
+
+import { describe, expect, test } from 'vitest'
+import {
+  encodeSelectorJson,
+  literal,
+  regex,
+  Selector,
+  selectorFromJsonValue,
+  selectorToJsonValue,
+  type AnchorBox,
+} from '../index.js'
+
+describe('Pattern wire shape', () => {
+  test('literal encodes as bare string', () => {
+    const sel = Selector.text(literal('hello'))
+    const json = encodeSelectorJson(sel)
+    expect(json).toContain('"text":"hello"')
+  })
+
+  test('regex encodes as object', () => {
+    const sel = Selector.text(regex('foo.*', 'i'))
+    const json = encodeSelectorJson(sel)
+    expect(json).toContain('"regex":"foo.*"')
+    expect(json).toContain('"flags":"i"')
+  })
+})
+
+describe('Selector base wire shape', () => {
+  test('id with modifiers flatten', () => {
+    const sel = Selector.id('btn-login').below(Selector.text(literal('Sign In'))).nth(0)
+    const json = encodeSelectorJson(sel)
+    expect(json).toContain('"id":"btn-login"')
+    expect(json).toContain('"below":{"text":"Sign In"}')
+    expect(json).toContain('"nth":0')
+  })
+
+  test('role with name pattern', () => {
+    const sel = Selector.role('button', literal('Submit'))
+    const json = encodeSelectorJson(sel)
+    expect(json).toContain('"role":"button"')
+    expect(json).toContain('"name":"Submit"')
+  })
+
+  test('focused encodes as boolean', () => {
+    const json = encodeSelectorJson(Selector.focused())
+    expect(json).toBe('{"focused":true}')
+  })
+
+  test('anchor with index', () => {
+    const box: AnchorBox = { below: Selector.text(literal('Address')) }
+    const sel = Selector.anchor(box, { nth: 2 })
+    const json = encodeSelectorJson(sel)
+    expect(json).toContain('"anchor":{"below":{"text":"Address"}}')
+    expect(json).toContain('"nth":2')
+  })
+
+  test('localizedText carries multi-locale map', () => {
+    const sel = Selector.localizedText({ en: 'Submit', ja: '送信' })
+    const json = encodeSelectorJson(sel)
+    expect(json).toContain('"localizedText"')
+    expect(json).toContain('Submit')
+    expect(json).toContain('送信')
+  })
+})
+
+describe('Wire decode roundtrip', () => {
+  test('id with below and nth', () => {
+    const wire = { id: 'btn-login', below: { text: 'Sign In' }, nth: 0 }
+    const sel = selectorFromJsonValue(wire)
+    expect(sel.data.kind).toBe('id')
+    if (sel.data.kind === 'id') {
+      expect(sel.data.id).toBe('btn-login')
+      expect(sel.data.modifiers.nth).toBe(0)
+      const below = sel.data.modifiers.below
+      expect(below?.data.kind).toBe('text')
+    }
+  })
+
+  test('focused', () => {
+    const sel = selectorFromJsonValue({ focused: true })
+    expect(sel.data.kind).toBe('focused')
+  })
+
+  test('anchor', () => {
+    const sel = selectorFromJsonValue({ anchor: { below: { text: 'Address' } }, nth: 2 })
+    expect(sel.data.kind).toBe('anchor')
+    if (sel.data.kind === 'anchor') {
+      expect(sel.data.index.nth).toBe(2)
+    }
+  })
+
+  test('localizedText', () => {
+    const sel = selectorFromJsonValue({ localizedText: { en: 'Submit', ja: '送信' } })
+    expect(sel.data.kind).toBe('localizedText')
+    if (sel.data.kind === 'localizedText') {
+      expect(sel.data.map.en).toBe('Submit')
+    }
+  })
+
+  test('role with regex pattern', () => {
+    const sel = selectorFromJsonValue({ role: 'button', name: { regex: '^Sub', flags: 'i' } })
+    expect(sel.data.kind).toBe('role')
+    if (sel.data.kind === 'role') {
+      expect(sel.data.role).toBe('button')
+      expect(sel.data.name?.kind).toBe('regex')
+    }
+  })
+})
+
+describe('Fluent chaining', () => {
+  test('below sets modifier', () => {
+    const sel = Selector.id('btn').below(Selector.text(literal('anchor')))
+    if (sel.data.kind === 'id') {
+      expect(sel.data.modifiers.below).toBeDefined()
+    }
+  })
+
+  test('chained multiple', () => {
+    const sel = Selector.id('btn')
+      .below(Selector.text(literal('address')))
+      .above(Selector.text(literal('title')))
+      .nth(3)
+    if (sel.data.kind === 'id') {
+      expect(sel.data.modifiers.below).toBeDefined()
+      expect(sel.data.modifiers.above).toBeDefined()
+      expect(sel.data.modifiers.nth).toBe(3)
+    }
+  })
+
+  test('first and last', () => {
+    const f = Selector.label('Item').first()
+    const l = Selector.label('Item').last()
+    if (f.data.kind === 'label') expect(f.data.modifiers.first).toBe(true)
+    if (l.data.kind === 'label') expect(l.data.modifiers.last).toBe(true)
+  })
+})
+
+describe('Roundtrip with modifiers', () => {
+  test('id with multiple modifiers byte-identical roundtrip', () => {
+    const original = Selector.id('btn-foo')
+      .below(Selector.text(literal('Address')))
+      .nth(0)
+    const json = JSON.stringify(selectorToJsonValue(original))
+    const decoded = selectorFromJsonValue(JSON.parse(json))
+    const reencoded = JSON.stringify(selectorToJsonValue(decoded))
+    expect(reencoded).toBe(json)
+  })
+
+  test('role with modifiers and name roundtrip', () => {
+    const original = Selector.role('button', literal('Submit'))
+      .below(Selector.text(literal('Email')))
+    const json = JSON.stringify(selectorToJsonValue(original))
+    const decoded = selectorFromJsonValue(JSON.parse(json))
+    const reencoded = JSON.stringify(selectorToJsonValue(decoded))
+    expect(reencoded).toBe(json)
+  })
+})

package/src/index.ts

@@ -0,0 +1,76 @@
+// v7.5 c1 — @smix/rn public API exports.
+//
+// Mirror Kotlin SDK + Swift SDK surface. Per iron rule §9 #13:
+// this package only ships to test harnesses (vitest / jest / Detox-like
+// runners) — never bundled into a production RN app.
+
+export {
+  App,
+} from './App.js'
+
+export {
+  literal,
+  patternFromJson,
+  patternToJson,
+  regex,
+  type Pattern,
+} from './Pattern.js'
+
+export {
+  encodeSelectorJson,
+  Selector,
+  selectorFromJsonValue,
+  selectorToJsonValue,
+  type AnchorBox,
+  type IndexModifiers,
+  type Modifiers,
+  type SelectorData,
+  type SelectorKind,
+} from './Selector.js'
+
+export {
+  ExpectationFailure,
+  FAILURE_CODES,
+  type FailureCode,
+} from './ExpectationFailure.js'
+
+export {
+  Locator,
+  SmixNotImplementedError,
+} from './Locator.js'
+
+export {
+  appPath,
+  bundleId,
+  Smix,
+  type AppTarget,
+} from './Smix.js'
+
+export {
+  MockSimRuntime,
+  type KeyName,
+  type LaunchFreshCall,
+  type SmixSimRuntime,
+  type SwipeDirection,
+} from './SimRuntime.js'
+
+export {
+  MockLabelsResolver,
+  MockSelectorResolver,
+  type LabelsResolver,
+  type SelectorResolver,
+} from './SelectorResolver.js'
+
+export {
+  HttpSimRuntime,
+  type HttpFetch,
+} from './HttpRunner.js'
+
+export {
+  findById,
+  flatten,
+  rectCenter,
+  type A11yNode,
+  type A11yRole,
+  type Rect,
+} from './A11yNode.js'