@tricoteuses/tisseuse 0.12.10 → 0.13.0

package/dist/src/lib/extractors/action_directives.d.ts

@@ -1,5 +1,5 @@
 import { PortionSelector } from './article_portions.js';
-import { ActionTarget, TextAstReference } from '../text_parsers/ast.js';
+import { ActionTarget, TextAstActionDirective, TextAstReference } from '../text_parsers/ast.js';
 import { FragmentPosition } from '../text_parsers/fragments.js';
 export type ActionReplacement = {
     type: "text";
@@ -17,29 +17,76 @@ export type ActionTableTarget = {
     rowIndex?: number;
     columnIndex?: number;
 };
-export type ActionDirective = {
+export type ActionInsertLayout = "block" | "inline";
+export type ActionReplacementLayout = ActionInsertLayout;
+export type ActionTargetScope = {
+    type: "tail_after_target";
+    unit?: "phrase" | "alinéa" | "article";
+};
+type ActionOperationTarget = {
+    targetType?: ActionTarget;
+    reference?: TextAstReference;
+    portionSelectors?: PortionSelector[];
+};
+type ActionDirectiveCommon = {
+    applicabilityDate?: string;
+    sourcePosition: FragmentPosition;
+    sourceText: string;
+};
+export type ActionOperation = (ActionOperationTarget & {
+    kind: "insert_after" | "insert_before";
+    targetText: string;
+    insertText: string;
+    insertLayout?: ActionInsertLayout;
+    citation?: ActionCitation;
+    tableTarget?: ActionTableTarget;
+}) | (ActionOperationTarget & {
+    kind: "replace_portion";
+    replacementText: string;
+    replacement: ActionReplacement;
+    replacementLayout?: ActionReplacementLayout;
+    citation?: ActionCitation;
+    tableTarget?: ActionTableTarget;
+}) | (ActionOperationTarget & {
+    kind: "replace";
+    targetText: string;
+    replacementText: string;
+    replacement: ActionReplacement;
+    targetScope?: ActionTargetScope;
+    tableTarget?: ActionTableTarget;
+}) | (ActionOperationTarget & {
+    kind: "delete";
+    targetText: string;
+    targetScope?: ActionTargetScope;
+    occurrenceIndex?: number;
+    tableTarget?: ActionTableTarget;
+}) | (ActionOperationTarget & {
+    kind: "delete_portion";
+    tableTarget?: ActionTableTarget;
+}) | (ActionOperationTarget & {
+    kind: "delete_article";
+});
+export type ResolvedActionDirective = (ActionDirectiveCommon & {
     kind: "insert_after" | "insert_before";
     targetType: ActionTarget;
     reference: TextAstReference;
     portionSelectors: PortionSelector[];
     targetText: string;
     insertText: string;
+    insertLayout?: ActionInsertLayout;
     citation?: ActionCitation;
     tableTarget?: ActionTableTarget;
-    sourcePosition: FragmentPosition;
-    sourceText: string;
-} | {
+}) | (ActionDirectiveCommon & {
     kind: "replace_portion";
     targetType: ActionTarget;
     reference: TextAstReference;
     portionSelectors: PortionSelector[];
     replacementText: string;
     replacement: ActionReplacement;
+    replacementLayout?: ActionReplacementLayout;
     citation?: ActionCitation;
     tableTarget?: ActionTableTarget;
-    sourcePosition: FragmentPosition;
-    sourceText: string;
-} | {
+}) | (ActionDirectiveCommon & {
     kind: "replace";
     targetType: ActionTarget;
     reference: TextAstReference;
@@ -47,34 +94,49 @@ export type ActionDirective = {
     targetText: string;
     replacementText: string;
     replacement: ActionReplacement;
+    targetScope?: ActionTargetScope;
     tableTarget?: ActionTableTarget;
-    sourcePosition: FragmentPosition;
-    sourceText: string;
-} | {
+}) | (ActionDirectiveCommon & {
     kind: "delete";
     targetType: ActionTarget;
     reference: TextAstReference;
     portionSelectors: PortionSelector[];
     targetText: string;
+    targetScope?: ActionTargetScope;
     occurrenceIndex?: number;
     tableTarget?: ActionTableTarget;
-    sourcePosition: FragmentPosition;
-    sourceText: string;
-} | {
+}) | (ActionDirectiveCommon & {
     kind: "delete_portion";
     targetType: ActionTarget;
     reference: TextAstReference;
     portionSelectors: PortionSelector[];
     tableTarget?: ActionTableTarget;
-    sourcePosition: FragmentPosition;
-    sourceText: string;
-} | {
+}) | (ActionDirectiveCommon & {
     kind: "delete_article";
     targetType: "article";
     reference: TextAstReference;
     portionSelectors: PortionSelector[];
-    sourcePosition: FragmentPosition;
-    sourceText: string;
-};
-export declare function extractActionDirectivesFromText(text: string): ActionDirective[];
-export declare function extractActionDirectivesFromHtml(html: string): ActionDirective[];
+}) | (ActionDirectiveCommon & {
+    kind: "compound";
+    targetType: ActionTarget;
+    reference: TextAstReference;
+    portionSelectors: PortionSelector[];
+    operations: ActionOperation[];
+});
+/**
+ * @deprecated Use ResolvedActionDirective for resolved, projection-ready
+ * directives. TextAstActionDirective is the generic parser AST.
+ */
+export type ActionDirective = ResolvedActionDirective;
+export declare function extractActionDirectiveAstsFromText(text: string): TextAstActionDirective[];
+export declare function resolveActionDirectivesFromText(text: string): ActionDirective[];
+/**
+ * @deprecated Use resolveActionDirectivesFromText.
+ */
+export declare const extractActionDirectivesFromText: typeof resolveActionDirectivesFromText;
+export declare function resolveActionDirectivesFromHtml(html: string): ActionDirective[];
+/**
+ * @deprecated Use resolveActionDirectivesFromHtml.
+ */
+export declare const extractActionDirectivesFromHtml: typeof resolveActionDirectivesFromHtml;
+export {};

package/dist/src/lib/extractors/article_portions.d.ts

@@ -15,7 +15,7 @@ export type PortionSelector = {
     last: PortionSelectorStep[];
     count?: number;
 };
-export type ArticlePortionNode = ArticlePortionArticle | ArticlePortionDivision | ArticlePortionItem | ArticlePortionAlinea;
+export type ArticlePortionNode = ArticlePortionArticle | ArticlePortionDivision | ArticlePortionItem | ArticlePortionAlinea | ArticlePortionPhrase;
 export interface ArticlePortionArticle {
     type: "article";
     children: ArticlePortionNode[];
@@ -40,6 +40,19 @@ export interface ArticlePortionAlinea {
     text: string;
     html: string;
     paragraphIndex: number;
+    htmlStart?: number;
+    htmlStop?: number;
+    lineIndex?: number;
+}
+export interface ArticlePortionPhrase {
+    type: "phrase";
+    index: number;
+    text: string;
+    html: string;
+    paragraphIndex: number;
+    htmlStart?: number;
+    htmlStop?: number;
+    alinea: ArticlePortionAlinea;
 }
 export type ArticlePortionMatch = {
     selector: PortionSelector;
@@ -55,6 +68,7 @@ export type ArticlePortionMatch = {
 export declare const ITEM_PREFIX_RE: RegExp;
 export declare const BARE_ITEM_PREFIX_RE: RegExp;
 export declare function isRomanNumeral(token: string): boolean;
+export declare function isArticlePortionStructuralStart(text: string): boolean;
 export declare function buildArticlePortionTreeFromHtml(html: string): ArticlePortionArticle;
 export declare function extractPortionSelectors(reference: TextAstReference): PortionSelector[];
 export declare function resolvePortionSelector(article: ArticlePortionArticle, selector: PortionSelector): ArticlePortionMatch | null;

package/dist/src/lib/extractors/references.d.ts

@@ -2,7 +2,9 @@ import { TextAstCitation, TextAstReference } from '../text_parsers/ast.js';
 import { TextParserContext } from '../text_parsers/parsers.js';
 import { Transformation } from '../text_parsers/transformers.js';
 export declare function extractCitationReferences(context: TextParserContext, citation: TextAstCitation): Generator<TextAstReference, void>;
-export declare function extractReferences(context: TextParserContext): Generator<TextAstReference, void>;
+export declare function extractReferences(context: TextParserContext, options?: {
+    overlapWindowForCandidate?: (anchor: string) => number;
+}): Generator<TextAstReference, void>;
 export declare function extractReferencesWithOriginalTransformations(context: TextParserContext, transformation: Transformation): Generator<TextAstReference, void>;
 export declare const getExtractedReferences: (context: TextParserContext) => TextAstReference[];
 export declare const getExtractedReferencesWithOriginalTransformations: (context: TextParserContext, transformation: Transformation) => TextAstReference[];

package/dist/src/lib/extractors/table_of_contents.d.ts

@@ -7,6 +7,7 @@ export interface TableOfContents {
     divisions?: TableOfContentsDivision[];
 }
 export interface TableOfContentsArticle {
+    id?: string;
     line: string;
     type: "article";
 }
@@ -17,6 +18,7 @@ export type TableOfContentsArticlePositioned = TableOfContentsArticle & {
 export interface TableOfContentsDivision {
     articles?: TableOfContentsArticle[];
     divisions?: TableOfContentsDivision[];
+    id?: string;
     line: string;
     type: DivisionType;
 }

package/dist/src/lib/f_legi/extractors/links.d.ts

@@ -0,0 +1,134 @@
+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';
+import { TextParserContext } from '../../text_parsers/parsers.js';
+import { Transformation } from '../../text_parsers/transformers.js';
+export type DefinitionOrLink = ArticleDefinition | ArticleLink | DivisionLink | TextLink;
+export interface ArticleDefinition {
+    article: TextAstArticle;
+    /**
+     * Same value as article.originalTransformation, added for homogeneity
+     *
+     * Only defined when a transformation was used to convert input text
+     * to simplified text.
+     */
+    originalTransformation?: FragmentReverseTransformation;
+    /**
+     * Same value as article.position, added for homogeneity
+     */
+    position: FragmentPosition;
+    reference: TextAstReference;
+    textId: string;
+    type: "article_definition";
+}
+export interface ArticleExternalLink {
+    article: TextAstArticle;
+    articleId?: string;
+    /**
+     * Only defined when a transformation was used to convert input text
+     * to simpeurolified text.
+     */
+    originalTransformation?: FragmentReverseTransformation;
+    position: FragmentPosition;
+    reference: TextAstReference;
+    type: "external_article";
+}
+export interface ArticleInternalLink {
+    article: TextAstArticle;
+    definition: ArticleDefinition;
+    /**
+     * Only defined when a transformation was used to convert input text
+     * to simplified text.
+     */
+    originalTransformation?: FragmentReverseTransformation;
+    position: FragmentPosition;
+    reference: TextAstReference;
+    type: "internal_article";
+}
+export type ArticleLink = ArticleExternalLink | ArticleInternalLink;
+export interface DivisionExternalLink {
+    division: TextAstDivision;
+    /**
+     * Only defined when a transformation was used to convert input text
+     * to simplified text.
+     */
+    originalTransformation?: FragmentReverseTransformation;
+    position: FragmentPosition;
+    reference: TextAstReference;
+    sectionTaId?: string;
+    type: "external_division";
+}
+export type DivisionLink = DivisionExternalLink;
+export interface ExtractedLinkDb {
+    field_name: string;
+    index: number;
+    link: ArticleExternalLink | DivisionExternalLink | TextEuropeanLink | TextExternalLink;
+    source_id: string;
+    target_id: string | null;
+}
+export interface TextEuropeanLink {
+    /**
+     * Only defined when a transformation was used to convert input text
+     * to simplified text.
+     */
+    originalTransformation?: FragmentReverseTransformation;
+    position: FragmentPosition;
+    reference: TextAstReference;
+    text: TextAstText & TextAstPosition;
+    titleId: string;
+    type: "european_text";
+    url?: string;
+}
+export interface TextExternalLink {
+    /**
+     * Only defined when a transformation was used to convert input text
+     * to simplified text.
+     */
+    originalTransformation?: FragmentReverseTransformation;
+    position: FragmentPosition;
+    reference: TextAstReference;
+    text: TextAstText & TextAstPosition;
+    type: "external_text";
+}
+export type TextLink = TextEuropeanLink | TextExternalLink;
+export interface TextLinksParserState {
+    articleId?: string;
+    codeId?: string;
+    constitutionId?: string;
+    decreeId?: string;
+    defaultTextId?: string;
+    lawId?: string;
+    sectionTaId?: string;
+    textId?: string;
+}
+export declare function extractTextLinks({ context, date, flegiResolver, logIgnoredReferencesTypes, logPartialReferences, logReferences, state: inputState, transformation, }: {
+    context: TextParserContext;
+    date: string;
+    flegiResolver: LegiResolver;
+    logIgnoredReferencesTypes?: boolean;
+    logPartialReferences?: boolean;
+    logReferences?: boolean;
+    /**
+     * When given, state is modified by this generator, so that the callers
+     * always has the latest state version (and can reuse it for the next article,
+     * for example).
+     */
+    state?: TextLinksParserState;
+    transformation?: Transformation;
+}): AsyncGenerator<DefinitionOrLink, void>;
+export declare function iterReferenceLinks({ articleDefinitionByNumByTextId: articleDefinitionByNumByTextIdInput, flegiResolver, context, date, logIgnoredReferencesTypes, logPartialReferences, originalPositionsFromTransformedIterator, reference, state: inputState, }: {
+    articleDefinitionByNumByTextId?: Record<string, Record<string, ArticleDefinition>>;
+    flegiResolver: LegiResolver;
+    context: TextParserContext;
+    date: string;
+    logIgnoredReferencesTypes?: boolean;
+    logPartialReferences?: boolean;
+    originalPositionsFromTransformedIterator?: Generator<FragmentReverseTransformation, void, FragmentPosition | undefined>;
+    reference: TextAstReference;
+    /**
+     * When given, state is modified by this generator, so that the callers
+     * always has the latest state version (and can reuse it for the next article,
+     * for example).
+     */
+    state?: TextLinksParserState;
+}): AsyncGenerator<DefinitionOrLink>;

package/dist/src/lib/f_legi/linkers/html.d.ts

@@ -0,0 +1,51 @@
+import { DefinitionOrLink, TextLinksParserState } from '../extractors/links.js';
+import { LegiResolver } from '../../legi/resolver.js';
+import { LinkType } from '../../links.js';
+import { TextParserContext } from '../../text_parsers/parsers.js';
+import { Transformation } from '../../text_parsers/transformers.js';
+export declare function addLinksToHtml({ legiResolver, date, html, linkBaseUrl, linkType, logIgnoredReferencesTypes, logPartialReferences, logReferences, onLink, previousContext, state, }: {
+    legiResolver: LegiResolver;
+    date: string;
+    html: string;
+    linkBaseUrl: string;
+    linkType: LinkType;
+    logIgnoredReferencesTypes?: boolean;
+    logPartialReferences?: boolean;
+    logReferences?: boolean;
+    onLink?: (link: DefinitionOrLink, index: number) => Promise<boolean | void>;
+    previousContext?: TextParserContext;
+    state?: TextLinksParserState;
+}): Promise<{
+    context: TextParserContext;
+    output: string | null;
+}>;
+export type OutputByType = Partial<Record<OutputType, {
+    html: string;
+    offset: number;
+    replacements: HtmlReplacement[];
+}>>;
+export type OutputType = "links" | "links_or_references" | "references";
+interface HtmlReplacement {
+    order: number;
+    replacement: string;
+    start: number;
+    stop: number;
+}
+export declare function addLinksOrReferencesToHtmlPage({ legiResolver, date, defaultTextId, htmlTransformation, inputHtml, linkBaseUrl, linkType, logIgnoredReferencesTypes, logPartialReferences, logReferences, outputTypes: requestedOutputTypes, referredLegifranceTextsInfos, }: {
+    legiResolver: LegiResolver;
+    date: string;
+    defaultTextId?: string;
+    htmlTransformation: Transformation;
+    inputHtml: string;
+    linkBaseUrl: string;
+    linkType: LinkType;
+    logIgnoredReferencesTypes?: boolean;
+    logPartialReferences?: boolean;
+    logReferences?: boolean;
+    outputTypes: OutputType[];
+    referredLegifranceTextsInfos?: boolean;
+}): Promise<{
+    outputByType: OutputByType;
+    referredLegifranceTextCountByCid: Record<string, number>;
+}>;
+export {};

package/dist/src/lib/f_legi/resolver.d.ts

@@ -0,0 +1,54 @@
+import { Sql } from 'postgres';
+import { LegiArticleInfo, LegiResolver, LegiSectionInfo, PreloadTextTitlesInfosOptions } from '../legi/resolver.js';
+export type FlegiArticleInfo = LegiArticleInfo;
+export type FlegiSectionInfo = LegiSectionInfo;
+export declare class FlegiResolver implements LegiResolver {
+    private readonly flegiDb;
+    private readonly articleRowsByNumByTextAndDate;
+    private readonly articleNumsLoadedByTextAndDate;
+    private readonly articleRowsByContextTextId;
+    private readonly directSectionChildrenByParentAndDate;
+    private readonly globalArticleRowsByNumAndDate;
+    private readonly rootTextIdsByTextId;
+    private readonly contextTextIdsByTextId;
+    private readonly textIdBySegmentId;
+    private textTitlesInfosLoaded;
+    constructor(flegiDb: Sql);
+    getActiveArticlesByTextAndNum({ date, num, textId, }: {
+        date: string;
+        num: string | undefined;
+        textId: string;
+    }): Promise<FlegiArticleInfo[]>;
+    getDirectSectionChildren({ date, parentPath, }: {
+        date: string;
+        parentPath: string;
+    }): Promise<FlegiSectionInfo[]>;
+    getTextIdFromSegmentId(segmentId: string): Promise<string | undefined>;
+    preloadTextTitlesInfos(options?: PreloadTextTitlesInfosOptions): Promise<void>;
+    getUniqueActiveArticlesByNum({ date, num, }: {
+        date: string;
+        num: string | undefined;
+    }): Promise<FlegiArticleInfo[]>;
+    preloadUniqueActiveArticlesByNums({ date, nums, }: {
+        date: string;
+        nums: Iterable<string | undefined>;
+    }): Promise<void>;
+    preloadActiveArticlesByTextIds({ date, nums, textIds, }: {
+        date: string;
+        nums?: Iterable<string | undefined>;
+        textIds: Iterable<string | undefined>;
+    }): Promise<void>;
+    private queryUniqueActiveArticlesByNumsUsingContextHeuristic;
+    private queryGloballyUniqueArticleRowsByNums;
+    private getActiveArticleRowsByNum;
+    private getActiveArticleRowsForContextTextIds;
+    private getActiveArticleRowsForContextTextIdsWithRoots;
+    private queryActiveArticleRowsForContextTextIds;
+    private getDirectSectionChildrenByExactParentPath;
+    private getTextIdFromSegmentIdUsingContextHeuristic;
+    private getTextIdFromSegmentIdUsingSctaHeuristic;
+    private getContextTextIdsFromTextId;
+    private getContextTextIdsByTextIds;
+    private getRootTextIdsFromTextId;
+    private getRootTextIdsByTextIds;
+}

package/dist/src/lib/index.d.ts

@@ -4,10 +4,10 @@ export { assertNever } from './asserts.js';
 export { newAssembleeObjectCache, newLegifranceObjectCache, newObjectCache, type AssembleeObjectCache, type AssembleeObjectType, type LegifranceObjectCache, type ObjectCache, } from './cache.js';
 export { formatLongDate } from './dates.js';
 export { extractBillDefinitions } from './extractors/definitions.js';
-export { extractActionDirectivesFromHtml, extractActionDirectivesFromText, type ActionCitation, type ActionDirective, type ActionReplacement, type ActionTableTarget, } from './extractors/action_directives.js';
+export { extractActionDirectivesFromHtml, extractActionDirectiveAstsFromText, extractActionDirectivesFromText, resolveActionDirectivesFromHtml, resolveActionDirectivesFromText, type ActionCitation, type ActionDirective, type ActionOperation, type ActionReplacement, type ActionTableTarget, type ResolvedActionDirective, } from './extractors/action_directives.js';
 export { extractTextLinks, iterReferenceLinks, type ArticleDefinition, type ArticleExternalLink, type ArticleInternalLink, type ArticleLink, type DefinitionOrLink, type DivisionExternalLink, type DivisionLink, type ExtractedLinkDb, type TextEuropeanLink, type TextExternalLink, type TextLink, type TextLinksParserState, } from './extractors/links.js';
 export { extractCitationReferences, extractReferences, extractReferencesWithOriginalTransformations, getExtractedReferences, getExtractedReferencesWithOriginalTransformations, } from './extractors/references.js';
-export { buildArticlePortionTreeFromHtml, extractPortionSelectors, resolvePortionSelector, type ArticlePortionArticle, type ArticlePortionDivision, type ArticlePortionItem, type ArticlePortionAlinea, type ArticlePortionMatch, type ArticlePortionNode, type PortionSelector, type PortionSelectorStep, } from './extractors/article_portions.js';
+export { buildArticlePortionTreeFromHtml, extractPortionSelectors, isArticlePortionStructuralStart, resolvePortionSelector, type ArticlePortionArticle, type ArticlePortionDivision, type ArticlePortionItem, type ArticlePortionAlinea, type ArticlePortionPhrase, type ArticlePortionMatch, type ArticlePortionNode, type PortionSelector, type PortionSelectorStep, } from './extractors/article_portions.js';
 export { addPositionsToTableOfContentsItems, getExtractedTableOfContentsFromTextBill, walkTableOfContents, type TableOfContents, type TableOfContentsArticle, type TableOfContentsArticlePositioned, type TableOfContentsDivision, type TableOfContentsDivisionPositioned, type TableOfContentsPositioned, } from './extractors/table_of_contents.js';
 export { jsonReplacer } from './json.js';
 export { addLinksToHtml, addLinksOrReferencesToHtmlPage, type OutputByType, type OutputType, } from './linkers/html.js';
@@ -21,8 +21,9 @@ export { linkTypes, urlFromLegalId, type LinkType } from './links.js';
 export { getOrLoadDocument, getOrLoadDocumentsByDossierParlementaireUid, getOrLoadDossierParlementaire, } from './loaders/assemblee.js';
 export { extendLoadedArticle, getOrLoadArticle, getOrLoadJo, getOrLoadSectionTa, getOrLoadSectionsTa, getOrLoadTextelr, getOrLoadTexteslr, getOrLoadTextesVersions, getOrLoadTexteVersion, loadArticles, type ArticleExtension, type JorfArticleExtended, type LegiArticleExtended, } from './loaders/legifrance.js';
 export { action } from './text_parsers/actions.js';
+export { actionDirective } from './text_parsers/action_directives.js';
 export { article, articles, definitionArticleDansCitation, definitionArticleDansProjetOuPropositionLoi, designationArticle, listeArticles, nomArticle, nomSpecialArticle, } from './text_parsers/articles.js';
-export { actionTargets, compoundReferencesSeparators, divisionTypes, europeanLawNatures, frenchLawNatures, internationalLawNatures, isTextAstAtomicReference, isTextAstDivision, isTextAstPortion, lawNatures, localizationAdverbs, portionTypes, type ActionTarget, type CompoundReferencesSeparator, type DivisionType, type EuropeanLawNature, type FrenchLawNature, type InternationalLawNature, type LawNature, type LocalizationAdverb, type PortionType, type TextAst, type TextAstAction, type TextAstArticle, type TextAstAtomicReference, type TextAstBoundedInterval, type TextAstCitation, type TextAstCompoundReference, type TextAstConseilConstitutionnelDecision, type TextAstCountedInterval, type TextAstDivision, type TextAstEnumeration, type TextAstExclusion, type TextAstIncompleteHeader, type TextAstLocalization, type TextAstNumber, type TextAstParentChild, type TextAstPortion, type TextAstPosition, type TextAstReference, type TextAstReferenceAndAction, type TextAstText, type TextAstTextIdentification, type TextAstTextInfos, type TextInfosByWordsTree, type TextInfosByWordsTreeNode, } from './text_parsers/ast.js';
+export { actionTargets, compoundReferencesSeparators, divisionTypes, europeanLawNatures, frenchLawNatures, internationalLawNatures, isTextAstAtomicReference, isTextAstDivision, isTextAstPortion, lawNatures, localizationAdverbs, portionTypes, type ActionTarget, type CompoundReferencesSeparator, type DivisionType, type EuropeanLawNature, type FrenchLawNature, type InternationalLawNature, type LawNature, type LocalizationAdverb, type PortionType, type TextAst, type TextAstAction, type TextAstActionDirective, type TextAstActionDirectiveOperation, type TextAstActionTargetScope, type TextAstApplicabilityClause, type TextAstArticle, type TextAstAtomicReference, type TextAstBoundedInterval, type TextAstCitation, type TextAstCompoundReference, type TextAstConseilConstitutionnelDecision, type TextAstCountedInterval, type TextAstDivision, type TextAstEnumeration, type TextAstExclusion, type TextAstIncompleteHeader, type TextAstLocalization, type TextAstModificationBlock, type TextAstModificationItem, type TextAstNumber, type TextAstParentChild, type TextAstPortion, type TextAstPosition, type TextAstReference, type TextAstReferenceAndAction, type TextAstText, type TextAstTextIdentification, type TextAstTextInfos, type TextInfosByWordsTree, type TextInfosByWordsTreeNode, } from './text_parsers/ast.js';
 export { citation, citationLigne, citationSimple, } from './text_parsers/citations.js';
 export { date, duDate } from './text_parsers/dates.js';
 export { definitionDivision, designationDivision, division, divisions, natureDivisionSingulier, numeroDivision, } from './text_parsers/divisions.js';

package/dist/src/lib/legi/canutes_resolver.d.ts

@@ -0,0 +1,33 @@
+import { Sql } from 'postgres';
+import { LegiArticleInfo, LegiResolver, LegiSectionInfo, PreloadTextTitlesInfosOptions } from './resolver.js';
+export declare class CanutesResolver implements LegiResolver {
+    private readonly canutesDb;
+    private readonly options;
+    private readonly articleRowsByNumByTextAndDate;
+    private readonly directSectionChildrenByParentAndDate;
+    private readonly globalArticleRowsByNumAndDate;
+    private readonly textIdBySegmentId;
+    private textTitlesInfosLoaded;
+    constructor(canutesDb: Sql, options?: {
+        textTitlesInfosPath?: string;
+    });
+    getActiveArticlesByTextAndNum({ date, num, textId, }: {
+        date: string;
+        num: string | undefined;
+        textId: string;
+    }): Promise<LegiArticleInfo[]>;
+    getDirectSectionChildren({ date, parentPath, }: {
+        date: string;
+        parentPath: string;
+    }): Promise<LegiSectionInfo[]>;
+    getTextIdFromSegmentId(segmentId: string): Promise<string | undefined>;
+    getUniqueActiveArticlesByNum({ date, num, }: {
+        date: string;
+        num: string | undefined;
+    }): Promise<LegiArticleInfo[]>;
+    preloadTextTitlesInfos(options?: PreloadTextTitlesInfosOptions): Promise<void>;
+    preloadUniqueActiveArticlesByNums({ date, nums, }: {
+        date: string;
+        nums: Iterable<string | undefined>;
+    }): Promise<void>;
+}

package/dist/src/lib/legi/resolver.d.ts

@@ -0,0 +1,48 @@
+export interface LegiArticleInfo {
+    dateDebut: string;
+    dateFin: string;
+    id: string;
+    num: string | null;
+    textId: string | null;
+}
+export interface LegiSectionInfo {
+    dateDebut: string | null;
+    dateFin: string | null;
+    id: string;
+    path: string;
+    title: string | null;
+}
+export type PreloadTextTitlesInfosProgress = {
+    count?: number;
+    detail?: string;
+    phase: string;
+    resolver: LegiResolverKind;
+};
+export type PreloadTextTitlesInfosOptions = {
+    onProgress?: (progress: PreloadTextTitlesInfosProgress) => void;
+};
+export interface LegiResolver {
+    getActiveArticlesByTextAndNum(options: {
+        date: string;
+        num: string | undefined;
+        textId: string;
+    }): Promise<LegiArticleInfo[]>;
+    getDirectSectionChildren(options: {
+        date: string;
+        parentPath: string;
+    }): Promise<LegiSectionInfo[]>;
+    getTextIdFromSegmentId(segmentId: string): Promise<string | undefined>;
+    getUniqueActiveArticlesByNum(options: {
+        date: string;
+        num: string | undefined;
+    }): Promise<LegiArticleInfo[]>;
+    preloadTextTitlesInfos(options?: PreloadTextTitlesInfosOptions): Promise<void>;
+    preloadUniqueActiveArticlesByNums(options: {
+        date: string;
+        nums: Iterable<string | undefined>;
+    }): Promise<void>;
+}
+export declare const legiResolverKinds: readonly ["canutes", "f_legi"];
+export type LegiResolverKind = (typeof legiResolverKinds)[number];
+export declare const defaultLegiResolverKind: LegiResolverKind;
+export declare function parseLegiResolverKind(value: string | undefined): LegiResolverKind;

package/dist/src/lib/server/databases/index.d.ts

@@ -5,7 +5,7 @@ export interface Version {
 export declare const canutesDb: postgres.Sql<{}>;
 export declare const assembleeVersionNumber = 7;
 export declare const legiAnomaliesVersionNumber = 1;
-export declare const legiVersionNumber = 19;
+export declare const legiVersionNumber = 21;
 export declare const tisseuseVersionNumber = 3;
 export declare function checkAssembleeDb(): Promise<void>;
 export declare function checkLegiAnomaliesDb(): Promise<void>;

package/dist/src/lib/server/f_legi/databases/index.d.ts

@@ -0,0 +1,2 @@
+import { default as postgres } from 'postgres';
+export declare const flegiDb: postgres.Sql<{}>;

package/dist/src/lib/server/f_legi/linkers/html.d.ts

@@ -0,0 +1,20 @@
+import { LinkType } from '../../../links.js';
+import { LegiResolver } from '../../../legi/resolver.js';
+export declare function addLinksOrReferencesToHtmlFile({ legiResolver, date, defaultTextId, htmlFilePath, htmlTransformationsInputDir, htmlTransformationsOutputDir, htmlWithLinksFilePath, htmlWithLinksOrReferencesFilePath, htmlWithLinksTransformationsOutputDir, htmlWithReferencesFilePath, linkBaseUrl, linkType, logIgnoredReferencesTypes, logPartialReferences, logReferences, referredLegifranceTextsInfosFilePath, }: {
+    legiResolver: LegiResolver;
+    date: string;
+    defaultTextId?: string;
+    htmlFilePath: string;
+    htmlTransformationsInputDir?: string;
+    htmlTransformationsOutputDir?: string;
+    htmlWithLinksFilePath?: string;
+    htmlWithLinksOrReferencesFilePath?: string;
+    htmlWithLinksTransformationsOutputDir?: string;
+    htmlWithReferencesFilePath?: string;
+    linkBaseUrl: string;
+    linkType: LinkType;
+    logIgnoredReferencesTypes?: boolean;
+    logPartialReferences?: boolean;
+    logReferences?: boolean;
+    referredLegifranceTextsInfosFilePath?: string;
+}): Promise<void>;

package/dist/src/lib/server/index.d.ts

@@ -1,4 +1,7 @@
 export { simplifyWordHtml, simplifyWordHtmlToDocument, type SimplifyHtmlOptions, } from './html_simplifier.js';
 export { addLinksOrReferencesToHtmlFile } from './linkers/html.js';
+export { linkAkomaNtosoBillRaw, linkAssembleeBillRaw, parseAkomaNtosoBillRaw, parseAssembleeBillRaw, renderAkomaNtosoBillRaw, type LinkedBillDocument, type ParsedBillArticle, type ParsedBillBlock, type ParsedBillBlockKind, type ParsedBillDirective, type ParsedBillDocument, type ParsedBillLink, type ParsedBillSourceFormat, type ParsedBillToc, type ParseBillRawOptions, } from './parsed_bills.js';
+export { defaultLegiResolverKind, legiResolverKinds, parseLegiResolverKind, type LegiArticleInfo, type LegiResolver, type LegiResolverKind, type LegiSectionInfo, } from '../legi/resolver.js';
 export { addPositionsToTableOfContentsFile, simplifiedHtmlBillFileToTableOfContentsFile, } from './tables_of_contents.js';
+export { createLegiResolver } from './legi/resolvers.js';
 export { readTransformation, writeTransformation, } from './text_parsers/transformers.js';

package/dist/src/lib/server/legi/resolvers.d.ts

@@ -0,0 +1,10 @@
+import { Sql } from 'postgres';
+import { LegiResolver, LegiResolverKind } from '../../legi/resolver.js';
+export declare function getTextTitlesInfosPath(input?: string): string | undefined;
+export declare function getLegiResolverKind(input?: string): LegiResolverKind;
+export declare function createLegiResolver({ canutesDb, resolver, textTitlesInfosPath, }: {
+    canutesDb: Sql;
+    resolver?: string;
+    textTitlesInfosPath?: string;
+}): LegiResolver;
+export declare function endLegiResolverDatabases(): Promise<void>;