@ncukondo/reference-manager 0.29.5 → 0.30.0

package/dist/config/schema.d.ts

@@ -149,6 +149,24 @@ declare const fulltextPreferredTypeSchema: z.ZodEnum<{
 /**
  * Fulltext retrieval configuration schema
  */
+/**
+ * Custom converter configuration schema
+ */
+export declare const customConverterSchema: z.ZodObject<{
+    command: z.ZodString;
+    outputMode: z.ZodOptional<z.ZodEnum<{
+        file: "file";
+        stdout: "stdout";
+    }>>;
+    checkCommand: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    progress: z.ZodOptional<z.ZodEnum<{
+        inherit: "inherit";
+        quiet: "quiet";
+    }>>;
+    commandWindows: z.ZodOptional<z.ZodString>;
+    checkCommandWindows: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const fulltextConfigSchema: z.ZodObject<{
     preferSources: z.ZodArray<z.ZodEnum<{
         pmc: "pmc";
@@ -161,6 +179,24 @@ export declare const fulltextConfigSchema: z.ZodObject<{
         markdown: "markdown";
     }>>;
     autoFetchOnAdd: z.ZodBoolean;
+    pdfConverter: z.ZodString;
+    pdfConverterPriority: z.ZodArray<z.ZodString>;
+    pdfConverterTimeout: z.ZodNumber;
+    converters: z.ZodRecord<z.ZodString, z.ZodObject<{
+        command: z.ZodString;
+        outputMode: z.ZodOptional<z.ZodEnum<{
+            file: "file";
+            stdout: "stdout";
+        }>>;
+        checkCommand: z.ZodOptional<z.ZodString>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        progress: z.ZodOptional<z.ZodEnum<{
+            inherit: "inherit";
+            quiet: "quiet";
+        }>>;
+        commandWindows: z.ZodOptional<z.ZodString>;
+        checkCommandWindows: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     sources: z.ZodObject<{
         unpaywallEmail: z.ZodOptional<z.ZodString>;
         coreApiKey: z.ZodOptional<z.ZodString>;
@@ -230,6 +266,24 @@ export declare const configSchema: z.ZodObject<{
             markdown: "markdown";
         }>>;
         autoFetchOnAdd: z.ZodBoolean;
+        pdfConverter: z.ZodString;
+        pdfConverterPriority: z.ZodArray<z.ZodString>;
+        pdfConverterTimeout: z.ZodNumber;
+        converters: z.ZodRecord<z.ZodString, z.ZodObject<{
+            command: z.ZodString;
+            outputMode: z.ZodOptional<z.ZodEnum<{
+                file: "file";
+                stdout: "stdout";
+            }>>;
+            checkCommand: z.ZodOptional<z.ZodString>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            progress: z.ZodOptional<z.ZodEnum<{
+                inherit: "inherit";
+                quiet: "quiet";
+            }>>;
+            commandWindows: z.ZodOptional<z.ZodString>;
+            checkCommandWindows: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         sources: z.ZodObject<{
             unpaywallEmail: z.ZodOptional<z.ZodString>;
             coreApiKey: z.ZodOptional<z.ZodString>;
@@ -363,6 +417,27 @@ export declare const partialConfigSchema: z.ZodObject<{
         }>>;
         autoFetchOnAdd: z.ZodOptional<z.ZodBoolean>;
         auto_fetch_on_add: z.ZodOptional<z.ZodBoolean>;
+        pdfConverter: z.ZodOptional<z.ZodString>;
+        pdf_converter: z.ZodOptional<z.ZodString>;
+        pdfConverterPriority: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        pdf_converter_priority: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        pdfConverterTimeout: z.ZodOptional<z.ZodNumber>;
+        pdf_converter_timeout: z.ZodOptional<z.ZodNumber>;
+        converters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            command: z.ZodString;
+            outputMode: z.ZodOptional<z.ZodEnum<{
+                file: "file";
+                stdout: "stdout";
+            }>>;
+            checkCommand: z.ZodOptional<z.ZodString>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            progress: z.ZodOptional<z.ZodEnum<{
+                inherit: "inherit";
+                quiet: "quiet";
+            }>>;
+            commandWindows: z.ZodOptional<z.ZodString>;
+            checkCommandWindows: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
         sources: z.ZodOptional<z.ZodObject<{
             unpaywallEmail: z.ZodOptional<z.ZodString>;
             unpaywall_email: z.ZodOptional<z.ZodString>;
@@ -459,8 +534,9 @@ export type DeepPartialConfig = {
     server?: Partial<ServerConfig>;
     citation?: Partial<CitationConfig>;
     pubmed?: Partial<PubmedConfig>;
-    fulltext?: Partial<Omit<FulltextConfig, "sources">> & {
+    fulltext?: Partial<Omit<FulltextConfig, "sources" | "converters">> & {
         sources?: Partial<FulltextConfig["sources"]>;
+        converters?: FulltextConfig["converters"];
     };
     attachments?: Partial<AttachmentsConfig>;
     cli?: Partial<Omit<CliConfig, "tui" | "edit">> & {

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;AAGxB;;GAEG;AACH,eAAO,MAAM,cAAc;;;;EAAsC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,eAAe;;;;iBAI1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;EAA2B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;iBAE3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;iBAM1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;iBAE1B,CAAC;AAEH;;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,uBAAuB;;;EAA8B,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAM/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;EAAgD,CAAC;AAClF,QAAA,MAAM,2BAA2B;;;EAA8B,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;iBAU/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;iBAElC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAavB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmHhB,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,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,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,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,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,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,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,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,GAAG;QACpD,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;KAC9C,CAAC;IACF,WAAW,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,GAAG;QAC/C,GAAG,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACzB,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;KAC5B,CAAC;IACF,GAAG,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC1B,CAAC;AAqSF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,CAqBhF"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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"}

package/dist/features/operations/fulltext/builtin-converters.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Built-in PDF converter definitions for marker, docling, mineru, pymupdf.
+ */
+import type { PdfConverter } from "./pdf-converter.js";
+export declare const BUILTIN_CONVERTER_NAMES: readonly ["marker", "docling", "mineru", "pymupdf"];
+export type BuiltinConverterName = (typeof BUILTIN_CONVERTER_NAMES)[number];
+export interface ConverterInfo {
+    install: string;
+    description: string;
+}
+export declare const BUILTIN_CONVERTER_INFO: Record<BuiltinConverterName, ConverterInfo>;
+export declare function getBuiltinConverter(name: string): PdfConverter | undefined;
+//# sourceMappingURL=builtin-converters.d.ts.map

package/dist/features/operations/fulltext/builtin-converters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-converters.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/builtin-converters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAyB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9E,eAAO,MAAM,uBAAuB,qDAAsD,CAAC;AAE3F,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,oBAAoB,EAAE,aAAa,CAiB9E,CAAC;AAsBF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAG1E"}

package/dist/features/operations/fulltext/command-template.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Command template expansion for custom PDF converters.
+ *
+ * Placeholders:
+ * - {input}       — absolute path to input PDF
+ * - {output}      — absolute path to desired output Markdown
+ * - {input_dir}   — directory of input file
+ * - {input_name}  — filename of input file
+ * - {output_name} — filename of output file
+ */
+export interface TemplateVars {
+    input: string;
+    output: string;
+}
+export declare function expandTemplate(template: string, vars: TemplateVars): string;
+//# sourceMappingURL=command-template.d.ts.map

package/dist/features/operations/fulltext/command-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-template.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/command-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAOD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAU3E"}

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

@@ -1,8 +1,9 @@
 /**
  * Fulltext convert operation.
  *
- * Converts an attached PMC JATS XML file to Markdown.
+ * Converts an attached fulltext file (PMC JATS XML or PDF) to Markdown.
  */
+import type { FulltextConfig } from "../../../config/schema.js";
 import type { ILibrary, IdentifierType } from "../../../core/library-interface.js";
 export interface FulltextConvertOptions {
     /** Reference identifier (id or uuid) */
@@ -11,12 +12,26 @@ export interface FulltextConvertOptions {
     idType?: IdentifierType | undefined;
     /** Directory for fulltext attachments */
     fulltextDirectory: string;
+    /** Input format: "xml", "pdf", or undefined for auto-detect */
+    from?: "xml" | "pdf" | undefined;
+    /** Converter name or "auto" */
+    converter?: string | undefined;
+    /** Force re-conversion (overwrite existing markdown) */
+    force?: boolean | undefined;
+    /** Fulltext config for converter settings */
+    fulltextConfig?: FulltextConfig | undefined;
 }
 export interface FulltextConvertResult {
     success: boolean;
     error?: string;
     /** The converted markdown filename */
     filename?: string;
+    /** Error hints for the user */
+    hints?: string;
+    /** Error code for structured error handling */
+    code?: string;
+    /** Converter stderr output (on failure) */
+    stderr?: string;
 }
 export declare function fulltextConvert(library: ILibrary, options: FulltextConvertOptions): Promise<FulltextConvertResult>;
 //# sourceMappingURL=convert.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/convert.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGnF,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAkBD,wBAAsB,eAAe,CACnC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAkDhC"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/convert.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAInF,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IACjC,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,6CAA6C;IAC7C,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4BD,wBAAsB,eAAe,CACnC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAmBhC"}

package/dist/features/operations/fulltext/converter-check.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Converter availability checking utilities.
+ */
+/** Check if a command is available on the system using which/where */
+export declare function isCommandAvailable(command: string): Promise<boolean>;
+/** Run a custom check command to verify converter availability */
+export declare function runCheckCommand(checkCommand: string): Promise<boolean>;
+//# sourceMappingURL=converter-check.d.ts.map

package/dist/features/operations/fulltext/converter-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter-check.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/converter-check.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,sEAAsE;AACtE,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO1E;AAED,kEAAkE;AAClE,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM5E"}

package/dist/features/operations/fulltext/converter-resolver.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Converter resolution: finds the best available PDF converter.
+ */
+import type { CustomConverterConfig, PdfConvertError, PdfConverter } from "./pdf-converter.js";
+export type ResolveResult = {
+    success: true;
+    converter: PdfConverter;
+} | {
+    success: false;
+    code: PdfConvertError;
+    error: string;
+    hints?: string;
+};
+export interface ResolveOptions {
+    priority: string[];
+    customConverters: Record<string, CustomConverterConfig>;
+}
+export declare function resolveConverter(name: string, options: ResolveOptions): Promise<ResolveResult>;
+export declare function buildNoConverterHints(checked: string[]): string;
+//# sourceMappingURL=converter-resolver.d.ts.map

package/dist/features/operations/fulltext/converter-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter-resolver.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/converter-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE/F,MAAM,MAAM,aAAa,GACrB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,YAAY,CAAA;CAAE,GAC1C;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACzD;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CAKxB;AAiED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAgB/D"}

package/dist/features/operations/fulltext/custom-converter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Custom PDF converter implementation.
+ * Wraps user-defined shell commands as PdfConverter instances.
+ */
+import type { CustomConverterConfig, PdfConvertResult, PdfConverter } from "./pdf-converter.js";
+export declare class CustomPdfConverter implements PdfConverter {
+    readonly name: string;
+    private readonly config;
+    constructor(name: string, config: CustomConverterConfig);
+    isAvailable(): Promise<boolean>;
+    convert(pdfPath: string, outputPath: string): Promise<PdfConvertResult>;
+    private getCommand;
+    private getCheckCommand;
+    private execCommand;
+    private handleExecError;
+}
+//# sourceMappingURL=custom-converter.d.ts.map

package/dist/features/operations/fulltext/custom-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-converter.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/custom-converter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEhG,qBAAa,kBAAmB,YAAW,YAAY;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAEnC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB;IAKjD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAW/B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+B7E,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,eAAe;CAgBxB"}

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

@@ -1 +1 @@
-{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/fetch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhF,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAInF,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,6BAA6B;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,6CAA6C;IAC7C,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IACvE,mCAAmC;IACnC,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC;IACtC,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACtC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IAChE,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AA8OD,wBAAsB,aAAa,CACjC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAyE9B"}
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/fetch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhF,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAKnF,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,6BAA6B;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,6CAA6C;IAC7C,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IACvE,mCAAmC;IACnC,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC;IACtC,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACtC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IAChE,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AA+OD,wBAAsB,aAAa,CACjC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CA0E9B"}

package/dist/features/operations/fulltext/pdf-converter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * PDF converter interface and types for the pluggable converter system.
+ */
+/** Error codes for PDF conversion failures */
+export type PdfConvertError = "no-converter" | "not-installed" | "conversion-failed" | "timeout" | "no-pdf" | "output-not-created";
+/** Result of a PDF-to-Markdown conversion */
+export type PdfConvertResult = {
+    success: true;
+    outputPath: string;
+} | {
+    success: false;
+    error: string;
+    code: PdfConvertError;
+    stderr?: string;
+};
+/** Interface that all PDF converters must implement */
+export interface PdfConverter {
+    readonly name: string;
+    isAvailable(): Promise<boolean>;
+    convert(pdfPath: string, outputPath: string): Promise<PdfConvertResult>;
+}
+/** Configuration for a user-defined custom converter */
+export interface CustomConverterConfig {
+    /** Shell command template with placeholders: {input}, {output}, {input_dir}, {input_name}, {output_name} */
+    command: string;
+    /** Output mode: "file" (tool writes to {output}) or "stdout" (stdout captured as markdown) */
+    outputMode?: "file" | "stdout" | undefined;
+    /** Command to check if the converter is available (exit 0 = available) */
+    checkCommand?: string | undefined;
+    /** Conversion timeout in seconds (overrides global) */
+    timeout?: number | undefined;
+    /** Progress display: "inherit" (stderr to terminal) or "quiet" (capture stderr) */
+    progress?: "inherit" | "quiet" | undefined;
+    /** Windows-specific command override */
+    commandWindows?: string | undefined;
+    /** Windows-specific check command override */
+    checkCommandWindows?: string | undefined;
+}
+//# sourceMappingURL=pdf-converter.d.ts.map

package/dist/features/operations/fulltext/pdf-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-converter.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/pdf-converter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8CAA8C;AAC9C,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,eAAe,GACf,mBAAmB,GACnB,SAAS,GACT,QAAQ,GACR,oBAAoB,CAAC;AAEzB,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GACxB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACzE;AAED,wDAAwD;AACxD,MAAM,WAAW,qBAAqB;IACpC,4GAA4G;IAC5G,OAAO,EAAE,MAAM,CAAC;IAChB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,mFAAmF;IACnF,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAC3C,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,8CAA8C;IAC9C,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C"}

package/dist/index.js

@@ -5,7 +5,7 @@ import { readFile, copyFile, stat, unlink, readdir } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { g as getOpenerCommand, o as openWithSystemApp, b as backupConfigSchema, c as configSchema, d as defaultConfig, a as getDefaultBackupDirectory, e as getDefaultCurrentDirConfigFilename, f as getDefaultLibraryPath, h as getDefaultUserConfigPath, l as loadConfig, i as logLevelSchema, n as normalizePartialConfig, p as partialConfigSchema, w as watchConfigSchema } from "./chunks/loader-B6sytmQd.js";
+import { g as getOpenerCommand, o as openWithSystemApp, b as backupConfigSchema, c as configSchema, d as defaultConfig, a as getDefaultBackupDirectory, e as getDefaultCurrentDirConfigFilename, f as getDefaultLibraryPath, h as getDefaultUserConfigPath, l as loadConfig, i as logLevelSchema, n as normalizePartialConfig, p as partialConfigSchema, w as watchConfigSchema } from "./chunks/loader-6TuXzBbw.js";
 function validateCslJson(data) {
   const parseResult = CslLibrarySchema.safeParse(data);
   if (!parseResult.success) {

package/dist/mcp/tools/fulltext.d.ts

@@ -80,6 +80,10 @@ export declare function registerFulltextFetchTool(server: McpServer, getLibraryO
 export interface FulltextConvertToolParams {
     /** Reference ID */
     id: string;
+    /** Input format: "xml" or "pdf" (default: auto-detect) */
+    from?: "xml" | "pdf" | undefined;
+    /** PDF converter name (default: auto) */
+    converter?: string | undefined;
 }
 /**
  * Register the fulltext_convert tool with the MCP server.

package/dist/mcp/tools/fulltext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fulltext.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/fulltext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAWrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,MAAM,kBAAkB,EAC9C,SAAS,EAAE,MAAM,MAAM,GACtB,IAAI,CAuCN;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,MAAM,kBAAkB,EAC9C,SAAS,EAAE,MAAM,MAAM,GACtB,IAAI,CAkEN;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,MAAM,kBAAkB,EAC9C,SAAS,EAAE,MAAM,MAAM,GACtB,IAAI,CAqCN;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,MAAM,kBAAkB,EAC9C,SAAS,EAAE,MAAM,MAAM,GACtB,IAAI,CA0CN;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,MAAM,kBAAkB,EAC9C,SAAS,EAAE,MAAM,MAAM,GACtB,IAAI,CA6CN;AAwBD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,MAAM,kBAAkB,EAC9C,SAAS,EAAE,MAAM,MAAM,GACtB,IAAI,CAmCN"}
+{"version":3,"file":"fulltext.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/fulltext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAWrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,MAAM,kBAAkB,EAC9C,SAAS,EAAE,MAAM,MAAM,GACtB,IAAI,CAuCN;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,MAAM,kBAAkB,EAC9C,SAAS,EAAE,MAAM,MAAM,GACtB,IAAI,CAkEN;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,MAAM,kBAAkB,EAC9C,SAAS,EAAE,MAAM,MAAM,GACtB,IAAI,CAqCN;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,MAAM,kBAAkB,EAC9C,SAAS,EAAE,MAAM,MAAM,GACtB,IAAI,CA0CN;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,MAAM,kBAAkB,EAC9C,SAAS,EAAE,MAAM,MAAM,GACtB,IAAI,CA6CN;AAwBD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IACjC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,MAAM,kBAAkB,EAC9C,SAAS,EAAE,MAAM,MAAM,GACtB,IAAI,CAmDN"}

package/dist/server/routes/references.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../src/server/routes/references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AASrD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,8EAyOtE"}
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../src/server/routes/references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AASrD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,8EAuPtE"}

package/dist/server.js

@@ -1,6 +1,6 @@
 import "hono";
 import "./chunks/file-watcher-CWHg1yol.js";
-import { v, u } from "./chunks/index-6Aild0Uk.js";
+import { v, u } from "./chunks/index-DoOmAYKd.js";
 export {
   v as createServer,
   u as startServerWithFileWatcher

package/package.json

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