import { type IOFormat } from '../io-util.js';
import { type TableFieldDefinition } from '../table-generator.js';
import { type Naming, type Sorting } from './io-defs.js';
import { type BuildOutputFormatterFlags } from './output-builder.js';
import { type SmartThingsCommand } from './smartthings-command.js';
export type TableCommonOutputProducer<O extends object> = {
    tableFieldDefinitions: TableFieldDefinition<O>[];
};
export type CustomCommonOutputProducer<O extends object> = {
    buildTableOutput(data: O): string;
};
export type CommonOutputProducer<O extends object> = TableCommonOutputProducer<O> | CustomCommonOutputProducer<O>;
export type TableCommonListOutputProducer<L extends object> = Sorting<L> & {
    listTableFieldDefinitions: TableFieldDefinition<L>[];
};
export type CustomCommonListOutputProducer<L extends object> = Sorting<L> & {
    buildListTableOutput(data: L[]): string;
};
export type CommonListOutputProducer<L extends object> = Sorting<L> | TableCommonListOutputProducer<L> | CustomCommonListOutputProducer<L>;
export type FormatAndWriteItemFlags = BuildOutputFormatterFlags;
export declare const formatAndWriteItemBuilder: <T extends import("./smartthings-command.js").SmartThingsCommandFlags>(yargs: import("yargs").Argv<T>) => import("yargs").Argv<T & BuildOutputFormatterFlags>;
export type FormatAndWriteItemConfig<O extends object> = CommonOutputProducer<O>;
/**
 * Format and output the given item.
 *
 * @param command The command outputting the list.
 * @param config Configuration for how to write the list. This must include either a list of
 *   table field definitions called `tableFieldDefinitions` or a function to write common-formatted
 *   output called `buildTableOutput`.
 * @param item The item to be written.
 * @param defaultIOFormat The default IOFormat to use. This should be used when a command also takes
 *   input so the output can default to the input format.
 */
export declare function formatAndWriteItem<O extends object>(command: SmartThingsCommand<FormatAndWriteItemFlags>, config: FormatAndWriteItemConfig<O>, item: O, defaultIOFormat?: IOFormat): Promise<void>;
export type FormatAndWriteListFlags = BuildOutputFormatterFlags;
export declare const formatAndWriteListBuilder: <T extends import("./smartthings-command.js").SmartThingsCommandFlags>(yargs: import("yargs").Argv<T>) => import("yargs").Argv<T & BuildOutputFormatterFlags>;
export type FormatAndWriteListConfig<L extends object> = CommonListOutputProducer<L> & Naming & Sorting<L>;
export type FormatAndWriteListOptions = {
    /**
     * Set this to true if you want to include an index in the output. Default is false.
     */
    includeIndex?: boolean;
    /**
     * Set this to true if you're displaying this to the user for a question. This will force
     * output to stdout and skip the JSON/YAML formatters. Default is false.
     */
    forUserQuery?: boolean;
    /**
     * A custom error message to display when no items are found.
     */
    customNotFoundMessage?: string;
};
/**
 * Format and output the given list.
 *
 * @param command The command outputting the list.
 * @param config Configuration for how to write the list. This must include either a list of
 *   table field definitions called `listTableFieldDefinitions` or a function to write
 *   common-formatted output called `buildTableOutput`.
 * @param list The items to be written.
 * @param options See FormatAndWriteListOptions for details.
 */
export declare function formatAndWriteList<L extends object>(command: SmartThingsCommand<FormatAndWriteListFlags>, config: FormatAndWriteListConfig<L>, list: L[], options?: FormatAndWriteListOptions): Promise<void>;
//# sourceMappingURL=format.d.ts.map