import type { JSX, ValidComponent } from "@solidjs/web";
import { dynamic } from "@solidjs/web";
import { omit, untrack } from "solid-js";
import { mergeRootProps } from "../../internals/merge-root-props";
import { resolveClassStyle } from "../../internals/resolve-class-style";
import type { BaseUIComponentProps } from "../../internals/types";
import { useRegisteredLabelId } from "../../internals/use-registered-label-id";
import { usePopoverRootContext } from "../popover-root-context";

// biome-ignore lint/complexity/noBannedTypes: matches Base UI React — description exposes no state fields.
export type PopoverDescriptionState = {};

export interface PopoverDescriptionProps
	extends BaseUIComponentProps<"p", PopoverDescriptionState> {
	/**
	 * Tag/component to render. Defaults to `"p"`. Replaces the
	 * pre-spike `render` prop (axis G).
	 */
	as?: ValidComponent;
}

/**
 * A paragraph with additional information about the popover. Renders a `<p>`
 * by default.
 */
export function PopoverDescription(
	props: PopoverDescriptionProps,
): JSX.Element {
	const root = usePopoverRootContext();

	// `props.id` is an id override read once at setup; untrack it so the read
	// doesn't trip `[STRICT_READ_UNTRACKED]` in this (non-tracking) body.
	const id = useRegisteredLabelId(
		untrack(() => props.id as string | undefined),
		root.setDescriptionId,
	);

	const internal = { id };

	const userClassStyle = resolveClassStyle(props, () => ({}));

	const userProps = omit(props, "as", "class", "style", "attrs");

	let merged: Record<string, unknown> = mergeRootProps(
		internal,
		userClassStyle,
	);
	merged = mergeRootProps(merged, userProps);

	const Tag = dynamic(() => props.as ?? "p");
	return <Tag {...merged} />;
}