eyecite-ts 0.29.1 → 0.30.0

package/dist/index.d.cts

@@ -1,11 +1,12 @@
-import { A as SubsequentHistoryEntry, B as NeutralComponentSpans, C as RegulationCitation, D as ShortFormCitationType, E as ShortFormCitation, F as CaseComponentSpans, G as TreatiseComponentSpans, H as RestatementComponentSpans, I as ConstitutionalComponentSpans, J as spanFromGroupIndex, K as Span, L as FederalRegisterComponentSpans, M as TreatiseCitation, N as Warning, O as StatuteCitation, P as AnnotationComponentSpans, R as FederalRuleComponentSpans, S as PublicLawCitation, T as ShortFormCaseCitation, U as StatuteComponentSpans, V as PublicLawComponentSpans, W as StatutesAtLargeComponentSpans, X as parsePincite, Y as PinciteInfo, _ as IdCitation, a as CitationSignal, b as Parenthetical, c as CourtInference, d as FederalRegisterCitation, f as FederalRuleCitation, g as HistorySignal, h as FullCitationType, i as CitationOfType, j as SupraCitation, k as StatutesAtLargeCitation, l as DocketCitation, m as FullCitation, n as Citation, o as CitationType, p as FullCaseCitation, q as TransformationMap, r as CitationBase, s as ConstitutionalCitation, t as AnnotationCitation, u as ExtractorMap, v as JournalCitation, w as RestatementCitation, x as ParentheticalType, y as NeutralCitation, z as JournalComponentSpans } from "./citation-CsWsvkxB.cjs";
-import { a as FootnoteMap, i as ScopeStrategy, n as ResolutionResult, o as FootnoteZone, r as ResolvedCitation, t as ResolutionOptions } from "./types-DXnfQIbk.cjs";
+import { A as StatutesAtLargeCitation, B as JournalComponentSpans, C as PublicLawCitation, D as ShortFormCitation, E as ShortFormCaseCitation, F as AnnotationComponentSpans, G as StatutesAtLargeComponentSpans, H as PublicLawComponentSpans, I as CaseComponentSpans, J as TransformationMap, K as TreatiseComponentSpans, L as ConstitutionalComponentSpans, M as SupraCitation, N as TreatiseCitation, O as ShortFormCitationType, P as Warning, R as FederalRegisterComponentSpans, S as ParentheticalType, T as RestatementCitation, U as RestatementComponentSpans, V as NeutralComponentSpans, W as StatuteComponentSpans, X as PinciteInfo, Y as spanFromGroupIndex, Z as parsePincite, _ as HistorySignal, a as CitationOfType, b as NeutralCitation, c as ConstitutionalCitation, d as ExtractorMap, f as FederalRegisterCitation, g as FullCitationType, h as FullCitation, i as CitationId, j as SubsequentHistoryEntry, k as StatuteCitation, l as CourtInference, m as FullCaseCitation, n as Citation, o as CitationSignal, p as FederalRuleCitation, q as Span, r as CitationBase, s as CitationType, t as AnnotationCitation, u as DocketCitation, v as IdCitation, w as RegulationCitation, x as Parenthetical, y as JournalCitation, z as FederalRuleComponentSpans } from "./citation-t5DPIzyE.cjs";
+import { a as FootnoteMap, i as ScopeStrategy, n as ResolutionResult, o as FootnoteZone, r as ResolvedCitation, t as ResolutionOptions } from "./types-D961u5ik.cjs";
 
 //#region src/types/guards.d.ts
 /**
-* Type guard: narrows Citation to a full citation (case, statute, journal,
-* neutral, publicLaw, federalRegister, statutesAtLarge, constitutional,
-* federalRule, restatement, treatise, annotation).
+* Type guard: narrows Citation to a full citation — any member of
+* `FullCitationType`. Membership derives from `FULL_CITATION_TYPES` (the single
+* source), so it can never silently omit a full type the way it once dropped
+* `regulation` / `stateRule` (#843).
 */
 declare function isFullCitation(citation: Citation): citation is FullCitation;
 /**
@@ -68,6 +69,21 @@ interface ExtractOptions {
   */
   cleaners?: Array<(text: string) => string>;
   /**
+  * Extra cleaners appended AFTER the effective base chain (the defaults, or a
+  * custom `cleaners` array). Unlike `cleaners` — which REPLACES the defaults —
+  * `additionalCleaners` keeps them, so you can add e.g. `stripMarkdownEmphasis`
+  * without silently dropping HTML stripping, whitespace/Unicode normalization,
+  * smart-quote fixing, reporter spacing, etc. (#835)
+  *
+  * @example
+  * ```typescript
+  * import { extractCitations, stripMarkdownEmphasis } from "eyecite-ts"
+  * // markdown legal text: keep all defaults, also strip *emphasis*
+  * extractCitations(markdownText, { additionalCleaners: [stripMarkdownEmphasis] })
+  * ```
+  */
+  additionalCleaners?: Array<(text: string) => string>;
+  /**
   * Custom regex patterns (overrides defaults).
   *
   * If provided, these patterns replace the default pattern set:
@@ -226,6 +242,15 @@ declare function extractCitationsAsync(text: string, options: ExtractOptions & {
 }): Promise<ResolvedCitation[]>;
 declare function extractCitationsAsync(text: string, options?: ExtractOptions): Promise<Citation[]>;
 //#endregion
+//#region src/extract/assignCitationIds.d.ts
+/**
+* Build a lookup from {@link CitationId} to its citation. Citations without an
+* id (e.g. produced by the granular per-type extractors rather than by
+* `extractCitations()`) are skipped. The map keys by stable id, so it keeps
+* working after the caller has `filter`/`sort`/`map`-ed the array.
+*/
+declare function byId(citations: Citation[]): Map<CitationId, Citation>;
+//#endregion
 //#region src/extract/filterFalsePositives.d.ts
 /**
 * Apply false positive filters to extracted citations.
@@ -248,6 +273,31 @@ declare function extractCitationsAsync(text: string, options?: ExtractOptions):
 */
 declare function applyFalsePositiveFilters(citations: Citation[], remove: boolean, originalText?: string): Citation[];
 //#endregion
+//#region src/clean/cleaners.d.ts
+/**
+* Strip markdown emphasis markers (`*italic*`, `**bold**`, `***both***`) while
+* keeping the emphasized text. For markdown legal text (e.g. LLM-drafted briefs
+* where case names are emphasized: `*Leon v. Martinez*`), whose asterisks
+* otherwise break case-name capture / `fullSpan`.
+*
+* Deliberately conservative so it never corrupts citations:
+* - Star-pagination pincites are preserved (`at *3` \u2014 an asterisk followed by a
+*   digit, or with no closing `*`, never matches).
+* - Underscores are never touched (`_x_`, and blank locators like `[____]`).
+* - Lone or space-flanked asterisks (`a * b`) and backslash-escaped pairs
+*   (`\*x\*`) are left alone.
+*
+* NOT in the default pipeline \u2014 pass it via `additionalCleaners` (recommended;
+* keeps the defaults) or `cleaners`. It changes length; position tracking is
+* handled by `cleanText`'s TransformationMap. Each pattern uses a single bounded
+* quantifier (ReDoS-safe). (#835)
+*
+* @example
+* stripMarkdownEmphasis("see *Leon v. Martinez*, 84 N.Y.2d 83")
+* // => "see Leon v. Martinez, 84 N.Y.2d 83"
+*/
+declare function stripMarkdownEmphasis(text: string): string;
+//#endregion
 //#region src/clean/cleanText.d.ts
 /**
 * Result of text cleaning operation.
@@ -268,7 +318,8 @@ interface CleanTextResult {
 * cleaned text while reporting positions in the original text.
 *
 * @param original - Original input text
-* @param cleaners - Array of cleaner functions to apply (default: stripHtmlTags, decodeHtmlEntities, normalizeWhitespace, normalizeUnicode, normalizeDashes, fixSmartQuotes, normalizeTypography, normalizeReporterSpacing)
+* @param cleaners - Array of cleaner functions to apply (default: stripHtmlTags, decodeHtmlEntities, normalizeWhitespace, normalizeUnicode, normalizeDashes, fixSmartQuotes, normalizeTypography, normalizeReporterSpacing). Passing a custom array REPLACES the defaults.
+* @param additionalCleaners - Cleaners appended AFTER the effective base chain (the defaults, or a custom `cleaners` array). Use this to add a cleaner — e.g. `stripMarkdownEmphasis` — without dropping the defaults (#835).
 * @returns Cleaned text with position mappings and warnings
 *
 * @example
@@ -276,7 +327,7 @@ interface CleanTextResult {
 * // result.cleaned: "Smith v. Doe, 500 F.2d 123"
 * // result.transformationMap tracks position shifts from HTML removal
 */
-declare function cleanText(original: string, cleaners?: Array<(text: string) => string>): CleanTextResult;
+declare function cleanText(original: string, cleaners?: Array<(text: string) => string>, additionalCleaners?: Array<(text: string) => string>): CleanTextResult;
 //#endregion
 //#region src/tokenize/tokenizer.d.ts
 /**
@@ -624,13 +675,26 @@ declare function normalizeCourt(court: string | undefined): string | undefined;
 */
 declare class DocumentResolver {
   private readonly citations;
+  /** Original document text — used for original-coordinate reads (quote zones,
+  *  paragraph boundaries, party-name lookback) that locate citations via
+  *  `span.originalStart`. */
   private readonly text;
+  /** Cleaned document text — used for clean-coordinate reads (bracket scopes,
+  *  trigger-anchored asides, family/name windows) that index by
+  *  `span.cleanStart`/`cleanEnd`. Equals `text` when no length-changing cleaner
+  *  ran; diverges from it otherwise, which is the #830 desync this fixes. */
+  private readonly cleanedText;
+  /** Maps clean→original offsets so derived output spans carry correct original
+  *  coordinates even when a cleaner transformed the text (#830). */
+  private readonly transformationMap?;
   private readonly options;
   private readonly context;
   private readonly partyNameTree;
   private readonly quoteZones;
   /** Parenthesis depth at each citation's start (filled lazily by resolve()). */
   private parenDepths;
+  /** Per-citation bracket-balance trust (#809/#820); false = structure unreliable. */
+  private balanceOks;
   /** Resolution results accumulated during the in-flight resolve() pass. */
   private resolutions;
   /** Resolved citations accumulated during the in-flight resolve() pass; used
@@ -640,10 +704,17 @@ declare class DocumentResolver {
   * Creates a new DocumentResolver.
   *
   * @param citations - All citations in document (in order of appearance)
-  * @param text - Original document text
+  * @param text - Original document text (original-coordinate reads index into it)
   * @param options - Resolution options
+  * @param cleanContext - Cleaned text + transformation map for clean-coordinate
+  *   reads (#830). When omitted, `text` is treated as the cleaned text too,
+  *   preserving the historical clean==original behavior for callers that pass
+  *   only one text (e.g. text untouched by a length-changing cleaner).
   */
-  constructor(citations: Citation[], text: string, options?: ResolutionOptions);
+  constructor(citations: Citation[], text: string, options?: ResolutionOptions, cleanContext?: {
+    cleanedText: string;
+    transformationMap: TransformationMap;
+  });
   /**
   * Resolves all citations in the document.
   *
@@ -753,6 +824,22 @@ declare class DocumentResolver {
   */
   private isParentheticalChild;
   /**
+  * Whether the citation's clean span is wholly inside a previously-resolved
+  * citation's `fullSpan` (the #214 strategy-2 signal). Independent of the
+  * fragile bracket-depth count, so it stays a *hard* exclusion even when
+  * balance fails (#820).
+  */
+  private isFullSpanContained;
+  /**
+  * #820: the citation's paren-child status rests ONLY on the (possibly
+  * desynced) bracket depth, in a clause whose brackets did not balance — so the
+  * "nested" verdict is untrustworthy. Trigger-anchored asides and
+  * fullSpan-contained cites are reliable (independent of the depth count) and
+  * stay hard exclusions; only the depth-only case under balance failure is
+  * soft, which `resolveId` keeps as a degraded-confidence candidate.
+  */
+  private isUntrustworthyDepthAside;
+  /**
   * Scans the prose between the previous citation and `Id.` for a case-name
   * mention. If a name is found and doesn't match the picked antecedent's
   * caseName/plaintiff/defendant, returns a downgraded confidence and an
@@ -772,6 +859,15 @@ declare class DocumentResolver {
   * threshold-derived `maxDistance` to recover it.
   */
   private resolveSupra;
+  /**
+  * Apply the #818 hybrid policy to the in-scope authorities a `supra` name key
+  * resolved to. Exactly one → commit at the matched similarity. More than one is
+  * a non-unique key: a *true tie* (same name + same year, indistinguishable by
+  * the key alone) abstains; otherwise pick the most-recent-within-name but cap
+  * confidence and warn, with `idConfidenceFloor` able to fail it closed. Mirrors
+  * the `Id.` path's downgrade-warn-then-floor-abstain shape (#800/#820).
+  */
+  private selectSupraAntecedent;
   private createSupraSuccess;
   /**
   * Match a full-caption supra (`Plaintiff v. Defendant, supra`) against a
@@ -876,9 +972,16 @@ declare class DocumentResolver {
 * @param citations - Extracted citations in order of appearance
 * @param text - Original document text
 * @param options - Resolution options
+* @param cleanContext - Optional cleaned text + transformation map. Pass when a
+*   length-changing cleaner was applied so clean-coordinate reads index the
+*   cleaned text and derived spans map back to original coordinates (#830). When
+*   omitted, `text` is treated as the cleaned text too (clean == original).
 * @returns Citations with resolution metadata
 */
-declare function resolveCitations(citations: Citation[], text: string, options?: ResolutionOptions): ResolvedCitation[];
+declare function resolveCitations(citations: Citation[], text: string, options?: ResolutionOptions, cleanContext?: {
+  cleanedText: string;
+  transformationMap: TransformationMap;
+}): ResolvedCitation[];
 //#endregion
 //#region src/footnotes/detectFootnotes.d.ts
 /**
@@ -1041,5 +1144,5 @@ declare function analyzeDocument(text: string, citations: Citation[], opts?: {
   transformationMap?: TransformationMap;
 }): Document;
 //#endregion
-export { type AnalyzedFootnoteZone, type AnnotationCitation, type AnnotationComponentSpans, 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 FederalRuleCitation, type FederalRuleComponentSpans, 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 RestatementCitation, type RestatementComponentSpans, 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 TreatiseCitation, type TreatiseComponentSpans, type Warning, analyzeDocument, applyFalsePositiveFilters, assertUnreachable, cleanText, detectFootnotes, extractAnnotation, extractCase, extractCitations, extractCitationsAsync, extractConstitutional, extractFederalRegister, extractFederalRule, extractJournal, extractNeutral, extractPublicLaw, extractRestatement, extractStatute, extractStatutesAtLarge, extractTreatise, isCaseCitation, isCitationType, isFullCitation, isShortFormCitation, normalizeCourt, parsePincite, resolveCitations, spanFromGroupIndex, tokenize };
+export { type AnalyzedFootnoteZone, type AnnotationCitation, type AnnotationComponentSpans, type AttributionKind, type CaseComponentSpans, type Citation, type CitationBase, type CitationGraph, type CitationId, 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 FederalRuleCitation, type FederalRuleComponentSpans, 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 RestatementCitation, type RestatementComponentSpans, 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 TreatiseCitation, type TreatiseComponentSpans, type Warning, analyzeDocument, applyFalsePositiveFilters, assertUnreachable, byId, cleanText, detectFootnotes, extractAnnotation, extractCase, extractCitations, extractCitationsAsync, extractConstitutional, extractFederalRegister, extractFederalRule, extractJournal, extractNeutral, extractPublicLaw, extractRestatement, extractStatute, extractStatutesAtLarge, extractTreatise, isCaseCitation, isCitationType, isFullCitation, isShortFormCitation, normalizeCourt, parsePincite, resolveCitations, spanFromGroupIndex, stripMarkdownEmphasis, 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/extractAnnotation.ts","../src/extract/extractCase.ts","../src/extract/extractConstitutional.ts","../src/extract/extractFederalRegister.ts","../src/extract/extractFederalRule.ts","../src/extract/extractJournal.ts","../src/extract/extractNeutral.ts","../src/extract/extractPublicLaw.ts","../src/extract/extractRestatement.ts","../src/extract/extractStatute.ts","../src/extract/extractStatutesAtLarge.ts","../src/extract/extractTreatise.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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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types/guards.ts","../src/patterns/casePatterns.ts","../src/extract/extractCitations.ts","../src/extract/assignCitationIds.ts","../src/extract/filterFalsePositives.ts","../src/clean/cleaners.ts","../src/clean/cleanText.ts","../src/tokenize/tokenizer.ts","../src/extract/extractAnnotation.ts","../src/extract/extractCase.ts","../src/extract/extractConstitutional.ts","../src/extract/extractFederalRegister.ts","../src/extract/extractFederalRule.ts","../src/extract/extractJournal.ts","../src/extract/extractNeutral.ts","../src/extract/extractPublicLaw.ts","../src/extract/extractRestatement.ts","../src/extract/extractStatute.ts","../src/extract/extractStatutesAtLarge.ts","../src/extract/extractTreatise.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

@@ -1,11 +1,12 @@
-import { A as SubsequentHistoryEntry, B as NeutralComponentSpans, C as RegulationCitation, D as ShortFormCitationType, E as ShortFormCitation, F as CaseComponentSpans, G as TreatiseComponentSpans, H as RestatementComponentSpans, I as ConstitutionalComponentSpans, J as spanFromGroupIndex, K as Span, L as FederalRegisterComponentSpans, M as TreatiseCitation, N as Warning, O as StatuteCitation, P as AnnotationComponentSpans, R as FederalRuleComponentSpans, S as PublicLawCitation, T as ShortFormCaseCitation, U as StatuteComponentSpans, V as PublicLawComponentSpans, W as StatutesAtLargeComponentSpans, X as parsePincite, Y as PinciteInfo, _ as IdCitation, a as CitationSignal, b as Parenthetical, c as CourtInference, d as FederalRegisterCitation, f as FederalRuleCitation, g as HistorySignal, h as FullCitationType, i as CitationOfType, j as SupraCitation, k as StatutesAtLargeCitation, l as DocketCitation, m as FullCitation, n as Citation, o as CitationType, p as FullCaseCitation, q as TransformationMap, r as CitationBase, s as ConstitutionalCitation, t as AnnotationCitation, u as ExtractorMap, v as JournalCitation, w as RestatementCitation, x as ParentheticalType, y as NeutralCitation, z as JournalComponentSpans } from "./citation-Dy_8OOzV.mjs";
-import { a as FootnoteMap, i as ScopeStrategy, n as ResolutionResult, o as FootnoteZone, r as ResolvedCitation, t as ResolutionOptions } from "./types-BS607EPW.mjs";
+import { A as StatutesAtLargeCitation, B as JournalComponentSpans, C as PublicLawCitation, D as ShortFormCitation, E as ShortFormCaseCitation, F as AnnotationComponentSpans, G as StatutesAtLargeComponentSpans, H as PublicLawComponentSpans, I as CaseComponentSpans, J as TransformationMap, K as TreatiseComponentSpans, L as ConstitutionalComponentSpans, M as SupraCitation, N as TreatiseCitation, O as ShortFormCitationType, P as Warning, R as FederalRegisterComponentSpans, S as ParentheticalType, T as RestatementCitation, U as RestatementComponentSpans, V as NeutralComponentSpans, W as StatuteComponentSpans, X as PinciteInfo, Y as spanFromGroupIndex, Z as parsePincite, _ as HistorySignal, a as CitationOfType, b as NeutralCitation, c as ConstitutionalCitation, d as ExtractorMap, f as FederalRegisterCitation, g as FullCitationType, h as FullCitation, i as CitationId, j as SubsequentHistoryEntry, k as StatuteCitation, l as CourtInference, m as FullCaseCitation, n as Citation, o as CitationSignal, p as FederalRuleCitation, q as Span, r as CitationBase, s as CitationType, t as AnnotationCitation, u as DocketCitation, v as IdCitation, w as RegulationCitation, x as Parenthetical, y as JournalCitation, z as FederalRuleComponentSpans } from "./citation-Dx71V5wD.mjs";
+import { a as FootnoteMap, i as ScopeStrategy, n as ResolutionResult, o as FootnoteZone, r as ResolvedCitation, t as ResolutionOptions } from "./types-BKg6EJIz.mjs";
 
 //#region src/types/guards.d.ts
 /**
-* Type guard: narrows Citation to a full citation (case, statute, journal,
-* neutral, publicLaw, federalRegister, statutesAtLarge, constitutional,
-* federalRule, restatement, treatise, annotation).
+* Type guard: narrows Citation to a full citation — any member of
+* `FullCitationType`. Membership derives from `FULL_CITATION_TYPES` (the single
+* source), so it can never silently omit a full type the way it once dropped
+* `regulation` / `stateRule` (#843).
 */
 declare function isFullCitation(citation: Citation): citation is FullCitation;
 /**
@@ -68,6 +69,21 @@ interface ExtractOptions {
   */
   cleaners?: Array<(text: string) => string>;
   /**
+  * Extra cleaners appended AFTER the effective base chain (the defaults, or a
+  * custom `cleaners` array). Unlike `cleaners` — which REPLACES the defaults —
+  * `additionalCleaners` keeps them, so you can add e.g. `stripMarkdownEmphasis`
+  * without silently dropping HTML stripping, whitespace/Unicode normalization,
+  * smart-quote fixing, reporter spacing, etc. (#835)
+  *
+  * @example
+  * ```typescript
+  * import { extractCitations, stripMarkdownEmphasis } from "eyecite-ts"
+  * // markdown legal text: keep all defaults, also strip *emphasis*
+  * extractCitations(markdownText, { additionalCleaners: [stripMarkdownEmphasis] })
+  * ```
+  */
+  additionalCleaners?: Array<(text: string) => string>;
+  /**
   * Custom regex patterns (overrides defaults).
   *
   * If provided, these patterns replace the default pattern set:
@@ -226,6 +242,15 @@ declare function extractCitationsAsync(text: string, options: ExtractOptions & {
 }): Promise<ResolvedCitation[]>;
 declare function extractCitationsAsync(text: string, options?: ExtractOptions): Promise<Citation[]>;
 //#endregion
+//#region src/extract/assignCitationIds.d.ts
+/**
+* Build a lookup from {@link CitationId} to its citation. Citations without an
+* id (e.g. produced by the granular per-type extractors rather than by
+* `extractCitations()`) are skipped. The map keys by stable id, so it keeps
+* working after the caller has `filter`/`sort`/`map`-ed the array.
+*/
+declare function byId(citations: Citation[]): Map<CitationId, Citation>;
+//#endregion
 //#region src/extract/filterFalsePositives.d.ts
 /**
 * Apply false positive filters to extracted citations.
@@ -248,6 +273,31 @@ declare function extractCitationsAsync(text: string, options?: ExtractOptions):
 */
 declare function applyFalsePositiveFilters(citations: Citation[], remove: boolean, originalText?: string): Citation[];
 //#endregion
+//#region src/clean/cleaners.d.ts
+/**
+* Strip markdown emphasis markers (`*italic*`, `**bold**`, `***both***`) while
+* keeping the emphasized text. For markdown legal text (e.g. LLM-drafted briefs
+* where case names are emphasized: `*Leon v. Martinez*`), whose asterisks
+* otherwise break case-name capture / `fullSpan`.
+*
+* Deliberately conservative so it never corrupts citations:
+* - Star-pagination pincites are preserved (`at *3` \u2014 an asterisk followed by a
+*   digit, or with no closing `*`, never matches).
+* - Underscores are never touched (`_x_`, and blank locators like `[____]`).
+* - Lone or space-flanked asterisks (`a * b`) and backslash-escaped pairs
+*   (`\*x\*`) are left alone.
+*
+* NOT in the default pipeline \u2014 pass it via `additionalCleaners` (recommended;
+* keeps the defaults) or `cleaners`. It changes length; position tracking is
+* handled by `cleanText`'s TransformationMap. Each pattern uses a single bounded
+* quantifier (ReDoS-safe). (#835)
+*
+* @example
+* stripMarkdownEmphasis("see *Leon v. Martinez*, 84 N.Y.2d 83")
+* // => "see Leon v. Martinez, 84 N.Y.2d 83"
+*/
+declare function stripMarkdownEmphasis(text: string): string;
+//#endregion
 //#region src/clean/cleanText.d.ts
 /**
 * Result of text cleaning operation.
@@ -268,7 +318,8 @@ interface CleanTextResult {
 * cleaned text while reporting positions in the original text.
 *
 * @param original - Original input text
-* @param cleaners - Array of cleaner functions to apply (default: stripHtmlTags, decodeHtmlEntities, normalizeWhitespace, normalizeUnicode, normalizeDashes, fixSmartQuotes, normalizeTypography, normalizeReporterSpacing)
+* @param cleaners - Array of cleaner functions to apply (default: stripHtmlTags, decodeHtmlEntities, normalizeWhitespace, normalizeUnicode, normalizeDashes, fixSmartQuotes, normalizeTypography, normalizeReporterSpacing). Passing a custom array REPLACES the defaults.
+* @param additionalCleaners - Cleaners appended AFTER the effective base chain (the defaults, or a custom `cleaners` array). Use this to add a cleaner — e.g. `stripMarkdownEmphasis` — without dropping the defaults (#835).
 * @returns Cleaned text with position mappings and warnings
 *
 * @example
@@ -276,7 +327,7 @@ interface CleanTextResult {
 * // result.cleaned: "Smith v. Doe, 500 F.2d 123"
 * // result.transformationMap tracks position shifts from HTML removal
 */
-declare function cleanText(original: string, cleaners?: Array<(text: string) => string>): CleanTextResult;
+declare function cleanText(original: string, cleaners?: Array<(text: string) => string>, additionalCleaners?: Array<(text: string) => string>): CleanTextResult;
 //#endregion
 //#region src/tokenize/tokenizer.d.ts
 /**
@@ -624,13 +675,26 @@ declare function normalizeCourt(court: string | undefined): string | undefined;
 */
 declare class DocumentResolver {
   private readonly citations;
+  /** Original document text — used for original-coordinate reads (quote zones,
+  *  paragraph boundaries, party-name lookback) that locate citations via
+  *  `span.originalStart`. */
   private readonly text;
+  /** Cleaned document text — used for clean-coordinate reads (bracket scopes,
+  *  trigger-anchored asides, family/name windows) that index by
+  *  `span.cleanStart`/`cleanEnd`. Equals `text` when no length-changing cleaner
+  *  ran; diverges from it otherwise, which is the #830 desync this fixes. */
+  private readonly cleanedText;
+  /** Maps clean→original offsets so derived output spans carry correct original
+  *  coordinates even when a cleaner transformed the text (#830). */
+  private readonly transformationMap?;
   private readonly options;
   private readonly context;
   private readonly partyNameTree;
   private readonly quoteZones;
   /** Parenthesis depth at each citation's start (filled lazily by resolve()). */
   private parenDepths;
+  /** Per-citation bracket-balance trust (#809/#820); false = structure unreliable. */
+  private balanceOks;
   /** Resolution results accumulated during the in-flight resolve() pass. */
   private resolutions;
   /** Resolved citations accumulated during the in-flight resolve() pass; used
@@ -640,10 +704,17 @@ declare class DocumentResolver {
   * Creates a new DocumentResolver.
   *
   * @param citations - All citations in document (in order of appearance)
-  * @param text - Original document text
+  * @param text - Original document text (original-coordinate reads index into it)
   * @param options - Resolution options
+  * @param cleanContext - Cleaned text + transformation map for clean-coordinate
+  *   reads (#830). When omitted, `text` is treated as the cleaned text too,
+  *   preserving the historical clean==original behavior for callers that pass
+  *   only one text (e.g. text untouched by a length-changing cleaner).
   */
-  constructor(citations: Citation[], text: string, options?: ResolutionOptions);
+  constructor(citations: Citation[], text: string, options?: ResolutionOptions, cleanContext?: {
+    cleanedText: string;
+    transformationMap: TransformationMap;
+  });
   /**
   * Resolves all citations in the document.
   *
@@ -753,6 +824,22 @@ declare class DocumentResolver {
   */
   private isParentheticalChild;
   /**
+  * Whether the citation's clean span is wholly inside a previously-resolved
+  * citation's `fullSpan` (the #214 strategy-2 signal). Independent of the
+  * fragile bracket-depth count, so it stays a *hard* exclusion even when
+  * balance fails (#820).
+  */
+  private isFullSpanContained;
+  /**
+  * #820: the citation's paren-child status rests ONLY on the (possibly
+  * desynced) bracket depth, in a clause whose brackets did not balance — so the
+  * "nested" verdict is untrustworthy. Trigger-anchored asides and
+  * fullSpan-contained cites are reliable (independent of the depth count) and
+  * stay hard exclusions; only the depth-only case under balance failure is
+  * soft, which `resolveId` keeps as a degraded-confidence candidate.
+  */
+  private isUntrustworthyDepthAside;
+  /**
   * Scans the prose between the previous citation and `Id.` for a case-name
   * mention. If a name is found and doesn't match the picked antecedent's
   * caseName/plaintiff/defendant, returns a downgraded confidence and an
@@ -772,6 +859,15 @@ declare class DocumentResolver {
   * threshold-derived `maxDistance` to recover it.
   */
   private resolveSupra;
+  /**
+  * Apply the #818 hybrid policy to the in-scope authorities a `supra` name key
+  * resolved to. Exactly one → commit at the matched similarity. More than one is
+  * a non-unique key: a *true tie* (same name + same year, indistinguishable by
+  * the key alone) abstains; otherwise pick the most-recent-within-name but cap
+  * confidence and warn, with `idConfidenceFloor` able to fail it closed. Mirrors
+  * the `Id.` path's downgrade-warn-then-floor-abstain shape (#800/#820).
+  */
+  private selectSupraAntecedent;
   private createSupraSuccess;
   /**
   * Match a full-caption supra (`Plaintiff v. Defendant, supra`) against a
@@ -876,9 +972,16 @@ declare class DocumentResolver {
 * @param citations - Extracted citations in order of appearance
 * @param text - Original document text
 * @param options - Resolution options
+* @param cleanContext - Optional cleaned text + transformation map. Pass when a
+*   length-changing cleaner was applied so clean-coordinate reads index the
+*   cleaned text and derived spans map back to original coordinates (#830). When
+*   omitted, `text` is treated as the cleaned text too (clean == original).
 * @returns Citations with resolution metadata
 */
-declare function resolveCitations(citations: Citation[], text: string, options?: ResolutionOptions): ResolvedCitation[];
+declare function resolveCitations(citations: Citation[], text: string, options?: ResolutionOptions, cleanContext?: {
+  cleanedText: string;
+  transformationMap: TransformationMap;
+}): ResolvedCitation[];
 //#endregion
 //#region src/footnotes/detectFootnotes.d.ts
 /**
@@ -1041,5 +1144,5 @@ declare function analyzeDocument(text: string, citations: Citation[], opts?: {
   transformationMap?: TransformationMap;
 }): Document;
 //#endregion
-export { type AnalyzedFootnoteZone, type AnnotationCitation, type AnnotationComponentSpans, 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 FederalRuleCitation, type FederalRuleComponentSpans, 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 RestatementCitation, type RestatementComponentSpans, 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 TreatiseCitation, type TreatiseComponentSpans, type Warning, analyzeDocument, applyFalsePositiveFilters, assertUnreachable, cleanText, detectFootnotes, extractAnnotation, extractCase, extractCitations, extractCitationsAsync, extractConstitutional, extractFederalRegister, extractFederalRule, extractJournal, extractNeutral, extractPublicLaw, extractRestatement, extractStatute, extractStatutesAtLarge, extractTreatise, isCaseCitation, isCitationType, isFullCitation, isShortFormCitation, normalizeCourt, parsePincite, resolveCitations, spanFromGroupIndex, tokenize };
+export { type AnalyzedFootnoteZone, type AnnotationCitation, type AnnotationComponentSpans, type AttributionKind, type CaseComponentSpans, type Citation, type CitationBase, type CitationGraph, type CitationId, 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 FederalRuleCitation, type FederalRuleComponentSpans, 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 RestatementCitation, type RestatementComponentSpans, 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 TreatiseCitation, type TreatiseComponentSpans, type Warning, analyzeDocument, applyFalsePositiveFilters, assertUnreachable, byId, cleanText, detectFootnotes, extractAnnotation, extractCase, extractCitations, extractCitationsAsync, extractConstitutional, extractFederalRegister, extractFederalRule, extractJournal, extractNeutral, extractPublicLaw, extractRestatement, extractStatute, extractStatutesAtLarge, extractTreatise, isCaseCitation, isCitationType, isFullCitation, isShortFormCitation, normalizeCourt, parsePincite, resolveCitations, spanFromGroupIndex, stripMarkdownEmphasis, 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/extractAnnotation.ts","../src/extract/extractCase.ts","../src/extract/extractConstitutional.ts","../src/extract/extractFederalRegister.ts","../src/extract/extractFederalRule.ts","../src/extract/extractJournal.ts","../src/extract/extractNeutral.ts","../src/extract/extractPublicLaw.ts","../src/extract/extractRestatement.ts","../src/extract/extractStatute.ts","../src/extract/extractStatutesAtLarge.ts","../src/extract/extractTreatise.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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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/guards.ts","../src/patterns/casePatterns.ts","../src/extract/extractCitations.ts","../src/extract/assignCitationIds.ts","../src/extract/filterFalsePositives.ts","../src/clean/cleaners.ts","../src/clean/cleanText.ts","../src/tokenize/tokenizer.ts","../src/extract/extractAnnotation.ts","../src/extract/extractCase.ts","../src/extract/extractConstitutional.ts","../src/extract/extractFederalRegister.ts","../src/extract/extractFederalRule.ts","../src/extract/extractJournal.ts","../src/extract/extractNeutral.ts","../src/extract/extractPublicLaw.ts","../src/extract/extractRestatement.ts","../src/extract/extractStatute.ts","../src/extract/extractStatutesAtLarge.ts","../src/extract/extractTreatise.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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"}