eyecite-ts 0.8.4 → 0.10.0

package/README.md

@@ -313,7 +313,6 @@ const resolved = resolveCitations(citations, text, {
 | `paragraphBoundaryPattern` | `RegExp` | `/\n\n+/` | Pattern to detect paragraphs |
 | `fuzzyPartyMatching` | `boolean` | `true` | Enable fuzzy party name matching for supra |
 | `partyMatchThreshold` | `number` | `0.8` | Similarity threshold (0-1) for fuzzy matching |
-| `allowNestedResolution` | `boolean` | `false` | Allow Id. to resolve to other short-form citations |
 | `reportUnresolved` | `boolean` | `true` | Report failure reasons for unresolved citations |
 
 ### Resolution Examples
@@ -347,7 +346,7 @@ const citations = extractCitations(text, { resolve: true })
 ```typescript
 const text = 'Id. at 100.' // Orphan Id. with no preceding citation
 const citations = extractCitations(text, { resolve: true })
-// citations[0].resolution.failureReason === 'No preceding full case citation found'
+// citations[0].resolution.failureReason === 'No preceding citation found'
 ```
 
 ## Citation Annotation

package/dist/annotate/index.d.cts

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

package/dist/annotate/index.d.mts

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

package/dist/{citation-Cp0M8pGK.d.cts → citation-CCExUh08.d.mts}

@@ -107,6 +107,130 @@ interface TransformationMap {
   /** Compressed segment-based clean→original mapping for O(log k) lookup */
   cleanToOriginalSegments?: SegmentMap;
 }
+/**
+* Build a Span for a regex capture group using match.indices (ES2022 `d` flag).
+*
+* Requires the regex to have the `d` flag so match.indices is populated.
+* The indices are relative to the token text — tokenCleanStart translates
+* them to document-level clean-text positions, then resolveOriginalSpan
+* maps to original positions via TransformationMap.
+*
+* @param tokenCleanStart - The token's cleanStart position in the document
+* @param indices - match.indices[n] for the capture group: [start, end]
+* @param map - TransformationMap for clean→original resolution
+* @returns Span with both clean and original coordinates
+*/
+declare function spanFromGroupIndex(tokenCleanStart: number, indices: [number, number], map: TransformationMap): Span;
+//#endregion
+//#region src/types/componentSpans.d.ts
+/**
+* Component spans for case citations (type: "case").
+*
+* Containment: when both `metadataParenthetical` and `court`/`year` are present,
+* `court` and `year` are sub-ranges within `metadataParenthetical`. Consumers
+* rendering highlights should use either the parent or child spans, not both.
+*/
+interface CaseComponentSpans {
+  caseName?: Span;
+  plaintiff?: Span;
+  defendant?: Span;
+  volume?: Span;
+  reporter?: Span;
+  page?: Span;
+  pincite?: Span;
+  court?: Span;
+  year?: Span;
+  signal?: Span;
+  metadataParenthetical?: Span;
+}
+/**
+* Component spans for statute citations (type: "statute").
+*
+* Note: `signal` is included for future extensibility but is currently only
+* populated for case citations.
+*/
+interface StatuteComponentSpans {
+  title?: Span;
+  code?: Span;
+  section?: Span;
+  subsection?: Span;
+  signal?: Span;
+}
+/**
+* Component spans for constitutional citations (type: "constitutional").
+*
+* Note: `signal` is included for future extensibility but is currently only
+* populated for case citations.
+*/
+interface ConstitutionalComponentSpans {
+  jurisdiction?: Span;
+  article?: Span;
+  amendment?: Span;
+  section?: Span;
+  clause?: Span;
+  signal?: Span;
+}
+/**
+* Component spans for journal citations (type: "journal").
+*
+* Note: `signal` is included for future extensibility but is currently only
+* populated for case citations.
+*/
+interface JournalComponentSpans {
+  volume?: Span;
+  journal?: Span;
+  page?: Span;
+  pincite?: Span;
+  year?: Span;
+  signal?: Span;
+}
+/**
+* Component spans for neutral citations (type: "neutral").
+*
+* Note: `signal` is included for future extensibility but is currently only
+* populated for case citations.
+*/
+interface NeutralComponentSpans {
+  year?: Span;
+  court?: Span;
+  documentNumber?: Span;
+  signal?: Span;
+}
+/**
+* Component spans for public law citations (type: "publicLaw").
+*
+* Note: `signal` is included for future extensibility but is currently only
+* populated for case citations.
+*/
+interface PublicLawComponentSpans {
+  congress?: Span;
+  lawNumber?: Span;
+  signal?: Span;
+}
+/**
+* Component spans for federal register citations (type: "federalRegister").
+*
+* Note: `signal` is included for future extensibility but is currently only
+* populated for case citations.
+*/
+interface FederalRegisterComponentSpans {
+  volume?: Span;
+  page?: Span;
+  year?: Span;
+  signal?: Span;
+}
+/**
+* Component spans for statutes at large citations (type: "statutesAtLarge").
+*
+* Note: `signal` is included for future extensibility but is currently only
+* populated for case citations.
+*/
+interface StatutesAtLargeComponentSpans {
+  volume?: Span;
+  page?: Span;
+  year?: Span;
+  signal?: Span;
+}
 //#endregion
 //#region src/types/citation.d.ts
 /**
@@ -204,6 +328,8 @@ interface Parenthetical {
   text: string;
   /** Signal-word classification based on leading gerund */
   type: ParentheticalType;
+  /** Position of full parenthetical block including delimiters */
+  span?: Span;
 }
 /**
 * Normalized subsequent history signal classification.
@@ -383,6 +509,8 @@ interface FullCaseCitation extends CitationBase {
   * to preserve tree-shaking of the `eyecite-ts/data` entry point.
   */
   inferredCourt?: CourtInference;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: CaseComponentSpans;
 }
 /**
 * Statute citation (U.S. Code, state codes, etc.).
@@ -407,6 +535,8 @@ interface StatuteCitation extends CitationBase {
   pincite?: string;
   /** True when "et seq." follows the citation */
   hasEtSeq?: boolean;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: StatuteComponentSpans;
 }
 /**
 * Journal citation (law review, legal periodical).
@@ -434,6 +564,8 @@ interface JournalCitation extends CitationBase {
   pincite?: number;
   /** Publication year */
   year?: number;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: JournalComponentSpans;
 }
 /**
 * Neutral citation (vendor-neutral format).
@@ -451,6 +583,8 @@ interface NeutralCitation extends CitationBase {
   court: string;
   /** Document number */
   documentNumber: string;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: NeutralComponentSpans;
 }
 /**
 * Public law citation (federal legislation).
@@ -468,6 +602,8 @@ interface PublicLawCitation extends CitationBase {
   lawNumber: number;
   /** Optional bill title extracted from nearby text */
   title?: string;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: PublicLawComponentSpans;
 }
 /**
 * Federal Register citation.
@@ -485,6 +621,8 @@ interface FederalRegisterCitation extends CitationBase {
   page: number;
   /** Publication year (if extracted) */
   year?: number;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: FederalRegisterComponentSpans;
 }
 /** Citation to the Statutes at Large (session law compilation) */
 interface StatutesAtLargeCitation extends CitationBase {
@@ -495,6 +633,8 @@ interface StatutesAtLargeCitation extends CitationBase {
   page: number;
   /** Publication year (if extracted) */
   year?: number;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: StatutesAtLargeComponentSpans;
 }
 /**
 * Constitutional citation (U.S. or state constitution).
@@ -515,6 +655,8 @@ interface ConstitutionalCitation extends CitationBase {
   section?: string;
   /** Clause number (always numeric) */
   clause?: number;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: ConstitutionalComponentSpans;
 }
 /**
 * Id. citation (refers to immediately preceding citation).
@@ -601,5 +743,5 @@ type CitationOfType<T extends CitationType> = Extract<Citation, {
 */
 type ExtractorMap = { [K in FullCitationType]: CitationOfType<K> };
 //#endregion
-export { PinciteInfo as A, StatuteCitation as C, Warning as D, SupraCitation as E, Span as O, 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, parsePincite as j, TransformationMap 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 };
-//# sourceMappingURL=citation-Cp0M8pGK.d.cts.map
+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-CCExUh08.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"citation-CCExUh08.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-GF9_w_kw.d.mts → citation-DEZNY4qH.d.cts}

@@ -107,6 +107,130 @@ interface TransformationMap {
   /** Compressed segment-based clean→original mapping for O(log k) lookup */
   cleanToOriginalSegments?: SegmentMap;
 }
+/**
+* Build a Span for a regex capture group using match.indices (ES2022 `d` flag).
+*
+* Requires the regex to have the `d` flag so match.indices is populated.
+* The indices are relative to the token text — tokenCleanStart translates
+* them to document-level clean-text positions, then resolveOriginalSpan
+* maps to original positions via TransformationMap.
+*
+* @param tokenCleanStart - The token's cleanStart position in the document
+* @param indices - match.indices[n] for the capture group: [start, end]
+* @param map - TransformationMap for clean→original resolution
+* @returns Span with both clean and original coordinates
+*/
+declare function spanFromGroupIndex(tokenCleanStart: number, indices: [number, number], map: TransformationMap): Span;
+//#endregion
+//#region src/types/componentSpans.d.ts
+/**
+* Component spans for case citations (type: "case").
+*
+* Containment: when both `metadataParenthetical` and `court`/`year` are present,
+* `court` and `year` are sub-ranges within `metadataParenthetical`. Consumers
+* rendering highlights should use either the parent or child spans, not both.
+*/
+interface CaseComponentSpans {
+  caseName?: Span;
+  plaintiff?: Span;
+  defendant?: Span;
+  volume?: Span;
+  reporter?: Span;
+  page?: Span;
+  pincite?: Span;
+  court?: Span;
+  year?: Span;
+  signal?: Span;
+  metadataParenthetical?: Span;
+}
+/**
+* Component spans for statute citations (type: "statute").
+*
+* Note: `signal` is included for future extensibility but is currently only
+* populated for case citations.
+*/
+interface StatuteComponentSpans {
+  title?: Span;
+  code?: Span;
+  section?: Span;
+  subsection?: Span;
+  signal?: Span;
+}
+/**
+* Component spans for constitutional citations (type: "constitutional").
+*
+* Note: `signal` is included for future extensibility but is currently only
+* populated for case citations.
+*/
+interface ConstitutionalComponentSpans {
+  jurisdiction?: Span;
+  article?: Span;
+  amendment?: Span;
+  section?: Span;
+  clause?: Span;
+  signal?: Span;
+}
+/**
+* Component spans for journal citations (type: "journal").
+*
+* Note: `signal` is included for future extensibility but is currently only
+* populated for case citations.
+*/
+interface JournalComponentSpans {
+  volume?: Span;
+  journal?: Span;
+  page?: Span;
+  pincite?: Span;
+  year?: Span;
+  signal?: Span;
+}
+/**
+* Component spans for neutral citations (type: "neutral").
+*
+* Note: `signal` is included for future extensibility but is currently only
+* populated for case citations.
+*/
+interface NeutralComponentSpans {
+  year?: Span;
+  court?: Span;
+  documentNumber?: Span;
+  signal?: Span;
+}
+/**
+* Component spans for public law citations (type: "publicLaw").
+*
+* Note: `signal` is included for future extensibility but is currently only
+* populated for case citations.
+*/
+interface PublicLawComponentSpans {
+  congress?: Span;
+  lawNumber?: Span;
+  signal?: Span;
+}
+/**
+* Component spans for federal register citations (type: "federalRegister").
+*
+* Note: `signal` is included for future extensibility but is currently only
+* populated for case citations.
+*/
+interface FederalRegisterComponentSpans {
+  volume?: Span;
+  page?: Span;
+  year?: Span;
+  signal?: Span;
+}
+/**
+* Component spans for statutes at large citations (type: "statutesAtLarge").
+*
+* Note: `signal` is included for future extensibility but is currently only
+* populated for case citations.
+*/
+interface StatutesAtLargeComponentSpans {
+  volume?: Span;
+  page?: Span;
+  year?: Span;
+  signal?: Span;
+}
 //#endregion
 //#region src/types/citation.d.ts
 /**
@@ -204,6 +328,8 @@ interface Parenthetical {
   text: string;
   /** Signal-word classification based on leading gerund */
   type: ParentheticalType;
+  /** Position of full parenthetical block including delimiters */
+  span?: Span;
 }
 /**
 * Normalized subsequent history signal classification.
@@ -383,6 +509,8 @@ interface FullCaseCitation extends CitationBase {
   * to preserve tree-shaking of the `eyecite-ts/data` entry point.
   */
   inferredCourt?: CourtInference;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: CaseComponentSpans;
 }
 /**
 * Statute citation (U.S. Code, state codes, etc.).
@@ -407,6 +535,8 @@ interface StatuteCitation extends CitationBase {
   pincite?: string;
   /** True when "et seq." follows the citation */
   hasEtSeq?: boolean;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: StatuteComponentSpans;
 }
 /**
 * Journal citation (law review, legal periodical).
@@ -434,6 +564,8 @@ interface JournalCitation extends CitationBase {
   pincite?: number;
   /** Publication year */
   year?: number;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: JournalComponentSpans;
 }
 /**
 * Neutral citation (vendor-neutral format).
@@ -451,6 +583,8 @@ interface NeutralCitation extends CitationBase {
   court: string;
   /** Document number */
   documentNumber: string;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: NeutralComponentSpans;
 }
 /**
 * Public law citation (federal legislation).
@@ -468,6 +602,8 @@ interface PublicLawCitation extends CitationBase {
   lawNumber: number;
   /** Optional bill title extracted from nearby text */
   title?: string;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: PublicLawComponentSpans;
 }
 /**
 * Federal Register citation.
@@ -485,6 +621,8 @@ interface FederalRegisterCitation extends CitationBase {
   page: number;
   /** Publication year (if extracted) */
   year?: number;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: FederalRegisterComponentSpans;
 }
 /** Citation to the Statutes at Large (session law compilation) */
 interface StatutesAtLargeCitation extends CitationBase {
@@ -495,6 +633,8 @@ interface StatutesAtLargeCitation extends CitationBase {
   page: number;
   /** Publication year (if extracted) */
   year?: number;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: StatutesAtLargeComponentSpans;
 }
 /**
 * Constitutional citation (U.S. or state constitution).
@@ -515,6 +655,8 @@ interface ConstitutionalCitation extends CitationBase {
   section?: string;
   /** Clause number (always numeric) */
   clause?: number;
+  /** Precise text positions for each parsed component of this citation. */
+  spans?: ConstitutionalComponentSpans;
 }
 /**
 * Id. citation (refers to immediately preceding citation).
@@ -601,5 +743,5 @@ type CitationOfType<T extends CitationType> = Extract<Citation, {
 */
 type ExtractorMap = { [K in FullCitationType]: CitationOfType<K> };
 //#endregion
-export { PinciteInfo as A, StatuteCitation as C, Warning as D, SupraCitation as E, Span as O, 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, parsePincite as j, TransformationMap 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 };
-//# sourceMappingURL=citation-GF9_w_kw.d.mts.map
+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-DEZNY4qH.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"citation-DEZNY4qH.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/data/index.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../knownCodes-DBWj7s2T.cjs`);async function t(){let t=e.a();if(t)return t;let n=await import(`../../data/reporters.json`,{assert:{type:`json`}}),r=new Map,i=[],a=n.default||n;for(let[e,t]of Object.entries(a))for(let e of t){i.push(e);for(let t of Object.keys(e.editions)){let n=t.toLowerCase();r.has(n)||r.set(n,[]),r.get(n)?.push(e)}for(let[t,n]of Object.entries(e.variations||{})){let n=t.toLowerCase();r.has(n)||r.set(n,[]),r.get(n)?.push(e)}}let o={byAbbreviation:r,all:i};return e.o(o),o}function n(){return e.a()}async function r(e){return(await t()).byAbbreviation.get(e.toLowerCase())??[]}exports.abbreviatedCodes=e.t,exports.findAbbreviatedCode=e.n,exports.findNamedCode=e.r,exports.findReportersByAbbreviation=r,exports.getReportersSync=n,exports.loadReporters=t,exports.namedCodes=e.i;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../knownCodes-D_EXxDqq.cjs`);async function t(){let t=e.s();if(t)return t;let n=await import(`../../data/reporters.json`,{assert:{type:`json`}}),r=new Map,i=[],a=n.default||n;for(let[e,t]of Object.entries(a))for(let e of t){i.push(e);for(let t of Object.keys(e.editions)){let n=t.toLowerCase();r.has(n)||r.set(n,[]),r.get(n)?.push(e)}for(let[t,n]of Object.entries(e.variations||{})){let n=t.toLowerCase();r.has(n)||r.set(n,[]),r.get(n)?.push(e)}}let o={byAbbreviation:r,all:i};return e.c(o),o}function n(){return e.s()}async function r(e){return(await t()).byAbbreviation.get(e.toLowerCase())??[]}exports.abbreviatedCodes=e.t,exports.findAbbreviatedCode=e.n,exports.findNamedCode=e.r,exports.findReportersByAbbreviation=r,exports.getReportersSync=n,exports.loadReporters=t,exports.namedCodes=e.i,exports.stateStatuteEntries=e.o;
 //# sourceMappingURL=index.cjs.map

package/dist/data/index.d.cts

@@ -1,12 +1,5 @@
 //#region src/data/knownCodes.d.ts
 /**
-* Known statutory code registry for abbreviated-code jurisdictions
-*
-* Provides a registry of state statutory codes that use abbreviated
-* citation forms (e.g., "R.C. § 1.01", "MCL 750.83"). Used by the
-* citation extractor to identify and normalize state statute citations.
-*/
-/**
 * A single entry in the known codes registry.
 *
 * PA has two entries (Pa.C.S. and P.S.) because it has two distinct
@@ -24,14 +17,12 @@ interface CodeEntry {
 }
 /**
 * Registry of state statutory codes that use abbreviated citation forms.
+* Derived from stateStatuteEntries — the single source of truth.
 *
-* Covers 12 jurisdictions. Pennsylvania has two entries because it
-* maintains two distinct code families (Pa.C.S. and P.S.).
-*
-* Note: Short 2-letter patterns (GS, IC, PS, RC, FS) may produce false positives
-* in non-legal text (e.g., "GS 5" for government service grade). The extraction
-* layer mitigates this via confidence scoring — citations without a § symbol receive
-* lower confidence (0.85 vs 0.95). Consumers should filter by confidence threshold.
+* Note: Short 2-letter patterns (AS, GS, IC, OS, PS, RC, FS, WS) may produce
+* false positives in non-legal text. The extraction layer mitigates this via
+* confidence scoring — citations without a § symbol receive lower confidence
+* (0.85 vs 0.95). Consumers should filter by confidence threshold.
 */
 declare const abbreviatedCodes: CodeEntry[];
 /**
@@ -202,5 +193,28 @@ declare function getReportersSync(): ReportersDatabase | null;
 */
 declare function findReportersByAbbreviation(abbr: string): Promise<ReporterEntry[]>;
 //#endregion
-export { CodeEntry, ReporterEdition, ReporterEntry, ReportersDatabase, abbreviatedCodes, findAbbreviatedCode, findNamedCode, findReportersByAbbreviation, getReportersSync, loadReporters, namedCodes };
+//#region src/data/stateStatutes.d.ts
+/**
+* State statute abbreviation table — single source of truth for the
+* abbreviated-code tokenizer pattern and the knownCodes lookup registry.
+*/
+interface StateStatuteEntry {
+  /** Two-letter jurisdiction code (e.g., "AK", "AZ") */
+  jurisdiction: string;
+  /** All recognized abbreviation forms — used for lookup by findAbbreviatedCode */
+  abbreviations: string[];
+  /**
+  * Regex fragment for tokenizer alternation. If omitted, auto-generated
+  * from abbreviations via escapeForRegex. Provide explicitly when the
+  * pattern needs optional components (e.g., "Stat(?:utes)?").
+  */
+  regexFragment?: string;
+}
+/**
+* Abbreviations are ordered longest-first within each entry. The last element
+* is used as the canonical short abbreviation in knownCodes.ts.
+*/
+declare const stateStatuteEntries: StateStatuteEntry[];
+//#endregion
+export { CodeEntry, ReporterEdition, ReporterEntry, ReportersDatabase, type StateStatuteEntry, abbreviatedCodes, findAbbreviatedCode, findNamedCode, findReportersByAbbreviation, getReportersSync, loadReporters, namedCodes, stateStatuteEntries };
 //# sourceMappingURL=index.d.cts.map

package/dist/data/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/data/knownCodes.ts","../../src/data/reporters.ts"],"mappings":";;AAcA;;;;;;;;;;AAsBA;;UAtBiB,SAAA;EAsBc;EApB7B,YAAA;EAqIF;EAnIE,YAAA;;EAEA,QAAA;EAiIuB;EA/HvB,MAAA;AAAA;;;;;;;;AAs6BF;;;;cAx5Ba,gBAAA,EAAkB,SAAA;;;;ACd/B;;;;;AAgBA;;;;;;;cD+Ga,UAAA,EAAY,SAAA;;;;;;;;;;;;;ACxFzB;;;;;;;iBDi0BgB,aAAA,CAAc,YAAA,UAAsB,QAAA,WAAmB,SAAA;;;;;;;;ACzyBvE;;;;;AA6DA;;;;iBD0yBgB,mBAAA,CAAoB,UAAA,WAAqB,SAAA;;;;AA96BzD;;;;;;;;;;AAsBA;;;;;AAiHA;;;;;AAAA,UC/HiB,eAAA;EDw2BD;ECt2Bd,KAAA;EDs2BqE;ECp2BrE,GAAA;AAAA;;;;ADk6BF;;;;;;UCt5BiB,aAAA;;EAEf,IAAA;EAlBe;EAoBf,SAAA;EApBe;EAsBf,QAAA,EAAU,MAAA,SAAe,eAAA;EAN3B;EAQE,UAAA,GAAa,MAAA;;EAEb,gBAAA;;EAEA,SAAA;;EAEA,KAAA;AAAA;;;;;;;UASe,iBAAA;;EAEf,cAAA,EAAgB,GAAA,SAAY,aAAA;;EAE5B,GAAA,EAAK,aAAA;AAAA;;;;;;;;;;;;;iBAoBe,aAAA,CAAA,GAAiB,OAAA,CAAQ,iBAAA;;AAA/C;;;;;AA6DA;;;;;AAqBA;;;;;iBArBgB,gBAAA,CAAA,GAAoB,iBAAA;;;;;;;;;;;;;;;;;;iBAqBd,2BAAA,CAA4B,IAAA,WAAe,OAAA,CAAQ,aAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/data/knownCodes.ts","../../src/data/reporters.ts","../../src/data/stateStatutes.ts"],"mappings":";;AAgBA;;;;;UAAiB,SAAA;;EAEf,YAAA;;EAEA,YAAA;EAgBF;EAdE,QAAA;;EAEA,MAAA;AAAA;AAkCF;;;;;AAyuBA;;;;AAzuBA,cAtBa,gBAAA,EAAkB,SAAA;;;;;AA6zB/B;;;;;;;;AC30BA;;;cDoCa,UAAA,EAAY,SAAA;;ACpBzB;;;;;;;;;;;;;;;;;;iBD6vBgB,aAAA,CAAc,YAAA,UAAsB,QAAA,WAAmB,SAAA;;ACtuBvE;;;;;;;;;;;;;;;iBDoyBgB,mBAAA,CAAoB,UAAA,WAAqB,SAAA;;;;AAj1BzD;;;;;;;;;;AAoBA;;;;;AAsBA;;;;;AAAA,UCpCiB,eAAA;ED6wBD;EC3wBd,KAAA;ED2wBqE;ECzwBrE,GAAA;AAAA;;;;ADu0BF;;;;;;UC3zBiB,aAAA;;EAEf,IAAA;EAlBe;EAoBf,SAAA;EApBe;EAsBf,QAAA,EAAU,MAAA,SAAe,eAAA;EAN3B;EAQE,UAAA,GAAa,MAAA;;EAEb,gBAAA;;EAEA,SAAA;;EAEA,KAAA;AAAA;;;;;;;UASe,iBAAA;;EAEf,cAAA,EAAgB,GAAA,SAAY,aAAA;;EAE5B,GAAA,EAAK,aAAA;AAAA;;;;;;;;;;;;;iBAoBe,aAAA,CAAA,GAAiB,OAAA,CAAQ,iBAAA;;AAA/C;;;;;AA6DA;;;;;AAqBA;;;;;iBArBgB,gBAAA,CAAA,GAAoB,iBAAA;;;;;;;AC7IpC;;;;;;;;;AA6EA;;iBDqFsB,2BAAA,CAA4B,IAAA,WAAe,OAAA,CAAQ,aAAA;;;;ADvJzE;;;UEXiB,iBAAA;;EAEf,YAAA;;EAEA,aAAA;;;AF2BF;;;EErBE,aAAA;AAAA;ADOF;;;;AAAA,cC4Da,mBAAA,EAAqB,iBAAA"}

package/dist/data/index.d.mts

@@ -1,12 +1,5 @@
 //#region src/data/knownCodes.d.ts
 /**
-* Known statutory code registry for abbreviated-code jurisdictions
-*
-* Provides a registry of state statutory codes that use abbreviated
-* citation forms (e.g., "R.C. § 1.01", "MCL 750.83"). Used by the
-* citation extractor to identify and normalize state statute citations.
-*/
-/**
 * A single entry in the known codes registry.
 *
 * PA has two entries (Pa.C.S. and P.S.) because it has two distinct
@@ -24,14 +17,12 @@ interface CodeEntry {
 }
 /**
 * Registry of state statutory codes that use abbreviated citation forms.
+* Derived from stateStatuteEntries — the single source of truth.
 *
-* Covers 12 jurisdictions. Pennsylvania has two entries because it
-* maintains two distinct code families (Pa.C.S. and P.S.).
-*
-* Note: Short 2-letter patterns (GS, IC, PS, RC, FS) may produce false positives
-* in non-legal text (e.g., "GS 5" for government service grade). The extraction
-* layer mitigates this via confidence scoring — citations without a § symbol receive
-* lower confidence (0.85 vs 0.95). Consumers should filter by confidence threshold.
+* Note: Short 2-letter patterns (AS, GS, IC, OS, PS, RC, FS, WS) may produce
+* false positives in non-legal text. The extraction layer mitigates this via
+* confidence scoring — citations without a § symbol receive lower confidence
+* (0.85 vs 0.95). Consumers should filter by confidence threshold.
 */
 declare const abbreviatedCodes: CodeEntry[];
 /**
@@ -202,5 +193,28 @@ declare function getReportersSync(): ReportersDatabase | null;
 */
 declare function findReportersByAbbreviation(abbr: string): Promise<ReporterEntry[]>;
 //#endregion
-export { CodeEntry, ReporterEdition, ReporterEntry, ReportersDatabase, abbreviatedCodes, findAbbreviatedCode, findNamedCode, findReportersByAbbreviation, getReportersSync, loadReporters, namedCodes };
+//#region src/data/stateStatutes.d.ts
+/**
+* State statute abbreviation table — single source of truth for the
+* abbreviated-code tokenizer pattern and the knownCodes lookup registry.
+*/
+interface StateStatuteEntry {
+  /** Two-letter jurisdiction code (e.g., "AK", "AZ") */
+  jurisdiction: string;
+  /** All recognized abbreviation forms — used for lookup by findAbbreviatedCode */
+  abbreviations: string[];
+  /**
+  * Regex fragment for tokenizer alternation. If omitted, auto-generated
+  * from abbreviations via escapeForRegex. Provide explicitly when the
+  * pattern needs optional components (e.g., "Stat(?:utes)?").
+  */
+  regexFragment?: string;
+}
+/**
+* Abbreviations are ordered longest-first within each entry. The last element
+* is used as the canonical short abbreviation in knownCodes.ts.
+*/
+declare const stateStatuteEntries: StateStatuteEntry[];
+//#endregion
+export { CodeEntry, ReporterEdition, ReporterEntry, ReportersDatabase, type StateStatuteEntry, abbreviatedCodes, findAbbreviatedCode, findNamedCode, findReportersByAbbreviation, getReportersSync, loadReporters, namedCodes, stateStatuteEntries };
 //# sourceMappingURL=index.d.mts.map

package/dist/data/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/data/knownCodes.ts","../../src/data/reporters.ts"],"mappings":";;AAcA;;;;;;;;;;AAsBA;;UAtBiB,SAAA;EAsBc;EApB7B,YAAA;EAqIF;EAnIE,YAAA;;EAEA,QAAA;EAiIuB;EA/HvB,MAAA;AAAA;;;;;;;;AAs6BF;;;;cAx5Ba,gBAAA,EAAkB,SAAA;;;;ACd/B;;;;;AAgBA;;;;;;;cD+Ga,UAAA,EAAY,SAAA;;;;;;;;;;;;;ACxFzB;;;;;;;iBDi0BgB,aAAA,CAAc,YAAA,UAAsB,QAAA,WAAmB,SAAA;;;;;;;;ACzyBvE;;;;;AA6DA;;;;iBD0yBgB,mBAAA,CAAoB,UAAA,WAAqB,SAAA;;;;AA96BzD;;;;;;;;;;AAsBA;;;;;AAiHA;;;;;AAAA,UC/HiB,eAAA;EDw2BD;ECt2Bd,KAAA;EDs2BqE;ECp2BrE,GAAA;AAAA;;;;ADk6BF;;;;;;UCt5BiB,aAAA;;EAEf,IAAA;EAlBe;EAoBf,SAAA;EApBe;EAsBf,QAAA,EAAU,MAAA,SAAe,eAAA;EAN3B;EAQE,UAAA,GAAa,MAAA;;EAEb,gBAAA;;EAEA,SAAA;;EAEA,KAAA;AAAA;;;;;;;UASe,iBAAA;;EAEf,cAAA,EAAgB,GAAA,SAAY,aAAA;;EAE5B,GAAA,EAAK,aAAA;AAAA;;;;;;;;;;;;;iBAoBe,aAAA,CAAA,GAAiB,OAAA,CAAQ,iBAAA;;AAA/C;;;;;AA6DA;;;;;AAqBA;;;;;iBArBgB,gBAAA,CAAA,GAAoB,iBAAA;;;;;;;;;;;;;;;;;;iBAqBd,2BAAA,CAA4B,IAAA,WAAe,OAAA,CAAQ,aAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/data/knownCodes.ts","../../src/data/reporters.ts","../../src/data/stateStatutes.ts"],"mappings":";;AAgBA;;;;;UAAiB,SAAA;;EAEf,YAAA;;EAEA,YAAA;EAgBF;EAdE,QAAA;;EAEA,MAAA;AAAA;AAkCF;;;;;AAyuBA;;;;AAzuBA,cAtBa,gBAAA,EAAkB,SAAA;;;;;AA6zB/B;;;;;;;;AC30BA;;;cDoCa,UAAA,EAAY,SAAA;;ACpBzB;;;;;;;;;;;;;;;;;;iBD6vBgB,aAAA,CAAc,YAAA,UAAsB,QAAA,WAAmB,SAAA;;ACtuBvE;;;;;;;;;;;;;;;iBDoyBgB,mBAAA,CAAoB,UAAA,WAAqB,SAAA;;;;AAj1BzD;;;;;;;;;;AAoBA;;;;;AAsBA;;;;;AAAA,UCpCiB,eAAA;ED6wBD;EC3wBd,KAAA;ED2wBqE;ECzwBrE,GAAA;AAAA;;;;ADu0BF;;;;;;UC3zBiB,aAAA;;EAEf,IAAA;EAlBe;EAoBf,SAAA;EApBe;EAsBf,QAAA,EAAU,MAAA,SAAe,eAAA;EAN3B;EAQE,UAAA,GAAa,MAAA;;EAEb,gBAAA;;EAEA,SAAA;;EAEA,KAAA;AAAA;;;;;;;UASe,iBAAA;;EAEf,cAAA,EAAgB,GAAA,SAAY,aAAA;;EAE5B,GAAA,EAAK,aAAA;AAAA;;;;;;;;;;;;;iBAoBe,aAAA,CAAA,GAAiB,OAAA,CAAQ,iBAAA;;AAA/C;;;;;AA6DA;;;;;AAqBA;;;;;iBArBgB,gBAAA,CAAA,GAAoB,iBAAA;;;;;;;AC7IpC;;;;;;;;;AA6EA;;iBDqFsB,2BAAA,CAA4B,IAAA,WAAe,OAAA,CAAQ,aAAA;;;;ADvJzE;;;UEXiB,iBAAA;;EAEf,YAAA;;EAEA,aAAA;;;AF2BF;;;EErBE,aAAA;AAAA;ADOF;;;;AAAA,cC4Da,mBAAA,EAAqB,iBAAA"}

package/dist/data/index.mjs

@@ -1,2 +1,2 @@
-import{a as e,i as t,n,o as r,r as i,t as a}from"../knownCodes-DTkb3Uw9.mjs";async function o(){let t=e();if(t)return t;let n=await import(`../../data/reporters.json`,{assert:{type:`json`}}),i=new Map,a=[],o=n.default||n;for(let[e,t]of Object.entries(o))for(let e of t){a.push(e);for(let t of Object.keys(e.editions)){let n=t.toLowerCase();i.has(n)||i.set(n,[]),i.get(n)?.push(e)}for(let[t,n]of Object.entries(e.variations||{})){let n=t.toLowerCase();i.has(n)||i.set(n,[]),i.get(n)?.push(e)}}let s={byAbbreviation:i,all:a};return r(s),s}function s(){return e()}async function c(e){return(await o()).byAbbreviation.get(e.toLowerCase())??[]}export{a as abbreviatedCodes,n as findAbbreviatedCode,i as findNamedCode,c as findReportersByAbbreviation,s as getReportersSync,o as loadReporters,t as namedCodes};
+import{c as e,i as t,n,o as r,r as i,s as a,t as o}from"../knownCodes-WUweUwCB.mjs";async function s(){let t=a();if(t)return t;let n=await import(`../../data/reporters.json`,{assert:{type:`json`}}),r=new Map,i=[],o=n.default||n;for(let[e,t]of Object.entries(o))for(let e of t){i.push(e);for(let t of Object.keys(e.editions)){let n=t.toLowerCase();r.has(n)||r.set(n,[]),r.get(n)?.push(e)}for(let[t,n]of Object.entries(e.variations||{})){let n=t.toLowerCase();r.has(n)||r.set(n,[]),r.get(n)?.push(e)}}let s={byAbbreviation:r,all:i};return e(s),s}function c(){return a()}async function l(e){return(await s()).byAbbreviation.get(e.toLowerCase())??[]}export{o as abbreviatedCodes,n as findAbbreviatedCode,i as findNamedCode,l as findReportersByAbbreviation,c as getReportersSync,s as loadReporters,t as namedCodes,r as stateStatuteEntries};
 //# sourceMappingURL=index.mjs.map