@tricoteuses/tisseuse 0.21.2 → 0.22.1

package/dist/{src/lib → lib}/legi/canutes_resolver.d.ts

@@ -1,24 +1,10 @@
 import { CanutesSql } from './canutes_sql.js';
-import { LegiResolver, LegiArticleHistoryInfo, LegiArticleInfo, LegiSectionInfo, PreloadActiveArticlesByTextIdsOptions, PreloadTextTitlesInfosOptions } from './resolver.js';
+import { LegiResolver, LegiArticleAbrogationProof, LegiArticleHistoryInfo, LegiArticleInfo, LegiArticleStructureProof, LegiSectionInfo, PreloadActiveArticlesByTextIdsOptions, PreloadTextTitlesInfosOptions } from './resolver.js';
 /**
  * Minimal structural view of a Légifrance article row needed to compute an
  * article history entry point; shared with the audit preload.
  */
-export interface ArticleHistorySourceRow {
-    dateDebut: string | null;
-    id: string;
-    versions: {
-        VERSION?: unknown;
-    } | null;
-}
-/**
- * Group article rows by version chain (the set of ids listed in their
- * VERSIONS section, always including the row's own id) and return the latest
- * version of the chain, but only when exactly one chain exists for the
- * requested number. Several chains mean the number was reused by distinct
- * articles: the history would then be ambiguous.
- */
-export declare function articleHistoryInfoFromRows(rows: ArticleHistorySourceRow[]): LegiArticleHistoryInfo | undefined;
+export { articleHistoryInfoFromRows, type ArticleHistorySourceRow, } from './article_history.js';
 export declare class CanutesResolver extends LegiResolver {
     private readonly canutesDb;
     private readonly articleHistoryInfoByTextAndNum;
@@ -34,6 +20,21 @@ export declare class CanutesResolver extends LegiResolver {
         num: string | undefined;
         textId: string;
     }): Promise<LegiArticleInfo[]>;
+    getLawArticleType({ articleId, textId, }: {
+        articleId: string;
+        textId: string;
+    }): Promise<"AUTONOME" | "ENTIEREMENT_MODIF" | "PARTIELLEMENT_MODIF" | undefined>;
+    getVerifiedPublicationComponents(candidateCids: string[]): Promise<import('./resolver.js').LegiPublicationComponentsProof | undefined>;
+    getVerifiedArticleAbrogation({ date, num, textId, }: {
+        date: string;
+        num: string;
+        textId: string;
+    }): Promise<LegiArticleAbrogationProof | undefined>;
+    getVerifiedArticleStructure({ date, num, textId, }: {
+        date: string;
+        num: string;
+        textId: string;
+    }): Promise<LegiArticleStructureProof | undefined>;
     preloadActiveArticlesByTextIds({ date, nums, textIds, }: PreloadActiveArticlesByTextIdsOptions): Promise<void>;
     getArticleHistoryInfo({ num, textId, }: {
         num: string | undefined;

package/dist/lib/legi/law_article.d.ts

@@ -0,0 +1,13 @@
+import { LegiArticleInfo, LegiResolver } from './resolver.js';
+export declare function supportsModifyingArticleRule(nature: string | undefined): boolean;
+/** Select the consultation article of a law, ordinance or decree, never a code.
+ * Sentinel LEGI periods do not prove validity, but the version still counts
+ * when testing the unique modificative-version exception. Historical API
+ * names are retained for resolver compatibility.
+ */
+export declare function selectLawArticle({ candidates, date, legiResolver, textId, }: {
+    candidates: LegiArticleInfo[];
+    date: string;
+    legiResolver: LegiResolver;
+    textId: string;
+}): Promise<LegiArticleInfo | undefined>;

package/dist/lib/legi/named_text_article.d.ts

@@ -0,0 +1,22 @@
+import { LegiArticleInfo, LegiResolver } from './resolver.js';
+export interface NamedTextArticleTarget {
+    articleId?: string;
+    historyArticleId?: string;
+}
+/** Keep the resolver evidence with the rendering target so extraction and
+ * rendering cannot independently choose different versions of a citation.
+ */
+export declare function resolveNamedTextArticle({ date, isLaw, legiResolver, num, textId, }: {
+    date: string;
+    /** Historical option name: includes ordinances and decrees. */
+    isLaw?: boolean;
+    legiResolver: LegiResolver;
+    num: string;
+    textId: string;
+}): Promise<{
+    candidates: (LegiArticleInfo & {
+        textId: string;
+    })[];
+    target: NamedTextArticleTarget;
+}>;
+export declare function getNamedTextArticleTarget(options: Parameters<typeof resolveNamedTextArticle>[0]): Promise<NamedTextArticleTarget>;

package/dist/lib/legi/publication_components.d.ts

@@ -0,0 +1,22 @@
+import { LegiPublicationComponentsProof } from './resolver.js';
+/** Published JORF components, NOT dated LEGI structure or article validity. */
+export interface PublicationComponentRow {
+    cid: string;
+    nature: string | null;
+    num: string | null;
+    dateTexte: string | null;
+    datePubli: string | null;
+    nor: string | null;
+    hasVisas: boolean;
+    hasSignataires: boolean;
+    children: Array<{
+        id: string;
+        kind: string;
+        title: string | null;
+    }> | null;
+}
+/** Deliberately bounded domain: one signed body of direct articles and one
+ * separately published, unnumbered Annex root in the very same JORF issue.
+ * Neither the title, NOR, absent signatures nor sentinel dates alone is proof.
+ */
+export declare function verifyPublicationComponents(candidateCids: string[], rows: PublicationComponentRow[]): LegiPublicationComponentsProof | undefined;

package/dist/lib/legi/publication_components.fixture.d.ts

@@ -0,0 +1,3 @@
+import { PublicationComponentRow } from './publication_components.js';
+export declare const ordinanceComponentRows: PublicationComponentRow[];
+export declare const ordinanceCorrectionRow: PublicationComponentRow;

package/dist/{src/lib → lib}/legi/resolver.d.ts

@@ -1,3 +1,9 @@
+import { PublicationComponentRow } from './publication_components.js';
+export interface LegiPublicationComponentsProof {
+    candidates: PublicationComponentRow[];
+    bodyCid: string;
+    annexCid: string;
+}
 export interface LegiArticleInfo {
     dateDebut: string;
     dateFin: string;
@@ -5,6 +11,20 @@ export interface LegiArticleInfo {
     num: string | null;
     textId: string | null;
 }
+export type LawArticleType = "AUTONOME" | "ENTIEREMENT_MODIF" | "PARTIELLEMENT_MODIF";
+/** An abrogation proof must travel with the exact version set read in its
+ * snapshot. Consumers must compare it with the candidates already resolved
+ * for the occurrence before using the terminal version for consultation.
+ */
+export interface LegiArticleAbrogationProof {
+    candidates: LegiArticleInfo[];
+    terminalId: string;
+}
+/** Verified edges and candidates from one read-only snapshot, for a collision only. */
+export interface LegiArticleStructureProof {
+    candidates: LegiArticleInfo[];
+    structures: Record<string, "valable" | "invalide">;
+}
 /**
  * Entry point to the history of an article: the latest version of the unique
  * version chain known for a cited article number within a cited text.
@@ -34,11 +54,31 @@ export type PreloadActiveArticlesByTextIdsOptions = {
     textIds: Iterable<string | undefined>;
 };
 export declare abstract class LegiResolver {
+    /** Collision only; all metadata and root children read in one stable snapshot. */
+    getVerifiedPublicationComponents(candidateCids: string[]): Promise<LegiPublicationComponentsProof | undefined>;
     abstract getActiveArticlesByTextAndNum(options: {
         date: string;
         num: string | undefined;
         textId: string;
     }): Promise<LegiArticleInfo[]>;
+    /** Law, ordinance or decree TYPE; historical name retained for compatibility.
+     * Only consulted for a single LEGI version competing with its JORF original.
+     */
+    getLawArticleType(options: {
+        articleId: string;
+        textId: string;
+    }): Promise<LawArticleType | undefined>;
+    /** Optional, collision-only proof; no proof is safer than a stale one. */
+    getVerifiedArticleAbrogation(options: {
+        date: string;
+        num: string;
+        textId: string;
+    }): Promise<LegiArticleAbrogationProof | undefined>;
+    getVerifiedArticleStructure(options: {
+        date: string;
+        num: string;
+        textId: string;
+    }): Promise<LegiArticleStructureProof | undefined>;
     /**
      * Latest version of the unique version chain of an article number within a
      * text, or `undefined` when the number is unknown, ambiguous (several

package/dist/lib/linkers/enumeration_scope.fixture.d.ts

@@ -0,0 +1,19 @@
+export declare const enumerationParagraphs: {
+    cid: string;
+    title: string;
+    nums: string[];
+    html: string;
+}[];
+export declare const historicalEnumerationParagraph: {
+    html: string;
+    cid: string;
+    title: string;
+    nums: string[];
+};
+export declare const constructionEnumerationParagraph: {
+    cid: string;
+    title: string;
+    nums: string[];
+    html: string;
+};
+export declare const quotedAmendmentWithPastilles: string;

package/dist/{src/lib → lib}/linkers/html.d.ts

@@ -1,19 +1,23 @@
 import { CanutesSql } from '../legi/canutes_sql.js';
-import { DefinitionOrLink, TextLinksParserState } from '../extractors/links.js';
+import { DefinitionOrLink, LinkDecision, LinkDecisionObserver, TextLinksParserState } from '../extractors/links.js';
 import { ReferenceParsingMode } from '../extractors/references.js';
 import { LegiResolver } from '../legi/resolver.js';
 import { LinkType } from '../links.js';
 import { FragmentPosition } from '../text_parsers/fragments.js';
 import { TextParserContext } from '../text_parsers/parsers.js';
 import { Transformation } from '../text_parsers/transformers.js';
-export declare function addLinksToHtml({ canutesDb, excludedHtmlRanges, includeInternalArticleLinks, legiResolver: providedLegiResolver, date, html, linkBaseUrl, linkType, logIgnoredReferencesTypes, logPartialReferences, logReferences, onLink, parsingMode, previousContext, state, }: {
+export declare function addLinksToHtml({ canutesDb, callerDate, excludedHtmlRanges, includeInternalArticleLinks, legiResolver: providedLegiResolver, date, decisionObserver, html, linkBaseUrl, linkDecisionDocumentId, linkType, logIgnoredReferencesTypes, logPartialReferences, logReferences, onLink, parsingMode, previousContext, renderLinkDecisions, state, }: {
     canutesDb?: CanutesSql;
+    /** Explicit resolution date, distinct from the document date. */
+    callerDate?: string;
     excludedHtmlRanges?: FragmentPosition[];
     includeInternalArticleLinks?: boolean;
     legiResolver?: LegiResolver;
     date: string;
+    decisionObserver?: LinkDecisionObserver;
     html: string;
     linkBaseUrl: string;
+    linkDecisionDocumentId?: string;
     linkType: LinkType;
     logIgnoredReferencesTypes?: boolean;
     logPartialReferences?: boolean;
@@ -21,10 +25,13 @@ export declare function addLinksToHtml({ canutesDb, excludedHtmlRanges, includeI
     onLink?: (link: DefinitionOrLink, index: number) => Promise<boolean | void>;
     parsingMode?: ReferenceParsingMode;
     previousContext?: TextParserContext;
+    /** Render captured decisions; requires linkDecisionDocumentId. */
+    renderLinkDecisions?: boolean;
     state?: TextLinksParserState;
 }): Promise<{
     context: TextParserContext;
     output: string | null;
+    linkDecisions?: LinkDecision[];
 }>;
 export type OutputByType = Partial<Record<OutputType, {
     html: string;
@@ -38,22 +45,28 @@ interface HtmlReplacement {
     start: number;
     stop: number;
 }
-export declare function addLinksOrReferencesToHtmlPage({ canutesDb, legiResolver: providedLegiResolver, date, defaultTextId, htmlTransformation, inputHtml, linkBaseUrl, linkType, logIgnoredReferencesTypes, logPartialReferences, logReferences, outputTypes: requestedOutputTypes, referredLegifranceTextsInfos, }: {
+export declare function addLinksOrReferencesToHtmlPage({ canutesDb, callerDate, legiResolver: providedLegiResolver, date, defaultTextId, htmlTransformation, inputHtml, linkBaseUrl, linkDecisionDocumentId, linkType, logIgnoredReferencesTypes, logPartialReferences, logReferences, outputTypes: requestedOutputTypes, referredLegifranceTextsInfos, renderLinkDecisions, }: {
     canutesDb?: CanutesSql;
+    /** Explicit resolution date, distinct from the document date. */
+    callerDate?: string;
     legiResolver?: LegiResolver;
     date: string;
     defaultTextId?: string;
     htmlTransformation: Transformation;
     inputHtml: string;
     linkBaseUrl: string;
+    linkDecisionDocumentId?: string;
     linkType: LinkType;
     logIgnoredReferencesTypes?: boolean;
     logPartialReferences?: boolean;
     logReferences?: boolean;
     outputTypes: OutputType[];
     referredLegifranceTextsInfos?: boolean;
+    /** Render captured decisions in link outputs; requires linkDecisionDocumentId. */
+    renderLinkDecisions?: boolean;
 }): Promise<{
     outputByType: OutputByType;
     referredLegifranceTextCountByCid: Record<string, number>;
+    linkDecisions?: LinkDecision[];
 }>;
 export {};

package/dist/lib/linkers/html_decision_capture.d.ts

@@ -0,0 +1,18 @@
+import { LinkDecision, LinkDecisionObserver } from '../extractors/links.js';
+import { FragmentReverseTransformation } from '../text_parsers/fragments.js';
+/** Keep capture and source-span matching identical in both HTML renderers. */
+export declare function createHtmlDecisionCapture({ captureAbrogation, captureAmbiguity, captureStructure, documentId, render, observer, }: {
+    captureAbrogation?: boolean;
+    captureAmbiguity?: boolean;
+    captureStructure?: boolean;
+    documentId?: string;
+    render: boolean;
+    observer?: LinkDecisionObserver;
+}): {
+    decisions: LinkDecision[] | undefined;
+    observer: LinkDecisionObserver | undefined;
+    findDecision: (original: FragmentReverseTransformation | undefined) => LinkDecision | undefined;
+    findAbrogationDecision: (original: FragmentReverseTransformation | undefined) => LinkDecision | undefined;
+    findAmbiguityDecision: (original: FragmentReverseTransformation | undefined) => LinkDecision | undefined;
+    findStructureDecision: (original: FragmentReverseTransformation | undefined) => LinkDecision | undefined;
+};

package/dist/lib/linkers/link_decision_html.d.ts

@@ -0,0 +1,4 @@
+import { LinkDecision } from '../extractors/links.js';
+import { LinkType } from '../links.js';
+/** Serialize only consultation and uncertainty; projection rights stay structured. */
+export declare function linkDecisionHtmlAttributes(decision: LinkDecision, linkType: LinkType, linkBaseUrl: string): string | undefined;

package/dist/lib/linkers/link_decision_metadata.d.ts

@@ -0,0 +1,15 @@
+/** Public HTML consultation metadata; projection rights are never serialized here. */
+export declare const linkDecisionMetadataAttributes: readonly ["data-tisseuse-warning", "data-tisseuse-candidates"];
+export declare const linkDecisionReferenceClasses: {
+    readonly article: {
+        readonly linked: "lien_article_externe";
+        readonly undecidable: "reference_article_indecidable";
+    };
+    readonly text: {
+        readonly linked: "lien_texte_externe";
+        readonly undecidable: "reference_texte_indecidable";
+    };
+};
+export type LinkDecisionReferenceKind = keyof typeof linkDecisionReferenceClasses;
+export declare function isLinkDecisionWarning(code: string): boolean;
+export declare function isLinkDecisionCandidateId(kind: LinkDecisionReferenceKind, id: string): boolean;

package/dist/{src/lib → lib}/linkers/markdown.d.ts

@@ -1,13 +1,18 @@
 import { CanutesSql } from '../legi/canutes_sql.js';
+import { LinkDecision } from '../extractors/links.js';
 import { ReferenceParsingMode } from '../extractors/references.js';
 import { LegiResolver } from '../legi/resolver.js';
 import { LinkType } from '../links.js';
 import { TextParserContext } from '../text_parsers/parsers.js';
-export declare function addLinksToMarkdown({ canutesDb, legiResolver: providedLegiResolver, date, linkBaseUrl, linkType, parsingMode, previousContext, text, }: {
+export declare function addLinksToMarkdown({ canutesDb, callerDate, legiResolver: providedLegiResolver, date, linkBaseUrl, linkDecisionDocumentId, linkType, parsingMode, previousContext, text, }: {
     canutesDb?: CanutesSql;
+    /** Explicit resolution date, distinct from the document date. */
+    callerDate?: string;
     legiResolver?: LegiResolver;
     date: string;
     linkBaseUrl: string;
+    /** Capture decisions at original source offsets, independently of Markdown links. */
+    linkDecisionDocumentId?: string;
     linkType: LinkType;
     parsingMode?: ReferenceParsingMode;
     previousContext?: TextParserContext;
@@ -15,4 +20,5 @@ export declare function addLinksToMarkdown({ canutesDb, legiResolver: providedLe
 }): Promise<{
     context: TextParserContext;
     output: string | null;
+    linkDecisions?: LinkDecision[];
 }>;

package/dist/lib/linkers/named_text_article.d.ts

@@ -0,0 +1 @@
+export { getNamedTextArticleTarget } from '../legi/named_text_article.js';

package/dist/lib/linkers/quoted_section.fixture.d.ts

@@ -0,0 +1 @@
+export declare const quotedSectionWithVersionProvenance = "<h6>Article 11</h6>\n<p>I. \u2013 Le chapitre V du titre Ier du livre Ier de la premi\u00E8re partie du code des transports, tel qu\u2019il r\u00E9sulte du I de l\u2019article 9 de la pr\u00E9sente loi, est compl\u00E9t\u00E9 par une section 3 ainsi r\u00E9dig\u00E9e :</p>\n<p>\u00AB Section 3</p>\n<p>\u00AB Services d\u2019information et de billettique multimodales</p>\n<p>\u00AB <i>Art. L. 1115\u20117</i>. \u2013 Les autorit\u00E9s organisatrices d\u00E9sign\u00E9es aux articles L. 1231\u20113 et L. 1241\u20111 veillent \u00E0 l\u2019existence de services d\u2019information, \u00E0 l\u2019intention des usagers, sur l\u2019ensemble des modes de d\u00E9placements dans leur ressort de comp\u00E9tence.</p>\n<p>\u00AB Un num\u00E9ro unique d\u2019appel national est cr\u00E9\u00E9 pour la r\u00E9servation et l\u2019accompagnement des personnes \u00E0 besoins sp\u00E9cifiques dans le transport ferroviaire.</p>\n<p>\u00AB <i>Art. L. 1115\u20118</i>. \u2013 Lorsqu\u2019un service num\u00E9rique multimodal proposant la vente ou la r\u00E9servation de services de transport ou de stationnement pr\u00E9sente une ou plusieurs solutions de d\u00E9placement en r\u00E9ponse \u00E0 la requ\u00EAte de l\u2019usager, celles\u2011ci sont pr\u00E9sent\u00E9es de mani\u00E8re claire et insusceptible d\u2019induire l\u2019usager en erreur. Les crit\u00E8res utilis\u00E9s pour leur s\u00E9lection et leur classement sont explicites. Ils sont appliqu\u00E9s sans discrimination \u00E0 tous les services de transport ou de stationnement int\u00E9gr\u00E9s au service num\u00E9rique multimodal et ne se fondent sur aucun \u00E9l\u00E9ment directement ou indirectement li\u00E9 \u00E0 l\u2019identit\u00E9 de l\u2019usager ou \u00E0 une consid\u00E9ration commerciale.</p>\n<p>\u00AB Lorsque les autorit\u00E9s organisatrices de la mobilit\u00E9 fournissent un service num\u00E9rique multimodal proposant la vente ou la r\u00E9servation de plusieurs services de transport ou de stationnement, les fournisseurs de services de transport et de stationnement op\u00E9rant sur leur territoire leur octroient, sur demande, un acc\u00E8s \u00E0 leurs services num\u00E9riques de vente ou de r\u00E9servation. Les conditions techniques et financi\u00E8res de cet acc\u00E8s sont d\u00E9finies par contrat. Elles doivent \u00EAtre raisonnables, proportionn\u00E9es et non discriminatoires.</p>\n<p>\u00AB Un d\u00E9cret en Conseil d\u2019\u00C9tat pr\u00E9cise les conditions d\u2019application du pr\u00E9sent article. \u00BB</p>\n<p>II. \u2013 L\u2019article L. 1115\u20117 du code des transports dans sa r\u00E9daction r\u00E9sultant du I du pr\u00E9sent article entre en vigueur le 1er d\u00E9cembre 2021.</p>";

package/dist/lib/linkers/table_column_texts.d.ts

@@ -0,0 +1,4 @@
+import { TextAstReference } from '../text_parsers/ast.js';
+import { Transformation } from '../text_parsers/transformers.js';
+/** Attach an unambiguous table-column heading to number-only cells. */
+export declare function tableColumnTextReferences(transformation: Transformation): TextAstReference[];

package/dist/{src/lib → lib}/server/parsed_bills.d.ts

@@ -1,6 +1,7 @@
 import { Sql } from 'postgres';
 import { ResolvedActionDirective } from '../extractors/action_directives.js';
 import { ArticleActionEffect, ArticleActionSourceAnnotation } from '../extractors/article_action_effects.js';
+import { LinkDecision } from '../extractors/links.js';
 import { TableOfContents } from '../extractors/table_of_contents.js';
 import { LegiResolver } from '../legi/resolver.js';
 import { LinkType } from '../links.js';
@@ -34,6 +35,8 @@ export type ParsedBillBlock = {
     articleId: string;
     kind: ParsedBillBlockKind;
     links: ParsedBillLink[];
+    /** Decisions keyed by positions in the unlinked source, including citations without href. */
+    linkDecisions?: LinkDecision[];
     qualifiedVersion?: ParsedBillQualifiedVersion;
     text: string;
     html: string;
@@ -46,6 +49,8 @@ export type ParsedBillQualifiedVersion = {
 };
 export type ParsedBillLink = {
     id: string;
+    /** A warned consultation URL cannot become an affirmative directive target. */
+    consultationOnly?: boolean;
     insideFrenchQuotes?: boolean;
     text?: string;
     type: "article" | "division" | "text";
@@ -89,6 +94,10 @@ export type ParsedBillDirective = {
     /** Explicitly cited article numbers defined in this bill; external projection is unavailable. */
     internallyCreatedTargetNums?: string[];
     targetIds?: string[];
+    /** Possible projection targets, never affirmative targetIds. */
+    indicativeTargetIds?: string[];
+    /** Occurrences in this directive's own source blocks, not inherited context. */
+    linkDecisions?: LinkDecision[];
     qualifiedVersion?: ParsedBillQualifiedVersion;
 };
 export type ParsedBillInternalArticleTarget = {
@@ -106,6 +115,8 @@ export type ParsedBillInternalArticleDefinition = ParsedBillInternalArticleTarge
 };
 export type ParseBillRawOptions = {
     canutesDb?: Sql;
+    /** Explicit resolution date; `date` remains the source document date. */
+    callerDate?: string;
     date?: string;
     includeInternalArticleLinks?: boolean;
     includeDirectiveAnalysis?: boolean;
@@ -113,6 +124,12 @@ export type ParseBillRawOptions = {
     linkBaseUrl: string;
     linkType: LinkType;
     linkedHtml?: string;
+    /** Enable structured decisions when linking, using this stable source document ID. */
+    linkDecisionDocumentId?: string;
+    /** Supply decisions when linkedHtml was produced in an earlier step. */
+    linkDecisions?: LinkDecision[];
+    /** Opt in to rendering consultation decisions in newly linked HTML. */
+    renderLinkDecisions?: boolean;
     logIgnoredReferencesTypes?: boolean;
     logPartialReferences?: boolean;
     logReferences?: boolean;
@@ -122,6 +139,7 @@ export type LinkedBillDocument = {
     documentDate?: string;
     html: string;
     linkedHtml: string;
+    linkDecisions?: LinkDecision[];
 };
 export type ParsedBillDocument = {
     sourceFormat: ParsedBillSourceFormat;
@@ -133,6 +151,7 @@ export type ParsedBillDocument = {
     globalApplicabilityDate?: string;
     internalArticleDefinitions?: ParsedBillInternalArticleDefinition[];
     directives: ParsedBillDirective[];
+    linkDecisions?: LinkDecision[];
     annotations?: ParsedBillAnnotation[];
     diagnostics?: ParsedBillDiagnostic[];
 };

package/dist/{src/lib → lib}/text_parsers/ast.d.ts

@@ -78,6 +78,8 @@ export type TextAstArticle = {
     localizationAdverb?: LocalizationAdverb;
     newOrOld?: "new" | "old";
     ofTheSaid?: boolean;
+    /** Explicit article recall ("article 289 précité"), not a bare amended-text reference. */
+    previouslyCited?: boolean;
     type: "article";
 } & TextAstLocalization & TextAstPosition;
 export type TextAstAtomicReference = TextAstArticle | TextAstDivision | TextAstIncompleteHeader | TextAstPortion | (TextAstText & TextAstPosition);
@@ -167,8 +169,16 @@ export type TextAstText = {
      * Légifrance CID of the text.
      */
     cid?: string;
-    /** Candidate code CIDs for a title shared by historical code editions. */
+    /** Competing publications or code-title CIDs, including excluded alternatives. */
     candidateCids?: string[];
+    /** Publications whose otherwise identical title says "(rectificatif)". */
+    rectificatifCids?: string[];
+    /** Annex qualifier applied to this code, not to the preceding article group. */
+    annex?: string;
+    /** Annex explicitly qualifying a named non-code text; not proof of a separate CID. */
+    publicationAnnex?: string;
+    /** Anaphoric annex ("même annexe"), distinct from "même code". */
+    sameAnnex?: boolean;
     nature: LawNature;
     legislation?: "international" | "UE";
     ofTheSaid?: boolean;
@@ -191,11 +201,11 @@ export type TextInfosByWordsTreeNode = {
     [word: string]: TextInfosByWordsTree;
 };
 export declare const compoundReferencesSeparators: readonly [",", "à", "et", "ou", "sauf"];
-export declare const europeanLawNatures: readonly ["ARRETEEURO", "ARRETEURO", "AVISEURO", "DECISION_EURO", "DECLARATIONEURO", "DELIBERATIONEURO", "DIRECTIVE_EURO", "INFORMATIONEURO", "INSTRUCTIONEURO", "LETTREEURO", "REGLEMENTEUROPEEN"];
+export declare const europeanLawNatures: readonly ["ARRETEEURO", "ARRETEURO", "AVISEURO", "DECISION_EURO", "DECLARATIONEURO", "DELIBERATIONEURO", "DIRECTIVE_EURO", "INFORMATIONEURO", "INSTRUCTIONEURO", "LETTREEURO", "RECOMMANDATIONEURO", "REGLEMENTEUROPEEN"];
 export declare const frenchLawNatures: readonly ["ARRETE", "CIRCULAIRE", "CODE", "CONSTITUTION", "DECRET", "DECRET_LOI", "LOI", "LOI_CONSTIT", "LOI_ORGANIQUE", "ORDONNANCE"];
 export declare const internationalLawNatures: readonly ["CONVENTION"];
 export declare const divisionTypes: readonly ["partie", "livre", "titre", "sous-titre", "chapitre", "section", "sous-section", "paragraphe", "sous-paragraphe", "sous-sous-paragraphe"];
-export declare const lawNatures: readonly ["ARRETEEURO", "ARRETEURO", "AVISEURO", "DECISION_EURO", "DECLARATIONEURO", "DELIBERATIONEURO", "DIRECTIVE_EURO", "INFORMATIONEURO", "INSTRUCTIONEURO", "LETTREEURO", "REGLEMENTEUROPEEN", "ARRETE", "CIRCULAIRE", "CODE", "CONSTITUTION", "DECRET", "DECRET_LOI", "LOI", "LOI_CONSTIT", "LOI_ORGANIQUE", "ORDONNANCE", "CONVENTION"];
+export declare const lawNatures: readonly ["ARRETEEURO", "ARRETEURO", "AVISEURO", "DECISION_EURO", "DECLARATIONEURO", "DELIBERATIONEURO", "DIRECTIVE_EURO", "INFORMATIONEURO", "INSTRUCTIONEURO", "LETTREEURO", "RECOMMANDATIONEURO", "REGLEMENTEUROPEEN", "ARRETE", "CIRCULAIRE", "CODE", "CONSTITUTION", "DECRET", "DECRET_LOI", "LOI", "LOI_CONSTIT", "LOI_ORGANIQUE", "ORDONNANCE", "CONVENTION"];
 /**
  * Portions are elements of an article.
  * "items" is a generic term for lines preceded with a number.

package/dist/lib/text_parsers/historical_versions.d.ts

@@ -0,0 +1,18 @@
+import { TextAstReference } from './ast.js';
+export interface HistoricalVersionQualifier {
+    date: string;
+    range: {
+        start: number;
+        stop: number;
+    };
+    scope: {
+        start: number;
+        stop: number;
+    };
+    /** Preserved when the public scope is mapped back to the source HTML. */
+    transformedScope?: {
+        start: number;
+        stop: number;
+    };
+}
+export declare function historicalVersionQualifiers(input: string, references: TextAstReference[]): Map<TextAstReference, HistoricalVersionQualifier>;

package/dist/{src/lib → lib}/text_parsers/parsers.d.ts

@@ -35,6 +35,8 @@ export type FastPathExtractCandidate = {
 export declare class TextParserContext {
     input: string;
     offset: number;
+    /** Only reference/link search may skip parenthesized repetition qualifiers. */
+    ignoreReferenceRepetitionQualifiers: boolean;
     currentArticle: TextAstArticle | undefined;
     currentText: TextAstText | undefined;
     length: number;

package/dist/{src/lib → lib}/text_parsers/repeated_actions.d.ts

@@ -1,4 +1,5 @@
 import { TextParser } from './parsers.js';
+export declare const referenceRepetitionQualifier: TextParser;
 export declare const repeatedActionQualifier: TextParser<number>;
 export declare function findRepeatedActionCount(text: string): number | null;
 export declare function findRepeatedTargetOccurrenceCount(text: string, position: number): number | null;

package/dist/{src/lib → lib}/text_parsers/texts.d.ts

@@ -1,5 +1,7 @@
 export declare function getTextTitlesInfosInstallationVersion(): number;
 export declare function setTextTitlesInfos(textTitlesInfos: unknown): void;
+/** Code titles actually in force on the date of the citation. */
+export declare function activeCodeTitleCids(cids: string[], date: string): string[];
 /** Keep the successive titles of one CID together when ranking code editions. */
 export declare function rankCodeTitleCids(cids: string[], date: string): string[];
 /**
@@ -53,3 +55,13 @@ export declare const natureTexteEuropeen: import('./parsers.js').TextParser<impo
 export declare const texteEuropeen: import('./parsers.js').TextParser<import('./ast.js').TextAst>;
 export declare const texteInternational: import('./parsers.js').TextParser<import('./ast.js').TextAst>;
 export declare const texte: import('./parsers.js').TextParser<import('./ast.js').TextAst>;
+/** Annex labels share the existing number, typography and liaison grammars. */
+export declare const designationAnnexe: import('./parsers.js').TextParser<import('./ast.js').TextAst>;
+/** A postposed annex qualifier is a text parent, never an article of the code. */
+export declare const annexeCode: import('./parsers.js').TextParser<import('./ast.js').TextAst>;
+/** Preserve the named text's annex qualifier independently of its storage:
+ * it can be an article of the text or a separately published component. */
+export declare const annexeTexte: import('./parsers.js').TextParser<import('./ast.js').TextAst>;
+/** Only a complete catalogue title proves an autonomous annex CID. An annex
+ * stored inside its code must not silently become the principal code's CID. */
+export declare function codeAnnexCids(codeCid: string | undefined, annex: string): string[];

package/dist/link-decision-metadata.js

@@ -0,0 +1,32 @@
+//#region src/lib/linkers/link_decision_metadata.ts
+var e = ["data-tisseuse-warning", "data-tisseuse-candidates"], t = {
+	article: {
+		linked: "lien_article_externe",
+		undecidable: "reference_article_indecidable"
+	},
+	text: {
+		linked: "lien_texte_externe",
+		undecidable: "reference_texte_indecidable"
+	}
+}, n = new Set([
+	"article_futur_a_date_reference",
+	"article_abroge_avant_date_reference",
+	"indice_structurel",
+	"composant_publication",
+	"structure_absente",
+	"reference_historique_explicite",
+	"plusieurs_candidats_indepartageables",
+	"cid_non_etabli",
+	"donnees_insuffisantes"
+]), r = {
+	article: /^(?:LEGIARTI|JORFARTI)\d{12}$/,
+	text: /^(?:LEGITEXT|JORFTEXT)\d{12}$/
+};
+function i(e) {
+	return n.has(e);
+}
+function a(e, t) {
+	return r[e].test(t);
+}
+//#endregion
+export { a as isLinkDecisionCandidateId, i as isLinkDecisionWarning, e as linkDecisionMetadataAttributes, t as linkDecisionReferenceClasses };