@tricoteuses/tisseuse 0.2.0 → 0.4.0

package/dist/lib/articles.d.ts

@@ -0,0 +1,13 @@
+import { JorfArticle, LegiArticle } from '@tricoteuses/legifrance';
+import { Sql } from 'postgres';
+import { LegalObjectCacheByIdByCategorieTag } from './loaders.js';
+/**
+ * TODO: Migrate to @tricoteuses/legifrance
+ */
+export declare function getArticleDateSignature(article: JorfArticle | LegiArticle): string;
+/**
+ * TODO:
+ * - Handle date to filter articles outside date
+ * - Migrate everything @tricoteuses/legifrance.
+ */
+export declare function getOrLoadArticleSiblingId(legiDb: Sql, legalObjectCacheByIdByCategorieTag: LegalObjectCacheByIdByCategorieTag, id: string, offset: -1 | 1): Promise<string | undefined>;

package/dist/lib/index.d.ts

@@ -1,7 +1,8 @@
+export { getArticleDateSignature, getOrLoadArticleSiblingId, } from './articles.js';
 export { assertNever } from './asserts.js';
 export { formatLongDate } from './dates.js';
 export { jsonReplacer } from './json.js';
-export { iterCardinalNumeralFormsFromNumber, iterLatinMultiplicativeAdverbsFromNumber, iterOrdinalNumeralFormsFromNumber, numberFromRomanNumeral, ordinalNumeralFromNumber, romanNumeralFromNumber, } from './numbers.js';
+export { extendLoadedArticle, newLegalObjectCacheByIdByCategorieTag, getOrLoadArticle, getOrLoadJo, getOrLoadSectionTa, getOrLoadSectionsTa, getOrLoadTextelr, getOrLoadTexteVersion, type ArticleExtension, type JorfArticleExtended, type LegalObjectCacheByIdByCategorieTag, type LegiArticleExtended, } from './loaders.js';
 export { action } from './text_parsers/actions.js';
 export { article, articles, definitionArticle, designationArticle, listeArticles, nomArticle, nomSpecialArticle, } from './text_parsers/articles.js';
 export { compoundReferencesSeparators, divisionTypes, europeanLawNatures, frenchLawNatures, internationalLawNatures, isTextAstAtomicReference, isTextAstDivision, isTextAstPortion, lawNatures, localizationAdverbs, portionTypes, 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';
@@ -18,6 +19,7 @@ export { ditPluriel, ditSingulier, introPluriel, introSingulier, liaisonPluriel,
 export { reference, uniteBasePreciseeSingulier, uniteBaseSingulier, } from './text_parsers/references.js';
 export { adverbeRelatif, espaceAdverbeRelatif, relatifPlurielPrepose, relatifSingulierPrepose, } from './text_parsers/relative_locations.js';
 export { convertHtmlElementsToText, decodeNamedHtmlEntities, decodeNumericHtmlEntities, replacePattern, replacePatterns, simplifyHtml, simplifyText, simplifyUnicodeCharacters, } from './text_parsers/simplifiers.js';
+export { parseTextLinks, type ArticleDefinition, type ArticleExternalLink, type ArticleInternalLink, type ArticleLink, type DefinitionOrLink, type DivisionExternalLink, type DivisionLink, type ExtractedLinkDb, type TextExternalLink, type TextLink, type TextLinksParserState, } from './text_parsers/text_links.js';
 export { definitionTexteFrancais, identificationTexteEuropeen, natureTexteFrancais, numeroEtOuDateTexteFrancais, numeroTexteEuropeen, numeroTexteFrancais, optionalEspaceDuTerritoire, texte, texteEuropeen, texteFrancais, texteInternational, } from './text_parsers/texts.js';
 export { chainTransformers, iterOriginalMergedPositionsFromTransformed, originalMergedPositionsFromTransformed, originalSplitPositionsFromTransformed, reverseTransformedInnerFragment, reverseTransformedReplacement, type SourceMapSegment, type Transformation, type TransformationLeaf, type TransformationNode, type Transformer, type TransformerLeaf, type TransformerNode, } from './text_parsers/transformers.js';
 export { espace, lettreAsciiMinuscule, nonLettre, numero, virguleOuEspace, } from './text_parsers/typography.js';

package/dist/lib/loaders.d.ts

@@ -0,0 +1,19 @@
+import { Jo, JorfArticle, JorfCategorieTag, JorfSectionTa, JorfTextelr, JorfTexteVersion, LegiArticle, LegiCategorieTag, LegiSectionTa, LegiTextelr, LegiTexteVersion } from '@tricoteuses/legifrance';
+import { JSONValue, Sql } from 'postgres';
+export interface ArticleExtension {
+    num?: string;
+}
+export type JorfArticleExtended = JorfArticle & ArticleExtension;
+export type LegalObjectCacheByIdByCategorieTag = Map<JorfCategorieTag | LegiCategorieTag, Map<string, JSONValue>>;
+export type LegiArticleExtended = LegiArticle & ArticleExtension;
+export declare function extendLoadedArticle<ArticleType extends JorfArticle | LegiArticle>({ data: article, num, }: {
+    data: ArticleType;
+    num: string | null;
+}): ArticleType & ArticleExtension;
+export declare function getOrLoadArticle<ArticleType extends JorfArticle | LegiArticle>(legiDb: Sql, legalObjectCacheByIdByCategorieTag: LegalObjectCacheByIdByCategorieTag, id: string): Promise<(ArticleType & ArticleExtension) | undefined>;
+export declare function getOrLoadJo<JoType extends Jo>(legiDb: Sql, legalObjectCacheByIdByCategorieTag: LegalObjectCacheByIdByCategorieTag, id: string): Promise<JoType | undefined>;
+export declare function getOrLoadSectionTa<SectionTaType extends JorfSectionTa | LegiSectionTa>(legiDb: Sql, legalObjectCacheByIdByCategorieTag: LegalObjectCacheByIdByCategorieTag, id: string): Promise<SectionTaType | undefined>;
+export declare function getOrLoadSectionsTa<SectionTaType extends JorfSectionTa | LegiSectionTa>(legiDb: Sql, legalObjectCacheByIdByCategorieTag: LegalObjectCacheByIdByCategorieTag, ids: string[]): Promise<SectionTaType[]>;
+export declare function getOrLoadTextelr<TextelrType extends JorfTextelr | LegiTextelr>(legiDb: Sql, legalObjectCacheByIdByCategorieTag: LegalObjectCacheByIdByCategorieTag, id: string): Promise<TextelrType | undefined>;
+export declare function getOrLoadTexteVersion<TexteVersionType extends JorfTexteVersion | LegiTexteVersion>(legiDb: Sql, legalObjectCacheByIdByCategorieTag: LegalObjectCacheByIdByCategorieTag, id: string): Promise<TexteVersionType | undefined>;
+export declare const newLegalObjectCacheByIdByCategorieTag: () => LegalObjectCacheByIdByCategorieTag;

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

@@ -7,7 +7,7 @@ export declare const assembleeVersionNumber = 7;
 export declare const legiAnomaliesDb: postgres.Sql<{}>;
 export declare const legiAnomaliesVersionNumber = 1;
 export declare const legiDb: postgres.Sql<{}>;
-export declare const legiVersionNumber = 16;
+export declare const legiVersionNumber = 19;
 export declare const tisseuseDb: postgres.Sql<{}>;
 export declare const tisseuseVersionNumber = 1;
 /**

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

@@ -11,6 +11,7 @@ export declare const nombreRomainOu0iAsTextAstNumber: import('./parsers.js').Tex
 export declare const adjectifNumeralCardinalDix: import('./parsers.js').TextParser;
 export declare const adjectifNumeralCardinalDizaine: import('./parsers.js').TextParser;
 export declare const adjectifNumeralCardinalUnite: import('./parsers.js').TextParser;
+export declare const adjectifNumeralCardinalLong: import('./parsers.js').TextParser;
 export declare const adjectifNumeralCardinal: import('./parsers.js').TextParser;
 export declare const adjectifNumeralOrdinalLong: import('./parsers.js').TextParser;
 export declare const adjectifNumeralOrdinal: import('./parsers.js').TextParser;

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

@@ -9,8 +9,10 @@ export declare const naturePortionPluriel: import('./parsers.js').TextParser;
  */
 export declare const numeroPortion: import('./parsers.js').TextParser;
 /**
- * Portion désignée soit par un adjectif relatif soit par un ordinal écrit en lettres,
- * par exemple « même alinéa » ou « troisième phrase »
+ * Portion désignée !
+ * - soit par un adjectif relatif (par exemple « même alinéa)
+ * - soit par un nombre ordinal écrit en lettres (par exemple « troisième phrase »)
+ * - soit par un npmbre cardinal (par exemple « alinéa 3 »)
  */
 export declare const unePortion: import('./parsers.js').TextParser;
 export declare const numeroPortionOuUnePortion: import('./parsers.js').TextParser;
@@ -43,7 +45,7 @@ export declare const listeQuelquesPortions: import('./parsers.js').TextParser;
  * TODO: Les fusionner ?
  */
 export declare const listePortions: import('./parsers.js').TextParser;
-export declare const portionsEntreParentheses: import('./parsers.js').TextParser;
+export declare const portionsEntreParenthesesOuVirgules: import('./parsers.js').TextParser;
 export declare const localisationPortion: import('./parsers.js').TextParser;
 export declare const portion: import('./parsers.js').TextParser;
 export declare const portions: import('./parsers.js').TextParser;

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

@@ -1,5 +1,8 @@
+import { Sql } from 'postgres';
 import { TextAstArticle, TextAstDivision, TextAstPosition, TextAstReference, TextAstText } from './ast.js';
 import { FragmentPosition, FragmentReverseTransformation } from './fragments.js';
+import { TextParserContext } from './parsers.js';
+import { Transformation } from './transformers.js';
 export type DefinitionOrLink = ArticleDefinition | ArticleLink | DivisionLink | TextLink;
 export interface ArticleDefinition {
     article: TextAstArticle;
@@ -75,3 +78,28 @@ export interface TextExternalLink {
     type: "external_text";
 }
 export type TextLink = TextExternalLink;
+export interface TextLinksParserState {
+    articleId?: string;
+    codeId?: string;
+    constitutionId?: string;
+    decreeId?: string;
+    defaultTextId?: string;
+    lawId?: string;
+    sectionTaId?: string;
+    textId?: string;
+}
+export declare function parseTextLinks({ context, date, legiDb, logIgnoredReferencesTypes, logPartialReferences, logReferences, state: inputState, transformation, }: {
+    context: TextParserContext;
+    date: string;
+    legiDb: Sql;
+    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>;

package/dist/lib/text_parsers/text_links.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/textes.d.ts

@@ -1 +1,6 @@
+import { JorfTexteVersion, LegiTexteVersion } from '@tricoteuses/legifrance';
 export declare const cleanTexteTitle: <StringOrUndefined extends string | undefined>(title: StringOrUndefined) => StringOrUndefined;
+/**
+ * TODO: Migrate to @tricoteuses/legifrance
+ */
+export declare function getTexteVersionDateSignature(texteVersion: JorfTexteVersion | LegiTexteVersion): string;

package/dist/scripts/set_articles_missing_num.d.ts

@@ -0,0 +1,2 @@
+import { JorfArticle, LegiArticle } from '@tricoteuses/legifrance';
+export declare function getArticleNum(article: JorfArticle | LegiArticle): Promise<string | undefined>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tricoteuses/tisseuse",
   "description": "Find links in/to French legislative documents",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "keywords": [
     "Assemblée nationale",
     "France",
@@ -26,7 +26,9 @@
     "node": ">=22.14.0"
   },
   "files": [
-    "dist"
+    "dist",
+    "!dist/server",
+    "!**/*.test.js"
   ],
   "exports": {
     ".": {
@@ -44,28 +46,28 @@
     "configure": "tsx src/scripts/configure.ts",
     "format": "prettier --write \"src/**/*.ts\"",
     "lint": "eslint .",
-    "prepare": "npm run build",
+    "prepack": "npm run build",
     "test": "npm run test:unit -- --run",
     "test:unit": "vitest"
   },
   "devDependencies": {
     "@auditors/core": "^0.7.4",
     "@tricoteuses/assemblee": "^2.3.1",
-    "@tricoteuses/legifrance": "^0.15.2",
+    "@tricoteuses/legifrance": "^0.16.0",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^24.3.1",
-    "@typescript-eslint/eslint-plugin": "^8.43.0",
-    "@typescript-eslint/parser": "^8.43.0",
+    "@types/node": "^24.8.1",
+    "@typescript-eslint/eslint-plugin": "^8.46.1",
+    "@typescript-eslint/parser": "^8.46.1",
     "dedent-js": "^1.0.1",
     "dotenv": "^17.2.2",
-    "eslint": "^9.35.0",
+    "eslint": "^9.38.0",
     "fs-extra": "^11.3.1",
     "postgres": "^3.4.7",
     "prettier": "^3.0.0",
     "sade": "^1.8.1",
     "tsx": "^4.20.5",
     "typescript": "^5.0.0",
-    "vite": "^7.1.5",
+    "vite": "^7.1.10",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^3.2.4"
   }

package/dist/lib/numbers.d.ts

@@ -1,6 +0,0 @@
-export declare function iterCardinalNumeralFormsFromNumber(num: number): Generator<string, void>;
-export declare function iterLatinMultiplicativeAdverbsFromNumber(num: number): Generator<string, void>;
-export declare function iterOrdinalNumeralFormsFromNumber(num: number): Generator<string, void>;
-export declare function numberFromRomanNumeral(romanNumeral: string): number;
-export declare function ordinalNumeralFromNumber(num: number): string | undefined;
-export declare function romanNumeralFromNumber(num: number): string | undefined;

package/dist/lib/server/text_links.d.ts

@@ -1,11 +0,0 @@
-import { TextParserContext } from '../text_parsers/parsers.js';
-import { DefinitionOrLink } from '../text_parsers/text_links.js';
-import { Transformation } from '../text_parsers/transformers.js';
-export declare function iterTextLinks(context: TextParserContext, { date, defaultTextId, logIgnoredReferencesTypes, logPartialReferences, logReferences, transformation, }: {
-    date: string;
-    defaultTextId?: string;
-    logIgnoredReferencesTypes?: boolean;
-    logPartialReferences?: boolean;
-    logReferences?: boolean;
-    transformation?: Transformation;
-}): AsyncGenerator<DefinitionOrLink, void>;