@kernocal/viteshot 0.1.1 → 0.1.2

package/dist/cli.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { resolve } from "node:path";
 import { styleText } from "node:util";
 
 //#region src/cli.ts
@@ -11,7 +12,7 @@ function getFlag(name) {
 }
 switch (command) {
 	case "dev": {
-		const { DEV_HELP_MESSAGE } = await import("./help-messages-B_-FA6OE.mjs");
+		const { DEV_HELP_MESSAGE } = await import("./help-messages-D98KkJBb.mjs");
 		if (showHelp) {
 			console.log(DEV_HELP_MESSAGE);
 			process.exit(0);
@@ -23,7 +24,7 @@ switch (command) {
 		break;
 	}
 	case "export": {
-		const { EXPORT_HELP_MESSAGE } = await import("./help-messages-B_-FA6OE.mjs");
+		const { EXPORT_HELP_MESSAGE } = await import("./help-messages-D98KkJBb.mjs");
 		if (showHelp) {
 			console.log(EXPORT_HELP_MESSAGE);
 			process.exit(0);
@@ -37,7 +38,7 @@ switch (command) {
 		process.exit(0);
 	}
 	case "popup": {
-		const { POPUP_HELP_MESSAGE } = await import("./help-messages-B_-FA6OE.mjs");
+		const { POPUP_HELP_MESSAGE } = await import("./help-messages-D98KkJBb.mjs");
 		if (showHelp) {
 			console.log(POPUP_HELP_MESSAGE);
 			process.exit(0);
@@ -52,18 +53,32 @@ switch (command) {
 		});
 		process.exit(0);
 	}
+	case "suggest": {
+		const { SUGGEST_HELP_MESSAGE } = await import("./help-messages-D98KkJBb.mjs");
+		if (showHelp) {
+			console.log(SUGGEST_HELP_MESSAGE);
+			process.exit(0);
+		}
+		const dir = args[0] ?? DEFAULT_DIR;
+		const { suggest } = await import("./suggest-D4mx8DKj.mjs");
+		await suggest({
+			dataSrc: resolve(dir, "data"),
+			exportsDir: resolve(dir, "exports")
+		});
+		process.exit(0);
+	}
 	case "init": {
-		const { INIT_HELP_MESSAGE } = await import("./help-messages-B_-FA6OE.mjs");
+		const { INIT_HELP_MESSAGE } = await import("./help-messages-D98KkJBb.mjs");
 		if (showHelp) {
 			console.log(INIT_HELP_MESSAGE);
 			process.exit(0);
 		}
-		const { init } = await import("./init-BUrgR61N.mjs");
+		const { init } = await import("./init-EKAK797h.mjs");
 		await init(args[0] ?? DEFAULT_DIR);
 		process.exit(0);
 	}
 	default: {
-		const { GENERAL_HELP_MESSAGE } = await import("./help-messages-B_-FA6OE.mjs");
+		const { GENERAL_HELP_MESSAGE } = await import("./help-messages-D98KkJBb.mjs");
 		if (showHelp) {
 			console.log(GENERAL_HELP_MESSAGE);
 			process.exit(0);

package/dist/{help-messages-B_-FA6OE.mjs → help-messages-D98KkJBb.mjs}

@@ -1,7 +1,7 @@
 import { styleText } from "node:util";
 
 //#region package.json
-var version = "0.1.1";
+var version = "0.1.2";
 
 //#endregion
 //#region src/core/help-messages.ts
@@ -15,6 +15,7 @@ ${styleText("bold", "Commands")}
   ${styleText(["bold", "magenta"], "export")}    ${styleText("dim", "store")}            Export screenshots
   ${styleText(["bold", "magenta"], "init")}      ${styleText("dim", "store")}            Initialize viteshot in your project
   ${styleText(["bold", "magenta"], "popup")}     ${styleText("dim", "--extension-path")}   Screenshot a browser extension popup
+  ${styleText(["bold", "magenta"], "suggest")}   ${styleText("dim", "store")}            Generate store listing suggestions via AI
 
   ${styleText("dim", "<command>")} ${styleText(["bold", "blue"], "--help")}           Print help text for a command
 `;
@@ -56,6 +57,21 @@ ${styleText("bold", "Examples:")}
   ${styleText(["bold", "green"], "viteshot popup")} --extension-path=.output/chrome-mv3
   ${styleText(["bold", "green"], "viteshot popup")} --extension-path=.output/chrome-mv3 --output=screenshots
 `;
+const SUGGEST_HELP_MESSAGE = `${styleText("bold", "Usage:")} ${styleText(["bold", "green"], "viteshot suggest")} ${styleText("bold", "[<folder>]")}
+  Generate AI suggestions for store listing fields (permission justifications, single purpose, search terms).
+
+${styleText("bold", "Args:")}
+
+  ${FOLDER_ARG}
+
+${styleText("bold", "Environment:")}
+
+  ${styleText(["bold", "blue"], "GEMINI_API_KEY")}    Google AI API key ${styleText("red", "(required)")}
+
+${styleText("bold", "Examples:")}
+  ${styleText(["bold", "green"], "viteshot suggest")}
+  ${styleText(["bold", "green"], "viteshot suggest")} store
+`;
 const INIT_HELP_MESSAGE = `
 ${styleText("bold", "Usage:")} ${styleText(["bold", "green"], "viteshot init")} ${styleText("bold", "[<folder>]")}
   Initialize viteshot in your project.
@@ -70,4 +86,4 @@ ${styleText("bold", "Examples:")}
 `;
 
 //#endregion
-export { DEV_HELP_MESSAGE, EXPORT_HELP_MESSAGE, GENERAL_HELP_MESSAGE, INIT_HELP_MESSAGE, POPUP_HELP_MESSAGE };
+export { DEV_HELP_MESSAGE, EXPORT_HELP_MESSAGE, GENERAL_HELP_MESSAGE, INIT_HELP_MESSAGE, POPUP_HELP_MESSAGE, SUGGEST_HELP_MESSAGE };

package/dist/index.d.mts

@@ -109,4 +109,13 @@ type Screenshot = {
 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 };
+//#region src/core/suggest.d.ts
+interface SuggestOptions {
+  /** Path to the store data module (resolved by jiti). @default "store/data" */
+  dataSrc?: string;
+  /** Directory to write suggested-data.json. @default "store/exports" */
+  exportsDir?: string;
+}
+declare function suggest(options?: SuggestOptions): Promise<void>;
+//#endregion
+export { CaptureOptions, CaptureResult, CapturedImages, InlineConfig, PopupScreenshotOptions, PuppeteerOptions, ResolvedConfig, Screenshot, SuggestOptions, UserConfig, captureExtensionScreenshots, captureLocale, createServer, defineConfig, exportPopupScreenshot, exportScreenshots, getScreenshots, logInvalidDesignFiles, resolveConfig, suggest };

package/dist/index.mjs

@@ -3,5 +3,6 @@ import { i as logInvalidDesignFiles, n as captureLocale, r as getScreenshots, t
 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";
+import { t as suggest } from "./suggest-C2hZd_gx.mjs";
 
-export { captureExtensionScreenshots, captureLocale, createServer, defineConfig, exportPopupScreenshot, exportScreenshots, getScreenshots, logInvalidDesignFiles, resolveConfig };
+export { captureExtensionScreenshots, captureLocale, createServer, defineConfig, exportPopupScreenshot, exportScreenshots, getScreenshots, logInvalidDesignFiles, resolveConfig, suggest };

package/dist/{init-BUrgR61N.mjs → init-EKAK797h.mjs}

@@ -56,6 +56,39 @@ body {
   <p>Screenshot design here</p>
   <p>{{translated}}</p>
 </div>
+`,
+	"data.ts": `import type { StoreDetails } from '@kernocal/validate-store'
+
+export const storeData = {
+  common: {
+    privacyPolicyUrl: '',
+    screenshots: [{ path: 'exports/screenshot-1.png', width: 1280, height: 800 }],
+    smallPromoTile: { path: 'exports/small-promo.png', width: 440, height: 280 },
+    largePromoTile: null,
+    promoVideoUrl: null,
+    websiteUrl: '',
+    matureContent: false,
+    locales: {
+      en: { description: '' },
+    },
+  },
+  chrome: {
+    category: 'Tools',
+    icon: { path: 'exports/icon-128.png', width: 128, height: 128 },
+    officialUrl: null,
+    supportUrl: '',
+    singlePurpose: '',
+    permissionJustifications: {},
+    remoteCode: false,
+  },
+  edge: {
+    category: 'Productivity',
+    icon: { path: 'exports/icon-300.png', width: 300, height: 300 },
+    searchTerms: [],
+    supportContact: '',
+    collectsPersonalData: false,
+  },
+} satisfies StoreDetails
 `
 };
 

package/dist/suggest-C2hZd_gx.mjs

@@ -0,0 +1,105 @@
+import { resolve } from "node:path";
+import { mkdir, writeFile } from "node:fs/promises";
+import { createJiti } from "jiti";
+
+//#region src/core/suggest.ts
+async function generatePermissionJustifications(ai, model, permissions, description) {
+	const response = await ai.models.generateContent({
+		model,
+		contents: `You are writing Chrome Web Store permission justifications for a browser extension.
+
+Extension description: ${description}
+Permissions requested: ${permissions.join(", ")}
+
+For each permission, write a clear, concise justification (1 sentence) explaining
+why the extension needs this permission. Chrome reviewers will read these.
+
+Rules:
+- Be specific about what the permission is used for
+- Reference the extension's actual functionality
+- Keep each justification under 200 characters
+- Do not use marketing language
+- Do not start the justification with "to ".
+- Do not start with The x permission or the permission x.
+- Do not end the justification with a period.
+- Do not start the justification with captilisation, first word can be lowercase.
+
+Respond as JSON: { "permissionName": "justification text" }`,
+		config: {
+			responseMimeType: "application/json",
+			responseSchema: {
+				type: "object",
+				properties: Object.fromEntries(permissions.map((p) => [p, { type: "string" }])),
+				required: permissions
+			}
+		}
+	});
+	return JSON.parse(response.text ?? "{}");
+}
+async function generateSinglePurpose(ai, model, description) {
+	return (await ai.models.generateContent({
+		model,
+		contents: `You are writing a Chrome Web Store "single purpose" description for a browser extension.
+
+Extension description: ${description}
+
+Write a concise single-purpose statement (1 sentence) that describes what this extension does.
+Chrome requires this to be a clear, single purpose. Keep it under 132 characters.`
+	})).text ?? "";
+}
+async function generateSearchTerms(ai, model, description) {
+	const response = await ai.models.generateContent({
+		model,
+		contents: `Generate search terms for a Microsoft Edge Add-ons listing.
+
+Extension description: ${description}
+
+Rules:
+- Maximum 7 terms
+- Each term max 30 characters
+- Total max 21 words across all terms
+- Terms should be what users would search to find this extension
+- Include both specific and broad terms
+
+Respond as JSON array of strings.`,
+		config: {
+			responseMimeType: "application/json",
+			responseSchema: {
+				type: "array",
+				items: { type: "string" }
+			}
+		}
+	});
+	return JSON.parse(response.text ?? "[]");
+}
+async function suggest(options) {
+	const dataSrc = resolve(options?.dataSrc ?? "store/data");
+	const exportsDir = resolve(options?.exportsDir ?? "store/exports");
+	const { storeData } = await createJiti(import.meta.url).import(dataSrc);
+	const { GoogleGenAI } = await import("@google/genai");
+	const apiKey = process.env.GEMINI_API_KEY;
+	if (!apiKey) {
+		console.error("GEMINI_API_KEY env var is required");
+		process.exit(1);
+	}
+	const ai = new GoogleGenAI({ apiKey });
+	const model = "gemini-2.5-flash";
+	const permissions = Object.keys(storeData.chrome.permissionJustifications);
+	const { description } = storeData.common.locales.en;
+	const pause = () => new Promise((res) => setTimeout(res, 1e3));
+	const permissionJustifications = await generatePermissionJustifications(ai, model, permissions, description);
+	await pause();
+	const singlePurpose = await generateSinglePurpose(ai, model, description);
+	await pause();
+	const searchTerms = await generateSearchTerms(ai, model, description);
+	const resultJson = JSON.stringify({
+		permissionJustifications,
+		singlePurpose,
+		searchTerms
+	}, null, 4);
+	await mkdir(exportsDir, { recursive: true });
+	await writeFile(resolve(exportsDir, "suggested-data.json"), resultJson, "utf-8");
+}
+
+//#endregion
+export { suggest as t };

package/dist/suggest-D4mx8DKj.mjs

@@ -0,0 +1,3 @@
+import { t as suggest } from "./suggest-C2hZd_gx.mjs";
+
+export { suggest };

package/package.json

@@ -1,20 +1,29 @@
 {
   "name": "@kernocal/viteshot",
   "description": "fork adding weird popup sidebar options screenshots. original by @aklinker1",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "dependencies": {
     "async-mutex": "^0.5.0",
+    "jiti": "^2.4.2",
     "natural-compare-lite": "^1.4.0",
     "p-map": "^7.0.4",
     "p-queue": "^9.1.0",
     "puppeteer-core": "^24.37.5"
   },
   "peerDependencies": {
+    "@google/genai": ">=1",
+    "@kernocal/validate-store": ">=0.1.8",
     "svelte": ">=5",
     "vite": ">=5"
   },
   "peerDependenciesMeta": {
+    "@google/genai": {
+      "optional": true
+    },
+    "@kernocal/validate-store": {
+      "optional": true
+    },
     "svelte": {
       "optional": true
     }