@wpelevator/wp-release 0.14.0 → 0.16.0

package/dist/commands/changeset-project-args.js

@@ -0,0 +1,114 @@
+import { packageJsonVersion, composerJsonVersion, wordpressPluginVersion, wordpressThemeVersion, wordpressStableTag, phpConstantVersion, gitTagVersion, } from "../changeset-config.js";
+import { ValidationError } from "../errors.js";
+import { getBoolean, getString, getStrings } from "./command.js";
+export const changesetProjectArgs = {
+    'version-package-json': { type: 'string', multiple: true },
+    'version-composer-json': { type: 'string', multiple: true },
+    'version-wordpress-plugin': { type: 'string', multiple: true },
+    'version-wordpress-theme': { type: 'string', multiple: true },
+    'version-wordpress-stable-tag': { type: 'string', multiple: true },
+    'version-php-constant': { type: 'string', multiple: true },
+    'version-git-tag': { type: 'string', multiple: true },
+    'version-from': { type: 'string' },
+    'base-branch': { type: 'string' },
+    remote: { type: 'string' },
+    'changesets-dir': { type: 'string' },
+    'readme-changelog': { type: 'boolean' },
+    'no-readme-changelog': { type: 'boolean' },
+    'changelog-insert-after': { type: 'string' },
+};
+export const changesetProjectHelp = `
+Single-project options (without a release config file):
+  --version-package-json <file>             npm version source/target (repeatable)
+  --version-composer-json <file>            Composer source/target (repeatable)
+  --version-wordpress-plugin <file>         Plugin header source/target (repeatable)
+  --version-wordpress-theme <file>          Theme header source/target (repeatable)
+  --version-wordpress-stable-tag <file>     Readme Stable tag source/target (repeatable)
+  --version-php-constant <file>#<constant>  PHP constant source/target (repeatable)
+  --version-git-tag <pattern>               Git tag source only; use {version}
+  --version-from <kind>[:<file>]            Choose the source; constants use file#constant
+  --base-branch <branch>                   Default comparison branch on the remote
+  --remote <name>                          Git remote (default: origin)
+  --changesets-dir <dir>                   Changeset directory (default: .changeset)
+  --readme-changelog / --no-readme-changelog
+                                          Enable/disable readme changelog updates
+  --changelog-insert-after <marker>        Insert changelog entries after this marker
+
+Explicit descriptors define all version targets. Without them, detect one root
+project. A unique non-Stable-tag descriptor is the inferred source; otherwise
+pass --version-from, qualifying it with :file when its kind is repeated.
+Use the same project options for every changeset command.`;
+/**
+ * Parse shared single-project settings; operation flags stay command-specific.
+ *
+ * @param values Parsed command arguments.
+ * @return Fallback settings when explicitly supplied.
+ */
+export function parseChangesetProjectArgs(values) {
+    const options = {};
+    const versions = [];
+    const factories = {
+        'package-json': packageJsonVersion,
+        'composer-json': composerJsonVersion,
+        'wordpress-plugin': wordpressPluginVersion,
+        'wordpress-theme': wordpressThemeVersion,
+        'wordpress-stable-tag': wordpressStableTag,
+    };
+    for (const [kind, factory] of Object.entries(factories)) {
+        for (const file of getStrings(values, `version-${kind}`)) {
+            if (!file.trim()) {
+                throw new ValidationError(`--version-${kind} <file> must not be empty.`);
+            }
+            versions.push(factory({ file }));
+        }
+    }
+    for (const value of getStrings(values, 'version-php-constant')) {
+        const separator = value.lastIndexOf('#');
+        const file = value.slice(0, separator);
+        const constant = value.slice(separator + 1);
+        if (separator < 1 ||
+            !file.trim() ||
+            !/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(constant)) {
+            throw new ValidationError('--version-php-constant must be <file>#<constant>, for example plugin.php#PLUGIN_VERSION.');
+        }
+        versions.push(phpConstantVersion({ file, constant }));
+    }
+    const patterns = getStrings(values, 'version-git-tag');
+    if (patterns.length > 1) {
+        throw new ValidationError('--version-git-tag accepts one source pattern.');
+    }
+    for (const pattern of patterns) {
+        if (!pattern.trim() || !pattern.includes('{version}')) {
+            throw new ValidationError('--version-git-tag <pattern> must contain {version}.');
+        }
+        versions.push(gitTagVersion({ pattern }));
+    }
+    if (versions.length) {
+        options.versions = versions;
+    }
+    const strings = {
+        'version-from': 'versionFrom',
+        'base-branch': 'baseBranch',
+        remote: 'remote',
+        'changesets-dir': 'changesets',
+        'changelog-insert-after': 'changelogInsertAfter',
+    };
+    for (const [flag, key] of Object.entries(strings)) {
+        const value = getString(values, flag);
+        if (undefined !== value) {
+            if (!value.trim()) {
+                throw new ValidationError(`--${flag} must not be empty.`);
+            }
+            options[key] = value;
+        }
+    }
+    if (getBoolean(values, 'readme-changelog') &&
+        getBoolean(values, 'no-readme-changelog')) {
+        throw new ValidationError('--readme-changelog cannot be combined with --no-readme-changelog.');
+    }
+    if (getBoolean(values, 'readme-changelog') ||
+        getBoolean(values, 'no-readme-changelog')) {
+        options.readmeChangelog = getBoolean(values, 'readme-changelog');
+    }
+    return Object.keys(options).length ? { singleProject: options } : {};
+}

package/dist/commands/changeset-status.d.ts

@@ -22,7 +22,56 @@ declare const _default: {
     summary: string;
     help: string;
     options: {
-        readonly since: {
+        'version-package-json': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-composer-json': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-wordpress-plugin': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-wordpress-theme': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-wordpress-stable-tag': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-php-constant': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-git-tag': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-from': {
+            readonly type: "string";
+        };
+        'base-branch': {
+            readonly type: "string";
+        };
+        remote: {
+            readonly type: "string";
+        };
+        'changesets-dir': {
+            readonly type: "string";
+        };
+        'readme-changelog': {
+            readonly type: "boolean";
+        };
+        'no-readme-changelog': {
+            readonly type: "boolean";
+        };
+        'changelog-insert-after': {
+            readonly type: "string";
+        };
+        since: {
             readonly type: "string";
         };
     };

package/dist/commands/changeset-status.js

@@ -1,3 +1,4 @@
+import { changesetProjectArgs, changesetProjectHelp, parseChangesetProjectArgs, } from "./changeset-project-args.js";
 import { getChangesetStatus } from "../changeset-release.js";
 import { changesetStatusArgs, parseChangesetStatusArgs, } from "./changeset-args.js";
 export default {
@@ -8,12 +9,13 @@ export default {
   --since <ref>          Compare changed files with this git ref (for CI)
 
 Exit status is 2 when a changed package has no changeset added since the comparison base.
-An empty changeset added since the comparison base counts as an explicit no-release decision.`,
-    options: changesetStatusArgs,
+An empty changeset added since the comparison base counts as an explicit no-release decision.${changesetProjectHelp}`,
+    options: { ...changesetStatusArgs, ...changesetProjectArgs },
     async run({ values, cwd, configFile, tagFormat, logger }) {
         const { since } = parseChangesetStatusArgs(values);
         const result = await getChangesetStatus({
             cwd,
+            ...parseChangesetProjectArgs(values),
             ...(configFile ? { configFile } : {}),
             ...(tagFormat ? { tagFormat } : {}),
             ...(since ? { since } : {}),

package/dist/commands/changeset-tag.d.ts

@@ -4,23 +4,72 @@ declare const _default: {
     summary: string;
     help: string;
     options: {
-        readonly push: {
+        'version-package-json': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-composer-json': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-wordpress-plugin': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-wordpress-theme': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-wordpress-stable-tag': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-php-constant': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-git-tag': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-from': {
+            readonly type: "string";
+        };
+        'base-branch': {
+            readonly type: "string";
+        };
+        remote: {
+            readonly type: "string";
+        };
+        'changesets-dir': {
+            readonly type: "string";
+        };
+        'readme-changelog': {
+            readonly type: "boolean";
+        };
+        'no-readme-changelog': {
+            readonly type: "boolean";
+        };
+        'changelog-insert-after': {
+            readonly type: "string";
+        };
+        push: {
             readonly type: "boolean";
         };
-        readonly 'dry-run': {
+        'dry-run': {
             readonly type: "boolean";
         };
-        readonly untagged: {
+        untagged: {
             readonly type: "boolean";
         };
-        readonly since: {
+        since: {
             readonly type: "string";
         };
-        readonly package: {
+        package: {
             readonly type: "string";
             readonly multiple: true;
         };
-        readonly version: {
+        version: {
             readonly type: "string";
         };
     };

package/dist/commands/changeset-tag.js

@@ -1,3 +1,4 @@
+import { changesetProjectArgs, changesetProjectHelp, parseChangesetProjectArgs, } from "./changeset-project-args.js";
 import { tagChangesets } from "../changeset-release.js";
 import { parseChangesetTagArgs, changesetTagArgs } from "./changeset-args.js";
 import { getChangesetTagSummary, getTagStatus } from "../summary.js";
@@ -12,8 +13,9 @@ export default {
   --since <ref>          Tag packages changed since this git ref
   --package <name>       Tag only this package, by identifier or path under
                          the configured root (repeatable)
-  --version <version>    Fail unless the single --package is at this version;
-                         the version to tag for packages versioned by git tags
+  --version <version>    Fail unless the selected package is at this version;
+                         the version to tag for packages versioned by git tags.
+                         A sole root package is selected without --package
   --push                 Push newly created tags to the configured remote
                          (default: origin), one at a time
 
@@ -22,12 +24,13 @@ safe. Before a tag is created, every configured version target must match the
 version. With --json or --github-output, each tag comes with the title, notes
 and pre-release flag of its release, for a workflow step that creates the
 GitHub Release. --untagged lists only the releases that still need a tag, for
-example to release each of them with a separate workflow.`,
-    options: changesetTagArgs,
+example to release each of them with a separate workflow.${changesetProjectHelp}`,
+    options: { ...changesetTagArgs, ...changesetProjectArgs },
     async run({ values, cwd, configFile, tagFormat, logger }) {
         const args = parseChangesetTagArgs(values);
         const result = await tagChangesets({
             cwd,
+            ...parseChangesetProjectArgs(values),
             ...(configFile ? { configFile } : {}),
             ...(tagFormat ? { tagFormat } : {}),
             ...args,

package/dist/commands/changeset-version.d.ts

@@ -16,23 +16,72 @@ declare const _default: {
     summary: string;
     help: string;
     options: {
-        readonly 'dry-run': {
+        'version-package-json': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-composer-json': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-wordpress-plugin': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-wordpress-theme': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-wordpress-stable-tag': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-php-constant': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-git-tag': {
+            readonly type: "string";
+            readonly multiple: true;
+        };
+        'version-from': {
+            readonly type: "string";
+        };
+        'base-branch': {
+            readonly type: "string";
+        };
+        remote: {
+            readonly type: "string";
+        };
+        'changesets-dir': {
+            readonly type: "string";
+        };
+        'readme-changelog': {
+            readonly type: "boolean";
+        };
+        'no-readme-changelog': {
+            readonly type: "boolean";
+        };
+        'changelog-insert-after': {
+            readonly type: "string";
+        };
+        'dry-run': {
             readonly type: "boolean";
         };
-        readonly date: {
+        date: {
             readonly type: "string";
         };
-        readonly package: {
+        package: {
             readonly type: "string";
             readonly multiple: true;
         };
-        readonly 'no-dependents': {
+        'no-dependents': {
             readonly type: "boolean";
         };
-        readonly prerelease: {
+        prerelease: {
             readonly type: "string";
         };
-        readonly snapshot: {
+        snapshot: {
             readonly type: "string";
         };
     };

package/dist/commands/changeset-version.js

@@ -1,3 +1,4 @@
+import { changesetProjectArgs, changesetProjectHelp, parseChangesetProjectArgs, } from "./changeset-project-args.js";
 import { versionChangesets } from "../changeset-release.js";
 import { getChangesetVersionSummary } from "../summary.js";
 import { parseChangesetVersionArgs, changesetVersionArgs, } from "./changeset-args.js";
@@ -26,12 +27,13 @@ since the pre-release consumes the changesets that the stable release needs.
 The readme Stable tag keeps the last stable version.
 
 With --snapshot, build and publish the versioned files without committing
-them, for example to test a pull request.`,
-    options: changesetVersionArgs,
+them, for example to test a pull request.${changesetProjectHelp}`,
+    options: { ...changesetVersionArgs, ...changesetProjectArgs },
     async run({ values, cwd, configFile, tagFormat, logger }) {
         const args = parseChangesetVersionArgs(values);
         const result = await versionChangesets({
             cwd,
+            ...parseChangesetProjectArgs(values),
             ...(configFile ? { configFile } : {}),
             ...(tagFormat ? { tagFormat } : {}),
             ...args,

package/dist/commands/checksums.d.ts

@@ -27,10 +27,13 @@ declare const _default: {
         'filename-format': {
             type: "string";
         };
+        'checksums-format': {
+            type: "string";
+        };
         output: {
             type: "string";
         };
     };
-    run({ values, positionals, cwd, logger, }: import("./command.ts").CommandContext): Promise<CommandOutcome<ChecksumsResult>>;
+    run({ values, positionals, cwd, configFile, logger, }: import("./command.ts").CommandContext): Promise<CommandOutcome<ChecksumsResult>>;
 };
 export default _default;

package/dist/commands/checksums.js

@@ -1,6 +1,10 @@
-import { basename, resolve } from 'node:path';
-import { CHECKSUMS_EXTENSION, createChecksums, writeChecksums, } from "../checksums.js";
-import { ignoreOwnFile, ignoreOwnSignature, loadFileRules, resolveFileSelection, } from "../file-selection.js";
+import { ValidationError } from "../errors.js";
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, basename, resolve } from 'node:path';
+import { loadChangesetConfig } from "../changeset-config.js";
+import { resolveManifestCodec, encodeIntegrity } from "../integrity.js";
+import { CHECKSUMS_EXTENSION, createChecksums } from "../checksums.js";
+import { isErrorCode, ignoreOwnFile, ignoreOwnSignature, loadFileRules, resolveFileSelection, } from "../file-selection.js";
 import { FILENAME_FORMAT, formatFilename } from "../filename.js";
 import { readPackageMeta } from "../package-meta.js";
 import { getChecksumsSummary } from "../summary.js";
@@ -15,6 +19,7 @@ export default {
                               accepted as --source-dir <dir>
 
 Options:
+  --checksums-format <name>    wordpress-json (default) or sha256sum
   --output <file>             Manifest file (default: the --filename-format name
                               in the current directory)
   --slug <slug>               Plugin or theme slug (default: project directory name)
@@ -40,22 +45,27 @@ matches the ZIP contents.`,
         version: { type: 'string' },
         type: { type: 'string' },
         'filename-format': { type: 'string' },
+        'checksums-format': { type: 'string' },
         output: { type: 'string' },
         ...sourceDirArgs,
         ...fileSelectionArgs,
         force: { type: 'boolean' },
     },
-    async run({ values, positionals, cwd, logger, }) {
+    async run({ values, positionals, cwd, configFile, logger, }) {
         const sourceDir = resolve(cwd, getSourceDirArg(values, positionals));
         const slug = getString(values, 'slug') ?? basename(cwd);
         await checkDirectory(sourceDir);
         const meta = await readPackageMeta({ dir: sourceDir, slug });
         const version = getString(values, 'version') ?? meta?.version ?? null;
         const filename = formatFilename(getString(values, 'filename-format') ?? FILENAME_FORMAT, { slug, version });
+        const loaded = await loadChangesetConfig({ cwd, configFile });
+        const codec = resolveManifestCodec(getString(values, 'checksums-format') ?? loaded?.config.integrity?.codec);
         const checksumsPath = resolveOutput({
             cwd,
             output: getString(values, 'output'),
-            filename: filename + CHECKSUMS_EXTENSION,
+            filename: codec.id === 'wordpress-json'
+                ? filename + CHECKSUMS_EXTENSION
+                : codec.filename,
         });
         const selection = resolveFileSelection({
             cwd,
@@ -71,7 +81,18 @@ matches the ZIP contents.`,
             type: getString(values, 'type') ?? meta?.type,
         });
         const files = Object.keys(manifest.files).length;
-        await writeChecksums(checksumsPath, manifest, getBoolean(values, 'force'));
+        await mkdir(dirname(checksumsPath), { recursive: true });
+        try {
+            await writeFile(checksumsPath, await encodeIntegrity(codec, manifest), {
+                flag: getBoolean(values, 'force') ? 'w' : 'wx',
+            });
+        }
+        catch (error) {
+            if (isErrorCode(error, 'EEXIST')) {
+                throw new ValidationError(`${checksumsPath} already exists, pass --force to overwrite it.`);
+            }
+            throw error;
+        }
         logger.debug(`Hashed ${files} files in ${sourceDir}.`);
         logger.info(checksumsPath);
         logger.summary((context) => getChecksumsSummary(context, { checksumsPath, files }));

package/dist/commands/command.d.ts

@@ -1,6 +1,7 @@
 import type { ParseArgsOptionsConfig } from 'node:util';
 import type { PromptTerminal } from '../changeset-prompt.ts';
 import type { Logger } from '../logger.ts';
+import type { SvnRunner } from '../svn.ts';
 /**
  * Parsed option values from node:util parseArgs().
  */
@@ -18,6 +19,8 @@ export interface CommandContext {
     tagFormat?: string;
     /** Logger for the command output. */
     logger: Logger;
+    /** SVN command runner supplied by a wrapper, instead of spawning svn directly. */
+    svnRunner?: SvnRunner;
     /** Terminal for interactive prompts, only when the CLI runs in one and prints no JSON. */
     terminal?: PromptTerminal;
 }

package/dist/commands/deploy-svn.d.ts

@@ -1,5 +1,14 @@
 import type { DeployInput } from '../deploy-options.ts';
-import type { ParsedValues } from './command.ts';
+import type { DeployResult } from '../svn-deploy.ts';
+import type { PackageDeployPlanItem } from '../package-deploy.ts';
+import type { CommandOutcome, ParsedValues } from './command.ts';
+import type { PackageDeployOutcome } from './package-deploys.ts';
+/** Results of a single deploy, a configured plan or configured deploys. */
+export type DeploySvnResult = DeployResult | {
+    packages: PackageDeployPlanItem[];
+} | {
+    deploys: PackageDeployOutcome<DeployResult>[];
+};
 export interface DeployArgsInput {
     /** Parsed CLI values. */
     values: ParsedValues;
@@ -76,19 +85,6 @@ declare const _default: {
             type: "string";
         };
     };
-    run({ values, positionals, cwd, configFile, tagFormat, logger }: import("./command.ts").CommandContext): Promise<{
-        exitCode: number;
-        result: {
-            packages: import("../package-deploy.ts").PackageDeployPlanItem[];
-        };
-    } | {
-        exitCode: number;
-        result: {
-            deploys: import("./package-deploys.ts").PackageDeployOutcome<import("../svn-deploy.ts").DeployResult>[];
-        };
-    } | {
-        exitCode: number;
-        result: import("../svn-deploy.ts").DeployResult;
-    }>;
+    run({ values, positionals, cwd, configFile, tagFormat, logger, svnRunner, }: import("./command.ts").CommandContext): Promise<CommandOutcome<DeploySvnResult>>;
 };
 export default _default;

package/dist/commands/deploy-svn.js

@@ -1,6 +1,7 @@
 import { resolveDeployOptions } from "../deploy-options.js";
 import { getSvnDeploys } from "../package-deploy.js";
 import { SvnDeploy } from "../svn-deploy.js";
+import { Svn } from "../svn.js";
 import { fileSelectionArgs, getFileSelectionInput, getSourceDirArg, sourceDirArgs, } from "./args.js";
 import { getBoolean, getString } from "./command.js";
 import { getPackageDeployArgs, listPackageDeploys, packageDeployArgs, runPackageDeploys, } from "./package-deploys.js";
@@ -23,6 +24,26 @@ const TARGET_FLAGS = [
     'svn-url',
     'message',
 ];
+/**
+ * Run an SVN deploy with the optional command runner supplied by a wrapper.
+ *
+ * @param input  Deploy input.
+ * @param logger Logger for the deploy.
+ * @param runner Optional SVN command runner.
+ * @return Deploy result.
+ */
+async function runDeploy(input, logger, runner) {
+    const options = resolveDeployOptions(input);
+    const svn = runner
+        ? new Svn({
+            runner,
+            username: options.svnUsername,
+            password: options.svnPassword,
+            logger,
+        })
+        : undefined;
+    return new SvnDeploy(options, logger, svn).run();
+}
 /**
  * Map the parsed "deploy-svn" arguments to resolveDeployOptions() input.
  * Flags that aren't passed stay undefined, so that the same defaults apply
@@ -135,7 +156,7 @@ Examples:
         ...packageDeployArgs,
         'dry-run': { type: 'boolean' },
     },
-    async run({ values, positionals, cwd, configFile, tagFormat, logger }) {
+    async run({ values, positionals, cwd, configFile, tagFormat, logger, svnRunner, }) {
         const { ref, packages, list } = getPackageDeployArgs(values, positionals, TARGET_FLAGS);
         if (ref) {
             const deploys = await getSvnDeploys({
@@ -148,14 +169,13 @@ Examples:
             });
             return list
                 ? listPackageDeploys(deploys, logger, ref)
-                : runPackageDeploys(deploys, (input) => new SvnDeploy(resolveDeployOptions({
+                : runPackageDeploys(deploys, (input) => runDeploy({
                     ...input,
                     svnUsername: getString(values, 'svn-username'),
                     force: getBoolean(values, 'force'),
-                }), logger).run(), logger, ref);
+                }, logger, svnRunner), logger, ref);
         }
-        const options = resolveDeployOptions(getDeployInputFromArgs({ values, positionals, cwd }));
-        const result = await new SvnDeploy(options, logger).run();
+        const result = await runDeploy(getDeployInputFromArgs({ values, positionals, cwd }), logger, svnRunner);
         return { exitCode: 0, result };
     },
 };

package/dist/commands/package-source.d.ts

@@ -0,0 +1,43 @@
+import type { PackageType } from '../checksums.ts';
+import type { FileSelection } from '../file-selection.ts';
+import type { ParsedValues } from './command.ts';
+/** Release source, file selection and package metadata. */
+export interface PackageSource {
+    sourceDir: string;
+    selection: FileSelection;
+    slug: string;
+    version: string | null;
+    type?: PackageType;
+    package?: string;
+}
+/**
+ * Get the configured package to release, failing for the options that set the
+ * source directory and the files instead.
+ *
+ * @param  values      Parsed CLI values.
+ * @param  positionals Positional arguments.
+ * @return The package identifier or path, or undefined without --package.
+ * @throws {ValidationError} For an empty --package, or --package with a source directory or file selection option.
+ */
+export declare function getPackageArg(values: ParsedValues, positionals: string[]): string | undefined;
+/**
+ * Get the files of a source directory from the CLI options.
+ *
+ * @param values      Parsed CLI values.
+ * @param positionals Positional arguments.
+ * @param cwd         Working directory.
+ * @return Source directory, file selection, slug and version.
+ */
+export declare function getDirectorySource(values: ParsedValues, positionals: string[], cwd: string): Promise<PackageSource>;
+/**
+ * Get the directory of a configured package with the files config of its
+ * package group, which its deploys use too.
+ *
+ * @param  values     Parsed CLI values.
+ * @param  cwd        Repository root with the wp-release config.
+ * @param  name       Package identifier or path under the configured root.
+ * @param  configFile Config file, instead of the conventional one.
+ * @return Source directory, file selection, slug, version and package.
+ * @throws {ValidationError} Without a config or for an unknown package.
+ */
+export declare function getPackageSource(values: ParsedValues, cwd: string, name: string, configFile?: string): Promise<PackageSource>;