@tuicomponents/progress 0.1.1

package/dist/index.cjs

@@ -0,0 +1,370 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ProgressComponent: () => ProgressComponent,
+  computeProgressLayout: () => computeProgressLayout,
+  createProgress: () => createProgress,
+  getProgressChars: () => getProgressChars,
+  progressInputSchema: () => progressInputSchema,
+  progressStyleSchema: () => progressStyleSchema,
+  renderProgressAnsi: () => renderProgressAnsi,
+  renderProgressMarkdown: () => renderProgressMarkdown
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/progress.ts
+var import_core2 = require("@tuicomponents/core");
+var import_zod_to_json_schema = require("zod-to-json-schema");
+
+// src/schema.ts
+var import_zod = require("zod");
+var progressStyleSchema = import_zod.z.enum([
+  "block",
+  "shaded",
+  "bracket",
+  "arrow",
+  "ascii"
+]);
+var progressInputSchema = import_zod.z.object({
+  /**
+   * Current progress value (0 or greater).
+   * Required unless indeterminate state is desired.
+   */
+  value: import_zod.z.number().nonnegative(),
+  /**
+   * Maximum value (determines 100%).
+   * @default 100
+   */
+  max: import_zod.z.number().positive().default(100),
+  /**
+   * Width of the progress bar in characters.
+   * @default 20
+   */
+  width: import_zod.z.number().int().positive().default(20),
+  /**
+   * Style for progress bar characters.
+   * @default "block"
+   */
+  style: progressStyleSchema.default("block"),
+  /**
+   * Custom filled character (overrides style default).
+   */
+  filledChar: import_zod.z.string().length(1).optional(),
+  /**
+   * Custom empty character (overrides style default).
+   */
+  emptyChar: import_zod.z.string().length(1).optional(),
+  /**
+   * Optional label to display before the progress bar.
+   */
+  label: import_zod.z.string().optional(),
+  /**
+   * Whether to show percentage after the bar.
+   * @default true
+   */
+  showPercentage: import_zod.z.boolean().default(true),
+  /**
+   * Whether to show the current/max value (e.g., "12/25").
+   * @default false
+   */
+  showValue: import_zod.z.boolean().default(false)
+});
+
+// src/chars.ts
+var blockChars = {
+  filled: "\u2588",
+  empty: "\u2591",
+  leftBracket: "",
+  rightBracket: ""
+};
+var shadedChars = {
+  filled: "\u2593",
+  empty: "\u2591",
+  leftBracket: "",
+  rightBracket: ""
+};
+var bracketChars = {
+  filled: "\u2588",
+  empty: "\u2591",
+  leftBracket: "[",
+  rightBracket: "]"
+};
+var arrowChars = {
+  filled: ">",
+  empty: "-",
+  leftBracket: "",
+  rightBracket: ""
+};
+var asciiChars = {
+  filled: "#",
+  empty: ".",
+  leftBracket: "",
+  rightBracket: ""
+};
+function getProgressChars(style) {
+  switch (style) {
+    case "block":
+      return blockChars;
+    case "shaded":
+      return shadedChars;
+    case "bracket":
+      return bracketChars;
+    case "arrow":
+      return arrowChars;
+    case "ascii":
+      return asciiChars;
+  }
+}
+
+// src/layout.ts
+function computeProgressLayout(input, chars) {
+  const rawPercentage = input.max > 0 ? input.value / input.max * 100 : 0;
+  const percentage = Math.min(100, Math.max(0, rawPercentage));
+  const barWidth = input.width;
+  const filledCount = Math.round(percentage / 100 * barWidth);
+  const emptyCount = barWidth - filledCount;
+  const filledChar = input.filledChar ?? chars.filled;
+  const emptyChar = input.emptyChar ?? chars.empty;
+  const filledBar = filledChar.repeat(filledCount);
+  const emptyBar = emptyChar.repeat(emptyCount);
+  const percentageStr = `${String(Math.round(percentage))}%`;
+  const valueStr = `${String(input.value)}/${String(input.max)}`;
+  return {
+    label: input.label ?? "",
+    filledBar,
+    emptyBar,
+    leftBracket: chars.leftBracket,
+    rightBracket: chars.rightBracket,
+    percentage,
+    percentageStr,
+    valueStr,
+    filledCount,
+    emptyCount,
+    barWidth
+  };
+}
+
+// src/renderers.ts
+var import_core = require("@tuicomponents/core");
+function renderProgressAnsi(layout, input, theme) {
+  const parts = [];
+  if (layout.label) {
+    const coloredLabel = theme ? theme.semantic.header(layout.label) : layout.label;
+    parts.push(coloredLabel);
+    parts.push(" ");
+  }
+  if (layout.leftBracket) {
+    const coloredBracket = theme ? theme.semantic.border(layout.leftBracket) : layout.leftBracket;
+    parts.push(coloredBracket);
+  }
+  const coloredFilled = theme ? theme.semantic.primary(layout.filledBar) : layout.filledBar;
+  const coloredEmpty = theme ? theme.semantic.secondary(layout.emptyBar) : layout.emptyBar;
+  parts.push(coloredFilled);
+  parts.push(coloredEmpty);
+  if (layout.rightBracket) {
+    const coloredBracket = theme ? theme.semantic.border(layout.rightBracket) : layout.rightBracket;
+    parts.push(coloredBracket);
+  }
+  const suffix = buildSuffix(layout, input, theme);
+  if (suffix) {
+    parts.push(" ");
+    parts.push(suffix);
+  }
+  return parts.join("");
+}
+function renderProgressMarkdown(layout, input) {
+  const parts = [];
+  if (layout.label) {
+    parts.push(layout.label);
+    parts.push(" ");
+  }
+  if (layout.leftBracket) {
+    parts.push(layout.leftBracket);
+  }
+  parts.push(layout.filledBar);
+  parts.push(layout.emptyBar);
+  if (layout.rightBracket) {
+    parts.push(layout.rightBracket);
+  }
+  const suffix = buildSuffix(layout, input);
+  if (suffix) {
+    parts.push(" ");
+    parts.push(suffix);
+  }
+  return (0, import_core.anchorLine)(parts.join(""), import_core.DEFAULT_ANCHOR);
+}
+function buildSuffix(layout, input, theme) {
+  const suffixParts = [];
+  if (input.showPercentage) {
+    suffixParts.push(layout.percentageStr);
+  }
+  if (input.showValue) {
+    suffixParts.push(layout.valueStr);
+  }
+  if (suffixParts.length === 0) {
+    return "";
+  }
+  const suffix = suffixParts.join(" ");
+  return theme ? theme.semantic.secondary(suffix) : suffix;
+}
+
+// src/progress.ts
+var ProgressComponent = class extends import_core2.BaseTuiComponent {
+  metadata = {
+    name: "progress",
+    description: "Renders horizontal progress bars for task completion",
+    version: "0.1.0",
+    supportedModes: ["ansi", "markdown"],
+    examples: [
+      {
+        name: "basic",
+        description: "Simple progress bar at 50%",
+        input: {
+          value: 50,
+          max: 100
+        }
+      },
+      {
+        name: "with-label",
+        description: "Progress bar with label",
+        input: {
+          value: 75,
+          max: 100,
+          label: "Loading:"
+        }
+      },
+      {
+        name: "block-style",
+        description: "Block style progress bar",
+        input: {
+          value: 60,
+          max: 100,
+          style: "block",
+          label: "Progress"
+        }
+      },
+      {
+        name: "shaded-style",
+        description: "Shaded style progress bar",
+        input: {
+          value: 40,
+          max: 100,
+          style: "shaded"
+        }
+      },
+      {
+        name: "bracket-style",
+        description: "Bracket style progress bar",
+        input: {
+          value: 80,
+          max: 100,
+          style: "bracket"
+        }
+      },
+      {
+        name: "arrow-style",
+        description: "Arrow style progress bar",
+        input: {
+          value: 65,
+          max: 100,
+          style: "arrow"
+        }
+      },
+      {
+        name: "ascii-style",
+        description: "ASCII style progress bar",
+        input: {
+          value: 50,
+          max: 100,
+          style: "ascii"
+        }
+      },
+      {
+        name: "with-value",
+        description: "Progress bar showing current/max value",
+        input: {
+          value: 12,
+          max: 25,
+          label: "Downloads",
+          showValue: true
+        }
+      },
+      {
+        name: "complete",
+        description: "100% complete progress bar",
+        input: {
+          value: 100,
+          max: 100,
+          style: "bracket"
+        }
+      },
+      {
+        name: "custom-width",
+        description: "Wide progress bar",
+        input: {
+          value: 45,
+          max: 100,
+          width: 40,
+          label: "Processing:"
+        }
+      }
+    ]
+  };
+  schema = progressInputSchema;
+  /**
+   * Override getJsonSchema to use direct schema generation.
+   */
+  getJsonSchema() {
+    return (0, import_zod_to_json_schema.zodToJsonSchema)(this.schema, {
+      name: this.metadata.name,
+      $refStrategy: "none"
+    });
+  }
+  render(input, context) {
+    const parsed = this.schema.parse(input);
+    const chars = getProgressChars(parsed.style);
+    const layout = computeProgressLayout(parsed, chars);
+    const output = context.renderMode === "markdown" ? renderProgressMarkdown(layout, parsed) : renderProgressAnsi(layout, parsed, context.theme);
+    const measured = (0, import_core2.measureLines)(output);
+    return {
+      output,
+      actualWidth: measured.maxWidth,
+      lineCount: measured.lineCount
+    };
+  }
+};
+function createProgress() {
+  return new ProgressComponent();
+}
+import_core2.registry.register(createProgress);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ProgressComponent,
+  computeProgressLayout,
+  createProgress,
+  getProgressChars,
+  progressInputSchema,
+  progressStyleSchema,
+  renderProgressAnsi,
+  renderProgressMarkdown
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/progress.ts","../src/schema.ts","../src/chars.ts","../src/layout.ts","../src/renderers.ts"],"sourcesContent":["export { createProgress, ProgressComponent } from \"./progress.js\";\nexport {\n  progressInputSchema,\n  progressStyleSchema,\n  type ProgressInput,\n  type ProgressInputWithDefaults,\n  type ProgressStyle,\n} from \"./schema.js\";\nexport { type ProgressChars, getProgressChars } from \"./chars.js\";\nexport { type ProgressLayout, computeProgressLayout } from \"./layout.js\";\nexport { renderProgressAnsi, renderProgressMarkdown } from \"./renderers.js\";\n","import {\n  BaseTuiComponent,\n  type ComponentMetadata,\n  type RenderContext,\n  type RenderResult,\n  measureLines,\n  registry,\n} from \"@tuicomponents/core\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport { progressInputSchema, type ProgressInput } from \"./schema.js\";\nimport { getProgressChars } from \"./chars.js\";\nimport { computeProgressLayout } from \"./layout.js\";\nimport { renderProgressAnsi, renderProgressMarkdown } from \"./renderers.js\";\n\n/**\n * Progress component for rendering horizontal progress bars.\n */\nclass ProgressComponent extends BaseTuiComponent<\n  ProgressInput,\n  typeof progressInputSchema\n> {\n  readonly metadata: ComponentMetadata<ProgressInput> = {\n    name: \"progress\",\n    description: \"Renders horizontal progress bars for task completion\",\n    version: \"0.1.0\",\n    supportedModes: [\"ansi\", \"markdown\"],\n    examples: [\n      {\n        name: \"basic\",\n        description: \"Simple progress bar at 50%\",\n        input: {\n          value: 50,\n          max: 100,\n        },\n      },\n      {\n        name: \"with-label\",\n        description: \"Progress bar with label\",\n        input: {\n          value: 75,\n          max: 100,\n          label: \"Loading:\",\n        },\n      },\n      {\n        name: \"block-style\",\n        description: \"Block style progress bar\",\n        input: {\n          value: 60,\n          max: 100,\n          style: \"block\",\n          label: \"Progress\",\n        },\n      },\n      {\n        name: \"shaded-style\",\n        description: \"Shaded style progress bar\",\n        input: {\n          value: 40,\n          max: 100,\n          style: \"shaded\",\n        },\n      },\n      {\n        name: \"bracket-style\",\n        description: \"Bracket style progress bar\",\n        input: {\n          value: 80,\n          max: 100,\n          style: \"bracket\",\n        },\n      },\n      {\n        name: \"arrow-style\",\n        description: \"Arrow style progress bar\",\n        input: {\n          value: 65,\n          max: 100,\n          style: \"arrow\",\n        },\n      },\n      {\n        name: \"ascii-style\",\n        description: \"ASCII style progress bar\",\n        input: {\n          value: 50,\n          max: 100,\n          style: \"ascii\",\n        },\n      },\n      {\n        name: \"with-value\",\n        description: \"Progress bar showing current/max value\",\n        input: {\n          value: 12,\n          max: 25,\n          label: \"Downloads\",\n          showValue: true,\n        },\n      },\n      {\n        name: \"complete\",\n        description: \"100% complete progress bar\",\n        input: {\n          value: 100,\n          max: 100,\n          style: \"bracket\",\n        },\n      },\n      {\n        name: \"custom-width\",\n        description: \"Wide progress bar\",\n        input: {\n          value: 45,\n          max: 100,\n          width: 40,\n          label: \"Processing:\",\n        },\n      },\n    ],\n  };\n\n  readonly schema = progressInputSchema;\n\n  /**\n   * Override getJsonSchema to use direct schema generation.\n   */\n  override getJsonSchema(): object {\n    return zodToJsonSchema(this.schema, {\n      name: this.metadata.name,\n      $refStrategy: \"none\",\n    });\n  }\n\n  render(input: ProgressInput, context: RenderContext): RenderResult {\n    const parsed = this.schema.parse(input);\n\n    // Get character set based on style\n    const chars = getProgressChars(parsed.style);\n\n    // Compute layout once, share between renderers\n    const layout = computeProgressLayout(parsed, chars);\n\n    // Choose renderer based on render mode\n    const output =\n      context.renderMode === \"markdown\"\n        ? renderProgressMarkdown(layout, parsed)\n        : renderProgressAnsi(layout, parsed, context.theme);\n\n    const measured = measureLines(output);\n\n    return {\n      output,\n      actualWidth: measured.maxWidth,\n      lineCount: measured.lineCount,\n    };\n  }\n}\n\n/**\n * Factory function to create a progress component.\n */\nexport function createProgress(): ProgressComponent {\n  return new ProgressComponent();\n}\n\n// Register with global registry\nregistry.register(createProgress);\n\nexport { ProgressComponent };\n","import { z } from \"zod\";\n\n/**\n * Style options for progress bar characters.\n */\nexport const progressStyleSchema = z.enum([\n  \"block\",\n  \"shaded\",\n  \"bracket\",\n  \"arrow\",\n  \"ascii\",\n]);\n\nexport type ProgressStyle = z.infer<typeof progressStyleSchema>;\n\n/**\n * Schema for progress component input.\n */\nexport const progressInputSchema = z.object({\n  /**\n   * Current progress value (0 or greater).\n   * Required unless indeterminate state is desired.\n   */\n  value: z.number().nonnegative(),\n\n  /**\n   * Maximum value (determines 100%).\n   * @default 100\n   */\n  max: z.number().positive().default(100),\n\n  /**\n   * Width of the progress bar in characters.\n   * @default 20\n   */\n  width: z.number().int().positive().default(20),\n\n  /**\n   * Style for progress bar characters.\n   * @default \"block\"\n   */\n  style: progressStyleSchema.default(\"block\"),\n\n  /**\n   * Custom filled character (overrides style default).\n   */\n  filledChar: z.string().length(1).optional(),\n\n  /**\n   * Custom empty character (overrides style default).\n   */\n  emptyChar: z.string().length(1).optional(),\n\n  /**\n   * Optional label to display before the progress bar.\n   */\n  label: z.string().optional(),\n\n  /**\n   * Whether to show percentage after the bar.\n   * @default true\n   */\n  showPercentage: z.boolean().default(true),\n\n  /**\n   * Whether to show the current/max value (e.g., \"12/25\").\n   * @default false\n   */\n  showValue: z.boolean().default(false),\n});\n\nexport type ProgressInput = z.input<typeof progressInputSchema>;\nexport type ProgressInputWithDefaults = z.output<typeof progressInputSchema>;\n","import type { ProgressStyle } from \"./schema.js\";\n\n/**\n * Characters used for progress bar rendering.\n */\nexport interface ProgressChars {\n  /** Filled portion character */\n  filled: string;\n  /** Empty portion character */\n  empty: string;\n  /** Left bracket (only for bracket style) */\n  leftBracket: string;\n  /** Right bracket (only for bracket style) */\n  rightBracket: string;\n}\n\n/**\n * Block style: █░\n */\nconst blockChars: ProgressChars = {\n  filled: \"█\",\n  empty: \"░\",\n  leftBracket: \"\",\n  rightBracket: \"\",\n};\n\n/**\n * Shaded style: ▓░\n */\nconst shadedChars: ProgressChars = {\n  filled: \"▓\",\n  empty: \"░\",\n  leftBracket: \"\",\n  rightBracket: \"\",\n};\n\n/**\n * Bracket style: [█░]\n */\nconst bracketChars: ProgressChars = {\n  filled: \"█\",\n  empty: \"░\",\n  leftBracket: \"[\",\n  rightBracket: \"]\",\n};\n\n/**\n * Arrow style: >-\n */\nconst arrowChars: ProgressChars = {\n  filled: \">\",\n  empty: \"-\",\n  leftBracket: \"\",\n  rightBracket: \"\",\n};\n\n/**\n * ASCII style: #.\n */\nconst asciiChars: ProgressChars = {\n  filled: \"#\",\n  empty: \".\",\n  leftBracket: \"\",\n  rightBracket: \"\",\n};\n\n/**\n * Get progress bar characters for a given style.\n */\nexport function getProgressChars(style: ProgressStyle): ProgressChars {\n  switch (style) {\n    case \"block\":\n      return blockChars;\n    case \"shaded\":\n      return shadedChars;\n    case \"bracket\":\n      return bracketChars;\n    case \"arrow\":\n      return arrowChars;\n    case \"ascii\":\n      return asciiChars;\n  }\n}\n","import type { ProgressInputWithDefaults } from \"./schema.js\";\nimport type { ProgressChars } from \"./chars.js\";\n\n/**\n * Pre-computed layout for the progress bar.\n */\nexport interface ProgressLayout {\n  /** Label to display (empty string if none) */\n  label: string;\n  /** Filled portion of the bar */\n  filledBar: string;\n  /** Empty portion of the bar */\n  emptyBar: string;\n  /** Left bracket (empty for non-bracket styles) */\n  leftBracket: string;\n  /** Right bracket (empty for non-bracket styles) */\n  rightBracket: string;\n  /** Percentage (0-100) */\n  percentage: number;\n  /** Formatted percentage string (e.g., \"50%\") */\n  percentageStr: string;\n  /** Formatted value string (e.g., \"12/25\") */\n  valueStr: string;\n  /** Number of filled characters */\n  filledCount: number;\n  /** Number of empty characters */\n  emptyCount: number;\n  /** Total width of the bar portion */\n  barWidth: number;\n}\n\n/**\n * Compute the layout for a progress bar.\n *\n * @param input - Validated progress input with defaults applied\n * @param chars - Character set to use\n * @returns Computed layout ready for rendering\n */\nexport function computeProgressLayout(\n  input: ProgressInputWithDefaults,\n  chars: ProgressChars\n): ProgressLayout {\n  // Calculate percentage (clamped to 0-100)\n  const rawPercentage = input.max > 0 ? (input.value / input.max) * 100 : 0;\n  const percentage = Math.min(100, Math.max(0, rawPercentage));\n\n  // Determine actual bar width (accounting for brackets if present)\n  const barWidth = input.width;\n\n  // Calculate filled/empty character counts\n  const filledCount = Math.round((percentage / 100) * barWidth);\n  const emptyCount = barWidth - filledCount;\n\n  // Get effective characters (allow override)\n  const filledChar = input.filledChar ?? chars.filled;\n  const emptyChar = input.emptyChar ?? chars.empty;\n\n  // Build bar strings\n  const filledBar = filledChar.repeat(filledCount);\n  const emptyBar = emptyChar.repeat(emptyCount);\n\n  // Format percentage\n  const percentageStr = `${String(Math.round(percentage))}%`;\n\n  // Format value\n  const valueStr = `${String(input.value)}/${String(input.max)}`;\n\n  return {\n    label: input.label ?? \"\",\n    filledBar,\n    emptyBar,\n    leftBracket: chars.leftBracket,\n    rightBracket: chars.rightBracket,\n    percentage,\n    percentageStr,\n    valueStr,\n    filledCount,\n    emptyCount,\n    barWidth,\n  };\n}\n","import { type TuiTheme, anchorLine, DEFAULT_ANCHOR } from \"@tuicomponents/core\";\nimport type { ProgressLayout } from \"./layout.js\";\nimport type { ProgressInputWithDefaults } from \"./schema.js\";\n\n/**\n * Render a progress bar using ANSI escape codes for rich terminal output.\n *\n * @param layout - Pre-computed progress layout\n * @param input - Original input with defaults\n * @param theme - Optional theme for colors\n * @returns ANSI-formatted progress bar string\n */\nexport function renderProgressAnsi(\n  layout: ProgressLayout,\n  input: ProgressInputWithDefaults,\n  theme?: TuiTheme\n): string {\n  const parts: string[] = [];\n\n  // Add label if present\n  if (layout.label) {\n    const coloredLabel = theme\n      ? theme.semantic.header(layout.label)\n      : layout.label;\n    parts.push(coloredLabel);\n    parts.push(\" \");\n  }\n\n  // Add left bracket\n  if (layout.leftBracket) {\n    const coloredBracket = theme\n      ? theme.semantic.border(layout.leftBracket)\n      : layout.leftBracket;\n    parts.push(coloredBracket);\n  }\n\n  // Add bar\n  const coloredFilled = theme\n    ? theme.semantic.primary(layout.filledBar)\n    : layout.filledBar;\n  const coloredEmpty = theme\n    ? theme.semantic.secondary(layout.emptyBar)\n    : layout.emptyBar;\n  parts.push(coloredFilled);\n  parts.push(coloredEmpty);\n\n  // Add right bracket\n  if (layout.rightBracket) {\n    const coloredBracket = theme\n      ? theme.semantic.border(layout.rightBracket)\n      : layout.rightBracket;\n    parts.push(coloredBracket);\n  }\n\n  // Add percentage and/or value\n  const suffix = buildSuffix(layout, input, theme);\n  if (suffix) {\n    parts.push(\" \");\n    parts.push(suffix);\n  }\n\n  return parts.join(\"\");\n}\n\n/**\n * Render a progress bar using markdown-friendly output.\n *\n * @param layout - Pre-computed progress layout\n * @param input - Original input with defaults\n * @returns Markdown-friendly progress bar string\n */\nexport function renderProgressMarkdown(\n  layout: ProgressLayout,\n  input: ProgressInputWithDefaults\n): string {\n  const parts: string[] = [];\n\n  // Add label if present\n  if (layout.label) {\n    parts.push(layout.label);\n    parts.push(\" \");\n  }\n\n  // Add left bracket\n  if (layout.leftBracket) {\n    parts.push(layout.leftBracket);\n  }\n\n  // Add bar\n  parts.push(layout.filledBar);\n  parts.push(layout.emptyBar);\n\n  // Add right bracket\n  if (layout.rightBracket) {\n    parts.push(layout.rightBracket);\n  }\n\n  // Add percentage and/or value\n  const suffix = buildSuffix(layout, input);\n  if (suffix) {\n    parts.push(\" \");\n    parts.push(suffix);\n  }\n\n  return anchorLine(parts.join(\"\"), DEFAULT_ANCHOR);\n}\n\n/**\n * Build the suffix string (percentage and/or value).\n */\nfunction buildSuffix(\n  layout: ProgressLayout,\n  input: ProgressInputWithDefaults,\n  theme?: TuiTheme\n): string {\n  const suffixParts: string[] = [];\n\n  if (input.showPercentage) {\n    suffixParts.push(layout.percentageStr);\n  }\n\n  if (input.showValue) {\n    suffixParts.push(layout.valueStr);\n  }\n\n  if (suffixParts.length === 0) {\n    return \"\";\n  }\n\n  const suffix = suffixParts.join(\" \");\n  return theme ? theme.semantic.secondary(suffix) : suffix;\n}\n"],"mappings":"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","names":["import_core"]}

package/dist/index.d.cts

@@ -0,0 +1,199 @@
+import * as zod from 'zod';
+import { z } from 'zod';
+import { BaseTuiComponent, ComponentMetadata, RenderContext, RenderResult, TuiTheme } from '@tuicomponents/core';
+
+/**
+ * Style options for progress bar characters.
+ */
+declare const progressStyleSchema: z.ZodEnum<["block", "shaded", "bracket", "arrow", "ascii"]>;
+type ProgressStyle = z.infer<typeof progressStyleSchema>;
+/**
+ * Schema for progress component input.
+ */
+declare const progressInputSchema: z.ZodObject<{
+    /**
+     * Current progress value (0 or greater).
+     * Required unless indeterminate state is desired.
+     */
+    value: z.ZodNumber;
+    /**
+     * Maximum value (determines 100%).
+     * @default 100
+     */
+    max: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Width of the progress bar in characters.
+     * @default 20
+     */
+    width: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Style for progress bar characters.
+     * @default "block"
+     */
+    style: z.ZodDefault<z.ZodEnum<["block", "shaded", "bracket", "arrow", "ascii"]>>;
+    /**
+     * Custom filled character (overrides style default).
+     */
+    filledChar: z.ZodOptional<z.ZodString>;
+    /**
+     * Custom empty character (overrides style default).
+     */
+    emptyChar: z.ZodOptional<z.ZodString>;
+    /**
+     * Optional label to display before the progress bar.
+     */
+    label: z.ZodOptional<z.ZodString>;
+    /**
+     * Whether to show percentage after the bar.
+     * @default true
+     */
+    showPercentage: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Whether to show the current/max value (e.g., "12/25").
+     * @default false
+     */
+    showValue: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    value: number;
+    max: number;
+    width: number;
+    style: "block" | "shaded" | "bracket" | "arrow" | "ascii";
+    showPercentage: boolean;
+    showValue: boolean;
+    filledChar?: string | undefined;
+    emptyChar?: string | undefined;
+    label?: string | undefined;
+}, {
+    value: number;
+    max?: number | undefined;
+    width?: number | undefined;
+    style?: "block" | "shaded" | "bracket" | "arrow" | "ascii" | undefined;
+    filledChar?: string | undefined;
+    emptyChar?: string | undefined;
+    label?: string | undefined;
+    showPercentage?: boolean | undefined;
+    showValue?: boolean | undefined;
+}>;
+type ProgressInput = z.input<typeof progressInputSchema>;
+type ProgressInputWithDefaults = z.output<typeof progressInputSchema>;
+
+/**
+ * Progress component for rendering horizontal progress bars.
+ */
+declare class ProgressComponent extends BaseTuiComponent<ProgressInput, typeof progressInputSchema> {
+    readonly metadata: ComponentMetadata<ProgressInput>;
+    readonly schema: zod.ZodObject<{
+        value: zod.ZodNumber;
+        max: zod.ZodDefault<zod.ZodNumber>;
+        width: zod.ZodDefault<zod.ZodNumber>;
+        style: zod.ZodDefault<zod.ZodEnum<["block", "shaded", "bracket", "arrow", "ascii"]>>;
+        filledChar: zod.ZodOptional<zod.ZodString>;
+        emptyChar: zod.ZodOptional<zod.ZodString>;
+        label: zod.ZodOptional<zod.ZodString>;
+        showPercentage: zod.ZodDefault<zod.ZodBoolean>;
+        showValue: zod.ZodDefault<zod.ZodBoolean>;
+    }, "strip", zod.ZodTypeAny, {
+        value: number;
+        max: number;
+        width: number;
+        style: "block" | "shaded" | "bracket" | "arrow" | "ascii";
+        showPercentage: boolean;
+        showValue: boolean;
+        filledChar?: string | undefined;
+        emptyChar?: string | undefined;
+        label?: string | undefined;
+    }, {
+        value: number;
+        max?: number | undefined;
+        width?: number | undefined;
+        style?: "block" | "shaded" | "bracket" | "arrow" | "ascii" | undefined;
+        filledChar?: string | undefined;
+        emptyChar?: string | undefined;
+        label?: string | undefined;
+        showPercentage?: boolean | undefined;
+        showValue?: boolean | undefined;
+    }>;
+    /**
+     * Override getJsonSchema to use direct schema generation.
+     */
+    getJsonSchema(): object;
+    render(input: ProgressInput, context: RenderContext): RenderResult;
+}
+/**
+ * Factory function to create a progress component.
+ */
+declare function createProgress(): ProgressComponent;
+
+/**
+ * Characters used for progress bar rendering.
+ */
+interface ProgressChars {
+    /** Filled portion character */
+    filled: string;
+    /** Empty portion character */
+    empty: string;
+    /** Left bracket (only for bracket style) */
+    leftBracket: string;
+    /** Right bracket (only for bracket style) */
+    rightBracket: string;
+}
+/**
+ * Get progress bar characters for a given style.
+ */
+declare function getProgressChars(style: ProgressStyle): ProgressChars;
+
+/**
+ * Pre-computed layout for the progress bar.
+ */
+interface ProgressLayout {
+    /** Label to display (empty string if none) */
+    label: string;
+    /** Filled portion of the bar */
+    filledBar: string;
+    /** Empty portion of the bar */
+    emptyBar: string;
+    /** Left bracket (empty for non-bracket styles) */
+    leftBracket: string;
+    /** Right bracket (empty for non-bracket styles) */
+    rightBracket: string;
+    /** Percentage (0-100) */
+    percentage: number;
+    /** Formatted percentage string (e.g., "50%") */
+    percentageStr: string;
+    /** Formatted value string (e.g., "12/25") */
+    valueStr: string;
+    /** Number of filled characters */
+    filledCount: number;
+    /** Number of empty characters */
+    emptyCount: number;
+    /** Total width of the bar portion */
+    barWidth: number;
+}
+/**
+ * Compute the layout for a progress bar.
+ *
+ * @param input - Validated progress input with defaults applied
+ * @param chars - Character set to use
+ * @returns Computed layout ready for rendering
+ */
+declare function computeProgressLayout(input: ProgressInputWithDefaults, chars: ProgressChars): ProgressLayout;
+
+/**
+ * Render a progress bar using ANSI escape codes for rich terminal output.
+ *
+ * @param layout - Pre-computed progress layout
+ * @param input - Original input with defaults
+ * @param theme - Optional theme for colors
+ * @returns ANSI-formatted progress bar string
+ */
+declare function renderProgressAnsi(layout: ProgressLayout, input: ProgressInputWithDefaults, theme?: TuiTheme): string;
+/**
+ * Render a progress bar using markdown-friendly output.
+ *
+ * @param layout - Pre-computed progress layout
+ * @param input - Original input with defaults
+ * @returns Markdown-friendly progress bar string
+ */
+declare function renderProgressMarkdown(layout: ProgressLayout, input: ProgressInputWithDefaults): string;
+
+export { type ProgressChars, ProgressComponent, type ProgressInput, type ProgressInputWithDefaults, type ProgressLayout, type ProgressStyle, computeProgressLayout, createProgress, getProgressChars, progressInputSchema, progressStyleSchema, renderProgressAnsi, renderProgressMarkdown };

package/dist/index.d.ts

@@ -0,0 +1,199 @@
+import * as zod from 'zod';
+import { z } from 'zod';
+import { BaseTuiComponent, ComponentMetadata, RenderContext, RenderResult, TuiTheme } from '@tuicomponents/core';
+
+/**
+ * Style options for progress bar characters.
+ */
+declare const progressStyleSchema: z.ZodEnum<["block", "shaded", "bracket", "arrow", "ascii"]>;
+type ProgressStyle = z.infer<typeof progressStyleSchema>;
+/**
+ * Schema for progress component input.
+ */
+declare const progressInputSchema: z.ZodObject<{
+    /**
+     * Current progress value (0 or greater).
+     * Required unless indeterminate state is desired.
+     */
+    value: z.ZodNumber;
+    /**
+     * Maximum value (determines 100%).
+     * @default 100
+     */
+    max: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Width of the progress bar in characters.
+     * @default 20
+     */
+    width: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Style for progress bar characters.
+     * @default "block"
+     */
+    style: z.ZodDefault<z.ZodEnum<["block", "shaded", "bracket", "arrow", "ascii"]>>;
+    /**
+     * Custom filled character (overrides style default).
+     */
+    filledChar: z.ZodOptional<z.ZodString>;
+    /**
+     * Custom empty character (overrides style default).
+     */
+    emptyChar: z.ZodOptional<z.ZodString>;
+    /**
+     * Optional label to display before the progress bar.
+     */
+    label: z.ZodOptional<z.ZodString>;
+    /**
+     * Whether to show percentage after the bar.
+     * @default true
+     */
+    showPercentage: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Whether to show the current/max value (e.g., "12/25").
+     * @default false
+     */
+    showValue: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    value: number;
+    max: number;
+    width: number;
+    style: "block" | "shaded" | "bracket" | "arrow" | "ascii";
+    showPercentage: boolean;
+    showValue: boolean;
+    filledChar?: string | undefined;
+    emptyChar?: string | undefined;
+    label?: string | undefined;
+}, {
+    value: number;
+    max?: number | undefined;
+    width?: number | undefined;
+    style?: "block" | "shaded" | "bracket" | "arrow" | "ascii" | undefined;
+    filledChar?: string | undefined;
+    emptyChar?: string | undefined;
+    label?: string | undefined;
+    showPercentage?: boolean | undefined;
+    showValue?: boolean | undefined;
+}>;
+type ProgressInput = z.input<typeof progressInputSchema>;
+type ProgressInputWithDefaults = z.output<typeof progressInputSchema>;
+
+/**
+ * Progress component for rendering horizontal progress bars.
+ */
+declare class ProgressComponent extends BaseTuiComponent<ProgressInput, typeof progressInputSchema> {
+    readonly metadata: ComponentMetadata<ProgressInput>;
+    readonly schema: zod.ZodObject<{
+        value: zod.ZodNumber;
+        max: zod.ZodDefault<zod.ZodNumber>;
+        width: zod.ZodDefault<zod.ZodNumber>;
+        style: zod.ZodDefault<zod.ZodEnum<["block", "shaded", "bracket", "arrow", "ascii"]>>;
+        filledChar: zod.ZodOptional<zod.ZodString>;
+        emptyChar: zod.ZodOptional<zod.ZodString>;
+        label: zod.ZodOptional<zod.ZodString>;
+        showPercentage: zod.ZodDefault<zod.ZodBoolean>;
+        showValue: zod.ZodDefault<zod.ZodBoolean>;
+    }, "strip", zod.ZodTypeAny, {
+        value: number;
+        max: number;
+        width: number;
+        style: "block" | "shaded" | "bracket" | "arrow" | "ascii";
+        showPercentage: boolean;
+        showValue: boolean;
+        filledChar?: string | undefined;
+        emptyChar?: string | undefined;
+        label?: string | undefined;
+    }, {
+        value: number;
+        max?: number | undefined;
+        width?: number | undefined;
+        style?: "block" | "shaded" | "bracket" | "arrow" | "ascii" | undefined;
+        filledChar?: string | undefined;
+        emptyChar?: string | undefined;
+        label?: string | undefined;
+        showPercentage?: boolean | undefined;
+        showValue?: boolean | undefined;
+    }>;
+    /**
+     * Override getJsonSchema to use direct schema generation.
+     */
+    getJsonSchema(): object;
+    render(input: ProgressInput, context: RenderContext): RenderResult;
+}
+/**
+ * Factory function to create a progress component.
+ */
+declare function createProgress(): ProgressComponent;
+
+/**
+ * Characters used for progress bar rendering.
+ */
+interface ProgressChars {
+    /** Filled portion character */
+    filled: string;
+    /** Empty portion character */
+    empty: string;
+    /** Left bracket (only for bracket style) */
+    leftBracket: string;
+    /** Right bracket (only for bracket style) */
+    rightBracket: string;
+}
+/**
+ * Get progress bar characters for a given style.
+ */
+declare function getProgressChars(style: ProgressStyle): ProgressChars;
+
+/**
+ * Pre-computed layout for the progress bar.
+ */
+interface ProgressLayout {
+    /** Label to display (empty string if none) */
+    label: string;
+    /** Filled portion of the bar */
+    filledBar: string;
+    /** Empty portion of the bar */
+    emptyBar: string;
+    /** Left bracket (empty for non-bracket styles) */
+    leftBracket: string;
+    /** Right bracket (empty for non-bracket styles) */
+    rightBracket: string;
+    /** Percentage (0-100) */
+    percentage: number;
+    /** Formatted percentage string (e.g., "50%") */
+    percentageStr: string;
+    /** Formatted value string (e.g., "12/25") */
+    valueStr: string;
+    /** Number of filled characters */
+    filledCount: number;
+    /** Number of empty characters */
+    emptyCount: number;
+    /** Total width of the bar portion */
+    barWidth: number;
+}
+/**
+ * Compute the layout for a progress bar.
+ *
+ * @param input - Validated progress input with defaults applied
+ * @param chars - Character set to use
+ * @returns Computed layout ready for rendering
+ */
+declare function computeProgressLayout(input: ProgressInputWithDefaults, chars: ProgressChars): ProgressLayout;
+
+/**
+ * Render a progress bar using ANSI escape codes for rich terminal output.
+ *
+ * @param layout - Pre-computed progress layout
+ * @param input - Original input with defaults
+ * @param theme - Optional theme for colors
+ * @returns ANSI-formatted progress bar string
+ */
+declare function renderProgressAnsi(layout: ProgressLayout, input: ProgressInputWithDefaults, theme?: TuiTheme): string;
+/**
+ * Render a progress bar using markdown-friendly output.
+ *
+ * @param layout - Pre-computed progress layout
+ * @param input - Original input with defaults
+ * @returns Markdown-friendly progress bar string
+ */
+declare function renderProgressMarkdown(layout: ProgressLayout, input: ProgressInputWithDefaults): string;
+
+export { type ProgressChars, ProgressComponent, type ProgressInput, type ProgressInputWithDefaults, type ProgressLayout, type ProgressStyle, computeProgressLayout, createProgress, getProgressChars, progressInputSchema, progressStyleSchema, renderProgressAnsi, renderProgressMarkdown };

package/dist/index.js

@@ -0,0 +1,340 @@
+// src/progress.ts
+import {
+  BaseTuiComponent,
+  measureLines,
+  registry
+} from "@tuicomponents/core";
+import { zodToJsonSchema } from "zod-to-json-schema";
+
+// src/schema.ts
+import { z } from "zod";
+var progressStyleSchema = z.enum([
+  "block",
+  "shaded",
+  "bracket",
+  "arrow",
+  "ascii"
+]);
+var progressInputSchema = z.object({
+  /**
+   * Current progress value (0 or greater).
+   * Required unless indeterminate state is desired.
+   */
+  value: z.number().nonnegative(),
+  /**
+   * Maximum value (determines 100%).
+   * @default 100
+   */
+  max: z.number().positive().default(100),
+  /**
+   * Width of the progress bar in characters.
+   * @default 20
+   */
+  width: z.number().int().positive().default(20),
+  /**
+   * Style for progress bar characters.
+   * @default "block"
+   */
+  style: progressStyleSchema.default("block"),
+  /**
+   * Custom filled character (overrides style default).
+   */
+  filledChar: z.string().length(1).optional(),
+  /**
+   * Custom empty character (overrides style default).
+   */
+  emptyChar: z.string().length(1).optional(),
+  /**
+   * Optional label to display before the progress bar.
+   */
+  label: z.string().optional(),
+  /**
+   * Whether to show percentage after the bar.
+   * @default true
+   */
+  showPercentage: z.boolean().default(true),
+  /**
+   * Whether to show the current/max value (e.g., "12/25").
+   * @default false
+   */
+  showValue: z.boolean().default(false)
+});
+
+// src/chars.ts
+var blockChars = {
+  filled: "\u2588",
+  empty: "\u2591",
+  leftBracket: "",
+  rightBracket: ""
+};
+var shadedChars = {
+  filled: "\u2593",
+  empty: "\u2591",
+  leftBracket: "",
+  rightBracket: ""
+};
+var bracketChars = {
+  filled: "\u2588",
+  empty: "\u2591",
+  leftBracket: "[",
+  rightBracket: "]"
+};
+var arrowChars = {
+  filled: ">",
+  empty: "-",
+  leftBracket: "",
+  rightBracket: ""
+};
+var asciiChars = {
+  filled: "#",
+  empty: ".",
+  leftBracket: "",
+  rightBracket: ""
+};
+function getProgressChars(style) {
+  switch (style) {
+    case "block":
+      return blockChars;
+    case "shaded":
+      return shadedChars;
+    case "bracket":
+      return bracketChars;
+    case "arrow":
+      return arrowChars;
+    case "ascii":
+      return asciiChars;
+  }
+}
+
+// src/layout.ts
+function computeProgressLayout(input, chars) {
+  const rawPercentage = input.max > 0 ? input.value / input.max * 100 : 0;
+  const percentage = Math.min(100, Math.max(0, rawPercentage));
+  const barWidth = input.width;
+  const filledCount = Math.round(percentage / 100 * barWidth);
+  const emptyCount = barWidth - filledCount;
+  const filledChar = input.filledChar ?? chars.filled;
+  const emptyChar = input.emptyChar ?? chars.empty;
+  const filledBar = filledChar.repeat(filledCount);
+  const emptyBar = emptyChar.repeat(emptyCount);
+  const percentageStr = `${String(Math.round(percentage))}%`;
+  const valueStr = `${String(input.value)}/${String(input.max)}`;
+  return {
+    label: input.label ?? "",
+    filledBar,
+    emptyBar,
+    leftBracket: chars.leftBracket,
+    rightBracket: chars.rightBracket,
+    percentage,
+    percentageStr,
+    valueStr,
+    filledCount,
+    emptyCount,
+    barWidth
+  };
+}
+
+// src/renderers.ts
+import { anchorLine, DEFAULT_ANCHOR } from "@tuicomponents/core";
+function renderProgressAnsi(layout, input, theme) {
+  const parts = [];
+  if (layout.label) {
+    const coloredLabel = theme ? theme.semantic.header(layout.label) : layout.label;
+    parts.push(coloredLabel);
+    parts.push(" ");
+  }
+  if (layout.leftBracket) {
+    const coloredBracket = theme ? theme.semantic.border(layout.leftBracket) : layout.leftBracket;
+    parts.push(coloredBracket);
+  }
+  const coloredFilled = theme ? theme.semantic.primary(layout.filledBar) : layout.filledBar;
+  const coloredEmpty = theme ? theme.semantic.secondary(layout.emptyBar) : layout.emptyBar;
+  parts.push(coloredFilled);
+  parts.push(coloredEmpty);
+  if (layout.rightBracket) {
+    const coloredBracket = theme ? theme.semantic.border(layout.rightBracket) : layout.rightBracket;
+    parts.push(coloredBracket);
+  }
+  const suffix = buildSuffix(layout, input, theme);
+  if (suffix) {
+    parts.push(" ");
+    parts.push(suffix);
+  }
+  return parts.join("");
+}
+function renderProgressMarkdown(layout, input) {
+  const parts = [];
+  if (layout.label) {
+    parts.push(layout.label);
+    parts.push(" ");
+  }
+  if (layout.leftBracket) {
+    parts.push(layout.leftBracket);
+  }
+  parts.push(layout.filledBar);
+  parts.push(layout.emptyBar);
+  if (layout.rightBracket) {
+    parts.push(layout.rightBracket);
+  }
+  const suffix = buildSuffix(layout, input);
+  if (suffix) {
+    parts.push(" ");
+    parts.push(suffix);
+  }
+  return anchorLine(parts.join(""), DEFAULT_ANCHOR);
+}
+function buildSuffix(layout, input, theme) {
+  const suffixParts = [];
+  if (input.showPercentage) {
+    suffixParts.push(layout.percentageStr);
+  }
+  if (input.showValue) {
+    suffixParts.push(layout.valueStr);
+  }
+  if (suffixParts.length === 0) {
+    return "";
+  }
+  const suffix = suffixParts.join(" ");
+  return theme ? theme.semantic.secondary(suffix) : suffix;
+}
+
+// src/progress.ts
+var ProgressComponent = class extends BaseTuiComponent {
+  metadata = {
+    name: "progress",
+    description: "Renders horizontal progress bars for task completion",
+    version: "0.1.0",
+    supportedModes: ["ansi", "markdown"],
+    examples: [
+      {
+        name: "basic",
+        description: "Simple progress bar at 50%",
+        input: {
+          value: 50,
+          max: 100
+        }
+      },
+      {
+        name: "with-label",
+        description: "Progress bar with label",
+        input: {
+          value: 75,
+          max: 100,
+          label: "Loading:"
+        }
+      },
+      {
+        name: "block-style",
+        description: "Block style progress bar",
+        input: {
+          value: 60,
+          max: 100,
+          style: "block",
+          label: "Progress"
+        }
+      },
+      {
+        name: "shaded-style",
+        description: "Shaded style progress bar",
+        input: {
+          value: 40,
+          max: 100,
+          style: "shaded"
+        }
+      },
+      {
+        name: "bracket-style",
+        description: "Bracket style progress bar",
+        input: {
+          value: 80,
+          max: 100,
+          style: "bracket"
+        }
+      },
+      {
+        name: "arrow-style",
+        description: "Arrow style progress bar",
+        input: {
+          value: 65,
+          max: 100,
+          style: "arrow"
+        }
+      },
+      {
+        name: "ascii-style",
+        description: "ASCII style progress bar",
+        input: {
+          value: 50,
+          max: 100,
+          style: "ascii"
+        }
+      },
+      {
+        name: "with-value",
+        description: "Progress bar showing current/max value",
+        input: {
+          value: 12,
+          max: 25,
+          label: "Downloads",
+          showValue: true
+        }
+      },
+      {
+        name: "complete",
+        description: "100% complete progress bar",
+        input: {
+          value: 100,
+          max: 100,
+          style: "bracket"
+        }
+      },
+      {
+        name: "custom-width",
+        description: "Wide progress bar",
+        input: {
+          value: 45,
+          max: 100,
+          width: 40,
+          label: "Processing:"
+        }
+      }
+    ]
+  };
+  schema = progressInputSchema;
+  /**
+   * Override getJsonSchema to use direct schema generation.
+   */
+  getJsonSchema() {
+    return zodToJsonSchema(this.schema, {
+      name: this.metadata.name,
+      $refStrategy: "none"
+    });
+  }
+  render(input, context) {
+    const parsed = this.schema.parse(input);
+    const chars = getProgressChars(parsed.style);
+    const layout = computeProgressLayout(parsed, chars);
+    const output = context.renderMode === "markdown" ? renderProgressMarkdown(layout, parsed) : renderProgressAnsi(layout, parsed, context.theme);
+    const measured = measureLines(output);
+    return {
+      output,
+      actualWidth: measured.maxWidth,
+      lineCount: measured.lineCount
+    };
+  }
+};
+function createProgress() {
+  return new ProgressComponent();
+}
+registry.register(createProgress);
+export {
+  ProgressComponent,
+  computeProgressLayout,
+  createProgress,
+  getProgressChars,
+  progressInputSchema,
+  progressStyleSchema,
+  renderProgressAnsi,
+  renderProgressMarkdown
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/progress.ts","../src/schema.ts","../src/chars.ts","../src/layout.ts","../src/renderers.ts"],"sourcesContent":["import {\n  BaseTuiComponent,\n  type ComponentMetadata,\n  type RenderContext,\n  type RenderResult,\n  measureLines,\n  registry,\n} from \"@tuicomponents/core\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport { progressInputSchema, type ProgressInput } from \"./schema.js\";\nimport { getProgressChars } from \"./chars.js\";\nimport { computeProgressLayout } from \"./layout.js\";\nimport { renderProgressAnsi, renderProgressMarkdown } from \"./renderers.js\";\n\n/**\n * Progress component for rendering horizontal progress bars.\n */\nclass ProgressComponent extends BaseTuiComponent<\n  ProgressInput,\n  typeof progressInputSchema\n> {\n  readonly metadata: ComponentMetadata<ProgressInput> = {\n    name: \"progress\",\n    description: \"Renders horizontal progress bars for task completion\",\n    version: \"0.1.0\",\n    supportedModes: [\"ansi\", \"markdown\"],\n    examples: [\n      {\n        name: \"basic\",\n        description: \"Simple progress bar at 50%\",\n        input: {\n          value: 50,\n          max: 100,\n        },\n      },\n      {\n        name: \"with-label\",\n        description: \"Progress bar with label\",\n        input: {\n          value: 75,\n          max: 100,\n          label: \"Loading:\",\n        },\n      },\n      {\n        name: \"block-style\",\n        description: \"Block style progress bar\",\n        input: {\n          value: 60,\n          max: 100,\n          style: \"block\",\n          label: \"Progress\",\n        },\n      },\n      {\n        name: \"shaded-style\",\n        description: \"Shaded style progress bar\",\n        input: {\n          value: 40,\n          max: 100,\n          style: \"shaded\",\n        },\n      },\n      {\n        name: \"bracket-style\",\n        description: \"Bracket style progress bar\",\n        input: {\n          value: 80,\n          max: 100,\n          style: \"bracket\",\n        },\n      },\n      {\n        name: \"arrow-style\",\n        description: \"Arrow style progress bar\",\n        input: {\n          value: 65,\n          max: 100,\n          style: \"arrow\",\n        },\n      },\n      {\n        name: \"ascii-style\",\n        description: \"ASCII style progress bar\",\n        input: {\n          value: 50,\n          max: 100,\n          style: \"ascii\",\n        },\n      },\n      {\n        name: \"with-value\",\n        description: \"Progress bar showing current/max value\",\n        input: {\n          value: 12,\n          max: 25,\n          label: \"Downloads\",\n          showValue: true,\n        },\n      },\n      {\n        name: \"complete\",\n        description: \"100% complete progress bar\",\n        input: {\n          value: 100,\n          max: 100,\n          style: \"bracket\",\n        },\n      },\n      {\n        name: \"custom-width\",\n        description: \"Wide progress bar\",\n        input: {\n          value: 45,\n          max: 100,\n          width: 40,\n          label: \"Processing:\",\n        },\n      },\n    ],\n  };\n\n  readonly schema = progressInputSchema;\n\n  /**\n   * Override getJsonSchema to use direct schema generation.\n   */\n  override getJsonSchema(): object {\n    return zodToJsonSchema(this.schema, {\n      name: this.metadata.name,\n      $refStrategy: \"none\",\n    });\n  }\n\n  render(input: ProgressInput, context: RenderContext): RenderResult {\n    const parsed = this.schema.parse(input);\n\n    // Get character set based on style\n    const chars = getProgressChars(parsed.style);\n\n    // Compute layout once, share between renderers\n    const layout = computeProgressLayout(parsed, chars);\n\n    // Choose renderer based on render mode\n    const output =\n      context.renderMode === \"markdown\"\n        ? renderProgressMarkdown(layout, parsed)\n        : renderProgressAnsi(layout, parsed, context.theme);\n\n    const measured = measureLines(output);\n\n    return {\n      output,\n      actualWidth: measured.maxWidth,\n      lineCount: measured.lineCount,\n    };\n  }\n}\n\n/**\n * Factory function to create a progress component.\n */\nexport function createProgress(): ProgressComponent {\n  return new ProgressComponent();\n}\n\n// Register with global registry\nregistry.register(createProgress);\n\nexport { ProgressComponent };\n","import { z } from \"zod\";\n\n/**\n * Style options for progress bar characters.\n */\nexport const progressStyleSchema = z.enum([\n  \"block\",\n  \"shaded\",\n  \"bracket\",\n  \"arrow\",\n  \"ascii\",\n]);\n\nexport type ProgressStyle = z.infer<typeof progressStyleSchema>;\n\n/**\n * Schema for progress component input.\n */\nexport const progressInputSchema = z.object({\n  /**\n   * Current progress value (0 or greater).\n   * Required unless indeterminate state is desired.\n   */\n  value: z.number().nonnegative(),\n\n  /**\n   * Maximum value (determines 100%).\n   * @default 100\n   */\n  max: z.number().positive().default(100),\n\n  /**\n   * Width of the progress bar in characters.\n   * @default 20\n   */\n  width: z.number().int().positive().default(20),\n\n  /**\n   * Style for progress bar characters.\n   * @default \"block\"\n   */\n  style: progressStyleSchema.default(\"block\"),\n\n  /**\n   * Custom filled character (overrides style default).\n   */\n  filledChar: z.string().length(1).optional(),\n\n  /**\n   * Custom empty character (overrides style default).\n   */\n  emptyChar: z.string().length(1).optional(),\n\n  /**\n   * Optional label to display before the progress bar.\n   */\n  label: z.string().optional(),\n\n  /**\n   * Whether to show percentage after the bar.\n   * @default true\n   */\n  showPercentage: z.boolean().default(true),\n\n  /**\n   * Whether to show the current/max value (e.g., \"12/25\").\n   * @default false\n   */\n  showValue: z.boolean().default(false),\n});\n\nexport type ProgressInput = z.input<typeof progressInputSchema>;\nexport type ProgressInputWithDefaults = z.output<typeof progressInputSchema>;\n","import type { ProgressStyle } from \"./schema.js\";\n\n/**\n * Characters used for progress bar rendering.\n */\nexport interface ProgressChars {\n  /** Filled portion character */\n  filled: string;\n  /** Empty portion character */\n  empty: string;\n  /** Left bracket (only for bracket style) */\n  leftBracket: string;\n  /** Right bracket (only for bracket style) */\n  rightBracket: string;\n}\n\n/**\n * Block style: █░\n */\nconst blockChars: ProgressChars = {\n  filled: \"█\",\n  empty: \"░\",\n  leftBracket: \"\",\n  rightBracket: \"\",\n};\n\n/**\n * Shaded style: ▓░\n */\nconst shadedChars: ProgressChars = {\n  filled: \"▓\",\n  empty: \"░\",\n  leftBracket: \"\",\n  rightBracket: \"\",\n};\n\n/**\n * Bracket style: [█░]\n */\nconst bracketChars: ProgressChars = {\n  filled: \"█\",\n  empty: \"░\",\n  leftBracket: \"[\",\n  rightBracket: \"]\",\n};\n\n/**\n * Arrow style: >-\n */\nconst arrowChars: ProgressChars = {\n  filled: \">\",\n  empty: \"-\",\n  leftBracket: \"\",\n  rightBracket: \"\",\n};\n\n/**\n * ASCII style: #.\n */\nconst asciiChars: ProgressChars = {\n  filled: \"#\",\n  empty: \".\",\n  leftBracket: \"\",\n  rightBracket: \"\",\n};\n\n/**\n * Get progress bar characters for a given style.\n */\nexport function getProgressChars(style: ProgressStyle): ProgressChars {\n  switch (style) {\n    case \"block\":\n      return blockChars;\n    case \"shaded\":\n      return shadedChars;\n    case \"bracket\":\n      return bracketChars;\n    case \"arrow\":\n      return arrowChars;\n    case \"ascii\":\n      return asciiChars;\n  }\n}\n","import type { ProgressInputWithDefaults } from \"./schema.js\";\nimport type { ProgressChars } from \"./chars.js\";\n\n/**\n * Pre-computed layout for the progress bar.\n */\nexport interface ProgressLayout {\n  /** Label to display (empty string if none) */\n  label: string;\n  /** Filled portion of the bar */\n  filledBar: string;\n  /** Empty portion of the bar */\n  emptyBar: string;\n  /** Left bracket (empty for non-bracket styles) */\n  leftBracket: string;\n  /** Right bracket (empty for non-bracket styles) */\n  rightBracket: string;\n  /** Percentage (0-100) */\n  percentage: number;\n  /** Formatted percentage string (e.g., \"50%\") */\n  percentageStr: string;\n  /** Formatted value string (e.g., \"12/25\") */\n  valueStr: string;\n  /** Number of filled characters */\n  filledCount: number;\n  /** Number of empty characters */\n  emptyCount: number;\n  /** Total width of the bar portion */\n  barWidth: number;\n}\n\n/**\n * Compute the layout for a progress bar.\n *\n * @param input - Validated progress input with defaults applied\n * @param chars - Character set to use\n * @returns Computed layout ready for rendering\n */\nexport function computeProgressLayout(\n  input: ProgressInputWithDefaults,\n  chars: ProgressChars\n): ProgressLayout {\n  // Calculate percentage (clamped to 0-100)\n  const rawPercentage = input.max > 0 ? (input.value / input.max) * 100 : 0;\n  const percentage = Math.min(100, Math.max(0, rawPercentage));\n\n  // Determine actual bar width (accounting for brackets if present)\n  const barWidth = input.width;\n\n  // Calculate filled/empty character counts\n  const filledCount = Math.round((percentage / 100) * barWidth);\n  const emptyCount = barWidth - filledCount;\n\n  // Get effective characters (allow override)\n  const filledChar = input.filledChar ?? chars.filled;\n  const emptyChar = input.emptyChar ?? chars.empty;\n\n  // Build bar strings\n  const filledBar = filledChar.repeat(filledCount);\n  const emptyBar = emptyChar.repeat(emptyCount);\n\n  // Format percentage\n  const percentageStr = `${String(Math.round(percentage))}%`;\n\n  // Format value\n  const valueStr = `${String(input.value)}/${String(input.max)}`;\n\n  return {\n    label: input.label ?? \"\",\n    filledBar,\n    emptyBar,\n    leftBracket: chars.leftBracket,\n    rightBracket: chars.rightBracket,\n    percentage,\n    percentageStr,\n    valueStr,\n    filledCount,\n    emptyCount,\n    barWidth,\n  };\n}\n","import { type TuiTheme, anchorLine, DEFAULT_ANCHOR } from \"@tuicomponents/core\";\nimport type { ProgressLayout } from \"./layout.js\";\nimport type { ProgressInputWithDefaults } from \"./schema.js\";\n\n/**\n * Render a progress bar using ANSI escape codes for rich terminal output.\n *\n * @param layout - Pre-computed progress layout\n * @param input - Original input with defaults\n * @param theme - Optional theme for colors\n * @returns ANSI-formatted progress bar string\n */\nexport function renderProgressAnsi(\n  layout: ProgressLayout,\n  input: ProgressInputWithDefaults,\n  theme?: TuiTheme\n): string {\n  const parts: string[] = [];\n\n  // Add label if present\n  if (layout.label) {\n    const coloredLabel = theme\n      ? theme.semantic.header(layout.label)\n      : layout.label;\n    parts.push(coloredLabel);\n    parts.push(\" \");\n  }\n\n  // Add left bracket\n  if (layout.leftBracket) {\n    const coloredBracket = theme\n      ? theme.semantic.border(layout.leftBracket)\n      : layout.leftBracket;\n    parts.push(coloredBracket);\n  }\n\n  // Add bar\n  const coloredFilled = theme\n    ? theme.semantic.primary(layout.filledBar)\n    : layout.filledBar;\n  const coloredEmpty = theme\n    ? theme.semantic.secondary(layout.emptyBar)\n    : layout.emptyBar;\n  parts.push(coloredFilled);\n  parts.push(coloredEmpty);\n\n  // Add right bracket\n  if (layout.rightBracket) {\n    const coloredBracket = theme\n      ? theme.semantic.border(layout.rightBracket)\n      : layout.rightBracket;\n    parts.push(coloredBracket);\n  }\n\n  // Add percentage and/or value\n  const suffix = buildSuffix(layout, input, theme);\n  if (suffix) {\n    parts.push(\" \");\n    parts.push(suffix);\n  }\n\n  return parts.join(\"\");\n}\n\n/**\n * Render a progress bar using markdown-friendly output.\n *\n * @param layout - Pre-computed progress layout\n * @param input - Original input with defaults\n * @returns Markdown-friendly progress bar string\n */\nexport function renderProgressMarkdown(\n  layout: ProgressLayout,\n  input: ProgressInputWithDefaults\n): string {\n  const parts: string[] = [];\n\n  // Add label if present\n  if (layout.label) {\n    parts.push(layout.label);\n    parts.push(\" \");\n  }\n\n  // Add left bracket\n  if (layout.leftBracket) {\n    parts.push(layout.leftBracket);\n  }\n\n  // Add bar\n  parts.push(layout.filledBar);\n  parts.push(layout.emptyBar);\n\n  // Add right bracket\n  if (layout.rightBracket) {\n    parts.push(layout.rightBracket);\n  }\n\n  // Add percentage and/or value\n  const suffix = buildSuffix(layout, input);\n  if (suffix) {\n    parts.push(\" \");\n    parts.push(suffix);\n  }\n\n  return anchorLine(parts.join(\"\"), DEFAULT_ANCHOR);\n}\n\n/**\n * Build the suffix string (percentage and/or value).\n */\nfunction buildSuffix(\n  layout: ProgressLayout,\n  input: ProgressInputWithDefaults,\n  theme?: TuiTheme\n): string {\n  const suffixParts: string[] = [];\n\n  if (input.showPercentage) {\n    suffixParts.push(layout.percentageStr);\n  }\n\n  if (input.showValue) {\n    suffixParts.push(layout.valueStr);\n  }\n\n  if (suffixParts.length === 0) {\n    return \"\";\n  }\n\n  const suffix = suffixParts.join(\" \");\n  return theme ? theme.semantic.secondary(suffix) : suffix;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@tuicomponents/progress",
+  "version": "0.1.1",
+  "description": "Horizontal progress bar component for TUI",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "tui",
+    "terminal",
+    "progress",
+    "progress-bar",
+    "visualization"
+  ],
+  "license": "UNLICENSED",
+  "dependencies": {
+    "zod": "^3.25.56",
+    "zod-to-json-schema": "^3.24.5",
+    "@tuicomponents/core": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "api-report": "api-extractor run",
+    "api-report:update": "api-extractor run --local",
+    "clean": "rm -rf dist"
+  }
+}