/// <reference path="./jsx.d.ts" />
/// <reference types="./suspense.d.ts" />
/// <reference types="./error-boundary.d.ts" />

/**
 * Returns true if the character at the given index is an uppercase character.
 *
 * @param input The string to check.
 * @param index The index of the character to check.
 * @returns If the character at the given index is an uppercase character.
 */
export function isUpper(this: void, input: string, index: number): boolean;

/**
 * Tag function that escapes the given string pieces and interpolates the given values.
 * Internally it uses {@linkcode escapeHtml} to escape the values.
 *
 * @param strings Template string.
 * @param values Values to interpolate.
 * @returns The escaped string.
 */
export function escape(
  this: void,
  strings: TemplateStringsArray,
  ...values: any[]
): string;

/**
 * Escapes a string for safe use as HTML text content. If the value is not a string, it is
 * coerced to one with its own `toString()` method.
 *
 * If the {@linkcode Bun} runtime is available, this function will be swapped out to
 * {@linkcode Bun.escapeHTML}.
 *
 * @param value The value to escape.
 * @returns The escaped string.
 */
export function escapeHtml(this: void, value: any): string;

/**
 * Returns true if the element is a html void element.
 *
 * @param tag The name of the element to check.
 * @returns If the element is a html void element.
 */
export function isVoidElement(this: void, tag: string): boolean;

/**
 * Transforms an object of style attributes into a html style string.
 *
 * @param style A record of literal values to use as style attributes or a string.
 * @returns The generated html style string.
 */
export function styleToString(this: void, style: object | string): string;

/**
 * Transforms an object of attributes into a html attributes string.
 *
 * **This function does not support Date objects.**
 *
 * @example `a b="c" d="1"`
 *
 * @param attributes A record of literal values to use as attributes.
 * @returns The generated html attributes string.
 */
export function attributesToString(this: void, attributes: object): string;

/**
 * Converts a camel cased string to a kebab cased string.
 *
 * @param camel The camel cased string to convert.
 */
export function toKebabCase(this: void, camel: string): string;

/**
 * Generates a html string from the given contents.
 *
 * @param name The name of the element to create or a function that creates the element.
 * @param [attributes] A record of literal values to use as attributes. A property named
 *   `children` will be used as the children of the element.
 * @param contents The inner contents of the element.
 * @returns The generated html string.
 */
export function createElement(
  this: void,
  name: string | Function,
  attributes: PropsWithChildren<any> | null,
  ...contents: Children[]
): JSX.Element;

/**
 * Joins raw string html elements into a single html string.
 *
 * A raw html fragment is just an array of strings, this method concatenates .
 *
 * @param contents An maybe nested array of strings to concatenate.
 * @param escape If it should escape the contents before concatenating them. Default is
 *   `false`
 * @returns The concatenated and escaped string of contents.
 */
export function contentsToString(
  this: void,
  contents: Children[],
  escape?: boolean
): JSX.Element;

/**
 * Transforms a single content into a string.
 *
 * @param content The content to transform.
 * @param escape If it should escape the content before transforming it. Default is
 *   `false`
 * @returns The transformed and escaped string of content.
 */
export function contentToString(
  this: void,
  content: Children,
  escape?: boolean
): JSX.Element;

/** Here for interop with `preact` and many build systems. */
export const h: typeof createElement;

/**
 * Alias of {@linkcode escape} to reduce verbosity.
 *
 * @example
 *
 * ```tsx
 * import { e } from '@kitajs/html'
 *
 * <div>{e`My name is ${user.name}!`}</div>;
 * ```
 */
export const e: typeof escape;

/**
 * A JSX Fragment is used to return multiple elements from a component.
 *
 * @example
 *
 * ```tsx
 * // renders <div>1</div> and <div>2</div> without needing a wrapper element
 * const html = <><div>1</div><div>2</div></>
 *
 * // Html.Fragment is the same as <>...</>
 * const html = <Html.Fragment><div>1</div><div>2</div></Html.Fragment>
 * ```
 */
export function Fragment(props: PropsWithChildren): JSX.Element;

export type Children =
  | number
  | string
  | boolean
  | null
  | undefined
  | bigint
  | Promise<Children>
  | Children[];

export type PropsWithChildren<T = {}> = { children?: Children } & T;

export type Component<T = {}> = (this: void, props: PropsWithChildren<T>) => JSX.Element;

/**
 * Fast and type safe HTML templates using JSX syntax.
 *
 * @module Html
 * @license Apache License Version 2.0
 * @link https://github.com/kitajs/html
 * @link https://www.npmjs.com/package/@kitajs/html
 */
export const Html: Omit<typeof import('.'), 'Html'>;