@kernocal/viteshot 0.1.1

package/dist/index.d.mts

@@ -0,0 +1,112 @@
+import { CreatePageOptions, LaunchOptions, ScreenshotOptions } from "puppeteer-core";
+import { InlineConfig as InlineConfig$1, UserConfig as UserConfig$1, ViteDevServer } from "vite";
+
+//#region src/core/capture-extension-screenshots.d.ts
+type CapturedImages = {
+  popup?: Buffer;
+  sidebar?: Buffer;
+  options?: Buffer;
+};
+/** locale language string → captured images (e.g. "es" → { sidebar: Buffer, ... }) */
+type CaptureResult = Map<string, CapturedImages>;
+type CaptureOptions = {
+  extensionPath: string;
+  chromePath?: string;
+  localesDir?: string;
+  waitSelector?: string;
+  settleDelay?: number;
+};
+/**
+ * Capture popup/sidebar/options screenshots for a single locale.
+ * Pass `language: "_default"` (or omit) to capture without `--lang`.
+ */
+declare function captureLocale(options: {
+  extensionPath: string;
+  chromePath?: string;
+  language?: string;
+  waitSelector?: string;
+  settleDelay?: number;
+}): Promise<CapturedImages>;
+/**
+ * Capture popup/sidebar/options screenshots for all locales (batch).
+ * Used by the `export` command.
+ */
+declare function captureExtensionScreenshots(options: CaptureOptions): Promise<CaptureResult>;
+//#endregion
+//#region src/core/config.d.ts
+type PuppeteerOptions = {
+  launchOptions?: LaunchOptions;
+  newPageOptions?: CreatePageOptions;
+  screenshotOptions?: Omit<ScreenshotOptions, "clip" | "path">;
+};
+type UserConfig = UserConfig$1 & {
+  screenshots?: {
+    /** @default "locales" */localesDir?: string; /** @default "designs" */
+    designsDir?: string; /** @default "screenshots" */
+    exportsDir?: string;
+    /**
+     * How many screenshots can be exported concurrently.
+     *
+     * @default 4
+     */
+    renderConcurrency?: number; /** Override the options passed into puppeteer. */
+    puppeteer?: PuppeteerOptions;
+    /**
+     * List of relative paths from your viteshot.config.ts file to CSS files to
+     * add to your screenshot's HTML file as links.
+     */
+    css?: string[]; /** Path to the unpacked extension directory for popup screenshots. @default ".output/chrome-mv3" */
+    extensionPath?: string; /** Path to the Chrome/Chromium executable. Falls back to VITESHOT_CHROME_PATH env var. */
+    chromePath?: string;
+  };
+};
+type InlineConfig = UserConfig & {
+  root: string;
+};
+type ResolvedConfig = {
+  root: string;
+  localesDir: string;
+  designsDir: string;
+  exportsDir: string;
+  renderConcurrency: number;
+  puppeteer: PuppeteerOptions | undefined;
+  css: string[];
+  extensionPath: string;
+  chromePath: string;
+  captures?: CaptureResult;
+  vite: InlineConfig$1;
+};
+declare function defineConfig(config: UserConfig): UserConfig;
+declare function resolveConfig(dir?: string): Promise<ResolvedConfig>;
+//#endregion
+//#region src/core/create-server.d.ts
+declare function createServer(dir?: string): Promise<ViteDevServer>;
+//#endregion
+//#region src/core/export-screenshots.d.ts
+declare function exportScreenshots(config: ResolvedConfig): Promise<void>;
+//#endregion
+//#region src/core/export-popup-screenshot.d.ts
+type PopupScreenshotOptions = {
+  extensionPath: string;
+  chromePath?: string;
+  outputDir?: string;
+  localesDir?: string;
+  waitSelector?: string;
+  settleDelay?: number;
+};
+declare function exportPopupScreenshot(options: PopupScreenshotOptions): Promise<void>;
+//#endregion
+//#region src/core/get-screenshots.d.ts
+type Screenshot = {
+  id: string;
+  path: string;
+  ext: string;
+  name: string;
+  size: string;
+  width: number;
+  height: number;
+};
+declare function getScreenshots(designsDir: string): Promise<Screenshot[]>;
+declare function logInvalidDesignFiles(designsDir: string): Promise<void>;
+//#endregion
+export { CaptureOptions, CaptureResult, CapturedImages, InlineConfig, PopupScreenshotOptions, PuppeteerOptions, ResolvedConfig, Screenshot, UserConfig, captureExtensionScreenshots, captureLocale, createServer, defineConfig, exportPopupScreenshot, exportScreenshots, getScreenshots, logInvalidDesignFiles, resolveConfig };

package/dist/index.mjs

@@ -0,0 +1,7 @@
+import { n as resolveConfig, t as defineConfig } from "./config-BvHGePNd.mjs";
+import { i as logInvalidDesignFiles, n as captureLocale, r as getScreenshots, t as captureExtensionScreenshots } from "./capture-extension-screenshots-DQWqq69W.mjs";
+import { t as createServer } from "./create-server-CpPbF7ms.mjs";
+import { t as exportScreenshots } from "./export-screenshots-B6IGCV4J.mjs";
+import { t as exportPopupScreenshot } from "./export-popup-screenshot-UhxUtKCP.mjs";
+
+export { captureExtensionScreenshots, captureLocale, createServer, defineConfig, exportPopupScreenshot, exportScreenshots, getScreenshots, logInvalidDesignFiles, resolveConfig };

package/dist/init-BUrgR61N.mjs

@@ -0,0 +1,63 @@
+import { basename, dirname, join, relative, resolve } from "node:path";
+import { access, mkdir, writeFile } from "node:fs/promises";
+import { styleText } from "node:util";
+
+//#region src/core/init.ts
+async function init(_dir) {
+	const absDir = resolve(_dir);
+	const relativeDir = relative(process.cwd(), absDir);
+	const dirBasename = basename(_dir);
+	for (const [file, contents] of Object.entries(FILES)) {
+		const path = join(absDir, file);
+		if (await access(path).then(() => true, () => false)) {
+			process.stdout.write(`File ${file} already exists. Overwrite? (y/n) `);
+			if ((await waitForInput()).toLowerCase() !== "y") continue;
+		}
+		await mkdir(dirname(path), { recursive: true });
+		await writeFile(path, contents);
+	}
+	console.log(`\n${styleText(["bold", "cyan"], "ViteShot")} project initialized:\n`);
+	for (const file of Object.keys(FILES)) console.log(`  ${styleText("dim", `./${relativeDir}/`)}${styleText(["bold", "blue"], file)}`);
+	console.log("\nAdd the following scripts to your package.json:\n");
+	console.log(`  "${dirBasename}:dev": "viteshot dev ${relativeDir}",`);
+	console.log(`  "${dirBasename}:export": "viteshot export ${relativeDir}"\n`);
+}
+async function waitForInput() {
+	return new Promise((resolve) => {
+		process.stdin.once("data", (data) => {
+			resolve(data.toString().trim());
+		});
+	});
+}
+const FILES = {
+	"viteshot.config.ts": `import { defineConfig } from 'viteshot';
+
+export default defineConfig({
+  screenshots: {
+    // Add CSS to the <head> of your design's HTML document
+    css: ["assets/style.css"],
+
+    // Other ViteShot config here
+  },
+
+  // Regular Vite config here
+})
+`,
+	"assets/style.css": `/* Global styles here */
+body {
+  background: #181818;
+  color: white;
+}`,
+	"designs/screenshot-1@600x480.html": `<style>
+  /* Inline styles per-design here */
+</style>
+
+<div>
+  <p>Screenshot design here</p>
+  <p>{{translated}}</p>
+</div>
+`
+};
+
+//#endregion
+export { init };

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@kernocal/viteshot",
+  "description": "fork adding weird popup sidebar options screenshots. original by @aklinker1",
+  "version": "0.1.1",
+  "type": "module",
+  "dependencies": {
+    "async-mutex": "^0.5.0",
+    "natural-compare-lite": "^1.4.0",
+    "p-map": "^7.0.4",
+    "p-queue": "^9.1.0",
+    "puppeteer-core": "^24.37.5"
+  },
+  "peerDependencies": {
+    "svelte": ">=5",
+    "vite": ">=5"
+  },
+  "peerDependenciesMeta": {
+    "svelte": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@aklinker1/check": "^2.4.0",
+    "@sveltejs/vite-plugin-svelte": "^7.0.0",
+    "@tailwindcss/vite": "^4.2.2",
+    "@types/natural-compare-lite": "^1.4.2",
+    "@typescript/native-preview": "^7.0.0-dev.20260223.1",
+    "oxlint": "^1.50.0",
+    "prettier": "^3.8.1",
+    "prettier-plugin-jsdoc": "^1.8.0",
+    "publint": "^0.3.17",
+    "puppeteer": "^24.37.5",
+    "tailwindcss": "^4.2.2",
+    "tsdown": "^0.20.3",
+    "typescript": "^5"
+  },
+  "types": "dist/index.d.mts",
+  "module": "dist/index.mjs",
+  "bin": {
+    "viteshot": "dist/cli.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "url": "https://github.com/Kernocal/viteshot"
+  },
+  "files": [
+    "dist",
+    "assets"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown"
+  }
+}