eyecite-ts 0.13.4 → 0.15.0

package/dist/annotate/index.d.cts

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

package/dist/annotate/index.d.mts

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

package/dist/{citation-CxwyZdtS.d.mts → citation-B7SBPpEl.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;
 }
@@ -368,7 +387,7 @@ interface Parenthetical {
 * 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" | "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";
+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.
 *
@@ -403,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;
@@ -532,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
@@ -799,6 +848,17 @@ interface ShortFormCaseCitation extends CitationBase {
   pinciteInfo?: PinciteInfo;
   /** Component-level spans (currently just `pincite`; extend when needed). */
   spans?: ShortFormCaseComponentSpans;
+  /** Back-reference party name when the short-form includes one (Bluebook
+  *  form: `Smith, 500 F.2d at 125`). Citation signals (`See`, `Cf.`, etc.)
+  *  and sentence-initial connectors (`Then`, `Also`, `In` not-`In re`) are
+  *  stripped via the same helper as supra (#216). Undefined when the
+  *  short-form is bare `500 F.2d at 125`. Used by the resolver to
+  *  disambiguate when multiple full citations share the same vol+reporter. */
+  partyName?: string;
+  /** Normalized party name for resolver matching (lowercased, whitespace
+  *  collapsed). Mirrors `defendantNormalized` / `plaintiffNormalized` on
+  *  `FullCaseCitation`. */
+  partyNameNormalized?: string;
 }
 /**
 * Union type of all citation types.
@@ -850,4 +910,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-CxwyZdtS.d.mts.map
+//# sourceMappingURL=citation-B7SBPpEl.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"citation-B7SBPpEl.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-dDdIyQC7.d.cts → citation-BuBDvjag.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;
 }
@@ -368,7 +387,7 @@ interface Parenthetical {
 * 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" | "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";
+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.
 *
@@ -403,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;
@@ -532,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
@@ -799,6 +848,17 @@ interface ShortFormCaseCitation extends CitationBase {
   pinciteInfo?: PinciteInfo;
   /** Component-level spans (currently just `pincite`; extend when needed). */
   spans?: ShortFormCaseComponentSpans;
+  /** Back-reference party name when the short-form includes one (Bluebook
+  *  form: `Smith, 500 F.2d at 125`). Citation signals (`See`, `Cf.`, etc.)
+  *  and sentence-initial connectors (`Then`, `Also`, `In` not-`In re`) are
+  *  stripped via the same helper as supra (#216). Undefined when the
+  *  short-form is bare `500 F.2d at 125`. Used by the resolver to
+  *  disambiguate when multiple full citations share the same vol+reporter. */
+  partyName?: string;
+  /** Normalized party name for resolver matching (lowercased, whitespace
+  *  collapsed). Mirrors `defendantNormalized` / `plaintiffNormalized` on
+  *  `FullCaseCitation`. */
+  partyNameNormalized?: string;
 }
 /**
 * Union type of all citation types.
@@ -850,4 +910,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-dDdIyQC7.d.cts.map
+//# sourceMappingURL=citation-BuBDvjag.d.mts.map

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

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