eyecite-ts 0.13.3 → 0.14.0

package/dist/annotate/index.d.cts

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

package/dist/annotate/index.d.mts

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

package/dist/{citation-BaRqFZnV.d.cts → citation-DVzO4qsD.d.cts}

@@ -1,10 +1,17 @@
 //#region src/extract/pincite.d.ts
 /**
 * Structured pincite information parsed from citation text.
+*
+* `page` and `paragraph` are mutually exclusive — a pincite is either a page
+* reference (the common case) or a paragraph reference (#204; common in
+* NY Slip Op, Canadian neutrals, and other paragraph-numbered sources). The
+* top-level convenience `pincite: number` field on the citation continues to
+* mirror `page` only; paragraph consumers read `paragraph` / `endParagraph`
+* from this struct directly.
 */
 interface PinciteInfo {
-  /** Primary page number */
-  page: number;
+  /** Primary page number. Undefined when the pincite is paragraph-only (#204). */
+  page?: number;
   /** End page for ranges: "570-75" → 575 */
   endPage?: number;
   /** Footnote number: "570 n.3" → 3. For multi-footnote refs ("nn.3-5"), the
@@ -12,12 +19,24 @@ interface PinciteInfo {
   footnote?: number;
   /** End footnote for multi-note refs: "570 nn.3-5" → 5 */
   footnoteEnd?: number;
-  /** True if this is a page range */
+  /** True if this is a page or paragraph range */
   isRange: boolean;
   /** True when the pincite uses star-pagination (e.g., "*2"), denoting a
   *  slip-opinion page or unreported-decision page rather than a reporter page.
   *  Common on NY Slip Op, Westlaw, and Lexis citations. */
   starPage?: boolean;
+  /** Paragraph number for `¶ N` / `para. N` pincites (#204). */
+  paragraph?: number;
+  /** End paragraph for `¶¶ N-M` / `paras. N-M` pincites (#204). */
+  endParagraph?: number;
+  /** Additional discrete pincites following the primary one (#247). E.g.,
+  *  `410 U.S. 113, 115, 153` → first pincite is page=115, additionalPincites
+  *  is `[{ page: 153, ... }]`. Each entry is a full `PinciteInfo` so ranges
+  *  / footnotes / star-pages inside the comma chain are preserved
+  *  (`115, 105-110` → additional has `endPage` set). The top-level
+  *  convenience `pincite: number` field on the citation continues to mirror
+  *  only the primary pincite; consumers needing all pincites read this array. */
+  additionalPincites?: PinciteInfo[];
   /** Original text before parsing */
   raw: string;
 }
@@ -281,9 +300,11 @@ interface Warning {
 }
 /**
 * Introductory signal word classification for citation support level.
-* Based on Bluebook signal categories (Rule 1.2).
+* Based on Bluebook signal categories (Rule 1.2). The `, e.g.` combined
+* forms (Rule 1.3) carry distinct meaning ("one of many illustrative
+* authorities") and are tracked separately from the bare signals.
 */
-type CitationSignal = "see" | "see also" | "see generally" | "cf" | "but see" | "but cf" | "compare" | "accord" | "contra";
+type CitationSignal = "see" | "see also" | "see generally" | "cf" | "but see" | "but cf" | "compare" | "accord" | "contra" | "e.g." | "see, e.g." | "see also, e.g." | "but see, e.g." | "cf., e.g." | "but cf., e.g.";
 /**
 * Base fields shared by all citation types.
 */
@@ -360,8 +381,13 @@ interface Parenthetical {
 /**
 * Normalized subsequent history signal classification.
 * Maps variant spellings (aff'd, affirmed) to canonical forms.
+*
+* Texas Greenbook writ/petition history forms (placed inside the court-and-year
+* parenthetical, per Tex. R. App. P. 47.7) are tracked with their own categories
+* so downstream consumers can distinguish them from federal-style subsequent
+* history. See #229.
 */
-type HistorySignal = "affirmed" | "reversed" | "cert_denied" | "cert_granted" | "overruled" | "vacated" | "remanded" | "modified" | "abrogated" | "superseded" | "disapproved" | "questioned" | "distinguished" | "withdrawn" | "reinstated";
+type HistorySignal = "affirmed" | "reversed" | "cert_denied" | "cert_granted" | "overruled" | "vacated" | "remanded" | "modified" | "abrogated" | "superseded" | "disapproved" | "questioned" | "distinguished" | "withdrawn" | "reinstated" | "rehearing_denied" | "rehearing_granted" | "writ_refused" | "writ_dismissed" | "writ_denied" | "writ_granted" | "no_writ" | "pet_refused" | "pet_denied" | "pet_dismissed" | "pet_granted" | "pet_filed" | "no_pet" | "review_denied" | "review_granted" | "opinion_vacated" | "disapproved_other_grounds" | "not_published" | "petition_for_review_filed" | "petition_for_review_granted" | "petition_for_review_denied" | "superseded_by_grant_of_review" | "modified_on_denial_of_rehearing";
 /**
 * A single subsequent history entry from a case citation.
 *
@@ -396,6 +422,12 @@ interface FullCaseCitation extends CitationBase {
   /** Structured pincite information (page, range, footnote) */
   pinciteInfo?: PinciteInfo;
   court?: string;
+  /**
+  * True for citations whose source carried an unpublished-disposition marker.
+  * Set by NY Slip Op `(U)` / `[U]` suffix detection (#231). Absent or `false`
+  * for published decisions.
+  */
+  unpublished?: boolean;
   /** Normalized court string: spaces collapsed, trailing period ensured */
   normalizedCourt?: string;
   year?: number;
@@ -525,10 +557,34 @@ interface FullCaseCitation extends CitationBase {
   /**
   * Disposition or procedural status from parenthetical.
   * Populated by Phase 6 (Complex Parentheticals).
-  * @example "en banc", "per curiam"
+  * @example "en banc", "per curiam", "dissent", "concurrence", "mixed", "plurality opinion", "mem."
   */
   disposition?: string;
   /**
+  * Surname(s) of justice(s) attributed to the parenthetical disposition.
+  * Populated for justice-attribution parens (#235) like
+  * `(Brennan, J., dissenting)` → `["Brennan"]` or
+  * `(Brennan and Marshall, JJ., dissenting)` → `["Brennan", "Marshall"]`.
+  */
+  justices?: string[];
+  /**
+  * Scope qualifier from a justice-attribution parenthetical (#235).
+  * `in_judgment` — "concurring in the judgment"
+  * `in_part`     — "concurring in part" / "concurring in part and dissenting in part"
+  * `from_denial` — "dissenting from denial of <X>"
+  */
+  scope?: string;
+  /**
+  * Administrative parenthetical from a bankruptcy adversary caption (#241).
+  * In `Spence v. Hintze (In re Hintze), 570 B.R. 369`, the `(In re Hintze)`
+  * names the underlying debtor and is part of the case name (preserved on
+  * `caseName`). This field exposes the debtor identification separately so
+  * `defendant` / `defendantNormalized` can hold just the adversary defendant.
+  * Content is the parenthetical text without the surrounding parens — e.g.,
+  * `"In re Hintze"`.
+  */
+  adminParenthetical?: string;
+  /**
   * Court level/jurisdiction inferred from reporter series.
   * Always populated independently of the parenthetical `court` field.
   * Uses a curated static lookup table — does not depend on the reporter DB
@@ -609,6 +665,12 @@ interface NeutralCitation extends CitationBase {
   court: string;
   /** Document number */
   documentNumber: string;
+  /**
+  * True when the citation has an Illinois Rule 23 `-U` suffix (or analogous
+  * unpublished marker). The suffix is consumed and stripped from
+  * `documentNumber`. Absent or `false` for published decisions. (#230)
+  */
+  unpublished?: boolean;
   /** Pincite page (numeric portion, without "*" for star-pagination). */
   pincite?: number;
   /** Structured pincite information (page, range, footnote, star-pagination). */
@@ -837,4 +899,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-BaRqFZnV.d.cts.map
+//# sourceMappingURL=citation-DVzO4qsD.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"citation-DVzO4qsD.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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"}

package/dist/{citation-CVm_rp15.d.mts → citation-Djz0Pc-N.d.mts}

@@ -1,10 +1,17 @@
 //#region src/extract/pincite.d.ts
 /**
 * Structured pincite information parsed from citation text.
+*
+* `page` and `paragraph` are mutually exclusive — a pincite is either a page
+* reference (the common case) or a paragraph reference (#204; common in
+* NY Slip Op, Canadian neutrals, and other paragraph-numbered sources). The
+* top-level convenience `pincite: number` field on the citation continues to
+* mirror `page` only; paragraph consumers read `paragraph` / `endParagraph`
+* from this struct directly.
 */
 interface PinciteInfo {
-  /** Primary page number */
-  page: number;
+  /** Primary page number. Undefined when the pincite is paragraph-only (#204). */
+  page?: number;
   /** End page for ranges: "570-75" → 575 */
   endPage?: number;
   /** Footnote number: "570 n.3" → 3. For multi-footnote refs ("nn.3-5"), the
@@ -12,12 +19,24 @@ interface PinciteInfo {
   footnote?: number;
   /** End footnote for multi-note refs: "570 nn.3-5" → 5 */
   footnoteEnd?: number;
-  /** True if this is a page range */
+  /** True if this is a page or paragraph range */
   isRange: boolean;
   /** True when the pincite uses star-pagination (e.g., "*2"), denoting a
   *  slip-opinion page or unreported-decision page rather than a reporter page.
   *  Common on NY Slip Op, Westlaw, and Lexis citations. */
   starPage?: boolean;
+  /** Paragraph number for `¶ N` / `para. N` pincites (#204). */
+  paragraph?: number;
+  /** End paragraph for `¶¶ N-M` / `paras. N-M` pincites (#204). */
+  endParagraph?: number;
+  /** Additional discrete pincites following the primary one (#247). E.g.,
+  *  `410 U.S. 113, 115, 153` → first pincite is page=115, additionalPincites
+  *  is `[{ page: 153, ... }]`. Each entry is a full `PinciteInfo` so ranges
+  *  / footnotes / star-pages inside the comma chain are preserved
+  *  (`115, 105-110` → additional has `endPage` set). The top-level
+  *  convenience `pincite: number` field on the citation continues to mirror
+  *  only the primary pincite; consumers needing all pincites read this array. */
+  additionalPincites?: PinciteInfo[];
   /** Original text before parsing */
   raw: string;
 }
@@ -281,9 +300,11 @@ interface Warning {
 }
 /**
 * Introductory signal word classification for citation support level.
-* Based on Bluebook signal categories (Rule 1.2).
+* Based on Bluebook signal categories (Rule 1.2). The `, e.g.` combined
+* forms (Rule 1.3) carry distinct meaning ("one of many illustrative
+* authorities") and are tracked separately from the bare signals.
 */
-type CitationSignal = "see" | "see also" | "see generally" | "cf" | "but see" | "but cf" | "compare" | "accord" | "contra";
+type CitationSignal = "see" | "see also" | "see generally" | "cf" | "but see" | "but cf" | "compare" | "accord" | "contra" | "e.g." | "see, e.g." | "see also, e.g." | "but see, e.g." | "cf., e.g." | "but cf., e.g.";
 /**
 * Base fields shared by all citation types.
 */
@@ -360,8 +381,13 @@ interface Parenthetical {
 /**
 * Normalized subsequent history signal classification.
 * Maps variant spellings (aff'd, affirmed) to canonical forms.
+*
+* Texas Greenbook writ/petition history forms (placed inside the court-and-year
+* parenthetical, per Tex. R. App. P. 47.7) are tracked with their own categories
+* so downstream consumers can distinguish them from federal-style subsequent
+* history. See #229.
 */
-type HistorySignal = "affirmed" | "reversed" | "cert_denied" | "cert_granted" | "overruled" | "vacated" | "remanded" | "modified" | "abrogated" | "superseded" | "disapproved" | "questioned" | "distinguished" | "withdrawn" | "reinstated";
+type HistorySignal = "affirmed" | "reversed" | "cert_denied" | "cert_granted" | "overruled" | "vacated" | "remanded" | "modified" | "abrogated" | "superseded" | "disapproved" | "questioned" | "distinguished" | "withdrawn" | "reinstated" | "rehearing_denied" | "rehearing_granted" | "writ_refused" | "writ_dismissed" | "writ_denied" | "writ_granted" | "no_writ" | "pet_refused" | "pet_denied" | "pet_dismissed" | "pet_granted" | "pet_filed" | "no_pet" | "review_denied" | "review_granted" | "opinion_vacated" | "disapproved_other_grounds" | "not_published" | "petition_for_review_filed" | "petition_for_review_granted" | "petition_for_review_denied" | "superseded_by_grant_of_review" | "modified_on_denial_of_rehearing";
 /**
 * A single subsequent history entry from a case citation.
 *
@@ -396,6 +422,12 @@ interface FullCaseCitation extends CitationBase {
   /** Structured pincite information (page, range, footnote) */
   pinciteInfo?: PinciteInfo;
   court?: string;
+  /**
+  * True for citations whose source carried an unpublished-disposition marker.
+  * Set by NY Slip Op `(U)` / `[U]` suffix detection (#231). Absent or `false`
+  * for published decisions.
+  */
+  unpublished?: boolean;
   /** Normalized court string: spaces collapsed, trailing period ensured */
   normalizedCourt?: string;
   year?: number;
@@ -525,10 +557,34 @@ interface FullCaseCitation extends CitationBase {
   /**
   * Disposition or procedural status from parenthetical.
   * Populated by Phase 6 (Complex Parentheticals).
-  * @example "en banc", "per curiam"
+  * @example "en banc", "per curiam", "dissent", "concurrence", "mixed", "plurality opinion", "mem."
   */
   disposition?: string;
   /**
+  * Surname(s) of justice(s) attributed to the parenthetical disposition.
+  * Populated for justice-attribution parens (#235) like
+  * `(Brennan, J., dissenting)` → `["Brennan"]` or
+  * `(Brennan and Marshall, JJ., dissenting)` → `["Brennan", "Marshall"]`.
+  */
+  justices?: string[];
+  /**
+  * Scope qualifier from a justice-attribution parenthetical (#235).
+  * `in_judgment` — "concurring in the judgment"
+  * `in_part`     — "concurring in part" / "concurring in part and dissenting in part"
+  * `from_denial` — "dissenting from denial of <X>"
+  */
+  scope?: string;
+  /**
+  * Administrative parenthetical from a bankruptcy adversary caption (#241).
+  * In `Spence v. Hintze (In re Hintze), 570 B.R. 369`, the `(In re Hintze)`
+  * names the underlying debtor and is part of the case name (preserved on
+  * `caseName`). This field exposes the debtor identification separately so
+  * `defendant` / `defendantNormalized` can hold just the adversary defendant.
+  * Content is the parenthetical text without the surrounding parens — e.g.,
+  * `"In re Hintze"`.
+  */
+  adminParenthetical?: string;
+  /**
   * Court level/jurisdiction inferred from reporter series.
   * Always populated independently of the parenthetical `court` field.
   * Uses a curated static lookup table — does not depend on the reporter DB
@@ -609,6 +665,12 @@ interface NeutralCitation extends CitationBase {
   court: string;
   /** Document number */
   documentNumber: string;
+  /**
+  * True when the citation has an Illinois Rule 23 `-U` suffix (or analogous
+  * unpublished marker). The suffix is consumed and stripped from
+  * `documentNumber`. Absent or `false` for published decisions. (#230)
+  */
+  unpublished?: boolean;
   /** Pincite page (numeric portion, without "*" for star-pagination). */
   pincite?: number;
   /** Structured pincite information (page, range, footnote, star-pagination). */
@@ -837,4 +899,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-CVm_rp15.d.mts.map
+//# sourceMappingURL=citation-Djz0Pc-N.d.mts.map

package/dist/citation-Djz0Pc-N.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-Djz0Pc-N.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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"}