@sundaeswap/sprinkles 0.5.0 → 0.6.0

package/dist/esm/Sprinkle/menus/field-menu.js

@@ -0,0 +1,155 @@
+/**
+ * Field menu module for menu-based struct editing.
+ * Handles the sub-menu shown when selecting a field with an existing value.
+ */
+
+import { Separator } from "@inquirer/core";
+import { selectWithClear } from "../prompts.js";
+import { isNullable, hasDefault, getDefault } from "../type-guards.js";
+import { formatValuePreview } from "../utils/formatting.js";
+import { bigIntReplacer } from "../encryption.js";
+
+/**
+ * Options for the field menu prompt.
+ */
+
+/**
+ * Show a sub-menu for a field that has a value.
+ * Provides options to edit, view, clear, set null, or reset to default.
+ *
+ * @param options - Field menu options
+ * @returns The user's chosen action
+ */
+export async function promptFieldMenu(options) {
+  const {
+    fieldName,
+    fieldType,
+    state
+  } = options;
+  const nullable = isNullable(fieldType);
+  const hasDefaultVal = hasDefault(fieldType);
+  const defaultVal = hasDefaultVal ? getDefault(fieldType) : undefined;
+
+  // Build the display of current value
+  const currentDisplay = state.status === "null" ? "null" : state.status === "set" ? formatValuePreview(state.value, 40) : "[not set]";
+  const choices = [];
+
+  // Always offer edit
+  choices.push({
+    name: "Edit value",
+    value: "edit"
+  });
+
+  // View full value (only if there's a value to view)
+  if (state.status === "set") {
+    choices.push({
+      name: "View full value",
+      value: "view"
+    });
+  }
+
+  // For nullable fields with value: offer "Set to null" and "Clear value"
+  if (nullable && state.status === "set") {
+    choices.push({
+      name: "Set to null",
+      value: "setNull"
+    });
+    choices.push({
+      name: "Clear value (remove from output)",
+      value: "clear"
+    });
+  }
+
+  // For nullable fields that are null: offer "Clear value" to remove null
+  if (nullable && state.status === "null") {
+    choices.push({
+      name: "Clear value (remove from output)",
+      value: "clear"
+    });
+  }
+
+  // For non-nullable fields with default: offer "Reset to default"
+  if (hasDefaultVal && !nullable && state.status === "set") {
+    const defaultPreview = formatValuePreview(defaultVal, 20);
+    choices.push({
+      name: `Reset to default (${defaultPreview})`,
+      value: "reset"
+    });
+  }
+  choices.push(new Separator());
+  choices.push({
+    name: "Back (keep current)",
+    value: "back"
+  });
+  const selection = await selectWithClear({
+    message: `${fieldName}: ${currentDisplay}`,
+    choices
+  });
+
+  // Escape returns to menu
+  if (selection === null) {
+    return {
+      action: "back"
+    };
+  }
+  switch (selection) {
+    case "edit":
+      // Caller will handle the actual editing
+      return {
+        action: "edit"
+      };
+    case "view":
+      return {
+        action: "view"
+      };
+    case "clear":
+      return {
+        action: "clear"
+      };
+    case "setNull":
+      return {
+        action: "setNull"
+      };
+    case "reset":
+      return {
+        action: "reset",
+        defaultValue: defaultVal
+      };
+    case "back":
+    default:
+      return {
+        action: "back"
+      };
+  }
+}
+
+/**
+ * Display the full value of a field.
+ * Shows formatted JSON and waits for user to press Enter.
+ *
+ * @param fieldName - The field name
+ * @param value - The value to display
+ */
+export async function displayFullValue(fieldName, value) {
+  const header = `Current value of ${fieldName}:`;
+  const jsonStr = JSON.stringify(value, bigIntReplacer, 2);
+  const jsonLines = jsonStr.split("\n").length;
+  console.log("");
+  console.log(header);
+  console.log(jsonStr);
+  console.log("");
+
+  // Wait for user to press Enter
+  await selectWithClear({
+    message: "Press Enter to continue...",
+    choices: [{
+      name: "Continue",
+      value: "continue"
+    }]
+  });
+
+  // Clear all the output lines: empty line + header + json lines + empty line
+  const totalLines = 1 + 1 + jsonLines + 1;
+  process.stdout.write("\x1b[1A\x1b[2K".repeat(totalLines) + "\x1b[G");
+}
+//# sourceMappingURL=field-menu.js.map

package/dist/esm/Sprinkle/menus/field-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-menu.js","names":["Separator","selectWithClear","isNullable","hasDefault","getDefault","formatValuePreview","bigIntReplacer","promptFieldMenu","options","fieldName","fieldType","state","nullable","hasDefaultVal","defaultVal","undefined","currentDisplay","status","value","choices","push","name","defaultPreview","selection","message","action","defaultValue","displayFullValue","header","jsonStr","JSON","stringify","jsonLines","split","length","console","log","totalLines","process","stdout","write","repeat"],"sources":["../../../../src/Sprinkle/menus/field-menu.ts"],"sourcesContent":["/**\n * Field menu module for menu-based struct editing.\n * Handles the sub-menu shown when selecting a field with an existing value.\n */\n\nimport { Separator } from \"@inquirer/core\";\nimport type { TSchema } from \"@sinclair/typebox\";\nimport { selectWithClear } from \"../prompts.js\";\nimport type { FieldMenuResult, FieldState } from \"../types.js\";\nimport { isNullable, hasDefault, getDefault } from \"../type-guards.js\";\nimport { formatValuePreview } from \"../utils/formatting.js\";\nimport { bigIntReplacer } from \"../encryption.js\";\n\n/**\n * Options for the field menu prompt.\n */\nexport interface FieldMenuOptions<T> {\n  /** The field name */\n  fieldName: string;\n  /** The field's schema */\n  fieldType: TSchema;\n  /** Current state of the field */\n  state: FieldState<T>;\n}\n\n/**\n * Show a sub-menu for a field that has a value.\n * Provides options to edit, view, clear, set null, or reset to default.\n *\n * @param options - Field menu options\n * @returns The user's chosen action\n */\nexport async function promptFieldMenu<T>(\n  options: FieldMenuOptions<T>,\n): Promise<FieldMenuResult<T>> {\n  const { fieldName, fieldType, state } = options;\n\n  const nullable = isNullable(fieldType);\n  const hasDefaultVal = hasDefault(fieldType);\n  const defaultVal = hasDefaultVal ? getDefault(fieldType) : undefined;\n\n  // Build the display of current value\n  const currentDisplay =\n    state.status === \"null\"\n      ? \"null\"\n      : state.status === \"set\"\n        ? formatValuePreview(state.value, 40)\n        : \"[not set]\";\n\n  const choices: Array<{ name: string; value: string } | Separator> = [];\n\n  // Always offer edit\n  choices.push({ name: \"Edit value\", value: \"edit\" });\n\n  // View full value (only if there's a value to view)\n  if (state.status === \"set\") {\n    choices.push({ name: \"View full value\", value: \"view\" });\n  }\n\n  // For nullable fields with value: offer \"Set to null\" and \"Clear value\"\n  if (nullable && state.status === \"set\") {\n    choices.push({ name: \"Set to null\", value: \"setNull\" });\n    choices.push({ name: \"Clear value (remove from output)\", value: \"clear\" });\n  }\n\n  // For nullable fields that are null: offer \"Clear value\" to remove null\n  if (nullable && state.status === \"null\") {\n    choices.push({ name: \"Clear value (remove from output)\", value: \"clear\" });\n  }\n\n  // For non-nullable fields with default: offer \"Reset to default\"\n  if (hasDefaultVal && !nullable && state.status === \"set\") {\n    const defaultPreview = formatValuePreview(defaultVal, 20);\n    choices.push({\n      name: `Reset to default (${defaultPreview})`,\n      value: \"reset\",\n    });\n  }\n\n  choices.push(new Separator());\n  choices.push({ name: \"Back (keep current)\", value: \"back\" });\n\n  const selection = await selectWithClear({\n    message: `${fieldName}: ${currentDisplay}`,\n    choices,\n  });\n\n  // Escape returns to menu\n  if (selection === null) {\n    return { action: \"back\" };\n  }\n\n  switch (selection) {\n    case \"edit\":\n      // Caller will handle the actual editing\n      return { action: \"edit\" };\n\n    case \"view\":\n      return { action: \"view\" };\n\n    case \"clear\":\n      return { action: \"clear\" };\n\n    case \"setNull\":\n      return { action: \"setNull\" };\n\n    case \"reset\":\n      return { action: \"reset\", defaultValue: defaultVal as T };\n\n    case \"back\":\n    default:\n      return { action: \"back\" };\n  }\n}\n\n/**\n * Display the full value of a field.\n * Shows formatted JSON and waits for user to press Enter.\n *\n * @param fieldName - The field name\n * @param value - The value to display\n */\nexport async function displayFullValue(\n  fieldName: string,\n  value: unknown,\n): Promise<void> {\n  const header = `Current value of ${fieldName}:`;\n  const jsonStr = JSON.stringify(value, bigIntReplacer, 2);\n  const jsonLines = jsonStr.split(\"\\n\").length;\n\n  console.log(\"\");\n  console.log(header);\n  console.log(jsonStr);\n  console.log(\"\");\n\n  // Wait for user to press Enter\n  await selectWithClear({\n    message: \"Press Enter to continue...\",\n    choices: [{ name: \"Continue\", value: \"continue\" }],\n  });\n\n  // Clear all the output lines: empty line + header + json lines + empty line\n  const totalLines = 1 + 1 + jsonLines + 1;\n  process.stdout.write(\"\\x1b[1A\\x1b[2K\".repeat(totalLines) + \"\\x1b[G\");\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/Sprinkle/menus/index.js

@@ -0,0 +1,8 @@
+/**
+ * Menu modules for menu-based struct editing.
+ */
+
+export { promptFieldMenu, displayFullValue } from "./field-menu.js";
+export { promptObject } from "./object-menu.js";
+export { promptArray } from "./array-menu.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/Sprinkle/menus/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["promptFieldMenu","displayFullValue","promptObject","promptArray"],"sources":["../../../../src/Sprinkle/menus/index.ts"],"sourcesContent":["/**\n * Menu modules for menu-based struct editing.\n */\n\nexport { promptFieldMenu, displayFullValue } from \"./field-menu.js\";\nexport type { FieldMenuOptions } from \"./field-menu.js\";\n\nexport { promptObject } from \"./object-menu.js\";\nexport type { ObjectMenuOptions, FillFunction } from \"./object-menu.js\";\n\nexport { promptArray } from \"./array-menu.js\";\nexport type { ArrayMenuOptions } from \"./array-menu.js\";\n"],"mappings":"AAAA;AACA;AACA;;AAEA,SAASA,eAAe,EAAEC,gBAAgB,QAAQ,iBAAiB;AAGnE,SAASC,YAAY,QAAQ,kBAAkB;AAG/C,SAASC,WAAW,QAAQ,iBAAiB","ignoreList":[]}

package/dist/esm/Sprinkle/menus/object-menu.js

@@ -0,0 +1,318 @@
+/**
+ * Object menu module for menu-based struct editing.
+ * Shows all fields of an object and allows non-linear editing.
+ */
+
+import { Separator } from "@inquirer/core";
+import { selectWithClear, confirmWithClear, clearLines } from "../prompts.js";
+import colors from "yoctocolors-cjs";
+import { UserCancelledError } from "../types.js";
+import { isOptional, hasDefault, getDefault, isLiteral } from "../type-guards.js";
+import { buildFieldLabel, countRequiredFields, allRequiredFieldsFilled, getInitialFieldState, isFieldRequired } from "../utils/field-utils.js";
+import { formatBreadcrumb } from "../utils/formatting.js";
+import { promptFieldMenu, displayFullValue } from "./field-menu.js";
+
+/**
+ * Type for the fill function that handles individual field types.
+ */
+
+/**
+ * Options for the object menu prompt.
+ */
+
+/**
+ * Show a menu-based editor for an object.
+ * Allows non-linear editing of fields with Submit/Cancel.
+ *
+ * @param options - Object menu options
+ * @returns The edited object or cancel result
+ */
+export async function promptObject(options) {
+  const {
+    type,
+    path,
+    defs,
+    defaults = {},
+    fillField
+  } = options;
+  const fields = type.properties;
+  const fieldNames = Object.keys(fields);
+
+  // Edge case: empty struct
+  if (fieldNames.length === 0) {
+    return {
+      action: "submit",
+      value: {}
+    };
+  }
+
+  // Edge case: single required field with no optionals - skip menu
+  const requiredFields = fieldNames.filter(name => isFieldRequired(fields[name]));
+  const optionalFields = fieldNames.filter(name => !isFieldRequired(fields[name]));
+  if (requiredFields.length === 1 && optionalFields.length === 0) {
+    const fieldName = requiredFields[0];
+    const fieldType = fields[fieldName];
+    try {
+      const value = await fillField(fieldType, [...path, fieldName], defs, defaults[fieldName]);
+      return {
+        action: "submit",
+        value: {
+          [fieldName]: value
+        }
+      };
+    } catch (e) {
+      if (e instanceof UserCancelledError) {
+        return {
+          action: "cancel"
+        };
+      }
+      throw e;
+    }
+  }
+
+  // Initialize state for all fields
+  const state = new Map();
+  for (const fieldName of fieldNames) {
+    const fieldType = fields[fieldName];
+    // Auto-fill Literal fields with their const value
+    if (isLiteral(fieldType)) {
+      state.set(fieldName, {
+        status: "set",
+        value: fieldType.const
+      });
+    } else {
+      state.set(fieldName, getInitialFieldState(fieldType, defaults[fieldName]));
+    }
+  }
+
+  // Main menu loop
+  while (true) {
+    const {
+      total,
+      filled
+    } = countRequiredFields(type, state);
+    const canSubmit = allRequiredFieldsFilled(type, state);
+
+    // Build menu choices
+    const choices = [];
+
+    // Add field items
+    for (const fieldName of fieldNames) {
+      const fieldType = fields[fieldName];
+      const fieldState = state.get(fieldName);
+      const label = buildFieldLabel(fieldName, fieldType, fieldState);
+      choices.push({
+        name: label,
+        value: `field:${fieldName}`
+      });
+    }
+
+    // Add separator and actions
+    choices.push(new Separator("\u2500\u2500\u2500 Actions \u2500\u2500\u2500"));
+
+    // Submit button
+    if (canSubmit) {
+      choices.push({
+        name: "Submit",
+        value: "submit"
+      });
+    } else {
+      choices.push({
+        name: `Submit (${filled} of ${total} required complete)`,
+        value: "submit",
+        disabled: true
+      });
+    }
+    choices.push({
+      name: "Cancel",
+      value: "cancel"
+    });
+
+    // Show breadcrumb header if we're in a nested path
+    const breadcrumb = formatBreadcrumb(path);
+    if (breadcrumb) {
+      console.log(colors.dim(`📍 ${breadcrumb}`));
+    }
+
+    // Show menu
+    const selection = await selectWithClear({
+      message: "Edit:",
+      choices
+    });
+
+    // Clear the breadcrumb line too if we printed one
+    if (breadcrumb) {
+      clearLines(1);
+    }
+
+    // Handle escape
+    if (selection === null) {
+      // Check if any values have been set
+      const hasValues = Array.from(state.values()).some(s => s.status === "set" || s.status === "null");
+      if (hasValues) {
+        const confirmCancel = await confirmWithClear({
+          message: "Discard changes?",
+          default: false
+        });
+        if (confirmCancel === null || confirmCancel === false) {
+          continue; // Return to menu
+        }
+      }
+      return {
+        action: "cancel"
+      };
+    }
+
+    // Handle submit
+    if (selection === "submit") {
+      if (!canSubmit) {
+        continue; // Shouldn't happen due to disabled, but be safe
+      }
+      const result = buildResultObject(fields, state, defs);
+      return {
+        action: "submit",
+        value: result
+      };
+    }
+
+    // Handle cancel
+    if (selection === "cancel") {
+      const hasValues = Array.from(state.values()).some(s => s.status === "set" || s.status === "null");
+      if (hasValues) {
+        const confirmCancel = await confirmWithClear({
+          message: "Discard changes?",
+          default: false
+        });
+        if (confirmCancel === null || confirmCancel === false) {
+          continue;
+        }
+      }
+      return {
+        action: "cancel"
+      };
+    }
+
+    // Handle field selection
+    if (typeof selection === "string" && selection.startsWith("field:")) {
+      const fieldName = selection.slice(6);
+      const fieldType = fields[fieldName];
+      const fieldState = state.get(fieldName);
+
+      // If field has a value, show field sub-menu
+      if (fieldState.status === "set" || fieldState.status === "null") {
+        const menuResult = await promptFieldMenu({
+          fieldName,
+          fieldType,
+          state: fieldState
+        });
+        switch (menuResult.action) {
+          case "edit":
+            {
+              // Edit the field
+              try {
+                const newValue = await fillField(fieldType, [...path, fieldName], defs, fieldState.status === "set" ? fieldState.value : undefined);
+                state.set(fieldName, {
+                  status: "set",
+                  value: newValue
+                });
+              } catch (e) {
+                if (e instanceof UserCancelledError) {
+                  // Return to menu without changing
+                  continue;
+                }
+                throw e;
+              }
+              break;
+            }
+          case "view":
+            {
+              if (fieldState.status === "set") {
+                await displayFullValue(fieldName, fieldState.value);
+              }
+              break;
+            }
+          case "clear":
+            {
+              state.set(fieldName, {
+                status: "unset"
+              });
+              break;
+            }
+          case "setNull":
+            {
+              state.set(fieldName, {
+                status: "null"
+              });
+              break;
+            }
+          case "reset":
+            {
+              // Reset to default value - show as unset, will use default on submit
+              state.set(fieldName, {
+                status: "unset"
+              });
+              break;
+            }
+          case "back":
+            // Do nothing, return to main menu
+            break;
+        }
+      } else {
+        // Field is unset - directly prompt for value
+        try {
+          const newValue = await fillField(fieldType, [...path, fieldName], defs, defaults[fieldName]);
+          // If user skipped an optional field (returned undefined), leave as unset
+          if (newValue === undefined) {
+            // Don't change state - field remains unset
+          } else {
+            state.set(fieldName, {
+              status: "set",
+              value: newValue
+            });
+          }
+        } catch (e) {
+          if (e instanceof UserCancelledError) {
+            // Return to menu without changing
+            continue;
+          }
+          throw e;
+        }
+      }
+    }
+  }
+}
+
+/**
+ * Build the result object from the state map.
+ * Applies defaults for unset fields with defaults.
+ */
+function buildResultObject(fields, state, _defs) {
+  const result = {};
+  for (const [fieldName, fieldType] of Object.entries(fields)) {
+    const fieldState = state.get(fieldName);
+    if (!fieldState || fieldState.status === "unset") {
+      // If optional, skip (undefined)
+      if (isOptional(fieldType)) {
+        continue;
+      }
+
+      // If field has a default, use it
+      if (hasDefault(fieldType)) {
+        result[fieldName] = getDefault(fieldType);
+        continue;
+      }
+
+      // No value, no default: omit from output
+      continue;
+    }
+    if (fieldState.status === "null") {
+      result[fieldName] = null;
+      continue;
+    }
+    if (fieldState.status === "set") {
+      result[fieldName] = fieldState.value;
+    }
+  }
+  return result;
+}
+//# sourceMappingURL=object-menu.js.map

package/dist/esm/Sprinkle/menus/object-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-menu.js","names":["Separator","selectWithClear","confirmWithClear","clearLines","colors","UserCancelledError","isOptional","hasDefault","getDefault","isLiteral","buildFieldLabel","countRequiredFields","allRequiredFieldsFilled","getInitialFieldState","isFieldRequired","formatBreadcrumb","promptFieldMenu","displayFullValue","promptObject","options","type","path","defs","defaults","fillField","fields","properties","fieldNames","Object","keys","length","action","value","requiredFields","filter","name","optionalFields","fieldName","fieldType","e","state","Map","set","status","const","total","filled","canSubmit","choices","fieldState","get","label","push","disabled","breadcrumb","console","log","dim","selection","message","hasValues","Array","from","values","some","s","confirmCancel","default","result","buildResultObject","startsWith","slice","menuResult","newValue","undefined","_defs","entries"],"sources":["../../../../src/Sprinkle/menus/object-menu.ts"],"sourcesContent":["/**\n * Object menu module for menu-based struct editing.\n * Shows all fields of an object and allows non-linear editing.\n */\n\nimport { Separator } from \"@inquirer/core\";\nimport type { TObject, TSchema } from \"@sinclair/typebox\";\nimport { selectWithClear, confirmWithClear, clearLines } from \"../prompts.js\";\nimport colors from \"yoctocolors-cjs\";\nimport type { FieldState, ObjectMenuResult } from \"../types.js\";\nimport { UserCancelledError } from \"../types.js\";\nimport { isOptional, hasDefault, getDefault, isNullable, isLiteral } from \"../type-guards.js\";\nimport {\n  buildFieldLabel,\n  countRequiredFields,\n  allRequiredFieldsFilled,\n  getInitialFieldState,\n  isFieldRequired,\n} from \"../utils/field-utils.js\";\nimport { formatBreadcrumb } from \"../utils/formatting.js\";\nimport { promptFieldMenu, displayFullValue } from \"./field-menu.js\";\n\n/**\n * Type for the fill function that handles individual field types.\n */\nexport type FillFunction = <U extends TSchema>(\n  type: U,\n  path: string[],\n  defs: Record<string, TSchema>,\n  def?: unknown,\n) => Promise<unknown>;\n\n/**\n * Options for the object menu prompt.\n */\nexport interface ObjectMenuOptions {\n  /** The object schema */\n  type: TObject;\n  /** Current path for display */\n  path: string[];\n  /** Type definitions for resolving refs */\n  defs: Record<string, TSchema>;\n  /** Default/existing values */\n  defaults?: Record<string, unknown>;\n  /** Function to fill individual fields */\n  fillField: FillFunction;\n}\n\n/**\n * Show a menu-based editor for an object.\n * Allows non-linear editing of fields with Submit/Cancel.\n *\n * @param options - Object menu options\n * @returns The edited object or cancel result\n */\nexport async function promptObject<T extends Record<string, unknown>>(\n  options: ObjectMenuOptions,\n): Promise<ObjectMenuResult<T>> {\n  const { type, path, defs, defaults = {}, fillField } = options;\n\n  const fields = type.properties as Record<string, TSchema>;\n  const fieldNames = Object.keys(fields);\n\n  // Edge case: empty struct\n  if (fieldNames.length === 0) {\n    return { action: \"submit\", value: {} as T };\n  }\n\n  // Edge case: single required field with no optionals - skip menu\n  const requiredFields = fieldNames.filter((name) =>\n    isFieldRequired(fields[name]!),\n  );\n  const optionalFields = fieldNames.filter(\n    (name) => !isFieldRequired(fields[name]!),\n  );\n\n  if (requiredFields.length === 1 && optionalFields.length === 0) {\n    const fieldName = requiredFields[0]!;\n    const fieldType = fields[fieldName]!;\n    try {\n      const value = await fillField(\n        fieldType,\n        [...path, fieldName],\n        defs,\n        defaults[fieldName],\n      );\n      return {\n        action: \"submit\",\n        value: { [fieldName]: value } as T,\n      };\n    } catch (e) {\n      if (e instanceof UserCancelledError) {\n        return { action: \"cancel\" };\n      }\n      throw e;\n    }\n  }\n\n  // Initialize state for all fields\n  const state = new Map<string, FieldState>();\n  for (const fieldName of fieldNames) {\n    const fieldType = fields[fieldName]!;\n    // Auto-fill Literal fields with their const value\n    if (isLiteral(fieldType)) {\n      state.set(fieldName, { status: \"set\", value: fieldType.const });\n    } else {\n      state.set(fieldName, getInitialFieldState(fieldType, defaults[fieldName]));\n    }\n  }\n\n  // Main menu loop\n  while (true) {\n    const { total, filled } = countRequiredFields(type, state);\n    const canSubmit = allRequiredFieldsFilled(type, state);\n\n    // Build menu choices\n    const choices: Array<{ name: string; value: string; disabled?: boolean | string } | Separator> = [];\n\n    // Add field items\n    for (const fieldName of fieldNames) {\n      const fieldType = fields[fieldName]!;\n      const fieldState = state.get(fieldName)!;\n      const label = buildFieldLabel(fieldName, fieldType, fieldState);\n      choices.push({ name: label, value: `field:${fieldName}` });\n    }\n\n    // Add separator and actions\n    choices.push(new Separator(\"\\u2500\\u2500\\u2500 Actions \\u2500\\u2500\\u2500\"));\n\n    // Submit button\n    if (canSubmit) {\n      choices.push({ name: \"Submit\", value: \"submit\" });\n    } else {\n      choices.push({\n        name: `Submit (${filled} of ${total} required complete)`,\n        value: \"submit\",\n        disabled: true,\n      });\n    }\n\n    choices.push({ name: \"Cancel\", value: \"cancel\" });\n\n    // Show breadcrumb header if we're in a nested path\n    const breadcrumb = formatBreadcrumb(path);\n    if (breadcrumb) {\n      console.log(colors.dim(`📍 ${breadcrumb}`));\n    }\n\n    // Show menu\n    const selection = await selectWithClear({\n      message: \"Edit:\",\n      choices,\n    });\n\n    // Clear the breadcrumb line too if we printed one\n    if (breadcrumb) {\n      clearLines(1);\n    }\n\n    // Handle escape\n    if (selection === null) {\n      // Check if any values have been set\n      const hasValues = Array.from(state.values()).some(\n        (s) => s.status === \"set\" || s.status === \"null\",\n      );\n\n      if (hasValues) {\n        const confirmCancel = await confirmWithClear({\n          message: \"Discard changes?\",\n          default: false,\n        });\n        if (confirmCancel === null || confirmCancel === false) {\n          continue; // Return to menu\n        }\n      }\n      return { action: \"cancel\" };\n    }\n\n    // Handle submit\n    if (selection === \"submit\") {\n      if (!canSubmit) {\n        continue; // Shouldn't happen due to disabled, but be safe\n      }\n      const result = buildResultObject(fields, state, defs);\n      return { action: \"submit\", value: result as T };\n    }\n\n    // Handle cancel\n    if (selection === \"cancel\") {\n      const hasValues = Array.from(state.values()).some(\n        (s) => s.status === \"set\" || s.status === \"null\",\n      );\n\n      if (hasValues) {\n        const confirmCancel = await confirmWithClear({\n          message: \"Discard changes?\",\n          default: false,\n        });\n        if (confirmCancel === null || confirmCancel === false) {\n          continue;\n        }\n      }\n      return { action: \"cancel\" };\n    }\n\n    // Handle field selection\n    if (typeof selection === \"string\" && selection.startsWith(\"field:\")) {\n      const fieldName = selection.slice(6);\n      const fieldType = fields[fieldName]!;\n      const fieldState = state.get(fieldName)!;\n\n      // If field has a value, show field sub-menu\n      if (fieldState.status === \"set\" || fieldState.status === \"null\") {\n        const menuResult = await promptFieldMenu({\n          fieldName,\n          fieldType,\n          state: fieldState,\n        });\n\n        switch (menuResult.action) {\n          case \"edit\": {\n            // Edit the field\n            try {\n              const newValue = await fillField(\n                fieldType,\n                [...path, fieldName],\n                defs,\n                fieldState.status === \"set\" ? fieldState.value : undefined,\n              );\n              state.set(fieldName, { status: \"set\", value: newValue });\n            } catch (e) {\n              if (e instanceof UserCancelledError) {\n                // Return to menu without changing\n                continue;\n              }\n              throw e;\n            }\n            break;\n          }\n\n          case \"view\": {\n            if (fieldState.status === \"set\") {\n              await displayFullValue(fieldName, fieldState.value);\n            }\n            break;\n          }\n\n          case \"clear\": {\n            state.set(fieldName, { status: \"unset\" });\n            break;\n          }\n\n          case \"setNull\": {\n            state.set(fieldName, { status: \"null\" });\n            break;\n          }\n\n          case \"reset\": {\n            // Reset to default value - show as unset, will use default on submit\n            state.set(fieldName, { status: \"unset\" });\n            break;\n          }\n\n          case \"back\":\n            // Do nothing, return to main menu\n            break;\n        }\n      } else {\n        // Field is unset - directly prompt for value\n        try {\n          const newValue = await fillField(\n            fieldType,\n            [...path, fieldName],\n            defs,\n            defaults[fieldName],\n          );\n          // If user skipped an optional field (returned undefined), leave as unset\n          if (newValue === undefined) {\n            // Don't change state - field remains unset\n          } else {\n            state.set(fieldName, { status: \"set\", value: newValue });\n          }\n        } catch (e) {\n          if (e instanceof UserCancelledError) {\n            // Return to menu without changing\n            continue;\n          }\n          throw e;\n        }\n      }\n    }\n  }\n}\n\n/**\n * Build the result object from the state map.\n * Applies defaults for unset fields with defaults.\n */\nfunction buildResultObject(\n  fields: Record<string, TSchema>,\n  state: Map<string, FieldState>,\n  _defs: Record<string, TSchema>,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n\n  for (const [fieldName, fieldType] of Object.entries(fields)) {\n    const fieldState = state.get(fieldName);\n\n    if (!fieldState || fieldState.status === \"unset\") {\n      // If optional, skip (undefined)\n      if (isOptional(fieldType)) {\n        continue;\n      }\n\n      // If field has a default, use it\n      if (hasDefault(fieldType)) {\n        result[fieldName] = getDefault(fieldType);\n        continue;\n      }\n\n      // No value, no default: omit from output\n      continue;\n    }\n\n    if (fieldState.status === \"null\") {\n      result[fieldName] = null;\n      continue;\n    }\n\n    if (fieldState.status === \"set\") {\n      result[fieldName] = fieldState.value;\n    }\n  }\n\n  return result;\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/Sprinkle/prompts.js

@@ -61,7 +61,7 @@ function normalizeChoices(choices) {
 export const selectCancellable = createPrompt((config, done) => {
   const {
     loop = true,
-    pageSize = 7
+    pageSize = 15
   } = config;
   const theme = makeTheme(selectTheme, config.theme);
   const [status, setStatus] = useState("idle");
@@ -156,6 +156,64 @@ export const selectCancellable = createPrompt((config, done) => {
   const helpTip = colors.dim("(Use arrow keys, Enter to select, Esc to cancel)");
   return `${prefix} ${config.message} ${helpTip}\n${page}`;
 });
+
+/**
+ * Clears N lines above the cursor.
+ * Used after prompts to clean up menu output.
+ */
+export function clearLines(count) {
+  // Move up and clear each line
+  process.stdout.write("\x1b[1A\x1b[2K".repeat(count));
+}
+
+/**
+ * Select prompt that clears its output after completion.
+ * Returns the selected value or null if cancelled.
+ */
+export async function selectWithClear(config) {
+  const result = await selectCancellable(config);
+
+  // Clear the "done" line that inquirer left behind
+  // Move up one line, clear it, move cursor to start
+  process.stdout.write("\x1b[1A\x1b[2K\x1b[G");
+  return result;
+}
+
+/**
+ * Input prompt that clears its output after completion.
+ * Returns the input value or null if cancelled.
+ */
+export async function inputWithClear(config) {
+  const result = await inputCancellable(config);
+
+  // Clear the "done" line
+  process.stdout.write("\x1b[1A\x1b[2K\x1b[G");
+  return result;
+}
+
+/**
+ * Password prompt that clears its output after completion.
+ * Returns the password or null if cancelled.
+ */
+export async function passwordWithClear(config) {
+  const result = await passwordCancellable(config);
+
+  // Clear the "done" line
+  process.stdout.write("\x1b[1A\x1b[2K\x1b[G");
+  return result;
+}
+
+/**
+ * Confirm prompt that clears its output after completion.
+ * Returns true/false or null if cancelled.
+ */
+export async function confirmWithClear(config) {
+  const result = await confirmCancellable(config);
+
+  // Clear the "done" line
+  process.stdout.write("\x1b[1A\x1b[2K\x1b[G");
+  return result;
+}
 /**
  * Input prompt with escape key support.
  * Returns null if user presses Escape.