formshell 1.0.0

package/dist/index.js

@@ -0,0 +1,1070 @@
+const i = {
+  // Main color palette (CSS styling for console.log)
+  colors: {
+    primary: "#6366f1",
+    // Indigo
+    secondary: "#8b5cf6",
+    // Purple
+    accent: "#ec4899",
+    // Pink
+    success: "#10b981",
+    // Green
+    error: "#ef4444",
+    // Red
+    warning: "#f59e0b",
+    // Orange
+    info: "#3b82f6",
+    // Blue
+    text: {
+      primary: "#f8fafc",
+      // Almost pure white
+      secondary: "#cbd5e1",
+      // Light gray
+      muted: "#64748b",
+      // Medium gray
+      dark: "#1e293b"
+      // Dark gray for background
+    },
+    background: {
+      main: "#0f172a",
+      // Dark blue
+      secondary: "#1e293b",
+      // Lighter dark blue
+      accent: "#334155"
+      // Blue gray
+    }
+  },
+  // Unicode icons for UI elements
+  icons: {
+    checkmark: "✓",
+    cross: "✗",
+    star: "★",
+    starEmpty: "☆",
+    arrow: "➤",
+    bullet: "◆",
+    bulletEmpty: "◇",
+    chevron: "▸",
+    heart: "♥",
+    info: "ℹ",
+    warning: "⚠",
+    question: "?",
+    cursor: "█",
+    cursorBlink: "▊",
+    spinner: ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]
+  },
+  // Box drawing characters (Unicode)
+  box: {
+    // Single lines
+    topLeft: "┌",
+    topRight: "┐",
+    bottomLeft: "└",
+    bottomRight: "┘",
+    horizontal: "─",
+    vertical: "│",
+    // Double lines (for emphasis)
+    doubleTopLeft: "╔",
+    doubleTopRight: "╗",
+    doubleBottomLeft: "╚",
+    doubleBottomRight: "╝",
+    doubleHorizontal: "═",
+    doubleVertical: "║",
+    // Progress bar characters
+    filled: "▓",
+    empty: "░",
+    halfFilled: "▒",
+    // Shadow/gradient characters
+    shadow: ["░", "▒", "▓"],
+    fade: ["⣀", "⣄", "⣤", "⣦", "⣶", "⣷", "⣿"]
+  },
+  // Text styles (using Unicode characters or ANSI)
+  text: {
+    bold: (n) => `\x1B[1m${n}\x1B[0m`,
+    italic: (n) => `\x1B[3m${n}\x1B[0m`,
+    underline: (n) => `\x1B[4m${n}\x1B[0m`,
+    // Alternative using Unicode mathematical characters (fallback)
+    boldUnicode: (n) => {
+      const e = {
+        a: "𝗮",
+        b: "𝗯",
+        c: "𝗰",
+        d: "𝗱",
+        e: "𝗲",
+        f: "𝗳",
+        g: "𝗴",
+        h: "𝗵",
+        i: "𝗶",
+        j: "𝗷",
+        k: "𝗸",
+        l: "𝗹",
+        m: "𝗺",
+        n: "𝗻",
+        o: "𝗼",
+        p: "𝗽",
+        q: "𝗾",
+        r: "𝗿",
+        s: "𝘀",
+        t: "𝘁",
+        u: "𝘂",
+        v: "𝘃",
+        w: "𝘄",
+        x: "𝘅",
+        y: "𝘆",
+        z: "𝘇",
+        A: "𝗔",
+        B: "𝗕",
+        C: "𝗖",
+        D: "𝗗",
+        E: "𝗘",
+        F: "𝗙",
+        G: "𝗚",
+        H: "𝗛",
+        I: "𝗜",
+        J: "𝗝",
+        K: "𝗞",
+        L: "𝗟",
+        M: "𝗠",
+        N: "𝗡",
+        O: "𝗢",
+        P: "𝗣",
+        Q: "𝗤",
+        R: "𝗥",
+        S: "𝗦",
+        T: "𝗧",
+        U: "𝗨",
+        V: "𝗩",
+        W: "𝗪",
+        X: "𝗫",
+        Y: "𝗬",
+        Z: "𝗭",
+        0: "𝟬",
+        1: "𝟭",
+        2: "𝟮",
+        3: "𝟯",
+        4: "𝟰",
+        5: "𝟱",
+        6: "𝟲",
+        7: "𝟳",
+        8: "𝟴",
+        9: "𝟵"
+      };
+      return n.split("").map((t) => e[t] || t).join("");
+    }
+  },
+  // Style presets for common elements
+  styles: {
+    title: {
+      color: "#6366f1",
+      fontSize: "20px",
+      fontWeight: "bold",
+      textShadow: "0 0 10px rgba(99, 102, 241, 0.5)"
+    },
+    subtitle: {
+      color: "#8b5cf6",
+      fontSize: "16px",
+      fontWeight: "600"
+    },
+    body: {
+      color: "#f8fafc",
+      fontSize: "14px",
+      lineHeight: "1.5"
+    },
+    success: {
+      color: "#10b981",
+      fontSize: "14px",
+      fontWeight: "bold"
+    },
+    error: {
+      color: "#ef4444",
+      fontSize: "14px",
+      fontWeight: "bold"
+    },
+    muted: {
+      color: "#64748b",
+      fontSize: "13px",
+      fontStyle: "italic"
+    },
+    highlight: {
+      color: "#ec4899",
+      fontSize: "14px",
+      fontWeight: "bold",
+      textShadow: "0 0 8px rgba(236, 72, 153, 0.4)"
+    }
+  },
+  // Helper to create CSS style string for console.log
+  createStyle: (n) => Object.entries(n).filter((e) => e[1] !== void 0).map(([e, t]) => `${e.replace(/([A-Z])/g, "-$1").toLowerCase()}: ${t}`).join("; "),
+  // Preset messages with styles
+  format: {
+    title: (n) => [`%c${n}`, i.createStyle(i.styles.title)],
+    subtitle: (n) => [`%c${n}`, i.createStyle(i.styles.subtitle)],
+    body: (n) => [`%c${n}`, i.createStyle(i.styles.body)],
+    success: (n) => [`%c${i.icons.checkmark} ${n}`, i.createStyle(i.styles.success)],
+    error: (n) => [`%c${i.icons.cross} ${n}`, i.createStyle(i.styles.error)],
+    muted: (n) => [`%c${n}`, i.createStyle(i.styles.muted)],
+    highlight: (n) => [`%c${n}`, i.createStyle(i.styles.highlight)],
+    // Quick custom colors
+    colored: (n, e) => [`%c${n}`, `color: ${e}; font-size: 14px;`]
+  }
+};
+class d {
+  constructor(e) {
+    this.type = e.type, this.id = e.id, this.label = e.label, this.required = e.required !== !1, this.value = e.defaultValue ?? null, this.error = null, this.condition = "condition" in e ? e.condition : void 0;
+  }
+  /**
+   * Validate the field (to be overridden in subclasses)
+   */
+  validate(e) {
+    return this.required && (e == null || e === "") ? {
+      valid: !1,
+      error: "This field is required"
+    } : { valid: !0 };
+  }
+  /**
+   * Format the value for display
+   */
+  format(e) {
+    return String(e ?? "");
+  }
+  /**
+   * Get the current value
+   */
+  getValue() {
+    return this.value;
+  }
+  /**
+   * Set the value
+   */
+  setValue(e) {
+    const t = this.validate(e);
+    return t.valid ? (this.value = e, this.error = null, !0) : (this.error = t.error, !1);
+  }
+}
+class a extends d {
+  constructor(e) {
+    super(e), this.minLength = "minLength" in e ? e.minLength ?? null : null, this.maxLength = "maxLength" in e ? e.maxLength ?? null : null, this.pattern = "pattern" in e ? e.pattern ?? null : null;
+  }
+  validate(e) {
+    const t = super.validate(e);
+    if (!t.valid) return t;
+    if (!e && !this.required)
+      return { valid: !0 };
+    const r = String(e);
+    return this.minLength && r.length < this.minLength ? {
+      valid: !1,
+      error: `Minimum ${this.minLength} characters required`
+    } : this.maxLength && r.length > this.maxLength ? {
+      valid: !1,
+      error: `Maximum ${this.maxLength} characters allowed`
+    } : this.pattern && !this.pattern.test(r) ? {
+      valid: !1,
+      error: "Invalid format"
+    } : { valid: !0 };
+  }
+}
+class u extends d {
+  constructor(e) {
+    super(e), this.min = "min" in e && e.min !== void 0 ? e.min : null, this.max = "max" in e && e.max !== void 0 ? e.max : null, this.integer = "integer" in e ? e.integer ?? !1 : !1;
+  }
+  validate(e) {
+    const t = super.validate(e);
+    if (!t.valid) return t;
+    if (!e && !this.required)
+      return { valid: !0 };
+    const r = Number(e);
+    return isNaN(r) ? {
+      valid: !1,
+      error: "Must be a valid number"
+    } : this.integer && !Number.isInteger(r) ? {
+      valid: !1,
+      error: "Must be an integer"
+    } : this.min !== null && r < this.min ? {
+      valid: !1,
+      error: `Minimum value: ${this.min}`
+    } : this.max !== null && r > this.max ? {
+      valid: !1,
+      error: `Maximum value: ${this.max}`
+    } : { valid: !0 };
+  }
+  format(e) {
+    return e != null ? String(e) : "";
+  }
+}
+class V extends a {
+  constructor(e) {
+    super(e), this.pattern = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+  }
+  validate(e) {
+    const t = super.validate(e);
+    return t.valid ? t : {
+      valid: !1,
+      error: t.error === "Invalid format" ? "Invalid email address" : t.error
+    };
+  }
+}
+class I extends a {
+  constructor(e) {
+    super(e), this.pattern = /^https?:\/\/.+\..+/;
+  }
+  validate(e) {
+    const t = super.validate(e);
+    return t.valid ? t : {
+      valid: !1,
+      error: t.error === "Invalid format" ? "Invalid URL (must start with http:// or https://)" : t.error
+    };
+  }
+}
+class T extends a {
+  constructor(e) {
+    super(e), this.pattern = /^(0[1-9]|[12][0-9]|3[01])\/(0[1-9]|1[012])\/(19|20)\d\d$/;
+  }
+  validate(e) {
+    const t = super.validate(e);
+    if (!t.valid)
+      return {
+        valid: !1,
+        error: t.error === "Invalid format" ? "Invalid date (format: DD/MM/YYYY)" : t.error
+      };
+    if (e && typeof e == "string" && this.pattern.test(e)) {
+      const [r, s, o] = e.split("/").map(Number), l = new Date(o, s - 1, r);
+      if (l.getDate() !== r || l.getMonth() !== s - 1 || l.getFullYear() !== o)
+        return {
+          valid: !1,
+          error: "Invalid date (format: DD/MM/YYYY)"
+        };
+    }
+    return t;
+  }
+}
+class S extends d {
+  constructor(e) {
+    super(e), this.options = "options" in e ? e.options ?? [] : [];
+  }
+  validate(e) {
+    const t = super.validate(e);
+    if (!t.valid) return t;
+    if (!e && !this.required)
+      return { valid: !0 };
+    if (typeof e == "number")
+      return e < 1 || e > this.options.length ? {
+        valid: !1,
+        error: `Choose a number between 1 and ${this.options.length}`
+      } : { valid: !0 };
+    const r = this.options.map(
+      (s) => typeof s == "string" ? s : s.value
+    );
+    return typeof e == "string" && !r.includes(e) ? {
+      valid: !1,
+      error: "Invalid choice"
+    } : { valid: !0 };
+  }
+  setValue(e) {
+    if (typeof e == "number") {
+      const t = e - 1;
+      if (t >= 0 && t < this.options.length) {
+        const r = this.options[t], s = typeof r == "string" ? r : r.value;
+        return super.setValue(s);
+      }
+    }
+    return super.setValue(e);
+  }
+  format(e) {
+    if (!e) return "";
+    const t = this.options.find(
+      (r) => (typeof r == "string" ? r : r.value) === e
+    );
+    return typeof t == "string" ? t : (t == null ? void 0 : t.label) || String(e);
+  }
+}
+class x extends d {
+  constructor(e) {
+    super(e), this.options = "options" in e ? e.options ?? [] : [], this.minChoices = "minChoices" in e ? e.minChoices ?? (this.required ? 1 : 0) : this.required ? 1 : 0, this.maxChoices = "maxChoices" in e ? e.maxChoices ?? this.options.length : this.options.length;
+  }
+  validate(e) {
+    if (!Array.isArray(e))
+      return this.required ? {
+        valid: !1,
+        error: "Select at least 1 option(s)"
+      } : { valid: !0 };
+    if (e.length < this.minChoices)
+      return {
+        valid: !1,
+        error: `Select at least ${this.minChoices} option(s)`
+      };
+    if (e.length > this.maxChoices)
+      return {
+        valid: !1,
+        error: `Select maximum ${this.maxChoices} option(s)`
+      };
+    const t = this.options.map(
+      (r) => typeof r == "string" ? r : r.value
+    );
+    for (const r of e)
+      if (!t.includes(r))
+        return {
+          valid: !1,
+          error: "One or more choices are invalid"
+        };
+    return { valid: !0 };
+  }
+  setValue(e) {
+    if (typeof e == "string") {
+      const t = e.split(/[,\s]+/).map((s) => s.trim()).filter((s) => s), r = [];
+      for (const s of t) {
+        const o = Number(s);
+        if (!isNaN(o) && o >= 1 && o <= this.options.length) {
+          const l = this.options[o - 1];
+          r.push(typeof l == "string" ? l : l.value);
+        }
+      }
+      return super.setValue(r);
+    }
+    return super.setValue(e);
+  }
+  format(e) {
+    return !Array.isArray(e) || e.length === 0 ? "No selection" : e.map((r) => {
+      const s = this.options.find(
+        (o) => (typeof o == "string" ? o : o.value) === r
+      );
+      return typeof s == "string" ? s : (s == null ? void 0 : s.label) || r;
+    }).join(", ");
+  }
+}
+class y extends u {
+  constructor(e) {
+    super(e), this.min = "min" in e && e.min !== void 0 ? e.min : 1, this.max = "max" in e && e.max !== void 0 ? e.max : 5, this.integer = !0;
+  }
+  validate(e) {
+    const t = super.validate(e);
+    return t.valid ? t : {
+      valid: !1,
+      error: t.error.includes("number") ? `Enter a number from ${this.min} to ${this.max}` : t.error
+    };
+  }
+  format(e) {
+    return !e || typeof e != "number" ? "" : `${i.icons.star.repeat(e) + i.icons.starEmpty.repeat((this.max ?? 5) - e)} (${e}/${this.max})`;
+  }
+}
+class C extends d {
+  constructor(e) {
+    super(e), this.value = e.defaultValue || null;
+  }
+  validate(e) {
+    const t = super.validate(e);
+    if (!t.valid) return t;
+    if (typeof e == "boolean")
+      return { valid: !0 };
+    if (typeof e == "string") {
+      const r = e.toLowerCase().trim();
+      if (["y", "yes", "s", "si", "sì", "n", "no"].includes(r))
+        return { valid: !0 };
+    }
+    return {
+      valid: !1,
+      error: "Answer with Y (yes) or N (no)"
+    };
+  }
+  setValue(e) {
+    if (typeof e == "string") {
+      const t = e.toLowerCase().trim();
+      if (["y", "yes", "s", "si", "sì"].includes(t))
+        return this.value = !0, this.error = null, !0;
+      if (["n", "no"].includes(t))
+        return this.value = !1, this.error = null, !0;
+    }
+    return typeof e == "boolean" ? (this.value = e, this.error = null, !0) : (this.error = "Answer with Y (yes) or N (no)", !1);
+  }
+  format(e) {
+    return e === !0 ? "Yes" : e === !1 ? "No" : "";
+  }
+}
+const L = {
+  create(n) {
+    const e = (n.type || "text").toLowerCase();
+    switch (e) {
+      case "text":
+        return new a(n);
+      case "number":
+        return new u(n);
+      case "email":
+        return new V(n);
+      case "url":
+        return new I(n);
+      case "date":
+        return new T(n);
+      case "choice":
+        return new S(n);
+      case "multiple-choice":
+      case "multiplechoice":
+        return new x(n);
+      case "rating":
+        return new y(n);
+      case "yesno":
+      case "yes-no":
+        return new C(n);
+      default:
+        return console.warn(`Unknown field type: ${e}, defaulting to text`), new a(n);
+    }
+  }
+}, N = "\x1B";
+class A {
+  constructor() {
+    this.cursorVisible = !0, this.cursorInterval = null;
+  }
+  /**
+   * Initialize the renderer and start cursor blinking
+   */
+  init() {
+    this.startCursorBlink();
+  }
+  /**
+   * Clear the console
+   */
+  clear() {
+    console.clear();
+  }
+  /**
+   * Start the cursor blinking animation
+   */
+  startCursorBlink() {
+    this.cursorInterval && clearInterval(this.cursorInterval), this.cursorInterval = window.setInterval(() => {
+      this.cursorVisible = !this.cursorVisible;
+    }, 530);
+  }
+  /**
+   * Stop the cursor animation
+   */
+  stopCursorBlink() {
+    this.cursorInterval && (clearInterval(this.cursorInterval), this.cursorInterval = null);
+  }
+  /**
+   * Get the current cursor character
+   */
+  getCursor() {
+    return this.cursorVisible ? i.icons.cursor : " ";
+  }
+  /**
+   * Create a decorative horizontal line
+   */
+  createHorizontalLine(e = 60, t = i.box.horizontal) {
+    return t.repeat(e);
+  }
+  /**
+   * Create a box with Unicode borders
+   */
+  createBox(e, t = 60, r = "single") {
+    const s = [], o = r === "double", l = o ? i.box.doubleTopLeft : i.box.topLeft, h = o ? i.box.doubleTopRight : i.box.topRight, c = o ? i.box.doubleBottomLeft : i.box.bottomLeft, v = o ? i.box.doubleBottomRight : i.box.bottomRight, m = o ? i.box.doubleHorizontal : i.box.horizontal, p = o ? i.box.doubleVertical : i.box.vertical;
+    return s.push(l + m.repeat(t - 2) + h), (Array.isArray(e) ? e : [e]).forEach(($) => {
+      const f = String($), w = new RegExp(`${N}\\[[0-9;]*m`, "g"), M = f.replace(w, ""), g = t - 2 - M.length, b = Math.floor(g / 2), E = g - b;
+      s.push(p + " ".repeat(b) + f + " ".repeat(E) + p);
+    }), s.push(c + m.repeat(t - 2) + v), s;
+  }
+  /**
+   * Create an elegant progress bar
+   */
+  createProgressBar(e, t, r = 40) {
+    const s = Math.round(e / t * 100), o = Math.round(e / t * r), l = r - o, h = i.box.filled.repeat(o), c = i.box.empty.repeat(l);
+    return {
+      bar: h + c,
+      percentage: s,
+      text: `${e}/${t}`
+    };
+  }
+  /**
+   * Render the main title with style
+   */
+  renderTitle(e) {
+    const [t, r] = i.format.title(e);
+    console.log(t, r);
+  }
+  /**
+   * Render the subtitle with style
+   */
+  renderSubtitle(e) {
+    const [t, r] = i.format.subtitle(e);
+    console.log(t, r);
+  }
+  /**
+   * Render normal text
+   */
+  renderText(e, t = null) {
+    if (t) {
+      const [r, s] = i.format.colored(e, t);
+      console.log(r, s);
+    } else {
+      const [r, s] = i.format.body(e);
+      console.log(r, s);
+    }
+  }
+  /**
+   * Render a success message
+   */
+  renderSuccess(e) {
+    const [t, r] = i.format.success(e);
+    console.log(t, r);
+  }
+  /**
+   * Render an error message
+   */
+  renderError(e) {
+    const [t, r] = i.format.error(e);
+    console.log(t, r);
+  }
+  /**
+   * Render muted/secondary text
+   */
+  renderMuted(e) {
+    const [t, r] = i.format.muted(e);
+    console.log(t, r);
+  }
+  /**
+   * Render highlighted text
+   */
+  renderHighlight(e) {
+    const [t, r] = i.format.highlight(e);
+    console.log(t, r);
+  }
+  /**
+   * Render a complete box
+   */
+  renderBox(e, t = 60, r = "single") {
+    this.createBox(e, t, r).forEach((o) => {
+      this.renderText(o, i.colors.text.secondary);
+    });
+  }
+  /**
+   * Render a separator line
+   */
+  renderSeparator(e = 60, t = i.box.horizontal) {
+    const r = this.createHorizontalLine(e, t);
+    this.renderMuted(r);
+  }
+  /**
+   * Render the progress bar with info
+   */
+  renderProgress(e, t, r = "Progress") {
+    const s = this.createProgressBar(e, t);
+    console.log(""), this.renderMuted(`${r}: ${s.text} (${s.percentage}%)`), this.renderHighlight(s.bar), console.log("");
+  }
+  /**
+   * Render a list of options
+   */
+  renderOptions(e, t = null) {
+    e.forEach((r, s) => {
+      const o = s + 1;
+      t === s ? this.renderHighlight(`   ${o}. ${r}`) : this.renderText(`   ${o}. ${r}`, i.colors.text.secondary);
+    });
+  }
+  /**
+   * Render an input field with cursor
+   */
+  renderInput(e, t = "", r = !0) {
+    const s = r ? this.getCursor() : "", o = t + s;
+    console.log(""), this.renderHighlight(`${i.icons.chevron} ${e}`), console.log(""), this.renderText(`  ${o}`, i.colors.primary), console.log("");
+  }
+  /**
+   * Render a yes/no question
+   */
+  renderYesNo(e, t = null, r = "Yes", s = "No") {
+    console.log(""), this.renderHighlight(`${i.icons.question} ${e}`), console.log("");
+    const o = `  ${i.icons.bulletEmpty} Y - ${r}`, l = `  ${i.icons.bulletEmpty} N - ${s}`;
+    t === !0 ? (this.renderHighlight(o), this.renderMuted(l)) : t === !1 ? (this.renderMuted(o), this.renderHighlight(l)) : (this.renderMuted(o), this.renderMuted(l)), console.log("");
+  }
+  /**
+   * Render rating with stars
+   */
+  renderRating(e, t = 0, r = 5) {
+    console.log(""), this.renderHighlight(`${i.icons.star} ${e}`), console.log("");
+    let s = "";
+    for (let o = 1; o <= r; o++)
+      o <= t ? s += i.icons.star + " " : s += i.icons.starEmpty + " ";
+    this.renderText(`  ${s}`, i.colors.warning), this.renderMuted(`  (${t}/${r})`), console.log("");
+  }
+  /**
+   * Render a summary with key-value data
+   */
+  renderSummary(e, t) {
+    console.log(""), this.renderTitle(e), this.renderSeparator(60), console.log(""), Object.entries(t).forEach(([r, s]) => {
+      const o = r.charAt(0).toUpperCase() + r.slice(1);
+      this.renderText(`${i.icons.bullet} ${o}:`, i.colors.text.secondary), this.renderHighlight(`  ${s}`), console.log("");
+    }), this.renderSeparator(60);
+  }
+  /**
+   * Render a help/commands message
+   */
+  renderHelp(e, t = "Available Commands") {
+    console.log(""), this.renderTitle(`📋 ${t}`), this.renderSeparator(60), console.log(""), e.forEach(({ command: r, description: s }) => {
+      this.renderHighlight(`  ${i.icons.chevron} ${r}`), this.renderMuted(`    ${s}`), console.log("");
+    }), this.renderSeparator(60);
+  }
+  /**
+   * Render an animated welcome message
+   */
+  renderWelcome(e, t = null) {
+    this.clear(), console.log(""), console.log(""), this.renderTitle(`✨ ${e} ✨`), t && (console.log(""), this.renderSubtitle(t)), console.log(""), this.renderSeparator(60, i.box.doubleHorizontal), console.log("");
+  }
+  /**
+   * Render a spinner/loader (static, not animated)
+   */
+  renderLoader(e = "Loading...") {
+    const t = i.icons.spinner[0];
+    this.renderText(`${t} ${e}`, i.colors.info);
+  }
+  /**
+   * Cleanup the renderer
+   */
+  destroy() {
+    this.stopCursorBlink();
+  }
+}
+class k {
+  constructor(e) {
+    this.title = e.title || "Form", this.subtitle = e.subtitle || null, this.endpoint = e.endpoint || null, this.onComplete = e.onComplete || null, this.steps = this.initializeSteps(e.steps || []), this.currentStepIndex = -1, this.renderer = new A(), this.started = !1, this.completed = !1, this.startTime = null, this.helpActive = !1, this.renderer.init(), this.showWelcome();
+  }
+  /**
+   * Initialize steps with appropriate field types
+   */
+  initializeSteps(e) {
+    return e.map((t, r) => {
+      const s = L.create(t);
+      return {
+        id: t.id || `step_${r}`,
+        field: s,
+        description: t.description ?? null,
+        answered: !1
+      };
+    });
+  }
+  /**
+   * Show welcome screen
+   */
+  showWelcome() {
+    this.renderer.clear(), console.log(""), this.renderer.renderTitle(this.title), this.subtitle && this.renderer.renderMuted(this.subtitle), console.log(""), this.renderer.renderMuted("Type formShell.start() to begin or formShell.help() for available commands"), console.log("");
+  }
+  /**
+   * Show help screen with commands.
+   * Can be called at any time without interrupting the form flow.
+   * Use formShell.continue() to resume where you left off.
+   */
+  help() {
+    this.helpActive = !0, this.renderer.clear(), console.log(""), this.renderer.renderTitle(this.title), this.subtitle && this.renderer.renderMuted(this.subtitle), console.log(""), this.renderer.renderHighlight("Commands:"), this.renderer.renderMuted("  formShell.start()              Start the form"), this.renderer.renderMuted("  formShell.continue()           Resume the form"), this.renderer.renderMuted("  formShell.answer(...)          Answer and proceed"), this.renderer.renderMuted("  formShell.skip()               Skip (if optional)"), this.renderer.renderMuted("  formShell.y() / formShell.n()  Yes / No"), this.renderer.renderMuted("  formShell.back()               Go back"), this.renderer.renderMuted("  formShell.submit()             Submit (at the end)"), this.renderer.renderMuted("  formShell.reset()              Start over"), this.renderer.renderMuted("  formShell.help()               Show this help"), console.log(""), this.renderer.renderMuted("Type formShell.continue() to resume"), console.log("");
+  }
+  /**
+   * Start the form (only from welcome screen)
+   */
+  start() {
+    if (this.helpActive) {
+      this.renderer.renderError("Use formShell.continue() to resume the form first");
+      return;
+    }
+    if (this.started) {
+      this.renderer.renderError("Form already started. Use formShell.reset() to start over");
+      return;
+    }
+    const e = this.getNextVisibleStep(-1);
+    if (e >= this.steps.length) {
+      this.renderer.renderError("No visible steps in form");
+      return;
+    }
+    this.currentStepIndex = e, this.started = !0, this.startTime = Date.now(), this.renderCurrentStep();
+  }
+  /**
+   * Resume the form after viewing help
+   */
+  continue() {
+    if (!this.helpActive) {
+      this.started ? this.renderer.renderError("Use formShell.answer() to respond to the current question") : this.renderer.renderError("Use formShell.start() to begin the form");
+      return;
+    }
+    this.helpActive = !1, this.started ? this.completed ? this.showSummary() : this.renderCurrentStep() : this.showWelcome();
+  }
+  /**
+   * Check if a step should be shown based on its condition
+   */
+  shouldShowStep(e) {
+    const t = this.steps[e];
+    if (!t.field.condition)
+      return !0;
+    const r = this.collectData();
+    return t.field.condition(r);
+  }
+  /**
+   * Get next visible step index
+   */
+  getNextVisibleStep(e) {
+    for (let t = e + 1; t < this.steps.length; t++)
+      if (this.shouldShowStep(t))
+        return t;
+    return this.steps.length;
+  }
+  /**
+   * Get previous visible step index
+   */
+  getPreviousVisibleStep(e) {
+    for (let t = e - 1; t >= 0; t--)
+      if (this.shouldShowStep(t))
+        return t;
+    return -1;
+  }
+  /**
+   * Advance to next step (internal method)
+   */
+  _advanceStep() {
+    if (this.completed)
+      return;
+    const e = this.getNextVisibleStep(this.currentStepIndex);
+    e < this.steps.length ? (this.currentStepIndex = e, this.renderCurrentStep()) : (this.completed = !0, this.showSummary());
+  }
+  /**
+   * Go back to previous step
+   */
+  back() {
+    if (this.helpActive) {
+      this.renderer.renderError("Use formShell.continue() to resume the form first");
+      return;
+    }
+    const e = this.getPreviousVisibleStep(this.currentStepIndex);
+    if (e < 0) {
+      this.renderer.renderError("Already at first question. Use formShell.help() for commands");
+      return;
+    }
+    this.currentStepIndex = e, this.completed = !1, this.renderCurrentStep();
+  }
+  /**
+   * Answer the current question
+   */
+  answer(e) {
+    if (this.helpActive) {
+      this.renderer.renderError("Use formShell.continue() to resume the form first");
+      return;
+    }
+    if (!this.started) {
+      this.renderer.renderError("Use formShell.start() to begin the form");
+      return;
+    }
+    if (this.completed) {
+      this.renderer.renderError("Form already completed! Use formShell.submit() to send or formShell.reset() to start over");
+      return;
+    }
+    const t = this.steps[this.currentStepIndex], r = t.field;
+    r.setValue(e) ? (t.answered = !0, this.renderer.renderSuccess(`${r.format(r.getValue())}`), console.log(""), setTimeout(() => {
+      this._advanceStep();
+    }, 1e3)) : (this.renderer.renderError(r.error ?? "Invalid value"), console.log(""));
+  }
+  /**
+   * Shortcut to answer "Yes"
+   */
+  y() {
+    this.answer("y");
+  }
+  /**
+   * Shortcut to answer "No"
+   */
+  n() {
+    this.answer("n");
+  }
+  /**
+   * Skip the current question (only if not required)
+   */
+  skip() {
+    if (this.helpActive) {
+      this.renderer.renderError("Use formShell.continue() to resume the form first");
+      return;
+    }
+    if (!this.started) {
+      this.renderer.renderError("Use formShell.start() to begin the form");
+      return;
+    }
+    if (this.completed) {
+      this.renderer.renderError("Form already completed! Use formShell.submit() to send or formShell.reset() to start over");
+      return;
+    }
+    const e = this.steps[this.currentStepIndex], t = e.field;
+    if (t.required) {
+      this.renderer.renderError("This question is required and cannot be skipped"), console.log("");
+      return;
+    }
+    e.answered = !0, t.value = null, this.renderer.renderMuted("Skipped"), console.log(""), setTimeout(() => {
+      this._advanceStep();
+    }, 1e3);
+  }
+  /**
+   * Reset the form
+   */
+  reset() {
+    this.currentStepIndex = -1, this.started = !1, this.completed = !1, this.startTime = null, this.helpActive = !1, this.steps.forEach((e) => {
+      e.answered = !1, e.field.value = null, e.field.error = null;
+    }), this.showWelcome();
+  }
+  /**
+   * Submit data to server
+   */
+  async submit() {
+    if (this.helpActive) {
+      this.renderer.renderError("Use formShell.continue() to resume the form first");
+      return;
+    }
+    if (!this.completed) {
+      this.renderer.renderError("Complete all questions first!");
+      return;
+    }
+    const e = this.collectData();
+    console.log(""), this.renderer.renderMuted("Submitting...");
+    try {
+      if (this.endpoint) {
+        const t = await fetch(this.endpoint, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(e)
+        });
+        if (!t.ok)
+          throw new Error(`HTTP error! status: ${t.status}`);
+        const r = await t.json();
+        this.renderer.renderSuccess("Submitted!"), console.log(""), this.onComplete && await this.onComplete(r), console.log("Response:", r);
+      } else
+        this.renderer.renderSuccess("Completed!"), console.log(""), console.log("Data:", e), this.onComplete && await this.onComplete(e);
+    } catch (t) {
+      const r = t instanceof Error ? t.message : String(t);
+      this.renderer.renderError(`Error: ${r}`), console.log("");
+    }
+  }
+  /**
+   * Collect all form data
+   */
+  collectData() {
+    const e = {};
+    return this.steps.forEach((t) => {
+      e[t.field.id] = t.field.getValue();
+    }), e;
+  }
+  /**
+   * Calculate completion percentage
+   */
+  getProgress() {
+    const e = this.steps.filter(
+      (r, s) => this.shouldShowStep(s)
+    ), t = e.filter((r) => r.answered).length;
+    return {
+      current: t,
+      total: e.length,
+      percentage: e.length > 0 ? Math.round(t / e.length * 100) : 0
+    };
+  }
+  /**
+   * Estimate remaining time
+   */
+  getEstimatedTime() {
+    if (!this.startTime || this.currentStepIndex < 1)
+      return null;
+    const t = (Date.now() - this.startTime) / (this.currentStepIndex + 1), r = this.steps.length - this.currentStepIndex - 1, s = t * r, o = Math.round(s / 1e3);
+    return o < 60 ? `~${o}s` : `~${Math.round(o / 60)}m`;
+  }
+  /**
+   * Render the current step
+   */
+  renderCurrentStep() {
+    this.renderer.clear();
+    const e = this.steps[this.currentStepIndex], t = e.field;
+    console.log("");
+    const r = this.getProgress(), s = this.getVisibleStepNumber(this.currentStepIndex), o = this.renderer.createProgressBar(
+      s,
+      r.total,
+      30
+    );
+    this.renderer.renderMuted(`[${o.bar}] ${o.text}`), console.log(""), this.renderer.renderHighlight(`${s}. ${t.label}`), e.description && this.renderer.renderMuted(`   ${e.description}`), console.log(""), this.renderField(t);
+  }
+  /**
+   * Get the visible step number (position among visible steps)
+   */
+  getVisibleStepNumber(e) {
+    let t = 0;
+    for (let r = 0; r <= e; r++)
+      this.shouldShowStep(r) && t++;
+    return t;
+  }
+  /**
+   * Render a field based on its type
+   */
+  renderField(e) {
+    if (e instanceof y) {
+      this.renderer.renderMuted(`   formShell.answer(1-${e.max})`);
+      const t = i.icons.starEmpty.repeat(e.max ?? 5);
+      this.renderer.renderText(`   ${t}`, i.colors.warning);
+    } else if (e instanceof S)
+      this.renderer.renderOptions(
+        e.options.map(
+          (t) => typeof t == "string" ? t : t.label
+        )
+      ), this.renderer.renderMuted("   formShell.answer(number)");
+    else if (e instanceof x)
+      this.renderer.renderOptions(
+        e.options.map(
+          (t) => typeof t == "string" ? t : t.label
+        )
+      ), this.renderer.renderMuted('   formShell.answer("1,2,3")');
+    else if (e.type === "yesno")
+      this.renderer.renderMuted("   formShell.y() / formShell.n()");
+    else {
+      const t = this.getPlaceholder(e);
+      this.renderer.renderMuted(`   formShell.answer("${t}")`);
+    }
+    e.required || this.renderer.renderMuted("   formShell.skip() to skip"), console.log("");
+  }
+  /**
+   * Get a placeholder for the field
+   */
+  getPlaceholder(e) {
+    switch (e.type) {
+      case "email":
+        return "email@example.com";
+      case "url":
+        return "https://...";
+      case "date":
+        return "DD/MM/YYYY";
+      case "number":
+        return e instanceof u && e.min !== null ? `${e.min}-${e.max ?? "..."}` : "number";
+      default:
+        return "your answer";
+    }
+  }
+  /**
+   * Show final summary
+   */
+  showSummary() {
+    this.renderer.clear(), console.log(""), this.renderer.renderTitle("Summary"), console.log("");
+    let e = 1;
+    this.steps.forEach((t) => {
+      if (t.field.condition) {
+        const l = this.collectData();
+        if (!t.field.condition(l))
+          return;
+      }
+      const r = t.field, s = r.getValue(), o = r.format(s);
+      this.renderer.renderMuted(`${e}. ${r.label}`), this.renderer.renderHighlight(`   ${o}`), e++;
+    }), console.log(""), this.renderer.renderSuccess("Completed!"), this.renderer.renderMuted("formShell.submit() to send | formShell.back() to modify"), console.log("");
+  }
+  /**
+   * Cleanup when form is destroyed
+   */
+  destroy() {
+    this.renderer.destroy();
+  }
+}
+export {
+  d as BaseField,
+  S as ChoiceField,
+  T as DateField,
+  V as EmailField,
+  L as FieldFactory,
+  k as FormShell,
+  x as MultipleChoiceField,
+  u as NumberField,
+  y as RatingField,
+  A as TUIRenderer,
+  a as TextField,
+  i as Theme,
+  I as URLField,
+  C as YesNoField,
+  k as default
+};
+//# sourceMappingURL=index.js.map