import type { ApiFunctionLike } from "../apiJson.js";

/**
 * Double quote property name if it is not a valid identifier and not a symbol.
 *
 * @param name
 */
export function maybeEscapePropertyName(name: string): string;

/**
 * Determine if property name needs to be quoted and have quotes and backslashes
 * escaped.
 *
 * Permits the name to start with [ for computed property names. At present, only
 * [Symbol.iterator]
 *
 * @param name
 */
export function isPropertyEscapeNeeded(name: string): boolean;

/**
 * Print a function or method signature.
 *
 * Consider refactoring out usages of this function in favor of rendering a
 * table of parameters (with their description), and a return type section.
 *
 * @param functionLike
 */
export function printSignature(functionLike: Pick<ApiFunctionLike, "parameters" | "return" | "typeParameters">): string;