includio-cms 0.16.0 → 0.19.0

package/dist/core/server/generator/generator.js

@@ -179,21 +179,21 @@ function generateAPI(config) {
     const filePath = join(cmsDir, 'api.ts');
     let code = `// This file is auto-generated. Do not edit directly.\n\n`;
     code += `
-	
+
 		import type { SingleEntryMap, SingleSlug, CollectionEntryMap, CollectionSlug, FormEntryMap, SiteLanguage } from './types';
-		import { getEntry, getEntries, countEntries, createFormSubmission } from 'includio-cms/sveltekit/server';
+		import { resolveEntry, resolveEntries, countEntries, createFormSubmission, type PopulateConfig } from 'includio-cms/sveltekit/server';
 
 	`;
     code += `
 
 		interface GetEntryOptions {
 			id?: string;
-			status?: 'draft' | 'published' | 'scheduled' | 'archived';
-			dataValues?: Record<string, unknown>;
+			status?: 'published' | 'draft' | 'scheduled';
+			populate?: PopulateConfig;
 		`;
     if (config.languages && config.languages.length > 0) {
         code += `
-			language?: SiteLanguage;
+			locale?: SiteLanguage;
 				`;
     }
     code += `
@@ -201,8 +201,11 @@ function generateAPI(config) {
 
 		interface GetEntriesOptions extends GetEntryOptions {
 			ids?: string[];
-			dataLike?: Record<string, unknown>;
-			dataILikeOr?: Record<string, unknown>;
+			filter?: {
+				dataValues?: Record<string, unknown>;
+				dataLike?: Record<string, unknown>;
+				dataILikeOr?: Record<string, unknown>;
+			};
 			orderBy?: { column: 'createdAt' | 'updatedAt' | 'sortOrder'; direction: 'asc' | 'desc' };
 			dataOrderBy?: { field: string; direction: 'asc' | 'desc' };
 			limit?: number;
@@ -213,25 +216,25 @@ function generateAPI(config) {
     code += `
 
 		export async function getSingleEntry<K extends SingleSlug>(slug: K, options: GetEntryOptions = {}): Promise<SingleEntryMap[K] | null> {
-			return (await getEntry({
-				slug,
+			return (await resolveEntry({
+				collection: slug,
 				...options
 			})) as unknown as SingleEntryMap[K] | null;
 		}
 
 		export async function getCollectionEntry<K extends CollectionSlug>(slug: K, options: GetEntryOptions = {}): Promise<CollectionEntryMap[K] | null> {
-			return (await getEntry({
-				slug,
+			return (await resolveEntry({
+				collection: slug,
 				...options
 			})) as unknown as CollectionEntryMap[K] | null;
 		}
 
 		export async function getCollectionEntries<K extends CollectionSlug>(slug: K, options: GetEntriesOptions = {}): Promise<CollectionEntryMap[K][]> {
-			return (await getEntries({ slug, ...options })) as unknown as CollectionEntryMap[K][];
+			return (await resolveEntries({ collection: slug, ...options })) as unknown as CollectionEntryMap[K][];
 		}
 
-		export async function countCollectionEntries<K extends CollectionSlug>(slug: K, options: Omit<GetEntriesOptions, 'limit' | 'offset' | 'orderBy'> = {}): Promise<number> {
-			return countEntries({ slug, ...options });
+		export async function countCollectionEntries<K extends CollectionSlug>(slug: K, options: Omit<GetEntriesOptions, 'limit' | 'offset' | 'orderBy' | 'populate'> = {}): Promise<number> {
+			return countEntries({ collection: slug, ...options });
 		}
 
 		${config.forms && config.forms.length > 0

package/dist/db-postgres/index.d.ts

@@ -5,4 +5,8 @@ import type { DatabaseAdapter } from '../types/adapters/db.js';
 export type DatabaseAdapterWithDrizzle = DatabaseAdapter & {
     _drizzle: ReturnType<typeof drizzle<typeof schema>>;
 };
+/**
+ * Postgres database adapter (drizzle + `postgres`).
+ * @public
+ */
 export declare function pg(config: Config): DatabaseAdapterWithDrizzle;

package/dist/db-postgres/index.js

@@ -262,6 +262,10 @@ function buildMediaFileConditions(db, options) {
     }
     return conditions;
 }
+/**
+ * Postgres database adapter (drizzle + `postgres`).
+ * @public
+ */
 export function pg(config) {
     const client = postgres(config.databaseUrl);
     const db = drizzle(client, { schema });

package/dist/email-nodemailer/index.d.ts

@@ -5,5 +5,14 @@ interface Options {
     defaultFromName: string;
     transportOptions: SMTPTransport.Options;
 }
+/**
+ * SMTP email adapter built on `nodemailer`.
+ *
+ * `nodemailer` is an **optional peer dependency** — install it in your project
+ * (`pnpm add nodemailer`) when using this adapter. The SDK loads lazily on first
+ * `sendMail()`; missing peer throws a clear error.
+ *
+ * @public
+ */
 export declare function nodemailerAdapter(options: Options): EmailAdapter;
 export {};

package/dist/email-nodemailer/index.js

@@ -1,14 +1,36 @@
-import { createTransport } from 'nodemailer';
+/**
+ * SMTP email adapter built on `nodemailer`.
+ *
+ * `nodemailer` is an **optional peer dependency** — install it in your project
+ * (`pnpm add nodemailer`) when using this adapter. The SDK loads lazily on first
+ * `sendMail()`; missing peer throws a clear error.
+ *
+ * @public
+ */
 export function nodemailerAdapter(options) {
-    const transporter = createTransport({
-        ...options.transportOptions,
-        from: `"${options.defaultFromName}" <${options.defaultFromAddress}>`
-    });
+    let transporter = null;
+    async function getTransporter() {
+        if (transporter)
+            return transporter;
+        let createTransport;
+        try {
+            ({ createTransport } = await import('nodemailer'));
+        }
+        catch {
+            throw new Error('nodemailer is required for nodemailerAdapter — install it with `pnpm add nodemailer`');
+        }
+        transporter = createTransport({
+            ...options.transportOptions,
+            from: `"${options.defaultFromName}" <${options.defaultFromAddress}>`
+        });
+        return transporter;
+    }
     return {
         defaultFromAddress: options.defaultFromAddress,
         defaultFromName: options.defaultFromName,
         sendMail: async (sendMailOptions) => {
-            await transporter.sendMail({
+            const t = await getTransporter();
+            await t.sendMail({
                 ...sendMailOptions,
                 from: `"${options.defaultFromName}" <${options.defaultFromAddress}>`
             });

package/dist/entity/index.js

@@ -1,6 +1,6 @@
 import { generateZodSchemaFromFields } from '../core/fields/fieldSchemaToTs.js';
 import { getFieldsFromConfig } from '../core/fields/layoutUtils.js';
-import { getRawEntries } from '../core/server/entries/operations/get.js';
+import { _getRawEntries as getRawEntries } from '../core/server/entries/operations/get.js';
 export function createEntityAPI(cms, opts) {
     const db = cms.databaseAdapter;
     const userId = opts?.userId ?? 'system';

package/dist/files-local/index.d.ts

@@ -4,4 +4,8 @@ export interface LocalFilesConfig {
     ffmpegPath?: string;
     ffprobePath?: string;
 }
+/**
+ * Local-disk files adapter. Stores uploads under `./static/uploads` (dev) or `/data/uploads` (prod).
+ * @public
+ */
 export declare function local(config?: LocalFilesConfig): FilesAdapter;

package/dist/files-local/index.js

@@ -19,6 +19,10 @@ async function ensureDir(dir) {
         // Already exists
     }
 }
+/**
+ * Local-disk files adapter. Stores uploads under `./static/uploads` (dev) or `/data/uploads` (prod).
+ * @public
+ */
 export function local(config) {
     if (config?.ffmpegPath || config?.ffprobePath) {
         setFfmpegPaths(config.ffmpegPath, config.ffprobePath);

package/dist/paraglide/messages/_index.d.ts

@@ -1,36 +1,3 @@
-export function hello_world(inputs: {
-    name: NonNullable<unknown>;
-}, options?: {
-    locale?: "en" | "pl";
-}): string;
-/**
-* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
-*
-* - Changing this function will be over-written by the next build.
-*
-* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
-* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
-*
-* @param {{}} inputs
-* @param {{ locale?: "en" | "pl" }} options
-* @returns {string}
-*/
-declare function login_hello(inputs?: {}, options?: {
-    locale?: "en" | "pl";
-}): string;
-/**
-* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
-*
-* - Changing this function will be over-written by the next build.
-*
-* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
-* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
-*
-* @param {{}} inputs
-* @param {{ locale?: "en" | "pl" }} options
-* @returns {string}
-*/
-declare function login_please_login(inputs?: {}, options?: {
-    locale?: "en" | "pl";
-}): string;
-export { login_hello as login.hello, login_please_login as login.please_login };
+export * from "./hello_world.js";
+export * from "./login_hello.js";
+export * from "./login_please_login.js";

package/dist/paraglide/messages/_index.js

@@ -1,72 +1,4 @@
 /* eslint-disable */
-import { getLocale, trackMessageCall, experimentalMiddlewareLocaleSplitting, isServer } from "../runtime.js"
-import * as en from "./en.js"
-import * as pl from "./pl.js"
-/**
-* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
-*
-* - Changing this function will be over-written by the next build.
-*
-* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
-* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
-* 
-* @param {{ name: NonNullable<unknown> }} inputs
-* @param {{ locale?: "en" | "pl" }} options
-* @returns {string}
-*/
-/* @__NO_SIDE_EFFECTS__ */
-export const hello_world = (inputs, options = {}) => {
-	if (experimentalMiddlewareLocaleSplitting && isServer === false) {
-		return /** @type {any} */ (globalThis).__paraglide_ssr.hello_world(inputs) 
-	}
-	const locale = options.locale ?? getLocale()
-	trackMessageCall("hello_world", locale)
-	if (locale === "en") return en.hello_world(inputs)
-	return pl.hello_world(inputs)
-};
-/**
-* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
-*
-* - Changing this function will be over-written by the next build.
-*
-* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
-* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
-* 
-* @param {{}} inputs
-* @param {{ locale?: "en" | "pl" }} options
-* @returns {string}
-*/
-/* @__NO_SIDE_EFFECTS__ */
-const login_hello = (inputs = {}, options = {}) => {
-	if (experimentalMiddlewareLocaleSplitting && isServer === false) {
-		return /** @type {any} */ (globalThis).__paraglide_ssr.login_hello(inputs) 
-	}
-	const locale = options.locale ?? getLocale()
-	trackMessageCall("login_hello", locale)
-	if (locale === "en") return en.login_hello(inputs)
-	return pl.login_hello(inputs)
-};
-export { login_hello as "login.hello" }
-/**
-* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
-*
-* - Changing this function will be over-written by the next build.
-*
-* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
-* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
-* 
-* @param {{}} inputs
-* @param {{ locale?: "en" | "pl" }} options
-* @returns {string}
-*/
-/* @__NO_SIDE_EFFECTS__ */
-const login_please_login = (inputs = {}, options = {}) => {
-	if (experimentalMiddlewareLocaleSplitting && isServer === false) {
-		return /** @type {any} */ (globalThis).__paraglide_ssr.login_please_login(inputs) 
-	}
-	const locale = options.locale ?? getLocale()
-	trackMessageCall("login_please_login", locale)
-	if (locale === "en") return en.login_please_login(inputs)
-	return pl.login_please_login(inputs)
-};
-export { login_please_login as "login.please_login" }
+export * from './hello_world.js'
+export * from './login_hello.js'
+export * from './login_please_login.js'

package/dist/paraglide/messages/hello_world.d.ts

@@ -0,0 +1,5 @@
+export function hello_world(inputs: {
+    name: NonNullable<unknown>;
+}, options?: {
+    locale?: "en" | "pl";
+}): string;

package/dist/paraglide/messages/hello_world.js

@@ -0,0 +1,33 @@
+/* eslint-disable */
+import { getLocale, trackMessageCall, experimentalMiddlewareLocaleSplitting, isServer } from '../runtime.js';
+
+const en_hello_world = /** @type {(inputs: { name: NonNullable<unknown> }) => string} */ (i) => {
+	return `Hello, ${i.name} from en!`
+};
+
+const pl_hello_world = /** @type {(inputs: { name: NonNullable<unknown> }) => string} */ (i) => {
+	return `Hello, ${i.name} from pl!`
+};
+
+/**
+* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
+*
+* - Changing this function will be over-written by the next build.
+*
+* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
+* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
+* 
+* @param {{ name: NonNullable<unknown> }} inputs
+* @param {{ locale?: "en" | "pl" }} options
+* @returns {string}
+*/
+/* @__NO_SIDE_EFFECTS__ */
+export const hello_world = (inputs, options = {}) => {
+	if (experimentalMiddlewareLocaleSplitting && isServer === false) {
+		return /** @type {any} */ (globalThis).__paraglide_ssr.hello_world(inputs) 
+	}
+	const locale = options.locale ?? getLocale()
+	trackMessageCall("hello_world", locale)
+	if (locale === "en") return en_hello_world(inputs)
+	return pl_hello_world(inputs)
+};

package/dist/paraglide/messages/login_hello.d.ts

@@ -0,0 +1,16 @@
+export { login_hello as login.hello };
+/**
+* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
+*
+* - Changing this function will be over-written by the next build.
+*
+* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
+* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
+*
+* @param {{}} inputs
+* @param {{ locale?: "en" | "pl" }} options
+* @returns {string}
+*/
+declare function login_hello(inputs?: {}, options?: {
+    locale?: "en" | "pl";
+}): string;

package/dist/paraglide/messages/login_hello.js

@@ -0,0 +1,34 @@
+/* eslint-disable */
+import { getLocale, trackMessageCall, experimentalMiddlewareLocaleSplitting, isServer } from '../runtime.js';
+
+const en_login_hello = /** @type {(inputs: {}) => string} */ () => {
+	return `Welcome back`
+};
+
+const pl_login_hello = /** @type {(inputs: {}) => string} */ () => {
+	return `Witaj ponownie`
+};
+
+/**
+* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
+*
+* - Changing this function will be over-written by the next build.
+*
+* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
+* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
+* 
+* @param {{}} inputs
+* @param {{ locale?: "en" | "pl" }} options
+* @returns {string}
+*/
+/* @__NO_SIDE_EFFECTS__ */
+const login_hello = (inputs = {}, options = {}) => {
+	if (experimentalMiddlewareLocaleSplitting && isServer === false) {
+		return /** @type {any} */ (globalThis).__paraglide_ssr.login_hello(inputs) 
+	}
+	const locale = options.locale ?? getLocale()
+	trackMessageCall("login_hello", locale)
+	if (locale === "en") return en_login_hello(inputs)
+	return pl_login_hello(inputs)
+};
+export { login_hello as "login.hello" }

package/dist/paraglide/messages/login_please_login.d.ts

@@ -0,0 +1,16 @@
+export { login_please_login as login.please_login };
+/**
+* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
+*
+* - Changing this function will be over-written by the next build.
+*
+* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
+* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
+*
+* @param {{}} inputs
+* @param {{ locale?: "en" | "pl" }} options
+* @returns {string}
+*/
+declare function login_please_login(inputs?: {}, options?: {
+    locale?: "en" | "pl";
+}): string;

package/dist/paraglide/messages/login_please_login.js

@@ -0,0 +1,34 @@
+/* eslint-disable */
+import { getLocale, trackMessageCall, experimentalMiddlewareLocaleSplitting, isServer } from '../runtime.js';
+
+const en_login_please_login = /** @type {(inputs: {}) => string} */ () => {
+	return `Login to your account`
+};
+
+const pl_login_please_login = /** @type {(inputs: {}) => string} */ () => {
+	return `Zaloguj się na swoje konto`
+};
+
+/**
+* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
+*
+* - Changing this function will be over-written by the next build.
+*
+* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
+* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
+* 
+* @param {{}} inputs
+* @param {{ locale?: "en" | "pl" }} options
+* @returns {string}
+*/
+/* @__NO_SIDE_EFFECTS__ */
+const login_please_login = (inputs = {}, options = {}) => {
+	if (experimentalMiddlewareLocaleSplitting && isServer === false) {
+		return /** @type {any} */ (globalThis).__paraglide_ssr.login_please_login(inputs) 
+	}
+	const locale = options.locale ?? getLocale()
+	trackMessageCall("login_please_login", locale)
+	if (locale === "en") return en_login_please_login(inputs)
+	return pl_login_please_login(inputs)
+};
+export { login_please_login as "login.please_login" }

package/dist/shop/server/populate.d.ts

@@ -1,4 +1,5 @@
 import type { Field } from '../../types/fields.js';
+import type { PopulateCtx } from '../../core/server/entries/operations/resolveEntry.js';
 export interface PopulatedShopField {
     /** Netto w PLN (number, ≤6dp). Od 0.15.2. */
     basePrice: number;
@@ -14,4 +15,4 @@ export interface PopulatedShopField {
         attributes: Record<string, string> | null;
     }>;
 }
-export declare function resolveShopFields(data: Record<string, unknown>, fields: Field[], entryId: string | undefined): Promise<Record<string, unknown>>;
+export declare function resolveShopFields(data: Record<string, unknown>, fields: Field[], ctx: PopulateCtx): Promise<Record<string, unknown>>;

package/dist/shop/server/populate.js

@@ -15,7 +15,8 @@ function toPopulated(row) {
         }))
     };
 }
-export async function resolveShopFields(data, fields, entryId) {
+export async function resolveShopFields(data, fields, ctx) {
+    const entryId = ctx.entryId;
     if (!entryId)
         return data;
     // Skip if shop is not configured

package/dist/sveltekit/server/index.d.ts

@@ -1,6 +1,6 @@
 export { includioCMS } from './handle.js';
 export { cmsLayoutLoad } from './layout.js';
-export { getEntry, getEntries, countEntries } from '../../core/server/entries/operations/get.js';
+export { resolveEntry, resolveEntries, countEntries, type ResolveEntryOptions, type ResolveEntriesOptions, type CountEntriesOptions, type PopulateConfig, type ResolveStatus } from '../../core/server/entries/operations/resolveEntry.js';
 export { createFormSubmission } from '../../core/server/forms/submissions/operations/create.js';
 export { parseFormDataForSubmission } from '../../core/server/forms/submissions/utils/parseMultipart.js';
 export { createConsentLog } from '../../core/server/consentLogs/operations/create.js';

package/dist/sveltekit/server/index.js

@@ -1,6 +1,6 @@
 export { includioCMS } from './handle.js';
 export { cmsLayoutLoad } from './layout.js';
-export { getEntry, getEntries, countEntries } from '../../core/server/entries/operations/get.js';
+export { resolveEntry, resolveEntries, countEntries } from '../../core/server/entries/operations/resolveEntry.js';
 export { createFormSubmission } from '../../core/server/forms/submissions/operations/create.js';
 export { parseFormDataForSubmission } from '../../core/server/forms/submissions/utils/parseMultipart.js';
 export { createConsentLog } from '../../core/server/consentLogs/operations/create.js';

package/dist/types/adapters/ai.d.ts

@@ -1,11 +1,19 @@
+/** @public */
 export interface AIConfig {
     apiKey: string;
 }
+/** @public */
 export type AIAdapterConfig = {
     config: AIConfig;
     adapter: (config: AIConfig, db: AIAdapter) => AIAdapter;
 };
+/**
+ * Contract for AI adapters. Currently powers `generateAltText` (admin media UI).
+ * Default implementations: `includio-cms/ai-openai`, `includio-cms/ai-claude`.
+ * @public
+ */
 export interface AIAdapter {
     generateAltText: GenerateAltText;
 }
+/** @public */
 export type GenerateAltText = (fileId: string) => Promise<string>;

package/dist/types/adapters/db.d.ts

@@ -4,6 +4,15 @@ import type { ImageFieldStyle } from '../fields.js';
 import type { FormSubmission } from '../forms.js';
 import type { ImageStyle, MediaFile, MediaTag, UploadedMediaFile, VideoStyle, VideoStyleStatus } from '../media.js';
 export type { FilesAdapter } from './files.js';
+/**
+ * Contract for database adapters. Drives entries, versions, media, tags, form submissions,
+ * consent logs, and image/video styles. Default implementation: `includio-cms/db-postgres`.
+ *
+ * To build a custom adapter, implement every required method (optionals are marked `?`).
+ * See README — "Writing your own adapter".
+ *
+ * @public
+ */
 export interface DatabaseAdapter {
     createEntry: CreateEntry;
     getEntries: GetEntries;

package/dist/types/adapters/email.d.ts

@@ -1,4 +1,10 @@
+/** @public */
 export type EmailAdapterFactory = () => EmailAdapter;
+/**
+ * Contract for email adapters. Used by `better-auth` reset-password flow and form submission
+ * notifications. Default implementation: `includio-cms/email-nodemailer`.
+ * @public
+ */
 export interface EmailAdapter {
     sendMail: SendMail;
     defaultFromAddress: string;

package/dist/types/adapters/files.d.ts

@@ -1,4 +1,9 @@
 import type { UploadedMediaFile } from '../media.js';
+/**
+ * Contract for file storage adapters. Used by media upload pipeline + private file flow
+ * (e.g. shop receipts). Default implementation: `includio-cms/files-local`.
+ * @public
+ */
 export interface FilesAdapter {
     downloadFile: DownloadFile;
     uploadFile: UploadFile;

package/dist/types/plugins.d.ts

@@ -2,6 +2,7 @@ import type { Component } from 'svelte';
 import type { z } from 'zod';
 import type { RawEntry } from './entries.js';
 import type { CustomField } from './fields.js';
+import type { PopulateCtx } from '../core/server/entries/operations/resolveEntry.js';
 export interface CustomFieldDefinition {
     /** Unique field type slug, e.g. 'photo-grid' */
     fieldType: string;
@@ -13,8 +14,11 @@ export interface CustomFieldDefinition {
     zodSchema: (field: CustomField, languages: string[]) => z.ZodType;
     /** TypeScript type string for codegen */
     tsType?: string;
-    /** Populate/resolve step for API output */
-    populateResolver?: (value: unknown, field: CustomField) => Promise<unknown>;
+    /**
+     * Populate/resolve step for API output.
+     * @experimental ctx (3rd arg) added in 0.17.0 — carries locale/status/depth/visited cascade.
+     */
+    populateResolver?: (value: unknown, field: CustomField, ctx: PopulateCtx) => Promise<unknown>;
 }
 export interface PluginConfig {
     slug: string;

package/dist/updates/0.18.0/index.d.ts

@@ -0,0 +1,2 @@
+import type { CmsUpdate } from '../index.js';
+export declare const update: CmsUpdate;