@tricoteuses/tisseuse 0.21.1 → 0.22.0

package/dist/{src/lib → lib}/extractors/article_portions.d.ts

@@ -48,6 +48,20 @@ export interface ArticlePortionAlinea {
     htmlStart?: number;
     htmlStop?: number;
     lineIndex?: number;
+    /** Quotation marks around a table belong to this alinéa, but its HTML
+     * offsets still designate the table itself for portion edits. */
+    tableQuotation?: {
+        opening: {
+            html: string;
+            htmlStart: number;
+            htmlStop: number;
+        };
+        closing: {
+            html: string;
+            htmlStart: number;
+            htmlStop: number;
+        };
+    };
 }
 export interface ArticlePortionPhrase {
     type: "phrase";

package/dist/{src/lib → lib}/extractors/links.d.ts

@@ -1,5 +1,7 @@
 import { Sql } from 'postgres';
 import { ReferenceParsingMode } from './references.js';
+import { HistoricalVersionQualifier } from '../text_parsers/historical_versions.js';
+import { NamedTextArticleTarget } from '../legi/named_text_article.js';
 import { LegiResolver } from '../legi/resolver.js';
 import { TextAstArticle, TextAstDivision, TextAstPosition, TextAstReference, TextAstText } from '../text_parsers/ast.js';
 import { FragmentPosition, FragmentReverseTransformation } from '../text_parsers/fragments.js';
@@ -26,6 +28,10 @@ export interface ArticleDefinition {
 export interface ArticleExternalLink {
     article: TextAstArticle;
     articleId?: string;
+    /** A direct version selected by an explicit historical drafting qualifier. */
+    historicalQualifiedArticle?: boolean;
+    /** Present (possibly empty) only for a uniquely selected future consultation. */
+    futureAlternativeArticleIds?: string[];
     /**
      * Defined only when no version of the cited article number is active at the
      * reference date and the number has a single version chain in the cited
@@ -89,6 +95,11 @@ export interface TextEuropeanLink {
     url?: string;
 }
 export interface TextExternalLink {
+    publicationComponentCids?: string[];
+    /** Article embedded in a named-text citation, resolved before rendering. */
+    namedArticle?: NamedTextArticleTarget & {
+        num: string;
+    };
     /**
      * Only defined when a transformation was used to convert input text
      * to simplified text.
@@ -100,8 +111,103 @@ export interface TextExternalLink {
     type: "external_text";
 }
 export type TextLink = TextEuropeanLink | TextExternalLink;
+/** A source span, before rendering, identifies a citation even when its URL is shared. */
+export interface LinkOccurrence {
+    documentId: string;
+    blockId?: string;
+    insideFrenchQuotes?: boolean;
+    sourceStart: number;
+    sourceStop: number;
+}
+export type LinkDecisionReason = "composant_publication" | "article_futur_a_date_reference" | "article_abroge_avant_date_reference" | "indice_structurel" | "structure_absente" | "reference_historique_explicite" | "publication_rectificative" | "plusieurs_candidats_indepartageables" | "cid_non_etabli" | "donnees_insuffisantes" | "hors_perimetre";
+export interface LinkDecisionCandidate {
+    kind: "article" | "text";
+    id: string;
+    cid: string;
+    debut?: string;
+    fin?: string;
+    role: "retenu" | "alternatif" | "ecarte";
+    reasons: LinkDecisionReason[];
+}
+export interface LinkDecision {
+    occurrence: LinkOccurrence;
+    kind: LinkDecisionEvidence["kind"];
+    recognition: "reconnue" | "sans_candidat" | "non_prise_en_charge" | "non_reconnue";
+    date: {
+        value: string;
+        source: "appelant" | "qualification" | "document" | "aujourdhui";
+        qualifierRange?: {
+            start: number;
+            stop: number;
+        };
+    };
+    textCids: string[];
+    candidates: LinkDecisionCandidate[];
+    consultationId?: string;
+    warnings: LinkDecisionReason[];
+    projection: {
+        mode: "etablie";
+        targetIds: string[];
+    } | {
+        mode: "indicative";
+        candidateIds: string[];
+    } | {
+        mode: "aucune";
+    };
+}
+export interface LinkDecisionEvidence {
+    /** Consultation established by published-component structure, not projection. */
+    publicationComponent?: boolean;
+    kind: "article" | "text" | "european_text";
+    occurrence: LinkOccurrence;
+    callerDate?: string;
+    documentDate?: string;
+    /** A qualifier only governs the citation whose source span lies within its scope. */
+    qualifier?: {
+        date: string;
+        range: {
+            start: number;
+            stop: number;
+        };
+        scope: {
+            start: number;
+            stop: number;
+        };
+    };
+    /** The CONTEXTE text CID, or a text CID explicitly established by the citation. */
+    textCid?: string;
+    textCids?: string[];
+    /** Explicitly labelled rectificatifs of the selected original publication. */
+    rectificatifCids?: string[];
+    /** Selected using the law-specific LEGI/exceptional JORF rule. */
+    lawArticleTargetId?: string;
+    /** No law version satisfied the selection rule. */
+    lawArticleUnresolved?: boolean;
+    /** Evidence from a resolver; an empty list is distinct from unavailable evidence. */
+    candidates?: Array<{
+        kind: "article" | "text";
+        id: string;
+        cid: string;
+        debut?: string;
+        fin?: string;
+        /** SCTA can qualify a collision but cannot override CONTEXTE. */
+        structure?: "valable" | "absente" | "invalide";
+        abrogationVerified?: boolean;
+    }>;
+    recognized?: boolean;
+}
+export interface LinkDecisionObserver {
+    documentId: string;
+    blockId?: string;
+    onDecision: (decision: LinkDecision) => void;
+}
+/** Pure, opt-in oracle. Neither legacy link fields nor renderer output use it yet. */
+export declare function decideLinkOccurrence(evidence: LinkDecisionEvidence): LinkDecision;
 export interface TextLinksParserState {
     articleId?: string;
+    historicalQualifier?: HistoricalVersionQualifier;
+    /** Multiple code-title CIDs contain the cited active article; no text is established. */
+    ambiguousCodeTitleCids?: string[];
     codeId?: string;
     constitutionId?: string;
     decreeId?: string;
@@ -147,10 +253,15 @@ type TextLinksIterationDiagnostics = {
     textLinkCount: number;
     textLinkMs: number;
 };
-export declare function extractTextLinks({ canutesDb, context, date, includeInternalArticleLinks, legiResolver: providedLegiResolver, logIgnoredReferencesTypes, logPartialReferences, logReferences, parsingMode, state: inputState, transformation, }: {
+export declare function extractTextLinks({ canutesDb, callerDate, context, date: documentDate, decisionObserver, extraReferences, includeInternalArticleLinks, legiResolver: providedLegiResolver, logIgnoredReferencesTypes, logPartialReferences, logReferences, parsingMode, state: inputState, transformation, }: {
     canutesDb?: Sql;
+    /** An explicitly requested resolution date overrides a date quoted in the source. */
+    callerDate?: string;
     context: TextParserContext;
     date: string;
+    decisionObserver?: LinkDecisionObserver;
+    /** HTML table-cell references qualified by their column heading. */
+    extraReferences?: TextAstReference[];
     includeInternalArticleLinks?: boolean;
     legiResolver?: LegiResolver;
     logIgnoredReferencesTypes?: boolean;
@@ -165,13 +276,16 @@ export declare function extractTextLinks({ canutesDb, context, date, includeInte
     state?: TextLinksParserState;
     transformation?: Transformation;
 }): AsyncGenerator<DefinitionOrLink, void>;
-export declare function iterReferenceLinks({ articleDefinitionByNumByTextId: articleDefinitionByNumByTextIdInput, inOriginalCitation, includeInternalArticleLinks, legiResolver, context, date, logIgnoredReferencesTypes, logPartialReferences, originalPositionsFromTransformedIterator, reference, iterationDiagnostics: inputIterationDiagnostics, resolverDiagnostics: inputResolverDiagnostics, state: inputState, }: {
-    articleDefinitionByNumByTextId?: Record<string, Record<string, ArticleDefinition>>;
+export declare function iterReferenceLinks({ articleDefinitionByNumByTextId: articleDefinitionByNumByTextIdInput, callerDate, inOriginalCitation, includeInternalArticleLinks, legiResolver, context, date: inputDate, decisionObserver, documentDate, logIgnoredReferencesTypes, logPartialReferences, originalPositionsFromTransformedIterator, reference, iterationDiagnostics: inputIterationDiagnostics, resolverDiagnostics: inputResolverDiagnostics, state: inputState, }: {
+    articleDefinitionByNumByTextId?: Record<string, Record<string, ArticleDefinition[]>>;
+    callerDate?: string;
     inOriginalCitation?: boolean;
     includeInternalArticleLinks?: boolean;
     legiResolver: LegiResolver;
     context: TextParserContext;
     date: string;
+    decisionObserver?: LinkDecisionObserver;
+    documentDate?: string;
     logIgnoredReferencesTypes?: boolean;
     logPartialReferences?: boolean;
     originalPositionsFromTransformedIterator?: Generator<FragmentReverseTransformation, void, FragmentPosition | undefined>;

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

@@ -1,16 +1,20 @@
 import { Sql } from 'postgres';
-import { LegiResolver, LegiArticleInfo, LegiSectionInfo, PreloadActiveArticlesByTextIdsOptions, PreloadTextTitlesInfosOptions } from '../legi/resolver.js';
+import { LegiResolver, LegiArticleAbrogationProof, LegiArticleInfo, LegiArticleHistoryInfo, LegiArticleStructureProof, LegiSectionInfo, PreloadActiveArticlesByTextIdsOptions, PreloadTextTitlesInfosOptions } from '../legi/resolver.js';
 export type FlegiArticleInfo = LegiArticleInfo;
 export type FlegiSectionInfo = LegiSectionInfo;
 export declare function checkFlegiResolverDatabase(flegiDb: Sql): Promise<void>;
 export declare class FlegiResolver extends LegiResolver {
     private readonly flegiDb;
+    private readonly articleHistoryInfoByTextAndNum;
+    getArticleHistoryInfo({ num, textId, }: {
+        num: string | undefined;
+        textId: string;
+    }): Promise<LegiArticleHistoryInfo | undefined>;
     private readonly articleRowsByNumByTextAndDate;
     private readonly articleNumsLoadedByTextAndDate;
     private readonly articleRowsByContextTextId;
     private readonly directSectionChildrenByParentAndDate;
-    private readonly directSectionChildrenLoadedRootsAndDate;
-    private readonly directSectionChildrenRootPromises;
+    private readonly directSectionChildrenParentPromises;
     private readonly globalArticleRowsByNumAndDate;
     private readonly rootTextIdsByTextId;
     private readonly contextTextIdsByTextId;
@@ -23,6 +27,21 @@ export declare class FlegiResolver extends LegiResolver {
         num: string | undefined;
         textId: string;
     }): Promise<FlegiArticleInfo[]>;
+    getLawArticleType({ articleId, textId, }: {
+        articleId: string;
+        textId: string;
+    }): Promise<"AUTONOME" | "ENTIEREMENT_MODIF" | "PARTIELLEMENT_MODIF" | undefined>;
+    getVerifiedPublicationComponents(candidateCids: string[]): Promise<import('../legi/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>;
     getDirectSectionChildren({ date, parentPath, }: {
         date: string;
         parentPath: string;
@@ -47,7 +66,7 @@ export declare class FlegiResolver extends LegiResolver {
     private getActiveArticleRowsByNum;
     private getActiveArticleRowsForContextTextIdsWithRoots;
     private queryActiveArticleRowsForContextTextIds;
-    private preloadDirectSectionChildrenByRootPath;
+    private preloadDirectSectionChildrenByParentPath;
     private getTextIdFromSegmentIdUsingContextHeuristic;
     private getTextIdFromSegmentIdUsingSctaHeuristic;
     private getContextTextIdsByTextIds;

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

@@ -0,0 +1,25 @@
+import { LegiArticleAbrogationProof, LegiArticleInfo } from './resolver.js';
+export type ArticleAbrogationRow = {
+    id: string;
+    num: string | null;
+    textId: string | null;
+    dateDebut: string | null;
+    dateFin: string | null;
+    etat: string | null;
+    versions: {
+        id: string;
+        dateDebut: string | null;
+        dateFin: string | null;
+        etat?: string | null;
+    }[] | null;
+};
+/** Only a complete, unique chain matching the actual resolver's candidates
+ * within the same read-only snapshot can certify an expired version. */
+export declare function verifyArticleAbrogation({ candidates, date, missingContext, num, rows, textId, }: {
+    candidates: LegiArticleInfo[];
+    date: string;
+    missingContext: number;
+    num: string;
+    rows: ArticleAbrogationRow[];
+    textId: string;
+}): LegiArticleAbrogationProof | undefined;

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

@@ -0,0 +1,11 @@
+import { LegiArticleHistoryInfo } from './resolver.js';
+/** Minimal view of an article and its declared version chain. */
+export interface ArticleHistorySourceRow {
+    dateDebut: string | null;
+    id: string;
+    versions: {
+        VERSION?: unknown;
+    } | null;
+}
+/** Return the latest entry point only when every row declares the same chain. */
+export declare function articleHistoryInfoFromRows(rows: ArticleHistorySourceRow[]): LegiArticleHistoryInfo | undefined;

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

@@ -0,0 +1,9 @@
+import { LegiArticleInfo, LegiArticleStructureProof } from './resolver.js';
+export type DatedStructureLink = {
+    dateDebut: string | null;
+    dateFin: string | null;
+};
+/** A missing, duplicated or malformed edge is not evidence against a candidate. */
+export declare function structureStatusFromCompletePath(links: DatedStructureLink[] | undefined, date: string): "valable" | "invalide" | undefined;
+/** The snapshot contains the same candidates as its structural evidence. */
+export declare function verifiedArticleStructureProof(candidates: LegiArticleInfo[], paths: Map<string, DatedStructureLink[] | undefined>, date: string, textId: string, num: string): LegiArticleStructureProof | undefined;

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[];