eyecite-ts 0.11.3 → 0.13.0

package/dist/annotate/index.d.cts

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

package/dist/annotate/index.d.mts

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

package/dist/{citation-B_8m5AcV.d.cts → citation-CWBCicCr.d.mts}

@@ -201,9 +201,28 @@ interface NeutralComponentSpans {
   year?: Span;
   court?: Span;
   documentNumber?: Span;
+  pincite?: Span;
   signal?: Span;
 }
 /**
+* Component spans for Id./Ibid. citations (type: "id").
+*/
+interface IdComponentSpans {
+  pincite?: Span;
+}
+/**
+* Component spans for supra citations (type: "supra").
+*/
+interface SupraComponentSpans {
+  pincite?: Span;
+}
+/**
+* Component spans for short-form case citations (type: "shortFormCase").
+*/
+interface ShortFormCaseComponentSpans {
+  pincite?: Span;
+}
+/**
 * Component spans for public law citations (type: "publicLaw").
 *
 * Note: `signal` is included for future extensibility but is currently only
@@ -243,7 +262,7 @@ interface StatutesAtLargeComponentSpans {
 /**
 * Citation type discriminator for type-safe pattern matching.
 */
-type CitationType = "case" | "statute" | "journal" | "neutral" | "publicLaw" | "federalRegister" | "statutesAtLarge" | "constitutional" | "id" | "supra" | "shortFormCase";
+type CitationType = "case" | "docket" | "statute" | "journal" | "neutral" | "publicLaw" | "federalRegister" | "statutesAtLarge" | "constitutional" | "id" | "supra" | "shortFormCase";
 /**
 * Warning generated during citation parsing.
 */
@@ -648,6 +667,57 @@ interface StatutesAtLargeCitation extends CitationBase {
   spans?: StatutesAtLargeComponentSpans;
 }
 /**
+* Docket-number-only case citation (no traditional reporter assignment).
+*
+* Used for very recent decisions identified by docket/slip number, common for:
+* - NY Court of Appeals slip opinions: `IKB Int'l v. Wells Fargo, No. 51 (N.Y. 2023)`
+* - Federal district court decisions before reporter assignment: `Smith v. Jones, No. 12-3456 (S.D.N.Y. 2024)`
+* - Some unreported state-court orders
+*
+* Disambiguation: a bare `No. 51 (N.Y. 2023)` is too generic to extract on its
+* own — extraction only emits a DocketCitation when a preceding case-name
+* anchor (e.g. `Party v. Party,`) is present.
+*
+* @example "IKB Int'l, S.A. v. Wells Fargo Bank, N.A., No. 51 (N.Y. 2023)"
+*/
+interface DocketCitation extends CitationBase {
+  type: "docket";
+  /** Docket / slip-opinion number (string to preserve hyphens, e.g. "12-3456") */
+  docketNumber: string;
+  /** Court abbreviation extracted from the parenthetical (e.g. "N.Y.", "S.D.N.Y.") */
+  court?: string;
+  /** Normalized court string: spaces collapsed, trailing period ensured */
+  normalizedCourt?: string;
+  /** Year of decision */
+  year?: number;
+  /** Date information when the parenthetical includes month/day */
+  date?: {
+    iso: string;
+    parsed?: {
+      year: number;
+      month?: number;
+      day?: number;
+    };
+  };
+  /** Extracted case name (party names around "v.") */
+  caseName?: string;
+  /** Plaintiff party name */
+  plaintiff?: string;
+  /** Defendant party name */
+  defendant?: string;
+  /** Normalized plaintiff name for matching (lowercase, stripped of noise) */
+  plaintiffNormalized?: string;
+  /** Normalized defendant name for matching (lowercase, stripped of noise) */
+  defendantNormalized?: string;
+  /** Procedural prefix for non-adversarial cases (e.g. "In re") */
+  proceduralPrefix?: string;
+  /**
+  * Full span covering citation from case name through closing parenthetical.
+  * @example For "Smith v. Jones, No. 51 (N.Y. 2023)", fullSpan covers the entire text.
+  */
+  fullSpan?: Span;
+}
+/**
 * Constitutional citation (U.S. or state constitution).
 *
 * @example "U.S. Const. art. III, § 2"
@@ -680,6 +750,8 @@ interface IdCitation extends CitationBase {
   pincite?: number;
   /** Structured pincite information (page, range, footnote, star-pagination). */
   pinciteInfo?: PinciteInfo;
+  /** Component-level spans (currently just `pincite`; extend when needed). */
+  spans?: IdComponentSpans;
 }
 /**
 * Supra citation (refers to earlier citation by party name).
@@ -695,6 +767,8 @@ interface SupraCitation extends CitationBase {
   pincite?: number;
   /** Structured pincite information (page, range, footnote, star-pagination). */
   pinciteInfo?: PinciteInfo;
+  /** Component-level spans (currently just `pincite`; extend when needed). */
+  spans?: SupraComponentSpans;
 }
 /**
 * Short-form case citation (abbreviated reference to earlier full citation).
@@ -710,6 +784,8 @@ interface ShortFormCaseCitation extends CitationBase {
   pincite?: number;
   /** Structured pincite information (page, range, footnote, star-pagination). */
   pinciteInfo?: PinciteInfo;
+  /** Component-level spans (currently just `pincite`; extend when needed). */
+  spans?: ShortFormCaseComponentSpans;
 }
 /**
 * Union type of all citation types.
@@ -728,16 +804,16 @@ interface ShortFormCaseCitation extends CitationBase {
 *   // ...
 * }
 */
-type Citation = FullCaseCitation | StatuteCitation | JournalCitation | NeutralCitation | PublicLawCitation | FederalRegisterCitation | StatutesAtLargeCitation | ConstitutionalCitation | IdCitation | SupraCitation | ShortFormCaseCitation;
+type Citation = FullCaseCitation | DocketCitation | StatuteCitation | JournalCitation | NeutralCitation | PublicLawCitation | FederalRegisterCitation | StatutesAtLargeCitation | ConstitutionalCitation | IdCitation | SupraCitation | ShortFormCaseCitation;
 /**
 * Citation type discriminators grouped by category.
 */
-type FullCitationType = "case" | "statute" | "journal" | "neutral" | "publicLaw" | "federalRegister" | "statutesAtLarge" | "constitutional";
+type FullCitationType = "case" | "docket" | "statute" | "journal" | "neutral" | "publicLaw" | "federalRegister" | "statutesAtLarge" | "constitutional";
 type ShortFormCitationType = "id" | "supra" | "shortFormCase";
 /**
 * Union of all full citation types (not short-form references).
 */
-type FullCitation = FullCaseCitation | StatuteCitation | JournalCitation | NeutralCitation | PublicLawCitation | FederalRegisterCitation | StatutesAtLargeCitation | ConstitutionalCitation;
+type FullCitation = FullCaseCitation | DocketCitation | StatuteCitation | JournalCitation | NeutralCitation | PublicLawCitation | FederalRegisterCitation | StatutesAtLargeCitation | ConstitutionalCitation;
 /**
 * Union of all short-form citation types (Id., supra, short-form case).
 */
@@ -761,4 +837,4 @@ type CitationOfType<T extends CitationType> = Extract<Citation, {
 type ExtractorMap = { [K in FullCitationType]: CitationOfType<K> };
 //#endregion
 export { FederalRegisterComponentSpans as A, parsePincite as B, StatuteCitation as C, Warning as D, SupraCitation as E, StatutesAtLargeComponentSpans as F, Span as I, TransformationMap as L, NeutralComponentSpans as M, PublicLawComponentSpans as N, CaseComponentSpans as O, StatuteComponentSpans as P, spanFromGroupIndex as R, ShortFormCitationType as S, SubsequentHistoryEntry as T, Parenthetical as _, CitationType as a, ShortFormCaseCitation as b, ExtractorMap as c, FullCitation as d, FullCitationType as f, NeutralCitation as g, JournalCitation as h, CitationSignal as i, JournalComponentSpans as j, ConstitutionalComponentSpans as k, FederalRegisterCitation as l, IdCitation as m, CitationBase as n, ConstitutionalCitation as o, HistorySignal as p, CitationOfType as r, CourtInference as s, Citation as t, FullCaseCitation as u, ParentheticalType as v, StatutesAtLargeCitation as w, ShortFormCitation as x, PublicLawCitation as y, PinciteInfo as z };
-//# sourceMappingURL=citation-B_8m5AcV.d.cts.map
+//# sourceMappingURL=citation-CWBCicCr.d.mts.map

package/dist/citation-CWBCicCr.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-CWBCicCr.d.mts","names":[],"sources":["../src/extract/pincite.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-CIVlt9QA.d.mts → citation-DL2BQTYK.d.cts}

@@ -201,9 +201,28 @@ interface NeutralComponentSpans {
   year?: Span;
   court?: Span;
   documentNumber?: Span;
+  pincite?: Span;
   signal?: Span;
 }
 /**
+* Component spans for Id./Ibid. citations (type: "id").
+*/
+interface IdComponentSpans {
+  pincite?: Span;
+}
+/**
+* Component spans for supra citations (type: "supra").
+*/
+interface SupraComponentSpans {
+  pincite?: Span;
+}
+/**
+* Component spans for short-form case citations (type: "shortFormCase").
+*/
+interface ShortFormCaseComponentSpans {
+  pincite?: Span;
+}
+/**
 * Component spans for public law citations (type: "publicLaw").
 *
 * Note: `signal` is included for future extensibility but is currently only
@@ -243,7 +262,7 @@ interface StatutesAtLargeComponentSpans {
 /**
 * Citation type discriminator for type-safe pattern matching.
 */
-type CitationType = "case" | "statute" | "journal" | "neutral" | "publicLaw" | "federalRegister" | "statutesAtLarge" | "constitutional" | "id" | "supra" | "shortFormCase";
+type CitationType = "case" | "docket" | "statute" | "journal" | "neutral" | "publicLaw" | "federalRegister" | "statutesAtLarge" | "constitutional" | "id" | "supra" | "shortFormCase";
 /**
 * Warning generated during citation parsing.
 */
@@ -648,6 +667,57 @@ interface StatutesAtLargeCitation extends CitationBase {
   spans?: StatutesAtLargeComponentSpans;
 }
 /**
+* Docket-number-only case citation (no traditional reporter assignment).
+*
+* Used for very recent decisions identified by docket/slip number, common for:
+* - NY Court of Appeals slip opinions: `IKB Int'l v. Wells Fargo, No. 51 (N.Y. 2023)`
+* - Federal district court decisions before reporter assignment: `Smith v. Jones, No. 12-3456 (S.D.N.Y. 2024)`
+* - Some unreported state-court orders
+*
+* Disambiguation: a bare `No. 51 (N.Y. 2023)` is too generic to extract on its
+* own — extraction only emits a DocketCitation when a preceding case-name
+* anchor (e.g. `Party v. Party,`) is present.
+*
+* @example "IKB Int'l, S.A. v. Wells Fargo Bank, N.A., No. 51 (N.Y. 2023)"
+*/
+interface DocketCitation extends CitationBase {
+  type: "docket";
+  /** Docket / slip-opinion number (string to preserve hyphens, e.g. "12-3456") */
+  docketNumber: string;
+  /** Court abbreviation extracted from the parenthetical (e.g. "N.Y.", "S.D.N.Y.") */
+  court?: string;
+  /** Normalized court string: spaces collapsed, trailing period ensured */
+  normalizedCourt?: string;
+  /** Year of decision */
+  year?: number;
+  /** Date information when the parenthetical includes month/day */
+  date?: {
+    iso: string;
+    parsed?: {
+      year: number;
+      month?: number;
+      day?: number;
+    };
+  };
+  /** Extracted case name (party names around "v.") */
+  caseName?: string;
+  /** Plaintiff party name */
+  plaintiff?: string;
+  /** Defendant party name */
+  defendant?: string;
+  /** Normalized plaintiff name for matching (lowercase, stripped of noise) */
+  plaintiffNormalized?: string;
+  /** Normalized defendant name for matching (lowercase, stripped of noise) */
+  defendantNormalized?: string;
+  /** Procedural prefix for non-adversarial cases (e.g. "In re") */
+  proceduralPrefix?: string;
+  /**
+  * Full span covering citation from case name through closing parenthetical.
+  * @example For "Smith v. Jones, No. 51 (N.Y. 2023)", fullSpan covers the entire text.
+  */
+  fullSpan?: Span;
+}
+/**
 * Constitutional citation (U.S. or state constitution).
 *
 * @example "U.S. Const. art. III, § 2"
@@ -680,6 +750,8 @@ interface IdCitation extends CitationBase {
   pincite?: number;
   /** Structured pincite information (page, range, footnote, star-pagination). */
   pinciteInfo?: PinciteInfo;
+  /** Component-level spans (currently just `pincite`; extend when needed). */
+  spans?: IdComponentSpans;
 }
 /**
 * Supra citation (refers to earlier citation by party name).
@@ -695,6 +767,8 @@ interface SupraCitation extends CitationBase {
   pincite?: number;
   /** Structured pincite information (page, range, footnote, star-pagination). */
   pinciteInfo?: PinciteInfo;
+  /** Component-level spans (currently just `pincite`; extend when needed). */
+  spans?: SupraComponentSpans;
 }
 /**
 * Short-form case citation (abbreviated reference to earlier full citation).
@@ -710,6 +784,8 @@ interface ShortFormCaseCitation extends CitationBase {
   pincite?: number;
   /** Structured pincite information (page, range, footnote, star-pagination). */
   pinciteInfo?: PinciteInfo;
+  /** Component-level spans (currently just `pincite`; extend when needed). */
+  spans?: ShortFormCaseComponentSpans;
 }
 /**
 * Union type of all citation types.
@@ -728,16 +804,16 @@ interface ShortFormCaseCitation extends CitationBase {
 *   // ...
 * }
 */
-type Citation = FullCaseCitation | StatuteCitation | JournalCitation | NeutralCitation | PublicLawCitation | FederalRegisterCitation | StatutesAtLargeCitation | ConstitutionalCitation | IdCitation | SupraCitation | ShortFormCaseCitation;
+type Citation = FullCaseCitation | DocketCitation | StatuteCitation | JournalCitation | NeutralCitation | PublicLawCitation | FederalRegisterCitation | StatutesAtLargeCitation | ConstitutionalCitation | IdCitation | SupraCitation | ShortFormCaseCitation;
 /**
 * Citation type discriminators grouped by category.
 */
-type FullCitationType = "case" | "statute" | "journal" | "neutral" | "publicLaw" | "federalRegister" | "statutesAtLarge" | "constitutional";
+type FullCitationType = "case" | "docket" | "statute" | "journal" | "neutral" | "publicLaw" | "federalRegister" | "statutesAtLarge" | "constitutional";
 type ShortFormCitationType = "id" | "supra" | "shortFormCase";
 /**
 * Union of all full citation types (not short-form references).
 */
-type FullCitation = FullCaseCitation | StatuteCitation | JournalCitation | NeutralCitation | PublicLawCitation | FederalRegisterCitation | StatutesAtLargeCitation | ConstitutionalCitation;
+type FullCitation = FullCaseCitation | DocketCitation | StatuteCitation | JournalCitation | NeutralCitation | PublicLawCitation | FederalRegisterCitation | StatutesAtLargeCitation | ConstitutionalCitation;
 /**
 * Union of all short-form citation types (Id., supra, short-form case).
 */
@@ -761,4 +837,4 @@ type CitationOfType<T extends CitationType> = Extract<Citation, {
 type ExtractorMap = { [K in FullCitationType]: CitationOfType<K> };
 //#endregion
 export { FederalRegisterComponentSpans as A, parsePincite as B, StatuteCitation as C, Warning as D, SupraCitation as E, StatutesAtLargeComponentSpans as F, Span as I, TransformationMap as L, NeutralComponentSpans as M, PublicLawComponentSpans as N, CaseComponentSpans as O, StatuteComponentSpans as P, spanFromGroupIndex as R, ShortFormCitationType as S, SubsequentHistoryEntry as T, Parenthetical as _, CitationType as a, ShortFormCaseCitation as b, ExtractorMap as c, FullCitation as d, FullCitationType as f, NeutralCitation as g, JournalCitation as h, CitationSignal as i, JournalComponentSpans as j, ConstitutionalComponentSpans as k, FederalRegisterCitation as l, IdCitation as m, CitationBase as n, ConstitutionalCitation as o, HistorySignal as p, CitationOfType as r, CourtInference as s, Citation as t, FullCaseCitation as u, ParentheticalType as v, StatutesAtLargeCitation as w, ShortFormCitation as x, PublicLawCitation as y, PinciteInfo as z };
-//# sourceMappingURL=citation-CIVlt9QA.d.mts.map
+//# sourceMappingURL=citation-DL2BQTYK.d.cts.map

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

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