executable-stories-showcase 0.0.0-stage → 0.0.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,18 @@
-# Temporary Holding Version
+# executable-stories-showcase
 
-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.
+Put a running app into any state from a URL. Scenarios are JSON files that set network fixtures, URL params and app state. A dev panel lets you switch between them, inspect and edit live state, and save it as a shareable link. Playwright helpers open scenarios in tests, and adapters connect TanStack Query, Zustand, Redux and XState.
+
+```ts
+import { type ScenarioInput, startScenarios } from 'executable-stories-showcase';
+import { mountPanel } from 'executable-stories-showcase/panel';
+
+const session = await startScenarios({
+  scenarios: Object.values(
+    import.meta.glob<ScenarioInput>('./scenarios/*.json', { eager: true, import: 'default' }),
+  ),
+  defaultScenario: 'default',
+});
+mountPanel(session);
+```
+
+Documentation: https://github.com/jagreehal/executable-stories

package/dist/adapters/cookies.d.ts

@@ -0,0 +1,11 @@
+import type { TypedAdapter } from '../runtime.js';
+/**
+ * Connects `document.cookie` as `state.cookies` (or your key): `{ "authToken": "fake" }`.
+ * Applied before the app renders, so cookie-based auth gates let the scenario in.
+ * It overwrites real cookies with the same name: sign in again after leaving scenarios.
+ * Inline links can't set it; link to a catalog scenario by name instead.
+ */
+export declare const cookiesAdapter: ({ key, path }?: {
+    key?: string;
+    path?: string;
+}) => TypedAdapter<Record<string, string>>;

package/dist/adapters/cookies.js

@@ -0,0 +1,27 @@
+// src/adapters/cookies.ts
+import { z } from "zod";
+var CookiesSchema = z.record(z.string(), z.string());
+var cookiesAdapter = ({ key = "cookies", path = "/" } = {}) => ({
+  key,
+  schema: CookiesSchema,
+  apply: (cookies) => {
+    for (const [name, value] of Object.entries(cookies)) {
+      document.cookie = `${encodeURIComponent(name)}=${encodeURIComponent(value)}; path=${path}`;
+    }
+  },
+  read: () => Object.fromEntries(
+    document.cookie.split("; ").filter(Boolean).map((c) => {
+      const i = c.indexOf("=");
+      return [decodeURIComponent(c.slice(0, i)), decodeURIComponent(c.slice(i + 1))];
+    })
+  ),
+  // Cookie libraries (react-cookie, js-cookie) read once at startup.
+  inPlace: false,
+  // A cookie outlives the scenario and reaches the real backend, so only catalog
+  // scenarios, which live in the repo, set it.
+  fromLinks: false
+});
+export {
+  cookiesAdapter
+};
+//# sourceMappingURL=cookies.js.map

package/dist/adapters/cookies.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/cookies.ts"],"sourcesContent":["import { z } from 'zod';\nimport type { TypedAdapter } from '../runtime.js';\n\nconst CookiesSchema = z.record(z.string(), z.string());\n\n/**\n * Connects `document.cookie` as `state.cookies` (or your key): `{ \"authToken\": \"fake\" }`.\n * Applied before the app renders, so cookie-based auth gates let the scenario in.\n * It overwrites real cookies with the same name: sign in again after leaving scenarios.\n * Inline links can't set it; link to a catalog scenario by name instead.\n */\nexport const cookiesAdapter = (\n  { key = 'cookies', path = '/' }: { key?: string; path?: string; } = {},\n): TypedAdapter<Record<string, string>> => ({\n  key,\n  schema: CookiesSchema,\n  apply: (cookies) => {\n    for (const [name, value] of Object.entries(cookies)) {\n      document.cookie = `${encodeURIComponent(name)}=${encodeURIComponent(value)}; path=${path}`;\n    }\n  },\n  read: () =>\n    Object.fromEntries(\n      document.cookie.split('; ').filter(Boolean).map((c) => {\n        const i = c.indexOf('=');\n\n        return [decodeURIComponent(c.slice(0, i)), decodeURIComponent(c.slice(i + 1))];\n      }),\n    ),\n  // Cookie libraries (react-cookie, js-cookie) read once at startup.\n  inPlace: false,\n  // A cookie outlives the scenario and reaches the real backend, so only catalog\n  // scenarios, which live in the repo, set it.\n  fromLinks: false,\n});\n"],"mappings":";AAAA,SAAS,SAAS;AAGlB,IAAM,gBAAgB,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC;AAQ9C,IAAM,iBAAiB,CAC5B,EAAE,MAAM,WAAW,OAAO,IAAI,IAAsC,CAAC,OAC3B;AAAA,EAC1C;AAAA,EACA,QAAQ;AAAA,EACR,OAAO,CAAC,YAAY;AAClB,eAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,OAAO,GAAG;AACnD,eAAS,SAAS,GAAG,mBAAmB,IAAI,CAAC,IAAI,mBAAmB,KAAK,CAAC,UAAU,IAAI;AAAA,IAC1F;AAAA,EACF;AAAA,EACA,MAAM,MACJ,OAAO;AAAA,IACL,SAAS,OAAO,MAAM,IAAI,EAAE,OAAO,OAAO,EAAE,IAAI,CAAC,MAAM;AACrD,YAAM,IAAI,EAAE,QAAQ,GAAG;AAEvB,aAAO,CAAC,mBAAmB,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,mBAAmB,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;AAAA,IAC/E,CAAC;AAAA,EACH;AAAA;AAAA,EAEF,SAAS;AAAA;AAAA;AAAA,EAGT,WAAW;AACb;","names":[]}

package/dist/adapters/redux.d.ts

@@ -0,0 +1,23 @@
+import type { z } from 'zod';
+import type { JsonAdapter } from '../runtime.js';
+import { type Json, type Serializable } from '../schema.js';
+export declare const SCENARIO_HYDRATE = "@@scenarios/hydrate";
+interface Action {
+    type: string;
+    payload?: Json;
+}
+/**
+ * Wrap your root reducer so scenario state can be merged in. Objects deep-merge into the
+ * current state and `null` removes a key; `schema` checks the result is still valid state.
+ */
+export declare function withScenarioState<S extends Serializable, A extends Action>(reducer: (state: S | undefined, action: A) => S, schema: z.ZodType<S>): (state: S | undefined, action: A) => S;
+interface Store {
+    dispatch(action: Action): void;
+    getState(): Serializable;
+    subscribe(listener: () => void): () => void;
+}
+/** Connects a Redux store as `state.redux` (or your key). Needs `withScenarioState`. */
+export declare const reduxAdapter: (store: Store, { key }?: {
+    key?: string;
+}) => JsonAdapter;
+export {};

package/dist/adapters/redux.js

@@ -0,0 +1,28 @@
+import {
+  deepMerge
+} from "../chunk-MCC3CAWQ.js";
+import {
+  parseJson
+} from "../chunk-BK4EEQXV.js";
+
+// src/adapters/redux.ts
+var SCENARIO_HYDRATE = "@@scenarios/hydrate";
+function withScenarioState(reducer, schema) {
+  return (state, action) => {
+    if (action.type !== SCENARIO_HYDRATE || action.payload === void 0) return reducer(state, action);
+    const base = state ?? reducer(void 0, action);
+    return schema.parse(deepMerge(parseJson(JSON.stringify(base)), action.payload));
+  };
+}
+var reduxAdapter = (store, { key = "redux" } = {}) => ({
+  key,
+  apply: (payload) => store.dispatch({ type: SCENARIO_HYDRATE, payload }),
+  read: () => parseJson(JSON.stringify(store.getState())),
+  subscribe: (onChange) => store.subscribe(onChange)
+});
+export {
+  SCENARIO_HYDRATE,
+  reduxAdapter,
+  withScenarioState
+};
+//# sourceMappingURL=redux.js.map

package/dist/adapters/redux.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/redux.ts"],"sourcesContent":["import type { z } from 'zod';\nimport { deepMerge } from '../catalog.js';\nimport type { JsonAdapter } from '../runtime.js';\nimport { type Json, parseJson, type Serializable } from '../schema.js';\n\nexport const SCENARIO_HYDRATE = '@@scenarios/hydrate';\n\ninterface Action {\n  type: string;\n  payload?: Json;\n}\n\n/**\n * Wrap your root reducer so scenario state can be merged in. Objects deep-merge into the\n * current state and `null` removes a key; `schema` checks the result is still valid state.\n */\nexport function withScenarioState<S extends Serializable, A extends Action>(\n  reducer: (state: S | undefined, action: A) => S,\n  schema: z.ZodType<S>,\n) {\n  return (state: S | undefined, action: A): S => {\n    if (action.type !== SCENARIO_HYDRATE || action.payload === undefined) return reducer(state, action);\n    // Reducers return their initial state for an action they don't handle.\n    const base = state ?? reducer(undefined, action);\n\n    return schema.parse(deepMerge(parseJson(JSON.stringify(base)), action.payload));\n  };\n}\n\ninterface Store {\n  dispatch(action: Action): void;\n  getState(): Serializable;\n  subscribe(listener: () => void): () => void;\n}\n\n/** Connects a Redux store as `state.redux` (or your key). Needs `withScenarioState`. */\nexport const reduxAdapter = (store: Store, { key = 'redux' }: { key?: string; } = {}): JsonAdapter => ({\n  key,\n  apply: (payload) => store.dispatch({ type: SCENARIO_HYDRATE, payload }),\n  read: () => parseJson(JSON.stringify(store.getState())),\n  subscribe: (onChange) => store.subscribe(onChange),\n});\n"],"mappings":";;;;;;;;AAKO,IAAM,mBAAmB;AAWzB,SAAS,kBACd,SACA,QACA;AACA,SAAO,CAAC,OAAsB,WAAiB;AAC7C,QAAI,OAAO,SAAS,oBAAoB,OAAO,YAAY,OAAW,QAAO,QAAQ,OAAO,MAAM;AAElG,UAAM,OAAO,SAAS,QAAQ,QAAW,MAAM;AAE/C,WAAO,OAAO,MAAM,UAAU,UAAU,KAAK,UAAU,IAAI,CAAC,GAAG,OAAO,OAAO,CAAC;AAAA,EAChF;AACF;AASO,IAAM,eAAe,CAAC,OAAc,EAAE,MAAM,QAAQ,IAAuB,CAAC,OAAoB;AAAA,EACrG;AAAA,EACA,OAAO,CAAC,YAAY,MAAM,SAAS,EAAE,MAAM,kBAAkB,QAAQ,CAAC;AAAA,EACtE,MAAM,MAAM,UAAU,KAAK,UAAU,MAAM,SAAS,CAAC,CAAC;AAAA,EACtD,WAAW,CAAC,aAAa,MAAM,UAAU,QAAQ;AACnD;","names":[]}

package/dist/adapters/tanstack-query.d.ts

@@ -0,0 +1,17 @@
+import type { QueryClient } from '@tanstack/react-query';
+import { z } from 'zod';
+import type { TypedAdapter } from '../runtime.js';
+export declare const tanstackQueryState: z.ZodArray<z.ZodObject<{
+    queryKey: z.ZodArray<z.ZodJSONSchema>;
+    data: z.ZodJSONSchema;
+    stale: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>>;
+type CacheState = z.output<typeof tanstackQueryState>;
+/**
+ * Connects the TanStack Query cache as `state["tanstack-query"]`:
+ * [{ "queryKey": ["countries"], "data": [...] }]
+ * Seeds states the network alone can't produce (cached data while a refetch hangs),
+ * and lets the panel inspect, edit and capture the live cache.
+ */
+export declare const tanstackQuery: (client: QueryClient) => TypedAdapter<CacheState>;
+export {};

package/dist/adapters/tanstack-query.js

@@ -0,0 +1,43 @@
+import {
+  JsonSchema,
+  parseJson
+} from "../chunk-BK4EEQXV.js";
+
+// src/adapters/tanstack-query.ts
+import { z } from "zod";
+var tanstackQueryState = z.array(
+  z.object({
+    queryKey: z.array(JsonSchema).min(1),
+    data: JsonSchema,
+    /** Refetch on mount (e.g. to show a background refresh). Default: fresh, so the data stays as given. */
+    stale: z.boolean().optional()
+  })
+);
+var tanstackQuery = (client) => ({
+  key: "tanstack-query",
+  schema: tanstackQueryState,
+  async apply(entries) {
+    for (const { queryKey, data, stale } of entries) {
+      if (!stale) await client.cancelQueries({ queryKey, exact: true });
+      client.setQueryData(queryKey, data);
+      if (stale) void client.invalidateQueries({ queryKey, exact: true, refetchType: "none" });
+      else client.setQueryDefaults(queryKey, { staleTime: Infinity });
+    }
+  },
+  read: () => parseJson(JSON.stringify(
+    client.getQueryCache().getAll().flatMap(
+      (query) => query.state.data === void 0 ? [] : [{
+        queryKey: query.queryKey,
+        data: query.state.data,
+        // A refresh in flight is part of what's on screen ("Refreshing…"), so capture it.
+        stale: query.state.fetchStatus === "fetching" || void 0
+      }]
+    )
+  )),
+  subscribe: (onChange) => client.getQueryCache().subscribe(onChange)
+});
+export {
+  tanstackQuery,
+  tanstackQueryState
+};
+//# sourceMappingURL=tanstack-query.js.map

package/dist/adapters/tanstack-query.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/tanstack-query.ts"],"sourcesContent":["import type { QueryClient } from '@tanstack/react-query';\nimport { z } from 'zod';\nimport type { TypedAdapter } from '../runtime.js';\nimport { JsonSchema, parseJson } from '../schema.js';\n\nexport const tanstackQueryState = z.array(\n  z.object({\n    queryKey: z.array(JsonSchema).min(1),\n    data: JsonSchema,\n    /** Refetch on mount (e.g. to show a background refresh). Default: fresh, so the data stays as given. */\n    stale: z.boolean().optional(),\n  }),\n);\n\ntype CacheState = z.output<typeof tanstackQueryState>;\n\n/**\n * Connects the TanStack Query cache as `state[\"tanstack-query\"]`:\n * [{ \"queryKey\": [\"countries\"], \"data\": [...] }]\n * Seeds states the network alone can't produce (cached data while a refetch hangs),\n * and lets the panel inspect, edit and capture the live cache.\n */\nexport const tanstackQuery = (client: QueryClient): TypedAdapter<CacheState> => ({\n  key: 'tanstack-query',\n  schema: tanstackQueryState,\n  async apply(entries) {\n    for (const { queryKey, data, stale } of entries) {\n      // A refetch started by a scenario switch must not land on top of fresh scenario data.\n      if (!stale) await client.cancelQueries({ queryKey, exact: true });\n      client.setQueryData(queryKey, data);\n\n      // Fresh by default, so a saved scenario reproduces the screen instead of refetching over it.\n      if (stale) void client.invalidateQueries({ queryKey, exact: true, refetchType: 'none' });\n      else client.setQueryDefaults(queryKey, { staleTime: Infinity });\n    }\n  },\n  read: () =>\n    parseJson(JSON.stringify(\n      client.getQueryCache().getAll().flatMap((query) =>\n        query.state.data === undefined ? [] : [{\n          queryKey: query.queryKey,\n          data: query.state.data,\n          // A refresh in flight is part of what's on screen (\"Refreshing…\"), so capture it.\n          stale: query.state.fetchStatus === 'fetching' || undefined,\n        }]\n      ),\n    )),\n  subscribe: (onChange) => client.getQueryCache().subscribe(onChange),\n});\n"],"mappings":";;;;;;AACA,SAAS,SAAS;AAIX,IAAM,qBAAqB,EAAE;AAAA,EAClC,EAAE,OAAO;AAAA,IACP,UAAU,EAAE,MAAM,UAAU,EAAE,IAAI,CAAC;AAAA,IACnC,MAAM;AAAA;AAAA,IAEN,OAAO,EAAE,QAAQ,EAAE,SAAS;AAAA,EAC9B,CAAC;AACH;AAUO,IAAM,gBAAgB,CAAC,YAAmD;AAAA,EAC/E,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM,MAAM,SAAS;AACnB,eAAW,EAAE,UAAU,MAAM,MAAM,KAAK,SAAS;AAE/C,UAAI,CAAC,MAAO,OAAM,OAAO,cAAc,EAAE,UAAU,OAAO,KAAK,CAAC;AAChE,aAAO,aAAa,UAAU,IAAI;AAGlC,UAAI,MAAO,MAAK,OAAO,kBAAkB,EAAE,UAAU,OAAO,MAAM,aAAa,OAAO,CAAC;AAAA,UAClF,QAAO,iBAAiB,UAAU,EAAE,WAAW,SAAS,CAAC;AAAA,IAChE;AAAA,EACF;AAAA,EACA,MAAM,MACJ,UAAU,KAAK;AAAA,IACb,OAAO,cAAc,EAAE,OAAO,EAAE;AAAA,MAAQ,CAAC,UACvC,MAAM,MAAM,SAAS,SAAY,CAAC,IAAI,CAAC;AAAA,QACrC,UAAU,MAAM;AAAA,QAChB,MAAM,MAAM,MAAM;AAAA;AAAA,QAElB,OAAO,MAAM,MAAM,gBAAgB,cAAc;AAAA,MACnD,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AAAA,EACH,WAAW,CAAC,aAAa,OAAO,cAAc,EAAE,UAAU,QAAQ;AACpE;","names":[]}

package/dist/adapters/xstate.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import type { TypedAdapter } from '../runtime.js';
+/** XState's state value: "loading", or { "checkout": "payment" } for nested states. */
+type StateValue = string | {
+    [state: string]: StateValue;
+};
+export declare const xstateState: z.ZodObject<{
+    value: z.ZodType<StateValue, unknown, z.core.$ZodTypeInternals<StateValue, unknown>>;
+    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+}, z.core.$strip>;
+interface Machine<Context, Snapshot> {
+    config: {
+        context?: unknown;
+    };
+    resolveState(config: {
+        value: StateValue;
+        context: Context;
+    }): Snapshot;
+}
+/**
+ * Resolves `state.xstate` into a snapshot. Start your actor from it:
+ * `createActor(machine, { snapshot: adapter.snapshot })`.
+ */
+export declare function xstateAdapter<Context, Snapshot>(machine: Machine<Context, Snapshot>, { key, context: contextSchema }: {
+    key?: string;
+    context: z.ZodType<Context>;
+}): TypedAdapter<{
+    value: StateValue;
+    context?: Record<string, z.core.util.JSONType> | undefined;
+}> & {
+    snapshot?: Snapshot;
+};
+export {};

package/dist/adapters/xstate.js

@@ -0,0 +1,36 @@
+import {
+  deepMerge
+} from "../chunk-MCC3CAWQ.js";
+import {
+  JsonSchema
+} from "../chunk-BK4EEQXV.js";
+
+// src/adapters/xstate.ts
+import { z } from "zod";
+var StateValueSchema = z.lazy(
+  () => z.union([z.string(), z.record(z.string(), StateValueSchema)])
+);
+var xstateState = z.object({
+  value: StateValueSchema,
+  /** Merged over the machine's initial context, then decoded with the context schema. */
+  context: z.record(z.string(), JsonSchema).optional()
+});
+function xstateAdapter(machine, { key = "xstate", context: contextSchema }) {
+  const adapter = {
+    key,
+    schema: xstateState,
+    // The actor starts from the snapshot once, so a new one needs a reload.
+    inPlace: false,
+    apply({ value, context }) {
+      const initial = JsonSchema.safeParse(machine.config.context ?? {});
+      const merged = deepMerge(initial.success ? initial.data : {}, context ?? {});
+      adapter.snapshot = machine.resolveState({ value, context: contextSchema.parse(merged) });
+    }
+  };
+  return adapter;
+}
+export {
+  xstateAdapter,
+  xstateState
+};
+//# sourceMappingURL=xstate.js.map

package/dist/adapters/xstate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/xstate.ts"],"sourcesContent":["import { z } from 'zod';\nimport { deepMerge } from '../catalog.js';\nimport type { TypedAdapter } from '../runtime.js';\nimport { JsonSchema } from '../schema.js';\n\n/** XState's state value: \"loading\", or { \"checkout\": \"payment\" } for nested states. */\ntype StateValue = string | { [state: string]: StateValue; };\n\nconst StateValueSchema: z.ZodType<StateValue> = z.lazy(() =>\n  z.union([z.string(), z.record(z.string(), StateValueSchema)])\n);\n\nexport const xstateState = z.object({\n  value: StateValueSchema,\n  /** Merged over the machine's initial context, then decoded with the context schema. */\n  context: z.record(z.string(), JsonSchema).optional(),\n});\n\ntype MachineState = z.output<typeof xstateState>;\n\ninterface Machine<Context, Snapshot> {\n  config: { context?: unknown; };\n  resolveState(config: { value: StateValue; context: Context; }): Snapshot;\n}\n\n/**\n * Resolves `state.xstate` into a snapshot. Start your actor from it:\n * `createActor(machine, { snapshot: adapter.snapshot })`.\n */\nexport function xstateAdapter<Context, Snapshot>(\n  machine: Machine<Context, Snapshot>,\n  { key = 'xstate', context: contextSchema }: { key?: string; context: z.ZodType<Context>; },\n) {\n  const adapter: TypedAdapter<MachineState> & { snapshot?: Snapshot; } = {\n    key,\n    schema: xstateState,\n    // The actor starts from the snapshot once, so a new one needs a reload.\n    inPlace: false,\n    apply({ value, context }) {\n      // Context factories can't be merged into; only a plain JSON context is.\n      const initial = JsonSchema.safeParse(machine.config.context ?? {});\n      const merged = deepMerge(initial.success ? initial.data : {}, context ?? {});\n      adapter.snapshot = machine.resolveState({ value, context: contextSchema.parse(merged) });\n    },\n  };\n\n  return adapter;\n}\n"],"mappings":";;;;;;;;AAAA,SAAS,SAAS;AAQlB,IAAM,mBAA0C,EAAE;AAAA,EAAK,MACrD,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC;AAC9D;AAEO,IAAM,cAAc,EAAE,OAAO;AAAA,EAClC,OAAO;AAAA;AAAA,EAEP,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,EAAE,SAAS;AACrD,CAAC;AAaM,SAAS,cACd,SACA,EAAE,MAAM,UAAU,SAAS,cAAc,GACzC;AACA,QAAM,UAAiE;AAAA,IACrE;AAAA,IACA,QAAQ;AAAA;AAAA,IAER,SAAS;AAAA,IACT,MAAM,EAAE,OAAO,QAAQ,GAAG;AAExB,YAAM,UAAU,WAAW,UAAU,QAAQ,OAAO,WAAW,CAAC,CAAC;AACjE,YAAM,SAAS,UAAU,QAAQ,UAAU,QAAQ,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC;AAC3E,cAAQ,WAAW,QAAQ,aAAa,EAAE,OAAO,SAAS,cAAc,MAAM,MAAM,EAAE,CAAC;AAAA,IACzF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/adapters/zustand.d.ts

@@ -0,0 +1,17 @@
+import type { z } from 'zod';
+import type { TypedAdapter } from '../runtime.js';
+import { type Serializable } from '../schema.js';
+interface Store<T> {
+    setState(partial: Partial<T>): void;
+    getState(): T;
+    subscribe(listener: () => void): () => void;
+}
+/**
+ * Connects a Zustand store as `state.zustand` (or your key). The schema decodes scenario
+ * JSON into the slice of state to merge, e.g. `StoreSchema.partial()`.
+ */
+export declare const zustandAdapter: <T extends Serializable>(store: Store<T>, { key, schema }: {
+    key?: string;
+    schema: z.ZodType<Partial<T>>;
+}) => TypedAdapter<Partial<T>>;
+export {};

package/dist/adapters/zustand.js

@@ -0,0 +1,16 @@
+import {
+  parseJson
+} from "../chunk-BK4EEQXV.js";
+
+// src/adapters/zustand.ts
+var zustandAdapter = (store, { key = "zustand", schema }) => ({
+  key,
+  schema,
+  apply: (state) => store.setState(state),
+  read: () => parseJson(JSON.stringify(store.getState())),
+  subscribe: (onChange) => store.subscribe(onChange)
+});
+export {
+  zustandAdapter
+};
+//# sourceMappingURL=zustand.js.map

package/dist/adapters/zustand.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/zustand.ts"],"sourcesContent":["import type { z } from 'zod';\nimport type { TypedAdapter } from '../runtime.js';\nimport { parseJson, type Serializable } from '../schema.js';\n\ninterface Store<T> {\n  setState(partial: Partial<T>): void;\n  getState(): T;\n  subscribe(listener: () => void): () => void;\n}\n\n/**\n * Connects a Zustand store as `state.zustand` (or your key). The schema decodes scenario\n * JSON into the slice of state to merge, e.g. `StoreSchema.partial()`.\n */\nexport const zustandAdapter = <T extends Serializable>(\n  store: Store<T>,\n  { key = 'zustand', schema }: { key?: string; schema: z.ZodType<Partial<T>>; },\n): TypedAdapter<Partial<T>> => ({\n  key,\n  schema,\n  apply: (state) => store.setState(state),\n  read: () => parseJson(JSON.stringify(store.getState())),\n  subscribe: (onChange) => store.subscribe(onChange),\n});\n"],"mappings":";;;;;AAcO,IAAM,iBAAiB,CAC5B,OACA,EAAE,MAAM,WAAW,OAAO,OACI;AAAA,EAC9B;AAAA,EACA;AAAA,EACA,OAAO,CAAC,UAAU,MAAM,SAAS,KAAK;AAAA,EACtC,MAAM,MAAM,UAAU,KAAK,UAAU,MAAM,SAAS,CAAC,CAAC;AAAA,EACtD,WAAW,CAAC,aAAa,MAAM,UAAU,QAAQ;AACnD;","names":[]}

package/dist/capture-GCESXDQD.js

@@ -0,0 +1,10 @@
+import {
+  captureScenario
+} from "./chunk-QDLRQPTA.js";
+import "./chunk-PKGBYTBX.js";
+import "./chunk-MCC3CAWQ.js";
+import "./chunk-BK4EEQXV.js";
+export {
+  captureScenario
+};
+//# sourceMappingURL=capture-GCESXDQD.js.map

package/dist/capture-GCESXDQD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/capture.d.ts

@@ -0,0 +1,26 @@
+import type { ScenarioSession } from './runtime.js';
+import { type Scenario, type ScenarioInput } from './schema.js';
+export interface CaptureOptions {
+    name: string;
+    description?: string;
+    /** Playwright selector that marks this UI state ready. */
+    ready?: string;
+    /**
+     * Catalog scenario to `extends`. Diff uses its resolved (flattened) form.
+     * Omit for a full self-contained snapshot.
+     */
+    base?: Scenario;
+    /** Relative `$schema` path stamped on the catalog file only, e.g. `../scenario.schema.json`. */
+    schemaPath?: string;
+}
+export interface CapturedScenario {
+    /** Flattened snapshot for inline share links. */
+    flat: Scenario;
+    /** File to commit: diffs against `base` when set, otherwise the flat snapshot as input. */
+    forCatalog: ScenarioInput;
+}
+/**
+ * Snapshot what the app shows now: current route and URL params, the active network
+ * fixtures (plus recorded responses), and every connected adapter's live state.
+ */
+export declare function captureScenario(session: ScenarioSession, options: CaptureOptions): CapturedScenario;

package/dist/catalog.d.ts

@@ -0,0 +1,27 @@
+import { type Json, type Scenario, type ScenarioInput } from './schema.js';
+/**
+ * A business rule a resolved scenario must satisfy, beyond schema shape.
+ * Return a message (or several) for each violation.
+ */
+export type ScenarioRule = (scenario: Scenario) => string | string[] | void | undefined;
+/** Identity helper for typing rule lists. */
+export declare const defineScenarioRules: (rules: ScenarioRule[]) => ScenarioRule[];
+export interface Catalog {
+    list: Scenario[];
+    get(name: string): Scenario | undefined;
+    /** Flatten `extends` into one self-contained scenario, then check the rules. */
+    resolve(scenario: Scenario): Scenario;
+    /** Resolve every scenario; returns one message per problem. */
+    check(): string[];
+}
+export declare function createCatalog(raw: ScenarioInput[], { rules }?: {
+    rules?: ScenarioRule[];
+}): Catalog;
+/** Objects merge recursively, `null` deletes a key, anything else replaces. */
+export declare function deepMerge(base: Json | undefined, over: Json): Json;
+/**
+ * Inverse of `extends` merge: overrides that turn a resolved `base` into `captured`.
+ * Pass the flattened base (from `catalog.resolve`). Copy-link keeps `captured` as-is;
+ * Download JSON uses this so the file can `extends` the base instead of repeating it.
+ */
+export declare function diffScenario(captured: Scenario, base?: Scenario): ScenarioInput;

package/dist/chunk-7VEOUHJP.js

@@ -0,0 +1,40 @@
+// src/network.ts
+import { delay, http, HttpResponse } from "msw";
+var verbs = {
+  GET: http.get,
+  POST: http.post,
+  PUT: http.put,
+  PATCH: http.patch,
+  DELETE: http.delete,
+  HEAD: http.head,
+  OPTIONS: http.options
+};
+var isCode = (href) => {
+  const { pathname } = new URL(href);
+  return /\.(m?[jt]sx?|css|s[ac]ss|less|html?|wasm)$/i.test(pathname) || pathname.startsWith("/@") || pathname.includes("/node_modules/");
+};
+function toHandlers(entries = []) {
+  return entries.map((entry) => {
+    const responses = entry.sequence ?? [entry.response];
+    let calls = 0;
+    return verbs[entry.method](entry.path, async ({ request }) => {
+      if (request.mode === "navigate" || isCode(request.url)) return void 0;
+      if (entry.query) {
+        const params = new URL(request.url).searchParams;
+        const matches = Object.entries(entry.query).every(([k, v]) => params.get(k) === v);
+        if (!matches) return void 0;
+      }
+      const r = responses[Math.min(calls++, responses.length - 1)];
+      if (r.delay !== void 0) await delay(r.delay);
+      const init = { status: r.status, headers: r.headers };
+      if (r.text !== void 0) return HttpResponse.text(r.text, init);
+      if (r.body === void 0) return new HttpResponse(null, init);
+      return HttpResponse.json(r.body, init);
+    });
+  });
+}
+
+export {
+  toHandlers
+};
+//# sourceMappingURL=chunk-7VEOUHJP.js.map

package/dist/chunk-7VEOUHJP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/network.ts"],"sourcesContent":["import { delay, http, HttpResponse } from 'msw';\nimport type { NetworkEntry } from './schema.js';\n\nconst verbs = {\n  GET: http.get,\n  POST: http.post,\n  PUT: http.put,\n  PATCH: http.patch,\n  DELETE: http.delete,\n  HEAD: http.head,\n  OPTIONS: http.options,\n} satisfies Record<NetworkEntry['method'], typeof http.get>;\n\n// The worker can't see a request's destination, so code is recognised by its path.\n// ponytail: a script URL with no extension (e.g. `/gtag/js`) can still be answered by a fixture;\n// refusing links off localhost (`allowLinks`) is the upgrade if that matters.\nconst isCode = (href: string) => {\n  const { pathname } = new URL(href);\n\n  return /\\.(m?[jt]sx?|css|s[ac]ss|less|html?|wasm)$/i.test(pathname)\n    || pathname.startsWith('/@') || pathname.includes('/node_modules/');\n};\n\n/** Turn scenario network entries into MSW handlers. First match wins. */\nexport function toHandlers(entries: NetworkEntry[] = []) {\n  return entries.map((entry) => {\n    const responses = entry.sequence ?? [entry.response!];\n    let calls = 0;\n\n    return verbs[entry.method](entry.path, async ({ request }): Promise<Response | undefined> => {\n      // Fixtures answer the app's requests, never a page load or code: a scenario from a shared\n      // link could otherwise serve its own HTML or scripts (a lazy chunk) on the app's origin.\n      if (request.mode === 'navigate' || isCode(request.url)) return undefined;\n\n      if (entry.query) {\n        const params = new URL(request.url).searchParams;\n        const matches = Object.entries(entry.query).every(([k, v]) => params.get(k) === v);\n\n        if (!matches) return undefined; // fall through to the next handler\n      }\n\n      const r = responses[Math.min(calls++, responses.length - 1)];\n\n      if (r.delay !== undefined) await delay(r.delay);\n      const init = { status: r.status, headers: r.headers };\n\n      if (r.text !== undefined) return HttpResponse.text(r.text, init);\n\n      if (r.body === undefined) return new HttpResponse(null, init);\n\n      return HttpResponse.json(r.body, init);\n    });\n  });\n}\n"],"mappings":";AAAA,SAAS,OAAO,MAAM,oBAAoB;AAG1C,IAAM,QAAQ;AAAA,EACZ,KAAK,KAAK;AAAA,EACV,MAAM,KAAK;AAAA,EACX,KAAK,KAAK;AAAA,EACV,OAAO,KAAK;AAAA,EACZ,QAAQ,KAAK;AAAA,EACb,MAAM,KAAK;AAAA,EACX,SAAS,KAAK;AAChB;AAKA,IAAM,SAAS,CAAC,SAAiB;AAC/B,QAAM,EAAE,SAAS,IAAI,IAAI,IAAI,IAAI;AAEjC,SAAO,8CAA8C,KAAK,QAAQ,KAC7D,SAAS,WAAW,IAAI,KAAK,SAAS,SAAS,gBAAgB;AACtE;AAGO,SAAS,WAAW,UAA0B,CAAC,GAAG;AACvD,SAAO,QAAQ,IAAI,CAAC,UAAU;AAC5B,UAAM,YAAY,MAAM,YAAY,CAAC,MAAM,QAAS;AACpD,QAAI,QAAQ;AAEZ,WAAO,MAAM,MAAM,MAAM,EAAE,MAAM,MAAM,OAAO,EAAE,QAAQ,MAAqC;AAG3F,UAAI,QAAQ,SAAS,cAAc,OAAO,QAAQ,GAAG,EAAG,QAAO;AAE/D,UAAI,MAAM,OAAO;AACf,cAAM,SAAS,IAAI,IAAI,QAAQ,GAAG,EAAE;AACpC,cAAM,UAAU,OAAO,QAAQ,MAAM,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,OAAO,IAAI,CAAC,MAAM,CAAC;AAEjF,YAAI,CAAC,QAAS,QAAO;AAAA,MACvB;AAEA,YAAM,IAAI,UAAU,KAAK,IAAI,SAAS,UAAU,SAAS,CAAC,CAAC;AAE3D,UAAI,EAAE,UAAU,OAAW,OAAM,MAAM,EAAE,KAAK;AAC9C,YAAM,OAAO,EAAE,QAAQ,EAAE,QAAQ,SAAS,EAAE,QAAQ;AAEpD,UAAI,EAAE,SAAS,OAAW,QAAO,aAAa,KAAK,EAAE,MAAM,IAAI;AAE/D,UAAI,EAAE,SAAS,OAAW,QAAO,IAAI,aAAa,MAAM,IAAI;AAE5D,aAAO,aAAa,KAAK,EAAE,MAAM,IAAI;AAAA,IACvC,CAAC;AAAA,EACH,CAAC;AACH;","names":[]}