import { memo, useCallback, type FC } from "react";

interface ComponentNameProps {
  /** Description of prop */
  propName: string;
  /** Optional prop with default */
  optionalProp?: boolean;
  /** Callback handler */
  onAction?: (value: string) => void;
}

/**
 * ComponentName - Brief description
 *
 * @example
 * <ComponentName propName="value" onAction={handleAction} />
 */
export const ComponentName: FC<ComponentNameProps> = memo(
  ({ propName, optionalProp = false, onAction }) => {
    const handleClick = useCallback(() => {
      onAction?.(propName);
    }, [propName, onAction]);

    return <div className="component-name">{/* Component content */}</div>;
  }
);

ComponentName.displayName = "ComponentName";

import { render, screen, fireEvent } from "@testing-library/react";
import { describe, it, expect, vi } from "vitest";
import { ComponentName } from "./ComponentName";

describe("ComponentName", () => {
  it("renders correctly", () => {
    render(<ComponentName propName="test" />);
    expect(screen.getByText("test")).toBeInTheDocument();
  });

  it("calls onAction when clicked", () => {
    const onAction = vi.fn();
    render(<ComponentName propName="test" onAction={onAction} />);
    fireEvent.click(screen.getByRole("button"));
    expect(onAction).toHaveBeenCalledWith("test");
  });
});

components/
  ComponentName/
    index.ts          # Export barrel
    ComponentName.tsx # Component implementation
    ComponentName.test.tsx # Tests
    ComponentName.css # Styles (if needed)