@politty/zod 0.1.0 → 0.1.1

package/dist/cli-main-BQfutJEX.js

@@ -0,0 +1,3 @@
+import { t as runPolittyCli } from "./cli-main-D4kkrRfX.js";
+
+export { runPolittyCli };

package/dist/{cli-main-Cdz55PLM.js → cli-main-D4kkrRfX.js}

@@ -1,6 +1,6 @@
 import { a as internalField, i as internalArgs } from "./schema-extractor-DMSozq40.js";
 import { n as defineCommand } from "./command-k-4yAz4J.js";
-import { n as runMain } from "./runner-UEbd9e-3.js";
+import { n as runMain } from "./runner-DAGvxV2P.js";
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { basename, dirname, extname, isAbsolute, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -239,7 +239,7 @@ const generateWorkerCommand = defineCommand({
 	description: "Generate and verify a bundled shell completion worker",
 	args: generateWorkerArgsSchema,
 	async run(args) {
-		const { generateBundledCompletionWorker } = await import("./src-zNS0DTqZ.js");
+		const { generateBundledCompletionWorker } = await import("./src-CLogLsbS.js");
 		await generateBundledCompletionWorker({
 			bin: args.bin,
 			programName: args.program,

package/dist/{cli-run-BlcK64io.js → cli-run-wxd6kPPf.js}

@@ -1,7 +1,7 @@
 import "./register-DlGnMLIY.js";
 
 //#region src/cli-run.ts
-const { runPolittyCli } = await import("./cli-main-B5mwyz8q.js");
+const { runPolittyCli } = await import("./cli-main-BQfutJEX.js");
 await runPolittyCli("@politty/zod");
 
 //#endregion

package/dist/cli.js

@@ -10,7 +10,7 @@ import { n as enableCompileCache } from "./compile-cache-BC65o7MH.js";
 * before any code runs, so they could never hit a cache enabled here.
 */
 enableCompileCache("politty");
-await import("./cli-run-BlcK64io.js");
+await import("./cli-run-wxd6kPPf.js");
 
 //#endregion
 export {  };

package/dist/docs.js

@@ -67,10 +67,19 @@ function toOptionRows(options) {
 	return options.map(toOptionRow);
 }
 /**
-* Escape markdown special characters in table cells.
+* Convert hard line breaks in a description into `<br>` so they render as line
+* breaks inside a single markdown table cell or list item, instead of breaking
+* the surrounding table row / list structure.
+*/
+function inlineMarkdownBreaks(str) {
+	return str.replace(/\r?\n/g, "<br>");
+}
+/**
+* Escape markdown special characters in table cells. Embedded line breaks are
+* converted to `<br>` so multi-line descriptions stay within a single cell.
 */
 function escapeTableCell$2(str) {
-	return str.replace(/\|/g, "\\|").replace(/\n/g, " ");
+	return inlineMarkdownBreaks(str.replace(/\|/g, "\\|"));
 }
 function backtick(value) {
 	return `\`${value}\``;
@@ -195,12 +204,12 @@ function emitMarkdownList(rows) {
 			...longAliases
 		].map(backtick).join(", ");
 		if (row.inlineNegation) flags += ` / ${backtick(row.inlineNegation)}`;
-		const desc = row.description ? ` - ${row.description}` : "";
+		const desc = row.description ? ` - ${inlineMarkdownBreaks(row.description)}` : "";
 		const required = row.required ? " (required)" : "";
 		const defaultVal = row.hasDefault ? ` (default: ${JSON.stringify(row.defaultValue)})` : "";
 		const envInfo = formatEnvInfo(row.env);
 		lines.push(`- ${flags}${desc}${required}${defaultVal}${envInfo}`);
-		if (row.negationRow) lines.push(`- ${backtick(row.negationRow.flag)} - ${row.negationRow.description} ${row.negationRow.relationMarker}`);
+		if (row.negationRow) lines.push(`- ${backtick(row.negationRow.flag)} - ${inlineMarkdownBreaks(row.negationRow.description)} ${row.negationRow.relationMarker}`);
 	}
 	return lines.join("\n");
 }
@@ -306,10 +315,11 @@ function indexEndMarker(scope) {
 //#endregion
 //#region ../core/src/docs/default-renderers.ts
 /**
-* Escape markdown special characters in table cells
+* Escape markdown special characters in table cells. Embedded line breaks are
+* converted to `<br>` so multi-line descriptions stay within a single cell.
 */
 function escapeTableCell$1(str) {
-	return str.replace(/\|/g, "\\|").replace(/\n/g, " ");
+	return inlineMarkdownBreaks(str.replace(/\|/g, "\\|"));
 }
 /**
 * Render usage line
@@ -346,7 +356,7 @@ function renderArgumentsList(info) {
 	const lines = [];
 	for (const arg of info.positionalArgs) {
 		const required = arg.required ? "(required)" : "(optional)";
-		const desc = arg.description ? ` - ${arg.description}` : "";
+		const desc = arg.description ? ` - ${inlineMarkdownBreaks(arg.description)}` : "";
 		lines.push(`- \`${arg.name}\`${desc} ${required}`);
 	}
 	return lines.join("\n");
@@ -503,7 +513,7 @@ function renderArgumentsListFromArray(args) {
 	const lines = [];
 	for (const arg of args) {
 		const required = arg.required ? "(required)" : "(optional)";
-		const desc = arg.description ? ` - ${arg.description}` : "";
+		const desc = arg.description ? ` - ${inlineMarkdownBreaks(arg.description)}` : "";
 		lines.push(`- \`${arg.name}\`${desc} ${required}`);
 	}
 	return lines.join("\n");
@@ -921,7 +931,7 @@ async function executeSingleExample(example, rootCommand, commandPath) {
 	collector.start();
 	let success = true;
 	try {
-		const { runCommand } = await import("./runner-DR5Lw7LX.js");
+		const { runCommand } = await import("./runner-MMjpKeEa.js");
 		const result = await runCommand(rootCommand, argv);
 		success = result.success;
 		if (!result.success && result.error) console.error(result.error.message);

package/dist/index.js

@@ -1,13 +1,13 @@
 import { i as toKebabCase, r as toCamelCase } from "./field-meta-DMy5BcRr.js";
 import { t as arg$1 } from "./register-DlGnMLIY.js";
 import { r as getUnknownKeysMode, t as extractFields } from "./schema-extractor-DMSozq40.js";
-import { n as createCompileCacheShimGenerator, t as runPolittyCli } from "./cli-main-Cdz55PLM.js";
+import { n as createCompileCacheShimGenerator, t as runPolittyCli } from "./cli-main-D4kkrRfX.js";
 import { n as defineCommand$1, t as createDefineCommand$1 } from "./command-k-4yAz4J.js";
-import { C as ReservedFieldNameError, E as renderMarkdown, S as ReservedAliasError, T as renderInline, _ as DuplicateAliasError, a as parseArgv, b as FieldTypeConflictError, c as validateCommand, d as validateDuplicateFields, f as validateDuplicateNegations, g as CaseVariantCollisionError, h as validateReservedFieldNames, i as formatValidationErrors, l as validateCrossSchemaCollisions, m as validateReservedAliases, n as runMain, o as formatCommandValidationErrors, p as validatePositionalConfig, r as createDualCaseProxy, s as validateCaseVariantCollisions, t as runCommand, u as validateDuplicateAliases, v as DuplicateFieldError, w as generateHelp, x as PositionalConfigError, y as DuplicateNegationError } from "./runner-UEbd9e-3.js";
+import { C as ReservedFieldNameError, E as renderMarkdown, S as ReservedAliasError, T as renderInline, _ as DuplicateAliasError, a as parseArgv, b as FieldTypeConflictError, c as validateCommand, d as validateDuplicateFields, f as validateDuplicateNegations, g as CaseVariantCollisionError, h as validateReservedFieldNames, i as formatValidationErrors, l as validateCrossSchemaCollisions, m as validateReservedAliases, n as runMain, o as formatCommandValidationErrors, p as validatePositionalConfig, r as createDualCaseProxy, s as validateCaseVariantCollisions, t as runCommand, u as validateDuplicateAliases, v as DuplicateFieldError, w as generateHelp, x as PositionalConfigError, y as DuplicateNegationError } from "./runner-DAGvxV2P.js";
 import { o as isLazyCommand, s as lazy } from "./subcommand-router-Cskpofdk.js";
 import { a as symbols, i as styles, n as logger, r as setColorEnabled, t as isColorEnabled } from "./logger-i_bb-Jhc.js";
 import { a as generateCompletion, p as generateBundledCompletionWorker, s as withCompletionCommand } from "./completion-DW5qVc3l.js";
-import "./src-DO4W2NcZ.js";
+import "./src-bYH2XCQ4.js";
 
 //#region src/index.ts
 /**

package/dist/{runner-UEbd9e-3.js → runner-DAGvxV2P.js}

@@ -737,16 +737,31 @@ function padEndVisual(str, width) {
 	return str + " ".repeat(padding);
 }
 /**
+* Re-indent the continuation lines of a multi-line description so they align
+* under the description column. A `\n` in a description is treated as a hard
+* line break; every line after the first is padded to `column` spaces.
+*/
+function indentDescription(description, column) {
+	if (!description.includes("\n")) return description;
+	const pad = " ".repeat(column);
+	return description.split("\n").join(`\n${pad}`);
+}
+/**
 * Format a single option line
 * If flags exceed the column width, description is moved to the next line
+*
+* Descriptions may contain `\n` line breaks; continuation lines are indented to
+* stay aligned under the description column.
 */
 function formatOption(flags, description, indent = 0, extraDescPadding = 0) {
 	const flagWidth = 32;
 	const indentStr = "  ".repeat(indent);
 	const visualFlagLength = stripAnsi(flags).length;
 	const effectiveFlagWidth = flagWidth - indent * 2 + extraDescPadding;
-	if (visualFlagLength >= effectiveFlagWidth) return `${indentStr}  ${flags}\n${" ".repeat(effectiveFlagWidth + 2 + indent * 2)}${description}`;
-	return `${indentStr}  ${padEndVisual(flags, effectiveFlagWidth)}${description}`;
+	const descColumn = effectiveFlagWidth + 2 + indent * 2;
+	const desc = indentDescription(description, descColumn);
+	if (visualFlagLength >= effectiveFlagWidth) return `${indentStr}  ${flags}\n${" ".repeat(descColumn)}${desc}`;
+	return `${indentStr}  ${padEndVisual(flags, effectiveFlagWidth)}${desc}`;
 }
 /**
 * Format a single option field as a help line
@@ -881,7 +896,7 @@ function renderExamplesForHelp(examples, context) {
 	const cmdPath = context?.commandPath?.join(" ") ?? "";
 	const fullPrefix = cmdPath ? `${cmdPrefix}${cmdPath} ` : cmdPrefix;
 	for (const example of examples) {
-		lines.push(`  ${styles.dim(example.desc)}`);
+		lines.push(`  ${styles.dim(example.desc).split("\n").join("\n  ")}`);
 		lines.push(`    ${styles.dim("$")} ${fullPrefix}${example.cmd}`);
 		if (example.output) for (const line of example.output.split("\n")) lines.push(`    ${line}`);
 		lines.push("");

package/dist/runner-MMjpKeEa.js

@@ -0,0 +1,3 @@
+import { n as runMain, t as runCommand } from "./runner-DAGvxV2P.js";
+
+export { runCommand };

package/dist/{src-zNS0DTqZ.js → src-CLogLsbS.js}

@@ -1,12 +1,12 @@
 import { i as toKebabCase, r as toCamelCase } from "./field-meta-DMy5BcRr.js";
 import { t as arg } from "./register-DlGnMLIY.js";
 import { r as getUnknownKeysMode, t as extractFields } from "./schema-extractor-DMSozq40.js";
-import { n as createCompileCacheShimGenerator, t as runPolittyCli } from "./cli-main-Cdz55PLM.js";
+import { n as createCompileCacheShimGenerator, t as runPolittyCli } from "./cli-main-D4kkrRfX.js";
 import { n as defineCommand, t as createDefineCommand } from "./command-k-4yAz4J.js";
-import { C as ReservedFieldNameError, E as renderMarkdown, S as ReservedAliasError, T as renderInline, _ as DuplicateAliasError, a as parseArgv, b as FieldTypeConflictError, c as validateCommand, d as validateDuplicateFields, f as validateDuplicateNegations, g as CaseVariantCollisionError, h as validateReservedFieldNames, i as formatValidationErrors, l as validateCrossSchemaCollisions, m as validateReservedAliases, n as runMain, o as formatCommandValidationErrors, p as validatePositionalConfig, r as createDualCaseProxy, s as validateCaseVariantCollisions, t as runCommand, u as validateDuplicateAliases, v as DuplicateFieldError, w as generateHelp, x as PositionalConfigError, y as DuplicateNegationError } from "./runner-UEbd9e-3.js";
+import { C as ReservedFieldNameError, E as renderMarkdown, S as ReservedAliasError, T as renderInline, _ as DuplicateAliasError, a as parseArgv, b as FieldTypeConflictError, c as validateCommand, d as validateDuplicateFields, f as validateDuplicateNegations, g as CaseVariantCollisionError, h as validateReservedFieldNames, i as formatValidationErrors, l as validateCrossSchemaCollisions, m as validateReservedAliases, n as runMain, o as formatCommandValidationErrors, p as validatePositionalConfig, r as createDualCaseProxy, s as validateCaseVariantCollisions, t as runCommand, u as validateDuplicateAliases, v as DuplicateFieldError, w as generateHelp, x as PositionalConfigError, y as DuplicateNegationError } from "./runner-DAGvxV2P.js";
 import { o as isLazyCommand, s as lazy } from "./subcommand-router-Cskpofdk.js";
 import { a as symbols, i as styles, n as logger, r as setColorEnabled, t as isColorEnabled } from "./logger-i_bb-Jhc.js";
 import { a as generateCompletion, p as generateBundledCompletionWorker, s as withCompletionCommand } from "./completion-DW5qVc3l.js";
-import "./src-DO4W2NcZ.js";
+import "./src-bYH2XCQ4.js";
 
 export { generateBundledCompletionWorker };

package/dist/src-bYH2XCQ4.js

@@ -0,0 +1,6 @@
+import "./cli-main-D4kkrRfX.js";
+import "./runner-DAGvxV2P.js";
+import "./logger-i_bb-Jhc.js";
+import "./completion-DW5qVc3l.js";
+
+export {  };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@politty/zod",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A lightweight CLI framework inspired by citty with zod v4 registry integration for type-safe metadata management",
   "keywords": [
     "argument-parser",
@@ -71,7 +71,7 @@
     }
   },
   "dependencies": {
-    "yaml": "^2.8.3"
+    "yaml": "^2.9.0"
   },
   "devDependencies": {
     "@types/node": "25.9.5",

package/dist/cli-main-B5mwyz8q.js

@@ -1,3 +0,0 @@
-import { t as runPolittyCli } from "./cli-main-Cdz55PLM.js";
-
-export { runPolittyCli };

package/dist/runner-DR5Lw7LX.js

@@ -1,3 +0,0 @@
-import { n as runMain, t as runCommand } from "./runner-UEbd9e-3.js";
-
-export { runCommand };

package/dist/src-DO4W2NcZ.js

@@ -1,6 +0,0 @@
-import "./cli-main-Cdz55PLM.js";
-import "./runner-UEbd9e-3.js";
-import "./logger-i_bb-Jhc.js";
-import "./completion-DW5qVc3l.js";
-
-export {  };