@carlonicora/nextjs-jsonapi 1.131.2 → 1.133.0

package/src/components/navigations/Breadcrumb.tsx

@@ -19,18 +19,18 @@ import {
   Breadcrumb as UIBreadcrumb,
 } from "../../shadcnui";
 
-type BreadcrumbProps = { items: BreadcrumbItemData[] };
+type BreadcrumbProps = { items: BreadcrumbItemData[]; rootLabel?: string };
 
 const ITEMS_TO_DISPLAY = 4;
 
 function BreadcrumbDesktop({
   items,
   generateUrl,
-  t,
+  rootLabel,
 }: {
   items: BreadcrumbItemData[];
   generateUrl: ReturnType<typeof usePageUrlGenerator>;
-  t: ReturnType<typeof useTranslations>;
+  rootLabel: string;
 }) {
   const [open, setOpen] = useState<boolean>(false);
 
@@ -38,7 +38,7 @@ function BreadcrumbDesktop({
     <UIBreadcrumb>
       <BreadcrumbList>
         <BreadcrumbItem>
-          <Link href={generateUrl({ page: `/` })}>{t(`common.home`)}</Link>
+          <Link href={generateUrl({ page: `/` })}>{rootLabel}</Link>
         </BreadcrumbItem>
         {items.length > 0 && <BreadcrumbSeparator />}
 
@@ -112,23 +112,23 @@ function BreadcrumbDesktop({
 function BreadcrumbMobile({
   items,
   generateUrl,
-  t,
+  rootLabel,
 }: {
   items: BreadcrumbItemData[];
   generateUrl: ReturnType<typeof usePageUrlGenerator>;
-  t: ReturnType<typeof useTranslations>;
+  rootLabel: string;
 }) {
   const [open, setOpen] = useState<boolean>(false);
 
   const lastItem = items[items.length - 1];
-  const allItems = [{ name: t(`common.home`), href: generateUrl({ page: `/` }) }, ...items];
+  const allItems = [{ name: rootLabel, href: generateUrl({ page: `/` }) }, ...items];
 
   if (!lastItem && items.length === 0) {
     return (
       <UIBreadcrumb>
         <BreadcrumbList>
           <BreadcrumbItem>
-            <Link href={generateUrl({ page: `/` })}>{t(`common.home`)}</Link>
+            <Link href={generateUrl({ page: `/` })}>{rootLabel}</Link>
           </BreadcrumbItem>
         </BreadcrumbList>
       </UIBreadcrumb>
@@ -158,14 +158,16 @@ function BreadcrumbMobile({
   );
 }
 
-export function BreadcrumbNavigation({ items }: BreadcrumbProps) {
+export function BreadcrumbNavigation({ items, rootLabel }: BreadcrumbProps) {
   const generateUrl = usePageUrlGenerator();
   const t = useTranslations();
   const isMobile = useIsMobile();
 
+  const root = rootLabel?.trim() ? rootLabel : t(`common.home`);
+
   if (isMobile) {
-    return <BreadcrumbMobile items={items} generateUrl={generateUrl} t={t} />;
+    return <BreadcrumbMobile items={items} generateUrl={generateUrl} rootLabel={root} />;
   }
 
-  return <BreadcrumbDesktop items={items} generateUrl={generateUrl} t={t} />;
+  return <BreadcrumbDesktop items={items} generateUrl={generateUrl} rootLabel={root} />;
 }

package/src/components/navigations/Header.tsx

@@ -1,6 +1,7 @@
 "use client";
 
 import { useIsMobile } from "@/utils";
+import { useHeaderRootLabel } from "../../contexts/HeaderChildrenContext";
 import { useSharedContext } from "../../contexts/SharedContext";
 import { SidebarTrigger } from "../../shadcnui";
 import { BreadcrumbNavigation } from "./Breadcrumb";
@@ -13,6 +14,7 @@ type HeaderProps = {
 
 export function Header({ children, leftContent, className }: HeaderProps) {
   const { breadcrumbs } = useSharedContext();
+  const rootLabel = useHeaderRootLabel();
   const isMobile = useIsMobile();
 
   return (
@@ -21,7 +23,7 @@ export function Header({ children, leftContent, className }: HeaderProps) {
         <SidebarTrigger aria-label="Toggle sidebar" id="sidebar-trigger" />
         {leftContent}
         <div className="flex w-full flex-row items-center justify-start">
-          <BreadcrumbNavigation items={breadcrumbs} />
+          <BreadcrumbNavigation items={breadcrumbs} rootLabel={rootLabel ?? undefined} />
         </div>
         {!isMobile && children && (
           <div className="flex w-64 flex-row items-center justify-end gap-x-4 whitespace-nowrap">

package/src/components/tables/ContentListTable.tsx

@@ -10,6 +10,7 @@ import React, { ReactNode, memo, useMemo, useState } from "react";
 import { DataListRetriever, TableContent, useTableGenerator } from "../../hooks";
 import { ModuleWithPermissions } from "../../permissions";
 import { Button, Table, TableBody, TableCell, TableFooter, TableHead, TableHeader, TableRow } from "../../shadcnui";
+import { MicroLabel } from "../typography";
 import { ContentTableSearch } from "./ContentTableSearch";
 
 const EMPTY_ARRAY: any[] = [];
@@ -49,6 +50,9 @@ type ContentListTableProps = {
   defaultExpanded?: boolean | ExpandedState;
   fullWidth?: boolean;
   groupBy?: string;
+  groupLabel?: (key: string) => ReactNode;
+  groupOrder?: string[];
+  hideHeader?: boolean;
   emptyState?: ReactNode;
   onRowClick?: (rowData: any) => void;
 };
@@ -118,12 +122,24 @@ export const ContentListTable = memo(function ContentListTable(props: ContentLis
       }
     }
 
-    const sortedKeys = [...groupMap.keys()].sort((a, b) => a.localeCompare(b));
+    const order = props.groupOrder;
+    const sortedKeys = [...groupMap.keys()].sort((a, b) => {
+      if (order) {
+        const ia = order.indexOf(a);
+        const ib = order.indexOf(b);
+        // keys absent from groupOrder sort last, alphabetically among themselves
+        if (ia === -1 && ib === -1) return a.localeCompare(b);
+        if (ia === -1) return 1;
+        if (ib === -1) return -1;
+        return ia - ib;
+      }
+      return a.localeCompare(b);
+    });
     return sortedKeys.map((groupKey) => ({
       groupKey,
       rows: groupMap.get(groupKey)!,
     }));
-  }, [props.groupBy, rowModel]);
+  }, [props.groupBy, props.groupOrder, rowModel]);
 
   const showFooter = !!(data.next || data.previous);
 
@@ -168,18 +184,19 @@ export const ContentListTable = memo(function ContentListTable(props: ContentLis
                 </TableHead>
               </TableRow>
             )}
-            {table.getHeaderGroups().map((headerGroup) => (
-              <TableRow key={headerGroup.id}>
-                {headerGroup.headers.map((header) => {
-                  const meta = header.column.columnDef.meta as { className?: string } | undefined;
-                  return (
-                    <TableHead key={header.id} className={meta?.className}>
-                      {header.isPlaceholder ? null : flexRender(header.column.columnDef.header, header.getContext())}
-                    </TableHead>
-                  );
-                })}
-              </TableRow>
-            ))}
+            {!props.hideHeader &&
+              table.getHeaderGroups().map((headerGroup) => (
+                <TableRow key={headerGroup.id}>
+                  {headerGroup.headers.map((header) => {
+                    const meta = header.column.columnDef.meta as { className?: string } | undefined;
+                    return (
+                      <TableHead key={header.id} className={meta?.className}>
+                        {header.isPlaceholder ? null : flexRender(header.column.columnDef.header, header.getContext())}
+                      </TableHead>
+                    );
+                  })}
+                </TableRow>
+              ))}
           </TableHeader>
           <TableBody>
             {rowModel && rowModel.rows?.length ? (
@@ -187,11 +204,8 @@ export const ContentListTable = memo(function ContentListTable(props: ContentLis
                 groupedRows.map((group) => (
                   <React.Fragment key={group.groupKey}>
                     <TableRow>
-                      <TableCell
-                        colSpan={tableColumns.length}
-                        className="bg-muted text-muted-foreground px-4 py-2 text-sm font-semibold"
-                      >
-                        {group.groupKey}
+                      <TableCell colSpan={tableColumns.length} className="bg-muted px-4 py-2">
+                        <MicroLabel>{props.groupLabel?.(group.groupKey) ?? group.groupKey}</MicroLabel>
                       </TableCell>
                     </TableRow>
                     {group.rows.map((row) => (

package/src/components/tables/__tests__/ContentListTable.test.tsx

@@ -338,6 +338,37 @@ describe("ContentListTable", () => {
     });
   });
 
+  describe("hideHeader", () => {
+    it("should render the column header row by default", () => {
+      const dataRetriever = createMockDataRetriever({
+        data: [{ id: "1", title: "Article 1" }],
+      });
+
+      render(<ContentListTable data={dataRetriever} tableGeneratorType={mockModule as any} fields={["id", "title"]} />);
+
+      expect(screen.getByText("Title")).toBeInTheDocument();
+    });
+
+    it("should not render the column header row when hideHeader is set", () => {
+      const dataRetriever = createMockDataRetriever({
+        data: [{ id: "1", title: "Article 1" }],
+      });
+
+      render(
+        <ContentListTable
+          data={dataRetriever}
+          tableGeneratorType={mockModule as any}
+          fields={["id", "title"]}
+          hideHeader
+        />,
+      );
+
+      expect(screen.queryByText("Title")).not.toBeInTheDocument();
+      // Body rows must still render — only the header row is suppressed.
+      expect(screen.getByText("Article 1")).toBeInTheDocument();
+    });
+  });
+
   describe("grouping", () => {
     it("should not group rows when groupBy is not provided", () => {
       const dataRetriever = createMockDataRetriever({
@@ -511,6 +542,52 @@ describe("ContentListTable", () => {
       const article3Count = allText.filter((t) => t === "Article 3").length;
       expect(article3Count).toBe(2);
     });
+
+    it("should render group headers through groupLabel when provided", () => {
+      const dataRetriever = createMockDataRetriever({
+        data: [
+          { id: "1", title: "Article 1", category: "CIVIL" },
+          { id: "2", title: "Article 2", category: "CRIMINAL" },
+        ],
+      });
+
+      render(
+        <ContentListTable
+          data={dataRetriever}
+          tableGeneratorType={mockModule as any}
+          fields={["id", "title"]}
+          groupBy="category"
+          groupLabel={(key) => `Branch: ${key}`}
+        />,
+      );
+
+      expect(screen.getByText("Branch: CIVIL")).toBeInTheDocument();
+      expect(screen.getByText("Branch: CRIMINAL")).toBeInTheDocument();
+      expect(screen.queryByText("CIVIL")).not.toBeInTheDocument();
+    });
+
+    it("should order groups by groupOrder instead of alphabetically", () => {
+      const dataRetriever = createMockDataRetriever({
+        data: [
+          { id: "1", title: "A Article", category: "A" },
+          { id: "2", title: "B Article", category: "B" },
+          { id: "3", title: "C Article", category: "C" },
+        ],
+      });
+
+      render(
+        <ContentListTable
+          data={dataRetriever}
+          tableGeneratorType={mockModule as any}
+          fields={["id", "title"]}
+          groupBy="category"
+          groupOrder={["C", "A", "B"]}
+        />,
+      );
+
+      const headings = screen.getAllByRole("heading", { level: 4 });
+      expect(headings.map((h) => h.textContent)).toEqual(["C", "A", "B"]);
+    });
   });
 
   describe("onRowClick", () => {

package/src/contexts/HeaderChildrenContext.tsx

@@ -4,24 +4,30 @@ import { createContext, useContext, ReactNode } from "react";
 
 interface HeaderChildrenContextType {
   headerChildren: ReactNode | null;
+  headerRootLabel: string | null;
 }
 
 const HeaderChildrenContext = createContext<HeaderChildrenContextType>({
   headerChildren: null,
+  headerRootLabel: null,
 });
 
 interface HeaderChildrenProviderProps {
   children: ReactNode;
   content: ReactNode;
+  rootLabel?: string;
 }
 
 /**
  * Provider to supply custom content to be rendered in the Header component.
  * Wrap your layout with this provider and pass the content you want in the header.
+ * Optionally pass `rootLabel` to override the first breadcrumb entry (defaults to `common.home`).
  */
-export function HeaderChildrenProvider({ children, content }: HeaderChildrenProviderProps) {
+export function HeaderChildrenProvider({ children, content, rootLabel }: HeaderChildrenProviderProps) {
   return (
-    <HeaderChildrenContext.Provider value={{ headerChildren: content }}>{children}</HeaderChildrenContext.Provider>
+    <HeaderChildrenContext.Provider value={{ headerChildren: content, headerRootLabel: rootLabel ?? null }}>
+      {children}
+    </HeaderChildrenContext.Provider>
   );
 }
 
@@ -33,3 +39,12 @@ export function useHeaderChildren(): ReactNode | null {
   const context = useContext(HeaderChildrenContext);
   return context.headerChildren;
 }
+
+/**
+ * Hook to get the label of the first breadcrumb entry, when the application supplies one.
+ * Returns null when no override was provided, in which case the Header falls back to `common.home`.
+ */
+export function useHeaderRootLabel(): string | null {
+  const context = useContext(HeaderChildrenContext);
+  return context.headerRootLabel;
+}

package/src/features/assistant-message/components/MessageItem.tsx

@@ -46,7 +46,7 @@ export function MessageItem({
           <div className="text-destructive flex items-center gap-2 text-xs">
             <AlertCircle className="h-3.5 w-3.5" />
             <span>{t("features.assistant.send_failed")}</span>
-            <button type="button" className="underline" onClick={() => onRetry?.(message.id)}>
+            <button type="button" onClick={() => onRetry?.(message.id)}>
               {t("features.assistant.retry")}
             </button>
           </div>

package/src/features/auth/components/GdprConsentSection.tsx

@@ -21,11 +21,11 @@ export function GdprConsentSection<T extends FieldValues>({
   const termsLabel = (
     <>
       {t("terms_prefix")}{" "}
-      <Link href="/terms" target="_blank" rel="noopener" className="underline">
+      <Link href="/terms" target="_blank" rel="noopener">
         {t("terms_of_service")}
       </Link>{" "}
       {t("and")}{" "}
-      <Link href="/privacy" target="_blank" rel="noopener" className="underline">
+      <Link href="/privacy" target="_blank" rel="noopener">
         {t("privacy_policy")}
       </Link>
     </>

package/src/features/auth/components/forms/Register.tsx

@@ -194,7 +194,7 @@ export default function Register() {
         <CardContent className="text-center">
           <p className="text-destructive mb-4">{inviteError}</p>
           <p className="mb-4">{t("waitlist.invite.join_prompt")}</p>
-          <Link href="/waitlist" className="text-primary underline">
+          <Link href="/waitlist" className="text-primary">
             {t("waitlist.invite.join_link")}
           </Link>
         </CardContent>
@@ -215,7 +215,7 @@ export default function Register() {
         <CardContent className="text-center">
           <p className="mb-4">{t("waitlist.invite.registration_description")}</p>
           <p className="mb-4">{t("waitlist.invite.registration_hint")}</p>
-          <Link href="/waitlist" className="text-primary underline">
+          <Link href="/waitlist" className="text-primary">
             {t("waitlist.invite.join_link")}
           </Link>
         </CardContent>

package/src/features/help/components/HelpArticleBody.tsx

@@ -43,14 +43,14 @@ export function HelpArticleBody(props: {
       ) : null}
       <div className="mt-4 flex justify-between text-sm">
         {prev ? (
-          <Link href={generateUrl({ page: `/help/${prev.howToType}/${prev.slug}` })} className="hover:underline">
+          <Link href={generateUrl({ page: `/help/${prev.howToType}/${prev.slug}` })}>
             ← {t("help.article.previous")}: {prev.title}
           </Link>
         ) : (
           <span />
         )}
         {next ? (
-          <Link href={generateUrl({ page: `/help/${next.howToType}/${next.slug}` })} className="hover:underline">
+          <Link href={generateUrl({ page: `/help/${next.howToType}/${next.slug}` })}>
             {t("help.article.next")}: {next.title} →
           </Link>
         ) : (

package/src/features/notification/components/common/NotificationErrorBoundary.tsx

@@ -34,10 +34,7 @@ export class NotificationErrorBoundary extends Component<Props, State> {
           <div className="flex items-center justify-center p-4 text-center">
             <div className="text-muted-foreground text-sm">
               <p>Something went wrong with notifications.</p>
-              <button
-                onClick={() => this.setState({ hasError: false })}
-                className="text-primary mt-2 underline hover:no-underline"
-              >
+              <button onClick={() => this.setState({ hasError: false })} className="text-primary mt-2">
                 Try again
               </button>
             </div>

package/src/features/oauth/components/consent/OAuthConsentScreen.tsx

@@ -111,11 +111,11 @@ export function OAuthConsentScreen({
         <CardFooter className="justify-center">
           <p className="text-xs text-center text-muted-foreground">
             By authorizing, you agree to the app's{" "}
-            <a href={termsUrl} className="underline hover:text-foreground" target="_blank" rel="noopener">
+            <a href={termsUrl} className="hover:text-foreground" target="_blank" rel="noopener">
               Terms of Service
             </a>{" "}
             and{" "}
-            <a href={privacyUrl} className="underline hover:text-foreground" target="_blank" rel="noopener">
+            <a href={privacyUrl} className="hover:text-foreground" target="_blank" rel="noopener">
               Privacy Policy
             </a>
             .

package/src/features/waitlist/components/forms/WaitlistForm.tsx

@@ -159,11 +159,11 @@ export function WaitlistForm({ onSuccess }: WaitlistFormProps) {
             label={
               <>
                 {t("auth.gdpr.terms_prefix")}
-                <Link href="/terms" target="_blank" rel="noopener" className="underline">
+                <Link href="/terms" target="_blank" rel="noopener">
                   {t("auth.gdpr.terms_of_service")}
                 </Link>
                 {t("auth.gdpr.and")}
-                <Link href="/privacy" target="_blank" rel="noopener" className="underline">
+                <Link href="/privacy" target="_blank" rel="noopener">
                   {t("auth.gdpr.privacy_policy")}
                 </Link>
               </>

package/src/features/waitlist/components/lists/WaitlistList.tsx

@@ -3,7 +3,7 @@
 import { flexRender, getCoreRowModel, useReactTable } from "@tanstack/react-table";
 import { RefreshCw, Users } from "lucide-react";
 import { useTranslations } from "next-intl";
-import { useCallback, useEffect, useState } from "react";
+import { useCallback, useEffect, useMemo, useState } from "react";
 import { errorToast } from "../../../../components";
 import { SectionHeader } from "../../../../components/typography";
 import {
@@ -64,6 +64,17 @@ export function WaitlistList() {
 
   const columns = useWaitlistTableStructure({ onInvite: handleInvite });
 
+  const statusItems = useMemo(
+    () => ({
+      all: t("waitlist.admin.all_statuses"),
+      pending: t("waitlist.admin.status.pending"),
+      confirmed: t("waitlist.admin.status.confirmed"),
+      invited: t("waitlist.admin.status.invited"),
+      registered: t("waitlist.admin.status.registered"),
+    }),
+    [t],
+  );
+
   const table = useReactTable({
     data: entries,
     columns,
@@ -82,7 +93,7 @@ export function WaitlistList() {
 
         <div className="flex items-center gap-4">
           {/* Status Filter */}
-          <Select value={statusFilter} onValueChange={(value) => setStatusFilter(value ?? "all")}>
+          <Select items={statusItems} value={statusFilter} onValueChange={(value) => setStatusFilter(value ?? "all")}>
             <SelectTrigger className="w-40">
               <SelectValue placeholder={t("waitlist.admin.filter_placeholder")} />
             </SelectTrigger>

package/src/shadcnui/custom/link.tsx

@@ -21,7 +21,7 @@ const Link = React.forwardRef<HTMLAnchorElement, LinkProps>(({ className, href,
       prefetch={false}
       ref={ref}
       href={href}
-      className={cn("text-primary font-medium hover:underline", className)}
+      className={cn("text-primary font-medium", className)}
       {...props}
     >
       {children}

package/src/shadcnui/ui/accordion.tsx

@@ -59,7 +59,7 @@ function AccordionContent({ className, children, ...props }: AccordionPrimitive.
     >
       <div
         className={cn(
-          "pt-0 pb-4 [&_a]:hover:text-foreground h-(--accordion-panel-height) data-ending-style:h-0 data-starting-style:h-0 [&_a]:underline [&_a]:underline-offset-3 [&_p:not(:last-child)]:mb-4",
+          "pt-0 pb-4 [&_a]:hover:text-foreground h-(--accordion-panel-height) data-ending-style:h-0 data-starting-style:h-0 [&_p:not(:last-child)]:mb-4",
           className,
         )}
       >

package/src/shadcnui/ui/alert-dialog.tsx

@@ -114,7 +114,7 @@ function AlertDialogDescription({
     <AlertDialogPrimitive.Description
       data-slot="alert-dialog-description"
       className={cn(
-        "text-muted-foreground *:[a]:hover:text-foreground text-xs/relaxed text-balance md:text-pretty *:[a]:underline *:[a]:underline-offset-3",
+        "text-muted-foreground *:[a]:hover:text-foreground text-xs/relaxed text-balance md:text-pretty",
         className,
       )}
       {...props}

package/src/shadcnui/ui/alert.tsx

@@ -27,10 +27,7 @@ function AlertTitle({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
       data-slot="alert-title"
-      className={cn(
-        "text-sm font-medium group-has-[>svg]/alert:col-start-2 [&_a]:hover:text-foreground [&_a]:underline [&_a]:underline-offset-3",
-        className,
-      )}
+      className={cn("text-sm font-medium group-has-[>svg]/alert:col-start-2 [&_a]:hover:text-foreground", className)}
       {...props}
     />
   );
@@ -41,7 +38,7 @@ function AlertDescription({ className, ...props }: React.ComponentProps<"div">)
     <div
       data-slot="alert-description"
       className={cn(
-        "text-muted-foreground text-xs/relaxed text-balance md:text-pretty [&_p:not(:last-child)]:mb-4 [&_a]:hover:text-foreground [&_a]:underline [&_a]:underline-offset-3",
+        "text-muted-foreground text-xs/relaxed text-balance md:text-pretty [&_p:not(:last-child)]:mb-4 [&_a]:hover:text-foreground",
         className,
       )}
       {...props}

package/src/shadcnui/ui/badge.tsx

@@ -16,7 +16,7 @@ const badgeVariants = cva(
         outline:
           "border-border text-foreground [a]:hover:bg-muted [a]:hover:text-muted-foreground bg-input/20 dark:bg-input/30",
         ghost: "hover:bg-muted hover:text-muted-foreground dark:hover:bg-muted/50",
-        link: "text-primary underline-offset-4 hover:underline",
+        link: "text-primary",
         warning: "bg-warning text-warning-foreground [a]:hover:bg-warning/80",
         softGreen: "bg-green-500/10 text-green-700 dark:bg-green-500/15 dark:text-green-400",
         softRed: "bg-red-500/10 text-red-700 dark:bg-red-500/15 dark:text-red-400",

package/src/shadcnui/ui/button.tsx

@@ -17,7 +17,7 @@ const buttonVariants = cva(
           "hover:bg-muted hover:text-foreground dark:hover:bg-muted/50 aria-expanded:bg-muted aria-expanded:text-foreground",
         destructive:
           "bg-destructive/10 hover:bg-destructive/20 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/20 text-destructive focus-visible:border-destructive/40 dark:hover:bg-destructive/30",
-        link: "text-primary underline-offset-4 hover:underline",
+        link: "text-primary",
       },
       size: {
         default:

package/src/shadcnui/ui/dialog.tsx

@@ -102,10 +102,7 @@ function DialogDescription({ className, ...props }: DialogPrimitive.Description.
   return (
     <DialogPrimitive.Description
       data-slot="dialog-description"
-      className={cn(
-        "text-muted-foreground *:[a]:hover:text-foreground text-xs/relaxed *:[a]:underline *:[a]:underline-offset-3",
-        className,
-      )}
+      className={cn("text-muted-foreground *:[a]:hover:text-foreground text-xs/relaxed", className)}
       {...props}
     />
   );

package/src/shadcnui/ui/field.tsx

@@ -123,7 +123,7 @@ function FieldDescription({ className, ...props }: React.ComponentProps<"p">) {
       className={cn(
         "text-muted-foreground text-left text-xs/relaxed [[data-variant=legend]+&]:-mt-1.5 leading-normal font-normal group-has-[[data-orientation=horizontal]]/field:text-balance",
         "last:mt-0 nth-last-2:-mt-1",
-        "[&>a:hover]:text-primary [&>a]:underline [&>a]:underline-offset-4",
+        "[&>a:hover]:text-primary",
         className,
       )}
       {...props}

package/src/utils/__tests__/italian-validators.test.ts

@@ -0,0 +1,63 @@
+import { describe, expect, it } from "vitest";
+
+import { validateCodiceFiscale, validateItalianTaxCode, validatePartitaIva } from "../italian-validators";
+
+const VALID_CODICE_FISCALE = "RSSMRA85M01H501Q";
+const VALID_PARTITA_IVA = "00743110157";
+
+describe("validatePartitaIva", () => {
+  it("accepts a valid partita iva", () => {
+    expect(validatePartitaIva(VALID_PARTITA_IVA)).toBe(true);
+  });
+
+  it("rejects a partita iva with a wrong check digit", () => {
+    expect(validatePartitaIva("00743110158")).toBe(false);
+  });
+
+  it("rejects a codice fiscale", () => {
+    expect(validatePartitaIva(VALID_CODICE_FISCALE)).toBe(false);
+  });
+});
+
+describe("validateCodiceFiscale", () => {
+  it("accepts a valid codice fiscale", () => {
+    expect(validateCodiceFiscale(VALID_CODICE_FISCALE)).toBe(true);
+  });
+
+  it("rejects a partita iva by default", () => {
+    expect(validateCodiceFiscale(VALID_PARTITA_IVA)).toBe(false);
+  });
+
+  it("accepts a partita iva when allowPartitaIva is set", () => {
+    expect(validateCodiceFiscale(VALID_PARTITA_IVA, { allowPartitaIva: true })).toBe(true);
+  });
+
+  it("still accepts a codice fiscale when allowPartitaIva is set", () => {
+    expect(validateCodiceFiscale(VALID_CODICE_FISCALE, { allowPartitaIva: true })).toBe(true);
+  });
+
+  it("rejects a value that is neither, even when allowPartitaIva is set", () => {
+    expect(validateCodiceFiscale("NOT-A-CODE", { allowPartitaIva: true })).toBe(false);
+    expect(validateCodiceFiscale("00743110158", { allowPartitaIva: true })).toBe(false);
+  });
+
+  it("ignores whitespace", () => {
+    expect(validateCodiceFiscale("0074 3110 157", { allowPartitaIva: true })).toBe(true);
+  });
+
+  it("rejects empty values", () => {
+    expect(validateCodiceFiscale("", { allowPartitaIva: true })).toBe(false);
+  });
+});
+
+describe("validateItalianTaxCode", () => {
+  it("forwards the options to the codice fiscale validator", () => {
+    expect(validateItalianTaxCode(VALID_PARTITA_IVA, "codiceFiscale")).toBe(false);
+    expect(validateItalianTaxCode(VALID_PARTITA_IVA, "codiceFiscale", { allowPartitaIva: true })).toBe(true);
+  });
+
+  it("leaves partita iva validation unchanged", () => {
+    expect(validateItalianTaxCode(VALID_PARTITA_IVA, "partitaIva")).toBe(true);
+    expect(validateItalianTaxCode(VALID_CODICE_FISCALE, "partitaIva")).toBe(false);
+  });
+});

package/src/utils/index.ts

@@ -12,6 +12,14 @@ export { getTableComponents, getTableOptions, TableOptions } from "./table-optio
 export { entityObjectSchema, userObjectSchema, type EntityObject, type UserObject } from "./schemas";
 
 export { getInitials } from "./getInitials";
+export {
+  validatePartitaIva,
+  validateCodiceFiscale,
+  validateItalianTaxCode,
+  formatPartitaIva,
+  formatCodiceFiscale,
+  type CodiceFiscaleValidationOptions,
+} from "./italian-validators";
 export * from "./blocknote-diff.util";
 export * from "./blocknote-word-diff-renderer.util";
 export * from "./icons";