@ncukondo/reference-manager 0.1.0

package/dist/core/identifier/uuid.d.ts

@@ -0,0 +1,24 @@
+import type { CslCustom } from "../csl-json/types";
+/**
+ * Validate if a string is a valid UUID v4
+ */
+export declare function isValidUuid(uuid: string): boolean;
+/**
+ * Generate a new UUID v4
+ */
+export declare function generateUuid(): string;
+/**
+ * Generate a new ISO 8601 timestamp
+ */
+export declare function generateTimestamp(): string;
+/**
+ * Extract UUID from custom field
+ */
+export declare function extractUuidFromCustom(custom: CslCustom | undefined): string | null;
+/**
+ * Ensure custom metadata has valid UUID, created_at, and timestamp
+ * Handles legacy migration from old timestamp-only format
+ * Generates new values if missing or invalid
+ */
+export declare function ensureCustomMetadata(custom: CslCustom | undefined): CslCustom;
+//# sourceMappingURL=uuid.d.ts.map

package/dist/core/identifier/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../../src/core/identifier/uuid.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAInD;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAMlF;AAoED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAK7E"}

package/dist/core/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Core module exports
+ */
+export { Reference } from "./reference";
+export type { ReferenceCreateOptions } from "./reference";
+export { Library } from "./library";
+export type { CslItem, CslLibrary, CslCustom } from "./csl-json/types";
+export { CslItemSchema, CslLibrarySchema } from "./csl-json/types";
+export { parseCslJson } from "./csl-json/parser";
+export { serializeCslJson, writeCslJson } from "./csl-json/serializer";
+export { validateCslJson } from "./csl-json/validator";
+export { generateId, generateIdWithCollisionCheck } from "./identifier/generator";
+export { normalizeText } from "./identifier/normalize";
+export { generateUuid, isValidUuid, ensureCustomMetadata, extractUuidFromCustom, } from "./identifier/uuid";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,UAAU,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC"}

package/dist/core/library.d.ts

@@ -0,0 +1,73 @@
+import type { CslItem } from "./csl-json/types";
+import { Reference } from "./reference";
+/**
+ * Library manager for CSL-JSON references
+ */
+export declare class Library {
+    private filePath;
+    private references;
+    private currentHash;
+    private uuidIndex;
+    private idIndex;
+    private doiIndex;
+    private pmidIndex;
+    private constructor();
+    /**
+     * Load library from file
+     */
+    static load(filePath: string): Promise<Library>;
+    /**
+     * Save library to file
+     */
+    save(): Promise<void>;
+    /**
+     * Add a reference to the library
+     */
+    add(item: CslItem): void;
+    /**
+     * Remove a reference by UUID
+     */
+    removeByUuid(uuid: string): boolean;
+    /**
+     * Remove a reference by ID
+     */
+    removeById(id: string): boolean;
+    /**
+     * Find a reference by UUID
+     */
+    findByUuid(uuid: string): Reference | undefined;
+    /**
+     * Find a reference by ID
+     */
+    findById(id: string): Reference | undefined;
+    /**
+     * Find a reference by DOI
+     */
+    findByDoi(doi: string): Reference | undefined;
+    /**
+     * Find a reference by PMID
+     */
+    findByPmid(pmid: string): Reference | undefined;
+    /**
+     * Get all references
+     */
+    getAll(): Reference[];
+    /**
+     * Get the file path
+     */
+    getFilePath(): string;
+    /**
+     * Get the current file hash
+     * Returns null if the library has not been loaded or saved yet
+     */
+    getCurrentHash(): string | null;
+    /**
+     * Add reference to all indices
+     */
+    private addToIndices;
+    /**
+     * Remove reference from all indices and array
+     */
+    private removeReference;
+}
+//# sourceMappingURL=library.d.ts.map

package/dist/core/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/core/library.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,WAAW,CAAuB;IAG1C,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,SAAS,CAAqC;IAEtD,OAAO;IAWP;;OAEG;WACU,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQrD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAYxB;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IASnC;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS/B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI/C;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI3C;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI7C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI/C;;OAEG;IACH,MAAM,IAAI,SAAS,EAAE;IAIrB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,OAAO,CAAC,eAAe;CAwBxB"}

package/dist/core/reference.d.ts

@@ -0,0 +1,86 @@
+import type { CslItem } from "./csl-json/types";
+/**
+ * Options for creating a Reference
+ */
+export interface ReferenceCreateOptions {
+    /** Existing IDs to check for collision */
+    existingIds?: Set<string>;
+}
+/**
+ * Reference entity wrapping a CSL-JSON item
+ */
+export declare class Reference {
+    private item;
+    private uuid;
+    constructor(item: CslItem);
+    /**
+     * Factory method to create a Reference with UUID and ID generation
+     */
+    static create(item: CslItem, options?: ReferenceCreateOptions): Reference;
+    /**
+     * Get the underlying CSL-JSON item
+     */
+    getItem(): CslItem;
+    /**
+     * Get the UUID (internal stable identifier)
+     */
+    getUuid(): string;
+    /**
+     * Get the ID (Pandoc citation key / BibTeX-key)
+     */
+    getId(): string;
+    /**
+     * Get the title
+     */
+    getTitle(): string | undefined;
+    /**
+     * Get the authors
+     */
+    getAuthors(): CslItem["author"];
+    /**
+     * Get the year from issued date
+     */
+    getYear(): number | undefined;
+    /**
+     * Get the DOI
+     */
+    getDoi(): string | undefined;
+    /**
+     * Get the PMID
+     */
+    getPmid(): string | undefined;
+    /**
+     * Get the PMCID
+     */
+    getPmcid(): string | undefined;
+    /**
+     * Get the URL
+     */
+    getUrl(): string | undefined;
+    /**
+     * Get the keyword
+     */
+    getKeyword(): string[] | undefined;
+    /**
+     * Get additional URLs from custom metadata
+     */
+    getAdditionalUrls(): string[] | undefined;
+    /**
+     * Get the creation timestamp from custom metadata (immutable)
+     */
+    getCreatedAt(): string;
+    /**
+     * Get the last modification timestamp from custom metadata
+     */
+    getTimestamp(): string;
+    /**
+     * Update the timestamp to current time
+     * Call this whenever the reference is modified
+     */
+    touch(): void;
+    /**
+     * Get the type
+     */
+    getType(): string;
+}
+//# sourceMappingURL=reference.d.ts.map

package/dist/core/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/core/reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIhD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,IAAI,CAAS;gBAET,IAAI,EAAE,OAAO;IAazB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,SAAS;IAazE;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,QAAQ,IAAI,MAAM,GAAG,SAAS;IAI9B;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC;IAI/B;;OAEG;IACH,OAAO,IAAI,MAAM,GAAG,SAAS;IAS7B;;OAEG;IACH,MAAM,IAAI,MAAM,GAAG,SAAS;IAI5B;;OAEG;IACH,OAAO,IAAI,MAAM,GAAG,SAAS;IAI7B;;OAEG;IACH,QAAQ,IAAI,MAAM,GAAG,SAAS;IAI9B;;OAEG;IACH,MAAM,IAAI,MAAM,GAAG,SAAS;IAI5B;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE,GAAG,SAAS;IAIlC;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE,GAAG,SAAS;IAIzC;;OAEG;IACH,YAAY,IAAI,MAAM;IAOtB;;OAEG;IACH,YAAY,IAAI,MAAM;IAOtB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,OAAO,IAAI,MAAM;CAGlB"}

package/dist/features/duplicate/detector.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Duplicate detection logic
+ */
+import type { CslItem } from "../../core/csl-json/types.js";
+import type { DuplicateResult } from "./types.js";
+/**
+ * Detects if a reference is a duplicate of any existing references
+ *
+ * Priority order:
+ * 1. DOI (highest priority)
+ * 2. PMID
+ * 3. Title + Author + Year (lowest priority)
+ *
+ * @param item - The reference to check for duplicates
+ * @param existingReferences - Array of existing references to check against
+ * @returns DuplicateResult indicating if duplicate found and match details
+ */
+export declare function detectDuplicate(item: CslItem, existingReferences: CslItem[]): DuplicateResult;
+//# sourceMappingURL=detector.d.ts.map

package/dist/features/duplicate/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/features/duplicate/detector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,YAAY,CAAC;AAwJlE;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG,eAAe,CAoB7F"}

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

@@ -0,0 +1,6 @@
+/**
+ * Duplicate detection exports
+ */
+export * from "./types.js";
+export { detectDuplicate } from "./detector.js";
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,45 @@
+/**
+ * Duplicate detection types
+ */
+import type { CslItem } from "../../core/csl-json/types.js";
+/**
+ * Type of duplicate match
+ */
+export type DuplicateType = "doi" | "pmid" | "title-author-year";
+/**
+ * A single duplicate match result
+ */
+export interface DuplicateMatch {
+    /**
+     * The type of duplicate detected
+     */
+    type: DuplicateType;
+    /**
+     * The existing reference that matches
+     */
+    existing: CslItem;
+    /**
+     * Optional match details (e.g., normalized values used for comparison)
+     */
+    details?: {
+        doi?: string;
+        pmid?: string;
+        normalizedTitle?: string;
+        normalizedAuthors?: string;
+        year?: string;
+    };
+}
+/**
+ * Result of duplicate detection
+ */
+export interface DuplicateResult {
+    /**
+     * Whether a duplicate was found
+     */
+    isDuplicate: boolean;
+    /**
+     * Array of duplicate matches (can have multiple matches)
+     */
+    matches: DuplicateMatch[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/duplicate/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,mBAAmB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B"}

package/dist/features/file-watcher/file-watcher.d.ts

@@ -0,0 +1,83 @@
+import { EventEmitter } from "node:events";
+/**
+ * Options for FileWatcher
+ */
+export interface FileWatcherOptions {
+    /** Debounce time in milliseconds (default: 500) */
+    debounceMs?: number;
+    /** Poll interval in milliseconds for polling mode (default: 5000) */
+    pollIntervalMs?: number;
+    /** Use polling instead of native file system events */
+    usePolling?: boolean;
+    /** Retry delay in milliseconds for JSON parse (default: 200) */
+    retryDelayMs?: number;
+    /** Maximum number of retries for JSON parse (default: 10) */
+    maxRetries?: number;
+}
+/**
+ * FileWatcher watches a file or directory for changes and emits events.
+ *
+ * Events:
+ * - 'change': Emitted when a watched file changes (after debounce)
+ * - 'error': Emitted when a watch error occurs
+ * - 'ready': Emitted when watching has started
+ * - 'parsed': Emitted when JSON file is successfully parsed
+ * - 'parseError': Emitted when JSON parse fails after all retries
+ */
+export declare class FileWatcher extends EventEmitter {
+    private readonly watchPath;
+    private readonly debounceMs;
+    private readonly pollIntervalMs;
+    private readonly usePolling;
+    private readonly retryDelayMs;
+    private readonly maxRetries;
+    private watcher;
+    private watching;
+    private debounceTimers;
+    constructor(watchPath: string, options?: FileWatcherOptions);
+    /**
+     * Start watching for file changes
+     */
+    start(): Promise<void>;
+    /**
+     * Handle file change with debouncing
+     */
+    private handleFileChange;
+    /**
+     * Try to parse JSON file with retries
+     */
+    private tryParseJsonFile;
+    /**
+     * Delay helper
+     */
+    private delay;
+    /**
+     * Stop watching for file changes
+     */
+    close(): void;
+    /**
+     * Get the watched path
+     */
+    getPath(): string;
+    /**
+     * Check if the watcher is currently active
+     */
+    isWatching(): boolean;
+    /**
+     * Get the debounce time in milliseconds
+     */
+    getDebounceMs(): number;
+    /**
+     * Get the poll interval in milliseconds
+     */
+    getPollIntervalMs(): number;
+    /**
+     * Get the retry delay in milliseconds
+     */
+    getRetryDelayMs(): number;
+    /**
+     * Get the maximum number of retries
+     */
+    getMaxRetries(): number;
+}
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/features/file-watcher/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../../src/features/file-watcher/file-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAyCD;;;;;;;;;GASG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAA0C;gBAEpD,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB;IAU3D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsC5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;YACW,gBAAgB;IAyB9B;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,KAAK,IAAI,IAAI;IAeb;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,aAAa,IAAI,MAAM;CAGxB"}

package/dist/features/file-watcher/index.d.ts

@@ -0,0 +1,2 @@
+export { FileWatcher, type FileWatcherOptions } from "./file-watcher";
+//# sourceMappingURL=index.d.ts.map

package/dist/features/file-watcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/file-watcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * 3-way merge module
+ *
+ * Provides Last-Write-Wins (LWW) merge strategy for CSL-JSON items
+ */
+export type { FieldConflict, ItemConflict, MergeOptions, MergeResult, MergeStatus, PreferOption, } from "./types.js";
+export { threeWayMerge } from "./three-way.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/merge/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/features/merge/three-way.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 3-way merge implementation with Last-Write-Wins (LWW) strategy
+ */
+import type { CslItem } from "../../core/csl-json/types.js";
+import type { MergeOptions, MergeResult } from "./types.js";
+/**
+ * Performs a 3-way merge of CSL-JSON items
+ *
+ * @param base - Base version (common ancestor)
+ * @param local - Local version (current working copy)
+ * @param remote - Remote version (incoming changes)
+ * @param options - Merge options (e.g., prefer local/remote for tie-breaking)
+ * @returns Merge result with merged items and conflict information
+ */
+export declare function threeWayMerge(base: CslItem[], local: CslItem[], remote: CslItem[], options?: MergeOptions): MergeResult;
+//# sourceMappingURL=three-way.d.ts.map

package/dist/features/merge/three-way.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-way.d.ts","sourceRoot":"","sources":["../../../src/features/merge/three-way.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EAGV,YAAY,EACZ,WAAW,EAEZ,MAAM,YAAY,CAAC;AA2TpB;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,OAAO,EAAE,EACf,KAAK,EAAE,OAAO,EAAE,EAChB,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,YAAY,GACrB,WAAW,CA6Bb"}

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

@@ -0,0 +1,74 @@
+/**
+ * 3-way merge types for Last-Write-Wins (LWW) conflict resolution
+ */
+import type { CslItem } from "../../core/csl-json/types.js";
+/**
+ * Preference option for tie-breaking when timestamps are equal
+ */
+export type PreferOption = "local" | "remote";
+/**
+ * Merge options
+ */
+export interface MergeOptions {
+    /**
+     * Tie-breaker when custom.timestamp values are equal
+     * If not provided and timestamps are equal, conflict is reported
+     */
+    prefer?: PreferOption;
+}
+/**
+ * Information about a field conflict
+ */
+export interface FieldConflict {
+    /** Field path (e.g., "title", "author[0].family") */
+    field: string;
+    /** Value in base version */
+    base: unknown;
+    /** Value in local version */
+    local: unknown;
+    /** Value in remote version */
+    remote: unknown;
+    /** Chosen value (based on LWW or prefer option) */
+    resolved?: unknown;
+}
+/**
+ * Information about a conflicted item
+ */
+export interface ItemConflict {
+    /** UUID of the conflicted item */
+    uuid: string;
+    /** ID (citation key) of the item */
+    id: string;
+    /** List of conflicting fields */
+    fields: FieldConflict[];
+    /** Local timestamp */
+    localTimestamp: string;
+    /** Remote timestamp */
+    remoteTimestamp: string;
+    /** How the conflict was resolved */
+    resolution: "auto-lww" | "prefer-local" | "prefer-remote" | "unresolved";
+}
+/**
+ * Merge status
+ */
+export type MergeStatus = "success" | "auto-resolved" | "conflict";
+/**
+ * Result of a 3-way merge operation
+ */
+export interface MergeResult {
+    /** Merge status */
+    status: MergeStatus;
+    /** Merged items (all items from both sides, with conflicts resolved) */
+    merged: CslItem[];
+    /** List of conflicts (empty if status is 'success') */
+    conflicts: ItemConflict[];
+    /** Items only in local (additions in local) */
+    localOnly: CslItem[];
+    /** Items only in remote (additions in remote) */
+    remoteOnly: CslItem[];
+    /** Items deleted in local (present in base, absent in local) */
+    deletedInLocal: CslItem[];
+    /** Items deleted in remote (present in base, absent in remote) */
+    deletedInRemote: CslItem[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/merge/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,6BAA6B;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,8BAA8B;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,UAAU,EAAE,UAAU,GAAG,cAAc,GAAG,eAAe,GAAG,YAAY,CAAC;CAC1E;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,eAAe,GACf,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,wEAAwE;IACxE,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,uDAAuD;IACvD,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,+CAA+C;IAC/C,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,iDAAiD;IACjD,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,gEAAgE;IAChE,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B,kEAAkE;IAClE,eAAe,EAAE,OAAO,EAAE,CAAC;CAC5B"}

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

@@ -0,0 +1,9 @@
+/**
+ * Search feature exports
+ */
+export * from "./types.js";
+export { tokenize } from "./tokenizer.js";
+export { normalize } from "./normalizer.js";
+export { search } from "./matcher.js";
+export { sortResults } from "./sorter.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/search/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { CslItem } from "../../core/csl-json/types.js";
+import type { FieldMatch, SearchResult, SearchToken } from "./types.js";
+/**
+ * Match a single token against a reference
+ * Returns an array of field matches
+ */
+export declare function matchToken(token: SearchToken, reference: CslItem): FieldMatch[];
+/**
+ * Match a reference against all search tokens
+ * Returns a SearchResult if all tokens match (AND logic), null otherwise
+ */
+export declare function matchReference(reference: CslItem, tokens: SearchToken[]): SearchResult | null;
+/**
+ * Search references against search tokens
+ * Returns array of SearchResult for all matching references
+ */
+export declare function search(references: CslItem[], tokens: SearchToken[]): SearchResult[];
+//# sourceMappingURL=matcher.d.ts.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * Normalize text for search matching
+ *
+ * Applies the following transformations:
+ * 1. Unicode NFKC normalization
+ * 2. Lowercase conversion
+ * 3. Remove diacritics (accents)
+ * 4. Punctuation removal
+ * 5. Whitespace normalization
+ */
+export declare function normalize(text: string): string;
+//# sourceMappingURL=normalizer.d.ts.map

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

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

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

@@ -0,0 +1,11 @@
+import type { SearchResult } from "./types.js";
+/**
+ * Sort search results according to the specification:
+ * 1. Match strength (exact > partial)
+ * 2. Year (descending)
+ * 3. Author (alphabetical)
+ * 4. Title (alphabetical)
+ * 5. Registration order (original array order)
+ */
+export declare function sortResults(results: SearchResult[]): SearchResult[];
+//# sourceMappingURL=sorter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sorter.d.ts","sourceRoot":"","sources":["../../../src/features/search/sorter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,YAAY,CAAC;AA6E9D;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CA4BnE"}

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

@@ -0,0 +1,6 @@
+import type { SearchQuery } from "./types.js";
+/**
+ * Tokenize a search query string
+ */
+export declare function tokenize(query: string): SearchQuery;
+//# sourceMappingURL=tokenizer.d.ts.map

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

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