@ncukondo/reference-manager 0.5.3 → 0.7.0

package/dist/config/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,IAAI,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MA+B3B,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,IAAI,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MA2C3B,CAAC"}

package/dist/config/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,OAAO,EACL,KAAK,MAAM,EAMZ,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7B;AA8ID;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAwClE"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,OAAO,EACL,KAAK,MAAM,EAMZ,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7B;AA6ND;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAwClE"}

package/dist/config/schema.d.ts

@@ -10,6 +10,40 @@ export declare const logLevelSchema: z.ZodEnum<{
     info: "info";
     debug: "debug";
 }>;
+/**
+ * Interactive search configuration schema
+ */
+export declare const interactiveConfigSchema: z.ZodObject<{
+    limit: z.ZodNumber;
+    debounceMs: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * CLI configuration schema
+ */
+export declare const cliConfigSchema: z.ZodObject<{
+    defaultLimit: z.ZodNumber;
+    defaultSort: z.ZodEnum<{
+        title: "title";
+        author: "author";
+        updated: "updated";
+        created: "created";
+        published: "published";
+    }>;
+    defaultOrder: z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>;
+    interactive: z.ZodObject<{
+        limit: z.ZodNumber;
+        debounceMs: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * MCP configuration schema
+ */
+export declare const mcpConfigSchema: z.ZodObject<{
+    defaultLimit: z.ZodNumber;
+}, z.core.$strip>;
 /**
  * Backup configuration schema
  */
@@ -112,6 +146,27 @@ export declare const configSchema: z.ZodObject<{
     fulltext: z.ZodObject<{
         directory: z.ZodString;
     }, z.core.$strip>;
+    cli: z.ZodObject<{
+        defaultLimit: z.ZodNumber;
+        defaultSort: z.ZodEnum<{
+            title: "title";
+            author: "author";
+            updated: "updated";
+            created: "created";
+            published: "published";
+        }>;
+        defaultOrder: z.ZodEnum<{
+            asc: "asc";
+            desc: "desc";
+        }>;
+        interactive: z.ZodObject<{
+            limit: z.ZodNumber;
+            debounceMs: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    mcp: z.ZodObject<{
+        defaultLimit: z.ZodNumber;
+    }, z.core.$strip>;
 }, z.core.$strip>;
 /**
  * Partial configuration schema (for TOML files)
@@ -178,6 +233,41 @@ export declare const partialConfigSchema: z.ZodObject<{
     fulltext: z.ZodOptional<z.ZodObject<{
         directory: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    cli: z.ZodOptional<z.ZodObject<{
+        defaultLimit: z.ZodOptional<z.ZodNumber>;
+        default_limit: z.ZodOptional<z.ZodNumber>;
+        defaultSort: z.ZodOptional<z.ZodEnum<{
+            title: "title";
+            author: "author";
+            updated: "updated";
+            created: "created";
+            published: "published";
+        }>>;
+        default_sort: z.ZodOptional<z.ZodEnum<{
+            title: "title";
+            author: "author";
+            updated: "updated";
+            created: "created";
+            published: "published";
+        }>>;
+        defaultOrder: z.ZodOptional<z.ZodEnum<{
+            asc: "asc";
+            desc: "desc";
+        }>>;
+        default_order: z.ZodOptional<z.ZodEnum<{
+            asc: "asc";
+            desc: "desc";
+        }>>;
+        interactive: z.ZodOptional<z.ZodObject<{
+            limit: z.ZodOptional<z.ZodNumber>;
+            debounceMs: z.ZodOptional<z.ZodNumber>;
+            debounce_ms: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    mcp: z.ZodOptional<z.ZodObject<{
+        defaultLimit: z.ZodOptional<z.ZodNumber>;
+        default_limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
 }, z.core.$loose>;
 /**
  * Inferred types from schemas
@@ -190,6 +280,9 @@ export type CitationFormat = z.infer<typeof citationFormatSchema>;
 export type CitationConfig = z.infer<typeof citationConfigSchema>;
 export type PubmedConfig = z.infer<typeof pubmedConfigSchema>;
 export type FulltextConfig = z.infer<typeof fulltextConfigSchema>;
+export type InteractiveConfig = z.infer<typeof interactiveConfigSchema>;
+export type CliConfig = z.infer<typeof cliConfigSchema>;
+export type McpConfig = z.infer<typeof mcpConfigSchema>;
 export type Config = z.infer<typeof configSchema>;
 export type PartialConfig = z.infer<typeof partialConfigSchema>;
 /**
@@ -204,6 +297,10 @@ export type DeepPartialConfig = {
     citation?: Partial<CitationConfig>;
     pubmed?: Partial<PubmedConfig>;
     fulltext?: Partial<FulltextConfig>;
+    cli?: Partial<Omit<CliConfig, "interactive">> & {
+        interactive?: Partial<InteractiveConfig>;
+    };
+    mcp?: Partial<McpConfig>;
 };
 /**
  * Normalize snake_case fields to camelCase

package/dist/config/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,cAAc;;;;EAAsC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;iBAK5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;EAAkC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;iBAK/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASvB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2DhB,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACpC,CAAC;AAoKF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,CAmEhF"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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"}

package/dist/features/import/importer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../../src/features/import/importer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAW5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAqOD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAAG,MAAM,EAC5B,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CAuCvB;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CA2BvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,oDAAoD;IACpD,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC9B,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAsGD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAiCvB"}
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../../src/features/import/importer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAW5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAqOD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAAG,MAAM,EAC5B,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CAuCvB;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CA2BvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,oDAAoD;IACpD,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC9B,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAuGD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAiCvB"}

package/dist/features/interactive/action-menu.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Action menu for interactive search mode.
+ * Allows users to perform actions on selected references.
+ */
+import type { CslItem } from "../../core/csl-json/types.js";
+/**
+ * Action types available in the action menu.
+ */
+export type ActionType = "output-ids" | "output-csl-json" | "output-bibtex" | "cite-apa" | "cite-choose" | "cancel";
+/**
+ * Result from action menu selection.
+ */
+export interface ActionMenuResult {
+    /** Selected action type */
+    action: ActionType;
+    /** Generated output (empty for cancel) */
+    output: string;
+    /** Whether the prompt was cancelled */
+    cancelled: boolean;
+}
+/**
+ * Result from style selection prompt.
+ */
+export interface StyleSelectResult {
+    /** Selected style (undefined if cancelled) */
+    style?: string;
+    /** Whether the prompt was cancelled */
+    cancelled: boolean;
+}
+/**
+ * Choice definition for Enquirer Select prompt.
+ */
+interface SelectChoice {
+    name: string;
+    message: string;
+    value: ActionType | string;
+}
+/**
+ * Available action choices for the action menu.
+ */
+export declare const ACTION_CHOICES: SelectChoice[];
+/**
+ * Available style choices for citation style selection.
+ * Uses BUILTIN_STYLES from config/csl-styles.ts
+ */
+export declare const STYLE_CHOICES: SelectChoice[];
+export declare function runStyleSelectPrompt(): Promise<StyleSelectResult>;
+/**
+ * Run the action menu for selected references.
+ *
+ * @param items - Selected references
+ * @returns Action result with output
+ */
+export declare function runActionMenu(items: CslItem[]): Promise<ActionMenuResult>;
+export {};
+//# sourceMappingURL=action-menu.d.ts.map

package/dist/features/interactive/action-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-menu.d.ts","sourceRoot":"","sources":["../../../src/features/interactive/action-menu.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAG5D;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,iBAAiB,GACjB,eAAe,GACf,UAAU,GACV,aAAa,GACb,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EAOxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,YAAY,EAIvC,CAAC;AAwEF,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CA+BvE;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkC/E"}

package/dist/features/interactive/debounce.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Debounce utility for interactive search
+ */
+/**
+ * Debounced function with cancel capability
+ */
+export interface DebouncedFunction<T extends (...args: never[]) => void> {
+    (...args: Parameters<T>): void;
+    cancel: () => void;
+}
+/**
+ * Create a debounced version of a function
+ *
+ * The debounced function will only execute after the specified delay
+ * has passed without any new calls. Each call resets the delay timer.
+ *
+ * @param fn - Function to debounce
+ * @param delayMs - Delay in milliseconds
+ * @returns Debounced function with cancel method
+ */
+export declare function debounce<T extends (...args: never[]) => void>(fn: T, delayMs: number): DebouncedFunction<T>;
+//# sourceMappingURL=debounce.d.ts.map

package/dist/features/interactive/debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../../src/features/interactive/debounce.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI;IACrE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,EAC3D,EAAE,EAAE,CAAC,EACL,OAAO,EAAE,MAAM,GACd,iBAAiB,CAAC,CAAC,CAAC,CAwBtB"}

package/dist/features/interactive/format.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Display format functions for interactive search
+ */
+import type { CslItem } from "../../core/csl-json/types.js";
+/**
+ * CSL name type (author structure)
+ */
+type CslName = NonNullable<CslItem["author"]>[number];
+/**
+ * Format author list for display
+ * - Single author: "Smith, J."
+ * - Two authors: "Smith, J., & Doe, A."
+ * - Three authors: "Smith, J., Doe, A., & Johnson, B."
+ * - More than three: "Smith, J., et al."
+ *
+ * @param authors - Array of CSL author objects
+ * @returns Formatted author string
+ */
+export declare function formatAuthors(authors: CslName[] | undefined): string;
+/**
+ * Truncate title to fit terminal width
+ *
+ * @param title - Title string
+ * @param maxWidth - Maximum display width
+ * @returns Truncated title with ellipsis if needed
+ */
+export declare function formatTitle(title: string | undefined, maxWidth: number): string;
+/**
+ * Format identifiers (DOI, PMID, PMCID, ISBN) for display
+ *
+ * @param item - CSL item
+ * @returns Formatted identifier string (e.g., "DOI: 10.1000/example | PMID: 12345678")
+ */
+export declare function formatIdentifiers(item: CslItem): string;
+/**
+ * Compose a complete search result line
+ *
+ * Format:
+ * ```
+ * [1] Smith, J., & Doe, A. (2020)
+ *     Machine learning in medicine: A comprehensive review
+ *     DOI: 10.1000/example | PMID: 12345678
+ * ```
+ *
+ * @param item - CSL item
+ * @param index - Display index (1-based)
+ * @param terminalWidth - Terminal width for title truncation
+ * @returns Multi-line formatted string
+ */
+export declare function formatSearchResult(item: CslItem, index: number, terminalWidth: number): string;
+export {};
+//# sourceMappingURL=format.d.ts.map

package/dist/features/interactive/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/features/interactive/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D;;GAEG;AACH,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAqBtD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,SAAS,GAAG,MAAM,CAsBpE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAW/E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAiBvD;AAiBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAyB9F"}

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

@@ -0,0 +1,47 @@
+/**
+ * Interactive search prompt using Enquirer's AutoComplete
+ *
+ * Provides real-time incremental search with multiple selection support.
+ */
+import type { CslItem } from "../../core/csl-json/types.js";
+import type { SearchResult } from "../search/types.js";
+import type { AutoCompleteChoice } from "./enquirer.js";
+/**
+ * Configuration for the search prompt
+ */
+export interface SearchPromptConfig {
+    /** Maximum number of results to display */
+    limit: number;
+    /** Debounce delay in milliseconds */
+    debounceMs: number;
+}
+/**
+ * Search function type for filtering references
+ */
+export type SearchFunction = (query: string) => SearchResult[];
+/**
+ * Result from the search prompt
+ */
+export interface SearchPromptResult {
+    /** Selected references */
+    selected: CslItem[];
+    /** Whether the prompt was cancelled */
+    cancelled: boolean;
+}
+/**
+ * Creates choices from search results
+ */
+export declare function createChoices(results: SearchResult[], terminalWidth: number): AutoCompleteChoice[];
+/**
+ * Parses selected values back to CslItems
+ */
+export declare function parseSelectedValues(values: string | string[]): CslItem[];
+/**
+ * Gets terminal width, falling back to 80 if not available
+ */
+export declare function getTerminalWidth(): number;
+/**
+ * Creates and runs an interactive search prompt
+ */
+export declare function runSearchPrompt(allReferences: CslItem[], searchFn: SearchFunction, config: SearchPromptConfig, initialQuery?: string): Promise<SearchPromptResult>;
+//# sourceMappingURL=search-prompt.d.ts.map

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

@@ -0,0 +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,CAgBtB;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,wBAAsB,eAAe,CACnC,aAAa,EAAE,OAAO,EAAE,EACxB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,kBAAkB,EAC1B,YAAY,SAAK,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAgF7B"}

package/dist/features/interactive/tty.d.ts

@@ -0,0 +1,20 @@
+/**
+ * TTY detection for interactive mode
+ */
+/**
+ * Error thrown when TTY is required but not available
+ */
+export declare class TTYError extends Error {
+    readonly exitCode = 1;
+    constructor(message: string);
+}
+/**
+ * Check if the current environment is a TTY
+ *
+ * Throws TTYError if stdin or stdout is not a TTY,
+ * which means interactive mode cannot be used.
+ *
+ * @throws {TTYError} If not running in a TTY
+ */
+export declare function checkTTY(): void;
+//# sourceMappingURL=tty.d.ts.map

package/dist/features/interactive/tty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty.d.ts","sourceRoot":"","sources":["../../../src/features/interactive/tty.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,QAAQ,KAAK;gBAEV,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAI/B"}

package/dist/features/operations/add.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/features/operations/add.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOzD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC9B,+BAA+B;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAwC9B"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/features/operations/add.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOzD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC9B,+BAA+B;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAwC9B"}

package/dist/features/operations/list.d.ts

@@ -1,4 +1,5 @@
 import type { ILibrary } from "../../core/library-interface.js";
+import { type PaginationOptions, type SortOptions } from "../pagination/index.js";
 /**
  * Output format options for list operation
  */
@@ -6,7 +7,7 @@ export type ListFormat = "pretty" | "json" | "bibtex" | "ids-only" | "uuid";
 /**
  * Options for listReferences operation
  */
-export interface ListOptions {
+export interface ListOptions extends PaginationOptions, SortOptions {
     /** Output format (default: "pretty") */
     format?: ListFormat;
 }
@@ -16,13 +17,21 @@ export interface ListOptions {
 export interface ListResult {
     /** Formatted strings for each reference */
     items: string[];
+    /** Total count before pagination */
+    total: number;
+    /** Applied limit (0 if unlimited) */
+    limit: number;
+    /** Applied offset */
+    offset: number;
+    /** Next page offset, null if no more results */
+    nextOffset: number | null;
 }
 /**
  * List all references from the library with specified format.
  *
  * @param library - The library to list references from
- * @param options - Formatting options
- * @returns Formatted strings for each reference
+ * @param options - Formatting and pagination options
+ * @returns Formatted strings for each reference with pagination metadata
  */
 export declare function listReferences(library: ILibrary, options: ListOptions): Promise<ListResult>;
 //# sourceMappingURL=list.d.ts.map

package/dist/features/operations/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/features/operations/list.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAGhE;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA4BjG"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/features/operations/list.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhE,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,WAAW,EAIjB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,iBAAiB,EAAE,WAAW;IACjE,wCAAwC;IACxC,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AA4BD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA2BjG"}

package/dist/features/operations/search.d.ts

@@ -1,12 +1,20 @@
 import type { ILibrary } from "../../core/library-interface.js";
+import { type PaginationOptions, type SearchSortField, type SortOrder } from "../pagination/index.js";
 /**
  * Output format options for search operation
  */
 export type SearchFormat = "pretty" | "json" | "bibtex" | "ids-only" | "uuid";
+/**
+ * Sort options for search (includes relevance)
+ */
+export interface SearchSortOptions {
+    sort?: SearchSortField;
+    order?: SortOrder;
+}
 /**
  * Options for searchReferences operation
  */
-export interface SearchOperationOptions {
+export interface SearchOperationOptions extends PaginationOptions, SearchSortOptions {
     /** Search query string */
     query: string;
     /** Output format (default: "pretty") */
@@ -18,13 +26,21 @@ export interface SearchOperationOptions {
 export interface SearchResult {
     /** Formatted strings for each matching reference */
     items: string[];
+    /** Total count before pagination */
+    total: number;
+    /** Applied limit (0 if unlimited) */
+    limit: number;
+    /** Applied offset */
+    offset: number;
+    /** Next page offset, null if no more results */
+    nextOffset: number | null;
 }
 /**
  * Search references in the library and return formatted results.
  *
  * @param library - The library to search in
- * @param options - Search query and formatting options
- * @returns Formatted strings for each matching reference
+ * @param options - Search query, formatting, and pagination options
+ * @returns Formatted strings for each matching reference with pagination metadata
  */
 export declare function searchReferences(library: ILibrary, options: SearchOperationOptions): Promise<SearchResult>;
 //# sourceMappingURL=search.d.ts.map

package/dist/features/operations/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/features/operations/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAMhE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,YAAY,CAAC,CA0CvB"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/features/operations/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhE,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAEpB,KAAK,SAAS,EAGf,MAAM,wBAAwB,CAAC;AAKhC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB,EAAE,iBAAiB;IAClF,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AA4BD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAuDvB"}

package/dist/features/pagination/aliases.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Sort field alias resolver
+ */
+import type { SearchSortField } from "./types.js";
+/**
+ * Resolves a sort field alias to its full name.
+ * Passes through valid sort fields unchanged.
+ *
+ * @param alias - The alias or sort field name
+ * @returns The resolved sort field
+ * @throws Error if the alias is unknown
+ */
+export declare function resolveSortAlias(alias: string): SearchSortField;
+//# sourceMappingURL=aliases.d.ts.map

package/dist/features/pagination/aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.d.ts","sourceRoot":"","sources":["../../../src/features/pagination/aliases.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAkBlD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAW/D"}

package/dist/features/pagination/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Pagination feature exports
+ */
+export * from "./types.js";
+export { resolveSortAlias } from "./aliases.js";
+export { sortReferences } from "./sorter.js";
+export { paginate, type PaginateOptions, type PaginateResult } from "./paginate.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/features/pagination/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/pagination/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/features/pagination/paginate.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Pagination applier
+ */
+export interface PaginateOptions {
+    limit?: number;
+    offset?: number;
+}
+export interface PaginateResult<T> {
+    items: T[];
+    nextOffset: number | null;
+}
+/**
+ * Apply pagination to an array of items.
+ *
+ * @param items - Items to paginate
+ * @param options - Pagination options (limit=0 or undefined means unlimited)
+ * @returns Paginated items with nextOffset (null if no more items)
+ */
+export declare function paginate<T>(items: T[], options: PaginateOptions): PaginateResult<T>;
+//# sourceMappingURL=paginate.d.ts.map

package/dist/features/pagination/paginate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.d.ts","sourceRoot":"","sources":["../../../src/features/pagination/paginate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,eAAe,GAAG,cAAc,CAAC,CAAC,CAAC,CAiCnF"}

package/dist/features/pagination/sorter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Reference sorter
+ */
+import type { CslItem } from "../../core/csl-json/types.js";
+import type { SortField, SortOrder } from "./types.js";
+/**
+ * Sort references by the specified field and order.
+ * Uses secondary sort: created (desc), then id (asc) for stability.
+ *
+ * @param items - References to sort
+ * @param sort - Sort field
+ * @param order - Sort order
+ * @returns Sorted references (new array, does not mutate input)
+ */
+export declare function sortReferences(items: CslItem[], sort: SortField, order: SortOrder): CslItem[];
+//# sourceMappingURL=sorter.d.ts.map

package/dist/features/pagination/sorter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sorter.d.ts","sourceRoot":"","sources":["../../../src/features/pagination/sorter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAsFvD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,EAAE,CAmB7F"}

package/dist/features/pagination/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Pagination and sorting type definitions
+ */
+import { z } from "zod";
+/**
+ * Sort field for list/search commands
+ */
+export declare const sortFieldSchema: z.ZodEnum<{
+    title: "title";
+    author: "author";
+    updated: "updated";
+    created: "created";
+    published: "published";
+}>;
+export type SortField = z.infer<typeof sortFieldSchema>;
+/**
+ * Sort field for search command (includes relevance)
+ */
+export declare const searchSortFieldSchema: z.ZodEnum<{
+    title: "title";
+    author: "author";
+    updated: "updated";
+    created: "created";
+    published: "published";
+    relevance: "relevance";
+}>;
+export type SearchSortField = z.infer<typeof searchSortFieldSchema>;
+/**
+ * Sort order
+ */
+export declare const sortOrderSchema: z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+}>;
+export type SortOrder = z.infer<typeof sortOrderSchema>;
+/**
+ * Pagination options
+ */
+export declare const paginationOptionsSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PaginationOptions = z.infer<typeof paginationOptionsSchema>;
+/**
+ * Sort options
+ */
+export declare const sortOptionsSchema: z.ZodObject<{
+    sort: z.ZodOptional<z.ZodEnum<{
+        title: "title";
+        author: "author";
+        updated: "updated";
+        created: "created";
+        published: "published";
+    }>>;
+    order: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+}, z.core.$strip>;
+export type SortOptions<T extends string = SortField> = {
+    sort?: T;
+    order?: SortOrder;
+};
+/**
+ * Paginated result
+ */
+export interface PaginatedResult<T> {
+    items: T[];
+    total: number;
+    limit: number;
+    offset: number;
+    nextOffset: number | null;
+}
+//# sourceMappingURL=types.d.ts.map