@linklabjs/core 0.1.0 → 0.1.1

package/dist/api/test-domain.js

@@ -0,0 +1,105 @@
+/**
+ * test-domain.ts — Validation niveau 1 : DomainProxy
+ *
+ * Couvre :
+ *   - Accès propriété simple       cinema.movies
+ *   - Filtre par ID (number)       cinema.people(278)
+ *   - Filtre par objet             cinema.people({ id: 278 })
+ *   - Traversée thenable           await cinema.people(278).movies
+ *   - Fetch direct                 await cinema.movies
+ *   - Chaînage profond             await cinema.people(278).movies (depth 2)
+ */
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
+import path from 'path';
+import { Graph } from './index.js';
+const require = createRequire(import.meta.url);
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const root = path.join(__dirname, '..');
+const ok = (label) => console.log(`  ✅ ${label}`);
+const err = (label, detail) => console.log(`  ❌ ${label}: ${detail?.message ?? JSON.stringify(detail)}`);
+const sep = (t) => console.log(`\n${'─'.repeat(50)}\n${t}`);
+// ── Setup Netflix ─────────────────────────────────────────────────────────────
+const compiled = require(`${root}/examples/netflix/compiled-graph.json`);
+const movies = require(`${root}/scenarios/test-netflix/data/movies.json`);
+const credits = require(`${root}/scenarios/test-netflix/data/credits.json`);
+const people = require(`${root}/scenarios/test-netflix/data/people.json`);
+const cinema = new Graph(require(`${root}/scenarios/test-netflix/graph.json`), { compiled, dataset: { movies, credits, people } }).domain();
+sep('NIVEAU 1 — Fetch direct (depth 1)');
+try {
+    // await cinema.movies → tous les films
+    const r1 = await cinema.movies;
+    r1.data.length > 0
+        ? ok(`await cinema.movies → ${r1.data.length} films`)
+        : err('cinema.movies', 'vide');
+    // await cinema.people → toutes les personnes
+    const r2 = await cinema.people;
+    r2.data.length > 0
+        ? ok(`await cinema.people → ${r2.data.length} personnes`)
+        : err('cinema.people', 'vide');
+    // await cinema.movies(278) → un seul film
+    const r3 = await cinema.movies(278);
+    r3.data.length === 1 && r3.data[0].title === 'Les Évadés'
+        ? ok(`await cinema.movies(278) → "${r3.data[0].title}"`)
+        : err('cinema.movies(278)', r3.data);
+    // await cinema.people(4027) → Frank Darabont
+    const r4 = await cinema.people(4027);
+    r4.data.length === 1 && r4.data[0].name === 'Frank Darabont'
+        ? ok(`await cinema.people(4027) → "${r4.data[0].name}"`)
+        : err('cinema.people(4027)', r4.data);
+    // Filtre par objet
+    const r5 = await cinema.people({ id: 4027 });
+    r5.data.length === 1
+        ? ok(`await cinema.people({ id: 4027 }) → "${r5.data[0].name}"`)
+        : err('cinema.people({id:4027})', r5.data);
+}
+catch (e) {
+    err('Depth 1', e);
+}
+sep('NIVEAU 1 — Traversée (depth 2)');
+try {
+    // await cinema.people(4027).movies → filmographie Darabont
+    const r1 = await cinema.people(4027).movies;
+    r1.data.length >= 2
+        ? ok(`await cinema.people(4027).movies → ${r1.data.length} films : ${r1.data.map((m) => m.title).join(', ')}`)
+        : err('cinema.people(4027).movies', `${r1.data.length} films`);
+    // await cinema.movies(278).people → cast des Évadés
+    const r2 = await cinema.movies(278).people;
+    r2.data.length >= 10
+        ? ok(`await cinema.movies(278).people → ${r2.data.length} personnes`)
+        : err('cinema.movies(278).people', `${r2.data.length}`);
+    // Trail path
+    r1.path.length > 1
+        ? ok(`path: ${r1.path.join('→')}`)
+        : err('path', r1.path);
+}
+catch (e) {
+    err('Depth 2', e);
+}
+sep('NIVEAU 1 — Clé sémantique (string filter)');
+try {
+    // await cinema.movies('Les Évadés') → via title
+    // Le semantic_key pour movies devrait être 'title'
+    const r1 = await cinema.movies({ title: 'Les Évadés' });
+    r1.data.length === 1
+        ? ok(`await cinema.movies({ title: 'Les Évadés' }) → id=${r1.data[0].id}`)
+        : err('cinema.movies({title})', `${r1.data.length} résultats`);
+}
+catch (e) {
+    err('Semantic key', e);
+}
+sep('NIVEAU 1 — Musicians (nodes par type)');
+try {
+    const music = new Graph(require(`${root}/examples/musicians/graph.json`)).domain();
+    // Les musicians ont type='artist' — pas de données, juste des nodes
+    // cinema.artists → devrait résoudre le type 'artist'
+    const node = music.artists;
+    node !== undefined
+        ? ok(`cinema.artists → DomainNode résolu (entity=${node.entity})`)
+        : err('cinema.artists', 'undefined');
+}
+catch (e) {
+    err('Musicians domain', e);
+}
+console.log('\n' + '─'.repeat(50));
+//# sourceMappingURL=test-domain.js.map

package/dist/api/test-domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-domain.js","sourceRoot":"","sources":["../../src/api/test-domain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAA;AACnC,OAAO,IAAI,MAAmB,MAAM,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAc,YAAY,CAAA;AAE1C,MAAM,OAAO,GAAK,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAChD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAC9D,MAAM,IAAI,GAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;AAE5C,MAAM,EAAE,GAAI,CAAC,KAAa,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,EAAE,CAAC,CAAA;AAC1D,MAAM,GAAG,GAAG,CAAC,KAAa,EAAE,MAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,KAAK,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACrH,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;AAEnE,iFAAiF;AAEjF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,IAAI,uCAAuC,CAAC,CAAA;AACxE,MAAM,MAAM,GAAK,OAAO,CAAC,GAAG,IAAI,0CAA0C,CAAC,CAAA;AAC3E,MAAM,OAAO,GAAI,OAAO,CAAC,GAAG,IAAI,2CAA2C,CAAC,CAAA;AAC5E,MAAM,MAAM,GAAK,OAAO,CAAC,GAAG,IAAI,0CAA0C,CAAC,CAAA;AAE3E,MAAM,MAAM,GAAG,IAAI,KAAK,CACtB,OAAO,CAAC,GAAG,IAAI,oCAAoC,CAAC,EACpD,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CACnD,CAAC,MAAM,EAAE,CAAA;AAEV,GAAG,CAAC,mCAAmC,CAAC,CAAA;AACxC,IAAI,CAAC;IACH,uCAAuC;IACvC,MAAM,EAAE,GAAG,MAAO,MAAc,CAAC,MAAM,CAAA;IACvC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAChB,CAAC,CAAC,EAAE,CAAC,yBAAyB,EAAE,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC;QACrD,CAAC,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,CAAA;IAEhC,6CAA6C;IAC7C,MAAM,EAAE,GAAG,MAAO,MAAc,CAAC,MAAM,CAAA;IACvC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAChB,CAAC,CAAC,EAAE,CAAC,yBAAyB,EAAE,CAAC,IAAI,CAAC,MAAM,YAAY,CAAC;QACzD,CAAC,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,CAAA;IAEhC,0CAA0C;IAC1C,MAAM,EAAE,GAAG,MAAO,MAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC5C,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,YAAY;QACvD,CAAC,CAAC,EAAE,CAAC,+BAA+B,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;QACxD,CAAC,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;IAEtC,6CAA6C;IAC7C,MAAM,EAAE,GAAG,MAAO,MAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC7C,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB;QAC1D,CAAC,CAAC,EAAE,CAAC,gCAAgC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QACxD,CAAC,CAAC,GAAG,CAAC,qBAAqB,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;IAEvC,mBAAmB;IACnB,MAAM,EAAE,GAAG,MAAO,MAAc,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IACrD,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAClB,CAAC,CAAC,EAAE,CAAC,wCAAwC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QAChE,CAAC,CAAC,GAAG,CAAC,0BAA0B,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;AAE9C,CAAC;AAAC,OAAM,CAAC,EAAE,CAAC;IAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;AAAC,CAAC;AAEhC,GAAG,CAAC,gCAAgC,CAAC,CAAA;AACrC,IAAI,CAAC;IACH,2DAA2D;IAC3D,MAAM,EAAE,GAAG,MAAO,MAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAA;IACpD,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC;QACjB,CAAC,CAAC,EAAE,CAAC,sCAAsC,EAAE,CAAC,IAAI,CAAC,MAAM,YAAY,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAK,EAAC,EAAE,CAAA,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChH,CAAC,CAAC,GAAG,CAAC,4BAA4B,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,CAAA;IAEhE,oDAAoD;IACpD,MAAM,EAAE,GAAG,MAAO,MAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAA;IACnD,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE;QAClB,CAAC,CAAC,EAAE,CAAC,qCAAqC,EAAE,CAAC,IAAI,CAAC,MAAM,YAAY,CAAC;QACrE,CAAC,CAAC,GAAG,CAAC,2BAA2B,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;IAEzD,aAAa;IACb,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAChB,CAAC,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;AAE1B,CAAC;AAAC,OAAM,CAAC,EAAE,CAAC;IAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;AAAC,CAAC;AAEhC,GAAG,CAAC,2CAA2C,CAAC,CAAA;AAChD,IAAI,CAAC;IACH,gDAAgD;IAChD,mDAAmD;IACnD,MAAM,EAAE,GAAG,MAAO,MAAc,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAA;IAChE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAClB,CAAC,CAAC,EAAE,CAAC,qDAAqD,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1E,CAAC,CAAC,GAAG,CAAC,wBAAwB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,YAAY,CAAC,CAAA;AAElE,CAAC;AAAC,OAAM,CAAC,EAAE,CAAC;IAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAA;AAAC,CAAC;AAErC,GAAG,CAAC,uCAAuC,CAAC,CAAA;AAC5C,IAAI,CAAC;IACH,MAAM,KAAK,GAAG,IAAI,KAAK,CACrB,OAAO,CAAC,GAAG,IAAI,gCAAgC,CAAC,CACjD,CAAC,MAAM,EAAE,CAAA;IAEV,oEAAoE;IACpE,qDAAqD;IACrD,MAAM,IAAI,GAAI,KAAa,CAAC,OAAO,CAAA;IACnC,IAAI,KAAK,SAAS;QAChB,CAAC,CAAC,EAAE,CAAC,8CAA8C,IAAI,CAAC,MAAM,GAAG,CAAC;QAClE,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAA;AAExC,CAAC;AAAC,OAAM,CAAC,EAAE,CAAC;IAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAA;AAAC,CAAC;AAEzC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA"}

package/dist/api/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * api/types.ts — Types publics de l'API LinkLab niveau 2+
+ *
+ * Ces types sont la surface visible pour les utilisateurs du moteur.
+ * Les types internes (CompiledGraph, RouteInfo, etc.) restent dans types/index.ts.
+ */
+import type { GraphEdge } from '../types/index.js';
+/**
+ * Strategy — comment Dijkstra pondère les chemins.
+ *
+ * Shortest      : poids brut des arêtes — temps pur, distance minimale
+ * Comfort       : pénalité par correspondance (+8 unités) — moins de changements
+ * LeastHops     : favorise les chemins avec peu d'étapes
+ * Custom(n)     : pénalité explicite par correspondance
+ */
+export type Strategy = {
+    type: 'Shortest';
+} | {
+    type: 'Comfort';
+} | {
+    type: 'LeastHops';
+} | {
+    type: 'Custom';
+    transferPenalty: number;
+};
+export declare const Strategy: {
+    readonly Shortest: () => Strategy;
+    readonly Comfort: () => Strategy;
+    readonly LeastHops: () => Strategy;
+    readonly Custom: (transferPenalty: number) => Strategy;
+    readonly toPenalty: (s: Strategy) => number;
+};
+export interface PathStep {
+    node: string;
+    label?: string;
+    via?: GraphEdge;
+}
+export interface ResolvedPath {
+    nodes: string[];
+    steps: PathStep[];
+    weight: number;
+    hops: number;
+}
+export interface PathResult {
+    from: string;
+    to: string;
+    found: boolean;
+    paths: ResolvedPath[];
+}
+/**
+ * QueryResult — retourné par PathBuilder.execute()
+ * Uniquement en mode données (netflix, dvdrental) — pas pour metro/musicians.
+ */
+export interface QueryResult<T = Record<string, any>> {
+    from: string;
+    to: string;
+    filters: Record<string, any>;
+    data: T[];
+    path: string[];
+    timing: number;
+}
+export interface PathBuilderOptions {
+    maxPaths?: number;
+    minHops?: number;
+    maxHops?: number;
+    via?: string[];
+    strategy?: Strategy;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAIlD;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAA;AAG/C,eAAO,MAAM,QAAQ;6BACJ,QAAQ;4BACR,QAAQ;8BACR,QAAQ;uCACM,MAAM,KAAG,QAAQ;4BAEjC,QAAQ,KAAG,MAAM;CAQtB,CAAA;AAIV,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAI,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAI,SAAS,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAG,MAAM,EAAE,CAAA;IAChB,KAAK,EAAG,QAAQ,EAAE,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAI,MAAM,CAAA;CACf;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAG,MAAM,CAAA;IACb,EAAE,EAAK,MAAM,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,YAAY,EAAE,CAAA;CACtB;AAID;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAClD,IAAI,EAAK,MAAM,CAAA;IACf,EAAE,EAAO,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B,IAAI,EAAK,CAAC,EAAE,CAAA;IACZ,IAAI,EAAK,MAAM,EAAE,CAAA;IACjB,MAAM,EAAG,MAAM,CAAA;CAChB;AAID,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAG,MAAM,CAAA;IAClB,OAAO,CAAC,EAAI,MAAM,CAAA;IAClB,OAAO,CAAC,EAAI,MAAM,CAAA;IAClB,GAAG,CAAC,EAAQ,MAAM,EAAE,CAAA;IACpB,QAAQ,CAAC,EAAG,QAAQ,CAAA;CACrB"}

package/dist/api/types.js

@@ -0,0 +1,22 @@
+/**
+ * api/types.ts — Types publics de l'API LinkLab niveau 2+
+ *
+ * Ces types sont la surface visible pour les utilisateurs du moteur.
+ * Les types internes (CompiledGraph, RouteInfo, etc.) restent dans types/index.ts.
+ */
+// Factories — évitent les objets littéraux à l'usage
+export const Strategy = {
+    Shortest: () => ({ type: 'Shortest' }),
+    Comfort: () => ({ type: 'Comfort' }),
+    LeastHops: () => ({ type: 'LeastHops' }),
+    Custom: (transferPenalty) => ({ type: 'Custom', transferPenalty }),
+    toPenalty(s) {
+        switch (s.type) {
+            case 'Shortest': return 0;
+            case 'Comfort': return 8;
+            case 'LeastHops': return 50;
+            case 'Custom': return s.transferPenalty;
+        }
+    }
+};
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,qDAAqD;AACrD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,QAAQ,EAAG,GAAa,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACjD,OAAO,EAAI,GAAa,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAChD,SAAS,EAAE,GAAa,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAClD,MAAM,EAAK,CAAC,eAAuB,EAAY,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;IAEvF,SAAS,CAAC,CAAW;QACnB,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,UAAU,CAAC,CAAE,OAAO,CAAC,CAAA;YAC1B,KAAK,SAAS,CAAC,CAAG,OAAO,CAAC,CAAA;YAC1B,KAAK,WAAW,CAAC,CAAC,OAAO,EAAE,CAAA;YAC3B,KAAK,QAAQ,CAAC,CAAI,OAAO,CAAC,CAAC,eAAe,CAAA;QAC5C,CAAC;IACH,CAAC;CACO,CAAA"}

package/dist/config/synonyms.json

@@ -0,0 +1,25 @@
+{
+    "_comment": "Singular → plural irregular mappings for FK resolution. Used by JsonSchemaExtractor to resolve *Id columns to their target table. Add project-specific synonyms in examples/<project>/synonyms.json.",
+    "person": "people",
+    "man": "men",
+    "woman": "women",
+    "child": "children",
+    "company": "companies",
+    "category": "categories",
+    "country": "countries",
+    "city": "cities",
+    "currency": "currencies",
+    "industry": "industries",
+    "activity": "activities",
+    "facility": "facilities",
+    "capability": "capabilities",
+    "authority": "authorities",
+    "community": "communities",
+    "datum": "data",
+    "medium": "media",
+    "criterion": "criteria",
+    "phenomenon": "phenomena",
+    "analysis": "analyses",
+    "basis": "bases",
+    "thesis": "theses"
+}

package/dist/core/EventBus.d.ts

@@ -0,0 +1,56 @@
+/**
+ * EventBus — Bus générique pour hooks, events et errors
+ *
+ * Trois bus distincts, trois contrats clairs :
+ *
+ *   HookBus    — awaitable, peut modifier/annuler le flux
+ *   EventBus   — fire-and-forget, observationnel, ne bloque pas
+ *   ErrorBus   — synchrone, jamais silencieux
+ *
+ * Usage :
+ *   const bus = new EventBus<MyEvents>()
+ *   bus.on('traversal.complete', handler)
+ *   bus.emit('traversal.complete', data)
+ *   bus.off('traversal.complete', handler)
+ */
+export type Handler<T = any> = (data: T) => void;
+export type AsyncHandler<T = any, R = T | void> = (data: T) => Promise<R> | R;
+export declare class EventBus<TEvents extends Record<string, any> = Record<string, any>> {
+    private handlers;
+    on<K extends keyof TEvents & string>(event: K, handler: Handler<TEvents[K]>): () => void;
+    off<K extends keyof TEvents & string>(event: K, handler: Handler<TEvents[K]>): void;
+    emit<K extends keyof TEvents & string>(event: K, data: TEvents[K]): void;
+    clear(event?: string): void;
+    listenerCount(event: string): number;
+}
+export interface HookResult<T> {
+    value: T;
+    cancelled?: boolean;
+    reason?: string;
+}
+export declare class HookBus<THooks extends Record<string, any> = Record<string, any>> {
+    private handlers;
+    on<K extends keyof THooks & string>(hook: K, handler: AsyncHandler<THooks[K]>): () => void;
+    off<K extends keyof THooks & string>(hook: K, handler: AsyncHandler<THooks[K]>): void;
+    /**
+     * Appelle les handlers en séquence.
+     * Chaque handler peut retourner une valeur modifiée — elle est passée au suivant.
+     * Si un handler retourne { cancelled: true }, la chaîne s'arrête.
+     */
+    call<K extends keyof THooks & string>(hook: K, data: THooks[K]): Promise<HookResult<THooks[K]>>;
+    listenerCount(hook: string): number;
+}
+export declare class ErrorBus<TErrors extends Record<string, any> = Record<string, any>> {
+    private handlers;
+    private fallback?;
+    /**
+     * Handler de fallback si aucun handler n'est enregistré pour cette erreur.
+     * Par défaut : console.error.
+     */
+    setFallback(fn: (event: string, data: any) => void): void;
+    on<K extends keyof TErrors & string>(event: K, handler: Handler<TErrors[K]>): () => void;
+    off<K extends keyof TErrors & string>(event: K, handler: Handler<TErrors[K]>): void;
+    emit<K extends keyof TErrors & string>(event: K, data: TErrors[K]): void;
+    listenerCount(event: string): number;
+}
+//# sourceMappingURL=EventBus.d.ts.map

package/dist/core/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../src/core/EventBus.ts"],"names":[],"mappings":"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"}

package/dist/core/EventBus.js

@@ -0,0 +1,147 @@
+/**
+ * EventBus — Bus générique pour hooks, events et errors
+ *
+ * Trois bus distincts, trois contrats clairs :
+ *
+ *   HookBus    — awaitable, peut modifier/annuler le flux
+ *   EventBus   — fire-and-forget, observationnel, ne bloque pas
+ *   ErrorBus   — synchrone, jamais silencieux
+ *
+ * Usage :
+ *   const bus = new EventBus<MyEvents>()
+ *   bus.on('traversal.complete', handler)
+ *   bus.emit('traversal.complete', data)
+ *   bus.off('traversal.complete', handler)
+ */
+// ── EventBus — fire-and-forget ────────────────────────────────
+export class EventBus {
+    handlers = new Map();
+    on(event, handler) {
+        if (!this.handlers.has(event)) {
+            this.handlers.set(event, new Set());
+        }
+        this.handlers.get(event).add(handler);
+        // Retourne une fonction de désinscription
+        return () => this.off(event, handler);
+    }
+    off(event, handler) {
+        this.handlers.get(event)?.delete(handler);
+    }
+    emit(event, data) {
+        const handlers = this.handlers.get(event);
+        if (!handlers?.size)
+            return;
+        // Fire-and-forget — les erreurs dans les handlers ne propagent pas
+        for (const handler of handlers) {
+            try {
+                handler(data);
+            }
+            catch (err) {
+                console.error(`[EventBus] Handler error on "${event}":`, err);
+            }
+        }
+    }
+    clear(event) {
+        if (event) {
+            this.handlers.delete(event);
+        }
+        else {
+            this.handlers.clear();
+        }
+    }
+    listenerCount(event) {
+        return this.handlers.get(event)?.size ?? 0;
+    }
+}
+export class HookBus {
+    handlers = new Map();
+    on(hook, handler) {
+        if (!this.handlers.has(hook)) {
+            this.handlers.set(hook, []);
+        }
+        this.handlers.get(hook).push(handler);
+        return () => this.off(hook, handler);
+    }
+    off(hook, handler) {
+        const list = this.handlers.get(hook);
+        if (!list)
+            return;
+        const idx = list.indexOf(handler);
+        if (idx !== -1)
+            list.splice(idx, 1);
+    }
+    /**
+     * Appelle les handlers en séquence.
+     * Chaque handler peut retourner une valeur modifiée — elle est passée au suivant.
+     * Si un handler retourne { cancelled: true }, la chaîne s'arrête.
+     */
+    async call(hook, data) {
+        const handlers = this.handlers.get(hook);
+        if (!handlers?.length)
+            return { value: data };
+        let current = data;
+        for (const handler of handlers) {
+            const result = await handler(current);
+            // Si le handler retourne un objet avec cancelled, on stoppe
+            if (result && typeof result === 'object' && 'cancelled' in result && result.cancelled) {
+                return { value: current, cancelled: true, reason: result.reason };
+            }
+            // Si le handler retourne une valeur, elle remplace le contexte courant
+            if (result !== undefined && result !== null) {
+                current = result;
+            }
+        }
+        return { value: current };
+    }
+    listenerCount(hook) {
+        return this.handlers.get(hook)?.length ?? 0;
+    }
+}
+// ── ErrorBus — synchrone, jamais silencieux ──────────────────
+export class ErrorBus {
+    handlers = new Map();
+    fallback;
+    /**
+     * Handler de fallback si aucun handler n'est enregistré pour cette erreur.
+     * Par défaut : console.error.
+     */
+    setFallback(fn) {
+        this.fallback = fn;
+    }
+    on(event, handler) {
+        if (!this.handlers.has(event)) {
+            this.handlers.set(event, new Set());
+        }
+        this.handlers.get(event).add(handler);
+        return () => this.off(event, handler);
+    }
+    off(event, handler) {
+        this.handlers.get(event)?.delete(handler);
+    }
+    emit(event, data) {
+        const handlers = this.handlers.get(event);
+        if (!handlers?.size) {
+            // Jamais silencieux — fallback ou console.error
+            if (this.fallback) {
+                this.fallback(event, data);
+            }
+            else {
+                console.error(`[LinkLab Error] ${event}:`, data);
+            }
+            return;
+        }
+        for (const handler of handlers) {
+            try {
+                handler(data);
+            }
+            catch (err) {
+                // Les erreurs dans les error handlers ne doivent jamais être avalées
+                console.error(`[ErrorBus] Handler threw on "${event}":`, err);
+            }
+        }
+    }
+    listenerCount(event) {
+        return this.handlers.get(event)?.size ?? 0;
+    }
+}
+//# sourceMappingURL=EventBus.js.map

package/dist/core/EventBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.js","sourceRoot":"","sources":["../../src/core/EventBus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,iEAAiE;AAEjE,MAAM,OAAO,QAAQ;IACX,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAA;IAElD,EAAE,CAAmC,KAAQ,EAAE,OAA4B;QACzE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;QACrC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAEtC,0CAA0C;QAC1C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACvC,CAAC;IAED,GAAG,CAAmC,KAAQ,EAAE,OAA4B;QAC1E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IAC3C,CAAC;IAED,IAAI,CAAmC,KAAQ,EAAE,IAAgB;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACzC,IAAI,CAAC,QAAQ,EAAE,IAAI;YAAE,OAAM;QAE3B,mEAAmE;QACnE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,CAAA;YACf,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,gCAAgC,KAAK,IAAI,EAAE,GAAG,CAAC,CAAA;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC7B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;QACvB,CAAC;IACH,CAAC;IAED,aAAa,CAAC,KAAa;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAA;IAC5C,CAAC;CACF;AAUD,MAAM,OAAO,OAAO;IACV,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAA;IAEpD,EAAE,CACA,IAAO,EACP,OAAgC;QAEhC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QAC7B,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAEtC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACtC,CAAC;IAED,GAAG,CAAkC,IAAO,EAAE,OAAgC;QAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,CAAC,IAAI;YAAE,OAAM;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACjC,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;IACrC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CACR,IAAO,EACP,IAAe;QAEf,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACxC,IAAI,CAAC,QAAQ,EAAE,MAAM;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;QAE7C,IAAI,OAAO,GAAG,IAAI,CAAA;QAElB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;YAErC,4DAA4D;YAC5D,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,WAAW,IAAI,MAAM,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAA;YACnE,CAAC;YAED,uEAAuE;YACvE,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBAC5C,OAAO,GAAG,MAAmB,CAAA;YAC/B,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;IAC3B,CAAC;IAED,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,CAAA;IAC7C,CAAC;CACF;AAED,gEAAgE;AAEhE,MAAM,OAAO,QAAQ;IACX,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAA;IAC1C,QAAQ,CAAqC;IAErD;;;OAGG;IACH,WAAW,CAAC,EAAsC;QAChD,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;IACpB,CAAC;IAED,EAAE,CAAmC,KAAQ,EAAE,OAA4B;QACzE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;QACrC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAEtC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACvC,CAAC;IAED,GAAG,CAAmC,KAAQ,EAAE,OAA4B;QAC1E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IAC3C,CAAC;IAED,IAAI,CAAmC,KAAQ,EAAE,IAAgB;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAEzC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;YACpB,gDAAgD;YAChD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;YAC5B,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,mBAAmB,KAAK,GAAG,EAAE,IAAI,CAAC,CAAA;YAClD,CAAC;YACD,OAAM;QACR,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,CAAA;YACf,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,qEAAqE;gBACrE,OAAO,CAAC,KAAK,CAAC,gCAAgC,KAAK,IAAI,EAAE,GAAG,CAAC,CAAA;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAED,aAAa,CAAC,KAAa;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAA;IAC5C,CAAC;CACF"}

package/dist/core/GraphEvents.d.ts

@@ -0,0 +1,118 @@
+/**
+ * GraphEvents — Catalogue des événements LinkLab
+ *
+ * Trois bus, trois contrats :
+ *
+ *   graph.hooks   — awaitable, enrichit ou annule le flux
+ *   graph.events  — fire-and-forget, observation pure
+ *   graph.errors  — synchrone, jamais silencieux
+ *
+ * Conventions de nommage :
+ *   hooks  : <sujet>.<moment>   ex: traversal.before, access.check
+ *   events : <sujet>.<résultat> ex: traversal.complete, cache.miss
+ *   errors : <sujet>.<type>     ex: route.notfound, traversal.failed
+ */
+import { HookBus, EventBus, ErrorBus } from './EventBus.js';
+import type { Frame, GraphEdge, NavigationPath, Graph } from '../types/index.js';
+export interface TraversalBeforePayload {
+    from: string;
+    to: string;
+    stack: Frame[];
+    graph: Graph;
+}
+export interface TraversalStepPayload {
+    node: string;
+    edge: GraphEdge;
+    stack: Frame[];
+    depth: number;
+}
+export interface AccessCheckPayload {
+    node: string;
+    stack: Frame[];
+    context?: Record<string, any>;
+}
+export interface StackPushPayload {
+    frame: Frame;
+    stack: Frame[];
+}
+export interface StackPopPayload {
+    frame: Frame;
+    stack: Frame[];
+}
+export interface TraversalCompletePayload {
+    from: string;
+    to: string;
+    path: NavigationPath;
+    durationMs: number;
+    stackDepth: number;
+    routeUsed: string;
+    routeWeight: number;
+    resultCount?: number;
+}
+export interface CacheMissPayload {
+    key: string;
+    requestedAt: number;
+}
+export interface CacheHitPayload {
+    key: string;
+    accessCount: number;
+    cachedAt?: number;
+}
+export interface WeightUpdatedPayload {
+    edge: string;
+    previousWeight: number;
+    newWeight: number;
+    reason?: string;
+}
+export interface StackCompactedPayload {
+    before: Frame[];
+    after: Frame[];
+    removedCount: number;
+}
+export interface RouteNotFoundPayload {
+    from: string;
+    to: string;
+    stack: Frame[];
+}
+export interface TraversalFailedPayload {
+    from: string;
+    to: string;
+    reason: string;
+    error?: Error;
+}
+export interface HookTimeoutPayload {
+    hook: string;
+    timeoutMs: number;
+}
+export interface AccessDeniedPayload {
+    node: string;
+    reason: string;
+    stack: Frame[];
+}
+export interface GraphHooks {
+    'traversal.before': TraversalBeforePayload;
+    'traversal.step': TraversalStepPayload;
+    'access.check': AccessCheckPayload;
+    'stack.push': StackPushPayload;
+    'stack.pop': StackPopPayload;
+}
+export interface GraphEventMap {
+    'traversal.complete': TraversalCompletePayload;
+    'cache.miss': CacheMissPayload;
+    'cache.hit': CacheHitPayload;
+    'weight.updated': WeightUpdatedPayload;
+    'stack.compacted': StackCompactedPayload;
+}
+export interface GraphErrors {
+    'route.notfound': RouteNotFoundPayload;
+    'traversal.failed': TraversalFailedPayload;
+    'hook.timeout': HookTimeoutPayload;
+    'access.denied': AccessDeniedPayload;
+}
+export interface GraphBuses {
+    hooks: HookBus<GraphHooks>;
+    events: EventBus<GraphEventMap>;
+    errors: ErrorBus<GraphErrors>;
+}
+export declare function createGraphBuses(): GraphBuses;
+//# sourceMappingURL=GraphEvents.d.ts.map

package/dist/core/GraphEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphEvents.d.ts","sourceRoot":"","sources":["../../src/core/GraphEvents.ts"],"names":[],"mappings":"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"}

package/dist/core/GraphEvents.js

@@ -0,0 +1,23 @@
+/**
+ * GraphEvents — Catalogue des événements LinkLab
+ *
+ * Trois bus, trois contrats :
+ *
+ *   graph.hooks   — awaitable, enrichit ou annule le flux
+ *   graph.events  — fire-and-forget, observation pure
+ *   graph.errors  — synchrone, jamais silencieux
+ *
+ * Conventions de nommage :
+ *   hooks  : <sujet>.<moment>   ex: traversal.before, access.check
+ *   events : <sujet>.<résultat> ex: traversal.complete, cache.miss
+ *   errors : <sujet>.<type>     ex: route.notfound, traversal.failed
+ */
+import { HookBus, EventBus, ErrorBus } from './EventBus.js';
+export function createGraphBuses() {
+    return {
+        hooks: new HookBus(),
+        events: new EventBus(),
+        errors: new ErrorBus(),
+    };
+}
+//# sourceMappingURL=GraphEvents.js.map

package/dist/core/GraphEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphEvents.js","sourceRoot":"","sources":["../../src/core/GraphEvents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAmI3D,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,KAAK,EAAG,IAAI,OAAO,EAAc;QACjC,MAAM,EAAE,IAAI,QAAQ,EAAiB;QACrC,MAAM,EAAE,IAAI,QAAQ,EAAe;KACpC,CAAA;AACH,CAAC"}

package/dist/core/PathFinder.d.ts

@@ -0,0 +1,43 @@
+/**
+ * PathFinder - Dijkstra + DFS limité
+ *
+ * Deux algorithmes selon l'usage :
+ *
+ *   findShortestPath()  → Dijkstra  (chemin optimal garanti, performant)
+ *   findAllPaths()      → DFS limité (N meilleurs chemins alternatifs)
+ *
+ * Sur un graphe de métro (300+ stations, 900+ arêtes),
+ * le DFS pur explose. Dijkstra est l'algorithme correct.
+ */
+import type { Graph, Path, PathDetails } from '../types/index.js';
+export declare class PathFinder {
+    private graph;
+    private adjacencyList;
+    constructor(graph: Graph);
+    /**
+     * Chemin le plus court par poids (Dijkstra).
+     * Garanti optimal. Performant sur grands graphes.
+     */
+    findShortestPath(from: string, to: string): PathDetails | null;
+    /**
+     * N meilleurs chemins (Yen's K-shortest paths simplifié).
+     * Trouve le plus court via Dijkstra, puis des alternatives
+     * en pénalisant les arêtes du chemin précédent.
+     */
+    findAllPaths(from: string, to: string, maxPaths?: number, _maxDepth?: number, transferPenalty?: number, allowedVia?: string[], minHops?: number): Path[];
+    /**
+     * Dijkstra avec exclusion d'arêtes (pour les chemins alternatifs)
+     */
+    private dijkstraWithExclusions;
+    getPathWeight(path: Path): number;
+    getPathDetails(path: Path): PathDetails;
+    hasPath(from: string, to: string): boolean;
+    getReachableNodes(from: string, maxDepth?: number): Set<string>;
+    private buildAdjacencyList;
+    getStats(): {
+        nodes: number;
+        edges: number;
+        avgDegree: number;
+    };
+}
+//# sourceMappingURL=PathFinder.d.ts.map

package/dist/core/PathFinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathFinder.d.ts","sourceRoot":"","sources":["../../src/core/PathFinder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAa,IAAI,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE5E,qBAAa,UAAU;IAGT,OAAO,CAAC,KAAK;IAFzB,OAAO,CAAC,aAAa,CAAqD;gBAEtD,KAAK,EAAE,KAAK;IAMhC;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IA0E9D;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,SAAS,SAAK,EAAE,eAAe,SAAI,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,SAAI,GAAG,IAAI,EAAE;IAoBrI;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4F9B,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IASjC,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW;IAevC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;IAI1C,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,GAAG,CAAC,MAAM,CAAC;IAc3D,OAAO,CAAC,kBAAkB;IAU1B,QAAQ;;;;;CAST"}