@pdfme/cli 6.1.5 → 6.1.7-dev.1

package/README.md

@@ -1,6 +1,6 @@
 ## @pdfme/cli
 
-This package provides the `pdfme` command-line interface for JSON-first pdfme workflows, including PDF generation, validation, diagnostics, example export, and PDF conversion utilities.
+This package provides the `pdfme` command-line interface for JSON-first pdfme workflows, including PDF generation, validation, diagnostics, and PDF conversion utilities.
 
 Node.js 20 or later is required.
 

package/dist/commands/doctor.d.ts

@@ -41,10 +41,5 @@ declare const _default: import("citty").CommandDef<{
         description: string;
         default: boolean;
     };
-    imageFormat: {
-        type: "string";
-        description: string;
-        default: string;
-    };
 }>;
 export default _default;

package/dist/commands/generate.d.ts

@@ -30,11 +30,6 @@ declare const _default: import("citty").CommandDef<{
         description: string;
         default: boolean;
     };
-    imageFormat: {
-        type: "string";
-        description: string;
-        default: string;
-    };
     scale: {
         type: "string";
         description: string;

package/dist/commands/pdf2img.d.ts

@@ -24,11 +24,6 @@ declare const _default: import("citty").CommandDef<{
         description: string;
         default: string;
     };
-    imageFormat: {
-        type: "string";
-        description: string;
-        default: string;
-    };
     pages: {
         type: "string";
         description: string;

package/dist/grid.d.ts

@@ -9,15 +9,14 @@ interface Schema {
     height: number;
     [key: string]: unknown;
 }
-type ImageFormat = 'png' | 'jpeg';
 /**
  * Draw grid lines and schema boundary overlays on a generated PDF page image.
  * Used by `pdfme generate --grid`.
  */
-export declare function drawGridOnImage(imageBuffer: ArrayBuffer, schemas: Schema[], gridSizeMm: number, pageWidthMm: number, pageHeightMm: number, imageType: ImageFormat): Promise<ArrayBuffer>;
+export declare function drawGridOnImage(imageBuffer: ArrayBuffer, schemas: Schema[], gridSizeMm: number, pageWidthMm: number, pageHeightMm: number): Promise<ArrayBuffer>;
 /**
  * Draw grid lines with mm coordinate labels on a plain PDF image.
  * Used by `pdfme pdf2img --grid`.
  */
-export declare function drawGridOnPdfImage(imageBuffer: ArrayBuffer, gridSizeMm: number, pageWidthMm: number, pageHeightMm: number, imageType: ImageFormat): Promise<ArrayBuffer>;
+export declare function drawGridOnPdfImage(imageBuffer: ArrayBuffer, gridSizeMm: number, pageWidthMm: number, pageHeightMm: number): Promise<ArrayBuffer>;
 export {};

package/dist/index.js

@@ -103,13 +103,6 @@ function isOptionProvided(rawArgs, name, alias) {
 		return allowedFlags.has(flag);
 	});
 }
-function parseEnumArg(optionName, value, allowedValues) {
-	if (typeof value !== "string" || !allowedValues.includes(value)) fail(`Invalid value for --${optionName}: expected one of ${allowedValues.join(", ")}, received ${formatValue(value)}.`, {
-		code: "EARG",
-		exitCode: 1
-	});
-	return value;
-}
 function parsePositiveNumberArg(optionName, value) {
 	const parsed = typeof value === "number" ? value : Number(value);
 	if (!Number.isFinite(parsed) || parsed <= 0) fail(`Invalid value for --${optionName}: expected a positive number, received ${formatValue(value)}.`, {
@@ -278,11 +271,10 @@ function resolveBasePdf(template, basePdfArg, templateDir) {
 	}
 	return template;
 }
-function getImageOutputPaths(pdfOutputPath, pageCount, imageFormat) {
+function getImageOutputPaths(pdfOutputPath, pageCount) {
 	const dir = dirname(pdfOutputPath);
 	const base = basename(pdfOutputPath, extname(pdfOutputPath));
-	const ext = imageFormat === "jpeg" ? "jpg" : "png";
-	return Array.from({ length: pageCount }, (_, i) => join(dir, `${base}-${i + 1}.${ext}`));
+	return Array.from({ length: pageCount }, (_, i) => join(dir, `${base}-${i + 1}.png`));
 }
 function writeOutput(filePath, data) {
 	try {
@@ -478,7 +470,7 @@ function validateTemplate(template) {
 	} catch (error) {
 		errors.push(error instanceof Error ? error.message : String(error));
 	}
-	const schemaPages = normalizeSchemaPages$2(template.schemas);
+	const schemaPages = normalizeSchemaPages$1(template.schemas);
 	if (schemaPages.length === 0) return {
 		errors,
 		warnings,
@@ -531,7 +523,7 @@ function validateTemplate(template) {
 	};
 }
 function inspectTemplate(template, templateDir) {
-	const flattenedSchemas = normalizeSchemaPages$2(template.schemas).flat();
+	const flattenedSchemas = normalizeSchemaPages$1(template.schemas).flat();
 	const collectedSchemaTypes = getUniqueStringValues(flattenedSchemas.map((schema) => schema.type));
 	const requiredFonts = getUniqueStringValues(flattenedSchemas.map((schema) => schema.fontName));
 	return {
@@ -543,7 +535,7 @@ function inspectTemplate(template, templateDir) {
 }
 function collectInputHints(template) {
 	const hintMap = /* @__PURE__ */ new Map();
-	const schemaPages = normalizeSchemaPages$2(template.schemas);
+	const schemaPages = normalizeSchemaPages$1(template.schemas);
 	const radioGroupMembers = collectRadioGroupMembers(schemaPages);
 	for (let pageIdx = 0; pageIdx < schemaPages.length; pageIdx++) for (const schema of schemaPages[pageIdx]) {
 		const name = typeof schema.name === "string" ? schema.name : "";
@@ -645,7 +637,7 @@ function assertRecordObject(value, label) {
 	});
 	return value;
 }
-function normalizeSchemaPages$2(rawSchemas) {
+function normalizeSchemaPages$1(rawSchemas) {
 	if (!Array.isArray(rawSchemas)) return [];
 	return rawSchemas.map((page) => {
 		if (Array.isArray(page)) return page.filter((schema) => typeof schema === "object" && schema !== null);
@@ -1730,23 +1722,21 @@ function bufferToArrayBuffer(buffer) {
 * Draw grid lines and schema boundary overlays on a generated PDF page image.
 * Used by `pdfme generate --grid`.
 */
-async function drawGridOnImage(imageBuffer, schemas, gridSizeMm, pageWidthMm, pageHeightMm, imageType) {
+async function drawGridOnImage(imageBuffer, schemas, gridSizeMm, pageWidthMm, pageHeightMm) {
 	const { canvas, ctx, img } = await loadAndPrepareCanvas(imageBuffer);
 	const pxPerMm = img.width / pageWidthMm;
 	drawGridLines(ctx, pxPerMm, pageWidthMm, pageHeightMm, img.width, img.height, gridSizeMm, false);
 	drawSchemaOverlays(ctx, schemas, pxPerMm);
-	const mimeType = imageType === "jpeg" ? "image/jpeg" : "image/png";
-	return bufferToArrayBuffer(canvas.toBuffer(mimeType));
+	return bufferToArrayBuffer(canvas.toBuffer("image/png"));
 }
 /**
 * Draw grid lines with mm coordinate labels on a plain PDF image.
 * Used by `pdfme pdf2img --grid`.
 */
-async function drawGridOnPdfImage(imageBuffer, gridSizeMm, pageWidthMm, pageHeightMm, imageType) {
+async function drawGridOnPdfImage(imageBuffer, gridSizeMm, pageWidthMm, pageHeightMm) {
 	const { canvas, ctx, img } = await loadAndPrepareCanvas(imageBuffer);
 	drawGridLines(ctx, img.width / pageWidthMm, pageWidthMm, pageHeightMm, img.width, img.height, gridSizeMm, true);
-	const mimeType = imageType === "jpeg" ? "image/jpeg" : "image/png";
-	return bufferToArrayBuffer(canvas.toBuffer(mimeType));
+	return bufferToArrayBuffer(canvas.toBuffer("image/png"));
 }
 //#endregion
 //#region src/commands/generate.ts
@@ -1782,11 +1772,6 @@ var generateArgs = {
 		description: "Also output PNG images per page",
 		default: false
 	},
-	imageFormat: {
-		type: "string",
-		description: "Image format: png | jpeg",
-		default: "png"
-	},
 	scale: {
 		type: "string",
 		description: "Image render scale",
@@ -1836,7 +1821,6 @@ var generate_default = defineCommand({
 	async run({ args, rawArgs }) {
 		return runWithContract({ json: Boolean(args.json) }, async () => {
 			assertNoUnknownFlags(rawArgs, generateArgs);
-			const imageFormat = parseEnumArg("imageFormat", args.imageFormat, ["png", "jpeg"]);
 			const scale = parsePositiveNumberArg("scale", args.scale);
 			const gridSize = parsePositiveNumberArg("gridSize", args.gridSize);
 			ensureSafeDefaultOutputPath({
@@ -1854,7 +1838,7 @@ var generate_default = defineCommand({
 			});
 			const template = resolveBasePdf(rawTemplate, args.basePdf, templateDir);
 			const mode = args.file ? "job" : "template+inputs";
-			const templatePageCount = normalizeSchemaPages$1(template.schemas).length;
+			const templatePageCount = normalizeSchemaPages(template.schemas).length;
 			const jobOptions = normalizeJobOptions(rawJobOptions);
 			assertSupportedSchemaTypes(template);
 			const resolvedFont = await resolveFont({
@@ -1889,7 +1873,7 @@ var generate_default = defineCommand({
 				console.error(`Template pages: ${templatePageCount}`);
 				console.error(`Inputs: ${inputs.length} set(s)`);
 				console.error(`Output: ${args.output}`);
-				console.error(`Images: ${args.image || args.grid ? `enabled (${imageFormat}, scale=${scale}, grid=${args.grid ? `${gridSize}mm` : "disabled"})` : "disabled"}`);
+				console.error(`Images: ${args.image || args.grid ? `enabled (png, scale=${scale}, grid=${args.grid ? `${gridSize}mm` : "disabled"})` : "disabled"}`);
 				console.error(`Fonts: ${Object.keys(font).join(", ")}`);
 				if (args.basePdf) console.error(`Base PDF override: ${args.basePdf}`);
 			}
@@ -1911,18 +1895,15 @@ var generate_default = defineCommand({
 				outputBytes: pdf.byteLength
 			};
 			if (args.image || args.grid) {
-				const images = await pdf2img(pdf, {
-					scale,
-					imageType: imageFormat
-				});
-				const imagePaths = getImageOutputPaths(args.output, images.length, imageFormat);
+				const images = await pdf2img(pdf, { scale });
+				const imagePaths = getImageOutputPaths(args.output, images.length);
 				if (args.grid) {
 					const renderedPageSizes = await pdf2size(pdf);
 					for (let i = 0; i < images.length; i++) {
 						const templateSchemas = template.schemas ?? [];
 						const pageSchemas = templateSchemas[i % templateSchemas.length] ?? [];
 						const size = renderedPageSizes[i] ?? renderedPageSizes[0] ?? PAGE_SIZE_PRESETS.A4;
-						const gridImage = await drawGridOnImage(images[i], pageSchemas, gridSize, size.width, size.height, imageFormat);
+						const gridImage = await drawGridOnImage(images[i], pageSchemas, gridSize, size.width, size.height);
 						writeOutput(imagePaths[i], gridImage);
 					}
 				} else for (let i = 0; i < images.length; i++) writeOutput(imagePaths[i], images[i]);
@@ -1969,7 +1950,7 @@ function hasExplicitFontEntries(jobFont) {
 }
 function assertSupportedSchemaTypes(template) {
 	const unsupported = [];
-	for (const page of normalizeSchemaPages$1(template.schemas)) for (const schema of page) {
+	for (const page of normalizeSchemaPages(template.schemas)) for (const schema of page) {
 		const type = schema.type;
 		if (typeof type === "string" && !schemaTypes.has(type)) {
 			const name = typeof schema.name === "string" && schema.name.length > 0 ? schema.name : null;
@@ -1986,7 +1967,7 @@ function describeGenerateInput(file, template, inputs) {
 	if (template || inputs) return `${template ?? "(missing template)"} + ${inputs ?? "(missing inputs)"}`;
 	return "(unknown)";
 }
-function normalizeSchemaPages$1(rawSchemas) {
+function normalizeSchemaPages(rawSchemas) {
 	if (!Array.isArray(rawSchemas)) return [];
 	return rawSchemas.map((page) => {
 		if (Array.isArray(page)) return page.filter((schema) => typeof schema === "object" && schema !== null);
@@ -2114,11 +2095,6 @@ var pdf2imgArgs = {
 		description: "Render scale",
 		default: "1"
 	},
-	imageFormat: {
-		type: "string",
-		description: "Image format: png | jpeg",
-		default: "png"
-	},
 	pages: {
 		type: "string",
 		description: "Page range (e.g., 1-3, 1,3,5)"
@@ -2150,16 +2126,11 @@ var pdf2img_default = defineCommand({
 			});
 			const scale = parsePositiveNumberArg("scale", args.scale);
 			const gridSize = parsePositiveNumberArg("gridSize", args.gridSize);
-			const imageFormat = parseEnumArg("imageFormat", args.imageFormat, ["png", "jpeg"]);
 			const pdfData = readPdfFile(args.file);
 			const sizes = await pdf2size(pdfData);
 			const pageIndices = args.pages ? parsePageRange(args.pages, sizes.length).map((page) => page - 1) : Array.from({ length: sizes.length }, (_, index) => index);
-			const allImages = await pdf2img(pdfData, {
-				scale,
-				imageType: imageFormat
-			});
+			const allImages = await pdf2img(pdfData, { scale });
 			const inputBase = basename(args.file, extname(args.file));
-			const ext = imageFormat === "jpeg" ? "jpg" : "png";
 			let outputDir = ".";
 			if (args.output) {
 				outputDir = args.output;
@@ -2175,7 +2146,7 @@ var pdf2img_default = defineCommand({
 				console.error(`Pages: ${sizes.length}`);
 				console.error(`Selected pages: ${pageIndices.map((pageIdx) => pageIdx + 1).join(", ")}`);
 				console.error(`Output: ${outputDir}`);
-				console.error(`Image format: ${imageFormat}`);
+				console.error("Image format: png");
 				console.error(`Scale: ${scale}`);
 				console.error(`Grid: ${args.grid ? `enabled (${gridSize}mm)` : "disabled"}`);
 			}
@@ -2183,8 +2154,8 @@ var pdf2img_default = defineCommand({
 			for (const pageIdx of pageIndices) {
 				let imageData = allImages[pageIdx];
 				const size = sizes[pageIdx] ?? PAGE_SIZE_PRESETS.A4;
-				if (args.grid) imageData = await drawGridOnPdfImage(imageData, gridSize, size.width, size.height, imageFormat);
-				const outputPath = join(outputDir, `${inputBase}-${pageIdx + 1}.${ext}`);
+				if (args.grid) imageData = await drawGridOnPdfImage(imageData, gridSize, size.width, size.height);
+				const outputPath = join(outputDir, `${inputBase}-${pageIdx + 1}.png`);
 				writeOutput(outputPath, imageData);
 				const paperSize = detectPaperSize(size.width, size.height);
 				results.push({
@@ -2270,307 +2241,7 @@ var pdf2size_default = defineCommand({
 });
 //#endregion
 //#region src/version.ts
-var CLI_VERSION = "6.1.5";
-//#endregion
-//#region src/example-templates.ts
-function getExamplesBaseUrl() {
-	return process.env.PDFME_EXAMPLES_BASE_URL ?? "https://playground.pdfme.com/template-assets";
-}
-async function fetchJson(url) {
-	const response = await fetch(url, { signal: AbortSignal.timeout(15e3) });
-	if (!response.ok) throw new Error(`HTTP ${response.status}`);
-	return await response.json();
-}
-async function getExampleManifest() {
-	let lastError;
-	for (const url of getManifestUrls()) try {
-		return {
-			manifest: normalizeManifest(await fetchJson(url)),
-			source: "remote",
-			url
-		};
-	} catch (error) {
-		lastError = error;
-	}
-	throw new Error(`Could not load examples manifest. ${formatError(lastError)}`);
-}
-async function fetchExampleTemplateWithSource(name, options = {}) {
-	const entry = (options.manifest ?? (await getExampleManifest()).manifest).templates.find((template) => template.name === name);
-	if (!entry) throw new Error(`Template "${name}" is not present in the examples manifest.`);
-	const relativePath = entry.path;
-	const templateUrl = `${getExamplesBaseUrl().replace(/\/$/, "")}/${relativePath}`;
-	return {
-		template: await fetchJson(templateUrl),
-		source: "remote",
-		url: templateUrl
-	};
-}
-function getManifestUrls() {
-	const baseUrl = getExamplesBaseUrl().replace(/\/$/, "");
-	return [`${baseUrl}/manifest.json`, `${baseUrl}/index.json`];
-}
-function normalizeManifest(raw) {
-	if (Array.isArray(raw)) return {
-		schemaVersion: 1,
-		cliVersion: CLI_VERSION,
-		templates: normalizeEntries(raw)
-	};
-	if (typeof raw !== "object" || raw === null) throw new Error("Examples manifest must be a JSON object or array.");
-	const record = raw;
-	const rawTemplates = Array.isArray(record.templates) ? record.templates : Array.isArray(record.entries) ? record.entries : void 0;
-	if (!rawTemplates) throw new Error("Examples manifest is missing templates.");
-	return {
-		schemaVersion: typeof record.schemaVersion === "number" && Number.isFinite(record.schemaVersion) ? record.schemaVersion : 1,
-		cliVersion: typeof record.cliVersion === "string" ? record.cliVersion : CLI_VERSION,
-		templates: normalizeEntries(rawTemplates)
-	};
-}
-function normalizeEntries(rawTemplates) {
-	return rawTemplates.filter((entry) => typeof entry === "object" && entry !== null).map((entry) => {
-		const name = typeof entry.name === "string" ? entry.name : "";
-		return {
-			name,
-			author: typeof entry.author === "string" && entry.author.length > 0 ? entry.author : "pdfme",
-			path: typeof entry.path === "string" && entry.path.length > 0 ? entry.path : `${name}/template.json`,
-			thumbnailPath: typeof entry.thumbnailPath === "string" && entry.thumbnailPath.length > 0 ? entry.thumbnailPath : `${name}/thumbnail.png`,
-			...typeof entry.sourcePath === "string" && entry.sourcePath.length > 0 ? { sourcePath: entry.sourcePath } : {},
-			...typeof entry.description === "string" ? { description: entry.description } : {},
-			...typeof entry.order === "number" && Number.isFinite(entry.order) ? { order: entry.order } : {},
-			pageCount: typeof entry.pageCount === "number" && Number.isFinite(entry.pageCount) ? entry.pageCount : 0,
-			fieldCount: typeof entry.fieldCount === "number" && Number.isFinite(entry.fieldCount) ? entry.fieldCount : 0,
-			schemaTypes: normalizeStringArray(entry.schemaTypes),
-			fontNames: normalizeStringArray(entry.fontNames),
-			hasCJK: typeof entry.hasCJK === "boolean" ? entry.hasCJK : false,
-			basePdfKind: typeof entry.basePdfKind === "string" && entry.basePdfKind.length > 0 ? entry.basePdfKind : "unknown",
-			...typeof entry.sourceKind === "string" ? { sourceKind: entry.sourceKind } : {},
-			...Array.isArray(entry.tags) ? { tags: normalizeStringArray(entry.tags) } : {},
-			...typeof entry.title === "string" ? { title: entry.title } : {}
-		};
-	}).filter((entry) => entry.name.length > 0);
-}
-function normalizeStringArray(value) {
-	if (!Array.isArray(value)) return [];
-	return value.filter((item) => typeof item === "string" && item.length > 0);
-}
-function formatError(error) {
-	return error instanceof Error ? error.message : String(error);
-}
-//#endregion
-//#region src/example-fonts.ts
-var OFFICIAL_EXAMPLE_FONT_URLS = {
-	NotoSansJP: "https://fonts.gstatic.com/s/notosansjp/v53/-F6jfjtqLzI2JPCgQBnw7HFyzSD-AsregP8VFBEj75vY0rw-oME.ttf",
-	NotoSerifJP: "https://fonts.gstatic.com/s/notoserifjp/v30/xn71YHs72GKoTvER4Gn3b5eMRtWGkp6o7MjQ2bwxOubAILO5wBCU.ttf",
-	"PinyonScript-Regular": "https://fonts.gstatic.com/s/pinyonscript/v22/6xKpdSJbL9-e9LuoeQiDRQR8aOLQO4bhiDY.ttf"
-};
-function collectTemplateFontNames(template) {
-	const schemas = template.schemas;
-	if (!Array.isArray(schemas)) return [];
-	const fontNames = /* @__PURE__ */ new Set();
-	for (const page of schemas) {
-		const pageSchemas = Array.isArray(page) ? page : typeof page === "object" && page !== null ? Object.values(page) : [];
-		for (const schema of pageSchemas) {
-			if (typeof schema !== "object" || schema === null) continue;
-			const fontName = schema.fontName;
-			if (typeof fontName === "string" && fontName.length > 0) fontNames.add(fontName);
-		}
-	}
-	return [...fontNames].sort();
-}
-function getOfficialExampleFonts(template) {
-	const entries = collectTemplateFontNames(template).flatMap((fontName) => {
-		const url = OFFICIAL_EXAMPLE_FONT_URLS[fontName];
-		return url ? [[fontName, {
-			data: url,
-			fallback: false,
-			subset: true
-		}]] : [];
-	});
-	if (entries.length === 0) return;
-	return Object.fromEntries(entries);
-}
-//#endregion
-//#region src/commands/examples.ts
-var examplesArgs = {
-	name: {
-		type: "positional",
-		description: "Template name to output",
-		required: false
-	},
-	list: {
-		type: "boolean",
-		description: "List available templates",
-		default: false
-	},
-	output: {
-		type: "string",
-		alias: "o",
-		description: "Output file path"
-	},
-	withInputs: {
-		type: "boolean",
-		alias: "w",
-		description: "Output unified format with sample inputs",
-		default: false
-	},
-	verbose: {
-		type: "boolean",
-		alias: "v",
-		description: "Verbose output",
-		default: false
-	},
-	json: {
-		type: "boolean",
-		description: "Machine-readable JSON output",
-		default: false
-	}
-};
-function generateSampleInputs(template) {
-	const fields = normalizeSchemaPages(template.schemas).flat();
-	if (fields.length === 0) return [{}];
-	const input = {};
-	for (const schema of fields) {
-		if (typeof schema !== "object" || schema === null) continue;
-		const name = schema.name;
-		const content = schema.content;
-		const readOnly = schema.readOnly;
-		const type = schema.type;
-		if (readOnly) continue;
-		if (name) input[name] = content || (type === "image" || type === "signature" ? "" : `Sample ${name}`);
-	}
-	return [input];
-}
-var examples_default = defineCommand({
-	meta: {
-		name: "examples",
-		description: "List and output example pdfme templates"
-	},
-	args: examplesArgs,
-	async run({ args, rawArgs }) {
-		return runWithContract({ json: Boolean(args.json) }, async () => {
-			assertNoUnknownFlags(rawArgs, examplesArgs);
-			let manifestResult;
-			try {
-				manifestResult = await getExampleManifest();
-			} catch (error) {
-				fail(`Failed to load examples manifest. ${error instanceof Error ? error.message : String(error)}`, {
-					code: "EIO",
-					exitCode: 3,
-					cause: error
-				});
-			}
-			const templateEntries = manifestResult.manifest.templates;
-			const templateNames = templateEntries.map((entry) => entry.name).filter((name) => typeof name === "string" && name.length > 0).sort();
-			if (args.verbose) {
-				console.error(`Base URL: ${getExamplesBaseUrl()}`);
-				console.error(`Manifest source: ${manifestResult.source}`);
-				if (manifestResult.url) console.error(`Manifest URL: ${manifestResult.url}`);
-				console.error(`Templates: ${templateNames.length}`);
-			}
-			if (args.list || !args.name) {
-				if (args.json) printJson({
-					ok: true,
-					command: "examples",
-					mode: "list",
-					templateCount: templateNames.length,
-					source: manifestResult.source,
-					baseUrl: getExamplesBaseUrl(),
-					manifest: manifestResult.manifest
-				});
-				else {
-					console.log("Available templates:");
-					for (const name of templateNames) console.log(`  ${name}`);
-				}
-				return;
-			}
-			if (!templateEntries.find((template) => template.name === args.name)) fail(`Template "${args.name}" not found. Available templates: ${templateNames.join(", ")}`, {
-				code: "EARG",
-				exitCode: 1
-			});
-			let templateResult;
-			try {
-				templateResult = await fetchExampleTemplateWithSource(args.name, { manifest: manifestResult.manifest });
-			} catch (error) {
-				fail(`Failed to load example template "${args.name}". ${error instanceof Error ? error.message : String(error)}`, {
-					code: "EIO",
-					exitCode: 3,
-					cause: error
-				});
-			}
-			const output = args.withInputs ? buildExampleJob(templateResult.template) : templateResult.template;
-			const mode = args.withInputs ? "job" : "template";
-			const stats = countTemplateStats(templateResult.template);
-			const inputCount = args.withInputs ? output.inputs?.length ?? 0 : void 0;
-			if (args.verbose) {
-				console.error(`Template: ${args.name}`);
-				console.error(`Template source: ${templateResult.source}`);
-				if (templateResult.url) console.error(`Template URL: ${templateResult.url}`);
-				console.error(`Mode: ${mode}`);
-				console.error(`Template pages: ${stats.templatePageCount}`);
-				console.error(`Fields: ${stats.fieldCount}`);
-				if (inputCount !== void 0) console.error(`Inputs: ${inputCount} set(s)`);
-				console.error(`Output: ${args.output ?? "stdout"}`);
-			}
-			if (args.output) {
-				writeOutput(args.output, new TextEncoder().encode(JSON.stringify(output, null, 2)));
-				if (args.json) printJson({
-					ok: true,
-					command: "examples",
-					name: args.name,
-					mode,
-					source: templateResult.source,
-					templatePageCount: stats.templatePageCount,
-					fieldCount: stats.fieldCount,
-					...inputCount !== void 0 ? { inputCount } : {},
-					outputPath: args.output
-				});
-				else {
-					const label = args.withInputs ? "Job file" : "Template";
-					console.log(`\u2713 ${label} written to ${args.output}`);
-				}
-				return;
-			}
-			if (args.json) printJson({
-				ok: true,
-				command: "examples",
-				name: args.name,
-				source: templateResult.source,
-				mode,
-				templatePageCount: stats.templatePageCount,
-				fieldCount: stats.fieldCount,
-				...inputCount !== void 0 ? { inputCount } : {},
-				data: output
-			});
-			else console.log(JSON.stringify(output, null, 2));
-		});
-	}
-});
-function buildExampleJob(template) {
-	const job = {
-		template,
-		inputs: generateSampleInputs(template)
-	};
-	const font = getOfficialExampleFonts(template);
-	if (font) job.options = { font };
-	return job;
-}
-function countTemplateStats(template) {
-	const schemaPages = normalizeSchemaPages(template.schemas);
-	return {
-		templatePageCount: schemaPages.length,
-		fieldCount: schemaPages.reduce((count, page) => count + page.length, 0)
-	};
-}
-function normalizeSchemaPages(rawSchemas) {
-	if (!Array.isArray(rawSchemas)) return [];
-	return rawSchemas.map((page) => {
-		if (Array.isArray(page)) return page.filter((schema) => typeof schema === "object" && schema !== null);
-		if (typeof page === "object" && page !== null) return Object.entries(page).map(([name, schema]) => typeof schema === "object" && schema !== null ? {
-			...schema,
-			name: schema.name ?? name
-		} : null).filter((schema) => schema !== null);
-		return [];
-	});
-}
+var CLI_VERSION = "6.1.7-dev.1";
 //#endregion
 //#region src/commands/doctor.ts
 var doctorArgs = {
@@ -2615,11 +2286,6 @@ var doctorArgs = {
 		type: "boolean",
 		description: "Simulate generate --image when previewing runtime output paths",
 		default: false
-	},
-	imageFormat: {
-		type: "string",
-		description: "Image format to use when previewing runtime output paths: png | jpeg",
-		default: "png"
 	}
 };
 var doctor_default = defineCommand({
@@ -2632,7 +2298,6 @@ var doctor_default = defineCommand({
 		return runWithContract({ json: Boolean(args.json) }, async () => {
 			assertNoUnknownFlags(rawArgs, doctorArgs);
 			const invocation = resolveDoctorInvocation(args);
-			const imageFormat = parseEnumArg("imageFormat", args.imageFormat, ["png", "jpeg"]);
 			const environment = getEnvironmentReport();
 			if (invocation.target === "environment") {
 				const issues = collectEnvironmentIssues(environment);
@@ -2660,7 +2325,6 @@ var doctor_default = defineCommand({
 					output: args.output,
 					force: Boolean(args.force),
 					image: Boolean(args.image),
-					imageFormat,
 					rawArgs
 				}
 			});
@@ -2886,8 +2550,8 @@ function diagnoseRuntime(source, options) {
 		output,
 		imageOutputs: {
 			enabled: options.image,
-			format: options.imageFormat,
-			paths: options.image ? getImageOutputPaths(options.output, estimatedPages, options.imageFormat) : [],
+			format: "png",
+			paths: options.image ? getImageOutputPaths(options.output, estimatedPages) : [],
 			directory: dirname(output.resolvedPath)
 		}
 	};
@@ -3130,7 +2794,6 @@ runMain(defineCommand({
 		validate: validate_default,
 		pdf2img: pdf2img_default,
 		pdf2size: pdf2size_default,
-		examples: examples_default,
 		doctor: doctor_default
 	}
 }));