eyecite-ts 0.20.1 → 0.21.1

package/dist/index.d.cts

@@ -619,15 +619,6 @@ declare class DocumentResolver {
   */
   private inheritPincites;
   /**
-  * Compute parenthesis depth at the start position of each citation.
-  * Walks the raw text once, counting `(` and `)` and recording the
-  * running depth at every citation's `span.cleanStart`. Depth > 0
-  * indicates the citation is nested inside an open parenthetical
-  * block (typically an explanatory `(quoting X)` / `(citing Y)`
-  * following an earlier citation).
-  */
-  private computeParenDepths;
-  /**
   * Find the immediate-preceding citation index for `antecedentIndex`
   * purposes. Bluebook Rule 4.1: `Id.` anchors to "the immediately
   * preceding cited authority" — unlike `resolveId`'s primary chase
@@ -641,8 +632,10 @@ declare class DocumentResolver {
   private findImmediatePredecessor;
   /**
   * Resolves `Id.` to the most recent preceding *cited authority*, respecting
-  * Bluebook signal categories, block-/inline-quote zones, and the family
-  * (case vs. statute) implied by `Id.`'s pincite shape (#480).
+  * block-/inline-quote zones and the family (case vs. statute) implied by
+  * `Id.`'s pincite shape (#480). Per Bluebook Rule 4.1, signal phrase is
+  * NOT a filter — `Id.` anchors to the immediately preceding cited
+  * authority regardless of whether it carries `See`, `Cf.`, etc. (#498).
   *
   * Algorithm:
   *   1. Walk backward from `currentIndex`, normalizing short-form citations
@@ -651,9 +644,8 @@ declare class DocumentResolver {
   *      doesn't get double-counted with its full-cite further back.
   *   2. Filter candidates that are parenthetical children (existing #214
   *      behavior) or in a quote zone outside `Id.`'s own zone.
-  *   3. Score remaining candidates: family-match dominates, then signal
-  *      strength, then (implicitly) recency (first-added = most recent
-  *      effective mention).
+  *   3. Score remaining candidates: family-match dominates, then (implicitly)
+  *      recency (first-added = most recent effective mention).
   *   4. Apply the case-name window check to surface ambiguity when the prose
   *      immediately before `Id.` mentions a different case name.
   */
@@ -667,14 +659,6 @@ declare class DocumentResolver {
   */
   private getIdPreferredFamily;
   /**
-  * Computes the "effective" signal for a citation. Citations inside a
-  * string-cite group inherit the leading signal of the group's first
-  * member when they have no signal of their own — the Bluebook rule that
-  * a leading signal governs the entire string cite.
-  */
-  private getEffectiveSignal;
-  private isCandidateWeakSignal;
-  /**
   * `(citing X)` / `(quoting Y)` detection (#214). Two strategies in OR:
   *   - paren depth > 0 at the citation's start (works for any prior
   *     citation type — statute, journal, etc.);
@@ -801,5 +785,152 @@ declare function resolveCitations(citations: Citation[], text: string, options?:
 */
 declare function detectFootnotes(text: string): FootnoteMap;
 //#endregion
-export { type CaseComponentSpans, type Citation, type CitationBase, type CitationOfType, type CitationSignal, type CitationType, type CleanTextResult, type ConstitutionalCitation, type ConstitutionalComponentSpans, type CourtInference, type DocketCitation, DocumentResolver, type ExtractOptions, type ExtractorMap, type FederalRegisterCitation, type FederalRegisterComponentSpans, type FootnoteMap, type FootnoteZone, type FullCaseCitation, type FullCitation, type FullCitationType, type HistorySignal, type IdCitation, type JournalCitation, type JournalComponentSpans, type NeutralCitation, type NeutralComponentSpans, type Parenthetical, type ParentheticalType, type PinciteInfo, type PublicLawCitation, type PublicLawComponentSpans, type ResolutionOptions, type ResolutionResult, type ResolvedCitation, type ScopeStrategy, type ShortFormCaseCitation, type ShortFormCitation, type ShortFormCitationType, type Span, type StatuteCitation, type StatuteComponentSpans, type StatutesAtLargeCitation, type StatutesAtLargeComponentSpans, type SubsequentHistoryEntry, type SupraCitation, type Token, type TransformationMap, type Warning, applyFalsePositiveFilters, assertUnreachable, cleanText, detectFootnotes, extractCase, extractCitations, extractCitationsAsync, extractConstitutional, extractFederalRegister, extractJournal, extractNeutral, extractPublicLaw, extractStatute, extractStatutesAtLarge, isCaseCitation, isCitationType, isFullCitation, isShortFormCitation, normalizeCourt, parsePincite, resolveCitations, spanFromGroupIndex, tokenize };
+//#region src/document/types.d.ts
+/**
+* Attribution mode for a quoted-text zone. Reflects the structural
+* relationship between the quote and the citation that vouches for it.
+*
+* - "block-quote": Bluebook Rule 5 — quote set off as an indented block or
+*   marked with markdown `>`, with the citation immediately following.
+* - "adjacent": inline quote in the same sentence as the citation.
+* - "parenthetical": quote inside an explanatory parenthetical
+*   (e.g. `(quoting "..." Smith, 1 U.S. 1)`).
+*/
+type AttributionKind = "block-quote" | "adjacent" | "parenthetical";
+/**
+* A quoted-text zone paired with the citation (if any) that vouches for it.
+* Produced by the document analyzer; one entry per detected quote zone.
+* Unattributed zones surface with `citationIndex` undefined.
+*/
+interface QuoteAttribution {
+  /** The quoted-text span in original-text coordinates. */
+  quoteSpan: Span;
+  /** Verbatim quoted text (chars between the marks, exclusive of the marks). */
+  quoteText: string;
+  /** Citation index that vouches for the quote; undefined when none found. */
+  citationIndex?: number;
+  /** How the attribution was inferred; undefined iff citationIndex is. */
+  attributionKind?: AttributionKind;
+  /**
+  * Confidence (0-1). See `quoteAttribution.ts` for the stratification:
+  *   block-quote, citation within 50 chars: 0.98
+  *   block-quote, citation within 200 chars: 0.90
+  *   adjacent inline, same sentence: 0.85
+  *   parenthetical-internal: 0.95
+  *   unattributed: undefined
+  */
+  confidence?: number;
+}
+/**
+* A typed edge in the citation graph. `from` and `to` are indices into
+* the `Document.citations` array. `type` discriminates the union.
+*
+* See `docs/superpowers/specs/2026-05-19-document-understanding-api-design.md`
+* for the source-map describing which existing citation fields drive each kind.
+*/
+type Edge = {
+  type: "resolves-to";
+  from: number;
+  to: number;
+  confidence: number;
+  warnings?: string[];
+} | {
+  type: "antecedent";
+  from: number;
+  to: number;
+} | {
+  type: "parallel";
+  from: number;
+  to: number;
+  groupId: string;
+} | {
+  type: "history-of";
+  from: number;
+  to: number;
+  signal: HistorySignal;
+} | {
+  type: "pincite-inherit";
+  from: number;
+  to: number;
+} | {
+  type: "string-cite";
+  from: number;
+  to: number;
+  groupId: string;
+  position: number;
+} | {
+  type: "in-parenthetical-of";
+  from: number;
+  to: number;
+};
+/**
+* The graph of relationships between citations in a document.
+*
+* - `nodes.length === citations.length` always; isolated nodes
+*   (no edges) are still included so consumers iterating nodes don't
+*   miss anything.
+* - `edges` is sorted by from-index, then type (alphabetical), then
+*   to-index for deterministic iteration and test assertions.
+* - No self-edges. No duplicate edges of the same type+from+to.
+*   Undirected relationships (parallel groups) emit one edge per pair.
+*/
+interface CitationGraph {
+  nodes: number[];
+  edges: Edge[];
+}
+/**
+* A footnote zone with the citations it contains. Populated only when
+* input citations carry footnote tagging (extractCitations was called
+* with `detectFootnotes: true`).
+*/
+interface AnalyzedFootnoteZone {
+  start: number;
+  end: number;
+  footnoteNumber: number;
+  /** Indices of citations whose span falls inside this footnote. */
+  citationIndices: number[];
+}
+/**
+* The document analysis result. Returned by `analyzeDocument(text, citations)`.
+*
+* Produced as a pure projection over `text + citations[]` — no new
+* tokenization or extraction. See the design doc for the algorithm rationale.
+*/
+interface Document {
+  /** The citations that were analyzed. Same array reference as the input. */
+  citations: Citation[];
+  /** Prose between citations (+ before-first + after-last). Sorted by
+  *  originalStart. Uses `fullSpan` (when available) to bound citations,
+  *  so case-name text is not mislabeled as prose. */
+  proseSpans: Span[];
+  /** Per-citation view: prose span ending at this citation. */
+  precedingProse: Map<number, Span>;
+  /** Per-citation view: prose span starting after this citation. */
+  followingProse: Map<number, Span>;
+  /** Detected quoted-text zones with attempted attribution. Includes
+  *  unattributed zones (citationIndex undefined). */
+  quoteAttributions: QuoteAttribution[];
+  /** All relationships between citations as typed edges. */
+  citationGraph: CitationGraph;
+  /** Footnote zones with citation members. Optional — only present when
+  *  citations carry footnote tagging. */
+  footnoteZones?: AnalyzedFootnoteZone[];
+}
+//#endregion
+//#region src/document/analyzer.d.ts
+/**
+* Project an existing extraction result into a Document view with prose
+* offsets, quote attribution, citation graph, and (optionally) footnote
+* zones.
+*
+* Pure projection — reads existing fields, re-shapes; no new tokenization
+* or extraction. Cheap (sub-millisecond per call for typical brief sizes).
+*
+* See `docs/superpowers/specs/2026-05-19-document-understanding-api-design.md`.
+*/
+declare function analyzeDocument(text: string, citations: Citation[], opts?: {
+  transformationMap?: TransformationMap;
+}): Document;
+//#endregion
+export { type AnalyzedFootnoteZone, type AttributionKind, type CaseComponentSpans, type Citation, type CitationBase, type CitationGraph, type CitationOfType, type CitationSignal, type CitationType, type CleanTextResult, type ConstitutionalCitation, type ConstitutionalComponentSpans, type CourtInference, type DocketCitation, type Document, DocumentResolver, type Edge, type ExtractOptions, type ExtractorMap, type FederalRegisterCitation, type FederalRegisterComponentSpans, type FootnoteMap, type FootnoteZone, type FullCaseCitation, type FullCitation, type FullCitationType, type HistorySignal, type IdCitation, type JournalCitation, type JournalComponentSpans, type NeutralCitation, type NeutralComponentSpans, type Parenthetical, type ParentheticalType, type PinciteInfo, type PublicLawCitation, type PublicLawComponentSpans, type QuoteAttribution, type ResolutionOptions, type ResolutionResult, type ResolvedCitation, type ScopeStrategy, type ShortFormCaseCitation, type ShortFormCitation, type ShortFormCitationType, type Span, type StatuteCitation, type StatuteComponentSpans, type StatutesAtLargeCitation, type StatutesAtLargeComponentSpans, type SubsequentHistoryEntry, type SupraCitation, type Token, type TransformationMap, type Warning, analyzeDocument, applyFalsePositiveFilters, assertUnreachable, cleanText, detectFootnotes, extractCase, extractCitations, extractCitationsAsync, extractConstitutional, extractFederalRegister, extractJournal, extractNeutral, extractPublicLaw, extractStatute, extractStatutesAtLarge, isCaseCitation, isCitationType, isFullCitation, isShortFormCitation, normalizeCourt, parsePincite, resolveCitations, spanFromGroupIndex, tokenize };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types/guards.ts","../src/patterns/casePatterns.ts","../src/extract/extractCitations.ts","../src/extract/filterFalsePositives.ts","../src/clean/cleanText.ts","../src/tokenize/tokenizer.ts","../src/extract/extractCase.ts","../src/extract/extractConstitutional.ts","../src/extract/extractFederalRegister.ts","../src/extract/extractJournal.ts","../src/extract/extractNeutral.ts","../src/extract/extractPublicLaw.ts","../src/extract/extractStatute.ts","../src/extract/extractStatutesAtLarge.ts","../src/extract/courtNormalization.ts","../src/resolve/DocumentResolver.ts","../src/resolve/index.ts","../src/footnotes/detectFootnotes.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types/guards.ts","../src/patterns/casePatterns.ts","../src/extract/extractCitations.ts","../src/extract/filterFalsePositives.ts","../src/clean/cleanText.ts","../src/tokenize/tokenizer.ts","../src/extract/extractCase.ts","../src/extract/extractConstitutional.ts","../src/extract/extractFederalRegister.ts","../src/extract/extractJournal.ts","../src/extract/extractNeutral.ts","../src/extract/extractPublicLaw.ts","../src/extract/extractStatute.ts","../src/extract/extractStatutesAtLarge.ts","../src/extract/courtNormalization.ts","../src/resolve/DocumentResolver.ts","../src/resolve/index.ts","../src/footnotes/detectFootnotes.ts","../src/document/types.ts","../src/document/analyzer.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -619,15 +619,6 @@ declare class DocumentResolver {
   */
   private inheritPincites;
   /**
-  * Compute parenthesis depth at the start position of each citation.
-  * Walks the raw text once, counting `(` and `)` and recording the
-  * running depth at every citation's `span.cleanStart`. Depth > 0
-  * indicates the citation is nested inside an open parenthetical
-  * block (typically an explanatory `(quoting X)` / `(citing Y)`
-  * following an earlier citation).
-  */
-  private computeParenDepths;
-  /**
   * Find the immediate-preceding citation index for `antecedentIndex`
   * purposes. Bluebook Rule 4.1: `Id.` anchors to "the immediately
   * preceding cited authority" — unlike `resolveId`'s primary chase
@@ -641,8 +632,10 @@ declare class DocumentResolver {
   private findImmediatePredecessor;
   /**
   * Resolves `Id.` to the most recent preceding *cited authority*, respecting
-  * Bluebook signal categories, block-/inline-quote zones, and the family
-  * (case vs. statute) implied by `Id.`'s pincite shape (#480).
+  * block-/inline-quote zones and the family (case vs. statute) implied by
+  * `Id.`'s pincite shape (#480). Per Bluebook Rule 4.1, signal phrase is
+  * NOT a filter — `Id.` anchors to the immediately preceding cited
+  * authority regardless of whether it carries `See`, `Cf.`, etc. (#498).
   *
   * Algorithm:
   *   1. Walk backward from `currentIndex`, normalizing short-form citations
@@ -651,9 +644,8 @@ declare class DocumentResolver {
   *      doesn't get double-counted with its full-cite further back.
   *   2. Filter candidates that are parenthetical children (existing #214
   *      behavior) or in a quote zone outside `Id.`'s own zone.
-  *   3. Score remaining candidates: family-match dominates, then signal
-  *      strength, then (implicitly) recency (first-added = most recent
-  *      effective mention).
+  *   3. Score remaining candidates: family-match dominates, then (implicitly)
+  *      recency (first-added = most recent effective mention).
   *   4. Apply the case-name window check to surface ambiguity when the prose
   *      immediately before `Id.` mentions a different case name.
   */
@@ -667,14 +659,6 @@ declare class DocumentResolver {
   */
   private getIdPreferredFamily;
   /**
-  * Computes the "effective" signal for a citation. Citations inside a
-  * string-cite group inherit the leading signal of the group's first
-  * member when they have no signal of their own — the Bluebook rule that
-  * a leading signal governs the entire string cite.
-  */
-  private getEffectiveSignal;
-  private isCandidateWeakSignal;
-  /**
   * `(citing X)` / `(quoting Y)` detection (#214). Two strategies in OR:
   *   - paren depth > 0 at the citation's start (works for any prior
   *     citation type — statute, journal, etc.);
@@ -801,5 +785,152 @@ declare function resolveCitations(citations: Citation[], text: string, options?:
 */
 declare function detectFootnotes(text: string): FootnoteMap;
 //#endregion
-export { type CaseComponentSpans, type Citation, type CitationBase, type CitationOfType, type CitationSignal, type CitationType, type CleanTextResult, type ConstitutionalCitation, type ConstitutionalComponentSpans, type CourtInference, type DocketCitation, DocumentResolver, type ExtractOptions, type ExtractorMap, type FederalRegisterCitation, type FederalRegisterComponentSpans, type FootnoteMap, type FootnoteZone, type FullCaseCitation, type FullCitation, type FullCitationType, type HistorySignal, type IdCitation, type JournalCitation, type JournalComponentSpans, type NeutralCitation, type NeutralComponentSpans, type Parenthetical, type ParentheticalType, type PinciteInfo, type PublicLawCitation, type PublicLawComponentSpans, type ResolutionOptions, type ResolutionResult, type ResolvedCitation, type ScopeStrategy, type ShortFormCaseCitation, type ShortFormCitation, type ShortFormCitationType, type Span, type StatuteCitation, type StatuteComponentSpans, type StatutesAtLargeCitation, type StatutesAtLargeComponentSpans, type SubsequentHistoryEntry, type SupraCitation, type Token, type TransformationMap, type Warning, applyFalsePositiveFilters, assertUnreachable, cleanText, detectFootnotes, extractCase, extractCitations, extractCitationsAsync, extractConstitutional, extractFederalRegister, extractJournal, extractNeutral, extractPublicLaw, extractStatute, extractStatutesAtLarge, isCaseCitation, isCitationType, isFullCitation, isShortFormCitation, normalizeCourt, parsePincite, resolveCitations, spanFromGroupIndex, tokenize };
+//#region src/document/types.d.ts
+/**
+* Attribution mode for a quoted-text zone. Reflects the structural
+* relationship between the quote and the citation that vouches for it.
+*
+* - "block-quote": Bluebook Rule 5 — quote set off as an indented block or
+*   marked with markdown `>`, with the citation immediately following.
+* - "adjacent": inline quote in the same sentence as the citation.
+* - "parenthetical": quote inside an explanatory parenthetical
+*   (e.g. `(quoting "..." Smith, 1 U.S. 1)`).
+*/
+type AttributionKind = "block-quote" | "adjacent" | "parenthetical";
+/**
+* A quoted-text zone paired with the citation (if any) that vouches for it.
+* Produced by the document analyzer; one entry per detected quote zone.
+* Unattributed zones surface with `citationIndex` undefined.
+*/
+interface QuoteAttribution {
+  /** The quoted-text span in original-text coordinates. */
+  quoteSpan: Span;
+  /** Verbatim quoted text (chars between the marks, exclusive of the marks). */
+  quoteText: string;
+  /** Citation index that vouches for the quote; undefined when none found. */
+  citationIndex?: number;
+  /** How the attribution was inferred; undefined iff citationIndex is. */
+  attributionKind?: AttributionKind;
+  /**
+  * Confidence (0-1). See `quoteAttribution.ts` for the stratification:
+  *   block-quote, citation within 50 chars: 0.98
+  *   block-quote, citation within 200 chars: 0.90
+  *   adjacent inline, same sentence: 0.85
+  *   parenthetical-internal: 0.95
+  *   unattributed: undefined
+  */
+  confidence?: number;
+}
+/**
+* A typed edge in the citation graph. `from` and `to` are indices into
+* the `Document.citations` array. `type` discriminates the union.
+*
+* See `docs/superpowers/specs/2026-05-19-document-understanding-api-design.md`
+* for the source-map describing which existing citation fields drive each kind.
+*/
+type Edge = {
+  type: "resolves-to";
+  from: number;
+  to: number;
+  confidence: number;
+  warnings?: string[];
+} | {
+  type: "antecedent";
+  from: number;
+  to: number;
+} | {
+  type: "parallel";
+  from: number;
+  to: number;
+  groupId: string;
+} | {
+  type: "history-of";
+  from: number;
+  to: number;
+  signal: HistorySignal;
+} | {
+  type: "pincite-inherit";
+  from: number;
+  to: number;
+} | {
+  type: "string-cite";
+  from: number;
+  to: number;
+  groupId: string;
+  position: number;
+} | {
+  type: "in-parenthetical-of";
+  from: number;
+  to: number;
+};
+/**
+* The graph of relationships between citations in a document.
+*
+* - `nodes.length === citations.length` always; isolated nodes
+*   (no edges) are still included so consumers iterating nodes don't
+*   miss anything.
+* - `edges` is sorted by from-index, then type (alphabetical), then
+*   to-index for deterministic iteration and test assertions.
+* - No self-edges. No duplicate edges of the same type+from+to.
+*   Undirected relationships (parallel groups) emit one edge per pair.
+*/
+interface CitationGraph {
+  nodes: number[];
+  edges: Edge[];
+}
+/**
+* A footnote zone with the citations it contains. Populated only when
+* input citations carry footnote tagging (extractCitations was called
+* with `detectFootnotes: true`).
+*/
+interface AnalyzedFootnoteZone {
+  start: number;
+  end: number;
+  footnoteNumber: number;
+  /** Indices of citations whose span falls inside this footnote. */
+  citationIndices: number[];
+}
+/**
+* The document analysis result. Returned by `analyzeDocument(text, citations)`.
+*
+* Produced as a pure projection over `text + citations[]` — no new
+* tokenization or extraction. See the design doc for the algorithm rationale.
+*/
+interface Document {
+  /** The citations that were analyzed. Same array reference as the input. */
+  citations: Citation[];
+  /** Prose between citations (+ before-first + after-last). Sorted by
+  *  originalStart. Uses `fullSpan` (when available) to bound citations,
+  *  so case-name text is not mislabeled as prose. */
+  proseSpans: Span[];
+  /** Per-citation view: prose span ending at this citation. */
+  precedingProse: Map<number, Span>;
+  /** Per-citation view: prose span starting after this citation. */
+  followingProse: Map<number, Span>;
+  /** Detected quoted-text zones with attempted attribution. Includes
+  *  unattributed zones (citationIndex undefined). */
+  quoteAttributions: QuoteAttribution[];
+  /** All relationships between citations as typed edges. */
+  citationGraph: CitationGraph;
+  /** Footnote zones with citation members. Optional — only present when
+  *  citations carry footnote tagging. */
+  footnoteZones?: AnalyzedFootnoteZone[];
+}
+//#endregion
+//#region src/document/analyzer.d.ts
+/**
+* Project an existing extraction result into a Document view with prose
+* offsets, quote attribution, citation graph, and (optionally) footnote
+* zones.
+*
+* Pure projection — reads existing fields, re-shapes; no new tokenization
+* or extraction. Cheap (sub-millisecond per call for typical brief sizes).
+*
+* See `docs/superpowers/specs/2026-05-19-document-understanding-api-design.md`.
+*/
+declare function analyzeDocument(text: string, citations: Citation[], opts?: {
+  transformationMap?: TransformationMap;
+}): Document;
+//#endregion
+export { type AnalyzedFootnoteZone, type AttributionKind, type CaseComponentSpans, type Citation, type CitationBase, type CitationGraph, type CitationOfType, type CitationSignal, type CitationType, type CleanTextResult, type ConstitutionalCitation, type ConstitutionalComponentSpans, type CourtInference, type DocketCitation, type Document, DocumentResolver, type Edge, type ExtractOptions, type ExtractorMap, type FederalRegisterCitation, type FederalRegisterComponentSpans, type FootnoteMap, type FootnoteZone, type FullCaseCitation, type FullCitation, type FullCitationType, type HistorySignal, type IdCitation, type JournalCitation, type JournalComponentSpans, type NeutralCitation, type NeutralComponentSpans, type Parenthetical, type ParentheticalType, type PinciteInfo, type PublicLawCitation, type PublicLawComponentSpans, type QuoteAttribution, type ResolutionOptions, type ResolutionResult, type ResolvedCitation, type ScopeStrategy, type ShortFormCaseCitation, type ShortFormCitation, type ShortFormCitationType, type Span, type StatuteCitation, type StatuteComponentSpans, type StatutesAtLargeCitation, type StatutesAtLargeComponentSpans, type SubsequentHistoryEntry, type SupraCitation, type Token, type TransformationMap, type Warning, analyzeDocument, applyFalsePositiveFilters, assertUnreachable, cleanText, detectFootnotes, extractCase, extractCitations, extractCitationsAsync, extractConstitutional, extractFederalRegister, extractJournal, extractNeutral, extractPublicLaw, extractStatute, extractStatutesAtLarge, isCaseCitation, isCitationType, isFullCitation, isShortFormCitation, normalizeCourt, parsePincite, resolveCitations, spanFromGroupIndex, tokenize };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/guards.ts","../src/patterns/casePatterns.ts","../src/extract/extractCitations.ts","../src/extract/filterFalsePositives.ts","../src/clean/cleanText.ts","../src/tokenize/tokenizer.ts","../src/extract/extractCase.ts","../src/extract/extractConstitutional.ts","../src/extract/extractFederalRegister.ts","../src/extract/extractJournal.ts","../src/extract/extractNeutral.ts","../src/extract/extractPublicLaw.ts","../src/extract/extractStatute.ts","../src/extract/extractStatutesAtLarge.ts","../src/extract/courtNormalization.ts","../src/resolve/DocumentResolver.ts","../src/resolve/index.ts","../src/footnotes/detectFootnotes.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/guards.ts","../src/patterns/casePatterns.ts","../src/extract/extractCitations.ts","../src/extract/filterFalsePositives.ts","../src/clean/cleanText.ts","../src/tokenize/tokenizer.ts","../src/extract/extractCase.ts","../src/extract/extractConstitutional.ts","../src/extract/extractFederalRegister.ts","../src/extract/extractJournal.ts","../src/extract/extractNeutral.ts","../src/extract/extractPublicLaw.ts","../src/extract/extractStatute.ts","../src/extract/extractStatutesAtLarge.ts","../src/extract/courtNormalization.ts","../src/resolve/DocumentResolver.ts","../src/resolve/index.ts","../src/footnotes/detectFootnotes.ts","../src/document/types.ts","../src/document/analyzer.ts"],"mappings":"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"}