@repraze/kernelkit 0.0.0-stage → 0.1.0-alpha.1

package/src/components/input-group.tsx

@@ -0,0 +1,186 @@
+"use client";
+
+import {Button} from "@repraze/kernelkit/components/button";
+import {Input} from "@repraze/kernelkit/components/input";
+import {Textarea} from "@repraze/kernelkit/components/textarea";
+import {fieldSurface} from "@repraze/kernelkit/lib/recipes";
+import {cva, type VariantProps} from "class-variance-authority";
+import {cn} from "cn";
+import * as React from "react";
+
+const inputGroupVariants = cva(
+    [
+        fieldSurface,
+        "group/input-group relative flex w-full min-w-0 items-center outline-none",
+        // focus ring on the container while its control has focus (§6 composite controls)
+        "has-[[data-slot=input-group-control]:focus-visible]:border-ring has-[[data-slot=input-group-control]:focus-visible]:ring-3 has-[[data-slot=input-group-control]:focus-visible]:ring-ring/50",
+        "has-aria-invalid:border-danger has-aria-invalid:ring-3 has-aria-invalid:ring-danger/20 dark:has-aria-invalid:ring-danger/40",
+        "has-[[data-slot=input-group-control]:disabled]:bg-field-disabled has-[[data-slot=input-group-control]:disabled]:opacity-50 hc:has-[[data-slot=input-group-control]:disabled]:bg-transparent dark:hc:has-[[data-slot=input-group-control]:disabled]:bg-transparent",
+        // inside a combobox popup the search field sits flush, no ring
+        "in-data-[slot=combobox-content]:focus-within:border-inherit in-data-[slot=combobox-content]:focus-within:ring-0",
+        // block addons stack above / below the control
+        "has-[>[data-align=block-end]]:h-auto has-[>[data-align=block-end]]:flex-col has-[>[data-align=block-start]]:h-auto has-[>[data-align=block-start]]:flex-col has-[>textarea]:h-auto",
+        "has-[>[data-align=block-end]]:[&>input]:h-8 has-[>[data-align=block-end]]:[&>input]:pt-3 has-[>[data-align=block-start]]:[&>input]:h-8 has-[>[data-align=block-start]]:[&>input]:pb-3",
+        "has-[>[data-align=inline-end]]:[&>input]:pr-1.5 has-[>[data-align=inline-start]]:[&>input]:pl-1.5",
+    ],
+    {
+        variants: {
+            size: {
+                sm: "h-7 rounded-md text-[0.8rem]",
+                default: "h-8",
+                lg: "h-9",
+            },
+        },
+        defaultVariants: {size: "default"},
+    },
+);
+
+function InputGroup({
+    className,
+    size = "default",
+    ...props
+}: React.ComponentProps<"div"> & VariantProps<typeof inputGroupVariants>) {
+    return (
+        <div
+            data-slot="input-group"
+            data-size={size}
+            role="group"
+            className={cn(inputGroupVariants({size}), className)}
+            {...props}
+        />
+    );
+}
+
+const inputGroupAddonVariants = cva(
+    "flex h-auto cursor-text items-center justify-center gap-2 py-1.5 text-sm font-medium text-muted-foreground select-none group-has-[[data-slot=input-group-control]:disabled]/input-group:opacity-50 [&>kbd]:rounded-md [&>svg:not([class*='size-'])]:size-4 group-data-[size=sm]/input-group:text-[0.8rem] group-data-[size=sm]/input-group:[&>svg:not([class*='size-'])]:size-3.5",
+    {
+        variants: {
+            align: {
+                "inline-start": "order-first pl-2 has-[>button]:ml-[-0.3rem] has-[>kbd]:ml-[-0.15rem]",
+                "inline-end": "order-last pr-2 has-[>button]:mr-[-0.3rem] has-[>kbd]:mr-[-0.15rem]",
+                "block-start":
+                    "order-first w-full justify-start px-2.5 pt-2 group-has-[>input]/input-group:pt-2 [.border-b]:pb-2",
+                "block-end":
+                    "order-last w-full justify-start px-2.5 pb-2 group-has-[>input]/input-group:pb-2 [.border-t]:pt-2",
+            },
+        },
+        defaultVariants: {
+            align: "inline-start",
+        },
+    },
+);
+
+function InputGroupAddon({
+    className,
+    align = "inline-start",
+    onClick,
+    ...props
+}: React.ComponentProps<"div"> & VariantProps<typeof inputGroupAddonVariants>) {
+    return (
+        <div
+            role="group"
+            data-slot="input-group-addon"
+            data-align={align}
+            className={cn(inputGroupAddonVariants({align}), className)}
+            onClick={(e) => {
+                onClick?.(e);
+                if (e.defaultPrevented || (e.target as HTMLElement).closest("button")) {
+                    return;
+                }
+                e.currentTarget.parentElement?.querySelector<HTMLElement>("[data-slot=input-group-control]")?.focus();
+            }}
+            {...props}
+        />
+    );
+}
+
+const inputGroupButtonVariants = cva("flex items-center gap-2 text-sm shadow-none", {
+    variants: {
+        size: {
+            xs: "h-6 gap-1 rounded-md px-1.5 [&>svg:not([class*='size-'])]:size-3.5",
+            sm: "",
+            "icon-xs": "size-6 rounded-md p-0 has-[>svg]:p-0",
+            "icon-sm": "size-8 p-0 has-[>svg]:p-0",
+        },
+    },
+    defaultVariants: {
+        size: "xs",
+    },
+});
+
+function InputGroupButton({
+    className,
+    type = "button",
+    variant = "ghost",
+    size = "xs",
+    ...props
+}: Omit<React.ComponentProps<typeof Button>, "size" | "type"> &
+    VariantProps<typeof inputGroupButtonVariants> & {
+        type?: "button" | "submit" | "reset";
+    }) {
+    return (
+        <Button
+            type={type}
+            data-size={size}
+            variant={variant}
+            className={cn(
+                inputGroupButtonVariants({size}),
+                // a small group gets a smaller button so it keeps a 2px inset
+                "group-data-[size=sm]/input-group:data-[size=icon-xs]:size-5 group-data-[size=sm]/input-group:data-[size=icon-xs]:rounded-sm group-data-[size=sm]/input-group:data-[size=xs]:h-5 group-data-[size=sm]/input-group:data-[size=xs]:rounded-sm",
+                className,
+            )}
+            {...props}
+        />
+    );
+}
+
+function InputGroupText({className, ...props}: React.ComponentProps<"span">) {
+    return (
+        <span
+            data-slot="input-group-text"
+            className={cn(
+                "flex items-center gap-2 text-sm text-muted-foreground group-data-[size=sm]/input-group:text-[0.8rem] [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4",
+                className,
+            )}
+            {...props}
+        />
+    );
+}
+
+function InputGroupInput({className, ...props}: React.ComponentProps<typeof Input>) {
+    return (
+        <Input
+            data-slot="input-group-control"
+            className={cn(
+                "h-full flex-1 rounded-none border-0 bg-transparent shadow-none ring-0 focus-visible:ring-0 disabled:bg-transparent aria-invalid:ring-0 dark:bg-transparent dark:disabled:bg-transparent",
+                "group-data-[size=sm]/input-group:px-2 group-data-[size=sm]/input-group:md:text-[0.8rem] group-data-[size=lg]/input-group:px-3",
+                className,
+            )}
+            {...props}
+        />
+    );
+}
+
+function InputGroupTextarea({className, ...props}: React.ComponentProps<"textarea">) {
+    return (
+        <Textarea
+            data-slot="input-group-control"
+            className={cn(
+                "flex-1 resize-none rounded-none border-0 bg-transparent py-2 shadow-none ring-0 focus-visible:ring-0 disabled:bg-transparent aria-invalid:ring-0 dark:bg-transparent dark:disabled:bg-transparent",
+                className,
+            )}
+            {...props}
+        />
+    );
+}
+
+export {
+    InputGroup,
+    InputGroupAddon,
+    InputGroupButton,
+    inputGroupButtonVariants,
+    InputGroupInput,
+    InputGroupText,
+    InputGroupTextarea,
+    inputGroupVariants,
+};

package/src/components/input-otp.tsx

@@ -0,0 +1,82 @@
+"use client";
+
+import {cn} from "cn";
+import {OTPInput, OTPInputContext} from "input-otp";
+import {MinusIcon} from "lucide-react";
+import * as React from "react";
+
+/** Pass `aria-invalid` to `InputOTP` (it lands on the hidden input) and every slot turns danger. */
+function InputOTP({
+    className,
+    containerClassName,
+    ...props
+}: React.ComponentProps<typeof OTPInput> & {
+    containerClassName?: string;
+}) {
+    return (
+        <OTPInput
+            data-slot="input-otp"
+            containerClassName={cn(
+                "group/input-otp cn-input-otp flex items-center gap-2 has-disabled:opacity-50",
+                containerClassName,
+            )}
+            spellCheck={false}
+            className={cn("disabled:cursor-not-allowed", className)}
+            {...props}
+        />
+    );
+}
+
+function InputOTPGroup({className, ...props}: React.ComponentProps<"div">) {
+    return <div data-slot="input-otp-group" className={cn("flex items-center rounded-lg", className)} {...props} />;
+}
+
+function InputOTPSlot({
+    index,
+    className,
+    ...props
+}: React.ComponentProps<"div"> & {
+    index: number;
+}) {
+    const inputOTPContext = React.useContext(OTPInputContext);
+    const {char, hasFakeCaret, isActive} = inputOTPContext?.slots[index] ?? {};
+
+    return (
+        <div
+            data-slot="input-otp-slot"
+            data-active={isActive}
+            className={cn(
+                "relative flex size-8 items-center justify-center border-y border-r border-input font-mono text-sm tabular-nums transition-[color,background-color,border-color,box-shadow] outline-none first:rounded-l-lg first:border-l last:rounded-r-lg bg-field hc:bg-transparent dark:hc:bg-transparent",
+                "group-has-disabled/input-otp:bg-field-disabled",
+                "data-[active=true]:z-10 data-[active=true]:border-ring data-[active=true]:ring-3 data-[active=true]:ring-ring/50",
+                // invalid: on the slot itself or on the OTP input
+                "aria-invalid:border-danger group-has-[input[aria-invalid=true]]/input-otp:border-danger",
+                "data-[active=true]:aria-invalid:ring-danger/20 group-has-[input[aria-invalid=true]]/input-otp:data-[active=true]:ring-danger/20 dark:data-[active=true]:aria-invalid:ring-danger/40 dark:group-has-[input[aria-invalid=true]]/input-otp:data-[active=true]:ring-danger/40",
+                className,
+            )}
+            {...props}
+        >
+            {char}
+            {hasFakeCaret && (
+                <div className="pointer-events-none absolute inset-0 flex items-center justify-center">
+                    <div className="h-4 w-px animate-caret-blink bg-foreground duration-1000" />
+                </div>
+            )}
+        </div>
+    );
+}
+
+function InputOTPSeparator({className, ...props}: React.ComponentProps<"div">) {
+    return (
+        <div
+            data-slot="input-otp-separator"
+            className={cn("flex items-center text-muted-foreground [&_svg:not([class*='size-'])]:size-4", className)}
+            role="separator"
+            {...props}
+        >
+            <MinusIcon />
+        </div>
+    );
+}
+
+export {InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot};

package/src/components/input.tsx

@@ -0,0 +1,50 @@
+"use client";
+
+import {Input as InputPrimitive} from "@base-ui/react/input";
+import {fieldSurface, focusRing, invalidRing} from "@repraze/kernelkit/lib/recipes";
+import {cva} from "class-variance-authority";
+import {cn} from "cn";
+import * as React from "react";
+
+const inputVariants = cva(
+    [
+        fieldSurface,
+        focusRing,
+        invalidRing,
+        "w-full min-w-0 py-1 text-base md:text-sm",
+        "file:inline-flex file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground",
+    ],
+    {
+        variants: {
+            // Same heights as Button / Select / Tabs (GUIDELINES.md §4) so mixed rows line up.
+            size: {
+                sm: "h-7 rounded-md px-2 file:h-5 md:text-[0.8rem]",
+                default: "h-8 px-2.5 file:h-6",
+                lg: "h-9 px-3 file:h-7",
+            },
+        },
+        defaultVariants: {size: "default"},
+    },
+);
+
+interface InputProps extends Omit<React.ComponentProps<"input">, "size"> {
+    size?: "sm" | "default" | "lg";
+    /** Native `size` attribute (character width), renamed since `size` is the control size. */
+    htmlSize?: number;
+}
+
+function Input({className, type, size = "default", htmlSize, ...props}: InputProps) {
+    return (
+        <InputPrimitive
+            type={type}
+            data-slot="input"
+            data-size={size}
+            size={htmlSize}
+            className={cn(inputVariants({size}), className)}
+            {...props}
+        />
+    );
+}
+
+export {Input, inputVariants};
+export type {InputProps};

package/src/components/item.tsx

@@ -0,0 +1,191 @@
+"use client";
+
+import {mergeProps} from "@base-ui/react/merge-props";
+import {useRender} from "@base-ui/react/use-render";
+import {Separator} from "@repraze/kernelkit/components/separator";
+import {focusRing} from "@repraze/kernelkit/lib/recipes";
+import {cva, type VariantProps} from "class-variance-authority";
+import {cn} from "cn";
+import * as React from "react";
+
+function ItemGroup({className, ...props}: React.ComponentProps<"div">) {
+    return (
+        <div
+            role="list"
+            data-slot="item-group"
+            className={cn(
+                "group/item-group flex w-full flex-col gap-4 has-data-[size=sm]:gap-2.5 has-data-[size=xs]:gap-2",
+                className,
+            )}
+            {...props}
+        />
+    );
+}
+
+function ItemSeparator({className, ...props}: React.ComponentProps<typeof Separator>) {
+    return (
+        <Separator data-slot="item-separator" orientation="horizontal" className={cn("my-2", className)} {...props} />
+    );
+}
+
+const itemVariants = cva(
+    [
+        "group/item flex w-full flex-wrap items-center rounded-lg border text-sm transition-[color,background-color,border-color,box-shadow] duration-100",
+        focusRing,
+        // interactive items (rendered as a link or button) get the hover wash; selected = border + tint
+        "[a]:hover:bg-hover [button]:hover:bg-hover [button]:text-left aria-[current=page]:border-primary-text aria-[current=page]:bg-accent aria-selected:border-primary-text aria-selected:bg-accent",
+    ],
+    {
+        variants: {
+            variant: {
+                default: "border-transparent",
+                outline: "border-border",
+                muted: "border-transparent bg-muted/50",
+            },
+            size: {
+                default: "gap-3 px-4 py-3",
+                sm: "gap-2.5 px-3 py-2.5",
+                xs: "gap-2 px-2.5 py-2 in-data-[slot=dropdown-menu-content]:p-0",
+            },
+        },
+        defaultVariants: {
+            variant: "default",
+            size: "default",
+        },
+    },
+);
+
+function Item({
+    className,
+    variant = "default",
+    size = "default",
+    render,
+    ...props
+}: useRender.ComponentProps<"div"> & VariantProps<typeof itemVariants>) {
+    return useRender({
+        defaultTagName: "div",
+        props: mergeProps<"div">(
+            {
+                className: cn(itemVariants({variant, size, className})),
+            },
+            props,
+        ),
+        render,
+        state: {
+            slot: "item",
+            variant,
+            size,
+        },
+    });
+}
+
+const itemMediaVariants = cva(
+    "flex shrink-0 items-center justify-center gap-2 group-has-data-[slot=item-description]/item:translate-y-0.5 group-has-data-[slot=item-description]/item:self-start [&_svg]:pointer-events-none",
+    {
+        variants: {
+            variant: {
+                default: "bg-transparent",
+                icon: "[&_svg:not([class*='size-'])]:size-4",
+                /** Boxed icon tile, aligned with the image size. */
+                tile: "size-8 rounded-md border border-border bg-muted text-muted-foreground group-data-[size=xs]/item:size-6 [&_svg:not([class*='size-'])]:size-4",
+                image: "size-10 overflow-hidden rounded-md group-data-[size=sm]/item:size-8 group-data-[size=xs]/item:size-6 [&_img]:size-full [&_img]:object-cover",
+            },
+        },
+        defaultVariants: {
+            variant: "default",
+        },
+    },
+);
+
+function ItemMedia({
+    className,
+    variant = "default",
+    ...props
+}: React.ComponentProps<"div"> & VariantProps<typeof itemMediaVariants>) {
+    return (
+        <div
+            data-slot="item-media"
+            data-variant={variant}
+            className={cn(itemMediaVariants({variant, className}))}
+            {...props}
+        />
+    );
+}
+
+function ItemContent({className, ...props}: React.ComponentProps<"div">) {
+    return (
+        <div
+            data-slot="item-content"
+            className={cn(
+                "flex flex-1 flex-col gap-1 group-data-[size=xs]/item:gap-0 [&+[data-slot=item-content]]:flex-none",
+                className,
+            )}
+            {...props}
+        />
+    );
+}
+
+function ItemTitle({className, ...props}: React.ComponentProps<"div">) {
+    return (
+        <div
+            data-slot="item-title"
+            className={cn(
+                "line-clamp-1 flex w-fit items-center gap-2 text-sm leading-snug font-medium underline-offset-4",
+                className,
+            )}
+            {...props}
+        />
+    );
+}
+
+function ItemDescription({className, ...props}: React.ComponentProps<"p">) {
+    return (
+        <p
+            data-slot="item-description"
+            className={cn(
+                "line-clamp-2 text-left text-sm leading-normal font-normal text-muted-foreground group-data-[size=xs]/item:text-xs [&>a]:underline [&>a]:underline-offset-4 [&>a:hover]:text-foreground",
+                className,
+            )}
+            {...props}
+        />
+    );
+}
+
+function ItemActions({className, ...props}: React.ComponentProps<"div">) {
+    return <div data-slot="item-actions" className={cn("flex items-center gap-2", className)} {...props} />;
+}
+
+function ItemHeader({className, ...props}: React.ComponentProps<"div">) {
+    return (
+        <div
+            data-slot="item-header"
+            className={cn("flex basis-full items-center justify-between gap-2", className)}
+            {...props}
+        />
+    );
+}
+
+function ItemFooter({className, ...props}: React.ComponentProps<"div">) {
+    return (
+        <div
+            data-slot="item-footer"
+            className={cn("flex basis-full items-center justify-between gap-2", className)}
+            {...props}
+        />
+    );
+}
+
+export {
+    Item,
+    ItemActions,
+    ItemContent,
+    ItemDescription,
+    ItemFooter,
+    ItemGroup,
+    ItemHeader,
+    ItemMedia,
+    itemMediaVariants,
+    ItemSeparator,
+    ItemTitle,
+    itemVariants,
+};

package/src/components/kbd.tsx

@@ -0,0 +1,39 @@
+"use client";
+
+import {cva} from "class-variance-authority";
+import {cn} from "cn";
+import type * as React from "react";
+
+/** A keycap: mono, `rounded-sm`, a thicker bottom border for the key look (readable in hc). */
+const kbdVariants = cva(
+    [
+        "pointer-events-none inline-flex w-fit items-center justify-center gap-1 rounded-sm border border-b-2 border-border bg-muted font-mono font-medium text-muted-foreground select-none [&_svg]:shrink-0",
+        // inside a tooltip (inverted surface) the key becomes a translucent chip
+        "in-data-[slot=tooltip-content]:border-transparent in-data-[slot=tooltip-content]:bg-background/20 in-data-[slot=tooltip-content]:text-background dark:in-data-[slot=tooltip-content]:bg-background/10",
+    ],
+    {
+        variants: {
+            size: {
+                sm: "h-4 min-w-4 px-0.5 text-[0.625rem] [&_svg:not([class*='size-'])]:size-2.5",
+                default: "h-5 min-w-5 px-1 text-xs [&_svg:not([class*='size-'])]:size-3",
+            },
+        },
+        defaultVariants: {size: "default"},
+    },
+);
+
+function Kbd({className, size = "default", ...props}: React.ComponentProps<"kbd"> & {size?: "sm" | "default"}) {
+    return <kbd data-slot="kbd" data-size={size} className={cn(kbdVariants({size}), className)} {...props} />;
+}
+
+function KbdGroup({className, ...props}: React.ComponentProps<"kbd">) {
+    return (
+        <kbd
+            data-slot="kbd-group"
+            className={cn("inline-flex items-center gap-1 font-mono text-xs text-muted-foreground", className)}
+            {...props}
+        />
+    );
+}
+
+export {Kbd, KbdGroup, kbdVariants};

package/src/components/label.tsx

@@ -0,0 +1,19 @@
+"use client";
+
+import {cn} from "cn";
+import * as React from "react";
+
+function Label({className, ...props}: React.ComponentProps<"label">) {
+    return (
+        <label
+            data-slot="label"
+            className={cn(
+                "flex items-center gap-2 text-sm leading-none font-medium select-none group-data-[disabled=true]:pointer-events-none group-data-[disabled=true]:opacity-50 peer-disabled:cursor-not-allowed peer-disabled:opacity-50 peer-data-disabled:cursor-not-allowed peer-data-disabled:opacity-50 has-data-disabled:cursor-not-allowed has-data-disabled:opacity-50",
+                className,
+            )}
+            {...props}
+        />
+    );
+}
+
+export {Label};

package/src/components/marker.tsx

@@ -0,0 +1,69 @@
+"use client";
+
+import {mergeProps} from "@base-ui/react/merge-props";
+import {useRender} from "@base-ui/react/use-render";
+import {cva, type VariantProps} from "class-variance-authority";
+import {cn} from "cn";
+import * as React from "react";
+
+const markerVariants = cva(
+    "group/marker relative flex min-h-4 w-full items-center gap-2 text-left text-sm text-muted-foreground [&_svg:not([class*='size-'])]:size-4 [a]:underline [a]:underline-offset-3 [a]:hover:text-foreground",
+    {
+        variants: {
+            variant: {
+                default: "",
+                separator:
+                    "before:mr-1 before:h-px before:min-w-0 before:flex-1 before:bg-border after:ml-1 after:h-px after:min-w-0 after:flex-1 after:bg-border",
+                border: "border-b border-border pb-2",
+            },
+        },
+    },
+);
+
+function Marker({
+    className,
+    variant = "default",
+    render,
+    ...props
+}: useRender.ComponentProps<"div"> & VariantProps<typeof markerVariants>) {
+    return useRender({
+        defaultTagName: "div",
+        props: mergeProps<"div">(
+            {
+                className: cn(markerVariants({variant, className})),
+            },
+            props,
+        ),
+        render,
+        state: {
+            slot: "marker",
+            variant,
+        },
+    });
+}
+
+function MarkerIcon({className, ...props}: React.ComponentProps<"span">) {
+    return (
+        <span
+            data-slot="marker-icon"
+            aria-hidden="true"
+            className={cn("size-4 shrink-0 [&_svg:not([class*='size-'])]:size-4", className)}
+            {...props}
+        />
+    );
+}
+
+function MarkerContent({className, ...props}: React.ComponentProps<"span">) {
+    return (
+        <span
+            data-slot="marker-content"
+            className={cn(
+                "min-w-0 wrap-break-word group-data-[variant=separator]/marker:flex-none group-data-[variant=separator]/marker:text-center *:[a]:underline *:[a]:underline-offset-3 *:[a]:hover:text-foreground",
+                className,
+            )}
+            {...props}
+        />
+    );
+}
+
+export {Marker, MarkerContent, MarkerIcon, markerVariants};