nextjs-cms 0.9.36 → 0.9.38

package/dist/core/db/table-checker/MysqlTable.js

@@ -22,12 +22,12 @@ export class MysqlTableChecker extends DbTableChecker {
         return _tables;
     }
     static async getColumns(tableName) {
-        const statement = sql `
-       SELECT COLUMN_NAME 
-      FROM information_schema.COLUMNS c
-      inner join information_schema.TABLES t ON t.TABLE_NAME = c.TABLE_NAME
-      WHERE t.TABLE_SCHEMA = DATABASE()
-        AND c.TABLE_SCHEMA = DATABASE()
+        const statement = sql `
+       SELECT COLUMN_NAME 
+      FROM information_schema.COLUMNS c
+      inner join information_schema.TABLES t ON t.TABLE_NAME = c.TABLE_NAME
+      WHERE t.TABLE_SCHEMA = DATABASE()
+        AND c.TABLE_SCHEMA = DATABASE()
         AND t.TABLE_NAME = ${tableName}`;
         const _cols = [];
         const _res = await db.execute(statement);
@@ -84,10 +84,10 @@ export class MysqlTableChecker extends DbTableChecker {
                     fullTextKeys.push({ name: key, columns: _fullTextKeyMap[key] });
             }
             // Foreign keys should be retrieved from information_schema
-            const [foreignKeys] = await db.execute(sql `
-            SELECT COLUMN_NAME, REFERENCED_TABLE_NAME, REFERENCED_COLUMN_NAME
-            FROM information_schema.KEY_COLUMN_USAGE
-            WHERE TABLE_NAME = ${table} AND CONSTRAINT_NAME != 'PRIMARY' AND REFERENCED_TABLE_NAME IS NOT NULL;
+            const [foreignKeys] = await db.execute(sql `
+            SELECT COLUMN_NAME, REFERENCED_TABLE_NAME, REFERENCED_COLUMN_NAME
+            FROM information_schema.KEY_COLUMN_USAGE
+            WHERE TABLE_NAME = ${table} AND CONSTRAINT_NAME != 'PRIMARY' AND REFERENCED_TABLE_NAME IS NOT NULL;
         `);
             return { primaryKeys, uniqueKeys, indexKeys, foreignKeys, fullTextKeys };
         }

package/dist/core/factories/section-factory-with-esbuild.js

@@ -460,15 +460,15 @@ export class SectionFactory {
                             importErr.message.includes('Cannot find module') &&
                             importErr.message.includes('.section')) {
                             this.sectionProcessingErrors[file] ??= [];
-                            this.sectionProcessingErrors[file].push(`❌ Invalid section import detected.
-
-Sections MUST use extensionless relative imports:
-
-  ✅ import exampleSection from './example.section'
-  ❌ import exampleSection from './example.section.ts'
-  ❌ import exampleSection from './example.section.js'
-
-This file is bundled with esbuild, so Node never resolves the import directly.
+                            this.sectionProcessingErrors[file].push(`❌ Invalid section import detected.
+
+Sections MUST use extensionless relative imports:
+
+  ✅ import exampleSection from './example.section'
+  ❌ import exampleSection from './example.section.ts'
+  ❌ import exampleSection from './example.section.js'
+
+This file is bundled with esbuild, so Node never resolves the import directly.
 If you added an extension manually, remove it.`);
                             this.errorCount++;
                             continue;

package/dist/core/factories/section-factory-with-jiti.js

@@ -417,15 +417,15 @@ export class SectionFactory {
                             importErr.message.includes('Cannot find module') &&
                             importErr.message.includes('.section')) {
                             this.sectionProcessingErrors[file] ??= [];
-                            this.sectionProcessingErrors[file].push(`❌ Invalid section import detected.
-
-Sections MUST use extensionless relative imports:
-
-  ✅ import exampleSection from './example.section'
-  ❌ import exampleSection from './example.section.ts'
-  ❌ import exampleSection from './example.section.js'
-
-This file is bundled with jiti, so Node never resolves the import directly.
+                            this.sectionProcessingErrors[file].push(`❌ Invalid section import detected.
+
+Sections MUST use extensionless relative imports:
+
+  ✅ import exampleSection from './example.section'
+  ❌ import exampleSection from './example.section.ts'
+  ❌ import exampleSection from './example.section.js'
+
+This file is bundled with jiti, so Node never resolves the import directly.
 If you added an extension manually, remove it.`);
                             this.errorCount++;
                             continue;

package/dist/core/fields/date-range.d.ts

@@ -70,13 +70,13 @@ declare const optionsSchema: z.ZodObject<{
     maxDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
     defaultStartValue: z.ZodOptional<z.ZodDate>;
     defaultEndValue: z.ZodOptional<z.ZodDate>;
-    order: z.ZodOptional<z.ZodNumber>;
-    localized: z.ZodOptional<z.ZodBoolean>;
     label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
     required: z.ZodOptional<z.ZodBoolean>;
     defaultValue: z.ZodOptional<z.ZodAny>;
+    order: z.ZodOptional<z.ZodNumber>;
     conditionalRules: z.ZodOptional<z.ZodArray<z.ZodCustom<import("../types/index.js").ConditionalRule, import("../types/index.js").ConditionalRule>>>;
     adminGenerated: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodLiteral<false>, z.ZodLiteral<"readonly">]>>;
+    localized: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 declare const dateRangeFieldConfigSchema: z.ZodObject<{
     /**
@@ -97,13 +97,13 @@ declare const dateRangeFieldConfigSchema: z.ZodObject<{
     maxDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
     defaultStartValue: z.ZodOptional<z.ZodDate>;
     defaultEndValue: z.ZodOptional<z.ZodDate>;
-    order: z.ZodOptional<z.ZodNumber>;
-    localized: z.ZodOptional<z.ZodBoolean>;
     label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
     required: z.ZodOptional<z.ZodBoolean>;
     defaultValue: z.ZodOptional<z.ZodAny>;
+    order: z.ZodOptional<z.ZodNumber>;
     conditionalRules: z.ZodOptional<z.ZodArray<z.ZodCustom<import("../types/index.js").ConditionalRule, import("../types/index.js").ConditionalRule>>>;
     adminGenerated: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodLiteral<false>, z.ZodLiteral<"readonly">]>>;
+    localized: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export type DateRangeFieldConfig = z.infer<typeof dateRangeFieldConfigSchema>;
 /**

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

@@ -0,0 +1,115 @@
+import type { BaseFieldConfig } from './field.js';
+import { Field } from './field.js';
+import { entityKind } from '../helpers/index.js';
+import * as z from 'zod';
+declare const configSchema: z.ZodObject<{
+    startName: z.ZodString;
+    endName: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<{
+        date: "date";
+        datetime: "datetime";
+    }>>;
+    defaultStartValue: z.ZodOptional<z.ZodCustom<Date, Date>>;
+    defaultEndValue: z.ZodOptional<z.ZodCustom<Date, Date>>;
+}, z.core.$strict>;
+type Config = z.infer<typeof configSchema>;
+/**
+ * DateRangeField stores two DB columns: startName and endName.
+ *
+ * Because Field expects a single `name`, we pass `startName` as `name` to the
+ * super constructor (used for label generation / identity only).
+ * The field opts out of the normal single-column SQL path via hasSqlNameAndValue()=false
+ * and instead exposes setValues() / getSqlNamesAndValues() which submit.ts calls
+ * via an is(field, DateRangeField) guard — the same pattern used for SelectField.
+ */
+export declare class DateRangeField extends Field<'date_range', Config> {
+    static readonly [entityKind]: string;
+    readonly startName: string;
+    readonly endName: string;
+    readonly format: 'date' | 'datetime';
+    private startValue;
+    private endValue;
+    constructor(config: Omit<BaseFieldConfig<Config>, 'name'> & Config);
+    hasSqlNameAndValue(): boolean;
+    setValues(postData: FormData): void;
+    getSqlNamesAndValues(): Record<string, string | null>;
+    getValue(): {
+        from: string | null;
+        to: string | null;
+    };
+    exportForClient(): {
+        startName: string;
+        endName: string;
+        format: "date" | "datetime";
+        startValue: any;
+        endValue: any;
+        type: "date_range";
+        name: string;
+        label: string;
+        required: boolean;
+        localized?: boolean;
+        conditionalFields: import("../types/index.js").ConditionalField[];
+        readonly: boolean;
+        defaultValue: any;
+        value: any;
+    };
+    checkRequired(): void;
+    prepareForSubmission(): Promise<void>;
+    private parseDate;
+    private formatDate;
+}
+export type DateRangeFieldClientConfig = ReturnType<DateRangeField['exportForClient']>;
+declare const optionsSchema: z.ZodObject<{
+    startName: z.ZodString;
+    endName: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<{
+        date: "date";
+        datetime: "datetime";
+    }>>;
+    defaultStartValue: z.ZodOptional<z.ZodCustom<Date, Date>>;
+    defaultEndValue: z.ZodOptional<z.ZodCustom<Date, Date>>;
+    label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    defaultValue: z.ZodOptional<z.ZodAny>;
+    order: z.ZodOptional<z.ZodNumber>;
+    conditionalRules: z.ZodOptional<z.ZodArray<z.ZodCustom<import("../types/index.js").ConditionalRule, import("../types/index.js").ConditionalRule>>>;
+    adminGenerated: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodLiteral<false>, z.ZodLiteral<"readonly">]>>;
+    localized: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+declare const dateRangeFieldConfigSchema: z.ZodObject<{
+    /**
+     * Auto-computed as `${startName}|${endName}`.
+     * Satisfies the `FieldConfig` union constraint that every config has a `name` property.
+     * Never set manually — use `startName` and `endName` instead.
+     */
+    name: z.ZodString;
+    type: z.ZodLiteral<"date_range">;
+    build: z.ZodFunction<z.core.$ZodFunctionArgs, z.ZodCustom<DateRangeField, DateRangeField>>;
+    startName: z.ZodString;
+    endName: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<{
+        date: "date";
+        datetime: "datetime";
+    }>>;
+    defaultStartValue: z.ZodOptional<z.ZodCustom<Date, Date>>;
+    defaultEndValue: z.ZodOptional<z.ZodCustom<Date, Date>>;
+    label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    defaultValue: z.ZodOptional<z.ZodAny>;
+    order: z.ZodOptional<z.ZodNumber>;
+    conditionalRules: z.ZodOptional<z.ZodArray<z.ZodCustom<import("../types/index.js").ConditionalRule, import("../types/index.js").ConditionalRule>>>;
+    adminGenerated: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodLiteral<false>, z.ZodLiteral<"readonly">]>>;
+    localized: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type DateRangeFieldConfig = z.infer<typeof dateRangeFieldConfigSchema>;
+/**
+ * Helper to create a date range field configuration.
+ * Uses `startName` and `endName` instead of the usual `name`.
+ * The `name` property is auto-computed as `${startName}|${endName}`.
+ *
+ * @example
+ * dateRangeField({ startName: 'event_start', endName: 'event_end', label: 'Event Dates' })
+ */
+export declare function dateRangeField(field: z.infer<typeof optionsSchema>): DateRangeFieldConfig;
+export {};
+//# sourceMappingURL=dateRange.d.ts.map

package/dist/core/fields/dateRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateRange.d.ts","sourceRoot":"","sources":["../../../src/core/fields/dateRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,KAAK,EAAyB,MAAM,YAAY,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAIxB,QAAA,MAAM,YAAY;;;;;;;;;kBAMhB,CAAA;AAEF,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAE1C;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC;IAC3D,gBAAyB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAmB;IAEhE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;IAEpC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAK;gBAET,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM;IAYzD,kBAAkB,IAAI,OAAO;IAMtC,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IASnC,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IASrD,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAO7C,eAAe;;;;;;;;;;;;;;;;IAWxB,aAAa,IAAI,IAAI;IASf,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3C,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,UAAU;CAOrB;AAED,MAAM,MAAM,0BAA0B,GAAG,UAAU,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAA;AAItF,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;kBAGjB,CAAA;AAEF,QAAA,MAAM,0BAA0B;IAE5B;;;;OAIG;;;;;;;;;;;;;;;;;;;kBAOL,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAE7E;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GAAG,oBAAoB,CAczF"}

package/dist/core/fields/dateRange.js

@@ -0,0 +1,149 @@
+import { Field, baseFieldConfigSchema } from './field.js';
+import { entityKind } from '../helpers/index.js';
+import * as z from 'zod';
+import dayjs from 'dayjs';
+import getString from '../../translations/index.js';
+const configSchema = z.strictObject({
+    startName: z.string().describe('The DB column name for the start date'),
+    endName: z.string().describe('The DB column name for the end date'),
+    format: z.enum(['date', 'datetime']).optional().describe('The format of the date columns'),
+    defaultStartValue: z.custom().optional().describe('Default value for the start date'),
+    defaultEndValue: z.custom().optional().describe('Default value for the end date'),
+});
+/**
+ * DateRangeField stores two DB columns: startName and endName.
+ *
+ * Because Field expects a single `name`, we pass `startName` as `name` to the
+ * super constructor (used for label generation / identity only).
+ * The field opts out of the normal single-column SQL path via hasSqlNameAndValue()=false
+ * and instead exposes setValues() / getSqlNamesAndValues() which submit.ts calls
+ * via an is(field, DateRangeField) guard — the same pattern used for SelectField.
+ */
+export class DateRangeField extends Field {
+    static [entityKind] = 'DateRangeField';
+    startName;
+    endName;
+    format;
+    startValue;
+    endValue;
+    constructor(config) {
+        // Pass startName as `name` so the base class label-generation / identity works
+        super({ ...config, name: config.startName }, 'date_range');
+        this.startName = config.startName;
+        this.endName = config.endName;
+        this.format = config.format ?? 'date';
+        this.startValue = config.defaultStartValue ?? undefined;
+        this.endValue = config.defaultEndValue ?? undefined;
+    }
+    // ─── Opt out of single-column SQL path ────────────────────────────────────
+    hasSqlNameAndValue() {
+        return false;
+    }
+    // ─── Dual-column FormData reading (called by submit.ts) ───────────────────
+    setValues(postData) {
+        const start = postData.get(this.startName);
+        const end = postData.get(this.endName);
+        if (start)
+            this.startValue = start;
+        if (end)
+            this.endValue = end;
+    }
+    // ─── Dual-column SQL output (called by submit.ts) ─────────────────────────
+    getSqlNamesAndValues() {
+        return {
+            [this.startName]: this.formatDate(this.startValue),
+            [this.endName]: this.formatDate(this.endValue),
+        };
+    }
+    // ─── Standard Field interface ─────────────────────────────────────────────
+    getValue() {
+        return {
+            from: this.formatDate(this.startValue),
+            to: this.formatDate(this.endValue),
+        };
+    }
+    exportForClient() {
+        return {
+            ...super.exportForClient(),
+            startName: this.startName,
+            endName: this.endName,
+            format: this.format,
+            startValue: this.startValue ?? null,
+            endValue: this.endValue ?? null,
+        };
+    }
+    checkRequired() {
+        if (!this.required)
+            return;
+        if (!this.parseDate(this.startValue) || !this.parseDate(this.endValue)) {
+            throw new Error(getString('fieldIsRequired', this.language, { field: this.getLocalizedLabel() }));
+        }
+    }
+    async prepareForSubmission() {
+        const start = this.parseDate(this.startValue);
+        const end = this.parseDate(this.endValue);
+        if (this.required && (!start || !end)) {
+            throw new Error(getString('invalidDatePleaseProvideValid', this.language, { field: this.getLocalizedLabel() }));
+        }
+        if (start)
+            this.startValue = start.toISOString();
+        if (end)
+            this.endValue = end.toISOString();
+    }
+    // ─── Helpers ──────────────────────────────────────────────────────────────
+    parseDate(value) {
+        if (value === undefined || value === null || value === '')
+            return null;
+        const date = new Date(value);
+        return isNaN(date.getTime()) ? null : date;
+    }
+    formatDate(value) {
+        const date = this.parseDate(value);
+        if (!date)
+            return null;
+        return this.format === 'datetime'
+            ? dayjs(date).format('YYYY-MM-DD HH:mm:ss')
+            : dayjs(date).format('YYYY-MM-DD');
+    }
+}
+// ─── Config schema & factory ──────────────────────────────────────────────────
+const optionsSchema = z.strictObject({
+    ...baseFieldConfigSchema.omit({ name: true }).shape,
+    ...configSchema.shape,
+});
+const dateRangeFieldConfigSchema = z.strictObject({
+    ...optionsSchema.shape,
+    /**
+     * Auto-computed as `${startName}|${endName}`.
+     * Satisfies the `FieldConfig` union constraint that every config has a `name` property.
+     * Never set manually — use `startName` and `endName` instead.
+     */
+    name: z.string(),
+    type: z.literal('date_range').describe('The type of the field'),
+    build: z
+        .function()
+        .output(z.instanceof(DateRangeField))
+        .describe('Build a DateRangeField instance from this config'),
+});
+/**
+ * Helper to create a date range field configuration.
+ * Uses `startName` and `endName` instead of the usual `name`.
+ * The `name` property is auto-computed as `${startName}|${endName}`.
+ *
+ * @example
+ * dateRangeField({ startName: 'event_start', endName: 'event_end', label: 'Event Dates' })
+ */
+export function dateRangeField(field) {
+    const result = optionsSchema.safeParse(field);
+    if (!result.success) {
+        throw new Error(`[DateRangeField: ${field.startName}/${field.endName}]: ${z.prettifyError(result.error)}`);
+    }
+    return {
+        ...field,
+        name: `${field.startName}|${field.endName}`,
+        type: 'date_range',
+        build() {
+            return new DateRangeField(field);
+        },
+    };
+}

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

@@ -1,8 +1,17 @@
-import type { BaseFieldConfig } from './field.js';
-import { Field } from './field.js';
-import { entityKind } from '../helpers/index.js';
 import * as z from 'zod';
+import type { MultilingualString } from '../../translations/language-utils.js';
+import type { BaseFieldConfig } from './field.js';
 import type { TextFieldConfig } from './text.js';
+import { entityKind } from '../helpers/index.js';
+import { Field } from './field.js';
+type SlugEditProtectionAlertConfig = {
+    title?: MultilingualString;
+    description?: MultilingualString;
+};
+type NormalizedSlugEditProtection = {
+    enabled: boolean;
+    alert?: SlugEditProtectionAlertConfig;
+};
 declare const slugFieldConfigSchema: z.ZodObject<{
     placeholder: z.ZodOptional<z.ZodString>;
     minLength: z.ZodOptional<z.ZodNumber>;
@@ -50,6 +59,17 @@ declare const slugFieldConfigSchema: z.ZodObject<{
         adminGenerated?: boolean | "readonly" | undefined;
         localized?: boolean | undefined;
     }>;
+    /**
+     * Prevents edit forms from automatically changing this slug when the linked field changes.
+     * Disabled by default. Set to true or provide an object config to protect edit forms.
+     */
+    editProtection: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        alert: z.ZodOptional<z.ZodObject<{
+            title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+            description: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>]>>;
 }, z.core.$strict>;
 type Config = z.infer<typeof slugFieldConfigSchema>;
 export declare class SlugField extends Field<'slug', Config> {
@@ -59,9 +79,12 @@ export declare class SlugField extends Field<'slug', Config> {
     readonly placeholder: string | undefined;
     readonly forFieldName: string;
     readonly forFieldConfig: TextFieldConfig;
+    readonly editProtection: NormalizedSlugEditProtection;
     private readonly _defaultValue;
     value: string | undefined;
     constructor(config: BaseFieldConfig<Config>);
+    private static normalizeEditProtection;
+    private getEditProtectionClientConfig;
     /**
      * Convert a string to a URL-friendly slug.
      * - Converts to lowercase
@@ -76,6 +99,13 @@ export declare class SlugField extends Field<'slug', Config> {
         minLength: number | undefined;
         placeholder: string | undefined;
         forFieldName: string;
+        editProtection: {
+            enabled: boolean;
+            alert: {
+                title: string | undefined;
+                description: string | undefined;
+            };
+        };
         type: "slug";
         name: string;
         label: string;
@@ -147,6 +177,17 @@ declare const optionsSchema: z.ZodObject<{
         adminGenerated?: boolean | "readonly" | undefined;
         localized?: boolean | undefined;
     }>;
+    /**
+     * Prevents edit forms from automatically changing this slug when the linked field changes.
+     * Disabled by default. Set to true or provide an object config to protect edit forms.
+     */
+    editProtection: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        alert: z.ZodOptional<z.ZodObject<{
+            title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+            description: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>]>>;
     name: z.ZodString;
     label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
     required: z.ZodOptional<z.ZodBoolean>;
@@ -204,6 +245,17 @@ declare const configSchema: z.ZodObject<{
         adminGenerated?: boolean | "readonly" | undefined;
         localized?: boolean | undefined;
     }>;
+    /**
+     * Prevents edit forms from automatically changing this slug when the linked field changes.
+     * Disabled by default. Set to true or provide an object config to protect edit forms.
+     */
+    editProtection: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        alert: z.ZodOptional<z.ZodObject<{
+            title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+            description: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>]>>;
     name: z.ZodString;
     label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
     required: z.ZodOptional<z.ZodBoolean>;

package/dist/core/fields/slug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../../src/core/fields/slug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,KAAK,EAAyB,MAAM,YAAY,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAGhD,QAAA,MAAM,qBAAqB;;;;IAIvB;;;OAGG;;IAEH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEL,CAAA;AAEF,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnD,qBAAa,SAAU,SAAQ,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC;IAChD,gBAAyB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAc;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAA;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IACzC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;gBAEtB,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC;IAW3C;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAUpB,eAAe;;;;;;;;;;;;;;;IAU/B;;OAEG;IACH,QAAQ,IAAI,MAAM,GAAG,SAAS;IAI9B,aAAa;IAQJ,kBAAkB,IAAI,OAAO;IAOtC;;;;OAIG;IACG,oBAAoB;CAwB7B;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAA;AAE5E,QAAA,MAAM,aAAa;;;;IAvHf;;;OAGG;;IAEH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAiHL,CAAA;AAEF,QAAA,MAAM,YAAY;;;;;;IA5Hd;;;OAGG;;IAEH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAuHL,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAE1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GAAG,eAAe,CAkB/E"}
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../../src/core/fields/slug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAExB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAA;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAGhD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAyB,KAAK,EAAE,MAAM,YAAY,CAAA;AAwBzD,KAAK,6BAA6B,GAAG;IACjC,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,WAAW,CAAC,EAAE,kBAAkB,CAAA;CACnC,CAAA;AAED,KAAK,4BAA4B,GAAG;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,6BAA6B,CAAA;CACxC,CAAA;AAED,QAAA,MAAM,qBAAqB;;;;IAIvB;;;OAGG;;IAEH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEH;;;OAGG;;;;;;;;kBAEL,CAAA;AAEF,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnD,qBAAa,SAAU,SAAQ,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC;IAChD,gBAAyB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAc;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAA;IACxC,QAAQ,CAAC,cAAc,EAAE,4BAA4B,CAAA;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IACzC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;gBAEtB,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC;IAY3C,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAetC,OAAO,CAAC,6BAA6B;IAgBrC;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAUpB,eAAe;;;;;;;;;;;;;;;;;;;;;;IAW/B;;OAEG;IACH,QAAQ,IAAI,MAAM,GAAG,SAAS;IAI9B,aAAa;IAQJ,kBAAkB,IAAI,OAAO;IAOtC;;;;OAIG;IACG,oBAAoB;CAwB7B;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAA;AAE5E,QAAA,MAAM,aAAa;;;;IA9Jf;;;OAGG;;IAEH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEH;;;OAGG;;;;;;;;;;;;;;;kBAmJL,CAAA;AAEF,QAAA,MAAM,YAAY;;;;;;IAnKd;;;OAGG;;IAEH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEH;;;OAGG;;;;;;;;;;;;;;;kBAyJL,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAE1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GAAG,eAAe,CAkB/E"}

package/dist/core/fields/slug.js

@@ -1,7 +1,27 @@
-import { Field, baseFieldConfigSchema } from './field.js';
-import { entityKind } from '../helpers/index.js';
 import * as z from 'zod';
 import getString from '../../translations/index.js';
+import { resolveMultilingualString } from '../../translations/language-utils.js';
+import { entityKind } from '../helpers/index.js';
+import { baseFieldConfigSchema, Field } from './field.js';
+const multilingualStringSchema = z
+    .union([z.string(), z.record(z.string(), z.string())])
+    .describe('A plain string or an object with language codes as keys');
+const editProtectionAlertSchema = z.strictObject({
+    title: multilingualStringSchema.optional().describe('The alert title shown when editing a protected slug'),
+    description: multilingualStringSchema
+        .optional()
+        .describe('The alert description shown when editing a protected slug'),
+});
+const editProtectionSchema = z
+    .union([
+    z.boolean(),
+    z.strictObject({
+        enabled: z.boolean().optional().describe('Whether edit protection is enabled'),
+        alert: editProtectionAlertSchema.optional().describe('Custom alert text for protected slug edits'),
+    }),
+])
+    .optional()
+    .describe('Protects the slug from automatic changes in edit forms');
 const slugFieldConfigSchema = z.strictObject({
     placeholder: z.string().optional().describe('The placeholder text for the field'),
     minLength: z.number().optional().describe('The minimum length of the slug'),
@@ -17,6 +37,11 @@ const slugFieldConfigSchema = z.strictObject({
      * generate a slug from that value.
      */
     for: z.custom().describe('The text field config this slug is derived from'),
+    /**
+     * Prevents edit forms from automatically changing this slug when the linked field changes.
+     * Disabled by default. Set to true or provide an object config to protect edit forms.
+     */
+    editProtection: editProtectionSchema,
 });
 export class SlugField extends Field {
     static [entityKind] = 'SlugField';
@@ -25,6 +50,7 @@ export class SlugField extends Field {
     placeholder;
     forFieldName;
     forFieldConfig;
+    editProtection;
     _defaultValue;
     value;
     constructor(config) {
@@ -36,6 +62,33 @@ export class SlugField extends Field {
         this._defaultValue = config.defaultValue;
         this.forFieldName = config.for.name;
         this.forFieldConfig = config.for;
+        this.editProtection = SlugField.normalizeEditProtection(config.editProtection);
+    }
+    static normalizeEditProtection(editProtection) {
+        if (!editProtection) {
+            return { enabled: false };
+        }
+        if (typeof editProtection === 'boolean') {
+            return { enabled: editProtection };
+        }
+        return {
+            enabled: editProtection.enabled ?? false,
+            alert: editProtection.alert,
+        };
+    }
+    getEditProtectionClientConfig() {
+        const alert = this.editProtection.alert;
+        return {
+            enabled: this.editProtection.enabled,
+            alert: {
+                title: alert?.title
+                    ? resolveMultilingualString(alert.title, this.language, this.fallbackLanguage)
+                    : undefined,
+                description: alert?.description
+                    ? resolveMultilingualString(alert.description, this.language, this.fallbackLanguage)
+                    : undefined,
+            },
+        };
     }
     /**
      * Convert a string to a URL-friendly slug.
@@ -61,6 +114,7 @@ export class SlugField extends Field {
             minLength: this.minLength,
             placeholder: this.placeholder,
             forFieldName: this.forFieldName,
+            editProtection: this.getEditProtectionClientConfig(),
         };
     }
     /**