@tricoteuses/tisseuse 0.14.12 → 0.14.13

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

@@ -134,8 +134,40 @@ export type ResolvedActionDirective = (ActionDirectiveCommon & {
  * directives. TextAstActionDirective is the generic parser AST.
  */
 export type ActionDirective = ResolvedActionDirective;
+export type ActionDirectiveExtractionDiagnostics = {
+    applyApplicabilityDatesMs: number;
+    buildListItemTreeMs: number;
+    buildDirectivesMs: number;
+    canonicalizeMs: number;
+    collectApplicabilityScopesMs: number;
+    directiveCount: number;
+    extractReferencesMs: number;
+    fallbackReferencesMs: number;
+    filterReferencesMs: number;
+    findBaseReferenceMs: number;
+    listActionItemCount: number;
+    listActionIndexCacheHitCount: number;
+    listActionIndexCacheMissCount: number;
+    listBuildActionDirectiveMs: number;
+    listChildProcessingMs: number;
+    listExtractionMs: number;
+    listFindActionIndexMs: number;
+    listItemCount: number;
+    listPickLineReferenceMs: number;
+    listPickLocalReferenceMs: number;
+    listQuoteRangeCacheHitCount: number;
+    listQuoteRangeCacheMissCount: number;
+    listReferenceCacheHitCount: number;
+    listReferenceCacheMissCount: number;
+    prepareRangesMs: number;
+    processListItemNodesMs: number;
+    refineReferencesMs: number;
+    referenceCount: number;
+    simplifyMs: number;
+};
+export declare function createActionDirectiveExtractionDiagnostics(): ActionDirectiveExtractionDiagnostics;
 export declare function extractActionDirectiveAstsFromText(text: string): TextAstActionDirective[];
-export declare function resolveActionDirectivesFromText(text: string): ActionDirective[];
+export declare function resolveActionDirectivesFromText(text: string, diagnostics?: ActionDirectiveExtractionDiagnostics): ActionDirective[];
 /**
  * @deprecated Use resolveActionDirectivesFromText.
  */

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

@@ -109,6 +109,43 @@ export interface TextLinksParserState {
     sectionTaId?: string;
     textId?: string;
 }
+type TextLinksResolverDiagnostics = {
+    alternativeTargetCandidateCount: number;
+    getActiveArticlesByTextAndNumCount: number;
+    getArticleHistoryInfoCount: number;
+    getDirectSectionChildrenCount: number;
+    getEuropeanTextUrlCount: number;
+    getUniqueActiveArticlesByNumCount: number;
+    uniqueFallbackCheckCount: number;
+};
+type TextLinksIterationDiagnostics = {
+    articleDefinitionLinkCount: number;
+    articleDirectLookupMs: number;
+    articleExplicitAlternativeLookupMs: number;
+    articleExternalLinkCount: number;
+    articleFiscalParentLookupMs: number;
+    articleHistoryLookupMs: number;
+    articleLatestVersionFilterMs: number;
+    articleLinkCount: number;
+    articleLinkMs: number;
+    articleDefaultTextLookupMs: number;
+    articleTypographyAlternativeLookupMs: number;
+    articleUniqueLookupMs: number;
+    citationReferenceCount: number;
+    citationReferenceMs: number;
+    divisionChildArticleMs: number;
+    divisionChildDivisionMs: number;
+    divisionDirectChildrenLookupMs: number;
+    divisionLinkCount: number;
+    divisionLinkMs: number;
+    europeanTextLinkCount: number;
+    europeanTextUrlMs: number;
+    ignoredReferenceCount: number;
+    textChildArticleMs: number;
+    textChildDivisionMs: number;
+    textLinkCount: number;
+    textLinkMs: number;
+};
 export declare function extractTextLinks({ canutesDb, context, date, legiResolver: providedLegiResolver, logIgnoredReferencesTypes, logPartialReferences, logReferences, state: inputState, transformation, }: {
     canutesDb?: Sql;
     context: TextParserContext;
@@ -125,7 +162,7 @@ export declare function extractTextLinks({ canutesDb, context, date, legiResolve
     state?: TextLinksParserState;
     transformation?: Transformation;
 }): AsyncGenerator<DefinitionOrLink, void>;
-export declare function iterReferenceLinks({ articleDefinitionByNumByTextId: articleDefinitionByNumByTextIdInput, legiResolver, context, date, logIgnoredReferencesTypes, logPartialReferences, originalPositionsFromTransformedIterator, reference, state: inputState, }: {
+export declare function iterReferenceLinks({ articleDefinitionByNumByTextId: articleDefinitionByNumByTextIdInput, legiResolver, context, date, logIgnoredReferencesTypes, logPartialReferences, originalPositionsFromTransformedIterator, reference, iterationDiagnostics: inputIterationDiagnostics, resolverDiagnostics: inputResolverDiagnostics, state: inputState, }: {
     articleDefinitionByNumByTextId?: Record<string, Record<string, ArticleDefinition>>;
     legiResolver: LegiResolver;
     context: TextParserContext;
@@ -134,6 +171,8 @@ export declare function iterReferenceLinks({ articleDefinitionByNumByTextId: art
     logPartialReferences?: boolean;
     originalPositionsFromTransformedIterator?: Generator<FragmentReverseTransformation, void, FragmentPosition | undefined>;
     reference: TextAstReference;
+    iterationDiagnostics?: TextLinksIterationDiagnostics;
+    resolverDiagnostics?: TextLinksResolverDiagnostics;
     /**
      * 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,
@@ -141,3 +180,4 @@ export declare function iterReferenceLinks({ articleDefinitionByNumByTextId: art
      */
     state?: TextLinksParserState;
 }): AsyncGenerator<DefinitionOrLink>;
+export {};

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

@@ -1,10 +1,19 @@
 import { TextAstCitation, TextAstReference } from '../text_parsers/ast.js';
-import { TextParserContext } from '../text_parsers/parsers.js';
+import { FastPathExtractDiagnostics, 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 type ExtractReferencesDiagnostics = {
+    citationCount: number;
+    fastPath: FastPathExtractDiagnostics;
+};
+export declare function extractCitationReferences(context: TextParserContext, citation: TextAstCitation, options?: {
+    diagnostics?: ExtractReferencesDiagnostics;
+}): Generator<TextAstReference, void>;
 export declare function extractReferences(context: TextParserContext, options?: {
+    diagnostics?: ExtractReferencesDiagnostics;
     overlapWindowForCandidate?: (anchor: string) => number;
 }): Generator<TextAstReference, void>;
-export declare function extractReferencesWithOriginalTransformations(context: TextParserContext, transformation: Transformation): Generator<TextAstReference, void>;
+export declare function extractReferencesWithOriginalTransformations(context: TextParserContext, transformation: Transformation, options?: {
+    diagnostics?: ExtractReferencesDiagnostics;
+}): Generator<TextAstReference, void>;
 export declare const getExtractedReferences: (context: TextParserContext) => TextAstReference[];
 export declare const getExtractedReferencesWithOriginalTransformations: (context: TextParserContext, transformation: Transformation) => TextAstReference[];

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

@@ -27,6 +27,10 @@ export declare class FlegiResolver extends LegiResolver {
     }): Promise<FlegiSectionInfo[]>;
     getTextIdFromSegmentId(segmentId: string): Promise<string | undefined>;
     preloadTextTitlesInfos(options?: PreloadTextTitlesInfosOptions): Promise<void>;
+    private buildAndCacheTextTitlesInfos;
+    private getTextTitlesInfosParserCacheMeta;
+    private loadTextTitlesInfosParserCache;
+    private loadOrBuildTextTitlesInfosParserCache;
     getUniqueActiveArticlesByNum({ date, num, }: {
         date: string;
         num: string | undefined;

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

@@ -14,6 +14,8 @@ export type TextTitlesInfos = {
     textsCidsByNatureAndDate: Record<string, Record<string, string | string[]>>;
     textsCidsByNatureAndNum: Record<string, Record<string, string | string[]>>;
 };
+export declare const textTitlesInfosParserCacheKey = "current";
+export declare const textTitlesInfosParserCacheFormatVersion = 1;
 export type BuildTextTitlesInfosProgress = {
     count?: number;
     phase: string;
@@ -21,6 +23,7 @@ export type BuildTextTitlesInfosProgress = {
 export declare function buildAndInstallTextTitlesInfos(rows: TextTitlesInfoRow[], options?: {
     onProgress?: (progress: BuildTextTitlesInfosProgress) => void;
 }): Promise<void>;
+export declare function installTextTitlesInfos(textTitlesInfos: TextTitlesInfos): void;
 export declare function buildTextTitlesInfos(rows: TextTitlesInfoRow[], { onProgress, }?: {
     onProgress?: (progress: BuildTextTitlesInfosProgress) => void;
 }): Promise<TextTitlesInfos>;

package/dist/src/lib/text_parsers/parsers.d.ts

@@ -6,12 +6,31 @@ export type TextAstConverter<T extends TextAst> = (ast: T, context: TextParserCo
 export type TextParser<T extends TextAst = TextAst> = {
     (context: TextParserContext): T | undefined;
     extract?: (context: TextParserContext, options?: {
+        diagnostics?: FastPathExtractDiagnostics;
         jumpExact?: boolean;
         globalRegExpFlags?: string;
+        canStartAtOffset?: (input: string, offset: number) => boolean;
         overlapWindow?: number;
-        overlapWindowForCandidate?: (anchor: string) => number;
+        overlapWindowForCandidate?: (anchor: string, candidate?: FastPathExtractCandidate) => number | undefined;
     }) => Generator<T, void, undefined>;
 };
+export type FastPathExtractDiagnostics = {
+    anchorCounts: Record<string, number>;
+    candidateCount: number;
+    checkedOffsetCount: number;
+    failedCandidateCount: number;
+    matchedCount: number;
+    startOffsetSkippedCount: number;
+    overlapWindowOverrideCount: number;
+    overlapWindowReducedCandidateCount: number;
+    overlapWindowSavedOffsetCount: number;
+    parserAttemptCount: number;
+};
+export type FastPathExtractCandidate = {
+    index: number;
+    input: string;
+    text: string;
+};
 export declare class TextParserContext {
     input: string;
     offset: number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tricoteuses/tisseuse",
   "description": "Find links in/to French legislative documents",
-  "version": "0.14.12",
+  "version": "0.14.13",
   "keywords": [
     "Assemblée nationale",
     "France",