@tricoteuses/tisseuse 0.14.8 → 0.14.9

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

@@ -25,6 +25,13 @@ export interface ArticleDefinition {
 export interface ArticleExternalLink {
     article: TextAstArticle;
     articleId?: 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
+     * text: latest version of that chain, allowing linkers to propose a history
+     * page (versions and their periods) instead of an arbitrary resolution.
+     */
+    historyArticleId?: string;
     /**
      * Only defined when a transformation was used to convert input text
      * to simpeurolified text.

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

@@ -19,7 +19,7 @@ export { addLinksToHtml, addLinksOrReferencesToHtmlPage, type OutputByType, type
  */
 export declare const addLinksToText: typeof addLinksToMarkdown;
 export { addLinksToMarkdown };
-export { linkTypes, urlFromLegalId, type LinkType } from './links.js';
+export { linkTypes, urlFromArticleVersionsId, urlFromLegalId, type LinkType, } from './links.js';
 export { getOrLoadDocument, getOrLoadDocumentsByDossierParlementaireUid, getOrLoadDossierParlementaire, } from './loaders/assemblee.js';
 export { extendLoadedArticle, getOrLoadArticle, getOrLoadJo, getOrLoadSectionTa, getOrLoadSectionsTa, getOrLoadTextelr, getOrLoadTextekali, getOrLoadTexteslr, getOrLoadTextesVersions, getOrLoadTexteVersion, loadArticles, type ArticleExtension, type JorfArticleExtended, type KaliArticleExtended, type LegiArticleExtended, } from './loaders/legifrance.js';
 export { action } from './text_parsers/actions.js';

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

@@ -1,7 +1,27 @@
 import { Sql } from 'postgres';
-import { LegiResolver, LegiArticleInfo, LegiSectionInfo, PreloadTextTitlesInfosOptions } from './resolver.js';
+import { LegiResolver, LegiArticleHistoryInfo, LegiArticleInfo, LegiSectionInfo, 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 declare class CanutesResolver extends LegiResolver {
     private readonly canutesDb;
+    private readonly articleHistoryInfoByTextAndNum;
     private readonly articleRowsByNumByTextAndDate;
     private readonly directSectionChildrenByParentAndDate;
     private readonly globalArticleRowsByNumAndDate;
@@ -14,6 +34,10 @@ export declare class CanutesResolver extends LegiResolver {
         num: string | undefined;
         textId: string;
     }): Promise<LegiArticleInfo[]>;
+    getArticleHistoryInfo({ num, textId, }: {
+        num: string | undefined;
+        textId: string;
+    }): Promise<LegiArticleHistoryInfo | undefined>;
     getDirectSectionChildren({ date, parentPath, }: {
         date: string;
         parentPath: string;

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

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

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

@@ -5,6 +5,13 @@ export interface LegiArticleInfo {
     num: string | null;
     textId: string | null;
 }
+/**
+ * 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.
+ */
+export interface LegiArticleHistoryInfo {
+    articleId: string;
+}
 export interface LegiSectionInfo {
     dateDebut: string | null;
     dateFin: string | null;
@@ -32,6 +39,15 @@ export declare abstract class LegiResolver {
         num: string | undefined;
         textId: string;
     }): Promise<LegiArticleInfo[]>;
+    /**
+     * Latest version of the unique version chain of an article number within a
+     * text, or `undefined` when the number is unknown, ambiguous (several
+     * distinct version chains) or when the resolver cannot answer.
+     */
+    getArticleHistoryInfo(options: {
+        num: string | undefined;
+        textId: string;
+    }): Promise<LegiArticleHistoryInfo | undefined>;
     abstract getDirectSectionChildren(options: {
         date: string;
         parentPath: string;

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

@@ -1,3 +1,10 @@
 export type LinkType = (typeof linkTypes)[number];
 export declare const linkTypes: readonly ["Exploratrice", "Forgejo"];
+/**
+ * URL of the page presenting every known version (with their validity
+ * periods) of a legal article. Used instead of a direct resolution when no
+ * version of the article is active at the reference date. Returns
+ * `undefined` when this link kind has no equivalent for the given type.
+ */
+export declare function urlFromArticleVersionsId(linkType: LinkType, baseUrl: string, articleId: string): string | undefined;
 export declare function urlFromLegalId(linkType: LinkType, baseUrl: string, id: string): string;

package/package.json

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