/** * Built-in CSV delimiter presets keyed by preset id. * * @alpha */ export declare const CSV_DELIMITER_PRESETS: { readonly comma: { readonly delimiter: ","; readonly previewSymbol: ","; }; readonly semicolon: { readonly delimiter: ";"; readonly previewSymbol: ";"; }; readonly pipe: { readonly delimiter: "|"; readonly previewSymbol: "|"; }; readonly tab: { readonly delimiter: "\t"; readonly previewSymbol: "⇥"; }; }; /** * Identifier of the default CSV delimiter preset. * * @alpha */ export declare const DEFAULT_CSV_DELIMITER_PRESET_ID = "comma"; /** * The default CSV delimiter character (comma). * * @alpha */ export declare const DEFAULT_CSV_DELIMITER: ","; /** * Identifier of a built-in CSV delimiter preset. * * @alpha */ export type CsvDelimiterPresetId = keyof typeof CSV_DELIMITER_PRESETS; /** * Identifier of a CSV delimiter preset, or "custom" when the user provides their own character. * * @alpha */ export type CsvDelimiterPreset = CsvDelimiterPresetId | "custom"; /** * Validation error codes returned by {@link getCsvDelimiterValidationError}. * * - `"singleCharacter"` — the value is empty or longer than one character. * - `"unsupportedCharacter"` — the character is not in the allowed set. * * @alpha */ export type CsvDelimiterValidationError = "singleCharacter" | "unsupportedCharacter"; /** * Validates a custom delimiter string and returns the first validation error, or `undefined` if valid. * * @param delimiter - the custom delimiter string to validate * @returns validation error code, or `undefined` when the delimiter is acceptable * @alpha */ export declare function getCsvDelimiterValidationError(delimiter: string): CsvDelimiterValidationError | undefined; /** * Resolves a delimiter character to its corresponding preset identifier. * * Returns `"custom"` when the delimiter does not match any built-in preset, * or the default preset id (`"comma"`) when no delimiter is provided. * * @param delimiter - delimiter character to look up * @returns the matching preset id, `"custom"`, or the default * @alpha */ export declare function getCsvDelimiterPreset(delimiter?: string): CsvDelimiterPreset; /** * Returns the actual delimiter character for a given preset selection. * * When the preset is `"custom"`, the provided custom delimiter string is returned as-is. * * @param selectedPreset - the selected preset identifier * @param customDelimiter - the user-provided custom delimiter (used only when preset is `"custom"`) * @returns the resolved delimiter character * @alpha */ export declare function getCsvDelimiterValue(selectedPreset: CsvDelimiterPreset, customDelimiter: string): string; /** * Resolves a delimiter value into its preset identifier and custom delimiter components. * * Maps the delimiter to a preset when possible, otherwise sets the preset to * `"custom"` and populates the custom delimiter field. * * @param delimiter - the persisted delimiter value (e.g. from workspace settings) * @alpha */ export declare function getCsvDelimiterState(delimiter?: string): { selectedPreset: CsvDelimiterPreset; customDelimiter: string; }; //# sourceMappingURL=csvDelimiter.d.ts.map