@ncukondo/reference-manager 0.6.0 → 0.7.0

package/README.md

@@ -42,6 +42,10 @@ ref list --format json > references.json
 Streamline your writing workflow:
 
 ```bash
+# Find and select references interactively
+ref search -i "machine learning"
+# → Select references with Space, then export as BibTeX or generate citations
+
 # Generate citations
 ref cite smith2024 jones2023 --style apa
 # Output: (Smith, 2024; Jones, 2023)
@@ -254,6 +258,10 @@ ref search "author:smith"
 ref search "author:jones year:2024"
 ref search "title:\"deep learning\""
 
+# Interactive search (with real-time filtering)
+ref search -i                         # Start interactive mode
+ref search -i "machine learning"      # Pre-fill query
+
 # Add references
 ref add paper.json                    # From CSL-JSON file
 ref add references.bib                # From BibTeX
@@ -314,6 +322,34 @@ ref fulltext detach smith2024 --pdf --delete      # Also delete the file
 
 Supported field prefixes: `author:`, `title:`, `doi:`, `pmid:`, `pmcid:`, `url:`, `keyword:`, `tag:`
 
+### Interactive Search
+
+Start an interactive search session with real-time filtering:
+
+```bash
+ref search -i                    # Start with empty query
+ref search -i "machine learning" # Pre-fill the search query
+```
+
+**Features:**
+- Real-time filtering as you type (200ms debounce)
+- Multi-select with Space key
+- Action menu for selected references:
+  - Output IDs (citation keys)
+  - Output as CSL-JSON
+  - Output as BibTeX
+  - Generate citation (APA or choose style)
+
+**Navigation:**
+| Key | Action |
+|-----|--------|
+| `↑` / `↓` | Move cursor |
+| `Space` | Toggle selection |
+| `Enter` | Open action menu |
+| `Esc` / `Ctrl+C` | Cancel |
+
+> **Note**: Interactive mode requires a TTY (terminal). It won't work in pipes or scripts.
+
 ### Sorting and Pagination
 
 ```bash

package/dist/chunks/action-menu-CTtINmWd.js

@@ -0,0 +1,118 @@
+import { f as formatBibliographyCSL, a as formatBibtex } from "./index-_7NEUoS7.js";
+const ACTION_CHOICES = [
+  { name: "output-ids", message: "Output IDs (citation keys)", value: "output-ids" },
+  { name: "output-csl-json", message: "Output as CSL-JSON", value: "output-csl-json" },
+  { name: "output-bibtex", message: "Output as BibTeX", value: "output-bibtex" },
+  { name: "cite-apa", message: "Generate citation (APA)", value: "cite-apa" },
+  { name: "cite-choose", message: "Generate citation (choose style)", value: "cite-choose" },
+  { name: "cancel", message: "Cancel", value: "cancel" }
+];
+const STYLE_CHOICES = [
+  { name: "apa", message: "APA", value: "apa" },
+  { name: "vancouver", message: "Vancouver", value: "vancouver" },
+  { name: "harvard", message: "Harvard", value: "harvard" }
+];
+function generateOutput(action, items, style = "apa") {
+  switch (action) {
+    case "output-ids":
+      return items.map((item) => item.id).join("\n");
+    case "output-csl-json":
+      return JSON.stringify(items, null, 2);
+    case "output-bibtex":
+      return formatBibtex(items);
+    case "cite-apa":
+      return formatBibliographyCSL(items, { style: "apa" });
+    case "cite-choose":
+      return formatBibliographyCSL(items, { style });
+    case "cancel":
+      return "";
+    default:
+      return "";
+  }
+}
+async function processAction(action, items) {
+  if (action === "cite-choose") {
+    const styleResult = await runStyleSelectPrompt();
+    if (styleResult.cancelled) {
+      return {
+        action: "cancel",
+        output: "",
+        cancelled: true
+      };
+    }
+    return {
+      action,
+      output: generateOutput(action, items, styleResult.style),
+      cancelled: false
+    };
+  }
+  if (action === "cancel") {
+    return {
+      action,
+      output: "",
+      cancelled: true
+    };
+  }
+  return {
+    action,
+    output: generateOutput(action, items),
+    cancelled: false
+  };
+}
+async function runStyleSelectPrompt() {
+  const enquirer = await import("enquirer");
+  const Select = enquirer.default.Select;
+  const promptOptions = {
+    name: "style",
+    message: "Select citation style:",
+    choices: STYLE_CHOICES
+  };
+  try {
+    const prompt = new Select(promptOptions);
+    const result = await prompt.run();
+    return {
+      style: result,
+      cancelled: false
+    };
+  } catch (error) {
+    if (error === "" || error instanceof Error && error.message === "") {
+      return {
+        cancelled: true
+      };
+    }
+    throw error;
+  }
+}
+async function runActionMenu(items) {
+  const enquirer = await import("enquirer");
+  const Select = enquirer.default.Select;
+  const count = items.length;
+  const refWord = count === 1 ? "reference" : "references";
+  const message = `Action for ${count} selected ${refWord}:`;
+  const promptOptions = {
+    name: "action",
+    message,
+    choices: ACTION_CHOICES
+  };
+  try {
+    const prompt = new Select(promptOptions);
+    const action = await prompt.run();
+    return processAction(action, items);
+  } catch (error) {
+    if (error === "" || error instanceof Error && error.message === "") {
+      return {
+        action: "cancel",
+        output: "",
+        cancelled: true
+      };
+    }
+    throw error;
+  }
+}
+export {
+  ACTION_CHOICES,
+  STYLE_CHOICES,
+  runActionMenu,
+  runStyleSelectPrompt
+};
+//# sourceMappingURL=action-menu-CTtINmWd.js.map

package/dist/chunks/action-menu-CTtINmWd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-menu-CTtINmWd.js","sources":["../../src/features/interactive/action-menu.ts"],"sourcesContent":["/**\n * Action menu for interactive search mode.\n * Allows users to perform actions on selected references.\n */\n\nimport type { CslItem } from \"../../core/csl-json/types.js\";\nimport { formatBibliographyCSL, formatBibtex } from \"../format/index.js\";\n\n/**\n * Action types available in the action menu.\n */\nexport type ActionType =\n  | \"output-ids\"\n  | \"output-csl-json\"\n  | \"output-bibtex\"\n  | \"cite-apa\"\n  | \"cite-choose\"\n  | \"cancel\";\n\n/**\n * Result from action menu selection.\n */\nexport interface ActionMenuResult {\n  /** Selected action type */\n  action: ActionType;\n  /** Generated output (empty for cancel) */\n  output: string;\n  /** Whether the prompt was cancelled */\n  cancelled: boolean;\n}\n\n/**\n * Result from style selection prompt.\n */\nexport interface StyleSelectResult {\n  /** Selected style (undefined if cancelled) */\n  style?: string;\n  /** Whether the prompt was cancelled */\n  cancelled: boolean;\n}\n\n/**\n * Choice definition for Enquirer Select prompt.\n */\ninterface SelectChoice {\n  name: string;\n  message: string;\n  value: ActionType | string;\n}\n\n/**\n * Available action choices for the action menu.\n */\nexport const ACTION_CHOICES: SelectChoice[] = [\n  { name: \"output-ids\", message: \"Output IDs (citation keys)\", value: \"output-ids\" },\n  { name: \"output-csl-json\", message: \"Output as CSL-JSON\", value: \"output-csl-json\" },\n  { name: \"output-bibtex\", message: \"Output as BibTeX\", value: \"output-bibtex\" },\n  { name: \"cite-apa\", message: \"Generate citation (APA)\", value: \"cite-apa\" },\n  { name: \"cite-choose\", message: \"Generate citation (choose style)\", value: \"cite-choose\" },\n  { name: \"cancel\", message: \"Cancel\", value: \"cancel\" },\n];\n\n/**\n * Available style choices for citation style selection.\n * Uses BUILTIN_STYLES from config/csl-styles.ts\n */\nexport const STYLE_CHOICES: SelectChoice[] = [\n  { name: \"apa\", message: \"APA\", value: \"apa\" },\n  { name: \"vancouver\", message: \"Vancouver\", value: \"vancouver\" },\n  { name: \"harvard\", message: \"Harvard\", value: \"harvard\" },\n];\n\n/**\n * Run the style selection prompt.\n */\n\n/**\n * Generate output for the given action and items.\n */\nfunction generateOutput(action: ActionType, items: CslItem[], style = \"apa\"): string {\n  switch (action) {\n    case \"output-ids\":\n      return items.map((item) => item.id).join(\"\\n\");\n\n    case \"output-csl-json\":\n      return JSON.stringify(items, null, 2);\n\n    case \"output-bibtex\":\n      return formatBibtex(items);\n\n    case \"cite-apa\":\n      return formatBibliographyCSL(items, { style: \"apa\" });\n\n    case \"cite-choose\":\n      return formatBibliographyCSL(items, { style });\n\n    case \"cancel\":\n      return \"\";\n\n    default:\n      return \"\";\n  }\n}\n\n/**\n * Process the selected action and generate result.\n */\nasync function processAction(action: ActionType, items: CslItem[]): Promise<ActionMenuResult> {\n  // Handle cite-choose: prompt for style first\n  if (action === \"cite-choose\") {\n    const styleResult = await runStyleSelectPrompt();\n    if (styleResult.cancelled) {\n      return {\n        action: \"cancel\",\n        output: \"\",\n        cancelled: true,\n      };\n    }\n    return {\n      action,\n      output: generateOutput(action, items, styleResult.style),\n      cancelled: false,\n    };\n  }\n\n  // Handle cancel\n  if (action === \"cancel\") {\n    return {\n      action,\n      output: \"\",\n      cancelled: true,\n    };\n  }\n\n  // Handle other actions\n  return {\n    action,\n    output: generateOutput(action, items),\n    cancelled: false,\n  };\n}\n\nexport async function runStyleSelectPrompt(): Promise<StyleSelectResult> {\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 Select = (enquirer.default as unknown as Record<string, unknown>).Select as new (\n    options: Record<string, unknown>\n  ) => { run(): Promise<string> };\n\n  const promptOptions = {\n    name: \"style\",\n    message: \"Select citation style:\",\n    choices: STYLE_CHOICES,\n  };\n\n  try {\n    const prompt = new Select(promptOptions);\n    const result = (await prompt.run()) as string;\n\n    return {\n      style: result,\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        cancelled: true,\n      };\n    }\n    throw error;\n  }\n}\n\n/**\n * Run the action menu for selected references.\n *\n * @param items - Selected references\n * @returns Action result with output\n */\nexport async function runActionMenu(items: CslItem[]): Promise<ActionMenuResult> {\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 Select = (enquirer.default as unknown as Record<string, unknown>).Select as new (\n    options: Record<string, unknown>\n  ) => { run(): Promise<string> };\n\n  const count = items.length;\n  const refWord = count === 1 ? \"reference\" : \"references\";\n  const message = `Action for ${count} selected ${refWord}:`;\n\n  const promptOptions = {\n    name: \"action\",\n    message,\n    choices: ACTION_CHOICES,\n  };\n\n  try {\n    const prompt = new Select(promptOptions);\n    const action = (await prompt.run()) as ActionType;\n\n    return processAction(action, items);\n  } catch (error) {\n    // Enquirer throws an empty string when cancelled\n    if (error === \"\" || (error instanceof Error && error.message === \"\")) {\n      return {\n        action: \"cancel\",\n        output: \"\",\n        cancelled: true,\n      };\n    }\n    throw error;\n  }\n}\n"],"names":[],"mappings":";AAqDO,MAAM,iBAAiC;AAAA,EAC5C,EAAE,MAAM,cAAc,SAAS,8BAA8B,OAAO,aAAA;AAAA,EACpE,EAAE,MAAM,mBAAmB,SAAS,sBAAsB,OAAO,kBAAA;AAAA,EACjE,EAAE,MAAM,iBAAiB,SAAS,oBAAoB,OAAO,gBAAA;AAAA,EAC7D,EAAE,MAAM,YAAY,SAAS,2BAA2B,OAAO,WAAA;AAAA,EAC/D,EAAE,MAAM,eAAe,SAAS,oCAAoC,OAAO,cAAA;AAAA,EAC3E,EAAE,MAAM,UAAU,SAAS,UAAU,OAAO,SAAA;AAC9C;AAMO,MAAM,gBAAgC;AAAA,EAC3C,EAAE,MAAM,OAAO,SAAS,OAAO,OAAO,MAAA;AAAA,EACtC,EAAE,MAAM,aAAa,SAAS,aAAa,OAAO,YAAA;AAAA,EAClD,EAAE,MAAM,WAAW,SAAS,WAAW,OAAO,UAAA;AAChD;AASA,SAAS,eAAe,QAAoB,OAAkB,QAAQ,OAAe;AACnF,UAAQ,QAAA;AAAA,IACN,KAAK;AACH,aAAO,MAAM,IAAI,CAAC,SAAS,KAAK,EAAE,EAAE,KAAK,IAAI;AAAA,IAE/C,KAAK;AACH,aAAO,KAAK,UAAU,OAAO,MAAM,CAAC;AAAA,IAEtC,KAAK;AACH,aAAO,aAAa,KAAK;AAAA,IAE3B,KAAK;AACH,aAAO,sBAAsB,OAAO,EAAE,OAAO,OAAO;AAAA,IAEtD,KAAK;AACH,aAAO,sBAAsB,OAAO,EAAE,OAAO;AAAA,IAE/C,KAAK;AACH,aAAO;AAAA,IAET;AACE,aAAO;AAAA,EAAA;AAEb;AAKA,eAAe,cAAc,QAAoB,OAA6C;AAE5F,MAAI,WAAW,eAAe;AAC5B,UAAM,cAAc,MAAM,qBAAA;AAC1B,QAAI,YAAY,WAAW;AACzB,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,QAAQ;AAAA,QACR,WAAW;AAAA,MAAA;AAAA,IAEf;AACA,WAAO;AAAA,MACL;AAAA,MACA,QAAQ,eAAe,QAAQ,OAAO,YAAY,KAAK;AAAA,MACvD,WAAW;AAAA,IAAA;AAAA,EAEf;AAGA,MAAI,WAAW,UAAU;AACvB,WAAO;AAAA,MACL;AAAA,MACA,QAAQ;AAAA,MACR,WAAW;AAAA,IAAA;AAAA,EAEf;AAGA,SAAO;AAAA,IACL;AAAA,IACA,QAAQ,eAAe,QAAQ,KAAK;AAAA,IACpC,WAAW;AAAA,EAAA;AAEf;AAEA,eAAsB,uBAAmD;AAGvE,QAAM,WAAW,MAAM,OAAO,UAAU;AACxC,QAAM,SAAU,SAAS,QAA+C;AAIxE,QAAM,gBAAgB;AAAA,IACpB,MAAM;AAAA,IACN,SAAS;AAAA,IACT,SAAS;AAAA,EAAA;AAGX,MAAI;AACF,UAAM,SAAS,IAAI,OAAO,aAAa;AACvC,UAAM,SAAU,MAAM,OAAO,IAAA;AAE7B,WAAO;AAAA,MACL,OAAO;AAAA,MACP,WAAW;AAAA,IAAA;AAAA,EAEf,SAAS,OAAO;AAEd,QAAI,UAAU,MAAO,iBAAiB,SAAS,MAAM,YAAY,IAAK;AACpE,aAAO;AAAA,QACL,WAAW;AAAA,MAAA;AAAA,IAEf;AACA,UAAM;AAAA,EACR;AACF;AAQA,eAAsB,cAAc,OAA6C;AAG/E,QAAM,WAAW,MAAM,OAAO,UAAU;AACxC,QAAM,SAAU,SAAS,QAA+C;AAIxE,QAAM,QAAQ,MAAM;AACpB,QAAM,UAAU,UAAU,IAAI,cAAc;AAC5C,QAAM,UAAU,cAAc,KAAK,aAAa,OAAO;AAEvD,QAAM,gBAAgB;AAAA,IACpB,MAAM;AAAA,IACN;AAAA,IACA,SAAS;AAAA,EAAA;AAGX,MAAI;AACF,UAAM,SAAS,IAAI,OAAO,aAAa;AACvC,UAAM,SAAU,MAAM,OAAO,IAAA;AAE7B,WAAO,cAAc,QAAQ,KAAK;AAAA,EACpC,SAAS,OAAO;AAEd,QAAI,UAAU,MAAO,iBAAiB,SAAS,MAAM,YAAY,IAAK;AACpE,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,QAAQ;AAAA,QACR,WAAW;AAAA,MAAA;AAAA,IAEf;AACA,UAAM;AAAA,EACR;AACF;"}

package/dist/chunks/{file-watcher-Cwfnnw92.js → file-watcher-D7oyc-9z.js}

@@ -956,6 +956,10 @@ function parseUnquotedValue(query, startIndex, includeQuotes = false) {
     nextIndex: i
   };
 }
+const tokenizer = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  tokenize
+}, Symbol.toStringTag, { value: "Module" }));
 function normalize(text) {
   let normalized = text.normalize("NFKC");
   normalized = normalized.toLowerCase();
@@ -1293,6 +1297,12 @@ function search(references, tokens) {
   }
   return results;
 }
+const matcher = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  matchReference,
+  matchToken,
+  search
+}, Symbol.toStringTag, { value: "Module" }));
 function extractYear$1(reference) {
   if (reference.issued?.["date-parts"]?.[0]?.[0]) {
     return String(reference.issued["date-parts"][0][0]);
@@ -1691,6 +1701,8 @@ export {
   tokenize as t,
   sortFieldSchema as u,
   searchSortFieldSchema as v,
-  writeCslJson as w
+  writeCslJson as w,
+  tokenizer as x,
+  matcher as y
 };
-//# sourceMappingURL=file-watcher-Cwfnnw92.js.map
+//# sourceMappingURL=file-watcher-D7oyc-9z.js.map