@fairgarden/distribution 0.1.0-alpha.0 → 0.1.0-alpha.2

package/dist/manifest.js

@@ -0,0 +1,64 @@
+import { readFileSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { submodules, uninitialised } from "./submodules.js";
+/** What this distribution ships, read from its checkouts. */
+export const shippedModules = (root) => {
+    const missing = uninitialised(root);
+    if (missing.length > 0) {
+        throw new Error(`These modules are not checked out, so what they are cannot be recorded: ${missing.join(', ')}. ` +
+            'Publish from a clone with its submodules (actions/checkout: `submodules: true`).');
+    }
+    const modules = {};
+    for (const submodule of submodules(root)) {
+        let pkg;
+        try {
+            pkg = JSON.parse(readFileSync(path.join(submodule.path, 'package.json'), 'utf8'));
+        }
+        catch {
+            continue;
+        }
+        if (typeof pkg.name !== 'string' || typeof pkg.version !== 'string')
+            continue;
+        modules[pkg.name] = {
+            version: pkg.version,
+            path: submodule.relativePath,
+            repository: submodule.url,
+            ...(submodule.upstream ? { upstream: submodule.upstream } : {}),
+            commit: submodule.pinned,
+        };
+    }
+    return modules;
+};
+/**
+ * Write what the distribution ships into its manifest, ready to publish.
+ *
+ * For CI, before `npm publish`: the repository's manifest is left without it,
+ * since the submodules already say it.
+ */
+export const stampModules = async (root, fields = {}) => {
+    const file = path.join(root, 'package.json');
+    const manifest = JSON.parse(await readFile(file, 'utf8'));
+    const modules = shippedModules(root);
+    await writeFile(file, `${JSON.stringify({
+        ...manifest,
+        ...fields,
+        distribution: { ...manifest.distribution, modules },
+    }, null, 2)}\n`);
+    return modules;
+};
+/**
+ * The modules a published distribution records, with where each lives, or
+ * undefined when it records none: published before this was written down.
+ */
+export const readPublishedModules = (manifest) => {
+    const modules = manifest.distribution?.modules;
+    if (!modules || typeof modules !== 'object')
+        return undefined;
+    const entries = Object.entries(modules).filter(([, module]) => typeof module?.version === 'string' &&
+        typeof module.path === 'string' &&
+        typeof module.repository === 'string' &&
+        typeof module.commit === 'string');
+    return Object.fromEntries(entries);
+};
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/policy.d.ts

@@ -0,0 +1,86 @@
+/**
+ * A distribution's policy: the organization's rules for every service it
+ * ships, kept in `policies/` beside `apps/` and `packages/`, and marked by the
+ * `.manifest` that says whose they are.
+ *
+ * It is built in layers — each module's own `policies/`, then the policy of
+ * any distribution this one extends, then its own — into one bundle, named
+ * after the distribution's version and what is in it. `policies/` is a
+ * workspace package, so turbo builds it once, and every service's build
+ * takes a copy (`fg-dist policy use`) to run. Upgrading a module brings its
+ * rules; the organization's stay as they were.
+ *
+ * Compiling is `@fairgarden/policy`'s: this finds the layers and hands them
+ * to whichever `fg-policy` the distribution installed.
+ */
+export declare const POLICIES = "policies";
+/** Where the bundle is built, inside `policies/`. */
+export declare const BUILT: string;
+/** Where a service runs it from, inside the service; `@fairgarden/policy` looks there. */
+export declare const USED: string;
+export interface DistributionPolicy {
+    /** The distribution's root. */
+    root: string;
+    /** Its `policies/`. */
+    dir: string;
+    /** The distribution's version: the release every revision belongs to. */
+    version: string | undefined;
+    /** Each module's own `policies/`. */
+    bases: string[];
+    /** The published `policies/` of each distribution this extends, the furthest first. */
+    parents: string[];
+    /** Where the bundle is built. */
+    built: string;
+}
+/**
+ * The distribution around `from`, if it has a policy: the nearest directory
+ * above with an organization's `policies/`. Found on disk rather than by
+ * git, which a build host may not have, and which stops at a submodule.
+ */
+export declare const findPolicy: (from: string) => DistributionPolicy | undefined;
+/**
+ * What the bundle is built from, as a digest: every rule, setting and
+ * manifest in every layer, and the version it is named after. A bundle built
+ * from anything else — a rule since changed, added or deleted — is out of date.
+ */
+export declare const inputsDigest: (policy: DistributionPolicy) => string;
+/** Build the bundle, named after the distribution's version. */
+export declare const buildPolicy: (policy: DistributionPolicy, from?: string, out?: string) => number;
+/** Each module's tests on its own rules, then the organization's on them all. */
+export declare const testPolicy: (policy: DistributionPolicy, from?: string) => number;
+/**
+ * Put the distribution's policy beside the service in `project`, for it to
+ * run: the bundle turbo already built, or one built now if there is none, or
+ * it was built from anything other than the rules as they are. Outside a
+ * distribution, nothing — and no copy left from before: the service's
+ * built-in rules decide.
+ */
+export declare const usePolicy: (project: string) => {
+    policy?: DistributionPolicy;
+    status: number;
+};
+type TurboTask = {
+    dependsOn?: string[];
+    inputs?: string[];
+    outputs?: string[];
+    [key: string]: unknown;
+};
+/**
+ * What turbo needs, so the policy is built once however many services run
+ * it: the policy's own tasks, which read every module's rules as well as its
+ * own, and each project whose build uses it waiting for it to be built.
+ *
+ * A project's task is the generic one plus the policy, unless `existing`
+ * already has one for it: that is kept as it is — a monolith's waits for its
+ * apps' libraries rather than their builds, say — and only gains the policy.
+ */
+export declare const turboTasks: (policy: DistributionPolicy, generic: TurboTask, genericDev?: TurboTask, existing?: Record<string, TurboTask>) => Record<string, TurboTask>;
+/**
+ * Write the policy's tasks into turbo.json, or with `check`, say which are
+ * missing or out of date. Returns what differed.
+ */
+export declare const setupTurbo: (policy: DistributionPolicy, { check }?: {
+    check?: boolean | undefined;
+}) => string[];
+export {};
+//# sourceMappingURL=policy.d.ts.map

package/dist/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,QAAQ,aAAa,CAAA;AAClC,qDAAqD;AACrD,eAAO,MAAM,KAAK,QAAuC,CAAA;AACzD,0FAA0F;AAC1F,eAAO,MAAM,IAAI,QAA0C,CAAA;AAI3D,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,yEAAyE;IACzE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,qCAAqC;IACrC,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,uFAAuF;IACvF,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAA;CACd;AAkDD;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,kBAAkB,GAAG,SAM9D,CAAA;AAgDD;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,kBAAkB,KAAG,MAazD,CAAA;AAKD,gEAAgE;AAChE,eAAO,MAAM,WAAW,GAAI,QAAQ,kBAAkB,EAAE,aAAkB,EAAE,YAAkB,KAAG,MAWhG,CAAA;AAED,iFAAiF;AACjF,eAAO,MAAM,UAAU,GAAI,QAAQ,kBAAkB,EAAE,aAAkB,KAAG,MACzB,CAAA;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,KAAG;IAAE,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAkBxF,CAAA;AAED,KAAK,SAAS,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAA;AAMxG;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACrB,QAAQ,kBAAkB,EAC1B,SAAS,SAAS,EAClB,aAAY,SAA8C,EAC1D,WAAU,MAAM,CAAC,MAAM,EAAE,SAAS,CAAM,KACvC,MAAM,CAAC,MAAM,EAAE,SAAS,CA4C1B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,kBAAkB,EAAE;;CAAsB,KAAG,MAAM,EAWrF,CAAA"}

package/dist/policy.js

@@ -0,0 +1,269 @@
+import { spawnSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+/**
+ * A distribution's policy: the organization's rules for every service it
+ * ships, kept in `policies/` beside `apps/` and `packages/`, and marked by the
+ * `.manifest` that says whose they are.
+ *
+ * It is built in layers — each module's own `policies/`, then the policy of
+ * any distribution this one extends, then its own — into one bundle, named
+ * after the distribution's version and what is in it. `policies/` is a
+ * workspace package, so turbo builds it once, and every service's build
+ * takes a copy (`fg-dist policy use`) to run. Upgrading a module brings its
+ * rules; the organization's stay as they were.
+ *
+ * Compiling is `@fairgarden/policy`'s: this finds the layers and hands them
+ * to whichever `fg-policy` the distribution installed.
+ */
+export const POLICIES = 'policies';
+/** Where the bundle is built, inside `policies/`. */
+export const BUILT = path.join('dist', 'policies.tar.gz');
+/** Where a service runs it from, inside the service; `@fairgarden/policy` looks there. */
+export const USED = path.join('.policy', 'policies.tar.gz');
+/** What marks a project as running the policy, in its build script. */
+const USES = 'fg-dist policy use';
+const readJson = (file) => JSON.parse(readFileSync(file, 'utf8'));
+/** A `policies/` with a `.manifest` is an organization's; a module's own has none. */
+const isOrganizations = (dir) => existsSync(path.join(dir, '.manifest'));
+/** The published policy of what `root` extends, and of what that extends, the furthest first. */
+const parentsOf = (root, seen = new Set()) => {
+    const parent = readJson(path.join(root, 'package.json')).distribution?.extends;
+    if (!parent || seen.has(parent))
+        return [];
+    seen.add(parent);
+    let parentRoot;
+    try {
+        parentRoot = path.dirname(createRequire(path.join(root, 'package.json')).resolve(`${parent}/package.json`));
+    }
+    catch {
+        // Not installed: `fg-dist check` says so; there is nothing to build on.
+        return [];
+    }
+    const dir = path.join(parentRoot, POLICIES);
+    return [...parentsOf(parentRoot, seen), ...(isOrganizations(dir) ? [dir] : [])];
+};
+const describe = (root) => {
+    const bases = [];
+    for (const group of ['apps', 'packages']) {
+        const entries = existsSync(path.join(root, group)) ? readdirSync(path.join(root, group)).sort() : [];
+        for (const name of entries) {
+            const dir = path.join(root, group, name, POLICIES);
+            if (existsSync(dir) && statSync(dir).isDirectory() && !isOrganizations(dir))
+                bases.push(dir);
+        }
+    }
+    const dir = path.join(root, POLICIES);
+    return {
+        root,
+        dir,
+        version: readJson(path.join(root, 'package.json')).version,
+        bases,
+        parents: parentsOf(root),
+        built: path.join(dir, BUILT),
+    };
+};
+/**
+ * The distribution around `from`, if it has a policy: the nearest directory
+ * above with an organization's `policies/`. Found on disk rather than by
+ * git, which a build host may not have, and which stops at a submodule.
+ */
+export const findPolicy = (from) => {
+    for (let dir = path.resolve(from);; dir = path.dirname(dir)) {
+        if (path.basename(dir) === POLICIES && isOrganizations(dir))
+            return describe(path.dirname(dir));
+        if (isOrganizations(path.join(dir, POLICIES)))
+            return describe(dir);
+        if (path.dirname(dir) === dir)
+            return undefined;
+    }
+};
+/** Where a package is installed, seen from `base`, whether or not it exports its package.json. */
+const packageDir = (base, name) => {
+    const require = createRequire(path.join(base, 'package.json'));
+    try {
+        return path.dirname(require.resolve(`${name}/package.json`));
+    }
+    catch {
+        // Not exported: find it from its entry point instead.
+    }
+    try {
+        for (let dir = path.dirname(require.resolve(name)); path.dirname(dir) !== dir; dir = path.dirname(dir)) {
+            const file = path.join(dir, 'package.json');
+            if (existsSync(file) && readJson(file).name === name)
+                return dir;
+        }
+    }
+    catch {
+        // Not installed here.
+    }
+    return undefined;
+};
+/** The `fg-policy` the distribution installed, from `from` or its root. */
+const fgPolicy = (policy, from) => {
+    for (const base of [from, policy.dir, policy.root]) {
+        const dir = packageDir(base, '@fairgarden/policy');
+        if (!dir)
+            continue;
+        const { bin } = readJson(path.join(dir, 'package.json'));
+        return path.join(dir, bin['fg-policy']);
+    }
+    throw new Error('@fairgarden/policy is not installed here; add it to policies/package.json.');
+};
+const layerArgs = (policy) => {
+    const relative = (dir) => path.relative(policy.root, dir);
+    return [
+        '--dir',
+        relative(policy.dir),
+        ...policy.bases.flatMap((dir) => ['--base', relative(dir)]),
+        ...policy.parents.flatMap((dir) => ['--parent', relative(dir)]),
+    ];
+};
+const run = (policy, from, args) => {
+    const result = spawnSync(process.execPath, [fgPolicy(policy, from), ...args], { cwd: policy.root, stdio: 'inherit' });
+    if (result.error)
+        throw result.error;
+    return result.status ?? 1;
+};
+/**
+ * What the bundle is built from, as a digest: every rule, setting and
+ * manifest in every layer, and the version it is named after. A bundle built
+ * from anything else — a rule since changed, added or deleted — is out of date.
+ */
+export const inputsDigest = (policy) => {
+    const hash = createHash('sha256').update(`${policy.version ?? ''}\0`);
+    for (const dir of [...policy.bases, ...policy.parents, policy.dir]) {
+        const files = readdirSync(dir, { recursive: true, encoding: 'utf8' })
+            .filter((file) => !file.split(path.sep).some((part) => part === 'node_modules' || part === 'dist'))
+            .filter((file) => /(\.rego|data\.json|\.manifest)$/.test(file))
+            .sort();
+        for (const file of files) {
+            hash.update(`${path.relative(policy.root, path.join(dir, file)).split(path.sep).join('/')}\0`);
+            hash.update(readFileSync(path.join(dir, file))).update('\0');
+        }
+    }
+    return hash.digest('hex');
+};
+/** Beside the bundle: the digest of what it was built from. */
+const inputsFile = (built) => `${built}.inputs`;
+/** Build the bundle, named after the distribution's version. */
+export const buildPolicy = (policy, from = policy.root, out = policy.built) => {
+    const digest = inputsDigest(policy);
+    const status = run(policy, from, [
+        'build',
+        ...layerArgs(policy),
+        ...(policy.version ? ['--release', policy.version] : []),
+        '--out',
+        out,
+    ]);
+    if (status === 0)
+        writeFileSync(inputsFile(out), `${digest}\n`);
+    return status;
+};
+/** Each module's tests on its own rules, then the organization's on them all. */
+export const testPolicy = (policy, from = policy.root) => run(policy, from, ['test', ...layerArgs(policy)]);
+/**
+ * Put the distribution's policy beside the service in `project`, for it to
+ * run: the bundle turbo already built, or one built now if there is none, or
+ * it was built from anything other than the rules as they are. Outside a
+ * distribution, nothing — and no copy left from before: the service's
+ * built-in rules decide.
+ */
+export const usePolicy = (project) => {
+    const used = path.join(project, USED);
+    const policy = findPolicy(project);
+    if (!policy) {
+        rmSync(used, { force: true });
+        return { status: 0 };
+    }
+    const built = existsSync(inputsFile(policy.built)) ? readFileSync(inputsFile(policy.built), 'utf8').trim() : undefined;
+    if (!existsSync(policy.built) || built !== inputsDigest(policy)) {
+        const status = buildPolicy(policy, project);
+        if (status !== 0)
+            return { policy, status };
+    }
+    mkdirSync(path.dirname(used), { recursive: true });
+    // Whole or not at all, for a server reading it meanwhile.
+    const partial = `${used}.${process.pid}.partial`;
+    copyFileSync(policy.built, partial);
+    renameSync(partial, used);
+    return { policy, status: 0 };
+};
+/** `list` with `entry` at the end, unless it has it already. */
+const including = (list, entry) => list?.includes(entry) ? list : [...(list ?? []), entry];
+/**
+ * What turbo needs, so the policy is built once however many services run
+ * it: the policy's own tasks, which read every module's rules as well as its
+ * own, and each project whose build uses it waiting for it to be built.
+ *
+ * A project's task is the generic one plus the policy, unless `existing`
+ * already has one for it: that is kept as it is — a monolith's waits for its
+ * apps' libraries rather than their builds, say — and only gains the policy.
+ */
+export const turboTasks = (policy, generic, genericDev = { persistent: true, cache: false }, existing = {}) => {
+    const name = readJson(path.join(policy.dir, 'package.json')).name;
+    if (!name)
+        throw new Error(`${path.join(POLICIES, 'package.json')} needs a name.`);
+    const inputs = [
+        '$TURBO_DEFAULT$',
+        '$TURBO_ROOT$/apps/*/policies/**',
+        '$TURBO_ROOT$/packages/*/policies/**',
+        // The distribution's version names every revision.
+        '$TURBO_ROOT$/package.json',
+        // What it extends is installed, so its policy changes with the lockfile.
+        ...(policy.parents.length > 0 ? ['$TURBO_ROOT$/pnpm-lock.yaml'] : []),
+    ];
+    // Not hashed: which opa compiles it changes nothing, and the commit is only
+    // where a revision was first built — the same rules are the same revision.
+    // A signing key is hashed, so adding one does not bring back an unsigned build.
+    const passThroughEnv = ['OPA', 'VERCEL_GIT_COMMIT_SHA', 'GITHUB_SHA'];
+    const tasks = {
+        [`${name}#build`]: { dependsOn: ['^build'], inputs, outputs: ['dist/**'], env: ['FG_POLICY_SIGNING_KEY'], passThroughEnv },
+        [`${name}#test`]: { dependsOn: ['^build'], inputs, passThroughEnv: ['OPA'] },
+    };
+    for (const group of ['apps', 'packages']) {
+        const entries = existsSync(path.join(policy.root, group)) ? readdirSync(path.join(policy.root, group)).sort() : [];
+        for (const entry of entries) {
+            const file = path.join(policy.root, group, entry, 'package.json');
+            if (!existsSync(file))
+                continue;
+            const pkg = readJson(file);
+            if (!pkg.name)
+                continue;
+            if (pkg.scripts?.build?.includes(USES)) {
+                const base = existing[`${pkg.name}#build`] ?? generic;
+                tasks[`${pkg.name}#build`] = {
+                    ...base,
+                    dependsOn: including(base.dependsOn, `${name}#build`),
+                    // The copy it runs is part of what it built: a cached build brings it back.
+                    outputs: including(base.outputs, `${path.dirname(USED)}/**`),
+                };
+            }
+            // A fresh checkout has built neither the policy nor the tools that build it.
+            if (pkg.scripts?.dev?.includes(USES)) {
+                const base = existing[`${pkg.name}#dev`] ?? genericDev;
+                tasks[`${pkg.name}#dev`] = { ...base, dependsOn: including(base.dependsOn, `${name}#build`) };
+            }
+        }
+    }
+    return tasks;
+};
+/**
+ * Write the policy's tasks into turbo.json, or with `check`, say which are
+ * missing or out of date. Returns what differed.
+ */
+export const setupTurbo = (policy, { check = false } = {}) => {
+    const file = path.join(policy.root, 'turbo.json');
+    const turbo = readJson(file);
+    const tasks = turbo.tasks ?? {};
+    const wanted = turboTasks(policy, tasks.build ?? { dependsOn: ['^build'] }, tasks.dev, tasks);
+    const differ = Object.keys(wanted).filter((key) => JSON.stringify(tasks[key]) !== JSON.stringify(wanted[key]));
+    if (!check && differ.length > 0) {
+        turbo.tasks = { ...tasks, ...wanted };
+        writeFileSync(file, `${JSON.stringify(turbo, null, 2)}\n`);
+    }
+    return differ;
+};
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

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

package/dist/readme.d.ts

@@ -24,6 +24,8 @@ export interface ModuleVersion {
     released: boolean;
     /** Where the repository can be browsed, when it has a web address. */
     url: string | undefined;
+    /** For a fork, where the repository it was forked from can be browsed, or its url. */
+    upstream: string | undefined;
     /** What the module is, from its own package.json. */
     description: string | undefined;
 }

package/dist/readme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readme.d.ts","sourceRoot":"","sources":["../src/readme.ts"],"names":[],"mappings":"AA2CA;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,MAAM,EACd,QAAQ,MAAM,EACd,MAAM,MAAM;AACZ;;;;GAIG;AACH,QAAQ,MAAM,KACb,MA2BF,CAAA;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,mEAAmE;IACnE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;IACvB,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAA;IACjB,sEAAsE;IACtE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;IACvB,qDAAqD;IACrD,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;CAChC;AAqCD,0DAA0D;AAC1D,eAAO,MAAM,cAAc,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,aAAa,EAAE,CAS1E,CAAA;AAkED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,KAAG,MA4DhE,CAAA;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,+EAA+E;IAC/E,IAAI,EAAE,cAAc,GAAG,QAAQ,CAAA;CAChC;AA8BD;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,MAAM,EACZ,YAAmB;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,KAC1C,OAAO,CAAC,YAAY,CA6FtB,CAAA"}
+{"version":3,"file":"readme.d.ts","sourceRoot":"","sources":["../src/readme.ts"],"names":[],"mappings":"AA2CA;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,MAAM,EACd,QAAQ,MAAM,EACd,MAAM,MAAM;AACZ;;;;GAIG;AACH,QAAQ,MAAM,KACb,MA2BF,CAAA;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,mEAAmE;IACnE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;IACvB,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAA;IACjB,sEAAsE;IACtE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;IACvB,sFAAsF;IACtF,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,qDAAqD;IACrD,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;CAChC;AAqCD,0DAA0D;AAC1D,eAAO,MAAM,cAAc,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,aAAa,EAAE,CAS1E,CAAA;AAuED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,KAAG,MA4DhE,CAAA;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,+EAA+E;IAC/E,IAAI,EAAE,cAAc,GAAG,QAAQ,CAAA;CAChC;AA8BD;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,MAAM,EACZ,YAAmB;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,KAC1C,OAAO,CAAC,YAAY,CA6FtB,CAAA"}

package/dist/readme.js

@@ -100,6 +100,7 @@ const readManifest = async (submodule) => {
             tag: state.current,
             released: state.exact,
             url: browsableAt(submodule.url),
+            upstream: submodule.upstream && (browsableAt(submodule.upstream) ?? submodule.upstream),
         };
     }
     catch {
@@ -116,7 +117,11 @@ const modulesTable = (modules) => {
             // An empty cell is honest: it shows which modules have yet to say what
             // they are, rather than hiding it.
             const what = module.description ? `<br>${module.description}` : '';
-            return `| ${name}${what} | ${module.version} | ${pinnedAs(module)} | \`${module.relativePath}\` |`;
+            // A fork is shipped from somewhere other than where the module lives.
+            const fork = module.upstream
+                ? `<br>Fork of ${/^https?:/.test(module.upstream) ? link(module.upstream.replace(/^https?:\/\//, ''), module.upstream) : module.upstream}`
+                : '';
+            return `| ${name}${what}${fork} | ${module.version} | ${pinnedAs(module)} | \`${module.relativePath}\` |`;
         }),
     ];
     // Only worth explaining when something is actually unreleased.

package/dist/readme.js.map

@@ -1 +1 @@
-{"version":3,"file":"readme.js","sourceRoot":"","sources":["../src/readme.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"readme.js","sourceRoot":"","sources":["../src/readme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,MAAM,MAAM,QAAQ,CAAA;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EACL,OAAO,EACP,cAAc,EACd,UAAU,EACV,aAAa,GAEd,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAuBtC,MAAM,IAAI,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,WAAW,MAAM,MAAM,CAAA;AAChE,MAAM,KAAK,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,YAAY,MAAM,MAAM,CAAA;AAElE,MAAM,OAAO,GAAG,CAAC,IAAU,EAAoB,EAAE,CAAC;IAChD,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC;IAChC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC;CAC/B,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,MAAc,EACd,MAAc,EACd,IAAY;AACZ;;;;GAIG;AACH,KAAc,EACN,EAAE;IACV,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAoC,CAAA;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CACnC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CACjE,CAAA;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IAC1E,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;IAEzE,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;QAC/B,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QACzB,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAA;IACrE,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,EAAE,CAAA;IAE9D,6EAA6E;IAC7E,0DAA0D;IAC1D,MAAM,MAAM,GACV,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAA;IAEvD,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,KAAK,OAAO,MAAM,EAAE,CAAA;IAE3C,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9B,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAA;AAChE,CAAC,CAAA;AAqBD;;;;;GAKG;AACH,MAAM,WAAW,GAAG,CAAC,MAAc,EAAsB,EAAE;IACzD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7B,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IAClD,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;AACpC,CAAC,CAAA;AAED,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,IAAwB,EAAU,EAAE,CAC9D,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;AAEpC;;;;;;GAMG;AACH,MAAM,QAAQ,GAAG,CAAC,MAAqB,EAAU,EAAE;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAEvC,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,GAAG,SAAS,MAAM,CAAC,GAAG,EAAE,CAAC,CAAA;IAC3E,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,GAAG,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;IACjF,OAAO,MAAM,CAAC,GAAG;QACf,CAAC,CAAC,GAAG,MAAM,wBAAwB,MAAM,CAAC,GAAG,EAAE;QAC/C,CAAC,CAAC,GAAG,MAAM,aAAa,CAAA;AAC5B,CAAC,CAAA;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,IAAY,EAA4B,EAAE;IAC7E,MAAM,KAAK,GAAoB,EAAE,CAAA;IAEjC,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,CAAA;QAC9C,IAAI,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACpC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAA;AAC3E,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,KAAK,EACxB,SAAoB,EACgB,EAAE;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAClE,CAAA;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE,OAAO,SAAS,CAAA;QAE/C,sEAAsE;QACtE,oCAAoC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;QAElD,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;YAC9E,YAAY,EAAE,SAAS,CAAC,YAAY;YACpC,MAAM,EAAE,KAAK,CAAC,IAAI;YAClB,GAAG,EAAE,KAAK,CAAC,OAAO;YAClB,QAAQ,EAAE,KAAK,CAAC,KAAK;YACrB,GAAG,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC;YAC/B,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC;SACxF,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,OAAwB,EAAU,EAAE;IACxD,MAAM,IAAI,GAAG;QACX,yCAAyC;QACzC,2BAA2B;QAC3B,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACxB,sEAAsE;YACtE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;YACnD,uEAAuE;YACvE,mCAAmC;YACnC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;YAClE,sEAAsE;YACtE,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ;gBAC1B,CAAC,CAAC,eAAe,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE;gBAC1I,CAAC,CAAC,EAAE,CAAA;YACN,OAAO,KAAK,IAAI,GAAG,IAAI,GAAG,IAAI,MAAM,MAAM,CAAC,OAAO,MAAM,QAAQ,CAAC,MAAM,CAAC,QAAQ,MAAM,CAAC,YAAY,MAAM,CAAA;QAC3G,CAAC,CAAC;KACH,CAAA;IAED,+DAA+D;IAC/D,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,CACP,EAAE,EACF,yEAAyE,EACzE,kEAAkE,CACnE,CAAA;IACH,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,CAAC,MAAqB,EAAU,EAAE,CACpD,aAAa,MAAM,CAAC,OAAO,IAAI,CAAA;AAEjC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,OAAe,EAAU,EAAE;IACxE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACpC,wEAAwE;IACxE,4EAA4E;IAC5E,mEAAmE;IACnE,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;IAEvD,MAAM,KAAK,GAAG,CAAC,IAAiC,EAAU,EAAE,CAC1D,CAAC,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,GAAG,CAAA;IAE9C,MAAM,MAAM,GAAG,UAAU;QACvB,CAAC,CAAC;YACE,8EAA8E;YAC9E,WAAW,CAAC,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,IAAI,GAAG,2CAA2C;YAC1G,8EAA8E;YAC9E,wBAAwB;SACzB;QACH,CAAC,CAAC;YACE,6EAA6E;YAC7E,kDAAkD;YAClD,EAAE;YACF,+BAA+B;YAC/B,wBAAwB;YACxB,qCAAqC,KAAK,CAAC,OAAO,CAAC,yCAAyC;YAC5F,qCAAqC,KAAK,CAAC,OAAO,CAAC,WAAW,MAAM,EAAE,KAAK,IAAI,GAAG,IAAI,MAAM,EAAE,KAAK,IAAI,GAAG,WAAW,KAAK,CAAC,OAAO,CAAC,MAAM;YACzI,qCAAqC,KAAK,CAAC,OAAO,CAAC,WAAW,MAAM,EAAE,KAAK,IAAI,GAAG,IAAI,MAAM,EAAE,KAAK,IAAI,GAAG,WAAW,KAAK,CAAC,OAAO,CAAC,MAAM;YACzI,EAAE;YACF,6EAA6E;YAC7E,iFAAiF;YACjF,+EAA+E;YAC/E,uEAAuE;SACxE,CAAA;IAEL,MAAM,KAAK,GAAG,UAAU;QACtB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;YACE,EAAE;YACF,kCAAkC;YAClC,EAAE;YACF,oDAAoD,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO;YACnF,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,GAAG,qDAAqD;YACrH,iFAAiF;YACjF,kFAAkF;YAClF,+DAA+D;SAChE,CAAA;IAEL,OAAO;QACL,cAAc;QACd,EAAE;QACF,sCAAsC,OAAO,qCAAqC;QAClF,kEAAkE;QAClE,EAAE;QACF,iFAAiF;QACjF,4DAA4D;QAC5D,GAAG,MAAM;QACT,GAAG,KAAK;QACR,EAAE;QACF,kCAAkC,IAAI,0CAA0C;QAChF,0EAA0E;KAC3E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC,CAAA;AAcD,6DAA6D;AAC7D,MAAM,WAAW,GAAG,KAAK,EACvB,IAAY,EAC4C,EAAE;IAC1D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;QAC/E,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE,OAAO,SAAS,CAAA;QAC/C,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAA;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,QAAQ,GAAG,KAAK,EAAE,GAAW,EAAmB,EAAE;IACtD,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;SAC/C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SAC9C,IAAI,EAAE,CAAA;IAET,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,CAAA;AAChD,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,IAAY,EACZ,EAAE,KAAK,GAAG,KAAK,KAA0B,EAAE,EACpB,EAAE;IACzB,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAA;IAE1C,6EAA6E;IAC7E,yEAAyE;IACzE,mDAAmD;IACnD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAA;IAE7D,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;QAClC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,0EAA0E;gBACxE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,+CAA+C,CACtE,CAAA;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAMR,EAAE,CAAA;IAEP,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAA;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,8DAA8D;gBACnE,oBAAoB,CACvB,CAAA;QACH,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAA;QACjC,OAAO,CAAC,IAAI,CACV,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,EAClF;YACE,IAAI;YACJ,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC;YAC7C,OAAO,EAAE,GAAG,CAAC,IAAI;YACjB,KAAK,EAAE,SAAS;SACjB,CACF,CAAA;IACH,CAAC;SAAM,CAAC;QACN,MAAM,YAAY,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;QAC3C,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC;YAC1B,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC;YAC3B,OAAO,EAAE,YAAY,CAAC,IAAI;SAC3B,CAAC,CAAA;QAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAA;YACjE,OAAO,CAAC,IAAI,CACV,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,EAC5E;gBACE,IAAI;gBACJ,MAAM,EAAE,WAAW;gBACnB,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC;gBACnD,OAAO,EAAE,MAAM,CAAC,IAAI;gBACpB,KAAK,EAAE,SAAS;aACjB,CACF,CAAA;QACH,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,oEAAoE;IACpE,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAA;IAChD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;IACpE,CAAC;IAED,MAAM,OAAO,GAAmB,EAAE,CAAA;IAClC,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAEpE,wEAAwE;QACxE,yCAAyC;QACzC,IAAI,OAAO,GAAG,QAAQ,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA;QACpD,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,MAAM,EAAE,CAAC;YAC7C,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;QACvD,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,KAAK,QAAQ,CAAA;QACpC,IAAI,OAAO,IAAI,CAAC,KAAK;YAAE,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACrD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IACjC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AACnC,CAAC,CAAA"}

package/dist/release.d.ts

@@ -66,6 +66,30 @@ export declare const planPrerelease: (current: string, { bump, id }: {
  * release is no occasion to reformat it.
  */
 export declare const setVersion: (source: string, version: string) => string;
+export interface DistributionRelease {
+    name: string;
+    /** The version in the manifest before. */
+    from: string;
+    /** Whether that was published already. */
+    published: boolean;
+    /** The version the publish workflow releases next. */
+    version: string;
+}
+/**
+ * Set the version a distribution publishes next — see calver.ts for the shape.
+ *
+ * Run after publishing, it moves on; run again when the month has turned, it
+ * moves a release not yet published to this month's first. Nothing branches:
+ * a distribution has no lines of its own, only the modules it pins, and those
+ * are released on their own.
+ */
+export declare const releaseDistribution: (root: string, { dryRun, on, id, stable, published: lookup, }?: {
+    dryRun?: boolean;
+    on?: Date;
+    id?: string;
+    stable?: boolean;
+    published?: (spec: string) => string | undefined;
+}) => Promise<DistributionRelease>;
 /** Read the release the repository is standing on, without changing anything. */
 export declare const readRelease: (root: string, { bump, id }?: {
     bump?: Bump;

package/dist/release.d.ts.map

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