import { For, Prose, Show, type Children } from "@alloy-js/core";

import type { ParameterDescriptor } from "../parameter-descriptor.js";

export interface JSDocParamsProps {
  parameters: ParameterDescriptor[] | string[];
}

/**
 * A component that creates a JSDoc block with `@param` tags for each parameter.
 */
export function JSDocParams(props: JSDocParamsProps) {
  const parameters = normalizeParametersForDoc(props.parameters);
  return (
    <For each={parameters}>
      {(param) => (
        <JSDocParam
          name={param.name}
          type={param.type}
          optional={param.optional}
          hyphen
        >
          {param.doc}
        </JSDocParam>
      )}
    </For>
  );
}

function normalizeParametersForDoc(
  parameters: ParameterDescriptor[] | string[],
): ParameterDescriptor[] {
  if (parameters.some((p) => typeof p === "string")) {
    return [];
  }

  return parameters as ParameterDescriptor[];
}

export interface JSDocParamProps {
  name: Children;
  type?: Children;
  children?: Children;
  hyphen?: boolean;
  optional?: boolean;
  defaultValue?: Children;
}

/**
 * Create a JSDoc parameter set off with `@param`.
 */
export function JSDocParam(props: JSDocParamProps) {
  return (
    <>
      {"@param "}
      <JSDocParamType type={props.type} />
      <JSDocParamName
        name={props.name}
        optional={props.optional}
        defaultValue={props.defaultValue}
      />
      <JSDocParamDescription hyphen={props.hyphen} children={props.children} />
    </>
  );
}

interface JSDocParamTypeProps {
  type?: Children;
}

function JSDocParamType(props: JSDocParamTypeProps) {
  return (
    <>
      <Show when={Boolean(props.type)}>
        {"{"}
        {props.type}
        {"} "}
      </Show>
    </>
  );
}

interface JSDocParamNameProps {
  name: Children;
  optional?: boolean;
  defaultValue?: Children;
}

function JSDocParamName(props: JSDocParamNameProps) {
  return (
    <>
      <Show when={props.optional}>{"["}</Show>
      {props.name}
      <Show when={Boolean(props.defaultValue)}>={props.defaultValue}</Show>
      <Show when={props.optional}>{"]"}</Show>
    </>
  );
}

interface JSDocParamDescriptionProps {
  children?: Children;
  hyphen?: boolean;
}

function JSDocParamDescription(props: JSDocParamDescriptionProps) {
  return (
    <Show when={Boolean(props.children)}>
      <Show when={props.hyphen} children={" - "} />
      <Show when={!props.hyphen} children={" "} />
      <align width={2}>
        <Prose>{props.children}</Prose>
      </align>
    </Show>
  );
}