From 30f3c41c7758f4f68c66b043e919c2b3a5f5e945 Mon Sep 17 00:00:00 2001
From: Arkadiusz Bachorski
 <60391032+arkadiuszbachorski@users.noreply.github.com>
Date: Mon, 4 Nov 2024 12:30:06 +0100
Subject: [PATCH] Add NotFound component

---
 package.json                                |  4 +
 src/molecules/NotFound/NotFound.stories.tsx | 30 +++++++
 src/molecules/NotFound/NotFound.test.tsx    | 28 +++++++
 src/molecules/NotFound/NotFound.tsx         | 89 +++++++++++++++++++++
 src/molecules/NotFound/index.tsx            |  9 +++
 5 files changed, 160 insertions(+)
 create mode 100644 src/molecules/NotFound/NotFound.stories.tsx
 create mode 100644 src/molecules/NotFound/NotFound.test.tsx
 create mode 100644 src/molecules/NotFound/NotFound.tsx
 create mode 100644 src/molecules/NotFound/index.tsx

diff --git a/package.json b/package.json
index 0d36ed4..40c6da5 100644
--- a/package.json
+++ b/package.json
@@ -143,6 +143,10 @@
       "types":  "./dist/molecules/Notifications.d.ts",
       "default":  "./dist/molecules/Notifications.js"
     },
+    "./molecules/NotFound": {
+      "types":  "./dist/molecules/NotFound.d.ts",
+      "default":  "./dist/molecules/NotFound.js"
+    },
     "./SpeziProvider": {
       "types": "./dist/SpeziProvider.d.ts",
       "default": "./dist/SpeziProvider.js"
diff --git a/src/molecules/NotFound/NotFound.stories.tsx b/src/molecules/NotFound/NotFound.stories.tsx
new file mode 100644
index 0000000..11cebac
--- /dev/null
+++ b/src/molecules/NotFound/NotFound.stories.tsx
@@ -0,0 +1,30 @@
+//
+// This source file is part of the Stanford Biodesign Digital Health Spezi Web Design System open-source project
+//
+// SPDX-FileCopyrightText: 2024 Stanford University and the project authors (see CONTRIBUTORS.md)
+//
+// SPDX-License-Identifier: MIT
+//
+
+import { type Meta, type StoryObj } from '@storybook/react'
+import { NotFound } from './NotFound'
+
+const meta: Meta<typeof NotFound> = {
+  title: 'Molecules/NotFound',
+  component: NotFound,
+}
+
+export default meta
+
+type Story = StoryObj<typeof NotFound>
+
+export const Generic: Story = {
+  args: { backPage: { href: '/', name: 'home' }, entityName: 'page' },
+}
+
+export const UserNotFound: Story = {
+  args: {
+    backPage: { href: '/users', name: 'users list' },
+    entityName: 'user',
+  },
+}
diff --git a/src/molecules/NotFound/NotFound.test.tsx b/src/molecules/NotFound/NotFound.test.tsx
new file mode 100644
index 0000000..52da2fc
--- /dev/null
+++ b/src/molecules/NotFound/NotFound.test.tsx
@@ -0,0 +1,28 @@
+//
+// This source file is part of the Stanford Biodesign Digital Health Spezi Web Design System open-source project
+//
+// SPDX-FileCopyrightText: 2024 Stanford University and the project authors (see CONTRIBUTORS.md)
+//
+// SPDX-License-Identifier: MIT
+//
+
+import { screen } from '@testing-library/react'
+import { renderWithProviders } from '@/tests/helpers'
+import { NotFound } from './'
+
+describe('NotFound', () => {
+  it('renders not found error page', () => {
+    renderWithProviders(
+      <NotFound
+        backPage={{ name: 'users', href: '/users' }}
+        entityName="user"
+      />,
+    )
+
+    const backLink = screen.getByRole('link', { name: /users/ })
+    expect(backLink).toBeInTheDocument()
+
+    const title = screen.getByText(`This user doesn't exist`)
+    expect(title).toBeInTheDocument()
+  })
+})
diff --git a/src/molecules/NotFound/NotFound.tsx b/src/molecules/NotFound/NotFound.tsx
new file mode 100644
index 0000000..bca09ca
--- /dev/null
+++ b/src/molecules/NotFound/NotFound.tsx
@@ -0,0 +1,89 @@
+//
+// This source file is part of the Stanford Biodesign Digital Health Spezi Web Design System open-source project
+//
+// SPDX-FileCopyrightText: 2024 Stanford University and the project authors (see CONTRIBUTORS.md)
+//
+// SPDX-License-Identifier: MIT
+//
+
+import { Link } from '@tanstack/react-router'
+import { RouteOff } from 'lucide-react'
+import { type ComponentProps, type ReactNode } from 'react'
+import { Button } from '@/components/Button'
+import { cn } from '@/utils/className'
+
+export const NotFoundIcon = ({
+  className,
+  ...props
+}: Omit<ComponentProps<'div'>, 'children'>) => (
+  <div
+    className={cn('flex-center mb-2 size-20 rounded-full bg-muted', className)}
+    {...props}
+  >
+    <RouteOff className="size-7" />
+  </div>
+)
+
+export const NotFoundContainer = ({
+  className,
+  ...props
+}: ComponentProps<'div'>) => (
+  <div
+    className={cn('flex-center grow flex-col gap-1', className)}
+    {...props}
+  />
+)
+
+export const NotFoundTitle = ({
+  className,
+  ...props
+}: ComponentProps<'h1'>) => (
+  <h1 className={cn('text-2xl font-medium', className)} {...props} />
+)
+
+export const NotFoundParagraph = ({
+  className,
+  ...props
+}: ComponentProps<'p'>) => (
+  <p className={cn('text-muted-foreground', className)} {...props} />
+)
+
+interface NotFoundActionProps extends ComponentProps<typeof Button> {}
+
+export const NotFoundAction = (props: NotFoundActionProps) => (
+  <Button size="sm" className="mt-3" asChild {...props} />
+)
+
+interface NotFoundProps {
+  /**
+   * Configures where user should go instead
+   * @example { name: "users list", href: "/user" }
+   * */
+  backPage: {
+    name: ReactNode
+    href: string
+  }
+  /**
+   * Singular name of accessed entity
+   * @example "user"
+   * */
+  entityName: ReactNode
+  className?: string
+}
+
+export const NotFound = ({
+  backPage,
+  entityName,
+  className,
+}: NotFoundProps) => (
+  <NotFoundContainer className={className}>
+    <NotFoundIcon />
+    <NotFoundTitle>This {entityName} doesn't exist</NotFoundTitle>
+    <NotFoundParagraph>
+      Please check your URL or return to {backPage.name}
+    </NotFoundParagraph>
+    <NotFoundAction>
+      <Link href={backPage.href}>Go to {backPage.name}</Link>
+    </NotFoundAction>
+  </NotFoundContainer>
+)
diff --git a/src/molecules/NotFound/index.tsx b/src/molecules/NotFound/index.tsx
new file mode 100644
index 0000000..c0d20bd
--- /dev/null
+++ b/src/molecules/NotFound/index.tsx
@@ -0,0 +1,9 @@
+//
+// This source file is part of the Stanford Biodesign Digital Health Spezi Web Design System open-source project
+//
+// SPDX-FileCopyrightText: 2024 Stanford University and the project authors (see CONTRIBUTORS.md)
+//
+// SPDX-License-Identifier: MIT
+//
+
+export * from './NotFound'