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

package/src/components/carousel.tsx

@@ -0,0 +1,294 @@
+"use client";
+
+import {Button} from "@repraze/kernelkit/components/button";
+import {focusRing} from "@repraze/kernelkit/lib/recipes";
+import {cn} from "cn";
+import useEmblaCarousel, {type UseEmblaCarouselType} from "embla-carousel-react";
+import {ChevronLeftIcon, ChevronRightIcon} from "lucide-react";
+import * as React from "react";
+
+type CarouselApi = UseEmblaCarouselType[1];
+type UseCarouselParameters = Parameters<typeof useEmblaCarousel>;
+type CarouselOptions = UseCarouselParameters[0];
+type CarouselPlugin = UseCarouselParameters[1];
+
+type CarouselProps = {
+    opts?: CarouselOptions;
+    plugins?: CarouselPlugin;
+    orientation?: "horizontal" | "vertical";
+    setApi?: (api: CarouselApi) => void;
+};
+
+type CarouselContextProps = {
+    carouselRef: ReturnType<typeof useEmblaCarousel>[0];
+    api: ReturnType<typeof useEmblaCarousel>[1];
+    scrollPrev: () => void;
+    scrollNext: () => void;
+    canScrollPrev: boolean;
+    canScrollNext: boolean;
+} & CarouselProps;
+
+const CarouselContext = React.createContext<CarouselContextProps | null>(null);
+
+function useCarousel() {
+    const context = React.useContext(CarouselContext);
+
+    if (!context) {
+        throw new Error("useCarousel must be used within a <Carousel />");
+    }
+
+    return context;
+}
+
+function Carousel({
+    orientation = "horizontal",
+    opts,
+    setApi,
+    plugins,
+    className,
+    children,
+    ...props
+}: React.ComponentProps<"div"> & CarouselProps) {
+    const [carouselRef, api] = useEmblaCarousel(
+        {
+            ...opts,
+            axis: orientation === "horizontal" ? "x" : "y",
+        },
+        plugins,
+    );
+    const [canScrollPrev, setCanScrollPrev] = React.useState(false);
+    const [canScrollNext, setCanScrollNext] = React.useState(false);
+
+    const onSelect = React.useCallback((api: CarouselApi) => {
+        if (!api) {
+            return;
+        }
+        setCanScrollPrev(api.canScrollPrev());
+        setCanScrollNext(api.canScrollNext());
+    }, []);
+
+    const scrollPrev = React.useCallback(() => {
+        api?.scrollPrev();
+    }, [api]);
+
+    const scrollNext = React.useCallback(() => {
+        api?.scrollNext();
+    }, [api]);
+
+    const handleKeyDown = React.useCallback(
+        (event: React.KeyboardEvent<HTMLDivElement>) => {
+            if (event.key === "ArrowLeft") {
+                event.preventDefault();
+                scrollPrev();
+            } else if (event.key === "ArrowRight") {
+                event.preventDefault();
+                scrollNext();
+            }
+        },
+        [scrollPrev, scrollNext],
+    );
+
+    React.useEffect(() => {
+        if (!api || !setApi) {
+            return;
+        }
+        setApi(api);
+    }, [api, setApi]);
+
+    React.useEffect(() => {
+        if (!api) {
+            return;
+        }
+        onSelect(api);
+        api.on("reInit", onSelect);
+        api.on("select", onSelect);
+
+        return () => {
+            api.off("reInit", onSelect);
+            api.off("select", onSelect);
+        };
+    }, [api, onSelect]);
+
+    return (
+        <CarouselContext.Provider
+            value={{
+                carouselRef,
+                api,
+                opts,
+                orientation: orientation || (opts?.axis === "y" ? "vertical" : "horizontal"),
+                scrollPrev,
+                scrollNext,
+                canScrollPrev,
+                canScrollNext,
+            }}
+        >
+            <div
+                onKeyDownCapture={handleKeyDown}
+                className={cn("relative", className)}
+                role="region"
+                aria-roledescription="carousel"
+                data-slot="carousel"
+                {...props}
+            >
+                {children}
+            </div>
+        </CarouselContext.Provider>
+    );
+}
+
+function CarouselContent({className, ...props}: React.ComponentProps<"div">) {
+    const {carouselRef, orientation} = useCarousel();
+
+    return (
+        <div ref={carouselRef} className="overflow-hidden" data-slot="carousel-content">
+            <div
+                data-slot="carousel-track"
+                className={cn("flex", orientation === "horizontal" ? "-ml-4" : "-mt-4 flex-col", className)}
+                {...props}
+            />
+        </div>
+    );
+}
+
+function CarouselItem({className, ...props}: React.ComponentProps<"div">) {
+    const {orientation} = useCarousel();
+
+    return (
+        <div
+            role="group"
+            aria-roledescription="slide"
+            data-slot="carousel-item"
+            className={cn(
+                "min-w-0 shrink-0 grow-0 basis-full",
+                orientation === "horizontal" ? "pl-4" : "pt-4",
+                className,
+            )}
+            {...props}
+        />
+    );
+}
+
+function CarouselPrevious({
+    className,
+    variant = "outline",
+    size = "icon-sm",
+    ...props
+}: React.ComponentProps<typeof Button>) {
+    const {orientation, scrollPrev, canScrollPrev} = useCarousel();
+
+    return (
+        <Button
+            data-slot="carousel-previous"
+            variant={variant}
+            size={size}
+            className={cn(
+                "absolute touch-manipulation rounded-pill",
+                orientation === "horizontal"
+                    ? "inset-y-0 -left-12 my-auto"
+                    : "-top-12 left-1/2 -translate-x-1/2 rotate-90",
+                className,
+            )}
+            disabled={!canScrollPrev}
+            onClick={scrollPrev}
+            {...props}
+        >
+            <ChevronLeftIcon />
+            <span className="sr-only">Previous slide</span>
+        </Button>
+    );
+}
+
+function CarouselNext({
+    className,
+    variant = "outline",
+    size = "icon-sm",
+    ...props
+}: React.ComponentProps<typeof Button>) {
+    const {orientation, scrollNext, canScrollNext} = useCarousel();
+
+    return (
+        <Button
+            data-slot="carousel-next"
+            variant={variant}
+            size={size}
+            className={cn(
+                "absolute touch-manipulation rounded-pill",
+                orientation === "horizontal"
+                    ? "inset-y-0 -right-12 my-auto"
+                    : "-bottom-12 left-1/2 -translate-x-1/2 rotate-90",
+                className,
+            )}
+            disabled={!canScrollNext}
+            onClick={scrollNext}
+            {...props}
+        >
+            <ChevronRightIcon />
+            <span className="sr-only">Next slide</span>
+        </Button>
+    );
+}
+
+/** One dot per snap point; the current one is a wider primary pill (selected = fill, §6). */
+function CarouselDots({className, ...props}: React.ComponentProps<"div">) {
+    const {api, orientation} = useCarousel();
+    const [snaps, setSnaps] = React.useState<number[]>([]);
+    const [current, setCurrent] = React.useState(0);
+
+    React.useEffect(() => {
+        if (!api) {
+            return;
+        }
+        const update = () => {
+            setSnaps(api.scrollSnapList());
+            setCurrent(api.selectedScrollSnap());
+        };
+        update();
+        api.on("reInit", update);
+        api.on("select", update);
+        return () => {
+            api.off("reInit", update);
+            api.off("select", update);
+        };
+    }, [api]);
+
+    return (
+        <div
+            data-slot="carousel-dots"
+            className={cn(
+                "flex items-center justify-center gap-1.5",
+                orientation === "horizontal" ? "pt-3" : "flex-col pl-3",
+                className,
+            )}
+            {...props}
+        >
+            {snaps.map((_, index) => (
+                <button
+                    key={index}
+                    type="button"
+                    data-slot="carousel-dot"
+                    data-active={index === current || undefined}
+                    aria-label={`Go to slide ${index + 1}`}
+                    aria-current={index === current || undefined}
+                    onClick={() => api?.scrollTo(index)}
+                    className={cn(
+                        focusRing,
+                        "size-2 rounded-pill bg-border transition-[width,height,background-color,box-shadow] duration-150 hover:bg-primary/50 motion-reduce:transition-none",
+                        "data-active:bg-primary-text",
+                        orientation === "horizontal" ? "data-active:w-5" : "data-active:h-5",
+                    )}
+                />
+            ))}
+        </div>
+    );
+}
+
+export {
+    Carousel,
+    type CarouselApi,
+    CarouselContent,
+    CarouselDots,
+    CarouselItem,
+    CarouselNext,
+    CarouselPrevious,
+    useCarousel,
+};

package/src/components/chart.tsx

@@ -0,0 +1,332 @@
+"use client";
+
+import {popupSurface} from "@repraze/kernelkit/lib/recipes";
+import {cn} from "cn";
+import * as React from "react";
+import type {TooltipValueType} from "recharts";
+import * as RechartsPrimitive from "recharts";
+
+// Format: { THEME_NAME: CSS_SELECTOR }
+const THEMES = {light: "", dark: ".dark"} as const;
+
+// Recharts paints its chrome with presentation attributes (light-grey and white strokes): re-skin them with
+// tokens. The attribute selectors only match recharts' own defaults, so a stroke set by the app wins.
+const rechartsDefaults = [
+    "[&_.recharts-cartesian-grid_line[stroke='#ccc']]:stroke-border", // lint-design-ignore: matches recharts' default attr
+    "[&_.recharts-polar-grid_[stroke='#ccc']]:stroke-border", // lint-design-ignore: matches recharts' default attr
+    "[&_.recharts-reference-line_[stroke='#ccc']]:stroke-border", // lint-design-ignore: matches recharts' default attr
+    "[&_.recharts-dot[stroke='#fff']]:stroke-card", // lint-design-ignore: matches recharts' default attr
+    "[&_.recharts-sector[stroke='#fff']]:stroke-card", // lint-design-ignore: matches recharts' default attr
+];
+
+const chartContainerClass = [
+    "flex aspect-video justify-center text-xs",
+    "[&_.recharts-cartesian-axis-tick_text]:fill-muted-foreground [&_.recharts-cartesian-axis-tick_text]:font-mono",
+    "[&_.recharts-curve.recharts-tooltip-cursor]:stroke-border [&_.recharts-rectangle.recharts-tooltip-cursor]:fill-hover",
+    "[&_.recharts-radial-bar-background-sector]:fill-muted",
+    "[&_.recharts-layer]:outline-hidden [&_.recharts-sector]:outline-hidden [&_.recharts-surface]:outline-hidden",
+    ...rechartsDefaults,
+];
+
+const INITIAL_DIMENSION = {width: 320, height: 200} as const;
+type TooltipNameType = number | string;
+
+export type ChartConfig = Record<
+    string,
+    {
+        label?: React.ReactNode;
+        icon?: React.ComponentType;
+    } & ({color?: string; theme?: never} | {color?: never; theme: Record<keyof typeof THEMES, string>})
+>;
+
+type ChartContextProps = {
+    config: ChartConfig;
+};
+
+const ChartContext = React.createContext<ChartContextProps | null>(null);
+
+function useChart() {
+    const context = React.useContext(ChartContext);
+
+    if (!context) {
+        throw new Error("useChart must be used within a <ChartContainer />");
+    }
+
+    return context;
+}
+
+function ChartContainer({
+    id,
+    className,
+    children,
+    config,
+    initialDimension = INITIAL_DIMENSION,
+    ...props
+}: React.ComponentProps<"div"> & {
+    config: ChartConfig;
+    children: React.ComponentProps<typeof RechartsPrimitive.ResponsiveContainer>["children"];
+    initialDimension?: {
+        width: number;
+        height: number;
+    };
+}) {
+    const uniqueId = React.useId();
+    const chartId = `chart-${id ?? uniqueId.replace(/:/g, "")}`;
+
+    return (
+        <ChartContext.Provider value={{config}}>
+            <div data-slot="chart" data-chart={chartId} className={cn(chartContainerClass, className)} {...props}>
+                <ChartStyle id={chartId} config={config} />
+                <RechartsPrimitive.ResponsiveContainer initialDimension={initialDimension}>
+                    {children}
+                </RechartsPrimitive.ResponsiveContainer>
+            </div>
+        </ChartContext.Provider>
+    );
+}
+
+const ChartStyle = ({id, config}: {id: string; config: ChartConfig}) => {
+    const colorConfig = Object.entries(config).filter(([, config]) => config.theme ?? config.color);
+
+    if (!colorConfig.length) {
+        return null;
+    }
+
+    return (
+        <style
+            dangerouslySetInnerHTML={{
+                __html: Object.entries(THEMES)
+                    .map(
+                        ([theme, prefix]) => `
+${prefix} [data-chart=${id}] {
+${colorConfig
+    .map(([key, itemConfig]) => {
+        const color = itemConfig.theme?.[theme as keyof typeof itemConfig.theme] ?? itemConfig.color;
+        return color ? `  --color-${key}: ${color};` : null;
+    })
+    .join("\n")}
+}
+`,
+                    )
+                    .join("\n"),
+            }}
+        />
+    );
+};
+
+const ChartTooltip = RechartsPrimitive.Tooltip;
+
+function ChartTooltipContent({
+    active,
+    payload,
+    className,
+    indicator = "dot",
+    hideLabel = false,
+    hideIndicator = false,
+    label,
+    labelFormatter,
+    labelClassName,
+    formatter,
+    color,
+    nameKey,
+    labelKey,
+}: React.ComponentProps<typeof RechartsPrimitive.Tooltip> &
+    React.ComponentProps<"div"> & {
+        hideLabel?: boolean;
+        hideIndicator?: boolean;
+        indicator?: "line" | "dot" | "dashed";
+        nameKey?: string;
+        labelKey?: string;
+    } & Omit<RechartsPrimitive.DefaultTooltipContentProps<TooltipValueType, TooltipNameType>, "accessibilityLayer">) {
+    const {config} = useChart();
+
+    const tooltipLabel = React.useMemo(() => {
+        if (hideLabel || !payload?.length) {
+            return null;
+        }
+
+        const [item] = payload;
+        const key = `${labelKey ?? item?.dataKey ?? item?.name ?? "value"}`;
+        const itemConfig = getPayloadConfigFromPayload(config, item, key);
+        const value = !labelKey && typeof label === "string" ? (config[label]?.label ?? label) : itemConfig?.label;
+
+        if (labelFormatter) {
+            return <div className={cn("font-medium", labelClassName)}>{labelFormatter(value, payload)}</div>;
+        }
+
+        if (!value) {
+            return null;
+        }
+
+        return <div className={cn("font-medium", labelClassName)}>{value}</div>;
+    }, [label, labelFormatter, payload, hideLabel, labelClassName, config, labelKey]);
+
+    if (!active || !payload?.length) {
+        return null;
+    }
+
+    const nestLabel = payload.length === 1 && indicator !== "dot";
+
+    return (
+        <div
+            data-slot="chart-tooltip"
+            className={cn(popupSurface, "grid min-w-32 items-start gap-1.5 px-2.5 py-1.5 text-xs", className)}
+        >
+            {!nestLabel ? tooltipLabel : null}
+            <div className="grid gap-1.5">
+                {payload
+                    .filter((item) => item.type !== "none")
+                    .map((item, index) => {
+                        const key = `${nameKey ?? item.name ?? item.dataKey ?? "value"}`;
+                        const itemConfig = getPayloadConfigFromPayload(config, item, key);
+                        const indicatorColor = color ?? item.payload?.fill ?? item.color;
+
+                        return (
+                            <div
+                                key={index}
+                                className={cn(
+                                    "flex w-full flex-wrap items-stretch gap-2 [&>svg]:h-2.5 [&>svg]:w-2.5 [&>svg]:text-muted-foreground",
+                                    indicator === "dot" && "items-center",
+                                )}
+                            >
+                                {formatter && item?.value !== undefined && item.name ? (
+                                    formatter(item.value, item.name, item, index, item.payload)
+                                ) : (
+                                    <>
+                                        {itemConfig?.icon ? (
+                                            <itemConfig.icon />
+                                        ) : (
+                                            !hideIndicator && (
+                                                <div
+                                                    className={cn(
+                                                        "shrink-0 rounded-xs border-(--color-border) bg-(--color-bg)",
+                                                        {
+                                                            "h-2.5 w-2.5": indicator === "dot",
+                                                            "w-1": indicator === "line",
+                                                            "w-0 border-[1.5px] border-dashed bg-transparent":
+                                                                indicator === "dashed",
+                                                            "my-0.5": nestLabel && indicator === "dashed",
+                                                        },
+                                                    )}
+                                                    style={
+                                                        {
+                                                            "--color-bg": indicatorColor,
+                                                            "--color-border": indicatorColor,
+                                                        } as React.CSSProperties
+                                                    }
+                                                />
+                                            )
+                                        )}
+                                        <div
+                                            className={cn(
+                                                "flex flex-1 justify-between leading-none",
+                                                nestLabel ? "items-end" : "items-center",
+                                            )}
+                                        >
+                                            <div className="grid gap-1.5">
+                                                {nestLabel ? tooltipLabel : null}
+                                                <span className="text-muted-foreground">
+                                                    {itemConfig?.label ?? item.name}
+                                                </span>
+                                            </div>
+                                            {item.value != null && (
+                                                <span className="font-mono font-medium text-foreground tabular-nums">
+                                                    {typeof item.value === "number"
+                                                        ? item.value.toLocaleString()
+                                                        : String(item.value)}
+                                                </span>
+                                            )}
+                                        </div>
+                                    </>
+                                )}
+                            </div>
+                        );
+                    })}
+            </div>
+        </div>
+    );
+}
+
+const ChartLegend = RechartsPrimitive.Legend;
+
+function ChartLegendContent({
+    className,
+    hideIcon = false,
+    payload,
+    verticalAlign = "bottom",
+    nameKey,
+}: React.ComponentProps<"div"> & {
+    hideIcon?: boolean;
+    nameKey?: string;
+} & RechartsPrimitive.DefaultLegendContentProps) {
+    const {config} = useChart();
+
+    if (!payload?.length) {
+        return null;
+    }
+
+    return (
+        <div
+            data-slot="chart-legend"
+            className={cn(
+                "flex flex-wrap items-center justify-center gap-x-4 gap-y-1 text-muted-foreground",
+                verticalAlign === "top" ? "pb-3" : "pt-3",
+                className,
+            )}
+        >
+            {payload
+                .filter((item) => item.type !== "none")
+                .map((item, index) => {
+                    const key = `${nameKey ?? item.dataKey ?? "value"}`;
+                    const itemConfig = getPayloadConfigFromPayload(config, item, key);
+
+                    return (
+                        <div
+                            key={index}
+                            data-slot="chart-legend-item"
+                            className="flex items-center gap-1.5 [&>svg]:size-3 [&>svg]:text-muted-foreground"
+                        >
+                            {itemConfig?.icon && !hideIcon ? (
+                                <itemConfig.icon />
+                            ) : (
+                                <div
+                                    className="size-2 shrink-0 rounded-xs"
+                                    style={{
+                                        backgroundColor: item.color,
+                                    }}
+                                />
+                            )}
+                            {itemConfig?.label}
+                        </div>
+                    );
+                })}
+        </div>
+    );
+}
+
+function getPayloadConfigFromPayload(config: ChartConfig, payload: unknown, key: string) {
+    if (typeof payload !== "object" || payload === null) {
+        return undefined;
+    }
+
+    const payloadPayload =
+        "payload" in payload && typeof payload.payload === "object" && payload.payload !== null
+            ? payload.payload
+            : undefined;
+
+    let configLabelKey: string = key;
+
+    if (key in payload && typeof payload[key as keyof typeof payload] === "string") {
+        configLabelKey = payload[key as keyof typeof payload] as string;
+    } else if (
+        payloadPayload &&
+        key in payloadPayload &&
+        typeof payloadPayload[key as keyof typeof payloadPayload] === "string"
+    ) {
+        configLabelKey = payloadPayload[key as keyof typeof payloadPayload] as string;
+    }
+
+    return configLabelKey in config ? config[configLabelKey] : config[key];
+}
+
+export {ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent};

package/src/components/checkbox-group.tsx

@@ -0,0 +1,21 @@
+"use client";
+
+import {CheckboxGroup as CheckboxGroupPrimitive} from "@base-ui/react/checkbox-group";
+import {cn} from "cn";
+
+/**
+ * Shared state for a set of checkboxes: `value` is the array of checked `Checkbox` values. Give the
+ * group `allValues` and one `<Checkbox parent />` to get a "select all" box that turns indeterminate
+ * when only some children are checked.
+ */
+function CheckboxGroup({className, ...props}: CheckboxGroupPrimitive.Props) {
+    return (
+        <CheckboxGroupPrimitive
+            data-slot="checkbox-group"
+            className={cn("flex flex-col items-start gap-3", className)}
+            {...props}
+        />
+    );
+}
+
+export {CheckboxGroup};

package/src/components/checkbox.tsx

@@ -0,0 +1,39 @@
+"use client";
+
+import {Checkbox as CheckboxPrimitive} from "@base-ui/react/checkbox";
+import {focusRing} from "@repraze/kernelkit/lib/recipes";
+import {cva} from "class-variance-authority";
+import {cn} from "cn";
+import {CheckIcon, MinusIcon} from "lucide-react";
+
+/** Box classes, exported so a custom element can look like a checkbox. */
+const checkboxVariants = cva([
+    "group/checkbox peer relative flex size-4 shrink-0 cursor-pointer items-center justify-center rounded-(--checkbox-radius) border border-input bg-transparent text-primary-foreground [--checkbox-radius:min(var(--radius-sm),var(--spacing))]",
+    "transition-[color,background-color,border-color,box-shadow] duration-100 motion-reduce:transition-none bg-field",
+    // 24px hit area around the 16px box (§4)
+    "after:absolute after:-inset-x-3 after:-inset-y-2",
+    focusRing,
+    "hover:bg-field-hover",
+    "data-checked:border-primary data-checked:bg-primary data-checked:hover:bg-primary/85",
+    "data-indeterminate:border-primary data-indeterminate:bg-primary data-indeterminate:hover:bg-primary/85",
+    "aria-invalid:border-danger aria-invalid:ring-3 aria-invalid:ring-danger/20 dark:aria-invalid:ring-danger/40",
+    "data-disabled:cursor-not-allowed data-disabled:opacity-50 data-disabled:hover:bg-field group-has-disabled/field:opacity-50",
+    // inside a FieldLabel card the label shows focus, not the box
+    "group-has-[:focus-visible]/field-label:ring-0 group-has-[:focus-visible]/field-label:not-data-checked:border-input group-has-[:focus-visible]/field-label:data-checked:border-primary",
+]);
+
+function Checkbox({className, ...props}: CheckboxPrimitive.Root.Props) {
+    return (
+        <CheckboxPrimitive.Root data-slot="checkbox" className={cn(checkboxVariants(), className)} {...props}>
+            <CheckboxPrimitive.Indicator
+                data-slot="checkbox-indicator"
+                className="grid place-content-center text-current transition-none [&>svg]:size-3.5"
+            >
+                <CheckIcon strokeWidth={3} className="group-data-indeterminate/checkbox:hidden" />
+                <MinusIcon strokeWidth={3} className="hidden group-data-indeterminate/checkbox:block" />
+            </CheckboxPrimitive.Indicator>
+        </CheckboxPrimitive.Root>
+    );
+}
+
+export {Checkbox, checkboxVariants};