@ncukondo/reference-manager 0.13.4 → 0.14.0

package/dist/features/interactive/reference-select.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Shared reference selection utility for interactive ID selection.
+ *
+ * This module provides a reusable function to select references interactively
+ * using the existing search prompt infrastructure.
+ */
+import type { CslItem } from "../../core/csl-json/types.js";
+import { type SearchPromptConfig } from "./search-prompt.js";
+/**
+ * Options for reference selection
+ */
+export interface ReferenceSelectOptions {
+    /** Whether to allow multiple selection (default: true) */
+    multiSelect: boolean;
+    /** Custom prompt message */
+    prompt?: string;
+    /** Initial search query */
+    initialQuery?: string;
+}
+/**
+ * Result from reference selection
+ */
+export interface ReferenceSelectResult {
+    /** Selected references */
+    selected: CslItem[];
+    /** Whether the selection was cancelled */
+    cancelled: boolean;
+}
+/**
+ * Run interactive reference selection.
+ *
+ * Launches an interactive search prompt to select references from the library.
+ * Supports both single and multiple selection modes.
+ *
+ * @param allReferences - All references available for selection
+ * @param options - Selection options
+ * @param config - Interactive prompt configuration
+ * @returns Selection result with selected references
+ * @throws TTYError if not running in a TTY environment
+ */
+export declare function runReferenceSelect(allReferences: CslItem[], options: ReferenceSelectOptions, config: SearchPromptConfig): Promise<ReferenceSelectResult>;
+/**
+ * Options for selectReferencesOrExit helper
+ */
+export interface SelectReferencesOrExitOptions {
+    /** Whether to allow multiple selection */
+    multiSelect: boolean;
+    /** Initial search query */
+    initialQuery?: string;
+}
+/**
+ * Select references interactively or exit if cancelled/empty.
+ *
+ * This is a convenience wrapper around runReferenceSelect that handles
+ * common patterns:
+ * - Exits with code 0 if library is empty
+ * - Exits with code 0 if selection is cancelled
+ * - Returns selected identifiers
+ *
+ * @param allReferences - All references available for selection
+ * @param options - Selection options
+ * @param config - Interactive prompt configuration
+ * @returns Array of selected reference IDs (never empty)
+ */
+export declare function selectReferencesOrExit(allReferences: CslItem[], options: SelectReferencesOrExitOptions, config: SearchPromptConfig): Promise<string[]>;
+/**
+ * Select reference items interactively or exit if cancelled/empty.
+ *
+ * Similar to selectReferencesOrExit but returns full CslItem objects
+ * instead of just identifiers. Useful when the caller needs access to
+ * the full reference data (e.g., for confirmation dialogs).
+ *
+ * @param allReferences - All references available for selection
+ * @param options - Selection options
+ * @param config - Interactive prompt configuration
+ * @returns Array of selected CslItem objects (never empty)
+ */
+export declare function selectReferenceItemsOrExit(allReferences: CslItem[], options: SelectReferencesOrExitOptions, config: SearchPromptConfig): Promise<CslItem[]>;
+//# sourceMappingURL=reference-select.d.ts.map

package/dist/features/interactive/reference-select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-select.d.ts","sourceRoot":"","sources":["../../../src/features/interactive/reference-select.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAG5D,OAAO,EAAE,KAAK,kBAAkB,EAAmB,MAAM,oBAAoB,CAAC;AAG9E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,WAAW,EAAE,OAAO,CAAC;IACrB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,0BAA0B;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,OAAO,EAAE,EACxB,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CA6BhC;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,0CAA0C;IAC1C,WAAW,EAAE,OAAO,CAAC;IACrB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,OAAO,EAAE,EACxB,OAAO,EAAE,6BAA6B,EACtC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CAanB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,0BAA0B,CAC9C,aAAa,EAAE,OAAO,EAAE,EACxB,OAAO,EAAE,6BAA6B,EACtC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,OAAO,EAAE,CAAC,CAapB"}

package/dist/features/interactive/search-prompt.d.ts

@@ -40,6 +40,17 @@ export declare function parseSelectedValues(values: string | string[]): CslItem[
  * Gets terminal width, falling back to 80 if not available
  */
 export declare function getTerminalWidth(): number;
+/**
+ * Gets terminal height, falling back to 24 if not available
+ */
+export declare function getTerminalHeight(): number;
+/**
+ * Calculates the effective limit for the autocomplete list
+ * based on terminal height to prevent input field from being hidden.
+ * Reserves space for: prompt header (1), input line (1), footer hint (1), and padding (2)
+ * Each item displays up to 3 lines (author/year, title, identifiers)
+ */
+export declare function calculateEffectiveLimit(configLimit: number): number;
 /**
  * Creates and runs an interactive search prompt
  */

package/dist/features/interactive/search-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-prompt.d.ts","sourceRoot":"","sources":["../../../src/features/interactive/search-prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGxD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,YAAY,EAAE,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;CACpB;AAUD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,YAAY,EAAE,EACvB,aAAa,EAAE,MAAM,GACpB,kBAAkB,EAAE,CAetB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,CAiBxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAoCD;;GAEG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,OAAO,EAAE,EACxB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,kBAAkB,EAC1B,YAAY,SAAK,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAwG7B"}
+{"version":3,"file":"search-prompt.d.ts","sourceRoot":"","sources":["../../../src/features/interactive/search-prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGxD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,YAAY,EAAE,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;CACpB;AAUD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,YAAY,EAAE,EACvB,aAAa,EAAE,MAAM,GACpB,kBAAkB,EAAE,CAetB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,CAiBxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAOnE;AAoCD;;GAEG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,OAAO,EAAE,EACxB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,kBAAkB,EAC1B,YAAY,SAAK,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAuN7B"}

package/dist/features/interactive/style-select.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Style selection prompt for citation style selection.
+ *
+ * Lists built-in styles and custom styles from csl_directory,
+ * with the default style shown first.
+ */
+/**
+ * Options for style selection
+ */
+export interface StyleSelectOptions {
+    /** Directory or directories containing custom CSL files */
+    cslDirectory?: string | string[];
+    /** Default style to show first */
+    defaultStyle?: string;
+}
+/**
+ * Result from style selection
+ */
+export interface StyleSelectResult {
+    /** Selected style name */
+    style?: string;
+    /** Whether the selection was cancelled */
+    cancelled: boolean;
+}
+/**
+ * Choice definition for Enquirer Select prompt
+ */
+interface StyleChoice {
+    name: string;
+    message: string;
+    value: string;
+}
+/**
+ * List custom CSL style names from the specified directory/directories.
+ *
+ * @param cslDirectory - Directory or directories to search for CSL files
+ * @returns Array of style names (without .csl extension)
+ */
+export declare function listCustomStyles(cslDirectory: string | string[] | undefined): string[];
+/**
+ * Build style choices for the selection prompt.
+ *
+ * @param customStyles - Custom style names from csl_directory
+ * @param defaultStyle - Default style to show first
+ * @returns Array of choices for Enquirer Select prompt
+ */
+export declare function buildStyleChoices(customStyles: string[], defaultStyle?: string): StyleChoice[];
+/**
+ * Run the style selection prompt.
+ *
+ * @param options - Style selection options
+ * @returns Selection result with style name
+ */
+export declare function runStyleSelect(options: StyleSelectOptions): Promise<StyleSelectResult>;
+export {};
+//# sourceMappingURL=style-select.d.ts.map

package/dist/features/interactive/style-select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-select.d.ts","sourceRoot":"","sources":["../../../src/features/interactive/style-select.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACjC,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAaD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CA4BtF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,YAAY,SAAQ,GAAG,WAAW,EAAE,CA8B7F;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoC5F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ncukondo/reference-manager",
-  "version": "0.13.4",
+  "version": "0.14.0",
   "description": "A local reference management tool using CSL-JSON as the single source of truth",
   "publishConfig": {
     "access": "public"