includio-cms 0.18.0 → 0.20.0

package/dist/ai-claude/index.js

@@ -1,14 +1,29 @@
 import { getCMS } from '../core/cms.js';
-import Anthropic from '@anthropic-ai/sdk';
 import sharp from 'sharp';
+/**
+ * Anthropic Claude AI adapter for `generateAltText`.
+ *
+ * `@anthropic-ai/sdk` is an **optional peer dependency** — install it in your
+ * project (`pnpm add @anthropic-ai/sdk`) when using this adapter. SDK loads
+ * lazily on first call; missing peer throws a clear error.
+ *
+ * @public
+ */
 export function claudeAdapter(config) {
     let client = null;
-    function getClient() {
-        if (!client) {
-            if (!config.apiKey)
-                throw new Error('AI_CLAUDE_API_KEY is not set');
-            client = new Anthropic({ apiKey: config.apiKey });
+    async function getClient() {
+        if (client)
+            return client;
+        if (!config.apiKey)
+            throw new Error('AI_CLAUDE_API_KEY is not set');
+        let Anthropic;
+        try {
+            Anthropic = (await import('@anthropic-ai/sdk')).default;
         }
+        catch {
+            throw new Error('@anthropic-ai/sdk is required for claudeAdapter — install it with `pnpm add @anthropic-ai/sdk`');
+        }
+        client = new Anthropic({ apiKey: config.apiKey });
         return client;
     }
     return {
@@ -29,7 +44,8 @@ export function claudeAdapter(config) {
             const pngBuffer = await sharp(fileBuffer).png().toBuffer();
             const imageBase64 = pngBuffer.toString('base64');
             const prompt = `Generate a concise and descriptive alt text for the following image file in polish language. The alt text should accurately describe the content and context of the image, be no longer than 125 characters, and avoid using phrases like "image of" or "picture of". Return only the alt text, nothing else.`;
-            const message = await getClient().messages.create({
+            const anthropic = await getClient();
+            const message = await anthropic.messages.create({
                 model: 'claude-haiku-4-5-20251001',
                 max_tokens: 256,
                 messages: [

package/dist/ai-openai/index.d.ts

@@ -1,2 +1,11 @@
 import type { AIAdapter, AIConfig } from '../types/adapters/ai.js';
+/**
+ * OpenAI AI adapter for `generateAltText`.
+ *
+ * `openai` is an **optional peer dependency** — install it in your project
+ * (`pnpm add openai`) when using this adapter. SDK loads lazily on first call;
+ * missing peer throws a clear error.
+ *
+ * @public
+ */
 export declare function openAIAdapter(config: AIConfig): AIAdapter;

package/dist/ai-openai/index.js

@@ -1,12 +1,32 @@
 import { getCMS } from '../core/cms.js';
-import OpenAI from 'openai';
-import { zodResponseFormat } from 'openai/helpers/zod.mjs';
 import z from 'zod';
 import sharp from 'sharp';
+/**
+ * OpenAI AI adapter for `generateAltText`.
+ *
+ * `openai` is an **optional peer dependency** — install it in your project
+ * (`pnpm add openai`) when using this adapter. SDK loads lazily on first call;
+ * missing peer throws a clear error.
+ *
+ * @public
+ */
 export function openAIAdapter(config) {
-    const openai = new OpenAI({
-        apiKey: config.apiKey
-    });
+    let openai = null;
+    let zodResponseFormat = null;
+    async function getClient() {
+        if (openai && zodResponseFormat)
+            return { client: openai, zodResponseFormat };
+        let OpenAI;
+        try {
+            OpenAI = (await import('openai')).default;
+            zodResponseFormat = (await import('openai/helpers/zod.mjs')).zodResponseFormat;
+        }
+        catch {
+            throw new Error('openai is required for openAIAdapter — install it with `pnpm add openai`');
+        }
+        openai = new OpenAI({ apiKey: config.apiKey });
+        return { client: openai, zodResponseFormat };
+    }
     return {
         generateAltText: async (fileId) => {
             const altTextSchema = z.object({
@@ -24,13 +44,12 @@ export function openAIAdapter(config) {
             if (!file) {
                 throw new Error('File not found');
             }
-            // Konwertuj plik na PNG używając Sharp i przekonwertuj na base64
             const fileBuffer = Buffer.from(await file.arrayBuffer());
             const pngBuffer = await sharp(fileBuffer).png().toBuffer();
             const imageBase64 = pngBuffer.toString('base64');
             const prompt = `Generate a concise and descriptive alt text for the following image file in polish language. The alt text should accurately describe the content and context of the image, be no longer than 125 characters, and avoid using phrases like "image of" or "picture of".`;
-            const completion = await openai.chat.completions.parse({
-                // model: 'gpt-4.1-nano',
+            const { client, zodResponseFormat: zrf } = await getClient();
+            const completion = await client.chat.completions.parse({
                 model: 'gpt-4o',
                 messages: [
                     {
@@ -49,7 +68,7 @@ export function openAIAdapter(config) {
                         ]
                     }
                 ],
-                response_format: zodResponseFormat(altTextSchema, 'response')
+                response_format: zrf(altTextSchema, 'response')
             });
             const response = completion.choices[0].message;
             if (!response.parsed) {

package/dist/components/ui/input-group/input-group-input.svelte.d.ts

@@ -2,7 +2,7 @@ declare const InputGroupInput: import("svelte").Component<(Omit<import("svelte/e
     type: "file";
     files?: FileList;
 } | {
-    type?: "number" | "image" | "url" | "text" | "date" | "radio" | "color" | "button" | "checkbox" | "search" | (string & {}) | "email" | "time" | "password" | "hidden" | "reset" | "submit" | "tel" | "datetime-local" | "month" | "range" | "week";
+    type?: "number" | "image" | "url" | "text" | "date" | "radio" | "color" | "button" | "checkbox" | "search" | (string & {}) | "email" | "password" | "time" | "hidden" | "reset" | "submit" | "tel" | "datetime-local" | "month" | "range" | "week";
     files?: undefined;
 })) & {
     ref?: HTMLElement | null | undefined;

package/dist/components/ui/sidebar/sidebar-input.svelte.d.ts

@@ -2,7 +2,7 @@ declare const SidebarInput: import("svelte").Component<(Omit<import("svelte/elem
     type: "file";
     files?: FileList;
 } | {
-    type?: "number" | "image" | "url" | "text" | "date" | "radio" | "color" | "button" | "checkbox" | "search" | (string & {}) | "email" | "time" | "password" | "hidden" | "reset" | "submit" | "tel" | "datetime-local" | "month" | "range" | "week";
+    type?: "number" | "image" | "url" | "text" | "date" | "radio" | "color" | "button" | "checkbox" | "search" | (string & {}) | "email" | "password" | "time" | "hidden" | "reset" | "submit" | "tel" | "datetime-local" | "month" | "range" | "week";
     files?: undefined;
 })) & {
     ref?: HTMLElement | null | undefined;

package/dist/core/cms.d.ts

@@ -38,4 +38,8 @@ export declare class CMS implements ICMS {
     getFormBySlug(slug: string): FormConfig;
 }
 export declare function initCMS(config: CMSConfig): CMS;
+/**
+ * Returns the singleton CMS instance. Must be called after `includioCMS()` initializes the CMS in `hooks.server.ts`.
+ * @public
+ */
 export declare function getCMS(): CMS;

package/dist/core/cms.js

@@ -159,6 +159,10 @@ export function initCMS(config) {
         .catch((e) => console.warn('[cms] Failed to start background maintenance:', e));
     return cms;
 }
+/**
+ * Returns the singleton CMS instance. Must be called after `includioCMS()` initializes the CMS in `hooks.server.ts`.
+ * @public
+ */
 export function getCMS() {
     if (!cms) {
         throw new Error('CMS not initialized. Call initCMS() first with your CMS config.');

package/dist/core/index.d.ts

@@ -1,2 +1,4 @@
 export { getCMS } from './cms.js';
 export { resolveMediaWithStyles, type ResolvedMedia } from './server/fields/utils/resolveMedia.js';
+export { createEntityAPI } from '../entity/index.js';
+export { getAuth } from '../server/auth.js';

package/dist/core/index.js

@@ -1,2 +1,4 @@
 export { getCMS } from './cms.js';
 export { resolveMediaWithStyles } from './server/fields/utils/resolveMedia.js';
+export { createEntityAPI } from '../entity/index.js';
+export { getAuth } from '../server/auth.js';

package/dist/core/server/consentLogs/operations/create.d.ts

@@ -1,2 +1,6 @@
 import type { ConsentLogData } from '../../../../types/consent.js';
+/**
+ * Persists a CMP consent log entry via the database adapter.
+ * @public
+ */
 export declare const createConsentLog: (data: ConsentLogData) => Promise<void>;

package/dist/core/server/consentLogs/operations/create.js

@@ -1,4 +1,8 @@
 import { getCMS } from '../../../cms.js';
+/**
+ * Persists a CMP consent log entry via the database adapter.
+ * @public
+ */
 export const createConsentLog = async (data) => {
     await getCMS().databaseAdapter.createConsentLog(data);
 };

package/dist/core/server/fields/utils/resolveMedia.d.ts

@@ -1,12 +1,15 @@
 import type { ImageFieldStyle } from '../../../../types/fields.js';
 import type { ImageStyle, MediaFile } from '../../../../types/media.js';
+/**
+ * @public
+ */
 export interface ResolvedMedia {
     data: MediaFile;
     styles: Record<string, ImageStyle>;
     blurDataUrl: string | null;
 }
 /**
- * Resolve media files by IDs and generate image styles.
- * Useful for plugins that need to resolve media references (e.g. photo-grid).
+ * Resolve media files by IDs and generate image styles. Useful for plugins resolving media references (e.g. photo-grid).
+ * @public
  */
 export declare function resolveMediaWithStyles(mediaIds: string[], styles?: ImageFieldStyle[]): Promise<Record<string, ResolvedMedia>>;

package/dist/core/server/fields/utils/resolveMedia.js

@@ -1,8 +1,8 @@
 import { getCMS } from '../../../cms.js';
 import { getImageStyles } from './imageStyles.js';
 /**
- * Resolve media files by IDs and generate image styles.
- * Useful for plugins that need to resolve media references (e.g. photo-grid).
+ * Resolve media files by IDs and generate image styles. Useful for plugins resolving media references (e.g. photo-grid).
+ * @public
  */
 export async function resolveMediaWithStyles(mediaIds, styles) {
     if (!mediaIds.length)

package/dist/core/server/forms/submissions/operations/create.d.ts

@@ -1,7 +1,14 @@
+/**
+ * @public
+ */
 export interface CreateFormSubmissionOptions {
     slug: string;
     data: Record<string, unknown>;
     ip?: string;
     userAgent?: string;
 }
+/**
+ * Persists a form submission and triggers best-effort notification email. Returns `true` if the row was written (email failures are logged, do not affect return).
+ * @public
+ */
 export declare const createFormSubmission: (options: CreateFormSubmissionOptions) => Promise<boolean>;

package/dist/core/server/forms/submissions/operations/create.js

@@ -1,6 +1,10 @@
 import { getLocalizedLabel } from '../../../../../admin/utils/collectionLabel.js';
 import { getCMS } from '../../../../cms.js';
 import { generateZodSchemaFromFormFields } from '../../../../fields/formFieldSchemaToTs.js';
+/**
+ * Persists a form submission and triggers best-effort notification email. Returns `true` if the row was written (email failures are logged, do not affect return).
+ * @public
+ */
 export const createFormSubmission = async (options) => {
     const { slug, data, ip, userAgent } = options;
     const config = getCMS().getFormBySlug(slug);

package/dist/core/server/forms/submissions/utils/parseMultipart.d.ts

@@ -1,2 +1,6 @@
 import type { FormField } from '../../../../../types/formFields.js';
+/**
+ * Parses multipart `FormData` into a typed record of field values, handling file uploads via the configured files adapter.
+ * @public
+ */
 export declare function parseFormDataForSubmission(formData: FormData, fields: FormField[]): Promise<Record<string, unknown>>;

package/dist/core/server/forms/submissions/utils/parseMultipart.js

@@ -25,6 +25,10 @@ function validateMagicBytes(buffer, declaredMime) {
     }
     return false;
 }
+/**
+ * Parses multipart `FormData` into a typed record of field values, handling file uploads via the configured files adapter.
+ * @public
+ */
 export async function parseFormDataForSubmission(formData, fields) {
     const result = {};
     const fileFields = new Map(fields.filter((f) => f.type === 'file').map((f) => [f.slug, f]));

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

@@ -2,7 +2,13 @@ import { drizzle } from 'drizzle-orm/postgres-js';
 import type { Config } from './types.js';
 import * as schema from './schema/index.js';
 import type { DatabaseAdapter } from '../types/adapters/db.js';
+export * from './schema/index.js';
+export * from '../server/db/schema/auth-schema.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,13 @@ function buildMediaFileConditions(db, options) {
     }
     return conditions;
 }
+// Schema re-exports (folded from `./db-postgres/schema-core`, `./db-postgres/schema-shop`, `./auth-schema` in 0.20.0)
+export * from './schema/index.js';
+export * from '../server/db/schema/auth-schema.js';
+/**
+ * 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.d.ts

@@ -7,6 +7,10 @@ interface CreateOptions {
     skipValidation?: boolean;
     sortOrder?: number;
 }
+/**
+ * Creates a high-level Entity API (CRUD + publish/archive) bound to a CMS instance and a user.
+ * @public
+ */
 export declare function createEntityAPI(cms: CMS, opts?: EntityAPIOptions): {
     create(slug: string, data?: EntryData, options?: CreateOptions & {
         lang?: string;

package/dist/entity/index.js

@@ -1,6 +1,10 @@
 import { generateZodSchemaFromFields } from '../core/fields/fieldSchemaToTs.js';
 import { getFieldsFromConfig } from '../core/fields/layoutUtils.js';
 import { _getRawEntries as getRawEntries } from '../core/server/entries/operations/get.js';
+/**
+ * Creates a high-level Entity API (CRUD + publish/archive) bound to a CMS instance and a user.
+ * @public
+ */
 export function createEntityAPI(cms, opts) {
     const db = cms.databaseAdapter;
     const userId = opts?.userId ?? 'system';

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

@@ -1,7 +1,12 @@
 import type { FilesAdapter } from '../types/adapters/files.js';
+/** @internal */
 export declare const fullDir: string;
 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

@@ -9,6 +9,7 @@ import { processVideo, setFfmpegPaths } from './video.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 global.__dirname = __dirname ?? '';
+/** @internal */
 export const fullDir = process.env.NODE_ENV === 'production' ? `/data/uploads` : `./static/uploads`;
 const privateDir = process.env.NODE_ENV === 'production' ? `/data/private-uploads` : `./data/private-uploads`;
 async function ensureDir(dir) {
@@ -19,6 +20,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/index.d.ts

@@ -1,4 +1,2 @@
-export * from './admin/index.js';
-export type * from './admin/index.js';
 export * from './core/index.js';
 export type * from './core/index.js';

package/dist/index.js

@@ -1,2 +1 @@
-export * from './admin/index.js';
 export * from './core/index.js';

package/dist/server/auth.d.ts

@@ -1 +1,5 @@
+/**
+ * Returns the underlying `better-auth` instance from the initialized CMS.
+ * @public
+ */
 export declare function getAuth(): import("better-auth", { with: { "resolution-mode": "require" } }).Auth<import("better-auth", { with: { "resolution-mode": "require" } }).BetterAuthOptions>;

package/dist/server/auth.js

@@ -1,4 +1,8 @@
 import { getCMS } from '../core/cms.js';
+/**
+ * Returns the underlying `better-auth` instance from the initialized CMS.
+ * @public
+ */
 export function getAuth() {
     return getCMS().auth;
 }

package/dist/shop/client/index.d.ts

@@ -125,3 +125,7 @@ export declare function createShopClient(options?: ShopClientOptions): ShopClien
 export type { CartSnapshot, CartLine, CartItemRef } from '../cart/types.js';
 export { createOrderState } from './use-order.svelte.js';
 export type { OrderState, CreateOrderStateOptions, OrderPaymentPhase } from './use-order.svelte.js';
+export { default as OrderStatus } from '../svelte/OrderStatus.svelte';
+export { default as InpostPicker } from '../svelte/InpostPicker.svelte';
+export { DEFAULT_LABELS_PL } from '../svelte/labels.js';
+export type { OrderStatusLabels } from '../svelte/labels.js';

package/dist/shop/client/index.js

@@ -47,3 +47,7 @@ function tokenQuery(token) {
     return token ? `?token=${encodeURIComponent(token)}` : '';
 }
 export { createOrderState } from './use-order.svelte.js';
+// Folded from `./shop/svelte` (dropped as separate export in 0.20.0)
+export { default as OrderStatus } from '../svelte/OrderStatus.svelte';
+export { default as InpostPicker } from '../svelte/InpostPicker.svelte';
+export { DEFAULT_LABELS_PL } from '../svelte/labels.js';

package/dist/sveltekit/config.d.ts

@@ -12,9 +12,29 @@ type SingleInput = Omit<SingleConfig, 'fields'> & {
     fields: Field[];
     layout?: Layout;
 };
+/**
+ * Defines the root CMS configuration. Pass to `includioCMS()` in `hooks.server.ts`.
+ * @public
+ */
 export declare function defineConfig(config: CMSConfig): CMSConfig;
+/**
+ * Defines a collection (multi-entry content type).
+ * @public
+ */
 export declare function defineCollection(config: CollectionInput): CollectionConfig;
+/**
+ * Defines a singleton (single-entry content type, e.g. site settings).
+ * @public
+ */
 export declare function defineSingle(config: SingleInput): SingleConfig;
+/**
+ * Defines a public form (submitted via `/api/forms/[slug]/submit`).
+ * @public
+ */
 export declare function defineForm(config: FormConfig): FormConfig;
+/**
+ * Defines a reusable object field (nested record). Use inside `fields[]`.
+ * @public
+ */
 export declare function defineObject(config: Omit<ObjectField, 'type'>): ObjectField;
 export {};

package/dist/sveltekit/config.js

@@ -1,15 +1,35 @@
+/**
+ * Defines the root CMS configuration. Pass to `includioCMS()` in `hooks.server.ts`.
+ * @public
+ */
 export function defineConfig(config) {
     return config;
 }
+/**
+ * Defines a collection (multi-entry content type).
+ * @public
+ */
 export function defineCollection(config) {
     return config;
 }
+/**
+ * Defines a singleton (single-entry content type, e.g. site settings).
+ * @public
+ */
 export function defineSingle(config) {
     return config;
 }
+/**
+ * Defines a public form (submitted via `/api/forms/[slug]/submit`).
+ * @public
+ */
 export function defineForm(config) {
     return config;
 }
+/**
+ * Defines a reusable object field (nested record). Use inside `fields[]`.
+ * @public
+ */
 export function defineObject(config) {
     return { ...config, type: 'object' };
 }

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

@@ -1,3 +1,7 @@
 import { type Handle } from '@sveltejs/kit';
 import type { CMSConfig } from '../../types/cms.js';
+/**
+ * SvelteKit `Handle[]` array that initializes the CMS, generates runtime artifacts, wires auth/admin guards, and exposes `event.locals.cmsContext`. Compose with `sequence()` in `hooks.server.ts`.
+ * @public
+ */
 export declare function includioCMS(cmsConfig: CMSConfig): Handle[];

package/dist/sveltekit/server/handle.js

@@ -65,6 +65,10 @@ const detectBrowserContext = async ({ event, resolve }) => {
     };
     return resolve(event);
 };
+/**
+ * SvelteKit `Handle[]` array that initializes the CMS, generates runtime artifacts, wires auth/admin guards, and exposes `event.locals.cmsContext`. Compose with `sequence()` in `hooks.server.ts`.
+ * @public
+ */
 export function includioCMS(cmsConfig) {
     generateRuntime(cmsConfig); // Generate runtime code based on the CMS config
     initCMS(cmsConfig);

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

@@ -5,3 +5,4 @@ export { createFormSubmission } from '../../core/server/forms/submissions/operat
 export { parseFormDataForSubmission } from '../../core/server/forms/submissions/utils/parseMultipart.js';
 export { createConsentLog } from '../../core/server/consentLogs/operations/create.js';
 export { getPreviewEntry } from './preview.js';
+export { createRestApiHandler } from '../../admin/api/rest/handler.js';

package/dist/sveltekit/server/index.js

@@ -5,3 +5,5 @@ export { createFormSubmission } from '../../core/server/forms/submissions/operat
 export { parseFormDataForSubmission } from '../../core/server/forms/submissions/utils/parseMultipart.js';
 export { createConsentLog } from '../../core/server/consentLogs/operations/create.js';
 export { getPreviewEntry } from './preview.js';
+// Folded from `./admin/api/rest/handler` (dropped as separate export in 0.20.0)
+export { createRestApiHandler } from '../../admin/api/rest/handler.js';

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

@@ -1,4 +1,8 @@
 import type { RequestEvent } from '@sveltejs/kit';
+/**
+ * Returns `cmsContext` from `event.locals` for use in a SvelteKit layout `load`. Drop into your `+layout.server.ts`.
+ * @public
+ */
 export declare function cmsLayoutLoad(event: RequestEvent): {
     cmsContext: any;
 };

package/dist/sveltekit/server/layout.js

@@ -1,3 +1,7 @@
+/**
+ * Returns `cmsContext` from `event.locals` for use in a SvelteKit layout `load`. Drop into your `+layout.server.ts`.
+ * @public
+ */
 export function cmsLayoutLoad(event) {
     return {
         cmsContext: event.locals.cmsContext ?? {}

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

@@ -1,5 +1,9 @@
 import type { Entry } from '../../types/entries.js';
 import { type RequestEvent } from '@sveltejs/kit';
+/**
+ * Resolves the preview entry from a `?preview=<versionId>` query param. Requires an authenticated session — throws `Unauthorized` otherwise.
+ * @public
+ */
 export declare function getPreviewEntry(event: RequestEvent, options: {
     language: string;
 }): Promise<Entry | null>;

package/dist/sveltekit/server/preview.js

@@ -1,5 +1,9 @@
 import { getEntryVersion } from '../../core/server/entries/operations/get.js';
 import {} from '@sveltejs/kit';
+/**
+ * Resolves the preview entry from a `?preview=<versionId>` query param. Requires an authenticated session — throws `Unauthorized` otherwise.
+ * @public
+ */
 export async function getPreviewEntry(event, options) {
     const preview = event.url.searchParams.get('preview');
     if (!preview) {

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>;