@goliapkg/smix 1.0.0 → 1.0.1

package/README.md

@@ -1,21 +1,9 @@
 # @goliapkg/smix
 
-> **Status (2026-06-30)**: v0.1.0 ✅ **PUBLISHED to npm** as `@goliapkg/smix`。
-> TS SDK API surface complete, 61 vitest unit tests + 4 demo flows running
-> end-to-end PASS + 24-fixture cross-binary harness × 3 backend byte-identical
-> (Rust + Swift + TS).
->
-> Earlier unscoped `smix-rn` package(briefly published during ship transition)
-> is deprecated pointing here。
->
-> See also [v7 full initiative wrap](../../docs/plan-history/v7-full-initiative-wrap.md)
-> for the 10-cycle outcome summary。
-
 Playwright-style iOS Simulator + Android emulator UI automation SDK for
-TypeScript / React Native / Expo / Detox-compatible test runners. v7
-initiative brings smix's Rust-core selector resolver to TS via HTTP
-client(production) or in-process mock(unit tests),packaged as ESM Node
-20+ module。
+TypeScript / React Native / Expo / Detox-compatible test runners. Brings
+smix's Rust-core selector resolver to TS via HTTP client (production) or
+in-process mock (unit tests), packaged as an ESM Node 20+ module.
 
 ## Installation
 
@@ -25,11 +13,11 @@ bun add -D @goliapkg/smix
 npm install -D @goliapkg/smix
 ```
 
-For test target / Detox-equiv consumer. **Iron rule (§9 #13)**: this
-package ships only to `devDependencies` — never bundled into a
-production RN/Expo app via metro/expo tree-shaking。
+For test target / Detox-equivalent consumer. This package should only be
+listed in `devDependencies` — never bundled into a production RN/Expo app
+via metro/expo tree-shaking.
 
-## Quick start(MockSimRuntime — unit tests)
+## Quick start (MockSimRuntime — unit tests)
 
 ```typescript
 import { Smix, Selector, literal, MockSimRuntime, MockSelectorResolver, bundleId } from '@goliapkg/smix'
@@ -51,7 +39,7 @@ await welcome.toBeVisible({ timeoutMs: 5_000 })
 ```typescript
 import { Smix, Selector, bundleId, HttpSimRuntime } from '@goliapkg/smix'
 
-// Connects to smix-runner-server running on host(see swift-bridge/SmixRunnerCore)
+// Connects to smix-runner-server running on host (see swift-bridge/SmixRunnerCore)
 const runtime = new HttpSimRuntime('http://localhost:14101')
 
 const app = await Smix.launchApp(bundleId('com.example.MyApp'), runtime, runtime.resolver, runtime.labelsResolver)
@@ -62,12 +50,12 @@ await app.find(Selector.role('button')).toHaveCount(3, { timeoutMs: 5_000 })
 HTTP endpoints documented in [`src/HttpRunner.ts`](src/HttpRunner.ts) +
 [Swift server route handler](../../swift-bridge/Sources/SmixRunnerCore/SmixRunnerServer.swift).
 
-## API surface(v7 complete)
+## API surface
 
 ### Selector
 
 ```typescript
-// Base discriminators(untagged JSON wire shape — matches Rust smix-selector)
+// Base discriminators (untagged JSON wire shape — matches Rust smix-selector)
 Selector.id('btn-login')
 Selector.text(literal('Sign In'))
 Selector.text(regex('^Sub', 'i'))
@@ -78,20 +66,20 @@ Selector.focused()
 Selector.anchor({ below: Selector.text(literal('Total')) }, { nth: 0 })
 Selector.localizedText({ en: 'Submit', ja: '送信' })
 
-// Fluent modifier chaining(returns new Selector with Modifiers updated)
+// Fluent modifier chaining (returns new Selector with Modifiers updated)
 Selector.id('btn').below(Selector.text(literal('Address')))
 Selector.label('Edit').nth(0)
 Selector.text(literal('Item')).above(Selector.text(literal('Footer'))).first()
 Selector.role('button').near(Selector.text(literal('Confirm'))).ancestor(Selector.role('dialog'))
 ```
 
-Wire JSON(untagged + flatten — byte-identical to Rust smix-selector):
+Wire JSON (untagged + flatten — byte-identical to Rust smix-selector):
 
 ```json
 {"id": "btn-login", "below": {"text": "Address"}, "nth": 0}
 ```
 
-### App(act)
+### App (act)
 
 ```typescript
 await app.tap(selector: Selector, opts?: { timeoutMs?: number })
@@ -104,7 +92,7 @@ await app.relaunch()
 await app.launchFresh({ clearState?: boolean, clearKeychain?: boolean, appPath?: string })
 ```
 
-### App(sense)
+### App (sense)
 
 ```typescript
 const png: Uint8Array = await app.screenshot()
@@ -113,7 +101,7 @@ const popups: A11yNode[] = await app.systemPopups()
 await app.openUrl('myapp://deep/link')
 ```
 
-### Locator(assertions)
+### Locator (assertions)
 
 ```typescript
 const loc = app.find(Selector.text(literal('Welcome')))
@@ -123,7 +111,7 @@ await loc.toHaveLabel('Sign In', { timeoutMs: 5_000 })  // strict equal
 await loc.toHaveCount(3, { timeoutMs: 5_000 })  // exact match count
 ```
 
-### ExpectationFailure(AI-readable JSON)
+### ExpectationFailure (AI-readable JSON)
 
 ```typescript
 try {
@@ -142,7 +130,7 @@ try {
 
 ## Demos
 
-Run any of the 4 realistic e2e flows in [`examples/demo-app/`](examples/demo-app):
+Run any of the realistic e2e flows in [`examples/demo-app/`](examples/demo-app):
 
 ```bash
 cd examples/demo-app
@@ -164,28 +152,26 @@ bash ../../scripts/sdk/run-cross-binary-harness.sh
 # Summary: 24 / 24 fixtures byte-identical (Rust + Swift + TS)
 ```
 
-## Iron rule §9 #13
+## Test-target-only
 
-`@goliapkg/smix` is **never** bundled into a production RN/Expo app. It lives
-in `devDependencies` only — metro/expo's tree-shaking guarantees the
-production bundle excludes it. The `HttpSimRuntime` connects to a
-smix-runner-server running on the host(via 127.0.0.1:port loopback),
-not in-process。
+`@goliapkg/smix` is intended for `devDependencies` only — never bundled
+into a production RN/Expo app. `metro`/`expo`'s tree-shaking guarantees
+the production bundle excludes it. The `HttpSimRuntime` connects to a
+smix-runner-server running on the host (via `127.0.0.1:port` loopback),
+not in-process.
 
 ## Architecture
 
-Per [docs/plan-cold/v7-sdk-design.md](../../docs/plan-cold/v7-sdk-design.md):
-
-- **Rust stone core**(crates/smix-{selector,selector-resolver,screen,error}):
-  selector resolution + AI-readable failure types,shared across all
-  4 language SDKs。
-- **HTTP runtime**(`src/HttpRunner.ts`): wraps fetch to smix-runner-server
-  on the host。Production-default。
-- **Mock runtime**(`src/SimRuntime.ts MockSimRuntime`): in-memory tree +
-  event log。Used by vitest unit tests + 4 demo flows。
-- **SDK facade**(`src/{Smix,App,Selector,Modifiers,Locator,ExpectationFailure}.ts`):
-  Playwright-style ergonomic surface,class-based fluent chaining。
+- **Rust stone core** (`crates/smix-{selector,selector-resolver,screen,error}`):
+  selector resolution + AI-readable failure types, shared across all
+  language SDKs.
+- **HTTP runtime** (`src/HttpRunner.ts`): wraps fetch to smix-runner-server
+  on the host. Production-default.
+- **Mock runtime** (`src/SimRuntime.ts MockSimRuntime`): in-memory tree +
+  event log. Used by vitest unit tests + demo flows.
+- **SDK facade** (`src/{Smix,App,Selector,Modifiers,Locator,ExpectationFailure}.ts`):
+  Playwright-style ergonomic surface, class-based fluent chaining.
 
 ## License
 
-Apache-2.0 OR MIT(dual,at your option)。
+Apache-2.0 OR MIT (dual, at your option).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goliapkg/smix",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Playwright-shape iOS Simulator / Android emulator UI automation SDK for React Native + Expo + Detox-compatible TypeScript test runners.",
   "type": "module",
   "license": "Apache-2.0 OR MIT",

package/src/SimRuntime.ts

@@ -1,12 +1,12 @@
-// v7.5 c1 — SmixSimRuntime interface + MockSimRuntime impl.
+// SmixSimRuntime interface + MockSimRuntime impl.
 //
-// Mirror Swift v7.2 + Kotlin v7.4 SimRuntime architecture. TS SDK
-// is HTTP-runner-friendly (per R-7.5-B decision):
-//   - HttpSimRuntime (real, lives in src/HttpRunner.ts, v7.5 c3):
-//     wraps smix-runner HTTP server via fetch (cross-platform iOS+Android).
+// Mirrors the Swift and Kotlin SimRuntime architecture. The TS SDK is
+// HTTP-runner-friendly:
+//   - HttpSimRuntime (real, lives in src/HttpRunner.ts): wraps the
+//     smix-runner HTTP server via fetch (cross-platform iOS+Android).
 //   - MockSimRuntime (here): in-memory tree + event log for unit tests.
 //
-// Per iron rule §9 #13: this module ships only to test targets.
+// This module is intended for test targets only.
 
 import type { A11yNode } from './A11yNode.js'
 

package/src/index.ts

@@ -1,8 +1,8 @@
-// v7.5 c1 — @smix/rn public API exports.
+// @goliapkg/smix 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.
+// Mirrors Kotlin SDK + Swift SDK surface. This package is intended for
+// test harnesses (vitest / jest / Detox-like runners) — it should not be
+// bundled into a production RN app.
 
 export {
   App,