@detergent-software/atk 8.9.0-dev.2 → 8.9.0-dev.20

package/build/lib/pastel/read-commands.js

@@ -10,9 +10,17 @@ import decamelize from 'decamelize';
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { pathToFileURL } from 'node:url';
-const readCommands = async (directory) => {
-    const commands = new Map();
-    const files = await fs.readdir(directory);
+import { isDeepStrictEqual } from 'node:util';
+import describeArguments from './generate-arguments.js';
+import describeOptions from './generate-options.js';
+/**
+ * Import every command in `directory` and describe it as plain data. Files are read in name order, so the manifest
+ * and the help list commands the same way on every file system. `prefix` is the folder's path from the commands
+ * folder, for `file`.
+ */
+const readCommands = async (directory, prefix = '') => {
+    const commands = [];
+    const files = (await fs.readdir(directory)).sort();
     for (const file of files) {
         if (file.startsWith('_app')) {
             continue;
@@ -20,40 +28,53 @@ const readCommands = async (directory) => {
         const filePath = path.join(directory, file);
         const stat = await fs.stat(filePath);
         if (stat.isDirectory()) {
-            const subCommands = await readCommands(filePath);
-            const indexCommand = subCommands.get('index');
-            if (indexCommand) {
-                indexCommand.name = file;
-                indexCommand.commands = subCommands;
-                subCommands.delete('index');
-                commands.set(file, indexCommand);
-                continue;
-            }
-            const command = indexCommand ?? {
-                commands: subCommands,
-                isDefault: false,
-                name: file,
-            };
-            commands.set(file, command);
+            const subCommands = await readCommands(filePath, `${prefix}${file}/`);
+            const indexCommand = subCommands.find((command) => command.name === 'index');
+            const others = subCommands.filter((command) => command !== indexCommand);
+            commands.push(indexCommand
+                ? { ...indexCommand, commands: others, name: file }
+                : { commands: others, isDefault: false, name: file });
             continue;
         }
         if (!/\.(js|ts)x?$/.test(file) || file.endsWith('.d.ts')) {
             continue;
         }
-        const fileUrl = pathToFileURL(filePath);
-        const m = (await import(__rewriteRelativeImportExtension(fileUrl.href)));
-        const name = decamelize(file.replace(/\.(js|ts)x?$/, ''), { separator: '-' });
-        commands.set(name, {
-            alias: m.alias,
-            args: m.args,
-            component: m.default,
-            description: m.description,
-            isDefault: m.isDefault ?? false,
-            name,
-            options: m.options,
-        });
+        const m = (await import(__rewriteRelativeImportExtension(pathToFileURL(filePath).href)));
+        const stem = file.replace(/\.(js|ts)x?$/, '');
+        const command = { isDefault: m.isDefault ?? false, name: decamelize(stem, { separator: '-' }) };
+        if (m.alias) {
+            command.alias = m.alias;
+        }
+        if (m.args) {
+            command.args = describeArguments(m.args);
+        }
+        if (m.description) {
+            command.description = m.description;
+        }
+        // The built module's name: under tsx, `.js` resolves to the `.ts(x)` source.
+        if (m.default) {
+            command.file = `${prefix}${stem}.js`;
+        }
+        if (m.options) {
+            command.options = describeOptions(m.options);
+        }
+        for (const spec of [...(command.args ?? []), ...(command.options ?? [])]) {
+            assertJsonDefault(spec, `${prefix}${file}`);
+        }
+        commands.push(command);
     }
     return commands;
 };
+/**
+ * The manifest is JSON, written on a developer's machine, so a default must be a constant JSON keeps as it is: not
+ * `Infinity`, a `Date` or a function's result. A default that differs between machines (`process.cwd()`, a home
+ * path) passes here but fails the manifest test anywhere else.
+ */
+function assertJsonDefault(spec, file) {
+    const { defaultValue } = spec;
+    if (defaultValue !== undefined && !isDeepStrictEqual(JSON.parse(JSON.stringify(defaultValue)), defaultValue)) {
+        throw new Error(`${file}: the default of ${spec.flags ?? spec.name} (${String(defaultValue)}) doesn't survive JSON, so the command manifest can't carry it.`);
+    }
+}
 export default readCommands;
 //# sourceMappingURL=read-commands.js.map

package/build/lib/pastel/read-commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-commands.js","sourceRoot":"","sources":["../../../src/lib/pastel/read-commands.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC,MAAM,YAAY,GAAG,KAAK,EAAE,SAAiB,EAAiC,EAAE;IAC9E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAErC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;YACjD,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAE9C,IAAI,YAAY,EAAE,CAAC;gBACjB,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC;gBACzB,YAAY,CAAC,QAAQ,GAAG,WAAW,CAAC;gBACpC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC5B,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;gBACjC,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAY,YAAY,IAAI;gBACvC,QAAQ,EAAE,WAAW;gBACrB,SAAS,EAAE,KAAK;gBAChB,IAAI,EAAE,IAAI;aACX,CAAC;YAEF,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACzD,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,kCAAC,OAAO,CAAC,IAAI,EAAC,CAAmB,CAAC;QACzD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAE9E,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE;YACjB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,CAAC,CAAC,OAAO;YACpB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,KAAK;YAC/B,IAAI;YACJ,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"read-commands.js","sourceRoot":"","sources":["../../../src/lib/pastel/read-commands.ts"],"names":[],"mappings":"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"}

package/build/lib/pastel/render-command.d.ts

@@ -0,0 +1,13 @@
+import { type Command as CommanderCommand } from 'commander';
+import type { CommandExports } from './internal-types.js';
+/**
+ * Run a command once commander has parsed it: check its options and arguments against the module's Zod schemas, then
+ * render its component in the app. `generate-command.tsx` imports this only when a command runs, so help and version
+ * output never load Ink, React or Zod (ATK-605).
+ */
+export default function renderCommand(commanderCommand: CommanderCommand, module: CommandExports, { commandsDirectory, input, variadic }: {
+    commandsDirectory: string;
+    input: unknown[];
+    variadic: boolean;
+}): Promise<void>;
+//# sourceMappingURL=render-command.d.ts.map

package/build/lib/pastel/render-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-command.d.ts","sourceRoot":"","sources":["../../../src/lib/pastel/render-command.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,IAAI,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAK7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D;;;;GAIG;AACH,wBAA8B,aAAa,CACzC,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,EAAE,cAAc,EACtB,EAAE,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,iBA6C3G"}

package/build/lib/pastel/render-command.js

@@ -0,0 +1,56 @@
+import {} from 'commander';
+import { render } from 'ink';
+import React from 'react';
+import { fromZodError } from 'zod-validation-error';
+import App from './_app.js';
+import readCustomApp from './read-custom-app.js';
+/**
+ * Run a command once commander has parsed it: check its options and arguments against the module's Zod schemas, then
+ * render its component in the app. `generate-command.tsx` imports this only when a command runs, so help and version
+ * output never load Ink, React or Zod (ATK-605).
+ */
+export default async function renderCommand(commanderCommand, module, { commandsDirectory, input, variadic }) {
+    const Component = module.default;
+    // The manifest names a module only when it had a component.
+    if (!Component) {
+        throw new Error(`${commanderCommand.name()} has no default export: run \`pnpm manifest\` after changing it.`);
+    }
+    const options = input.pop();
+    let parsedOptions = {};
+    if (module.options) {
+        const result = module.options.safeParse(options);
+        if (result.success) {
+            parsedOptions = result.data ?? {};
+        }
+        else {
+            rejectInput(commanderCommand, result.error);
+        }
+    }
+    let arguments_ = [];
+    if (module.args) {
+        const result = module.args.safeParse(variadic ? input.flat() : input);
+        if (result.success) {
+            arguments_ = result.data ?? [];
+        }
+        else {
+            rejectInput(commanderCommand, result.error);
+        }
+    }
+    const appComponent = (await readCustomApp(commandsDirectory)) ?? App;
+    render(React.createElement(appComponent, {
+        commandProps: {
+            args: arguments_,
+            options: parsedOptions,
+        },
+        Component,
+    }));
+}
+/**
+ * Options or arguments the command's schema rejects are a usage error, reported through commander like its own
+ * (exit 2), so `Pastel`'s `onUsageError` sees them too.
+ */
+function rejectInput(commanderCommand, error) {
+    const { message } = fromZodError(error, { maxIssuesInMessage: 1, prefix: '', prefixSeparator: '' });
+    commanderCommand.error(`error: ${message}`, { code: 'pastel.invalidInput', exitCode: 2 });
+}
+//# sourceMappingURL=render-command.js.map

package/build/lib/pastel/render-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-command.js","sourceRoot":"","sources":["../../../src/lib/pastel/render-command.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoC,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAIpD,OAAO,GAAG,MAAM,WAAW,CAAC;AAC5B,OAAO,aAAa,MAAM,sBAAsB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,aAAa,CACzC,gBAAkC,EAClC,MAAsB,EACtB,EAAE,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAsE;IAE1G,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC;IAEjC,4DAA4D;IAC5D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,GAAG,gBAAgB,CAAC,IAAI,EAAE,kEAAkE,CAAC,CAAC;IAChH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAA6B,CAAC;IACvD,IAAI,aAAa,GAA4B,EAAE,CAAC;IAEhD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEjD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,aAAa,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,gBAAgB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,IAAI,UAAU,GAAc,EAAE,CAAC;IAE/B,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAEtE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,UAAU,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,gBAAgB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,MAAM,aAAa,CAAC,iBAAiB,CAAC,CAAC,IAAI,GAAG,CAAC;IAErE,MAAM,CACJ,KAAK,CAAC,aAAa,CAAC,YAAY,EAAE;QAChC,YAAY,EAAE;YACZ,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,aAAa;SACvB;QACD,SAAS;KACV,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,gBAAkC,EAAE,KAAyC;IAChG,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,KAAK,EAAE,EAAE,kBAAkB,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,CAAC;IACpG,gBAAgB,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;AAC5F,CAAC"}

package/build/lib/publish-flow.d.ts

@@ -0,0 +1,225 @@
+import type { Adapter } from './schemas/adapter.js';
+import { type ManifestFieldChange } from './manifest-diff.js';
+import { type DeclaredDependency, type PublishEntry, type PublishPlan, type PublishResult, type PublishTarget, type RawAssetDetection, type ValidationResult, type VersionCheckResult } from './publisher.js';
+export type MetadataSubPhase = 'building-staging' | 'description' | 'tags';
+export type PublishAction = {
+    adapters: Adapter[];
+    type: 'TOOLS_LOADED';
+} | {
+    authorValue: string;
+    orgValue: string;
+    rawDetection: RawAssetDetection;
+    toolsDetected: string[];
+    type: 'RAW_DETECT_DONE';
+} | {
+    code?: string;
+    command?: string;
+    hint?: string;
+    message: string;
+    type: 'ERROR';
+} | {
+    entries: PublishEntryState[];
+    type: 'ENTRIES_CHECKED';
+} | {
+    entries: PublishEntryState[];
+    type: 'ENTRIES_LOADED';
+} | {
+    error: PublishErrorAction;
+    missing: DeclaredDependency[];
+    suggested: PublishEntry[];
+    type: 'SUGGEST_ENTRIES';
+} | {
+    isUpdate: boolean;
+    resolvedVersion: string;
+    token: string;
+    type: 'REGISTRY_CHECK_DONE';
+    versionCheck: VersionCheckResult;
+} | {
+    lockfileOrgReviewers?: string[];
+    type: 'VALIDATE_DONE';
+    validation: ValidationResult;
+} | {
+    manifestDiff?: ManifestFieldChange[];
+    plan: PublishPlan;
+    type: 'PLAN_DONE';
+} | {
+    message: string;
+    type: 'BUMP_DONE';
+    updatedTarget: PublishTarget;
+    version: string;
+} | {
+    message: string;
+    type: 'PUBLISH_PROGRESS';
+} | {
+    rawDetection: RawAssetDetection;
+    target: PublishTarget;
+    type: 'RAW_DETECT_DONE_NON_INTERACTIVE';
+} | {
+    resolvedPath: string;
+    type: 'RESOLVED_INSTALLED';
+} | {
+    resolvedPath: string;
+    type: 'RESOLVED_UPDATE';
+} | {
+    result: PublishResult;
+    type: 'PUBLISH_DONE';
+} | {
+    target: PublishTarget;
+    type: 'DETECT_DONE';
+} | {
+    target: PublishTarget;
+    type: 'STAGING_DONE';
+} | {
+    tools: string[];
+    type: 'CONFIRM_PROMPT_TOOLS';
+} | {
+    tools: string[];
+    type: 'RESOLVE_TOOLS_NONINTERACTIVE';
+} | {
+    type: 'SET_BUMP_SELECTION';
+    value: string;
+} | {
+    type: 'SET_CONFIRM_VALUE';
+    value: string;
+} | {
+    type: 'SET_DESCRIPTION';
+    value: string;
+} | {
+    type: 'SET_PROMPT_TAGS';
+    value: string;
+} | {
+    type: 'SET_PUBLISH_CONFIRM_VALUE';
+    value: string;
+} | {
+    type: 'SET_REVIEWER';
+    value: string;
+} | {
+    type: 'SET_TAGS';
+    value: string;
+} | {
+    type: 'SET_WITH_CONFIRM_VALUE';
+    value: string;
+} | {
+    type: 'SUBMIT_BUMP';
+} | {
+    type: 'SUBMIT_CONFIRM';
+} | {
+    type: 'SUBMIT_DESCRIPTION';
+} | {
+    type: 'SUBMIT_PROMPT_TAGS';
+} | {
+    type: 'SUBMIT_PUBLISH_CONFIRM';
+} | {
+    type: 'SUBMIT_REVIEWER';
+} | {
+    type: 'SUBMIT_TAGS';
+} | {
+    type: 'SUBMIT_WITH_CONFIRM';
+};
+/** An entry of the publish (see {@link PublishEntry}) and how far the run has checked it. */
+export interface PublishEntryState extends PublishEntry {
+    /** The version to publish: the manifest's, or its bump. Unset while a needed bump is pending. */
+    resolvedVersion?: string;
+    validation?: ValidationResult;
+    /** Set once `checking-entries` ran for the entry. */
+    versionCheck?: VersionCheckResult;
+}
+export type PublishErrorAction = PublishAction & {
+    type: 'ERROR';
+};
+export interface PublishFlags {
+    bump?: 'major' | 'minor' | 'patch';
+    descriptionFlag?: string;
+    dryRun: boolean;
+    force?: boolean;
+    fromInstalled: boolean;
+    isTTY?: boolean;
+    json?: boolean;
+    message?: string;
+    /** Every path given; more than one publishes them as one batch, `rawPath` (the first) as its root. */
+    paths?: string[];
+    projectRoot?: string;
+    rawPath: string;
+    refresh?: boolean;
+    reviewerFlag?: string;
+    tagsFlag?: string;
+    tool?: string;
+    toolsFlag?: string;
+    update: boolean;
+    /** `--with` folders: new dependencies published in the same pull request. */
+    withPaths?: string[];
+    yes?: boolean;
+}
+export type PublishPhase = 'building-plan' | 'bump-prompt' | 'checking-entries' | 'checking-registry' | 'confirm-publish' | 'confirm-update' | 'confirm-with' | 'detecting' | 'done' | 'dry-run-result' | 'error' | 'gathering-metadata' | 'loading-tools' | 'prompting-reviewer' | 'prompting-tags' | 'prompting-tools' | 'publishing' | 'resolving-installed' | 'resolving-update' | 'validating';
+export interface PublishState {
+    authorValue: string;
+    /** The entry the bump prompt is for; unset when it is for the root asset. */
+    bumpEntry?: number;
+    bumpSelection: string;
+    confirmValue: string;
+    descriptionValue: string;
+    /** New dependencies published with the root asset, in request order. */
+    entries: PublishEntryState[];
+    errorCode?: string;
+    errorCommand?: string;
+    errorHint?: string;
+    errorMessage: string;
+    flags: PublishFlags;
+    isRawPublish: boolean;
+    isUpdate: boolean;
+    manifestDiff: ManifestFieldChange[] | undefined;
+    metadataSubPhase: MetadataSubPhase;
+    /** The missing dependencies the `confirm-with` prompt offers folders for. */
+    missingDependencies: DeclaredDependency[];
+    nonInteractive: boolean;
+    orgValue: string;
+    /** The plan's error, shown if the `confirm-with` offer is declined. */
+    pendingError?: PublishErrorAction;
+    phase: PublishPhase;
+    plan: PublishPlan | undefined;
+    progressMessage: string;
+    promptTagsValue: string;
+    publishConfirmValue: string;
+    publishResult: PublishResult | undefined;
+    rawDetection: null | RawAssetDetection;
+    resolvedPath: string;
+    resolvedVersion: string;
+    reviewerValue: string;
+    /** The tools chosen at the tools prompt; empty unless it was asked. */
+    selectedPromptTools: string[];
+    /** Folders next to the root that the `confirm-with` prompt offers to publish too. */
+    suggestedEntries: PublishEntry[];
+    tagsValue: string;
+    target: PublishTarget | undefined;
+    token: string | undefined;
+    toolAdapters: Adapter[];
+    toolsDetected: string[];
+    validation: undefined | ValidationResult;
+    versionCheck: undefined | VersionCheckResult;
+    withConfirmValue: string;
+}
+/**
+ * What a publish step needs from whoever runs it. A step reads the state it started
+ * in and reports what it found as reducer actions, as the phase effects did.
+ */
+export interface PublishStepContext {
+    /** True once the run has moved on or stopped; `runPublishStep` then drops what the step dispatches. */
+    cancelled: () => boolean;
+    dispatch: (action: PublishAction) => void;
+    /** A staging directory the run removes when it ends, staged as soon as it exists so a cancelled run removes it too. */
+    stage: (dir: string) => void;
+}
+export declare function createInitialState(flags: PublishFlags): PublishState;
+/** Several folders published together (`atk publish a b c`) in one pull request; one folder named twice is one. */
+export declare function isBatch(flags: PublishFlags): boolean;
+/**
+ * Run the step for the state's phase, if it has one: the work the phase waits on,
+ * reported through `ctx.dispatch`, which reaches the runner only until the run is
+ * cancelled. An error the step throws is dispatched too, so this never rejects.
+ * Prompt and terminal phases have no step.
+ */
+export declare function runPublishStep(state: PublishState, ctx: PublishStepContext): Promise<void>;
+/** The comma-separated values in a flag or prompt answer, trimmed, without empty ones. */
+export declare function splitList(value: string | undefined): string[];
+export declare function publishReducer(state: PublishState, action: PublishAction): PublishState;
+//# sourceMappingURL=publish-flow.d.ts.map

package/build/lib/publish-flow.d.ts.map

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