handoff-app 2.0.0-4 → 2.0.0-5

package/dist/commands/eject/config.js

@@ -8,11 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const __1 = __importDefault(require("../../"));
 const utils_1 = require("../utils");
 const command = {
     command: 'eject:config',
@@ -21,7 +17,7 @@ const command = {
         return (0, utils_1.getSharedOptions)(yargs);
     },
     handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
-        const handoff = new __1.default(args.debug, args.force);
+        const handoff = (0, utils_1.createHandoff)(args);
         yield handoff.ejectConfig();
     }),
 };

package/dist/commands/eject/pages.js

@@ -8,11 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const __1 = __importDefault(require("../../"));
 const utils_1 = require("../utils");
 const command = {
     command: 'eject:pages',
@@ -21,7 +17,7 @@ const command = {
         return (0, utils_1.getSharedOptions)(yargs);
     },
     handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
-        const handoff = new __1.default(args.debug, args.force);
+        const handoff = (0, utils_1.createHandoff)(args);
         yield handoff.ejectPages();
     }),
 };

package/dist/commands/eject/theme.js

@@ -8,11 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const __1 = __importDefault(require("../../"));
 const utils_1 = require("../utils");
 const command = {
     command: 'eject:theme',
@@ -21,7 +17,7 @@ const command = {
         return (0, utils_1.getSharedOptions)(yargs);
     },
     handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
-        const handoff = new __1.default(args.debug, args.force);
+        const handoff = (0, utils_1.createHandoff)(args);
         yield handoff.ejectTheme();
     }),
 };

package/dist/commands/fetch/index.js

@@ -8,11 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const __1 = __importDefault(require("../../"));
 const utils_1 = require("../utils");
 const command = {
     command: 'fetch',
@@ -21,7 +17,7 @@ const command = {
         return (0, utils_1.getSharedOptions)(yargs);
     },
     handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
-        const handoff = new __1.default(args.debug, args.force);
+        const handoff = (0, utils_1.createHandoff)(args);
         yield handoff.fetch();
     }),
 };

package/dist/commands/index.js

@@ -20,7 +20,9 @@ const logout_1 = __importDefault(require("./logout"));
 const component_1 = __importDefault(require("./make/component"));
 const page_1 = __importDefault(require("./make/page"));
 const template_1 = __importDefault(require("./make/template"));
+const pull_1 = __importDefault(require("./pull"));
 const publish_1 = __importDefault(require("./publish"));
+const push_1 = require("./push");
 const scaffold_1 = __importDefault(require("./scaffold"));
 const start_1 = __importDefault(require("./start"));
 const components_2 = __importDefault(require("./validate/components"));
@@ -42,6 +44,8 @@ exports.commands = [
     component_1.default,
     template_1.default,
     publish_1.default,
+    pull_1.default,
+    ...push_1.pushCommands,
     scaffold_1.default,
     start_1.default,
     components_2.default,

package/dist/commands/login/index.js

@@ -8,11 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const __1 = __importDefault(require("../../"));
 const device_1 = require("../../cli/auth/device");
 const store_1 = require("../../cli/auth/store");
 const connection_1 = require("../../registry/connection");
@@ -33,7 +29,7 @@ const command = {
     }),
     handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
         var _a;
-        const handoff = new __1.default(args.debug, args.force);
+        const handoff = (0, utils_1.createHandoff)(args);
         try {
             const configured = (0, connection_1.resolveRegistryConnection)(handoff.config);
             const remoteUrl = ((_a = args.url) === null || _a === void 0 ? void 0 : _a.trim()) || configured.url;

package/dist/commands/logout/index.js

@@ -8,11 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const __1 = __importDefault(require("../../"));
 const device_1 = require("../../cli/auth/device");
 const store_1 = require("../../cli/auth/store");
 const logger_1 = require("../../utils/logger");
@@ -25,7 +21,7 @@ const command = {
         describe: 'Revoke credentials only when they belong to this exact registry URL',
     }),
     handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
-        const handoff = new __1.default(args.debug, args.force);
+        const handoff = (0, utils_1.createHandoff)(args);
         const auth = yield (0, store_1.readCliAuth)(handoff.workingPath);
         if (args.url && auth && !(0, store_1.cliAuthMatchesRegistry)(auth, args.url)) {
             logger_1.Logger.error(`The saved login belongs to ${auth.remoteUrl}, not ${(0, store_1.normalizeRegistryUrl)(args.url)}. No credentials were changed.`);

package/dist/commands/make/component.js

@@ -8,11 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const __1 = __importDefault(require("../.."));
 const logger_1 = require("../../utils/logger");
 const utils_1 = require("../utils");
 const command = {
@@ -25,7 +21,7 @@ const command = {
         });
     },
     handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
-        const handoff = new __1.default(args.debug, args.force);
+        const handoff = (0, utils_1.createHandoff)(args);
         const componentName = args.name;
         if (!/^[a-z0-9_-]+$/i.test(componentName)) {
             logger_1.Logger.error(`Component name must be alphanumeric and may contain dashes or underscores`);

package/dist/commands/make/page.js

@@ -8,11 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const __1 = __importDefault(require("../../"));
 const logger_1 = require("../../utils/logger");
 const utils_1 = require("../utils");
 const command = {
@@ -30,14 +26,14 @@ const command = {
         });
     },
     handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
-        const handoff = new __1.default(args.debug, args.force);
+        const handoff = (0, utils_1.createHandoff)(args);
         const pageName = args.name;
-        if (!/^[a-z0-9]+$/i.test(pageName)) {
+        if (!/^[a-z0-9_-]+$/i.test(pageName)) {
             logger_1.Logger.error(`Page name must be alphanumeric and may contain dashes or underscores`);
             return;
         }
         let pageParent = args.parent;
-        if (pageParent && !/^[a-z0-9]+$/i.test(pageParent)) {
+        if (pageParent && !/^[a-z0-9_-]+$/i.test(pageParent)) {
             logger_1.Logger.error(`Page parent must be alphanumeric and may contain dashes or underscores`);
             return;
         }

package/dist/commands/make/template.js

@@ -8,11 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const __1 = __importDefault(require("../../"));
 const logger_1 = require("../../utils/logger");
 const utils_1 = require("../utils");
 const command = {
@@ -30,7 +26,7 @@ const command = {
         });
     },
     handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
-        const handoff = new __1.default(args.debug, args.force);
+        const handoff = (0, utils_1.createHandoff)(args);
         const templateComponent = args.component;
         if (!/^[a-z0-9]+$/i.test(templateComponent)) {
             logger_1.Logger.error(`Template component must be alphanumeric and may contain dashes or underscores`);

package/dist/commands/publish/index.d.ts

@@ -1,22 +1,28 @@
 import { CommandModule } from 'yargs';
 import { SharedArgs } from '../types';
-import { RegistryEntityKind } from '../utils';
+import { RegistryTargetKind } from '../utils';
 export interface PublishArgs extends SharedArgs {
-    type: RegistryEntityKind;
-    id?: string;
+    type: RegistryTargetKind;
+    id?: string[];
 }
 /**
- * `handoff-app publish <components|patterns|pages> [id]` runs a fresh local build and uploads to the
- * connected registry. Pass an `id` to build and upload that one entity, or omit it to build the kind
- * once and upload every declared entity, skipping any whose content already matches the registry
- * (pass `--force` to re-upload everything).
+ * `handoff-app publish <components|patterns|pages> [id...]` runs a fresh local build and uploads to
+ * the connected registry. Pass ids to build and upload only those entities, or omit them to build the
+ * kind once and upload every declared entity, skipping any whose content already matches the registry
+ * (`--force` re-uploads everything).
  *
- * `handoff-app publish tokens [setId]` — fresh token build + upload of every logical token set, or
- * only the named set (`foundation/colors`, `component/button`).
+ * `handoff-app publish tokens [setId...]` does a fresh token build and uploads every logical token
+ * set, or only the named ones (`foundation/colors`, `component/button`).
  *
- * `handoff-app publish assets [collection]` runs a fresh build and uploads every asset collection, or
- * only the named one (`icons`, `logos`, `fonts`). Available only from a connected workspace
- * (`runtime.mode: workspace` + a configured `registryConnection`).
+ * `handoff-app publish assets [collection...]` runs a fresh build and uploads every asset collection,
+ * or only the named ones (`icons`, `logos`, `fonts`).
+ *
+ * `handoff-app publish all` runs every kind in dependency order: tokens, assets, components,
+ * patterns, then pages.
+ *
+ * Available only from a connected workspace (`runtime.mode: workspace` + a configured
+ * `registryConnection`), except under `--dry-run`, which reports what would be uploaded and needs no
+ * registry at all.
  */
 declare const command: CommandModule<{}, PublishArgs>;
 export default command;

package/dist/commands/publish/index.js

@@ -1,65 +1,29 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const __1 = __importDefault(require("../../"));
-const logger_1 = require("../../utils/logger");
 const utils_1 = require("../utils");
 /**
- * `handoff-app publish <components|patterns|pages> [id]` runs a fresh local build and uploads to the
- * connected registry. Pass an `id` to build and upload that one entity, or omit it to build the kind
- * once and upload every declared entity, skipping any whose content already matches the registry
- * (pass `--force` to re-upload everything).
+ * `handoff-app publish <components|patterns|pages> [id...]` runs a fresh local build and uploads to
+ * the connected registry. Pass ids to build and upload only those entities, or omit them to build the
+ * kind once and upload every declared entity, skipping any whose content already matches the registry
+ * (`--force` re-uploads everything).
+ *
+ * `handoff-app publish tokens [setId...]` does a fresh token build and uploads every logical token
+ * set, or only the named ones (`foundation/colors`, `component/button`).
+ *
+ * `handoff-app publish assets [collection...]` runs a fresh build and uploads every asset collection,
+ * or only the named ones (`icons`, `logos`, `fonts`).
  *
- * `handoff-app publish tokens [setId]` — fresh token build + upload of every logical token set, or
- * only the named set (`foundation/colors`, `component/button`).
+ * `handoff-app publish all` runs every kind in dependency order: tokens, assets, components,
+ * patterns, then pages.
  *
- * `handoff-app publish assets [collection]` runs a fresh build and uploads every asset collection, or
- * only the named one (`icons`, `logos`, `fonts`). Available only from a connected workspace
- * (`runtime.mode: workspace` + a configured `registryConnection`).
+ * Available only from a connected workspace (`runtime.mode: workspace` + a configured
+ * `registryConnection`), except under `--dry-run`, which reports what would be uploaded and needs no
+ * registry at all.
  */
 const command = {
-    command: 'publish <type> [id]',
+    command: 'publish <type> [id..]',
     describe: 'Build and publish components, patterns, pages, design tokens, or assets to the connected registry',
-    builder: (yargs) => {
-        return (0, utils_1.getSharedOptions)(yargs)
-            .positional('type', {
-            describe: 'The kind of entity to publish',
-            choices: utils_1.REGISTRY_ENTITY_KINDS,
-            type: 'string',
-        })
-            .positional('id', {
-            describe: 'The stable id of the entity (component/pattern/page id, token set id, or asset collection); omit to publish all of that kind',
-            type: 'string',
-        });
-    },
-    handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
-        const handoff = new __1.default(args.debug, args.force);
-        try {
-            if (args.type === 'tokens') {
-                yield handoff.publishTokens(args.id);
-                return;
-            }
-            if (args.type === 'assets') {
-                yield handoff.publishAssets(args.id);
-                return;
-            }
-            yield handoff.publish(utils_1.ENTITY_WIRE_KIND[args.type], args.id);
-        }
-        catch (error) {
-            logger_1.Logger.error(error instanceof Error ? error.message : String(error));
-            process.exitCode = 1;
-        }
-    }),
+    builder: (yargs) => (0, utils_1.withTargetPositionals)((0, utils_1.getPublishOptions)(yargs), 'publish'),
+    handler: (args) => (0, utils_1.runRegistryCommand)(args, (handoff) => (0, utils_1.runTarget)(handoff, args.type, args.id, 'publish')),
 };
 exports.default = command;

package/dist/commands/pull/index.d.ts

@@ -0,0 +1,13 @@
+import { CommandModule } from 'yargs';
+import { type CompatTargetArgs } from '../compat/push-args';
+import { SharedArgs } from '../types';
+/**
+ * Deprecated `pull`, the documented name for `checkout`, kept working over the canonical
+ * implementation. With no argument it pulls the entity kinds the docs describe (pages plus component
+ * and pattern declarations); with a kind or selective flags it narrows the same way `push` does.
+ * `--dry-run` is a supported `checkout` option, so it passes straight through.
+ */
+export interface PullArgs extends SharedArgs, CompatTargetArgs {
+}
+declare const pull: CommandModule<{}, PullArgs>;
+export default pull;

package/dist/commands/pull/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const deprecations_1 = require("../compat/deprecations");
+const push_args_1 = require("../compat/push-args");
+const utils_1 = require("../utils");
+const pull = {
+    command: 'pull [type] [id..]',
+    describe: 'Deprecated alias for checkout',
+    deprecated: true,
+    builder: (yargs) => (0, utils_1.withTargetPositionals)((0, utils_1.getCheckoutOptions)(yargs), 'checkout').options({
+        components: { type: 'array', string: true, description: 'Checkout only these component ids' },
+        patterns: { type: 'array', string: true, description: 'Checkout only these pattern ids' },
+        pages: { type: 'array', string: true, description: 'Checkout only these page slugs' },
+    }),
+    handler: (args) => (0, utils_1.runRegistryCommand)(args, (handoff) => {
+        (0, deprecations_1.warnDeprecatedCommand)('pull', 'checkout');
+        return handoff.checkoutAll((0, push_args_1.resolveCompatTargets)(args));
+    }),
+};
+exports.default = pull;

package/dist/commands/push/index.d.ts

@@ -0,0 +1,23 @@
+import { CommandModule } from 'yargs';
+import { type CompatAssetSkipArgs, type CompatSkipArgs, type CompatTargetArgs } from '../compat/push-args';
+import { SharedArgs } from '../types';
+/**
+ * Deprecated `push` family: the command names used by the published docs, kept working over the
+ * canonical `publish` implementation.
+ *
+ * Each command translates its documented arguments through `commands/compat` and then calls the same
+ * `Handoff` entry point `publish` uses, so there is no second publish path to keep in step. Options
+ * the docs describe for subsystems we do not have are declared hidden and warned about, so a command
+ * copied from the docs runs and explains itself rather than failing on an unknown argument.
+ */
+export interface PushArgs extends SharedArgs, CompatTargetArgs {
+}
+export interface PushAllArgs extends SharedArgs, CompatSkipArgs {
+}
+export interface PushTokensArgs extends SharedArgs {
+    setId?: string[];
+}
+export interface PushAssetsArgs extends SharedArgs, CompatAssetSkipArgs {
+    collection?: string;
+}
+export declare const pushCommands: (CommandModule<{}, PushArgs> | CommandModule<{}, PushAllArgs> | CommandModule<{}, PushTokensArgs> | CommandModule<{}, PushAssetsArgs>)[];

package/dist/commands/push/index.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pushCommands = void 0;
+const sets_1 = require("../../registry/assets/sets");
+const deprecations_1 = require("../compat/deprecations");
+const push_args_1 = require("../compat/push-args");
+const utils_1 = require("../utils");
+const push = {
+    command: 'push [type] [id..]',
+    describe: 'Deprecated alias for publish',
+    deprecated: true,
+    builder: (yargs) => (0, utils_1.withTargetPositionals)((0, utils_1.getPublishOptions)(yargs), 'publish').options(Object.assign({ components: { type: 'array', string: true, description: 'Publish only these component ids' }, patterns: { type: 'array', string: true, description: 'Publish only these pattern ids' }, pages: { type: 'array', string: true, description: 'Publish only these page slugs' } }, (0, deprecations_1.hiddenOptions)(deprecations_1.UNSUPPORTED_PUSH_OPTIONS))),
+    handler: (args) => (0, utils_1.runRegistryCommand)(args, (handoff) => {
+        (0, deprecations_1.warnDeprecatedCommand)('push', 'publish');
+        (0, deprecations_1.warnUnsupportedOptions)(args, deprecations_1.UNSUPPORTED_PUSH_OPTIONS);
+        return handoff.publishAll((0, push_args_1.resolveCompatTargets)(args));
+    }),
+};
+const pushAll = {
+    command: 'push:all',
+    describe: 'Deprecated alias for publish all',
+    deprecated: true,
+    builder: (yargs) => (0, utils_1.getPublishOptions)(yargs).options(Object.assign({ 'skip-tokens': { type: 'boolean', description: 'Skip the token step' }, 'skip-assets': { type: 'boolean', description: 'Skip the asset step' }, 'skip-components': { type: 'boolean', description: 'Skip the component step' }, 'skip-patterns': { type: 'boolean', description: 'Skip the pattern step' }, 'skip-pages': { type: 'boolean', description: 'Skip the page step' } }, (0, deprecations_1.hiddenOptions)(deprecations_1.UNSUPPORTED_PUSH_ALL_OPTIONS))),
+    handler: (args) => (0, utils_1.runRegistryCommand)(args, (handoff) => {
+        (0, deprecations_1.warnDeprecatedCommand)('push:all', 'publish all');
+        (0, deprecations_1.warnUnsupportedOptions)(args, deprecations_1.UNSUPPORTED_PUSH_ALL_OPTIONS);
+        return handoff.publishAll((0, push_args_1.resolveCompatAllKinds)(args));
+    }),
+};
+const pushTokens = {
+    command: 'push:tokens [setId..]',
+    describe: 'Deprecated alias for publish tokens',
+    deprecated: true,
+    builder: (yargs) => (0, utils_1.getPublishOptions)(yargs)
+        .positional('setId', { describe: 'Token set id, e.g. foundation/colors', type: 'string', array: true })
+        .options((0, deprecations_1.hiddenOptions)(deprecations_1.UNSUPPORTED_PUSH_TOKENS_OPTIONS)),
+    handler: (args) => (0, utils_1.runRegistryCommand)(args, (handoff) => {
+        (0, deprecations_1.warnDeprecatedCommand)('push:tokens', 'publish tokens');
+        (0, deprecations_1.warnUnsupportedOptions)(args, deprecations_1.UNSUPPORTED_PUSH_TOKENS_OPTIONS);
+        return handoff.publishTokens(args.setId);
+    }),
+};
+const pushAssets = {
+    command: 'push:assets [collection]',
+    describe: 'Deprecated alias for publish assets',
+    deprecated: true,
+    builder: (yargs) => (0, utils_1.getPublishOptions)(yargs)
+        .positional('collection', { describe: `Asset collection (${sets_1.ASSET_COLLECTIONS.join(', ')})`, type: 'string' })
+        .options({
+        'skip-icons': { type: 'boolean', description: 'Skip the icons collection' },
+        'skip-logos': { type: 'boolean', description: 'Skip the logos collection' },
+    }),
+    handler: (args) => (0, utils_1.runRegistryCommand)(args, (handoff) => {
+        (0, deprecations_1.warnDeprecatedCommand)('push:assets', 'publish assets');
+        return handoff.publishAssets((0, push_args_1.resolveCompatAssetSelection)(args, args.collection));
+    }),
+};
+exports.pushCommands = [push, pushAll, pushTokens, pushAssets];

package/dist/commands/scaffold/index.js

@@ -8,11 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const __1 = __importDefault(require("../.."));
 const scaffold_1 = require("../../cli/scaffold");
 const utils_1 = require("../utils");
 const command = {
@@ -22,7 +18,7 @@ const command = {
         return (0, utils_1.getSharedOptions)(yargs);
     },
     handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
-        const handoff = new __1.default(args.debug, args.force);
+        const handoff = (0, utils_1.createHandoff)(args);
         yield (0, scaffold_1.runScaffold)(handoff);
     }),
 };

package/dist/commands/start/index.js

@@ -8,11 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const __1 = __importDefault(require("../../"));
 const utils_1 = require("../utils");
 const command = {
     command: 'start',
@@ -21,7 +17,7 @@ const command = {
         return (0, utils_1.getSharedOptions)(yargs);
     },
     handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
-        const handoff = new __1.default(args.debug, args.force);
+        const handoff = (0, utils_1.createHandoff)(args);
         yield handoff.start();
     }),
 };

package/dist/commands/types.d.ts

@@ -1,5 +1,15 @@
 import { Arguments } from 'yargs';
 export interface SharedArgs extends Arguments {
+    /** Explicit config file, replacing the usual `handoff.config.*` lookup. */
+    config?: string;
     force?: boolean;
     debug?: boolean;
+    /**
+     * Report what would happen instead of doing it: publish uploads nothing and needs no registry URL
+     * or token, and checkout writes no workspace file. A publish dry run still runs the build, so build
+     * output on disk is refreshed; pair it with `skipBuild` to leave that alone too.
+     */
+    dryRun?: boolean;
+    /** yargs `--build` / `--no-build`; `false` publishes the existing build output. */
+    build?: boolean;
 }

package/dist/commands/utils.d.ts

@@ -1,10 +1,15 @@
 import { Argv } from 'yargs';
-import type { TransferEntityKind } from '../registry/transfer';
-/** Plural entity kinds accepted by the `publish`/`checkout` commands. */
-export declare const REGISTRY_ENTITY_KINDS: readonly ["components", "patterns", "pages", "tokens", "assets"];
-export type RegistryEntityKind = (typeof REGISTRY_ENTITY_KINDS)[number];
-/** Map the plural CLI kind to the singular wire kind used by entity publish/checkout. */
-export declare const ENTITY_WIRE_KIND: Record<'components' | 'patterns' | 'pages', TransferEntityKind>;
+import Handoff from '../';
+import { SharedArgs } from './types';
+/** The `type` argument accepted by publish/checkout: any content kind, or `all` for every kind. */
+export declare const REGISTRY_TARGET_KINDS: readonly ["components", "patterns", "pages", "tokens", "assets", "all"];
+export type RegistryTargetKind = (typeof REGISTRY_TARGET_KINDS)[number];
+export declare const createHandoff: (args: SharedArgs) => Handoff;
+/**
+ * Run a registry command against a fresh Handoff. Registry failures are the user's to act on, so they
+ * surface as one actionable line and a non-zero exit rather than a stack trace.
+ */
+export declare const runRegistryCommand: (args: SharedArgs, run: (handoff: Handoff) => Promise<unknown>) => Promise<void>;
 export declare const getSharedOptions: (yargs: Argv) => Argv<import("yargs").Omit<{}, "debug" | "config" | "force"> & import("yargs").InferredOptionTypes<{
     config: {
         alias: string;
@@ -22,3 +27,66 @@ export declare const getSharedOptions: (yargs: Argv) => Argv<import("yargs").Omi
         description: string;
     };
 }>>;
+/** Shared options plus the transfer options: publish and its compatibility aliases use these. */
+export declare const getPublishOptions: (yargs: Argv) => Argv<import("yargs").Omit<import("yargs").Omit<{}, "debug" | "config" | "force"> & import("yargs").InferredOptionTypes<{
+    config: {
+        alias: string;
+        type: "string";
+        description: string;
+    };
+    force: {
+        alias: string;
+        type: "boolean";
+        description: string;
+    };
+    debug: {
+        alias: string;
+        type: "boolean";
+        description: string;
+    };
+}>, "build" | "dry-run"> & import("yargs").InferredOptionTypes<{
+    'dry-run': {
+        type: "boolean";
+        description: string;
+    };
+    build: {
+        type: "boolean";
+        default: boolean;
+        description: string;
+    };
+}>>;
+/** Shared options plus `--dry-run`: checkout and its compatibility aliases use these. */
+export declare const getCheckoutOptions: (yargs: Argv) => Argv<import("yargs").Omit<import("yargs").Omit<{}, "debug" | "config" | "force"> & import("yargs").InferredOptionTypes<{
+    config: {
+        alias: string;
+        type: "string";
+        description: string;
+    };
+    force: {
+        alias: string;
+        type: "boolean";
+        description: string;
+    };
+    debug: {
+        alias: string;
+        type: "boolean";
+        description: string;
+    };
+}>, "dry-run"> & import("yargs").InferredOptionTypes<{
+    'dry-run': {
+        type: "boolean";
+        description: string;
+    };
+}>>;
+/**
+ * Positional `type` + variadic `id`, shared by publish, checkout, and their compatibility aliases.
+ * `choices` is always declared: yargs allows an omitted optional positional while still rejecting an
+ * unrecognized one, so the deprecated commands get the same guard as the canonical ones.
+ */
+export declare const withTargetPositionals: (yargs: Argv, verb: "publish" | "checkout") => Argv<{
+    type: "pages" | "components" | "patterns" | "assets" | "tokens" | "all";
+} & {
+    id: string[];
+}>;
+/** Dispatch one `type` argument to the matching Handoff entry point. */
+export declare const runTarget: (handoff: Handoff, type: RegistryTargetKind, ids: string[] | undefined, verb: "publish" | "checkout") => Promise<Handoff>;