includio-cms 0.37.3 → 0.37.4

package/API.md

@@ -1,8 +1,8 @@
-# includio-cms — Public API v0.37.3
+# includio-cms — Public API v0.37.4
 
 > Auto-generated by `scripts/generate-api-md.ts`. Do not edit by hand.
 
-Entry points: **23** · Stable: **715** · Experimental: **4**
+Entry points: **23** · Stable: **716** · Experimental: **4**
 
 Tags:
 - `@public` — frozen for v1.0; semver-protected.
@@ -152,6 +152,7 @@ Tags:
 - `interface RadioField`
 - `interface RelationField`
 - `type RelationFieldData = string | string[]`
+- `interface RelationPopulate` — Chuda populacja relacji: allowlist populowanych pól + cap głębokości.
 - `interface SCFigureAttrs`
 - `interface SCInlineBlockAttrs`
 - `interface SCMark`

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to includio-cms are documented here.
 Generated from `src/lib/updates/` — do not edit manually.
 
+## 0.37.4 — 2026-07-20
+
+Wydajność populacji: chude relacje/listy (opt-in `select`/`populate`) + mniejszy over-fetch wersji + indeksy ścieżki treści. Wyszło z diagnozy wolnych podstron u pod-zwrotnikami (bloki-listy ciągnące pełne media/relacje).
+
+### Added
+- **Chuda populacja relacji (`select`/`depth`) — trzy warstwy.** Na polu relacji `populate: { select: ["title", "hero"], depth: 0 }`, na kolekcji docelowej `defaultPopulate`, oraz per-call `resolveEntry(s)({ populate: { select, fields } })`. Precedencja: call > pole > kolekcja > pełna populacja (domyślnie, wstecznie zgodnie). `select` tnie także pola **media** — galeria nie jest już populowana, gdy widok czyta tylko `heroImage`. Meta (`_id/_slug/_url/...`) zawsze obecne.
+- **`resolveEntries({ populate: { select: [...] } })` dla list/bloków.** Chudy widok listy bez ciągnięcia pełnego drzewa każdego wpisu (media + relacje).
+
+### Fixed
+- **Mniejszy over-fetch wersji.** Wybór wersji czyta teraz tylko metadane (`getEntryVersionsMeta`, bez kolumny `data`), a pełne dane hydratują się wyłącznie dla wybranej wersji (`getEntryVersionData`). Wcześniej każda relacja/wpis ciągnął pełny JSON wszystkich swoich wersji i wybierał najnowszą w JS — koszt mnożony przez głębokość i liczbę wpisów.
+- **Indeksy ścieżki treści.** `entry(slug)`, `entry(type)`, `entry_version(entry_id, lang, version_number)`, `entry_version(entry_id, published_at)`, `media_file_tag(tag_id)`. Aplikowane przy `db:push`.
+
+### Breaking
+- **Kontrakt `DatabaseAdapter`: nowe wymagane metody `getEntryVersionsMeta` + `getEntryVersionData`.** Dotyczy wyłącznie własnych implementacji adaptera DB (oficjalny `db-postgres` zaktualizowany). `getEntryVersions` (pełne wersje) pozostaje bez zmian.
+
+### Notes
+
+Indeksy z tego wydania wchodzą przy najbliższym `pnpm db:push` w projekcie klienta — brak osobnej migracji SQL.
+
 ## 0.37.2 — 2026-07-16
 
 Powierzchnia SEO/AEO rdzenia — reużywalne helpery, które raz naprawione w rdzeniu działają u każdego klienta (wyszły z wdrożenia SEO u pod-zwrotnikami). W tym samym patchu domyka się też łatka bezpieczeństwa bookingu (kwota płatności).

package/DOCS.md

@@ -1,4 +1,4 @@
-# Includio CMS Documentation (v0.37.3)
+# Includio CMS Documentation (v0.37.4)
 
 > This file is auto-generated from the docs site. For the latest version, update the package.
 

package/ROADMAP.md

@@ -35,6 +35,14 @@
 - [x] `[feature]` `[P1]` Slug first-class + SEO v1.0 freeze (0.26.0) — `resolveSeo` public (`includio-cms/core`), `seoFieldDescriptor` SSOT (Zod+TS drift-guard), admin URL un-hardcode (`slugPath.ts` pure resolver, no `seo`-field requirement), `SlugField`/`SeoField`/`SeoFieldData` `@public` v1.0-frozen <!-- files: src/lib/core/fields/slugPath.ts, src/lib/core/fields/seoFieldDescriptor.ts, src/lib/core/fields/resolveSeo.ts, src/lib/types/fields.ts, src/lib/admin/client/collection/collection-entries.svelte, src/lib/updates/0.26.0/ -->
 - [x] `[feature]` `[P2]` Soft-delete zamówień admin-only (0.34.0) — ukrycie zamówienia z listy bez utraty danych (`deleted_at`/`deleted_by`), kosz + przywracanie, guard `decideOrderDeletion` (safe-statuses + faktura), auto-restore przy płatności, zwolnienie rezerwacji stocku, `requireRole('admin')` <!-- files: src/lib/shop/server/orders.ts, src/lib/db-postgres/schema/shop/order.ts, src/lib/admin/remote/shop.remote.ts, src/lib/admin/client/shop/{shop-order-detail-page,shop-orders-list-page,restore-order-cell}.svelte, src/lib/updates/0.34.0/ -->
 
+## 0.37.4 — Wydajność populacji
+
+- [x] `[feature]` `[P1]` Chuda populacja relacji (`select`/`populate`/`defaultPopulate`, 3 warstwy: call > pole > kolekcja) — `select` tnie media i relacje, `depth` cap per-pole; bloki-listy/karty-linki nie ciągną już pełnego drzewa target-wpisów. Spec: `docs/architecture/2026-07-20-lean-populate-select.md`, plan: `docs/architecture/2026-07-20-lean-populate-select.plan.md`. <!-- files: src/lib/types/{fields,collections}.ts, src/lib/core/server/fields/{populateSelect,resolveRelationFields}.ts, src/lib/core/server/entries/operations/resolveEntry.ts -->
+- [x] `[fix]` `[P1]` Over-fetch wersji — meta→pick→hydrate (`getEntryVersionsMeta`/`getEntryVersionData`), pełny JSON tylko dla wybranej wersji. <!-- files: src/lib/core/server/entries/operations/versionResolve.ts, src/lib/types/adapters/db.ts, src/lib/db-postgres/index.ts -->
+- [x] `[fix]` `[P1]` Indeksy ścieżki treści — `entry(slug,type)`, `entry_version(entry_id,lang,version_number / entry_id,published_at)`, `media_file_tag(tag_id)`. <!-- files: src/lib/db-postgres/schema/{entry,entryVersion,mediaFileTag}.ts -->
+- [x] `[breaking]` `[P2]` Kontrakt `DatabaseAdapter` — nowe wymagane `getEntryVersionsMeta` + `getEntryVersionData` (dotyczy własnych adapterów DB).
+- Backlog wydajności (odroczone C/D/E/F/G + indeksy shop/booking): `ideas/performance-backlog.md`.
+
 ## 0.37.1 — Bramka cenowa (bezpieczeństwo)
 
 - [x] `[fix]` `[breaking]` `[P0]` **Data wyceny zamrożona na rezerwacji** (`bookings.priced_at`). Dotąd cena bazowa była zamrożona, ale data — nie: `editBooking` i `priceFromExistingRows` (ścieżka **korekt**) przeliczały reguły zależne od czasu wg `new Date()`. Obsługa księgowała dopłatę ustaloną telefonicznie tydzień przed wylotem → `daysUntil(anchor, now)` spadało poniżej progu → **early-bird sprzed miesięcy cicho znikał, a klient robił się winien pieniądze**. Bomba tykała sama, bez żadnej zmiany cennika. Rezerwacje sprzed 0.37.1: `priced_at = NULL` → fallback na `created_at` (zero migracji danych). Pełny snapshot **wartości** polityki (`pricing_snapshot`) zostaje w 0.38.0 §4.4 — wymaga świadomej zmiany cennika przez klientkę, więc da się ją uprzedzić.
@@ -103,6 +111,18 @@ Spec: `docs/superpowers/specs/2026-07-13-moduly-kontrakt-vs-polityka-design.md`.
 
 ## Backlog
 
+> **i18n / lokalizacja** — audyt stanu + porównanie z PayloadCMS: `ideas/post-v1/i18n-localization-audit.md`
+> (2026-07-20). Wniosek: Paraglide zostaje, praca leży w rdzeniu. Każdy item = osobny brainstorm.
+> Microcopy aplikacji osobno: `ideas/post-v1/editable-microcopy-i18n.md`.
+
+- [ ] `[fix]` `[P0]` **Brak tłumaczenia ładuje treść innego języka** — gdy wpis nie ma wersji dla wybranego języka, `entry-version.svelte:21` przechodzi fallbackiem na `entry.versions[0]`, czyli pokazuje treść *innego* języka pod etykietą wybranego, bez sygnału w UI. Edytor przełącza na EN, widzi polski tekst, poprawia i zapisuje → nadpisał EN polszczyzną. Cicha utrata danych, nie kosmetyka. Payload pokazuje w tej sytuacji pusty slice locale. Potrzebny jawny pusty stan („brak tłumaczenia — utwórz / skopiuj z…"). Audyt §C1. <!-- files: src/lib/admin/client/entry/entry-version.svelte -->
+- [ ] `[breaking]` `[P1]` **Locale config v2** — usunąć hardkod `Language = 'en'\|'pl'` (`types/languages.ts:3`, dziś blokuje trzeci język i klienta nie-PL/EN), kształt locale `{ code, label, rtl?, fallbackLocale? }` + explicit `defaultLocale` zamiast konwencji „pierwszy z tablicy", oraz łańcuch fallbacków przy odczycie zamiast twardego `ENTRY_VERSION_NOT_FOUND` (wzorzec: Payload `sanitizeFallbackLocale.ts`). Jeden spec — wspólna powierzchnia, jedno breaking. Audyt §B1-B3. <!-- files: src/lib/types/languages.ts, src/lib/types/config.ts, src/lib/core/server/entries/operations/resolveEntry.ts -->
+- [ ] `[feature]` `[P1]` **Per-locale routing surface** — `resolveEntryBySlug(collection, slug, {locale})` + `alternates`/`getAlternateUrls(entry)` w rdzeniu, plus typy wyrażające relację „ten sam wpis, inny język". Dziś konsument ręcznie re-queruje CMS w drugim języku po przetłumaczony slug, owija w try/catch cicho zwracający `{}`, robi twardy `window.location.href` przy zmianie języka i sypie `as any` (moreways `[...slug]/+page.server.ts:6-19`, `navbar.svelte:11-18`). Każdy kolejny wielojęzyczny konsument wdepnie w to samo. Audyt §A1-A2. <!-- files: src/lib/core/server/entries/operations/resolveEntry.ts, src/lib/core/fields/slugPath.ts, src/lib/types/entries.ts -->
+- [ ] `[feature]` `[P1]` **Wymiar języka w liście wpisów** — kolumna/wskaźnik istniejących tłumaczeń + filtr „brakuje tłumaczenia X". Dziś `getEntryStatus` = „opublikowany, jeśli którykolwiek język", więc braków tłumaczeń nie widać z listy. Audyt §C2. <!-- files: src/lib/admin/client/collection/collection-entries.svelte, src/lib/admin/client/entry/utils.ts -->
+- [ ] `[fix]` `[P1]` **Historia wersji świadoma języka** — `version-history-sheet.svelte` miesza wersje wszystkich języków bez filtra i bez etykiety języka w wierszu, a nawigacja `?version=` omija switcher → można przywrócić wersję innego języka niż się sądzi. Audyt §C3. <!-- files: src/lib/admin/client/entry/version-history-sheet.svelte, entry-version.svelte -->
+- [ ] `[feature]` `[P2]` **UX lokalizacji w edytorze (paczka)** — copy-from-language per-pole/„tylko puste" zamiast całościowego nadpisania; język treści w URL (`?locale=`) zamiast globalnego toggle w localStorage dzielonego przez wszystkie wpisy; pasek „Translations" liczący realne pokrycie pól, nie sam status publikacji; ujednolicenie dwóch modeli lokalizacji (wersja-per-język vs wartości kluczowane językiem w `simple-array`/`blocks`/`UrlFieldData`). Audyt §C4-C7. <!-- files: src/lib/admin/client/entry/{entry,publish-panel}.svelte, src/lib/admin/state/content-language.svelte.ts, src/lib/admin/components/fields/ -->
+- [ ] `[feature]` `[P2]` **Dokończyć i18n interfejsu admina** — store `interface-language` + switcher istnieją, ale katalog Paraglide ma 3 klucze placeholder, a 59/182 plików admina ma stringi zahardkodowane po polsku → switcher nie ma czego przełączać. Odpowiednik `@payloadcms/translations`. Duży, mechaniczny koszt. Audyt §D1. <!-- files: messages/{en,pl}.json, src/lib/admin/state/interface-language.svelte.ts, src/lib/admin/ -->
+- [ ] `[fix]` `[P2]` **Spójność i18n — maile formularzy + klucz języka w liście** — subject/body powiadomień formularzy to zahardkodowane literały angielskie mimo `Localized` na etykietach pól; `collection-entries.svelte:506-509` keyuje odczyt treści (a11y check) po *interface* language zamiast content language. Audyt §D2-D3. <!-- files: src/lib/core/server/forms/submissions/operations/create.ts, src/lib/admin/client/collection/collection-entries.svelte -->
 - [ ] `[feature]` `[P2]` **Panel SEO w sidebarze admina (Yoast-like)** — osobny brainstorm/spec. Guided, niestechniczny panel (odwrotność przytłaczającego Yoasta, on-brand): globalna konfiguracja SEO, per-wpisowy box (snippet preview, noindex toggle, focus keyword → wtedy świadome rozszerzenie pola `seo`), pobranie sitemapy (nakładka na `buildSitemap`). **Przekierowania (redirects)** prawdopodobnie własny spec (tabela DB + hook 301/302 + CRUD). Szwy pod to = SEO surface 0.37.2.
 - [ ] `[fix]` `[P1]` Wyciek puli połączeń DB w dev (HMR) — pojedynczy proces `vite dev` konsumenta trzymał **100 połączeń** do Postgresa (cały `max_connections`), po czym baza odbijała wszystko: `FATAL: sorry, too many clients already` (zaobserwowane 2026-07-13 na pod-zwrotnikami). Hipoteza: każde przeładowanie modułu przez HMR tworzy nowy klient `postgres.js` (pula domyślnie 10), a stary nie jest zamykany — 10 przeładowań wyczerpuje limit. Sprawdzić zamykanie klienta w `import.meta.hot.dispose` / singleton na `globalThis` w adapterze. Dotyka każdego, kto dłużej pracuje w dev. <!-- files: src/lib/db-postgres/index.ts -->
 - [ ] `[chore]` `[P1]` CMS doctor — `validateLayout()` jest napisany i przetestowany, ale nie jest wołany z żadnego miejsca produkcyjnego: literówka w nazwie pola w tabie przechodzi po cichu (pole ląduje w orphanach). Podpiąć go do `defineConfig` obok `validatePreviews`, dołożyć `pnpm cms check` w CLI i zestaw reguł zdrowia configu (martwe pola, `pathTemplate` bez `previewUrl`/`previews`, itp.). <!-- files: src/lib/core/fields/layoutUtils.ts, src/lib/sveltekit/config.ts, src/lib/core/config/, src/lib/cli/index.ts -->
@@ -117,7 +137,7 @@ Spec: `docs/superpowers/specs/2026-07-13-moduly-kontrakt-vs-polityka-design.md`.
 - [ ] `[feature]` `[P1]` Ban/unban UI — reason + expiry, `banUser`/`unbanUser` <!-- files: src/lib/admin/client/users/ban-user-dialog.svelte -->
 - [ ] `[feature]` `[P1]` Impersonation UI — impersonate/stop bar <!-- files: src/lib/admin/client/users/impersonation-bar.svelte -->
 - [ ] `[chore]` `[P2]` Caching/performance layer (scope TBD)
-  - [ ] `[perf]` Opt-out populacji media per-pole (`populate.fields` obejmujące media, nie tylko relacje) — dziś `resolveMediaFields` wołane bez `ctx`, galeria ciągnięta na marne w widokach list. Diagnoza + opcje: `docs/architecture/2026-07-16-media-populate-opt-out.md`
+  - [x] `[perf]` Opt-out populacji media per-pole — zrealizowane przez `select` (tnie media i relacje, 3 warstwy) w 0.37.4; notatka diagnozy wchłonięta. Spec: `docs/architecture/2026-07-20-lean-populate-select.md`
 - [ ] `[feature]` `[P2]` API/CLI for configuration (setup DX for less technical users)
 - [ ] `[feature]` `[P0]` Plugin hooks in CRUD ops (before/afterCreate, Update, Delete) <!-- files: src/lib/types/plugins.ts, src/lib/core/server/entries/operations/ -->
 - [ ] `[feature]` `[P0]` Plugin registration API — public surface for external plugins

package/dist/core/server/entries/operations/resolveEntry.d.ts

@@ -16,8 +16,10 @@ export type ResolveStatus = 'published' | 'draft' | 'scheduled';
 export type PopulateConfig = {
     /** Hard cap on relation depth. Default 5. Use `0` to keep all relations as raw IDs. */
     maxDepth?: number;
-    /** Per-field opt-out. `{ author: false }` keeps `author` as raw ID instead of populated Entry. */
-    fields?: Record<string, false>;
+    /** Zawęź top-level entry do tych slugów pól (+ meta). Omit = wszystkie pola. */
+    select?: string[];
+    /** Per-field: `false` = surowe ID (denylist); `RelationPopulate` = per-field lean override. */
+    fields?: Record<string, false | import('../../../../types/fields.js').RelationPopulate>;
 };
 /**
  * Internal context passed through the populate chain.

package/dist/core/server/entries/operations/resolveEntry.js

@@ -2,18 +2,8 @@ import { getCMS } from '../../../cms.js';
 import { getFieldsFromConfig } from '../../../fields/layoutUtils.js';
 import { getEntrySlugPath, getSlugFromEntryData, getEntryPath } from '../../fields/slugResolver.js';
 import { CmsError } from '../../../errors.js';
-function pickVersion(versions, status) {
-    const sorted = versions.slice().sort((a, b) => b.versionNumber - a.versionNumber);
-    const now = new Date();
-    switch (status) {
-        case 'published':
-            return sorted.find((v) => v.publishedAt != null && v.publishedAt <= now) ?? null;
-        case 'draft':
-            return sorted.find((v) => v.publishedAt == null) ?? null;
-        case 'scheduled':
-            return sorted.find((v) => v.publishedAt != null && v.publishedAt > now) ?? null;
-    }
-}
+import { pickAndHydrateVersions, pickVersionsFromMeta } from './versionResolve.js';
+import { narrowFields, narrowData } from '../../fields/populateSelect.js';
 async function buildEntry(dbEntry, version, ctx) {
     const cms = getCMS();
     let config;
@@ -25,9 +15,14 @@ async function buildEntry(dbEntry, version, ctx) {
         return null;
     }
     const fields = getFieldsFromConfig(config);
+    // Top-level select (tylko korzeń): zawęź pola+dane przed populacją,
+    // żeby resolvery (media/relacje) nie dotknęły niewybranych pól.
+    const sel = ctx.depth === 0 ? ctx.populate.select : undefined;
+    const effFields = sel ? narrowFields(fields, sel) : fields;
+    const effData = sel ? narrowData(version.data, sel) : version.data;
     // Lazy import to avoid static circular dep with resolveRelationFields → _populate
     const { _populate } = await import('../../fields/populateEntry.js');
-    const populated = await _populate(version.data, fields, ctx);
+    const populated = await _populate(effData, effFields, ctx);
     const slugPath = getEntrySlugPath(dbEntry.slug);
     const slugValue = getSlugFromEntryData(version.data, slugPath, ctx.locale);
     const _url = slugValue ? getEntryPath(dbEntry.slug, slugValue, ctx.locale) : undefined;
@@ -82,11 +77,13 @@ export async function resolveEntry(opts) {
         return null;
     if (opts.collection && dbEntry.slug !== opts.collection)
         return null;
-    const versions = await cms.databaseAdapter.getEntryVersions({
+    const versionMap = await pickAndHydrateVersions({
+        adapter: cms.databaseAdapter,
         entryIds: [dbEntry.id],
-        lang: locale
+        lang: locale,
+        status
     });
-    const picked = pickVersion(versions, status);
+    const picked = versionMap.get(dbEntry.id);
     if (!picked)
         return null;
     const ctx = {
@@ -143,24 +140,21 @@ export async function resolveEntries(opts) {
     if (filtered.length === 0)
         return [];
     const entryIds = filtered.map((e) => e.id);
-    const allVersions = await cms.databaseAdapter.getEntryVersions({
+    const versionMap = await pickAndHydrateVersions({
+        adapter: cms.databaseAdapter,
         entryIds,
         lang: locale,
-        dataValues: opts.filter?.dataValues,
-        dataLike: opts.filter?.dataLike,
-        dataILikeOr: opts.filter?.dataILikeOr
+        status,
+        filters: {
+            dataValues: opts.filter?.dataValues,
+            dataLike: opts.filter?.dataLike,
+            dataILikeOr: opts.filter?.dataILikeOr
+        }
     });
-    const versionsByEntry = new Map();
-    for (const v of allVersions) {
-        const arr = versionsByEntry.get(v.entryId) ?? [];
-        arr.push(v);
-        versionsByEntry.set(v.entryId, arr);
-    }
     const order = new Map(filtered.map((e, i) => [e.id, i]));
     const picks = [];
     for (const dbEntry of filtered) {
-        const vs = versionsByEntry.get(dbEntry.id) ?? [];
-        const picked = pickVersion(vs, status);
+        const picked = versionMap.get(dbEntry.id);
         if (picked)
             picks.push({ version: picked, dbEntry });
     }
@@ -219,24 +213,12 @@ export async function countEntries(opts) {
     if (filtered.length === 0)
         return 0;
     const entryIds = filtered.map((e) => e.id);
-    const allVersions = await cms.databaseAdapter.getEntryVersions({
+    const meta = await cms.databaseAdapter.getEntryVersionsMeta({
         entryIds,
         lang: locale,
         dataValues: opts.filter?.dataValues,
         dataLike: opts.filter?.dataLike,
         dataILikeOr: opts.filter?.dataILikeOr
     });
-    const versionsByEntry = new Map();
-    for (const v of allVersions) {
-        const arr = versionsByEntry.get(v.entryId) ?? [];
-        arr.push(v);
-        versionsByEntry.set(v.entryId, arr);
-    }
-    let count = 0;
-    for (const dbEntry of filtered) {
-        const vs = versionsByEntry.get(dbEntry.id) ?? [];
-        if (pickVersion(vs, status))
-            count++;
-    }
-    return count;
+    return pickVersionsFromMeta(meta, status).size;
 }

package/dist/core/server/entries/operations/versionResolve.d.ts

@@ -0,0 +1,39 @@
+import type { DbEntryVersion } from '../../../../types/entries.js';
+import type { DatabaseAdapter } from '../../../../types/adapters/db.js';
+import type { ResolveStatus } from './resolveEntry.js';
+type Pickable = {
+    versionNumber: number;
+    publishedAt: Date | null;
+};
+/**
+ * Wybierz wersję wg statusu.
+ * - `published`: najnowsza z `publishedAt <= now`
+ * - `draft`: najnowsza bez `publishedAt`; przy `draftFallback` → fallback na published
+ * - `scheduled`: najnowsza z `publishedAt > now` (bez fallbacku)
+ */
+export declare function pickVersion<T extends Pickable>(versions: T[], status: ResolveStatus, opts?: {
+    draftFallback?: boolean;
+}): T | null;
+/** Zgrupuj metadane wersji po `entryId` i wybierz jedną wersję na wpis. */
+export declare function pickVersionsFromMeta<T extends Pickable & {
+    entryId: string;
+}>(versions: T[], status: ResolveStatus, opts?: {
+    draftFallback?: boolean;
+}): Map<string, T>;
+/**
+ * Meta → pick → hydrate: pobiera metadane wersji (bez `data`), wybiera jedną na wpis,
+ * a pełne `data` hydratuje wyłącznie dla wybranych par (entryId, versionNumber).
+ */
+export declare function pickAndHydrateVersions(args: {
+    adapter: Pick<DatabaseAdapter, 'getEntryVersionsMeta' | 'getEntryVersionData'>;
+    entryIds: string[];
+    lang: string;
+    status: ResolveStatus;
+    draftFallback?: boolean;
+    filters?: {
+        dataValues?: Record<string, unknown>;
+        dataLike?: Record<string, unknown>;
+        dataILikeOr?: Record<string, unknown>;
+    };
+}): Promise<Map<string, DbEntryVersion>>;
+export {};

package/dist/core/server/entries/operations/versionResolve.js

@@ -0,0 +1,52 @@
+/**
+ * Wybierz wersję wg statusu.
+ * - `published`: najnowsza z `publishedAt <= now`
+ * - `draft`: najnowsza bez `publishedAt`; przy `draftFallback` → fallback na published
+ * - `scheduled`: najnowsza z `publishedAt > now` (bez fallbacku)
+ */
+export function pickVersion(versions, status, opts = {}) {
+    const sorted = versions.slice().sort((a, b) => b.versionNumber - a.versionNumber);
+    const now = new Date();
+    const published = () => sorted.find((v) => v.publishedAt != null && v.publishedAt <= now) ?? null;
+    switch (status) {
+        case 'published':
+            return published();
+        case 'draft':
+            return sorted.find((v) => v.publishedAt == null) ?? (opts.draftFallback ? published() : null);
+        case 'scheduled':
+            return sorted.find((v) => v.publishedAt != null && v.publishedAt > now) ?? null;
+    }
+}
+/** Zgrupuj metadane wersji po `entryId` i wybierz jedną wersję na wpis. */
+export function pickVersionsFromMeta(versions, status, opts) {
+    const byEntry = new Map();
+    for (const v of versions) {
+        const arr = byEntry.get(v.entryId) ?? [];
+        arr.push(v);
+        byEntry.set(v.entryId, arr);
+    }
+    const out = new Map();
+    for (const [entryId, vs] of byEntry) {
+        const picked = pickVersion(vs, status, opts);
+        if (picked)
+            out.set(entryId, picked);
+    }
+    return out;
+}
+/**
+ * Meta → pick → hydrate: pobiera metadane wersji (bez `data`), wybiera jedną na wpis,
+ * a pełne `data` hydratuje wyłącznie dla wybranych par (entryId, versionNumber).
+ */
+export async function pickAndHydrateVersions(args) {
+    const meta = await args.adapter.getEntryVersionsMeta({
+        entryIds: args.entryIds,
+        lang: args.lang,
+        ...args.filters
+    });
+    const picked = pickVersionsFromMeta(meta, args.status, { draftFallback: args.draftFallback });
+    if (picked.size === 0)
+        return new Map();
+    const picks = [...picked.values()].map((m) => ({ entryId: m.entryId, versionNumber: m.versionNumber }));
+    const hydrated = await args.adapter.getEntryVersionData({ picks, lang: args.lang });
+    return new Map(hydrated.map((v) => [v.entryId, v]));
+}

package/dist/core/server/fields/populateSelect.d.ts

@@ -0,0 +1,22 @@
+import type { Field, RelationPopulate } from '../../../types/fields.js';
+import type { EntryData } from '../../../types/entries.js';
+/** Efektywna konfiguracja populacji po rozwiązaniu precedencji. `null` = pełna populacja. */
+export type EffectivePopulate = {
+    select?: string[];
+    depth?: number;
+} | null;
+/**
+ * Rozwiąż precedencję chudej populacji dla pojedynczego pola relacji:
+ * call override > pole > kolekcja docelowa > null (pełna populacja).
+ */
+export declare function resolveEffectivePopulate(args: {
+    callOverride?: RelationPopulate;
+    fieldPopulate?: RelationPopulate;
+    collectionDefault?: RelationPopulate;
+}): EffectivePopulate;
+/** Zawęź listę definicji pól do wybranych slugów. */
+export declare function narrowFields(fields: Field[], select: string[]): Field[];
+/** Pick tylko wybranych kluczy z danych wpisu. */
+export declare function narrowData(data: EntryData, select: string[]): EntryData;
+/** Stabilny klucz cache dla `entriesMap` (kolejność `select` bez znaczenia). */
+export declare function populateConfigKey(cfg: EffectivePopulate): string;

package/dist/core/server/fields/populateSelect.js

@@ -0,0 +1,28 @@
+/**
+ * Rozwiąż precedencję chudej populacji dla pojedynczego pola relacji:
+ * call override > pole > kolekcja docelowa > null (pełna populacja).
+ */
+export function resolveEffectivePopulate(args) {
+    return args.callOverride ?? args.fieldPopulate ?? args.collectionDefault ?? null;
+}
+/** Zawęź listę definicji pól do wybranych slugów. */
+export function narrowFields(fields, select) {
+    const set = new Set(select);
+    return fields.filter((f) => set.has(f.slug));
+}
+/** Pick tylko wybranych kluczy z danych wpisu. */
+export function narrowData(data, select) {
+    const set = new Set(select);
+    const out = {};
+    for (const k of Object.keys(data)) {
+        if (set.has(k))
+            out[k] = data[k];
+    }
+    return out;
+}
+/** Stabilny klucz cache dla `entriesMap` (kolejność `select` bez znaczenia). */
+export function populateConfigKey(cfg) {
+    if (!cfg)
+        return 'FULL';
+    return JSON.stringify({ select: cfg.select ? [...cfg.select].sort() : undefined, depth: cfg.depth });
+}

package/dist/core/server/fields/resolveRelationFields.d.ts

@@ -1,13 +1,13 @@
-import type { EntryData, PopulatedEntryData, DbEntryVersion } from '../../../types/entries.js';
+import type { EntryData, PopulatedEntryData } from '../../../types/entries.js';
 import type { Field } from '../../../types/fields.js';
 import type { PopulateCtx, ResolveStatus } from '../entries/operations/resolveEntry.js';
 /**
- * Version of a *related* entry to populate. Exported for tests.
- *
- * `draft` falls back to the published version: a related entry that has never been
- * drafted (only published versions) must still resolve, otherwise draft previews
- * silently drop every relation to `null` — see preview.remote.ts, which populates
- * form data with `status: 'draft'`.
+ * Wersja *populowanej relacji*: draft zawsze z fallbackiem na published — relacja,
+ * która nigdy nie była szkicowana (tylko published), musi się rozwiązać, inaczej
+ * podgląd szkicu cicho zeruje każdą relację (patrz preview.remote.ts). Eksport dla testów.
  */
-export declare function pickVersion(versions: DbEntryVersion[], status: ResolveStatus): DbEntryVersion | null;
+export declare function pickVersion<T extends {
+    versionNumber: number;
+    publishedAt: Date | null;
+}>(versions: T[], status: ResolveStatus): T | null;
 export declare function resolveRelationFields(data: EntryData, fields: Field[], ctx: PopulateCtx): Promise<PopulatedEntryData>;