import { Signal } from "@dathra/reactivity";
import { AtomStore } from "@dathra/store";
import { GenericHydrationPlan } from "@dathra/runtime/hydration";
import { IslandStrategyName } from "@dathra/shared";

//#region src/defineComponent/implementation.d.ts
/** Supported prop type constructors or custom coercion functions. */
type PropType = StringConstructor | NumberConstructor | BooleanConstructor | ((value: string | null) => unknown);
/** Definition for a single prop (type, default, attribute mapping). */
interface PropDefinition {
  /** Constructor or coercion function for attribute→value conversion. */
  type: PropType;
  /** Default value when attribute is absent. Falls back to type default. */
  default?: unknown;
  /** Attribute name override, or `false` to disable attribute observation. */
  attribute?: string | false;
}
/** Schema mapping prop names to their definitions. */
type PropsSchema = Record<string, PropDefinition>;
type EmptyPropsSchema = Record<never, never>;
/** Infer the runtime type from a PropDefinition's type field. */
type InferPropType<D extends PropDefinition> = D extends {
  type: StringConstructor;
} ? string : D extends {
  type: NumberConstructor;
} ? number : D extends {
  type: BooleanConstructor;
} ? boolean : D extends {
  type: (v: string | null) => infer R;
} ? R : unknown;
/** Map a PropsSchema to an object of reactive signals. */
type InferProps<S extends PropsSchema> = { readonly [K in keyof S]: Signal<InferPropType<S[K]>> };
/**
 * Function component that receives reactive props as signals.
 * Props can be accessed via .value and will reactively update when attributes change.
 */
type FunctionComponent<S extends PropsSchema = PropsSchema> = (ctx: ComponentContext<S>) => Node | DocumentFragment | string;
/** Internal setup function with host and context. @internal */
type SetupFunction<S extends PropsSchema = PropsSchema> = (host: HTMLElement, ctx: ComponentContext<S>) => Node | DocumentFragment | string;
/** Context passed to setup and hydrate functions. */
interface ComponentContext<S extends PropsSchema = PropsSchema> {
  readonly host: HTMLElement;
  readonly props: Readonly<InferProps<S>>;
  readonly client: ComponentClientContext;
  readonly store: AtomStore;
  readonly children: unknown;
}
interface ComponentClientContext {
  readonly strategy: IslandStrategyName | null;
  readonly value: string | null;
  readonly hydrated: boolean;
}
interface JSXReactiveValue<T> {
  readonly value: T;
}
type JSXPropValue<T> = T | JSXReactiveValue<T>;
interface IslandsDirectiveJSXProps {
  readonly "client:load"?: true | "";
  readonly "client:visible"?: true | "";
  readonly "client:idle"?: true | "";
  readonly "client:interaction"?: true | string;
  readonly "client:media"?: string;
}
/** Props accepted by the JSX helper component returned from defineComponent. */
type JSXComponentProps<S extends PropsSchema = EmptyPropsSchema> = { readonly [K in keyof S]?: JSXPropValue<InferPropType<S[K]>> } & {
  readonly children?: unknown;
} & IslandsDirectiveJSXProps;
/** Options for defineComponent. */
interface ComponentOptions<S extends PropsSchema = PropsSchema> {
  /** CSS styles to apply via adoptedStyleSheets. */
  styles?: readonly (CSSStyleSheet | string)[];
  /** Props schema defining observed attributes with type coercion. */
  props?: S;
  /** Hydration setup function for Declarative Shadow DOM. */
  hydrate?: HydrateSetupFunction<S>;
}
/** Component class with tag name and schema metadata. */
interface ComponentMetadata<S extends PropsSchema = PropsSchema> {
  readonly __tagName__: string;
  readonly __propsSchema__?: S;
  readonly __hydrationMetadata__?: ComponentHydrationMetadata;
}
type HydrationPlanFactory = (host: HTMLElement, ctx: ComponentContext<PropsSchema>) => GenericHydrationPlan;
interface ComponentHydrationMetadata {
  readonly kind: "generic-plan";
  readonly planFactory?: HydrationPlanFactory | null;
  readonly unsupportedReason?: string;
}
/** Component class with tag name and schema metadata. */
interface ComponentClass<S extends PropsSchema = PropsSchema> extends Function, ComponentMetadata<S> {}
/** Constructor type returned by defineComponent. */
type ComponentConstructor<S extends PropsSchema = PropsSchema> = {
  new (): HTMLElement & { [K in keyof S]: InferPropType<S[K]> };
  readonly prototype: HTMLElement;
} & ComponentClass<S>;
/** JSX helper component returned by defineComponent. */
type JSXComponent<S extends PropsSchema = EmptyPropsSchema> = (props: JSXComponentProps<S> | null) => Node;
/** Public object returned by defineComponent. */
interface DefinedComponent<S extends PropsSchema = EmptyPropsSchema> extends ComponentMetadata<S> {
  (props: JSXComponentProps<S> | null): Node;
  readonly webComponent: ComponentConstructor<S>;
  readonly jsx: JSXComponent<S>;
}
/** TSX helper: derive element attribute types from a ComponentClass. */
type ComponentElement<C> = C extends ComponentMetadata<infer S> ? JSXComponentProps<S> : Record<string, unknown>;
/** Function that hydrates existing DSD content without creating new DOM. */
type HydrateSetupFunction<S extends PropsSchema = PropsSchema> = (ctx: ComponentContext<S>) => void;
/**
 * Define a custom element with automatic Shadow DOM, reactive props with
 * type coercion, adoptedStyleSheets, and lifecycle management.
 * Accepts a FunctionComponent that receives reactive prop signals.
 * @param tagName - Custom element tag name (must contain a hyphen).
 * @param component - Function component that creates the component's DOM content.
 * @param options - Optional configuration for styles, props, and hydration.
 * @returns A component definition object containing the custom element class and JSX helper.
 */
declare function defineComponent<const S extends PropsSchema = EmptyPropsSchema>(tagName: string, component: FunctionComponent<S>, options?: ComponentOptions<S>): DefinedComponent<S>;
//#endregion
export { PropType as _, ComponentMetadata as a, defineComponent as b, FunctionComponent as c, InferProps as d, JSXComponent as f, PropDefinition as g, JSXReactiveValue as h, ComponentElement as i, HydrateSetupFunction as l, JSXPropValue as m, ComponentConstructor as n, ComponentOptions as o, JSXComponentProps as p, ComponentContext as r, DefinedComponent as s, ComponentClass as t, InferPropType as u, PropsSchema as v, SetupFunction as y };
//# sourceMappingURL=implementation-E2NIKX9i.d.mts.map