executable-stories-showcase 0.0.0-stage → 0.1.0

package/dist/link.d.ts

@@ -0,0 +1,33 @@
+import type { Scenario } from './schema.js';
+declare global {
+    /** Requests the active scenario didn't cover, for tests and agents (see `unhandledRequests`). */
+    var executableStoriesShowcaseUnhandled: string[] | undefined;
+}
+export declare const PARAM = "scenario";
+/** Fail unmatched requests instead of letting them reach the network. */
+export declare const STRICT_PARAM = "scenario-strict";
+/** Record real responses so they can be saved as a scenario. */
+export declare const RECORD_PARAM = "scenario-record";
+/** Dev-server route the `executable-stories-showcase/vite` plugin serves for the panel's "Save to project". */
+export declare const SAVE_ENDPOINT = "/__executable-stories-showcase/save";
+export declare const LOOPBACK: Set<string>;
+/**
+ * Whether a save URL the app's save route hands the panel is a loopback save server, such as
+ * the one the Next.js route starts on 127.0.0.1. The panel posts captured state there, so a
+ * URL on any other host is refused.
+ */
+export declare const isLoopbackSaveUrl: (value: string) => boolean;
+/** Inline scenario JSON, kept in the URL hash so it never reaches a server. */
+export declare const DATA_KEY = "scenario-data";
+/**
+ * A shareable URL that opens the app in a resolved scenario.
+ * `inline` embeds the flattened scenario, so the link works without the catalog.
+ */
+export declare function scenarioHref(resolved: Scenario, { base, inline, strict, record }?: {
+    base?: string | undefined;
+    inline?: boolean | undefined;
+    strict?: boolean | undefined;
+    record?: boolean | undefined;
+}): string;
+/** Inline scenario JSON from a URL hash, if present. */
+export declare const readInline: (hash: string) => string | null;

package/dist/network-I5SB4F6T.js

@@ -0,0 +1,7 @@
+import {
+  toHandlers
+} from "./chunk-DETES767.js";
+export {
+  toHandlers
+};
+//# sourceMappingURL=network-I5SB4F6T.js.map

package/dist/network-I5SB4F6T.js.map

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

package/dist/network.d.ts

@@ -0,0 +1,3 @@
+import type { NetworkEntry } from './schema.js';
+/** Turn scenario network entries into MSW handlers. First match wins. */
+export declare function toHandlers(entries?: NetworkEntry[]): import("msw").HttpHandler[];

package/dist/next.d.ts

@@ -0,0 +1,21 @@
+export interface SaveRouteOptions {
+    /** Folder the panel's "Save to project" writes into, relative to the project root. Default "src/scenarios". */
+    dir?: string;
+}
+declare global {
+    /** One save server per folder for the life of the dev process, across route reloads. */
+    var executableStoriesShowcaseSaveServers: Map<string, Promise<string>> | undefined;
+}
+/**
+ * The route handler behind the panel's "Save to project" in Next.js (App Router). Put it at
+ * `app/%5F%5Fexecutable-stories-showcase/save/route.ts` (`%5F` is an underscore; a plain `_` folder is
+ * private and never routes):
+ *
+ *     export const { GET } = createSaveRoute({ dir: 'scenarios' });
+ *
+ * `next dev` listens on the network, so this route only tells the panel where to save: a
+ * server on 127.0.0.1 that other machines can't reach. Outside `next dev` it answers 404.
+ */
+export declare function createSaveRoute({ dir }?: SaveRouteOptions): {
+    GET: (request: Request) => Promise<Response>;
+};

package/dist/next.js

@@ -0,0 +1,30 @@
+import {
+  startSaveServer
+} from "./chunk-COLHEOSE.js";
+import "./chunk-ESIS3D6R.js";
+import "./chunk-BK4EEQXV.js";
+
+// src/next.ts
+import { relative, resolve } from "path";
+function createSaveRoute({ dir = "src/scenarios" } = {}) {
+  const GET = async (request) => {
+    if (process.env.NODE_ENV !== "development") return new Response(null, { status: 404 });
+    const root = process.cwd();
+    const target = resolve(root, dir);
+    const port = process.env.PORT ?? new URL(request.url).port;
+    const origins = ["localhost", "127.0.0.1", "[::1]"].map((host) => `http://${host}:${port}`);
+    const servers = globalThis.executableStoriesShowcaseSaveServers ??= /* @__PURE__ */ new Map();
+    let url = servers.get(target);
+    if (!url) {
+      url = startSaveServer({ dir: target, root, origins });
+      servers.set(target, url);
+      url.catch(() => servers.delete(target));
+    }
+    return Response.json({ dir: relative(root, target).replaceAll("\\", "/"), url: await url });
+  };
+  return { GET };
+}
+export {
+  createSaveRoute
+};
+//# sourceMappingURL=next.js.map

package/dist/next.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/next.ts"],"sourcesContent":["import { relative, resolve } from 'node:path';\nimport { startSaveServer } from './save.js';\n\nexport interface SaveRouteOptions {\n  /** Folder the panel's \"Save to project\" writes into, relative to the project root. Default \"src/scenarios\". */\n  dir?: string;\n}\n\ndeclare global {\n  /** One save server per folder for the life of the dev process, across route reloads. */\n  var executableStoriesShowcaseSaveServers: Map<string, Promise<string>> | undefined;\n}\n\n/**\n * The route handler behind the panel's \"Save to project\" in Next.js (App Router). Put it at\n * `app/%5F%5Fexecutable-stories-showcase/save/route.ts` (`%5F` is an underscore; a plain `_` folder is\n * private and never routes):\n *\n *     export const { GET } = createSaveRoute({ dir: 'scenarios' });\n *\n * `next dev` listens on the network, so this route only tells the panel where to save: a\n * server on 127.0.0.1 that other machines can't reach. Outside `next dev` it answers 404.\n */\nexport function createSaveRoute({ dir = 'src/scenarios' }: SaveRouteOptions = {}) {\n  const GET = async (request: Request): Promise<Response> => {\n    if (process.env.NODE_ENV !== 'development') return new Response(null, { status: 404 });\n\n    const root = process.cwd();\n    const target = resolve(root, dir);\n    const port = process.env.PORT ?? new URL(request.url).port;\n    const origins = ['localhost', '127.0.0.1', '[::1]'].map((host) => `http://${host}:${port}`);\n\n    const servers = (globalThis.executableStoriesShowcaseSaveServers ??= new Map());\n    let url = servers.get(target);\n\n    if (!url) {\n      url = startSaveServer({ dir: target, root, origins });\n      servers.set(target, url);\n      // A failed start (port exhaustion, say) retries on the next request.\n      url.catch(() => servers.delete(target));\n    }\n\n    return Response.json({ dir: relative(root, target).replaceAll('\\\\', '/'), url: await url });\n  };\n\n  return { GET };\n}\n"],"mappings":";;;;;;;AAAA,SAAS,UAAU,eAAe;AAuB3B,SAAS,gBAAgB,EAAE,MAAM,gBAAgB,IAAsB,CAAC,GAAG;AAChF,QAAM,MAAM,OAAO,YAAwC;AACzD,QAAI,QAAQ,IAAI,aAAa,cAAe,QAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;AAErF,UAAM,OAAO,QAAQ,IAAI;AACzB,UAAM,SAAS,QAAQ,MAAM,GAAG;AAChC,UAAM,OAAO,QAAQ,IAAI,QAAQ,IAAI,IAAI,QAAQ,GAAG,EAAE;AACtD,UAAM,UAAU,CAAC,aAAa,aAAa,OAAO,EAAE,IAAI,CAAC,SAAS,UAAU,IAAI,IAAI,IAAI,EAAE;AAE1F,UAAM,UAAW,WAAW,yCAAyC,oBAAI,IAAI;AAC7E,QAAI,MAAM,QAAQ,IAAI,MAAM;AAE5B,QAAI,CAAC,KAAK;AACR,YAAM,gBAAgB,EAAE,KAAK,QAAQ,MAAM,QAAQ,CAAC;AACpD,cAAQ,IAAI,QAAQ,GAAG;AAEvB,UAAI,MAAM,MAAM,QAAQ,OAAO,MAAM,CAAC;AAAA,IACxC;AAEA,WAAO,SAAS,KAAK,EAAE,KAAK,SAAS,MAAM,MAAM,EAAE,WAAW,MAAM,GAAG,GAAG,KAAK,MAAM,IAAI,CAAC;AAAA,EAC5F;AAEA,SAAO,EAAE,IAAI;AACf;","names":[]}

package/dist/no-msw-browser.d.ts

@@ -0,0 +1,2 @@
+import type { setupWorker as SetupWorker } from 'msw/browser';
+export declare const setupWorker: typeof SetupWorker;

package/dist/no-msw-browser.js

@@ -0,0 +1,8 @@
+// src/no-msw-browser.ts
+var setupWorker = () => {
+  throw new Error("executable-stories-showcase: the MSW worker only runs in a browser");
+};
+export {
+  setupWorker
+};
+//# sourceMappingURL=no-msw-browser.js.map

package/dist/no-msw-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/no-msw-browser.ts"],"sourcesContent":["import type { setupWorker as SetupWorker } from 'msw/browser';\n\n// What `#msw-browser` resolves to on the server: msw/browser has no Node build, and SSR\n// bundlers (Next.js) compile client components for the server too. The worker only starts in a browser.\nexport const setupWorker: typeof SetupWorker = () => {\n  throw new Error('executable-stories-showcase: the MSW worker only runs in a browser');\n};\n"],"mappings":";AAIO,IAAM,cAAkC,MAAM;AACnD,QAAM,IAAI,MAAM,oEAAoE;AACtF;","names":[]}

package/dist/panel.d.ts

@@ -0,0 +1,30 @@
+import type { ScenarioSession } from './runtime.js';
+export interface PanelOptions {
+    /** Corner to dock in, e.g. to avoid a chat widget. Default "bottom-right". */
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    /** Default: the maximum, so the panel stays above app overlays. */
+    zIndex?: number;
+    /** "auto" follows the OS colour scheme. Default "auto". */
+    theme?: 'auto' | 'light' | 'dark';
+    /**
+     * Relative `$schema` path stamped on Download JSON, e.g. `../scenario.schema.json`.
+     * Copy link stays schema-free.
+     */
+    schemaPath?: string;
+}
+/**
+ * Add the floating scenario panel to the page. Framework-agnostic.
+ * Remove it with `panel.remove()`; it unsubscribes from the session.
+ */
+export declare function mountPanel(session: ScenarioSession, options?: PanelOptions): ScenarioPanel;
+declare const Base: typeof HTMLElement;
+declare class ScenarioPanel extends Base {
+    session: ScenarioSession;
+    schemaPath?: string;
+    private render?;
+    private unsubscribe?;
+    private stopPick?;
+    disconnectedCallback(): void;
+    connectedCallback(): void;
+}
+export {};