@quiesco/steps 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Quiesco contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,95 @@
-# Temporary Holding Version
+# @quiesco/steps
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Optional generic cucumber steps for Quiesco, in Chinese, Japanese and English.
+
+> **Operation scripts, not requirements.** These steps describe taps and texts ("tap `login-button`"),
+> not what the user wants to achieve. Use them while prototyping or exploring an app. A real project
+> writes its own steps in the language of the business ("When the user logs in as …") on top of
+> `this.app` — or a driver of its own (see the [driver pattern](https://shift-14cc7601.mintlify.site/driver-pattern)) — so the features
+> keep describing requirements when the UI changes.
+
+## Use
+
+```ts
+// features/support/steps.ts
+import { registerQuiescoSteps } from '@quiesco/steps';
+
+registerQuiescoSteps(); // all languages; or { languages: ['ja'] }, { only: ['tap', 'seeText'] }
+```
+
+`@quiesco/cucumber/register` must be imported too (it provides `this.app`). The steps are registered
+with cucumber's keyword-agnostic `defineStep`, so they work after any keyword (`当` / `もし` / `When` …)
+and in feature files of any `# language:`.
+
+A quoted target is a **testID**; the "text" variants match the displayed text instead. Every step waits
+for the app to become idle like any other Quiesco call — no sleeps.
+
+## Steps
+
+| Step | 中文 | 日本語 | English |
+|---|---|---|---|
+| `tap` | `点击 "add-todo"` | `"add-todo" をタップする` | `I tap "add-todo"` |
+| `tapText` | `点击文本 "保存"` | `テキスト "保存" をタップする` | `I tap the text "Save"` |
+| `longPress` | `长按 "todo-item"` | `"todo-item" を長押しする` | `I long press "todo-item"` |
+| `type` | `在 "todo-title" 中输入 "买牛奶"` | `"todo-title" に "牛乳を買う" と入力する` | `I type "Buy milk" into "todo-title"` |
+| `clear` | `清空 "todo-title" 的内容` | `"todo-title" の入力をクリアする` | `I clear "todo-title"` |
+| `scrollTo` | `在 "todo-list" 中滚动到 "todo-item-30"` | `"todo-list" を "todo-item-30" までスクロールする` | `I scroll "todo-list" to "todo-item-30"` |
+| `dismissKeyboard` | `收起键盘` | `キーボードを閉じる` | `I dismiss the keyboard` |
+| `pressBack` | `按返回键` | `戻るボタンを押す` | `I press back` |
+| `openUrl` | `打开链接 "myapp://todos"` | `リンク "myapp://todos" を開く` | `I open the link "myapp://todos"` |
+| `seeText` | `看到文本 "买牛奶"` | `テキスト "牛乳を買う" が表示されている` | `I see the text "Buy milk"` |
+| `notSeeText` | `看不到文本 "买牛奶"` | `テキスト "牛乳を買う" が表示されていない` | `I do not see the text "Buy milk"` |
+| `visible` | `元素 "todo-list" 可见` | `要素 "todo-list" が表示されている` | `the element "todo-list" is visible` |
+| `notVisible` | `元素 "todo-title-error" 不可见` | `要素 "todo-title-error" が表示されていない` | `the element "todo-title-error" is not visible` |
+| `hasText` | `元素 "greeting" 的文本是 "a@example.com"` | `要素 "greeting" のテキストが "a@example.com" である` | `the element "greeting" has the text "a@example.com"` |
+| `count` | `元素 "todo-item" 共有 2 个` | `要素 "todo-item" が 2 個ある` | `there are 2 elements "todo-item"` |
+| `doubleTap` | `双击 "photo"` | `"photo" をダブルタップする` | `I double tap "photo"` |
+| `replaceText` | `把 "todo-title" 的内容替换为 "买面包"` | `"todo-title" の入力を "パンを買う" に置き換える` | `I replace the text of "todo-title" with "Buy bread"` |
+| `pressEnter` | `在 "todo-title" 中按回车` | `"todo-title" でエンターキーを押す` | `I press enter in "todo-title"` |
+| `scroll` | `在 "todo-list" 中向下滚动` | `"todo-list" を下にスクロールする` | `I scroll "todo-list" down` |
+| `scrollToEdge` | `把 "todo-list" 滚动到底部` | `"todo-list" を一番下までスクロールする` | `I scroll "todo-list" to the bottom` |
+| `swipe` | `在 "todo-item" 上向左滑动` | `"todo-item" を左にスワイプする` | `I swipe left on "todo-item"` |
+| `drag` | `把 "item-1" 拖到 "item-3"` | `"item-1" を "item-3" までドラッグする` | `I drag "item-1" to "item-3"` |
+| `pinch` | `在 "photo" 上双指缩放到 2 倍` | `"photo" を 2 倍にピンチする` | `I pinch "photo" to 2 times` |
+| `setSlider` | `把滑块 "volume" 设为 30` | `スライダー "volume" を 30 にする` | `I set the slider "volume" to 30` |
+| `switchOn` | `打开开关 "notify"` | `スイッチ "notify" をオンにする` | `I turn on the switch "notify"` |
+| `switchOff` | `关闭开关 "notify"` | `スイッチ "notify" をオフにする` | `I turn off the switch "notify"` |
+| `select` | `在 "priority" 中选择 "高"` | `"priority" で "高" を選ぶ` | `I select "High" in "priority"` |
+| `enabled` | `元素 "save" 可用` | `要素 "save" が有効である` | `the element "save" is enabled` |
+| `disabled` | `元素 "save" 不可用` | `要素 "save" が無効である` | `the element "save" is disabled` |
+| `checked` | `元素 "notify" 已选中` | `要素 "notify" がオンである` | `the element "notify" is checked` |
+| `notChecked` | `元素 "notify" 未选中` | `要素 "notify" がオフである` | `the element "notify" is not checked` |
+| `focused` | `元素 "todo-title" 获得焦点` | `要素 "todo-title" にフォーカスがある` | `the element "todo-title" has the focus` |
+| `hasValue` | `元素 "priority" 的值是 "high"` | `要素 "priority" の値が "high" である` | `the element "priority" has the value "high"` |
+| `sliderValue` | `滑块 "volume" 的值是 30` | `スライダー "volume" の値が 30 である` | `the slider "volume" has the value 30` |
+| `background` | `把 App 切到后台` | `アプリをバックグラウンドにする` | `I send the app to the background` |
+| `foreground` | `把 App 切回前台` | `アプリをフォアグラウンドに戻す` | `I bring the app to the foreground` |
+| `relaunch` | `重新启动 App` | `アプリを再起動する` | `I relaunch the app` |
+| `orientation` | `把设备转到横屏` | `画面を横向きにする` | `I rotate the device to landscape` |
+| `appearance` | `把外观设为深色模式` | `外観をダークモードにする` | `I switch to dark mode` |
+| `location` | `把设备位置设为 35.68, 139.76` | `端末の位置を 35.68, 139.76 にする` | `I set the device location to 35.68, 139.76` |
+| `offline` | `把设备切换到离线` | `端末をオフラインにする` | `I go offline` |
+| `online` | `把设备切换到在线` | `端末をオンラインにする` | `I go online` |
+| `grantPermission` | `授予 App 定位权限` | `アプリに位置情報の権限を与える` | `I grant the location permission` |
+| `revokePermission` | `撤销 App 的定位权限` | `アプリの位置情報の権限を取り消す` | `I revoke the location permission` |
+| `allowDialog` | `在系统弹窗中允许` | `システムダイアログで許可する` | `I allow in the system dialog` |
+| `denyDialog` | `在系统弹窗中拒绝` | `システムダイアログで拒否する` | `I deny in the system dialog` |
+| `shake` | `摇动设备` | `端末を振る` | `I shake the device` |
+| `screenshot` | `截图并保存为 "列表"` | `スクリーンショットを "一覧" として保存する` | `I take a screenshot named "list"` |
+
+`pressBack` is not available on iOS (no back button); Quiesco reports `ACTION_NOT_SUPPORTED` there.
+
+Some steps take a word instead of a quoted value (any of the languages' words works in every language):
+
+| Word | Values |
+|---|---|
+| Direction (`scroll`, `swipe`: the finger's direction for a swipe) | 上 下 左 右 / up down left right |
+| Edge (`scrollToEdge`) | 顶部 底部 最左边 最右边 / 一番上 一番下 左端 右端 / top bottom left right |
+| Orientation | 竖屏 横屏 / 縦向き 横向き / portrait landscape |
+| Appearance | 浅色 深色 / ライト ダーク / light dark |
+| Permission | 相机 麦克风 定位 通知 通讯录 照片 日历 / カメラ マイク 位置情報 通知 連絡先 写真 カレンダー / camera microphone location notifications contacts photos calendar |
+
+An unknown word fails the step with the list of accepted ones. Device and system steps (`background`,
+`orientation`, `offline`, `grantPermission`, `allowDialog`, `shake`, …) call `this.app.device`; where a
+platform cannot do something Quiesco reports `ACTION_NOT_SUPPORTED` with the reason
+([platform differences](https://shift-14cc7601.mintlify.site/platforms)).

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import type { QuiescoWorld } from '@quiesco/cucumber';
+import type { Language } from './steps.js';
+export { GENERIC_STEPS, argsFor } from './steps.js';
+export type { GenericStep, Language } from './steps.js';
+export interface RegisterStepsOptions {
+    /** Step languages to register. Default: all (zh, ja, en). */
+    languages?: readonly Language[];
+    /** Only these steps (by `name`). Default: all. */
+    only?: readonly string[];
+}
+type Define = (expression: string, fn: (this: QuiescoWorld, ...params: (string | number)[]) => Promise<void>) => void;
+/** Number of `{…}` parameters in a cucumber expression. */
+export declare function parameterCount(expression: string): number;
+/** Register the generic steps with cucumber-js. Returns the expressions it registered. */
+export declare function registerQuiescoSteps(options?: RegisterStepsOptions, define?: Define): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAe,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAChC,kDAAkD;IAClD,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,KAAK,MAAM,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AAEtH,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AA2BD,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,oBAAyB,EAAE,MAAM,GAAE,MAAwC,GAAG,MAAM,EAAE,CAcnI"}

package/dist/index.js

@@ -0,0 +1,56 @@
+/**
+ * @quiesco/steps — optional generic steps (requirements.md §6.11).
+ *
+ *   // features/support/steps.ts
+ *   import { registerQuiescoSteps } from '@quiesco/steps';
+ *   registerQuiescoSteps({ languages: ['zh'] });
+ *
+ * Only for prototyping and exploration: these steps script taps and texts instead of stating what the
+ * user wants. Real projects write their own business-language steps (see docs/driver-pattern.mdx).
+ */
+import { defineStep } from '@cucumber/cucumber';
+import { GENERIC_STEPS, argsFor } from './steps.js';
+export { GENERIC_STEPS, argsFor } from './steps.js';
+/** Number of `{…}` parameters in a cucumber expression. */
+export function parameterCount(expression) {
+    return (expression.match(/\{[^}]*\}/g) ?? []).length;
+}
+/**
+ * cucumber-js checks a step function's arity against the expression's parameters, so the wrapper must
+ * declare exactly that many (a rest parameter has length 0).
+ */
+function withArity(count, body) {
+    switch (count) {
+        case 0:
+            return async function () {
+                await body(this, []);
+            };
+        case 1:
+            return async function (a) {
+                await body(this, [a]);
+            };
+        case 2:
+            return async function (a, b) {
+                await body(this, [a, b]);
+            };
+        default:
+            throw new Error(`generic steps take at most 2 parameters (got ${count})`);
+    }
+}
+/** Register the generic steps with cucumber-js. Returns the expressions it registered. */
+export function registerQuiescoSteps(options = {}, define = defineStep) {
+    const languages = options.languages ?? ['zh', 'ja', 'en'];
+    const steps = options.only === undefined ? GENERIC_STEPS : GENERIC_STEPS.filter((st) => options.only?.includes(st.name));
+    const registered = [];
+    for (const step of steps) {
+        for (const language of languages) {
+            const expression = step.expressions[language];
+            define(expression, withArity(parameterCount(expression), async (world, params) => {
+                await step.run(world.app, ...argsFor(step, language, params));
+            }));
+            registered.push(expression);
+        }
+    }
+    return registered;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIhD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAYpD,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;AACvD,CAAC;AAID;;;GAGG;AACH,SAAS,SAAS,CAAC,KAAa,EAAE,IAAU;IAC1C,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,CAAC;YACJ,OAAO,KAAK;gBACV,MAAM,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACvB,CAAC,CAAC;QACJ,KAAK,CAAC;YACJ,OAAO,KAAK,WAA+B,CAAkB;gBAC3D,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACxB,CAAC,CAAC;QACJ,KAAK,CAAC;YACJ,OAAO,KAAK,WAA+B,CAAkB,EAAE,CAAkB;gBAC/E,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC,CAAC;QACJ;YACE,MAAM,IAAI,KAAK,CAAC,gDAAgD,KAAK,GAAG,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,oBAAoB,CAAC,UAAgC,EAAE,EAAE,SAAiB,UAA+B;IACvH,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAW,CAAC;IACrE,MAAM,KAAK,GAA2B,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACjJ,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBAC/E,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;YAChE,CAAC,CAAC,CAAC,CAAC;YACJ,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/steps.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The generic steps (requirements.md §6.11), in Chinese, Japanese and English.
+ *
+ * These are operation scripts, not requirements: they describe taps and texts, not what the user wants
+ * to achieve. Use them while prototyping or exploring; a real project writes business-language steps
+ * ("When the user logs in as …") on top of `this.app` or its own driver.
+ *
+ * A quoted target is a testID (`点击 "add-todo"`); the "…文本 / テキスト / the text …" variants match
+ * the displayed text instead.
+ */
+import type { Driver } from '@quiesco/core';
+export type Language = 'zh' | 'ja' | 'en';
+export interface GenericStep {
+    /** Stable name, e.g. for docs. */
+    name: string;
+    /** Cucumber expression per language. Parameters are passed to `run` in the order they appear. */
+    expressions: Record<Language, string>;
+    /** Example step text per language (docs and tests). */
+    examples: Record<Language, string>;
+    /** Maps the language's parameters to `run` arguments when their order differs from `zh`. */
+    order?: Partial<Record<Language, number[]>>;
+    run(app: Driver, ...args: (string | number)[]): Promise<unknown>;
+}
+export declare const GENERIC_STEPS: readonly GenericStep[];
+/** Arguments as `run` expects them, from the parameters in the order the language's expression has them. */
+export declare function argsFor(step: GenericStep, language: Language, params: readonly (string | number)[]): (string | number)[];
+//# sourceMappingURL=steps.d.ts.map

package/dist/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../src/steps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,iGAAiG;IACjG,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACtC,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACnC,4FAA4F;IAC5F,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClE;AA6BD,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EA+S/C,CAAC;AACF,4GAA4G;AAC5G,wBAAgB,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAGxH"}

package/dist/steps.js

@@ -0,0 +1,332 @@
+const s = (v) => String(v);
+/** A word from the step text mapped to an API value; the same table serves every language. */
+function word(kind, table, v) {
+    const key = s(v).trim().toLowerCase();
+    const hit = table[key];
+    if (hit === undefined)
+        throw new Error(`Unknown ${kind} "${s(v)}": use one of ${Object.keys(table).join(', ')}`);
+    return hit;
+}
+const DIRECTIONS = { 上: 'up', 下: 'down', 左: 'left', 右: 'right', up: 'up', down: 'down', left: 'left', right: 'right' };
+const EDGES = {
+    顶部: 'top', 底部: 'bottom', 最左边: 'left', 最右边: 'right',
+    一番上: 'top', 一番下: 'bottom', 左端: 'left', 右端: 'right',
+    top: 'top', bottom: 'bottom', left: 'left', right: 'right',
+};
+const ORIENTATIONS = { 竖屏: 'portrait', 横屏: 'landscape', 縦向き: 'portrait', 横向き: 'landscape', portrait: 'portrait', landscape: 'landscape' };
+const APPEARANCES = { 浅色: 'light', 深色: 'dark', ライト: 'light', ダーク: 'dark', light: 'light', dark: 'dark' };
+const PERMISSIONS = {
+    相机: 'camera', 麦克风: 'microphone', 定位: 'location', 通知: 'notifications', 通讯录: 'contacts', 照片: 'photos', 日历: 'calendar',
+    カメラ: 'camera', マイク: 'microphone', 位置情報: 'location', 連絡先: 'contacts', 写真: 'photos', カレンダー: 'calendar',
+    camera: 'camera', microphone: 'microphone', location: 'location', notifications: 'notifications', contacts: 'contacts', photos: 'photos', calendar: 'calendar',
+};
+export const GENERIC_STEPS = [
+    {
+        name: 'tap',
+        expressions: { zh: '点击 {string}', ja: '{string} をタップする', en: 'I tap {string}' },
+        examples: { zh: '点击 "add-todo"', ja: '"add-todo" をタップする', en: 'I tap "add-todo"' },
+        run: (app, id) => app.tap(s(id)),
+    },
+    {
+        name: 'tapText',
+        expressions: { zh: '点击文本 {string}', ja: 'テキスト {string} をタップする', en: 'I tap the text {string}' },
+        examples: { zh: '点击文本 "保存"', ja: 'テキスト "保存" をタップする', en: 'I tap the text "Save"' },
+        run: (app, text) => app.tap({ text: s(text) }),
+    },
+    {
+        name: 'longPress',
+        expressions: { zh: '长按 {string}', ja: '{string} を長押しする', en: 'I long press {string}' },
+        examples: { zh: '长按 "todo-item"', ja: '"todo-item" を長押しする', en: 'I long press "todo-item"' },
+        run: (app, id) => app.longPress(s(id)),
+    },
+    {
+        name: 'type',
+        expressions: { zh: '在 {string} 中输入 {string}', ja: '{string} に {string} と入力する', en: 'I type {string} into {string}' },
+        examples: { zh: '在 "todo-title" 中输入 "买牛奶"', ja: '"todo-title" に "牛乳を買う" と入力する', en: 'I type "Buy milk" into "todo-title"' },
+        // en names the text first: run(target, text)
+        order: { en: [1, 0] },
+        run: (app, id, text) => app.type(s(id), s(text)),
+    },
+    {
+        name: 'clear',
+        expressions: { zh: '清空 {string} 的内容', ja: '{string} の入力をクリアする', en: 'I clear {string}' },
+        examples: { zh: '清空 "todo-title" 的内容', ja: '"todo-title" の入力をクリアする', en: 'I clear "todo-title"' },
+        run: (app, id) => app.clear(s(id)),
+    },
+    {
+        name: 'scrollTo',
+        expressions: { zh: '在 {string} 中滚动到 {string}', ja: '{string} を {string} までスクロールする', en: 'I scroll {string} to {string}' },
+        examples: { zh: '在 "todo-list" 中滚动到 "todo-item-30"', ja: '"todo-list" を "todo-item-30" までスクロールする', en: 'I scroll "todo-list" to "todo-item-30"' },
+        run: (app, container, target) => app.scrollTo(s(container), s(target)),
+    },
+    {
+        name: 'dismissKeyboard',
+        expressions: { zh: '收起键盘', ja: 'キーボードを閉じる', en: 'I dismiss the keyboard' },
+        examples: { zh: '收起键盘', ja: 'キーボードを閉じる', en: 'I dismiss the keyboard' },
+        run: (app) => app.dismissKeyboard(),
+    },
+    {
+        name: 'pressBack',
+        expressions: { zh: '按返回键', ja: '戻るボタンを押す', en: 'I press back' },
+        examples: { zh: '按返回键', ja: '戻るボタンを押す', en: 'I press back' },
+        run: (app) => app.pressBack(),
+    },
+    {
+        name: 'openUrl',
+        expressions: { zh: '打开链接 {string}', ja: 'リンク {string} を開く', en: 'I open the link {string}' },
+        examples: { zh: '打开链接 "myapp://todos"', ja: 'リンク "myapp://todos" を開く', en: 'I open the link "myapp://todos"' },
+        run: (app, url) => app.openUrl(s(url)),
+    },
+    {
+        name: 'seeText',
+        expressions: { zh: '看到文本 {string}', ja: 'テキスト {string} が表示されている', en: 'I see the text {string}' },
+        examples: { zh: '看到文本 "买牛奶"', ja: 'テキスト "牛乳を買う" が表示されている', en: 'I see the text "Buy milk"' },
+        run: (app, text) => app.expectVisible({ text: s(text) }),
+    },
+    {
+        name: 'notSeeText',
+        expressions: { zh: '看不到文本 {string}', ja: 'テキスト {string} が表示されていない', en: 'I do not see the text {string}' },
+        examples: { zh: '看不到文本 "买牛奶"', ja: 'テキスト "牛乳を買う" が表示されていない', en: 'I do not see the text "Buy milk"' },
+        run: (app, text) => app.expectNotVisible({ text: s(text) }),
+    },
+    {
+        name: 'visible',
+        expressions: { zh: '元素 {string} 可见', ja: '要素 {string} が表示されている', en: 'the element {string} is visible' },
+        examples: { zh: '元素 "todo-list" 可见', ja: '要素 "todo-list" が表示されている', en: 'the element "todo-list" is visible' },
+        run: (app, id) => app.expectVisible(s(id)),
+    },
+    {
+        name: 'notVisible',
+        expressions: { zh: '元素 {string} 不可见', ja: '要素 {string} が表示されていない', en: 'the element {string} is not visible' },
+        examples: { zh: '元素 "todo-title-error" 不可见', ja: '要素 "todo-title-error" が表示されていない', en: 'the element "todo-title-error" is not visible' },
+        run: (app, id) => app.expectNotVisible(s(id)),
+    },
+    {
+        name: 'hasText',
+        expressions: { zh: '元素 {string} 的文本是 {string}', ja: '要素 {string} のテキストが {string} である', en: 'the element {string} has the text {string}' },
+        examples: { zh: '元素 "greeting" 的文本是 "a@example.com"', ja: '要素 "greeting" のテキストが "a@example.com" である', en: 'the element "greeting" has the text "a@example.com"' },
+        run: (app, id, text) => app.expectText(s(id), s(text)),
+    },
+    {
+        name: 'count',
+        expressions: { zh: '元素 {string} 共有 {int} 个', ja: '要素 {string} が {int} 個ある', en: 'there are {int} elements {string}' },
+        examples: { zh: '元素 "todo-item" 共有 2 个', ja: '要素 "todo-item" が 2 個ある', en: 'there are 2 elements "todo-item"' },
+        // en names the count first: run(target, count)
+        order: { en: [1, 0] },
+        run: (app, id, count) => app.expectCount(s(id), Number(count)),
+    },
+    // ---- Phase 6.2 – 6.4: more actions ----
+    {
+        name: 'doubleTap',
+        expressions: { zh: '双击 {string}', ja: '{string} をダブルタップする', en: 'I double tap {string}' },
+        examples: { zh: '双击 "photo"', ja: '"photo" をダブルタップする', en: 'I double tap "photo"' },
+        run: (app, id) => app.doubleTap(s(id)),
+    },
+    {
+        name: 'replaceText',
+        expressions: { zh: '把 {string} 的内容替换为 {string}', ja: '{string} の入力を {string} に置き換える', en: 'I replace the text of {string} with {string}' },
+        examples: { zh: '把 "todo-title" 的内容替换为 "买面包"', ja: '"todo-title" の入力を "パンを買う" に置き換える', en: 'I replace the text of "todo-title" with "Buy bread"' },
+        run: (app, id, text) => app.replaceText(s(id), s(text)),
+    },
+    {
+        name: 'pressEnter',
+        expressions: { zh: '在 {string} 中按回车', ja: '{string} でエンターキーを押す', en: 'I press enter in {string}' },
+        examples: { zh: '在 "todo-title" 中按回车', ja: '"todo-title" でエンターキーを押す', en: 'I press enter in "todo-title"' },
+        run: (app, id) => app.pressKey(s(id), 'enter'),
+    },
+    {
+        name: 'scroll',
+        expressions: { zh: '在 {string} 中向{word}滚动', ja: '{string} を{word}にスクロールする', en: 'I scroll {string} {word}' },
+        examples: { zh: '在 "todo-list" 中向下滚动', ja: '"todo-list" を下にスクロールする', en: 'I scroll "todo-list" down' },
+        run: (app, id, dir) => app.scroll(s(id), word('direction', DIRECTIONS, dir)),
+    },
+    {
+        name: 'scrollToEdge',
+        expressions: { zh: '把 {string} 滚动到{word}', ja: '{string} を{word}までスクロールする', en: 'I scroll {string} to the {word}' },
+        examples: { zh: '把 "todo-list" 滚动到底部', ja: '"todo-list" を一番下までスクロールする', en: 'I scroll "todo-list" to the bottom' },
+        run: (app, id, edge) => app.scrollToEdge(s(id), word('edge', EDGES, edge)),
+    },
+    {
+        name: 'swipe',
+        expressions: { zh: '在 {string} 上向{word}滑动', ja: '{string} を{word}にスワイプする', en: 'I swipe {word} on {string}' },
+        examples: { zh: '在 "todo-item" 上向左滑动', ja: '"todo-item" を左にスワイプする', en: 'I swipe left on "todo-item"' },
+        // en names the direction first: run(target, direction)
+        order: { en: [1, 0] },
+        run: (app, id, dir) => app.swipe(s(id), word('direction', DIRECTIONS, dir)),
+    },
+    {
+        name: 'drag',
+        expressions: { zh: '把 {string} 拖到 {string}', ja: '{string} を {string} までドラッグする', en: 'I drag {string} to {string}' },
+        examples: { zh: '把 "item-1" 拖到 "item-3"', ja: '"item-1" を "item-3" までドラッグする', en: 'I drag "item-1" to "item-3"' },
+        run: (app, from, to) => app.drag(s(from), s(to)),
+    },
+    {
+        name: 'pinch',
+        expressions: { zh: '在 {string} 上双指缩放到 {float} 倍', ja: '{string} を {float} 倍にピンチする', en: 'I pinch {string} to {float} times' },
+        examples: { zh: '在 "photo" 上双指缩放到 2 倍', ja: '"photo" を 2 倍にピンチする', en: 'I pinch "photo" to 2 times' },
+        run: (app, id, scale) => app.pinch(s(id), Number(scale)),
+    },
+    // ---- Phase 6.3: value controls ----
+    {
+        name: 'setSlider',
+        expressions: { zh: '把滑块 {string} 设为 {float}', ja: 'スライダー {string} を {float} にする', en: 'I set the slider {string} to {float}' },
+        examples: { zh: '把滑块 "volume" 设为 30', ja: 'スライダー "volume" を 30 にする', en: 'I set the slider "volume" to 30' },
+        run: (app, id, value) => app.setValue(s(id), Number(value)),
+    },
+    {
+        name: 'switchOn',
+        expressions: { zh: '打开开关 {string}', ja: 'スイッチ {string} をオンにする', en: 'I turn on the switch {string}' },
+        examples: { zh: '打开开关 "notify"', ja: 'スイッチ "notify" をオンにする', en: 'I turn on the switch "notify"' },
+        run: (app, id) => app.setValue(s(id), true),
+    },
+    {
+        name: 'switchOff',
+        expressions: { zh: '关闭开关 {string}', ja: 'スイッチ {string} をオフにする', en: 'I turn off the switch {string}' },
+        examples: { zh: '关闭开关 "notify"', ja: 'スイッチ "notify" をオフにする', en: 'I turn off the switch "notify"' },
+        run: (app, id) => app.setValue(s(id), false),
+    },
+    {
+        name: 'select',
+        expressions: { zh: '在 {string} 中选择 {string}', ja: '{string} で {string} を選ぶ', en: 'I select {string} in {string}' },
+        examples: { zh: '在 "priority" 中选择 "高"', ja: '"priority" で "高" を選ぶ', en: 'I select "High" in "priority"' },
+        // en names the option first: run(target, option)
+        order: { en: [1, 0] },
+        run: (app, id, option) => app.setValue(s(id), s(option)),
+    },
+    // ---- Phase 6.1: state assertions ----
+    {
+        name: 'enabled',
+        expressions: { zh: '元素 {string} 可用', ja: '要素 {string} が有効である', en: 'the element {string} is enabled' },
+        examples: { zh: '元素 "save" 可用', ja: '要素 "save" が有効である', en: 'the element "save" is enabled' },
+        run: (app, id) => app.expectEnabled(s(id)),
+    },
+    {
+        name: 'disabled',
+        expressions: { zh: '元素 {string} 不可用', ja: '要素 {string} が無効である', en: 'the element {string} is disabled' },
+        examples: { zh: '元素 "save" 不可用', ja: '要素 "save" が無効である', en: 'the element "save" is disabled' },
+        run: (app, id) => app.expectDisabled(s(id)),
+    },
+    {
+        name: 'checked',
+        expressions: { zh: '元素 {string} 已选中', ja: '要素 {string} がオンである', en: 'the element {string} is checked' },
+        examples: { zh: '元素 "notify" 已选中', ja: '要素 "notify" がオンである', en: 'the element "notify" is checked' },
+        run: (app, id) => app.expectChecked(s(id)),
+    },
+    {
+        name: 'notChecked',
+        expressions: { zh: '元素 {string} 未选中', ja: '要素 {string} がオフである', en: 'the element {string} is not checked' },
+        examples: { zh: '元素 "notify" 未选中', ja: '要素 "notify" がオフである', en: 'the element "notify" is not checked' },
+        run: (app, id) => app.expectNotChecked(s(id)),
+    },
+    {
+        name: 'focused',
+        expressions: { zh: '元素 {string} 获得焦点', ja: '要素 {string} にフォーカスがある', en: 'the element {string} has the focus' },
+        examples: { zh: '元素 "todo-title" 获得焦点', ja: '要素 "todo-title" にフォーカスがある', en: 'the element "todo-title" has the focus' },
+        run: (app, id) => app.expectFocused(s(id)),
+    },
+    {
+        name: 'hasValue',
+        expressions: { zh: '元素 {string} 的值是 {string}', ja: '要素 {string} の値が {string} である', en: 'the element {string} has the value {string}' },
+        examples: { zh: '元素 "priority" 的值是 "high"', ja: '要素 "priority" の値が "high" である', en: 'the element "priority" has the value "high"' },
+        run: (app, id, value) => app.expectValue(s(id), s(value)),
+    },
+    {
+        name: 'sliderValue',
+        expressions: { zh: '滑块 {string} 的值是 {float}', ja: 'スライダー {string} の値が {float} である', en: 'the slider {string} has the value {float}' },
+        examples: { zh: '滑块 "volume" 的值是 30', ja: 'スライダー "volume" の値が 30 である', en: 'the slider "volume" has the value 30' },
+        run: (app, id, value) => app.expectValue(s(id), Number(value)),
+    },
+    // ---- Phase 6.5: app lifecycle ----
+    {
+        name: 'background',
+        expressions: { zh: '把 App 切到后台', ja: 'アプリをバックグラウンドにする', en: 'I send the app to the background' },
+        examples: { zh: '把 App 切到后台', ja: 'アプリをバックグラウンドにする', en: 'I send the app to the background' },
+        run: (app) => app.device.sendToBackground(),
+    },
+    {
+        name: 'foreground',
+        expressions: { zh: '把 App 切回前台', ja: 'アプリをフォアグラウンドに戻す', en: 'I bring the app to the foreground' },
+        examples: { zh: '把 App 切回前台', ja: 'アプリをフォアグラウンドに戻す', en: 'I bring the app to the foreground' },
+        run: (app) => app.device.bringToForeground(),
+    },
+    {
+        name: 'relaunch',
+        expressions: { zh: '重新启动 App', ja: 'アプリを再起動する', en: 'I relaunch the app' },
+        examples: { zh: '重新启动 App', ja: 'アプリを再起動する', en: 'I relaunch the app' },
+        run: (app) => app.device.relaunch(),
+    },
+    // ---- Phase 6.6 / 6.7: device state and system UI ----
+    {
+        name: 'orientation',
+        expressions: { zh: '把设备转到{word}', ja: '画面を{word}にする', en: 'I rotate the device to {word}' },
+        examples: { zh: '把设备转到横屏', ja: '画面を横向きにする', en: 'I rotate the device to landscape' },
+        run: (app, o) => app.device.setOrientation(word('orientation', ORIENTATIONS, o)),
+    },
+    {
+        name: 'appearance',
+        expressions: { zh: '把外观设为{word}模式', ja: '外観を{word}モードにする', en: 'I switch to {word} mode' },
+        examples: { zh: '把外观设为深色模式', ja: '外観をダークモードにする', en: 'I switch to dark mode' },
+        run: (app, a) => app.device.setAppearance(word('appearance', APPEARANCES, a)),
+    },
+    {
+        name: 'location',
+        expressions: { zh: '把设备位置设为 {float}, {float}', ja: '端末の位置を {float}, {float} にする', en: 'I set the device location to {float}, {float}' },
+        examples: { zh: '把设备位置设为 35.68, 139.76', ja: '端末の位置を 35.68, 139.76 にする', en: 'I set the device location to 35.68, 139.76' },
+        run: (app, lat, lon) => app.device.setLocation(Number(lat), Number(lon)),
+    },
+    {
+        name: 'offline',
+        expressions: { zh: '把设备切换到离线', ja: '端末をオフラインにする', en: 'I go offline' },
+        examples: { zh: '把设备切换到离线', ja: '端末をオフラインにする', en: 'I go offline' },
+        run: (app) => app.device.setNetwork('offline'),
+    },
+    {
+        name: 'online',
+        expressions: { zh: '把设备切换到在线', ja: '端末をオンラインにする', en: 'I go online' },
+        examples: { zh: '把设备切换到在线', ja: '端末をオンラインにする', en: 'I go online' },
+        run: (app) => app.device.setNetwork('online'),
+    },
+    {
+        name: 'grantPermission',
+        expressions: { zh: '授予 App {word}权限', ja: 'アプリに{word}の権限を与える', en: 'I grant the {word} permission' },
+        examples: { zh: '授予 App 定位权限', ja: 'アプリに位置情報の権限を与える', en: 'I grant the location permission' },
+        run: (app, p) => app.device.setPermission(word('permission', PERMISSIONS, p), 'grant'),
+    },
+    {
+        name: 'revokePermission',
+        expressions: { zh: '撤销 App 的{word}权限', ja: 'アプリの{word}の権限を取り消す', en: 'I revoke the {word} permission' },
+        examples: { zh: '撤销 App 的定位权限', ja: 'アプリの位置情報の権限を取り消す', en: 'I revoke the location permission' },
+        run: (app, p) => app.device.setPermission(word('permission', PERMISSIONS, p), 'revoke'),
+    },
+    {
+        name: 'allowDialog',
+        expressions: { zh: '在系统弹窗中允许', ja: 'システムダイアログで許可する', en: 'I allow in the system dialog' },
+        examples: { zh: '在系统弹窗中允许', ja: 'システムダイアログで許可する', en: 'I allow in the system dialog' },
+        run: (app) => app.device.system.allowPermission(),
+    },
+    {
+        name: 'denyDialog',
+        expressions: { zh: '在系统弹窗中拒绝', ja: 'システムダイアログで拒否する', en: 'I deny in the system dialog' },
+        examples: { zh: '在系统弹窗中拒绝', ja: 'システムダイアログで拒否する', en: 'I deny in the system dialog' },
+        run: (app) => app.device.system.denyPermission(),
+    },
+    {
+        name: 'shake',
+        expressions: { zh: '摇动设备', ja: '端末を振る', en: 'I shake the device' },
+        examples: { zh: '摇动设备', ja: '端末を振る', en: 'I shake the device' },
+        run: (app) => app.device.shake(),
+    },
+    // ---- Phase 6.9: evidence ----
+    {
+        name: 'screenshot',
+        expressions: { zh: '截图并保存为 {string}', ja: 'スクリーンショットを {string} として保存する', en: 'I take a screenshot named {string}' },
+        examples: { zh: '截图并保存为 "列表"', ja: 'スクリーンショットを "一覧" として保存する', en: 'I take a screenshot named "list"' },
+        run: (app, name) => app.device.screenshot(undefined, { name: s(name) }),
+    },
+];
+/** Arguments as `run` expects them, from the parameters in the order the language's expression has them. */
+export function argsFor(step, language, params) {
+    const order = step.order?.[language];
+    return order === undefined ? [...params] : order.map((i) => params[i]);
+}
+//# sourceMappingURL=steps.js.map

package/dist/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../src/steps.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@quiesco/steps",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Optional generic cucumber steps for Quiesco (prototyping only; write business-language steps for real projects)",
+  "license": "MIT",
+  "author": "h2nology",
+  "keywords": [
+    "quiesco",
+    "e2e",
+    "testing",
+    "expo",
+    "react-native",
+    "cucumber",
+    "gherkin",
+    "steps"
+  ],
+  "homepage": "https://github.com/h2nology/quiesco/tree/main/packages/steps#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/h2nology/quiesco.git",
+    "directory": "packages/steps"
+  },
+  "bugs": {
+    "url": "https://github.com/h2nology/quiesco/issues"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@quiesco/core": "0.1.0",
+    "@quiesco/cucumber": "0.1.0"
+  },
+  "devDependencies": {
+    "@cucumber/cucumber": "13.3.0",
+    "@cucumber/cucumber-expressions": "20.1.0"
+  },
+  "peerDependencies": {
+    "@cucumber/cucumber": ">=12"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run"
+  }
 }

package/src/index.ts

@@ -0,0 +1,74 @@
+/**
+ * @quiesco/steps — optional generic steps (requirements.md §6.11).
+ *
+ *   // features/support/steps.ts
+ *   import { registerQuiescoSteps } from '@quiesco/steps';
+ *   registerQuiescoSteps({ languages: ['zh'] });
+ *
+ * Only for prototyping and exploration: these steps script taps and texts instead of stating what the
+ * user wants. Real projects write their own business-language steps (see docs/driver-pattern.mdx).
+ */
+import { defineStep } from '@cucumber/cucumber';
+import type { QuiescoWorld } from '@quiesco/cucumber';
+
+import type { GenericStep, Language } from './steps.js';
+import { GENERIC_STEPS, argsFor } from './steps.js';
+
+export { GENERIC_STEPS, argsFor } from './steps.js';
+export type { GenericStep, Language } from './steps.js';
+
+export interface RegisterStepsOptions {
+  /** Step languages to register. Default: all (zh, ja, en). */
+  languages?: readonly Language[];
+  /** Only these steps (by `name`). Default: all. */
+  only?: readonly string[];
+}
+
+type Define = (expression: string, fn: (this: QuiescoWorld, ...params: (string | number)[]) => Promise<void>) => void;
+
+/** Number of `{…}` parameters in a cucumber expression. */
+export function parameterCount(expression: string): number {
+  return (expression.match(/\{[^}]*\}/g) ?? []).length;
+}
+
+type Body = (world: QuiescoWorld, params: (string | number)[]) => Promise<void>;
+
+/**
+ * cucumber-js checks a step function's arity against the expression's parameters, so the wrapper must
+ * declare exactly that many (a rest parameter has length 0).
+ */
+function withArity(count: number, body: Body): (this: QuiescoWorld, ...params: (string | number)[]) => Promise<void> {
+  switch (count) {
+    case 0:
+      return async function (this: QuiescoWorld) {
+        await body(this, []);
+      };
+    case 1:
+      return async function (this: QuiescoWorld, a: string | number) {
+        await body(this, [a]);
+      };
+    case 2:
+      return async function (this: QuiescoWorld, a: string | number, b: string | number) {
+        await body(this, [a, b]);
+      };
+    default:
+      throw new Error(`generic steps take at most 2 parameters (got ${count})`);
+  }
+}
+
+/** Register the generic steps with cucumber-js. Returns the expressions it registered. */
+export function registerQuiescoSteps(options: RegisterStepsOptions = {}, define: Define = defineStep as unknown as Define): string[] {
+  const languages = options.languages ?? (['zh', 'ja', 'en'] as const);
+  const steps: readonly GenericStep[] = options.only === undefined ? GENERIC_STEPS : GENERIC_STEPS.filter((st) => options.only?.includes(st.name));
+  const registered: string[] = [];
+  for (const step of steps) {
+    for (const language of languages) {
+      const expression = step.expressions[language];
+      define(expression, withArity(parameterCount(expression), async (world, params) => {
+        await step.run(world.app, ...argsFor(step, language, params));
+      }));
+      registered.push(expression);
+    }
+  }
+  return registered;
+}

package/src/steps.ts

@@ -0,0 +1,362 @@
+/**
+ * The generic steps (requirements.md §6.11), in Chinese, Japanese and English.
+ *
+ * These are operation scripts, not requirements: they describe taps and texts, not what the user wants
+ * to achieve. Use them while prototyping or exploring; a real project writes business-language steps
+ * ("When the user logs in as …") on top of `this.app` or its own driver.
+ *
+ * A quoted target is a testID (`点击 "add-todo"`); the "…文本 / テキスト / the text …" variants match
+ * the displayed text instead.
+ */
+import type { Driver } from '@quiesco/core';
+
+export type Language = 'zh' | 'ja' | 'en';
+
+export interface GenericStep {
+  /** Stable name, e.g. for docs. */
+  name: string;
+  /** Cucumber expression per language. Parameters are passed to `run` in the order they appear. */
+  expressions: Record<Language, string>;
+  /** Example step text per language (docs and tests). */
+  examples: Record<Language, string>;
+  /** Maps the language's parameters to `run` arguments when their order differs from `zh`. */
+  order?: Partial<Record<Language, number[]>>;
+  run(app: Driver, ...args: (string | number)[]): Promise<unknown>;
+}
+
+const s = (v: string | number | undefined): string => String(v);
+
+/** A word from the step text mapped to an API value; the same table serves every language. */
+function word<T>(kind: string, table: Record<string, T>, v: string | number | undefined): T {
+  const key = s(v).trim().toLowerCase();
+  const hit = table[key];
+  if (hit === undefined) throw new Error(`Unknown ${kind} "${s(v)}": use one of ${Object.keys(table).join(', ')}`);
+  return hit;
+}
+
+type Direction = 'up' | 'down' | 'left' | 'right';
+const DIRECTIONS: Record<string, Direction> = { 上: 'up', 下: 'down', 左: 'left', 右: 'right', up: 'up', down: 'down', left: 'left', right: 'right' };
+type Edge = 'top' | 'bottom' | 'left' | 'right';
+const EDGES: Record<string, Edge> = {
+  顶部: 'top', 底部: 'bottom', 最左边: 'left', 最右边: 'right',
+  一番上: 'top', 一番下: 'bottom', 左端: 'left', 右端: 'right',
+  top: 'top', bottom: 'bottom', left: 'left', right: 'right',
+};
+const ORIENTATIONS: Record<string, 'portrait' | 'landscape'> = { 竖屏: 'portrait', 横屏: 'landscape', 縦向き: 'portrait', 横向き: 'landscape', portrait: 'portrait', landscape: 'landscape' };
+const APPEARANCES: Record<string, 'light' | 'dark'> = { 浅色: 'light', 深色: 'dark', ライト: 'light', ダーク: 'dark', light: 'light', dark: 'dark' };
+type Permission = 'camera' | 'microphone' | 'location' | 'notifications' | 'contacts' | 'photos' | 'calendar';
+const PERMISSIONS: Record<string, Permission> = {
+  相机: 'camera', 麦克风: 'microphone', 定位: 'location', 通知: 'notifications', 通讯录: 'contacts', 照片: 'photos', 日历: 'calendar',
+  カメラ: 'camera', マイク: 'microphone', 位置情報: 'location', 連絡先: 'contacts', 写真: 'photos', カレンダー: 'calendar',
+  camera: 'camera', microphone: 'microphone', location: 'location', notifications: 'notifications', contacts: 'contacts', photos: 'photos', calendar: 'calendar',
+};
+
+export const GENERIC_STEPS: readonly GenericStep[] = [
+  {
+    name: 'tap',
+    expressions: { zh: '点击 {string}', ja: '{string} をタップする', en: 'I tap {string}' },
+    examples: { zh: '点击 "add-todo"', ja: '"add-todo" をタップする', en: 'I tap "add-todo"' },
+    run: (app, id) => app.tap(s(id)),
+  },
+  {
+    name: 'tapText',
+    expressions: { zh: '点击文本 {string}', ja: 'テキスト {string} をタップする', en: 'I tap the text {string}' },
+    examples: { zh: '点击文本 "保存"', ja: 'テキスト "保存" をタップする', en: 'I tap the text "Save"' },
+    run: (app, text) => app.tap({ text: s(text) }),
+  },
+  {
+    name: 'longPress',
+    expressions: { zh: '长按 {string}', ja: '{string} を長押しする', en: 'I long press {string}' },
+    examples: { zh: '长按 "todo-item"', ja: '"todo-item" を長押しする', en: 'I long press "todo-item"' },
+    run: (app, id) => app.longPress(s(id)),
+  },
+  {
+    name: 'type',
+    expressions: { zh: '在 {string} 中输入 {string}', ja: '{string} に {string} と入力する', en: 'I type {string} into {string}' },
+    examples: { zh: '在 "todo-title" 中输入 "买牛奶"', ja: '"todo-title" に "牛乳を買う" と入力する', en: 'I type "Buy milk" into "todo-title"' },
+    // en names the text first: run(target, text)
+    order: { en: [1, 0] },
+    run: (app, id, text) => app.type(s(id), s(text)),
+  },
+  {
+    name: 'clear',
+    expressions: { zh: '清空 {string} 的内容', ja: '{string} の入力をクリアする', en: 'I clear {string}' },
+    examples: { zh: '清空 "todo-title" 的内容', ja: '"todo-title" の入力をクリアする', en: 'I clear "todo-title"' },
+    run: (app, id) => app.clear(s(id)),
+  },
+  {
+    name: 'scrollTo',
+    expressions: { zh: '在 {string} 中滚动到 {string}', ja: '{string} を {string} までスクロールする', en: 'I scroll {string} to {string}' },
+    examples: { zh: '在 "todo-list" 中滚动到 "todo-item-30"', ja: '"todo-list" を "todo-item-30" までスクロールする', en: 'I scroll "todo-list" to "todo-item-30"' },
+    run: (app, container, target) => app.scrollTo(s(container), s(target)),
+  },
+  {
+    name: 'dismissKeyboard',
+    expressions: { zh: '收起键盘', ja: 'キーボードを閉じる', en: 'I dismiss the keyboard' },
+    examples: { zh: '收起键盘', ja: 'キーボードを閉じる', en: 'I dismiss the keyboard' },
+    run: (app) => app.dismissKeyboard(),
+  },
+  {
+    name: 'pressBack',
+    expressions: { zh: '按返回键', ja: '戻るボタンを押す', en: 'I press back' },
+    examples: { zh: '按返回键', ja: '戻るボタンを押す', en: 'I press back' },
+    run: (app) => app.pressBack(),
+  },
+  {
+    name: 'openUrl',
+    expressions: { zh: '打开链接 {string}', ja: 'リンク {string} を開く', en: 'I open the link {string}' },
+    examples: { zh: '打开链接 "myapp://todos"', ja: 'リンク "myapp://todos" を開く', en: 'I open the link "myapp://todos"' },
+    run: (app, url) => app.openUrl(s(url)),
+  },
+  {
+    name: 'seeText',
+    expressions: { zh: '看到文本 {string}', ja: 'テキスト {string} が表示されている', en: 'I see the text {string}' },
+    examples: { zh: '看到文本 "买牛奶"', ja: 'テキスト "牛乳を買う" が表示されている', en: 'I see the text "Buy milk"' },
+    run: (app, text) => app.expectVisible({ text: s(text) }),
+  },
+  {
+    name: 'notSeeText',
+    expressions: { zh: '看不到文本 {string}', ja: 'テキスト {string} が表示されていない', en: 'I do not see the text {string}' },
+    examples: { zh: '看不到文本 "买牛奶"', ja: 'テキスト "牛乳を買う" が表示されていない', en: 'I do not see the text "Buy milk"' },
+    run: (app, text) => app.expectNotVisible({ text: s(text) }),
+  },
+  {
+    name: 'visible',
+    expressions: { zh: '元素 {string} 可见', ja: '要素 {string} が表示されている', en: 'the element {string} is visible' },
+    examples: { zh: '元素 "todo-list" 可见', ja: '要素 "todo-list" が表示されている', en: 'the element "todo-list" is visible' },
+    run: (app, id) => app.expectVisible(s(id)),
+  },
+  {
+    name: 'notVisible',
+    expressions: { zh: '元素 {string} 不可见', ja: '要素 {string} が表示されていない', en: 'the element {string} is not visible' },
+    examples: { zh: '元素 "todo-title-error" 不可见', ja: '要素 "todo-title-error" が表示されていない', en: 'the element "todo-title-error" is not visible' },
+    run: (app, id) => app.expectNotVisible(s(id)),
+  },
+  {
+    name: 'hasText',
+    expressions: { zh: '元素 {string} 的文本是 {string}', ja: '要素 {string} のテキストが {string} である', en: 'the element {string} has the text {string}' },
+    examples: { zh: '元素 "greeting" 的文本是 "a@example.com"', ja: '要素 "greeting" のテキストが "a@example.com" である', en: 'the element "greeting" has the text "a@example.com"' },
+    run: (app, id, text) => app.expectText(s(id), s(text)),
+  },
+  {
+    name: 'count',
+    expressions: { zh: '元素 {string} 共有 {int} 个', ja: '要素 {string} が {int} 個ある', en: 'there are {int} elements {string}' },
+    examples: { zh: '元素 "todo-item" 共有 2 个', ja: '要素 "todo-item" が 2 個ある', en: 'there are 2 elements "todo-item"' },
+    // en names the count first: run(target, count)
+    order: { en: [1, 0] },
+    run: (app, id, count) => app.expectCount(s(id), Number(count)),
+  },
+  // ---- Phase 6.2 – 6.4: more actions ----
+  {
+    name: 'doubleTap',
+    expressions: { zh: '双击 {string}', ja: '{string} をダブルタップする', en: 'I double tap {string}' },
+    examples: { zh: '双击 "photo"', ja: '"photo" をダブルタップする', en: 'I double tap "photo"' },
+    run: (app, id) => app.doubleTap(s(id)),
+  },
+  {
+    name: 'replaceText',
+    expressions: { zh: '把 {string} 的内容替换为 {string}', ja: '{string} の入力を {string} に置き換える', en: 'I replace the text of {string} with {string}' },
+    examples: { zh: '把 "todo-title" 的内容替换为 "买面包"', ja: '"todo-title" の入力を "パンを買う" に置き換える', en: 'I replace the text of "todo-title" with "Buy bread"' },
+    run: (app, id, text) => app.replaceText(s(id), s(text)),
+  },
+  {
+    name: 'pressEnter',
+    expressions: { zh: '在 {string} 中按回车', ja: '{string} でエンターキーを押す', en: 'I press enter in {string}' },
+    examples: { zh: '在 "todo-title" 中按回车', ja: '"todo-title" でエンターキーを押す', en: 'I press enter in "todo-title"' },
+    run: (app, id) => app.pressKey(s(id), 'enter'),
+  },
+  {
+    name: 'scroll',
+    expressions: { zh: '在 {string} 中向{word}滚动', ja: '{string} を{word}にスクロールする', en: 'I scroll {string} {word}' },
+    examples: { zh: '在 "todo-list" 中向下滚动', ja: '"todo-list" を下にスクロールする', en: 'I scroll "todo-list" down' },
+    run: (app, id, dir) => app.scroll(s(id), word('direction', DIRECTIONS, dir)),
+  },
+  {
+    name: 'scrollToEdge',
+    expressions: { zh: '把 {string} 滚动到{word}', ja: '{string} を{word}までスクロールする', en: 'I scroll {string} to the {word}' },
+    examples: { zh: '把 "todo-list" 滚动到底部', ja: '"todo-list" を一番下までスクロールする', en: 'I scroll "todo-list" to the bottom' },
+    run: (app, id, edge) => app.scrollToEdge(s(id), word('edge', EDGES, edge)),
+  },
+  {
+    name: 'swipe',
+    expressions: { zh: '在 {string} 上向{word}滑动', ja: '{string} を{word}にスワイプする', en: 'I swipe {word} on {string}' },
+    examples: { zh: '在 "todo-item" 上向左滑动', ja: '"todo-item" を左にスワイプする', en: 'I swipe left on "todo-item"' },
+    // en names the direction first: run(target, direction)
+    order: { en: [1, 0] },
+    run: (app, id, dir) => app.swipe(s(id), word('direction', DIRECTIONS, dir)),
+  },
+  {
+    name: 'drag',
+    expressions: { zh: '把 {string} 拖到 {string}', ja: '{string} を {string} までドラッグする', en: 'I drag {string} to {string}' },
+    examples: { zh: '把 "item-1" 拖到 "item-3"', ja: '"item-1" を "item-3" までドラッグする', en: 'I drag "item-1" to "item-3"' },
+    run: (app, from, to) => app.drag(s(from), s(to)),
+  },
+  {
+    name: 'pinch',
+    expressions: { zh: '在 {string} 上双指缩放到 {float} 倍', ja: '{string} を {float} 倍にピンチする', en: 'I pinch {string} to {float} times' },
+    examples: { zh: '在 "photo" 上双指缩放到 2 倍', ja: '"photo" を 2 倍にピンチする', en: 'I pinch "photo" to 2 times' },
+    run: (app, id, scale) => app.pinch(s(id), Number(scale)),
+  },
+  // ---- Phase 6.3: value controls ----
+  {
+    name: 'setSlider',
+    expressions: { zh: '把滑块 {string} 设为 {float}', ja: 'スライダー {string} を {float} にする', en: 'I set the slider {string} to {float}' },
+    examples: { zh: '把滑块 "volume" 设为 30', ja: 'スライダー "volume" を 30 にする', en: 'I set the slider "volume" to 30' },
+    run: (app, id, value) => app.setValue(s(id), Number(value)),
+  },
+  {
+    name: 'switchOn',
+    expressions: { zh: '打开开关 {string}', ja: 'スイッチ {string} をオンにする', en: 'I turn on the switch {string}' },
+    examples: { zh: '打开开关 "notify"', ja: 'スイッチ "notify" をオンにする', en: 'I turn on the switch "notify"' },
+    run: (app, id) => app.setValue(s(id), true),
+  },
+  {
+    name: 'switchOff',
+    expressions: { zh: '关闭开关 {string}', ja: 'スイッチ {string} をオフにする', en: 'I turn off the switch {string}' },
+    examples: { zh: '关闭开关 "notify"', ja: 'スイッチ "notify" をオフにする', en: 'I turn off the switch "notify"' },
+    run: (app, id) => app.setValue(s(id), false),
+  },
+  {
+    name: 'select',
+    expressions: { zh: '在 {string} 中选择 {string}', ja: '{string} で {string} を選ぶ', en: 'I select {string} in {string}' },
+    examples: { zh: '在 "priority" 中选择 "高"', ja: '"priority" で "高" を選ぶ', en: 'I select "High" in "priority"' },
+    // en names the option first: run(target, option)
+    order: { en: [1, 0] },
+    run: (app, id, option) => app.setValue(s(id), s(option)),
+  },
+  // ---- Phase 6.1: state assertions ----
+  {
+    name: 'enabled',
+    expressions: { zh: '元素 {string} 可用', ja: '要素 {string} が有効である', en: 'the element {string} is enabled' },
+    examples: { zh: '元素 "save" 可用', ja: '要素 "save" が有効である', en: 'the element "save" is enabled' },
+    run: (app, id) => app.expectEnabled(s(id)),
+  },
+  {
+    name: 'disabled',
+    expressions: { zh: '元素 {string} 不可用', ja: '要素 {string} が無効である', en: 'the element {string} is disabled' },
+    examples: { zh: '元素 "save" 不可用', ja: '要素 "save" が無効である', en: 'the element "save" is disabled' },
+    run: (app, id) => app.expectDisabled(s(id)),
+  },
+  {
+    name: 'checked',
+    expressions: { zh: '元素 {string} 已选中', ja: '要素 {string} がオンである', en: 'the element {string} is checked' },
+    examples: { zh: '元素 "notify" 已选中', ja: '要素 "notify" がオンである', en: 'the element "notify" is checked' },
+    run: (app, id) => app.expectChecked(s(id)),
+  },
+  {
+    name: 'notChecked',
+    expressions: { zh: '元素 {string} 未选中', ja: '要素 {string} がオフである', en: 'the element {string} is not checked' },
+    examples: { zh: '元素 "notify" 未选中', ja: '要素 "notify" がオフである', en: 'the element "notify" is not checked' },
+    run: (app, id) => app.expectNotChecked(s(id)),
+  },
+  {
+    name: 'focused',
+    expressions: { zh: '元素 {string} 获得焦点', ja: '要素 {string} にフォーカスがある', en: 'the element {string} has the focus' },
+    examples: { zh: '元素 "todo-title" 获得焦点', ja: '要素 "todo-title" にフォーカスがある', en: 'the element "todo-title" has the focus' },
+    run: (app, id) => app.expectFocused(s(id)),
+  },
+  {
+    name: 'hasValue',
+    expressions: { zh: '元素 {string} 的值是 {string}', ja: '要素 {string} の値が {string} である', en: 'the element {string} has the value {string}' },
+    examples: { zh: '元素 "priority" 的值是 "high"', ja: '要素 "priority" の値が "high" である', en: 'the element "priority" has the value "high"' },
+    run: (app, id, value) => app.expectValue(s(id), s(value)),
+  },
+  {
+    name: 'sliderValue',
+    expressions: { zh: '滑块 {string} 的值是 {float}', ja: 'スライダー {string} の値が {float} である', en: 'the slider {string} has the value {float}' },
+    examples: { zh: '滑块 "volume" 的值是 30', ja: 'スライダー "volume" の値が 30 である', en: 'the slider "volume" has the value 30' },
+    run: (app, id, value) => app.expectValue(s(id), Number(value)),
+  },
+  // ---- Phase 6.5: app lifecycle ----
+  {
+    name: 'background',
+    expressions: { zh: '把 App 切到后台', ja: 'アプリをバックグラウンドにする', en: 'I send the app to the background' },
+    examples: { zh: '把 App 切到后台', ja: 'アプリをバックグラウンドにする', en: 'I send the app to the background' },
+    run: (app) => app.device.sendToBackground(),
+  },
+  {
+    name: 'foreground',
+    expressions: { zh: '把 App 切回前台', ja: 'アプリをフォアグラウンドに戻す', en: 'I bring the app to the foreground' },
+    examples: { zh: '把 App 切回前台', ja: 'アプリをフォアグラウンドに戻す', en: 'I bring the app to the foreground' },
+    run: (app) => app.device.bringToForeground(),
+  },
+  {
+    name: 'relaunch',
+    expressions: { zh: '重新启动 App', ja: 'アプリを再起動する', en: 'I relaunch the app' },
+    examples: { zh: '重新启动 App', ja: 'アプリを再起動する', en: 'I relaunch the app' },
+    run: (app) => app.device.relaunch(),
+  },
+  // ---- Phase 6.6 / 6.7: device state and system UI ----
+  {
+    name: 'orientation',
+    expressions: { zh: '把设备转到{word}', ja: '画面を{word}にする', en: 'I rotate the device to {word}' },
+    examples: { zh: '把设备转到横屏', ja: '画面を横向きにする', en: 'I rotate the device to landscape' },
+    run: (app, o) => app.device.setOrientation(word('orientation', ORIENTATIONS, o)),
+  },
+  {
+    name: 'appearance',
+    expressions: { zh: '把外观设为{word}模式', ja: '外観を{word}モードにする', en: 'I switch to {word} mode' },
+    examples: { zh: '把外观设为深色模式', ja: '外観をダークモードにする', en: 'I switch to dark mode' },
+    run: (app, a) => app.device.setAppearance(word('appearance', APPEARANCES, a)),
+  },
+  {
+    name: 'location',
+    expressions: { zh: '把设备位置设为 {float}, {float}', ja: '端末の位置を {float}, {float} にする', en: 'I set the device location to {float}, {float}' },
+    examples: { zh: '把设备位置设为 35.68, 139.76', ja: '端末の位置を 35.68, 139.76 にする', en: 'I set the device location to 35.68, 139.76' },
+    run: (app, lat, lon) => app.device.setLocation(Number(lat), Number(lon)),
+  },
+  {
+    name: 'offline',
+    expressions: { zh: '把设备切换到离线', ja: '端末をオフラインにする', en: 'I go offline' },
+    examples: { zh: '把设备切换到离线', ja: '端末をオフラインにする', en: 'I go offline' },
+    run: (app) => app.device.setNetwork('offline'),
+  },
+  {
+    name: 'online',
+    expressions: { zh: '把设备切换到在线', ja: '端末をオンラインにする', en: 'I go online' },
+    examples: { zh: '把设备切换到在线', ja: '端末をオンラインにする', en: 'I go online' },
+    run: (app) => app.device.setNetwork('online'),
+  },
+  {
+    name: 'grantPermission',
+    expressions: { zh: '授予 App {word}权限', ja: 'アプリに{word}の権限を与える', en: 'I grant the {word} permission' },
+    examples: { zh: '授予 App 定位权限', ja: 'アプリに位置情報の権限を与える', en: 'I grant the location permission' },
+    run: (app, p) => app.device.setPermission(word('permission', PERMISSIONS, p), 'grant'),
+  },
+  {
+    name: 'revokePermission',
+    expressions: { zh: '撤销 App 的{word}权限', ja: 'アプリの{word}の権限を取り消す', en: 'I revoke the {word} permission' },
+    examples: { zh: '撤销 App 的定位权限', ja: 'アプリの位置情報の権限を取り消す', en: 'I revoke the location permission' },
+    run: (app, p) => app.device.setPermission(word('permission', PERMISSIONS, p), 'revoke'),
+  },
+  {
+    name: 'allowDialog',
+    expressions: { zh: '在系统弹窗中允许', ja: 'システムダイアログで許可する', en: 'I allow in the system dialog' },
+    examples: { zh: '在系统弹窗中允许', ja: 'システムダイアログで許可する', en: 'I allow in the system dialog' },
+    run: (app) => app.device.system.allowPermission(),
+  },
+  {
+    name: 'denyDialog',
+    expressions: { zh: '在系统弹窗中拒绝', ja: 'システムダイアログで拒否する', en: 'I deny in the system dialog' },
+    examples: { zh: '在系统弹窗中拒绝', ja: 'システムダイアログで拒否する', en: 'I deny in the system dialog' },
+    run: (app) => app.device.system.denyPermission(),
+  },
+  {
+    name: 'shake',
+    expressions: { zh: '摇动设备', ja: '端末を振る', en: 'I shake the device' },
+    examples: { zh: '摇动设备', ja: '端末を振る', en: 'I shake the device' },
+    run: (app) => app.device.shake(),
+  },
+  // ---- Phase 6.9: evidence ----
+  {
+    name: 'screenshot',
+    expressions: { zh: '截图并保存为 {string}', ja: 'スクリーンショットを {string} として保存する', en: 'I take a screenshot named {string}' },
+    examples: { zh: '截图并保存为 "列表"', ja: 'スクリーンショットを "一覧" として保存する', en: 'I take a screenshot named "list"' },
+    run: (app, name) => app.device.screenshot(undefined, { name: s(name) }),
+  },
+];
+/** Arguments as `run` expects them, from the parameters in the order the language's expression has them. */
+export function argsFor(step: GenericStep, language: Language, params: readonly (string | number)[]): (string | number)[] {
+  const order = step.order?.[language];
+  return order === undefined ? [...params] : order.map((i) => params[i] as string | number);
+}