bussing 0.0.0-stage → 0.0.3

package/dist/categories.js

@@ -0,0 +1,45 @@
+// Categorías de problemas y su gravedad.
+/**
+ * De la más grave a la menos grave. Primero lo que puede hacer perder trabajo, después lo que hace fallar en otros entornos.
+ * Las dependencias desactualizadas van antes de subir la versión porque al corregirlas cambia el package.json.
+ */
+export const PROBLEM_CATEGORIES = [
+    'uncommitted',
+    'unpushed',
+    'altered-node-modules',
+    'waiting-dependencies',
+    'outdated-dependencies',
+    'version-not-bumped',
+    'unpublished',
+];
+/** Categoría de cada tipo de problema. `waiting-dependencies` no corresponde a un tipo: la determina `mainCategory`. */
+export const PROBLEM_CATEGORY = {
+    'uncommitted': 'uncommitted',
+    'unpushed': 'unpushed',
+    'no-upstream': 'unpushed',
+    'linked-dependency': 'altered-node-modules',
+    'copied-dependency': 'altered-node-modules',
+    'outdated-dependency': 'outdated-dependencies',
+    'version-not-bumped': 'version-not-bumped',
+    'unpublished-version': 'unpublished',
+    'not-published': 'unpublished',
+};
+/**
+ * Categoría más grave entre los problemas; `null` si no hay problemas.
+ * Si la más grave es `outdated-dependencies` y hay que esperar a alguna de esas dependencias (`mustWait`),
+ * la categoría es `waiting-dependencies`.
+ */
+export function mainCategory(problems, mustWait) {
+    for (const category of PROBLEM_CATEGORIES) {
+        if (problems.some(function (problem) { return PROBLEM_CATEGORY[problem.kind] === category; })) {
+            if (category === 'outdated-dependencies' && problems.some(function (problem) {
+                return problem.kind === 'outdated-dependency' && mustWait(problem.dependency);
+            })) {
+                return 'waiting-dependencies';
+            }
+            return category;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=categories.js.map

package/dist/categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../src/categories.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAIzC;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA+B;IAC1D,aAAa;IACb,UAAU;IACV,sBAAsB;IACtB,sBAAsB;IACtB,uBAAuB;IACvB,oBAAoB;IACpB,aAAa;CAChB,CAAC;AAEF,wHAAwH;AACxH,MAAM,CAAC,MAAM,gBAAgB,GAAyC;IAClE,aAAa,EAAE,aAAa;IAC5B,UAAU,EAAE,UAAU;IACtB,aAAa,EAAE,UAAU;IACzB,mBAAmB,EAAE,sBAAsB;IAC3C,mBAAmB,EAAE,sBAAsB;IAC3C,qBAAqB,EAAE,uBAAuB;IAC9C,oBAAoB,EAAE,oBAAoB;IAC1C,qBAAqB,EAAE,aAAa;IACpC,eAAe,EAAE,aAAa;CACjC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,QAAmB,EAAE,QAAmC;IACjF,KAAK,MAAM,QAAQ,IAAI,kBAAkB,EAAE,CAAC;QACxC,IAAI,QAAQ,CAAC,IAAI,CAAC,UAAU,OAAO,IAAI,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5F,IAAI,QAAQ,KAAK,uBAAuB,IAAI,QAAQ,CAAC,IAAI,CAAC,UAAU,OAAO;gBACvE,OAAO,OAAO,CAAC,IAAI,KAAK,qBAAqB,IAAI,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAClF,CAAC,CAAC,EAAE,CAAC;gBACD,OAAO,sBAAsB,CAAC;YAClC,CAAC;YACD,OAAO,QAAQ,CAAC;QACpB,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/checks.d.ts

@@ -0,0 +1,29 @@
+import * as git from './git.js';
+import { type PackageJson } from './repos.js';
+import type { CopyDifference, Problem, Registry, Warning } from './types.js';
+export interface CheckResult {
+    problems: Problem[];
+    warnings: Warning[];
+}
+export interface GitCheckResult extends CheckResult {
+    /** `null` si la carpeta no es un repositorio git. */
+    state: git.GitState | null;
+}
+export declare function checkGit(dir: string): Promise<GitCheckResult>;
+export declare function checkPublication(dir: string, pkg: PackageJson, state: git.GitState | null, registry: Registry): Promise<CheckResult>;
+/** Versión local de cada paquete revisado (solo los nombres que corresponden a un único repositorio). */
+export type LocalVersions = Map<string, string>;
+export declare function checkCrossDependencies(pkg: PackageJson, localVersions: LocalVersions): CheckResult;
+/** Archivos declarados en `bin` del package.json publicado. */
+export declare function binFiles(tarball: Map<string, Uint8Array>): Set<string>;
+/**
+ * Al instalar, npm (bin-links) cambia el fin de línea CRLF de la primera línea (el shebang) de los ejecutables por LF.
+ * Devuelve el contenido publicado con ese mismo cambio aplicado.
+ */
+export declare function installedBinContent(content: Uint8Array): Uint8Array;
+export declare function compareWithTarball(installedDir: string, tarball: Map<string, Uint8Array>): Promise<CopyDifference[]>;
+/**
+ * Busca en `node_modules` enlaces simbólicos (todas las dependencias) y copias que no coinciden con lo publicado
+ * (solo las dependencias que son repositorios revisados, `localNames`).
+ */
+export declare function checkInstallation(dir: string, localNames: Set<string>, registry: Registry): Promise<CheckResult>;

package/dist/checks.js

@@ -0,0 +1,255 @@
+// Controles por repositorio: git, publicación, dependencias cruzadas e instalación.
+import { lstat, readdir, readFile, readlink, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { guarantee, is } from 'guarantee-type';
+import semver from 'semver';
+import * as git from './git.js';
+import { declaredDependencies, readPackageJson } from './repos.js';
+function emptyResult() {
+    return { problems: [], warnings: [] };
+}
+function isNotFound(err) {
+    return err instanceof Error && 'code' in err && err.code === 'ENOENT';
+}
+async function exists(path) {
+    try {
+        await lstat(path);
+        return true;
+    }
+    catch (err) {
+        if (isNotFound(err))
+            return false;
+        throw err;
+    }
+}
+export async function checkGit(dir) {
+    if (!await exists(join(dir, '.git'))) {
+        return { state: null, problems: [], warnings: [{ check: 'git', message: 'no es un repositorio git' }] };
+    }
+    const state = await git.getState(dir);
+    const result = { state, problems: [], warnings: [] };
+    if (state.changed.length > 0)
+        result.problems.push({ kind: 'uncommitted', files: state.changed });
+    if (state.branch === null) {
+        result.warnings.push({ check: 'git', message: 'HEAD desacoplado (no está en ninguna rama)' });
+    }
+    else if (state.upstream === null) {
+        result.problems.push({ kind: 'no-upstream', branch: state.branch });
+    }
+    if (state.ahead > 0)
+        result.problems.push({ kind: 'unpushed', commits: state.ahead });
+    return result;
+}
+// ---------------------------------------------------------------- publicación
+export async function checkPublication(dir, pkg, state, registry) {
+    const result = emptyResult();
+    if (pkg.private === true)
+        return result;
+    if (pkg.name === undefined || pkg.version === undefined) {
+        result.warnings.push({ check: 'publication', message: 'el package.json no tiene name o version' });
+        return result;
+    }
+    const packument = await registry.getPackument(pkg.name);
+    if (packument === null) {
+        result.problems.push({ kind: 'not-published', version: pkg.version });
+        return result;
+    }
+    const published = packument.versions[pkg.version];
+    if (published === undefined) {
+        result.problems.push({ kind: 'unpublished-version', version: pkg.version, latest: packument.distTags['latest'] ?? null });
+        return result;
+    }
+    const gitHead = published.gitHead;
+    if (gitHead === undefined) {
+        result.warnings.push({ check: 'publication', message: `npm no registró el commit (gitHead) de la versión ${pkg.version}; no se puede saber si hay cambios posteriores` });
+    }
+    else if (state === null || state.head === null) {
+        result.warnings.push({ check: 'publication', message: 'no hay commit local para comparar con el publicado' });
+    }
+    else if (gitHead !== state.head) {
+        if (!await git.commitExists(dir, gitHead)) {
+            result.warnings.push({ check: 'publication', message: `el commit publicado (${gitHead}) no está en el repositorio local` });
+        }
+        else if (await git.isAncestor(dir, gitHead, state.head)) {
+            result.problems.push({ kind: 'version-not-bumped', version: pkg.version, commitsAfterPublish: await git.countCommits(dir, gitHead, state.head) });
+        }
+        else {
+            result.warnings.push({ check: 'publication', message: `el HEAD local no desciende del commit publicado (${gitHead})` });
+        }
+    }
+    return result;
+}
+export function checkCrossDependencies(pkg, localVersions) {
+    const result = emptyResult();
+    for (const dep of declaredDependencies(pkg)) {
+        const local = localVersions.get(dep.name);
+        if (local === undefined || dep.name === pkg.name)
+            continue;
+        const minimum = semver.validRange(dep.spec) === null ? null : semver.minVersion(dep.spec);
+        if (minimum === null) {
+            result.warnings.push({ check: 'cross-dependencies', message: `${dep.name}: la versión declarada "${dep.spec}" (${dep.field}) no es un rango semver` });
+        }
+        else if (semver.valid(local) === null) {
+            result.warnings.push({ check: 'cross-dependencies', message: `${dep.name}: la versión local "${local}" no es semver` });
+        }
+        else if (semver.lt(minimum, local)) {
+            result.problems.push({ kind: 'outdated-dependency', dependency: dep.name, field: dep.field, declared: dep.spec, local });
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------- instalación
+const lockDescription = is.object({
+    lockfileVersion: is.number,
+    packages: is.optional.recordString.object({
+        version: is.optional.string,
+        resolved: is.optional.string,
+        integrity: is.optional.string,
+        link: is.optional.boolean,
+    }),
+});
+/** Nombres de los paquetes instalados en `node_modules` (incluye los que tienen scope). */
+async function installedNames(nodeModules) {
+    const names = [];
+    for (const entry of await readdir(nodeModules, { withFileTypes: true })) {
+        if (entry.name.startsWith('.'))
+            continue;
+        if (entry.name.startsWith('@') && entry.isDirectory()) {
+            for (const scoped of await readdir(join(nodeModules, entry.name)))
+                names.push(`${entry.name}/${scoped}`);
+        }
+        else {
+            names.push(entry.name);
+        }
+    }
+    return names;
+}
+/** Rutas relativas (con `/`) de los archivos de un paquete instalado, sin su `node_modules` interno. */
+async function installedFiles(root, relative = '') {
+    const files = [];
+    for (const entry of await readdir(join(root, relative), { withFileTypes: true })) {
+        const path = relative === '' ? entry.name : `${relative}/${entry.name}`;
+        if (entry.isDirectory()) {
+            if (path !== 'node_modules')
+                files.push(...await installedFiles(root, path));
+        }
+        else {
+            files.push(path);
+        }
+    }
+    return files;
+}
+const binDescription = is.object({
+    bin: { optional: is.union([is.string, is.recordString.string]) },
+});
+function normalizePath(path) {
+    return path.replace(/\\/g, '/').replace(/^(\.\/)+/, '');
+}
+/** Archivos declarados en `bin` del package.json publicado. */
+export function binFiles(tarball) {
+    const packageJson = tarball.get('package.json');
+    if (packageJson === undefined)
+        return new Set();
+    const bin = guarantee(binDescription, JSON.parse(Buffer.from(packageJson).toString('utf8'))).bin;
+    const paths = bin === undefined ? [] : typeof bin === 'string' ? [bin] : Object.values(bin);
+    return new Set(paths.map(normalizePath));
+}
+/**
+ * Al instalar, npm (bin-links) cambia el fin de línea CRLF de la primera línea (el shebang) de los ejecutables por LF.
+ * Devuelve el contenido publicado con ese mismo cambio aplicado.
+ */
+export function installedBinContent(content) {
+    const buffer = Buffer.from(content);
+    const firstLineEnd = buffer.indexOf(0x0a);
+    if (buffer.subarray(0, 2).toString('latin1') === '#!' && firstLineEnd > 0 && buffer[firstLineEnd - 1] === 0x0d) {
+        return Buffer.concat([buffer.subarray(0, firstLineEnd - 1), buffer.subarray(firstLineEnd)]);
+    }
+    return content;
+}
+export async function compareWithTarball(installedDir, tarball) {
+    const differences = [];
+    const installed = new Set(await installedFiles(installedDir));
+    const bins = binFiles(tarball);
+    for (const [path, published] of tarball) {
+        const expected = bins.has(path) ? installedBinContent(published) : published;
+        if (!installed.has(path)) {
+            differences.push({ path, kind: 'missing' });
+        }
+        else if (Buffer.compare(await readFile(join(installedDir, path)), expected) !== 0) {
+            differences.push({ path, kind: 'modified' });
+        }
+    }
+    for (const path of installed) {
+        if (!tarball.has(path))
+            differences.push({ path, kind: 'extra' });
+    }
+    return differences.sort(function (a, b) { return a.path < b.path ? -1 : a.path > b.path ? 1 : 0; });
+}
+/**
+ * Busca en `node_modules` enlaces simbólicos (todas las dependencias) y copias que no coinciden con lo publicado
+ * (solo las dependencias que son repositorios revisados, `localNames`).
+ */
+export async function checkInstallation(dir, localNames, registry) {
+    const result = emptyResult();
+    const nodeModules = join(dir, 'node_modules');
+    if (!await exists(nodeModules))
+        return result;
+    const toCompare = [];
+    for (const name of await installedNames(nodeModules)) {
+        const path = join(nodeModules, name);
+        if ((await lstat(path)).isSymbolicLink()) {
+            result.problems.push({ kind: 'linked-dependency', dependency: name, target: await readlink(path) });
+        }
+        else if (localNames.has(name) && (await stat(path)).isDirectory()) {
+            toCompare.push(name);
+        }
+    }
+    if (toCompare.length === 0)
+        return result;
+    let lockText;
+    try {
+        lockText = await readFile(join(dir, 'package-lock.json'), 'utf8');
+    }
+    catch (err) {
+        if (!isNotFound(err))
+            throw err;
+        result.warnings.push({ check: 'installation', message: `no hay package-lock.json; no se puede verificar ${toCompare.join(', ')}` });
+        return result;
+    }
+    const lock = guarantee(lockDescription, JSON.parse(lockText));
+    if (lock.packages === undefined) {
+        result.warnings.push({ check: 'installation', message: `package-lock.json versión ${lock.lockfileVersion} sin "packages"; no se puede verificar ${toCompare.join(', ')}` });
+        return result;
+    }
+    for (const name of toCompare) {
+        const entry = lock.packages[`node_modules/${name}`];
+        if (entry === undefined || entry.version === undefined) {
+            result.warnings.push({ check: 'installation', message: `${name} no figura en package-lock.json` });
+            continue;
+        }
+        let tarballUrl = entry.resolved;
+        if (tarballUrl === undefined) {
+            const packument = await registry.getPackument(name);
+            tarballUrl = packument?.versions[entry.version]?.tarball;
+        }
+        if (tarballUrl === undefined || !/^https?:\/\//.test(tarballUrl)) {
+            result.warnings.push({ check: 'installation', message: `${name}@${entry.version}: no se encontró el tarball publicado (${tarballUrl ?? 'sin resolved'})` });
+            continue;
+        }
+        const installedDir = join(nodeModules, name);
+        const differences = await compareWithTarball(installedDir, await registry.getTarballFiles(tarballUrl, entry.integrity));
+        if (differences.length > 0) {
+            let installedVersion;
+            try {
+                installedVersion = (await readPackageJson(installedDir)).version ?? null;
+            }
+            catch (err) {
+                installedVersion = null;
+                result.warnings.push({ check: 'installation', message: `no se pudo leer node_modules/${name}/package.json: ${err instanceof Error ? err.message : String(err)}` });
+            }
+            result.problems.push({ kind: 'copied-dependency', dependency: name, version: entry.version, installedVersion, differences });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=checks.js.map

package/dist/checks.js.map

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

package/dist/git.d.ts

@@ -0,0 +1,20 @@
+export interface GitState {
+    /** Rama actual; `null` si el HEAD está desacoplado. */
+    branch: string | null;
+    /** Commit actual; `null` si el repositorio todavía no tiene commits. */
+    head: string | null;
+    upstream: string | null;
+    ahead: number;
+    behind: number;
+    /** Archivos modificados, en conflicto o no versionados (los ignorados no se incluyen). */
+    changed: string[];
+}
+/** Interpreta la salida de `git status --porcelain=v2 --branch -z`. */
+export declare function parseStatus(output: string): GitState;
+export declare function getState(dir: string): Promise<GitState>;
+/** `true` si el commit existe en el repositorio local. */
+export declare function commitExists(dir: string, commit: string): Promise<boolean>;
+/** `true` si `ancestor` es ancestro de `descendant` (o es el mismo commit). */
+export declare function isAncestor(dir: string, ancestor: string, descendant: string): Promise<boolean>;
+/** Cantidad de commits alcanzables desde `to` que no lo son desde `from`. */
+export declare function countCommits(dir: string, from: string, to: string): Promise<number>;

package/dist/git.js

@@ -0,0 +1,88 @@
+// Consultas a git. Se invoca el ejecutable `git` sin shell.
+import { execFile } from 'node:child_process';
+function runGit(dir, args) {
+    return new Promise(function (resolve, reject) {
+        execFile('git', ['-C', dir, ...args], { maxBuffer: 64 * 1024 * 1024, encoding: 'utf8' }, function (err, stdout, stderr) {
+            if (err === null) {
+                resolve({ code: 0, stdout, stderr });
+            }
+            else if (typeof err.code === 'number') {
+                resolve({ code: err.code, stdout, stderr });
+            }
+            else {
+                reject(err);
+            }
+        });
+    });
+}
+async function git(dir, args) {
+    const result = await runGit(dir, args);
+    if (result.code !== 0)
+        throw new Error(`git ${args.join(' ')} (en ${dir}) terminó con código ${result.code}: ${result.stderr.trim()}`);
+    return result.stdout;
+}
+/** Interpreta la salida de `git status --porcelain=v2 --branch -z`. */
+export function parseStatus(output) {
+    const state = { branch: null, head: null, upstream: null, ahead: 0, behind: 0, changed: [] };
+    const items = output.split('\0');
+    for (let i = 0; i < items.length; i++) {
+        const item = items[i] ?? '';
+        if (item.startsWith('# branch.oid ')) {
+            const oid = item.slice('# branch.oid '.length);
+            state.head = oid === '(initial)' ? null : oid;
+        }
+        else if (item.startsWith('# branch.head ')) {
+            const branch = item.slice('# branch.head '.length);
+            state.branch = branch === '(detached)' ? null : branch;
+        }
+        else if (item.startsWith('# branch.upstream ')) {
+            state.upstream = item.slice('# branch.upstream '.length);
+        }
+        else if (item.startsWith('# branch.ab ')) {
+            const match = /^# branch\.ab \+(\d+) -(\d+)$/.exec(item);
+            if (match === null)
+                throw new Error(`Línea de git status no reconocida: ${item}`);
+            state.ahead = Number(match[1]);
+            state.behind = Number(match[2]);
+        }
+        else if (item.startsWith('1 ')) {
+            state.changed.push(item.split(' ').slice(8).join(' '));
+        }
+        else if (item.startsWith('2 ')) {
+            state.changed.push(item.split(' ').slice(9).join(' '));
+            i++; // el siguiente elemento es la ruta original del renombre
+        }
+        else if (item.startsWith('u ')) {
+            state.changed.push(item.split(' ').slice(10).join(' '));
+        }
+        else if (item.startsWith('? ')) {
+            state.changed.push(item.slice(2));
+        }
+        else if (item !== '' && !item.startsWith('# ')) {
+            throw new Error(`Línea de git status no reconocida: ${item}`);
+        }
+    }
+    return state;
+}
+export async function getState(dir) {
+    return parseStatus(await git(dir, ['status', '--porcelain=v2', '--branch', '-z', '--untracked-files=normal']));
+}
+/** `true` si el commit existe en el repositorio local. */
+export async function commitExists(dir, commit) {
+    const result = await runGit(dir, ['cat-file', '-e', `${commit}^{commit}`]);
+    return result.code === 0;
+}
+/** `true` si `ancestor` es ancestro de `descendant` (o es el mismo commit). */
+export async function isAncestor(dir, ancestor, descendant) {
+    const result = await runGit(dir, ['merge-base', '--is-ancestor', ancestor, descendant]);
+    if (result.code === 0)
+        return true;
+    if (result.code === 1)
+        return false;
+    throw new Error(`git merge-base --is-ancestor (en ${dir}) terminó con código ${result.code}: ${result.stderr.trim()}`);
+}
+/** Cantidad de commits alcanzables desde `to` que no lo son desde `from`. */
+export async function countCommits(dir, from, to) {
+    return Number((await git(dir, ['rev-list', '--count', `${from}..${to}`])).trim());
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

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

package/dist/order.d.ts

@@ -0,0 +1,14 @@
+import type { CleanupStep, ProblemCategory } from './types.js';
+export interface OrderNode {
+    /** Identifica al nodo (la carpeta del repositorio, porque dos repositorios pueden tener el mismo nombre). */
+    dir: string;
+    name: string;
+    /** Categoría del problema propio más grave; `null` si no tiene problemas propios. */
+    mainProblem: ProblemCategory | null;
+    /** Carpetas de los repositorios revisados de los que depende (dependencias fuertes: siempre se respetan en el orden). */
+    dependsOn: string[];
+    /** Carpetas de los repositorios revisados de los que depende como devDependency (débiles: se respetan salvo que cierren un ciclo). */
+    weakDependsOn: string[];
+}
+/** `priority`: prioridad de cada paquete como dependencia débil (por omisión 0); ver `BussingOptions.dependencyPriority`. */
+export declare function computeCleanupOrder(nodes: OrderNode[], priority?: ReadonlyMap<string, number>): CleanupStep[];

package/dist/order.js

@@ -0,0 +1,154 @@
+// Orden de limpieza: repositorios con problemas y los que dependen de ellos, en orden topológico.
+// Las dependencias fuertes (dependencies, optionalDependencies, peerDependencies) definen quién entra en la lista y se
+// respetan siempre; las débiles (devDependencies) solo ordenan, y se descartan si cierran un ciclo.
+import { defined, mustGet } from './util.js';
+function byName(a, b) {
+    return a.name < b.name ? -1 : a.name > b.name ? 1 : a.dir < b.dir ? -1 : a.dir > b.dir ? 1 : 0;
+}
+/** Componentes fuertemente conexas (Tarjan), para tratar cada ciclo de dependencias como un solo paso. */
+function stronglyConnectedComponents(dirs, edges) {
+    const component = new Map();
+    const index = new Map();
+    const low = new Map();
+    const stack = [];
+    const onStack = new Set();
+    let counter = 0;
+    let components = 0;
+    function visit(dir) {
+        index.set(dir, counter);
+        low.set(dir, counter);
+        counter++;
+        stack.push(dir);
+        onStack.add(dir);
+        for (const next of edges.get(dir) ?? []) {
+            if (!index.has(next)) {
+                visit(next);
+                low.set(dir, Math.min(mustGet(low, dir), mustGet(low, next)));
+            }
+            else if (onStack.has(next)) {
+                low.set(dir, Math.min(mustGet(low, dir), mustGet(index, next)));
+            }
+        }
+        if (low.get(dir) === index.get(dir)) {
+            let member;
+            do {
+                member = defined(stack.pop(), 'elemento de la pila');
+                onStack.delete(member);
+                component.set(member, components);
+            } while (member !== dir);
+            components++;
+        }
+    }
+    for (const dir of dirs)
+        if (!index.has(dir))
+            visit(dir);
+    return component;
+}
+/** `true` si desde `from` se llega a `to` siguiendo las aristas. */
+function reaches(edges, from, to) {
+    const visited = new Set();
+    const pending = [from];
+    while (pending.length > 0) {
+        const current = defined(pending.pop(), 'pendiente');
+        if (current === to)
+            return true;
+        if (visited.has(current))
+            continue;
+        visited.add(current);
+        pending.push(...(edges.get(current) ?? []));
+    }
+    return false;
+}
+/** `priority`: prioridad de cada paquete como dependencia débil (por omisión 0); ver `BussingOptions.dependencyPriority`. */
+export function computeCleanupOrder(nodes, priority = new Map()) {
+    const byDir = new Map(nodes.map(function (node) { return [node.dir, node]; }));
+    const dependents = new Map();
+    for (const node of nodes) {
+        for (const dep of node.dependsOn)
+            dependents.set(dep, [...(dependents.get(dep) ?? []), node.dir]);
+    }
+    // Los repositorios con problemas propios y, transitivamente por las dependencias fuertes, los que dependen de ellos
+    const included = new Set();
+    const pending = nodes.filter(function (node) { return node.mainProblem !== null; }).map(function (node) { return node.dir; });
+    while (pending.length > 0) {
+        const dir = defined(pending.pop(), 'pendiente');
+        if (included.has(dir))
+            continue;
+        included.add(dir);
+        pending.push(...(dependents.get(dir) ?? []));
+    }
+    const dirs = [...included].sort();
+    const strongEdges = new Map(dirs.map(function (dir) {
+        return [dir, mustGet(byDir, dir).dependsOn.filter(function (dep) { return included.has(dep); })];
+    }));
+    // Los ciclos de dependencias fuertes forman un solo paso
+    const component = stronglyConnectedComponents(dirs, strongEdges);
+    const componentEdges = new Map();
+    function addComponentEdge(from, to) {
+        const set = componentEdges.get(from) ?? new Set();
+        set.add(to);
+        componentEdges.set(from, set);
+    }
+    for (const dir of dirs) {
+        for (const dep of mustGet(strongEdges, dir)) {
+            if (mustGet(component, dep) !== mustGet(component, dir))
+                addComponentEdge(mustGet(component, dir), mustGet(component, dep));
+        }
+    }
+    // Las dependencias débiles se respetan salvo que cierren un ciclo. Se agregan primero las de mayor prioridad (según la
+    // dependencia) y, a igual prioridad, por nombre, para que el resultado sea reproducible. Las que cerrarían un ciclo se postergan.
+    const acceptedWeak = new Map(dirs.map(function (dir) { return [dir, []]; }));
+    const deferredWeak = new Map(dirs.map(function (dir) { return [dir, []]; }));
+    const priorityOf = function (dir) { return priority.get(mustGet(byDir, dir).name) ?? 0; };
+    const weakEdges = [];
+    for (const dir of dirs) {
+        for (const dep of mustGet(byDir, dir).weakDependsOn)
+            if (included.has(dep))
+                weakEdges.push([dir, dep]);
+    }
+    weakEdges.sort(function ([dirA, depA], [dirB, depB]) {
+        return priorityOf(depB) - priorityOf(depA) || byName(mustGet(byDir, dirA), mustGet(byDir, dirB)) || byName(mustGet(byDir, depA), mustGet(byDir, depB));
+    });
+    for (const [dir, dep] of weakEdges) {
+        const from = mustGet(component, dir);
+        const to = mustGet(component, dep);
+        if (from === to)
+            continue;
+        if (reaches(componentEdges, to, from)) {
+            mustGet(deferredWeak, dir).push(dep);
+        }
+        else {
+            addComponentEdge(from, to);
+            mustGet(acceptedWeak, dir).push(dep);
+        }
+    }
+    // Nivel de cada componente: 0 si no depende de otra componente; si no, uno más que la de mayor nivel de la que depende
+    const levels = new Map();
+    function levelOf(id) {
+        const known = levels.get(id);
+        if (known !== undefined)
+            return known;
+        let level = 0;
+        for (const dep of componentEdges.get(id) ?? [])
+            level = Math.max(level, levelOf(dep) + 1);
+        levels.set(id, level);
+        return level;
+    }
+    const steps = dirs.map(function (dir) {
+        const node = mustGet(byDir, dir);
+        const id = mustGet(component, dir);
+        const names = function (list) { return list.map(function (d) { return mustGet(byDir, d).name; }).sort(); };
+        const deps = [...mustGet(strongEdges, dir).filter(function (dep) { return mustGet(component, dep) !== id; }), ...mustGet(acceptedWeak, dir)];
+        return {
+            name: node.name,
+            dir,
+            level: levelOf(id),
+            mainProblem: node.mainProblem,
+            dependsOn: names([...new Set(deps)]),
+            deferred: names(mustGet(deferredWeak, dir)),
+            inCycleWith: names(dirs.filter(function (other) { return other !== dir && mustGet(component, other) === id; })),
+        };
+    });
+    return steps.sort(function (a, b) { return a.level - b.level || byName(a, b); });
+}
+//# sourceMappingURL=order.js.map