@riducms/plugin-seo 0.16.2 → 0.18.0

package/dist/generation-controller.svelte.d.ts

@@ -0,0 +1,7 @@
+import type { FieldAuthoringHost, FieldDocumentForm } from "@riducms/plugin";
+export declare class GenerationController {
+    #private;
+    status: "idle" | "pending" | "error";
+    run(authoring: FieldAuthoringHost | undefined, form: FieldDocumentForm, path: string): Promise<string | undefined>;
+    cancel(): void;
+}

package/dist/generation-controller.svelte.js

@@ -0,0 +1,68 @@
+import { generationScopeToken, generationSnapshotToken } from "./generation-snapshot.js";
+export class GenerationController {
+    status = $state("idle");
+    #generation = 0;
+    #request;
+    async run(authoring, form, path) {
+        const requestPlugin = authoring?.requestPlugin;
+        const snapshot = form.snapshot;
+        const resource = form.resource;
+        if (requestPlugin === undefined || snapshot === undefined || resource === undefined) {
+            this.status = "error";
+            return undefined;
+        }
+        this.#request?.abort();
+        const request = new AbortController();
+        this.#request = request;
+        const generation = ++this.#generation;
+        this.status = "pending";
+        const document = snapshot.call(form);
+        const documentRevision = generationSnapshotToken(document);
+        const scope = generationScopeToken(resource, form.contentLocale);
+        try {
+            const response = await requestPlugin(path, {
+                ...(resource.global
+                    ? { global: resource.collection }
+                    : { collection: resource.collection }),
+                id: resource.id,
+                locale: form.contentLocale,
+                document,
+            }, request.signal);
+            if (generation !== this.#generation ||
+                request.signal.aborted ||
+                generationSnapshotToken(snapshot.call(form)) !== documentRevision ||
+                generationScopeToken(form.resource, form.contentLocale) !== scope) {
+                if (generation === this.#generation)
+                    this.status = "idle";
+                return undefined;
+            }
+            if (!isGenerationResponse(response))
+                throw new Error("SEO generation returned an invalid response");
+            this.status = "idle";
+            return response.result;
+        }
+        catch {
+            if (generation !== this.#generation || request.signal.aborted)
+                return undefined;
+            this.status = "error";
+            return undefined;
+        }
+        finally {
+            if (this.#request === request)
+                this.#request = undefined;
+        }
+    }
+    cancel() {
+        this.#generation += 1;
+        this.#request?.abort();
+        this.#request = undefined;
+        if (this.status === "pending")
+            this.status = "idle";
+    }
+}
+function isGenerationResponse(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "result" in value &&
+        typeof value.result === "string");
+}

package/dist/generation-snapshot.d.ts

@@ -0,0 +1,3 @@
+import type { FieldFormResource } from "@riducms/plugin";
+export declare function generationSnapshotToken(document: Readonly<Record<string, unknown>>): string;
+export declare function generationScopeToken(resource: FieldFormResource | undefined, locale: string | undefined): string;

package/dist/generation-snapshot.js

@@ -0,0 +1,11 @@
+export function generationSnapshotToken(document) {
+    return JSON.stringify(document);
+}
+export function generationScopeToken(resource, locale) {
+    return JSON.stringify({
+        collection: resource?.collection ?? "",
+        global: resource?.global === true,
+        id: resource?.id ?? "",
+        locale: locale ?? "",
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+export declare const seoAdminPlugin: {
+    readonly key: "seo";
+    readonly pairingVersion: 1;
+    readonly fieldEditors: {
+        readonly overview: import("@riducms/plugin").PluginFieldRegistration<undefined, undefined, "ui"> & {
+            readonly fieldType?: never;
+        };
+        readonly title: import("@riducms/plugin").PluginFieldRegistration<string, string, "text"> & {
+            readonly fieldType?: never;
+        };
+        readonly description: import("@riducms/plugin").PluginFieldRegistration<string, string, "textarea"> & {
+            readonly fieldType?: never;
+        };
+        readonly image: import("@riducms/plugin").PluginFieldRegistration<string, string, "upload"> & {
+            readonly fieldType?: never;
+        };
+        readonly preview: import("@riducms/plugin").PluginFieldRegistration<undefined, undefined, "ui"> & {
+            readonly fieldType?: never;
+        };
+    };
+    readonly messages: import("@riducms/plugin").DefineAdminMessagesInput<{
+        readonly almostThere: "Almost there";
+        readonly autoGenerate: "Auto-generate";
+        readonly bestPractices: "best practices";
+        readonly cancelled: "Generation was cancelled.";
+        readonly characterCount: "{current}/{minLength}-{maxLength} chars";
+        readonly charactersLeft: ", {characters} left over";
+        readonly charactersToGo: ", {characters} to go";
+        readonly charactersTooMany: ", {characters} too many";
+        readonly checksPassing: "{current}/{max} checks are passing";
+        readonly chooseExistingImage: "Choose existing";
+        readonly createNewImage: "Create new";
+        readonly generationFailed: "Could not generate this value. Try again.";
+        readonly good: "Good";
+        readonly image: "Image";
+        readonly imageAutoGenerationTip: "Generate an image from the current document, or choose one manually.";
+        readonly imageSourceTip: "or drag and drop a file.";
+        readonly imageUnavailable: "Referenced image is unavailable.";
+        readonly inspectImage: "Inspect image";
+        readonly lengthTipDescription: "This should be between {minLength} and {maxLength} characters. For help in writing quality meta descriptions, see ";
+        readonly lengthTipTitle: "This should be between {minLength} and {maxLength} characters. For help in writing quality meta titles, see ";
+        readonly missing: "Missing";
+        readonly noImage: "No image";
+        readonly or: "or";
+        readonly preview: "Preview";
+        readonly previewDescription: "Exact result listings may vary based on content and search relevancy.";
+        readonly removeImage: "Remove image";
+        readonly selectImage: "Select image";
+        readonly tooLong: "Too long";
+        readonly tooShort: "Too short";
+        readonly title: "Title";
+        readonly description: "Description";
+    }>;
+} & {
+    readonly apiVersion: 1;
+};
+export { lengthState, type LengthState, type LengthStatus } from "./length-indicator.js";
+export { generationScopeToken, generationSnapshotToken } from "./generation-snapshot.js";
+export { seoMessages } from "./messages.js";

package/dist/index.js

@@ -0,0 +1,48 @@
+import { defineAdminPlugin, defineFieldComponent } from "@riducms/plugin/authoring/v1";
+import { decodeString, decodeUI, decodeLengthConfig, decodeOverviewConfig, decodeImageConfig, decodePreviewConfig, } from "./seo-config.js";
+import { seoMessages } from "./messages.js";
+import MetaDescriptionField from "./meta-description-field.svelte";
+import MetaImageField from "./meta-image-field.svelte";
+import MetaTitleField from "./meta-title-field.svelte";
+import OverviewField from "./overview-field.svelte";
+import PreviewField from "./preview-field.svelte";
+export const seoAdminPlugin = defineAdminPlugin({
+    key: "seo",
+    pairingVersion: 1,
+    fieldEditors: {
+        overview: defineFieldComponent({
+            type: "ui",
+            component: OverviewField,
+            decodeValue: decodeUI,
+            decodeConfig: decodeOverviewConfig,
+        }),
+        title: defineFieldComponent({
+            type: "text",
+            component: MetaTitleField,
+            decodeValue: decodeString,
+            decodeConfig: (raw) => decodeLengthConfig(raw, "text"),
+        }),
+        description: defineFieldComponent({
+            type: "textarea",
+            component: MetaDescriptionField,
+            decodeValue: decodeString,
+            decodeConfig: (raw) => decodeLengthConfig(raw, "textarea"),
+        }),
+        image: defineFieldComponent({
+            type: "upload",
+            component: MetaImageField,
+            decodeValue: decodeString,
+            decodeConfig: decodeImageConfig,
+        }),
+        preview: defineFieldComponent({
+            type: "ui",
+            component: PreviewField,
+            decodeValue: decodeUI,
+            decodeConfig: decodePreviewConfig,
+        }),
+    },
+    messages: seoMessages,
+});
+export { lengthState } from "./length-indicator.js";
+export { generationScopeToken, generationSnapshotToken } from "./generation-snapshot.js";
+export { seoMessages } from "./messages.js";

package/dist/length-indicator.d.ts

@@ -0,0 +1,8 @@
+export type LengthStatus = "missing" | "tooShort" | "almostThere" | "good" | "tooLong";
+export interface LengthState {
+    status: LengthStatus;
+    length: number;
+    progress: number;
+    remaining: number;
+}
+export declare function lengthState(text: string, minLength: number, maxLength: number): LengthState;

package/dist/length-indicator.js

@@ -0,0 +1,24 @@
+export function lengthState(text, minLength, maxLength) {
+    const length = text.length;
+    if (length === 0)
+        return { status: "missing", length, progress: 0, remaining: minLength };
+    if (length < minLength) {
+        const progress = Math.min(1, length / minLength);
+        return {
+            status: progress > 0.9 ? "almostThere" : "tooShort",
+            length,
+            progress,
+            remaining: minLength - length,
+        };
+    }
+    if (length <= maxLength) {
+        const range = Math.max(1, maxLength - minLength);
+        return {
+            status: "good",
+            length,
+            progress: Math.min(1, (length - minLength) / range),
+            remaining: maxLength - length,
+        };
+    }
+    return { status: "tooLong", length, progress: 1, remaining: length - maxLength };
+}

package/{src → dist}/length-indicator.svelte

@@ -1,8 +1,8 @@
 <script lang="ts">
 	import type { AdminI18n } from "@riducms/plugin";
 
-	import { lengthState } from "@plugin-seo/length-indicator";
-	import "@plugin-seo/seo.scss";
+	import { lengthState } from "./length-indicator.js";
+	import "./seo.css";
 
 	let {
 		text,

package/dist/length-indicator.svelte.d.ts

@@ -0,0 +1,11 @@
+import type { AdminI18n } from "@riducms/plugin";
+import "./seo.css";
+type $$ComponentProps = {
+    text: string;
+    minLength: number;
+    maxLength: number;
+    i18n: AdminI18n;
+};
+declare const LengthIndicator: import("svelte").Component<$$ComponentProps, {}, "">;
+type LengthIndicator = ReturnType<typeof LengthIndicator>;
+export default LengthIndicator;

package/dist/messages.d.ts

@@ -0,0 +1,33 @@
+export declare const seoMessages: import("@riducms/plugin").DefineAdminMessagesInput<{
+    readonly almostThere: "Almost there";
+    readonly autoGenerate: "Auto-generate";
+    readonly bestPractices: "best practices";
+    readonly cancelled: "Generation was cancelled.";
+    readonly characterCount: "{current}/{minLength}-{maxLength} chars";
+    readonly charactersLeft: ", {characters} left over";
+    readonly charactersToGo: ", {characters} to go";
+    readonly charactersTooMany: ", {characters} too many";
+    readonly checksPassing: "{current}/{max} checks are passing";
+    readonly chooseExistingImage: "Choose existing";
+    readonly createNewImage: "Create new";
+    readonly generationFailed: "Could not generate this value. Try again.";
+    readonly good: "Good";
+    readonly image: "Image";
+    readonly imageAutoGenerationTip: "Generate an image from the current document, or choose one manually.";
+    readonly imageSourceTip: "or drag and drop a file.";
+    readonly imageUnavailable: "Referenced image is unavailable.";
+    readonly inspectImage: "Inspect image";
+    readonly lengthTipDescription: "This should be between {minLength} and {maxLength} characters. For help in writing quality meta descriptions, see ";
+    readonly lengthTipTitle: "This should be between {minLength} and {maxLength} characters. For help in writing quality meta titles, see ";
+    readonly missing: "Missing";
+    readonly noImage: "No image";
+    readonly or: "or";
+    readonly preview: "Preview";
+    readonly previewDescription: "Exact result listings may vary based on content and search relevancy.";
+    readonly removeImage: "Remove image";
+    readonly selectImage: "Select image";
+    readonly tooLong: "Too long";
+    readonly tooShort: "Too short";
+    readonly title: "Title";
+    readonly description: "Description";
+}>;

package/dist/messages.js

@@ -0,0 +1,104 @@
+import { defineAdminMessages } from "@riducms/plugin";
+export const seoMessages = defineAdminMessages({
+    fallback: {
+        almostThere: "Almost there",
+        autoGenerate: "Auto-generate",
+        bestPractices: "best practices",
+        cancelled: "Generation was cancelled.",
+        characterCount: "{current}/{minLength}-{maxLength} chars",
+        charactersLeft: ", {characters} left over",
+        charactersToGo: ", {characters} to go",
+        charactersTooMany: ", {characters} too many",
+        checksPassing: "{current}/{max} checks are passing",
+        chooseExistingImage: "Choose existing",
+        createNewImage: "Create new",
+        generationFailed: "Could not generate this value. Try again.",
+        good: "Good",
+        image: "Image",
+        imageAutoGenerationTip: "Generate an image from the current document, or choose one manually.",
+        imageSourceTip: "or drag and drop a file.",
+        imageUnavailable: "Referenced image is unavailable.",
+        inspectImage: "Inspect image",
+        lengthTipDescription: "This should be between {minLength} and {maxLength} characters. For help in writing quality meta descriptions, see ",
+        lengthTipTitle: "This should be between {minLength} and {maxLength} characters. For help in writing quality meta titles, see ",
+        missing: "Missing",
+        noImage: "No image",
+        or: "or",
+        preview: "Preview",
+        previewDescription: "Exact result listings may vary based on content and search relevancy.",
+        removeImage: "Remove image",
+        selectImage: "Select image",
+        tooLong: "Too long",
+        tooShort: "Too short",
+        title: "Title",
+        description: "Description",
+    },
+    translations: {
+        fr: {
+            almostThere: "Presque terminé",
+            autoGenerate: "Générer automatiquement",
+            bestPractices: "bonnes pratiques",
+            cancelled: "La génération a été annulée.",
+            characterCount: "{current}/{minLength}-{maxLength} caractères",
+            charactersLeft: ", {characters} restants",
+            charactersToGo: ", encore {characters}",
+            charactersTooMany: ", {characters} en trop",
+            checksPassing: "{current}/{max} vérifications réussies",
+            chooseExistingImage: "Choisir un élément existant",
+            createNewImage: "Créer un élément",
+            generationFailed: "Impossible de générer cette valeur. Réessayez.",
+            good: "Bon",
+            image: "Image",
+            imageAutoGenerationTip: "Générez une image à partir du document actuel ou choisissez-en une manuellement.",
+            imageSourceTip: "ou glissez-déposez un fichier.",
+            imageUnavailable: "L’image référencée n’est pas disponible.",
+            inspectImage: "Inspecter l’image",
+            lengthTipDescription: "Ceci devrait contenir entre {minLength} et {maxLength} caractères. Pour obtenir de l’aide pour rédiger des descriptions meta de qualité, consultez les ",
+            lengthTipTitle: "Ceci devrait contenir entre {minLength} et {maxLength} caractères. Pour obtenir de l’aide pour rédiger des titres meta de qualité, consultez les ",
+            missing: "Manquant",
+            noImage: "Aucune image",
+            or: "ou",
+            preview: "Aperçu",
+            previewDescription: "Les résultats exacts peuvent varier en fonction du contenu et de la pertinence de la recherche.",
+            removeImage: "Supprimer l’image",
+            selectImage: "Sélectionner une image",
+            tooLong: "Trop long",
+            tooShort: "Trop court",
+            title: "Titre",
+            description: "Description",
+        },
+        ar: {
+            almostThere: "أوشكت على الانتهاء",
+            autoGenerate: "إنشاء تلقائي",
+            bestPractices: "أفضل الممارسات",
+            cancelled: "تم إلغاء الإنشاء.",
+            characterCount: "{current}/{minLength}-{maxLength} حرفًا",
+            charactersLeft: "، متبقٍ {characters}",
+            charactersToGo: "، يلزم {characters}",
+            charactersTooMany: "، زائد {characters}",
+            checksPassing: "تم اجتياز {current}/{max} من الفحوصات",
+            chooseExistingImage: "اختيار صورة موجودة",
+            createNewImage: "إنشاء صورة جديدة",
+            description: "الوصف",
+            generationFailed: "تعذر إنشاء هذه القيمة. حاول مرة أخرى.",
+            good: "جيد",
+            image: "الصورة",
+            imageAutoGenerationTip: "أنشئ صورة من المستند الحالي أو اختر صورة يدويًا.",
+            imageSourceTip: "أو اسحب ملفًا وأفلته.",
+            imageUnavailable: "الصورة المشار إليها غير متاحة.",
+            inspectImage: "فحص الصورة",
+            lengthTipDescription: "يجب أن يتراوح هذا بين {minLength} و{maxLength} حرفًا. للحصول على مساعدة في كتابة أوصاف ميتا ذات جودة، راجع ",
+            lengthTipTitle: "يجب أن يتراوح هذا بين {minLength} و{maxLength} حرفًا. للحصول على مساعدة في كتابة عناوين ميتا ذات جودة، راجع ",
+            missing: "مفقود",
+            noImage: "لا توجد صورة",
+            or: "أو",
+            preview: "معاينة",
+            previewDescription: "قد تختلف النتائج الدقيقة بناءً على المحتوى وملاءمة البحث.",
+            removeImage: "إزالة الصورة",
+            selectImage: "اختيار صورة",
+            title: "العنوان",
+            tooLong: "طويل جدًا",
+            tooShort: "قصير جدًا",
+        },
+    },
+});

package/{src → dist}/meta-description-field.svelte

@@ -2,10 +2,10 @@
 	import type { PluginFieldProps } from "@riducms/plugin";
 	import { Button, FieldFrame, Textarea, fieldControlARIA } from "@riducms/ui";
 
-	import { GenerationController } from "@plugin-seo/generation-controller.svelte";
-	import LengthIndicator from "@plugin-seo/length-indicator.svelte";
-	import "@plugin-seo/seo.scss";
-	import type { LengthConfig } from "@plugin-seo/seo-config";
+	import { GenerationController } from "./generation-controller.svelte.js";
+	import LengthIndicator from "./length-indicator.svelte";
+	import "./seo.css";
+	import type { LengthConfig } from "./seo-config.js";
 
 	let {
 		field: binding,

package/dist/meta-description-field.svelte.d.ts

@@ -0,0 +1,6 @@
+import type { PluginFieldProps } from "@riducms/plugin";
+import "./seo.css";
+import type { LengthConfig } from "./seo-config.js";
+declare const MetaDescriptionField: import("svelte").Component<PluginFieldProps<string, LengthConfig, "textarea">, {}, "">;
+type MetaDescriptionField = ReturnType<typeof MetaDescriptionField>;
+export default MetaDescriptionField;

package/{src → dist}/meta-image-field.svelte

@@ -1,12 +1,12 @@
 <script lang="ts">
 	import type { PluginFieldProps, FieldDocument } from "@riducms/plugin";
 	import { Button, FieldFrame, fieldControlARIA } from "@riducms/ui";
-	import ImageIcon from "~icons/lucide/image";
-	import PencilIcon from "~icons/lucide/pencil";
-	import XIcon from "~icons/lucide/x";
+	import ImageIcon from "./~icons/lucide/image.svelte";
+	import PencilIcon from "./~icons/lucide/pencil.svelte";
+	import XIcon from "./~icons/lucide/x.svelte";
 
-	import { GenerationController } from "@plugin-seo/generation-controller.svelte";
-	import "@plugin-seo/seo.scss";
+	import { GenerationController } from "./generation-controller.svelte.js";
+	import "./seo.css";
 
 	let {
 		field: binding,

package/dist/meta-image-field.svelte.d.ts

@@ -0,0 +1,7 @@
+import type { PluginFieldProps } from "@riducms/plugin";
+import "./seo.css";
+declare const MetaImageField: import("svelte").Component<PluginFieldProps<string, {
+    generate: boolean;
+}, "upload">, {}, "">;
+type MetaImageField = ReturnType<typeof MetaImageField>;
+export default MetaImageField;

package/{src → dist}/meta-title-field.svelte

@@ -2,10 +2,10 @@
 	import type { PluginFieldProps } from "@riducms/plugin";
 	import { Button, FieldFrame, Input, fieldControlARIA } from "@riducms/ui";
 
-	import { GenerationController } from "@plugin-seo/generation-controller.svelte";
-	import LengthIndicator from "@plugin-seo/length-indicator.svelte";
-	import "@plugin-seo/seo.scss";
-	import type { LengthConfig } from "@plugin-seo/seo-config";
+	import { GenerationController } from "./generation-controller.svelte.js";
+	import LengthIndicator from "./length-indicator.svelte";
+	import "./seo.css";
+	import type { LengthConfig } from "./seo-config.js";
 
 	let {
 		field: binding,

package/dist/meta-title-field.svelte.d.ts

@@ -0,0 +1,6 @@
+import type { PluginFieldProps } from "@riducms/plugin";
+import "./seo.css";
+import type { LengthConfig } from "./seo-config.js";
+declare const MetaTitleField: import("svelte").Component<PluginFieldProps<string, LengthConfig, "text">, {}, "">;
+type MetaTitleField = ReturnType<typeof MetaTitleField>;
+export default MetaTitleField;

package/{src → dist}/overview-field.svelte

@@ -1,8 +1,8 @@
 <script lang="ts">
 	import type { PluginFieldProps } from "@riducms/plugin";
-	import "@plugin-seo/seo.scss";
+	import "./seo.css";
 
-	import type { OverviewConfig } from "@plugin-seo/seo-config";
+	import type { OverviewConfig } from "./seo-config.js";
 
 	let {
 		field: binding,

package/dist/overview-field.svelte.d.ts

@@ -0,0 +1,6 @@
+import type { PluginFieldProps } from "@riducms/plugin";
+import "./seo.css";
+import type { OverviewConfig } from "./seo-config.js";
+declare const OverviewField: import("svelte").Component<PluginFieldProps<undefined, OverviewConfig, "ui">, {}, "">;
+type OverviewField = ReturnType<typeof OverviewField>;
+export default OverviewField;

package/{src → dist}/preview-field.svelte

@@ -1,9 +1,9 @@
 <script lang="ts">
 	import type { PluginFieldProps } from "@riducms/plugin";
 
-	import { GenerationController } from "@plugin-seo/generation-controller.svelte";
-	import "@plugin-seo/seo.scss";
-	import type { PreviewConfig } from "@plugin-seo/seo-config";
+	import { GenerationController } from "./generation-controller.svelte.js";
+	import "./seo.css";
+	import type { PreviewConfig } from "./seo-config.js";
 
 	let {
 		field: binding,

package/dist/preview-field.svelte.d.ts

@@ -0,0 +1,6 @@
+import type { PluginFieldProps } from "@riducms/plugin";
+import "./seo.css";
+import type { PreviewConfig } from "./seo-config.js";
+declare const PreviewField: import("svelte").Component<PluginFieldProps<undefined, PreviewConfig, "ui">, {}, "">;
+type PreviewField = ReturnType<typeof PreviewField>;
+export default PreviewField;

package/dist/seo-config.d.ts

@@ -0,0 +1,27 @@
+export interface LengthConfig {
+    generate: boolean;
+    minLength: number;
+    maxLength: number;
+}
+export interface OverviewConfig {
+    titlePath: string;
+    descriptionPath: string;
+    imagePath: string;
+    titleMin: number;
+    titleMax: number;
+    descriptionMin: number;
+    descriptionMax: number;
+}
+export interface PreviewConfig {
+    generate: boolean;
+    titlePath: string;
+    descriptionPath: string;
+}
+export declare function decodeLengthConfig(raw: unknown, type: "text" | "textarea"): LengthConfig;
+export declare function decodeOverviewConfig(raw: unknown): OverviewConfig;
+export declare function decodePreviewConfig(raw: unknown): PreviewConfig;
+export declare function decodeImageConfig(raw: unknown): {
+    generate: boolean;
+};
+export declare function decodeString(value: unknown): string;
+export declare function decodeUI(value: unknown): undefined;

package/dist/seo-config.js

@@ -0,0 +1,74 @@
+export function decodeLengthConfig(raw, type) {
+    const value = componentConfig(raw, ["generate", "minLength", "maxLength"]);
+    return {
+        generate: value.generate === true,
+        minLength: positiveInteger(value.minLength, type === "textarea" ? 100 : 50),
+        maxLength: positiveInteger(value.maxLength, type === "textarea" ? 150 : 60),
+    };
+}
+export function decodeOverviewConfig(raw) {
+    const value = componentConfig(raw, [
+        "titlePath",
+        "descriptionPath",
+        "imagePath",
+        "titleMin",
+        "titleMax",
+        "descriptionMin",
+        "descriptionMax",
+    ]);
+    return {
+        titlePath: stringValue(value.titlePath, "meta.title"),
+        descriptionPath: stringValue(value.descriptionPath, "meta.description"),
+        imagePath: stringValue(value.imagePath, "meta.image"),
+        titleMin: positiveInteger(value.titleMin, 50),
+        titleMax: positiveInteger(value.titleMax, 60),
+        descriptionMin: positiveInteger(value.descriptionMin, 100),
+        descriptionMax: positiveInteger(value.descriptionMax, 150),
+    };
+}
+export function decodePreviewConfig(raw) {
+    const value = componentConfig(raw, ["generate", "titlePath", "descriptionPath"]);
+    return {
+        generate: value.generate === true,
+        titlePath: stringValue(value.titlePath, "meta.title"),
+        descriptionPath: stringValue(value.descriptionPath, "meta.description"),
+    };
+}
+export function decodeImageConfig(raw) {
+    return { generate: componentConfig(raw, ["generate"]).generate === true };
+}
+function componentConfig(raw, allowed) {
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+        throw new Error("SEO config must be an object.");
+    const value = raw;
+    for (const key of Object.keys(value))
+        if (!allowed.includes(key))
+            throw new Error(`Unsupported SEO config key ${key}.`);
+    if (value.generate !== undefined && typeof value.generate !== "boolean")
+        throw new Error("generate must be a boolean.");
+    return value;
+}
+export function decodeString(value) {
+    if (typeof value !== "string")
+        throw new Error("Expected a string value.");
+    return value;
+}
+export function decodeUI(value) {
+    if (value !== undefined)
+        throw new Error("UI fields have no stored value.");
+    return undefined;
+}
+function stringValue(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== "string" || !value.length)
+        throw new Error("Expected a nonempty string config value.");
+    return value;
+}
+function positiveInteger(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== "number" || !Number.isInteger(value) || value <= 0)
+        throw new Error("Expected a positive integer config value.");
+    return value;
+}