@fairgarden/distribution 0.1.0-alpha.1 → 0.1.0-alpha.3

package/dist/forks.js

@@ -0,0 +1,357 @@
+import { execFileSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import semver from 'semver';
+import { CHANGELOG, aheadEntry, bumpEntry, crossedReleases, moduleLabel, noteInDistribution, releaseNotesLinks, repositoryLink, shown, topVersion, } from "./changelog.js";
+import { existsSync } from 'node:fs';
+import { describeRemote, toHttps } from "./git-url.js";
+import { UPSTREAM, containsAll, ensureUpstreamRemote, gitmodulesSet, moveTo, setUrl, } from "./submodules.js";
+/**
+ * Forking a module, from inside a distribution.
+ *
+ * A fork is the module checked out from somewhere you can push to, with the
+ * repository it came from recorded beside it. You fix or add something there,
+ * offer it upstream as a pull request, and meanwhile ship it. Updating works
+ * as it does for any module, except that a fork takes upstream's releases by
+ * merging them in. Once upstream has everything the fork adds, you can go back
+ * to upstream, or keep the fork.
+ */
+/** Run git, throwing with what it said when it fails. */
+const run = (cwd, args) => {
+    try {
+        return execFileSync('git', args, {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch (cause) {
+        const stderr = cause instanceof Error && 'stderr' in cause ? String(cause.stderr).trim() : '';
+        throw new Error(`git ${args[0]} failed in ${cwd}${stderr ? `:\n${stderr}` : ''}`, { cause });
+    }
+};
+/** Run git, returning undefined rather than throwing when it fails. */
+const attempt = (cwd, args) => {
+    try {
+        return run(cwd, args);
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * The branch in a fork that holds everything this distribution pins, named
+ * after the distribution.
+ *
+ * Not the pull request's branch: GitHub deletes that once it is merged, and a
+ * pinned commit has to stay fetchable for as long as anything pins it. Not the
+ * fork's main either, which is upstream's to follow.
+ */
+export const distributionBranch = (root) => {
+    let name;
+    try {
+        name = JSON.parse(readFileSync(path.join(root, 'package.json'), 'utf8')).name;
+    }
+    catch {
+        name = undefined;
+    }
+    return (typeof name === 'string' ? name : path.basename(root))
+        .replace(/^@/, '')
+        .replace(/[^A-Za-z0-9._-]+/g, '-');
+};
+/**
+ * Put the checked-out commit on the fork's distribution branch, which only
+ * moves forward. `to` is the fork's url, or `origin` once it is the fork.
+ */
+const pushPinned = (submodule, branch, to = 'origin') => {
+    try {
+        run(submodule.path, ['push', '--quiet', to, `HEAD:refs/heads/${branch}`]);
+    }
+    catch (cause) {
+        const fork = to === 'origin' ? submodule.url : to;
+        throw new Error(`${branch} on ${describeRemote(fork)} has commits that ${submodule.relativePath} does not. ` +
+            `Merge them in first, then run this again:\n` +
+            `    cd ${submodule.relativePath} && git fetch ${fork} ${branch} && git merge FETCH_HEAD`, { cause });
+    }
+};
+/** `https://github.com/acme/id.git` -> `acme/id`; undefined anywhere else. */
+export const githubRepo = (url) => /^https:\/\/github\.com\/([^/]+\/[^/]+?)(?:\.git)?\/?$/i.exec(toHttps(url))?.[1];
+/** The branch a remote's HEAD names, which is where pull requests go. */
+const defaultBranch = (cwd, remote) => {
+    const read = () => attempt(cwd, ['symbolic-ref', '--short', `refs/remotes/${remote}/HEAD`])?.replace(`${remote}/`, '');
+    const known = read();
+    if (known)
+        return known;
+    attempt(cwd, ['remote', 'set-head', remote, '--auto']);
+    return read() ?? 'main';
+};
+/**
+ * Check a module out from a fork, keeping where it came from.
+ *
+ * The fork has to exist already — on GitHub, the Fork button — since creating
+ * repositories is not something to do behind anyone's back. Forking a fork
+ * keeps the original upstream.
+ */
+export const forkModule = (root, submodule, url, { ssh = false, push = true } = {}) => {
+    const fork = ssh ? url : toHttps(url);
+    const upstream = submodule.upstream ?? submodule.url;
+    if (fork === submodule.url) {
+        throw new Error(`${submodule.relativePath} is already checked out from ${fork}.`);
+    }
+    if (fork === upstream) {
+        throw new Error(`${fork} is where ${submodule.relativePath} was forked from. ` +
+            `Run \`fg-dist unfork ${submodule.name}\` to go back to it.`);
+    }
+    // Before anything is written: a fork nobody can read is a pin nobody can fetch.
+    if (attempt(submodule.path, ['ls-remote', '--heads', fork]) === undefined) {
+        throw new Error(`Could not read ${fork}. Fork ${describeRemote(upstream)} there first, then run this again.`);
+    }
+    // Pushed before anything is recorded, so a refusal leaves the module as it was.
+    const branch = distributionBranch(root);
+    if (push)
+        pushPinned(submodule, branch, fork);
+    gitmodulesSet(root, submodule.configName, 'upstream', upstream);
+    setUrl(root, submodule, fork);
+    run(submodule.path, ['remote', 'set-url', 'origin', fork]);
+    ensureUpstreamRemote(submodule.path, upstream);
+    attempt(submodule.path, ['fetch', '--quiet', 'origin']);
+    attempt(submodule.path, ['fetch', '--quiet', '--tags', UPSTREAM]);
+    const { name } = moduleLabel(submodule.path);
+    noteInDistribution(root, `\`${name}\` forked to ${repositoryLink(fork)}, from ${repositoryLink(upstream)}`);
+    return { url: fork, upstream, rewritten: fork !== url, branch: push ? branch : undefined };
+};
+/** A pull request's title, as GitHub has it. */
+const pullRequestTitle = (cwd, url) => {
+    try {
+        return (execFileSync('gh', ['pr', 'view', url, '--json', 'title', '--jq', '.title'], {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim() || undefined);
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * The changelog line a pull request still needs, with its link: only the
+ * words are left, which are the author's to write. Undefined for a module
+ * without a changelog, or one that links the pull request already.
+ */
+const changelogLine = (submodule, pullRequest) => {
+    const file = path.join(submodule.path, CHANGELOG);
+    if (!existsSync(file))
+        return undefined;
+    const text = readFileSync(file, 'utf8');
+    if (text.toLowerCase().includes(pullRequest.replace(/^https?:\/\//, '').toLowerCase()))
+        return undefined;
+    const version = topVersion(text);
+    const number = /\/pull\/(\d+)/.exec(pullRequest)?.[1];
+    if (!version || !number)
+        return undefined;
+    return {
+        file: path.join(submodule.relativePath, CHANGELOG),
+        version,
+        line: `- What this changes, for someone using it ([#${number}](${pullRequest}))`,
+    };
+};
+/**
+ * Offer what is on the checkout's branch upstream, as a pull request.
+ *
+ * For a fork the branch goes to the fork and the pull request to upstream; for
+ * a module you can push to, both go to its own repository. A fork also moves
+ * its distribution branch up to the commit, since that is what is pinned and
+ * the pull request's branch is gone once merged.
+ */
+export const contribute = (root, submodule, { push = true, base } = {}) => {
+    const cwd = submodule.path;
+    const branch = attempt(cwd, ['symbolic-ref', '--short', '-q', 'HEAD']);
+    if (!branch) {
+        throw new Error(`${submodule.relativePath} is not on a branch. Start one for the change:\n` +
+            `    cd ${submodule.relativePath} && git switch -c <name>`);
+    }
+    if ((attempt(cwd, ['status', '--porcelain']) ?? '') !== '') {
+        throw new Error(`${submodule.relativePath} has uncommitted changes. Commit them first.`);
+    }
+    const fork = submodule.upstream;
+    const remote = fork ? UPSTREAM : 'origin';
+    const repository = fork ?? submodule.url;
+    if (fork) {
+        ensureUpstreamRemote(cwd, fork);
+        attempt(cwd, ['fetch', '--quiet', UPSTREAM]);
+    }
+    const into = base ?? defaultBranch(cwd, remote);
+    if (!fork && branch === into) {
+        throw new Error(`${submodule.relativePath} is on ${into} itself. A pull request needs a branch of its own:\n` +
+            `    cd ${submodule.relativePath} && git switch -c <name>`);
+    }
+    const upstreamRepo = githubRepo(repository);
+    const ownRepo = githubRepo(submodule.url);
+    const head = fork && ownRepo ? `${ownRepo.split('/')[0]}:${branch}` : branch;
+    const compare = upstreamRepo
+        ? `https://github.com/${upstreamRepo}/compare/${into}...${head}?expand=1`
+        : undefined;
+    if (!push) {
+        return { branch, repository, base: into, pullRequest: undefined, compare, pinnedOn: undefined };
+    }
+    run(cwd, ['push', '--quiet', '-u', 'origin', branch]);
+    const pinnedOn = fork ? distributionBranch(root) : undefined;
+    if (pinnedOn)
+        pushPinned(submodule, pinnedOn);
+    let pullRequest;
+    if (upstreamRepo) {
+        try {
+            const output = execFileSync('gh', ['pr', 'create', '--repo', upstreamRepo, '--base', into, '--head', head, '--fill'], { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+            pullRequest = /https:\/\/\S+/.exec(output)?.[0];
+        }
+        catch {
+            // No gh, not signed in, or one already open: the compare link does the rest.
+            pullRequest = undefined;
+        }
+    }
+    // What the change is, in the distribution's changelog: the pull request's
+    // title, or without one, what its last commit says. Never the branch's name,
+    // which means nothing to anyone reading it.
+    const title = (pullRequest && pullRequestTitle(cwd, pullRequest)) ||
+        attempt(cwd, ['log', '-1', '--format=%s']) ||
+        branch;
+    // Linked where it can be read about: its pull request, or else its commit.
+    const { name } = moduleLabel(cwd);
+    const number = pullRequest && /\/pull\/(\d+)/.exec(pullRequest)?.[1];
+    const tip = attempt(cwd, ['rev-parse', 'HEAD']);
+    const link = pullRequest && upstreamRepo && number
+        ? { text: `${upstreamRepo}#${number}`, url: pullRequest }
+        : ownRepo && tip
+            ? { text: `${ownRepo}@${tip.slice(0, 7)}`, url: `https://github.com/${ownRepo}/commit/${tip}` }
+            : undefined;
+    noteInDistribution(root, aheadEntry(name, title, link));
+    // The module's own line is written by whoever made the change, and reviewed
+    // with it; only its link is known here.
+    const changelog = pullRequest ? changelogLine(submodule, pullRequest) : undefined;
+    return { branch, repository, base: into, pullRequest, compare, pinnedOn, changelog };
+};
+/**
+ * Take an upstream release into a fork: what `bump` does for one.
+ *
+ * When the release already has everything the fork adds, the fork is simply
+ * moved to it — upstream has taken the work, and the fork could be dropped.
+ * Otherwise the release is merged into the fork, keeping the fork's changes on
+ * top, and pushed to the distribution branch. A merge rather than a rebase, so
+ * every commit an older distribution pinned stays in the fork.
+ */
+export const integrate = (root, state, tag, { push = true } = {}) => {
+    const { submodule } = state;
+    const cwd = submodule.path;
+    const upstream = submodule.upstream ?? submodule.url;
+    const { name } = moduleLabel(cwd);
+    const from = state.current ?? state.head.slice(0, 7);
+    const releases = crossedReleases(state.available, tag);
+    if (containsAll(cwd, `refs/tags/${tag}`, state.head)) {
+        moveTo(submodule, tag);
+        // The fork may not have the release yet, and it is what is pinned now.
+        if (push)
+            run(cwd, ['push', '--quiet', 'origin', `refs/tags/${tag}`]);
+        noteInDistribution(root, bumpEntry(name, from, tag, upstream, releases, 'which has everything the fork added'));
+        return { how: 'moved', pushed: push ? tag : undefined };
+    }
+    try {
+        run(cwd, [
+            'merge',
+            '--no-edit',
+            '--quiet',
+            '-m',
+            `Merge ${tag} from ${describeRemote(upstream)}`,
+            `refs/tags/${tag}`,
+        ]);
+    }
+    catch (cause) {
+        attempt(cwd, ['merge', '--abort']);
+        throw new Error(`${tag} does not merge cleanly into ${submodule.relativePath}. Merge it by hand, ` +
+            `then push, and commit the new pin:\n    cd ${submodule.relativePath} && git merge ${tag}`, { cause });
+    }
+    const branch = distributionBranch(root);
+    if (push)
+        pushPinned(submodule, branch);
+    noteInDistribution(root, bumpEntry(name, from, tag, upstream, releases, 'merged into the fork'));
+    return { how: 'merged', pushed: push ? branch : undefined };
+};
+/** Commits the fork has that `base` does not, for saying what would be lost. */
+const notIn = (cwd, base) => (attempt(cwd, [
+    'log',
+    '--no-merges',
+    '--cherry-pick',
+    '--right-only',
+    '--format=%h %s',
+    `${base}...HEAD`,
+]) ?? '')
+    .split('\n')
+    .filter(Boolean);
+/**
+ * Check a forked module out from its upstream again.
+ *
+ * Only to something that has everything the fork adds, unless forced: going
+ * back means the fork's commits stop shipping, and that should be because
+ * upstream has them, not by accident. Without `to`, the oldest upstream release
+ * from the pinned version on that has them is chosen — going back to upstream
+ * is not the moment to upgrade as well.
+ */
+export const unforkModule = (root, state, { to, major = false, force = false } = {}) => {
+    const { submodule } = state;
+    const cwd = submodule.path;
+    const upstream = submodule.upstream;
+    if (!upstream) {
+        throw new Error(`${submodule.relativePath} is not a fork; it is checked out from ${submodule.url}.`);
+    }
+    if (state.dirty) {
+        throw new Error(`${submodule.relativePath} has uncommitted changes. Commit or drop them first.`);
+    }
+    let target;
+    let label;
+    if (to) {
+        const ref = [`refs/tags/${to}`, `${UPSTREAM}/${to}`, to].find((candidate) => attempt(cwd, ['rev-parse', '--verify', '--quiet', `${candidate}^{commit}`]) !== undefined);
+        if (!ref)
+            throw new Error(`${to} is not a tag, upstream branch or commit in ${submodule.relativePath}.`);
+        const lost = containsAll(cwd, ref, state.head) ? [] : notIn(cwd, ref);
+        if (lost.length > 0 && !force) {
+            throw new Error(`${to} does not have everything the fork adds:\n${lost.map((line) => `  ${line}`).join('\n')}\n` +
+                'Pass --force to go back anyway and stop shipping them.');
+        }
+        target = ref;
+        label = to;
+    }
+    else {
+        const merged = state.fork?.merged;
+        if (!merged) {
+            const tip = `${UPSTREAM}/HEAD`;
+            const lost = notIn(cwd, attempt(cwd, ['rev-parse', '--verify', '--quiet', tip]) ? tip : 'HEAD');
+            throw new Error(`Upstream has not taken everything ${submodule.relativePath} adds yet:\n` +
+                `${lost.map((line) => `  ${line}`).join('\n')}\n` +
+                'Keep the fork until it has, or pass --to <tag> --force to go back without them.');
+        }
+        if (!semver.valid(merged)) {
+            throw new Error(`Only ${merged} has everything ${submodule.relativePath} adds, and it is not a release yet. ` +
+                `Wait for one, or pass --to ${merged.replace(`${UPSTREAM}/`, '')} to go back to the branch.`);
+        }
+        if (!major && state.current && semver.major(merged) !== semver.major(state.current)) {
+            throw new Error(`The first release with everything ${submodule.relativePath} adds is ${merged}, a major ` +
+                'upgrade. Pass --major to go back to it.');
+        }
+        target = `refs/tags/${merged}`;
+        label = merged;
+    }
+    const lost = containsAll(cwd, target, state.head) ? [] : notIn(cwd, target);
+    run(cwd, ['checkout', '--quiet', `${target}^{commit}`]);
+    setUrl(root, submodule, upstream);
+    run(cwd, ['remote', 'set-url', 'origin', upstream]);
+    gitmodulesSet(root, submodule.configName, 'upstream', undefined);
+    attempt(cwd, ['remote', 'remove', UPSTREAM]);
+    const { name } = moduleLabel(cwd);
+    const notes = semver.valid(label) ? releaseNotesLinks(upstream, crossedReleases(state.available, label)) : '';
+    noteInDistribution(root, `\`${name}\` back to ${repositoryLink(upstream)} at ${shown(label)}, ` +
+        (lost.length > 0
+            ? `leaving behind ${lost.length} commit${lost.length === 1 ? '' : 's'} of the fork's that upstream does not have`
+            : 'which has everything the fork added') +
+        notes);
+    return { url: upstream, to: label };
+};
+//# sourceMappingURL=forks.js.map

package/dist/forks.js.map

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

package/dist/index.d.ts

@@ -11,4 +11,11 @@ export { assertExtends, describeViolations, findFloorViolations, inspectExtends,
 export type { Distribution, ExtendsReport, FloorViolation } from './extends.ts';
 export { buildPolicy, findPolicy, setupTurbo, testPolicy, turboTasks, usePolicy } from './policy.ts';
 export type { DistributionPolicy } from './policy.ts';
+export { contribute, distributionBranch, forkModule, integrate, unforkModule } from './forks.ts';
+export type { ContributeResult, ForkResult, Integration, UnforkResult } from './forks.ts';
+export type { ForkState } from './submodules.ts';
+export { readPublishedModules, shippedModules, stampModules } from './manifest.ts';
+export type { PublishedModule, PublishedModules } from './manifest.ts';
+export { inherit } from './inherit.ts';
+export type { Inheritance, InheritedModule } from './inherit.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,OAAO,EACP,eAAe,EACf,KAAK,GACN,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AACtE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAExE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAC5D,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE7D,OAAO,EACL,OAAO,EACP,QAAQ,EACR,MAAM,EACN,cAAc,EACd,MAAM,EACN,UAAU,EACV,MAAM,GACP,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAE7E,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,UAAU,GACX,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE/E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACpG,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,OAAO,EACP,eAAe,EACf,KAAK,GACN,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AACtE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAExE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAC5D,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE7D,OAAO,EACL,OAAO,EACP,QAAQ,EACR,MAAM,EACN,cAAc,EACd,MAAM,EACN,UAAU,EACV,MAAM,GACP,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAE7E,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,UAAU,GACX,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE/E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACpG,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAChG,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzF,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAClF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEtE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -5,4 +5,7 @@ export { describeRemote, isSsh, toHttps } from "./git-url.js";
 export { inspect, isPublic, moveTo, repositoryRoot, setUrl, submodules, target, } from "./submodules.js";
 export { assertExtends, describeViolations, findFloorViolations, inspectExtends, readDistribution, readParent, } from "./extends.js";
 export { buildPolicy, findPolicy, setupTurbo, testPolicy, turboTasks, usePolicy } from "./policy.js";
+export { contribute, distributionBranch, forkModule, integrate, unforkModule } from "./forks.js";
+export { readPublishedModules, shippedModules, stampModules } from "./manifest.js";
+export { inherit } from "./inherit.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,OAAO,EACP,eAAe,EACf,KAAK,GACN,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAGtE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAG5D,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE7D,OAAO,EACL,OAAO,EACP,QAAQ,EACR,MAAM,EACN,cAAc,EACd,MAAM,EACN,UAAU,EACV,MAAM,GACP,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,UAAU,GACX,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,OAAO,EACP,eAAe,EACf,KAAK,GACN,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAGtE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAG5D,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE7D,OAAO,EACL,OAAO,EACP,QAAQ,EACR,MAAM,EACN,cAAc,EACd,MAAM,EACN,UAAU,EACV,MAAM,GACP,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,UAAU,GACX,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAGpG,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAIhG,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAGlF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/dist/inherit.d.ts

@@ -0,0 +1,18 @@
+import { type PublishedModule } from './manifest.ts';
+export interface InheritedModule extends PublishedModule {
+    name: string;
+}
+export interface Inheritance {
+    parent: string;
+    parentVersion: string;
+    /** Added, or with a dry run, what would be. */
+    added: InheritedModule[];
+    /** Shipped already, at whatever version: `check` and `bump` see to that. */
+    shipped: string[];
+    /** Something is already where the parent has the module. */
+    blocked: InheritedModule[];
+}
+export declare const inherit: (root: string, { dryRun }?: {
+    dryRun?: boolean;
+}) => Promise<Inheritance>;
+//# sourceMappingURL=inherit.d.ts.map

package/dist/inherit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inherit.d.ts","sourceRoot":"","sources":["../src/inherit.ts"],"names":[],"mappings":"AAMA,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AAsB1E,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,+CAA+C;IAC/C,KAAK,EAAE,eAAe,EAAE,CAAA;IACxB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,4DAA4D;IAC5D,OAAO,EAAE,eAAe,EAAE,CAAA;CAC3B;AAED,eAAO,MAAM,OAAO,GAClB,MAAM,MAAM,EACZ,aAAoB;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,KAC5C,OAAO,CAAC,WAAW,CAqErB,CAAA"}

package/dist/inherit.js

@@ -0,0 +1,84 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { addModule } from "./add-module.js";
+import { readDistribution } from "./extends.js";
+import { readPublishedModules } from "./manifest.js";
+import { noteInDistribution, repositoryLink } from "./changelog.js";
+import { ensureUpstreamRemote, gitmodulesSet, submodules } from "./submodules.js";
+/**
+ * Ship what the distribution this extends ships.
+ *
+ * An extension starts from its parent: every module the parent's published
+ * manifest records, added where the parent has it, from the repository the
+ * parent clones it from, at the commit the parent pins. A module the parent
+ * ships as a fork comes as the same fork. After that it is the extension's —
+ * bumped, forked or moved ahead as it likes, never behind.
+ */
+const git = (cwd, args) => {
+    try {
+        return execFileSync('git', args, { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+    }
+    catch {
+        return undefined;
+    }
+};
+export const inherit = async (root, { dryRun = false } = {}) => {
+    const own = readDistribution(root);
+    if (!own.extends)
+        throw new Error(`${own.name} extends nothing, so there is nothing to inherit.`);
+    let manifest;
+    try {
+        const file = createRequire(path.join(root, 'package.json')).resolve(`${own.extends}/package.json`);
+        manifest = JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch {
+        throw new Error(`${own.extends} is not installed, so there is nothing to read. Run pnpm install first.`);
+    }
+    const published = readPublishedModules(manifest);
+    if (!published) {
+        throw new Error(`${own.extends}@${manifest.version} does not record where its modules live. ` +
+            'Publish it again with this version of fg-dist, or add them with `fg-dist add-module <url>`.');
+    }
+    const inheritance = {
+        parent: own.extends,
+        parentVersion: manifest.version ?? '',
+        added: [],
+        shipped: [],
+        blocked: [],
+    };
+    for (const [name, module] of Object.entries(published)) {
+        if (own.modules[name] !== undefined) {
+            inheritance.shipped.push(name);
+            continue;
+        }
+        const target = path.join(root, module.path);
+        if (existsSync(target) && readdirSync(target).length > 0) {
+            inheritance.blocked.push({ name, ...module });
+            continue;
+        }
+        inheritance.added.push({ name, ...module });
+        if (dryRun)
+            continue;
+        await addModule(root, module.repository, { at: module.path, changelog: false });
+        // What the parent pins, which may be past the release its version names.
+        if (git(target, ['checkout', '--quiet', module.commit]) === undefined) {
+            git(target, ['fetch', '--quiet', 'origin', module.commit]);
+            if (git(target, ['checkout', '--quiet', module.commit]) === undefined) {
+                throw new Error(`${module.repository} does not have ${module.commit}, which ${own.extends} ships as ${name}.`);
+            }
+        }
+        if (module.upstream) {
+            const added = submodules(root).find((submodule) => submodule.relativePath === module.path);
+            if (added) {
+                gitmodulesSet(root, added.configName, 'upstream', module.upstream);
+                ensureUpstreamRemote(target, module.upstream);
+            }
+        }
+        noteInDistribution(root, `\`${name}\` ${module.version} added, as ${own.extends} ships it, from ${repositoryLink(module.repository)}` +
+            (module.upstream ? `, a fork of ${repositoryLink(module.upstream)}` : ''));
+    }
+    return inheritance;
+};
+//# sourceMappingURL=inherit.js.map

package/dist/inherit.js.map

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

package/dist/manifest.d.ts

@@ -0,0 +1,43 @@
+/**
+ * What a published distribution says it ships.
+ *
+ * In the repository the submodules are the record, and nothing restates them.
+ * A published distribution has no submodules, so its manifest carries them —
+ * written into `distribution.modules` as it is published, never committed.
+ * That is what an extension is checked against, and what it takes its own
+ * modules from.
+ */
+export interface PublishedModule {
+    version: string;
+    /** Where it sits in the distribution, which an extension puts it at too. */
+    path: string;
+    /** What it is cloned from: the fork, for a module the distribution forked. */
+    repository: string;
+    /** Where a fork was forked from. */
+    upstream?: string;
+    /** The commit shipped, which may be ahead of the version's release. */
+    commit: string;
+}
+export type PublishedModules = Record<string, PublishedModule>;
+/** What this distribution ships, read from its checkouts. */
+export declare const shippedModules: (root: string) => PublishedModules;
+/**
+ * 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 declare const stampModules: (root: string, fields?: {
+    version?: string;
+    gitSha?: string;
+}) => Promise<PublishedModules>;
+/**
+ * The modules a published distribution records, with where each lives, or
+ * undefined when it records none: published before this was written down.
+ */
+export declare const readPublishedModules: (manifest: {
+    distribution?: {
+        modules?: unknown;
+    };
+}) => PublishedModules | undefined;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAA;IACZ,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAA;IAClB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;AAE9D,6DAA6D;AAC7D,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,gBA2B7C,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,MAAM,EACZ,SAAQ;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,KACjD,OAAO,CAAC,gBAAgB,CAiB1B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU;IAC7C,YAAY,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CACrC,KAAG,gBAAgB,GAAG,SAWtB,CAAA"}