@metaphor-cloud/ui 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Metaphor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,420 @@
+# @metaphor-cloud/ui
+
+Shared React component library for Metaphor projects. Themeable, accessible, built on Radix UI primitives.
+
+Requires **React 19+** and **Tailwind CSS 4** (optional, for extending with the preset).
+
+## Quick Start
+
+```bash
+npm install @metaphor-cloud/ui
+```
+
+```tsx
+import "@metaphor-cloud/ui/metaphor"; // theme + styles in one import
+import { ThemeProvider, Button } from "@metaphor-cloud/ui";
+
+function App() {
+  return (
+    <ThemeProvider>
+      <Button variant="primary">Click me</Button>
+    </ThemeProvider>
+  );
+}
+```
+
+That's it. `ThemeProvider` reads the theme's default mode automatically from the CSS (`--theme-default`), persists the user's choice to localStorage, and syncs across tabs.
+
+## Themes
+
+Two themes ship out of the box:
+
+| Theme | Import | Default Mode | Accent | Fonts |
+|-------|--------|--------------|--------|-------|
+| Metaphor | `@metaphor-cloud/ui/metaphor` | Dark | Blue | Plus Jakarta Sans, Outfit, JetBrains Mono |
+| Um | `@metaphor-cloud/ui/um` | Light | Ocean blue | Nunito, JetBrains Mono |
+
+### Switching themes
+
+Replace the CSS import — no other changes needed:
+
+```tsx
+import "@metaphor-cloud/ui/um"; // swap to Um theme
+```
+
+### Dark / light mode
+
+`ThemeProvider` handles mode switching. Use `useThemeContext()` anywhere inside the provider:
+
+```tsx
+import { useThemeContext } from "@metaphor-cloud/ui";
+
+function ThemeToggle() {
+  const { theme, resolved, cycleTheme, setTheme } = useThemeContext();
+
+  return (
+    <button onClick={cycleTheme}>
+      {resolved === "dark" ? "🌙" : "☀️"}
+      {theme === "system" && " (auto)"}
+    </button>
+  );
+}
+```
+
+Modes cycle: **dark → light → system → dark**. The `system` mode follows the OS preference.
+
+### Creating a custom theme
+
+Copy `src/themes/metaphor.css` and override the CSS variables:
+
+```css
+:root,
+[data-theme="dark"] {
+  --theme-default: dark;
+  --accent: #your-color;
+  --bg: #your-bg;
+  /* ... */
+}
+
+[data-theme="light"] {
+  --accent: #your-light-color;
+  --bg: #your-light-bg;
+  /* ... */
+}
+```
+
+## Tailwind CSS Preset
+
+If your app uses Tailwind CSS 4, extend from the preset to get all the theme-aware utility classes (colors, fonts, animations, border radii):
+
+```css
+/* your app's main CSS */
+@import "tailwindcss";
+@import "@metaphor-cloud/ui/metaphor";
+
+@config "./tailwind.config.ts";
+```
+
+```ts
+// tailwind.config.ts
+import preset from "@metaphor-cloud/ui/tailwind-preset";
+import type { Config } from "tailwindcss";
+
+export default {
+  presets: [preset],
+  content: ["./src/**/*.{ts,tsx}"],
+} satisfies Config;
+```
+
+The preset gives you:
+
+- **Colors**: `bg-bg-elevated`, `text-accent`, `border-border`, `text-success`, etc. — all CSS variable-backed, all theme-reactive
+- **Fonts**: `font-sans`, `font-display`, `font-mono`
+- **Animations**: `animate-fade-in`, `animate-fade-up`, `animate-accordion-down`, etc.
+- **Spacing**: `section-gap`
+- **Border radius**: `rounded` / `rounded-lg` / `rounded-sm` — derived from the theme's `--radius` variable
+
+If your app uses `data-theme` for dark mode (like this library does), add this to your CSS:
+
+```css
+@custom-variant dark (&:where([data-theme="dark"]), &:where([data-theme="dark"] *));
+```
+
+## Components
+
+All components accept `ref` as a regular prop (React 19), support `className` for overrides via Tailwind, and are fully typed.
+
+### Layout
+
+| Component | Parts | Usage |
+|-----------|-------|-------|
+| `Card` | `CardHeader`, `CardTitle`, `CardDescription`, `CardContent`, `CardFooter` | Content container |
+| `Separator` | — | Horizontal or vertical divider |
+| `Table` | `TableHeader`, `TableBody`, `TableFooter`, `TableRow`, `TableHead`, `TableCell`, `TableCaption` | Data table |
+| `Skeleton` | — | Loading placeholder |
+
+### Forms
+
+| Component | Usage |
+|-----------|-------|
+| `Button` | `variant`: primary, secondary, danger, ghost, link. `size`: sm, md, lg, icon. Supports `asChild` for custom elements. |
+| `Input` | Text input |
+| `Textarea` | Multi-line input |
+| `Label` | Form label |
+| `Select` | `SelectTrigger`, `SelectContent`, `SelectItem`, `SelectGroup`, `SelectValue`, `SelectLabel`, `SelectSeparator` |
+| `Checkbox` | Checkable input |
+| `Switch` | Toggle switch |
+
+### Feedback
+
+| Component | Usage |
+|-----------|-------|
+| `Alert` | `variant`: default, info, success, danger, warning. With `AlertTitle`, `AlertDescription`. |
+| `Badge` | `variant`: default, success, danger, warning, outline |
+| `Progress` | Progress bar with value/max |
+| `Toast` | See [Toast notifications](#toast-notifications) below |
+
+### Overlays
+
+| Component | Parts | Usage |
+|-----------|-------|-------|
+| `Dialog` | `DialogTrigger`, `DialogContent`, `DialogHeader`, `DialogFooter`, `DialogTitle`, `DialogDescription`, `DialogClose` | Modal dialog. `DialogContent` accepts `hideCloseButton`. |
+| `AlertDialog` | `AlertDialogTrigger`, `AlertDialogContent`, `AlertDialogHeader`, `AlertDialogFooter`, `AlertDialogTitle`, `AlertDialogDescription`, `AlertDialogAction`, `AlertDialogCancel` | Confirmation dialog |
+| `DropdownMenu` | `DropdownMenuTrigger`, `DropdownMenuContent`, `DropdownMenuItem`, `DropdownMenuLabel`, `DropdownMenuSeparator`, `DropdownMenuCheckboxItem`, `DropdownMenuRadioGroup`, `DropdownMenuRadioItem`, `DropdownMenuSub`, `DropdownMenuSubTrigger`, `DropdownMenuSubContent` | Context/action menu |
+| `Tooltip` | `TooltipProvider`, `TooltipTrigger`, `TooltipContent` | Hover tooltip |
+| `Popover` | `PopoverTrigger`, `PopoverContent` | Click popover |
+
+### Navigation
+
+| Component | Parts | Usage |
+|-----------|-------|-------|
+| `Nav` | — | Responsive navbar with theme toggle, dropdowns, mobile drawer |
+| `Breadcrumb` | — | Semantic breadcrumb nav with automatic BreadcrumbList JSON-LD |
+
+### SEO & Social
+
+| Component | Usage |
+|-----------|-------|
+| `MetaHead` | Declarative `<head>` management — title, description, Open Graph, Twitter Cards, canonical URL, robots |
+| `StructuredData` | Injects JSON-LD `<script>` tags — typed props for Organization, Article, Product, BreadcrumbList, FAQPage, WebSite |
+
+### Other
+
+| Component | Usage |
+|-----------|-------|
+| `Accordion` | `AccordionItem`, `AccordionTrigger`, `AccordionContent` — collapsible sections |
+| `Tabs` | `TabsList`, `TabsTrigger`, `TabsContent` — tabbed navigation |
+| `CodeBlock` | `inline` prop for inline code, block by default |
+
+## Toast Notifications
+
+Add `<Toaster />` once in your layout, then call `toast()` from anywhere:
+
+```tsx
+import { Toaster, toast } from "@metaphor-cloud/ui";
+
+// In your root layout
+function Layout({ children }) {
+  return (
+    <>
+      {children}
+      <Toaster />
+    </>
+  );
+}
+
+// Anywhere in your app
+function SaveButton() {
+  const handleSave = async () => {
+    await save();
+    toast({
+      title: "Saved",
+      description: "Your changes have been saved.",
+      variant: "success", // "default" | "success" | "danger" | "warning"
+    });
+  };
+
+  return <Button onClick={handleSave}>Save</Button>;
+}
+```
+
+`toast()` returns `{ id, dismiss, update }` for programmatic control. Up to 5 toasts show at once, auto-dismissing after 5 seconds (customisable via `duration`).
+
+## SEO & Social Previews
+
+### `<MetaHead>`
+
+Manages `<title>`, meta description, Open Graph, Twitter Cards, canonical URL, and robots directives. All tags are automatically cleaned up on unmount or when props change.
+
+```tsx
+import { MetaHead } from "@metaphor-cloud/ui";
+
+<MetaHead
+  title="My Page"
+  titleTemplate="%s | My Site"
+  description="A short description for search results and social previews."
+  url="https://example.com/page"
+  image="https://example.com/og.png"
+  imageAlt="Preview of My Page"
+  imageWidth={1200}
+  imageHeight={630}
+  siteName="My Site"
+  twitterCard="summary_large_image"
+  twitterSite="@mysite"
+/>
+```
+
+Props: `title`, `titleTemplate`, `description`, `url`, `image`, `imageAlt`, `imageWidth`, `imageHeight`, `type` (default `"website"`), `siteName`, `locale`, `twitterCard`, `twitterSite`, `twitterCreator`, `noindex`, `nofollow`.
+
+### `<StructuredData>`
+
+Injects a `<script type="application/ld+json">` tag into the document head. Typed props for common schema.org types.
+
+```tsx
+import { StructuredData } from "@metaphor-cloud/ui";
+
+// Organization
+<StructuredData
+  data={{
+    "@type": "Organization",
+    name: "Acme Corp",
+    url: "https://acme.com",
+    logo: "https://acme.com/logo.png",
+    sameAs: ["https://twitter.com/acme", "https://linkedin.com/company/acme"],
+  }}
+/>
+
+// FAQ page
+<StructuredData
+  data={{
+    "@type": "FAQPage",
+    mainEntity: [
+      {
+        "@type": "Question",
+        name: "What is Acme?",
+        acceptedAnswer: { "@type": "Answer", text: "Acme builds widgets." },
+      },
+    ],
+  }}
+/>
+```
+
+### `<Breadcrumb>`
+
+Semantic breadcrumb navigation that automatically emits BreadcrumbList JSON-LD structured data.
+
+```tsx
+import { Breadcrumb } from "@metaphor-cloud/ui";
+
+<Breadcrumb
+  items={[
+    { label: "Home", href: "/" },
+    { label: "Blog", href: "/blog" },
+    { label: "My Post" },
+  ]}
+/>
+```
+
+Supports `renderLink` for framework routers (Next.js, React Router, etc.), a custom `separator`, and `structuredData={false}` to disable JSON-LD output.
+
+```tsx
+<Breadcrumb
+  items={items}
+  separator="/"
+  renderLink={({ href, children, className }) => (
+    <Link to={href} className={className}>{children}</Link>
+  )}
+/>
+```
+
+### `createOgImageUrl`
+
+Factory for building Open Graph image URLs. Works with any OG image service (Vercel OG, custom endpoints, etc.).
+
+```tsx
+import { createOgImageUrl } from "@metaphor-cloud/ui";
+
+const ogImage = createOgImageUrl({
+  baseUrl: "https://og.mysite.com/api/image",
+  defaults: { siteName: "My Site", theme: "dark" },
+});
+
+// Returns: "https://og.mysite.com/api/image?title=Hello+World&siteName=My+Site&theme=dark"
+ogImage({ title: "Hello World" });
+
+// Use with MetaHead
+<MetaHead
+  title="Hello World"
+  image={ogImage({ title: "Hello World" })}
+  imageWidth={1200}
+  imageHeight={630}
+/>
+```
+
+For custom URL formats, pass a `buildUrl` function:
+
+```tsx
+const ogImage = createOgImageUrl({
+  baseUrl: "https://og.mysite.com",
+  buildUrl: (base, params) => `${base}/${encodeURIComponent(params.title)}.png`,
+});
+```
+
+## Hooks
+
+### `useThemeContext()`
+
+Access theme state from inside `ThemeProvider`. Returns `{ theme, resolved, setTheme, cycleTheme }`.
+
+### `useTheme(defaultTheme?)`
+
+Standalone theme hook (used internally by `ThemeProvider`). Use directly if you need theme management without the context provider.
+
+### `useMobile(breakpoint?)`
+
+Returns `true` when the viewport is at or below the breakpoint (default 768px).
+
+```tsx
+import { useMobile } from "@metaphor-cloud/ui";
+
+const isMobile = useMobile();     // default: 768px
+const isTablet = useMobile(1024); // custom breakpoint
+```
+
+### `useCanonical(url)`
+
+Manages a `<link rel="canonical">` tag in the document head. Cleans up on unmount.
+
+```tsx
+import { useCanonical } from "@metaphor-cloud/ui";
+
+useCanonical("https://example.com/page");
+```
+
+### `useAlternateLinks(links)`
+
+Manages `<link rel="alternate" hreflang="…">` tags for multi-language sites.
+
+```tsx
+import { useAlternateLinks } from "@metaphor-cloud/ui";
+
+useAlternateLinks([
+  { hreflang: "en", href: "https://example.com/en/page" },
+  { hreflang: "fr", href: "https://example.com/fr/page" },
+  { hreflang: "x-default", href: "https://example.com/page" },
+]);
+
+## CSS Imports
+
+| Import | Contents |
+|--------|----------|
+| `@metaphor-cloud/ui/metaphor` | Metaphor theme variables + base styles + utilities (all-in-one) |
+| `@metaphor-cloud/ui/um` | Um theme variables + base styles + utilities (all-in-one) |
+| `@metaphor-cloud/ui/style.css` | Base styles + utilities only (no theme variables) |
+| `@metaphor-cloud/ui/themes/metaphor.css` | Metaphor theme variables only |
+| `@metaphor-cloud/ui/themes/um.css` | Um theme variables only |
+
+Use the all-in-one imports for simplicity. Use the split imports if you need to load theme variables separately (e.g. for dynamic theme switching at the CSS level).
+
+## TypeScript
+
+All components and hooks are fully typed. The library re-exports Radix primitive prop types for convenience:
+
+```tsx
+import type {
+  ButtonProps,
+  BadgeProps,
+  InputProps,
+  DialogProps,
+  SelectProps,
+  // ... etc
+} from "@metaphor-cloud/ui";
+```
+
+## Development
+
+```bash
+npm install
+npm run build    # tsc + vite build
+npm run dev      # vite dev server
+```

package/dist/components/Accordion.d.ts

@@ -0,0 +1,14 @@
+import * as React from "react";
+import * as AccordionPrimitive from "@radix-ui/react-accordion";
+declare const Accordion: any;
+declare function AccordionItem({ className, ref, ...props }: React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Item> & {
+    ref?: React.Ref<React.ElementRef<typeof AccordionPrimitive.Item>>;
+}): import("react/jsx-runtime").JSX.Element;
+declare function AccordionTrigger({ className, children, ref, ...props }: React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Trigger> & {
+    ref?: React.Ref<React.ElementRef<typeof AccordionPrimitive.Trigger>>;
+}): import("react/jsx-runtime").JSX.Element;
+declare function AccordionContent({ className, children, ref, ...props }: React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Content> & {
+    ref?: React.Ref<React.ElementRef<typeof AccordionPrimitive.Content>>;
+}): import("react/jsx-runtime").JSX.Element;
+export { Accordion, AccordionItem, AccordionTrigger, AccordionContent };
+//# sourceMappingURL=Accordion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Accordion.d.ts","sourceRoot":"","sources":["Accordion.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,kBAAkB,MAAM,2BAA2B,CAAC;AAGhE,QAAA,MAAM,SAAS,KAA0B,CAAC;AAE1C,iBAAS,aAAa,CAAC,EACrB,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,wBAAwB,CAAC,OAAO,kBAAkB,CAAC,IAAI,CAAC,GAAG;IAClE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;CACnE,2CAQA;AAED,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,QAAQ,EACR,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,wBAAwB,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,GAAG;IACrE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;CACtE,2CAgCA;AAED,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,QAAQ,EACR,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,wBAAwB,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,GAAG;IACrE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;CACtE,2CAUA;AAED,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/components/Alert.d.ts

@@ -0,0 +1,14 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+declare const alertVariants: any;
+declare function Alert({ className, variant, ref, ...props }: React.HTMLAttributes<HTMLDivElement> & VariantProps<typeof alertVariants> & {
+    ref?: React.Ref<HTMLDivElement>;
+}): import("react/jsx-runtime").JSX.Element;
+declare function AlertTitle({ className, ref, ...props }: React.HTMLAttributes<HTMLHeadingElement> & {
+    ref?: React.Ref<HTMLParagraphElement>;
+}): import("react/jsx-runtime").JSX.Element;
+declare function AlertDescription({ className, ref, ...props }: React.HTMLAttributes<HTMLParagraphElement> & {
+    ref?: React.Ref<HTMLParagraphElement>;
+}): import("react/jsx-runtime").JSX.Element;
+export { Alert, AlertTitle, AlertDescription, alertVariants };
+//# sourceMappingURL=Alert.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Alert.d.ts","sourceRoot":"","sources":["Alert.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGlE,QAAA,MAAM,aAAa,KAgBlB,CAAC;AAEF,iBAAS,KAAK,CAAC,EACb,SAAS,EACT,OAAO,EACP,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GACrC,YAAY,CAAC,OAAO,aAAa,CAAC,GAAG;IACnC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;CACjC,2CAUF;AAED,iBAAS,UAAU,CAAC,EAClB,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,kBAAkB,CAAC,GAAG;IAC5C,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;CACvC,2CAQA;AAED,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,oBAAoB,CAAC,GAAG;IAC9C,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;CACvC,2CAQA;AAED,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC"}

package/dist/components/AlertDialog.d.ts

@@ -0,0 +1,27 @@
+import * as React from "react";
+import * as AlertDialogPrimitive from "@radix-ui/react-alert-dialog";
+declare const AlertDialog: any;
+declare const AlertDialogTrigger: any;
+declare const AlertDialogPortal: any;
+declare function AlertDialogOverlay({ className, ref, ...props }: React.ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Overlay> & {
+    ref?: React.Ref<React.ElementRef<typeof AlertDialogPrimitive.Overlay>>;
+}): import("react/jsx-runtime").JSX.Element;
+declare function AlertDialogContent({ className, ref, ...props }: React.ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Content> & {
+    ref?: React.Ref<React.ElementRef<typeof AlertDialogPrimitive.Content>>;
+}): import("react/jsx-runtime").JSX.Element;
+declare const AlertDialogHeader: ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) => import("react/jsx-runtime").JSX.Element;
+declare const AlertDialogFooter: ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) => import("react/jsx-runtime").JSX.Element;
+declare function AlertDialogTitle({ className, ref, ...props }: React.ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Title> & {
+    ref?: React.Ref<React.ElementRef<typeof AlertDialogPrimitive.Title>>;
+}): import("react/jsx-runtime").JSX.Element;
+declare function AlertDialogDescription({ className, ref, ...props }: React.ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Description> & {
+    ref?: React.Ref<React.ElementRef<typeof AlertDialogPrimitive.Description>>;
+}): import("react/jsx-runtime").JSX.Element;
+declare function AlertDialogAction({ className, ref, ...props }: React.ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Action> & {
+    ref?: React.Ref<React.ElementRef<typeof AlertDialogPrimitive.Action>>;
+}): import("react/jsx-runtime").JSX.Element;
+declare function AlertDialogCancel({ className, ref, ...props }: React.ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Cancel> & {
+    ref?: React.Ref<React.ElementRef<typeof AlertDialogPrimitive.Cancel>>;
+}): import("react/jsx-runtime").JSX.Element;
+export { AlertDialog, AlertDialogPortal, AlertDialogOverlay, AlertDialogTrigger, AlertDialogContent, AlertDialogHeader, AlertDialogFooter, AlertDialogTitle, AlertDialogDescription, AlertDialogAction, AlertDialogCancel, };
+//# sourceMappingURL=AlertDialog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AlertDialog.d.ts","sourceRoot":"","sources":["AlertDialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,oBAAoB,MAAM,8BAA8B,CAAC;AAIrE,QAAA,MAAM,WAAW,KAA4B,CAAC;AAC9C,QAAA,MAAM,kBAAkB,KAA+B,CAAC;AACxD,QAAA,MAAM,iBAAiB,KAA8B,CAAC;AAEtD,iBAAS,kBAAkB,CAAC,EAC1B,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,wBAAwB,CAAC,OAAO,oBAAoB,CAAC,OAAO,CAAC,GAAG;IACvE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;CACxE,2CAWA;AAED,iBAAS,kBAAkB,CAAC,EAC1B,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,wBAAwB,CAAC,OAAO,oBAAoB,CAAC,OAAO,CAAC,GAAG;IACvE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;CACxE,2CAgBA;AAED,QAAA,MAAM,iBAAiB,4BAGpB,MAAM,cAAc,CAAC,cAAc,CAAC,4CAKtC,CAAC;AAEF,QAAA,MAAM,iBAAiB,4BAGpB,MAAM,cAAc,CAAC,cAAc,CAAC,4CAQtC,CAAC;AAEF,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,wBAAwB,CAAC,OAAO,oBAAoB,CAAC,KAAK,CAAC,GAAG;IACrE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;CACtE,2CAQA;AAED,iBAAS,sBAAsB,CAAC,EAC9B,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,wBAAwB,CAAC,OAAO,oBAAoB,CAAC,WAAW,CAAC,GAAG;IAC3E,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC;CAC5E,2CAQA;AAED,iBAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,wBAAwB,CAAC,OAAO,oBAAoB,CAAC,MAAM,CAAC,GAAG;IACtE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;CACvE,2CAQA;AAED,iBAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,wBAAwB,CAAC,OAAO,oBAAoB,CAAC,MAAM,CAAC,GAAG;IACtE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;CACvE,2CAQA;AAED,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,GAClB,CAAC"}

package/dist/components/AnimatedCounter.d.ts

@@ -0,0 +1,13 @@
+import * as React from "react";
+export interface AnimatedCounterProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> {
+    /** The target numeric value to animate to. */
+    value: number;
+    /** Animation duration in milliseconds. @default 600 */
+    duration?: number;
+    /** Custom number formatter. @default (n) => Math.round(n).toLocaleString() */
+    formatter?: (value: number) => string;
+    ref?: React.Ref<HTMLSpanElement>;
+}
+declare function AnimatedCounter({ value, duration, formatter, className, ref, ...props }: AnimatedCounterProps): import("react/jsx-runtime").JSX.Element;
+export { AnimatedCounter };
+//# sourceMappingURL=AnimatedCounter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnimatedCounter.d.ts","sourceRoot":"","sources":["AnimatedCounter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,WAAW,oBACf,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC;IAC/D,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;CAClC;AAED,iBAAS,eAAe,CAAC,EACvB,KAAK,EACL,QAAc,EACd,SAAiD,EACjD,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,oBAAoB,2CA+CtB;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/components/Badge.d.ts

@@ -0,0 +1,9 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+declare const badgeVariants: any;
+export interface BadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {
+    ref?: React.Ref<HTMLDivElement>;
+}
+declare function Badge({ className, variant, ref, ...props }: BadgeProps): import("react/jsx-runtime").JSX.Element;
+export { Badge, badgeVariants };
+//# sourceMappingURL=Badge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["Badge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGlE,QAAA,MAAM,aAAa,KAgBlB,CAAC;AAEF,MAAM,WAAW,UACf,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAC1C,YAAY,CAAC,OAAO,aAAa,CAAC;IACpC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;CACjC;AAED,iBAAS,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,UAAU,2CAQ/D;AAED,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC"}

package/dist/components/Breadcrumb.d.ts

@@ -0,0 +1,31 @@
+import * as React from "react";
+export interface BreadcrumbItem {
+    /** Display label */
+    label: string;
+    /** URL for this crumb — omit for the current (last) page */
+    href?: string;
+}
+export interface BreadcrumbLinkRenderProps {
+    href: string;
+    className?: string;
+    children: React.ReactNode;
+}
+export interface BreadcrumbProps extends React.HTMLAttributes<HTMLElement> {
+    /** Ordered list of breadcrumb items (first = root, last = current page) */
+    items: BreadcrumbItem[];
+    /** Separator between items — defaults to "/" */
+    separator?: React.ReactNode;
+    /** Custom link renderer for framework routers (Next.js Link, React Router, etc.) */
+    renderLink?: (props: BreadcrumbLinkRenderProps) => React.ReactNode;
+    /** Emit BreadcrumbList JSON-LD structured data — defaults to true */
+    structuredData?: boolean;
+    ref?: React.Ref<HTMLElement>;
+}
+/**
+ * Semantic breadcrumb navigation with optional JSON-LD structured data.
+ *
+ * Uses `<nav>` with `aria-label="Breadcrumb"` and an `<ol>` for proper
+ * accessibility. The last item is marked with `aria-current="page"`.
+ */
+export declare function Breadcrumb({ items, separator, renderLink, structuredData, className, ref, ...props }: BreadcrumbProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Breadcrumb.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Breadcrumb.d.ts","sourceRoot":"","sources":["Breadcrumb.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC;IACxE,2EAA2E;IAC3E,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,gDAAgD;IAChD,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,oFAAoF;IACpF,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,KAAK,CAAC,SAAS,CAAC;IACnE,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;CAC9B;AA+CD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,SAAS,EACT,UAA8B,EAC9B,cAAqB,EACrB,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,eAAe,2CA6DjB"}

package/dist/components/Button.d.ts

@@ -0,0 +1,10 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+declare const buttonVariants: any;
+export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+    asChild?: boolean;
+    ref?: React.Ref<HTMLButtonElement>;
+}
+declare function Button({ className, variant, size, asChild, ref, ...props }: ButtonProps): import("react/jsx-runtime").JSX.Element;
+export { Button, buttonVariants };
+//# sourceMappingURL=Button.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGlE,QAAA,MAAM,cAAc,KAiCnB,CAAC;AAEF,MAAM,WAAW,WACf,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EACnD,YAAY,CAAC,OAAO,cAAc,CAAC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;CACpC;AAED,iBAAS,MAAM,CAAC,EACd,SAAS,EACT,OAAO,EACP,IAAI,EACJ,OAAe,EACf,GAAG,EACH,GAAG,KAAK,EACT,EAAE,WAAW,2CASb;AAED,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC"}

package/dist/components/Card.d.ts

@@ -0,0 +1,21 @@
+import * as React from "react";
+declare function Card({ className, ref, ...props }: React.HTMLAttributes<HTMLDivElement> & {
+    ref?: React.Ref<HTMLDivElement>;
+}): import("react/jsx-runtime").JSX.Element;
+declare function CardHeader({ className, ref, ...props }: React.HTMLAttributes<HTMLDivElement> & {
+    ref?: React.Ref<HTMLDivElement>;
+}): import("react/jsx-runtime").JSX.Element;
+declare function CardTitle({ className, ref, ...props }: React.HTMLAttributes<HTMLDivElement> & {
+    ref?: React.Ref<HTMLDivElement>;
+}): import("react/jsx-runtime").JSX.Element;
+declare function CardDescription({ className, ref, ...props }: React.HTMLAttributes<HTMLDivElement> & {
+    ref?: React.Ref<HTMLDivElement>;
+}): import("react/jsx-runtime").JSX.Element;
+declare function CardContent({ className, ref, ...props }: React.HTMLAttributes<HTMLDivElement> & {
+    ref?: React.Ref<HTMLDivElement>;
+}): import("react/jsx-runtime").JSX.Element;
+declare function CardFooter({ className, ref, ...props }: React.HTMLAttributes<HTMLDivElement> & {
+    ref?: React.Ref<HTMLDivElement>;
+}): import("react/jsx-runtime").JSX.Element;
+export { Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter };
+//# sourceMappingURL=Card.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["Card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,iBAAS,IAAI,CAAC,EACZ,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;CACjC,2CAWA;AAED,iBAAS,UAAU,CAAC,EAClB,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;CACjC,2CAQA;AAED,iBAAS,SAAS,CAAC,EACjB,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;CACjC,2CAQA;AAED,iBAAS,eAAe,CAAC,EACvB,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;CACjC,2CAQA;AAED,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;CACjC,2CAEA;AAED,iBAAS,UAAU,CAAC,EAClB,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;CACjC,2CAQA;AAED,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC"}

package/dist/components/Checkbox.d.ts

@@ -0,0 +1,7 @@
+import * as React from "react";
+import * as CheckboxPrimitive from "@radix-ui/react-checkbox";
+declare function Checkbox({ className, ref, ...props }: React.ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root> & {
+    ref?: React.Ref<React.ElementRef<typeof CheckboxPrimitive.Root>>;
+}): import("react/jsx-runtime").JSX.Element;
+export { Checkbox };
+//# sourceMappingURL=Checkbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Checkbox.d.ts","sourceRoot":"","sources":["Checkbox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,iBAAiB,MAAM,0BAA0B,CAAC;AAG9D,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,wBAAwB,CAAC,OAAO,iBAAiB,CAAC,IAAI,CAAC,GAAG;IACjE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;CAClE,2CA+BA;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/components/CodeBlock.d.ts

@@ -0,0 +1,8 @@
+import * as React from "react";
+export interface CodeBlockProps extends React.HTMLAttributes<HTMLElement> {
+    inline?: boolean;
+    ref?: React.Ref<HTMLElement>;
+}
+declare function CodeBlock({ className, inline, children, ref, ...props }: CodeBlockProps): import("react/jsx-runtime").JSX.Element;
+export { CodeBlock };
+//# sourceMappingURL=CodeBlock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CodeBlock.d.ts","sourceRoot":"","sources":["CodeBlock.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;CAC9B;AAED,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,2CA4BhF;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}