prime-ui-kit 0.13.1 → 0.15.0

package/src/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/src/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/src/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/src/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>

package/src/components/file-upload/examples/examples.module.css

@@ -28,7 +28,7 @@
   flex: 1;
 }
 
-/* in-form.tsx: header → field 32 → actions 32 (foundation §1). */
+/* in-form.tsx: field → actions 32 (foundation §1). */
 .form {
   display: flex;
   flex-direction: column;
@@ -36,12 +36,6 @@
   width: min(100%, var(--prime-modal-width-s));
 }
 
-.formHeader {
-  display: flex;
-  flex-direction: column;
-  gap: var(--prime-space-1);
-}
-
 .formActions {
   display: flex;
   justify-content: flex-end;

package/src/components/file-upload/examples/file-cards.tsx

@@ -1,4 +1,4 @@
-/** 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`. */
+/** 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`. */
 import { FileUpload, type FileUploadFile, type UploadContext, useUploadQueue } from "prime-ui-kit";
 
 import styles from "./examples.module.css";
@@ -27,6 +27,14 @@ const MATERIALS: readonly FileUploadFile[] = [
   { id: "insp-stock", name: "Остатки на 12 марта.xlsx", size: 96_000 },
 ];
 
+/** Sizes as the inspection report gives them: megabytes with two decimals. */
+const MEGABYTES = new Intl.NumberFormat("ru-RU", {
+  minimumFractionDigits: 2,
+  maximumFractionDigits: 2,
+});
+
+const formatMegabytes = (bytes: number) => `${MEGABYTES.format(bytes / 1024 / 1024)} МБ`;
+
 /** A stand-in for the server: sends a file in a few steps and answers with its address. */
 function sendFile(file: File, { signal, onProgress }: UploadContext): Promise<string> {
   return new Promise((resolve, reject) => {
@@ -58,6 +66,7 @@ export default function FileUploadFileCardsExample() {
         multiple
         defaultValue={MATERIALS}
         queue={queue}
+        formatSize={formatMegabytes}
       />
     </div>
   );

package/src/components/file-upload/examples/gallery.tsx

@@ -1,4 +1,4 @@
-/** 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`. */
+/** 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`. */
 import { FileUpload, type FileUploadFile, type UploadContext, useUploadQueue } from "prime-ui-kit";
 import * as React from "react";
 
@@ -94,7 +94,7 @@ export default function FileUploadGalleryExample() {
         cover
         accept="image/*"
         multiple
-        max={12}
+        max={6}
         value={photos}
         onValueChange={setPhotos}
         queue={queue}

package/src/components/file-upload/examples/in-form.tsx

@@ -4,7 +4,9 @@ import * as React from "react";
 
 import styles from "./examples.module.css";
 
-const HINT = "PDF до 20 МБ, все страницы";
+const HINT = "Все страницы, с подписями обеих сторон";
+/** The zone names the formats the check takes. */
+const ZONE_LABELS = { description: "PDF до 20 МБ" };
 const MAX_SIZE = 20 * 1024 * 1024;
 
 /** A picked file as a file of the set. */
@@ -44,20 +46,13 @@ export default function FileUploadInFormExample() {
 
   return (
     <form className={styles.form} noValidate onSubmit={submit} onReset={() => change([])}>
-      <div className={styles.formHeader}>
-        <Typography as="h3" variant="title-m">
-          Договор поставки
-        </Typography>
-        <Typography as="p" variant="body-s" tone="secondary">
-          Подписанный скан нужен до первой отгрузки.
-        </Typography>
-      </div>
       <FileUpload.Root
         label="Скан договора"
         name="contract"
         accept=".pdf"
         required
         hint={HINT}
+        labels={ZONE_LABELS}
         error={error}
         value={scan}
         onValueChange={change}

package/src/components/file-upload/examples/overview.tsx

@@ -5,6 +5,9 @@ import styles from "./examples.module.css";
 
 const MAX_SIZE = 10 * 1024 * 1024;
 
+/** The zone names the limit the stand-in server holds. */
+const ZONE_LABELS = { description: "Любые файлы до 10 МБ" };
+
 const ATTACHED: readonly FileUploadFile[] = [
   {
     id: "deal-contract",
@@ -50,7 +53,8 @@ export default function FileUploadOverviewExample() {
     <div className={styles.column}>
       <FileUpload.Root
         label="Документы сделки"
-        hint="Любые файлы до 10 МБ, можно несколько"
+        hint="Договор, смета и акты по сделке; можно несколько сразу"
+        labels={ZONE_LABELS}
         multiple
         defaultValue={ATTACHED}
         queue={queue}

package/src/components/file-upload/examples/row-parts.tsx

@@ -1,4 +1,4 @@
-/** 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`. */
+/** 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`. */
 import { Button, FileUpload, Icon } from "prime-ui-kit";
 
 import styles from "./examples.module.css";
@@ -36,6 +36,29 @@ export default function FileUploadRowPartsExample() {
         <FileUpload.ItemDescription>Формируется · 60%</FileUpload.ItemDescription>
         <FileUpload.ItemProgress value={60} aria-label="Формируется: Отчёт по заказу.xlsx" />
       </FileUpload.Item>
+      <FileUpload.Item invalid>
+        <FileUpload.FormatBadge format="pdf" color="red" />
+        <FileUpload.ItemName>Акт сверки за март.pdf</FileUpload.ItemName>
+        <FileUpload.ItemDescription>
+          Не удалось сформировать: нет данных за 31 марта
+        </FileUpload.ItemDescription>
+        <FileUpload.ItemActions>
+          <Button.Root
+            variant="ghost"
+            tone="neutral"
+            aria-label="Сформировать заново: Акт сверки за март.pdf"
+          >
+            <Button.Icon>
+              <Icon name="action.refresh" />
+            </Button.Icon>
+          </Button.Root>
+        </FileUpload.ItemActions>
+        <FileUpload.ItemProgress
+          value={35}
+          tone="danger"
+          aria-label="Остановлено: Акт сверки за март.pdf"
+        />
+      </FileUpload.Item>
     </div>
   );
 }

package/src/components/file-upload/examples/screen.module.css

@@ -0,0 +1,45 @@
+/* Media library: a work screen — the app header carries the title and the tools; this module lays
+   out the library block only, the page rhythm comes from PageContent. */
+
+.bar {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--prime-space-2);
+}
+
+/* As many ~8rem tiles as fit: two across from 320px, more as the panel grows. */
+.grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(min(100%, calc(var(--prime-space-16) * 2)), 1fr));
+  gap: var(--prime-space-5) var(--prime-space-4);
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+/* A tile: the picture, then the name over the size and date. */
+.tile {
+  display: grid;
+  align-content: start;
+  gap: var(--prime-space-2);
+  min-width: 0;
+}
+
+.tileText {
+  display: grid;
+  min-width: 0;
+}
+
+/* The skeleton tile keeps the picture's 4 : 3 and the two text lines, so nothing moves on load. */
+.picture {
+  height: auto;
+  aspect-ratio: 4 / 3;
+}
+
+.nameBar {
+  width: 75%;
+}
+
+.metaBar {
+  width: 45%;
+}