import type { ApiClassMember, ApiClassMethod, ApiCssCustomProperty, ApiCustomElementField, ApiCustomElementMember, ApiDeclaration, ApiEvent, ApiSlot } from "../apiJson.js";

/** @param member */
export function isApiMethod(member: ApiClassMember): member is ApiClassMethod;

/** @param member */
export function isApiProperty(member: ApiClassMember): member is ApiCustomElementField;

/** This is not made up by us - defined in the custom-elements-manifest spec */
export const globalPackageIdentifier: "global:";

/**
 * Get a name from a class member.
 *
 * @param member
 * @example
 * - method named "test" => "test"
 * - property named "test" => "test"
 * - constructor => "constructor"
 * - call-signature => "call-signature"
 */
export function getApiMemberName(member: ApiClassMember | ApiCustomElementMember): string;

/**
 * Like `getApiMemberName`, but prefixes with `static ` if the member is static.
 *
 * @param member
 */
export function getMaybeStaticApiMemberName(member: ApiClassMember | ApiCustomElementMember): string;

/**
 * Get a UI label from a class member.
 *
 * @param member
 * @example
 * - method named "test" => "test()"
 * - property named "test" => "test"
 * - constructor => "constructor()"
 * - call-signature => "()"
 * - web component with tag name "my-component" => "my-component"
 */
export function getApiNodeLabel(member: ApiClassMember | ApiCssCustomProperty | ApiCustomElementMember | ApiDeclaration | ApiEvent | ApiSlot): string;

/**
 * Checks whether method's return type is a Promise.
 *
 * @param apiMethod
 */
export function isApiMethodAsync(apiMethod: ApiClassMethod): boolean;