@neopress/cli 4.8.1 → 4.9.0

package/dist/bin.cjs

@@ -26407,6 +26407,7 @@ function serializeTemplate(t) {
 		referenceUrl: t.reference_url,
 		previewImgUrls: t.preview_img_urls,
 		previewVideoUrl: t.preview_video_url ?? null,
+		language: t.language ?? null,
 		createdAt: t.created_at
 	};
 }
@@ -30438,7 +30439,7 @@ var TemplatesEndpoint = class {
 		if (siteIds.length === 0) return [];
 		const namePrefix = params?.namePrefix?.trim();
 		const limit = Math.min(Math.max(params?.limit ?? 100, 1), 500);
-		let query = this.client.db.from("templates").select("id, name, reference_url, preview_img_urls, description, created_at").in("id", siteIds);
+		let query = this.client.db.from("templates").select("id, name, reference_url, preview_img_urls, description, language, created_at").in("id", siteIds);
 		if (namePrefix) query = query.ilike("name", `${namePrefix}%`);
 		if (params?.order) query = query.order("created_at", { ascending: params.order === "asc" });
 		query = query.limit(limit);
@@ -30454,6 +30455,7 @@ var TemplatesEndpoint = class {
 				referenceUrl: t.reference_url,
 				previewImgUrls: t.preview_img_urls ?? null,
 				description: t.description ?? null,
+				language: t.language ?? null,
 				createdAt: t.created_at
 			};
 		});
@@ -31019,7 +31021,7 @@ Draft content fields (--tsx/--i18n/--draft-meta) need \`neopress publish\` to go
 	pages.command("get <pageId>").description("Get page details").action(async (pageId) => {
 		output(await (await getClientAsync()).pages.get(parseInt(pageId, 10)));
 	});
-	pages.command("create").description("Create a new page").requiredOption("--path <path>", "Page path (e.g., /about)").option("--title <title>", "Page title").option("--tsx <file>", "TSX file path").option("--i18n <json>", "Page i18n JSON string or @file path").option("--public-locales <locales>", "Comma-separated locale list or JSON string array").option("--metadata <json>", "Page metadata JSON string or @file path").option("--draft-meta <json>", "Draft runtime metadata JSON string or @file path").option("--query-config <json>", "Query config JSON string or @file path; stored as draftMeta.queryConfig").option("--collection <id>", "Collection ID for dynamic pages").option("--type <type>", "Page type (static/dynamic)", "static").addHelpText("after", `
+	pages.command("create").description("Create a new page").requiredOption("--path <path>", "Page path (e.g., /about)").option("--title <title>", "Page title").option("--tsx <file>", "TSX file path").option("--i18n <json>", "Page i18n JSON string or @file path").option("--public-locales <locales>", "Comma-separated locale list or JSON string array").option("--metadata <json>", "Page metadata JSON string or @file path").option("--draft-meta <json>", "Draft runtime metadata JSON string or @file path").option("--query-config <json>", "Query config JSON string or @file path (including collectionWindow bindings); stored as draftMeta.queryConfig").option("--collection <id>", "Collection ID for dynamic pages").option("--type <type>", "Page type (static/dynamic)", "static").addHelpText("after", `
 Examples:
   $ neopress pages create --path /about --title About --tsx ./about.tsx
   $ neopress pages create --path /blog --type dynamic --collection 12 --tsx ./blog.tsx
@@ -31052,7 +31054,7 @@ Examples:
   $ neopress pages update 12 --title About --path /about-us
   $ neopress pages update 12 --collection 12 --query-config @query.json
 
-Pass at least one field flag. --tsx reads the component from a file; JSON options take inline JSON or @file. Draft content (--tsx/--i18n/--draft-meta/--query-config) needs \`neopress publish\` to go live; --title/--path/--collection apply immediately.`).option("--path <path>", "New page path").option("--title <title>", "New title").option("--tsx <file>", "TSX file path").option("--i18n <json>", "Page i18n JSON string or @file path").option("--public-locales <locales>", "Comma-separated locale list or JSON string array").option("--metadata <json>", "Page metadata JSON string or @file path").option("--draft-meta <json>", "Draft runtime metadata JSON string or @file path").option("--query-config <json>", "Query config JSON string or @file path; stored as draftMeta.queryConfig").option("--collection <id>", "Collection ID for dynamic pages").action(async (pageId, options) => {
+Pass at least one field flag. --tsx reads the component from a file; JSON options take inline JSON or @file. Draft content (--tsx/--i18n/--draft-meta/--query-config) needs \`neopress publish\` to go live; --title/--path/--collection apply immediately.`).option("--path <path>", "New page path").option("--title <title>", "New title").option("--tsx <file>", "TSX file path").option("--i18n <json>", "Page i18n JSON string or @file path").option("--public-locales <locales>", "Comma-separated locale list or JSON string array").option("--metadata <json>", "Page metadata JSON string or @file path").option("--draft-meta <json>", "Draft runtime metadata JSON string or @file path").option("--query-config <json>", "Query config JSON string or @file path (including collectionWindow bindings); stored as draftMeta.queryConfig").option("--collection <id>", "Collection ID for dynamic pages").action(async (pageId, options) => {
 		const client = await getClientAsync();
 		const data = {};
 		if (options.path) data.path = options.path;
@@ -31527,13 +31529,21 @@ Examples:
 }
 //#endregion
 //#region src/commands/templates.ts
+/**
+* Template commands
+*/
 function collectPreviewImgUrl(value, previous = []) {
 	return previous.concat(value);
 }
+function parseLanguage(value) {
+	const language = value.trim().toLowerCase();
+	if (!/^[a-z]{2}$/.test(language)) throw new InvalidArgumentError("must be a two-letter ISO 639-1 language code (e.g. ko, en, es)");
+	return language;
+}
 function registerTemplateCommands(program) {
 	const templates = program.command("templates").description("Manage template metadata for the active site").addHelpText("after", `
 Examples:
-  $ neopress templates mark --name "SaaS Landing" --reference-url https://example.com --preview-img-url https://cdn.example.com/1.png
+  $ neopress templates mark --name "SaaS Landing" --reference-url https://example.com --language en --preview-img-url https://cdn.example.com/1.png
   $ neopress templates list --limit 50
   $ neopress templates delete
 \`templates mark\` operates on the active site. \`templates delete\` permanently removes the template metadata AND the connected site — it is destructive and not recoverable.`);
@@ -31549,14 +31559,15 @@ Examples:
 	});
 	templates.command("mark").description("Mark or update the active site as a template").addHelpText("after", `
 Examples:
-  $ neopress templates mark --name "SaaS Landing" --reference-url https://example.com --preview-img-url https://cdn.example.com/1.png
-  $ neopress templates mark --name Portfolio --reference-url https://example.com --preview-img-url https://cdn.example.com/a.png --preview-img-url https://cdn.example.com/b.png --description "Minimal portfolio"
-  $ neopress templates mark --name "SaaS Landing" --reference-url https://example.com --preview-img-url https://cdn.example.com/poster.webp --preview-video-url https://cdn.example.com/preview.webm
---name and --reference-url are required, and at least one --preview-img-url must be given (repeat the flag for multiple images). --preview-video-url is the gallery hover video; pair it with the poster (its first frame) as the first --preview-img-url. Upserts the template metadata for the active site and sets the site status to active; running it again updates the existing template.`).requiredOption("--name <name>", "Template display name").option("--description <description>", "Template description, up to 150 characters").requiredOption("--reference-url <url>", "Reference URL for template provenance").option("--preview-img-url <url>", "Preview image URL (required — at least one). Repeat for multiple images.", collectPreviewImgUrl, []).option("--preview-video-url <url>", "Preview video URL played on gallery hover. The first --preview-img-url should be this video's first frame.").action(async (options) => {
+  $ neopress templates mark --name "SaaS Landing" --reference-url https://example.com --language en --preview-img-url https://cdn.example.com/1.png
+  $ neopress templates mark --name Portfolio --reference-url https://example.com --language ko --preview-img-url https://cdn.example.com/a.png --preview-img-url https://cdn.example.com/b.png --description "Minimal portfolio"
+  $ neopress templates mark --name "SaaS Landing" --reference-url https://example.com --language es --preview-img-url https://cdn.example.com/poster.webp --preview-video-url https://cdn.example.com/preview.webm
+--name, --reference-url, and --language are required, and at least one --preview-img-url must be given (repeat the flag for multiple images). --language is the language the template's own content is written in, as a two-letter ISO 639-1 code (ko, en, es) — not a region locale like en-US. --preview-video-url is the gallery hover video; pair it with the poster (its first frame) as the first --preview-img-url. Upserts the template metadata for the active site and sets the site status to active; running it again updates the existing template.`).requiredOption("--name <name>", "Template display name").option("--description <description>", "Template description, up to 150 characters").requiredOption("--reference-url <url>", "Reference URL for template provenance").requiredOption("--language <code>", "Primary language of the template content, as a two-letter ISO 639-1 code (e.g. ko, en, es)", parseLanguage).option("--preview-img-url <url>", "Preview image URL (required — at least one). Repeat for multiple images.", collectPreviewImgUrl, []).option("--preview-video-url <url>", "Preview video URL played on gallery hover. The first --preview-img-url should be this video's first frame.").action(async (options) => {
 		output(await (await getClientAsync()).templates.mark({
 			name: options.name,
 			description: options.description,
 			referenceUrl: options.referenceUrl,
+			language: options.language,
 			previewImgUrls: options.previewImgUrl.length > 0 ? options.previewImgUrl : void 0,
 			previewVideoUrl: options.previewVideoUrl
 		}));
@@ -31913,7 +31924,7 @@ function registerGuideCommands(program) {
 * Designed for use with Claude Code and other AI tools via --json mode.
 */
 const program = new Command();
-program.name("neopress").description("Neopress CLI — manage your site from the terminal").version("4.8.1").option("--json", "Output in JSON format (for AI tools and pipes)").option("--site <idOrHandle>", "Target a specific site (overrides active site; not persisted)").option("--no-input", "Non-interactive mode").hook("preAction", (thisCommand) => {
+program.name("neopress").description("Neopress CLI — manage your site from the terminal").version("4.9.0").option("--json", "Output in JSON format (for AI tools and pipes)").option("--site <idOrHandle>", "Target a specific site (overrides active site; not persisted)").option("--no-input", "Non-interactive mode").hook("preAction", (thisCommand) => {
 	const opts = thisCommand.optsWithGlobals();
 	if (opts.site) setSiteOverride(String(opts.site));
 	if (opts.json || !process.stdout.isTTY) setJsonMode(true);

package/dist/index.d.ts

@@ -44,6 +44,8 @@ interface Template {
   referenceUrl: string;
   previewImgUrls: string[] | null;
   previewVideoUrl: string | null;
+  /** Primary language of the template's content, as an ISO 639-1 code (ko/en/es). */
+  language: string | null;
   createdAt: string | null;
 }
 interface TemplateListItem {
@@ -54,6 +56,7 @@ interface TemplateListItem {
   referenceUrl: string;
   previewImgUrls: string[] | null;
   description: string | null;
+  language: string | null;
   createdAt: string;
 }
 interface Page {
@@ -600,6 +603,11 @@ interface TemplateMarkParams {
    * card cross-fades from poster to video, so the poster must be the video's
    * first frame. Omit to leave an existing value untouched; `null` clears it. */
   previewVideoUrl?: string | null;
+  /** Primary language of the template's content — required, ISO 639-1 lowercase
+   * two-letter code (`ko`, `en`, `es`). Region-qualified locales (`en-US`) are
+   * rejected: the gallery filters on this key and must not see one language
+   * under two spellings. */
+  language: string;
 }
 interface TemplateDeleteResult {
   siteId: number;

package/dist/index.js

@@ -22982,6 +22982,7 @@ function serializeTemplate(t) {
 		referenceUrl: t.reference_url,
 		previewImgUrls: t.preview_img_urls,
 		previewVideoUrl: t.preview_video_url ?? null,
+		language: t.language ?? null,
 		createdAt: t.created_at
 	};
 }
@@ -27013,7 +27014,7 @@ var TemplatesEndpoint = class {
 		if (siteIds.length === 0) return [];
 		const namePrefix = params?.namePrefix?.trim();
 		const limit = Math.min(Math.max(params?.limit ?? 100, 1), 500);
-		let query = this.client.db.from("templates").select("id, name, reference_url, preview_img_urls, description, created_at").in("id", siteIds);
+		let query = this.client.db.from("templates").select("id, name, reference_url, preview_img_urls, description, language, created_at").in("id", siteIds);
 		if (namePrefix) query = query.ilike("name", `${namePrefix}%`);
 		if (params?.order) query = query.order("created_at", { ascending: params.order === "asc" });
 		query = query.limit(limit);
@@ -27029,6 +27030,7 @@ var TemplatesEndpoint = class {
 				referenceUrl: t.reference_url,
 				previewImgUrls: t.preview_img_urls ?? null,
 				description: t.description ?? null,
+				language: t.language ?? null,
 				createdAt: t.created_at
 			};
 		});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neopress/cli",
-  "version": "4.8.1",
+  "version": "4.9.0",
   "description": "Neopress CLI — manage your Neopress site from the terminal",
   "type": "module",
   "keywords": [