@forthtilliath/forth-ui 0.2.0

package/dist/components/grid/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./grid";
+export * from "./grid-item";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/grid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/grid/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC"}

package/dist/components/grid/index.js

@@ -0,0 +1,2 @@
+export * from "./grid";
+export * from "./grid-item";

package/dist/components/grid/variants.d.ts

@@ -0,0 +1,16 @@
+import type { VariantProps } from "class-variance-authority";
+export declare const gridVariants: (props?: ({
+    cols?: 1 | 2 | 3 | 7 | 12 | 4 | 5 | 6 | 8 | 9 | 10 | 11 | null | undefined;
+    spacing?: "sm" | "lg" | "none" | "xs" | "md" | "xl" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type GridVariants = VariantProps<typeof gridVariants>;
+export declare const gridItemVariants: (props?: ({
+    cols?: "default" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "full" | null | undefined;
+    debug?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type GridItemVariants = VariantProps<typeof gridItemVariants>;
+export declare const gridItemDebugVariants: (props?: ({
+    active?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type GridItemDebugVariants = VariantProps<typeof gridItemDebugVariants>;
+//# sourceMappingURL=variants.d.ts.map

package/dist/components/grid/variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variants.d.ts","sourceRoot":"","sources":["../../../src/components/grid/variants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,eAAO,MAAM,YAAY;;;8EA6BvB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,YAAY,CAAC,CAAC;AAE7D,eAAO,MAAM,gBAAgB;;;8EA0B3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAErE,eAAO,MAAM,qBAAqB;;8EAkBjC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/components/grid/variants.js

@@ -0,0 +1,74 @@
+import { cva } from "class-variance-authority";
+export const gridVariants = cva("grid", {
+    variants: {
+        cols: {
+            1: "grid-cols-1",
+            2: "grid-cols-2",
+            3: "grid-cols-3",
+            4: "grid-cols-4",
+            5: "grid-cols-5",
+            6: "grid-cols-6",
+            7: "grid-cols-7",
+            8: "grid-cols-8",
+            9: "grid-cols-9",
+            10: "grid-cols-10",
+            11: "grid-cols-11",
+            12: "grid-cols-12",
+        },
+        spacing: {
+            none: "gap-0",
+            xs: "gap-1",
+            sm: "gap-2",
+            md: "gap-4",
+            lg: "gap-8",
+            xl: "gap-12",
+        },
+    },
+    defaultVariants: {
+        cols: 12,
+        spacing: "md",
+    },
+});
+export const gridItemVariants = cva("flex justify-center items-center", {
+    variants: {
+        cols: {
+            default: "col-span-1",
+            "2": "col-span-2",
+            "3": "col-span-3",
+            "4": "col-span-4",
+            "5": "col-span-5",
+            "6": "col-span-6",
+            "7": "col-span-7",
+            "8": "col-span-8",
+            "9": "col-span-9",
+            "10": "col-span-10",
+            "11": "col-span-11",
+            "12": "col-span-12",
+            full: "col-span-full",
+        },
+        debug: {
+            false: "",
+            true: "relative",
+        },
+    },
+    defaultVariants: {
+        cols: "default",
+        debug: false,
+    },
+});
+export const gridItemDebugVariants = cva([
+    "absolute inset-0 z-[999] pointer-events-none",
+    "w-full h-full bg-red-500/10",
+    "transition-transform duration-500 ease-in-out origin-top",
+    "border-dashed border-red-500/30 border",
+], {
+    variants: {
+        active: {
+            true: "scale-y-100",
+            false: "scale-y-0",
+        },
+    },
+    defaultVariants: {
+        active: true,
+    },
+});

package/dist/components/image-input/image-input.d.ts

@@ -0,0 +1,21 @@
+import * as React from "react";
+export interface ImageInputProps {
+    /** An existing image URL to preview (e.g. editing something that already has one). */
+    value?: string | null;
+    onFileChange?: (file: File | null) => void;
+    disabled?: boolean;
+    className?: string;
+    /** @default "16/9" */
+    aspectRatio?: string;
+}
+/**
+ * A click-to-upload image picker with a live preview.
+ *
+ * @see https://ktui.io/docs/image-input
+ *
+ * @version 0.1.0
+ * @author Forth
+ * @copyright 2026 Forth
+ */
+export declare function ImageInput({ value, onFileChange, disabled, className, aspectRatio, }: ImageInputProps): React.JSX.Element;
+//# sourceMappingURL=image-input.d.ts.map

package/dist/components/image-input/image-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-input.d.ts","sourceRoot":"","sources":["../../../src/components/image-input/image-input.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,YAAY,EACZ,QAAgB,EAChB,SAAS,EACT,WAAoB,GACrB,EAAE,eAAe,qBA4EjB"}

package/dist/components/image-input/image-input.js

@@ -0,0 +1,45 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { ImageIcon, XIcon } from "lucide-react";
+import { cn } from "@forthtilliath/shadcn-ui/lib/utils";
+/**
+ * A click-to-upload image picker with a live preview.
+ *
+ * @see https://ktui.io/docs/image-input
+ *
+ * @version 0.1.0
+ * @author Forth
+ * @copyright 2026 Forth
+ */
+export function ImageInput({ value, onFileChange, disabled = false, className, aspectRatio = "16/9", }) {
+    const [file, setFile] = React.useState(null);
+    const [objectUrl, setObjectUrl] = React.useState(null);
+    const inputRef = React.useRef(null);
+    React.useEffect(() => {
+        if (file === null) {
+            // eslint-disable-next-line @eslint-react/set-state-in-effect, react-hooks/set-state-in-effect -- syncs the object URL lifecycle (create/revoke) with the selected File, an external browser resource that can't be derived during render
+            setObjectUrl(null);
+            return;
+        }
+        const url = URL.createObjectURL(file);
+        // eslint-disable-next-line @eslint-react/set-state-in-effect -- see above
+        setObjectUrl(url);
+        return () => {
+            URL.revokeObjectURL(url);
+        };
+    }, [file]);
+    const preview = objectUrl ?? value ?? null;
+    function handleFile(next) {
+        setFile(next);
+        onFileChange?.(next);
+    }
+    return (_jsxs("div", { "data-slot": "image-input", className: cn("border-input relative flex items-center justify-center overflow-hidden rounded-lg border border-dashed", disabled && "pointer-events-none opacity-50", className), style: { aspectRatio }, children: [preview !== null ? (_jsxs(_Fragment, { children: [_jsx("img", { src: preview, alt: "", className: "size-full object-cover" }), _jsx("button", { type: "button", onClick: () => {
+                            handleFile(null);
+                        }, "aria-label": "Remove image", className: "bg-background/80 text-foreground hover:bg-background absolute top-2 right-2 rounded-full p-1 shadow-xs", children: _jsx(XIcon, { className: "size-4" }) })] })) : (_jsxs("button", { type: "button", onClick: () => {
+                    inputRef.current?.click();
+                }, disabled: disabled, className: "text-muted-foreground hover:text-foreground flex flex-col items-center gap-2 p-8 text-sm", children: [_jsx(ImageIcon, { className: "size-8" }), "Click to upload an image"] })), _jsx("input", { ref: inputRef, type: "file", accept: "image/*", disabled: disabled, className: "hidden", onChange: (e) => {
+                    handleFile(e.target.files?.[0] ?? null);
+                    e.target.value = "";
+                } })] }));
+}

package/dist/components/image-input/index.d.ts

@@ -0,0 +1,3 @@
+export type { ImageInputProps } from "./image-input";
+export { ImageInput } from "./image-input";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/image-input/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/image-input/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/components/image-input/index.js

@@ -0,0 +1 @@
+export { ImageInput } from "./image-input";

package/dist/components/infinite-scroll/index.d.ts

@@ -0,0 +1,3 @@
+export type { InfiniteScrollProps } from "./infinite-scroll";
+export { InfiniteScroll } from "./infinite-scroll";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/infinite-scroll/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/infinite-scroll/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/components/infinite-scroll/index.js

@@ -0,0 +1 @@
+export { InfiniteScroll } from "./infinite-scroll";

package/dist/components/infinite-scroll/infinite-scroll.d.ts

@@ -0,0 +1,20 @@
+import * as React from "react";
+export interface InfiniteScrollProps {
+    onLoadMore: () => void;
+    hasMore: boolean;
+    loading?: boolean;
+    children: React.ReactNode;
+    className?: string;
+}
+/**
+ * Calls `onLoadMore` once a sentinel at the bottom of `children` scrolls
+ * into view, via `IntersectionObserver` — no scroll-event polling.
+ *
+ * @see https://www.rigidui.com/docs/components/infinite-scroll
+ *
+ * @version 0.1.0
+ * @author Forth
+ * @copyright 2026 Forth
+ */
+export declare function InfiniteScroll({ onLoadMore, hasMore, loading, children, className, }: InfiniteScrollProps): React.JSX.Element;
+//# sourceMappingURL=infinite-scroll.d.ts.map

package/dist/components/infinite-scroll/infinite-scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infinite-scroll.d.ts","sourceRoot":"","sources":["../../../src/components/infinite-scroll/infinite-scroll.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,EAC7B,UAAU,EACV,OAAO,EACP,OAAe,EACf,QAAQ,EACR,SAAS,GACV,EAAE,mBAAmB,qBAgCrB"}

package/dist/components/infinite-scroll/infinite-scroll.js

@@ -0,0 +1,33 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { Loader2Icon } from "lucide-react";
+/**
+ * Calls `onLoadMore` once a sentinel at the bottom of `children` scrolls
+ * into view, via `IntersectionObserver` — no scroll-event polling.
+ *
+ * @see https://www.rigidui.com/docs/components/infinite-scroll
+ *
+ * @version 0.1.0
+ * @author Forth
+ * @copyright 2026 Forth
+ */
+export function InfiniteScroll({ onLoadMore, hasMore, loading = false, children, className, }) {
+    const sentinelRef = React.useRef(null);
+    React.useEffect(() => {
+        const sentinel = sentinelRef.current;
+        if (sentinel === null || !hasMore) {
+            return;
+        }
+        const observer = new IntersectionObserver((entries) => {
+            if (entries[0]?.isIntersecting === true) {
+                onLoadMore();
+            }
+        });
+        observer.observe(sentinel);
+        return () => {
+            observer.disconnect();
+        };
+    }, [hasMore, onLoadMore]);
+    return (_jsxs("div", { "data-slot": "infinite-scroll", className: className, children: [children, hasMore && (_jsx("div", { ref: sentinelRef, className: "flex justify-center py-4", children: loading && (_jsx(Loader2Icon, { className: "text-muted-foreground size-5 animate-spin" })) }))] }));
+}

package/dist/components/kbd/index.d.ts

@@ -0,0 +1,2 @@
+export { Kbd, KbdGroup } from "./kbd";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/kbd/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/kbd/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC"}

package/dist/components/kbd/index.js

@@ -0,0 +1 @@
+export { Kbd, KbdGroup } from "./kbd";

package/dist/components/kbd/kbd.d.ts

@@ -0,0 +1,15 @@
+import type React from "react";
+/**
+ * Displays which key or combination of keys performs a given action.
+ *
+ * _Inspired from multiple sources, to make a consistent and reusable component._
+ * @see https://ui.shadcn.com/docs/components/kbd
+ *
+ * @version 0.1.0
+ * @author Forth
+ * @copyright 2026 Forth
+ */
+export declare function Kbd({ className, ...props }: React.ComponentProps<"kbd">): React.JSX.Element;
+/** Groups several `Kbd`s together, e.g. for a "Ctrl + Shift + P" sequence. */
+export declare function KbdGroup({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+//# sourceMappingURL=kbd.d.ts.map

package/dist/components/kbd/kbd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kbd.d.ts","sourceRoot":"","sources":["../../../src/components/kbd/kbd.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;;;;;GASG;AACH,wBAAgB,GAAG,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAYvE;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAQ5E"}

package/dist/components/kbd/kbd.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cn } from "@forthtilliath/shadcn-ui/lib/utils";
+/**
+ * Displays which key or combination of keys performs a given action.
+ *
+ * _Inspired from multiple sources, to make a consistent and reusable component._
+ * @see https://ui.shadcn.com/docs/components/kbd
+ *
+ * @version 0.1.0
+ * @author Forth
+ * @copyright 2026 Forth
+ */
+export function Kbd({ className, ...props }) {
+    return (_jsx("kbd", { "data-slot": "kbd", className: cn("bg-muted text-muted-foreground pointer-events-none inline-flex h-5 w-fit min-w-5 items-center justify-center gap-1 rounded-sm px-1 font-sans text-xs font-medium select-none", "[&_svg:not([class*='size-'])]:size-3", className), ...props }));
+}
+/** Groups several `Kbd`s together, e.g. for a "Ctrl + Shift + P" sequence. */
+export function KbdGroup({ className, ...props }) {
+    return (_jsx("div", { "data-slot": "kbd-group", className: cn("inline-flex items-center gap-1", className), ...props }));
+}

package/dist/components/link/index.d.ts

@@ -0,0 +1,7 @@
+export type { LinkProps } from "./link";
+export { Link } from "./link";
+export type { LinkPreviewMetadata, LinkPreviewProps } from "./link-preview";
+export { LinkPreview } from "./link-preview";
+export type { LinkVariants } from "./variants";
+export { linkVariants } from "./variants";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/link/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/link/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/link/index.js

@@ -0,0 +1,3 @@
+export { Link } from "./link";
+export { LinkPreview } from "./link-preview";
+export { linkVariants } from "./variants";

package/dist/components/link/link-preview.d.ts

@@ -0,0 +1,36 @@
+import type * as React from "react";
+export interface LinkPreviewMetadata {
+    title: React.ReactNode;
+    description?: React.ReactNode;
+    image?: string;
+    favicon?: string;
+    url?: string;
+}
+export interface LinkPreviewProps {
+    metadata: LinkPreviewMetadata;
+    children: React.ReactNode;
+    className?: string;
+}
+/**
+ * Reveals a metadata card (title/description/image) on hover over its
+ * trigger — the "unfurl" pattern used for link previews.
+ *
+ * Metadata is supplied by the caller rather than fetched live: both
+ * reference sources (kibo-ui's Glimpse, aceternity's Link Preview) depend
+ * on a live external fetch (an Open Graph scrape via an RSC / server
+ * action, or a screenshot from the Microlink API respectively) — a
+ * network/backend dependency out of scope for a UI-only package. Wire this
+ * to your own metadata source (a server action, a cached lookup, etc.) and
+ * pass the result in as `metadata`.
+ *
+ * _Inspired from multiple sources, to make a consistent and reusable component._
+ * @see https://ui.shadcn.com/docs/components/hover-card
+ * @see https://www.kibo-ui.com/components/glimpse
+ * @see https://ui.aceternity.com/components/link-preview
+ *
+ * @version 0.1.0
+ * @author Forth
+ * @copyright 2026 Forth
+ */
+export declare function LinkPreview({ metadata, children, className, }: LinkPreviewProps): React.JSX.Element;
+//# sourceMappingURL=link-preview.d.ts.map

package/dist/components/link/link-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-preview.d.ts","sourceRoot":"","sources":["../../../src/components/link/link-preview.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AASpC,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,QAAQ,EACR,SAAS,GACV,EAAE,gBAAgB,qBAiClB"}

package/dist/components/link/link-preview.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { HoverCard, HoverCardContent, HoverCardTrigger, } from "@forthtilliath/shadcn-ui/components/hover-card";
+import { cn } from "@forthtilliath/shadcn-ui/lib/utils";
+/**
+ * Reveals a metadata card (title/description/image) on hover over its
+ * trigger — the "unfurl" pattern used for link previews.
+ *
+ * Metadata is supplied by the caller rather than fetched live: both
+ * reference sources (kibo-ui's Glimpse, aceternity's Link Preview) depend
+ * on a live external fetch (an Open Graph scrape via an RSC / server
+ * action, or a screenshot from the Microlink API respectively) — a
+ * network/backend dependency out of scope for a UI-only package. Wire this
+ * to your own metadata source (a server action, a cached lookup, etc.) and
+ * pass the result in as `metadata`.
+ *
+ * _Inspired from multiple sources, to make a consistent and reusable component._
+ * @see https://ui.shadcn.com/docs/components/hover-card
+ * @see https://www.kibo-ui.com/components/glimpse
+ * @see https://ui.aceternity.com/components/link-preview
+ *
+ * @version 0.1.0
+ * @author Forth
+ * @copyright 2026 Forth
+ */
+export function LinkPreview({ metadata, children, className, }) {
+    return (_jsxs(HoverCard, { openDelay: 150, children: [_jsx(HoverCardTrigger, { asChild: true, children: children }), _jsxs(HoverCardContent, { className: cn("w-80 overflow-hidden p-0", className), children: [metadata.image !== undefined && (_jsx("img", { src: metadata.image, alt: "", className: "aspect-video w-full object-cover" })), _jsxs("div", { className: "space-y-1 p-3", children: [_jsxs("div", { className: "flex items-center gap-1.5", children: [metadata.favicon !== undefined && (_jsx("img", { src: metadata.favicon, alt: "", className: "size-3.5" })), metadata.url !== undefined && (_jsx("span", { className: "text-muted-foreground truncate text-xs", children: metadata.url }))] }), _jsx("p", { className: "text-sm leading-none font-medium", children: metadata.title }), metadata.description !== undefined && (_jsx("p", { className: "text-muted-foreground line-clamp-2 text-xs", children: metadata.description }))] })] })] }));
+}

package/dist/components/link/link.d.ts

@@ -0,0 +1,27 @@
+import type * as React from "react";
+import type { LinkVariants } from "./variants";
+export type LinkProps = React.ComponentProps<"a"> & LinkVariants & {
+    /**
+     * Renders the passed child instead of an `<a>` (e.g. a framework's own
+     * `Link`), keeping this component's styling and `isExternal` behavior.
+     */
+    asChild?: boolean;
+    /**
+     * Adds `target="_blank"` + `rel="noopener noreferrer"` and a trailing
+     * arrow icon. Auto-detected from `href` when omitted.
+     */
+    isExternal?: boolean;
+    disabled?: boolean;
+};
+/**
+ * A styled hyperlink, or a component that looks like one.
+ *
+ * _Inspired from multiple sources, to make a consistent and reusable component._
+ * @see https://ktui.io/docs/link
+ *
+ * @version 0.1.0
+ * @author Forth
+ * @copyright 2026 Forth
+ */
+export declare function Link({ className, variant, underline, size, asChild, isExternal, disabled, href, children, ...props }: LinkProps): React.JSX.Element;
+//# sourceMappingURL=link.d.ts.map

package/dist/components/link/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../../src/components/link/link.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAMpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,GAC/C,YAAY,GAAG;IACb;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAMJ;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,EACnB,SAAS,EACT,OAAO,EACP,SAAS,EACT,IAAI,EACJ,OAAe,EACf,UAAU,EACV,QAAgB,EAChB,IAAI,EACJ,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,SAAS,qBAgCX"}

package/dist/components/link/link.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Slot } from "@radix-ui/react-slot";
+import { ArrowUpRightIcon } from "lucide-react";
+import { cn } from "@forthtilliath/shadcn-ui/lib/utils";
+import { linkVariants } from "./variants";
+function isExternalHref(href) {
+    return href !== undefined && /^https?:\/\//.test(href);
+}
+/**
+ * A styled hyperlink, or a component that looks like one.
+ *
+ * _Inspired from multiple sources, to make a consistent and reusable component._
+ * @see https://ktui.io/docs/link
+ *
+ * @version 0.1.0
+ * @author Forth
+ * @copyright 2026 Forth
+ */
+export function Link({ className, variant, underline, size, asChild = false, isExternal, disabled = false, href, children, ...props }) {
+    const external = isExternal ?? isExternalHref(href);
+    const sharedProps = {
+        "data-slot": "link",
+        "data-disabled": disabled,
+        href,
+        "aria-disabled": disabled,
+        target: external ? "_blank" : undefined,
+        rel: external ? "noopener noreferrer" : undefined,
+        className: cn(linkVariants({ variant, underline, size }), disabled && "pointer-events-none opacity-50", className),
+        ...props,
+    };
+    // `Slot` requires a single child to clone props onto, so the
+    // auto-appended external-link icon (which would make it two children)
+    // is only added for the plain `<a>` case — `asChild` callers own their
+    // entire subtree already.
+    if (asChild) {
+        return _jsx(Slot, { ...sharedProps, children: children });
+    }
+    return (_jsxs("a", { ...sharedProps, children: [children, external && _jsx(ArrowUpRightIcon, { className: "size-[0.9em]" })] }));
+}

package/dist/components/link/variants.d.ts

@@ -0,0 +1,8 @@
+import type { VariantProps } from "class-variance-authority";
+export declare const linkVariants: (props?: ({
+    variant?: "default" | "primary" | "destructive" | "muted" | null | undefined;
+    underline?: "none" | "always" | "hover" | null | undefined;
+    size?: "default" | "sm" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type LinkVariants = VariantProps<typeof linkVariants>;
+//# sourceMappingURL=variants.d.ts.map

package/dist/components/link/variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variants.d.ts","sourceRoot":"","sources":["../../../src/components/link/variants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,eAAO,MAAM,YAAY;;;;8EA2BxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/components/link/variants.js

@@ -0,0 +1,26 @@
+import { cva } from "class-variance-authority";
+export const linkVariants = cva("focus-visible:ring-ring/50 inline-flex items-center gap-1 rounded-xs outline-none transition-colors focus-visible:ring-2", {
+    variants: {
+        variant: {
+            default: "text-foreground hover:text-primary",
+            primary: "text-primary hover:text-primary/80",
+            muted: "text-muted-foreground hover:text-foreground",
+            destructive: "text-destructive hover:text-destructive/80",
+        },
+        underline: {
+            none: "no-underline",
+            hover: "no-underline hover:underline",
+            always: "underline",
+        },
+        size: {
+            sm: "text-sm",
+            default: "text-base",
+            lg: "text-lg",
+        },
+    },
+    defaultVariants: {
+        variant: "default",
+        underline: "hover",
+        size: "default",
+    },
+});

package/dist/components/marquee/index.d.ts

@@ -0,0 +1,3 @@
+export type { MarqueeProps } from "./marquee";
+export { Marquee } from "./marquee";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/marquee/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/marquee/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/components/marquee/index.js

@@ -0,0 +1 @@
+export { Marquee } from "./marquee";

package/dist/components/marquee/marquee.d.ts

@@ -0,0 +1,22 @@
+import type React from "react";
+export type MarqueeProps = React.ComponentProps<"div"> & {
+    /** Duration for one full loop, in seconds. @default 20 */
+    duration?: number;
+    reverse?: boolean;
+    pauseOnHover?: boolean;
+    vertical?: boolean;
+};
+/**
+ * Infinitely scrolls its children (a logo wall, a ticker) — two duplicated
+ * tracks looped via a pure CSS keyframe, no animation library.
+ *
+ * _Inspired from multiple sources, to make a consistent and reusable component._
+ * @see https://www.hextaui.com/docs/ui/components/marquee
+ * @see https://www.kibo-ui.com/components/marquee
+ *
+ * @version 0.1.0
+ * @author Forth
+ * @copyright 2026 Forth
+ */
+export declare function Marquee({ duration, reverse, pauseOnHover, vertical, className, children, ...props }: MarqueeProps): React.JSX.Element;
+//# sourceMappingURL=marquee.d.ts.map

package/dist/components/marquee/marquee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marquee.d.ts","sourceRoot":"","sources":["../../../src/components/marquee/marquee.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IACvD,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,EACtB,QAAa,EACb,OAAe,EACf,YAAoB,EACpB,QAAgB,EAChB,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,YAAY,qBA8Bd"}

package/dist/components/marquee/marquee.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cn } from "@forthtilliath/shadcn-ui/lib/utils";
+/**
+ * Infinitely scrolls its children (a logo wall, a ticker) — two duplicated
+ * tracks looped via a pure CSS keyframe, no animation library.
+ *
+ * _Inspired from multiple sources, to make a consistent and reusable component._
+ * @see https://www.hextaui.com/docs/ui/components/marquee
+ * @see https://www.kibo-ui.com/components/marquee
+ *
+ * @version 0.1.0
+ * @author Forth
+ * @copyright 2026 Forth
+ */
+export function Marquee({ duration = 20, reverse = false, pauseOnHover = false, vertical = false, className, children, ...props }) {
+    return (_jsx("div", { "data-slot": "marquee", className: cn("group flex overflow-hidden", vertical ? "flex-col" : "flex-row", className), ...props, children: [0, 1].map((track) => (_jsx("div", { "aria-hidden": track === 1, style: { animationDuration: `${duration.toString()}s` }, className: cn("flex shrink-0 justify-around gap-4", vertical
+                ? "animate-marquee-vertical flex-col"
+                : "animate-marquee flex-row", pauseOnHover && "group-hover:[animation-play-state:paused]", reverse && "[animation-direction:reverse]"), children: children }, track))) }));
+}

package/dist/components/multi-step-loader/index.d.ts

@@ -0,0 +1,3 @@
+export type { LoadingState, MultiStepLoaderProps } from "./multi-step-loader";
+export { MultiStepLoader } from "./multi-step-loader";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/multi-step-loader/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/multi-step-loader/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/components/multi-step-loader/index.js

@@ -0,0 +1 @@
+export { MultiStepLoader } from "./multi-step-loader";