eyecite-ts 0.15.1 → 0.15.3

package/dist/annotate/index.d.cts

@@ -1,4 +1,4 @@
-import { t as Citation } from "../citation-B7SBPpEl.cjs";
+import { t as Citation } from "../citation-BzekGHct.cjs";
 
 //#region src/annotate/types.d.ts
 /**

package/dist/annotate/index.d.mts

@@ -1,4 +1,4 @@
-import { t as Citation } from "../citation-BuBDvjag.mjs";
+import { t as Citation } from "../citation-Cd8-o32w.mjs";
 
 //#region src/annotate/types.d.ts
 /**

package/dist/{citation-B7SBPpEl.d.cts → citation-BzekGHct.d.cts}

@@ -55,6 +55,37 @@ interface PinciteInfo {
 */
 declare function parsePincite(raw: string): PinciteInfo | null;
 //#endregion
+//#region src/extract/dates.d.ts
+/**
+* Date Parsing Utilities for Legal Citations
+*
+* Parses dates from parentheticals in legal citations. Supports three formats:
+* 1. Abbreviated month: "Jan. 15, 2020"
+* 2. Full month: "January 15, 2020"
+* 3. Numeric US: "1/15/2020"
+* 4. Year-only: "2020"
+*
+* @module extract/dates
+*/
+/**
+* Structured date components.
+* Month and day are optional to support year-only dates.
+*/
+interface ParsedDate {
+  year: number;
+  month?: number;
+  day?: number;
+}
+/**
+* Date in both ISO string and structured format.
+*/
+interface StructuredDate {
+  /** ISO 8601 format: YYYY-MM-DD, YYYY-MM, or YYYY */
+  iso: string;
+  /** Structured date components */
+  parsed: ParsedDate;
+}
+//#endregion
 //#region src/clean/segmentMap.d.ts
 /**
 * Segment-based position mapping.
@@ -617,6 +648,17 @@ interface StatuteCitation extends CitationBase {
   pincite?: string;
   /** True when "et seq." follows the citation */
   hasEtSeq?: boolean;
+  /**
+  * Year of the code edition cited, captured from a trailing parenthetical
+  * (`HRS § 91-14(a) (1985)`, `42 U.S.C. § 1983 (1976)`,
+  * `28 U.S.C. § 1331 (West 2018)`). #285
+  */
+  year?: number;
+  /**
+  * Publisher of an annotated code edition (`West`, `Lexis`), captured from
+  * `(Publisher YYYY)` parentheticals alongside `year`. #285
+  */
+  publisher?: string;
   /** Precise text positions for each parsed component of this citation. */
   spans?: StatuteComponentSpans;
 }
@@ -661,8 +703,19 @@ interface NeutralCitation extends CitationBase {
   type: "neutral";
   /** Year of decision */
   year: number;
-  /** Court identifier (e.g., "WL", "U.S. LEXIS") */
-  court: string;
+  /**
+  * Court identifier extracted from a real jurisdictional neutral cite
+  * (`Ohio`, `IL`, `NM`) or recovered from a trailing `(court date)`
+  * parenthetical on a database cite (`N.D. Cal.`, `Tex. App.`). Database
+  * identifiers (`WL`, `LEXIS`) live in `database`, NOT here. #294
+  */
+  court?: string;
+  /**
+  * Database identifier for vendor-database cites that have no inherent
+  * court value: `WL` (Westlaw), `LEXIS` / `U.S. LEXIS` / `Fed. App. LEXIS`,
+  * `BL` (Bloomberg Law). Set instead of `court` for these forms. #294
+  */
+  database?: string;
   /** Document number */
   documentNumber: string;
   /**
@@ -675,6 +728,11 @@ interface NeutralCitation extends CitationBase {
   pincite?: number;
   /** Structured pincite information (page, range, footnote, star-pagination). */
   pinciteInfo?: PinciteInfo;
+  /**
+  * Decision date recovered from a trailing `(court date)` parenthetical on
+  * a database cite, e.g. `2014 WL 1924465 (Tex. App. May 8, 2014)`. #294
+  */
+  date?: StructuredDate;
   /** Precise text positions for each parsed component of this citation. */
   spans?: NeutralComponentSpans;
 }
@@ -812,6 +870,15 @@ interface IdCitation extends CitationBase {
   pincite?: number;
   /** Structured pincite information (page, range, footnote, star-pagination). */
   pinciteInfo?: PinciteInfo;
+  /**
+  * Trailing parenthetical content (text between the parens, excluding the
+  * parens themselves) captured from `Id. at N (...)` forms. Common values
+  * include drop-citation markers (`citation omitted`, `internal quotation
+  * marks omitted`), short-form case identifiers (`Marsh`, `Serrano III`),
+  * and explanatory holdings (`holding that ...`). Unclassified — consumers
+  * can post-classify if needed. #303
+  */
+  parenthetical?: string;
   /** Component-level spans (currently just `pincite`; extend when needed). */
   spans?: IdComponentSpans;
 }
@@ -829,6 +896,12 @@ interface SupraCitation extends CitationBase {
   pincite?: number;
   /** Structured pincite information (page, range, footnote, star-pagination). */
   pinciteInfo?: PinciteInfo;
+  /**
+  * Trailing parenthetical content (text between the parens, excluding the
+  * parens themselves). See `IdCitation.parenthetical` for common shapes
+  * and rationale. #303
+  */
+  parenthetical?: string;
   /** Component-level spans (currently just `pincite`; extend when needed). */
   spans?: SupraComponentSpans;
 }
@@ -859,6 +932,12 @@ interface ShortFormCaseCitation extends CitationBase {
   *  collapsed). Mirrors `defendantNormalized` / `plaintiffNormalized` on
   *  `FullCaseCitation`. */
   partyNameNormalized?: string;
+  /**
+  * Trailing parenthetical content (text between the parens, excluding the
+  * parens themselves). See `IdCitation.parenthetical` for common shapes
+  * and rationale. #303
+  */
+  parenthetical?: string;
 }
 /**
 * Union type of all citation types.
@@ -910,4 +989,4 @@ type CitationOfType<T extends CitationType> = Extract<Citation, {
 type ExtractorMap = { [K in FullCitationType]: CitationOfType<K> };
 //#endregion
 export { ConstitutionalComponentSpans as A, PinciteInfo as B, ShortFormCitationType as C, SupraCitation as D, SubsequentHistoryEntry as E, StatuteComponentSpans as F, StatutesAtLargeComponentSpans as I, Span as L, JournalComponentSpans as M, NeutralComponentSpans as N, Warning as O, PublicLawComponentSpans as P, TransformationMap as R, ShortFormCitation as S, StatutesAtLargeCitation as T, parsePincite as V, NeutralCitation as _, CitationType as a, PublicLawCitation as b, DocketCitation as c, FullCaseCitation as d, FullCitation as f, JournalCitation as g, IdCitation as h, CitationSignal as i, FederalRegisterComponentSpans as j, CaseComponentSpans as k, ExtractorMap as l, HistorySignal as m, CitationBase as n, ConstitutionalCitation as o, FullCitationType as p, CitationOfType as r, CourtInference as s, Citation as t, FederalRegisterCitation as u, Parenthetical as v, StatuteCitation as w, ShortFormCaseCitation as x, ParentheticalType as y, spanFromGroupIndex as z };
-//# sourceMappingURL=citation-B7SBPpEl.d.cts.map
+//# sourceMappingURL=citation-BzekGHct.d.cts.map

package/dist/citation-BzekGHct.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-BzekGHct.d.cts","names":[],"sources":["../src/extract/pincite.ts","../src/extract/dates.ts","../src/clean/segmentMap.ts","../src/types/span.ts","../src/types/componentSpans.ts","../src/types/citation.ts"],"mappings":"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"}

package/dist/{citation-BuBDvjag.d.mts → citation-Cd8-o32w.d.mts}

@@ -55,6 +55,37 @@ interface PinciteInfo {
 */
 declare function parsePincite(raw: string): PinciteInfo | null;
 //#endregion
+//#region src/extract/dates.d.ts
+/**
+* Date Parsing Utilities for Legal Citations
+*
+* Parses dates from parentheticals in legal citations. Supports three formats:
+* 1. Abbreviated month: "Jan. 15, 2020"
+* 2. Full month: "January 15, 2020"
+* 3. Numeric US: "1/15/2020"
+* 4. Year-only: "2020"
+*
+* @module extract/dates
+*/
+/**
+* Structured date components.
+* Month and day are optional to support year-only dates.
+*/
+interface ParsedDate {
+  year: number;
+  month?: number;
+  day?: number;
+}
+/**
+* Date in both ISO string and structured format.
+*/
+interface StructuredDate {
+  /** ISO 8601 format: YYYY-MM-DD, YYYY-MM, or YYYY */
+  iso: string;
+  /** Structured date components */
+  parsed: ParsedDate;
+}
+//#endregion
 //#region src/clean/segmentMap.d.ts
 /**
 * Segment-based position mapping.
@@ -617,6 +648,17 @@ interface StatuteCitation extends CitationBase {
   pincite?: string;
   /** True when "et seq." follows the citation */
   hasEtSeq?: boolean;
+  /**
+  * Year of the code edition cited, captured from a trailing parenthetical
+  * (`HRS § 91-14(a) (1985)`, `42 U.S.C. § 1983 (1976)`,
+  * `28 U.S.C. § 1331 (West 2018)`). #285
+  */
+  year?: number;
+  /**
+  * Publisher of an annotated code edition (`West`, `Lexis`), captured from
+  * `(Publisher YYYY)` parentheticals alongside `year`. #285
+  */
+  publisher?: string;
   /** Precise text positions for each parsed component of this citation. */
   spans?: StatuteComponentSpans;
 }
@@ -661,8 +703,19 @@ interface NeutralCitation extends CitationBase {
   type: "neutral";
   /** Year of decision */
   year: number;
-  /** Court identifier (e.g., "WL", "U.S. LEXIS") */
-  court: string;
+  /**
+  * Court identifier extracted from a real jurisdictional neutral cite
+  * (`Ohio`, `IL`, `NM`) or recovered from a trailing `(court date)`
+  * parenthetical on a database cite (`N.D. Cal.`, `Tex. App.`). Database
+  * identifiers (`WL`, `LEXIS`) live in `database`, NOT here. #294
+  */
+  court?: string;
+  /**
+  * Database identifier for vendor-database cites that have no inherent
+  * court value: `WL` (Westlaw), `LEXIS` / `U.S. LEXIS` / `Fed. App. LEXIS`,
+  * `BL` (Bloomberg Law). Set instead of `court` for these forms. #294
+  */
+  database?: string;
   /** Document number */
   documentNumber: string;
   /**
@@ -675,6 +728,11 @@ interface NeutralCitation extends CitationBase {
   pincite?: number;
   /** Structured pincite information (page, range, footnote, star-pagination). */
   pinciteInfo?: PinciteInfo;
+  /**
+  * Decision date recovered from a trailing `(court date)` parenthetical on
+  * a database cite, e.g. `2014 WL 1924465 (Tex. App. May 8, 2014)`. #294
+  */
+  date?: StructuredDate;
   /** Precise text positions for each parsed component of this citation. */
   spans?: NeutralComponentSpans;
 }
@@ -812,6 +870,15 @@ interface IdCitation extends CitationBase {
   pincite?: number;
   /** Structured pincite information (page, range, footnote, star-pagination). */
   pinciteInfo?: PinciteInfo;
+  /**
+  * Trailing parenthetical content (text between the parens, excluding the
+  * parens themselves) captured from `Id. at N (...)` forms. Common values
+  * include drop-citation markers (`citation omitted`, `internal quotation
+  * marks omitted`), short-form case identifiers (`Marsh`, `Serrano III`),
+  * and explanatory holdings (`holding that ...`). Unclassified — consumers
+  * can post-classify if needed. #303
+  */
+  parenthetical?: string;
   /** Component-level spans (currently just `pincite`; extend when needed). */
   spans?: IdComponentSpans;
 }
@@ -829,6 +896,12 @@ interface SupraCitation extends CitationBase {
   pincite?: number;
   /** Structured pincite information (page, range, footnote, star-pagination). */
   pinciteInfo?: PinciteInfo;
+  /**
+  * Trailing parenthetical content (text between the parens, excluding the
+  * parens themselves). See `IdCitation.parenthetical` for common shapes
+  * and rationale. #303
+  */
+  parenthetical?: string;
   /** Component-level spans (currently just `pincite`; extend when needed). */
   spans?: SupraComponentSpans;
 }
@@ -859,6 +932,12 @@ interface ShortFormCaseCitation extends CitationBase {
   *  collapsed). Mirrors `defendantNormalized` / `plaintiffNormalized` on
   *  `FullCaseCitation`. */
   partyNameNormalized?: string;
+  /**
+  * Trailing parenthetical content (text between the parens, excluding the
+  * parens themselves). See `IdCitation.parenthetical` for common shapes
+  * and rationale. #303
+  */
+  parenthetical?: string;
 }
 /**
 * Union type of all citation types.
@@ -910,4 +989,4 @@ type CitationOfType<T extends CitationType> = Extract<Citation, {
 type ExtractorMap = { [K in FullCitationType]: CitationOfType<K> };
 //#endregion
 export { ConstitutionalComponentSpans as A, PinciteInfo as B, ShortFormCitationType as C, SupraCitation as D, SubsequentHistoryEntry as E, StatuteComponentSpans as F, StatutesAtLargeComponentSpans as I, Span as L, JournalComponentSpans as M, NeutralComponentSpans as N, Warning as O, PublicLawComponentSpans as P, TransformationMap as R, ShortFormCitation as S, StatutesAtLargeCitation as T, parsePincite as V, NeutralCitation as _, CitationType as a, PublicLawCitation as b, DocketCitation as c, FullCaseCitation as d, FullCitation as f, JournalCitation as g, IdCitation as h, CitationSignal as i, FederalRegisterComponentSpans as j, CaseComponentSpans as k, ExtractorMap as l, HistorySignal as m, CitationBase as n, ConstitutionalCitation as o, FullCitationType as p, CitationOfType as r, CourtInference as s, Citation as t, FederalRegisterCitation as u, Parenthetical as v, StatuteCitation as w, ShortFormCaseCitation as x, ParentheticalType as y, spanFromGroupIndex as z };
-//# sourceMappingURL=citation-BuBDvjag.d.mts.map
+//# sourceMappingURL=citation-Cd8-o32w.d.mts.map

package/dist/citation-Cd8-o32w.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-Cd8-o32w.d.mts","names":[],"sources":["../src/extract/pincite.ts","../src/extract/dates.ts","../src/clean/segmentMap.ts","../src/types/span.ts","../src/types/componentSpans.ts","../src/types/citation.ts"],"mappings":"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"}