eyecite-ts 0.18.1 → 0.20.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { A as ConstitutionalComponentSpans, B as PinciteInfo, C as ShortFormCitationType, D as SupraCitation, E as SubsequentHistoryEntry, F as StatuteComponentSpans, I as StatutesAtLargeComponentSpans, L as Span, M as JournalComponentSpans, N as NeutralComponentSpans, O as Warning, P as PublicLawComponentSpans, R as TransformationMap, S as ShortFormCitation, T as StatutesAtLargeCitation, V as parsePincite, _ as NeutralCitation, a as CitationType, b as PublicLawCitation, c as DocketCitation, d as FullCaseCitation, f as FullCitation, g as JournalCitation, h as IdCitation, i as CitationSignal, j as FederalRegisterComponentSpans, k as CaseComponentSpans, l as ExtractorMap, m as HistorySignal, n as CitationBase, o as ConstitutionalCitation, p as FullCitationType, r as CitationOfType, s as CourtInference, t as Citation, u as FederalRegisterCitation, v as Parenthetical, w as StatuteCitation, x as ShortFormCaseCitation, y as ParentheticalType, z as spanFromGroupIndex } from "./citation-CYqkPRyu.cjs";
-import { a as FootnoteMap, i as ScopeStrategy, n as ResolutionResult, o as FootnoteZone, r as ResolvedCitation, t as ResolutionOptions } from "./types-DhaEp2Tg.cjs";
+import { A as ConstitutionalComponentSpans, B as PinciteInfo, C as ShortFormCitationType, D as SupraCitation, E as SubsequentHistoryEntry, F as StatuteComponentSpans, I as StatutesAtLargeComponentSpans, L as Span, M as JournalComponentSpans, N as NeutralComponentSpans, O as Warning, P as PublicLawComponentSpans, R as TransformationMap, S as ShortFormCitation, T as StatutesAtLargeCitation, V as parsePincite, _ as NeutralCitation, a as CitationType, b as PublicLawCitation, c as DocketCitation, d as FullCaseCitation, f as FullCitation, g as JournalCitation, h as IdCitation, i as CitationSignal, j as FederalRegisterComponentSpans, k as CaseComponentSpans, l as ExtractorMap, m as HistorySignal, n as CitationBase, o as ConstitutionalCitation, p as FullCitationType, r as CitationOfType, s as CourtInference, t as Citation, u as FederalRegisterCitation, v as Parenthetical, w as StatuteCitation, x as ShortFormCaseCitation, y as ParentheticalType, z as spanFromGroupIndex } from "./citation-Ba2mRoW-.cjs";
+import { a as FootnoteMap, i as ScopeStrategy, n as ResolutionResult, o as FootnoteZone, r as ResolvedCitation, t as ResolutionOptions } from "./types-BmlG4hQA.cjs";
 
 //#region src/types/guards.d.ts
 /**
@@ -598,6 +598,27 @@ declare class DocumentResolver {
   */
   resolve(): ResolvedCitation[];
   /**
+  * Returns true if the given full citation carries a numeric pincite
+  * (case-family: case, journal, neutral). Short-form citation types
+  * (IdCitation, SupraCitation, ShortFormCaseCitation) all type `pincite`
+  * as `number` only, so they can only inherit from numeric-pincite
+  * authorities. Statute-family inheritance is blocked by the type system
+  * today; revisit if/when short-forms gain `string` pincite support.
+  */
+  private hasNumericPinciteFamily;
+  /**
+  * Post-resolution pass: propagate pincite from the immediately preceding
+  * same-authority citation per Bluebook Rule 4.1 / Indigo Book R6.2.2.
+  * Mutates `resolved` in place. Walks backward from each short-form,
+  * stopping at authority boundaries (different `resolvedTo`) or successful
+  * inheritance, skipping citations nested in explanatory parentheticals
+  * (Rule 4.1 explicit exception). Only inherits numeric pincites — see
+  * `hasNumericPinciteFamily` for why.
+  *
+  * See docs/superpowers/specs/2026-05-19-pincite-inheritance-design.md.
+  */
+  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
@@ -607,6 +628,18 @@ declare class DocumentResolver {
   */
   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
+  * (which only accepts resolved full antecedents), this lookup accepts
+  * any prior citation that passes the existing scope / parenthetical /
+  * quote-zone filters, regardless of resolution state.
+  *
+  * Returns the index of the immediately-preceding eligible citation,
+  * or `undefined` if none.
+  */
+  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).
@@ -680,6 +713,33 @@ declare class DocumentResolver {
   */
   private resolveShortFormCase;
   /**
+  * Backward prose scan for "Party v. Party" patterns preceding a
+  * short-form citation whose vol+reporter lookup failed. Used to recover
+  * a case name when the author introduced the authority in prose (e.g.
+  * "In Yellen v. Kassin, ...") and used a short-form that didn't carry
+  * an extractable full citation.
+  *
+  * Unlike `extractCaseName` — which performs a boundary-bounded backward
+  * walk starting *immediately before* a citation core — this scan looks
+  * anywhere in a ~400-char window before the short-form and accepts the
+  * closest "Party v. Party" mention whose plaintiff or defendant matches
+  * the short-form's `partyName`. Crossing intervening sentence boundaries
+  * (e.g., "In Yellen v. Kassin, the court held. Yellen, 416 ...") is
+  * required: the prose mention and the short-form are by definition
+  * separated by other prose.
+  *
+  * LOOKBACK = 400 chars accommodates real-world legal prose where the
+  * prose mention and short-form are separated by a long quoted passage
+  * (e.g. the bug-report 2026-05-19 Yellen fixture has ~351 chars of
+  * block quote between "In Yellen v. Kassin" and "Yellen, 416 N.J.
+  * Super. at 590"). False-positive risk is bounded by the partyName
+  * acceptance check and the "closest match wins" tie-breaker.
+  *
+  * Returns the inferred case name + spans, or `undefined` if no
+  * acceptable match is found within `LOOKBACK` chars.
+  */
+  private extractInferredCaseName;
+  /**
   * Tracks a full citation in the resolution history.
   * Extracts party name for supra resolution.
   * Uses extracted party names (Phase 7) when available, falls back to backward search.

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"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { A as ConstitutionalComponentSpans, B as PinciteInfo, C as ShortFormCitationType, D as SupraCitation, E as SubsequentHistoryEntry, F as StatuteComponentSpans, I as StatutesAtLargeComponentSpans, L as Span, M as JournalComponentSpans, N as NeutralComponentSpans, O as Warning, P as PublicLawComponentSpans, R as TransformationMap, S as ShortFormCitation, T as StatutesAtLargeCitation, V as parsePincite, _ as NeutralCitation, a as CitationType, b as PublicLawCitation, c as DocketCitation, d as FullCaseCitation, f as FullCitation, g as JournalCitation, h as IdCitation, i as CitationSignal, j as FederalRegisterComponentSpans, k as CaseComponentSpans, l as ExtractorMap, m as HistorySignal, n as CitationBase, o as ConstitutionalCitation, p as FullCitationType, r as CitationOfType, s as CourtInference, t as Citation, u as FederalRegisterCitation, v as Parenthetical, w as StatuteCitation, x as ShortFormCaseCitation, y as ParentheticalType, z as spanFromGroupIndex } from "./citation-BuqlLfxK.mjs";
-import { a as FootnoteMap, i as ScopeStrategy, n as ResolutionResult, o as FootnoteZone, r as ResolvedCitation, t as ResolutionOptions } from "./types-kaciVAIk.mjs";
+import { A as ConstitutionalComponentSpans, B as PinciteInfo, C as ShortFormCitationType, D as SupraCitation, E as SubsequentHistoryEntry, F as StatuteComponentSpans, I as StatutesAtLargeComponentSpans, L as Span, M as JournalComponentSpans, N as NeutralComponentSpans, O as Warning, P as PublicLawComponentSpans, R as TransformationMap, S as ShortFormCitation, T as StatutesAtLargeCitation, V as parsePincite, _ as NeutralCitation, a as CitationType, b as PublicLawCitation, c as DocketCitation, d as FullCaseCitation, f as FullCitation, g as JournalCitation, h as IdCitation, i as CitationSignal, j as FederalRegisterComponentSpans, k as CaseComponentSpans, l as ExtractorMap, m as HistorySignal, n as CitationBase, o as ConstitutionalCitation, p as FullCitationType, r as CitationOfType, s as CourtInference, t as Citation, u as FederalRegisterCitation, v as Parenthetical, w as StatuteCitation, x as ShortFormCaseCitation, y as ParentheticalType, z as spanFromGroupIndex } from "./citation-BxhgKVy4.mjs";
+import { a as FootnoteMap, i as ScopeStrategy, n as ResolutionResult, o as FootnoteZone, r as ResolvedCitation, t as ResolutionOptions } from "./types-35a1MLhS.mjs";
 
 //#region src/types/guards.d.ts
 /**
@@ -598,6 +598,27 @@ declare class DocumentResolver {
   */
   resolve(): ResolvedCitation[];
   /**
+  * Returns true if the given full citation carries a numeric pincite
+  * (case-family: case, journal, neutral). Short-form citation types
+  * (IdCitation, SupraCitation, ShortFormCaseCitation) all type `pincite`
+  * as `number` only, so they can only inherit from numeric-pincite
+  * authorities. Statute-family inheritance is blocked by the type system
+  * today; revisit if/when short-forms gain `string` pincite support.
+  */
+  private hasNumericPinciteFamily;
+  /**
+  * Post-resolution pass: propagate pincite from the immediately preceding
+  * same-authority citation per Bluebook Rule 4.1 / Indigo Book R6.2.2.
+  * Mutates `resolved` in place. Walks backward from each short-form,
+  * stopping at authority boundaries (different `resolvedTo`) or successful
+  * inheritance, skipping citations nested in explanatory parentheticals
+  * (Rule 4.1 explicit exception). Only inherits numeric pincites — see
+  * `hasNumericPinciteFamily` for why.
+  *
+  * See docs/superpowers/specs/2026-05-19-pincite-inheritance-design.md.
+  */
+  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
@@ -607,6 +628,18 @@ declare class DocumentResolver {
   */
   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
+  * (which only accepts resolved full antecedents), this lookup accepts
+  * any prior citation that passes the existing scope / parenthetical /
+  * quote-zone filters, regardless of resolution state.
+  *
+  * Returns the index of the immediately-preceding eligible citation,
+  * or `undefined` if none.
+  */
+  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).
@@ -680,6 +713,33 @@ declare class DocumentResolver {
   */
   private resolveShortFormCase;
   /**
+  * Backward prose scan for "Party v. Party" patterns preceding a
+  * short-form citation whose vol+reporter lookup failed. Used to recover
+  * a case name when the author introduced the authority in prose (e.g.
+  * "In Yellen v. Kassin, ...") and used a short-form that didn't carry
+  * an extractable full citation.
+  *
+  * Unlike `extractCaseName` — which performs a boundary-bounded backward
+  * walk starting *immediately before* a citation core — this scan looks
+  * anywhere in a ~400-char window before the short-form and accepts the
+  * closest "Party v. Party" mention whose plaintiff or defendant matches
+  * the short-form's `partyName`. Crossing intervening sentence boundaries
+  * (e.g., "In Yellen v. Kassin, the court held. Yellen, 416 ...") is
+  * required: the prose mention and the short-form are by definition
+  * separated by other prose.
+  *
+  * LOOKBACK = 400 chars accommodates real-world legal prose where the
+  * prose mention and short-form are separated by a long quoted passage
+  * (e.g. the bug-report 2026-05-19 Yellen fixture has ~351 chars of
+  * block quote between "In Yellen v. Kassin" and "Yellen, 416 N.J.
+  * Super. at 590"). False-positive risk is bounded by the partyName
+  * acceptance check and the "closest match wins" tie-breaker.
+  *
+  * Returns the inferred case name + spans, or `undefined` if no
+  * acceptable match is found within `LOOKBACK` chars.
+  */
+  private extractInferredCaseName;
+  /**
   * Tracks a full citation in the resolution history.
   * Extracts party name for supra resolution.
   * Uses extracted party names (Phase 7) when available, falls back to backward search.

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":";;;;;;;iBAYgB,cAAA,CAAe,QAAA,EAAU,QAAA,GAAW,QAAA,IAAY,YAAA;;;;iBAiBhD,mBAAA,CAAoB,QAAA,EAAU,QAAA,GAAW,QAAA,IAAY,iBAAA;;;;iBAOrD,cAAA,CAAe,QAAA,EAAU,QAAA,GAAW,QAAA,IAAY,gBAAA;;AAPhE;;;iBAegB,cAAA,WAAyB,YAAA,CAAA,CACvC,QAAA,EAAU,QAAA,EACV,IAAA,EAAM,CAAA,GACL,QAAA,IAAY,cAAA,CAAe,CAAA;;;;;;;AAX9B;;;;;;;;;;iBA+BgB,iBAAA,CAAkB,CAAA;;;UCnDjB,OAAA;EACf,EAAA;EACA,KAAA,EAAO,MAAA;EACP,WAAA;EACA,IAAA,EAAM,gBAAA;AAAA;;;;ADRR;;UEgDiB,cAAA;EFhD+C;;;;;;;AAiBhE;;;;;;;EE8CE,QAAA,GAAW,KAAA,EAAO,IAAA;;;AFvCpB;;;;;;;;;;AAQA;;EE+CE,QAAA,GAAW,OAAA;;;;;;;;;;;;;;EAeX,OAAA;;;;;AFvCF;;;;;;;;ACnDA;;EC0GE,iBAAA,GAAoB,iBAAA;EDtGd;;;;;;;;;;;;ACwCR;;;;EAgFE,oBAAA;;EAGA,eAAA;AAAA;;;;;;;;;;;;;AA6DF;;;;;;;;;;;AAIA;;;;;;;;;;AAwTA;;;;;;;;;;;;;;;;AAIA;;;;;;;;;iBAhUgB,gBAAA,CACd,IAAA,UACA,OAAA,EAAS,cAAA;EAAmB,OAAA;AAAA,IAC3B,gBAAA;AAAA,iBACa,gBAAA,CAAiB,IAAA,UAAc,OAAA,GAAU,cAAA,GAAiB,QAAA;;;;;;AC6L1E;;;;;;;;;;;;;AC1XA;;;;iBFqfsB,qBAAA,CACpB,IAAA,UACA,OAAA,EAAS,cAAA;EAAmB,OAAA;AAAA,IAC3B,OAAA,CAAQ,gBAAA;AAAA,iBACW,qBAAA,CACpB,IAAA,UACA,OAAA,GAAU,cAAA,GACT,OAAA,CAAQ,QAAA;;;AFlfX;;;;;;;AAAA,iBGgXgB,yBAAA,CAA0B,SAAA,EAAW,QAAA,IAAY,MAAA,YAAkB,QAAA;;;;;AHjYnF;UIOiB,eAAA;;EAEf,OAAA;;EAGA,iBAAA,EAAmB,iBAAA;;EAGnB,QAAA,EAAU,OAAA;AAAA;;AJEZ;;;;;;;;;;AAOA;;;;;iBIUgB,SAAA,CACd,QAAA,UACA,QAAA,GAAU,KAAA,EAAO,IAAA,uBAYhB,eAAA;;;;;;;;;;UChCc,KAAA;ELQD;EKNd,IAAA;ELM8D;EKH9D,IAAA,EAAM,IAAA,CAAK,IAAA;;EAGX,IAAA,EAAM,OAAA;;EAGN,SAAA;AAAA;ALKF;;;;;;;;;;;;;;;;;;;;;AAuBA;;;;;;;;ACnDA;;;;;;;AD4BA,iBKkCgB,QAAA,CACd,WAAA,UACA,QAAA,GAAU,OAAA,KAOT,KAAA;;;AHqbH;;;;;;;;;;;;;;;;;;AC/HA;;;;;;;;;;;;;AC1XA;;;;;;;;;;;AA2BA;;;;;;;;;AF8dA,iBIopDgB,WAAA,CACd,KAAA,EAAO,KAAA,EACP,iBAAA,EAAmB,iBAAA,EACnB,WAAA,WACA,YAAA,WAOA,QAAA,GAAW,aAAA;EAAgB,UAAA;EAAoB,QAAA;AAAA,KAC9C,gBAAA;;;;ANhqEH;;;;;;iBOgJgB,qBAAA,CACd,KAAA,EAAO,KAAA,EACP,iBAAA,EAAmB,iBAAA,GAClB,sBAAA;;;;;;APlIH;;;;;;;;;;AAOA;;;;;;;;;;AAQA;;;;;;;;;;iBQGgB,sBAAA,CACd,KAAA,EAAO,KAAA,EACP,iBAAA,EAAmB,iBAAA,GAClB,uBAAA;;;;;;ARrBH;;;;;;;;;;AAOA;;;;;;;;;;AAQA;;;;;;;;;;;;;;;;;;;;;iBScgB,cAAA,CACd,KAAA,EAAO,KAAA,EACP,iBAAA,EAAmB,iBAAA,EACnB,WAAA,YACC,eAAA;;;;;;ATjCH;;;;;;;;;;AAOA;;;;;;;;;;AAQA;;;;;;;;;;;iBUiCgB,cAAA,CACd,KAAA,EAAO,KAAA,EACP,iBAAA,EAAmB,iBAAA,EACnB,WAAA,YACC,eAAA;;;;;;AVpDH;;;;;;;;;;AAOA;;;;;;;;;;AAQA;;;;;;;;;;;;iBWKgB,gBAAA,CACd,KAAA,EAAO,KAAA,EACP,iBAAA,EAAmB,iBAAA,GAClB,iBAAA;;;;;;;iBCyEa,cAAA,CACd,KAAA,EAAO,KAAA,EACP,iBAAA,EAAmB,iBAAA,GAClB,eAAA;;;iBC/Ga,sBAAA,CACd,KAAA,EAAO,KAAA,EACP,iBAAA,EAAmB,iBAAA,GAClB,uBAAA;;;;;;;AbRH;;;;;;;;iBcAgB,cAAA,CAAe,KAAA;;;;AdiB/B;;;ceyIa,gBAAA;EAAA,iBACM,SAAA;EAAA,iBACA,IAAA;EAAA,iBACA,OAAA;EAAA,iBAGA,OAAA;EAAA,iBACA,aAAA;EAAA,iBACA,UAAA;Ef1InB;EAAA,Qe4IU,WAAA;;UAEA,WAAA;;;UAGA,aAAA;;;;AfzIV;;;;EekJE,WAAA,CAAY,SAAA,EAAW,QAAA,IAAY,IAAA,UAAc,OAAA,GAAS,iBAAA;;;;;;EA+C1D,OAAA,CAAA,GAAW,gBAAA;;;;;;;;;UAqGH,kBAAA;EfnSoB;AAoB9B;;;;;;;;ACnDA;;;;;;;;;ED+B8B,QewUpB,SAAA;;;;;;Ab3TV;;Ua6ZU,oBAAA;;;;;;;UAeA,kBAAA;EAAA,QAaA,qBAAA;;;;;;;;;UAaA,oBAAA;EbtTV;;;;;;;;EAAA,QagVU,wBAAA;;;Ab5UV;UasbU,YAAA;;;;;;;;;Ab9HV;;;;;;;UauMU,oBAAA;;;;;;UAyDA,iBAAA;;;Ab5PV;;Ua0RU,gBAAA;;;;;;UAgCA,gBAAA;;;;UAWA,kBAAA;;;;UAUA,iBAAA;;AZ9cV;;UYwdU,aAAA;EZxdyE;;;EAAA,QYyezE,mBAAA;AAAA;;;;;;;Afl1BV;;;;;;iBgBHgB,gBAAA,CACd,SAAA,EAAW,QAAA,IACX,IAAA,UACA,OAAA,GAAU,iBAAA,GACT,gBAAA;;;;;;AhBzBH;;;;;;;;iBiBKgB,eAAA,CAAgB,IAAA,WAAe,WAAA"}
+{"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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"}