padrone 1.8.2 → 2.0.0

package/dist/output/primitives.mjs

@@ -0,0 +1,206 @@
+import { escapeHtml } from "./styling.mjs";
+//#region src/output/primitives.ts
+function stringifyCell(value) {
+	if (value === void 0 || value === null) return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean") return String(value);
+	return JSON.stringify(value);
+}
+function truncate(text, max) {
+	if (max <= 0 || text.length <= max) return text;
+	return max <= 1 ? "…" : `${text.slice(0, max - 1)}…`;
+}
+function padCell(text, width, alignment = "left") {
+	const pad = width - text.length;
+	if (pad <= 0) return text;
+	if (alignment === "right") return " ".repeat(pad) + text;
+	if (alignment === "center") {
+		const left = Math.floor(pad / 2);
+		return " ".repeat(left) + text + " ".repeat(pad - left);
+	}
+	return text + " ".repeat(pad);
+}
+function renderTable(data, options, ctx) {
+	if (data.length === 0) return "";
+	if (ctx.format === "json") return JSON.stringify(data, null, 2);
+	const columns = options?.columns ?? Object.keys(data[0]);
+	if (columns.length === 0) return "";
+	const headers = columns.map((col) => options?.headers?.[col] ?? col);
+	const maxCol = options?.maxColumnWidth;
+	const rows = data.map((row) => columns.map((col) => {
+		const text = stringifyCell(row[col]);
+		return maxCol ? truncate(text, maxCol) : text;
+	}));
+	const colWidths = columns.map((_, i) => {
+		const headerWidth = headers[i].length;
+		const maxCellWidth = rows.reduce((max, row) => Math.max(max, row[i].length), 0);
+		return Math.max(headerWidth, maxCellWidth);
+	});
+	const getAlign = (i) => options?.align?.[columns[i]] ?? "left";
+	if (ctx.format === "markdown") return renderTableMarkdown(headers, rows, colWidths, getAlign);
+	if (ctx.format === "html") return renderTableHtml(columns, headers, rows, data, getAlign);
+	return renderTableText(headers, rows, colWidths, getAlign, options?.border !== false, ctx);
+}
+function renderTableText(headers, rows, colWidths, getAlign, border, ctx) {
+	const { styler } = ctx;
+	const formatRow = (cells, style) => cells.map((cell, i) => {
+		const padded = padCell(cell, colWidths[i], getAlign(i));
+		return style ? style(padded) : padded;
+	});
+	if (border) {
+		const sep = ctx.styler.meta("─");
+		const divider = colWidths.map((w) => sep.repeat(w + 2)).join(styler.meta("┼"));
+		const row = (cells) => cells.map((c, i) => ` ${padCell(c, colWidths[i], getAlign(i))} `).join(styler.meta("│"));
+		const headerRow = row(headers.map((h) => styler.label(h)));
+		const dataRows = rows.map((r) => row(r.map((c) => styler.description(c))));
+		return [
+			headerRow,
+			styler.meta("─") + divider + styler.meta("─"),
+			...dataRows
+		].join("\n");
+	}
+	const headerCells = formatRow(headers, styler.label);
+	const dataCells = rows.map((r) => formatRow(r, styler.description));
+	const gap = "  ";
+	return [headerCells.join(gap), ...dataCells.map((r) => r.join(gap))].join("\n");
+}
+function renderTableMarkdown(headers, rows, colWidths, getAlign) {
+	return [
+		`| ${headers.map((h, i) => padCell(h, colWidths[i], "left")).join(" | ")} |`,
+		"| " + colWidths.map((w, i) => {
+			const a = getAlign(i);
+			const dashes = "─".repeat(Math.max(w, 3));
+			if (a === "center") return `:${dashes}:`;
+			if (a === "right") return `${dashes}:`;
+			return dashes;
+		}).join(" | ") + " |",
+		...rows.map((r) => `| ${r.map((c, i) => padCell(c, colWidths[i], "left")).join(" | ")} |`)
+	].join("\n");
+}
+function renderTableHtml(columns, headers, _rows, data, getAlign) {
+	const ths = headers.map((h, i) => {
+		const a = getAlign(i);
+		return `<th${a !== "left" ? ` style="text-align: ${a};"` : ""}>${escapeHtml(h)}</th>`;
+	});
+	const trs = data.map((row) => "<tr>" + columns.map((col, i) => {
+		const a = getAlign(i);
+		return `<td${a !== "left" ? ` style="text-align: ${a};"` : ""}>${escapeHtml(stringifyCell(row[col]))}</td>`;
+	}).join("") + "</tr>");
+	return `<table><thead><tr>${ths.join("")}</tr></thead><tbody>${trs.join("")}</tbody></table>`;
+}
+function renderTree(data, options, ctx) {
+	const nodes = Array.isArray(data) ? data : [data];
+	if (nodes.length === 0) return "";
+	if (ctx.format === "json") return JSON.stringify(nodes, null, 2);
+	if (ctx.format === "markdown") return renderTreeMarkdown(nodes, 0);
+	if (ctx.format === "html") return renderTreeHtml(nodes);
+	return renderTreeText(nodes, "", options?.guides !== false, ctx).join("\n");
+}
+function renderTreeText(nodes, prefix, guides, ctx) {
+	const lines = [];
+	for (let i = 0; i < nodes.length; i++) {
+		const node = nodes[i];
+		const isLast = i === nodes.length - 1;
+		if (guides) {
+			const connector = isLast ? "└── " : "├── ";
+			const childPrefix = isLast ? "    " : "│   ";
+			lines.push(prefix + ctx.styler.meta(connector) + ctx.styler.label(node.label));
+			if (node.children?.length) lines.push(...renderTreeText(node.children, prefix + ctx.styler.meta(childPrefix), guides, ctx));
+		} else {
+			const indent = prefix ? `${prefix}  ` : "";
+			lines.push(indent + ctx.styler.label(node.label));
+			if (node.children?.length) lines.push(...renderTreeText(node.children, indent, guides, ctx));
+		}
+	}
+	return lines;
+}
+function renderTreeMarkdown(nodes, depth) {
+	return nodes.map((node) => {
+		const line = `${"  ".repeat(depth)}- ${node.label}`;
+		if (!node.children?.length) return line;
+		return `${line}\n${renderTreeMarkdown(node.children, depth + 1)}`;
+	}).join("\n");
+}
+function renderTreeHtml(nodes) {
+	return `<ul>${nodes.map((node) => {
+		const label = escapeHtml(node.label);
+		if (!node.children?.length) return `<li>${label}</li>`;
+		return `<li>${label}${renderTreeHtml(node.children)}</li>`;
+	}).join("")}</ul>`;
+}
+function renderList(data, options, ctx) {
+	if (data.length === 0) return "";
+	if (ctx.format === "json") {
+		const normalized = data.map((item) => typeof item === "string" ? { label: item } : item);
+		return JSON.stringify(normalized, null, 2);
+	}
+	if (ctx.format === "markdown") return renderListMarkdown(data, options);
+	if (ctx.format === "html") return renderListHtml(data, options);
+	return renderListText(data, options, ctx);
+}
+function renderListText(data, options, ctx) {
+	const { styler } = ctx;
+	const numbered = options?.numbered ?? false;
+	const bullet = options?.bullet ?? (ctx.format === "ansi" ? "•" : "-");
+	const baseIndent = "  ".repeat(options?.indent ?? 0);
+	return data.map((item, i) => {
+		const prefix = numbered ? `${i + 1}.` : bullet;
+		const label = typeof item === "string" ? item : item.label;
+		const desc = typeof item === "object" && item.description ? item.description : void 0;
+		const line = `${baseIndent}${styler.meta(prefix)} ${styler.label(label)}`;
+		if (!desc) return line;
+		return `${line}  ${styler.description(desc)}`;
+	}).join("\n");
+}
+function renderListMarkdown(data, options) {
+	const numbered = options?.numbered ?? false;
+	return data.map((item, i) => {
+		const prefix = numbered ? `${i + 1}.` : "-";
+		const label = typeof item === "string" ? item : item.label;
+		const desc = typeof item === "object" && item.description ? item.description : void 0;
+		if (!desc) return `${prefix} ${label}`;
+		return `${prefix} **${label}** — ${desc}`;
+	}).join("\n");
+}
+function renderListHtml(data, options) {
+	const tag = options?.numbered ? "ol" : "ul";
+	return `<${tag}>${data.map((item) => {
+		const label = typeof item === "string" ? item : item.label;
+		const desc = typeof item === "object" && item.description ? item.description : void 0;
+		if (!desc) return `<li>${escapeHtml(label)}</li>`;
+		return `<li><strong>${escapeHtml(label)}</strong> — ${escapeHtml(desc)}</li>`;
+	}).join("")}</${tag}>`;
+}
+function renderKeyValue(data, options, ctx) {
+	const entries = Object.entries(data);
+	if (entries.length === 0) return "";
+	if (ctx.format === "json") return JSON.stringify(data, null, 2);
+	if (ctx.format === "markdown") return renderKeyValueMarkdown(entries, options);
+	if (ctx.format === "html") return renderKeyValueHtml(entries, options);
+	return renderKeyValueText(entries, options, ctx);
+}
+function getLabel(key, labels) {
+	return labels?.[key] ?? key;
+}
+function renderKeyValueText(entries, options, ctx) {
+	const { styler } = ctx;
+	const sep = options?.separator ?? ": ";
+	const shouldAlign = options?.align !== false;
+	const displayLabels = entries.map(([k]) => getLabel(k, options?.labels));
+	const maxWidth = shouldAlign ? Math.max(...displayLabels.map((l) => l.length)) : 0;
+	return entries.map(([_key, value], i) => {
+		const label = displayLabels[i];
+		const paddedLabel = shouldAlign ? label + " ".repeat(maxWidth - label.length) : label;
+		return `${styler.label(paddedLabel)}${styler.meta(sep)}${styler.description(stringifyCell(value))}`;
+	}).join("\n");
+}
+function renderKeyValueMarkdown(entries, options) {
+	return entries.map(([key, value]) => `- **${getLabel(key, options?.labels)}**: ${stringifyCell(value)}`).join("\n");
+}
+function renderKeyValueHtml(entries, options) {
+	return `<dl>${entries.map(([key, value]) => `<dt>${escapeHtml(getLabel(key, options?.labels))}</dt><dd>${escapeHtml(stringifyCell(value))}</dd>`).join("")}</dl>`;
+}
+//#endregion
+export { renderKeyValue, renderList, renderTable, renderTree };
+
+//# sourceMappingURL=primitives.mjs.map

package/dist/output/primitives.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.mjs","names":[],"sources":["../../src/output/primitives.ts"],"sourcesContent":["import { escapeHtml, type OutputContext } from './styling.ts';\n\n// ── Table ───────────────────────────────────────────────────────────────\n\nexport type TableOptions = {\n  /** Explicit column keys to display (default: infer from first row's keys). */\n  columns?: string[];\n  /** Column key → display header name mapping. */\n  headers?: Record<string, string>;\n  /** Column key → text alignment. */\n  align?: Record<string, 'left' | 'right' | 'center'>;\n  /** Maximum column width before truncation. */\n  maxColumnWidth?: number;\n  /** Show borders (default: true for ansi/text, false for others). */\n  border?: boolean;\n};\n\nfunction stringifyCell(value: unknown): string {\n  if (value === undefined || value === null) return '';\n  if (typeof value === 'string') return value;\n  if (typeof value === 'number' || typeof value === 'boolean') return String(value);\n  return JSON.stringify(value);\n}\n\nfunction truncate(text: string, max: number): string {\n  if (max <= 0 || text.length <= max) return text;\n  return max <= 1 ? '…' : `${text.slice(0, max - 1)}…`;\n}\n\nfunction padCell(text: string, width: number, alignment: 'left' | 'right' | 'center' = 'left'): string {\n  const pad = width - text.length;\n  if (pad <= 0) return text;\n  if (alignment === 'right') return ' '.repeat(pad) + text;\n  if (alignment === 'center') {\n    const left = Math.floor(pad / 2);\n    return ' '.repeat(left) + text + ' '.repeat(pad - left);\n  }\n  return text + ' '.repeat(pad);\n}\n\nexport function renderTable(data: Record<string, unknown>[], options: TableOptions | undefined, ctx: OutputContext): string {\n  if (data.length === 0) return '';\n  if (ctx.format === 'json') return JSON.stringify(data, null, 2);\n\n  const columns = options?.columns ?? Object.keys(data[0]!);\n  if (columns.length === 0) return '';\n\n  const headers = columns.map((col) => options?.headers?.[col] ?? col);\n  const maxCol = options?.maxColumnWidth;\n\n  const rows = data.map((row) =>\n    columns.map((col) => {\n      const text = stringifyCell(row[col]);\n      return maxCol ? truncate(text, maxCol) : text;\n    }),\n  );\n\n  const colWidths = columns.map((_, i) => {\n    const headerWidth = headers[i]!.length;\n    const maxCellWidth = rows.reduce((max, row) => Math.max(max, row[i]!.length), 0);\n    return Math.max(headerWidth, maxCellWidth);\n  });\n\n  const getAlign = (i: number): 'left' | 'right' | 'center' => options?.align?.[columns[i]!] ?? 'left';\n\n  if (ctx.format === 'markdown') return renderTableMarkdown(headers, rows, colWidths, getAlign);\n  if (ctx.format === 'html') return renderTableHtml(columns, headers, rows, data, getAlign);\n  return renderTableText(headers, rows, colWidths, getAlign, options?.border !== false, ctx);\n}\n\nfunction renderTableText(\n  headers: string[],\n  rows: string[][],\n  colWidths: number[],\n  getAlign: (i: number) => 'left' | 'right' | 'center',\n  border: boolean,\n  ctx: OutputContext,\n): string {\n  const { styler } = ctx;\n  const formatRow = (cells: string[], style?: (s: string) => string) =>\n    cells.map((cell, i) => {\n      const padded = padCell(cell, colWidths[i]!, getAlign(i));\n      return style ? style(padded) : padded;\n    });\n\n  if (border) {\n    const sep = ctx.styler.meta('─');\n    const divider = colWidths.map((w) => sep.repeat(w + 2)).join(styler.meta('┼'));\n    const row = (cells: string[]) => cells.map((c, i) => ` ${padCell(c, colWidths[i]!, getAlign(i))} `).join(styler.meta('│'));\n    const headerRow = row(headers.map((h) => styler.label(h)));\n    const dataRows = rows.map((r) => row(r.map((c) => styler.description(c))));\n    return [headerRow, styler.meta('─') + divider + styler.meta('─'), ...dataRows].join('\\n');\n  }\n\n  const headerCells = formatRow(headers, styler.label);\n  const dataCells = rows.map((r) => formatRow(r, styler.description));\n  const gap = '  ';\n  return [headerCells.join(gap), ...dataCells.map((r) => r.join(gap))].join('\\n');\n}\n\nfunction renderTableMarkdown(\n  headers: string[],\n  rows: string[][],\n  colWidths: number[],\n  getAlign: (i: number) => 'left' | 'right' | 'center',\n): string {\n  const headerLine = `| ${headers.map((h, i) => padCell(h, colWidths[i]!, 'left')).join(' | ')} |`;\n  const separatorLine =\n    '| ' +\n    colWidths\n      .map((w, i) => {\n        const a = getAlign(i);\n        const dashes = '─'.repeat(Math.max(w, 3));\n        if (a === 'center') return `:${dashes}:`;\n        if (a === 'right') return `${dashes}:`;\n        return dashes;\n      })\n      .join(' | ') +\n    ' |';\n  const dataLines = rows.map((r) => `| ${r.map((c, i) => padCell(c, colWidths[i]!, 'left')).join(' | ')} |`);\n  return [headerLine, separatorLine, ...dataLines].join('\\n');\n}\n\nfunction renderTableHtml(\n  columns: string[],\n  headers: string[],\n  _rows: string[][],\n  data: Record<string, unknown>[],\n  getAlign: (i: number) => 'left' | 'right' | 'center',\n): string {\n  const ths = headers.map((h, i) => {\n    const a = getAlign(i);\n    const style = a !== 'left' ? ` style=\"text-align: ${a};\"` : '';\n    return `<th${style}>${escapeHtml(h)}</th>`;\n  });\n  const trs = data.map(\n    (row) =>\n      '<tr>' +\n      columns\n        .map((col, i) => {\n          const a = getAlign(i);\n          const style = a !== 'left' ? ` style=\"text-align: ${a};\"` : '';\n          return `<td${style}>${escapeHtml(stringifyCell(row[col]))}</td>`;\n        })\n        .join('') +\n      '</tr>',\n  );\n  return `<table><thead><tr>${ths.join('')}</tr></thead><tbody>${trs.join('')}</tbody></table>`;\n}\n\n// ── Tree ────────────────────────────────────────────────────────────────\n\nexport type TreeNode = {\n  label: string;\n  children?: TreeNode[];\n};\n\nexport type TreeOptions = {\n  /** Characters per indent level (default: 2). */\n  indent?: number;\n  /** Show tree guide lines (default: true for ansi/text). */\n  guides?: boolean;\n};\n\nexport function renderTree(data: TreeNode | TreeNode[], options: TreeOptions | undefined, ctx: OutputContext): string {\n  const nodes = Array.isArray(data) ? data : [data];\n  if (nodes.length === 0) return '';\n  if (ctx.format === 'json') return JSON.stringify(nodes, null, 2);\n  if (ctx.format === 'markdown') return renderTreeMarkdown(nodes, 0);\n  if (ctx.format === 'html') return renderTreeHtml(nodes);\n\n  const guides = options?.guides !== false;\n  return renderTreeText(nodes, '', guides, ctx).join('\\n');\n}\n\nfunction renderTreeText(nodes: TreeNode[], prefix: string, guides: boolean, ctx: OutputContext): string[] {\n  const lines: string[] = [];\n  for (let i = 0; i < nodes.length; i++) {\n    const node = nodes[i]!;\n    const isLast = i === nodes.length - 1;\n    if (guides) {\n      const connector = isLast ? '└── ' : '├── ';\n      const childPrefix = isLast ? '    ' : '│   ';\n      lines.push(prefix + ctx.styler.meta(connector) + ctx.styler.label(node.label));\n      if (node.children?.length) lines.push(...renderTreeText(node.children, prefix + ctx.styler.meta(childPrefix), guides, ctx));\n    } else {\n      const indent = prefix ? `${prefix}  ` : '';\n      lines.push(indent + ctx.styler.label(node.label));\n      if (node.children?.length) lines.push(...renderTreeText(node.children, indent, guides, ctx));\n    }\n  }\n  return lines;\n}\n\nfunction renderTreeMarkdown(nodes: TreeNode[], depth: number): string {\n  return nodes\n    .map((node) => {\n      const indent = '  '.repeat(depth);\n      const line = `${indent}- ${node.label}`;\n      if (!node.children?.length) return line;\n      return `${line}\\n${renderTreeMarkdown(node.children, depth + 1)}`;\n    })\n    .join('\\n');\n}\n\nfunction renderTreeHtml(nodes: TreeNode[]): string {\n  const items = nodes\n    .map((node) => {\n      const label = escapeHtml(node.label);\n      if (!node.children?.length) return `<li>${label}</li>`;\n      return `<li>${label}${renderTreeHtml(node.children)}</li>`;\n    })\n    .join('');\n  return `<ul>${items}</ul>`;\n}\n\n// ── List ────────────────────────────────────────────────────────────────\n\nexport type ListItem = string | { label: string; description?: string };\n\nexport type ListOptions = {\n  /** Bullet character (default: '•' for ansi, '-' for text). */\n  bullet?: string;\n  /** Use numbered list instead of bullets. */\n  numbered?: boolean;\n  /** Indent level (default: 0). */\n  indent?: number;\n};\n\nexport function renderList(data: ListItem[], options: ListOptions | undefined, ctx: OutputContext): string {\n  if (data.length === 0) return '';\n  if (ctx.format === 'json') {\n    const normalized = data.map((item) => (typeof item === 'string' ? { label: item } : item));\n    return JSON.stringify(normalized, null, 2);\n  }\n  if (ctx.format === 'markdown') return renderListMarkdown(data, options);\n  if (ctx.format === 'html') return renderListHtml(data, options);\n  return renderListText(data, options, ctx);\n}\n\nfunction renderListText(data: ListItem[], options: ListOptions | undefined, ctx: OutputContext): string {\n  const { styler } = ctx;\n  const numbered = options?.numbered ?? false;\n  const bullet = options?.bullet ?? (ctx.format === 'ansi' ? '•' : '-');\n  const baseIndent = '  '.repeat(options?.indent ?? 0);\n\n  return data\n    .map((item, i) => {\n      const prefix = numbered ? `${i + 1}.` : bullet;\n      const label = typeof item === 'string' ? item : item.label;\n      const desc = typeof item === 'object' && item.description ? item.description : undefined;\n      const line = `${baseIndent}${styler.meta(prefix)} ${styler.label(label)}`;\n      if (!desc) return line;\n      return `${line}  ${styler.description(desc)}`;\n    })\n    .join('\\n');\n}\n\nfunction renderListMarkdown(data: ListItem[], options: ListOptions | undefined): string {\n  const numbered = options?.numbered ?? false;\n  return data\n    .map((item, i) => {\n      const prefix = numbered ? `${i + 1}.` : '-';\n      const label = typeof item === 'string' ? item : item.label;\n      const desc = typeof item === 'object' && item.description ? item.description : undefined;\n      if (!desc) return `${prefix} ${label}`;\n      return `${prefix} **${label}** — ${desc}`;\n    })\n    .join('\\n');\n}\n\nfunction renderListHtml(data: ListItem[], options: ListOptions | undefined): string {\n  const tag = options?.numbered ? 'ol' : 'ul';\n  const items = data\n    .map((item) => {\n      const label = typeof item === 'string' ? item : item.label;\n      const desc = typeof item === 'object' && item.description ? item.description : undefined;\n      if (!desc) return `<li>${escapeHtml(label)}</li>`;\n      return `<li><strong>${escapeHtml(label)}</strong> — ${escapeHtml(desc)}</li>`;\n    })\n    .join('');\n  return `<${tag}>${items}</${tag}>`;\n}\n\n// ── Key-Value ───────────────────────────────────────────────────────────\n\nexport type KeyValueOptions = {\n  /** Separator between key and value (default: ': '). */\n  separator?: string;\n  /** Align values by padding keys to the same width. */\n  align?: boolean;\n  /** Key → display label mapping. */\n  labels?: Record<string, string>;\n};\n\nexport function renderKeyValue(data: Record<string, unknown>, options: KeyValueOptions | undefined, ctx: OutputContext): string {\n  const entries = Object.entries(data);\n  if (entries.length === 0) return '';\n  if (ctx.format === 'json') return JSON.stringify(data, null, 2);\n  if (ctx.format === 'markdown') return renderKeyValueMarkdown(entries, options);\n  if (ctx.format === 'html') return renderKeyValueHtml(entries, options);\n  return renderKeyValueText(entries, options, ctx);\n}\n\nfunction getLabel(key: string, labels?: Record<string, string>): string {\n  return labels?.[key] ?? key;\n}\n\nfunction renderKeyValueText(entries: [string, unknown][], options: KeyValueOptions | undefined, ctx: OutputContext): string {\n  const { styler } = ctx;\n  const sep = options?.separator ?? ': ';\n  const shouldAlign = options?.align !== false;\n\n  const displayLabels = entries.map(([k]) => getLabel(k, options?.labels));\n  const maxWidth = shouldAlign ? Math.max(...displayLabels.map((l) => l.length)) : 0;\n\n  return entries\n    .map(([_key, value], i) => {\n      const label = displayLabels[i]!;\n      const paddedLabel = shouldAlign ? label + ' '.repeat(maxWidth - label.length) : label;\n      return `${styler.label(paddedLabel)}${styler.meta(sep)}${styler.description(stringifyCell(value))}`;\n    })\n    .join('\\n');\n}\n\nfunction renderKeyValueMarkdown(entries: [string, unknown][], options: KeyValueOptions | undefined): string {\n  return entries.map(([key, value]) => `- **${getLabel(key, options?.labels)}**: ${stringifyCell(value)}`).join('\\n');\n}\n\nfunction renderKeyValueHtml(entries: [string, unknown][], options: KeyValueOptions | undefined): string {\n  const items = entries\n    .map(([key, value]) => `<dt>${escapeHtml(getLabel(key, options?.labels))}</dt><dd>${escapeHtml(stringifyCell(value))}</dd>`)\n    .join('');\n  return `<dl>${items}</dl>`;\n}\n"],"mappings":"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"}

package/dist/output/styling.d.mts

@@ -0,0 +1,38 @@
+//#region src/output/styling.d.ts
+/**
+ * Styling functions for semantic text roles.
+ * Used by formatters to apply visual styles (ANSI, HTML, Markdown, etc.)
+ * to different types of content.
+ */
+type Styler = {
+  command: (text: string) => string;
+  arg: (text: string) => string;
+  type: (text: string) => string;
+  description: (text: string) => string;
+  label: (text: string) => string;
+  section: (text: string) => string;
+  meta: (text: string) => string;
+  example: (text: string) => string;
+  exampleValue: (text: string) => string;
+  deprecated: (text: string) => string;
+};
+/**
+ * Layout configuration for formatters.
+ */
+type LayoutConfig = {
+  newline: string;
+  indent: (level: number) => string;
+  join: (parts: string[]) => string;
+  wrapDocument?: (content: string) => string;
+};
+/** Resolved formatting context used by output primitives. */
+type OutputFormat = 'text' | 'ansi' | 'json' | 'markdown' | 'html';
+type OutputContext = {
+  format: OutputFormat;
+  styler: Styler;
+  layout: LayoutConfig;
+  terminalWidth?: number;
+};
+//#endregion
+export { LayoutConfig, OutputContext, OutputFormat, Styler };
+//# sourceMappingURL=styling.d.mts.map

package/dist/output/styling.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styling.d.mts","names":[],"sources":["../../src/output/styling.ts"],"mappings":";;;;;;KAiCY,MAAA;EACV,OAAA,GAAU,IAAA;EACV,GAAA,GAAM,IAAA;EACN,IAAA,GAAO,IAAA;EACP,WAAA,GAAc,IAAA;EACd,KAAA,GAAQ,IAAA;EACR,OAAA,GAAU,IAAA;EACV,IAAA,GAAO,IAAA;EACP,OAAA,GAAU,IAAA;EACV,YAAA,GAAe,IAAA;EACf,UAAA,GAAa,IAAA;AAAA;;;;KAMH,YAAA;EACV,OAAA;EACA,MAAA,GAAS,KAAA;EACT,IAAA,GAAO,KAAA;EACP,YAAA,IAAgB,OAAA;AAAA;;KAiHN,YAAA;AAAA,KAEA,aAAA;EACV,MAAA,EAAQ,YAAA;EACR,MAAA,EAAQ,MAAA;EACR,MAAA,EAAQ,YAAA;EACR,aAAA;AAAA"}

package/dist/output/styling.mjs

@@ -0,0 +1,146 @@
+import { createColorizer } from "./colorizer.mjs";
+function wrapText(text, maxWidth) {
+	if (maxWidth <= 0 || text.length <= maxWidth) return [text];
+	const words = text.split(" ");
+	const lines = [];
+	let current = "";
+	for (const word of words) if (current && current.length + 1 + word.length > maxWidth) {
+		lines.push(current);
+		current = word;
+	} else current = current ? `${current} ${word}` : word;
+	if (current) lines.push(current);
+	return lines.length > 0 ? lines : [text];
+}
+function escapeHtml(text) {
+	return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
+}
+function createTextStyler() {
+	return {
+		command: (text) => text,
+		arg: (text) => text,
+		type: (text) => text,
+		description: (text) => text,
+		label: (text) => text,
+		section: (text) => text,
+		meta: (text) => text,
+		example: (text) => text,
+		exampleValue: (text) => text,
+		deprecated: (text) => text
+	};
+}
+function createAnsiStyler(theme) {
+	const colorizer = createColorizer(theme);
+	return {
+		command: colorizer.command,
+		arg: colorizer.arg,
+		type: colorizer.type,
+		description: colorizer.description,
+		label: colorizer.label,
+		section: colorizer.label,
+		meta: colorizer.meta,
+		example: colorizer.example,
+		exampleValue: colorizer.exampleValue,
+		deprecated: colorizer.deprecated
+	};
+}
+function createConsoleStyler(theme) {
+	return createAnsiStyler(theme);
+}
+function createMarkdownStyler() {
+	return {
+		command: (text) => `**${text}**`,
+		arg: (text) => `\`${text}\``,
+		type: (text) => `\`${text}\``,
+		description: (text) => text,
+		label: (text) => `**${text}**`,
+		section: (text) => `### ${text}`,
+		meta: (text) => `*${text}*`,
+		example: (text) => `**${text}**`,
+		exampleValue: (text) => `\`${text}\``,
+		deprecated: (text) => `~~${text}~~`
+	};
+}
+function createHtmlStyler() {
+	return {
+		command: (text) => `<strong style="color: #00bcd4;">${escapeHtml(text)}</strong>`,
+		arg: (text) => `<code style="color: #4caf50;">${escapeHtml(text)}</code>`,
+		type: (text) => `<code style="color: #ff9800;">${escapeHtml(text)}</code>`,
+		description: (text) => `<span style="color: #666;">${escapeHtml(text)}</span>`,
+		label: (text) => `<strong>${escapeHtml(text)}</strong>`,
+		section: (text) => `<h3>${escapeHtml(text)}</h3>`,
+		meta: (text) => `<span style="color: #999;">${escapeHtml(text)}</span>`,
+		example: (text) => `<strong style="text-decoration: underline;">${escapeHtml(text)}</strong>`,
+		exampleValue: (text) => `<em>${escapeHtml(text)}</em>`,
+		deprecated: (text) => `<del style="color: #999;">${escapeHtml(text)}</del>`
+	};
+}
+function createTextLayout() {
+	return {
+		newline: "\n",
+		indent: (level) => "  ".repeat(level),
+		join: (parts) => parts.filter(Boolean).join(" ")
+	};
+}
+function createMarkdownLayout() {
+	return {
+		newline: "\n\n",
+		indent: (level) => {
+			if (level === 0) return "";
+			if (level === 1) return "  ";
+			return "    ";
+		},
+		join: (parts) => parts.filter(Boolean).join(" ")
+	};
+}
+function createHtmlLayout() {
+	return {
+		newline: "<br>",
+		indent: (level) => "&nbsp;&nbsp;".repeat(level),
+		join: (parts) => parts.filter(Boolean).join(" "),
+		wrapDocument: (content) => `<div style="font-family: monospace; line-height: 1.6;">${content}</div>`
+	};
+}
+function shouldUseAnsi(env, isTTY) {
+	if (env?.NO_COLOR) return false;
+	if (env?.CI) return false;
+	if (typeof isTTY === "boolean") return isTTY;
+	return false;
+}
+/** Resolve the output format from the runtime and caller context. */
+function resolveOutputFormat(runtime, caller) {
+	let format;
+	if (caller === "serve" || caller === "mcp" || caller === "tool") format = "json";
+	else if (runtime.format && runtime.format !== "auto" && runtime.format !== "console") format = runtime.format;
+	else format = shouldUseAnsi(runtime.env(), runtime.terminal?.isTTY) ? "ansi" : "text";
+	const terminalWidth = format === "markdown" || format === "html" ? void 0 : runtime.terminal?.columns ?? 80;
+	let styler;
+	let layout;
+	switch (format) {
+		case "ansi":
+			styler = createAnsiStyler(runtime.theme);
+			layout = createTextLayout();
+			break;
+		case "markdown":
+			styler = createMarkdownStyler();
+			layout = createMarkdownLayout();
+			break;
+		case "html":
+			styler = createHtmlStyler();
+			layout = createHtmlLayout();
+			break;
+		default:
+			styler = createTextStyler();
+			layout = createTextLayout();
+			break;
+	}
+	return {
+		format,
+		styler,
+		layout,
+		terminalWidth
+	};
+}
+//#endregion
+export { createAnsiStyler, createConsoleStyler, createHtmlLayout, createHtmlStyler, createMarkdownLayout, createMarkdownStyler, createTextLayout, createTextStyler, escapeHtml, resolveOutputFormat, shouldUseAnsi, wrapText };
+
+//# sourceMappingURL=styling.mjs.map

package/dist/output/styling.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"styling.mjs","names":[],"sources":["../../src/output/styling.ts"],"sourcesContent":["import type { PadroneActionContext } from '../types/index.ts';\nimport { type ColorConfig, type ColorTheme, createColorizer } from './colorizer.ts';\n\nexport const DEFAULT_TERMINAL_WIDTH = 80;\n\nexport function wrapText(text: string, maxWidth: number): string[] {\n  if (maxWidth <= 0 || text.length <= maxWidth) return [text];\n  const words = text.split(' ');\n  const lines: string[] = [];\n  let current = '';\n  for (const word of words) {\n    if (current && current.length + 1 + word.length > maxWidth) {\n      lines.push(current);\n      current = word;\n    } else {\n      current = current ? `${current} ${word}` : word;\n    }\n  }\n  if (current) lines.push(current);\n  return lines.length > 0 ? lines : [text];\n}\n\nexport function escapeHtml(text: string): string {\n  return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/\"/g, '&quot;').replace(/'/g, '&#039;');\n}\n\n// ── Styler ──────────────────────────────────────────────────────────────\n\n/**\n * Styling functions for semantic text roles.\n * Used by formatters to apply visual styles (ANSI, HTML, Markdown, etc.)\n * to different types of content.\n */\nexport type Styler = {\n  command: (text: string) => string;\n  arg: (text: string) => string;\n  type: (text: string) => string;\n  description: (text: string) => string;\n  label: (text: string) => string;\n  section: (text: string) => string;\n  meta: (text: string) => string;\n  example: (text: string) => string;\n  exampleValue: (text: string) => string;\n  deprecated: (text: string) => string;\n};\n\n/**\n * Layout configuration for formatters.\n */\nexport type LayoutConfig = {\n  newline: string;\n  indent: (level: number) => string;\n  join: (parts: string[]) => string;\n  wrapDocument?: (content: string) => string;\n};\n\n// ── Styler Factories ────────────────────────────────────────────────────\n\nexport function createTextStyler(): Styler {\n  return {\n    command: (text) => text,\n    arg: (text) => text,\n    type: (text) => text,\n    description: (text) => text,\n    label: (text) => text,\n    section: (text) => text,\n    meta: (text) => text,\n    example: (text) => text,\n    exampleValue: (text) => text,\n    deprecated: (text) => text,\n  };\n}\n\nexport function createAnsiStyler(theme?: ColorTheme | ColorConfig): Styler {\n  const colorizer = createColorizer(theme);\n  return {\n    command: colorizer.command,\n    arg: colorizer.arg,\n    type: colorizer.type,\n    description: colorizer.description,\n    label: colorizer.label,\n    section: colorizer.label,\n    meta: colorizer.meta,\n    example: colorizer.example,\n    exampleValue: colorizer.exampleValue,\n    deprecated: colorizer.deprecated,\n  };\n}\n\nexport function createConsoleStyler(theme?: ColorTheme | ColorConfig): Styler {\n  return createAnsiStyler(theme);\n}\n\nexport function createMarkdownStyler(): Styler {\n  return {\n    command: (text) => `**${text}**`,\n    arg: (text) => `\\`${text}\\``,\n    type: (text) => `\\`${text}\\``,\n    description: (text) => text,\n    label: (text) => `**${text}**`,\n    section: (text) => `### ${text}`,\n    meta: (text) => `*${text}*`,\n    example: (text) => `**${text}**`,\n    exampleValue: (text) => `\\`${text}\\``,\n    deprecated: (text) => `~~${text}~~`,\n  };\n}\n\nexport function createHtmlStyler(): Styler {\n  return {\n    command: (text) => `<strong style=\"color: #00bcd4;\">${escapeHtml(text)}</strong>`,\n    arg: (text) => `<code style=\"color: #4caf50;\">${escapeHtml(text)}</code>`,\n    type: (text) => `<code style=\"color: #ff9800;\">${escapeHtml(text)}</code>`,\n    description: (text) => `<span style=\"color: #666;\">${escapeHtml(text)}</span>`,\n    label: (text) => `<strong>${escapeHtml(text)}</strong>`,\n    section: (text) => `<h3>${escapeHtml(text)}</h3>`,\n    meta: (text) => `<span style=\"color: #999;\">${escapeHtml(text)}</span>`,\n    example: (text) => `<strong style=\"text-decoration: underline;\">${escapeHtml(text)}</strong>`,\n    exampleValue: (text) => `<em>${escapeHtml(text)}</em>`,\n    deprecated: (text) => `<del style=\"color: #999;\">${escapeHtml(text)}</del>`,\n  };\n}\n\n// ── Layout Factories ────────────────────────────────────────────────────\n\nexport function createTextLayout(): LayoutConfig {\n  return {\n    newline: '\\n',\n    indent: (level) => '  '.repeat(level),\n    join: (parts) => parts.filter(Boolean).join(' '),\n  };\n}\n\nexport function createMarkdownLayout(): LayoutConfig {\n  return {\n    newline: '\\n\\n',\n    indent: (level) => {\n      if (level === 0) return '';\n      if (level === 1) return '  ';\n      return '    ';\n    },\n    join: (parts) => parts.filter(Boolean).join(' '),\n  };\n}\n\nexport function createHtmlLayout(): LayoutConfig {\n  return {\n    newline: '<br>',\n    indent: (level) => '&nbsp;&nbsp;'.repeat(level),\n    join: (parts) => parts.filter(Boolean).join(' '),\n    wrapDocument: (content) => `<div style=\"font-family: monospace; line-height: 1.6;\">${content}</div>`,\n  };\n}\n\n// ── Format Detection ────────────────────────────────────────────────────\n\nexport function shouldUseAnsi(env?: Record<string, string | undefined>, isTTY?: boolean): boolean {\n  if (env?.NO_COLOR) return false;\n  if (env?.CI) return false;\n  if (typeof isTTY === 'boolean') return isTTY;\n  return false;\n}\n\n// ── Output Context ──────────────────────────────────────────────────────\n\n/** Resolved formatting context used by output primitives. */\nexport type OutputFormat = 'text' | 'ansi' | 'json' | 'markdown' | 'html';\n\nexport type OutputContext = {\n  format: OutputFormat;\n  styler: Styler;\n  layout: LayoutConfig;\n  terminalWidth?: number;\n};\n\n/** Resolve the output format from the runtime and caller context. */\nexport function resolveOutputFormat(\n  runtime: {\n    format?: string;\n    theme?: ColorTheme | ColorConfig;\n    terminal?: { columns?: number; isTTY?: boolean };\n    env: () => Record<string, string | undefined>;\n  },\n  caller?: PadroneActionContext['caller'],\n): OutputContext {\n  let format: OutputFormat;\n\n  if (caller === 'serve' || caller === 'mcp' || caller === 'tool') {\n    format = 'json';\n  } else if (runtime.format && runtime.format !== 'auto' && runtime.format !== 'console') {\n    format = runtime.format as OutputFormat;\n  } else {\n    format = shouldUseAnsi(runtime.env(), runtime.terminal?.isTTY) ? 'ansi' : 'text';\n  }\n\n  const terminalWidth = format === 'markdown' || format === 'html' ? undefined : (runtime.terminal?.columns ?? DEFAULT_TERMINAL_WIDTH);\n\n  let styler: Styler;\n  let layout: LayoutConfig;\n\n  switch (format) {\n    case 'ansi':\n      styler = createAnsiStyler(runtime.theme);\n      layout = createTextLayout();\n      break;\n    case 'markdown':\n      styler = createMarkdownStyler();\n      layout = createMarkdownLayout();\n      break;\n    case 'html':\n      styler = createHtmlStyler();\n      layout = createHtmlLayout();\n      break;\n    default:\n      styler = createTextStyler();\n      layout = createTextLayout();\n      break;\n  }\n\n  return { format, styler, layout, terminalWidth };\n}\n"],"mappings":"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"}

package/dist/schema/zod.d.mts

@@ -0,0 +1,6 @@
+import { PadroneFieldMeta } from "../types/args-meta.mjs";
+//#region src/schema/zod.d.ts
+declare module 'zod/v4/core' {
+  export interface GlobalMeta extends PadroneFieldMeta {}
+}
+//# sourceMappingURL=zod.d.mts.map

package/dist/schema/zod.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.mts","names":["GlobalMeta","PadroneFieldMeta"],"sources":["../../src/schema/zod.d.ts"],"mappings":";;;mBAGmBA,UAAAA,SAAmB,gBAAgB;AAAA"}

package/dist/schema/zod.mjs

@@ -0,0 +1,50 @@
+import { asyncStream } from "../util/stream.mjs";
+import * as z from "zod/v4";
+//#region src/schema/zod.ts
+/**
+* Creates a Zod schema for an async stream field, ready to use in `.arguments()`.
+* Wraps `z.custom<AsyncIterable<T>>()` with the `asyncStream()` metadata automatically.
+*
+* @param itemSchema - Optional item schema for per-item validation.
+*
+* @example
+* ```ts
+* import { zodAsyncStream } from 'padrone/zod';
+*
+* // String lines
+* z.object({ lines: zodAsyncStream() })
+*
+* // Typed items — each line JSON.parse'd and validated
+* const recordSchema = z.object({ name: z.string(), age: z.number() });
+* z.object({ records: zodAsyncStream(jsonCodec(recordSchema)) })
+* ```
+*/
+function zodAsyncStream(itemSchema) {
+	return z.custom().meta(asyncStream(itemSchema));
+}
+/**
+* JSON codec for Zod schemas
+* @see https://zod.dev/codecs?id=jsonschema
+* Unlike the example in the docs, this codec also handles the case where the input is already an object
+*/
+const jsonCodec = (schema) => z.codec(z.union([z.string(), z.unknown()]), schema, {
+	decode: (jsonString, ctx) => {
+		try {
+			if (typeof jsonString !== "string") return jsonString;
+			return JSON.parse(jsonString);
+		} catch (err) {
+			ctx.issues.push({
+				code: "invalid_format",
+				format: "json",
+				input: typeof jsonString === "string" ? jsonString : JSON.stringify(jsonString),
+				message: err.message
+			});
+			return z.NEVER;
+		}
+	},
+	encode: (value) => JSON.stringify(value)
+});
+//#endregion
+export { jsonCodec, zodAsyncStream };
+
+//# sourceMappingURL=zod.mjs.map

package/dist/schema/zod.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.mjs","names":[],"sources":["../../src/schema/zod.ts"],"sourcesContent":["import * as z from 'zod/v4';\nimport type { PadroneSchema } from '../types/index.ts';\nimport { asyncStream } from '../util/stream.ts';\n\n/**\n * Creates a Zod schema for an async stream field, ready to use in `.arguments()`.\n * Wraps `z.custom<AsyncIterable<T>>()` with the `asyncStream()` metadata automatically.\n *\n * @param itemSchema - Optional item schema for per-item validation.\n *\n * @example\n * ```ts\n * import { zodAsyncStream } from 'padrone/zod';\n *\n * // String lines\n * z.object({ lines: zodAsyncStream() })\n *\n * // Typed items — each line JSON.parse'd and validated\n * const recordSchema = z.object({ name: z.string(), age: z.number() });\n * z.object({ records: zodAsyncStream(jsonCodec(recordSchema)) })\n * ```\n */\nexport function zodAsyncStream<T = string>(itemSchema?: PadroneSchema<unknown, T>) {\n  return z.custom<AsyncIterable<T>>().meta(asyncStream(itemSchema));\n}\n\n/**\n * JSON codec for Zod schemas\n * @see https://zod.dev/codecs?id=jsonschema\n * Unlike the example in the docs, this codec also handles the case where the input is already an object\n */\nexport const jsonCodec = <T extends z.ZodType>(schema: T) =>\n  z.codec(z.union([z.string(), z.unknown()]), schema, {\n    decode: (jsonString, ctx) => {\n      try {\n        // HACK: in some cases the object is already deserialized, we just need to validate it\n        if (typeof jsonString !== 'string') return jsonString as z.input<T>;\n        return JSON.parse(jsonString) as z.input<T>;\n      } catch (err: any) {\n        ctx.issues.push({\n          code: 'invalid_format',\n          format: 'json',\n          input: typeof jsonString === 'string' ? jsonString : JSON.stringify(jsonString),\n          message: err.message,\n        });\n        return z.NEVER;\n      }\n    },\n    encode: (value) => JSON.stringify(value),\n  });\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,eAA2B,YAAwC;CACjF,OAAO,EAAE,OAAyB,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC;AAClE;;;;;;AAOA,MAAa,aAAkC,WAC7C,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC,GAAG,QAAQ;CAClD,SAAS,YAAY,QAAQ;EAC3B,IAAI;GAEF,IAAI,OAAO,eAAe,UAAU,OAAO;GAC3C,OAAO,KAAK,MAAM,UAAU;EAC9B,SAAS,KAAU;GACjB,IAAI,OAAO,KAAK;IACd,MAAM;IACN,QAAQ;IACR,OAAO,OAAO,eAAe,WAAW,aAAa,KAAK,UAAU,UAAU;IAC9E,SAAS,IAAI;GACf,CAAC;GACD,OAAO,EAAE;EACX;CACF;CACA,SAAS,UAAU,KAAK,UAAU,KAAK;AACzC,CAAC"}

package/dist/serve.d.mts

@@ -0,0 +1,2 @@
+import { WithServe, padroneServe } from "./extension/serve.mjs";
+export { type WithServe, padroneServe };

package/dist/serve.mjs

@@ -0,0 +1,2 @@
+import { padroneServe } from "./extension/serve.mjs";
+export { padroneServe };