prime-ui-kit 0.3.2 → 0.4.0

package/dist/layout/sidebar/Sidebar.d.ts

@@ -10,8 +10,16 @@ export type { SidebarLayoutMode, SidebarRootProps, SidebarSize };
 export { useSidebarContext };
 /** @deprecated Используйте `responsive` из `Sidebar.Root`. */
 export type SidebarResponsive = boolean;
-export type SidebarNavPanelProps = React.ComponentPropsWithoutRef<"nav">;
-declare function SidebarNavPanel({ className, id, ...rest }: SidebarNavPanelProps): import("react/jsx-runtime").JSX.Element;
+export type SidebarToggleButtonProps = Omit<React.ComponentPropsWithoutRef<"button">, "children" | "aria-label"> & {
+    openLabel?: string;
+    closedLabel?: string;
+    placement?: "inline" | "edge";
+};
+export type SidebarNavPanelProps = React.ComponentPropsWithoutRef<"nav"> & {
+    /** По умолчанию рендерится встроенная кнопка сворачивания на грани панели (`placement="edge"`). Состояние — через `Sidebar.Root` (`state` / `onStateChange`) или `useSidebarContext`. */
+    showToggle?: boolean;
+};
+declare function SidebarNavPanel({ className, id, showToggle, children, ...rest }: SidebarNavPanelProps): import("react/jsx-runtime").JSX.Element;
 declare namespace SidebarNavPanel {
     var displayName: string;
 }
@@ -47,11 +55,6 @@ declare function SidebarText({ className, ...rest }: SidebarTextProps): import("
 declare namespace SidebarText {
     var displayName: string;
 }
-export type SidebarToggleButtonProps = Omit<React.ComponentPropsWithoutRef<"button">, "children" | "aria-label"> & {
-    openLabel?: string;
-    closedLabel?: string;
-    placement?: "inline" | "edge";
-};
 export type SidebarIdentityButtonProps = Omit<React.ComponentPropsWithoutRef<"button">, "children"> & {
     leading?: React.ReactNode;
     title: React.ReactNode;

package/dist/layout/sidebar/Sidebar.d.ts.map

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

package/dist/layout/sidebar/SidebarRoot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SidebarRoot.d.ts","sourceRoot":"","sources":["../../../../src/layout/sidebar/SidebarRoot.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EACL,KAAK,uBAAuB,EAG5B,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,GAAG;IACzF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACnD,kBAAkB;IAClB,IAAI,CAAC,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IACnD,kBAAkB;IAClB,WAAW,CAAC,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IAC1D,kBAAkB;IAClB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAClD,kBAAkB;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kBAAkB;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB;IAClB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B,CAAC;AAiBF,QAAA,MAAM,WAAW;cArCL,KAAK,CAAC,SAAS;WAClB,WAAW;WACX,WAAW;YACV,iBAAiB;mBACV,iBAAiB;oBAChB,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI;IAClD,kBAAkB;WACX,iBAAiB,GAAG,uBAAuB;IAClD,kBAAkB;kBACJ,iBAAiB,GAAG,uBAAuB;IACzD,kBAAkB;mBACH,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI;IACjD,kBAAkB;WACX,OAAO;IACd,kBAAkB;kBACJ,OAAO;IACrB,kBAAkB;mBACH,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI;iBACzB,OAAO;kBACN,UAAU;qCAgSxB,CAAC;AAIH,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"SidebarRoot.d.ts","sourceRoot":"","sources":["../../../../src/layout/sidebar/SidebarRoot.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EACL,KAAK,uBAAuB,EAG5B,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,GAAG;IACzF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACnD,kBAAkB;IAClB,IAAI,CAAC,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IACnD,kBAAkB;IAClB,WAAW,CAAC,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IAC1D,kBAAkB;IAClB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAClD,kBAAkB;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kBAAkB;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB;IAClB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B,CAAC;AAiBF,QAAA,MAAM,WAAW;cArCL,KAAK,CAAC,SAAS;WAClB,WAAW;WACX,WAAW;YACV,iBAAiB;mBACV,iBAAiB;oBAChB,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI;IAClD,kBAAkB;WACX,iBAAiB,GAAG,uBAAuB;IAClD,kBAAkB;kBACJ,iBAAiB,GAAG,uBAAuB;IACzD,kBAAkB;mBACH,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI;IACjD,kBAAkB;WACX,OAAO;IACd,kBAAkB;kBACJ,OAAO;IACrB,kBAAkB;mBACH,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI;iBACzB,OAAO;kBACN,UAAU;qCAwQxB,CAAC;AAIH,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/layout/sidebar/examples/01-app-shell-nav.d.ts

@@ -1,5 +1,6 @@
 /**
  * Primary app layout: `AppShell.Template` nav slot holds `Sidebar` with `sidebarSlot="page-nav"`.
+ * `NavPanel` включает встроенную кнопку на грани (`data-placement="edge"`); режим — через `Sidebar.Root`.
  */
 export default function SidebarExampleAppShellNav(): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=01-app-shell-nav.d.ts.map

package/dist/layout/sidebar/examples/01-app-shell-nav.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"01-app-shell-nav.d.ts","sourceRoot":"","sources":["../../../../../src/layout/sidebar/examples/01-app-shell-nav.tsx"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,4CAsEhD"}
+{"version":3,"file":"01-app-shell-nav.d.ts","sourceRoot":"","sources":["../../../../../src/layout/sidebar/examples/01-app-shell-nav.tsx"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,4CAgFhD"}

package/dist/layout/sidebar/examples/02-collapsible-desktop.d.ts

@@ -1,6 +1,6 @@
 /**
- * Desktop collapse: `ToggleButton` cycles expanded → compact → expanded (not the mobile overlay).
- * With `responsive={false}`, narrow viewports keep the inline rail instead of the drawer pattern.
+ * Desktop collapse: встроенная кнопка на грани переключает expanded ↔ compact (не оверлей мобильного режима).
+ * С `responsive={false}` узкое окно сохраняет инлайн-рейл.
  */
 export default function SidebarExampleCollapsibleDesktop(): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=02-collapsible-desktop.d.ts.map

package/dist/layout/sidebar/examples/02-collapsible-desktop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"02-collapsible-desktop.d.ts","sourceRoot":"","sources":["../../../../../src/layout/sidebar/examples/02-collapsible-desktop.tsx"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,gCAAgC,4CAsDvD"}
+{"version":3,"file":"02-collapsible-desktop.d.ts","sourceRoot":"","sources":["../../../../../src/layout/sidebar/examples/02-collapsible-desktop.tsx"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,gCAAgC,4CAgEvD"}

package/dist/layout/sidebar/examples/03-controlled-state.d.ts

@@ -1,5 +1,5 @@
 /**
- * Controlled rail: parent owns `state` / `onStateChange` (here limited to expanded vs hidden for clarity).
+ * Контролируемый режим: родитель задаёт `state` / `onStateChange`; кнопка на грани панели вызывает то же переключение через контекст.
  */
 export default function SidebarExampleControlledState(): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=03-controlled-state.d.ts.map

package/dist/layout/sidebar/examples/03-controlled-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"03-controlled-state.d.ts","sourceRoot":"","sources":["../../../../../src/layout/sidebar/examples/03-controlled-state.tsx"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,6BAA6B,4CA8DpD"}
+{"version":3,"file":"03-controlled-state.d.ts","sourceRoot":"","sources":["../../../../../src/layout/sidebar/examples/03-controlled-state.tsx"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,6BAA6B,4CAwEpD"}

package/dist/layout/sidebar/examples/04-router-navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"04-router-navigation.d.ts","sourceRoot":"","sources":["../../../../../src/layout/sidebar/examples/04-router-navigation.tsx"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,8BAA8B,4CA2DrD"}
+{"version":3,"file":"04-router-navigation.d.ts","sourceRoot":"","sources":["../../../../../src/layout/sidebar/examples/04-router-navigation.tsx"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,8BAA8B,4CAqErD"}

package/dist/layout/sidebar/examples/05-responsive-behavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"05-responsive-behavior.d.ts","sourceRoot":"","sources":["../../../../../src/layout/sidebar/examples/05-responsive-behavior.tsx"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,gCAAgC,4CAmCvD"}
+{"version":3,"file":"05-responsive-behavior.d.ts","sourceRoot":"","sources":["../../../../../src/layout/sidebar/examples/05-responsive-behavior.tsx"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,gCAAgC,4CA6CvD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prime-ui-kit",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "React 19 UI kit: CSS Modules, semantic design tokens (--prime-sys-*), composable components — forms, modals, selects, tables, navigation, overlays. TypeScript, ESM, a11y-oriented.",
   "main": "./dist/index.js",
   "module": "./dist/index.js",

package/src/components/accordion/COMPONENT.md

@@ -28,8 +28,14 @@ A compound disclosure pattern: each item has a header trigger and expandable bod
 
 ### Canonical example
 
+Single open section at a time, **`layout="grouped"`** (one frame), **`Accordion.Icon as={LucideIcon}`** plus **`Accordion.Arrow`** on each trigger, and rich body copy with a **`LinkButton`**. For **`size`** steps, **`type="multiple"`** / **`layout="separate"`**, disabled and **`collapsible={false}`**, controlled **`value`**, **`Accordion.Arrow`** with **`openIcon` / `closeIcon`**, **`Accordion.Icon as="span"`**, and full-bleed width in preview, see the runnable **`./examples/*.tsx`** files and the playground snippets listed below (full source in those files—avoid duplicating long demos here).
+
+**Imports:** in this repo use the **`@/…`** paths shown; published apps import the same components from **`prime-ui-kit`**.
+
 ```tsx
-import { Accordion, LinkButton, Typography } from "prime-ui-kit";
+import { Accordion } from "@/components/accordion/Accordion";
+import { LinkButton } from "@/components/link-button/LinkButton";
+import { Typography } from "@/components/typography/Typography";
 import { Package, ShieldCheck, Truck } from "lucide-react";
 
 export function Example() {
@@ -88,15 +94,32 @@ export function Example() {
 }
 ```
 
-### Extended examples
+### Examples (source)
+
+| File | Intent |
+|------|--------|
+| [`./examples/01-faq-marketing.tsx`](./examples/01-faq-marketing.tsx) | FAQ: `type="single"`, `layout="grouped"`, **`Accordion.Icon as={Icon}`** + default chevron (**aligns with** `playground/snippets/accordion/composition.tsx`). |
+| [`./examples/02-settings-panels.tsx`](./examples/02-settings-panels.tsx) | Settings: **`type="multiple"`**, **`layout="separate"`**, **`defaultValue`** as string array (**aligns with** `playground/snippets/accordion/variants-layout-type.tsx`). |
+| [`./examples/03-checkout-order-summary.tsx`](./examples/03-checkout-order-summary.tsx) | Checkout: **`Accordion.Arrow openIcon` / `closeIcon`** (plus default chevron on another item) and links in the body (**aligns with** `playground/snippets/accordion/features-arrow.tsx`). |
+| [`./examples/04-api-docs-sections.tsx`](./examples/04-api-docs-sections.tsx) | Controlled **`value`** + **`onValueChange`** with `type="single"` (**aligns with** `playground/snippets/accordion/controlled.tsx`). |
+| [`./examples/05-knowledge-base-categories.tsx`](./examples/05-knowledge-base-categories.tsx) | **`collapsible={false}`**, **`Accordion.Item disabled`**, **`defaultValue`** (**aligns with** `playground/snippets/accordion/states.tsx`). |
+
+### Playground snippets
+
+Demos wired from [`playground/sections/AccordionSection.tsx`](../../../playground/sections/AccordionSection.tsx) (Russian copy; same public API as this doc):
 
-- [`./examples/01-faq-marketing.tsx`](./examples/01-faq-marketing.tsx) — Marketing FAQ: single panel, grouped layout, icons and chevron on each trigger.
-- [`./examples/02-settings-panels.tsx`](./examples/02-settings-panels.tsx) — Account settings: `type="multiple"` and `layout="separate"` so several sections stay open as cards.
-- [`./examples/03-checkout-order-summary.tsx`](./examples/03-checkout-order-summary.tsx) — Checkout: custom `Accordion.Arrow` icons plus policy links in the panel body.
-- [`./examples/04-api-docs-sections.tsx`](./examples/04-api-docs-sections.tsx) — API docs: controlled `value` / `onValueChange` for syncing open section with routing or in-page navigation.
-- [`./examples/05-knowledge-base-categories.tsx`](./examples/05-knowledge-base-categories.tsx) — Support hub: `collapsible={false}` and a disabled item for plan-gated content.
+| Snippet | Intent |
+|---------|--------|
+| [`playground/snippets/accordion/sizes.tsx`](../../../playground/snippets/accordion/sizes.tsx) | **`size`**: `s` / `m` / `l` / `xl` ladder. |
+| [`playground/snippets/accordion/variants-layout-type.tsx`](../../../playground/snippets/accordion/variants-layout-type.tsx) | **`layout`** `grouped` vs `separate`; **`type="multiple"`** with array **`defaultValue`**. |
+| [`playground/snippets/accordion/states.tsx`](../../../playground/snippets/accordion/states.tsx) | **`disabled`**, initial **`defaultValue`**, **`collapsible={false}`** in `single`. |
+| [`playground/snippets/accordion/controlled.tsx`](../../../playground/snippets/accordion/controlled.tsx) | External buttons + **`value` / `onValueChange`**. |
+| [`playground/snippets/accordion/composition.tsx`](../../../playground/snippets/accordion/composition.tsx) | Trigger row: **`Accordion.Icon as={Icon}`**, label in **`span`**, **`Accordion.Arrow`**. |
+| [`playground/snippets/accordion/full-width.tsx`](../../../playground/snippets/accordion/full-width.tsx) | Root fills preview column (**`examplePreviewBleed`** in playground). |
+| [`playground/snippets/accordion/icon-as.tsx`](../../../playground/snippets/accordion/icon-as.tsx) | **`Accordion.Icon as="span"`** with arbitrary child markup (e.g. Lucide as child). |
+| [`playground/snippets/accordion/features-arrow.tsx`](../../../playground/snippets/accordion/features-arrow.tsx) | **`openIcon` / `closeIcon`** vs default rotating chevron. |
 
-**LLM note:** Prefer reading the runnable files under `./examples/*.tsx` for full scenarios, prop combinations, and composition patterns; this page keeps the contract (rules + API tables) authoritative.
+**LLM note:** Prefer reading **`./examples/*.tsx`** and the **`playground/snippets/accordion/*.tsx`** files for full markup and prop combinations; this page keeps the contract (rules + API tables) authoritative.
 
 ## Rules
 

package/src/components/accordion/examples/01-faq-marketing.tsx

@@ -1,5 +1,6 @@
 import { CreditCard, Package, Truck } from "lucide-react";
-import { Accordion, Typography } from "prime-ui-kit";
+import { Accordion } from "@/components/accordion/Accordion";
+import { Typography } from "@/components/typography/Typography";
 
 import styles from "./examples.module.css";
 

package/src/components/accordion/examples/02-settings-panels.tsx

@@ -1,5 +1,6 @@
 import { Bell, Lock, User } from "lucide-react";
-import { Accordion, Typography } from "prime-ui-kit";
+import { Accordion } from "@/components/accordion/Accordion";
+import { Typography } from "@/components/typography/Typography";
 
 import styles from "./examples.module.css";
 

package/src/components/accordion/examples/03-checkout-order-summary.tsx

@@ -1,5 +1,7 @@
 import { Minus, Plus } from "lucide-react";
-import { Accordion, LinkButton, Typography } from "prime-ui-kit";
+import { Accordion } from "@/components/accordion/Accordion";
+import { LinkButton } from "@/components/link-button/LinkButton";
+import { Typography } from "@/components/typography/Typography";
 
 import styles from "./examples.module.css";
 

package/src/components/accordion/examples/04-api-docs-sections.tsx

@@ -1,6 +1,7 @@
 import { BookOpen, Code2, Webhook } from "lucide-react";
-import { Accordion, Typography } from "prime-ui-kit";
 import * as React from "react";
+import { Accordion } from "@/components/accordion/Accordion";
+import { Typography } from "@/components/typography/Typography";
 
 import styles from "./examples.module.css";
 
@@ -17,7 +18,9 @@ export default function AccordionExampleApiDocsSections() {
       size="m"
       layout="grouped"
       value={open}
-      onValueChange={(value) => setOpen(typeof value === "string" ? value : (value[0] ?? ""))}
+      onValueChange={(next) => {
+        if (typeof next === "string") setOpen(next);
+      }}
     >
       <Accordion.Item value="auth">
         <Accordion.Header>

package/src/components/accordion/examples/05-knowledge-base-categories.tsx

@@ -1,5 +1,6 @@
 import { FileQuestion, LifeBuoy, ShieldCheck } from "lucide-react";
-import { Accordion, Typography } from "prime-ui-kit";
+import { Accordion } from "@/components/accordion/Accordion";
+import { Typography } from "@/components/typography/Typography";
 
 import styles from "./examples.module.css";
 

package/src/components/avatar/COMPONENT.md

@@ -24,6 +24,8 @@ Circular avatar with an optional photo (`Avatar.Image`), a fallback layer (`Avat
 
 Один фрагмент разметки: одиночный аватар (**`Image`** + **`Fallback`**), группа с **`Overflow`**, плюс **`Fallback`** с иконкой и подписи через **[Typography](../typography/COMPONENT.md)**. Импорт только из **`prime-ui-kit`**.
 
+Те же идеи, что в плейграунде (**`playground/sections/AvatarSection.tsx`** + **`playground/snippets/avatar/*.tsx`**): полная шкала **`size`** (`s`–`6xl`), три статуса картинки (**`idle`** / **`loaded`** / **`error`**), группа из трёх, смена **`src`** из состояния родителя, пара **Image + Fallback** и **Fallback** с **`Icon`**, группа с **`Avatar.Group.Overflow`**. В монорепозитории см. **`examples/sizes.tsx`**, **`states.tsx`**, **`group-three.tsx`**, **`src-from-state.tsx`** (импорты **`@/`**); **`fallback-variants.tsx`** и **`group-overflow.tsx`** закрывают композицию и переполнение.
+
 ```tsx
 import { Avatar, Icon, Typography } from "prime-ui-kit";
 
@@ -77,15 +79,21 @@ export function CanonicalAvatarDemo() {
 
 | Файл | Сценарий |
 |------|----------|
+| [`examples/sizes.tsx`](./examples/sizes.tsx) | Все значения **`size`** подряд (`s`–`6xl`), как [`playground/snippets/avatar/sizes.tsx`](../../../playground/snippets/avatar/sizes.tsx) |
+| [`examples/states.tsx`](./examples/states.tsx) | Без **`Image`** / успешная загрузка / неверный URL, как [`states.tsx`](../../../playground/snippets/avatar/states.tsx) |
+| [`examples/group-three.tsx`](./examples/group-three.tsx) | **`Avatar.Group.Root`** из трёх **`Avatar.Root`**, как [`group-three.tsx`](../../../playground/snippets/avatar/group-three.tsx) |
+| [`examples/src-from-state.tsx`](./examples/src-from-state.tsx) | Родитель меняет **`src`** (сброс загрузки по URL), как [`src-from-state.tsx`](../../../playground/snippets/avatar/src-from-state.tsx) |
+| [`examples/fallback-variants.tsx`](./examples/fallback-variants.tsx) | Фото, инициалы и иконка в **`Fallback`** (см. также [`composition.tsx`](../../../playground/snippets/avatar/composition.tsx)) |
+| [`examples/group-overflow.tsx`](./examples/group-overflow.tsx) | Два лица + **`Avatar.Group.Overflow`**, как [`group-overflow.tsx`](../../../playground/snippets/avatar/group-overflow.tsx) |
 | [`examples/team-list.tsx`](./examples/team-list.tsx) | Список команды: аватар + имя + роль |
 | [`examples/comment-thread.tsx`](./examples/comment-thread.tsx) | Ветка комментариев с аватаром у каждого сообщения |
 | [`examples/app-header-nav.tsx`](./examples/app-header-nav.tsx) | Шапка: навигация **[LinkButton](../link-button/COMPONENT.md)** и блок «аккаунт» с аватаром |
-| [`examples/group-overflow.tsx`](./examples/group-overflow.tsx) | **`Avatar.Group`** с **`Overflow`** (`+N`) |
-| [`examples/fallback-variants.tsx`](./examples/fallback-variants.tsx) | Фото, инициалы и иконка в **`Fallback`** в одном ряду |
+
+Файлы **`sizes`**, **`states`**, **`group-three`**, **`src-from-state`** используют импорты **`@/`** для сборки внутри репозитория; остальные примеры — из **`"prime-ui-kit"`** для копирования в приложение-потребитель.
 
 ### Note for LLMs
 
-При генерации экранов опирайся на публичный API выше и на **исходники** в `src/components/avatar/examples/*.tsx`: там полные импорты **`prime-ui-kit`**, типичная композиция с **[Typography](../typography/COMPONENT.md)** / **[LinkButton](../link-button/COMPONENT.md)** / **`Icon`** (экспорт пакета) и семантическая вёрстка без обхода стилей кита. Не дублируй длинные листинги в ответе — укажи путь к файлу примера.
+При генерации экранов опирайся на публичный API выше и на **исходники** в `src/components/avatar/examples/*.tsx`. Сценарии из таблицы выше **согласованы** с **`playground/snippets/avatar/*.tsx`** (размеры, состояния, группа, смена **`src`**, композиция слотов, переполнение). Для продуктовых экранов копируй примеры с **`prime-ui-kit`**; в самом ките правь зеркала с **`@/`**. Не дублируй длинные листинги в ответе — укажи путь к файлу примера или сниппета.
 
 ## Rules
 

package/src/components/avatar/examples/group-three.tsx

@@ -0,0 +1,28 @@
+import { Avatar } from "@/components/avatar/Avatar";
+
+import styles from "./examples.module.css";
+
+const sampleSrc =
+  "https://images.unsplash.com/photo-1535713875002-d1d0cf377fde?w=128&h=128&fit=crop";
+
+/**
+ * Overlapping row of three avatars, group `size` cloned to children — mirrors `playground/snippets/avatar/group-three.tsx`.
+ */
+export default function AvatarGroupThreeExample() {
+  return (
+    <div className={styles.stack}>
+      <Avatar.Group.Root size="xl">
+        <Avatar.Root>
+          <Avatar.Image src={sampleSrc} alt="" />
+          <Avatar.Fallback>A</Avatar.Fallback>
+        </Avatar.Root>
+        <Avatar.Root>
+          <Avatar.Fallback>B</Avatar.Fallback>
+        </Avatar.Root>
+        <Avatar.Root>
+          <Avatar.Fallback>C</Avatar.Fallback>
+        </Avatar.Root>
+      </Avatar.Group.Root>
+    </div>
+  );
+}

package/src/components/avatar/examples/sizes.tsx

@@ -0,0 +1,24 @@
+import { Avatar, type AvatarSize } from "@/components/avatar/Avatar";
+
+import styles from "./examples.module.css";
+
+const sampleSrc =
+  "https://images.unsplash.com/photo-1535713875002-d1d0cf377fde?w=256&h=256&fit=crop";
+
+const sizes: AvatarSize[] = ["s", "m", "l", "xl", "2xl", "3xl", "4xl", "5xl", "6xl"];
+
+/**
+ * Full `size` scale in one row — mirrors `playground/snippets/avatar/sizes.tsx`.
+ */
+export default function AvatarSizesExample() {
+  return (
+    <div className={styles.row}>
+      {sizes.map((size) => (
+        <Avatar.Root key={size} size={size}>
+          <Avatar.Image src={sampleSrc} alt="" />
+          <Avatar.Fallback>{size}</Avatar.Fallback>
+        </Avatar.Root>
+      ))}
+    </div>
+  );
+}

package/src/components/avatar/examples/src-from-state.tsx

@@ -0,0 +1,35 @@
+import * as React from "react";
+import { Avatar } from "@/components/avatar/Avatar";
+import { Button } from "@/components/button/Button";
+
+import styles from "./examples.module.css";
+
+const sources = [
+  "https://images.unsplash.com/photo-1535713875002-d1d0cf377fde?w=128&h=128&fit=crop",
+  "https://images.unsplash.com/photo-1527980965255-d3b416303d12?w=128&h=128&fit=crop",
+] as const;
+
+/**
+ * Parent-owned `src`; image remounts per URL — mirrors `playground/snippets/avatar/src-from-state.tsx`.
+ */
+export default function AvatarSrcFromStateExample() {
+  const [index, setIndex] = React.useState(0);
+  const src = sources[index];
+
+  return (
+    <div className={styles.row}>
+      <Avatar.Root size="xl">
+        <Avatar.Image src={src} alt="" />
+        <Avatar.Fallback>?</Avatar.Fallback>
+      </Avatar.Root>
+      <Button.Root
+        mode="ghost"
+        size="m"
+        type="button"
+        onClick={() => setIndex((i) => (i + 1) % sources.length)}
+      >
+        Next portrait
+      </Button.Root>
+    </div>
+  );
+}

package/src/components/avatar/examples/states.tsx

@@ -0,0 +1,26 @@
+import { Avatar } from "@/components/avatar/Avatar";
+
+import styles from "./examples.module.css";
+
+const okSrc = "https://images.unsplash.com/photo-1535713875002-d1d0cf377fde?w=128&h=128&fit=crop";
+
+/**
+ * No `Avatar.Image` (idle), successful load, bad URL (error) — mirrors `playground/snippets/avatar/states.tsx`.
+ */
+export default function AvatarStatesExample() {
+  return (
+    <div className={styles.row}>
+      <Avatar.Root size="xl">
+        <Avatar.Fallback>AB</Avatar.Fallback>
+      </Avatar.Root>
+      <Avatar.Root size="xl">
+        <Avatar.Image src={okSrc} alt="User" />
+        <Avatar.Fallback>CD</Avatar.Fallback>
+      </Avatar.Root>
+      <Avatar.Root size="xl">
+        <Avatar.Image src="https://example.com/missing-avatar.png" alt="" />
+        <Avatar.Fallback>!</Avatar.Fallback>
+      </Avatar.Root>
+    </div>
+  );
+}

package/src/components/badge/COMPONENT.md

@@ -43,7 +43,21 @@ export default function BadgeCanonicalExample() {
 | [`examples/inbox-labels.tsx`](./examples/inbox-labels.tsx) | Priority, unread, channel type, `Badge.Dot` |
 | [`examples/admin-tags.tsx`](./examples/admin-tags.tsx) | Environment, access, feature-flag labels |
 
-Playground snippets under `playground/snippets/badge/` mirror matrix demos (sizes, variants, colors, disabled, context); prefer **`examples/*.tsx`** for product-shaped English samples and **`import { … } from "prime-ui-kit"`** only.
+### Playground snippets
+
+Order matches [`playground/sections/BadgeSection.tsx`](../../../playground/sections/BadgeSection.tsx). Snippets import from `@/components/badge/Badge` in-repo; consumers use **`import { Badge } from "prime-ui-kit"`**.
+
+| File | Scenario |
+|------|----------|
+| `playground/snippets/badge/sizes.tsx` | Explicit `size` `s`–`xl` with `variant="light"` and `color="gray"`. |
+| `playground/snippets/badge/variants.tsx` | `filled`, `light`, `lighter`, `stroke` on one `color`; `variant="status"` with `status` and `label`. |
+| `playground/snippets/badge/disabled.tsx` | `disabled` on `filled`, `stroke`, and `status`. |
+| `playground/snippets/badge/dot-icon.tsx` | `Badge.Dot` before text; `Badge.Icon` with text. |
+| `playground/snippets/badge/icons.tsx` | Icon left, variants/sizes, icon-only row, icon right, `Badge.Dot` + `Badge.Icon`. |
+| `playground/snippets/badge/semantic-colors.tsx` | Every `color` on `variant="light"` and `size="m"`. |
+| `playground/snippets/badge/context-size.tsx` | No `size` on root: `ControlSizeProvider`; context `xs` maps to badge visual `s`. |
+
+Prefer **`examples/*.tsx`** for product-shaped English samples.
 
 ## Note for LLM consumers
 

package/src/components/banner/COMPONENT.md

@@ -29,7 +29,30 @@ export function Example() {
 | `Banner.Actions` | Buttons / `LinkButton` |
 | `Banner.CloseButton` | **Direct child of `Banner.Root`** (sibling of `Banner.Content`), not nested inside `Content` |
 
-**Scenario examples (English):** [`examples/billing-alert.tsx`](examples/billing-alert.tsx) · [`examples/maintenance.tsx`](examples/maintenance.tsx) · [`examples/cookie-consent-row.tsx`](examples/cookie-consent-row.tsx) · [`examples/feature-promo.tsx`](examples/feature-promo.tsx)
+### Playground snippets
+
+Order matches [`playground/sections/BannerSection.tsx`](../../../playground/sections/BannerSection.tsx). Snippets import from `@/components/banner/Banner`; consumers use **`import { … } from "prime-ui-kit"`**.
+
+| File | Scenario |
+|------|----------|
+| `playground/snippets/banner/sizes.tsx` | `size` `s`–`xl` with `variant="light"` and `status="information"`. |
+| `playground/snippets/banner/variants.tsx` | `variant` `filled`, `light`, `lighter`, `stroke` at `status="information"`. |
+| `playground/snippets/banner/statuses.tsx` | `status` `information`, `warning`, `error`, `success`, `feature` at `variant="light"`. |
+| `playground/snippets/banner/controlled.tsx` | Visibility from React state: hide removes the root; external button shows again (no root `onDismiss` required). |
+| `playground/snippets/banner/composition.tsx` | Slots: `Banner.Icon` with `as`, title, description, `Banner.Actions` (`LinkButton`, `Button`); `size="l"`, `variant="stroke"`. |
+| `playground/snippets/banner/full-width.tsx` | Root fills parent width; narrow wrapper illustrates a card column or sidebar. |
+| `playground/snippets/banner/dismiss-patterns.tsx` | `onDismiss` only (auto close) · `Banner.CloseButton` only · both without duplicate injected control. |
+
+### Scenario examples (English)
+
+| File | Scenario |
+|------|----------|
+| [`examples/billing-alert.tsx`](examples/billing-alert.tsx) | Billing failure: `error` + `filled`, `onDismiss`, actions, `role="region"`. |
+| [`examples/maintenance.tsx`](examples/maintenance.tsx) | Downtime: `warning` + `stroke`, actions, region label. |
+| [`examples/cookie-consent-row.tsx`](examples/cookie-consent-row.tsx) | Consent: `information` + `lighter`, `onDismiss`, actions. |
+| [`examples/feature-promo.tsx`](examples/feature-promo.tsx) | Promo: `feature` + `lighter`, `onDismiss`, actions. |
+| [`examples/controlled-visibility.tsx`](examples/controlled-visibility.tsx) | Controlled show/hide by conditional render (mirrors `controlled.tsx` snippet). |
+| [`examples/dismiss-close-button.tsx`](examples/dismiss-close-button.tsx) | `Banner.CloseButton` as direct root child without `onDismiss` (mirrors manual-dismiss branch of `dismiss-patterns.tsx`). |
 
 ---
 
@@ -127,6 +150,10 @@ An in-flow announcement strip: a root grid with a central content column and an
 | children | `React.ReactNode` | — | No | Button content; defaults to a cross icon when omitted. |
 | …rest | `Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "size">` | — | No | Other button props; `size` is derived from banner context. |
 
+### Playground alignment
+
+Matrix demos (`sizes`, `variants`, `statuses`, `controlled`, `composition`, `full-width`, `dismiss-patterns`) are maintained next to [`BannerSection.tsx`](../../../playground/sections/BannerSection.tsx); keep this doc table and snippet filenames in sync when the playground order or scenarios change.
+
 ### Related
 
 - [Button](../button/COMPONENT.md) — actions inside `Banner.Actions`; `Banner.CloseButton` wraps `Button.Root` (ghost neutral).

package/src/components/banner/examples/controlled-visibility.tsx

@@ -0,0 +1,42 @@
+import { Info } from "lucide-react";
+import { Banner, Button } from "prime-ui-kit";
+import { useState } from "react";
+
+/** Show and hide by mounting the root; external control restores the strip (no `open` prop). */
+export default function BannerControlledVisibilityExample() {
+  const [visible, setVisible] = useState(true);
+
+  return (
+    <>
+      {!visible ? (
+        <Button.Root size="s" type="button" variant="neutral" onClick={() => setVisible(true)}>
+          Show announcement
+        </Button.Root>
+      ) : null}
+      {visible ? (
+        <Banner.Root size="m" status="feature" variant="lighter">
+          <Banner.Content>
+            <Banner.Icon as={Info} aria-hidden />
+            <Banner.Title>Controlled visibility</Banner.Title>
+            <Banner.Description>
+              Removing the node from the tree hides the banner; use parent state to show it again.
+            </Banner.Description>
+            <Banner.Actions>
+              <Button.Root mode="ghost" size="s" type="button" variant="neutral">
+                Learn more
+              </Button.Root>
+              <Button.Root
+                size="s"
+                type="button"
+                variant="primary"
+                onClick={() => setVisible(false)}
+              >
+                Hide
+              </Button.Root>
+            </Banner.Actions>
+          </Banner.Content>
+        </Banner.Root>
+      ) : null}
+    </>
+  );
+}

package/src/components/banner/examples/dismiss-close-button.tsx

@@ -0,0 +1,26 @@
+import { CheckCircle2 } from "lucide-react";
+
+import { Banner } from "prime-ui-kit";
+
+/**
+ * Explicit `Banner.CloseButton` as a direct child of `Banner.Root` (sibling of `Banner.Content`).
+ * No `onDismiss` on the root — the kit does not inject a second close control.
+ */
+export default function BannerDismissCloseButtonExample() {
+  return (
+    <Banner.Root status="success" variant="lighter">
+      <Banner.Content>
+        <Banner.Icon as={CheckCircle2} aria-hidden />
+        <Banner.Title>Changes saved</Banner.Title>
+        <Banner.Description>Your profile was updated successfully.</Banner.Description>
+      </Banner.Content>
+      <Banner.CloseButton
+        aria-label="Dismiss confirmation"
+        type="button"
+        onClick={() => {
+          /* product: hide banner */
+        }}
+      />
+    </Banner.Root>
+  );
+}

package/src/components/breadcrumb/COMPONENT.md

@@ -46,12 +46,24 @@ export function Example() {
 | Scenario | File |
 |----------|------|
 | Minimal trail | [`examples/canonical.tsx`](./examples/canonical.tsx) |
+| Four `size` rows (`s`–`xl` on `Root`) | [`examples/sizes.tsx`](./examples/sizes.tsx) |
+| Links + `current`; middle segment without `href` | [`examples/states.tsx`](./examples/states.tsx) |
+| Icon-only first `Item` (`aria-label`) + custom `Separator` | [`examples/composition.tsx`](./examples/composition.tsx) |
+| Narrow container; trail wraps (`flex-wrap`) | [`examples/full-width.tsx`](./examples/full-width.tsx) |
+| Long path + `Ellipsis` | [`examples/long-path-ellipsis.tsx`](./examples/long-path-ellipsis.tsx) |
 | Deep docs path | [`examples/deep-documentation.tsx`](./examples/deep-documentation.tsx) |
 | E‑commerce PDP | [`examples/ecommerce-product.tsx`](./examples/ecommerce-product.tsx) |
 | SaaS settings hierarchy | [`examples/saas-settings.tsx`](./examples/saas-settings.tsx) |
-| Long path + ellipsis | [`examples/long-path-ellipsis.tsx`](./examples/long-path-ellipsis.tsx) |
 
-Playground demos (app alias `@/…`): `playground/snippets/breadcrumb/` — sizes, states, composition (icon home + custom separator), narrow container, long ellipsis.
+**Playground snippets** (app alias `@/…`, same scenarios as the rows above where noted)
+
+| File | Coverage |
+|------|----------|
+| [`playground/snippets/breadcrumb/sizes.tsx`](../../../playground/snippets/breadcrumb/sizes.tsx) | `size` `s`–`xl` |
+| [`playground/snippets/breadcrumb/states.tsx`](../../../playground/snippets/breadcrumb/states.tsx) | Links + `current`; `Item` without `href` |
+| [`playground/snippets/breadcrumb/composition.tsx`](../../../playground/snippets/breadcrumb/composition.tsx) | Home icon + `/` separators |
+| [`playground/snippets/breadcrumb/full-width.tsx`](../../../playground/snippets/breadcrumb/full-width.tsx) | Narrow box; long labels wrap |
+| [`playground/snippets/breadcrumb/long-ellipsis.tsx`](../../../playground/snippets/breadcrumb/long-ellipsis.tsx) | Same trail shape as `long-path-ellipsis.tsx` (Russian copy in playground) |
 
 ---
 
@@ -124,4 +136,4 @@ Playground demos (app alias `@/…`): `playground/snippets/breadcrumb/` — size
 - Mark the active route with **`current`** and **no `href`** on that **`Item`**; otherwise **`aria-current="page"`** will not apply.
 - Collapsing the path is **manual**: insert **`Breadcrumb.Ellipsis`** between **`Separator`** nodes; it is **not** a menu and does not expose hidden links to assistive tech.
 - Icon-only links require **`aria-label`** on **`Item`**.
-- For copy-paste recipes, prefer the five files under **`src/components/breadcrumb/examples/`**; for interactive kit demos see **`playground/snippets/breadcrumb/`**.
+- For copy-paste recipes, prefer the files under **`src/components/breadcrumb/examples/`** (including **`sizes`**, **`states`**, **`composition`**, **`full-width`** aligned with playground); for interactive kit demos see **`playground/snippets/breadcrumb/`**.

package/src/components/breadcrumb/examples/composition.tsx

@@ -0,0 +1,25 @@
+import { Breadcrumb, Icon } from "prime-ui-kit";
+
+/** Icon-only first item (`aria-label`) and custom `Separator` children. Matches playground `snippets/breadcrumb/composition.tsx`. */
+export default function BreadcrumbCompositionExample() {
+  return (
+    <Breadcrumb.Root>
+      <Breadcrumb.Item href="/help" aria-label="Help home">
+        <span
+          style={{
+            display: "inline-flex",
+            alignItems: "center",
+            justifyContent: "center",
+            lineHeight: 0,
+          }}
+        >
+          <Icon name="nav.home" tone="default" />
+        </span>
+      </Breadcrumb.Item>
+      <Breadcrumb.Separator>/</Breadcrumb.Separator>
+      <Breadcrumb.Item href="/help/billing">Billing</Breadcrumb.Item>
+      <Breadcrumb.Separator>/</Breadcrumb.Separator>
+      <Breadcrumb.Item current>Refunds</Breadcrumb.Item>
+    </Breadcrumb.Root>
+  );
+}