@archastro/react-shot 0.1.0

package/dist/stubs.js

@@ -0,0 +1,49 @@
+export const nextNavigationStub = `
+export function useRouter() {
+  return {
+    push() {}, replace() {}, prefetch() {}, back() {},
+    forward() {}, refresh() {},
+  };
+}
+export function usePathname() { return "/"; }
+export function useSearchParams() { return new URLSearchParams(); }
+export function useParams() { return {}; }
+export function redirect() {}
+export function notFound() {}
+`;
+export const nextLinkStub = `
+import React from "react";
+export default function Link({ href, children, ...rest }) {
+  return React.createElement("a", { href: typeof href === "string" ? href : "#", ...rest }, children);
+}
+`;
+export const nextImageStub = `
+import React from "react";
+export default function Image({ src, alt, width, height, ...rest }) {
+  return React.createElement("img", {
+    src: typeof src === "string" ? src : "",
+    alt: alt || "",
+    width,
+    height,
+    ...rest,
+  });
+}
+`;
+export const serverOnlyStub = `export {};`;
+export const nextDynamicStub = `
+import React from "react";
+export default function dynamic(loader, options) {
+  const Lazy = React.lazy(loader);
+  const fallback = options && options.loading
+    ? React.createElement(options.loading)
+    : null;
+  return function DynamicComponent(props) {
+    return React.createElement(
+      React.Suspense,
+      { fallback },
+      React.createElement(Lazy, props),
+    );
+  };
+}
+`;
+//# sourceMappingURL=stubs.js.map

package/dist/stubs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stubs.js","sourceRoot":"","sources":["../src/stubs.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;CAYjC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;CAK3B,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;CAW5B,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;CAe9B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,79 @@
+import type { ReactNode } from "react";
+/**
+ * Default export shape for a react-shot fixture module.
+ *
+ * @example
+ * ```tsx
+ * export default {
+ *   width: 720,
+ *   height: 900,
+ *   background: "#faf9f6",
+ *   component: <MyModal />,
+ * } satisfies ReactShotFixture;
+ * ```
+ */
+export interface ReactShotFixture {
+    /** React tree to mount. */
+    component: ReactNode;
+    /** Viewport width in CSS pixels. Defaults to 1280. */
+    width?: number;
+    /** Viewport height in CSS pixels. Defaults to 800. */
+    height?: number;
+    /** Page or canvas background. Defaults to transparent. */
+    background?: string;
+    /** CSS selector to capture. Defaults to `[data-react-shot-root]`. */
+    selector?: string;
+    /** Optional selector or `text=...` value that must become visible. */
+    waitFor?: string;
+    /** Additional layout settling time in milliseconds. Defaults to 150. */
+    settleMs?: number;
+    /** Capture the full page instead of the selected element. */
+    fullPage?: boolean;
+    /**
+     * Remove a full-screen overlay around the target before capture.
+     * Defaults to true when `selector` targets a dialog.
+     */
+    stripOverlay?: boolean;
+    /**
+     * Preserve transparency in the PNG. Defaults to true for isolated dialogs.
+     */
+    omitBackground?: boolean;
+}
+/** Package-level config exported from `react-shot.config.*`. */
+export interface ReactShotConfig {
+    /** Package root used for module resolution. Relative paths are config-relative. */
+    root?: string;
+    /** Vite aliases, such as `@` to an application's source directory. */
+    alias?: Record<string, string>;
+    /** CSS files imported into every fixture host page. */
+    styles?: string[];
+    /** Path to a PostCSS config file. */
+    postcssConfig?: string;
+    /** Additional dependencies Vite should deduplicate. */
+    dedupe?: string[];
+    /** Module names that should resolve to an empty browser-safe stub. */
+    stubModules?: string[];
+}
+export interface ShotRequest {
+    fixturePath: string;
+    outPath: string;
+    root?: string;
+    configPath?: string;
+    headed?: boolean;
+    width?: number;
+    height?: number;
+}
+export interface BatchEntry {
+    fixture: string;
+    out: string;
+    root?: string;
+    config?: string;
+    width?: number;
+    height?: number;
+}
+export interface BatchManifest {
+    root?: string;
+    config?: string;
+    shots: BatchEntry[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/host/index.html

@@ -0,0 +1,22 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>react-shot</title>
+    <style>
+      html,
+      body {
+        margin: 0;
+        padding: 0;
+      }
+      #root {
+        min-height: 100vh;
+      }
+    </style>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/@react-shot/entry.tsx"></script>
+  </body>
+</html>

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@archastro/react-shot",
+  "version": "0.1.0",
+  "description": "Capture deterministic PNG screenshots from React and TSX fixtures",
+  "keywords": [
+    "react",
+    "screenshot",
+    "playwright",
+    "tsx",
+    "visual-testing"
+  ],
+  "homepage": "https://github.com/ArchAstro/astroshots#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArchAstro/astroshots.git",
+    "directory": "packages/react-shot"
+  },
+  "bugs": {
+    "url": "https://github.com/ArchAstro/astroshots/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    }
+  },
+  "bin": {
+    "react-shot": "bin/react-shot.mjs"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "host",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "test": "npm run build && vitest run",
+    "test:unit": "vitest run src/meta.test.ts",
+    "test:e2e": "npm run build && vitest run src/cli.e2e.test.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepack": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@vitejs/plugin-react": "^5.2.0",
+    "playwright": "1.61.1",
+    "tsx": "^4.19.0",
+    "vite": "^6.2.0",
+    "yaml": "^2.7.0"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.1.9"
+  }
+}