@ncukondo/reference-manager 0.6.0 → 0.7.0

package/dist/chunks/search-prompt-D67WyKrY.js

@@ -0,0 +1,179 @@
+function formatSingleAuthor(author) {
+  if (author.literal) {
+    return author.literal;
+  }
+  if (author.family) {
+    if (author.given) {
+      const initial = author.given.charAt(0).toUpperCase();
+      return `${author.family}, ${initial}.`;
+    }
+    return author.family;
+  }
+  return "";
+}
+function formatAuthors(authors) {
+  if (!authors || authors.length === 0) {
+    return "";
+  }
+  if (authors.length > 3) {
+    const first = authors[0];
+    if (!first) {
+      return "";
+    }
+    return `${formatSingleAuthor(first)}, et al.`;
+  }
+  const formatted = authors.map(formatSingleAuthor);
+  if (formatted.length === 1) {
+    return formatted[0] ?? "";
+  }
+  const allButLast = formatted.slice(0, -1).join(", ");
+  const last = formatted[formatted.length - 1] ?? "";
+  return `${allButLast}, & ${last}`;
+}
+function formatTitle(title, maxWidth) {
+  if (!title) {
+    return "";
+  }
+  if (title.length <= maxWidth) {
+    return title;
+  }
+  return `${title.slice(0, maxWidth - 3)}...`;
+}
+function formatIdentifiers(item) {
+  const identifiers = [];
+  if (item.DOI) {
+    identifiers.push(`DOI: ${item.DOI}`);
+  }
+  if (item.PMID) {
+    identifiers.push(`PMID: ${item.PMID}`);
+  }
+  if (item.PMCID) {
+    identifiers.push(`PMCID: ${item.PMCID}`);
+  }
+  if (item.ISBN) {
+    identifiers.push(`ISBN: ${item.ISBN}`);
+  }
+  return identifiers.join(" | ");
+}
+function extractYear(item) {
+  const dateParts = item.issued?.["date-parts"];
+  if (!dateParts || dateParts.length === 0) {
+    return void 0;
+  }
+  const firstDatePart = dateParts[0];
+  if (!firstDatePart || firstDatePart.length === 0) {
+    return void 0;
+  }
+  return firstDatePart[0];
+}
+function formatSearchResult(item, index, terminalWidth) {
+  const lines = [];
+  const authors = formatAuthors(item.author);
+  const year = extractYear(item);
+  const yearPart = year !== void 0 ? ` (${year})` : "";
+  const line1 = `[${index}] ${authors}${yearPart}`;
+  lines.push(line1);
+  const indent = "    ";
+  const titleMaxWidth = terminalWidth - indent.length;
+  const title = formatTitle(item.title, titleMaxWidth);
+  if (title) {
+    lines.push(`${indent}${title}`);
+  }
+  const identifiers = formatIdentifiers(item);
+  if (identifiers) {
+    lines.push(`${indent}${identifiers}`);
+  }
+  return lines.join("\n");
+}
+function createChoices(results, terminalWidth) {
+  return results.map((result, index) => {
+    const displayIndex = index + 1;
+    const formattedText = formatSearchResult(result.reference, displayIndex, terminalWidth);
+    return {
+      name: JSON.stringify({
+        index,
+        item: result.reference
+      }),
+      message: formattedText,
+      value: result.reference.id
+    };
+  });
+}
+function parseSelectedValues(values) {
+  const valueArray = Array.isArray(values) ? values : [values];
+  const items = [];
+  for (const value of valueArray) {
+    if (!value) continue;
+    try {
+      const data = JSON.parse(value);
+      items.push(data.item);
+    } catch {
+    }
+  }
+  return items;
+}
+function getTerminalWidth() {
+  return process.stdout.columns ?? 80;
+}
+async function runSearchPrompt(allReferences, searchFn, config, initialQuery = "") {
+  const enquirer = await import("enquirer");
+  const AutoComplete = enquirer.default.AutoComplete;
+  const terminalWidth = getTerminalWidth();
+  const initialResults = initialQuery ? searchFn(initialQuery).slice(0, config.limit) : allReferences.slice(0, config.limit).map((ref) => ({
+    reference: ref,
+    overallStrength: "exact",
+    tokenMatches: [],
+    score: 0
+  }));
+  const initialChoices = createChoices(initialResults, terminalWidth);
+  let lastQuery = initialQuery;
+  const promptOptions = {
+    name: "references",
+    message: "Search references",
+    initial: initialQuery,
+    choices: initialChoices,
+    multiple: true,
+    limit: config.limit,
+    suggest: (input, choices) => {
+      if (input === lastQuery) {
+        return choices;
+      }
+      lastQuery = input;
+      if (!input.trim()) {
+        const defaultResults = allReferences.slice(0, config.limit).map((ref) => ({
+          reference: ref,
+          overallStrength: "exact",
+          tokenMatches: [],
+          score: 0
+        }));
+        return createChoices(defaultResults, terminalWidth);
+      }
+      const results = searchFn(input).slice(0, config.limit);
+      return createChoices(results, terminalWidth);
+    }
+  };
+  try {
+    const prompt = new AutoComplete(promptOptions);
+    const result = await prompt.run();
+    const selected = parseSelectedValues(result);
+    return {
+      selected,
+      cancelled: false
+    };
+  } catch (error) {
+    if (error === "" || error instanceof Error && error.message === "") {
+      return {
+        selected: [],
+        cancelled: true
+      };
+    }
+    throw error;
+  }
+}
+export {
+  createChoices,
+  getTerminalWidth,
+  parseSelectedValues,
+  runSearchPrompt
+};
+//# sourceMappingURL=search-prompt-D67WyKrY.js.map

package/dist/chunks/search-prompt-D67WyKrY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-prompt-D67WyKrY.js","sources":["../../src/features/interactive/format.ts","../../src/features/interactive/search-prompt.ts"],"sourcesContent":["/**\n * Display format functions for interactive search\n */\n\nimport type { CslItem } from \"../../core/csl-json/types.js\";\n\n/**\n * CSL name type (author structure)\n */\ntype CslName = NonNullable<CslItem[\"author\"]>[number];\n\n/**\n * Format a single author name\n * - Personal: \"Smith, J.\" (family + initial of given)\n * - Institutional: \"World Health Organization\" (literal)\n */\nfunction formatSingleAuthor(author: CslName): string {\n  if (author.literal) {\n    return author.literal;\n  }\n  if (author.family) {\n    if (author.given) {\n      const initial = author.given.charAt(0).toUpperCase();\n      return `${author.family}, ${initial}.`;\n    }\n    return author.family;\n  }\n  return \"\";\n}\n\n/**\n * Format author list for display\n * - Single author: \"Smith, J.\"\n * - Two authors: \"Smith, J., & Doe, A.\"\n * - Three authors: \"Smith, J., Doe, A., & Johnson, B.\"\n * - More than three: \"Smith, J., et al.\"\n *\n * @param authors - Array of CSL author objects\n * @returns Formatted author string\n */\nexport function formatAuthors(authors: CslName[] | undefined): string {\n  if (!authors || authors.length === 0) {\n    return \"\";\n  }\n\n  if (authors.length > 3) {\n    const first = authors[0];\n    if (!first) {\n      return \"\";\n    }\n    return `${formatSingleAuthor(first)}, et al.`;\n  }\n\n  const formatted = authors.map(formatSingleAuthor);\n  if (formatted.length === 1) {\n    return formatted[0] ?? \"\";\n  }\n\n  // Join all but last with \", \" and append \"& \" + last\n  const allButLast = formatted.slice(0, -1).join(\", \");\n  const last = formatted[formatted.length - 1] ?? \"\";\n  return `${allButLast}, & ${last}`;\n}\n\n/**\n * Truncate title to fit terminal width\n *\n * @param title - Title string\n * @param maxWidth - Maximum display width\n * @returns Truncated title with ellipsis if needed\n */\nexport function formatTitle(title: string | undefined, maxWidth: number): string {\n  if (!title) {\n    return \"\";\n  }\n\n  if (title.length <= maxWidth) {\n    return title;\n  }\n\n  // Truncate and add ellipsis, keeping total length at maxWidth\n  return `${title.slice(0, maxWidth - 3)}...`;\n}\n\n/**\n * Format identifiers (DOI, PMID, PMCID, ISBN) for display\n *\n * @param item - CSL item\n * @returns Formatted identifier string (e.g., \"DOI: 10.1000/example | PMID: 12345678\")\n */\nexport function formatIdentifiers(item: CslItem): string {\n  const identifiers: string[] = [];\n\n  if (item.DOI) {\n    identifiers.push(`DOI: ${item.DOI}`);\n  }\n  if (item.PMID) {\n    identifiers.push(`PMID: ${item.PMID}`);\n  }\n  if (item.PMCID) {\n    identifiers.push(`PMCID: ${item.PMCID}`);\n  }\n  if (item.ISBN) {\n    identifiers.push(`ISBN: ${item.ISBN}`);\n  }\n\n  return identifiers.join(\" | \");\n}\n\n/**\n * Extract year from CSL item\n */\nfunction extractYear(item: CslItem): number | undefined {\n  const dateParts = item.issued?.[\"date-parts\"];\n  if (!dateParts || dateParts.length === 0) {\n    return undefined;\n  }\n  const firstDatePart = dateParts[0];\n  if (!firstDatePart || firstDatePart.length === 0) {\n    return undefined;\n  }\n  return firstDatePart[0];\n}\n\n/**\n * Compose a complete search result line\n *\n * Format:\n * ```\n * [1] Smith, J., & Doe, A. (2020)\n *     Machine learning in medicine: A comprehensive review\n *     DOI: 10.1000/example | PMID: 12345678\n * ```\n *\n * @param item - CSL item\n * @param index - Display index (1-based)\n * @param terminalWidth - Terminal width for title truncation\n * @returns Multi-line formatted string\n */\nexport function formatSearchResult(item: CslItem, index: number, terminalWidth: number): string {\n  const lines: string[] = [];\n\n  // Line 1: [index] Authors (year)\n  const authors = formatAuthors(item.author);\n  const year = extractYear(item);\n  const yearPart = year !== undefined ? ` (${year})` : \"\";\n  const line1 = `[${index}] ${authors}${yearPart}`;\n  lines.push(line1);\n\n  // Line 2: Title (indented, truncated)\n  const indent = \"    \";\n  const titleMaxWidth = terminalWidth - indent.length;\n  const title = formatTitle(item.title, titleMaxWidth);\n  if (title) {\n    lines.push(`${indent}${title}`);\n  }\n\n  // Line 3: Identifiers (indented)\n  const identifiers = formatIdentifiers(item);\n  if (identifiers) {\n    lines.push(`${indent}${identifiers}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n","/**\n * Interactive search prompt using Enquirer's AutoComplete\n *\n * Provides real-time incremental search with multiple selection support.\n */\n\nimport type { CslItem } from \"../../core/csl-json/types.js\";\nimport type { SearchResult } from \"../search/types.js\";\nimport type { AutoCompleteChoice } from \"./enquirer.js\";\nimport { formatSearchResult } from \"./format.js\";\n\n/**\n * Configuration for the search prompt\n */\nexport interface SearchPromptConfig {\n  /** Maximum number of results to display */\n  limit: number;\n  /** Debounce delay in milliseconds */\n  debounceMs: number;\n}\n\n/**\n * Search function type for filtering references\n */\nexport type SearchFunction = (query: string) => SearchResult[];\n\n/**\n * Result from the search prompt\n */\nexport interface SearchPromptResult {\n  /** Selected references */\n  selected: CslItem[];\n  /** Whether the prompt was cancelled */\n  cancelled: boolean;\n}\n\n/**\n * Maps internal choice value to CslItem\n */\ninterface ChoiceData {\n  index: number;\n  item: CslItem;\n}\n\n/**\n * Creates choices from search results\n */\nexport function createChoices(\n  results: SearchResult[],\n  terminalWidth: number\n): AutoCompleteChoice[] {\n  return results.map((result, index) => {\n    const displayIndex = index + 1;\n    const formattedText = formatSearchResult(result.reference, displayIndex, terminalWidth);\n\n    // Enquirer returns the 'name' property on selection, not 'value'\n    // So we store the JSON data in 'name' and use 'message' for display\n    return {\n      name: JSON.stringify({\n        index,\n        item: result.reference,\n      } satisfies ChoiceData),\n      message: formattedText,\n      value: result.reference.id,\n    };\n  });\n}\n\n/**\n * Parses selected values back to CslItems\n */\nexport function parseSelectedValues(values: string | string[]): CslItem[] {\n  const valueArray = Array.isArray(values) ? values : [values];\n  const items: CslItem[] = [];\n\n  for (const value of valueArray) {\n    if (!value) continue;\n    try {\n      const data = JSON.parse(value) as ChoiceData;\n      items.push(data.item);\n    } catch {\n      // If parsing fails, the value might be just the id (name)\n      // In this case, we can't recover the full item\n      // This shouldn't happen in normal operation\n    }\n  }\n\n  return items;\n}\n\n/**\n * Gets terminal width, falling back to 80 if not available\n */\nexport function getTerminalWidth(): number {\n  return process.stdout.columns ?? 80;\n}\n\n/**\n * Creates and runs an interactive search prompt\n */\nexport async function runSearchPrompt(\n  allReferences: CslItem[],\n  searchFn: SearchFunction,\n  config: SearchPromptConfig,\n  initialQuery = \"\"\n): Promise<SearchPromptResult> {\n  // Dynamic import to allow mocking in tests\n  // enquirer is a CommonJS module, so we must use default import\n  const enquirer = await import(\"enquirer\");\n  const AutoComplete = (enquirer.default as unknown as Record<string, unknown>)\n    .AutoComplete as new (\n    options: Record<string, unknown>\n  ) => {\n    run(): Promise<string | string[]>;\n  };\n\n  const terminalWidth = getTerminalWidth();\n\n  // Create initial choices from all references (limited)\n  const initialResults: SearchResult[] = initialQuery\n    ? searchFn(initialQuery).slice(0, config.limit)\n    : allReferences.slice(0, config.limit).map((ref) => ({\n        reference: ref,\n        overallStrength: \"exact\" as const,\n        tokenMatches: [],\n        score: 0,\n      }));\n\n  const initialChoices = createChoices(initialResults, terminalWidth);\n\n  // Track last search query to avoid redundant searches\n  let lastQuery = initialQuery;\n\n  const promptOptions = {\n    name: \"references\",\n    message: \"Search references\",\n    initial: initialQuery,\n    choices: initialChoices,\n    multiple: true,\n    limit: config.limit,\n    suggest: (input: string, choices: AutoCompleteChoice[]) => {\n      // If input hasn't changed, return current choices\n      if (input === lastQuery) {\n        return choices;\n      }\n      lastQuery = input;\n\n      // If input is empty, show all references (limited)\n      if (!input.trim()) {\n        const defaultResults: SearchResult[] = allReferences.slice(0, config.limit).map((ref) => ({\n          reference: ref,\n          overallStrength: \"exact\" as const,\n          tokenMatches: [],\n          score: 0,\n        }));\n        return createChoices(defaultResults, terminalWidth);\n      }\n\n      // Search and create new choices\n      const results = searchFn(input).slice(0, config.limit);\n      return createChoices(results, terminalWidth);\n    },\n  };\n\n  try {\n    const prompt = new AutoComplete(promptOptions);\n    const result = await prompt.run();\n\n    // Handle result\n    const selected = parseSelectedValues(result);\n\n    return {\n      selected,\n      cancelled: false,\n    };\n  } catch (error) {\n    // Enquirer throws an empty string when cancelled\n    if (error === \"\" || (error instanceof Error && error.message === \"\")) {\n      return {\n        selected: [],\n        cancelled: true,\n      };\n    }\n    throw error;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/chunks/tty-CDBIQraQ.js

@@ -0,0 +1,17 @@
+class TTYError extends Error {
+  exitCode = 1;
+  constructor(message) {
+    super(message);
+    this.name = "TTYError";
+  }
+}
+function checkTTY() {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    throw new TTYError("Interactive mode requires a TTY");
+  }
+}
+export {
+  TTYError,
+  checkTTY
+};
+//# sourceMappingURL=tty-CDBIQraQ.js.map

package/dist/chunks/tty-CDBIQraQ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty-CDBIQraQ.js","sources":["../../src/features/interactive/tty.ts"],"sourcesContent":["/**\n * TTY detection for interactive mode\n */\n\n/**\n * Error thrown when TTY is required but not available\n */\nexport class TTYError extends Error {\n  readonly exitCode = 1;\n\n  constructor(message: string) {\n    super(message);\n    this.name = \"TTYError\";\n  }\n}\n\n/**\n * Check if the current environment is a TTY\n *\n * Throws TTYError if stdin or stdout is not a TTY,\n * which means interactive mode cannot be used.\n *\n * @throws {TTYError} If not running in a TTY\n */\nexport function checkTTY(): void {\n  if (!process.stdin.isTTY || !process.stdout.isTTY) {\n    throw new TTYError(\"Interactive mode requires a TTY\");\n  }\n}\n"],"names":[],"mappings":"AAOO,MAAM,iBAAiB,MAAM;AAAA,EACzB,WAAW;AAAA,EAEpB,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAUO,SAAS,WAAiB;AAC/B,MAAI,CAAC,QAAQ,MAAM,SAAS,CAAC,QAAQ,OAAO,OAAO;AACjD,UAAM,IAAI,SAAS,iCAAiC;AAAA,EACtD;AACF;"}

package/dist/cli/commands/search.d.ts

@@ -1,3 +1,4 @@
+import type { Config } from "../../config/schema.js";
 import type { SearchResult } from "../../features/operations/search.js";
 import { type SearchSortField, type SortOrder } from "../../features/pagination/index.js";
 import type { ExecutionContext } from "../execution-context.js";
@@ -14,6 +15,7 @@ export interface SearchCommandOptions {
     order?: SortOrder;
     limit?: number;
     offset?: number;
+    interactive?: boolean;
 }
 /**
  * Result from search command execution.
@@ -36,4 +38,21 @@ export declare function executeSearch(options: SearchCommandOptions, context: Ex
  * @returns Formatted output string
  */
 export declare function formatSearchOutput(result: SearchCommandResult, isJson?: boolean): string;
+/**
+ * Result from interactive search command execution.
+ */
+export interface InteractiveSearchResult {
+    output: string;
+    cancelled: boolean;
+}
+/**
+ * Execute interactive search command.
+ * Uses runSearchPrompt and runActionMenu from the interactive module.
+ *
+ * @param options - Search command options with interactive flag
+ * @param context - Execution context
+ * @param config - Application configuration
+ * @returns Interactive search result containing output and cancelled flag
+ */
+export declare function executeInteractiveSearch(options: SearchCommandOptions, context: ExecutionContext, config: Config): Promise<InteractiveSearchResult>;
 //# sourceMappingURL=search.d.ts.map

package/dist/cli/commands/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACtF,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,SAAS,EAIf,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAgBhE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAwD/C;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAa9B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,EAAE,MAAM,UAAQ,GAAG,MAAM,CA2BtF"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACtF,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,SAAS,EAIf,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAgBhE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAwD/C;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAa9B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,EAAE,MAAM,UAAQ,GAAG,MAAM,CA2BtF;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB;AAkBD;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,uBAAuB,CAAC,CA+ClC"}

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqDpC;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CA+BvC;AA+wBD;;GAEG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBxD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0DpC;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CA+BvC;AAgyBD;;GAEG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBxD"}

package/dist/cli.js

@@ -1,19 +1,19 @@
 import { Command } from "commander";
 import { ZodOptional as ZodOptional$2, z } from "zod";
-import { p as pickDefined, q as sortOrderSchema, r as paginationOptionsSchema, L as Library, F as FileWatcher, u as sortFieldSchema, v as searchSortFieldSchema } from "./chunks/file-watcher-Cwfnnw92.js";
+import { p as pickDefined, q as sortOrderSchema, r as paginationOptionsSchema, L as Library, F as FileWatcher, u as sortFieldSchema, v as searchSortFieldSchema } from "./chunks/file-watcher-D7oyc-9z.js";
 import { promises, existsSync, mkdtempSync, writeFileSync, readFileSync } from "node:fs";
 import * as os from "node:os";
 import { tmpdir } from "node:os";
 import * as path from "node:path";
 import { join, extname } from "node:path";
 import { mkdir, unlink, rename, copyFile, rm, readFile } from "node:fs/promises";
-import { u as updateReference, B as BUILTIN_STYLES, s as startServerWithFileWatcher } from "./chunks/index-CQO8hLYm.js";
+import { u as updateReference, B as BUILTIN_STYLES, s as startServerWithFileWatcher } from "./chunks/index-_7NEUoS7.js";
 import process$1, { stdin, stdout } from "node:process";
-import { l as loadConfig } from "./chunks/loader-B_ZLxCQW.js";
+import { l as loadConfig } from "./chunks/loader-BItrdVWG.js";
 import { spawn } from "node:child_process";
 import { serve } from "@hono/node-server";
 const name = "@ncukondo/reference-manager";
-const version$1 = "0.6.0";
+const version$1 = "0.7.0";
 const description$1 = "A local reference management tool using CSL-JSON as the single source of truth";
 const packageJson = {
   name,
@@ -20959,19 +20959,19 @@ class OperationsLibrary {
   }
   // High-level operations
   async search(options) {
-    const { searchReferences } = await import("./chunks/index-CQO8hLYm.js").then((n) => n.d);
+    const { searchReferences } = await import("./chunks/index-_7NEUoS7.js").then((n) => n.e);
     return searchReferences(this.library, options);
   }
   async list(options) {
-    const { listReferences } = await import("./chunks/index-CQO8hLYm.js").then((n) => n.l);
+    const { listReferences } = await import("./chunks/index-_7NEUoS7.js").then((n) => n.l);
     return listReferences(this.library, options ?? {});
   }
   async cite(options) {
-    const { citeReferences } = await import("./chunks/index-CQO8hLYm.js").then((n) => n.b);
+    const { citeReferences } = await import("./chunks/index-_7NEUoS7.js").then((n) => n.d);
     return citeReferences(this.library, options);
   }
   async import(inputs, options) {
-    const { addReferences } = await import("./chunks/index-CQO8hLYm.js").then((n) => n.a);
+    const { addReferences } = await import("./chunks/index-_7NEUoS7.js").then((n) => n.b);
     return addReferences(inputs, this.library, options ?? {});
   }
 }
@@ -21614,6 +21614,48 @@ function formatSearchOutput(result, isJson = false) {
   lines.push(...result.items);
   return lines.join("\n");
 }
+function validateInteractiveOptions(options) {
+  const outputOptions = [options.json, options.idsOnly, options.uuid, options.bibtex].filter(
+    Boolean
+  );
+  if (outputOptions.length > 0) {
+    throw new Error(
+      "Interactive mode cannot be combined with output format options (--json, --ids-only, --uuid, --bibtex)"
+    );
+  }
+}
+async function executeInteractiveSearch(options, context, config2) {
+  validateInteractiveOptions(options);
+  const { checkTTY } = await import("./chunks/tty-CDBIQraQ.js");
+  const { runSearchPrompt } = await import("./chunks/search-prompt-D67WyKrY.js");
+  const { runActionMenu } = await import("./chunks/action-menu-CTtINmWd.js");
+  const { search } = await import("./chunks/file-watcher-D7oyc-9z.js").then((n) => n.y);
+  const { tokenize } = await import("./chunks/file-watcher-D7oyc-9z.js").then((n) => n.x);
+  checkTTY();
+  const allReferences = await context.library.getAll();
+  const searchFn = (query) => {
+    const { tokens } = tokenize(query);
+    return search(allReferences, tokens);
+  };
+  const interactiveConfig = config2.cli.interactive;
+  const searchResult = await runSearchPrompt(
+    allReferences,
+    searchFn,
+    {
+      limit: interactiveConfig.limit,
+      debounceMs: interactiveConfig.debounceMs
+    },
+    options.query || ""
+  );
+  if (searchResult.cancelled || searchResult.selected.length === 0) {
+    return { output: "", cancelled: true };
+  }
+  const actionResult = await runActionMenu(searchResult.selected);
+  return {
+    output: actionResult.output,
+    cancelled: actionResult.cancelled
+  };
+}
 async function serverStart(options) {
   const existingStatus = await serverStatus(options.portfilePath);
   if (existingStatus !== null) {
@@ -22285,6 +22327,14 @@ async function handleSearchAction(query, options, program) {
     const globalOpts = program.opts();
     const config2 = await loadConfigWithOverrides({ ...globalOpts, ...options });
     const context = await createExecutionContext(config2, Library.load);
+    if (options.interactive) {
+      const result2 = await executeInteractiveSearch({ ...options, query }, context, config2);
+      if (result2.output) {
+        process.stdout.write(`${result2.output}
+`);
+      }
+      process.exit(result2.cancelled ? 0 : 0);
+    }
     const result = await executeSearch({ ...options, query }, context);
     const output = formatSearchOutput(result, options.json ?? false);
     if (output) {
@@ -22299,8 +22349,12 @@ async function handleSearchAction(query, options, program) {
   }
 }
 function registerSearchCommand(program) {
-  program.command("search").description("Search references").argument("<query>", "Search query").option("--json", "Output in JSON format").option("--ids-only", "Output only citation keys").option("--uuid", "Output only UUIDs").option("--bibtex", "Output in BibTeX format").option("--sort <field>", "Sort by field: created|updated|published|author|title|relevance").option("--order <order>", "Sort order: asc|desc").option("-n, --limit <n>", "Maximum number of results", Number.parseInt).option("--offset <n>", "Number of results to skip", Number.parseInt).action(async (query, options) => {
-    await handleSearchAction(query, options, program);
+  program.command("search").description("Search references").argument("[query]", "Search query (required unless using --interactive)").option("-i, --interactive", "Enable interactive search mode").option("--json", "Output in JSON format").option("--ids-only", "Output only citation keys").option("--uuid", "Output only UUIDs").option("--bibtex", "Output in BibTeX format").option("--sort <field>", "Sort by field: created|updated|published|author|title|relevance").option("--order <order>", "Sort order: asc|desc").option("-n, --limit <n>", "Maximum number of results", Number.parseInt).option("--offset <n>", "Number of results to skip", Number.parseInt).action(async (query, options) => {
+    if (!options.interactive && !query) {
+      process.stderr.write("Error: Search query is required unless using --interactive\n");
+      process.exit(1);
+    }
+    await handleSearchAction(query ?? "", options, program);
   });
 }
 async function handleAddAction(inputs, options, program) {