create-nexst-monorepo 0.1.0

package/template/apps/web/src/components/dropdown-menu/dropdown-menu.tsx

@@ -0,0 +1,263 @@
+"use client";
+
+import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
+import { Check, ChevronRight, Circle } from "lucide-react";
+import type { ComponentPropsWithoutRef, ComponentRef, HTMLAttributes, RefObject } from "react";
+import { cn } from "@/lib/utils";
+
+const DropdownMenu = DropdownMenuPrimitive.Root;
+
+const DropdownMenuTrigger = DropdownMenuPrimitive.Trigger;
+
+const DropdownMenuGroup = DropdownMenuPrimitive.Group;
+
+const DropdownMenuPortal = DropdownMenuPrimitive.Portal;
+
+const DropdownMenuSub = DropdownMenuPrimitive.Sub;
+
+const DropdownMenuRadioGroup = DropdownMenuPrimitive.RadioGroup;
+
+function DropdownMenuSubTrigger({
+  children,
+  className,
+  inset,
+  ref,
+  ...props
+}: ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.SubTrigger> & {
+  inset?: boolean;
+} & { ref?: RefObject<ComponentRef<typeof DropdownMenuPrimitive.SubTrigger> | null> }) {
+  return (
+    <DropdownMenuPrimitive.SubTrigger
+      className={cn(
+        "flex cursor-default select-none items-center gap-2 rounded-lg px-3 py-2 text-sm outline-none",
+        "transition-colors duration-150",
+        "focus:bg-accent focus:text-accent-foreground",
+        "data-[state=open]:bg-accent data-[state=open]:text-accent-foreground",
+        "[&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0",
+        inset && "pl-8",
+        className,
+      )}
+      ref={ref}
+      {...props}
+    >
+      {children}
+      <ChevronRight className="ml-auto" />
+    </DropdownMenuPrimitive.SubTrigger>
+  );
+}
+DropdownMenuSubTrigger.displayName = DropdownMenuPrimitive.SubTrigger.displayName;
+
+function DropdownMenuSubContent({
+  className,
+  ref,
+  sideOffset = 8,
+  ...props
+}: ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.SubContent> & {
+  ref?: RefObject<ComponentRef<typeof DropdownMenuPrimitive.SubContent> | null>;
+}) {
+  return (
+    <DropdownMenuPrimitive.SubContent
+      className={cn(
+        "z-100 min-w-32 overflow-hidden rounded-xl p-1.5",
+        "border-border bg-popover text-popover-foreground border shadow-lg shadow-black/8",
+        "data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95",
+        "data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2",
+        "origin-[--radix-dropdown-menu-content-transform-origin]",
+        className,
+      )}
+      ref={ref}
+      sideOffset={sideOffset}
+      {...props}
+    />
+  );
+}
+DropdownMenuSubContent.displayName = DropdownMenuPrimitive.SubContent.displayName;
+
+function DropdownMenuContent({
+  className,
+  ref,
+  sideOffset = 4,
+  ...props
+}: ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Content> & {
+  ref?: RefObject<ComponentRef<typeof DropdownMenuPrimitive.Content> | null>;
+}) {
+  return (
+    <DropdownMenuPrimitive.Portal>
+      <DropdownMenuPrimitive.Content
+        className={cn(
+          "z-50 min-w-32 overflow-hidden rounded-xl p-1.5",
+          "border-border bg-popover text-popover-foreground border shadow-lg shadow-black/8",
+          "data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95",
+          "data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2",
+          "origin-[--radix-dropdown-menu-content-transform-origin]",
+          className,
+        )}
+        ref={ref}
+        sideOffset={sideOffset}
+        {...props}
+      />
+    </DropdownMenuPrimitive.Portal>
+  );
+}
+DropdownMenuContent.displayName = DropdownMenuPrimitive.Content.displayName;
+
+function DropdownMenuItem({
+  className,
+  destructive,
+  inset,
+  ref,
+  ...props
+}: ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Item> & {
+  destructive?: boolean;
+  inset?: boolean;
+} & { ref?: RefObject<ComponentRef<typeof DropdownMenuPrimitive.Item> | null> }) {
+  return (
+    <DropdownMenuPrimitive.Item
+      className={cn(
+        "relative flex cursor-default select-none items-center gap-2 rounded-lg px-3 py-2 text-sm outline-none",
+        "transition-colors duration-150",
+        destructive
+          ? "text-destructive focus:bg-destructive/10 focus:text-destructive"
+          : "focus:bg-accent focus:text-accent-foreground",
+        "data-disabled:pointer-events-none data-disabled:opacity-50",
+        "[&>svg]:size-4 [&>svg]:shrink-0",
+        inset && "pl-8",
+        className,
+      )}
+      ref={ref}
+      {...props}
+    />
+  );
+}
+DropdownMenuItem.displayName = DropdownMenuPrimitive.Item.displayName;
+
+function DropdownMenuCheckboxItem({
+  checked,
+  children,
+  className,
+  ref,
+  ...props
+}: ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.CheckboxItem> & {
+  ref?: RefObject<ComponentRef<typeof DropdownMenuPrimitive.CheckboxItem> | null>;
+}) {
+  return (
+    <DropdownMenuPrimitive.CheckboxItem
+      checked={checked}
+      className={cn(
+        "relative flex cursor-default select-none items-center rounded-lg py-2 pr-3 pl-8 text-sm outline-none",
+        "transition-colors duration-150",
+        "focus:bg-accent focus:text-accent-foreground",
+        "data-disabled:pointer-events-none data-disabled:opacity-50",
+        className,
+      )}
+      ref={ref}
+      {...props}
+    >
+      <span className="absolute left-2 flex h-3.5 w-3.5 items-center justify-center">
+        <DropdownMenuPrimitive.ItemIndicator>
+          <Check className="text-primary size-4" />
+        </DropdownMenuPrimitive.ItemIndicator>
+      </span>
+      {children}
+    </DropdownMenuPrimitive.CheckboxItem>
+  );
+}
+DropdownMenuCheckboxItem.displayName = DropdownMenuPrimitive.CheckboxItem.displayName;
+
+function DropdownMenuRadioItem({
+  children,
+  className,
+  ref,
+  ...props
+}: ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.RadioItem> & {
+  ref?: RefObject<ComponentRef<typeof DropdownMenuPrimitive.RadioItem> | null>;
+}) {
+  return (
+    <DropdownMenuPrimitive.RadioItem
+      className={cn(
+        "relative flex cursor-default select-none items-center rounded-lg py-2 pr-3 pl-8 text-sm outline-none",
+        "transition-colors duration-150",
+        "focus:bg-accent focus:text-accent-foreground",
+        "data-disabled:pointer-events-none data-disabled:opacity-50",
+        className,
+      )}
+      ref={ref}
+      {...props}
+    >
+      <span className="absolute left-2 flex h-3.5 w-3.5 items-center justify-center">
+        <DropdownMenuPrimitive.ItemIndicator>
+          <Circle className="text-primary size-2 fill-current" />
+        </DropdownMenuPrimitive.ItemIndicator>
+      </span>
+      {children}
+    </DropdownMenuPrimitive.RadioItem>
+  );
+}
+DropdownMenuRadioItem.displayName = DropdownMenuPrimitive.RadioItem.displayName;
+
+function DropdownMenuLabel({
+  className,
+  inset,
+  ref,
+  ...props
+}: ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Label> & {
+  inset?: boolean;
+} & { ref?: RefObject<ComponentRef<typeof DropdownMenuPrimitive.Label> | null> }) {
+  return (
+    <DropdownMenuPrimitive.Label
+      className={cn(
+        "text-muted-foreground px-3 py-1.5 text-xs font-medium",
+        inset && "pl-8",
+        className,
+      )}
+      ref={ref}
+      {...props}
+    />
+  );
+}
+DropdownMenuLabel.displayName = DropdownMenuPrimitive.Label.displayName;
+
+function DropdownMenuSeparator({
+  className,
+  ref,
+  ...props
+}: ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Separator> & {
+  ref?: RefObject<ComponentRef<typeof DropdownMenuPrimitive.Separator> | null>;
+}) {
+  return (
+    <DropdownMenuPrimitive.Separator
+      className={cn("bg-border -mx-1 my-1 h-px", className)}
+      ref={ref}
+      {...props}
+    />
+  );
+}
+DropdownMenuSeparator.displayName = DropdownMenuPrimitive.Separator.displayName;
+
+function DropdownMenuShortcut({ className, ...props }: HTMLAttributes<HTMLSpanElement>) {
+  return (
+    <span
+      className={cn("text-muted-foreground ml-auto text-xs tracking-widest", className)}
+      {...props}
+    />
+  );
+}
+DropdownMenuShortcut.displayName = "DropdownMenuShortcut";
+
+export {
+  DropdownMenu,
+  DropdownMenuCheckboxItem,
+  DropdownMenuContent,
+  DropdownMenuGroup,
+  DropdownMenuItem,
+  DropdownMenuLabel,
+  DropdownMenuPortal,
+  DropdownMenuRadioGroup,
+  DropdownMenuRadioItem,
+  DropdownMenuSeparator,
+  DropdownMenuShortcut,
+  DropdownMenuSub,
+  DropdownMenuSubContent,
+  DropdownMenuSubTrigger,
+  DropdownMenuTrigger,
+};

package/template/apps/web/src/components/empty-state.stories.tsx

@@ -0,0 +1,49 @@
+import type { Meta, StoryObj } from "@storybook/nextjs-vite";
+import { Inbox, SearchX } from "lucide-react";
+import { expect, within } from "storybook/test";
+import { Button } from "./button/button";
+import { EmptyState } from "./empty-state";
+
+const meta = {
+  args: { title: "No results found" },
+  component: EmptyState,
+  parameters: { layout: "centered" },
+  tags: ["autodocs"],
+} satisfies Meta<typeof EmptyState>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const TextOnly: Story = {
+  args: { className: "gap-1 p-3", title: "No modules found" },
+  play: async ({ canvasElement }) => {
+    await expect(within(canvasElement).getByText("No modules found")).toBeInTheDocument();
+  },
+};
+
+export const WithIcon: Story = {
+  args: { icon: SearchX, title: "No results found" },
+};
+
+export const WithDescription: Story = {
+  args: {
+    description: "Try a different search term or remove some filters.",
+    icon: SearchX,
+    title: "Nothing matched your search",
+  },
+};
+
+export const WithAction: Story = {
+  args: {
+    action: <Button size="sm">Create your first deck</Button>,
+    description: "Card decks you create or save show up here.",
+    icon: Inbox,
+    title: "No card decks yet",
+  },
+  play: async ({ canvasElement }) => {
+    await expect(
+      within(canvasElement).getByRole("button", { name: "Create your first deck" }),
+    ).toBeInTheDocument();
+  },
+};

package/template/apps/web/src/components/empty-state.tsx

@@ -0,0 +1,33 @@
+import type { LucideIcon } from "lucide-react";
+import type { ReactNode } from "react";
+import { cn } from "@/lib/utils";
+
+type EmptyStateProps = {
+  action?: ReactNode;
+  className?: string;
+  description?: string;
+  icon?: LucideIcon;
+  title: string;
+};
+
+/**
+ * Centered "nothing here" placeholder. Replaces the ad-hoc
+ * `<div class="text-muted-foreground text-center text-sm">…</div>` blocks that
+ * were copy-pasted across the search selectors and dropdowns.
+ */
+export function EmptyState({ action, className, description, icon: Icon, title }: EmptyStateProps) {
+  return (
+    <div
+      className={cn("flex flex-col items-center justify-center gap-2 p-6 text-center", className)}
+    >
+      {Icon ? (
+        <div className="bg-muted rounded-xl p-3">
+          <Icon aria-hidden className="text-muted-foreground size-6" strokeWidth={1.5} />
+        </div>
+      ) : null}
+      <p className="text-foreground text-sm font-medium">{title}</p>
+      {description ? <p className="text-muted-foreground max-w-xs text-xs">{description}</p> : null}
+      {action}
+    </div>
+  );
+}

package/template/apps/web/src/components/field-group.stories.tsx

@@ -0,0 +1,47 @@
+import type { Meta, StoryObj } from "@storybook/nextjs-vite";
+import { expect, within } from "storybook/test";
+import { withContainer } from "~sb/decorators";
+import { Input } from "@/components/input/input";
+import { FieldGroup } from "./field-group";
+
+const meta = {
+  component: FieldGroup,
+  decorators: [withContainer("w-90")],
+  parameters: { layout: "centered" },
+  tags: ["autodocs"],
+} satisfies Meta<typeof FieldGroup>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+const FRAMELESS =
+  "border-0 rounded-none bg-transparent shadow-none h-auto gap-0 px-0 focus-within:ring-0 focus-within:border-transparent";
+
+export const TwoRows: Story = {
+  args: {
+    children: (
+      <>
+        <Input
+          aria-label="Title"
+          containerClassName="gap-y-0 px-3 pt-2.5 pb-1"
+          frameClassName={FRAMELESS}
+          placeholder="Title"
+        />
+        <Input
+          aria-label="Description"
+          containerClassName="gap-y-0 px-3 pt-1 pb-2.5"
+          frameClassName={FRAMELESS}
+          placeholder="Description"
+          size="sm"
+        />
+      </>
+    ),
+  },
+  play: async ({ canvasElement }) => {
+    const canvas = within(canvasElement);
+
+    await expect(canvas.getByRole("textbox", { name: "Title" })).toBeInTheDocument();
+    await expect(canvas.getByRole("textbox", { name: "Description" })).toBeInTheDocument();
+  },
+};

package/template/apps/web/src/components/field-group.tsx

@@ -0,0 +1,20 @@
+import type { ReactNode } from "react";
+import { cn } from "@/lib/utils";
+
+/**
+ * Bordered container that visually merges a short stack of related fields into
+ * one control (title + description, module + professor). Each child is a row;
+ * rows carry their own padding (`px-3 py-2`) and are separated by a hairline.
+ */
+export function FieldGroup({ children, className }: { children: ReactNode; className?: string }) {
+  return (
+    <div
+      className={cn(
+        "divide-border bg-card border-input divide-y overflow-hidden rounded-lg border shadow-xs",
+        className,
+      )}
+    >
+      {children}
+    </div>
+  );
+}

package/template/apps/web/src/components/field-label.stories.tsx

@@ -0,0 +1,34 @@
+import type { Meta, StoryObj } from "@storybook/nextjs-vite";
+import { expect, within } from "storybook/test";
+import { FieldLabel } from "./field-label";
+
+const meta = {
+  args: {
+    children: "Email address",
+    htmlFor: "email",
+    required: false,
+  },
+  component: FieldLabel,
+  parameters: { layout: "centered" },
+  tags: ["autodocs"],
+} satisfies Meta<typeof FieldLabel>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  play: async ({ canvasElement }) => {
+    const label = within(canvasElement).getByText("Email address");
+
+    await expect(label).toHaveAttribute("for", "email");
+    await expect(within(canvasElement).queryByText("*")).not.toBeInTheDocument();
+  },
+};
+
+export const Required: Story = {
+  args: { required: true },
+  play: async ({ canvasElement }) => {
+    await expect(within(canvasElement).getByText("*")).toBeInTheDocument();
+  },
+};

package/template/apps/web/src/components/field-label.tsx

@@ -0,0 +1,28 @@
+import type { ReactNode } from "react";
+import { cn } from "@/lib/utils";
+
+type Props = {
+  children: ReactNode;
+  className?: string;
+  htmlFor: string;
+  required?: boolean;
+};
+
+export function FieldLabel({ children, className, htmlFor, required }: Props) {
+  return (
+    <label
+      className={cn(
+        "text-foreground/90 ml-0.5 flex items-center gap-1 text-sm font-medium",
+        className,
+      )}
+      htmlFor={htmlFor}
+    >
+      {children}
+      {required && (
+        <span aria-hidden className="text-destructive">
+          *
+        </span>
+      )}
+    </label>
+  );
+}

package/template/apps/web/src/components/icons.tsx

@@ -0,0 +1,25 @@
+import type { SVGProps } from "react";
+
+/** Brand glyphs lucide does not ship. */
+export const Icons = {
+  Google: (props: SVGProps<SVGSVGElement>) => (
+    <svg aria-hidden viewBox="0 0 24 24" {...props}>
+      <path
+        d="M22.56 12.25c0-.78-.07-1.53-.2-2.25H12v4.26h5.92c-.26 1.37-1.04 2.53-2.21 3.31v2.77h3.57c2.08-1.92 3.28-4.74 3.28-8.09z"
+        fill="#4285F4"
+      />
+      <path
+        d="M12 23c2.97 0 5.46-.98 7.28-2.66l-3.57-2.77c-.98.66-2.23 1.06-3.71 1.06-2.86 0-5.29-1.93-6.16-4.53H2.18v2.84C3.99 20.53 7.7 23 12 23z"
+        fill="#34A853"
+      />
+      <path
+        d="M5.84 14.09c-.22-.66-.35-1.36-.35-2.09s.13-1.43.35-2.09V7.07H2.18C1.43 8.55 1 10.22 1 12s.43 3.45 1.18 4.93l2.85-2.22.81-.62z"
+        fill="#FBBC05"
+      />
+      <path
+        d="M12 5.38c1.62 0 3.06.56 4.21 1.64l3.15-3.15C17.45 2.09 14.97 1 12 1 7.7 1 3.99 3.47 2.18 7.07l3.66 2.84c.87-2.6 3.3-4.53 6.16-4.53z"
+        fill="#EA4335"
+      />
+    </svg>
+  ),
+};

package/template/apps/web/src/components/input/input-otp.stories.tsx

@@ -0,0 +1,86 @@
+"use client";
+
+import type { Meta, StoryObj } from "@storybook/nextjs-vite";
+import { useState } from "react";
+import { expect, userEvent, within } from "storybook/test";
+import { InputOTP } from "./input-otp";
+
+const meta: Meta<typeof InputOTP> = {
+  args: {
+    label: "Verification code",
+    length: 6,
+    value: "",
+  },
+  argTypes: {
+    disabled: {
+      control: "boolean",
+    },
+    error: {
+      control: "text",
+    },
+    hint: {
+      control: "text",
+    },
+    length: {
+      control: { max: 8, min: 3, step: 1, type: "number" },
+    },
+    value: {
+      control: false,
+    },
+  },
+  component: InputOTP,
+  parameters: {
+    layout: "centered",
+  },
+  tags: ["autodocs"],
+} satisfies Meta<typeof InputOTP>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  play: async ({ canvasElement }) => {
+    const canvas = within(canvasElement);
+    const cells = canvas.getAllByRole("textbox");
+
+    await expect(cells).toHaveLength(6);
+
+    await userEvent.type(cells[0], "4");
+    await expect(cells[0]).toHaveValue("4");
+  },
+  render: (args) => {
+    const [code, setCode] = useState(args.value);
+
+    return (
+      <InputOTP
+        {...args}
+        onChange={(next) => {
+          setCode(next);
+          args.onChange?.(next);
+        }}
+        onComplete={(next) => {
+          args.onComplete?.(next);
+        }}
+        value={code}
+      />
+    );
+  },
+};
+
+export const WithHint: Story = {
+  args: {
+    hint: "Enter the 6-digit code we emailed you.",
+  },
+};
+
+export const WithError: Story = {
+  args: {
+    error: "The code you entered is invalid.",
+  },
+};
+
+export const Disabled: Story = {
+  args: {
+    disabled: true,
+  },
+};