@plaintake/scenario 1.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PlainLab
+
+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

@@ -0,0 +1,68 @@
+# @plaintake/scenario
+
+The authoring SDK for [PlainTake](https://github.com/plaintake/plaintake) demo scenarios:
+`defineDemo` and the scenario DSL types used to write `*.demo.ts` files that the PlainTake
+CLI records into a video.
+
+## Do you need to install this?
+
+No, strictly speaking. The PlainTake binary already ships a runtime fallback for
+`@plaintake/scenario`, so a scenario file's `import { defineDemo } from '@plaintake/scenario'`
+resolves and runs with nothing installed at all.
+
+What this package buys you is editor autocomplete and typechecking while you *write* a
+scenario: real types for `defineDemo`'s input, `DemoContext`, `DemoStep`, and the rest of the
+DSL, instead of an untyped `any`.
+
+If you do install it, your copy is what actually gets used — module resolution tries your
+project's own `node_modules` first, and only falls back to the binary's built-in copy when
+that lookup fails. Nothing is overridden or shadowed; it is simply resolved before the
+fallback is ever consulted.
+
+## Install
+
+```sh
+npm install --save-dev @plaintake/scenario
+```
+
+## Usage
+
+```ts
+// login.demo.ts
+import { defineDemo } from '@plaintake/scenario';
+
+export default defineDemo({
+  schema: 'agent-demo.scenario/v1',
+  id: 'sign-in',
+  title: 'Sign in to the dashboard',
+  viewport: { width: 1920, height: 1080, deviceScaleFactor: 1 },
+  locale: 'en-US',
+  timezoneId: 'UTC',
+  colorScheme: 'light',
+  reducedMotion: 'reduce',
+  async run({ page, demo, baseURL }) {
+    await page.goto(baseURL);
+    await demo.step({
+      id: 'submit',
+      title: 'Submit the sign-in form',
+      target: page.getByRole('button', { name: 'Sign in' }),
+      action: 'click',
+      run: () => page.getByRole('button', { name: 'Sign in' }).click(),
+    });
+  },
+});
+```
+
+The PlainTake CLI discovers and records files matching `*.demo.ts`. See the
+[scenario guide](https://github.com/plaintake/plaintake#readme) for the full DSL — chapters,
+assertions, masks, waits, and handoffs to a person for steps PlainTake cannot perform itself
+(entering a one-time code, for example).
+
+## Licence
+
+This package (`@plaintake/scenario`) is MIT licensed — see [LICENSE](./LICENSE).
+
+That covers only the authoring SDK. PlainTake itself — the CLI/binary that records and
+renders the video — is separate, proprietary software; installing this package does not
+grant any rights to it. See the [PlainTake licence](https://github.com/plaintake/plaintake/blob/main/LICENSE)
+for those terms.

package/dist/define.d.ts

@@ -0,0 +1,2 @@
+import type { DemoDefinition, DemoDefinitionInput } from './types.js';
+export declare function defineDemo(input: DemoDefinitionInput): DemoDefinition;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './define.js';
+export * from './types.js';