@carlonicora/nextjs-jsonapi 1.131.2 → 1.132.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/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";

package/src/utils/italian-validators.ts

@@ -29,7 +29,12 @@ export function validatePartitaIva(partitaIva: string): boolean {
   return totalSum % 10 === 0;
 }
 
-export function validateCodiceFiscale(codiceFiscale: string): boolean {
+export type CodiceFiscaleValidationOptions = {
+  /** When true, a valid Partita IVA is also accepted as a valid value. */
+  allowPartitaIva?: boolean;
+};
+
+export function validateCodiceFiscale(codiceFiscale: string, options?: CodiceFiscaleValidationOptions): boolean {
   if (!codiceFiscale || typeof codiceFiscale !== "string") {
     return false;
   }
@@ -37,13 +42,21 @@ export function validateCodiceFiscale(codiceFiscale: string): boolean {
   const cleaned = codiceFiscale.replace(/\s/g, "").toUpperCase();
 
   try {
-    return CodiceFiscale.check(cleaned);
+    if (CodiceFiscale.check(cleaned)) {
+      return true;
+    }
   } catch (error) {
-    return false;
+    // fall through to the optional Partita IVA check
   }
+
+  return options?.allowPartitaIva === true && validatePartitaIva(cleaned);
 }
 
-export function validateItalianTaxCode(value: string, type: "partitaIva" | "codiceFiscale"): boolean {
+export function validateItalianTaxCode(
+  value: string,
+  type: "partitaIva" | "codiceFiscale",
+  options?: CodiceFiscaleValidationOptions,
+): boolean {
   if (!value || typeof value !== "string") {
     return false;
   }
@@ -52,7 +65,7 @@ export function validateItalianTaxCode(value: string, type: "partitaIva" | "codi
     case "partitaIva":
       return validatePartitaIva(value);
     case "codiceFiscale":
-      return validateCodiceFiscale(value);
+      return validateCodiceFiscale(value, options);
     default:
       return false;
   }