includio-cms 0.7.0 → 0.7.1

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to includio-cms are documented here.
 Generated from `src/lib/updates/` — do not edit manually.
 
+## 0.7.1 — 2026-03-13
+
+Custom fields plugin system, pathTemplate, admin public API
+
+### Added
+- Custom fields plugin system — type definition, zod/TS codegen, field renderer, populate resolver
+- pathTemplate support — configurable URL paths for collections/singles
+- Admin public exports: admin/helpers (useField, contexts) & admin/ui (shadcn primitives, MediaSelector)
+- resolveMediaWithStyles utility — resolve media files with image styles
+
+### Fixed
+- Schema serialization type cast fix (stricter TS)
+- Core svelte export condition added to package.json
+
 ## 0.7.0 — 2026-03-11
 
 Auth core refactor & design system alignment

package/ROADMAP.md

@@ -155,6 +155,14 @@
 - [x] `[fix]` `[P2]` Blocks field accordion: rounded borders, card background
 - [x] `[fix]` `[P2]` Media file miniature: reset img/svg margins
 
+## 0.7.1 — Custom fields & admin DX
+
+- [x] `[feature]` `[P0]` Custom fields plugin system — type, zod/TS codegen, field renderer, populate resolver
+- [x] `[feature]` `[P1]` pathTemplate — configurable URL paths for collections/singles
+- [x] `[feature]` `[P1]` Admin public exports: admin/helpers & admin/ui for plugin authors
+- [x] `[feature]` `[P2]` resolveMediaWithStyles utility & core svelte export
+- [x] `[fix]` `[P1]` Schema serialization type cast (stricter TS compatibility)
+
 ## 0.8.0 — SEO module
 
 - [ ] `[feature]` `[P1]` SERP preview + character limits for title/description <!-- files: src/lib/admin/components/fields/seo-field.svelte -->

package/dist/admin/client/admin/admin-layout.svelte

@@ -3,12 +3,16 @@
 	import '../../styles/admin.css';
 	import { Toaster } from '../../../components/ui/sonner/index.js';
 	import { MediaSort, setMediaSort } from '../../state/media-sort.svelte.js';
+	import { setCustomFields } from '../../state/custom-fields.svelte.js';
+	import type { CustomFieldDefinition } from '../../../types/plugins.js';
 	import AdminPreloader from './admin-preloader.svelte';
 	import { onMount } from 'svelte';
 
 	setMediaSort(new MediaSort());
 
-	let { children }: { children: Snippet } = $props();
+	let { children, customFields }: { children: Snippet; customFields?: Map<string, CustomFieldDefinition> } = $props();
+
+	setCustomFields(customFields ?? new Map());
 
 	let mounted = $state(false);
 	onMount(() => {

package/dist/admin/client/admin/admin-layout.svelte.d.ts

@@ -1,7 +1,9 @@
 import type { Snippet } from 'svelte';
 import '../../styles/admin.css';
+import type { CustomFieldDefinition } from '../../../types/plugins.js';
 type $$ComponentProps = {
     children: Snippet;
+    customFields?: Map<string, CustomFieldDefinition>;
 };
 declare const AdminLayout: import("svelte").Component<$$ComponentProps, {}, "">;
 type AdminLayout = ReturnType<typeof AdminLayout>;

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

@@ -10,3 +10,4 @@ export { default as FormSubmissionPage } from './form/form-submission/form-submi
 export { default as UsersPage } from './users/users-page.svelte';
 export { default as AcceptInvitePage } from './users/accept-invite-page.svelte';
 export { default as MaintenancePage } from './maintenance/maintenance-page.svelte';
+export { default as MediaSelector } from '../components/media/media-selector.svelte';

package/dist/admin/client/index.js

@@ -10,3 +10,4 @@ export { default as FormSubmissionPage } from './form/form-submission/form-submi
 export { default as UsersPage } from './users/users-page.svelte';
 export { default as AcceptInvitePage } from './users/accept-invite-page.svelte';
 export { default as MaintenancePage } from './maintenance/maintenance-page.svelte';
+export { default as MediaSelector } from '../components/media/media-selector.svelte';

package/dist/admin/components/fields/field-renderer.svelte

@@ -16,6 +16,7 @@
 	import LazyField from './lazy-field.svelte';
 	import { useInterfaceLanguage } from '../../state/interface-language.svelte.js';
 	import { getLocalizedLabel } from '../../utils/collectionLabel.js';
+	import { getCustomFields } from '../../state/custom-fields.svelte.js';
 
 	type Props = {
 		objectFieldType?: 'default' | 'inline';
@@ -31,6 +32,7 @@
 	let { field, form, path, objectFieldType = 'default', focusedPath = null, flashingPath = null, depth = 0, distributed = false, ...props }: Props = $props();
 
 	const interfaceLanguage = useInterfaceLanguage();
+	const customFieldDefs = getCustomFields();
 
 	// Bridge: SuperForm store → $bindable for leaf components
 	// Cast to any: runtime types enforced by child components via $bindable
@@ -159,6 +161,13 @@
 						<DateTimeField {field} bind:value={$value} />
 					{:else if field.type === 'select'}
 						<SelectField {field} bind:value={$value} />
+					{:else if field.type === 'custom'}
+						{@const customDef = customFieldDefs.get(field.fieldType)}
+						{#if customDef}
+							<LazyField loader={customDef.component} props={{ field, form, path }} skeletonClass="h-20" />
+						{:else}
+							<p>Nieznany custom field: {field.fieldType}</p>
+						{/if}
 					{:else}
 						<p>Nieobsługiwany typ pola: {field.type}</p>
 					{/if}

package/dist/admin/helpers/build-custom-fields-map.d.ts

@@ -0,0 +1,7 @@
+import type { PluginConfig } from '../../types/plugins.js';
+import type { CustomFieldDefinition } from '../../types/plugins.js';
+/**
+ * Build a Map<fieldType, CustomFieldDefinition> from plugin configs.
+ * Use in consumer's admin layout to pass customFields to AdminLayout.
+ */
+export declare function buildCustomFieldsMap(...plugins: PluginConfig[]): Map<string, CustomFieldDefinition>;

package/dist/admin/helpers/build-custom-fields-map.js

@@ -0,0 +1,13 @@
+/**
+ * Build a Map<fieldType, CustomFieldDefinition> from plugin configs.
+ * Use in consumer's admin layout to pass customFields to AdminLayout.
+ */
+export function buildCustomFieldsMap(...plugins) {
+    const map = new Map();
+    for (const p of plugins) {
+        for (const f of p.fields ?? []) {
+            map.set(f.fieldType, f);
+        }
+    }
+    return map;
+}

package/dist/admin/helpers/index.d.ts

@@ -0,0 +1,7 @@
+export { useField } from './use-field.js';
+export { buildCustomFieldsMap } from './build-custom-fields-map.js';
+export { useInterfaceLanguage } from '../state/interface-language.svelte.js';
+export { getContentLanguage } from '../state/content-language.svelte.js';
+export { getRemotes } from '../context/remotes.js';
+export { getCustomFields } from '../state/custom-fields.svelte.js';
+export { getLocalizedLabel } from '../utils/collectionLabel.js';

package/dist/admin/helpers/index.js

@@ -0,0 +1,7 @@
+export { useField } from './use-field.js';
+export { buildCustomFieldsMap } from './build-custom-fields-map.js';
+export { useInterfaceLanguage } from '../state/interface-language.svelte.js';
+export { getContentLanguage } from '../state/content-language.svelte.js';
+export { getRemotes } from '../context/remotes.js';
+export { getCustomFields } from '../state/custom-fields.svelte.js';
+export { getLocalizedLabel } from '../utils/collectionLabel.js';

package/dist/admin/helpers/use-field.d.ts

@@ -0,0 +1,26 @@
+import { type SuperForm, type FormPathLeaves } from 'sveltekit-superforms';
+/**
+ * Simplified wrapper around sveltekit-superforms' formFieldProxy.
+ * Plugin authors don't need to know the superforms API.
+ */
+export declare function useField(form: SuperForm<Record<string, unknown>>, path: FormPathLeaves<Record<string, unknown>>): {
+    value: {
+        subscribe: (this: void, run: import("svelte/store").Subscriber<unknown>, invalidate?: () => void) => import("svelte/store").Unsubscriber;
+        set(this: void, value: unknown, options?: {
+            taint?: import("sveltekit-superforms").TaintOption;
+        }): void;
+        update(this: void, updater: import("svelte/store").Updater<unknown>, options?: {
+            taint?: import("sveltekit-superforms").TaintOption;
+        }): void;
+    };
+    errors: import("svelte/store").Writable<string[] | undefined>;
+    constraints: import("svelte/store").Writable<Partial<{
+        pattern: string;
+        min: number | string;
+        max: number | string;
+        required: boolean;
+        step: number | "any";
+        minlength: number;
+        maxlength: number;
+    }> | undefined>;
+};

package/dist/admin/helpers/use-field.js

@@ -0,0 +1,9 @@
+import { formFieldProxy } from 'sveltekit-superforms';
+/**
+ * Simplified wrapper around sveltekit-superforms' formFieldProxy.
+ * Plugin authors don't need to know the superforms API.
+ */
+export function useField(form, path) {
+    const { value, errors, constraints } = formFieldProxy(form, path);
+    return { value, errors, constraints };
+}

package/dist/admin/state/custom-fields.svelte.d.ts

@@ -0,0 +1,3 @@
+import type { CustomFieldDefinition } from '../../types/plugins.js';
+export declare function setCustomFields(defs: Map<string, CustomFieldDefinition>): void;
+export declare function getCustomFields(): Map<string, CustomFieldDefinition>;

package/dist/admin/state/custom-fields.svelte.js

@@ -0,0 +1,10 @@
+import { getContext, setContext } from 'svelte';
+import { setSchemaCustomFields } from '../../core/fields/fieldSchemaToTs.js';
+const contextKey = Symbol('customFields');
+export function setCustomFields(defs) {
+    setContext(contextKey, defs);
+    setSchemaCustomFields(defs);
+}
+export function getCustomFields() {
+    return getContext(contextKey) ?? new Map();
+}

package/dist/admin/ui/index.d.ts

@@ -0,0 +1,12 @@
+export { Button, type ButtonProps } from '../../components/ui/button/index.js';
+export * as Dialog from '../../components/ui/dialog/index.js';
+export { Input } from '../../components/ui/input/index.js';
+export * as Card from '../../components/ui/card/index.js';
+export { Label } from '../../components/ui/label/index.js';
+export { Separator } from '../../components/ui/separator/index.js';
+export { Badge } from '../../components/ui/badge/index.js';
+export { Skeleton } from '../../components/ui/skeleton/index.js';
+export * as Tabs from '../../components/ui/tabs/index.js';
+export * as Tooltip from '../../components/ui/tooltip/index.js';
+export { default as FileMiniature } from '../components/media/file/file-miniature.svelte';
+export { default as MediaSelector } from '../components/media/media-selector.svelte';

package/dist/admin/ui/index.js

@@ -0,0 +1,14 @@
+// shadcn-svelte UI primitives
+export { Button } from '../../components/ui/button/index.js';
+export * as Dialog from '../../components/ui/dialog/index.js';
+export { Input } from '../../components/ui/input/index.js';
+export * as Card from '../../components/ui/card/index.js';
+export { Label } from '../../components/ui/label/index.js';
+export { Separator } from '../../components/ui/separator/index.js';
+export { Badge } from '../../components/ui/badge/index.js';
+export { Skeleton } from '../../components/ui/skeleton/index.js';
+export * as Tabs from '../../components/ui/tabs/index.js';
+export * as Tooltip from '../../components/ui/tooltip/index.js';
+// Admin components
+export { default as FileMiniature } from '../components/media/file/file-miniature.svelte';
+export { default as MediaSelector } from '../components/media/media-selector.svelte';

package/dist/components/ui/accordion/accordion.svelte.d.ts

@@ -1,4 +1,4 @@
 import { Accordion as AccordionPrimitive } from "bits-ui";
-declare const Accordion: import("svelte").Component<AccordionPrimitive.RootProps, {}, "ref" | "value">;
+declare const Accordion: import("svelte").Component<AccordionPrimitive.RootProps, {}, "value" | "ref">;
 type Accordion = ReturnType<typeof Accordion>;
 export default Accordion;

package/dist/components/ui/calendar/calendar.svelte.d.ts

@@ -16,6 +16,6 @@ type $$ComponentProps = WithoutChildrenOrChild<CalendarPrimitive.RootProps> & {
         outsideMonth: boolean;
     }]>;
 };
-declare const Calendar: import("svelte").Component<$$ComponentProps, {}, "ref" | "value" | "placeholder">;
+declare const Calendar: import("svelte").Component<$$ComponentProps, {}, "value" | "ref" | "placeholder">;
 type Calendar = ReturnType<typeof Calendar>;
 export default Calendar;

package/dist/components/ui/command/command-dialog.svelte.d.ts

@@ -7,6 +7,6 @@ type $$ComponentProps = WithoutChildrenOrChild<DialogPrimitive.RootProps> & With
     title?: string;
     description?: string;
 };
-declare const CommandDialog: import("svelte").Component<$$ComponentProps, {}, "ref" | "value" | "open">;
+declare const CommandDialog: import("svelte").Component<$$ComponentProps, {}, "value" | "ref" | "open">;
 type CommandDialog = ReturnType<typeof CommandDialog>;
 export default CommandDialog;

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

@@ -1,4 +1,4 @@
 import { Command as CommandPrimitive } from "bits-ui";
-declare const CommandInput: import("svelte").Component<CommandPrimitive.InputProps, {}, "ref" | "value">;
+declare const CommandInput: import("svelte").Component<CommandPrimitive.InputProps, {}, "value" | "ref">;
 type CommandInput = ReturnType<typeof CommandInput>;
 export default CommandInput;

package/dist/components/ui/command/command.svelte.d.ts

@@ -3,6 +3,6 @@ export type CommandRootApi = CommandPrimitive.Root;
 type $$ComponentProps = CommandPrimitive.RootProps & {
     api?: CommandRootApi | null;
 };
-declare const Command: import("svelte").Component<$$ComponentProps, {}, "ref" | "value" | "api">;
+declare const Command: import("svelte").Component<$$ComponentProps, {}, "value" | "ref" | "api">;
 type Command = ReturnType<typeof Command>;
 export default Command;

package/dist/components/ui/dropdown-menu/dropdown-menu-radio-group.svelte.d.ts

@@ -1,4 +1,4 @@
 import { DropdownMenu as DropdownMenuPrimitive } from "bits-ui";
-declare const DropdownMenuRadioGroup: import("svelte").Component<DropdownMenuPrimitive.RadioGroupProps, {}, "ref" | "value">;
+declare const DropdownMenuRadioGroup: import("svelte").Component<DropdownMenuPrimitive.RadioGroupProps, {}, "value" | "ref">;
 type DropdownMenuRadioGroup = ReturnType<typeof DropdownMenuRadioGroup>;
 export default DropdownMenuRadioGroup;

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

@@ -8,6 +8,6 @@ type Props = WithElementRef<Omit<HTMLInputAttributes, "type"> & ({
     type?: InputType;
     files?: undefined;
 })>;
-declare const Input: import("svelte").Component<Props, {}, "files" | "ref" | "value">;
+declare const Input: import("svelte").Component<Props, {}, "files" | "value" | "ref">;
 type Input = ReturnType<typeof Input>;
 export default Input;

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

@@ -2,10 +2,10 @@ 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" | "password" | "hidden" | "reset" | "time" | "submit" | "tel" | "datetime-local" | "month" | "range" | "week";
+    type?: "number" | "image" | "url" | "text" | "date" | "radio" | "color" | "button" | "checkbox" | "search" | (string & {}) | "email" | "time" | "password" | "hidden" | "reset" | "submit" | "tel" | "datetime-local" | "month" | "range" | "week";
     files?: undefined;
 })) & {
     ref?: HTMLElement | null | undefined;
-}, {}, "ref" | "value">;
+}, {}, "value" | "ref">;
 type InputGroupInput = ReturnType<typeof InputGroupInput>;
 export default InputGroupInput;

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

@@ -1,3 +1,3 @@
-declare const InputGroupTextarea: import("svelte").Component<Omit<import("../../../utils.js").WithElementRef<import("svelte/elements").HTMLTextareaAttributes>, "children">, {}, "ref" | "value">;
+declare const InputGroupTextarea: import("svelte").Component<Omit<import("../../../utils.js").WithElementRef<import("svelte/elements").HTMLTextareaAttributes>, "children">, {}, "value" | "ref">;
 type InputGroupTextarea = ReturnType<typeof InputGroupTextarea>;
 export default InputGroupTextarea;

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

@@ -1,4 +1,4 @@
 import { RadioGroup as RadioGroupPrimitive } from "bits-ui";
-declare const RadioGroup: import("svelte").Component<RadioGroupPrimitive.RootProps, {}, "ref" | "value">;
+declare const RadioGroup: import("svelte").Component<RadioGroupPrimitive.RootProps, {}, "value" | "ref">;
 type RadioGroup = ReturnType<typeof RadioGroup>;
 export default RadioGroup;

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

@@ -2,10 +2,10 @@ 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" | "password" | "hidden" | "reset" | "time" | "submit" | "tel" | "datetime-local" | "month" | "range" | "week";
+    type?: "number" | "image" | "url" | "text" | "date" | "radio" | "color" | "button" | "checkbox" | "search" | (string & {}) | "email" | "time" | "password" | "hidden" | "reset" | "submit" | "tel" | "datetime-local" | "month" | "range" | "week";
     files?: undefined;
 })) & {
     ref?: HTMLElement | null | undefined;
-}, {}, "ref" | "value">;
+}, {}, "value" | "ref">;
 type SidebarInput = ReturnType<typeof SidebarInput>;
 export default SidebarInput;

package/dist/components/ui/tabs/tabs.svelte.d.ts

@@ -1,4 +1,4 @@
 import { Tabs as TabsPrimitive } from "bits-ui";
-declare const Tabs: import("svelte").Component<TabsPrimitive.RootProps, {}, "ref" | "value">;
+declare const Tabs: import("svelte").Component<TabsPrimitive.RootProps, {}, "value" | "ref">;
 type Tabs = ReturnType<typeof Tabs>;
 export default Tabs;

package/dist/components/ui/textarea/textarea.svelte.d.ts

@@ -1,5 +1,5 @@
 import { type WithElementRef } from "../../../utils.js";
 import type { HTMLTextareaAttributes } from "svelte/elements";
-declare const Textarea: import("svelte").Component<Omit<WithElementRef<HTMLTextareaAttributes>, "children">, {}, "ref" | "value">;
+declare const Textarea: import("svelte").Component<Omit<WithElementRef<HTMLTextareaAttributes>, "children">, {}, "value" | "ref">;
 type Textarea = ReturnType<typeof Textarea>;
 export default Textarea;

package/dist/components/ui/toggle-group/toggle-group-item.svelte.d.ts

@@ -1,6 +1,6 @@
 import { ToggleGroup as ToggleGroupPrimitive } from "bits-ui";
 import { type ToggleVariants } from "../toggle/index.js";
 type $$ComponentProps = ToggleGroupPrimitive.ItemProps & ToggleVariants;
-declare const ToggleGroupItem: import("svelte").Component<$$ComponentProps, {}, "ref" | "value">;
+declare const ToggleGroupItem: import("svelte").Component<$$ComponentProps, {}, "value" | "ref">;
 type ToggleGroupItem = ReturnType<typeof ToggleGroupItem>;
 export default ToggleGroupItem;

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

@@ -3,6 +3,6 @@ export declare function setToggleGroupCtx(props: ToggleVariants): void;
 export declare function getToggleGroupCtx(): ToggleVariants;
 import { ToggleGroup as ToggleGroupPrimitive } from "bits-ui";
 type $$ComponentProps = ToggleGroupPrimitive.RootProps & ToggleVariants;
-declare const ToggleGroup: import("svelte").Component<$$ComponentProps, {}, "ref" | "value">;
+declare const ToggleGroup: import("svelte").Component<$$ComponentProps, {}, "value" | "ref">;
 type ToggleGroup = ReturnType<typeof ToggleGroup>;
 export default ToggleGroup;

package/dist/core/cms.d.ts

@@ -4,7 +4,7 @@ import type { ApiKeyConfig, AuthConfig, CMSConfig, ICMS, MediaConfig } from '../
 import type { CollectionConfigWithType } from '../types/collections.js';
 import type { Language } from '../types/languages.js';
 import type { SingleConfigWithType } from '../types/singles.js';
-import type { PluginConfig } from '../types/plugins.js';
+import type { CustomFieldDefinition, PluginConfig } from '../types/plugins.js';
 import type { FormConfig } from '../types/forms.js';
 import type { AIAdapter } from '../types/adapters/ai.js';
 import type { EmailAdapter } from '../types/adapters/email.js';
@@ -23,6 +23,7 @@ export declare class CMS implements ICMS {
     languages: Language[];
     mediaConfig: MediaConfig;
     plugins: PluginConfig[];
+    customFields: Map<string, CustomFieldDefinition>;
     apiKeys: ApiKeyConfig[];
     constructor(config: CMSConfig);
     get auth(): ReturnType<typeof betterAuth>;

package/dist/core/cms.js

@@ -1,3 +1,4 @@
+import { setSchemaGetCMS } from './fields/fieldSchemaToTs.js';
 import { betterAuth } from 'better-auth';
 import { drizzleAdapter } from 'better-auth/adapters/drizzle';
 import { admin } from 'better-auth/plugins';
@@ -17,6 +18,7 @@ export class CMS {
     languages;
     mediaConfig;
     plugins = [];
+    customFields = new Map();
     apiKeys = [];
     constructor(config) {
         this.config = config;
@@ -50,7 +52,16 @@ export class CMS {
         this.apiKeys = config.apiKeys || [];
         if (config.plugins) {
             this.plugins = config.plugins;
+            for (const plugin of this.plugins) {
+                for (const def of plugin.fields ?? []) {
+                    if (this.customFields.has(def.fieldType)) {
+                        throw new Error(`Duplicate custom field type: "${def.fieldType}" (plugin: "${plugin.slug}")`);
+                    }
+                    this.customFields.set(def.fieldType, def);
+                }
+            }
         }
+        setSchemaGetCMS(() => this);
     }
     get auth() {
         if (!this._betterAuth) {

package/dist/core/fields/fieldSchemaToTs.d.ts

@@ -1,5 +1,16 @@
 import type { Field } from '../../types/fields.js';
+import type { CustomFieldDefinition } from '../../types/plugins.js';
 import { z } from 'zod';
+/**
+ * Set custom fields map for client-side use (where getCMS() is unavailable).
+ */
+export declare function setSchemaCustomFields(customFields: Map<string, CustomFieldDefinition>): void;
+/**
+ * Set CMS getter for server-side use (avoids static import of server-only cms.ts).
+ */
+export declare function setSchemaGetCMS(getter: () => {
+    customFields: Map<string, CustomFieldDefinition>;
+}): void;
 type AnyZodObject = z.ZodObject<any, any>;
 interface GenerateZodSchemaOptions {
     parentRequired?: boolean;

package/dist/core/fields/fieldSchemaToTs.js

@@ -1,4 +1,28 @@
 import { z } from 'zod';
+let _customFieldsOverride = null;
+/**
+ * Set custom fields map for client-side use (where getCMS() is unavailable).
+ */
+export function setSchemaCustomFields(customFields) {
+    _customFieldsOverride = customFields;
+}
+let _getCMS = null;
+/**
+ * Set CMS getter for server-side use (avoids static import of server-only cms.ts).
+ */
+export function setSchemaGetCMS(getter) {
+    _getCMS = getter;
+}
+function getCustomFieldDef(fieldType) {
+    if (_customFieldsOverride)
+        return _customFieldsOverride.get(fieldType);
+    try {
+        return _getCMS?.().customFields.get(fieldType);
+    }
+    catch {
+        return undefined;
+    }
+}
 export function generateZodSchemaFromField(field, languages, options = {
     parentRequired: true
 }) {
@@ -283,6 +307,12 @@ export function generateZodSchemaFromField(field, languages, options = {
             }
             return schema;
         }
+        case 'custom': {
+            const customDef = getCustomFieldDef(field.fieldType);
+            if (!customDef)
+                return z.any();
+            return customDef.zodSchema(field, languages);
+        }
         default:
             return z.any();
     }

package/dist/core/index.d.ts

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

package/dist/core/index.js

@@ -1 +1,2 @@
 export { getCMS } from './cms.js';
+export { resolveMediaWithStyles } from './server/fields/utils/resolveMedia.js';

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

@@ -4,6 +4,7 @@ import { resolveMediaFields } from './resolveImageFields.js';
 import { resolveRelationFields } from './resolveRelationFields.js';
 import { resolveRichtextLinks } from './resolveRichtextLinks.js';
 import { resolveUrlFields } from './resolveUrlFields.js';
+import { getCMS } from '../../cms.js';
 function translateInlineBlockData(data, fields, language) {
     for (const field of fields) {
         const val = data[field.slug];
@@ -45,11 +46,60 @@ function translateInlineBlockData(data, fields, language) {
         }
     }
 }
+async function resolveCustomFields(data, fields) {
+    // Check if any custom fields exist before accessing CMS
+    const hasCustom = fields.some((f) => f.type === 'custom' ||
+        f.type === 'object' ||
+        f.type === 'blocks');
+    if (!hasCustom)
+        return data;
+    let cms;
+    try {
+        cms = getCMS();
+    }
+    catch {
+        return data;
+    }
+    const result = { ...data };
+    for (const field of fields) {
+        const val = data[field.slug];
+        switch (field.type) {
+            case 'custom': {
+                const def = cms.customFields.get(field.fieldType);
+                if (def?.populateResolver && val != null) {
+                    result[field.slug] = await def.populateResolver(val, field);
+                }
+                break;
+            }
+            case 'object':
+                if (val && typeof val === 'object' && 'data' in val) {
+                    result[field.slug] = {
+                        ...val,
+                        data: await resolveCustomFields(val.data, field.fields)
+                    };
+                }
+                break;
+            case 'blocks':
+                if (Array.isArray(val)) {
+                    result[field.slug] = await Promise.all(val.map(async (item) => {
+                        const blockDef = field.of.find((d) => d.slug === item.slug);
+                        if (blockDef) {
+                            return { ...item, data: await resolveCustomFields(item.data, blockDef.fields) };
+                        }
+                        return item;
+                    }));
+                }
+                break;
+        }
+    }
+    return result;
+}
 export async function populateEntryData(data, fields, language) {
     let populatedData = await resolveRelationFields(data, fields, language);
     populatedData = await resolveUrlFields(populatedData, fields, language);
     populatedData = await resolveMediaFields(populatedData, fields);
     populatedData = await resolveRichtextLinks(populatedData, fields, language);
+    populatedData = (await resolveCustomFields(populatedData, fields));
     populatedData = translateObject(populatedData, language);
     translateInlineBlockData(populatedData, fields, language);
     return populatedData;

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

@@ -1,6 +1,6 @@
 import { getCMS } from '../../cms.js';
 import { extractEntryIds as extractEntryIdsFromDoc, extractMediaIds as extractMediaIdsFromDoc, cloneDoc, walkLinkMarks, walkInlineBlockNodes } from '../../../admin/components/tiptap/structured-content-utils.js';
-import { getEntrySlugPath, getSlugFromEntryData } from './slugResolver.js';
+import { getEntrySlugPath, getSlugFromEntryData, getEntryPath } from './slugResolver.js';
 const ENTRY_ID_RE = /data-entry-id="([0-9a-f-]{36})"/g;
 function extractEntryIds(html) {
     const ids = [];
@@ -130,7 +130,8 @@ export async function resolveRichtextLinks(data, fields, language) {
         const slugPath = configSlug ? getEntrySlugPath(configSlug) : 'seo.slug';
         const slug = getSlugFromEntryData(rawData, slugPath, language);
         if (slug) {
-            slugMap[version.entryId] = slug;
+            const configSlug = entryConfigSlugMap[version.entryId];
+            slugMap[version.entryId] = configSlug ? getEntryPath(configSlug, slug) : slug;
         }
     }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any

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

@@ -1,7 +1,7 @@
 import { urlFieldDataSchema, urlFieldDataWithRelationSchema } from '../../../schemas/field/url.js';
 import { walkInlineBlockNodes, cloneDoc } from '../../../admin/components/tiptap/structured-content-utils.js';
 import { getDbEntries, getDbEntryVersions } from '../entries/operations/get.js';
-import { getEntrySlugPath, getSlugFromEntryData } from './slugResolver.js';
+import { getEntrySlugPath, getSlugFromEntryData, getEntryPath } from './slugResolver.js';
 import { isExternalUrl, mergeRel } from '../../fields/urlUtils.js';
 const FLAT_KEY = '_flat';
 /**
@@ -121,7 +121,7 @@ export async function resolveUrlFields(data, fields, language) {
                 const slugPath = getEntrySlugPath(entry.slug);
                 const slug = getSlugFromEntryData(version.data, slugPath, language);
                 if (slug)
-                    slugMap[entry.id] = slug;
+                    slugMap[entry.id] = getEntryPath(entry.slug, slug);
             }
         }
     }

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

@@ -8,3 +8,8 @@ export declare function getEntrySlugPath(configSlug: string): string;
  * Handles both plain strings and localized objects { lang: string }.
  */
 export declare function getSlugFromEntryData(data: Record<string, unknown>, slugPath: string, language?: string): string | undefined;
+/**
+ * Build full entry path using collection's pathTemplate.
+ * If no template configured, returns the raw slug.
+ */
+export declare function getEntryPath(configSlug: string, slug: string): string;

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

@@ -32,3 +32,19 @@ export function getSlugFromEntryData(data, slugPath, language) {
     }
     return undefined;
 }
+/**
+ * Build full entry path using collection's pathTemplate.
+ * If no template configured, returns the raw slug.
+ */
+export function getEntryPath(configSlug, slug) {
+    try {
+        const config = getCMS().getBySlug(configSlug);
+        if (config.pathTemplate) {
+            return config.pathTemplate.replace('{slug}', slug);
+        }
+    }
+    catch {
+        // Config not found — fall through
+    }
+    return slug;
+}

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

@@ -0,0 +1,12 @@
+import type { ImageFieldStyle } from '../../../../types/fields.js';
+import type { ImageStyle, MediaFile } from '../../../../types/media.js';
+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).
+ */
+export declare function resolveMediaWithStyles(mediaIds: string[], styles?: ImageFieldStyle[]): Promise<Record<string, ResolvedMedia>>;

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

@@ -0,0 +1,23 @@
+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).
+ */
+export async function resolveMediaWithStyles(mediaIds, styles) {
+    if (!mediaIds.length)
+        return {};
+    const cms = getCMS();
+    const files = await cms.databaseAdapter.getMediaFiles({ data: { ids: mediaIds } });
+    // Synthetic ImageField to pass to getImageStyles
+    const syntheticField = {
+        type: 'image',
+        slug: '_resolved',
+        styles: styles ?? []
+    };
+    const entries = await Promise.all(files.map(async (file) => {
+        const { styles: resolvedStyles, blurDataUrl } = await getImageStyles(syntheticField, file);
+        return [file.id, { data: file, styles: resolvedStyles, blurDataUrl }];
+    }));
+    return Object.fromEntries(entries);
+}

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

@@ -1,2 +1,4 @@
 import type { Field } from '../../../types/fields.js';
+import type { CustomFieldDefinition } from '../../../types/plugins.js';
+export declare function setGeneratorCustomFields(customFields: Map<string, CustomFieldDefinition>): void;
 export declare function generateTsTypeFromFields(fields: Field[]): string;

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

@@ -1,4 +1,8 @@
 import { toPascalCase } from './utils.js';
+let _customFields = new Map();
+export function setGeneratorCustomFields(customFields) {
+    _customFields = customFields;
+}
 function getFieldTypeAsString(field) {
     switch (field.type) {
         case 'text':
@@ -82,6 +86,10 @@ function getFieldTypeAsString(field) {
                 urlParts.push('newTab?: boolean');
             return `{ ${urlParts.join('; ')} }`;
         }
+        case 'custom': {
+            const customDef = _customFields.get(field.fieldType);
+            return customDef?.tsType ?? 'unknown';
+        }
         default:
             return 'any';
     }

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

@@ -1,6 +1,6 @@
 import { mkdirSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { generateTsTypeFromFields } from './fields.js';
+import { generateTsTypeFromFields, setGeneratorCustomFields } from './fields.js';
 import { generateTsTypeFromFormFields } from './formFields.js';
 import { generateZodSchemaStringFromFormFieldsAsString } from './formFieldSchemaToString.js';
 import { toPascalCase } from './utils.js';
@@ -203,6 +203,14 @@ function generateRemote(config) {
     writeFileSync(filePath, code);
 }
 export function generateRuntime(config) {
+    // Build custom fields map from plugins for type generation
+    const customFields = new Map();
+    for (const plugin of config.plugins ?? []) {
+        for (const field of plugin.fields ?? []) {
+            customFields.set(field.fieldType, field);
+        }
+    }
+    setGeneratorCustomFields(customFields);
     createCmsRuntimeDir();
     generateTypes(config);
     generateAPI(config);

package/dist/sveltekit/index.d.ts

@@ -1,5 +1,6 @@
 export * from './config.js';
 export { setRemotes, getRemotes } from '../admin/context/remotes.js';
+export { setCustomFields, getCustomFields } from '../admin/state/custom-fields.svelte.js';
 export { default as Preview } from './components/preview.svelte';
 export { default as HybridTarget } from './components/hybrid-target.svelte';
 export { default as Image } from './components/image.svelte';

package/dist/sveltekit/index.js

@@ -1,5 +1,6 @@
 export * from './config.js';
 export { setRemotes, getRemotes } from '../admin/context/remotes.js';
+export { setCustomFields, getCustomFields } from '../admin/state/custom-fields.svelte.js';
 export { default as Preview } from './components/preview.svelte';
 export { default as HybridTarget } from './components/hybrid-target.svelte';
 export { default as Image } from './components/image.svelte';

package/dist/types/cms.d.ts

@@ -3,7 +3,7 @@ import type { FilesAdapter } from './adapters/files.js';
 import type { CollectionConfig, CollectionConfigWithType } from './collections.js';
 import type { Language } from './languages.js';
 import type { SingleConfig, SingleConfigWithType } from './singles.js';
-import type { PluginConfig } from './plugins.js';
+import type { CustomFieldDefinition, PluginConfig } from './plugins.js';
 import type { FormConfig } from './forms.js';
 import type { AIAdapter } from './adapters/ai.js';
 import type { EmailAdapter } from './adapters/email.js';
@@ -60,6 +60,7 @@ export interface ICMS {
     emailAdapter: EmailAdapter | null;
     authConfig: AuthConfig | null;
     plugins: PluginConfig[];
+    customFields: Map<string, CustomFieldDefinition>;
     aiAdapter: AIAdapter | null;
     mediaConfig: MediaConfig;
     apiKeys: ApiKeyConfig[];

package/dist/types/config.d.ts

@@ -8,4 +8,5 @@ export interface ConfigBase {
     fields: Field[];
     layout?: Layout;
     slugField?: string;
+    pathTemplate?: string;
 }

package/dist/types/fields.d.ts

@@ -2,7 +2,7 @@ import type { FormatEnum } from 'sharp';
 import type { ImageStyle, MediaFile } from './media.js';
 import type { Localized } from './languages.js';
 import type { StructuredContentDoc } from './structured-content.js';
-export type FieldType = 'text' | 'richtext' | 'content' | 'number' | 'boolean' | 'date' | 'datetime' | 'file' | 'image' | 'media' | 'select' | 'radio' | 'checkboxes' | 'relation' | 'object' | 'array' | 'blocks' | 'slug' | 'seo' | 'url';
+export type FieldType = 'text' | 'richtext' | 'content' | 'number' | 'boolean' | 'date' | 'datetime' | 'file' | 'image' | 'media' | 'select' | 'radio' | 'checkboxes' | 'relation' | 'object' | 'array' | 'blocks' | 'slug' | 'seo' | 'url' | 'custom';
 export interface FieldCondition {
     field: string;
     equals?: string | string[];
@@ -204,4 +204,11 @@ export type UrlFieldData = {
     newTab?: boolean;
     rel?: string;
 };
-export type Field = TextField | RichtextField | ContentField | NumberField | BooleanField | DateField | DateTimeField | FileField | ImageField | MediaField | SelectField | RadioField | CheckboxesField | RelationField | ObjectField | ArrayField | BlocksField | SlugField | SeoField | UrlField;
+export interface CustomField extends BaseField {
+    type: 'custom';
+    /** Matches CustomFieldDefinition.fieldType from a plugin */
+    fieldType: string;
+    /** Plugin-specific configuration, opaque to core */
+    config?: Record<string, unknown>;
+}
+export type Field = TextField | RichtextField | ContentField | NumberField | BooleanField | DateField | DateTimeField | FileField | ImageField | MediaField | SelectField | RadioField | CheckboxesField | RelationField | ObjectField | ArrayField | BlocksField | SlugField | SeoField | UrlField | CustomField;

package/dist/types/index.d.ts

@@ -10,5 +10,6 @@ export { type SingleConfig } from './singles.js';
 export { type FormConfig, type FormSubmission } from './forms.js';
 export { type FormField, type FormFieldType, type FormBaseField, type FormTextField, type FormEmailField, type FormTextareaField, type FormCheckboxField, type FormSelectField } from './formFields.js';
 export { type CMSConfig, type ApiKeyConfig, type AuthConfig } from './cms.js';
+export { type PluginConfig, type CustomFieldDefinition } from './plugins.js';
 export { type Language, type Localized } from './languages.js';
 export { type Layout, type LayoutNode, type LayoutPreset, type LayoutNodeType, type ColumnRatio, type SectionNode, type ColumnsNode, type CardNode, type AccordionNode, type StackNode } from './layout.js';

package/dist/types/index.js

@@ -10,5 +10,6 @@ export {} from './singles.js';
 export {} from './forms.js';
 export {} from './formFields.js';
 export {} from './cms.js';
+export {} from './plugins.js';
 export {} from './languages.js';
 export {} from './layout.js';

package/dist/types/plugins.d.ts

@@ -1,7 +1,25 @@
+import type { Component } from 'svelte';
+import type { z } from 'zod';
 import type { RawEntry } from './entries.js';
+import type { CustomField } from './fields.js';
+export interface CustomFieldDefinition {
+    /** Unique field type slug, e.g. 'photo-grid' */
+    fieldType: string;
+    /** Lazy-loaded Svelte component for admin UI */
+    component: () => Promise<{
+        default: Component<any>;
+    }>;
+    /** Zod schema factory — called with (field, languages) */
+    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>;
+}
 export interface PluginConfig {
     slug: string;
-    hooks: {
+    fields?: CustomFieldDefinition[];
+    hooks?: {
         beforeCreate?: (data: Record<string, unknown>) => Promise<void>;
         afterCreate?: (entry: RawEntry) => Promise<void>;
         beforeUpdate?: (id: string, data: Record<string, unknown>) => Promise<void>;

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

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

package/dist/updates/0.7.1/index.js

@@ -0,0 +1,16 @@
+export const update = {
+    version: '0.7.1',
+    date: '2026-03-13',
+    description: 'Custom fields plugin system, pathTemplate, admin public API',
+    features: [
+        'Custom fields plugin system — type definition, zod/TS codegen, field renderer, populate resolver',
+        'pathTemplate support — configurable URL paths for collections/singles',
+        'Admin public exports: admin/helpers (useField, contexts) & admin/ui (shadcn primitives, MediaSelector)',
+        'resolveMediaWithStyles utility — resolve media files with image styles'
+    ],
+    fixes: [
+        'Schema serialization type cast fix (stricter TS)',
+        'Core svelte export condition added to package.json'
+    ],
+    breakingChanges: []
+};

package/dist/updates/index.js

@@ -24,7 +24,8 @@ import { update as update060 } from './0.6.0/index.js';
 import { update as update061 } from './0.6.1/index.js';
 import { update as update062 } from './0.6.2/index.js';
 import { update as update070 } from './0.7.0/index.js';
-export const updates = [update0065, update0066, update0067, update0068, update0069, update010, update011, update012, update013, update014, update015, update020, update022, update050, update051, update052, update053, update054, update055, update056, update057, update058, update060, update061, update062, update070];
+import { update as update071 } from './0.7.1/index.js';
+export const updates = [update0065, update0066, update0067, update0068, update0069, update010, update011, update012, update013, update014, update015, update020, update022, update050, update051, update052, update053, update054, update055, update056, update057, update058, update060, update061, update062, update070, update071];
 export const getUpdatesFrom = (fromVersion) => {
     const fromParts = fromVersion.split('.').map(Number);
     return updates.filter((update) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "includio-cms",
-	"version": "0.7.0",
+	"version": "0.7.1",
 	"scripts": {
 		"dev": "vite dev",
 		"build": "vite build && npm run prepack",
@@ -47,6 +47,7 @@
 	"exports": {
 		"./core": {
 			"types": "./dist/core/index.d.ts",
+			"svelte": "./dist/core/index.js",
 			"node": "./dist/core/index.js"
 		},
 		"./entity": {
@@ -58,6 +59,14 @@
 			"svelte": "./dist/types/index.js",
 			"node": "./dist/types/index.js"
 		},
+		"./admin/helpers": {
+			"types": "./dist/admin/helpers/index.d.ts",
+			"svelte": "./dist/admin/helpers/index.js"
+		},
+		"./admin/ui": {
+			"types": "./dist/admin/ui/index.d.ts",
+			"svelte": "./dist/admin/ui/index.js"
+		},
 		"./admin": {
 			"types": "./dist/admin/index.d.ts",
 			"svelte": "./dist/admin/index.js"