prime-ui-kit 0.16.0 → 0.17.0

package/src/components/page-toolbar/examples/without-search.tsx

@@ -1,60 +0,0 @@
-/** A dashboard panel without search on a tablet-width column: the sections fill the top row, the period selector alone in the bottom row stretches to the full width — `PageToolbar.Sections`, `PageToolbar.View`. */
-import { Icon, PageToolbar, SegmentedControl, Select } from "prime-ui-kit";
-import * as React from "react";
-
-import styles from "./examples.module.css";
-
-const SECTIONS = [
-  { value: "overview", label: "Обзор" },
-  { value: "activity", label: "Активность" },
-  { value: "resources", label: "Ресурсы" },
-];
-
-const PERIODS = [
-  { value: "1h", label: "1 час" },
-  { value: "24h", label: "24 часа" },
-  { value: "7d", label: "7 дней" },
-];
-
-export default function PageToolbarWithoutSearchExample() {
-  const [section, setSection] = React.useState("overview");
-  const [period, setPeriod] = React.useState("24h");
-
-  return (
-    <div className={styles.tablet}>
-      <PageToolbar.Root aria-label="Панель мониторинга">
-        <PageToolbar.Sections>
-          <SegmentedControl.Root
-            fullWidth
-            value={section}
-            onValueChange={setSection}
-            aria-label="Раздел"
-          >
-            {SECTIONS.map((item) => (
-              <SegmentedControl.Item key={item.value} value={item.value}>
-                {item.label}
-              </SegmentedControl.Item>
-            ))}
-          </SegmentedControl.Root>
-        </PageToolbar.Sections>
-        <PageToolbar.View>
-          <Select.Root value={period} onValueChange={setPeriod}>
-            <Select.Trigger aria-label="Период">
-              <Select.TriggerIcon>
-                <Icon name="field.calendar" />
-              </Select.TriggerIcon>
-              <Select.Value />
-            </Select.Trigger>
-            <Select.Content>
-              {PERIODS.map((item) => (
-                <Select.Item key={item.value} value={item.value}>
-                  {item.label}
-                </Select.Item>
-              ))}
-            </Select.Content>
-          </Select.Root>
-        </PageToolbar.View>
-      </PageToolbar.Root>
-    </div>
-  );
-}

package/src/layout/app-header/COMPONENT.md

@@ -1,187 +0,0 @@
-# AppHeader
-
-**Category:** page
-**Kind:** layout
-
-> The page's bar at the top of the app's content panel: the page title with a line of data, the page's tools and its own buttons — only what the current page needs.
-
-## When to use
-- Every page of an app built on [AppShell](../app-shell/COMPONENT.md): the page titles itself here — `AppHeader.Title` (the page's `<h1>`) with an `AppHeader.Description` that carries data, the path up (`Breadcrumb`) on a nested record.
-- The page's tools — its own search and filter, sections, the view, the primary action — as a [PageToolbar](../../components/page-toolbar/COMPONENT.md) in `AppHeader.Tools`.
-- The phone header: in an `AppShell` whose Sidebar is off-canvas the header leads with the menu button that opens it by itself; the title and the page's action as an icon follow.
-- A page that owns its header: render `AppHeader.Root` at the top of the page — inside the shell it renders in the shell's header row and replaces `AppShell.Template`'s `header` while the page is on screen.
-
-## When not to use
-- A document page (settings, a long form, an article) → its title is `PageContent.Header` in main ([PageContent](../../components/page-content/COMPONENT.md)); the header then has no title.
-- App navigation → [Sidebar](../sidebar/COMPONENT.md) and, on a phone, [BottomNav](../bottom-nav/COMPONENT.md); the header holds at most the menu button.
-- Anything that is not about the current page (a global search, app-wide buttons) → the header row is per page; the app's own places live in the Sidebar.
-
-## Import
-```tsx
-import { AppHeader } from "prime-ui-kit";
-```
-
-## Anatomy
-```
-AppHeader.Root               <header>, the page's sticky bar; in an AppShell it renders in the shell's header row
-├─ AppHeader.Start           leading zone, takes the free width
-│  ├─ (menu button)          drawn while the shell's Sidebar is off-canvas; AppHeader.MenuButton places it elsewhere
-│  ├─ Breadcrumb             the path up, only on a nested record
-│  ├─ AppHeader.Separator    short vertical line between the path and the title
-│  └─ AppHeader.Title        the page title, truncates
-│     ├─ AppHeader.Icon      decorative glyph on a tile shaped like a soft button m
-│     └─ AppHeader.Description  a muted line of data under the name
-├─ AppHeader.Actions         the page's own buttons at the end of the title row
-└─ AppHeader.Tools           second row, full width: the page's tools (a PageToolbar.Root)
-```
-The name of `AppHeader.Title` (not the icon or the description) is the page's `<h1>`.
-
-## API
-
-<!-- Generated from api.ts by `bun run docs:build`. Edit api.ts, not this section. -->
-
-### AppHeader.Root
-`ref` → `HTMLElement`. The page's sticky `<header>`: its title, tools and own buttons. In an `AppShell` it renders in the shell's header row and, while the Sidebar is off-canvas, leads with the menu button. Icon buttons inside are `soft`.
-
-| Prop | Type | Default | Description |
-|---|---|---|---|
-| `labels` | `Partial<AppHeaderLabels>` | — | Built-in strings, see Labels. |
-| `…rest` | `HTMLAttributes<HTMLElement>` | — | `children` (`AppHeader.Start`, `AppHeader.Actions`, `AppHeader.Tools`), `className` and the other attributes. |
-
-### AppHeader.Start
-`ref` → `HTMLDivElement`. The leading zone that takes the free width: the menu button, the path up (a Breadcrumb) and the title.
-
-| Prop | Type | Default | Description |
-|---|---|---|---|
-| `…rest` | `HTMLAttributes<HTMLDivElement>` | — | `children`, `className` and the other div attributes. |
-
-### AppHeader.Title
-`ref` → `HTMLDivElement`. The page title: an optional `AppHeader.Icon`, the name (title-s, truncates) and an optional `AppHeader.Description` under it. The name is the page heading `<h1>`; the description stays outside its accessible name.
-
-| Prop | Type | Default | Description |
-|---|---|---|---|
-| `…rest` | `HTMLAttributes<HTMLDivElement>` | — | `children` (the name, `AppHeader.Icon`, `AppHeader.Description` in any order), `className` and the other div attributes. |
-
-### AppHeader.Icon
-`ref` → `HTMLSpanElement`. Decorative glyph before the title (`aria-hidden`) on a tile shaped like the bar's soft buttons: control m square (36), its radius and the subtle fill.
-
-| Prop | Type | Default | Description |
-|---|---|---|---|
-| `…rest` | `HTMLAttributes<HTMLSpanElement>` | — | `children` (an `Icon`), `className` and the other span attributes. |
-
-### AppHeader.Description
-`ref` → `HTMLSpanElement`. Muted line under the title that carries data («128 в работе · 6 ждут оплаты», a status and a date); truncates on a narrow header, never hides.
-
-| Prop | Type | Default | Description |
-|---|---|---|---|
-| `…rest` | `HTMLAttributes<HTMLSpanElement>` | — | `children`, `className` and the other span attributes. |
-
-### AppHeader.Separator
-`ref` → `HTMLDivElement`. The `inset` vertical `Divider` between groups in a zone — the path and the title: one text line tall, the tier gap on each side.
-
-| Prop | Type | Default | Description |
-|---|---|---|---|
-| `…rest` | `Omit<DividerProps, "orientation" \| "children" \| "align" \| "size" \| "inset">` | — | `className` and the other div attributes. |
-
-### AppHeader.Tools
-`ref` → `HTMLDivElement`. The page's tools in the header (a `PageToolbar.Root`): the header's second row, full width under the title row, wherever it is written in `AppHeader.Root` — directly, in a fragment or inside a component of the page.
-
-| Prop | Type | Default | Description |
-|---|---|---|---|
-| `…rest` | `HTMLAttributes<HTMLDivElement>` | — | `children` (a `PageToolbar.Root`), `className` and the other div attributes. |
-
-### AppHeader.Actions
-`ref` → `HTMLDivElement`. The trailing row of the page's own buttons in the title row (export, a more menu); the page's primary action goes into the PageToolbar in `AppHeader.Tools` when the page has tools. Never wraps.
-
-| Prop | Type | Default | Description |
-|---|---|---|---|
-| `…rest` | `HTMLAttributes<HTMLDivElement>` | — | `children`, `className` and the other div attributes. |
-
-### AppHeader.MenuButton
-`ref` → `HTMLButtonElement`. The menu button the header draws by itself, placed elsewhere: a soft icon `Button` named by `labels.menu` that opens the shell's off-canvas Sidebar. Nothing while the Sidebar is a rail, or outside a shell.
-
-| Prop | Type | Default | Description |
-|---|---|---|---|
-| `…rest` | `Omit<ButtonHTMLAttributes<HTMLButtonElement>, "type" \| "children" \| "aria-expanded" \| "aria-controls">` | — | `onClick` (runs first; `preventDefault()` stops the toggle), `aria-label` (replaces `labels.menu`), `className` and the other button attributes. |
-
-## Variants
-
-### Structure
-| Value | Looks like | Use when | Default |
-|---|---|---|---|
-| `AppHeader.Title` | Icon, name and a line of data under it, like the Sidebar brand | A top-level page | |
-| Breadcrumb in Start | The path, `AppHeader.Separator` and the record as the title | A nested record page | |
-| with `AppHeader.Actions` | A row of the page's buttons at the end of the title row | Export, a more menu of the page | |
-| with `AppHeader.Tools` | A second row under the title row with the page's PageToolbar | The page has search, filters, sections, a view or a primary action | |
-| no `AppHeader.Title` | Only the menu button and the page's buttons | A document page: its title is `PageContent.Header` in main | |
-| with `AppHeader.MenuButton` | The menu button at the place of the part instead of the start | The button belongs elsewhere in the bar (after a back button, in Actions) | |
-
-## States
-| State | Driven by | DOM |
-|---|---|---|
-| in an app shell | `AppHeader.Root` anywhere inside `AppShell.Root` (a page's own one in main) | renders in the shell's header row at the top of the panel; the latest one on screen wins over `AppShell.Template`'s `header` |
-| with the menu button | the shell's Sidebar is off-canvas (`offCanvas="auto"` on a phone, `"always"`) | a soft icon Button leads `AppHeader.Start` (or the row) with `aria-expanded` and `aria-controls` from the shell; gone while the Sidebar is a rail on screen and outside a shell |
-| with page tools | an `AppHeader.Tools` anywhere in Root (directly, in a fragment, inside a component of the page) | rendered after the title row (DOM and Tab order follow the rows), full width, `--prime-space-3` under it |
-| narrow header | header width below 36rem (container `prime-app-header`) | the icon tile hides; the title and its line of data truncate |
-| short viewport | viewport below 480px high (a phone on its side) | Root stops sticking |
-
-## Layout & spacing
-- Row min height = control m + `--prime-space-2` (44), padding-block `--prime-space-3` (the top grows to the safe-area inset): 68 in all, the height of the Sidebar header, so the brand and the title share one line.
-- Inline padding: the page gutter `--prime-layout-gutter` (16 → 24 → 32, the same as `AppShell.Main`), so in the shell's header row the header lines up with the page; in a frame inside the page (a preview) the small gutter. Main's top air ([AppShell](../app-shell/COMPONENT.md)) stands between the header and the page's first block.
-- Icon buttons are `soft` neutral (the menu button is), never `ghost`: every button on the bar has a shape.
-- Gaps: `--prime-space-3` between zones, `--prime-space-2` inside Start and Actions; `AppHeader.Separator` is the `inset` vertical Divider: the tier gap on each side (8 at `m`) and one text line tall (20 at `m`).
-- `AppHeader.Icon` is a 36 tile with the radius and fill of a soft neutral button m, so it lines up with the buttons on the bar.
-- On the panel surface with no divider or shadow (depth from fill); `z-index: --prime-z-sticky`.
-- Sticky at `top: 0` of its scroller (static on a viewport below 480px high). The shared sticky surface paints its fill one border width past the top edge, so no sub-pixel seam of the scrolling rows shows above it.
-- Controls inside are size `m`.
-- `AppHeader.Tools` is the header's second row: the full width under the title row, 12 apart, sticky with it. The PageToolbar inside lays itself out from that width — one row from 56rem, stacked rows below, the primary action on its own row when the search would get less than 18rem beside it — so on a phone the page tools wrap under the title, never squeeze it.
-
-## Accessibility
-
-### Keyboard
-<!-- Generated from api.ts by `bun run docs:build`. Edit api.ts, not this section. -->
-
-| Key | Action |
-|---|---|
-| `Tab` | Moves through the menu button, the path links and the page's buttons in reading order, then the page tools in the second row. |
-| `Enter` · `Space` | Presses the focused button: opens the menu or runs the action. |
-
-### ARIA
-<!-- Generated from api.ts by `bun run docs:build`. Edit api.ts, not this section. -->
-
-- Root is a `<header>`: the banner landmark when it sits at the top level of the page.
-- The menu button is named by `labels.menu`; `aria-expanded` (whether the Sidebar panel is open) and `aria-controls` (its `<nav>`) come from the shell.
-- The name of `AppHeader.Title` is the page heading `<h1>`; the description sits next to it, outside its accessible name. One `<h1>` per page: in the header on app pages, `PageContent.Title` on a document page (whose header has no title).
-- `AppHeader.Tools` follows the title row in the DOM, so Tab and screen readers meet the page tools after the header's own buttons.
-
-### Labels
-<!-- Generated from api.ts by `bun run docs:build`. Edit api.ts, not this section. -->
-
-| Key | Default | Used for |
-|---|---|---|
-| `menu` | `"Открыть меню"` | Name of the menu button (drawn by the header or `AppHeader.MenuButton`). |
-
-## Examples
-| Example | Shows |
-|---|---|
-| [overview.tsx](examples/overview.tsx) | The page's header: the page title with its icon and a line of data under it, the page's own buttons at the end — `AppHeader.Title`, `AppHeader.Description`, `AppHeader.Actions`. |
-| [breadcrumbs.tsx](examples/breadcrumbs.tsx) | A nested record: the path up, a separator and the record as the page title, the record's buttons at the end — `AppHeader.Separator`, `AppHeader.Actions`. |
-| [page-title.tsx](examples/page-title.tsx) | The header carries the page: the title is the page heading with a line of data, the page tools (sections, the period, the primary action) are its second row and lay themselves out from its width — `AppHeader.Title`, `AppHeader.Tools`. |
-| [in-app-shell.tsx](examples/in-app-shell.tsx) | The header in the app frame: one row with the Sidebar brand across the two planes, sticky over main — `AppShell`, `Sidebar.Brand`. |
-| [narrow.tsx](examples/narrow.tsx) | On a phone the header leads with the menu button that opens the navigation by itself, the title and its line of data truncate and the page's action keeps its icon — `AppShell`, `offCanvas`. |
-
-## Mistakes
-- A border or shadow under the header → it sits on the panel surface; the fill is the boundary.
-- `AppHeader.Title` while main also has `PageContent.Title` → two titles; an app page titles itself in the header, only a document page keeps `PageContent.Header` (and then the header has no title).
-- No title at all on an app page → the page has no `<h1>`.
-- A description that describes the page («Все заказы магазина») → a line of data («128 в работе · 6 ждут оплаты») or nothing.
-- Page tools crammed into `AppHeader.Actions` → `AppHeader.Tools` with a PageToolbar: it wraps under the title instead of squeezing it.
-- A global search, notifications or app-wide buttons in the header → the row is per page; the app's own places live in the Sidebar.
-- A heading element of your own inside `AppHeader.Title` → the title's name is already the `<h1>`; a second heading nests inside it.
-- A hand-made menu button with a media query or hand-wired `aria-expanded` → the header draws the menu button itself from the shell's Sidebar; `AppHeader.MenuButton` only moves it.
-- A page header that misses the phone menu → render the page's `AppHeader.Root` inside the `AppShell` (not in a frame of its own): it then joins the shell's header row and gets the menu button.
-- `ghost` icon buttons in the header → `variant="soft" tone="neutral"`: a light fill gives each button a shape on the bar.
-
-## Related
-- **Built from:** [Button](../../components/button/COMPONENT.md), [Divider](../../components/divider/COMPONENT.md), Icon (`nav.menu`), [AppShell](../app-shell/COMPONENT.md) (its header row and navigation)
-- **See also:** [AppShell](../app-shell/COMPONENT.md), [Sidebar](../sidebar/COMPONENT.md), [PageContent](../../components/page-content/COMPONENT.md), [PageToolbar](../../components/page-toolbar/COMPONENT.md) (inside `AppHeader.Tools`), [Breadcrumb](../../components/breadcrumb/COMPONENT.md)

package/src/layout/app-header/examples/breadcrumbs.tsx

@@ -1,37 +0,0 @@
-/** A nested record: the path up, a separator and the record as the page title, the record's buttons at the end — `AppHeader.Separator`, `AppHeader.Actions`. */
-import { AppHeader, Breadcrumb, Button, Icon } from "prime-ui-kit";
-
-import styles from "./examples.module.css";
-
-export default function AppHeaderBreadcrumbsExample() {
-  return (
-    <div className={styles.window}>
-      <AppHeader.Root>
-        <AppHeader.Start>
-          <Breadcrumb.Root>
-            <Breadcrumb.Item href="#crm">CRM</Breadcrumb.Item>
-            <Breadcrumb.Item href="#clients">Клиенты</Breadcrumb.Item>
-          </Breadcrumb.Root>
-          <AppHeader.Separator />
-          <AppHeader.Title>
-            ООО «Север»
-            <AppHeader.Description>Клиент с 2021 года · 4 сделки</AppHeader.Description>
-          </AppHeader.Title>
-        </AppHeader.Start>
-        <AppHeader.Actions>
-          <Button.Root variant="soft" tone="neutral">
-            <Button.Icon>
-              <Icon name="action.send" />
-            </Button.Icon>
-            Написать
-          </Button.Root>
-          <Button.Root variant="soft" tone="neutral" aria-label="Ещё действия">
-            <Button.Icon>
-              <Icon name="action.more" />
-            </Button.Icon>
-          </Button.Root>
-        </AppHeader.Actions>
-      </AppHeader.Root>
-    </div>
-  );
-}

package/src/layout/app-header/examples/examples.module.css

@@ -1,28 +0,0 @@
-/* Layout of the AppHeader scenarios: app windows and a phone-wide screen. The preview stage is the page; a window only sizes and clips. Semantic tokens only. */
-
-/* The top of an app window: the page with the header on it. */
-.window {
-  box-sizing: border-box;
-  width: 100%;
-  overflow: hidden;
-}
-
-/* narrow.tsx: an app window, phone-wide, so the title and its line of data truncate. */
-.phone {
-  width: min(100%, var(--prime-layout-narrow-width));
-  margin-inline: auto;
-}
-
-/* in-app-shell.tsx: a whole app window with the rail on the page. */
-.stage {
-  box-sizing: border-box;
-  display: flex;
-  width: 100%;
-  height: calc(var(--prime-space-24) * 4);
-  overflow: hidden;
-}
-
-/* The shell fills the window frame instead of the viewport. */
-.shell {
-  height: 100%;
-}

package/src/layout/app-header/examples/in-app-shell.tsx

@@ -1,67 +0,0 @@
-/** The header in the app frame: one row with the Sidebar brand across the two planes, sticky over main — `AppShell`, `Sidebar.Brand`. */
-import { AppHeader, AppShell, Icon, PageContent, Sidebar, Typography } from "prime-ui-kit";
-
-import styles from "./examples.module.css";
-
-const ORDERS = [
-  "№ 4821 · ООО «Север» · 84 000 ₽",
-  "№ 4820 · ИП Котов · 12 500 ₽",
-  "№ 4819 · ООО «Вектор» · 230 000 ₽",
-  "№ 4818 · АО «Меридиан» · 47 900 ₽",
-  "№ 4817 · ООО «Полюс» · 9 800 ₽",
-  "№ 4816 · ИП Белова · 156 000 ₽",
-];
-
-export default function AppHeaderInAppShellExample() {
-  return (
-    <div className={styles.stage}>
-      <AppShell.Root fillViewport className={styles.shell}>
-        <AppShell.Nav>
-          <Sidebar.Root offCanvas="never">
-            <Sidebar.Header>
-              <Sidebar.Brand href="#home" description="Отдел продаж">
-                <Sidebar.BrandLogo>
-                  <Icon name="nav.layoutGrid" />
-                </Sidebar.BrandLogo>
-                Acme CRM
-              </Sidebar.Brand>
-            </Sidebar.Header>
-            <Sidebar.Content>
-              <Sidebar.Item>
-                <Sidebar.ItemIcon>
-                  <Icon name="nav.home" />
-                </Sidebar.ItemIcon>
-                Обзор
-              </Sidebar.Item>
-              <Sidebar.Item current>
-                <Sidebar.ItemIcon>
-                  <Icon name="object.package" />
-                </Sidebar.ItemIcon>
-                Заказы
-              </Sidebar.Item>
-            </Sidebar.Content>
-          </Sidebar.Root>
-        </AppShell.Nav>
-        <AppHeader.Root>
-          <AppHeader.Start>
-            <AppHeader.Title>
-              Заказы
-              <AppHeader.Description>128 в работе</AppHeader.Description>
-            </AppHeader.Title>
-          </AppHeader.Start>
-        </AppHeader.Root>
-        <AppShell.Main>
-          <PageContent.Root as="section">
-            <PageContent.Body>
-              {ORDERS.map((order) => (
-                <Typography key={order} variant="body-m">
-                  {order}
-                </Typography>
-              ))}
-            </PageContent.Body>
-          </PageContent.Root>
-        </AppShell.Main>
-      </AppShell.Root>
-    </div>
-  );
-}

package/src/layout/app-header/examples/narrow.tsx

@@ -1,66 +0,0 @@
-/** On a phone the header leads with the menu button that opens the navigation by itself, the title and its line of data truncate and the page's action keeps its icon — `AppShell`, `offCanvas`. */
-import { AppHeader, AppShell, Button, Icon, PageContent, Sidebar, Typography } from "prime-ui-kit";
-
-import styles from "./examples.module.css";
-
-const ORDERS = [
-  "№ 4821 · ООО «Север» · 84 000 ₽",
-  "№ 4820 · ИП Котов · 12 500 ₽",
-  "№ 4819 · ООО «Вектор» · 230 000 ₽",
-];
-
-export default function AppHeaderNarrowExample() {
-  return (
-    <div className={`${styles.stage} ${styles.phone}`}>
-      <AppShell.Root fillViewport className={styles.shell}>
-        <AppShell.Nav>
-          {/* `always`: this window is phone-wide on any screen; in an app keep the default `auto`. */}
-          <Sidebar.Root offCanvas="always">
-            <Sidebar.Content>
-              <Sidebar.Item href="#overview">
-                <Sidebar.ItemIcon>
-                  <Icon name="nav.home" />
-                </Sidebar.ItemIcon>
-                Обзор
-              </Sidebar.Item>
-              <Sidebar.Item href="#orders" current>
-                <Sidebar.ItemIcon>
-                  <Icon name="object.package" />
-                </Sidebar.ItemIcon>
-                Заказы
-              </Sidebar.Item>
-            </Sidebar.Content>
-          </Sidebar.Root>
-        </AppShell.Nav>
-        <AppHeader.Root>
-          <AppHeader.Start>
-            <AppHeader.Title>
-              Заказы покупателей
-              <AppHeader.Description>
-                128 в работе · 6 ждут оплаты · 2 возврата
-              </AppHeader.Description>
-            </AppHeader.Title>
-          </AppHeader.Start>
-          <AppHeader.Actions>
-            <Button.Root aria-label="Новый заказ">
-              <Button.Icon>
-                <Icon name="action.add" />
-              </Button.Icon>
-            </Button.Root>
-          </AppHeader.Actions>
-        </AppHeader.Root>
-        <AppShell.Main>
-          <PageContent.Root as="section">
-            <PageContent.Body>
-              {ORDERS.map((order) => (
-                <Typography key={order} variant="body-m">
-                  {order}
-                </Typography>
-              ))}
-            </PageContent.Body>
-          </PageContent.Root>
-        </AppShell.Main>
-      </AppShell.Root>
-    </div>
-  );
-}

package/src/layout/app-header/examples/overview.tsx

@@ -1,34 +0,0 @@
-/** The page's header: the page title with its icon and a line of data under it, the page's own buttons at the end — `AppHeader.Title`, `AppHeader.Description`, `AppHeader.Actions`. */
-import { AppHeader, Button, Icon } from "prime-ui-kit";
-
-import styles from "./examples.module.css";
-
-export default function AppHeaderOverviewExample() {
-  return (
-    <div className={styles.window}>
-      <AppHeader.Root>
-        <AppHeader.Start>
-          <AppHeader.Title>
-            <AppHeader.Icon>
-              <Icon name="object.package" />
-            </AppHeader.Icon>
-            Заказы
-            <AppHeader.Description>128 в работе · 6 ждут оплаты</AppHeader.Description>
-          </AppHeader.Title>
-        </AppHeader.Start>
-        <AppHeader.Actions>
-          <Button.Root variant="soft" tone="neutral" aria-label="Экспорт в CSV">
-            <Button.Icon>
-              <Icon name="action.download" />
-            </Button.Icon>
-          </Button.Root>
-          <Button.Root variant="soft" tone="neutral" aria-label="Ещё действия">
-            <Button.Icon>
-              <Icon name="action.more" />
-            </Button.Icon>
-          </Button.Root>
-        </AppHeader.Actions>
-      </AppHeader.Root>
-    </div>
-  );
-}

package/src/layout/app-header/examples/page-title.tsx

@@ -1,78 +0,0 @@
-/** The header carries the page: the title is the page heading with a line of data, the page tools (sections, the period, the primary action) are its second row and lay themselves out from its width — `AppHeader.Title`, `AppHeader.Tools`. */
-import { AppHeader, Button, Icon, PageToolbar, SegmentedControl, Select } from "prime-ui-kit";
-import * as React from "react";
-
-import styles from "./examples.module.css";
-
-const SECTIONS = [
-  { value: "all", label: "Все" },
-  { value: "mine", label: "Мои" },
-  { value: "overdue", label: "Просроченные" },
-];
-
-const PERIODS = [
-  { value: "month", label: "Октябрь" },
-  { value: "quarter", label: "IV квартал" },
-  { value: "year", label: "2026 год" },
-];
-
-export default function AppHeaderPageTitleExample() {
-  const [section, setSection] = React.useState("all");
-  const [period, setPeriod] = React.useState("month");
-
-  return (
-    <div className={styles.window}>
-      <AppHeader.Root>
-        <AppHeader.Start>
-          <AppHeader.Title>
-            Сделки
-            <AppHeader.Description>24 сделки в работе · 8,2 млн ₽</AppHeader.Description>
-          </AppHeader.Title>
-        </AppHeader.Start>
-        <AppHeader.Tools>
-          <PageToolbar.Root aria-label="Сделки">
-            <PageToolbar.Sections>
-              <SegmentedControl.Root
-                fullWidth
-                value={section}
-                onValueChange={setSection}
-                aria-label="Раздел"
-              >
-                {SECTIONS.map((item) => (
-                  <SegmentedControl.Item key={item.value} value={item.value}>
-                    {item.label}
-                  </SegmentedControl.Item>
-                ))}
-              </SegmentedControl.Root>
-            </PageToolbar.Sections>
-            <PageToolbar.View>
-              <Select.Root value={period} onValueChange={setPeriod}>
-                <Select.Trigger aria-label="Период">
-                  <Select.TriggerIcon>
-                    <Icon name="field.calendar" />
-                  </Select.TriggerIcon>
-                  <Select.Value />
-                </Select.Trigger>
-                <Select.Content>
-                  {PERIODS.map((item) => (
-                    <Select.Item key={item.value} value={item.value}>
-                      {item.label}
-                    </Select.Item>
-                  ))}
-                </Select.Content>
-              </Select.Root>
-            </PageToolbar.View>
-            <PageToolbar.Actions>
-              <Button.Root>
-                <Button.Icon>
-                  <Icon name="action.add" />
-                </Button.Icon>
-                Новая сделка
-              </Button.Root>
-            </PageToolbar.Actions>
-          </PageToolbar.Root>
-        </AppHeader.Tools>
-      </AppHeader.Root>
-    </div>
-  );
-}

package/src/layout/app-shell/examples/contained.tsx

@@ -1,30 +0,0 @@
-/** A shell without navigation whose main column is centred and capped for long reads — `contentWidth`. */
-import { AppShell, PageContent, Typography } from "prime-ui-kit";
-
-import styles from "./examples.module.css";
-
-export default function AppShellContainedExample() {
-  return (
-    <div className={styles.stage}>
-      <AppShell.Root fillViewport className={styles.shell}>
-        <AppShell.Main contentWidth="contained">
-          <PageContent.Root maxWidth="readable">
-            <PageContent.Header>
-              {/* In a real app this is PageContent.Title (the page h1). */}
-              <Typography as="h2" variant="heading-m">
-                Как подключить оплату
-              </Typography>
-              <PageContent.Description>Обновлено 1 октября 2026 года.</PageContent.Description>
-            </PageContent.Header>
-            <PageContent.Body>
-              <Typography as="p" variant="body-l">
-                Откройте раздел «Настройки», выберите «Оплата» и укажите реквизиты. После проверки
-                банк пришлёт подтверждение, и приём платежей включится автоматически.
-              </Typography>
-            </PageContent.Body>
-          </PageContent.Root>
-        </AppShell.Main>
-      </AppShell.Root>
-    </div>
-  );
-}

package/dist/chunks/{chunk-U3Q2I3MY.js → chunk-2ODXLPW3.js}

@@ -1747,9 +1747,8 @@ export {
   useOptionalControlSize,
   useControlSize,
   useHostTier,
-  cx,
-  fieldTier_default,
   TOKEN_DEFAULTS,
+  cx,
   motionToken,
   readCssDurationMs,
   readElementDurationMs,
@@ -1763,6 +1762,7 @@ export {
   HOVER_QUERY,
   prefersReducedMotion,
   usePresence,
+  fieldTier_default,
   iconBox_default,
   iconBoxClass,
   iconSlotClass,