@ncukondo/reference-manager 0.1.0 → 0.4.0

package/dist/features/operations/fulltext/attach.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Fulltext attach operation
+ */
+import type { ILibrary } from "../../../core/library-interface.js";
+import { type FulltextType } from "../../fulltext/index.js";
+/**
+ * Options for fulltextAttach operation
+ */
+export interface FulltextAttachOptions {
+    /** Reference identifier (id or uuid) */
+    identifier: string;
+    /** Path to the file to attach */
+    filePath?: string | undefined;
+    /** Explicit file type (pdf or markdown) */
+    type?: FulltextType | undefined;
+    /** Move file instead of copy */
+    move?: boolean | undefined;
+    /** Force overwrite existing file */
+    force?: boolean | undefined;
+    /** Use uuid instead of id for lookup */
+    byUuid?: boolean | undefined;
+    /** Directory for fulltext files */
+    fulltextDirectory: string;
+    /** Content from stdin */
+    stdinContent?: Buffer | undefined;
+}
+/**
+ * Result of fulltextAttach operation
+ */
+export interface FulltextAttachResult {
+    success: boolean;
+    filename?: string | undefined;
+    type?: FulltextType | undefined;
+    overwritten?: boolean | undefined;
+    existingFile?: string | undefined;
+    requiresConfirmation?: boolean | undefined;
+    error?: string | undefined;
+}
+/**
+ * Attach a fulltext file to a reference.
+ *
+ * @param library - The library containing the reference
+ * @param options - Attach options
+ * @returns Result of the attach operation
+ */
+export declare function fulltextAttach(library: ILibrary, options: FulltextAttachOptions): Promise<FulltextAttachResult>;
+//# sourceMappingURL=attach.d.ts.map

package/dist/features/operations/fulltext/attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/attach.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG9F;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,gCAAgC;IAChC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAuHD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAqE/B"}

package/dist/features/operations/fulltext/detach.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Fulltext detach operation
+ */
+import type { ILibrary } from "../../../core/library-interface.js";
+import { type FulltextType } from "../../fulltext/index.js";
+/**
+ * Options for fulltextDetach operation
+ */
+export interface FulltextDetachOptions {
+    /** Reference identifier (id or uuid) */
+    identifier: string;
+    /** Specific type to detach (pdf or markdown) */
+    type?: FulltextType | undefined;
+    /** Delete the file from disk */
+    delete?: boolean | undefined;
+    /** Use uuid instead of id for lookup */
+    byUuid?: boolean | undefined;
+    /** Directory for fulltext files */
+    fulltextDirectory: string;
+}
+/**
+ * Result of fulltextDetach operation
+ */
+export interface FulltextDetachResult {
+    success: boolean;
+    detached?: FulltextType[];
+    deleted?: FulltextType[];
+    error?: string;
+}
+/**
+ * Detach fulltext file(s) from a reference.
+ *
+ * @param library - The library containing the reference
+ * @param options - Detach options
+ * @returns Result of the detach operation
+ */
+export declare function fulltextDetach(library: ILibrary, options: FulltextDetachOptions): Promise<FulltextDetachResult>;
+//# sourceMappingURL=detach.d.ts.map

package/dist/features/operations/fulltext/detach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detach.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/detach.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAC;AAGjC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,gCAAgC;IAChC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqDD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA0C/B"}

package/dist/features/operations/fulltext/get.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Fulltext get operation
+ */
+import type { ILibrary } from "../../../core/library-interface.js";
+import { type FulltextType } from "../../fulltext/index.js";
+/**
+ * Options for fulltextGet operation
+ */
+export interface FulltextGetOptions {
+    /** Reference identifier (id or uuid) */
+    identifier: string;
+    /** Specific type to get (pdf or markdown) */
+    type?: FulltextType | undefined;
+    /** If true, return file content instead of path */
+    stdout?: boolean | undefined;
+    /** Use uuid instead of id for lookup */
+    byUuid?: boolean | undefined;
+    /** Directory for fulltext files */
+    fulltextDirectory: string;
+}
+/**
+ * Result of fulltextGet operation
+ */
+export interface FulltextGetResult {
+    success: boolean;
+    paths?: {
+        pdf?: string;
+        markdown?: string;
+    };
+    content?: Buffer;
+    error?: string;
+}
+/**
+ * Get fulltext file paths or content for a reference.
+ *
+ * @param library - The library containing the reference
+ * @param options - Get options
+ * @returns Result with file paths or content
+ */
+export declare function fulltextGet(library: ILibrary, options: FulltextGetOptions): Promise<FulltextGetResult>;
+//# sourceMappingURL=get.d.ts.map

package/dist/features/operations/fulltext/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/get.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAmDD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAwB5B"}

package/dist/features/operations/fulltext/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Fulltext operations module
+ *
+ * Provides operations for managing fulltext files attached to references.
+ */
+export { fulltextAttach, type FulltextAttachOptions, type FulltextAttachResult } from "./attach.js";
+export { fulltextGet, type FulltextGetOptions, type FulltextGetResult } from "./get.js";
+export { fulltextDetach, type FulltextDetachOptions, type FulltextDetachResult } from "./detach.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/features/operations/fulltext/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACpG,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Operations module exports
+ *
+ * Re-exports ILibraryOperations interface and OperationsLibrary class
+ * for CLI unification pattern.
+ *
+ * See: spec/decisions/ADR-009-ilibrary-operations-pattern.md
+ */
+export type { ILibraryOperations, ImportOptions, ImportResult, } from "./library-operations.js";
+export { OperationsLibrary } from "./operations-library.js";
+export type { SearchOperationOptions, SearchResult } from "./search.js";
+export type { ListOptions, ListResult } from "./list.js";
+export type { CiteOperationOptions, CiteResult, CiteItemResult } from "./cite.js";
+export type { AddReferencesOptions, AddReferencesResult } from "./add.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/operations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,YAAY,GACb,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAClF,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}

package/dist/features/operations/library-operations.d.ts

@@ -0,0 +1,64 @@
+/**
+ * ILibraryOperations interface
+ *
+ * Extends ILibrary with high-level operations for CLI unification.
+ * Both OperationsLibrary (local) and ServerClient (server) implement this interface,
+ * allowing CLI commands to use a single interface without branching.
+ *
+ * See: spec/decisions/ADR-009-ilibrary-operations-pattern.md
+ */
+import type { ILibrary } from "../../core/library-interface.js";
+import type { AddReferencesOptions, AddReferencesResult } from "./add.js";
+import type { CiteOperationOptions, CiteResult } from "./cite.js";
+import type { ListOptions, ListResult } from "./list.js";
+import type { SearchOperationOptions, SearchResult } from "./search.js";
+/**
+ * Options for import operation
+ *
+ * Extends AddReferencesOptions since import is the high-level version of add.
+ */
+export type ImportOptions = AddReferencesOptions;
+/**
+ * Result of import operation
+ */
+export type ImportResult = AddReferencesResult;
+/**
+ * High-level library operations interface
+ *
+ * Extends ILibrary with search, list, cite, and import methods.
+ * This interface is implemented by:
+ * - OperationsLibrary: Wraps Library and uses operation functions
+ * - ServerClient: Makes HTTP requests to server endpoints
+ */
+export interface ILibraryOperations extends ILibrary {
+    /**
+     * Search references by query
+     *
+     * @param options - Search options including query and format
+     * @returns Search results with formatted items
+     */
+    search(options: SearchOperationOptions): Promise<SearchResult>;
+    /**
+     * List all references
+     *
+     * @param options - List options including format
+     * @returns List results with formatted items
+     */
+    list(options?: ListOptions): Promise<ListResult>;
+    /**
+     * Generate citations for references
+     *
+     * @param options - Citation options including identifiers, style, and format
+     * @returns Citation results
+     */
+    cite(options: CiteOperationOptions): Promise<CiteResult>;
+    /**
+     * Import references from various sources
+     *
+     * @param inputs - Array of inputs (PMID, DOI, BibTeX, RIS, file paths)
+     * @param options - Import options
+     * @returns Import results with added, failed, and skipped items
+     */
+    import(inputs: string[], options?: ImportOptions): Promise<ImportResult>;
+}
+//# sourceMappingURL=library-operations.d.ts.map

package/dist/features/operations/library-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-operations.d.ts","sourceRoot":"","sources":["../../../src/features/operations/library-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAmB,SAAQ,QAAQ;IAClD;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/D;;;;;OAKG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzD;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1E"}

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

@@ -0,0 +1,28 @@
+import type { ILibrary } from "../../core/library-interface.js";
+/**
+ * Output format options for list operation
+ */
+export type ListFormat = "pretty" | "json" | "bibtex" | "ids-only" | "uuid";
+/**
+ * Options for listReferences operation
+ */
+export interface ListOptions {
+    /** Output format (default: "pretty") */
+    format?: ListFormat;
+}
+/**
+ * Result of listReferences operation
+ */
+export interface ListResult {
+    /** Formatted strings for each reference */
+    items: string[];
+}
+/**
+ * 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
+ */
+export declare function listReferences(library: ILibrary, options: ListOptions): Promise<ListResult>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +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"}

package/dist/features/operations/operations-library.d.ts

@@ -0,0 +1,36 @@
+/**
+ * OperationsLibrary class
+ *
+ * Wraps an ILibrary instance and provides ILibraryOperations interface.
+ * Delegates ILibrary methods to the underlying library and implements
+ * high-level operations (search, list, cite, import) using operation functions.
+ *
+ * See: spec/decisions/ADR-009-ilibrary-operations-pattern.md
+ */
+import type { CslItem } from "../../core/csl-json/types.js";
+import type { FindOptions, ILibrary, RemoveResult, UpdateOptions, UpdateResult } from "../../core/library-interface.js";
+import type { CiteOperationOptions, CiteResult } from "./cite.js";
+import type { ILibraryOperations, ImportOptions, ImportResult } from "./library-operations.js";
+import type { ListOptions, ListResult } from "./list.js";
+import type { SearchOperationOptions, SearchResult } from "./search.js";
+/**
+ * OperationsLibrary wraps an ILibrary and implements ILibraryOperations
+ *
+ * This allows CLI commands to use a single interface without branching
+ * between local (Library) and server (ServerClient) modes.
+ */
+export declare class OperationsLibrary implements ILibraryOperations {
+    private readonly library;
+    constructor(library: ILibrary);
+    find(identifier: string, options?: FindOptions): Promise<CslItem | undefined>;
+    getAll(): Promise<CslItem[]>;
+    add(item: CslItem): Promise<CslItem>;
+    update(idOrUuid: string, updates: Partial<CslItem>, options?: UpdateOptions): Promise<UpdateResult>;
+    remove(identifier: string, options?: FindOptions): Promise<RemoveResult>;
+    save(): Promise<void>;
+    search(options: SearchOperationOptions): Promise<SearchResult>;
+    list(options?: ListOptions): Promise<ListResult>;
+    cite(options: CiteOperationOptions): Promise<CiteResult>;
+    import(inputs: string[], options?: ImportOptions): Promise<ImportResult>;
+}
+//# sourceMappingURL=operations-library.d.ts.map

package/dist/features/operations/operations-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations-library.d.ts","sourceRoot":"","sources":["../../../src/features/operations/operations-library.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,YAAY,EACb,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC/F,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExE;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,QAAQ;IAI9C,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAI7E,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAI5B,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpC,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EACzB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IAIxB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAIxE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMf,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC;IAK9D,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAKhD,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAKxD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CAI/E"}

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

@@ -0,0 +1,29 @@
+import type { CslItem } from "../../core/csl-json/types.js";
+import type { ILibrary } from "../../core/library-interface.js";
+/**
+ * Options for removeReference operation
+ */
+export interface RemoveOperationOptions {
+    /** Reference ID or UUID */
+    identifier: string;
+    /** If true, identifier is treated as UUID; otherwise as ID (default: false) */
+    byUuid?: boolean;
+}
+/**
+ * Result of removeReference operation
+ */
+export interface RemoveResult {
+    /** Whether the reference was removed */
+    removed: boolean;
+    /** The removed item (if found and removal succeeded) */
+    removedItem?: CslItem;
+}
+/**
+ * Remove a reference from the library.
+ *
+ * @param library - The library to remove from
+ * @param options - Remove options including identifier and lookup method
+ * @returns Result indicating success and the removed item
+ */
+export declare function removeReference(library: ILibrary, options: RemoveOperationOptions): Promise<RemoveResult>;
+//# sourceMappingURL=remove.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/features/operations/remove.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAUvB"}

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

@@ -0,0 +1,30 @@
+import type { ILibrary } from "../../core/library-interface.js";
+/**
+ * Output format options for search operation
+ */
+export type SearchFormat = "pretty" | "json" | "bibtex" | "ids-only" | "uuid";
+/**
+ * Options for searchReferences operation
+ */
+export interface SearchOperationOptions {
+    /** Search query string */
+    query: string;
+    /** Output format (default: "pretty") */
+    format?: SearchFormat;
+}
+/**
+ * Result of searchReferences operation
+ */
+export interface SearchResult {
+    /** Formatted strings for each matching reference */
+    items: string[];
+}
+/**
+ * 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
+ */
+export declare function searchReferences(library: ILibrary, options: SearchOperationOptions): Promise<SearchResult>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,39 @@
+import type { CslItem } from "../../core/csl-json/types.js";
+import type { ILibrary } from "../../core/library-interface.js";
+/**
+ * Options for updateReference operation
+ */
+export interface UpdateOperationOptions {
+    /** Reference ID or UUID */
+    identifier: string;
+    /** If true, identifier is treated as UUID; otherwise as ID (default: false) */
+    byUuid?: boolean;
+    /** Partial updates to apply to the reference */
+    updates: Partial<CslItem>;
+    /** How to handle ID collision: 'fail' (default) or 'suffix' */
+    onIdCollision?: "fail" | "suffix";
+}
+/**
+ * Result of updateReference operation
+ */
+export interface UpdateOperationResult {
+    /** Whether the update was successful */
+    updated: boolean;
+    /** The updated item (if successful) */
+    item?: CslItem;
+    /** True if ID collision occurred (only when updated=false and onIdCollision='fail') */
+    idCollision?: boolean;
+    /** True if the ID was changed due to collision resolution */
+    idChanged?: boolean;
+    /** The new ID after collision resolution (only when idChanged=true) */
+    newId?: string;
+}
+/**
+ * Update a reference in the library.
+ *
+ * @param library - The library to update
+ * @param options - Update options including identifier, updates, and collision handling
+ * @returns Result indicating success and the updated item
+ */
+export declare function updateReference(library: ILibrary, options: UpdateOperationOptions): Promise<UpdateOperationResult>;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/features/operations/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uFAAuF;IACvF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CA8BhC"}

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

@@ -1 +1 @@
-{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../../src/features/search/matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAiB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAuRvF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,GAAG,UAAU,EAAE,CAQ/E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,YAAY,GAAG,IAAI,CA4C7F;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,YAAY,EAAE,CAWnF"}
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../../src/features/search/matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAiB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAqUvF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,GAAG,UAAU,EAAE,CAQ/E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,YAAY,GAAG,IAAI,CA4C7F;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,YAAY,EAAE,CAWnF"}

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

@@ -9,4 +9,16 @@
  * 5. Whitespace normalization
  */
 export declare function normalize(text: string): string;
+/**
+ * Normalize text for matching while preserving case
+ *
+ * Applies the following transformations:
+ * 1. Unicode NFKC normalization
+ * 2. Remove diacritics (accents)
+ * 3. Normalize whitespace
+ *
+ * Unlike `normalize`, this function preserves letter case
+ * for use with uppercase-sensitive matching.
+ */
+export declare function normalizePreservingCase(text: string): string;
 //# sourceMappingURL=normalizer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../../src/features/search/normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsB9C"}
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../../src/features/search/normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsB9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAc5D"}

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

@@ -1 +1 @@
-{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../../src/features/search/tokenizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,WAAW,EAAe,MAAM,YAAY,CAAC;AA2B3E;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAuBnD"}
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../../src/features/search/tokenizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,WAAW,EAAe,MAAM,YAAY,CAAC;AA4B3E;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAuBnD"}

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

@@ -5,7 +5,7 @@ import type { CslItem } from "../../core/csl-json/types.js";
 /**
  * Field specifier for field-specific search
  */
-export type FieldSpecifier = "author" | "title" | "year" | "doi" | "pmid" | "pmcid" | "url" | "keyword";
+export type FieldSpecifier = "author" | "title" | "year" | "doi" | "pmid" | "pmcid" | "url" | "keyword" | "tag";
 /**
  * Search token representing a parsed query element
  */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/search/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,OAAO,GACP,MAAM,GACN,KAAK,GACL,MAAM,GACN,OAAO,GACP,KAAK,GACL,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,QAAQ,EAAE,aAAa,CAAC;IACxB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,KAAK,EAAE,WAAW,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,iEAAiE;IACjE,eAAe,EAAE,aAAa,CAAC;IAC/B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnD,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/search/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,OAAO,GACP,MAAM,GACN,KAAK,GACL,MAAM,GACN,OAAO,GACP,KAAK,GACL,SAAS,GACT,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,QAAQ,EAAE,aAAa,CAAC;IACxB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,KAAK,EAAE,WAAW,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,iEAAiE;IACjE,eAAe,EAAE,aAAa,CAAC;IAC/B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnD,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

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

@@ -0,0 +1,41 @@
+/**
+ * Represents a segment of consecutive uppercase letters in a string.
+ */
+export interface UppercaseSegment {
+    /** The uppercase segment text */
+    segment: string;
+    /** Start index (inclusive) */
+    start: number;
+    /** End index (exclusive) */
+    end: number;
+}
+/**
+ * Checks if the text contains 2 or more consecutive uppercase letters.
+ * Pattern: /[A-Z]{2,}/
+ *
+ * @param text - The text to check
+ * @returns true if text contains consecutive uppercase letters
+ */
+export declare function hasConsecutiveUppercase(text: string): boolean;
+/**
+ * Extracts all segments of 2 or more consecutive uppercase letters from text.
+ * Pattern: /[A-Z]{2,}/g
+ *
+ * @param text - The text to extract segments from
+ * @returns Array of uppercase segments with their positions
+ */
+export declare function extractUppercaseSegments(text: string): UppercaseSegment[];
+/**
+ * Matches a query string against a target string with case sensitivity
+ * for consecutive uppercase segments in the query.
+ *
+ * - If query contains 2+ consecutive uppercase letters (e.g., AI, RNA),
+ *   those portions must match exactly in the target.
+ * - Other portions are matched case-insensitively.
+ *
+ * @param query - The search query
+ * @param target - The target string to match against
+ * @returns true if query matches target according to the rules
+ */
+export declare function matchWithUppercaseSensitivity(query: string, target: string): boolean;
+//# sourceMappingURL=uppercase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uppercase.d.ts","sourceRoot":"","sources":["../../../src/features/search/uppercase.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG7D;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAazE;AAoDD;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CA6BpF"}