includio-cms 0.25.0 → 0.26.0

package/dist/admin/remote/shop.remote.d.ts

@@ -82,39 +82,44 @@ export declare const listOrdersAdmin: import("@sveltejs/kit").RemoteQueryFunctio
     limit?: number | undefined;
     offset?: number | undefined;
 } | undefined, {
-    number: string;
-    id: string;
-    status: import("../../shop/types.js").OrderStatus;
-    createdAt: Date;
-    updatedAt: Date;
-    language: string | null;
-    carrierType: string | null;
-    currency: string;
-    customerEmail: string;
-    customerName: string | null;
-    customerPhone: string | null;
-    shippingAddress: Record<string, string> | null;
-    totalNet: number;
-    totalGross: number;
-    vatAmount: number;
-    shippingNet: number;
-    shippingGross: number;
-    shippingMethodId: string | null;
-    carrierRef: string | null;
-    shipmentId: string | null;
-    trackingNumber: string | null;
-    labelUrl: string | null;
-    shipmentCreatedAt: Date | null;
-    paymentMethod: string | null;
-    paymentProviderRef: string | null;
-    consents: {
+    items: {
+        number: string;
         id: string;
-        accepted: boolean;
-        label: string;
-    }[] | null;
-    notes: string | null;
-    accessToken: string;
-}[]>;
+        status: import("../../shop/types.js").OrderStatus;
+        createdAt: Date;
+        updatedAt: Date;
+        language: string | null;
+        carrierType: string | null;
+        currency: string;
+        customerEmail: string;
+        customerName: string | null;
+        customerPhone: string | null;
+        shippingAddress: Record<string, string> | null;
+        totalNet: number;
+        totalGross: number;
+        vatAmount: number;
+        shippingNet: number;
+        shippingGross: number;
+        shippingMethodId: string | null;
+        carrierRef: string | null;
+        shipmentId: string | null;
+        trackingNumber: string | null;
+        labelUrl: string | null;
+        shipmentCreatedAt: Date | null;
+        paymentMethod: string | null;
+        paymentProviderRef: string | null;
+        consents: {
+            id: string;
+            accepted: boolean;
+            label: string;
+        }[] | null;
+        notes: string | null;
+        accessToken: string;
+    }[];
+    total: number;
+    limit: number;
+    offset: number;
+}>;
 export declare const getOrderForAdmin: import("@sveltejs/kit").RemoteQueryFunction<string, {
     order: {
         number: string;

package/dist/admin/remote/shop.remote.js

@@ -3,7 +3,7 @@ import z from 'zod';
 import { getCMS } from '../../core/cms.js';
 import { deleteShopData, getShopDataByEntry, listShopEntries, upsertShopData } from '../../shop/server/shop-data.js';
 import { createShippingMethod, deleteShippingMethod, getShippingMethod, listShippingMethods, reorderShippingMethods, updateShippingMethod } from '../../shop/server/shipping.js';
-import { getOrderById, getOrderItems, getOrderStatusHistory, listOrders, updateOrderStatus } from '../../shop/server/orders.js';
+import { countOrders, getOrderById, getOrderItems, getOrderStatusHistory, listOrders, updateOrderStatus } from '../../shop/server/orders.js';
 import { cancelShipmentForOrder, createShipmentForOrder } from '../../shop/server/shipments.js';
 import { sendOrderStatusEmail } from '../../shop/server/email.js';
 import { getRefundedAmount, listRefunds, refundOrder, RefundError } from '../../shop/server/refund.js';
@@ -129,7 +129,14 @@ export const listOrdersAdmin = query(z
 })
     .optional(), async (opts) => {
     requireAuth();
-    return listOrders(opts ?? {});
+    const params = opts ?? {};
+    const limit = params.limit ?? 50;
+    const offset = params.offset ?? 0;
+    const [items, total] = await Promise.all([
+        listOrders({ ...params, limit, offset }),
+        countOrders({ status: params.status, email: params.email })
+    ]);
+    return { items, total, limit, offset };
 });
 export const getOrderForAdmin = query(z.string(), async (id) => {
     requireAuth();

package/dist/admin/shared/password-generate.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generate a random password that satisfies the shared password policy:
+ * at least 8 characters, with at least one uppercase letter, one digit and
+ * one special character. See {@link passwordField} in `password-schema.ts`.
+ */
+export declare function generatePassword(length?: number): string;

package/dist/admin/shared/password-generate.js

@@ -0,0 +1,40 @@
+// Confusable characters (0/O, 1/l/I) are excluded for legibility.
+const UPPER = 'ABCDEFGHJKMNPQRSTUVWXYZ';
+const LOWER = 'abcdefghijkmnpqrstuvwxyz';
+const DIGITS = '23456789';
+const SPECIAL = '!@#$%&*?-_+=';
+const ALL = UPPER + LOWER + DIGITS + SPECIAL;
+/** Unbiased random integer in [0, max) using crypto when available. */
+function randInt(max) {
+    if (typeof crypto !== 'undefined' && typeof crypto.getRandomValues === 'function') {
+        const buf = new Uint32Array(1);
+        const limit = Math.floor(0x100000000 / max) * max; // reject the biased tail
+        let x;
+        do {
+            crypto.getRandomValues(buf);
+            x = buf[0];
+        } while (x >= limit);
+        return x % max;
+    }
+    return Math.floor(Math.random() * max);
+}
+function pick(set) {
+    return set[randInt(set.length)];
+}
+/**
+ * Generate a random password that satisfies the shared password policy:
+ * at least 8 characters, with at least one uppercase letter, one digit and
+ * one special character. See {@link passwordField} in `password-schema.ts`.
+ */
+export function generatePassword(length = 16) {
+    const target = Math.max(8, Math.floor(length));
+    const chars = [pick(UPPER), pick(LOWER), pick(DIGITS), pick(SPECIAL)];
+    while (chars.length < target)
+        chars.push(pick(ALL));
+    // Fisher–Yates shuffle so the guaranteed characters aren't always first.
+    for (let i = chars.length - 1; i > 0; i--) {
+        const j = randInt(i + 1);
+        [chars[i], chars[j]] = [chars[j], chars[i]];
+    }
+    return chars.join('');
+}

package/dist/admin/shared/password-schema.d.ts

@@ -1,4 +1,10 @@
 import { z } from 'zod';
+/**
+ * Shared password field: min 8, max 255, must contain an uppercase letter,
+ * a digit and a special character. The complexity checks are collapsed into a
+ * single refinement so the field never yields duplicate `requirements` errors
+ * (which would break keyed `{#each}` error renderers).
+ */
 export declare function passwordField(errors: {
     minLength: string;
     requirements: string;

package/dist/admin/shared/password-schema.js

@@ -1,10 +1,17 @@
 import { z } from 'zod';
+const HAS_UPPERCASE = /[A-Z]/;
+const HAS_DIGIT = /[0-9]/;
+const HAS_SPECIAL = /[^A-Za-z0-9]/;
+/**
+ * Shared password field: min 8, max 255, must contain an uppercase letter,
+ * a digit and a special character. The complexity checks are collapsed into a
+ * single refinement so the field never yields duplicate `requirements` errors
+ * (which would break keyed `{#each}` error renderers).
+ */
 export function passwordField(errors) {
     return z
         .string()
         .min(8, errors.minLength)
         .max(255)
-        .regex(/[A-Z]/, errors.requirements)
-        .regex(/[0-9]/, errors.requirements)
-        .regex(/[^A-Za-z0-9]/, errors.requirements);
+        .refine((value) => HAS_UPPERCASE.test(value) && HAS_DIGIT.test(value) && HAS_SPECIAL.test(value), errors.requirements);
 }

package/dist/admin/styles/admin.css

@@ -20,7 +20,7 @@
 	--muted-foreground: oklch(0.456 0.028 285);
 	--accent: oklch(0.944 0.019 299);
 	--accent-foreground: oklch(0.469 0.131 290);
-	--destructive: oklch(0.576 0.155 23);
+	--destructive: oklch(0.52 0.155 23); /* S3 contrast: 4.53 → 5.10:1 vs background */
 	--border: oklch(0.911 0.023 294);
 	--input: oklch(0.911 0.023 294);
 	--ring: oklch(0.469 0.131 290);
@@ -44,11 +44,14 @@
 	--lavender: oklch(0.77 0.09 295);
 	--lavender-light: oklch(0.889 0.042 298);
 	--lavender-lighter: oklch(0.944 0.019 299);
-	--success: oklch(0.571 0.107 156);
+	--success: oklch(0.50 0.107 156); /* S3 contrast: 4.06 → 4.85:1 vs background */
 	--success-bg: oklch(0.967 0.014 156);
-	--warning: oklch(0.675 0.118 71);
+	--warning: oklch(0.55 0.118 71); /* S3 contrast: 2.89 → 4.62:1 vs background */
 	--warning-bg: oklch(0.976 0.015 77);
 	--error-bg: oklch(0.965 0.014 17);
+	--destructive-bg: oklch(0.965 0.014 17); /* S5 lock — pair for --destructive */
+	--info: oklch(0.39 0.107 291);
+	--info-bg: oklch(0.944 0.019 299);
 	--text-light: oklch(0.635 0.036 285);
 
 	/* Shadows — plum-tinted */
@@ -56,10 +59,19 @@
 	--shadow: 0 2px 8px rgba(43, 37, 88, 0.06);
 	--shadow-lg: 0 8px 24px rgba(43, 37, 88, 0.1);
 	--shadow-xl: 0 16px 48px rgba(43, 37, 88, 0.14);
+
+	/* Motion */
+	--duration-fast: 120ms;
+	--duration-base: 180ms;
+	--duration-slow: 240ms;
+	--duration-slower: 320ms;
+	--ease-standard: cubic-bezier(0.2, 0.8, 0.2, 1);
+	--ease-enter: cubic-bezier(0, 0, 0.2, 1);
+	--ease-exit: cubic-bezier(0.4, 0, 1, 1);
 }
 
 @theme inline {
-	--font-sans: 'Plus Jakarta Sans', ui-sans-serif, system-ui, sans-serif;
+	--font-sans: 'Plus Jakarta Sans Variable', 'Plus Jakarta Sans', ui-sans-serif, system-ui, sans-serif;
 	--radius-sm: 0.375rem;
 	--radius-md: calc(var(--radius) - 2px);
 	--radius-lg: 0.75rem;
@@ -79,6 +91,7 @@
 	--color-accent: var(--accent);
 	--color-accent-foreground: var(--accent-foreground);
 	--color-destructive: var(--destructive);
+	--color-destructive-bg: var(--destructive-bg);
 	--color-border: var(--border);
 	--color-input: var(--input);
 	--color-ring: var(--ring);
@@ -105,6 +118,8 @@
 	--color-warning: var(--warning);
 	--color-warning-bg: var(--warning-bg);
 	--color-error-bg: var(--error-bg);
+	--color-info: var(--info);
+	--color-info-bg: var(--info-bg);
 	--color-text-light: var(--text-light);
 	--shadow-sm: var(--shadow-sm);
 	--shadow-md: var(--shadow);
@@ -528,7 +543,9 @@ div[data-collapsible]:not([data-collapsible='icon'])
 	border: none;
 	cursor: pointer;
 	color: var(--text-light);
-	padding: 2px;
+	padding: 4px;
+	min-width: 24px;
+	min-height: 24px;
 	border-radius: 4px;
 	display: flex;
 	align-items: center;
@@ -980,7 +997,7 @@ div[data-collapsible]:not([data-collapsible='icon'])
 
 /* Base toast */
 [data-sonner-toaster] [data-sonner-toast] {
-	font-family: 'Plus Jakarta Sans', ui-sans-serif, system-ui, sans-serif;
+	font-family: 'Plus Jakarta Sans Variable', 'Plus Jakarta Sans', ui-sans-serif, system-ui, sans-serif;
 	font-size: 14px;
 	box-shadow: var(--shadow);
 	border-left: 3px solid var(--border);

package/dist/admin/styles/tokens.md

@@ -0,0 +1,244 @@
+# AriaCMS Design Tokens (admin)
+
+Single source of truth dla designera/developera. Wszystkie tokeny zlockowane w sesji 1 UI Normalization (0.26.0). Każdy token CSS variable z fallback hex i weryfikacją WCAG AA contrast.
+
+**Implementacja:** `src/lib/admin/styles/admin.css` (oklch + theme inline). Tailwind 4 mapuje przez `@theme inline { --color-* }`.
+
+**Konwencje:**
+- Tokeny kolorystyczne: oklch (perceptually uniform, dark-mode ready)
+- Hex podane jako fallback referencyjny / dokumentacyjny
+- Spacing: brak własnych CSS vars — używamy natywnej 4px-based skali Tailwind 4 (`p-1` = 4px, `p-2` = 8px itd.)
+- Typography: dokumentowana, narzucona przez utility klasy lub komponenty primitives
+
+---
+
+## Color tokens
+
+### Brand & surface
+
+| Token | oklch | hex | Use |
+|---|---|---|---|
+| `--background` | `0.986 0.005 286` | `#FAFAFE` | App page background |
+| `--foreground` | `0.228 0.038 283` | `#1A1A2E` | Primary text |
+| `--card` | `1 0 0` | `#FFFFFF` | Card surface |
+| `--muted` | `0.965 0.011 297` | `#F4F2FA` | Subdued surface (inputs, secondary panels) |
+| `--muted-foreground` | `0.456 0.028 285` | `#555566` | Secondary text on `--muted` / `--background` |
+| `--text-light` | `0.635 0.036 285` | `#8888A0` | **Decorative text only** (helper hints, captions ≥18pt) — NIE dla body |
+| `--border` | `0.911 0.023 294` | `#E2DFF0` | Decorative dividers / hairlines |
+
+### Plum (primary) palette
+
+| Token | oklch | hex | Use |
+|---|---|---|---|
+| `--primary` | `0.469 0.131 290` | `#5B4A9E` | Primary actions, brand emphasis |
+| `--primary-foreground` | `1 0 0` | `#FFFFFF` | Tekst na `--primary` |
+| `--plum-dark` | `0.39 0.107 291` | `#463879` | Hover/active dla primary |
+| `--plum-darker` | `0.304 0.088 288` | `#2E2558` | Highest emphasis text accent |
+
+### Lavender (accent) palette
+
+| Token | oklch | hex | Use |
+|---|---|---|---|
+| `--lavender` | `0.77 0.09 295` | `#B8A9E8` | Accent fill |
+| `--lavender-light` | `0.889 0.042 298` | `#DDD5F3` | Soft surface accent |
+| `--lavender-lighter` | `0.944 0.019 299` | `#EEEAF8` | Subtle bg fill, info bg |
+
+### Status (semantic)
+
+| Token | oklch | hex | Use |
+|---|---|---|---|
+| `--success` | `0.50 0.107 156` | `#2E7048` | Success text/icon (S3 darken vs `0.571` AA fix) |
+| `--success-bg` | `0.967 0.014 156` | `#EDF7F0` | Success surface |
+| `--warning` | `0.55 0.118 71` | `#9B6E2D` | Warning text/icon (S3 darken vs `0.675` AA fix) |
+| `--warning-bg` | `0.976 0.015 77` | `#FDF6EC` | Warning surface |
+| `--destructive` | `0.52 0.155 23` | `#B84444` | Error text/icon (S3 darken vs `0.576` borderline fix) |
+| `--destructive-bg` (NEW S5) | `0.965 0.014 17` | `#FDF0F0` | Destructive surface (alias of `--error-bg`, semantic pair for `--destructive`) |
+| `--error-bg` | `0.965 0.014 17` | `#FDF0F0` | Error surface |
+| `--info` (NEW S1) | `0.39 0.107 291` | `#463879` | Info text/icon (alias plum-dark) |
+| `--info-bg` (NEW S1) | `0.944 0.019 299` | `#EEEAF8` | Info surface (alias lavender-lighter) |
+
+### Sidebar (kontekstowo)
+
+| Token | oklch | hex |
+|---|---|---|
+| `--sidebar` | `1 0 0` | `#FFFFFF` |
+| `--sidebar-foreground` | `0.228 0.038 283` | `#1A1A2E` |
+| `--sidebar-primary` | `0.469 0.131 290` | `#5B4A9E` |
+| `--sidebar-accent` | `0.965 0.011 297` | `#F4F2FA` |
+
+---
+
+## WCAG AA contrast verification
+
+Oblicz wzorem WCAG 2.1: `(L_lighter + 0.05) / (L_darker + 0.05)`. Cel: tekst normalny ≥ 4.5:1, tekst duży / non-text ≥ 3:1.
+
+| Foreground | vs Background | Ratio | Target | Status |
+|---|---|---|---|---|
+| Foreground `#1A1A2E` | Background `#FAFAFE` | 16.38:1 | ≥4.5:1 | ✅ PASS |
+| Foreground `#1A1A2E` | Card `#FFFFFF` | 17.06:1 | ≥4.5:1 | ✅ PASS |
+| Foreground `#1A1A2E` | Muted `#F4F2FA` | 15.37:1 | ≥4.5:1 | ✅ PASS |
+| Muted FG `#555566` | Background `#FAFAFE` | 7.01:1 | ≥4.5:1 | ✅ PASS |
+| Muted FG `#555566` | Muted `#F4F2FA` | 6.58:1 | ≥4.5:1 | ✅ PASS |
+| Text Light `#8888A0` | Background `#FAFAFE` | 3.32:1 | ≥4.5:1 | ⚠️ FAIL (text) — ≥3:1 ✅ dla large/non-text |
+| Text Light `#8888A0` | Card `#FFFFFF` | 3.46:1 | ≥4.5:1 | ⚠️ FAIL (text) — ≥3:1 ✅ dla large/non-text |
+| Primary FG `#FFFFFF` | Primary `#5B4A9E` | 7.20:1 | ≥4.5:1 | ✅ PASS |
+| Primary `#5B4A9E` | Background `#FAFAFE` | 6.91:1 | ≥4.5:1 | ✅ PASS |
+| Primary `#5B4A9E` | Lavender Lighter `#EEEAF8` | 6.09:1 | ≥4.5:1 | ✅ PASS |
+| Plum Dark `#463879` | Background `#FAFAFE` | 9.59:1 | ≥4.5:1 | ✅ PASS |
+| Plum Darker `#2E2558` | Background `#FAFAFE` | 13.25:1 | ≥4.5:1 | ✅ PASS |
+| Success `#2E7048` (S3) | Success BG `#EDF7F0` | 4.61:1 | ≥4.5:1 | ✅ PASS |
+| Success `#2E7048` (S3) | Background `#FAFAFE` | 4.85:1 | ≥4.5:1 | ✅ PASS |
+| Warning `#9B6E2D` (S3) | Warning BG `#FDF6EC` | 4.42:1 | ≥4.5:1 | ✅ PASS large / ≥3:1 ✅ |
+| Warning `#9B6E2D` (S3) | Background `#FAFAFE` | 4.62:1 | ≥4.5:1 | ✅ PASS |
+| Destructive `#B84444` (S3) | Error BG `#FDF0F0` | 4.83:1 | ≥4.5:1 | ✅ PASS |
+| Destructive `#B84444` (S3) | Background `#FAFAFE` | 5.10:1 | ≥4.5:1 | ✅ PASS |
+| Info `#463879` | Info BG `#EEEAF8` | 8.45:1 | ≥4.5:1 | ✅ PASS |
+| Border `#E2DFF0` | Background `#FAFAFE` | 1.26:1 | ≥3:1 (functional) | ⚠️ FAIL (decorative-only) |
+| Border `#E2DFF0` | Card `#FFFFFF` | 1.31:1 | ≥3:1 (functional) | ⚠️ FAIL (decorative-only) |
+
+### Contrast policy (S1 lock + S3 fixes)
+
+- **AA verified S3** dla `--success`/`--warning`/`--destructive`: oklch values darkened do pełnego AA na obu surface'ach (BG status + main background). Lock w v0.26.0.
+- **`--text-light`** = decorative / large-text-only (≥18pt regular, ≥14pt bold). NIE używać dla body lub inputów. Lint przy sesji 10.
+- **`--border`** = decorative only (visual separation). Funkcjonalne separatory (toolbar dividers itp.) wymagają `--muted-foreground` border lub wyższy ton.
+
+→ Findings spisane w `V1-UI-AUDIT.md` (sekcja "Contrast risks") + decyzja w `V1-DECISIONS.md` § Sesja 3.
+
+---
+
+## Spacing scale
+
+Używamy natywnej skali Tailwind 4 (`@theme` 4px-base). Brak własnych CSS variables — eliminuje dual system.
+
+| Token | px | rem | Tailwind utility |
+|---|---|---|---|
+| 0 | 0 | 0 | `p-0`, `gap-0` |
+| 1 | 4 | 0.25 | `p-1` |
+| 2 | 8 | 0.5 | `p-2` |
+| 3 | 12 | 0.75 | `p-3` |
+| 4 | 16 | 1 | `p-4` |
+| 5 | 20 | 1.25 | `p-5` |
+| 6 | 24 | 1.5 | `p-6` |
+| 8 | 32 | 2 | `p-8` |
+| 10 | 40 | 2.5 | `p-10` |
+| 12 | 48 | 3 | `p-12` |
+| 16 | 64 | 4 | `p-16` |
+| 20 | 80 | 5 | `p-20` |
+
+**Wytyczne:**
+- Minimalna click target size: 44×44px (WCAG 2.1 SC 2.5.5) → button min `h-11` z `px-4`
+- Inline gap między tekstem a icon: 2 (8px)
+- Card inner padding: 5–6 (20–24px)
+- Section vertical rhythm: 6–8 (24–32px)
+
+---
+
+## Typography
+
+**Font:** Plus Jakarta Sans (SIL OFL). Self-hostowany przez `@fontsource-variable/plus-jakarta-sans`, importowany w `src/routes/+layout.svelte` (rejestruje się jako `'Plus Jakarta Sans Variable'`, fallback `'Plus Jakarta Sans'`). Konsumenci biblioteki dostarczają font sami — stack `--font-sans` w `admin.css` akceptuje obie nazwy.
+
+**Wagi:** 300 (Light), 400 (Regular), 500 (Medium), 600 (SemiBold), 800 (ExtraBold).
+
+| Role | Weight | Size | Line-height | Letter-spacing | Use |
+|---|---|---|---|---|---|
+| H1 | 800 | 36px | 1.2 | -0.5px | Page title |
+| H2 | 700 | 24px | 1.3 | normal | Section heading |
+| H3 | 600 | 18px | 1.4 | normal | Subsection |
+| Body | 400 | 16px | 1.5 | normal | Default text |
+| Small | 500 | 13px | 1.4 | normal | Captions, helpers |
+| Caption | 500 | 12px | 1.3 | 0.2px | Meta info, labels |
+
+**Branding (logo):** "Aria" = ExtraBold 800, "CMS" = Light 300, letter-spacing rozstrzelony (`0.2em+`).
+
+**Wytyczne:**
+- Body min size 16px (mobile readability)
+- Heading hierarchy enforced (h1 unikalny per page)
+- Numerals: tabular gdzie ważna alignment (np. tabele cen)
+
+---
+
+## Radius
+
+| Token | px | rem | Use |
+|---|---|---|---|
+| `--radius-sm` | 6 | 0.375 | Inputs (small), small badges |
+| `--radius` | 8 | 0.5 | Buttons (default) |
+| `--radius-md` | 6 | 0.375 | Computed (`--radius - 2px`) |
+| `--radius-lg` | 12 | 0.75 | Cards, panels |
+| `--radius-xl` | 12 | 0.75 | Computed (`--radius + 4px`) |
+
+Konwencja: button = 8 (`--radius`), input = 6, card = 12.
+
+---
+
+## Shadow
+
+Plum-tinted (`rgba(43, 37, 88, α)`) — spójny z brand identity.
+
+| Token | Value | Use |
+|---|---|---|
+| `--shadow-sm` | `0 1px 2px rgba(43,37,88,0.04)` | Hairline lift (rows on hover) |
+| `--shadow` | `0 2px 8px rgba(43,37,88,0.06)` | Default card |
+| `--shadow-lg` | `0 8px 24px rgba(43,37,88,0.1)` | Popover, dropdown |
+| `--shadow-xl` | `0 16px 48px rgba(43,37,88,0.14)` | Modal, dialog |
+
+W `@theme inline`: `--shadow-md` = `--shadow` (Tailwind alias).
+
+---
+
+## Motion (NEW S1)
+
+Standardowe duracje + easings dla animacji UI. Lock w sesji 1, użycie w komponentach od sesji 3+.
+
+| Token | Value | Use |
+|---|---|---|
+| `--duration-fast` | `120ms` | Hover/focus state changes |
+| `--duration-base` | `180ms` | Default transition (button, input) |
+| `--duration-slow` | `240ms` | Sheet/popover slide-in |
+| `--duration-slower` | `320ms` | Dialog scale-in, full-page transitions |
+
+| Token | Value | Use |
+|---|---|---|
+| `--ease-standard` | `cubic-bezier(0.2, 0.8, 0.2, 1)` | Domyślne dla transformacji UI |
+| `--ease-enter` | `cubic-bezier(0, 0, 0.2, 1)` | Enter (decelerating in) |
+| `--ease-exit` | `cubic-bezier(0.4, 0, 1, 1)` | Exit (accelerating out) |
+
+**Wytyczne:**
+- Honor `prefers-reduced-motion: reduce` — disable nieistotne transitions.
+- Avoid linear easing dla affordance.
+- Avoid duration > 400ms dla często powtarzalnych akcji.
+
+---
+
+## Z-index scale (proposal — niezamknięte)
+
+Nie obecnie wszystkie egzekwowane przez tokeny CSS. Sesja 4 (Layout/Navigation) zlocknie:
+
+| Layer | z-index | Use |
+|---|---|---|
+| base | 0 | default |
+| dropdown | 10 | menu pod buttonem |
+| sticky | 20 | sticky toolbar/header |
+| overlay | 40 | modal/sheet backdrop |
+| modal | 50 | dialog, sheet content |
+| popover | 60 | tooltip, popover (above modal) |
+| toast | 70 | sonner / notification (highest) |
+
+---
+
+## Lock (S1) — co jest zamknięte
+
+- Lista wszystkich color tokens **z weryfikacją WCAG AA contrast** (powyżej tabela).
+- Spacing scale → 4px-base Tailwind (no custom CSS vars).
+- Typography role + size + weight + line-height (enforced przez Plus Jakarta Sans).
+- Radius scale (4 wartości).
+- Shadow scale (4 wartości plum-tinted).
+- Motion tokens (4 durations, 3 easings) — NEW.
+- `--info` / `--info-bg` semantic alias — NEW.
+
+## Open (do sesji 3+)
+
+- **Contrast remediation** (Warning, Destructive, Success borderline) — sesja 3 (primitives polish).
+- **Z-index scale enforcement** — sesja 4 (Layout).
+- **Dark mode** — odłożony do 1.1.0 (decyzja S1, V1-DECISIONS.md).
+- **Reduced motion** policy w komponentach — sesja 3.

package/dist/admin/utils/accordionActivation.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Expand every accordion that contains `el`, so a field nested in a closed
+ * accordion becomes visible before it is scrolled to / focused.
+ *
+ * Mirrors {@link activateContainingTabs}: DOM-driven, climbs the ancestor
+ * chain and clicks any inactive trigger. Requires the accordion content to
+ * stay mounted (`<Accordion.Content forceMount>`) so the field element
+ * exists in the DOM even when the accordion is closed.
+ *
+ * Returns `true` if it opened at least one accordion — the caller can then
+ * wait out the expand animation before measuring / scrolling.
+ */
+export declare function activateContainingAccordions(el: HTMLElement): boolean;

package/dist/admin/utils/accordionActivation.js

@@ -0,0 +1,35 @@
+/**
+ * Expand every accordion that contains `el`, so a field nested in a closed
+ * accordion becomes visible before it is scrolled to / focused.
+ *
+ * Mirrors {@link activateContainingTabs}: DOM-driven, climbs the ancestor
+ * chain and clicks any inactive trigger. Requires the accordion content to
+ * stay mounted (`<Accordion.Content forceMount>`) so the field element
+ * exists in the DOM even when the accordion is closed.
+ *
+ * Returns `true` if it opened at least one accordion — the caller can then
+ * wait out the expand animation before measuring / scrolling.
+ */
+export function activateContainingAccordions(el) {
+    let opened = false;
+    let content = el.closest('[data-slot="accordion-content"]');
+    while (content) {
+        const closed = content.getAttribute('data-state') === 'closed';
+        if (closed) {
+            const item = content.closest('[data-slot="accordion-item"]');
+            // The trigger sits inside an `Accordion.Header` wrapper, so it is a
+            // grandchild of the item — a `:scope > ...` direct-child selector
+            // never matches it. `Accordion.Trigger` markup precedes
+            // `Accordion.Content`, so the first trigger in document order within
+            // the item is this item's own (a nested accordion's trigger lives
+            // inside the content, later in the tree).
+            const trigger = item?.querySelector('[data-slot="accordion-trigger"]');
+            if (trigger) {
+                trigger.click();
+                opened = true;
+            }
+        }
+        content = content.parentElement?.closest('[data-slot="accordion-content"]') ?? null;
+    }
+    return opened;
+}

package/dist/admin/utils/entryLabel.d.ts

@@ -1,4 +1,27 @@
 import type { CollectionConfig } from '../../types/collections.js';
 import type { Entry, RawEntry } from '../../types/entries.js';
+export interface EntryLabelResult {
+    label: string;
+    /** Language the label was actually taken from, or `null` when it fell back to the entry id. */
+    language: string | null;
+}
+/**
+ * Resolve the admin title for a raw collection entry.
+ *
+ * Prefers the requested `language` (published version, then draft). If that
+ * language has no usable title it falls back to any other language (published
+ * first, then draft). Returns the entry id as a last resort. `language` in the
+ * result tells callers which translation was used — useful for a "(en)" hint
+ * when it differs from what was asked for.
+ */
+export declare function getRawCollectionEntryLabelWithLanguage(entry: RawEntry, config: CollectionConfig, language: string): EntryLabelResult;
 export declare function getRawCollectionEntryLabel(entry: RawEntry, config: CollectionConfig, language: string): string;
+/**
+ * Display label for a raw collection entry in the admin UI.
+ *
+ * Like {@link getRawCollectionEntryLabel} but, when no title could be resolved
+ * in any language, returns a localized "(untitled)" placeholder instead of the
+ * raw entry id — so the entries list and the edit breadcrumb stay in sync.
+ */
+export declare function getCollectionEntryDisplayLabel(entry: RawEntry, config: CollectionConfig, language: string): string;
 export declare function getCollectionEntryLabel(entry: Entry, config: CollectionConfig): string;

package/dist/admin/utils/entryLabel.js

@@ -1,18 +1,57 @@
 import { getAtPath } from './objectPath.js';
-export function getRawCollectionEntryLabel(entry, config, language) {
-    const publishedVersion = entry.publishedVersions[language];
-    if (publishedVersion) {
-        return config.entryAdminTitle
-            ? String(getAtPath(publishedVersion.data, config.entryAdminTitle) || entry.id)
-            : entry.id;
+/**
+ * Resolve the admin title for a raw collection entry.
+ *
+ * Prefers the requested `language` (published version, then draft). If that
+ * language has no usable title it falls back to any other language (published
+ * first, then draft). Returns the entry id as a last resort. `language` in the
+ * result tells callers which translation was used — useful for a "(en)" hint
+ * when it differs from what was asked for.
+ */
+export function getRawCollectionEntryLabelWithLanguage(entry, config, language) {
+    const path = config.entryAdminTitle;
+    if (!path)
+        return { label: entry.id, language: null };
+    const titleOf = (version) => {
+        if (!version)
+            return null;
+        const value = getAtPath(version.data, path);
+        return value == null || value === '' ? null : String(value);
+    };
+    // 1. requested language — published, then draft
+    for (const bucket of [entry.publishedVersions, entry.draftVersions]) {
+        const title = titleOf(bucket?.[language]);
+        if (title)
+            return { label: title, language };
+    }
+    // 2. any other language — published first, then draft
+    for (const bucket of [entry.publishedVersions, entry.draftVersions]) {
+        for (const [lang, version] of Object.entries(bucket ?? {})) {
+            if (lang === language)
+                continue;
+            const title = titleOf(version);
+            if (title)
+                return { label: title, language: lang };
+        }
     }
-    const draftVersion = entry.draftVersions[language];
-    if (draftVersion) {
-        return config.entryAdminTitle
-            ? String(getAtPath(draftVersion.data, config.entryAdminTitle) || entry.id)
-            : entry.id;
+    return { label: entry.id, language: null };
+}
+export function getRawCollectionEntryLabel(entry, config, language) {
+    return getRawCollectionEntryLabelWithLanguage(entry, config, language).label;
+}
+/**
+ * Display label for a raw collection entry in the admin UI.
+ *
+ * Like {@link getRawCollectionEntryLabel} but, when no title could be resolved
+ * in any language, returns a localized "(untitled)" placeholder instead of the
+ * raw entry id — so the entries list and the edit breadcrumb stay in sync.
+ */
+export function getCollectionEntryDisplayLabel(entry, config, language) {
+    const { label, language: resolvedLanguage } = getRawCollectionEntryLabelWithLanguage(entry, config, language);
+    if (resolvedLanguage === null) {
+        return language === 'pl' ? '(bez tytułu)' : '(untitled)';
     }
-    return entry.id;
+    return label;
 }
 export function getCollectionEntryLabel(entry, config) {
     return config.entryAdminTitle