@ripplo/testing 0.3.6 → 0.3.8

package/README.md

@@ -440,7 +440,7 @@ For entire presentation-only flows, pass the flag to `test`:
 test("filter-sort-user-flows", { uiOnly: true }).name("Filter & sort");
 ```
 
-Treat `uiOnly` as a narrow escape hatch — default to writing an observer.
+`uiOnly: true` is only valid for steps with zero backend effect (pure view transitions). If the step triggers a mutation, background job, or optimistic UI update, `uiOnly` is wrong — write an observer. The `mutation-without-observer-coverage` lint rule is a backstop, not a ceiling: authoring a test without backend assertions on a mutation flow is a mistake regardless of whether lint catches this particular click label. **Never use `uiOnly: true` with a `// TODO: add observer` comment as a placeholder.** That's a false green — the observer is in-scope work, not follow-up.
 
 ## Determinism Rules
 

package/dist/assert.d.ts

@@ -1,4 +1,4 @@
-import { O as ObserverHandle, a as ObserverInput, b as ObserverBudgetTier } from './types-Degkxs1f.js';
+import { O as ObserverHandle, a as ObserverInput, b as ObserverBudgetTier } from './types-Do4o4Y_c.js';
 import { Variable, StaticStringRef, VariableRef } from './control.js';
 import { U as UnlabeledStep } from './step-De52hTLd.js';
 import { CheckLocator, AnyLocator } from './locators.js';

package/dist/assert.js

@@ -1,7 +1,7 @@
 import {
   readObserverBudget,
   readObserverName
-} from "./chunk-XBYG5NBY.js";
+} from "./chunk-D7DRM7AG.js";
 import {
   toSpecLocator,
   toStringValueRef

package/dist/{builder-BGr5JvrY.d.ts → builder-D-i_ueN3.d.ts}

@@ -1,4 +1,4 @@
-import { O as ObserverHandle, P as Precondition, l as PreconditionData, j as TestDefinition, e as DslConfig, g as ObserverDefinition, k as PreconditionDefinition, U as UnimplementedItems, f as ObserverContext, h as ObserverOutcome, S as SetupContext, m as TestValue, T as TeardownContext, n as UserDslConfig } from './types-Degkxs1f.js';
+import { O as ObserverHandle, P as Precondition, l as PreconditionData, j as TestDefinition, e as DslConfig, g as ObserverDefinition, k as PreconditionDefinition, U as UnimplementedItems, f as ObserverContext, h as ObserverOutcome, S as SetupContext, m as TestValue, T as TeardownContext, n as UserDslConfig } from './types-Do4o4Y_c.js';
 import { ObserverBudget } from '@ripplo/spec';
 import { S as Step } from './step-De52hTLd.js';
 
@@ -43,7 +43,10 @@ interface TestNeedsStartsAt<TVars extends Record<string, Record<string, string>>
     readonly startsAt: (fn: (vars: TVars) => string) => TestNeedsSteps<TVars>;
 }
 interface TestNeedsSteps<TVars extends Record<string, Record<string, string>>> {
-    readonly steps: (fn: (vars: TVars) => ReadonlyArray<Step>) => TestDefinition;
+    readonly steps: (fn: (vars: TVars) => ReadonlyArray<Step>) => TestNeedsCoverage;
+}
+interface TestNeedsCoverage {
+    readonly coverage: (...ids: ReadonlyArray<string>) => TestDefinition;
 }
 
 type PreconditionSetupResult<TData extends Record<string, string>> = {

package/dist/{chunk-KNF4K4JH.js → chunk-5AGV4KQA.js}

@@ -54,6 +54,7 @@ function compileTest(def, preconditionDefs) {
   const resolvedPreconditions = resolveDependencyChain(def.requires, preconditionDefs);
   return {
     additionalChecks: [],
+    coverage: def.coverage,
     description: def.description,
     expectedOutcome: def.expectedOutcome,
     implemented: def.implemented,

package/dist/{chunk-XBYG5NBY.js → chunk-D7DRM7AG.js}

@@ -45,6 +45,9 @@ var DEFAULT_IGNORE_PATHS = [
   "**/storybook-static/**",
   "**/*.stories.*",
   "**/*.story.*",
+  "**/cli/**",
+  "**/scripts/**",
+  "**/tools/**",
   "**/__tests__/**",
   "**/__mocks__/**",
   "**/__fixtures__/**",

package/dist/compiler.d.ts

@@ -1,6 +1,6 @@
 import { Observer, Precondition, WorkflowSpec } from '@ripplo/spec';
-import { d as RipploBuilder } from './builder-BGr5JvrY.js';
-import { e as DslConfig } from './types-Degkxs1f.js';
+import { d as RipploBuilder } from './builder-D-i_ueN3.js';
+import { e as DslConfig } from './types-Do4o4Y_c.js';
 import './step-De52hTLd.js';
 import 'zod';
 
@@ -12,6 +12,7 @@ interface CompileResult {
 }
 interface CompiledTest {
     readonly additionalChecks: ReadonlyArray<string>;
+    readonly coverage: ReadonlyArray<string>;
     readonly description: string;
     readonly expectedOutcome: string;
     readonly implemented: boolean;

package/dist/compiler.js

@@ -1,6 +1,6 @@
 import {
   compile
-} from "./chunk-KNF4K4JH.js";
+} from "./chunk-5AGV4KQA.js";
 import "./chunk-MGATMMCZ.js";
 import "./chunk-4MGIQFAJ.js";
 export {

package/dist/elysia.d.ts

@@ -1,7 +1,7 @@
 import { Elysia } from 'elysia';
-import { R as RipploEngine } from './engine-CZ4F_Csu.js';
-import './builder-BGr5JvrY.js';
-import './types-Degkxs1f.js';
+import { R as RipploEngine } from './engine-BMfNkIKC.js';
+import './builder-D-i_ueN3.js';
+import './types-Do4o4Y_c.js';
 import 'zod';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/{engine-CZ4F_Csu.d.ts → engine-BMfNkIKC.d.ts}

@@ -1,5 +1,5 @@
-import { c as PreconditionRegistry, a as ObserverRegistry, O as ObserverImplFn, P as PreconditionImpl, e as RipploInstance } from './builder-BGr5JvrY.js';
-import { h as ObserverOutcome, C as CookieEntry, e as DslConfig, g as ObserverDefinition, k as PreconditionDefinition, U as UnimplementedItems, O as ObserverHandle, P as Precondition } from './types-Degkxs1f.js';
+import { c as PreconditionRegistry, a as ObserverRegistry, O as ObserverImplFn, P as PreconditionImpl, e as RipploInstance } from './builder-D-i_ueN3.js';
+import { h as ObserverOutcome, C as CookieEntry, e as DslConfig, g as ObserverDefinition, k as PreconditionDefinition, U as UnimplementedItems, O as ObserverHandle, P as Precondition } from './types-Do4o4Y_c.js';
 
 interface EngineResult {
     readonly cookies: ReadonlyArray<CookieEntry>;

package/dist/express.d.ts

@@ -1,7 +1,7 @@
 import { Router } from 'express';
-import { R as RipploEngine } from './engine-CZ4F_Csu.js';
-import './builder-BGr5JvrY.js';
-import './types-Degkxs1f.js';
+import { R as RipploEngine } from './engine-BMfNkIKC.js';
+import './builder-D-i_ueN3.js';
+import './types-Do4o4Y_c.js';
 import 'zod';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/fastify.d.ts

@@ -1,7 +1,7 @@
 import { FastifyInstance } from 'fastify';
-import { R as RipploEngine } from './engine-CZ4F_Csu.js';
-import './builder-BGr5JvrY.js';
-import './types-Degkxs1f.js';
+import { R as RipploEngine } from './engine-BMfNkIKC.js';
+import './builder-D-i_ueN3.js';
+import './types-Do4o4Y_c.js';
 import 'zod';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/hono.d.ts

@@ -1,7 +1,7 @@
 import { Hono } from 'hono';
-import { R as RipploEngine } from './engine-CZ4F_Csu.js';
-import './builder-BGr5JvrY.js';
-import './types-Degkxs1f.js';
+import { R as RipploEngine } from './engine-BMfNkIKC.js';
+import './builder-D-i_ueN3.js';
+import './types-Do4o4Y_c.js';
 import 'zod';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export { O as ObserverImplFn, a as ObserverRegistry, P as PreconditionImpl, b as PreconditionRecord, c as PreconditionRegistry, R as ResolveDeps, d as RipploBuilder, e as RipploInstance, f as RipploRegistries, g as createRipplo, o as observer, p as precondition, t as test } from './builder-BGr5JvrY.js';
+export { O as ObserverImplFn, a as ObserverRegistry, P as PreconditionImpl, b as PreconditionRecord, c as PreconditionRegistry, R as ResolveDeps, d as RipploBuilder, e as RipploInstance, f as RipploRegistries, g as createRipplo, o as observer, p as precondition, t as test } from './builder-D-i_ueN3.js';
 import { CompileResult } from './compiler.js';
 export { CompiledTest, compile } from './compiler.js';
-export { E as EngineImpls, a as EngineResult, b as ExecuteBatchOptions, N as NotImplemented, O as ObserverImplFnFor, P as PreconditionImplFor, R as RipploEngine, c as createEngine, n as notImplemented } from './engine-CZ4F_Csu.js';
-import { C as CookieEntry } from './types-Degkxs1f.js';
-export { c as CookieOptions, D as DEFAULT_IGNORE_PATHS, d as DEFAULT_WATCH_PATHS, e as DslConfig, f as ObserverContext, g as ObserverDefinition, O as ObserverHandle, a as ObserverInput, h as ObserverOutcome, P as Precondition, i as PreconditionDeps, S as SetupContext, T as TeardownContext, j as TestDefinition } from './types-Degkxs1f.js';
+export { E as EngineImpls, a as EngineResult, b as ExecuteBatchOptions, N as NotImplemented, O as ObserverImplFnFor, P as PreconditionImplFor, R as RipploEngine, c as createEngine, n as notImplemented } from './engine-BMfNkIKC.js';
+import { C as CookieEntry } from './types-Do4o4Y_c.js';
+export { c as CookieOptions, D as DEFAULT_IGNORE_PATHS, d as DEFAULT_WATCH_PATHS, e as DslConfig, f as ObserverContext, g as ObserverDefinition, O as ObserverHandle, a as ObserverInput, h as ObserverOutcome, P as Precondition, i as PreconditionDeps, S as SetupContext, T as TeardownContext, j as TestDefinition } from './types-Do4o4Y_c.js';
 export { D as DslNodeInput } from './step-De52hTLd.js';
 import '@ripplo/spec';
 import 'zod';

package/dist/index.js

@@ -12,10 +12,10 @@ import {
   readPreconditionName,
   readTestValue,
   userDslConfigSchema
-} from "./chunk-XBYG5NBY.js";
+} from "./chunk-D7DRM7AG.js";
 import {
   compile
-} from "./chunk-KNF4K4JH.js";
+} from "./chunk-5AGV4KQA.js";
 import "./chunk-MGATMMCZ.js";
 import {
   buildSetCookieHeader,
@@ -260,6 +260,7 @@ function buildTestStartsAt({
 }) {
   return {
     notImplemented: () => ({
+      coverage: [],
       description,
       expectedOutcome,
       id,
@@ -297,16 +298,19 @@ function buildTestSteps({
 }) {
   return {
     steps: (stepsFn) => ({
-      description,
-      expectedOutcome,
-      id,
-      implemented: true,
-      name,
-      requires: [...reqNames],
-      requiresKeys,
-      startsAtFn,
-      stepsFn,
-      uiOnly
+      coverage: (...ids) => ({
+        coverage: ids,
+        description,
+        expectedOutcome,
+        id,
+        implemented: true,
+        name,
+        requires: [...reqNames],
+        requiresKeys,
+        startsAtFn,
+        stepsFn,
+        uiOnly
+      })
     })
   };
 }

package/dist/koa.d.ts

@@ -1,7 +1,7 @@
 import { Middleware } from 'koa';
-import { R as RipploEngine } from './engine-CZ4F_Csu.js';
-import './builder-BGr5JvrY.js';
-import './types-Degkxs1f.js';
+import { R as RipploEngine } from './engine-BMfNkIKC.js';
+import './builder-D-i_ueN3.js';
+import './types-Do4o4Y_c.js';
 import 'zod';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/lockfile.d.ts

@@ -1,8 +1,8 @@
 import { Codec } from '@ripplo/spec';
 import { z } from 'zod';
 import { CompileResult } from './compiler.js';
-import './builder-BGr5JvrY.js';
-import './types-Degkxs1f.js';
+import './builder-D-i_ueN3.js';
+import './types-Do4o4Y_c.js';
 import './step-De52hTLd.js';
 
 declare const LOCKFILE_RELATIVE_PATH = ".ripplo/ripplo.lock";
@@ -21,6 +21,7 @@ declare const lockfileBodySchema: z.ZodObject<{
         returns: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
     tests: z.ZodArray<z.ZodObject<{
+        coverage: z.ZodDefault<z.ZodArray<z.ZodString>>;
         expectedOutcome: z.ZodString;
         name: z.ZodString;
         preconditions: z.ZodArray<z.ZodString>;

package/dist/lockfile.js

@@ -496,6 +496,7 @@ var LOCKFILE_RELATIVE_PATH = ".ripplo/ripplo.lock";
 var MAX_TESTS = 5e3;
 var requiresKeysSchema = z10.record(z10.string().max(200), z10.string().max(200));
 var compiledTestSchema = z10.object({
+  coverage: z10.array(z10.string().max(500)).max(2e3).default([]),
   expectedOutcome: z10.string().max(2e3),
   name: z10.string().max(200),
   preconditions: z10.array(z10.string().max(200)).max(1e3),
@@ -514,6 +515,7 @@ function compileResultToLockfile(result) {
     observers: result.observers,
     preconditions: result.preconditions,
     tests: result.tests.filter((test) => test.implemented).map((test) => ({
+      coverage: [...test.coverage],
       expectedOutcome: test.expectedOutcome,
       name: test.name,
       preconditions: [...test.preconditions],

package/dist/nestjs.d.ts

@@ -1,7 +1,7 @@
 import { DynamicModule } from '@nestjs/common';
-import { R as RipploEngine } from './engine-CZ4F_Csu.js';
-import './builder-BGr5JvrY.js';
-import './types-Degkxs1f.js';
+import { R as RipploEngine } from './engine-BMfNkIKC.js';
+import './builder-D-i_ueN3.js';
+import './types-Do4o4Y_c.js';
 import 'zod';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/nextjs.d.ts

@@ -1,6 +1,6 @@
-import { R as RipploEngine } from './engine-CZ4F_Csu.js';
-import './builder-BGr5JvrY.js';
-import './types-Degkxs1f.js';
+import { R as RipploEngine } from './engine-BMfNkIKC.js';
+import './builder-D-i_ueN3.js';
+import './types-Do4o4Y_c.js';
 import 'zod';
 import './step-De52hTLd.js';
 import '@ripplo/spec';

package/dist/{types-Degkxs1f.d.ts → types-Do4o4Y_c.d.ts}

@@ -70,6 +70,7 @@ interface PreconditionDefinition {
 }
 type VarsFn<T> = (vars: Record<string, Record<string, string>>) => T;
 interface TestDefinition {
+    readonly coverage: ReadonlyArray<string>;
     readonly description: string;
     readonly expectedOutcome: string;
     readonly id: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ripplo/testing",
   "description": "TypeScript DSL for defining and running Ripplo e2e workflow tests",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "type": "module",
   "files": [
     "dist"
@@ -99,8 +99,8 @@
     "tsup": "^8.5.1",
     "typescript": "catalog:",
     "vitest": "^4.1.4",
-    "@ripplo/eslint-config": "0.0.0",
-    "@ripplo/spec": "^0.0.0"
+    "@ripplo/spec": "^0.0.0",
+    "@ripplo/eslint-config": "0.0.0"
   },
   "peerDependencies": {
     "@nestjs/common": "^10.0.0 || ^11.0.0",