prime-ui-kit 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 esurkov1
+
+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,270 @@
+# prime-ui-kit
+
+[![npm version](https://img.shields.io/npm/v/prime-ui-kit.svg)](https://www.npmjs.com/package/prime-ui-kit)
+[![License: MIT](https://img.shields.io/npm/l/prime-ui-kit.svg)](https://github.com/esurkov1/prime-ui/blob/main/LICENSE)
+[![React](https://img.shields.io/badge/React-19-61dafb?logo=react&logoColor=white)](https://react.dev/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5-3178c6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+
+A **React 19** component library built with **CSS Modules**, **design tokens** as CSS variables (`--prime-sys-*`), and a **composable API** (`Modal.Root`, `Input.Field`, `Select.Trigger`, …). Works with **Vite**, **Next.js**, **Remix**, or any bundler that supports CSS Modules. Accessibility follows **react-aria-components** where it fits.
+
+**Links:** [npm](https://www.npmjs.com/package/prime-ui-kit) · [Repository & issues](https://github.com/esurkov1/prime-ui/issues)
+
+---
+
+## Table of contents
+
+- [Metadata (for tooling and LLMs)](#metadata-for-tooling-and-llms)
+- [Key features](#key-features)
+- [Requirements](#requirements)
+- [Installation](#installation)
+- [Styles and theming](#styles-and-theming)
+- [Quick start](#quick-start)
+- [Typography](#typography)
+- [Imports: main entry and heavy modules](#imports-main-entry-and-heavy-modules)
+- [Providers and context](#providers-and-context)
+- [Component catalog](#component-catalog)
+- [Package exports (`package.json` / `exports`)](#package-exports-packagejson--exports)
+- [TypeScript](#typescript)
+- [Application shell layout](#application-shell-layout)
+- [Where component docs live](#where-component-docs-live)
+- [License](#license)
+
+---
+
+## Metadata (for tooling and LLMs)
+
+```yaml
+name: prime-ui-kit
+ecosystem: react
+react_version: "^19.0.0"
+module_system: ESM
+styling: CSS Modules + CSS variables (--prime-sys-*)
+a11y_stack: react-aria-components (peer)
+documentation_per_component: src/components/<name>/COMPONENT.md
+component_examples_glob: src/components/<name>/examples/*.tsx
+layout_examples_glob: src/layout/<name>/examples/*.tsx
+repository: https://github.com/esurkov1/prime-ui
+typography: variant_roles  # see src/components/typography/COMPONENT.md
+```
+
+---
+
+## Key features
+
+- **Tokens & themes** — semantic variables, light and dark themes via `data-theme`.
+- **Composition** — subcomponent pattern (`Root`, `Field`, `Trigger`, …) instead of monolithic prop blobs.
+- **Forms** — inputs, selects, toggles, file upload, color, OTP-style fields, sliders.
+- **Overlays** — modals, drawers, popovers, menus, tooltips, command palette.
+- **Navigation & layout** — sidebar, breadcrumbs, tabs, accordion, stepper, pagination, page shell.
+- **Data** — table with sorting, pagination, or infinite scroll.
+- **Types** — published `.d.ts` alongside the package.
+- **Notifications** — toast queue via `NotificationProvider` and `useNotifications()`.
+
+---
+
+## Requirements
+
+| Dependency | Version |
+|------------|---------|
+| `react` / `react-dom` | ^19.0.0 |
+| `react-aria-components` | ^1.16.0 |
+| `react-day-picker` | ^9.14.0 |
+| `date-fns` | ^4.0.0 |
+
+The package bundles **lucide-react**, **framer-motion**, and **react-router-dom** (icons, notification motion, and **Sidebar** routing). Use a router (e.g. `BrowserRouter`) if **Sidebar** renders navigation items.
+
+---
+
+## Installation
+
+```bash
+npm install prime-ui-kit react react-dom react-aria-components react-day-picker date-fns
+```
+
+```bash
+pnpm add prime-ui-kit react react-dom react-aria-components react-day-picker date-fns
+```
+
+```bash
+bun add prime-ui-kit react react-dom react-aria-components react-day-picker date-fns
+```
+
+---
+
+## Styles and theming
+
+Import **global styles** (fonts, reset, tokens, both themes) and the **bundled component CSS** (CSS Modules output from the published build):
+
+```css
+@import "prime-ui-kit/styles.css";
+@import "prime-ui-kit/bundle.css";
+```
+
+- **`styles.css`** — Google Fonts, CSS reset, design tokens, light and dark themes.
+- **`bundle.css`** — class rules that match the JS bundle (`Button`, `Input`, …).
+
+**Light / dark:** set `data-theme="light"` or `data-theme="dark"` on `<html>`, a layout root, or any wrapper.
+
+Fine-grained imports (custom reset, single theme):
+
+```css
+@import "prime-ui-kit/tokens.css";
+@import "prime-ui-kit/theme-light.css";
+/* @import "prime-ui-kit/theme-dark.css"; */
+@import "prime-ui-kit/bundle.css";
+```
+
+If you only use **`prime-ui-kit/components`**, swap `bundle.css` for **`prime-ui-kit/components.css`**.
+
+---
+
+## Quick start
+
+```tsx
+import { Button, Input, Modal } from "prime-ui-kit";
+
+export function Example() {
+  return (
+    <>
+      <Input.Root size="m" label="Email" id="email">
+        <Input.Wrapper>
+          <Input.Field type="email" placeholder="you@example.com" />
+        </Input.Wrapper>
+      </Input.Root>
+
+      <Button variant="primary" mode="filled" size="l">
+        Submit
+      </Button>
+    </>
+  );
+}
+```
+
+---
+
+## Typography
+
+Текст страницы оформляется компонентом **`Typography`** с ролями **`variant`**: каждая роль задаёт пару кегль/межстрочный интервал из темы (`typography.role` → `--prime-sys-typography-role-*`). Примитивы `font.size.*` согласованы со [шкалой MD3](https://m3.material.io/styles/typography/type-scale-tokens); роли выстроены по смыслу рядом с **MD3**, **Apple SF** и **Polaris** — таблица соответствий и примерных **rem/px** при корне 16px — в [Typography COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/typography/COMPONENT.md).
+
+---
+
+## Imports: main entry and heavy modules
+
+- **`prime-ui-kit`** — main entry; use for most apps.
+- **`prime-ui-kit/components`** — alternate entry for tree-shaking heavier modules (e.g. `DataTable`).
+
+```tsx
+import { DataTable } from "prime-ui-kit/components";
+```
+
+---
+
+## Providers and context
+
+| API | Purpose |
+|-----|---------|
+| **`NotificationProvider`** + **`useNotifications()`** | Toast queue: `notify`, `dismiss`, `dismissAll`. Wrap your app or a subtree. |
+| **`ControlSizeProvider`** | Default **`s` \| `m` \| `l` \| `xl`** for controls inside the subtree. |
+
+---
+
+## Component catalog
+
+Descriptions are short summaries from the **About** section in each `COMPONENT.md` (where it exists). Full API, parts, and examples are in the linked files. **AppShell**, **ExampleFrame**, and **ScrollContainer** ship without a dedicated `COMPONENT.md` — use the linked source folders.
+
+Documentation base URL in the repo: `https://github.com/esurkov1/prime-ui/blob/main/src/components/`
+
+| Category | Component | Description | Docs |
+|----------|-----------|-------------|------|
+| Forms & input | **Checkbox** | Checkbox with chrome, label, hint, and error text. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/checkbox/COMPONENT.md) |
+| Forms & input | **ColorPicker** | Color selection: 2D area, channel sliders, swatches, hex, eyedropper (react-aria). | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/color-picker/COMPONENT.md) |
+| Forms & input | **DigitInput** | OTP-style one-character cells with paste and focus handoff. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/digit-input/COMPONENT.md) |
+| Forms & input | **FileUpload** | File picking: hidden `input`, drag-and-drop, per-file rows with progress. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/file-upload/COMPONENT.md) |
+| Forms & input | **Hint** | Helper or status line under a field, optional leading icon. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/hint/COMPONENT.md) |
+| Forms & input | **Input** | Single-line field with wrapper, affixes, and hint/error lines. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/input/COMPONENT.md) |
+| Forms & input | **Kbd** | Keyboard shortcuts styled as UI chrome (`kbd`). | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/kbd/COMPONENT.md) |
+| Forms & input | **Label** | Field caption: icon, required asterisk, secondary text. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/label/COMPONENT.md) |
+| Forms & input | **Radio** | Radio group with label, hint, and error wiring. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/radio/COMPONENT.md) |
+| Forms & input | **SegmentedControl** | Horizontal `radiogroup` with segments and a sliding indicator. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/segmented-control/COMPONENT.md) |
+| Forms & input | **Select** | Single-select combobox with a portaled listbox. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/select/COMPONENT.md) |
+| Forms & input | **Slider** | Horizontal `input type="range"` with kit sizing. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/slider/COMPONENT.md) |
+| Forms & input | **Switch** | On/off control with label and metadata slots. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/switch/COMPONENT.md) |
+| Forms & input | **Textarea** | Multiline field, character counter, hints and errors. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/textarea/COMPONENT.md) |
+| Date & time | **Datepicker** | Calendar, ranges, presets, optional time (react-day-picker + date-fns). | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/datepicker/COMPONENT.md) |
+| Overlays | **CommandMenu** | Modal command palette: search and pick from the list with the keyboard. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/command-menu/COMPONENT.md) |
+| Overlays | **Drawer** | Side sheet in a portal with scroll lock and focus management. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/drawer/COMPONENT.md) |
+| Overlays | **Dropdown** | Action menu with trigger and portaled panel (`role="menu"`). | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/dropdown/COMPONENT.md) |
+| Overlays | **Modal** | Centered dialog with backdrop, focus trap, optional built-in chrome. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/modal/COMPONENT.md) |
+| Overlays | **Popover** | Anchor + portaled panel; non-modal surface next to the trigger. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/popover/COMPONENT.md) |
+| Overlays | **Tooltip** | Delayed hint; trigger and content in a portal. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/tooltip/COMPONENT.md) |
+| Navigation & layout | **Accordion** | Expandable sections (FAQ, settings groups) with height animation. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/accordion/COMPONENT.md) |
+| Navigation & layout | **Breadcrumb** | `nav` trail with links, separators, and optional ellipsis. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/breadcrumb/COMPONENT.md) |
+| Navigation & layout | **Pagination** | Page controls: prev/next, page numbers, ellipsis. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/pagination/COMPONENT.md) |
+| Navigation & layout | **Sidebar** | Side navigation: single panel, groups, menus, responsive overlay. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/layout/sidebar/COMPONENT.md) |
+| Navigation & layout | **Stepper** | Multi-step flow on `<ol>` / `<li>` plus horizontal/vertical primitives. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/stepper/COMPONENT.md) |
+| Navigation & layout | **Tabs** | Tablist, indicator, one visible panel at a time. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/tabs/COMPONENT.md) |
+| Navigation & layout | **PageContent** | Main column: `Section` or `Root`, title, description (`measure`), body. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/page-content/COMPONENT.md) |
+| Navigation & layout | **AppShell** | Application shell: grid root, nav slot, scrollable **`main`** with page gutters (`x6`) on **`Main`**. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/layout/app-shell/COMPONENT.md) |
+| Navigation & layout | **ScrollContainer** | Scrollable region with horizontal or vertical axis (overflow wrapper). | [Source](https://github.com/esurkov1/prime-ui/tree/main/src/components/scroll-container) |
+| Data | **DataTable** | Table with scroll, sorting, pagination or infinite scroll, sticky regions. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/data-table/COMPONENT.md) |
+| Display & content | **Avatar** | Circular avatar: image, fallback, group with overflow cell. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/avatar/COMPONENT.md) |
+| Display & content | **Badge** | Compact status or count; optional presence dot variant. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/badge/COMPONENT.md) |
+| Display & content | **Banner** | In-flow announcement strip with icon, copy, and actions. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/banner/COMPONENT.md) |
+| Display & content | **CodeBlock** | TS/TSX syntax highlighting in `pre`/`code` (static presentation). | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/code-block/COMPONENT.md) |
+| Display & content | **ExampleFrame** | Preview stage + code layout for playgrounds and internal docs. | [Source](https://github.com/esurkov1/prime-ui/tree/main/src/components/example-frame) |
+| Display & content | **Card** | Dashboard tiles: `mini`, `mini-media`, `metric`, `panel`, `stat-trend`, `cta`, `list`, `split`, `cover`. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/card/COMPONENT.md) |
+| Display & content | **Divider** | Horizontal or vertical rule with optional inset label. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/divider/COMPONENT.md) |
+| Display & content | **ProgressBar** | Horizontal progress on the native `<progress>` element. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/progress-bar/COMPONENT.md) |
+| Display & content | **SegmentedProgressBar** | Stacked horizontal segments with proportional weights and semantic tones. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/segmented-progress-bar/COMPONENT.md) |
+| Display & content | **ProgressCircle** | Circular progress ring (SVG + `progressbar`). | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/progress-circle/COMPONENT.md) |
+| Display & content | **Tag** | Chip with optional icon, trailing dismiss when `onRemove` is set. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/tag/COMPONENT.md) |
+| Display & content | **Typography** | Reading text via semantic **`variant`** (roles), weight, tracking, muted tone. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/typography/COMPONENT.md) |
+| Actions & feedback | **Button** | Action control: `asChild`, icon, loading spinner. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/button/COMPONENT.md) |
+| Actions & feedback | **ButtonGroup** | Button row sharing one outline and internal dividers. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/button-group/COMPONENT.md) |
+| Actions & feedback | **LinkButton** | Text-style link with control padding and underline on hover/focus. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/link-button/COMPONENT.md) |
+| Actions & feedback | **Notification** | Toasts: provider, queue, positions, semantic types. | [COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/components/notification/COMPONENT.md) |
+
+---
+
+## Package exports (`package.json` / `exports`)
+
+| Path | Purpose |
+|------|---------|
+| `prime-ui-kit` | Main JS/TS API. |
+| `prime-ui-kit/components` | Alternate entry for tree-shaking heavier chunks. |
+| `prime-ui-kit/styles.css` | Global styles (fonts, reset, tokens, themes). |
+| `prime-ui-kit/tokens.css` | Tokens only. |
+| `prime-ui-kit/theme-light.css` / `theme-dark.css` | Individual theme files. |
+| `prime-ui-kit/bundle.css` | CSS aligned with the main bundle. |
+| `prime-ui-kit/components.css` | CSS for the `components` entry. |
+
+---
+
+## TypeScript
+
+Type definitions ship with the package (`dist/*.d.ts`).
+
+---
+
+## Where component docs live
+
+- **In the repo / on GitHub:** each component has `src/components/<name>/COMPONENT.md` (see the table above). **Sidebar** uses `src/layout/sidebar/COMPONENT.md`.
+- **Canonical + extended examples:** next to each `COMPONENT.md`, the `examples/` folder holds **3–5 self-contained `.tsx` files** (and optional `examples.module.css`) with real product scenarios. `COMPONENT.md` lists them under **Extended examples**; start from the **Canonical example** in the same file for a maximal single-block overview.
+- **Why separate files (not one `examples.md`):** each file is one scenario with a clear filename — easier for humans to navigate and for LLMs to retrieve the right chunk without loading an entire mega-document.
+- **In the installed package:** `COMPONENT.md` and `examples/**` are published (`package.json` → `files`), e.g. `node_modules/prime-ui-kit/src/components/button/examples/` and `node_modules/prime-ui-kit/src/layout/sidebar/COMPONENT.md`.
+
+**ExampleFrame** and **ScrollContainer** do not have a dedicated `COMPONENT.md`; refer to the linked source folders and types in the `.tsx` files.
+
+---
+
+## Application shell layout
+
+Use **`AppShell.Template`** so routes render inside **`AppShell.Main`**, which applies canonical **`--prime-sys-spacing-x6`** padding (no extra wrapper). **`PageContent.Root`** does **not** add edge padding; pair **`PageContent`** with the shell. Import **`prime-ui-kit/styles.css`** and **`prime-ui-kit/bundle.css`** so layout CSS applies.
+
+**Full diagram, token table, and troubleshooting** (“margins disappeared”): [src/layout/app-shell/COMPONENT.md](https://github.com/esurkov1/prime-ui/blob/main/src/layout/app-shell/COMPONENT.md).
+
+---
+
+## License
+
+MIT — see [`LICENSE`](https://github.com/esurkov1/prime-ui/blob/main/LICENSE) in the repo and in the npm package.

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

@@ -0,0 +1,70 @@
+import * as React from "react";
+import type { AccordionSize } from "@/internal/states";
+export type AccordionType = "single" | "multiple";
+export type { AccordionSize };
+export type AccordionRootProps = React.HTMLAttributes<HTMLDivElement> & {
+    type?: AccordionType;
+    value?: string | string[];
+    defaultValue?: string | string[];
+    onValueChange?: (value: string | string[]) => void;
+    /** Только для `type="single"`. Если `false`, в одиночном режиме нельзя закрыть открытый пункт. По умолчанию `true`. */
+    collapsible?: boolean;
+    /** Размер триггера, иконок и отступов контента. По умолчанию `m`. */
+    size?: AccordionSize;
+    /** Групповой список без зазоров (`grouped`) или отдельные карточки (`separate`). */
+    layout?: "grouped" | "separate";
+};
+export type AccordionItemProps = React.HTMLAttributes<HTMLDivElement> & {
+    value: string;
+    disabled?: boolean;
+};
+export type AccordionHeaderProps = React.HTMLAttributes<HTMLHeadingElement>;
+export type AccordionTriggerProps = React.ButtonHTMLAttributes<HTMLButtonElement>;
+export type AccordionContentProps = React.HTMLAttributes<HTMLDivElement>;
+export type AccordionIconProps<T extends React.ElementType = "div"> = {
+    as?: T;
+    className?: string;
+    children?: React.ReactNode;
+} & Omit<React.ComponentPropsWithoutRef<T>, "as" | "className">;
+export type AccordionArrowProps = React.HTMLAttributes<HTMLSpanElement> & {
+    openIcon?: React.ElementType<{
+        className?: string;
+        strokeWidth?: number | string;
+    }>;
+    closeIcon?: React.ElementType<{
+        className?: string;
+        strokeWidth?: number | string;
+    }>;
+};
+declare function AccordionIcon<T extends React.ElementType = "div">({ as, className, children, ...rest }: AccordionIconProps<T>): import("react/jsx-runtime").JSX.Element;
+declare namespace AccordionIcon {
+    var displayName: string;
+}
+declare function AccordionArrow({ className, openIcon: OpenIcon, closeIcon: CloseIcon, ...rest }: AccordionArrowProps): import("react/jsx-runtime").JSX.Element;
+declare namespace AccordionArrow {
+    var displayName: string;
+}
+export declare const Accordion: {
+    Root: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
+        type?: AccordionType;
+        value?: string | string[];
+        defaultValue?: string | string[];
+        onValueChange?: (value: string | string[]) => void;
+        /** Только для `type="single"`. Если `false`, в одиночном режиме нельзя закрыть открытый пункт. По умолчанию `true`. */
+        collapsible?: boolean;
+        /** Размер триггера, иконок и отступов контента. По умолчанию `m`. */
+        size?: AccordionSize;
+        /** Групповой список без зазоров (`grouped`) или отдельные карточки (`separate`). */
+        layout?: "grouped" | "separate";
+    } & React.RefAttributes<HTMLDivElement>>;
+    Header: React.ForwardRefExoticComponent<AccordionHeaderProps & React.RefAttributes<HTMLHeadingElement>>;
+    Item: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
+        value: string;
+        disabled?: boolean;
+    } & React.RefAttributes<HTMLDivElement>>;
+    Trigger: React.ForwardRefExoticComponent<AccordionTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+    Icon: typeof AccordionIcon;
+    Arrow: typeof AccordionArrow;
+    Content: React.ForwardRefExoticComponent<AccordionContentProps & React.RefAttributes<HTMLDivElement>>;
+};
+//# sourceMappingURL=Accordion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Accordion.d.ts","sourceRoot":"","sources":["../../../../src/components/accordion/Accordion.tsx"],"names":[],"mappings":"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"}

package/dist/components/accordion/examples/01-faq-marketing.d.ts

@@ -0,0 +1,5 @@
+/**
+ * FAQ-style marketing page: single expansion, grouped frame, triggers with icons and chevron.
+ */
+export default function AccordionExampleFaqMarketing(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=01-faq-marketing.d.ts.map

package/dist/components/accordion/examples/01-faq-marketing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"01-faq-marketing.d.ts","sourceRoot":"","sources":["../../../../../src/components/accordion/examples/01-faq-marketing.tsx"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,4BAA4B,4CAqDnD"}

package/dist/components/accordion/examples/02-settings-panels.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Account settings: compare several open sections at once with `type="multiple"` and card-like
+ * `layout="separate"`.
+ */
+export default function AccordionExampleSettingsPanels(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=02-settings-panels.d.ts.map

package/dist/components/accordion/examples/02-settings-panels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"02-settings-panels.d.ts","sourceRoot":"","sources":["../../../../../src/components/accordion/examples/02-settings-panels.tsx"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,8BAA8B,4CAoDrD"}

package/dist/components/accordion/examples/03-checkout-order-summary.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Checkout flow: custom open/close icons on the arrow, dense copy, and a policy link in the body.
+ */
+export default function AccordionExampleCheckoutOrderSummary(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=03-checkout-order-summary.d.ts.map

package/dist/components/accordion/examples/03-checkout-order-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"03-checkout-order-summary.d.ts","sourceRoot":"","sources":["../../../../../src/components/accordion/examples/03-checkout-order-summary.tsx"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,oCAAoC,4CA8E3D"}

package/dist/components/accordion/examples/04-api-docs-sections.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Long-form API reference: controlled `value` / `onValueChange` so another part of the page (or
+ * deep link) can sync which section is open.
+ */
+export default function AccordionExampleApiDocsSections(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=04-api-docs-sections.d.ts.map

package/dist/components/accordion/examples/04-api-docs-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"04-api-docs-sections.d.ts","sourceRoot":"","sources":["../../../../../src/components/accordion/examples/04-api-docs-sections.tsx"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,+BAA+B,4CA4EtD"}

package/dist/components/accordion/examples/05-knowledge-base-categories.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Support hub: `collapsible={false}` keeps one section pinned open once chosen, and a disabled item
+ * marks content that is not yet available for the user’s plan.
+ */
+export default function AccordionExampleKnowledgeBaseCategories(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=05-knowledge-base-categories.d.ts.map

package/dist/components/accordion/examples/05-knowledge-base-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"05-knowledge-base-categories.d.ts","sourceRoot":"","sources":["../../../../../src/components/accordion/examples/05-knowledge-base-categories.tsx"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,uCAAuC,4CAiD9D"}

package/dist/components/avatar/Avatar.d.ts

@@ -0,0 +1,58 @@
+import * as React from "react";
+export type AvatarSize = "s" | "m" | "l" | "xl" | "2xl" | "3xl" | "4xl" | "5xl" | "6xl";
+export type AvatarImageStatus = "idle" | "loading" | "loaded" | "error";
+export type AvatarRootProps = {
+    size?: AvatarSize;
+    className?: string;
+    children?: React.ReactNode;
+} & React.HTMLAttributes<HTMLDivElement>;
+export type AvatarImageProps = {
+    src: string;
+    alt?: string;
+    className?: string;
+} & Omit<React.ImgHTMLAttributes<HTMLImageElement>, "src" | "alt">;
+export type AvatarFallbackProps = {
+    children?: React.ReactNode;
+    className?: string;
+} & React.HTMLAttributes<HTMLSpanElement>;
+declare function AvatarFallback({ children, className, ...rest }: AvatarFallbackProps): import("react/jsx-runtime").JSX.Element;
+declare namespace AvatarFallback {
+    var displayName: string;
+}
+export type AvatarGroupOverflowProps = {
+    size?: AvatarSize;
+    className?: string;
+    children?: React.ReactNode;
+} & React.HTMLAttributes<HTMLDivElement>;
+export type AvatarGroupRootProps = {
+    size?: AvatarSize;
+    className?: string;
+    children?: React.ReactNode;
+} & React.HTMLAttributes<HTMLDivElement>;
+export declare const Avatar: {
+    Root: React.ForwardRefExoticComponent<{
+        size?: AvatarSize;
+        className?: string;
+        children?: React.ReactNode;
+    } & React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+    Image: React.ForwardRefExoticComponent<{
+        src: string;
+        alt?: string;
+        className?: string;
+    } & Omit<React.ImgHTMLAttributes<HTMLImageElement>, "alt" | "src"> & React.RefAttributes<HTMLImageElement>>;
+    Fallback: typeof AvatarFallback;
+    Group: {
+        Root: React.ForwardRefExoticComponent<{
+            size?: AvatarSize;
+            className?: string;
+            children?: React.ReactNode;
+        } & React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+        Overflow: React.ForwardRefExoticComponent<{
+            size?: AvatarSize;
+            className?: string;
+            children?: React.ReactNode;
+        } & React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+    };
+};
+export {};
+//# sourceMappingURL=Avatar.d.ts.map

package/dist/components/avatar/Avatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../../../../src/components/avatar/Avatar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAExF,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAUxE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;AAgCzC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC;AA2DnE,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;AAE1C,iBAAS,cAAc,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,mBAAmB,2CAY5E;kBAZQ,cAAc;;;AA8BvB,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;AAsDzC,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,GAAG,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;AAiBzC,eAAO,MAAM,MAAM;;eApNV,UAAU;oBACL,MAAM;mBACP,KAAK,CAAC,SAAS;;;aAkCrB,MAAM;cACL,MAAM;oBACA,MAAM;;;;;mBA0JX,UAAU;wBACL,MAAM;uBACP,KAAK,CAAC,SAAS;;;mBA5DnB,UAAU;wBACL,MAAM;uBACP,KAAK,CAAC,SAAS;;;CAoF3B,CAAC"}

package/dist/components/avatar/examples/app-header-nav.d.ts

@@ -0,0 +1,5 @@
+/**
+ * App chrome: product title, nav links, and a signed-in identity cluster (avatar + account link).
+ */
+export default function AvatarAppHeaderNavExample(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=app-header-nav.d.ts.map

package/dist/components/avatar/examples/app-header-nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-header-nav.d.ts","sourceRoot":"","sources":["../../../../../src/components/avatar/examples/app-header-nav.tsx"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,4CAsBhD"}

package/dist/components/avatar/examples/comment-thread.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Comment thread: avatar + stacked author line and body copy.
+ */
+export default function AvatarCommentThreadExample(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=comment-thread.d.ts.map

package/dist/components/avatar/examples/comment-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-thread.d.ts","sourceRoot":"","sources":["../../../../../src/components/avatar/examples/comment-thread.tsx"],"names":[],"mappings":"AAgCA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,0BAA0B,4CAqBjD"}

package/dist/components/avatar/examples/fallback-variants.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Side-by-side: loaded image, initials-only fallback, and icon-only fallback.
+ */
+export default function AvatarFallbackVariantsExample(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=fallback-variants.d.ts.map

package/dist/components/avatar/examples/fallback-variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-variants.d.ts","sourceRoot":"","sources":["../../../../../src/components/avatar/examples/fallback-variants.tsx"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,6BAA6B,4CAsBpD"}

package/dist/components/avatar/examples/group-overflow.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Overlapping group with an overflow cell for hidden participants.
+ */
+export default function AvatarGroupOverflowExample(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=group-overflow.d.ts.map

package/dist/components/avatar/examples/group-overflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-overflow.d.ts","sourceRoot":"","sources":["../../../../../src/components/avatar/examples/group-overflow.tsx"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,0BAA0B,4CAqBjD"}

package/dist/components/avatar/examples/group-three.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Overlapping row of three avatars, group `size` cloned to children — mirrors `playground/snippets/avatar/group-three.tsx`.
+ */
+export default function AvatarGroupThreeExample(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=group-three.d.ts.map

package/dist/components/avatar/examples/group-three.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-three.d.ts","sourceRoot":"","sources":["../../../../../src/components/avatar/examples/group-three.tsx"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,4CAiB9C"}

package/dist/components/avatar/examples/sizes.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Full `size` scale in one row — mirrors `playground/snippets/avatar/sizes.tsx`.
+ */
+export default function AvatarSizesExample(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=sizes.d.ts.map

package/dist/components/avatar/examples/sizes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sizes.d.ts","sourceRoot":"","sources":["../../../../../src/components/avatar/examples/sizes.tsx"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,4CAWzC"}

package/dist/components/avatar/examples/src-from-state.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Parent-owned `src`; image remounts per URL — mirrors `playground/snippets/avatar/src-from-state.tsx`.
+ */
+export default function AvatarSrcFromStateExample(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=src-from-state.d.ts.map

package/dist/components/avatar/examples/src-from-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"src-from-state.d.ts","sourceRoot":"","sources":["../../../../../src/components/avatar/examples/src-from-state.tsx"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,4CAmBhD"}

package/dist/components/avatar/examples/states.d.ts

@@ -0,0 +1,5 @@
+/**
+ * No `Avatar.Image` (idle), successful load, bad URL (error) — mirrors `playground/snippets/avatar/states.tsx`.
+ */
+export default function AvatarStatesExample(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=states.d.ts.map

package/dist/components/avatar/examples/states.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../../../../src/components/avatar/examples/states.tsx"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,4CAgB1C"}

package/dist/components/avatar/examples/team-list.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Team roster: each row pairs Avatar with Typography; missing photo falls back to initials.
+ */
+export default function AvatarTeamListExample(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=team-list.d.ts.map

package/dist/components/avatar/examples/team-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-list.d.ts","sourceRoot":"","sources":["../../../../../src/components/avatar/examples/team-list.tsx"],"names":[],"mappings":"AAeA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,4CA0B5C"}