prime-ui-kit 0.13.1 → 0.15.0

package/dist/skill/reference/components/field-list/examples/narrow.tsx

@@ -0,0 +1,68 @@
+/** The invoice lines in a 320 px column: the headings give way, each row stacks its fields with their own labels and rows stand a group apart — `columns`. */
+import { FieldList, type FieldListColumn, Input } from "prime-ui-kit";
+import * as React from "react";
+
+import styles from "./examples.module.css";
+
+type Line = { id: string; service: string; quantity: string; price: string };
+
+const COLUMNS: FieldListColumn[] = [
+  { label: "Услуга" },
+  { label: "Кол-во", width: "s" },
+  { label: "Цена", width: "m" },
+];
+
+const LINES: Line[] = [
+  { id: "setup", service: "Внедрение CRM", quantity: "1", price: "180 000" },
+  { id: "training", service: "Обучение менеджеров", quantity: "3", price: "15 000" },
+];
+
+export default function FieldListNarrowExample() {
+  const [lines, setLines] = React.useState(LINES);
+
+  return (
+    <div className={styles.narrow}>
+      <FieldList
+        label="Позиции счёта"
+        columns={COLUMNS}
+        value={lines}
+        onValueChange={setLines}
+        getId={(line) => line.id}
+        getLabel={(line) => line.service}
+        createItem={() => ({ id: crypto.randomUUID(), service: "", quantity: "1", price: "" })}
+        addLabel="Добавить позицию"
+        renderItem={(line, row) => (
+          <>
+            <Input.Root>
+              <Input.Wrapper>
+                <Input.Field
+                  value={line.service}
+                  onChange={(event) => row.update({ service: event.target.value })}
+                />
+              </Input.Wrapper>
+            </Input.Root>
+            <Input.Root>
+              <Input.Wrapper>
+                <Input.Field
+                  value={line.quantity}
+                  inputMode="numeric"
+                  onChange={(event) => row.update({ quantity: event.target.value })}
+                />
+              </Input.Wrapper>
+            </Input.Root>
+            <Input.Root>
+              <Input.Wrapper>
+                <Input.Field
+                  value={line.price}
+                  inputMode="decimal"
+                  onChange={(event) => row.update({ price: event.target.value })}
+                />
+                <Input.InlineAffix side="end">₽</Input.InlineAffix>
+              </Input.Wrapper>
+            </Input.Root>
+          </>
+        )}
+      />
+    </div>
+  );
+}

package/dist/skill/reference/components/field-list/examples/overview.tsx

@@ -0,0 +1,66 @@
+/** Lines of an invoice: the column headings stand once above the rows, each row has a remove button and the add button sits under them — `columns`, `renderItem`, `createItem`, `addLabel`. */
+import { FieldList, type FieldListColumn, Input } from "prime-ui-kit";
+import * as React from "react";
+
+type Line = { id: string; service: string; quantity: string; price: string };
+
+const COLUMNS: FieldListColumn[] = [
+  { label: "Услуга" },
+  { label: "Кол-во", width: "s" },
+  { label: "Цена", width: "m" },
+];
+
+const LINES: Line[] = [
+  { id: "setup", service: "Внедрение CRM", quantity: "1", price: "180 000" },
+  { id: "training", service: "Обучение менеджеров", quantity: "3", price: "15 000" },
+];
+
+export default function FieldListOverviewExample() {
+  const [lines, setLines] = React.useState(LINES);
+
+  return (
+    <FieldList
+      label="Позиции счёта"
+      columns={COLUMNS}
+      value={lines}
+      onValueChange={setLines}
+      getId={(line) => line.id}
+      getLabel={(line) => line.service}
+      createItem={() => ({ id: crypto.randomUUID(), service: "", quantity: "1", price: "" })}
+      addLabel="Добавить позицию"
+      renderItem={(line, row) => (
+        <>
+          <Input.Root>
+            <Input.Wrapper>
+              <Input.Field
+                value={line.service}
+                placeholder="Поддержка, 1 месяц"
+                onChange={(event) => row.update({ service: event.target.value })}
+              />
+            </Input.Wrapper>
+          </Input.Root>
+          <Input.Root>
+            <Input.Wrapper>
+              <Input.Field
+                value={line.quantity}
+                inputMode="numeric"
+                onChange={(event) => row.update({ quantity: event.target.value })}
+              />
+            </Input.Wrapper>
+          </Input.Root>
+          <Input.Root>
+            <Input.Wrapper>
+              <Input.Field
+                value={line.price}
+                inputMode="decimal"
+                placeholder="0"
+                onChange={(event) => row.update({ price: event.target.value })}
+              />
+              <Input.InlineAffix side="end">₽</Input.InlineAffix>
+            </Input.Wrapper>
+          </Input.Root>
+        </>
+      )}
+    />
+  );
+}

package/dist/skill/reference/components/field-list/examples/reorder.tsx

@@ -0,0 +1,42 @@
+/** Selling points of a plan in the order of the pricing page: a one-column list has no headings and no numbers, a point moves by its handle or Alt+arrows — `reorderable`, `getLabel`. */
+import { FieldList, type FieldListColumn, Input } from "prime-ui-kit";
+import * as React from "react";
+
+type Point = { id: string; text: string };
+
+const COLUMNS: FieldListColumn[] = [{ label: "Преимущество" }];
+
+const POINTS: Point[] = [
+  { id: "users", text: "До 50 сотрудников в одном пространстве" },
+  { id: "storage", text: "200 ГБ для документов и вложений" },
+  { id: "support", text: "Поддержка в рабочие часы, ответ за 2 часа" },
+  { id: "api", text: "Доступ к API и вебхукам" },
+];
+
+export default function FieldListReorderExample() {
+  const [points, setPoints] = React.useState(POINTS);
+
+  return (
+    <FieldList
+      label="Преимущества тарифа"
+      columns={COLUMNS}
+      reorderable
+      value={points}
+      onValueChange={setPoints}
+      getId={(point) => point.id}
+      getLabel={(point) => point.text}
+      createItem={() => ({ id: crypto.randomUUID(), text: "" })}
+      addLabel="Добавить преимущество"
+      renderItem={(point, row) => (
+        <Input.Root>
+          <Input.Wrapper>
+            <Input.Field
+              value={point.text}
+              onChange={(event) => row.update({ text: event.target.value })}
+            />
+          </Input.Wrapper>
+        </Input.Root>
+      )}
+    />
+  );
+}

package/dist/skill/reference/components/field-list/examples/screen.module.css

@@ -0,0 +1,18 @@
+/* Record editor: the sections are PageContent.Section layout="aside"; here only the panels' insides. */
+
+/* Two groups in one panel, a group apart. */
+.groups {
+  display: grid;
+  gap: var(--prime-space-8);
+}
+
+/* One value in three currencies: one row while there is room, the unit inside each field. */
+.currencies {
+  display: grid;
+  grid-template-columns: repeat(
+      auto-fit,
+      minmax(min(100%, calc(var(--prime-space-24) + var(--prime-space-8))), 1fr)
+    );
+  align-items: start;
+  gap: var(--prime-space-3);
+}

package/dist/skill/reference/components/field-list/examples/screen.tsx

@@ -0,0 +1,316 @@
+/** A record editor as a document page, a long form whose title, description and save stand in the content header: a plan's name, its specs and prices in one form; repeating records as FieldList rows with the headings once, a base price pinned above its changes, one value in three currencies in one row — `getLocked`, `compact`. */
+import {
+  Button,
+  Card,
+  ColorPresets,
+  FieldList,
+  type FieldListColumn,
+  Fieldset,
+  Icon,
+  type IconName,
+  Input,
+  PageContent,
+  Select,
+  Textarea,
+} from "prime-ui-kit";
+import * as React from "react";
+
+import styles from "./screen.module.css";
+
+type Spec = {
+  id: string;
+  icon: IconName;
+  name: string;
+  value: string;
+  color: string;
+  pinned?: boolean;
+};
+type Period = { id: string; from: string; price: string; base?: boolean };
+
+const SPEC_COLUMNS: FieldListColumn[] = [
+  { label: "Иконка", width: "compact" },
+  { label: "Параметр" },
+  { label: "Значение" },
+  { label: "Цвет", width: "compact" },
+];
+
+const SPEC_ICONS: { name: IconName; label: string }[] = [
+  { name: "object.users", label: "Сотрудники" },
+  { name: "object.storage", label: "Хранилище" },
+  { name: "object.headset", label: "Поддержка" },
+  { name: "object.chart", label: "Отчёты" },
+  { name: "object.key", label: "Доступ" },
+  { name: "object.globe", label: "Интеграции" },
+];
+
+const SPECS: Spec[] = [
+  {
+    id: "seats",
+    icon: "object.users",
+    name: "Сотрудники",
+    value: "до 50",
+    color: "#5068f5",
+    pinned: true,
+  },
+  {
+    id: "storage",
+    icon: "object.storage",
+    name: "Хранилище",
+    value: "200 ГБ",
+    color: "#22c55e",
+    pinned: true,
+  },
+  {
+    id: "support",
+    icon: "object.headset",
+    name: "Поддержка",
+    value: "8/5, ответ за 2 часа",
+    color: "#f97316",
+    pinned: true,
+  },
+  { id: "reports", icon: "object.chart", name: "Отчёты", value: "12 шаблонов", color: "#a855f7" },
+  { id: "sso", icon: "object.key", name: "Вход через SSO", value: "SAML, OIDC", color: "#14b8a6" },
+];
+
+const PRICE_COLUMNS: FieldListColumn[] = [{ label: "Действует" }, { label: "Цена", width: "m" }];
+
+const MONTHS = [
+  { value: "01", label: "С 1 января" },
+  { value: "04", label: "С 1 апреля" },
+  { value: "07", label: "С 1 июля" },
+  { value: "10", label: "С 1 октября" },
+];
+
+const PERIODS: Period[] = [
+  { id: "base", from: "", price: "4 900", base: true },
+  { id: "autumn", from: "10", price: "5 400" },
+];
+
+const SETUP_FEE = [
+  { currency: "₽", name: "setupRub", label: "Подключение в рублях", value: "15 000" },
+  { currency: "$", name: "setupUsd", label: "Подключение в долларах", value: "170" },
+  { currency: "€", name: "setupEur", label: "Подключение в евро", value: "" },
+];
+
+const SAVE_MS = 900;
+const SAVED_MS = 2000;
+
+export default function FieldListScreenExample() {
+  const formId = React.useId();
+  const [specs, setSpecs] = React.useState(SPECS);
+  const [periods, setPeriods] = React.useState(PERIODS);
+  const [nameError, setNameError] = React.useState<string>();
+  const [saving, setSaving] = React.useState(false);
+  const [saved, setSaved] = React.useState(false);
+
+  const save = (event: React.FormEvent<HTMLFormElement>) => {
+    event.preventDefault();
+    const name = String(new FormData(event.currentTarget).get("name") ?? "").trim();
+    if (name === "") {
+      setNameError("Назовите тариф: так его увидят клиенты");
+      event.currentTarget.querySelector<HTMLInputElement>("[name='name']")?.focus();
+      return;
+    }
+    setNameError(undefined);
+    setSaving(true);
+    window.setTimeout(() => {
+      setSaving(false);
+      setSaved(true);
+      window.setTimeout(() => setSaved(false), SAVED_MS);
+    }, SAVE_MS);
+  };
+
+  return (
+    <PageContent.Root maxWidth="wide" aria-labelledby="plan-title">
+      <PageContent.Header>
+        <PageContent.Title id="plan-title">Тариф «Команда»</PageContent.Title>
+        <PageContent.Description>
+          Так тариф выглядит на странице цен и в счетах.
+        </PageContent.Description>
+        <PageContent.Actions>
+          <Button.Root type="submit" form={formId} loading={saving}>
+            {saved ? "Сохранено" : "Сохранить тариф"}
+          </Button.Root>
+        </PageContent.Actions>
+      </PageContent.Header>
+      <PageContent.Body>
+        <PageContent.Section layout="aside" label="Основное">
+          <form id={formId} noValidate onSubmit={save}>
+            <Card.Root variant="panel">
+              <Card.Body>
+                <Fieldset disabled={saving} aria-label="Основное">
+                  <Input.Root label="Название" error={nameError}>
+                    <Input.Wrapper>
+                      <Input.Field name="name" defaultValue="Команда" />
+                    </Input.Wrapper>
+                  </Input.Root>
+                  <Textarea.Root
+                    name="summary"
+                    label="Описание"
+                    optional
+                    rows={2}
+                    defaultValue="Для отделов до 50 человек: задачи, документы и отчёты в одном месте."
+                  />
+                </Fieldset>
+              </Card.Body>
+            </Card.Root>
+          </form>
+        </PageContent.Section>
+
+        <PageContent.Section layout="aside" label="Характеристики">
+          <Card.Root variant="panel">
+            <Card.Body>
+              <FieldList
+                aria-label="Характеристики"
+                disabled={saving}
+                columns={SPEC_COLUMNS}
+                reorderable
+                value={specs}
+                onValueChange={setSpecs}
+                getId={(spec) => spec.id}
+                getLabel={(spec) => spec.name}
+                getLocked={(spec) => spec.pinned ?? false}
+                createItem={(): Spec => ({
+                  id: crypto.randomUUID(),
+                  icon: "object.globe",
+                  name: "",
+                  value: "",
+                  color: "#14b8a6",
+                })}
+                addLabel="Добавить характеристику"
+                renderItem={(spec, row) => (
+                  <>
+                    <Select.Root
+                      value={spec.icon}
+                      onValueChange={(icon) => row.update({ icon: icon as IconName })}
+                    >
+                      <Select.Trigger>
+                        <Select.TriggerIcon>
+                          <Icon name={spec.icon} />
+                        </Select.TriggerIcon>
+                      </Select.Trigger>
+                      <Select.Content>
+                        {SPEC_ICONS.map((icon) => (
+                          <Select.Item key={icon.name} value={icon.name}>
+                            <Select.ItemIcon>
+                              <Icon name={icon.name} />
+                            </Select.ItemIcon>
+                            {icon.label}
+                          </Select.Item>
+                        ))}
+                      </Select.Content>
+                    </Select.Root>
+                    <Input.Root>
+                      <Input.Wrapper>
+                        <Input.Field
+                          value={spec.name}
+                          onChange={(event) => row.update({ name: event.target.value })}
+                        />
+                      </Input.Wrapper>
+                    </Input.Root>
+                    <Input.Root>
+                      <Input.Wrapper>
+                        <Input.Field
+                          value={spec.value}
+                          onChange={(event) => row.update({ value: event.target.value })}
+                        />
+                      </Input.Wrapper>
+                    </Input.Root>
+                    <ColorPresets.Root
+                      value={spec.color}
+                      onValueChange={(color) => row.update({ color: color ?? spec.color })}
+                    >
+                      <ColorPresets.Trigger>
+                        <ColorPresets.SwatchButton />
+                      </ColorPresets.Trigger>
+                      <ColorPresets.Content />
+                    </ColorPresets.Root>
+                  </>
+                )}
+              />
+            </Card.Body>
+          </Card.Root>
+        </PageContent.Section>
+
+        <PageContent.Section layout="aside" label="Стоимость">
+          <Card.Root variant="panel">
+            <Card.Body className={styles.groups}>
+              <Fieldset label="За месяц" disabled={saving}>
+                <FieldList
+                  columns={PRICE_COLUMNS}
+                  value={periods}
+                  onValueChange={setPeriods}
+                  getId={(period) => period.id}
+                  getLocked={(period) => period.base ?? false}
+                  createItem={() => ({ id: crypto.randomUUID(), from: "", price: "" })}
+                  addLabel="Добавить изменение цены"
+                  renderItem={(period, row) => (
+                    <>
+                      {period.base ? (
+                        <Input.Root>
+                          <Input.Wrapper>
+                            <Input.Field value="Всегда, если нет изменений" readOnly />
+                          </Input.Wrapper>
+                        </Input.Root>
+                      ) : (
+                        <Select.Root
+                          value={period.from}
+                          onValueChange={(from) => row.update({ from })}
+                          placeholder="Выберите месяц"
+                        >
+                          <Select.Trigger>
+                            <Select.Value />
+                          </Select.Trigger>
+                          <Select.Content>
+                            {MONTHS.map((month) => (
+                              <Select.Item key={month.value} value={month.value}>
+                                {month.label}
+                              </Select.Item>
+                            ))}
+                          </Select.Content>
+                        </Select.Root>
+                      )}
+                      <Input.Root>
+                        <Input.Wrapper>
+                          <Input.Field
+                            value={period.price}
+                            inputMode="decimal"
+                            placeholder="0"
+                            onChange={(event) => row.update({ price: event.target.value })}
+                          />
+                          <Input.InlineAffix side="end">₽</Input.InlineAffix>
+                        </Input.Wrapper>
+                      </Input.Root>
+                    </>
+                  )}
+                />
+              </Fieldset>
+              <Fieldset
+                label="Подключение"
+                description="Разовый платёж; пустая валюта не выставляется."
+                disabled={saving}
+              >
+                <div className={styles.currencies}>
+                  {SETUP_FEE.map((fee) => (
+                    <Input.Root key={fee.name}>
+                      <Input.Wrapper>
+                        <Input.Field
+                          name={fee.name}
+                          aria-label={fee.label}
+                          inputMode="decimal"
+                          placeholder="0"
+                          defaultValue={fee.value}
+                        />
+                        <Input.InlineAffix side="end">{fee.currency}</Input.InlineAffix>
+                      </Input.Wrapper>
+                    </Input.Root>
+                  ))}
+                </div>
+              </Fieldset>
+            </Card.Body>
+          </Card.Root>
+        </PageContent.Section>
+      </PageContent.Body>
+    </PageContent.Root>
+  );
+}

package/dist/skill/reference/components/field-list/examples/sizes.tsx

@@ -0,0 +1,42 @@
+/** Every tier: the headings, the fields, the handle and the buttons follow the list's size — `size`. */
+import { FieldList, type FieldListColumn, Input } from "prime-ui-kit";
+
+type Contact = { id: string; name: string; phone: string };
+
+const SIZES = ["xs", "s", "m", "l", "xl"] as const;
+
+const COLUMNS: FieldListColumn[] = [{ label: "Контакт" }, { label: "Телефон", width: "m" }];
+
+const CONTACTS: Contact[] = [{ id: "buyer", name: "Анна Лебедева", phone: "+7 912 404-18-20" }];
+
+export default function FieldListSizesExample() {
+  return (
+    <>
+      {SIZES.map((size) => (
+        <FieldList
+          key={size}
+          size={size}
+          label={size}
+          columns={COLUMNS}
+          defaultValue={CONTACTS}
+          getId={(contact) => contact.id}
+          getLabel={(contact) => contact.name}
+          renderItem={(contact) => (
+            <>
+              <Input.Root>
+                <Input.Wrapper>
+                  <Input.Field defaultValue={contact.name} />
+                </Input.Wrapper>
+              </Input.Root>
+              <Input.Root>
+                <Input.Wrapper>
+                  <Input.Field type="tel" defaultValue={contact.phone} />
+                </Input.Wrapper>
+              </Input.Root>
+            </>
+          )}
+        />
+      ))}
+    </>
+  );
+}

package/dist/skill/reference/components/field-list/examples/states.tsx

@@ -0,0 +1,51 @@
+/** The same list editable and disabled while the request saves it: fields, handles and buttons turn off together — `disabled`. */
+import { FieldList, type FieldListColumn, Input } from "prime-ui-kit";
+
+type Stage = { id: string; name: string; days: string };
+
+const COLUMNS: FieldListColumn[] = [{ label: "Этап" }, { label: "Дней", width: "s" }];
+
+const STAGES: Stage[] = [
+  { id: "brief", name: "Бриф и смета", days: "3" },
+  { id: "design", name: "Дизайн", days: "10" },
+];
+
+const STATES = [
+  { label: "Этапы проекта", disabled: false },
+  { label: "disabled", disabled: true },
+];
+
+export default function FieldListStatesExample() {
+  return (
+    <>
+      {STATES.map((state) => (
+        <FieldList
+          key={state.label}
+          label={state.label}
+          disabled={state.disabled}
+          reorderable
+          columns={COLUMNS}
+          defaultValue={STAGES}
+          getId={(stage) => stage.id}
+          getLabel={(stage) => stage.name}
+          createItem={() => ({ id: crypto.randomUUID(), name: "", days: "" })}
+          addLabel="Добавить этап"
+          renderItem={(stage) => (
+            <>
+              <Input.Root>
+                <Input.Wrapper>
+                  <Input.Field defaultValue={stage.name} />
+                </Input.Wrapper>
+              </Input.Root>
+              <Input.Root>
+                <Input.Wrapper>
+                  <Input.Field defaultValue={stage.days} inputMode="numeric" />
+                </Input.Wrapper>
+              </Input.Root>
+            </>
+          )}
+        />
+      ))}
+    </>
+  );
+}

package/dist/skill/reference/components/file-upload/COMPONENT.md

@@ -288,7 +288,7 @@ A rejection of `upload` fails the file with its message as the reason; retry que
 | disabled | `disabled` | `data-disabled="true"`, disabled input, disabled fill and text, drops ignored; no add tile, actions or drag; a disabled button with `trigger="button"` |
 | empty | no files, `trigger="tile"` | the add tile spans the row with «Нажмите или перетащите файлы» |
 | cover | `cover`, the first tile | «Обложка» in place of the format pill, `data-cover` on the tiles wrapper (the first tile takes a 2 × 2 cell in a grid) |
-| full | the set reaches `max` | `data-full` on the add tile: «Лимит файлов», faded, the file input disabled |
+| full | the set reaches `max` | `data-full` on the add tile: «Лимит файлов», faded; the file input is `aria-disabled` and opens no picker, so the field label stays undimmed |
 | queued | queue item `status: "queued"` | a row reads «size · В очереди» over an empty bar; a tile (`data-upload="queued"`) dims under a 40px disk on the `media` shade (Button `shape="circle"` `variant="shade"`) whose ring turns at its least arc, described by «В очереди» |
 | loading | `status: "loading"` | a row reads «size · Загрузка 40%» and its bar fills (`accent`); a tile's white arc grows clockwise from 12 o'clock with the share sent (the `progress` ring of a shade circle Button, one variable `--ring-value`, gliding `base` while it turns); the disk is the remove («Отменить загрузку: name», described by the state), the corner × is not drawn; the tile still reorders, its carried copy keeps the disk |
 | done | `status: "done"` | a row reads «size» over a full `success` bar; a tile's ring fills, then its disk fades and shrinks to 0.9 (`fast`, `inert`), the picture returns to full or the sheet comes back |
@@ -372,20 +372,21 @@ Also `data-size`, `data-variant` on the zone, `data-size` on Item, `data-status`
 | Example | Shows |
 |---|---|
 | [overview.tsx](examples/overview.tsx) | Documents of a deal: a drop zone, the files already attached as rows whose names open them, and new files uploading through a queue with progress, a reason and a retry — `label`, `hint`, `multiple`, `defaultValue`, `href`, `queue`. |
-| [variants.tsx](examples/variants.tsx) | How files are added: the dashed drop zone, the zone with only its fill for cards and modals, the compact picker button and the add tile after the files — `variant`, `trigger`. |
+| [variants.tsx](examples/variants.tsx) | How files are added: the dashed drop zone, the zone with only its fill for cards and modals, the compact picker button and the add tile that starts an empty set of tiles — `variant`, `trigger`. |
 | [sizes.tsx](examples/sizes.tsx) | Every tier of the zone and of its file rows: padding, icon, button, text and the format badge follow it — `size`. |
 | [states.tsx](examples/states.tsx) | A default zone, a disabled one whose files are read-only and an invalid one without a message — `disabled`, `invalid`. |
 | [validation.tsx](examples/validation.tsx) | A required scan checked as soon as it is picked: a wrong type or a large file shakes in an error that leaves when the file is removed; a hint and an optional zone — `required`, `hint`, `error`, `optional`. |
-| [gallery.tsx](examples/gallery.tsx) | An image gallery of an office listing: the first photo is the cover on two tiles and a photo dragged first takes its place, new photos upload in their tiles, and the add tile counts up to the limit — `trigger`, `layout`, `cover`, `max`, `value`, `queue`. |
-| [file-cards.tsx](examples/file-cards.tsx) | Materials of a warehouse inspection as cards: photos and documents in one grid, each with its picture or format and the name with the size; new files upload in their cards and the order is set by drag or Alt + arrows — `trigger`, `layout`, `defaultValue`, `queue`. |
+| [gallery.tsx](examples/gallery.tsx) | An image gallery of an office listing: the first photo is the cover on two tiles and a photo dragged first takes its place, new photos upload in their tiles, one fails and retries, and the add tile counts up to the limit and then says so — `trigger`, `layout`, `cover`, `max`, `value`, `queue`. |
+| [file-cards.tsx](examples/file-cards.tsx) | Materials of a warehouse inspection as cards: photos and documents in one grid, each with its picture or format and the name with the size in megabytes as the report gives it; new files upload in their cards and the order is set by drag or Alt + arrows — `trigger`, `layout`, `defaultValue`, `queue`, `formatSize`. |
 | [attachment-tray.tsx](examples/attachment-tray.tsx) | A reply to a client with a paperclip instead of a drop zone: the icon-only picker button, and the attachments as one scrolling row of tiles above the message — `trigger`, `aria-label`, `FileUpload.Queue`, `layout`. |
 | [saving.tsx](examples/saving.tsx) | Published listing photos with no picker, every change saved on the server: a moved or removed photo waits busy, and a change the server refuses puts the set back — `FileUpload.Queue`, `onValueChange`, `value`, `cover`. |
-| [custom-body.tsx](examples/custom-body.tsx) | A custom body: a muted title with a browse link and source buttons instead of the built-in one — `FileUpload.Body`, `FileUpload.Title`. |
+| [custom-body.tsx](examples/custom-body.tsx) | A custom body: a muted title with a browse link and the formats line and source buttons instead of the built-in one — `FileUpload.Body`, `FileUpload.Title`, `FileUpload.Description`. |
 | [avatar-upload.tsx](examples/avatar-upload.tsx) | A round zone around an Avatar that takes images and shows a preview; buttons open the same input — `inputRef`, `accept`, `className`. |
-| [row-parts.tsx](examples/row-parts.tsx) | Rows the set does not draw, built from parts: order documents with a download button, a photo with its preview and a report still being prepared — `FileUpload.Item`, `FileUpload.FormatBadge`, `FileUpload.ItemPreview`, `FileUpload.ItemActions`, `FileUpload.ItemProgress`. |
+| [row-parts.tsx](examples/row-parts.tsx) | Rows the set does not draw, built from parts: order documents with a download button, a photo with its preview, a report still being prepared and one that failed with a retry — `FileUpload.Item`, `FileUpload.FormatBadge`, `FileUpload.ItemPreview`, `FileUpload.ItemActions`, `FileUpload.ItemProgress`, `invalid`, `tone`. |
 | [controlled.tsx](examples/controlled.tsx) | Documents of a deal in one list: the files already on the server and new uploads after them, saved on every change, and a button brings back the saved set — `value`, `onValueChange`, `queue`. |
 | [in-form.tsx](examples/in-form.tsx) | A contract upload form: submit checks the required scan, its error shakes in and leaves once a file is picked or removed — `required`, `error`, `name`, `value`. |
 | [narrow.tsx](examples/narrow.tsx) | In a phone-width column the zone text wraps, a long file name truncates, and a gallery goes three across and then two, the cover keeping two columns and the remove buttons shown without hover. |
+| [screen.tsx](examples/screen.tsx) | A media library of a catalog object as a work screen: the title, the object and a PageToolbar with sections, search, order and upload in the app header; uploads in FileUpload tiles through a queue; a grid of Thumbnails that open MediaViewer out of the tile or are picked for bulk download and delete; a Skeleton first load and a filtered empty state in a Crossfade — `trigger`, `layout`. |
 
 ## Mistakes
 - A `Label` and a `Hint` placed around the zone by hand → pass `label`, `hint`, `error`.

package/dist/skill/reference/components/file-upload/examples/custom-body.tsx

@@ -1,4 +1,4 @@
-/** A custom body: a muted title with a browse link and source buttons instead of the built-in one — `FileUpload.Body`, `FileUpload.Title`. */
+/** A custom body: a muted title with a browse link and the formats line and source buttons instead of the built-in one — `FileUpload.Body`, `FileUpload.Title`, `FileUpload.Description`. */
 import { Button, FileUpload, Icon, LinkButton } from "prime-ui-kit";
 import * as React from "react";
 
@@ -23,6 +23,7 @@ export default function FileUploadCustomBodyExample() {
               </button>
             </LinkButton>
           </FileUpload.Title>
+          <FileUpload.Description>PDF, JPG или PNG до 20 МБ</FileUpload.Description>
           <div className={styles.sources}>
             <Button.Root variant="soft" tone="neutral" size="s" onClick={openPicker}>
               <Button.Icon>