@de-otio/bibcheck 0.1.0

package/dist/schema/csl.d.ts

@@ -0,0 +1,429 @@
+/**
+ * Minimal CSL-JSON entry schema for bibcheck.
+ *
+ * CSL JSON is a large spec; bibcheck only consumes a small subset (citekey,
+ * identifiers, title, authors, year, URL, note, page). This schema validates
+ * that subset at the bibliography-load boundary so subcommand modules
+ * (existence, canonical, linkage, worklist) can rely on a typed `CslEntry`.
+ *
+ * Unknown fields are passed through (CSL JSON producers are diverse), so this
+ * uses `.passthrough()` and lets consumers ignore what they don't need.
+ *
+ * Field-name policy: CSL JSON conventionally uses `URL` (uppercase). bibcheck
+ * accepts both `URL` and `url`; the schema normalizes to the lowercase `url`
+ * during parse.
+ */
+import { z } from 'zod';
+export declare const CslAuthorSchema: z.ZodObject<{
+    family: z.ZodOptional<z.ZodString>;
+    given: z.ZodOptional<z.ZodString>;
+    literal: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    family: z.ZodOptional<z.ZodString>;
+    given: z.ZodOptional<z.ZodString>;
+    literal: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    family: z.ZodOptional<z.ZodString>;
+    given: z.ZodOptional<z.ZodString>;
+    literal: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export type CslAuthor = z.infer<typeof CslAuthorSchema>;
+export declare const CslDateSchema: z.ZodObject<{
+    'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+    literal: z.ZodOptional<z.ZodString>;
+    raw: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+    literal: z.ZodOptional<z.ZodString>;
+    raw: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+    literal: z.ZodOptional<z.ZodString>;
+    raw: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export type CslDate = z.infer<typeof CslDateSchema>;
+export declare const CslEntrySchema: z.ZodEffects<z.ZodObject<{
+    id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    type: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    DOI: z.ZodOptional<z.ZodString>;
+    doi: z.ZodOptional<z.ZodString>;
+    ISBN: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    isbn: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    URL: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    issued: z.ZodOptional<z.ZodObject<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    note: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodString>;
+    publisher: z.ZodOptional<z.ZodString>;
+    'container-title': z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    type: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    DOI: z.ZodOptional<z.ZodString>;
+    doi: z.ZodOptional<z.ZodString>;
+    ISBN: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    isbn: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    URL: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    issued: z.ZodOptional<z.ZodObject<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    note: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodString>;
+    publisher: z.ZodOptional<z.ZodString>;
+    'container-title': z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    type: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    DOI: z.ZodOptional<z.ZodString>;
+    doi: z.ZodOptional<z.ZodString>;
+    ISBN: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    isbn: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    URL: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    issued: z.ZodOptional<z.ZodObject<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    note: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodString>;
+    publisher: z.ZodOptional<z.ZodString>;
+    'container-title': z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>, {
+    citekey: string;
+    doi: string | undefined;
+    isbn: string | undefined;
+    url: string | undefined;
+    id?: string | number | undefined;
+    type?: string | undefined;
+    title?: string | undefined;
+    author?: z.objectOutputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">[] | undefined;
+    DOI?: string | undefined;
+    ISBN?: string | string[] | undefined;
+    URL?: string | undefined;
+    issued?: z.objectOutputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+    note?: string | undefined;
+    page?: string | undefined;
+    publisher?: string | undefined;
+    'container-title'?: string | undefined;
+}, z.objectInputType<{
+    id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    type: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    DOI: z.ZodOptional<z.ZodString>;
+    doi: z.ZodOptional<z.ZodString>;
+    ISBN: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    isbn: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    URL: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    issued: z.ZodOptional<z.ZodObject<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    note: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodString>;
+    publisher: z.ZodOptional<z.ZodString>;
+    'container-title': z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export type CslEntry = z.infer<typeof CslEntrySchema>;
+export declare const CslBibliographySchema: z.ZodArray<z.ZodEffects<z.ZodObject<{
+    id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    type: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    DOI: z.ZodOptional<z.ZodString>;
+    doi: z.ZodOptional<z.ZodString>;
+    ISBN: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    isbn: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    URL: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    issued: z.ZodOptional<z.ZodObject<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    note: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodString>;
+    publisher: z.ZodOptional<z.ZodString>;
+    'container-title': z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    type: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    DOI: z.ZodOptional<z.ZodString>;
+    doi: z.ZodOptional<z.ZodString>;
+    ISBN: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    isbn: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    URL: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    issued: z.ZodOptional<z.ZodObject<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    note: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodString>;
+    publisher: z.ZodOptional<z.ZodString>;
+    'container-title': z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    type: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    DOI: z.ZodOptional<z.ZodString>;
+    doi: z.ZodOptional<z.ZodString>;
+    ISBN: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    isbn: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    URL: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    issued: z.ZodOptional<z.ZodObject<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    note: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodString>;
+    publisher: z.ZodOptional<z.ZodString>;
+    'container-title': z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>, {
+    citekey: string;
+    doi: string | undefined;
+    isbn: string | undefined;
+    url: string | undefined;
+    id?: string | number | undefined;
+    type?: string | undefined;
+    title?: string | undefined;
+    author?: z.objectOutputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">[] | undefined;
+    DOI?: string | undefined;
+    ISBN?: string | string[] | undefined;
+    URL?: string | undefined;
+    issued?: z.objectOutputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+    note?: string | undefined;
+    page?: string | undefined;
+    publisher?: string | undefined;
+    'container-title'?: string | undefined;
+}, z.objectInputType<{
+    id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    type: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        family: z.ZodOptional<z.ZodString>;
+        given: z.ZodOptional<z.ZodString>;
+        literal: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    DOI: z.ZodOptional<z.ZodString>;
+    doi: z.ZodOptional<z.ZodString>;
+    ISBN: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    isbn: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    URL: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    issued: z.ZodOptional<z.ZodObject<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        'date-parts': z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">, "many">>;
+        literal: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    note: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodString>;
+    publisher: z.ZodOptional<z.ZodString>;
+    'container-title': z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>, "many">;
+export type CslBibliography = z.infer<typeof CslBibliographySchema>;
+export declare class BibliographyParseError extends Error {
+    readonly cause?: unknown | undefined;
+    name: "BibliographyParseError";
+    constructor(message: string, cause?: unknown | undefined);
+}
+export interface LoadBibliographyOptions {
+    path: string;
+    cwd?: string;
+}
+export declare function loadBibliography(opts: LoadBibliographyOptions): Promise<CslBibliography>;
+//# sourceMappingURL=csl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"csl.d.ts","sourceRoot":"","sources":["../../src/schema/csl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe;;;;;;;;;;;;gCAIZ,CAAC;AACjB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,aAAa;;;;;;;;;;;;gCAIV,CAAC;AACjB,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAoBpD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAUzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yCAA0B,CAAC;AAC7D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,qBAAa,sBAAuB,SAAQ,KAAK;aAEO,KAAK,CAAC,EAAE,OAAO;IAD5D,IAAI,EAAG,wBAAwB,CAAU;gBACtC,OAAO,EAAE,MAAM,EAA2B,KAAK,CAAC,EAAE,OAAO,YAAA;CAMtE;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,eAAe,CAAC,CA0C1B"}

package/dist/schema/csl.js

@@ -0,0 +1,101 @@
+/**
+ * Minimal CSL-JSON entry schema for bibcheck.
+ *
+ * CSL JSON is a large spec; bibcheck only consumes a small subset (citekey,
+ * identifiers, title, authors, year, URL, note, page). This schema validates
+ * that subset at the bibliography-load boundary so subcommand modules
+ * (existence, canonical, linkage, worklist) can rely on a typed `CslEntry`.
+ *
+ * Unknown fields are passed through (CSL JSON producers are diverse), so this
+ * uses `.passthrough()` and lets consumers ignore what they don't need.
+ *
+ * Field-name policy: CSL JSON conventionally uses `URL` (uppercase). bibcheck
+ * accepts both `URL` and `url`; the schema normalizes to the lowercase `url`
+ * during parse.
+ */
+import { z } from 'zod';
+export const CslAuthorSchema = z.object({
+    family: z.string().optional(),
+    given: z.string().optional(),
+    literal: z.string().optional(),
+}).passthrough();
+export const CslDateSchema = z.object({
+    'date-parts': z.array(z.array(z.union([z.number(), z.string()]))).optional(),
+    literal: z.string().optional(),
+    raw: z.string().optional(),
+}).passthrough();
+const CslEntryRawSchema = z.object({
+    id: z.union([z.string(), z.number()]).optional(),
+    type: z.string().optional(),
+    title: z.string().optional(),
+    author: z.array(CslAuthorSchema).optional(),
+    DOI: z.string().optional(),
+    doi: z.string().optional(),
+    ISBN: z.union([z.string(), z.array(z.string())]).optional(),
+    isbn: z.union([z.string(), z.array(z.string())]).optional(),
+    URL: z.string().optional(),
+    url: z.string().optional(),
+    issued: CslDateSchema.optional(),
+    note: z.string().optional(),
+    page: z.string().optional(),
+    publisher: z.string().optional(),
+    'container-title': z.string().optional(),
+}).passthrough();
+export const CslEntrySchema = CslEntryRawSchema.transform((raw) => {
+    const isbnRaw = raw.ISBN ?? raw.isbn;
+    const isbn = Array.isArray(isbnRaw) ? isbnRaw[0] : isbnRaw;
+    return {
+        ...raw,
+        citekey: typeof raw.id === 'number' ? String(raw.id) : raw.id ?? '',
+        doi: raw.DOI ?? raw.doi,
+        isbn,
+        url: raw.URL ?? raw.url,
+    };
+});
+export const CslBibliographySchema = z.array(CslEntrySchema);
+export class BibliographyParseError extends Error {
+    cause;
+    name = 'BibliographyParseError';
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        if (typeof Error.captureStackTrace === 'function') {
+            Error.captureStackTrace(this, BibliographyParseError);
+        }
+    }
+}
+export async function loadBibliography(opts) {
+    const { readFile } = await import('node:fs/promises');
+    const { resolve } = await import('node:path');
+    const cwd = opts.cwd ?? process.cwd();
+    const fullPath = resolve(cwd, opts.path);
+    let raw;
+    try {
+        raw = await readFile(fullPath, 'utf-8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new BibliographyParseError(`bibliography file not found: ${fullPath}`, err);
+        }
+        throw new BibliographyParseError(`failed to read bibliography: ${err.message}`, err);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new BibliographyParseError(`bibliography is not valid JSON: ${err.message}`, err);
+    }
+    if (!Array.isArray(parsed)) {
+        throw new BibliographyParseError('bibliography must be a JSON array of CSL-JSON entries');
+    }
+    const result = CslBibliographySchema.safeParse(parsed);
+    if (!result.success) {
+        const issue = result.error.issues[0];
+        const path = issue?.path?.join('.') ?? '<root>';
+        const message = issue?.message ?? 'invalid CSL-JSON entry';
+        throw new BibliographyParseError(`${path}: ${message}`, result.error);
+    }
+    return result.data;
+}
+//# sourceMappingURL=csl.js.map

package/dist/schema/csl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csl.js","sourceRoot":"","sources":["../../src/schema/csl.ts"],"names":[],"mappings":"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"}