Method GetApi

src/quickAddApi.ts:146–910

(
		app: App,
		plugin: QuickAdd,
		choiceExecutor: IChoiceExecutor,
	)

export class QuickAddApi {
	public static GetApi(
		app: App,
		plugin: QuickAdd,
		choiceExecutor: IChoiceExecutor,
	) {
		return {
			/**
			 * Open a single one-page modal to collect multiple inputs at once from a script.
			 * Any values already present in variables will be used as defaults and not re-asked.
			 *
			 * Example spec items:
			 * { id: "project", label: "Project", type: "text", defaultValue: "Inbox" }
			 * { id: "tags", label: "Tags", type: "suggester", options: ["#work", "#personal"], suggesterConfig: { multiSelect: true } }
			 */
			requestInputs: async (
				inputs: Array<{
					id: string;
					label?: string;
					type:
						| "text"
						| "number"
						| "textarea"
						| "dropdown"
						| "date"
						| "field-suggest"
						| "suggester"
						| "slider";
					placeholder?: string;
					defaultValue?: string;
					numericConfig?: NumericInputConfig;
					sliderConfig?: RequestSliderConfig;
					options?: string[];
					dateFormat?: string;
					description?: string;
					optional?: boolean;
					suggesterConfig?: {
						allowCustomInput?: boolean;
						caseSensitive?: boolean;
						multiSelect?: boolean;
					};
				}>,
			): Promise<Record<string, string>> => {
				// If all inputs already have values, return them immediately
				const existing: Record<string, string> = {};
				const missing: FieldRequirement[] = [];
				for (const spec of inputs) {
					const val = choiceExecutor.variables.get(spec.id) as
						| string
						| undefined;
					// Empty string is considered intentional and should not be re-asked
					if (val !== undefined && val !== null) {
						existing[spec.id] = String(val);
						continue;
					}
					const sliderConfig = sanitizeSliderConfig(spec.sliderConfig);
					const numericConfig =
						sliderConfig ?? sanitizeNumericConfig(spec.numericConfig);
					const type =