handoff-app 2.0.0-6 → 2.0.0-8

package/dist/cli/auth/store.d.ts

@@ -5,6 +5,8 @@ export interface CliAuth {
     /** Epoch milliseconds after which the token must not be used. */
     expiresAtMs: number;
 }
+/** Name a login is saved under when no profile is selected. */
+export declare const DEFAULT_LOGIN_PROFILE = "default";
 /**
  * Canonicalize a registry URL for both HTTP requests and exact credential matching.
  * Base paths are retained; query strings, fragments, credentials, and trailing slashes are not.
@@ -17,13 +19,20 @@ export declare const normalizeRegistryUrl: (value: string) => string;
  */
 export declare const assertRegistryOriginUrl: (baseUrl: string, candidate: string) => string;
 export declare const cliAuthFilePath: (workingPath: string) => string;
-/** Invalid or partial credential files are treated as unauthenticated. */
-export declare const readCliAuth: (workingPath: string) => Promise<CliAuth | null>;
+/** Every saved login, keyed by profile name. A missing or unreadable file reads as no logins. */
+export declare const readCliLogins: (workingPath: string) => Promise<Record<string, CliAuth>>;
+/** The login saved under one profile name. Never falls back to another profile. */
+export declare const readCliAuth: (workingPath: string, profile?: string) => Promise<CliAuth | null>;
 /**
- * Atomically replace the credential file. Restrictive permissions are best-effort on platforms
- * whose filesystems do not support POSIX modes.
+ * Profile names that have a saved login. Synchronous because config loading is, and the loader needs
+ * these names to decide whether a selected profile resolves.
  */
-export declare const writeCliAuth: (workingPath: string, auth: CliAuth) => Promise<void>;
-export declare const clearCliAuth: (workingPath: string) => Promise<void>;
+export declare const loginProfileNames: (workingPath: string) => string[];
+/** Save the login for one profile and leave the other profiles in place. */
+export declare const writeCliAuth: (workingPath: string, auth: CliAuth, profile?: string) => Promise<void>;
+/** Remove the login for one profile, and the file itself once no login is left. */
+export declare const clearCliAuth: (workingPath: string, profile?: string) => Promise<void>;
+/** Remove every saved login. */
+export declare const clearAllCliAuth: (workingPath: string) => Promise<void>;
 export declare const cliAuthMatchesRegistry: (auth: CliAuth | null, remoteUrl: string) => boolean;
 export declare const cliAuthTokenIsValid: (auth: CliAuth | null, skewMs?: number) => boolean;

package/dist/cli/auth/store.js

@@ -12,9 +12,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cliAuthTokenIsValid = exports.cliAuthMatchesRegistry = exports.clearCliAuth = exports.writeCliAuth = exports.readCliAuth = exports.cliAuthFilePath = exports.assertRegistryOriginUrl = exports.normalizeRegistryUrl = void 0;
+exports.cliAuthTokenIsValid = exports.cliAuthMatchesRegistry = exports.clearAllCliAuth = exports.clearCliAuth = exports.writeCliAuth = exports.loginProfileNames = exports.readCliAuth = exports.readCliLogins = exports.cliAuthFilePath = exports.assertRegistryOriginUrl = exports.normalizeRegistryUrl = exports.DEFAULT_LOGIN_PROFILE = void 0;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
+/** Name a login is saved under when no profile is selected. */
+exports.DEFAULT_LOGIN_PROFILE = 'default';
 const AUTH_DIRECTORY = '.handoff';
 const AUTH_FILE = 'cli-auth.json';
 /**
@@ -63,38 +65,71 @@ const assertRegistryOriginUrl = (baseUrl, candidate) => {
 exports.assertRegistryOriginUrl = assertRegistryOriginUrl;
 const cliAuthFilePath = (workingPath) => path_1.default.resolve(workingPath, AUTH_DIRECTORY, AUTH_FILE);
 exports.cliAuthFilePath = cliAuthFilePath;
-const isCliAuth = (value) => {
+/** An invalid or partial entry reads as no login, so one bad entry cannot hide the others. */
+const toCliAuth = (value) => {
     if (!value || typeof value !== 'object')
-        return false;
+        return null;
     const auth = value;
-    return (typeof auth.remoteUrl === 'string' &&
-        typeof auth.accessToken === 'string' &&
-        auth.accessToken.length > 0 &&
-        typeof auth.expiresAtMs === 'number' &&
-        Number.isFinite(auth.expiresAtMs));
-};
-/** Invalid or partial credential files are treated as unauthenticated. */
-const readCliAuth = (workingPath) => __awaiter(void 0, void 0, void 0, function* () {
+    if (typeof auth.remoteUrl !== 'string')
+        return null;
+    if (typeof auth.accessToken !== 'string' || auth.accessToken.length === 0)
+        return null;
+    if (typeof auth.expiresAtMs !== 'number' || !Number.isFinite(auth.expiresAtMs))
+        return null;
     try {
-        const value = (yield fs_extra_1.default.readJson((0, exports.cliAuthFilePath)(workingPath)));
-        if (!isCliAuth(value))
-            return null;
-        return Object.assign(Object.assign({}, value), { remoteUrl: (0, exports.normalizeRegistryUrl)(value.remoteUrl) });
+        return { remoteUrl: (0, exports.normalizeRegistryUrl)(auth.remoteUrl), accessToken: auth.accessToken, expiresAtMs: auth.expiresAtMs };
     }
     catch (_a) {
         return null;
     }
+};
+const toLogins = (value) => {
+    const logins = value === null || value === void 0 ? void 0 : value.logins;
+    if (!logins || typeof logins !== 'object')
+        return {};
+    const result = {};
+    for (const [profile, entry] of Object.entries(logins)) {
+        const auth = toCliAuth(entry);
+        if (auth)
+            result[profile] = auth;
+    }
+    return result;
+};
+/** Every saved login, keyed by profile name. A missing or unreadable file reads as no logins. */
+const readCliLogins = (workingPath) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        return toLogins((yield fs_extra_1.default.readJson((0, exports.cliAuthFilePath)(workingPath))));
+    }
+    catch (_a) {
+        return {};
+    }
 });
+exports.readCliLogins = readCliLogins;
+/** The login saved under one profile name. Never falls back to another profile. */
+const readCliAuth = (workingPath_1, ...args_1) => __awaiter(void 0, [workingPath_1, ...args_1], void 0, function* (workingPath, profile = exports.DEFAULT_LOGIN_PROFILE) { var _a; return (_a = (yield (0, exports.readCliLogins)(workingPath))[profile]) !== null && _a !== void 0 ? _a : null; });
 exports.readCliAuth = readCliAuth;
+/**
+ * Profile names that have a saved login. Synchronous because config loading is, and the loader needs
+ * these names to decide whether a selected profile resolves.
+ */
+const loginProfileNames = (workingPath) => {
+    try {
+        return Object.keys(toLogins(fs_extra_1.default.readJsonSync((0, exports.cliAuthFilePath)(workingPath))));
+    }
+    catch (_a) {
+        return [];
+    }
+};
+exports.loginProfileNames = loginProfileNames;
 /**
  * Atomically replace the credential file. Restrictive permissions are best-effort on platforms
  * whose filesystems do not support POSIX modes.
  */
-const writeCliAuth = (workingPath, auth) => __awaiter(void 0, void 0, void 0, function* () {
+const writeCliLogins = (workingPath, logins) => __awaiter(void 0, void 0, void 0, function* () {
     const filePath = (0, exports.cliAuthFilePath)(workingPath);
     const directory = path_1.default.dirname(filePath);
     const temporaryPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
-    const value = Object.assign(Object.assign({}, auth), { remoteUrl: (0, exports.normalizeRegistryUrl)(auth.remoteUrl) });
+    const value = { logins };
     yield fs_extra_1.default.ensureDir(directory, 0o700);
     try {
         yield fs_extra_1.default.chmod(directory, 0o700);
@@ -123,14 +158,32 @@ const writeCliAuth = (workingPath, auth) => __awaiter(void 0, void 0, void 0, fu
         throw error;
     }
 });
+/** Save the login for one profile and leave the other profiles in place. */
+const writeCliAuth = (workingPath_1, auth_1, ...args_1) => __awaiter(void 0, [workingPath_1, auth_1, ...args_1], void 0, function* (workingPath, auth, profile = exports.DEFAULT_LOGIN_PROFILE) {
+    const logins = yield (0, exports.readCliLogins)(workingPath);
+    logins[profile] = Object.assign(Object.assign({}, auth), { remoteUrl: (0, exports.normalizeRegistryUrl)(auth.remoteUrl) });
+    yield writeCliLogins(workingPath, logins);
+});
 exports.writeCliAuth = writeCliAuth;
-const clearCliAuth = (workingPath) => __awaiter(void 0, void 0, void 0, function* () {
+/** Remove the login for one profile, and the file itself once no login is left. */
+const clearCliAuth = (workingPath_1, ...args_1) => __awaiter(void 0, [workingPath_1, ...args_1], void 0, function* (workingPath, profile = exports.DEFAULT_LOGIN_PROFILE) {
+    const logins = yield (0, exports.readCliLogins)(workingPath);
+    delete logins[profile];
+    if (Object.keys(logins).length === 0) {
+        yield (0, exports.clearAllCliAuth)(workingPath);
+        return;
+    }
+    yield writeCliLogins(workingPath, logins);
+});
+exports.clearCliAuth = clearCliAuth;
+/** Remove every saved login. */
+const clearAllCliAuth = (workingPath) => __awaiter(void 0, void 0, void 0, function* () {
     const filePath = (0, exports.cliAuthFilePath)(workingPath);
     if (yield fs_extra_1.default.pathExists(filePath)) {
         yield fs_extra_1.default.remove(filePath);
     }
 });
-exports.clearCliAuth = clearCliAuth;
+exports.clearAllCliAuth = clearAllCliAuth;
 const cliAuthMatchesRegistry = (auth, remoteUrl) => {
     if (!auth)
         return false;

package/dist/cli/make.d.ts

@@ -1,9 +1,4 @@
 import Handoff from '../index';
-/**
- * Make a new exportable component
- * @param handoff
- */
-export declare const makeTemplate: (handoff: Handoff, component: string, state: string) => Promise<Handoff>;
 /**
  * Make a new docs page
  * @param handoff

package/dist/cli/make.js

@@ -35,54 +35,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeComponent = exports.makePage = exports.makeTemplate = void 0;
+exports.makeComponent = exports.makePage = void 0;
+const catalog_include_1 = require("../config/catalog-include");
+const runtime_1 = require("../config/runtime");
 const p = __importStar(require("@clack/prompts"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const logger_1 = require("../utils/logger");
-/**
- * Make a new exportable component
- * @param handoff
- */
-const makeTemplate = (handoff, component, state) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, _b;
-    if (!((_b = (_a = handoff === null || handoff === void 0 ? void 0 : handoff.runtimeConfig) === null || _a === void 0 ? void 0 : _a.entries) === null || _b === void 0 ? void 0 : _b.templates)) {
-        logger_1.Logger.error(`Runtime config does not specify entry for templates.`);
-        return;
-    }
-    if (!component) {
-        logger_1.Logger.error(`Template component must be set`);
-        return;
-    }
-    if (!state) {
-        state = 'default';
-    }
-    if (!/^[a-z0-9]+$/i.test(component)) {
-        logger_1.Logger.error(`Template component must be alphanumeric and may contain dashes or underscores`);
-        return;
-    }
-    if (!/^[a-z0-9]+$/i.test(state)) {
-        logger_1.Logger.error(`Template state must be alphanumeric and may contain dashes or underscores`);
-        return;
-    }
-    const workingPath = path_1.default.resolve(handoff.runtimeConfig.entries.templates, component);
-    if (!fs_extra_1.default.existsSync(workingPath)) {
-        fs_extra_1.default.mkdirSync(workingPath, { recursive: true });
-    }
-    const target = path_1.default.resolve(workingPath, `${state}.html`);
-    if (fs_extra_1.default.existsSync(target)) {
-        if (!handoff.force) {
-            logger_1.Logger.warn(`'${state}' already exists as custom template.  Use the --force flag revert it to default.`);
-            return;
-        }
-    }
-    const templatePath = path_1.default.resolve(path_1.default.join(handoff.modulePath, 'config/templates', 'template.html'));
-    const template = fs_extra_1.default.readFileSync(templatePath, 'utf8');
-    fs_extra_1.default.writeFileSync(target, template);
-    logger_1.Logger.success(`New template ${state}.html was created in ${workingPath}`);
-    return handoff;
-});
-exports.makeTemplate = makeTemplate;
 /**
  * Make a new docs page
  * @param handoff
@@ -136,22 +95,15 @@ exports.makePage = makePage;
  */
 const DEFAULT_COMPONENTS_DIR = 'components';
 const makeComponent = (handoff, name) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, _b, _c;
+    var _a, _b;
     if (!name) {
         logger_1.Logger.error(`Component name must be set`);
         return;
     }
     name = name.replace('.html', '');
-    let componentsRoot;
-    if ((_c = (_b = (_a = handoff.config) === null || _a === void 0 ? void 0 : _a.entries) === null || _b === void 0 ? void 0 : _b.components) === null || _c === void 0 ? void 0 : _c.length) {
-        componentsRoot = path_1.default.resolve(handoff.workingPath, handoff.config.entries.components[0]);
-    }
-    else {
-        componentsRoot = path_1.default.resolve(handoff.workingPath, DEFAULT_COMPONENTS_DIR);
-        logger_1.Logger.warn(`No entries.components configured in handoff.config.*. ` +
-            `Scaffolding into "${DEFAULT_COMPONENTS_DIR}/". ` +
-            `Add this path to entries.components in your config so the build picks it up.`);
-    }
+    const configuredRoot = (_b = (_a = handoff.config.catalog) === null || _a === void 0 ? void 0 : _a.include) === null || _b === void 0 ? void 0 : _b[0];
+    const root = path_1.default.resolve(handoff.workingPath, configuredRoot !== null && configuredRoot !== void 0 ? configuredRoot : DEFAULT_COMPONENTS_DIR);
+    const componentsRoot = (0, runtime_1.isComponentDirectory)(root) ? path_1.default.dirname(root) : root;
     let workingPath = path_1.default.resolve(componentsRoot, name);
     if (!fs_extra_1.default.existsSync(workingPath)) {
         fs_extra_1.default.mkdirSync(workingPath, { recursive: true });
@@ -188,34 +140,37 @@ const makeComponent = (handoff, name) => __awaiter(void 0, void 0, void 0, funct
         const scssTemplate = fs_extra_1.default.readFileSync(scssPath, 'utf8');
         fs_extra_1.default.writeFileSync(path_1.default.resolve(workingPath, `${name}.scss`), scssTemplate);
     }
-    const declarationEntries = [`template: './${name}.hbs'`];
+    // `implementation` names the template, so `entries` carries only supporting files.
+    const declarationEntries = [];
     if (writeJSFile === true) {
         declarationEntries.push(`js: './${name}.js'`);
     }
     if (writeSassFile === true) {
         declarationEntries.push(`scss: './${name}.scss'`);
     }
-    const declarationContent = `const { defineHandlebarsComponent } = require('handoff-app');
+    const entriesBlock = declarationEntries.length ? `\n  entries: {\n    ${declarationEntries.join(',\n    ')}\n  },` : '';
+    const declarationContent = `const { defineCatalogItem } = require('handoff-app/handlebars');
 
-module.exports = defineHandlebarsComponent({
+exports.default = defineCatalogItem({
   id: '${name}',
   name: '',
   description: '',
   group: '',
   type: 'element',
-  entries: {
-    ${declarationEntries.join(',\n    ')}
-  },
-  previews: {
-    default: {
-      title: 'Default',
-      args: {}
-    }
-  }
+  implementation: './${name}.hbs',${entriesBlock}
 });
+
+exports.Default = {
+  args: {},
+};
 `;
     fs_extra_1.default.writeFileSync(path_1.default.resolve(workingPath, `${name}.handoff.js`), declarationContent);
     logger_1.Logger.success(`New component declaration ${name}.handoff.js was created in ${workingPath}`);
+    if (!(0, catalog_include_1.isIncluded)(handoff, workingPath)) {
+        const result = yield (0, catalog_include_1.addToCatalog)(handoff, [workingPath]);
+        if (result.status === 'unsupported')
+            logger_1.Logger.warn(`Add ${result.pending.join(', ')} to catalog.include in handoff.config.`);
+    }
     return handoff;
 });
 exports.makeComponent = makeComponent;

package/dist/cli/scaffold.js

@@ -40,7 +40,7 @@ const p = __importStar(require("@clack/prompts"));
 const chalk_1 = __importDefault(require("chalk"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
-const entries_1 = require("../config/entries");
+const catalog_include_1 = require("../config/catalog-include");
 // Constants
 const COMPONENTS_DIR = 'components';
 const DEFAULT_GROUPS = [
@@ -63,49 +63,41 @@ const toTitleCase = (str) => {
  * Generate the component JS stub content
  */
 const generateComponentStub = (config) => {
+    // `implementation` names the source, so `entries` carries only supporting files.
     const entriesLines = [];
-    if (config.generateTsx) {
-        entriesLines.push(`    component: './${config.name}.tsx',`);
-    }
-    else {
-        entriesLines.push(`    template: './${config.name}.hbs',`);
-    }
     if (config.generateScss) {
         entriesLines.push(`    scss: './${config.name}.scss',`);
     }
+    const entriesBlock = entriesLines.length ? `\n  entries: {\n${entriesLines.join('\n')}\n  },` : '';
     const commonMetadata = `  id: "${config.name}",
   name: "${config.title}",
   description: "${config.description}",
   group: "${config.group}",
   type: "element",
   figmaComponentId: "${config.name}",`;
+    const previewExport = `
+exports.Default = {
+  args: {},
+};
+`;
     if (config.generateTsx) {
-        return `const { defineReactComponent } = require('handoff-app');
-const ${toTitleCase(config.name).replace(/\s/g, '')} = require('./${config.name}').default;
+        const identifier = toTitleCase(config.name).replace(/\s/g, '');
+        return `const { defineCatalogItem } = require('handoff-app/react');
+const ${identifier} = require('./${config.name}').default;
 
-module.exports = defineReactComponent(${toTitleCase(config.name).replace(/\s/g, '')}, {
+exports.default = defineCatalogItem({
 ${commonMetadata}
-  entries: {
-${entriesLines.join('\n')}
-  },
-  previews: {
-    default: { title: "Default", args: {} }
-  }
+  implementation: ${identifier},${entriesBlock}
 });
-`;
+${previewExport}`;
     }
-    return `const { defineHandlebarsComponent } = require('handoff-app');
+    return `const { defineCatalogItem } = require('handoff-app/handlebars');
 
-module.exports = defineHandlebarsComponent({
+exports.default = defineCatalogItem({
 ${commonMetadata}
-  entries: {
-${entriesLines.join('\n')}
-  },
-  previews: {
-    default: { title: "Default", args: {} }
-  }
+  implementation: './${config.name}.hbs',${entriesBlock}
 });
-`;
+${previewExport}`;
 };
 /**
  * Generate a basic React component stub with variant props
@@ -179,8 +171,8 @@ const getFigmaComponents = (handoff) => __awaiter(void 0, void 0, void 0, functi
  * Get list of registered component IDs from runtime config
  */
 const getRegisteredComponentIds = (handoff) => {
-    var _a, _b;
-    const components = ((_b = (_a = handoff.runtimeConfig) === null || _a === void 0 ? void 0 : _a.entries) === null || _b === void 0 ? void 0 : _b.components) || {};
+    var _a;
+    const components = ((_a = handoff.runtimeConfig) === null || _a === void 0 ? void 0 : _a.entities.components) || {};
     return Object.keys(components);
 };
 /**
@@ -385,22 +377,22 @@ const runScaffold = (handoff) => __awaiter(void 0, void 0, void 0, function* ()
         console.log(chalk_1.default.dim(`  ${relativePath}`));
     }
     // Update config if requested. Components already covered by a collection directory auto-load,
-    // so we only write the uncovered ones into entries.components.
+    // so we only write the unlisted ones into catalog.include.
     if (updateConfig) {
         const componentDirs = componentNames.map((name) => path_1.default.resolve(handoff.workingPath, COMPONENTS_DIR, name));
-        const uncovered = componentDirs.filter((dir) => !(0, entries_1.isEntryCovered)(handoff, 'components', dir));
-        if (uncovered.length === 0) {
+        const unlisted = componentDirs.filter((dir) => !(0, catalog_include_1.isIncluded)(handoff, dir));
+        if (unlisted.length === 0) {
             p.log.info(`Config already covers these components - they'll auto-load`);
         }
         else {
-            const result = yield (0, entries_1.writeEntries)(handoff, 'components', uncovered);
+            const result = yield (0, catalog_include_1.addToCatalog)(handoff, unlisted);
             if (result.status === 'added') {
                 const configFileName = result.configPath ? path_1.default.basename(result.configPath) : 'handoff.config.json';
                 p.log.success(`Updated ${configFileName} with component paths`);
             }
             else {
                 const where = result.configPath ? path_1.default.relative(handoff.workingPath, result.configPath) : 'handoff.config';
-                p.log.warn(`Could not automatically update ${where}. Please manually add these paths to entries.components:`);
+                p.log.warn(`Could not automatically update ${where}. Please manually add these paths to catalog.include:`);
                 for (const rel of result.pending) {
                     console.log(chalk_1.default.yellow(`  '${rel}'`));
                 }

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

@@ -6,10 +6,13 @@ export interface CheckoutArgs extends SharedArgs {
     id?: string[];
 }
 /**
- * `handoff-app checkout <components|patterns|pages> [id...]` pulls entities from the connected
- * registry into this workspace, writing their source files in standard authoring form and
- * synthesizing local declarations. Pass ids to pull only those entities, or omit them for every
- * published entity of that kind.
+ * `handoff-app checkout <catalog|pages> [id...]` pulls entities from the connected registry into this
+ * workspace, writing their source files in standard authoring form and synthesizing local
+ * declarations. Pass ids to pull only those entities, or omit them for every published entity of that
+ * kind.
+ *
+ * `catalog` covers every published catalog item. The lane an item was published into is looked up in
+ * the registry, so an id is enough and no lane is named here.
  *
  * `handoff-app checkout tokens [setId...]` pulls every published token set, or only the named ones,
  * reconstructing `tokens.json` and restoring the generated token files.

package/dist/commands/checkout/index.js

@@ -2,10 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const utils_1 = require("../utils");
 /**
- * `handoff-app checkout <components|patterns|pages> [id...]` pulls entities from the connected
- * registry into this workspace, writing their source files in standard authoring form and
- * synthesizing local declarations. Pass ids to pull only those entities, or omit them for every
- * published entity of that kind.
+ * `handoff-app checkout <catalog|pages> [id...]` pulls entities from the connected registry into this
+ * workspace, writing their source files in standard authoring form and synthesizing local
+ * declarations. Pass ids to pull only those entities, or omit them for every published entity of that
+ * kind.
+ *
+ * `catalog` covers every published catalog item. The lane an item was published into is looked up in
+ * the registry, so an id is enough and no lane is named here.
  *
  * `handoff-app checkout tokens [setId...]` pulls every published token set, or only the named ones,
  * reconstructing `tokens.json` and restoring the generated token files.
@@ -21,8 +24,8 @@ const utils_1 = require("../utils");
  */
 const command = {
     command: 'checkout <type> [id..]',
-    describe: 'Pull components, patterns, pages, design tokens, or assets from the connected registry into this workspace',
-    builder: (yargs) => (0, utils_1.withTargetPositionals)((0, utils_1.getCheckoutOptions)(yargs), 'checkout'),
+    describe: 'Pull catalog items, pages, design tokens, or assets from the connected registry into this workspace',
+    builder: (yargs) => (0, utils_1.withTargetPositionals)((0, utils_1.getCheckoutOptions)(yargs), 'checkout', utils_1.REGISTRY_TARGET_KINDS),
     handler: (args) => (0, utils_1.runRegistryCommand)(args, (handoff) => (0, utils_1.runTarget)(handoff, args.type, args.id, 'checkout')),
 };
 exports.default = command;

package/dist/commands/compat/push-args.d.ts

@@ -7,11 +7,11 @@
  * {@link Handoff.publishAll}, so no orchestration lives here.
  */
 import { type RegistryEntityKind } from '../../registry/content-kinds';
-import type { RegistryTargetKind } from '../utils';
+import type { CompatTargetKind } from '../utils';
 import type { ContentTarget } from '../../index';
 /** The documented `push` / `pull` arguments read here. */
 export interface CompatTargetArgs {
-    type?: RegistryTargetKind;
+    type?: CompatTargetKind;
     id?: string[];
     components?: string[];
     patterns?: string[];

package/dist/commands/index.js

@@ -19,7 +19,6 @@ const login_1 = __importDefault(require("./login"));
 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");
@@ -42,7 +41,6 @@ exports.commands = [
     logout_1.default,
     page_1.default,
     component_1.default,
-    template_1.default,
     publish_1.default,
     pull_1.default,
     ...push_1.pushCommands,

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

@@ -4,5 +4,10 @@ export interface LoginArgs extends SharedArgs {
     url?: string;
     browser?: boolean;
 }
+/**
+ * Saves one registry credential per profile, so a workspace can hold a login for every registry it
+ * publishes to. The name is independent of the config profiles, and `login` is the one command that
+ * accepts a profile nothing else knows yet.
+ */
 declare const command: CommandModule<{}, LoginArgs>;
 export default command;

package/dist/commands/login/index.js

@@ -14,6 +14,11 @@ const store_1 = require("../../cli/auth/store");
 const connection_1 = require("../../registry/connection");
 const logger_1 = require("../../utils/logger");
 const utils_1 = require("../utils");
+/**
+ * Saves one registry credential per profile, so a workspace can hold a login for every registry it
+ * publishes to. The name is independent of the config profiles, and `login` is the one command that
+ * accepts a profile nothing else knows yet.
+ */
 const command = {
     command: 'login',
     describe: 'Sign in to a registry using browser device authorization',
@@ -28,17 +33,24 @@ const command = {
         describe: 'Open the approval URL in the default browser (disable with --no-browser)',
     }),
     handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a;
-        const handoff = (0, utils_1.createHandoff)(args);
+        var _a, _b;
+        const handoff = (0, utils_1.createHandoff)(args, { profileWithoutConfig: 'any' });
+        const profile = (_a = handoff.getProfile()) !== null && _a !== void 0 ? _a : store_1.DEFAULT_LOGIN_PROFILE;
         try {
             const configured = (0, connection_1.resolveRegistryConnection)(handoff.config);
-            const remoteUrl = ((_a = args.url) === null || _a === void 0 ? void 0 : _a.trim()) || configured.url;
+            // Resolved in the order publish and checkout use, so a login always targets the registry those
+            // commands would reach.
+            const saved = yield (0, store_1.readCliAuth)(handoff.workingPath, profile);
+            const remoteUrl = ((_b = args.url) === null || _b === void 0 ? void 0 : _b.trim()) || configured.url || (saved === null || saved === void 0 ? void 0 : saved.remoteUrl);
             if (!remoteUrl) {
                 throw new Error(`Pass --url <registry-url>, configure runtime.registryConnection.url, or set "${configured.urlEnv}".`);
             }
-            yield (0, device_1.loginWithDevice)(handoff.workingPath, remoteUrl, { openBrowser: args.browser !== false });
-            logger_1.Logger.success(`Logged in. Credentials saved to ${(0, store_1.cliAuthFilePath)(handoff.workingPath)}.`);
-            logger_1.Logger.info('Publish and checkout commands will use this login for the matching registry URL.');
+            yield (0, device_1.loginWithDevice)(handoff.workingPath, remoteUrl, { openBrowser: args.browser !== false, profile });
+            const named = profile === store_1.DEFAULT_LOGIN_PROFILE ? '' : ` under profile "${profile}"`;
+            logger_1.Logger.success(`Logged in. Credentials saved to ${(0, store_1.cliAuthFilePath)(handoff.workingPath)}${named}.`);
+            logger_1.Logger.info(profile === store_1.DEFAULT_LOGIN_PROFILE
+                ? 'Publish and checkout commands will use this login for the matching registry URL.'
+                : `Publish and checkout commands will use this login when they run with --profile ${profile}.`);
         }
         catch (error) {
             logger_1.Logger.error(error instanceof Error ? error.message : String(error));

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

@@ -2,6 +2,11 @@ import { CommandModule } from 'yargs';
 import { SharedArgs } from '../types';
 export interface LogoutArgs extends SharedArgs {
     url?: string;
+    all?: boolean;
 }
+/**
+ * `handoff-app logout` removes the login of the selected profile, leaving every other profile signed
+ * in. `--all` removes them all.
+ */
 declare const command: CommandModule<{}, LogoutArgs>;
 export default command;