@avivbenhamo/polly-kit 0.7.0 → 0.9.0

package/README.md

@@ -71,7 +71,17 @@ body, so a bare `startPolly()` call in `index.tsx` runs *after* `./App` and ever
 imports — and any module that fires a request at import time would escape interception,
 silently and only sometimes.
 
-Add `/recordings` to `.gitignore`. A HAR holds complete response bodies.
+Add the recordings directory to `.gitignore` — a HAR holds complete response bodies:
+
+```sh
+npx polly-kit init                         # adds /recordings, or /apps/web/recordings
+npx polly-kit init --dir fixtures/har      # when that is not where you record
+```
+
+Run it from the directory the app records in. The entry is anchored at the repository root
+and written out in full — `/apps/web/recordings` from a package inside a monorepo, not
+`/recordings`, which would match nothing there and look like it had. An entry already in the
+file, in any spelling git honours, is left alone; running it twice adds one line.
 
 ## Running it
 
@@ -135,7 +145,7 @@ $env:POLLY_MODE='record'; npm run start:dev
 ```
 
 No Vite plugin and no recording store: `persister-fs` writes the HAR straight to disk.
-Add `/recordings` to `.gitignore`.
+`npx polly-kit init` gitignores the directory.
 
 **Use `{kind: 'only'}`, not `{kind: 'all'}`.** In a browser Polly sees the page's own
 requests. In Node the adapters are process-wide: they also see your service talking to

package/dist/cli.d.ts

@@ -1,5 +1,51 @@
 #!/usr/bin/env node
 export declare function main(argv: string[]): Promise<number>;
+export interface IgnoreOptions {
+    /** Where the command was run. The repository is found by walking up from here. */
+    cwd?: string;
+    /** The recordings directory, as passed to `startPolly`. Default `recordings`. */
+    dir?: string;
+}
+export interface IgnoreResult {
+    /**
+     * `added`   — the entry was appended.
+     * `covered` — a rule already matching the directory was there; nothing written.
+     * `outside` — the directory is not under the repository, so no rule can name it.
+     * `root`    — the directory *is* the repository, which is not something to ignore.
+     */
+    action: 'added' | 'covered' | 'outside' | 'root';
+    /** The `.gitignore` written, or the one that would have been. */
+    path: string;
+    /** The entry, as written or as it would be written. Empty when `outside`. */
+    entry: string;
+    /** The repository root this was resolved against. */
+    root: string;
+    /** The recordings directory, absolute. */
+    recordingsDir: string;
+}
+/**
+ * Adds the recordings directory to the repository's `.gitignore`.
+ *
+ * Two things here are deliberate and were the reason for the command.
+ *
+ * The entry is anchored at the repository root and spelled out in full —
+ * `/apps/web/recordings`, not `/recordings` — because the recordings directory
+ * is configured in the app's own code and so lives wherever the app does. A bare
+ * `/recordings` at the root of a monorepo matches nothing in `apps/web`, and the
+ * failure is silent: the file looks like it handled them and the HARs get
+ * committed anyway.
+ *
+ * Coverage is checked against every spelling git would honour, because the entry
+ * has been written by hand from the README for longer than this command has
+ * existed, and this package's own docs have asked for it as both `/recordings`
+ * and `recordings/`. `recordings` and `recordings/` have no leading slash, so git
+ * matches them at any depth and they already cover the directory — appending a
+ * second rule under one of them is a duplicate somebody then has to delete.
+ *
+ * Negated (`!recordings`) and commented-out entries are not coverage. Reading
+ * either as "already handled" would leave the recordings committed.
+ */
+export declare function ignoreRecordings(options?: IgnoreOptions): IgnoreResult;
 export interface StudioOptions {
     recordingsDir: string;
     port?: number;

package/dist/cli.js

@@ -1,6 +1,10 @@
 #!/usr/bin/env node
 /**
- * The studio, served on its own, for a checkout with no app running.
+ * The two things that are done to a checkout rather than inside an app: serving
+ * the studio with no app running (`studio`), and keeping the recordings out of
+ * git (`init`).
+ *
+ * On `init`, see `ignoreRecordings`. The rest of this is the studio.
  *
  * The mounted form stays the default and is the better one when there *is* a dev
  * server: `app.use('/__polly', pollyUi(...))` — or the Vite plugin, which does
@@ -18,8 +22,8 @@
  * see those.
  */
 import { createServer } from 'node:http';
-import { existsSync } from 'node:fs';
-import { isAbsolute, join, resolve } from 'node:path';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { pollyUi } from './studio/server.js';
 const DEFAULT_PORT = 7788;
@@ -33,11 +37,16 @@ const PORT_TRIES = 20;
 const USAGE = `polly-kit — Polly recordings, in a browser
 
   npx polly-kit studio [--dir DIR] [--port PORT]
+  npx polly-kit init [--dir DIR]
 
   studio    Serve the recording editor on 127.0.0.1. Reads and writes the HAR
             files under DIR (default ${DEFAULT_DIR}), the same ones the mounted
             editor edits.
 
+  init      Add DIR to the repository's .gitignore. A HAR holds complete
+            request and response bodies, so recordings are not something to
+            commit by accident. Safe to run twice.
+
 Mounted in a dev server instead — no second port, and it stops when the server
 does — this is the Vite plugin, or app.use('/__polly', pollyUi({recordingsDir})).
 Recordings held in a browser's localStorage are reachable only from the page
@@ -49,6 +58,24 @@ export async function main(argv) {
         process.stdout.write(USAGE);
         return 0;
     }
+    if (command === 'init' || command === 'setup') {
+        const result = ignoreRecordings({ dir: flag(argv, 'dir') });
+        // Every outcome is exit 0. This runs from a README in some trees and from a
+        // postinstall in others, and "already done" is the steady state in both.
+        if (result.action === 'added') {
+            process.stdout.write(`added to ${result.path}: ${result.entry}\n`);
+        }
+        else if (result.action === 'covered') {
+            process.stdout.write(`${result.entry} is already ignored by ${result.path}\n`);
+        }
+        else if (result.action === 'root') {
+            process.stdout.write(`${result.root} is the repository root, not a recordings directory — pass --dir\n`);
+        }
+        else {
+            process.stdout.write(`${result.recordingsDir} is outside ${result.root} — nothing to ignore there\n`);
+        }
+        return 0;
+    }
     if (command !== 'studio') {
         process.stderr.write(`unknown command: ${command}\n\n${USAGE}`);
         return 2;
@@ -79,6 +106,93 @@ export async function main(argv) {
     await studio.close();
     return 0;
 }
+const IGNORE_COMMENT = '# @avivbenhamo/polly-kit: recorded traffic. A HAR holds complete request and\n# response bodies, including anything the responses carried.';
+/**
+ * Adds the recordings directory to the repository's `.gitignore`.
+ *
+ * Two things here are deliberate and were the reason for the command.
+ *
+ * The entry is anchored at the repository root and spelled out in full —
+ * `/apps/web/recordings`, not `/recordings` — because the recordings directory
+ * is configured in the app's own code and so lives wherever the app does. A bare
+ * `/recordings` at the root of a monorepo matches nothing in `apps/web`, and the
+ * failure is silent: the file looks like it handled them and the HARs get
+ * committed anyway.
+ *
+ * Coverage is checked against every spelling git would honour, because the entry
+ * has been written by hand from the README for longer than this command has
+ * existed, and this package's own docs have asked for it as both `/recordings`
+ * and `recordings/`. `recordings` and `recordings/` have no leading slash, so git
+ * matches them at any depth and they already cover the directory — appending a
+ * second rule under one of them is a duplicate somebody then has to delete.
+ *
+ * Negated (`!recordings`) and commented-out entries are not coverage. Reading
+ * either as "already handled" would leave the recordings committed.
+ */
+export function ignoreRecordings(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const dir = options.dir ?? DEFAULT_DIR;
+    const recordingsDir = isAbsolute(dir) ? resolve(dir) : resolve(cwd, dir);
+    // No git command is run: `.git` is a directory in a normal checkout and a file
+    // in a worktree or submodule, and either one marks the root. Falling back to
+    // cwd covers the directory that is not a repository yet.
+    const root = gitRoot(cwd) ?? resolve(cwd);
+    const path = join(root, '.gitignore');
+    const within = relative(root, recordingsDir);
+    if (within === '') {
+        return { action: 'root', path, entry: '', root, recordingsDir };
+    }
+    if (within.startsWith('..') || isAbsolute(within)) {
+        return { action: 'outside', path, entry: '', root, recordingsDir };
+    }
+    const entry = `/${within.split(sep).join('/')}`;
+    const existing = existsSync(path) ? readFileSync(path, 'utf8') : '';
+    if (covers(existing, entry)) {
+        return { action: 'covered', path, entry, root, recordingsDir };
+    }
+    // The file's own line ending, not the platform's: git on Windows checks out a
+    // CRLF `.gitignore`, and appending LF lines to it shows the whole file as
+    // changed in the diff.
+    const eol = existing.includes('\r\n') ? '\r\n' : '\n';
+    const lead = existing === '' || /(\r?\n){2}$/.test(existing)
+        ? ''
+        : /\r?\n$/.test(existing)
+            ? eol
+            : `${eol}${eol}`;
+    const block = `${IGNORE_COMMENT}\n${entry}\n`.replace(/\n/g, eol);
+    writeFileSync(path, `${existing}${lead}${block}`, 'utf8');
+    return { action: 'added', path, entry, root, recordingsDir };
+}
+/** Nearest ancestor of `from` holding a `.git`, itself included. */
+function gitRoot(from) {
+    let at = resolve(from);
+    for (;;) {
+        if (existsSync(join(at, '.git')))
+            return at;
+        const up = dirname(at);
+        if (up === at)
+            return undefined;
+        at = up;
+    }
+}
+/** Does any rule in `contents` already ignore `entry` (`/a/b/recordings`)? */
+function covers(contents, entry) {
+    const wanted = entry.replace(/^\/+/, '').replace(/\/+$/, '');
+    const leaf = wanted.slice(wanted.lastIndexOf('/') + 1);
+    return contents.split(/\r?\n/).some((raw) => {
+        const line = raw.trim();
+        if (line === '' || line.startsWith('#') || line.startsWith('!'))
+            return false;
+        // A leading `**/` is git's explicit spelling of "at any depth", which is
+        // what a bare name means anyway.
+        const rule = line.replace(/^\*\*\//, '').replace(/^\/+/, '').replace(/\/+$/, '');
+        // Anchored by a leading slash, or by a slash anywhere inside it: git matches
+        // those against the path from the .gitignore's own directory, so it has to be
+        // the same path. Otherwise the rule matches at every depth and the last
+        // segment of the path is enough.
+        return line.startsWith('/') || rule.includes('/') ? rule === wanted : rule === leaf;
+    });
+}
 /**
  * The server, without the process around it.
  *

package/dist/studio/client.bundle.js

@@ -111,8 +111,13 @@ function entryDetail(entry) {
 
     <div class="actions">
       <button name="save">Save response</button>
+      <button name="duplicate" title="Append a copy to this request's group, replayed the next time the same request is made">Duplicate for next call</button>
       <button name="delete" class="danger">Delete entry</button>
     </div>
+    <p class="note">Duplicating adds a second answer to the <em>same</em> request:
+    Polly replays <code>_order 0</code> on the first call, this copy on the second.
+    It cannot become a different request \u2014 the <code>_id</code> is a hash of the
+    request, and an edited URL under the old hash would match nothing.</p>
   </div>
 </section>`;
 }
@@ -199,6 +204,18 @@ function mountStudio(root, store) {
       report(err);
     }
   }
+  async function duplicate(entryId, order) {
+    if (currentId === null || current === null)
+      return;
+    try {
+      const { har } = await store.duplicateEntry(currentId, entryId, order, current.etag);
+      const added = har.log.entries.filter((entry) => String(entry._id) === entryId).length - 1;
+      await openRecording(currentId);
+      openEntry(entryId, added);
+    } catch (err) {
+      report(err);
+    }
+  }
   async function remove(entryId, order) {
     if (currentId === null || current === null)
       return;
@@ -242,6 +259,8 @@ function mountStudio(root, store) {
     const order = Number(section.dataset["order"]);
     if (target.getAttribute("name") === "save")
       void save(entryId, order);
+    if (target.getAttribute("name") === "duplicate")
+      void duplicate(entryId, order);
     if (target.getAttribute("name") === "delete")
       void remove(entryId, order);
   });
@@ -309,6 +328,10 @@ var HttpStore = class {
   async patchEntry(id, entryId, order, etag, patch) {
     return await this.json("PATCH", `/api/recordings/${encodeURIComponent(id)}/entries/${encodeURIComponent(entryId)}/${order}`, { etag, patch });
   }
+  /** POST to the entry being copied: this adds a member to its group. */
+  async duplicateEntry(id, entryId, order, etag) {
+    return await this.json("POST", `/api/recordings/${encodeURIComponent(id)}/entries/${encodeURIComponent(entryId)}/${order}?etag=${encodeURIComponent(etag)}`);
+  }
   async deleteEntry(id, entryId, order, etag) {
     return await this.json("DELETE", `/api/recordings/${encodeURIComponent(id)}/entries/${encodeURIComponent(entryId)}/${order}?etag=${encodeURIComponent(etag)}`);
   }

package/dist/studio/edit.d.ts

@@ -29,6 +29,28 @@ export type EditResult = {
  * wrong rather than merely stale.
  */
 export declare function applyResponsePatch(har: Har, id: string, order: number, patch: ResponsePatch): EditResult;
+/**
+ * Copies an entry to the end of its own `_id` group — "the *next* time this same
+ * request happens, reply with this".
+ *
+ * `_order` is a position within a group of identical requests, not a label:
+ * Polly derives it at replay by counting how many earlier requests produced the
+ * same `_id`, starting at 0. So a recording with two members of a group answers
+ * the first call with `_order: 0` and the second with `_order: 1`. Duplicating
+ * appends a member, which is the only honest meaning "duplicate" can have here.
+ *
+ * What it deliberately is **not** is a way to make a *different* request. The
+ * `_id` is an md5 over the request that this package never recomputes — see
+ * `import.ts` — so a copy with an edited URL would carry the original's id,
+ * match nothing at replay, and fail silently. The copy keeps the id, and the
+ * caller edits the response.
+ *
+ * The clone is inserted directly after the last member of its group rather than
+ * appended to the file, because the list is shown in file order and a copy that
+ * appeared at the bottom, pages away from its original, reads as a new request
+ * somebody else recorded.
+ */
+export declare function duplicateEntry(har: Har, id: string, order: number): EditResult;
 export declare function notFound(id: string, order: number): string;
 /**
  * Removes one entry and closes the gap it leaves in its `_id` group.

package/dist/studio/edit.js

@@ -62,6 +62,41 @@ export function applyResponsePatch(har, id, order, patch) {
     }
     return { ok: true, har: next };
 }
+/**
+ * Copies an entry to the end of its own `_id` group — "the *next* time this same
+ * request happens, reply with this".
+ *
+ * `_order` is a position within a group of identical requests, not a label:
+ * Polly derives it at replay by counting how many earlier requests produced the
+ * same `_id`, starting at 0. So a recording with two members of a group answers
+ * the first call with `_order: 0` and the second with `_order: 1`. Duplicating
+ * appends a member, which is the only honest meaning "duplicate" can have here.
+ *
+ * What it deliberately is **not** is a way to make a *different* request. The
+ * `_id` is an md5 over the request that this package never recomputes — see
+ * `import.ts` — so a copy with an edited URL would carry the original's id,
+ * match nothing at replay, and fail silently. The copy keeps the id, and the
+ * caller edits the response.
+ *
+ * The clone is inserted directly after the last member of its group rather than
+ * appended to the file, because the list is shown in file order and a copy that
+ * appeared at the bottom, pages away from its original, reads as a new request
+ * somebody else recorded.
+ */
+export function duplicateEntry(har, id, order) {
+    const source = findEntry(har, id, order);
+    if (source === undefined) {
+        return { ok: false, error: { code: 'entry-not-found', message: notFound(id, order) } };
+    }
+    const next = structuredClone(har);
+    const entries = next.log.entries;
+    const group = entries.filter((entry) => entry._id === id);
+    const last = group.reduce((at, entry) => Math.max(at, entries.indexOf(entry)), -1);
+    const copy = structuredClone(findEntry(next, id, order));
+    copy._order = group.length;
+    entries.splice(last + 1, 0, copy);
+    return { ok: true, har: next };
+}
 export function notFound(id, order) {
     return `no entry with _id ${id} and _order ${order} — it may have been deleted since the page loaded`;
 }

package/dist/studio/server.js

@@ -3,7 +3,7 @@ import { readFile } from 'node:fs/promises';
 import { fileURLToPath } from 'node:url';
 import { FsStore } from './stores/fs-store.js';
 import { StoreError } from './stores/types.js';
-import { applyResponsePatch, deleteEntry } from './edit.js';
+import { applyResponsePatch, deleteEntry, duplicateEntry } from './edit.js';
 import { renderPage } from './ui/page.js';
 /**
  * A mountable editor for Polly recordings, in the style of swagger-ui: the app serves
@@ -131,6 +131,13 @@ async function handle(req, res, ctx) {
                     await mutate(ctx, res, id, etag, (har) => deleteEntry(har, entryId, order));
                     return;
                 }
+                // POST, not PUT: this creates a member of the group rather than
+                // replacing one, and the URL it is posted to is the entry being copied.
+                if (req.method === 'POST') {
+                    const etag = url.searchParams.get('etag') ?? '';
+                    await mutate(ctx, res, id, etag, (har) => duplicateEntry(har, entryId, order));
+                    return;
+                }
             }
         }
         sendJson(res, 404, { error: 'not found' });

package/dist/studio/stores/apply.d.ts

@@ -3,6 +3,7 @@ import type { Har, ResponsePatch } from '../types.js';
 type Local = Pick<RecordingStore, 'read' | 'write'>;
 export declare function patchEntryVia(store: Local, id: string, entryId: string, order: number, etag: string, patch: ResponsePatch): Promise<ReadResult>;
 export declare function deleteEntryVia(store: Local, id: string, entryId: string, order: number, etag: string): Promise<ReadResult>;
+export declare function duplicateEntryVia(store: Local, id: string, entryId: string, order: number, etag: string): Promise<ReadResult>;
 type Importable = Pick<RecordingStore, 'read' | 'write' | 'create'>;
 /**
  * The read-merge-write cycle, shared by every store that owns its own storage.

package/dist/studio/stores/apply.js

@@ -1,4 +1,4 @@
-import { applyResponsePatch, deleteEntry as deleteEntryIn } from '../edit.js';
+import { applyResponsePatch, deleteEntry as deleteEntryIn, duplicateEntry as duplicateEntryIn, } from '../edit.js';
 import { POLLY_CREATOR_NAME } from '../har.js';
 import { mergeEntries, rejectImport } from '../import.js';
 import { guidForRecording, rejectRecordingName } from '../recording-id.js';
@@ -9,6 +9,9 @@ export function patchEntryVia(store, id, entryId, order, etag, patch) {
 export function deleteEntryVia(store, id, entryId, order, etag) {
     return applyEntryEdit(store, id, etag, (har) => deleteEntryIn(har, entryId, order));
 }
+export function duplicateEntryVia(store, id, entryId, order, etag) {
+    return applyEntryEdit(store, id, etag, (har) => duplicateEntryIn(har, entryId, order));
+}
 async function applyEntryEdit(store, id, etag, apply) {
     const read = await store.read(id);
     if (read.etag !== etag) {

package/dist/studio/stores/fs-store.d.ts

@@ -49,6 +49,7 @@ export declare class FsStore implements RecordingStore {
      */
     delete(id: string): Promise<void>;
     patchEntry(id: string, entryId: string, order: number, etag: string, patch: ResponsePatch): Promise<ReadResult>;
+    duplicateEntry(id: string, entryId: string, order: number, etag: string): Promise<ReadResult>;
     deleteEntry(id: string, entryId: string, order: number, etag: string): Promise<ReadResult>;
     /**
      * `write` is read-compare-write and refuses a file that is not there, which is

package/dist/studio/stores/fs-store.js

@@ -4,7 +4,7 @@ import { randomUUID } from 'node:crypto';
 import { parseHar } from '../har.js';
 import { etagFor } from '../etag.js';
 import { StoreError } from './types.js';
-import { deleteEntryVia, importHarVia, patchEntryVia } from './apply.js';
+import { deleteEntryVia, duplicateEntryVia, importHarVia, patchEntryVia } from './apply.js';
 export { StoreError } from './types.js';
 const FILENAME = 'recording.har';
 /**
@@ -151,6 +151,9 @@ export class FsStore {
     patchEntry(id, entryId, order, etag, patch) {
         return patchEntryVia(this, id, entryId, order, etag, patch);
     }
+    duplicateEntry(id, entryId, order, etag) {
+        return duplicateEntryVia(this, id, entryId, order, etag);
+    }
     deleteEntry(id, entryId, order, etag) {
         return deleteEntryVia(this, id, entryId, order, etag);
     }

package/dist/studio/stores/http-store.d.ts

@@ -25,6 +25,8 @@ export declare class HttpStore implements RecordingStore {
     write(id: string, har: Har, etag: string): Promise<void>;
     delete(id: string): Promise<void>;
     patchEntry(id: string, entryId: string, order: number, etag: string, patch: ResponsePatch): Promise<ReadResult>;
+    /** POST to the entry being copied: this adds a member to its group. */
+    duplicateEntry(id: string, entryId: string, order: number, etag: string): Promise<ReadResult>;
     deleteEntry(id: string, entryId: string, order: number, etag: string): Promise<ReadResult>;
     /**
      * Not on the wire protocol: creation happens inside `/api/import`, server-side,

package/dist/studio/stores/http-store.js

@@ -36,6 +36,10 @@ export class HttpStore {
     async patchEntry(id, entryId, order, etag, patch) {
         return (await this.json('PATCH', `/api/recordings/${encodeURIComponent(id)}/entries/${encodeURIComponent(entryId)}/${order}`, { etag, patch }));
     }
+    /** POST to the entry being copied: this adds a member to its group. */
+    async duplicateEntry(id, entryId, order, etag) {
+        return (await this.json('POST', `/api/recordings/${encodeURIComponent(id)}/entries/${encodeURIComponent(entryId)}/${order}?etag=${encodeURIComponent(etag)}`));
+    }
     async deleteEntry(id, entryId, order, etag) {
         return (await this.json('DELETE', `/api/recordings/${encodeURIComponent(id)}/entries/${encodeURIComponent(entryId)}/${order}?etag=${encodeURIComponent(etag)}`));
     }

package/dist/studio/stores/local-storage-store.d.ts

@@ -19,6 +19,7 @@ export declare class LocalStorageStore implements RecordingStore {
     write(id: string, har: Har, etag: string): Promise<void>;
     delete(id: string): Promise<void>;
     patchEntry(id: string, entryId: string, order: number, etag: string, patch: ResponsePatch): Promise<ReadResult>;
+    duplicateEntry(id: string, entryId: string, order: number, etag: string): Promise<ReadResult>;
     deleteEntry(id: string, entryId: string, order: number, etag: string): Promise<ReadResult>;
     create(id: string, har: Har): Promise<void>;
     importHar(recordingName: string, incoming: Har): Promise<ImportResult>;

package/dist/studio/stores/local-storage-store.js

@@ -1,7 +1,7 @@
 import { parseHar } from '../har.js';
 import { etagFor } from '../etag.js';
 import { StoreError } from './types.js';
-import { deleteEntryVia, importHarVia, patchEntryVia } from './apply.js';
+import { deleteEntryVia, duplicateEntryVia, importHarVia, patchEntryVia } from './apply.js';
 /** Polly's default namespace. `persisterOptions.local-storage.key` can change it. */
 const DEFAULT_KEY = 'pollyjs';
 /**
@@ -90,6 +90,9 @@ export class LocalStorageStore {
     patchEntry(id, entryId, order, etag, patch) {
         return patchEntryVia(this, id, entryId, order, etag, patch);
     }
+    duplicateEntry(id, entryId, order, etag) {
+        return duplicateEntryVia(this, id, entryId, order, etag);
+    }
     deleteEntry(id, entryId, order, etag) {
         return deleteEntryVia(this, id, entryId, order, etag);
     }

package/dist/studio/stores/types.d.ts

@@ -35,7 +35,7 @@ export interface RecordingStore {
     write(id: string, har: Har, etag: string): Promise<void>;
     delete(id: string): Promise<void>;
     /**
-     * The two edits the UI performs, as store operations rather than as "read, apply, and
+     * The three edits the UI performs, as store operations rather than as "read, apply, and
      * hand a whole HAR back".
      *
      * They are on the interface so `mountStudio` never has to ask which store it holds.
@@ -46,6 +46,12 @@ export interface RecordingStore {
      */
     patchEntry(id: string, entryId: string, order: number, etag: string, patch: ResponsePatch): Promise<ReadResult>;
     deleteEntry(id: string, entryId: string, order: number, etag: string): Promise<ReadResult>;
+    /**
+     * Copy an entry to the end of its own `_id` group: the next identical request
+     * replays this one instead. Never a way to make a *different* request — see
+     * `duplicateEntry` in edit.ts.
+     */
+    duplicateEntry(id: string, entryId: string, order: number, etag: string): Promise<ReadResult>;
     /**
      * Write a recording that does not exist yet. Unlike `write` there is no etag to
      * compare, because there is nothing to compare against — and it must fail rather

package/dist/studio/ui/app.js

@@ -131,6 +131,24 @@ export function mountStudio(root, store) {
             report(err);
         }
     }
+    /**
+     * The copy lands at the end of its group, and that is the one we open: the
+     * entry you were looking at is unchanged, and the thing you are about to edit
+     * is the new answer, not the old one.
+     */
+    async function duplicate(entryId, order) {
+        if (currentId === null || current === null)
+            return;
+        try {
+            const { har } = await store.duplicateEntry(currentId, entryId, order, current.etag);
+            const added = har.log.entries.filter((entry) => String(entry._id) === entryId).length - 1;
+            await openRecording(currentId);
+            openEntry(entryId, added);
+        }
+        catch (err) {
+            report(err);
+        }
+    }
     async function remove(entryId, order) {
         if (currentId === null || current === null)
             return;
@@ -194,6 +212,8 @@ export function mountStudio(root, store) {
         const order = Number(section.dataset['order']);
         if (target.getAttribute('name') === 'save')
             void save(entryId, order);
+        if (target.getAttribute('name') === 'duplicate')
+            void duplicate(entryId, order);
         if (target.getAttribute('name') === 'delete')
             void remove(entryId, order);
     });

package/dist/studio/ui/page.d.ts

@@ -2,7 +2,7 @@
  * The body, shared with the browser-only mount in Task 12 so the two cannot drift into
  * two different editors.
  */
-export declare const STUDIO_MARKUP = "\n<div class=\"polly-studio\">\n<header class=\"ps-bar\">\n  <div class=\"ps-brand\">\n    <h1>polly-studio</h1>\n    <p class=\"ps-tagline\">Change what a recorded request replies with, then save it back to the HAR.</p>\n  </div>\n  <p class=\"warn banner\">Polly's <code>keepUnusedRequests</code> defaults to <code>false</code>:\n  the next record run deletes every entry it did not exercise, including the ones you edit here.\n  Set <code>persisterOptions.keepUnusedRequests: true</code> before editing.</p>\n</header>\n<main class=\"ps-panes\">\n  <section class=\"ps-pane ps-pane--list\">\n    <h2 class=\"ps-pane-title\">Recordings</h2>\n    <nav id=\"recordings\" class=\"ps-scroll\">Loading\u2026</nav>\n    <form id=\"import\" class=\"ps-import\">\n      <label for=\"import-name\">Import a HAR from the swagger-recorder extension</label>\n      <input id=\"import-name\" name=\"recordingName\" placeholder=\"recording name, e.g. my-app\" />\n      <input id=\"import-file\" name=\"har\" type=\"file\" accept=\".har,application/json\" />\n      <button type=\"submit\">Import</button>\n      <div id=\"import-report\" aria-live=\"polite\"></div>\n    </form>\n  </section>\n  <section class=\"ps-pane ps-pane--list\">\n    <h2 class=\"ps-pane-title\">Requests</h2>\n    <div id=\"entries\" class=\"ps-scroll\"></div>\n  </section>\n  <section class=\"ps-pane ps-pane--editor\">\n    <h2 class=\"ps-pane-title\">Recorded exchange</h2>\n    <div id=\"detail\" class=\"ps-scroll\"></div>\n  </section>\n</main>\n</div>";
+export declare const STUDIO_MARKUP = "\n<div class=\"polly-studio\">\n<!--\n  Import sits beside the title, not inside the recordings list.\n  It makes a recording rather than picking one, so under the list it read as a\n  footer of that list \u2014 something you do *to* the thing above it \u2014 and it\n  pushed the list it was supposedly part of into a shorter and shorter box.\n-->\n<header class=\"ps-bar\">\n  <div class=\"ps-brand\">\n    <h1>polly-studio</h1>\n    <p class=\"ps-tagline\">Change what a recorded request replies with, then save it back to the HAR.</p>\n  </div>\n  <form id=\"import\" class=\"ps-import\">\n    <h2 class=\"ps-import-title\">Import</h2>\n    <label for=\"import-name\">A HAR from the swagger-recorder extension</label>\n    <div class=\"ps-import-row\">\n      <input id=\"import-name\" name=\"recordingName\" placeholder=\"recording name, e.g. my-app\" />\n      <input id=\"import-file\" name=\"har\" type=\"file\" accept=\".har,application/json\" />\n      <button type=\"submit\">Import</button>\n    </div>\n    <div id=\"import-report\" aria-live=\"polite\"></div>\n  </form>\n</header>\n<p class=\"warn banner\">Polly's <code>keepUnusedRequests</code> defaults to <code>false</code>:\nthe next record run deletes every entry it did not exercise, including the ones you edit here.\nSet <code>persisterOptions.keepUnusedRequests: true</code> before editing.</p>\n<main class=\"ps-panes\">\n  <section class=\"ps-pane ps-pane--list\">\n    <h2 class=\"ps-pane-title\">Recordings</h2>\n    <nav id=\"recordings\" class=\"ps-scroll\">Loading\u2026</nav>\n  </section>\n  <section class=\"ps-pane ps-pane--list\">\n    <h2 class=\"ps-pane-title\">Requests</h2>\n    <div id=\"entries\" class=\"ps-scroll\"></div>\n  </section>\n  <section class=\"ps-pane ps-pane--editor\">\n    <h2 class=\"ps-pane-title\">Recorded exchange</h2>\n    <div id=\"detail\" class=\"ps-scroll\"></div>\n  </section>\n</main>\n</div>";
 /**
  * The HTML shell.
  *
@@ -50,4 +50,4 @@ export declare const PAGE_STYLE = "\nhtml { color-scheme: light; }\nhtml, body {
  * rules restyled the host app's own type and margins as a side effect of mounting an
  * editor. Scoping is the only thing preventing that, so new rules need the prefix too.
  */
-export declare const STUDIO_STYLE = "\n.polly-studio, .polly-studio *, .polly-studio *::before, .polly-studio *::after { box-sizing: border-box; }\n.polly-studio {\n  --ps-paper: #eaeef5;\n  --ps-surface: #ffffff;\n  --ps-sunken: #f1f5fb;\n  --ps-ink: #111722;\n  --ps-ink-soft: #4d5867;\n  --ps-ink-faint: #838e9d;\n  --ps-line: #dce3ed;\n  --ps-line-strong: #c3ccda;\n  --ps-accent: #3d2fbd;\n  --ps-accent-deep: #2e2298;\n  --ps-accent-line: #c8c2f0;\n  --ps-accent-soft: #eeecfb;\n  --ps-ok: #0a6b3d; --ps-ok-line: #b6ddc6; --ps-ok-soft: #e8f4ed;\n  --ps-warn: #875700; --ps-warn-line: #ecd3a3; --ps-warn-soft: #fbf2e1;\n  --ps-bad: #b3261e; --ps-bad-line: #edbdb9; --ps-bad-soft: #fceceb;\n  --ps-mono: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n\n  color-scheme: light;\n  font-family: ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", Roboto, sans-serif;\n  font-size: 15px;\n  line-height: 1.5;\n  color: var(--ps-ink);\n  background: var(--ps-paper);\n  display: flex;\n  flex-direction: column;\n  height: 100%;\n  min-height: 34rem;\n}\n\n/* Title bar ------------------------------------------------------------ */\n.polly-studio .ps-bar {\n  display: flex; flex-wrap: wrap; align-items: center; gap: .6rem 1.75rem;\n  padding: .8rem 1.25rem;\n  background: var(--ps-surface);\n  border-bottom: 1px solid var(--ps-line);\n}\n.polly-studio .ps-brand { display: flex; align-items: baseline; flex-wrap: wrap; gap: .1rem .75rem; }\n.polly-studio h1 { margin: 0; font-size: 1.0625rem; font-weight: 650; letter-spacing: -.015em; }\n.polly-studio .ps-tagline { margin: 0; font-size: .8125rem; color: var(--ps-ink-soft); }\n.polly-studio .banner {\n  flex: 1 1 26rem; min-width: 16rem; margin: 0;\n  padding: .45rem .7rem;\n  font-size: .78rem; line-height: 1.45;\n  background: var(--ps-warn-soft);\n  border: 1px solid var(--ps-warn-line); border-left-width: 3px;\n  border-radius: 0 7px 7px 0;\n}\n.polly-studio code {\n  font-family: var(--ps-mono); font-size: .92em;\n  background: rgba(17,23,34,.05); border-radius: 4px; padding: 0 .22em;\n}\n\n/* Panes ---------------------------------------------------------------- */\n.polly-studio .ps-panes {\n  flex: 1; min-height: 0;\n  display: grid; gap: .9rem;\n  grid-template-columns: 17rem 24rem minmax(0, 1fr);\n  padding: .9rem 1.25rem 1.25rem;\n}\n.polly-studio .ps-pane {\n  display: flex; flex-direction: column; min-height: 0;\n  border: 1px solid var(--ps-line); border-radius: 12px;\n  background: var(--ps-surface);\n  overflow: hidden;\n}\n/* The two browsers read as one surface you pick from; the editor reads as the page you\n   work on. Same border, different floor \u2014 not three identical cards. */\n.polly-studio .ps-pane--list { background: var(--ps-sunken); }\n.polly-studio .ps-pane-title {\n  margin: 0; padding: .5rem .75rem;\n  font-size: .8125rem; font-weight: 600; color: var(--ps-ink-soft);\n  background: var(--ps-surface);\n  border-bottom: 1px solid var(--ps-line);\n}\n.polly-studio .ps-pane--editor .ps-pane-title { box-shadow: inset 3px 0 0 var(--ps-accent); }\n.polly-studio .ps-scroll { flex: 1; min-height: 0; overflow: auto; padding: .5rem; }\n.polly-studio .ps-pane--editor .ps-scroll { padding: .9rem 1rem 1.25rem; }\n\n/* Recording list ------------------------------------------------------- */\n.polly-studio ul { list-style: none; margin: 0; padding: 0; }\n.polly-studio .recordings, .polly-studio #entries ul { display: grid; gap: .3rem; }\n/* Each row is its own bordered card rather than a hover-only highlight: a recorded URL\n   wraps to three or four lines often enough that without one, two rows read as one. */\n.polly-studio button.recording, .polly-studio button.entry {\n  width: 100%; text-align: left; font: inherit;\n  color: var(--ps-ink); background: var(--ps-surface);\n  border: 1px solid var(--ps-line); border-radius: 8px;\n  padding: .4rem .5rem; cursor: pointer;\n  transition: background-color .12s ease, border-color .12s ease;\n}\n.polly-studio button.recording:hover, .polly-studio button.entry:hover {\n  border-color: var(--ps-line-strong);\n}\n/* :focus, not :focus-visible \u2014 a click selects, and the selection has to be visible\n   whether it came from the mouse or the keyboard. app.ts keeps no selected state. */\n.polly-studio button.recording:focus, .polly-studio button.entry:focus {\n  outline: none; background: var(--ps-accent-soft); border-color: var(--ps-accent-line);\n}\n.polly-studio button.recording:focus-visible, .polly-studio button.entry:focus-visible {\n  outline: 2px solid var(--ps-accent); outline-offset: 1px;\n}\n.polly-studio button.recording { display: grid; grid-template-columns: minmax(0, 1fr) auto; align-items: center; gap: .5rem; }\n.polly-studio .ps-rec-name { font-family: var(--ps-mono); font-size: .8125rem; overflow-wrap: anywhere; }\n.polly-studio .count {\n  font-family: var(--ps-mono); font-size: .6875rem; color: var(--ps-ink-soft);\n  background: var(--ps-paper); border: 1px solid var(--ps-line);\n  border-radius: 999px; padding: 0 .42rem;\n}\n.polly-studio .ps-rec-note { margin: .1rem 0 .3rem .5rem; font-size: .75rem; line-height: 1.4; }\n\n/* Import form ------------------------------------------------------------ */\n.polly-studio .ps-import {\n  display: grid; gap: .4rem;\n  padding: .7rem .75rem; margin-top: .4rem;\n  border-top: 1px solid var(--ps-line);\n}\n.polly-studio .ps-import label {\n  font-size: .75rem; font-weight: 600; color: var(--ps-ink-soft);\n}\n.polly-studio .ps-import input {\n  width: 100%; min-width: 0;\n  font-family: var(--ps-mono); font-size: .8125rem; color: var(--ps-ink);\n  background: var(--ps-surface);\n  border: 1px solid var(--ps-line-strong); border-radius: 8px;\n  padding: .4rem .55rem;\n  transition: border-color .12s ease, box-shadow .12s ease;\n}\n.polly-studio .ps-import input:hover { border-color: #a9b5c6; }\n.polly-studio .ps-import input:focus {\n  outline: none; border-color: var(--ps-accent); box-shadow: 0 0 0 3px var(--ps-accent-soft);\n}\n.polly-studio .ps-import input[type=\"file\"] { font-size: .75rem; padding: .3rem .4rem; }\n.polly-studio .ps-import button {\n  font: inherit; font-size: .8125rem; font-weight: 600;\n  justify-self: start;\n  padding: .45rem .95rem; border-radius: 8px; cursor: pointer;\n  border: 1px solid transparent;\n  background: var(--ps-accent); color: #fff;\n  transition: background-color .12s ease;\n}\n.polly-studio .ps-import button:hover { background: var(--ps-accent-deep); }\n.polly-studio .ps-import button:focus-visible { outline: 2px solid var(--ps-accent); outline-offset: 2px; }\n.polly-studio .ps-import-result {\n  margin: .2rem 0 0; padding: .5rem .6rem; font-size: .78rem; line-height: 1.5;\n  background: var(--ps-sunken); border: 1px solid var(--ps-line);\n  border-left-width: 3px; border-radius: 0 8px 8px 0;\n}\n/* max-height + overflow-y: auto rather than relying on the pane's own scroll: the pane\n   around this (.ps-pane) is overflow: hidden, so without its own scroll a long skip\n   list would clip silently instead of growing the pane. */\n.polly-studio .ps-import-skips {\n  display: grid; gap: .25rem; margin: .4rem 0 0;\n  max-height: 10rem; overflow-y: auto;\n}\n.polly-studio .ps-import-skips li {\n  padding-left: .5rem; border-left: 2px solid var(--ps-line-strong);\n  font-size: .75rem; line-height: 1.4; color: var(--ps-ink-soft);\n}\n\n/* Request list --------------------------------------------------------- */\n.polly-studio button.entry {\n  display: grid; grid-template-columns: auto auto minmax(0, 1fr) auto;\n  align-items: baseline; gap: .1rem .5rem;\n}\n.polly-studio .method {\n  font-family: var(--ps-mono); font-size: .6875rem; font-weight: 700;\n  letter-spacing: .02em; color: var(--ps-ink-soft); min-width: 2.6rem;\n}\n.polly-studio .status {\n  font-family: var(--ps-mono); font-size: .6875rem; font-weight: 700;\n  border: 1px solid; border-radius: 5px; padding: 0 .3rem;\n}\n.polly-studio .status.s2 { color: var(--ps-ok); background: var(--ps-ok-soft); border-color: var(--ps-ok-line); }\n.polly-studio .status.s3 { color: var(--ps-warn); background: var(--ps-warn-soft); border-color: var(--ps-warn-line); }\n.polly-studio .status.s4, .polly-studio .status.s5 { color: var(--ps-bad); background: var(--ps-bad-soft); border-color: var(--ps-bad-line); }\n.polly-studio .url { font-family: var(--ps-mono); font-size: .78rem; overflow-wrap: anywhere; }\n.polly-studio .order { font-family: var(--ps-mono); font-size: .6875rem; color: var(--ps-ink-faint); }\n\n/* Detail --------------------------------------------------------------- */\n.polly-studio .detail { display: grid; gap: .85rem; }\n.polly-studio .ps-block {\n  border: 1px solid var(--ps-line); border-radius: 10px;\n  padding: .85rem .95rem 1rem;\n}\n.polly-studio .ps-block--request { background: var(--ps-sunken); }\n.polly-studio .detail h2 {\n  margin: 0 0 .45rem; font-size: .9375rem; font-weight: 650; letter-spacing: -.01em;\n  display: flex; align-items: baseline; gap: .5rem;\n}\n.polly-studio .detail h2 small {\n  font-size: .6875rem; font-weight: 500; color: var(--ps-ink-soft);\n  background: var(--ps-paper); border: 1px solid var(--ps-line);\n  border-radius: 999px; padding: .05rem .45rem;\n}\n.polly-studio .note { margin: 0 0 .75rem; font-size: .78rem; line-height: 1.5; color: var(--ps-ink-soft); max-width: 68ch; }\n.polly-studio dl { display: grid; grid-template-columns: max-content minmax(0, 1fr); gap: .3rem .9rem; margin: 0; font-size: .8125rem; }\n.polly-studio dt { font-weight: 600; color: var(--ps-ink-soft); }\n.polly-studio dd { margin: 0; font-family: var(--ps-mono); overflow-wrap: anywhere; }\n.polly-studio .ps-group-title {\n  margin: 1rem 0 .4rem; font-size: .75rem; font-weight: 600; color: var(--ps-ink-soft);\n}\n\n/* Fields --------------------------------------------------------------- */\n.polly-studio .ps-fields { display: grid; grid-template-columns: 7rem minmax(0, 1fr); gap: .55rem; }\n.polly-studio label.ps-field { display: grid; gap: .25rem; margin: 0; }\n.polly-studio .ps-field-label { font-size: .75rem; font-weight: 600; color: var(--ps-ink-soft); }\n.polly-studio .ps-input, .polly-studio textarea {\n  width: 100%; min-width: 0;\n  font-family: var(--ps-mono); font-size: .8125rem; color: var(--ps-ink);\n  background: var(--ps-surface);\n  border: 1px solid var(--ps-line-strong); border-radius: 8px;\n  padding: .4rem .55rem;\n  transition: border-color .12s ease, box-shadow .12s ease;\n}\n.polly-studio .ps-input:hover, .polly-studio textarea:hover, .polly-studio .header-row:hover { border-color: #a9b5c6; }\n.polly-studio .ps-input:focus, .polly-studio textarea:focus {\n  outline: none; border-color: var(--ps-accent); box-shadow: 0 0 0 3px var(--ps-accent-soft);\n}\n.polly-studio textarea { display: block; line-height: 1.55; resize: vertical; min-height: 11rem; tab-size: 2; }\n\n/* A header is one name:value pair, so it is one control split by a hairline, not two\n   inputs that happen to sit side by side. */\n.polly-studio .headers { display: grid; gap: .35rem; }\n.polly-studio .header-row {\n  display: grid; grid-template-columns: minmax(6rem, 13rem) minmax(0, 1fr);\n  background: var(--ps-surface);\n  border: 1px solid var(--ps-line-strong); border-radius: 8px;\n  overflow: hidden;\n  transition: border-color .12s ease, box-shadow .12s ease;\n}\n.polly-studio .header-row:focus-within { border-color: var(--ps-accent); box-shadow: 0 0 0 3px var(--ps-accent-soft); }\n.polly-studio .header-row input {\n  width: 100%; min-width: 0;\n  font-family: var(--ps-mono); font-size: .8125rem; color: var(--ps-ink);\n  background: transparent; border: 0; padding: .38rem .55rem;\n}\n.polly-studio .header-row input:focus { outline: none; }\n.polly-studio .header-row input[name^=\"headerName\"] {\n  color: var(--ps-accent-deep); font-weight: 600;\n  background: var(--ps-sunken); border-right: 1px solid var(--ps-line);\n}\n\n/* Actions -------------------------------------------------------------- */\n.polly-studio .actions {\n  display: flex; flex-wrap: wrap; gap: .5rem;\n  margin-top: 1rem; padding-top: .9rem;\n  border-top: 1px solid var(--ps-line);\n}\n.polly-studio .actions button {\n  font: inherit; font-size: .8125rem; font-weight: 600;\n  padding: .45rem .95rem; border-radius: 8px; cursor: pointer;\n  border: 1px solid transparent;\n  transition: background-color .12s ease, border-color .12s ease;\n}\n.polly-studio .actions button[name=\"save\"] { background: var(--ps-accent); color: #fff; }\n.polly-studio .actions button[name=\"save\"]:hover { background: var(--ps-accent-deep); }\n.polly-studio .actions button.danger { background: var(--ps-surface); color: var(--ps-bad); border-color: var(--ps-bad-line); }\n.polly-studio .actions button.danger:hover { background: var(--ps-bad-soft); }\n.polly-studio .actions button:focus-visible { outline: 2px solid var(--ps-accent); outline-offset: 2px; }\n\n/* Notices and empty states --------------------------------------------- */\n.polly-studio .warn { color: var(--ps-warn); }\n.polly-studio .problem { color: var(--ps-bad); }\n.polly-studio .ps-notice {\n  margin: 0; padding: .55rem .7rem; font-size: .8125rem; line-height: 1.5;\n  background: var(--ps-warn-soft); border: 1px solid var(--ps-warn-line);\n  border-left-width: 3px; border-radius: 0 8px 8px 0;\n}\n/* report() prepends a bare <p class=\"problem\"> here; it is the only alert the page has. */\n.polly-studio #detail > .problem {\n  margin: 0 0 .85rem; padding: .55rem .7rem; font-size: .8125rem;\n  background: var(--ps-bad-soft); border: 1px solid var(--ps-bad-line);\n  border-left-width: 3px; border-radius: 0 8px 8px 0;\n}\n.polly-studio section.problem { margin: 0; }\n.polly-studio li.problem { padding: .4rem .5rem; font-size: .8125rem; }\n.polly-studio .empty {\n  margin: 0; padding: 1.5rem .75rem; text-align: center;\n  font-size: .8125rem; line-height: 1.55; color: var(--ps-ink-faint);\n}\n/* The same class inside the editor is a field standing in for a control, not a pane with\n   nothing in it \u2014 centring it there would read as a broken row between two left-aligned\n   groups. */\n.polly-studio .ps-block .empty { padding: .3rem 0 .1rem; text-align: left; }\n/* The two panes app.ts blanks rather than filling with a placeholder. ::before keeps the\n   hint out of the markup, so nothing here has to be re-added after every innerHTML wipe. */\n.polly-studio #entries:empty::before, .polly-studio #detail:empty::before {\n  display: block; padding: 1.75rem .75rem; text-align: center;\n  font-size: .8125rem; color: var(--ps-ink-faint);\n}\n.polly-studio #entries:empty::before { content: \"Pick a recording to see the requests it captured.\"; }\n.polly-studio #detail:empty::before { content: \"Pick a request to edit the response it replays.\"; }\n\n@media (max-width: 72rem) {\n  .polly-studio { height: auto; }\n  .polly-studio .ps-panes { grid-template-columns: minmax(0, 1fr); }\n  .polly-studio .ps-pane--list .ps-scroll { max-height: 18rem; }\n}\n@media (max-width: 34rem) {\n  .polly-studio .ps-fields { grid-template-columns: minmax(0, 1fr); }\n  .polly-studio .header-row { grid-template-columns: minmax(0, 1fr); }\n  .polly-studio .header-row input[name^=\"headerName\"] { border-right: 0; border-bottom: 1px solid var(--ps-line); }\n}\n@media (prefers-reduced-motion: reduce) {\n  .polly-studio * { transition: none !important; }\n}\n";
+export declare const STUDIO_STYLE = "\n.polly-studio, .polly-studio *, .polly-studio *::before, .polly-studio *::after { box-sizing: border-box; }\n.polly-studio {\n  --ps-paper: #eaeef5;\n  --ps-surface: #ffffff;\n  --ps-sunken: #f1f5fb;\n  --ps-ink: #111722;\n  --ps-ink-soft: #4d5867;\n  --ps-ink-faint: #838e9d;\n  --ps-line: #dce3ed;\n  --ps-line-strong: #c3ccda;\n  --ps-accent: #3d2fbd;\n  --ps-accent-deep: #2e2298;\n  --ps-accent-line: #c8c2f0;\n  --ps-accent-soft: #eeecfb;\n  --ps-ok: #0a6b3d; --ps-ok-line: #b6ddc6; --ps-ok-soft: #e8f4ed;\n  --ps-warn: #875700; --ps-warn-line: #ecd3a3; --ps-warn-soft: #fbf2e1;\n  --ps-bad: #b3261e; --ps-bad-line: #edbdb9; --ps-bad-soft: #fceceb;\n  --ps-lift: 0 1px 2px rgba(17,23,34,.05), 0 10px 22px -14px rgba(17,23,34,.35);\n  --ps-mono: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n\n  color-scheme: light;\n  font-family: ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", Roboto, sans-serif;\n  font-size: 15px;\n  line-height: 1.5;\n  color: var(--ps-ink);\n  background: var(--ps-paper);\n  display: flex;\n  flex-direction: column;\n  height: 100%;\n  min-height: 34rem;\n}\n\n/* Title bar ------------------------------------------------------------ */\n/* The title on the left, import on the right, and the warning on its own line\n   underneath: three things competing for one row left the import squeezed into\n   whatever the banner had not taken. */\n.polly-studio .ps-bar {\n  display: flex; flex-wrap: wrap; align-items: flex-start;\n  justify-content: space-between; gap: .9rem 1.75rem;\n  padding: .8rem 1.25rem;\n  background: var(--ps-surface);\n  border-bottom: 1px solid var(--ps-line);\n}\n.polly-studio .ps-brand { display: flex; align-items: baseline; flex-wrap: wrap; gap: .1rem .75rem; }\n.polly-studio h1 { margin: 0; font-size: 1.0625rem; font-weight: 650; letter-spacing: -.015em; }\n.polly-studio .ps-tagline { margin: 0; font-size: .8125rem; color: var(--ps-ink-soft); }\n.polly-studio .banner {\n  margin: .9rem 1.25rem 0; padding: .45rem .7rem;\n  font-size: .78rem; line-height: 1.45;\n  background: var(--ps-warn-soft);\n  border: 1px solid var(--ps-warn-line); border-left-width: 3px;\n  border-radius: 0 7px 7px 0;\n}\n.polly-studio code {\n  font-family: var(--ps-mono); font-size: .92em;\n  background: rgba(17,23,34,.05); border-radius: 4px; padding: 0 .22em;\n}\n\n/* Panes ---------------------------------------------------------------- */\n.polly-studio .ps-panes {\n  flex: 1; min-height: 0;\n  display: grid; gap: .9rem;\n  grid-template-columns: 17rem 24rem minmax(0, 1fr);\n  padding: .9rem 1.25rem 1.25rem;\n}\n.polly-studio .ps-pane {\n  display: flex; flex-direction: column; min-height: 0;\n  border: 1px solid var(--ps-line); border-radius: 12px;\n  background: var(--ps-surface);\n  /* Lifted off the paper, so where one region ends and the next begins is a\n     shadow rather than a hairline somebody has to look for. */\n  box-shadow: var(--ps-lift);\n  overflow: hidden;\n}\n/* The two browsers read as one surface you pick from; the editor reads as the page you\n   work on. Same border, different floor \u2014 not three identical cards. */\n.polly-studio .ps-pane--list { background: var(--ps-sunken); }\n.polly-studio .ps-pane-title {\n  margin: 0; padding: .5rem .75rem;\n  font-size: .8125rem; font-weight: 600; color: var(--ps-ink-soft);\n  background: var(--ps-surface);\n  border-bottom: 1px solid var(--ps-line);\n}\n.polly-studio .ps-pane--editor .ps-pane-title { box-shadow: inset 3px 0 0 var(--ps-accent); }\n.polly-studio .ps-scroll { flex: 1; min-height: 0; overflow: auto; padding: .5rem; }\n.polly-studio .ps-pane--editor .ps-scroll { padding: .9rem 1rem 1.25rem; }\n\n/* Recording list ------------------------------------------------------- */\n.polly-studio ul { list-style: none; margin: 0; padding: 0; }\n.polly-studio .recordings, .polly-studio #entries ul { display: grid; gap: .3rem; }\n/* Each row is its own bordered card rather than a hover-only highlight: a recorded URL\n   wraps to three or four lines often enough that without one, two rows read as one. */\n.polly-studio button.recording, .polly-studio button.entry {\n  width: 100%; text-align: left; font: inherit;\n  color: var(--ps-ink); background: var(--ps-surface);\n  border: 1px solid var(--ps-line); border-radius: 8px;\n  padding: .4rem .5rem; cursor: pointer;\n  transition: background-color .12s ease, border-color .12s ease;\n}\n.polly-studio button.recording:hover, .polly-studio button.entry:hover {\n  border-color: var(--ps-line-strong);\n}\n/* :focus, not :focus-visible \u2014 a click selects, and the selection has to be visible\n   whether it came from the mouse or the keyboard. app.ts keeps no selected state. */\n.polly-studio button.recording:focus, .polly-studio button.entry:focus {\n  outline: none; background: var(--ps-accent-soft); border-color: var(--ps-accent-line);\n}\n.polly-studio button.recording:focus-visible, .polly-studio button.entry:focus-visible {\n  outline: 2px solid var(--ps-accent); outline-offset: 1px;\n}\n.polly-studio button.recording { display: grid; grid-template-columns: minmax(0, 1fr) auto; align-items: center; gap: .5rem; }\n.polly-studio .ps-rec-name { font-family: var(--ps-mono); font-size: .8125rem; overflow-wrap: anywhere; }\n.polly-studio .count {\n  font-family: var(--ps-mono); font-size: .6875rem; color: var(--ps-ink-soft);\n  background: var(--ps-paper); border: 1px solid var(--ps-line);\n  border-radius: 999px; padding: 0 .42rem;\n}\n.polly-studio .ps-rec-note { margin: .1rem 0 .3rem .5rem; font-size: .75rem; line-height: 1.4; }\n\n/* Import form ------------------------------------------------------------ */\n/* A card of its own in the title bar. Bounded width so a long page does not\n   stretch it across the screen, and wide enough that the three controls sit on\n   one line at the sizes this is actually used at. */\n.polly-studio .ps-import {\n  display: grid; gap: .35rem;\n  flex: 0 1 34rem; min-width: 17rem;\n  padding: .6rem .7rem;\n  background: var(--ps-sunken);\n  border: 1px solid var(--ps-line); border-radius: 12px;\n  box-shadow: var(--ps-lift);\n}\n.polly-studio .ps-import-title {\n  margin: 0; font-size: .8125rem; font-weight: 650; color: var(--ps-ink);\n}\n.polly-studio .ps-import-row {\n  display: grid; gap: .4rem;\n  grid-template-columns: minmax(7rem, 1fr) minmax(8rem, 1.2fr) auto;\n  align-items: center;\n}\n.polly-studio .ps-import label {\n  font-size: .75rem; font-weight: 600; color: var(--ps-ink-soft);\n}\n.polly-studio .ps-import input {\n  width: 100%; min-width: 0;\n  font-family: var(--ps-mono); font-size: .8125rem; color: var(--ps-ink);\n  background: var(--ps-surface);\n  border: 1px solid var(--ps-line-strong); border-radius: 8px;\n  padding: .4rem .55rem;\n  transition: border-color .12s ease, box-shadow .12s ease;\n}\n.polly-studio .ps-import input:hover { border-color: #a9b5c6; }\n.polly-studio .ps-import input:focus {\n  outline: none; border-color: var(--ps-accent); box-shadow: 0 0 0 3px var(--ps-accent-soft);\n}\n.polly-studio .ps-import input[type=\"file\"] { font-size: .75rem; padding: .3rem .4rem; }\n.polly-studio .ps-import button {\n  font: inherit; font-size: .8125rem; font-weight: 600;\n  justify-self: stretch; white-space: nowrap;\n  padding: .45rem .95rem; border-radius: 8px; cursor: pointer;\n  border: 1px solid transparent;\n  background: var(--ps-accent); color: #fff;\n  transition: background-color .12s ease;\n}\n.polly-studio .ps-import button:hover { background: var(--ps-accent-deep); }\n.polly-studio .ps-import button:focus-visible { outline: 2px solid var(--ps-accent); outline-offset: 2px; }\n.polly-studio .ps-import-result {\n  margin: .2rem 0 0; padding: .5rem .6rem; font-size: .78rem; line-height: 1.5;\n  background: var(--ps-sunken); border: 1px solid var(--ps-line);\n  border-left-width: 3px; border-radius: 0 8px 8px 0;\n}\n/* max-height + overflow-y: auto rather than relying on the pane's own scroll: the pane\n   around this (.ps-pane) is overflow: hidden, so without its own scroll a long skip\n   list would clip silently instead of growing the pane. */\n.polly-studio .ps-import-skips {\n  display: grid; gap: .25rem; margin: .4rem 0 0;\n  max-height: 10rem; overflow-y: auto;\n}\n.polly-studio .ps-import-skips li {\n  padding-left: .5rem; border-left: 2px solid var(--ps-line-strong);\n  font-size: .75rem; line-height: 1.4; color: var(--ps-ink-soft);\n}\n\n/* Request list --------------------------------------------------------- */\n.polly-studio button.entry {\n  display: grid; grid-template-columns: auto auto minmax(0, 1fr) auto;\n  align-items: baseline; gap: .1rem .5rem;\n}\n.polly-studio .method {\n  font-family: var(--ps-mono); font-size: .6875rem; font-weight: 700;\n  letter-spacing: .02em; color: var(--ps-ink-soft); min-width: 2.6rem;\n}\n.polly-studio .status {\n  font-family: var(--ps-mono); font-size: .6875rem; font-weight: 700;\n  border: 1px solid; border-radius: 5px; padding: 0 .3rem;\n}\n.polly-studio .status.s2 { color: var(--ps-ok); background: var(--ps-ok-soft); border-color: var(--ps-ok-line); }\n.polly-studio .status.s3 { color: var(--ps-warn); background: var(--ps-warn-soft); border-color: var(--ps-warn-line); }\n.polly-studio .status.s4, .polly-studio .status.s5 { color: var(--ps-bad); background: var(--ps-bad-soft); border-color: var(--ps-bad-line); }\n.polly-studio .url { font-family: var(--ps-mono); font-size: .78rem; overflow-wrap: anywhere; }\n.polly-studio .order { font-family: var(--ps-mono); font-size: .6875rem; color: var(--ps-ink-faint); }\n\n/* Detail --------------------------------------------------------------- */\n.polly-studio .detail { display: grid; gap: .85rem; }\n.polly-studio .ps-block {\n  border: 1px solid var(--ps-line); border-radius: 10px;\n  padding: .85rem .95rem 1rem;\n}\n.polly-studio .ps-block--request { background: var(--ps-sunken); }\n.polly-studio .detail h2 {\n  margin: 0 0 .45rem; font-size: .9375rem; font-weight: 650; letter-spacing: -.01em;\n  display: flex; align-items: baseline; gap: .5rem;\n}\n.polly-studio .detail h2 small {\n  font-size: .6875rem; font-weight: 500; color: var(--ps-ink-soft);\n  background: var(--ps-paper); border: 1px solid var(--ps-line);\n  border-radius: 999px; padding: .05rem .45rem;\n}\n.polly-studio .note { margin: 0 0 .75rem; font-size: .78rem; line-height: 1.5; color: var(--ps-ink-soft); max-width: 68ch; }\n.polly-studio dl { display: grid; grid-template-columns: max-content minmax(0, 1fr); gap: .3rem .9rem; margin: 0; font-size: .8125rem; }\n.polly-studio dt { font-weight: 600; color: var(--ps-ink-soft); }\n.polly-studio dd { margin: 0; font-family: var(--ps-mono); overflow-wrap: anywhere; }\n.polly-studio .ps-group-title {\n  margin: 1rem 0 .4rem; font-size: .75rem; font-weight: 600; color: var(--ps-ink-soft);\n}\n\n/* Fields --------------------------------------------------------------- */\n.polly-studio .ps-fields { display: grid; grid-template-columns: 7rem minmax(0, 1fr); gap: .55rem; }\n.polly-studio label.ps-field { display: grid; gap: .25rem; margin: 0; }\n.polly-studio .ps-field-label { font-size: .75rem; font-weight: 600; color: var(--ps-ink-soft); }\n.polly-studio .ps-input, .polly-studio textarea {\n  width: 100%; min-width: 0;\n  font-family: var(--ps-mono); font-size: .8125rem; color: var(--ps-ink);\n  background: var(--ps-surface);\n  border: 1px solid var(--ps-line-strong); border-radius: 8px;\n  padding: .4rem .55rem;\n  transition: border-color .12s ease, box-shadow .12s ease;\n}\n.polly-studio .ps-input:hover, .polly-studio textarea:hover, .polly-studio .header-row:hover { border-color: #a9b5c6; }\n.polly-studio .ps-input:focus, .polly-studio textarea:focus {\n  outline: none; border-color: var(--ps-accent); box-shadow: 0 0 0 3px var(--ps-accent-soft);\n}\n.polly-studio textarea { display: block; line-height: 1.55; resize: vertical; min-height: 11rem; tab-size: 2; }\n\n/* A header is one name:value pair, so it is one control split by a hairline, not two\n   inputs that happen to sit side by side. */\n.polly-studio .headers { display: grid; gap: .35rem; }\n.polly-studio .header-row {\n  display: grid; grid-template-columns: minmax(6rem, 13rem) minmax(0, 1fr);\n  background: var(--ps-surface);\n  border: 1px solid var(--ps-line-strong); border-radius: 8px;\n  overflow: hidden;\n  transition: border-color .12s ease, box-shadow .12s ease;\n}\n.polly-studio .header-row:focus-within { border-color: var(--ps-accent); box-shadow: 0 0 0 3px var(--ps-accent-soft); }\n.polly-studio .header-row input {\n  width: 100%; min-width: 0;\n  font-family: var(--ps-mono); font-size: .8125rem; color: var(--ps-ink);\n  background: transparent; border: 0; padding: .38rem .55rem;\n}\n.polly-studio .header-row input:focus { outline: none; }\n.polly-studio .header-row input[name^=\"headerName\"] {\n  color: var(--ps-accent-deep); font-weight: 600;\n  background: var(--ps-sunken); border-right: 1px solid var(--ps-line);\n}\n\n/* Actions -------------------------------------------------------------- */\n.polly-studio .actions {\n  display: flex; flex-wrap: wrap; gap: .5rem;\n  margin-top: 1rem; padding-top: .9rem;\n  border-top: 1px solid var(--ps-line);\n}\n.polly-studio .actions button {\n  font: inherit; font-size: .8125rem; font-weight: 600;\n  padding: .45rem .95rem; border-radius: 8px; cursor: pointer;\n  border: 1px solid transparent;\n  transition: background-color .12s ease, border-color .12s ease;\n}\n.polly-studio .actions button[name=\"save\"] { background: var(--ps-accent); color: #fff; }\n.polly-studio .actions button[name=\"save\"]:hover { background: var(--ps-accent-deep); }\n.polly-studio .actions button.danger { background: var(--ps-surface); color: var(--ps-bad); border-color: var(--ps-bad-line); }\n.polly-studio .actions button.danger:hover { background: var(--ps-bad-soft); }\n.polly-studio .actions button:focus-visible { outline: 2px solid var(--ps-accent); outline-offset: 2px; }\n\n/* Notices and empty states --------------------------------------------- */\n.polly-studio .warn { color: var(--ps-warn); }\n.polly-studio .problem { color: var(--ps-bad); }\n.polly-studio .ps-notice {\n  margin: 0; padding: .55rem .7rem; font-size: .8125rem; line-height: 1.5;\n  background: var(--ps-warn-soft); border: 1px solid var(--ps-warn-line);\n  border-left-width: 3px; border-radius: 0 8px 8px 0;\n}\n/* report() prepends a bare <p class=\"problem\"> here; it is the only alert the page has. */\n.polly-studio #detail > .problem {\n  margin: 0 0 .85rem; padding: .55rem .7rem; font-size: .8125rem;\n  background: var(--ps-bad-soft); border: 1px solid var(--ps-bad-line);\n  border-left-width: 3px; border-radius: 0 8px 8px 0;\n}\n.polly-studio section.problem { margin: 0; }\n.polly-studio li.problem { padding: .4rem .5rem; font-size: .8125rem; }\n.polly-studio .empty {\n  margin: 0; padding: 1.5rem .75rem; text-align: center;\n  font-size: .8125rem; line-height: 1.55; color: var(--ps-ink-faint);\n}\n/* The same class inside the editor is a field standing in for a control, not a pane with\n   nothing in it \u2014 centring it there would read as a broken row between two left-aligned\n   groups. */\n.polly-studio .ps-block .empty { padding: .3rem 0 .1rem; text-align: left; }\n/* The two panes app.ts blanks rather than filling with a placeholder. ::before keeps the\n   hint out of the markup, so nothing here has to be re-added after every innerHTML wipe. */\n.polly-studio #entries:empty::before, .polly-studio #detail:empty::before {\n  display: block; padding: 1.75rem .75rem; text-align: center;\n  font-size: .8125rem; color: var(--ps-ink-faint);\n}\n.polly-studio #entries:empty::before { content: \"Pick a recording to see the requests it captured.\"; }\n.polly-studio #detail:empty::before { content: \"Pick a request to edit the response it replays.\"; }\n\n@media (max-width: 72rem) {\n  .polly-studio { height: auto; }\n  .polly-studio .ps-panes { grid-template-columns: minmax(0, 1fr); }\n  .polly-studio .ps-pane--list .ps-scroll { max-height: 18rem; }\n}\n@media (max-width: 34rem) {\n  .polly-studio .ps-import-row { grid-template-columns: minmax(0, 1fr); }\n  .polly-studio .ps-fields { grid-template-columns: minmax(0, 1fr); }\n  .polly-studio .header-row { grid-template-columns: minmax(0, 1fr); }\n  .polly-studio .header-row input[name^=\"headerName\"] { border-right: 0; border-bottom: 1px solid var(--ps-line); }\n}\n@media (prefers-reduced-motion: reduce) {\n  .polly-studio * { transition: none !important; }\n}\n";

package/dist/studio/ui/page.js

@@ -4,26 +4,35 @@
  */
 export const STUDIO_MARKUP = `
 <div class="polly-studio">
+<!--
+  Import sits beside the title, not inside the recordings list.
+  It makes a recording rather than picking one, so under the list it read as a
+  footer of that list — something you do *to* the thing above it — and it
+  pushed the list it was supposedly part of into a shorter and shorter box.
+-->
 <header class="ps-bar">
   <div class="ps-brand">
     <h1>polly-studio</h1>
     <p class="ps-tagline">Change what a recorded request replies with, then save it back to the HAR.</p>
   </div>
-  <p class="warn banner">Polly's <code>keepUnusedRequests</code> defaults to <code>false</code>:
-  the next record run deletes every entry it did not exercise, including the ones you edit here.
-  Set <code>persisterOptions.keepUnusedRequests: true</code> before editing.</p>
+  <form id="import" class="ps-import">
+    <h2 class="ps-import-title">Import</h2>
+    <label for="import-name">A HAR from the swagger-recorder extension</label>
+    <div class="ps-import-row">
+      <input id="import-name" name="recordingName" placeholder="recording name, e.g. my-app" />
+      <input id="import-file" name="har" type="file" accept=".har,application/json" />
+      <button type="submit">Import</button>
+    </div>
+    <div id="import-report" aria-live="polite"></div>
+  </form>
 </header>
+<p class="warn banner">Polly's <code>keepUnusedRequests</code> defaults to <code>false</code>:
+the next record run deletes every entry it did not exercise, including the ones you edit here.
+Set <code>persisterOptions.keepUnusedRequests: true</code> before editing.</p>
 <main class="ps-panes">
   <section class="ps-pane ps-pane--list">
     <h2 class="ps-pane-title">Recordings</h2>
     <nav id="recordings" class="ps-scroll">Loading…</nav>
-    <form id="import" class="ps-import">
-      <label for="import-name">Import a HAR from the swagger-recorder extension</label>
-      <input id="import-name" name="recordingName" placeholder="recording name, e.g. my-app" />
-      <input id="import-file" name="har" type="file" accept=".har,application/json" />
-      <button type="submit">Import</button>
-      <div id="import-report" aria-live="polite"></div>
-    </form>
   </section>
   <section class="ps-pane ps-pane--list">
     <h2 class="ps-pane-title">Requests</h2>
@@ -122,6 +131,7 @@ export const STUDIO_STYLE = `
   --ps-ok: #0a6b3d; --ps-ok-line: #b6ddc6; --ps-ok-soft: #e8f4ed;
   --ps-warn: #875700; --ps-warn-line: #ecd3a3; --ps-warn-soft: #fbf2e1;
   --ps-bad: #b3261e; --ps-bad-line: #edbdb9; --ps-bad-soft: #fceceb;
+  --ps-lift: 0 1px 2px rgba(17,23,34,.05), 0 10px 22px -14px rgba(17,23,34,.35);
   --ps-mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;
 
   color-scheme: light;
@@ -137,8 +147,12 @@ export const STUDIO_STYLE = `
 }
 
 /* Title bar ------------------------------------------------------------ */
+/* The title on the left, import on the right, and the warning on its own line
+   underneath: three things competing for one row left the import squeezed into
+   whatever the banner had not taken. */
 .polly-studio .ps-bar {
-  display: flex; flex-wrap: wrap; align-items: center; gap: .6rem 1.75rem;
+  display: flex; flex-wrap: wrap; align-items: flex-start;
+  justify-content: space-between; gap: .9rem 1.75rem;
   padding: .8rem 1.25rem;
   background: var(--ps-surface);
   border-bottom: 1px solid var(--ps-line);
@@ -147,8 +161,7 @@ export const STUDIO_STYLE = `
 .polly-studio h1 { margin: 0; font-size: 1.0625rem; font-weight: 650; letter-spacing: -.015em; }
 .polly-studio .ps-tagline { margin: 0; font-size: .8125rem; color: var(--ps-ink-soft); }
 .polly-studio .banner {
-  flex: 1 1 26rem; min-width: 16rem; margin: 0;
-  padding: .45rem .7rem;
+  margin: .9rem 1.25rem 0; padding: .45rem .7rem;
   font-size: .78rem; line-height: 1.45;
   background: var(--ps-warn-soft);
   border: 1px solid var(--ps-warn-line); border-left-width: 3px;
@@ -170,6 +183,9 @@ export const STUDIO_STYLE = `
   display: flex; flex-direction: column; min-height: 0;
   border: 1px solid var(--ps-line); border-radius: 12px;
   background: var(--ps-surface);
+  /* Lifted off the paper, so where one region ends and the next begins is a
+     shadow rather than a hairline somebody has to look for. */
+  box-shadow: var(--ps-lift);
   overflow: hidden;
 }
 /* The two browsers read as one surface you pick from; the editor reads as the page you
@@ -218,10 +234,24 @@ export const STUDIO_STYLE = `
 .polly-studio .ps-rec-note { margin: .1rem 0 .3rem .5rem; font-size: .75rem; line-height: 1.4; }
 
 /* Import form ------------------------------------------------------------ */
+/* A card of its own in the title bar. Bounded width so a long page does not
+   stretch it across the screen, and wide enough that the three controls sit on
+   one line at the sizes this is actually used at. */
 .polly-studio .ps-import {
+  display: grid; gap: .35rem;
+  flex: 0 1 34rem; min-width: 17rem;
+  padding: .6rem .7rem;
+  background: var(--ps-sunken);
+  border: 1px solid var(--ps-line); border-radius: 12px;
+  box-shadow: var(--ps-lift);
+}
+.polly-studio .ps-import-title {
+  margin: 0; font-size: .8125rem; font-weight: 650; color: var(--ps-ink);
+}
+.polly-studio .ps-import-row {
   display: grid; gap: .4rem;
-  padding: .7rem .75rem; margin-top: .4rem;
-  border-top: 1px solid var(--ps-line);
+  grid-template-columns: minmax(7rem, 1fr) minmax(8rem, 1.2fr) auto;
+  align-items: center;
 }
 .polly-studio .ps-import label {
   font-size: .75rem; font-weight: 600; color: var(--ps-ink-soft);
@@ -241,7 +271,7 @@ export const STUDIO_STYLE = `
 .polly-studio .ps-import input[type="file"] { font-size: .75rem; padding: .3rem .4rem; }
 .polly-studio .ps-import button {
   font: inherit; font-size: .8125rem; font-weight: 600;
-  justify-self: start;
+  justify-self: stretch; white-space: nowrap;
   padding: .45rem .95rem; border-radius: 8px; cursor: pointer;
   border: 1px solid transparent;
   background: var(--ps-accent); color: #fff;
@@ -406,6 +436,7 @@ export const STUDIO_STYLE = `
   .polly-studio .ps-pane--list .ps-scroll { max-height: 18rem; }
 }
 @media (max-width: 34rem) {
+  .polly-studio .ps-import-row { grid-template-columns: minmax(0, 1fr); }
   .polly-studio .ps-fields { grid-template-columns: minmax(0, 1fr); }
   .polly-studio .header-row { grid-template-columns: minmax(0, 1fr); }
   .polly-studio .header-row input[name^="headerName"] { border-right: 0; border-bottom: 1px solid var(--ps-line); }

package/dist/studio/ui/render.js

@@ -192,8 +192,13 @@ function entryDetail(entry) {
 
     <div class="actions">
       <button name="save">Save response</button>
+      <button name="duplicate" title="Append a copy to this request's group, replayed the next time the same request is made">Duplicate for next call</button>
       <button name="delete" class="danger">Delete entry</button>
     </div>
+    <p class="note">Duplicating adds a second answer to the <em>same</em> request:
+    Polly replays <code>_order 0</code> on the first call, this copy on the second.
+    It cannot become a different request — the <code>_id</code> is a hash of the
+    request, and an edited URL under the old hash would match nothing.</p>
   </div>
 </section>`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avivbenhamo/polly-kit",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Drop-in record/replay of an app's HTTP traffic with Polly.JS, plus the polly-studio editor. Bring your own host policy.",
   "license": "MIT",
   "type": "module",
@@ -12,7 +12,7 @@
     "dist",
     "README.md"
   ],
-  "//bin": "The studio on its own, for a checkout with no dev server to mount it in. The mounted form stays the default.",
+  "//bin": "`studio` on its own, for a checkout with no dev server to mount it in — the mounted form stays the default — and `init`, which gitignores the recordings directory.",
   "bin": {
     "polly-kit": "./dist/cli.js"
   },