@salesforce/b2c-tooling-sdk 1.10.0 → 1.11.0

package/dist/cjs/cli/columns.js

@@ -1,128 +0,0 @@
-/*
- * Copyright (c) 2025, Salesforce, Inc.
- * SPDX-License-Identifier: Apache-2
- * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
- */
-/**
- * Shared `--columns` / `--extended` flag pair and selection helper for list
- * and search commands.
- *
- * Most list-style commands in the CLI render a {@link TableRenderer | table}
- * with a curated default set of columns and allow callers to override or
- * expand that set. This module provides the canonical implementation so each
- * command does not have to redeclare the flags or copy the selection logic.
- *
- * ## Usage
- *
- * ```typescript
- * import {Flags} from '@oclif/core';
- * import {
- *   InstanceCommand,
- *   TableRenderer,
- *   columnFlagsFor,
- *   selectColumns,
- *   type ColumnDef,
- * } from '@salesforce/b2c-tooling-sdk/cli';
- *
- * const COLUMNS: Record<string, ColumnDef<MyItem>> = { ... };
- * const DEFAULT_COLUMNS = ['id', 'name'];
- * const tableRenderer = new TableRenderer(COLUMNS);
- *
- * export default class MyList extends InstanceCommand<typeof MyList> {
- *   static flags = {
- *     ...columnFlagsFor(COLUMNS),
- *     // ...other flags
- *   };
- *
- *   async run(): Promise<MyResult> {
- *     // ...
- *     tableRenderer.render(items, selectColumns(this, tableRenderer, DEFAULT_COLUMNS));
- *   }
- * }
- * ```
- *
- * @module cli/columns
- */
-import { Flags } from '@oclif/core';
-/**
- * Returns the canonical `--columns` / `--extended` flag pair for a list-style
- * command. The `--columns` flag advertises the available column keys (taken
- * from the supplied `columns` map) so they show up in `--help` output.
- *
- * @param columns - Column definitions, used to enumerate available keys in the
- *   help text.
- * @param options - Optional overrides for the short flag characters when they
- *   conflict with command-specific flags.
- * @returns A flag definition object suitable for spreading into a command's
- *   `static flags`.
- *
- * @example
- * ```typescript
- * static flags = {
- *   ...columnFlagsFor(COLUMNS),
- *   count: Flags.integer({char: 'n', description: '...'}),
- * };
- *
- * // When -c is already used (e.g. for --category):
- * static flags = {
- *   category: Flags.string({char: 'c', description: '...'}),
- *   ...columnFlagsFor(COLUMNS, {columnsChar: false}),
- * };
- * ```
- */
-export function columnFlagsFor(columns, options = {}) {
-    const columnsChar = options.columnsChar ?? 'c';
-    const extendedChar = options.extendedChar ?? 'x';
-    return {
-        columns: Flags.string({
-            ...(columnsChar === false ? {} : { char: columnsChar }),
-            description: `Columns to display (comma-separated). Available: ${Object.keys(columns).join(', ')}`,
-        }),
-        extended: Flags.boolean({
-            ...(extendedChar === false ? {} : { char: extendedChar }),
-            description: 'Show all columns including extended fields',
-            default: false,
-        }),
-    };
-}
-/**
- * Resolves which columns a list-style command should render. Mirrors the
- * pattern duplicated across all `*List` commands:
- *
- * - If `flags.columns === 'id,name'` is provided, validate against the
- *   renderer's known keys; warn (and fall back to defaults) when no valid keys
- *   remain.
- * - If `flags.extended` is set, return every column key (including those
- *   marked `extended: true`).
- * - Otherwise, return the supplied default set.
- *
- * @typeParam T - Row type (carried through the renderer).
- * @param flags - The command's parsed `--columns` / `--extended` values. The
- *   parameter accepts the wider {@link ColumnFlags} shape, so callers can pass
- *   `this.flags` directly even when the inferred type contains additional
- *   fields.
- * @param renderer - The {@link TableRenderer} backing the table — used for
- *   key validation and to enumerate keys in extended mode.
- * @param defaults - Fallback set returned when neither flag overrides the
- *   selection.
- * @param warn - Optional warn callback invoked when `--columns` is provided
- *   but no key validates; defaults to `console.warn`.
- * @returns Ordered list of column keys to render.
- */
-export function selectColumns(flags, renderer, defaults, warn = console.warn) {
-    const { columns: columnsFlag, extended } = flags;
-    if (columnsFlag) {
-        const requested = columnsFlag.split(',').map((c) => c.trim());
-        const valid = renderer.validateColumnKeys(requested);
-        if (valid.length === 0) {
-            warn(`No valid columns specified. Available: ${renderer.getColumnKeys().join(', ')}`);
-            return defaults;
-        }
-        return valid;
-    }
-    if (extended) {
-        return renderer.getColumnKeys();
-    }
-    return defaults;
-}
-//# sourceMappingURL=columns.js.map

package/dist/cjs/cli/columns.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"columns.js","sourceRoot":"","sources":["../../../src/cli/columns.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,EAAC,KAAK,EAAkB,MAAM,aAAa,CAAC;AAqCnD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgC,EAAE,UAA8B,EAAE;IAC/F,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC;IAC/C,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,GAAG,CAAC;IACjD,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,GAAG,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,IAAI,EAAE,WAAW,EAAC,CAAC;YACrD,WAAW,EAAE,oDAAoD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACnG,CAAC;QACF,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;YACtB,GAAG,CAAC,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,IAAI,EAAE,YAAY,EAAC,CAAC;YACvD,WAAW,EAAE,4CAA4C;YACzD,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAkB,EAClB,QAA0B,EAC1B,QAAkB,EAClB,OAAe,OAAO,CAAC,IAAI;IAE3B,MAAM,EAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAC,GAAG,KAAK,CAAC;IAE/C,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,QAAQ,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,0CAA0C,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtF,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC,aAAa,EAAE,CAAC;IAClC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/cjs/cli/config.d.ts

@@ -1,159 +0,0 @@
-/**
- * CLI configuration utilities.
- *
- * This module provides configuration loading for CLI commands.
- * It uses {@link resolveConfig} internally for consistent behavior.
- *
- * @module cli/config
- */
-import type { AuthMethod } from '../auth/types.js';
-import { ALL_AUTH_METHODS } from '../auth/types.js';
-import { type NormalizedConfig, type ConfigSource, type ResolvedB2CConfig } from '../config/index.js';
-import { findDwJson } from '../config/dw-json.js';
-export type { AuthMethod };
-export { ALL_AUTH_METHODS };
-export { findDwJson };
-/**
- * Type for oclif parsed flags object.
- * Using Record<string, unknown> since flags can have various types.
- */
-export type ParsedFlags = Record<string, unknown>;
-/**
- * Extracts OAuth-related configuration from oclif flags.
- *
- * Use this to extract OAuth flags (--client-id, --client-secret, etc.)
- * from parsed oclif flags into a NormalizedConfig partial.
- *
- * @param flags - Parsed oclif flags
- * @returns Partial NormalizedConfig with OAuth fields
- *
- * @example
- * ```typescript
- * const flagConfig = extractOAuthFlags(this.flags);
- * return loadConfig(flagConfig, options);
- * ```
- */
-export declare function extractOAuthFlags(flags: ParsedFlags): Partial<NormalizedConfig>;
-/**
- * Extracts ODS-related configuration from oclif flags.
- *
- * Includes OAuth flags since ODS operations require OAuth authentication.
- *
- * @param flags - Parsed oclif flags
- * @returns Partial NormalizedConfig with ODS and OAuth fields
- */
-export declare function extractOdsFlags(flags: ParsedFlags): Partial<NormalizedConfig>;
-/**
- * Extracts B2C instance-related configuration from oclif flags.
- *
- * Includes both instance-specific flags (--server, --username, etc.)
- * and OAuth flags since instance operations often need both.
- *
- * @param flags - Parsed oclif flags
- * @returns Partial NormalizedConfig with instance and OAuth fields
- *
- * @example
- * ```typescript
- * const flagConfig = extractInstanceFlags(this.flags);
- * return loadConfig(flagConfig, options);
- * ```
- */
-export declare function extractInstanceFlags(flags: ParsedFlags): Partial<NormalizedConfig>;
-/**
- * Result of extracting MRT flags from oclif parsed flags.
- *
- * Contains both config values (for loadConfig's first argument) and
- * loading options (to spread into LoadConfigOptions).
- */
-export interface ExtractedMrtFlags {
-    /** MRT config values to pass to loadConfig's first argument */
-    config: Partial<NormalizedConfig>;
-    /** MRT loading options to spread into LoadConfigOptions */
-    options: Pick<LoadConfigOptions, 'cloudOrigin' | 'credentialsFile'>;
-}
-/**
- * Extracts MRT (Managed Runtime) configuration from oclif flags.
- *
- * Use this to extract MRT flags (--api-key, --project, --environment, --cloud-origin, --credentials-file)
- * from parsed oclif flags. Returns both config values and loading options.
- *
- * @param flags - Parsed oclif flags
- * @returns Object with `config` (NormalizedConfig partial) and `options` (LoadConfigOptions partial)
- *
- * @example
- * ```typescript
- * const mrt = extractMrtFlags(this.flags);
- * const options: LoadConfigOptions = {
- *   ...this.getBaseConfigOptions(),
- *   ...mrt.options,
- * };
- * return loadConfig(mrt.config, options);
- * ```
- */
-export declare function extractMrtFlags(flags: ParsedFlags): ExtractedMrtFlags;
-/**
- * Options for loading configuration.
- */
-export interface LoadConfigOptions {
-    /** Named instance from dw.json "configs" array */
-    instance?: string;
-    /** Explicit path to config file (skips searching if provided) */
-    configPath?: string;
-    /** Starting directory for config file search (default: current project directory) */
-    projectDirectory?: string;
-    /** @deprecated Use projectDirectory instead */
-    workingDirectory?: string;
-    /** Cloud origin for MRT ~/.mobify lookup (e.g., https://cloud-staging.mobify.com) */
-    cloudOrigin?: string;
-    /** Path to custom MRT credentials file (overrides default ~/.mobify) */
-    credentialsFile?: string;
-    /** Account Manager hostname for OAuth (passed to plugins for host-specific config) */
-    accountManagerHost?: string;
-}
-/**
- * Plugin-provided configuration sources with priority ordering.
- *
- * @deprecated Plugin config sources are now registered with the global
- * {@link globalConfigSourceRegistry} and automatically included in
- * {@link resolveConfig}. This type is retained for backwards compatibility.
- */
-export interface PluginSources {
-    /**
-     * Sources with high priority (inserted BEFORE dw.json/~/.mobify).
-     * These sources can override values from default configuration files.
-     */
-    before?: ConfigSource[];
-    /**
-     * Sources with low priority (inserted AFTER dw.json/~/.mobify).
-     * These sources fill in gaps left by default configuration files.
-     */
-    after?: ConfigSource[];
-}
-/**
- * Loads configuration with precedence: CLI flags/env vars > dw.json > ~/.mobify
- *
- * OCLIF handles environment variables automatically via flag `env` properties.
- * The flags parameter already contains resolved env var values.
- *
- * Uses {@link resolveConfig} internally for consistent behavior across CLI and SDK.
- *
- * @param flags - Configuration values from CLI flags/env vars
- * @param options - Loading options
- * @param pluginSources - @deprecated Plugin sources are now registered globally via
- *   {@link globalConfigSourceRegistry}. This parameter is retained for backwards compatibility.
- * @returns Resolved configuration with factory methods
- *
- * @example
- * ```typescript
- * // In a CLI command
- * const config = loadConfig(
- *   { hostname: this.flags.server, clientId: this.flags['client-id'] },
- *   { instance: this.flags.instance }
- * );
- *
- * if (config.hasB2CInstanceConfig()) {
- *   const instance = config.createB2CInstance();
- * }
- * ```
- */
-export declare function loadConfig(flags?: Partial<NormalizedConfig>, options?: LoadConfigOptions, pluginSources?: PluginSources): Promise<ResolvedB2CConfig>;

package/dist/cjs/cli/config.js

@@ -1,185 +0,0 @@
-import { ALL_AUTH_METHODS } from '../auth/types.js';
-import { resolveConfig } from '../config/index.js';
-import { findDwJson } from '../config/dw-json.js';
-import { getLogger } from '../logging/logger.js';
-export { ALL_AUTH_METHODS };
-export { findDwJson };
-/**
- * Extracts OAuth-related configuration from oclif flags.
- *
- * Use this to extract OAuth flags (--client-id, --client-secret, etc.)
- * from parsed oclif flags into a NormalizedConfig partial.
- *
- * @param flags - Parsed oclif flags
- * @returns Partial NormalizedConfig with OAuth fields
- *
- * @example
- * ```typescript
- * const flagConfig = extractOAuthFlags(this.flags);
- * return loadConfig(flagConfig, options);
- * ```
- */
-export function extractOAuthFlags(flags) {
-    const scopes = flags['auth-scope'];
-    // Parse auth methods from --auth-methods or --user-auth flag
-    const authMethodValues = flags['auth-methods'];
-    let authMethods;
-    if (flags['user-auth']) {
-        authMethods = ['implicit'];
-    }
-    else if (authMethodValues && authMethodValues.length > 0) {
-        const methods = authMethodValues
-            .map((s) => s.trim())
-            .filter((s) => ALL_AUTH_METHODS.includes(s));
-        authMethods = methods.length > 0 ? methods : undefined;
-    }
-    return {
-        clientId: flags['client-id'],
-        clientSecret: flags['client-secret'],
-        shortCode: flags['short-code'],
-        tenantId: flags['tenant-id'],
-        authMethods,
-        accountManagerHost: flags['account-manager-host'],
-        scopes: scopes && scopes.length > 0 ? scopes : undefined,
-        // JWT Bearer auth flags
-        jwtCertPath: flags['jwt-cert'],
-        jwtKeyPath: flags['jwt-key'],
-        jwtPassphrase: flags['jwt-passphrase'],
-    };
-}
-/**
- * Extracts ODS-related configuration from oclif flags.
- *
- * Includes OAuth flags since ODS operations require OAuth authentication.
- *
- * @param flags - Parsed oclif flags
- * @returns Partial NormalizedConfig with ODS and OAuth fields
- */
-export function extractOdsFlags(flags) {
-    return {
-        sandboxApiHost: flags['sandbox-api-host'],
-        ...extractOAuthFlags(flags),
-    };
-}
-/**
- * Extracts B2C instance-related configuration from oclif flags.
- *
- * Includes both instance-specific flags (--server, --username, etc.)
- * and OAuth flags since instance operations often need both.
- *
- * @param flags - Parsed oclif flags
- * @returns Partial NormalizedConfig with instance and OAuth fields
- *
- * @example
- * ```typescript
- * const flagConfig = extractInstanceFlags(this.flags);
- * return loadConfig(flagConfig, options);
- * ```
- */
-export function extractInstanceFlags(flags) {
-    return {
-        // Instance-specific flags
-        hostname: flags.server,
-        webdavHostname: flags['webdav-server'],
-        codeVersion: flags['code-version'],
-        cipHost: flags['cip-host'],
-        username: flags.username,
-        password: flags.password,
-        // TLS/mTLS options
-        certificate: flags.certificate,
-        certificatePassphrase: flags.passphrase,
-        selfSigned: flags.selfsigned || !flags.verify,
-        // Include OAuth flags (instance operations often need OAuth too)
-        ...extractOAuthFlags(flags),
-    };
-}
-/**
- * Extracts MRT (Managed Runtime) configuration from oclif flags.
- *
- * Use this to extract MRT flags (--api-key, --project, --environment, --cloud-origin, --credentials-file)
- * from parsed oclif flags. Returns both config values and loading options.
- *
- * @param flags - Parsed oclif flags
- * @returns Object with `config` (NormalizedConfig partial) and `options` (LoadConfigOptions partial)
- *
- * @example
- * ```typescript
- * const mrt = extractMrtFlags(this.flags);
- * const options: LoadConfigOptions = {
- *   ...this.getBaseConfigOptions(),
- *   ...mrt.options,
- * };
- * return loadConfig(mrt.config, options);
- * ```
- */
-export function extractMrtFlags(flags) {
-    const cloudOrigin = flags['cloud-origin'];
-    const credentialsFile = flags['credentials-file'];
-    return {
-        config: {
-            mrtApiKey: flags['api-key'],
-            mrtProject: flags.project,
-            mrtEnvironment: flags.environment,
-            mrtOrigin: cloudOrigin,
-        },
-        options: {
-            cloudOrigin,
-            credentialsFile,
-        },
-    };
-}
-/**
- * Loads configuration with precedence: CLI flags/env vars > dw.json > ~/.mobify
- *
- * OCLIF handles environment variables automatically via flag `env` properties.
- * The flags parameter already contains resolved env var values.
- *
- * Uses {@link resolveConfig} internally for consistent behavior across CLI and SDK.
- *
- * @param flags - Configuration values from CLI flags/env vars
- * @param options - Loading options
- * @param pluginSources - @deprecated Plugin sources are now registered globally via
- *   {@link globalConfigSourceRegistry}. This parameter is retained for backwards compatibility.
- * @returns Resolved configuration with factory methods
- *
- * @example
- * ```typescript
- * // In a CLI command
- * const config = loadConfig(
- *   { hostname: this.flags.server, clientId: this.flags['client-id'] },
- *   { instance: this.flags.instance }
- * );
- *
- * if (config.hasB2CInstanceConfig()) {
- *   const instance = config.createB2CInstance();
- * }
- * ```
- */
-export async function loadConfig(flags = {}, options = {}, pluginSources = {}) {
-    const logger = getLogger();
-    // Preserve instanceName and projectDirectory from options if not already in flags
-    const effectiveFlags = {
-        ...flags,
-        instanceName: flags.instanceName ?? options.instance,
-        projectDirectory: flags.projectDirectory ?? options.projectDirectory,
-        workingDirectory: flags.workingDirectory ?? options.workingDirectory,
-    };
-    const resolved = await resolveConfig(effectiveFlags, {
-        instance: options.instance,
-        configPath: options.configPath,
-        projectDirectory: options.projectDirectory,
-        workingDirectory: options.workingDirectory,
-        hostnameProtection: true,
-        cloudOrigin: options.cloudOrigin,
-        credentialsFile: options.credentialsFile,
-        accountManagerHost: options.accountManagerHost,
-        sourcesBefore: pluginSources.before,
-        sourcesAfter: pluginSources.after,
-    });
-    // Log warnings (at warn level so users can see configuration issues)
-    for (const warning of resolved.warnings) {
-        logger.warn({ warning }, `[Config] ${warning.message}`);
-    }
-    return resolved;
-}
-//# sourceMappingURL=config.js.map

package/dist/cjs/cli/config.js.map

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

package/dist/cjs/cli/details.d.ts

@@ -1,69 +0,0 @@
-/**
- * A single label / value pair. Tuple form is supported as a shorthand —
- * `['Login', 'user@example.com']` is equivalent to `{label: 'Login', value: 'user@example.com'}`.
- *
- * Values that are `null` or `undefined` are skipped entirely (the row is not
- * rendered). This matches the common shape of optional fields in OpenAPI
- * responses where missing data is `null`.
- */
-export type DetailField = [label: string, value: DetailValue] | DetailFieldObject;
-/**
- * Allowed scalar values for a detail field.
- */
-export type DetailValue = string | number | boolean | null | undefined;
-/**
- * Object form of a {@link DetailField} entry.
- */
-export interface DetailFieldObject {
-    label: string;
-    value: DetailValue;
-}
-/**
- * Section under a sub-heading. Renders a blank line, the heading, a separator,
- * and then either label/value `fields` or a flat list of `lines`.
- */
-export interface DetailSection {
-    /** Section heading shown above the body */
-    title: string;
-    /** Label/value rows. Mutually exclusive with `lines`. */
-    fields?: DetailField[];
-    /** Flat list of single-column rows (e.g. role names). Mutually exclusive with `fields`. */
-    lines?: string[];
-}
-/**
- * Options for {@link printFieldsBlock}.
- */
-export interface PrintFieldsBlockOptions {
-    /** Width of the label column (default 25) */
-    labelWidth?: number;
-    /** Width of the separator dashes (default 50) */
-    separatorWidth?: number;
-    /** Total terminal width (default `process.stdout.columns || 80`) */
-    termWidth?: number;
-    /** Optional sections rendered after the primary fields */
-    sections?: DetailSection[];
-}
-/**
- * Renders a "details" block to stdout: a title, a separator, then a column
- * of `label: value` rows. Optional named sections can be rendered after the
- * primary block.
- *
- * @param title - Heading rendered above the fields.
- * @param fields - Primary list of label / value rows. Rows whose value is
- *   `undefined` are skipped.
- * @param options - Rendering options including optional sub-sections.
- *
- * @example
- * ```typescript
- * printFieldsBlock('User Details', [
- *   ['Login', user.login],
- *   ['Email', user.email],
- *   ['Disabled', user.disabled?.toString()],
- * ], {
- *   sections: user.roles?.length
- *     ? [{title: 'Roles', fields: user.roles.map((r) => [r, ''] as DetailField)}]
- *     : [],
- * });
- * ```
- */
-export declare function printFieldsBlock(title: string, fields: DetailField[], options?: PrintFieldsBlockOptions): void;

package/dist/cjs/cli/details.js

@@ -1,72 +0,0 @@
-/*
- * Copyright (c) 2025, Salesforce, Inc.
- * SPDX-License-Identifier: Apache-2
- * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
- */
-/**
- * Shared "label / value" detail block printer for `*Get` style commands.
- *
- * Many commands render the same two-column "Title / dashes / label-value
- * pairs" block via cliui. This helper centralizes the layout so individual
- * commands only need to provide the title and field list.
- *
- * @module cli/details
- */
-import { ux } from '@oclif/core';
-import cliui from 'cliui';
-function normalizeField(field) {
-    return Array.isArray(field) ? { label: field[0], value: field[1] } : field;
-}
-function renderFields(ui, fields, labelWidth) {
-    for (const raw of fields) {
-        const { label, value } = normalizeField(raw);
-        if (value === undefined || value === null)
-            continue;
-        ui.div({ text: `${label}:`, width: labelWidth, padding: [0, 2, 0, 0] }, { text: String(value), padding: [0, 0, 0, 0] });
-    }
-}
-/**
- * Renders a "details" block to stdout: a title, a separator, then a column
- * of `label: value` rows. Optional named sections can be rendered after the
- * primary block.
- *
- * @param title - Heading rendered above the fields.
- * @param fields - Primary list of label / value rows. Rows whose value is
- *   `undefined` are skipped.
- * @param options - Rendering options including optional sub-sections.
- *
- * @example
- * ```typescript
- * printFieldsBlock('User Details', [
- *   ['Login', user.login],
- *   ['Email', user.email],
- *   ['Disabled', user.disabled?.toString()],
- * ], {
- *   sections: user.roles?.length
- *     ? [{title: 'Roles', fields: user.roles.map((r) => [r, ''] as DetailField)}]
- *     : [],
- * });
- * ```
- */
-export function printFieldsBlock(title, fields, options = {}) {
-    const labelWidth = options.labelWidth ?? 25;
-    const separatorWidth = options.separatorWidth ?? 50;
-    const termWidth = options.termWidth ?? process.stdout.columns ?? 80;
-    const ui = cliui({ width: termWidth });
-    ui.div({ text: title, padding: [1, 0, 0, 0] });
-    ui.div({ text: '─'.repeat(separatorWidth), padding: [0, 0, 0, 0] });
-    renderFields(ui, fields, labelWidth);
-    for (const section of options.sections ?? []) {
-        ui.div({ text: '', padding: [1, 0, 0, 0] });
-        ui.div({ text: section.title, padding: [0, 0, 0, 0] });
-        ui.div({ text: '─'.repeat(separatorWidth), padding: [0, 0, 0, 0] });
-        if (section.fields) {
-            renderFields(ui, section.fields, labelWidth);
-        }
-        for (const line of section.lines ?? []) {
-            ui.div({ text: line, padding: [0, 0, 0, 0] });
-        }
-    }
-    ux.stdout(ui.toString());
-}
-//# sourceMappingURL=details.js.map

package/dist/cjs/cli/details.js.map

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