@quiesco/cucumber 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,32 @@
-# Temporary Holding Version
+# @quiesco/cucumber
 
-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.
+cucumber-js World and hooks for Quiesco: one session for the run, a reset before every scenario,
+`this.app` in step definitions, platform tags (`@ios`, `@android`, `@web`, `@native`) and evidence
+(screenshot, element tree, idle state) attached to failed scenarios.
+
+```sh
+npm i -D @quiesco/cucumber @cucumber/cucumber
+```
+
+```ts
+// features/support/quiesco.ts
+import '@quiesco/cucumber/register';
+
+// features/step_definitions/todo.steps.ts
+import { When } from '@cucumber/cucumber';
+import type { QuiescoWorld } from '@quiesco/cucumber';
+
+When('they add a todo {string}', async function (this: QuiescoWorld, title: string) {
+  await this.app.tap('add-todo');                 // waits until the app is idle, then taps
+  await this.app.type('todo-title', title);
+});
+```
+
+Run with `npx quiesco test --platform ios|android|web`. [API reference](https://shift-14cc7601.mintlify.site/api),
+[driver pattern](https://shift-14cc7601.mintlify.site/driver-pattern), [parallel runs](https://shift-14cc7601.mintlify.site/parallel).
+
+Part of [Quiesco](https://github.com/h2nology/quiesco): gray-box end-to-end testing for Expo apps on iOS, Android and the web. Setup: `npx quiesco init` ([quick start](https://github.com/h2nology/quiesco#quick-start-web-about-10-minutes)).
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { registerQuiesco } from './register-hooks.js';
+export type { RegisterOptions } from './register-hooks.js';
+export { QuiescoWorld } from './world.js';
+export { Lifecycle, tagLevels } from './lifecycle.js';
+export type { Attachment, LifecycleOptions, ScenarioResult } from './lifecycle.js';
+//# 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":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { registerQuiesco } from './register-hooks.js';
+export { QuiescoWorld } from './world.js';
+export { Lifecycle, tagLevels } from './lifecycle.js';
+//# 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,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,45 @@
+/**
+ * cucumber-js on top of core's runner-independent Lifecycle (requirements.md §6.10): Gherkin tag levels
+ * and `--parallel` workers (Phase 6.12). Kept free of cucumber imports so it can be unit-tested.
+ */
+import { Lifecycle as CoreLifecycle } from '@quiesco/core';
+import type { LifecycleOptions as CoreOptions, WorkerInfo } from '@quiesco/core';
+export type { Attachment, ScenarioResult } from '@quiesco/core';
+export type LifecycleOptions = CoreOptions;
+interface TaggedNode {
+    tags: readonly {
+        id: string;
+    }[];
+}
+interface ScenarioNode extends TaggedNode {
+    examples: readonly TaggedNode[];
+}
+interface FeatureChild {
+    rule?: TaggedNode & {
+        children: readonly FeatureChild[];
+    };
+    scenario?: ScenarioNode;
+}
+/** The parts of a cucumber-js GherkinDocument needed to place tags (structural, no cucumber import). */
+export interface TagSource {
+    feature?: (TaggedNode & {
+        children: readonly FeatureChild[];
+    }) | undefined;
+}
+/**
+ * A pickle's tags grouped by Gherkin level: [feature, rule, scenario, examples]. Tags whose node is
+ * not found count as scenario tags.
+ */
+export declare function tagLevels(pickleTags: readonly {
+    name: string;
+    astNodeId: string;
+}[], doc: TagSource): string[][];
+/**
+ * The worker this thread is: cucumber-js `--parallel N` runs N worker threads and sets
+ * CUCUMBER_WORKER_ID ("0"…) and CUCUMBER_TOTAL_WORKERS in each one's environment (findings 4.6).
+ */
+export declare function cucumberWorker(env: NodeJS.ProcessEnv): WorkerInfo;
+export declare class Lifecycle extends CoreLifecycle {
+    constructor(options?: LifecycleOptions);
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,IAAI,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEjF,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAE3C,UAAU,UAAU;IAClB,IAAI,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjC;AACD,UAAU,YAAa,SAAQ,UAAU;IACvC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;CACjC;AACD,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,UAAU,GAAG;QAAE,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;KAAE,CAAC;IAC1D,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AACD,wGAAwG;AACxG,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,CAAC,UAAU,GAAG;QAAE,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;CAC5E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,EAAE,EAAE,CAsBhH;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,UAAU,CAKjE;AAED,qBAAa,SAAU,SAAQ,aAAa;gBAC9B,OAAO,GAAE,gBAAqB;CAG3C"}

package/dist/lifecycle.js

@@ -0,0 +1,50 @@
+/**
+ * cucumber-js on top of core's runner-independent Lifecycle (requirements.md §6.10): Gherkin tag levels
+ * and `--parallel` workers (Phase 6.12). Kept free of cucumber imports so it can be unit-tested.
+ */
+import { Lifecycle as CoreLifecycle } from '@quiesco/core';
+/**
+ * A pickle's tags grouped by Gherkin level: [feature, rule, scenario, examples]. Tags whose node is
+ * not found count as scenario tags.
+ */
+export function tagLevels(pickleTags, doc) {
+    const level = new Map();
+    const mark = (node, l) => node.tags.forEach((t) => level.set(t.id, l));
+    const walk = (children) => {
+        for (const c of children) {
+            if (c.rule !== undefined) {
+                mark(c.rule, 1);
+                walk(c.rule.children);
+            }
+            if (c.scenario !== undefined) {
+                mark(c.scenario, 2);
+                c.scenario.examples.forEach((e) => mark(e, 3));
+            }
+        }
+    };
+    if (doc.feature !== undefined) {
+        mark(doc.feature, 0);
+        walk(doc.feature.children);
+    }
+    const out = [[], [], [], []];
+    for (const t of pickleTags)
+        out[level.get(t.astNodeId) ?? 2]?.push(t.name);
+    return out;
+}
+/**
+ * The worker this thread is: cucumber-js `--parallel N` runs N worker threads and sets
+ * CUCUMBER_WORKER_ID ("0"…) and CUCUMBER_TOTAL_WORKERS in each one's environment (findings 4.6).
+ */
+export function cucumberWorker(env) {
+    const count = Number.parseInt(env['CUCUMBER_TOTAL_WORKERS'] ?? '', 10);
+    const index = Number.parseInt(env['CUCUMBER_WORKER_ID'] ?? '', 10);
+    if (!(count > 1) || !(index >= 0))
+        return { index: 0, count: 1 };
+    return { index, count };
+}
+export class Lifecycle extends CoreLifecycle {
+    constructor(options = {}) {
+        super({ worker: cucumberWorker(options.env ?? process.env), ...options });
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,eAAe,CAAC;AAqB3D;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,UAA0D,EAAE,GAAc;IAClG,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,MAAM,IAAI,GAAG,CAAC,IAAgB,EAAE,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3F,MAAM,IAAI,GAAG,CAAC,QAAiC,EAAE,EAAE;QACjD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBAChB,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxB,CAAC;YACD,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC7B,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;gBACpB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,GAAG,GAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,UAAU;QAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAsB;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACjE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,OAAO,SAAU,SAAQ,aAAa;IAC1C,YAAY,UAA4B,EAAE;QACxC,KAAK,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/register-hooks.d.ts

@@ -0,0 +1,19 @@
+import { Lifecycle } from './lifecycle.js';
+import type { LifecycleOptions } from './lifecycle.js';
+import { QuiescoWorld } from './world.js';
+export interface RegisterOptions extends LifecycleOptions {
+    /** Use your own World (must extend QuiescoWorld). Default QuiescoWorld. */
+    world?: typeof QuiescoWorld;
+    /** Default step timeout. Each driver call has its own sync timeout; this caps a whole step. Default 60 s. */
+    stepTimeoutMs?: number;
+    /** BeforeAll timeout: booting an emulator can take minutes. Default 10 min. */
+    setupTimeoutMs?: number;
+    /**
+     * Timeout of the per-scenario reset (Before). It can start the app again when it is gone, which waits up to
+     * 3 × the connect timeout. Default 3 min.
+     */
+    resetTimeoutMs?: number;
+}
+/** Register the World and the lifecycle hooks with cucumber-js. Call once, from a support file. */
+export declare function registerQuiesco(options?: RegisterOptions): Lifecycle;
+//# sourceMappingURL=register-hooks.d.ts.map

package/dist/register-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-hooks.d.ts","sourceRoot":"","sources":["../src/register-hooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAa,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,YAAY,CAAC;IAC5B,6GAA6G;IAC7G,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,OAAO,GAAE,eAAoB,GAAG,SAAS,CAkBxE"}

package/dist/register-hooks.js

@@ -0,0 +1,25 @@
+import { After, AfterAll, Before, BeforeAll, Status, setDefaultTimeout, setWorldConstructor } from '@cucumber/cucumber';
+import { Lifecycle, tagLevels } from './lifecycle.js';
+import { QuiescoWorld, bindLifecycle } from './world.js';
+/** Register the World and the lifecycle hooks with cucumber-js. Call once, from a support file. */
+export function registerQuiesco(options = {}) {
+    const lifecycle = new Lifecycle(options);
+    bindLifecycle(lifecycle);
+    setWorldConstructor(options.world ?? QuiescoWorld);
+    setDefaultTimeout(options.stepTimeoutMs ?? 60_000);
+    BeforeAll({ name: 'quiesco: start session', timeout: options.setupTimeoutMs ?? 600_000 }, () => lifecycle.beforeAll());
+    Before({ name: 'quiesco: reset app', timeout: options.resetTimeoutMs ?? 180_000 }, ({ pickle, gherkinDocument }) => lifecycle.before(tagLevels(pickle.tags, gherkinDocument), pickle.name));
+    After({ name: 'quiesco: evidence' }, async function ({ pickle, result }) {
+        const failed = result !== undefined && result.status !== Status.PASSED && result.status !== Status.SKIPPED;
+        for (const a of (await lifecycle.after({ tags: pickle.tags.map((t) => t.name), failed })).attachments) {
+            const opts = a.fileName !== undefined ? { mediaType: a.mediaType, fileName: a.fileName } : { mediaType: a.mediaType };
+            if (typeof a.data === 'string')
+                this.attach(a.data, opts);
+            else
+                this.attach(a.data, opts);
+        }
+    });
+    AfterAll({ name: 'quiesco: stop session', timeout: 120_000 }, () => lifecycle.afterAll());
+    return lifecycle;
+}
+//# sourceMappingURL=register-hooks.js.map

package/dist/register-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-hooks.js","sourceRoot":"","sources":["../src/register-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAExH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgBzD,mGAAmG;AACnG,MAAM,UAAU,eAAe,CAAC,UAA2B,EAAE;IAC3D,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;IACzC,aAAa,CAAC,SAAS,CAAC,CAAC;IACzB,mBAAmB,CAAC,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,CAAC;IACnD,iBAAiB,CAAC,OAAO,CAAC,aAAa,IAAI,MAAM,CAAC,CAAC;IAEnD,SAAS,CAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,IAAI,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;IACvH,MAAM,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,IAAI,OAAO,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5L,KAAK,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,KAAK,WAA+B,EAAE,MAAM,EAAE,MAAM,EAAE;QACzF,MAAM,MAAM,GAAG,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,CAAC;QAC3G,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACtG,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;YACtH,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;;gBACrD,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1F,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/register.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":""}

package/dist/register.js

@@ -0,0 +1,4 @@
+// `import '@quiesco/cucumber/register'` in a support file: World + hooks with defaults.
+import { registerQuiesco } from './register-hooks.js';
+registerQuiesco();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,eAAe,EAAE,CAAC"}

package/dist/world.d.ts

@@ -0,0 +1,16 @@
+import { World } from '@cucumber/cucumber';
+import type { IWorldOptions } from '@cucumber/cucumber';
+import type { Driver, Session } from '@quiesco/core';
+import type { Lifecycle } from './lifecycle.js';
+/** @internal set by registerQuiesco(). */
+export declare function bindLifecycle(l: Lifecycle): void;
+/**
+ * Cucumber World with `this.app` (the Quiesco Driver). Extend it to add your own business driver
+ * (Ports & Adapters): `class MyWorld extends QuiescoWorld { todos = new TodoDriver(this.app) }`.
+ */
+export declare class QuiescoWorld<Parameters = unknown> extends World<Parameters> {
+    constructor(options: IWorldOptions<Parameters>);
+    get app(): Driver;
+    get session(): Session;
+}
+//# sourceMappingURL=world.d.ts.map

package/dist/world.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../src/world.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD,0CAA0C;AAC1C,wBAAgB,aAAa,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAEhD;AAED;;;GAGG;AACH,qBAAa,YAAY,CAAC,UAAU,GAAG,OAAO,CAAE,SAAQ,KAAK,CAAC,UAAU,CAAC;gBAC3D,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC;IAI9C,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,OAAO,IAAI,OAAO,CAGrB;CACF"}

package/dist/world.js

@@ -0,0 +1,24 @@
+import { World } from '@cucumber/cucumber';
+let lifecycle = null;
+/** @internal set by registerQuiesco(). */
+export function bindLifecycle(l) {
+    lifecycle = l;
+}
+/**
+ * Cucumber World with `this.app` (the Quiesco Driver). Extend it to add your own business driver
+ * (Ports & Adapters): `class MyWorld extends QuiescoWorld { todos = new TodoDriver(this.app) }`.
+ */
+export class QuiescoWorld extends World {
+    constructor(options) {
+        super(options);
+    }
+    get app() {
+        return this.session.driver;
+    }
+    get session() {
+        if (lifecycle === null)
+            throw new Error("Quiesco is not registered: import '@quiesco/cucumber/register' in a support file");
+        return lifecycle.current;
+    }
+}
+//# sourceMappingURL=world.js.map

package/dist/world.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.js","sourceRoot":"","sources":["../src/world.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAM3C,IAAI,SAAS,GAAqB,IAAI,CAAC;AAEvC,0CAA0C;AAC1C,MAAM,UAAU,aAAa,CAAC,CAAY;IACxC,SAAS,GAAG,CAAC,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,YAAmC,SAAQ,KAAiB;IACvE,YAAY,OAAkC;QAC5C,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO;QACT,IAAI,SAAS,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;QAC5H,OAAO,SAAS,CAAC,OAAO,CAAC;IAC3B,CAAC;CACF"}

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "@quiesco/cucumber",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "cucumber-js World and hooks for Quiesco",
+  "license": "MIT",
+  "author": "h2nology",
+  "keywords": [
+    "quiesco",
+    "e2e",
+    "testing",
+    "expo",
+    "react-native",
+    "cucumber",
+    "bdd",
+    "gherkin"
+  ],
+  "homepage": "https://github.com/h2nology/quiesco/tree/main/packages/cucumber#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/h2nology/quiesco.git",
+    "directory": "packages/cucumber"
+  },
+  "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"
+    },
+    "./register": {
+      "types": "./dist/register.d.ts",
+      "import": "./dist/register.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@quiesco/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@cucumber/cucumber": "13.3.0"
+  },
+  "peerDependencies": {
+    "@cucumber/cucumber": ">=12"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run"
+  }
 }

package/src/index.ts

@@ -0,0 +1,5 @@
+export { registerQuiesco } from './register-hooks.js';
+export type { RegisterOptions } from './register-hooks.js';
+export { QuiescoWorld } from './world.js';
+export { Lifecycle, tagLevels } from './lifecycle.js';
+export type { Attachment, LifecycleOptions, ScenarioResult } from './lifecycle.js';

package/src/lifecycle.ts

@@ -0,0 +1,69 @@
+/**
+ * cucumber-js on top of core's runner-independent Lifecycle (requirements.md §6.10): Gherkin tag levels
+ * and `--parallel` workers (Phase 6.12). Kept free of cucumber imports so it can be unit-tested.
+ */
+import { Lifecycle as CoreLifecycle } from '@quiesco/core';
+import type { LifecycleOptions as CoreOptions, WorkerInfo } from '@quiesco/core';
+
+export type { Attachment, ScenarioResult } from '@quiesco/core';
+export type LifecycleOptions = CoreOptions;
+
+interface TaggedNode {
+  tags: readonly { id: string }[];
+}
+interface ScenarioNode extends TaggedNode {
+  examples: readonly TaggedNode[];
+}
+interface FeatureChild {
+  rule?: TaggedNode & { children: readonly FeatureChild[] };
+  scenario?: ScenarioNode;
+}
+/** The parts of a cucumber-js GherkinDocument needed to place tags (structural, no cucumber import). */
+export interface TagSource {
+  feature?: (TaggedNode & { children: readonly FeatureChild[] }) | undefined;
+}
+
+/**
+ * A pickle's tags grouped by Gherkin level: [feature, rule, scenario, examples]. Tags whose node is
+ * not found count as scenario tags.
+ */
+export function tagLevels(pickleTags: readonly { name: string; astNodeId: string }[], doc: TagSource): string[][] {
+  const level = new Map<string, number>();
+  const mark = (node: TaggedNode, l: number) => node.tags.forEach((t) => level.set(t.id, l));
+  const walk = (children: readonly FeatureChild[]) => {
+    for (const c of children) {
+      if (c.rule !== undefined) {
+        mark(c.rule, 1);
+        walk(c.rule.children);
+      }
+      if (c.scenario !== undefined) {
+        mark(c.scenario, 2);
+        c.scenario.examples.forEach((e) => mark(e, 3));
+      }
+    }
+  };
+  if (doc.feature !== undefined) {
+    mark(doc.feature, 0);
+    walk(doc.feature.children);
+  }
+  const out: string[][] = [[], [], [], []];
+  for (const t of pickleTags) out[level.get(t.astNodeId) ?? 2]?.push(t.name);
+  return out;
+}
+
+/**
+ * The worker this thread is: cucumber-js `--parallel N` runs N worker threads and sets
+ * CUCUMBER_WORKER_ID ("0"…) and CUCUMBER_TOTAL_WORKERS in each one's environment (findings 4.6).
+ */
+export function cucumberWorker(env: NodeJS.ProcessEnv): WorkerInfo {
+  const count = Number.parseInt(env['CUCUMBER_TOTAL_WORKERS'] ?? '', 10);
+  const index = Number.parseInt(env['CUCUMBER_WORKER_ID'] ?? '', 10);
+  if (!(count > 1) || !(index >= 0)) return { index: 0, count: 1 };
+  return { index, count };
+}
+
+export class Lifecycle extends CoreLifecycle {
+  constructor(options: LifecycleOptions = {}) {
+    super({ worker: cucumberWorker(options.env ?? process.env), ...options });
+  }
+}

package/src/register-hooks.ts

@@ -0,0 +1,40 @@
+import { After, AfterAll, Before, BeforeAll, Status, setDefaultTimeout, setWorldConstructor } from '@cucumber/cucumber';
+
+import { Lifecycle, tagLevels } from './lifecycle.js';
+import type { LifecycleOptions } from './lifecycle.js';
+import { QuiescoWorld, bindLifecycle } from './world.js';
+
+export interface RegisterOptions extends LifecycleOptions {
+  /** Use your own World (must extend QuiescoWorld). Default QuiescoWorld. */
+  world?: typeof QuiescoWorld;
+  /** Default step timeout. Each driver call has its own sync timeout; this caps a whole step. Default 60 s. */
+  stepTimeoutMs?: number;
+  /** BeforeAll timeout: booting an emulator can take minutes. Default 10 min. */
+  setupTimeoutMs?: number;
+  /**
+   * Timeout of the per-scenario reset (Before). It can start the app again when it is gone, which waits up to
+   * 3 × the connect timeout. Default 3 min.
+   */
+  resetTimeoutMs?: number;
+}
+
+/** Register the World and the lifecycle hooks with cucumber-js. Call once, from a support file. */
+export function registerQuiesco(options: RegisterOptions = {}): Lifecycle {
+  const lifecycle = new Lifecycle(options);
+  bindLifecycle(lifecycle);
+  setWorldConstructor(options.world ?? QuiescoWorld);
+  setDefaultTimeout(options.stepTimeoutMs ?? 60_000);
+
+  BeforeAll({ name: 'quiesco: start session', timeout: options.setupTimeoutMs ?? 600_000 }, () => lifecycle.beforeAll());
+  Before({ name: 'quiesco: reset app', timeout: options.resetTimeoutMs ?? 180_000 }, ({ pickle, gherkinDocument }) => lifecycle.before(tagLevels(pickle.tags, gherkinDocument), pickle.name));
+  After({ name: 'quiesco: evidence' }, async function (this: QuiescoWorld, { pickle, result }) {
+    const failed = result !== undefined && result.status !== Status.PASSED && result.status !== Status.SKIPPED;
+    for (const a of (await lifecycle.after({ tags: pickle.tags.map((t) => t.name), failed })).attachments) {
+      const opts = a.fileName !== undefined ? { mediaType: a.mediaType, fileName: a.fileName } : { mediaType: a.mediaType };
+      if (typeof a.data === 'string') this.attach(a.data, opts);
+      else this.attach(a.data, opts);
+    }
+  });
+  AfterAll({ name: 'quiesco: stop session', timeout: 120_000 }, () => lifecycle.afterAll());
+  return lifecycle;
+}

package/src/register.ts

@@ -0,0 +1,4 @@
+// `import '@quiesco/cucumber/register'` in a support file: World + hooks with defaults.
+import { registerQuiesco } from './register-hooks.js';
+
+registerQuiesco();

package/src/world.ts

@@ -0,0 +1,31 @@
+import { World } from '@cucumber/cucumber';
+import type { IWorldOptions } from '@cucumber/cucumber';
+import type { Driver, Session } from '@quiesco/core';
+
+import type { Lifecycle } from './lifecycle.js';
+
+let lifecycle: Lifecycle | null = null;
+
+/** @internal set by registerQuiesco(). */
+export function bindLifecycle(l: Lifecycle): void {
+  lifecycle = l;
+}
+
+/**
+ * Cucumber World with `this.app` (the Quiesco Driver). Extend it to add your own business driver
+ * (Ports & Adapters): `class MyWorld extends QuiescoWorld { todos = new TodoDriver(this.app) }`.
+ */
+export class QuiescoWorld<Parameters = unknown> extends World<Parameters> {
+  constructor(options: IWorldOptions<Parameters>) {
+    super(options);
+  }
+
+  get app(): Driver {
+    return this.session.driver;
+  }
+
+  get session(): Session {
+    if (lifecycle === null) throw new Error("Quiesco is not registered: import '@quiesco/cucumber/register' in a support file");
+    return lifecycle.current;
+  }
+}