@cogenta/widgets 0.2.3

package/dist/vocabulary.d.ts

@@ -0,0 +1,194 @@
+import { z } from 'zod';
+export declare const WIDGET_SETTINGS: {
+    readonly text: z.ZodObject<{
+        body: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            _key: z.ZodString;
+            _type: z.ZodLiteral<"block">;
+            style: z.ZodEnum<{
+                blockquote: "blockquote";
+                h2: "h2";
+                h3: "h3";
+                h4: "h4";
+                normal: "normal";
+            }>;
+            listItem: z.ZodOptional<z.ZodEnum<{
+                bullet: "bullet";
+                number: "number";
+            }>>;
+            level: z.ZodOptional<z.ZodNumber>;
+            children: z.ZodArray<z.ZodObject<{
+                _key: z.ZodString;
+                _type: z.ZodLiteral<"span">;
+                text: z.ZodString;
+                marks: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+            markDefs: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                _key: z.ZodString;
+                _type: z.ZodLiteral<"link">;
+                href: z.ZodString;
+                rel: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                _key: z.ZodString;
+                _type: z.ZodLiteral<"internalLink">;
+                collection: z.ZodString;
+                id: z.ZodString;
+            }, z.core.$strict>], "_type">>>;
+        }, z.core.$strict>, z.ZodObject<{
+            _key: z.ZodString;
+            _type: z.ZodLiteral<"media">;
+            id: z.ZodString;
+            caption: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            _key: z.ZodString;
+            _type: z.ZodLiteral<"hr">;
+        }, z.core.$strict>], "_type">>;
+    }, z.core.$strict>;
+    readonly image: z.ZodObject<{
+        media: z.ZodString;
+        alt: z.ZodDefault<z.ZodString>;
+        caption: z.ZodDefault<z.ZodString>;
+        href: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly gallery: z.ZodObject<{
+        media: z.ZodArray<z.ZodString>;
+        columns: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+    }, z.core.$strict>;
+    readonly embed: z.ZodObject<{
+        url: z.ZodString;
+        caption: z.ZodDefault<z.ZodString>;
+    }, z.core.$strict>;
+    readonly quote: z.ZodObject<{
+        text: z.ZodString;
+        attribution: z.ZodDefault<z.ZodString>;
+        role: z.ZodDefault<z.ZodString>;
+    }, z.core.$strict>;
+    readonly cta: z.ZodObject<{
+        heading: z.ZodString;
+        body: z.ZodDefault<z.ZodString>;
+        label: z.ZodString;
+        href: z.ZodString;
+    }, z.core.$strict>;
+    readonly links: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+            newTab: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    readonly contact: z.ZodObject<{
+        address: z.ZodDefault<z.ZodString>;
+        phone: z.ZodDefault<z.ZodString>;
+        email: z.ZodDefault<z.ZodString>;
+        hours: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    readonly about: z.ZodObject<{
+        media: z.ZodOptional<z.ZodString>;
+        heading: z.ZodDefault<z.ZodString>;
+        body: z.ZodString;
+        link: z.ZodOptional<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+            newTab: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    readonly recentEntries: z.ZodObject<{
+        collection: z.ZodString;
+        count: z.ZodDefault<z.ZodNumber>;
+        showDate: z.ZodDefault<z.ZodBoolean>;
+        showExcerpt: z.ZodDefault<z.ZodBoolean>;
+        showImage: z.ZodDefault<z.ZodBoolean>;
+        taxonomy: z.ZodOptional<z.ZodString>;
+        termId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly relatedEntries: z.ZodObject<{
+        count: z.ZodDefault<z.ZodNumber>;
+        showDate: z.ZodDefault<z.ZodBoolean>;
+        showImage: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>;
+    readonly popularEntries: z.ZodObject<{
+        collection: z.ZodOptional<z.ZodString>;
+        count: z.ZodDefault<z.ZodNumber>;
+        days: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>, z.ZodLiteral<365>]>>;
+        showImage: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>;
+    readonly terms: z.ZodObject<{
+        taxonomy: z.ZodString;
+        showCounts: z.ZodDefault<z.ZodBoolean>;
+        hierarchical: z.ZodDefault<z.ZodBoolean>;
+        hideEmpty: z.ZodDefault<z.ZodBoolean>;
+        display: z.ZodDefault<z.ZodEnum<{
+            dropdown: "dropdown";
+            list: "list";
+        }>>;
+    }, z.core.$strict>;
+    readonly tagCloud: z.ZodObject<{
+        taxonomy: z.ZodString;
+        maxTerms: z.ZodDefault<z.ZodNumber>;
+        showCounts: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>;
+    readonly archives: z.ZodObject<{
+        collection: z.ZodString;
+        granularity: z.ZodDefault<z.ZodEnum<{
+            month: "month";
+            year: "year";
+        }>>;
+        showCounts: z.ZodDefault<z.ZodBoolean>;
+        display: z.ZodDefault<z.ZodEnum<{
+            dropdown: "dropdown";
+            list: "list";
+        }>>;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>;
+    readonly recentComments: z.ZodObject<{
+        count: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>;
+    readonly search: z.ZodObject<{
+        placeholder: z.ZodDefault<z.ZodString>;
+    }, z.core.$strict>;
+    readonly menu: z.ZodObject<{
+        menuId: z.ZodString;
+    }, z.core.$strict>;
+    readonly social: z.ZodObject<{
+        items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+            newTab: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    readonly form: z.ZodObject<{
+        form: z.ZodString;
+    }, z.core.$strict>;
+    readonly toc: z.ZodObject<{
+        maxDepth: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+    }, z.core.$strict>;
+    readonly calendar: z.ZodObject<{
+        collection: z.ZodString;
+    }, z.core.$strict>;
+};
+export type WidgetType = keyof typeof WIDGET_SETTINGS;
+export declare const WIDGET_TYPES: readonly WidgetType[];
+export type WidgetSettings<T extends WidgetType> = z.infer<(typeof WIDGET_SETTINGS)[T]>;
+/** Widgets whose content comes from the site at render time rather than from their settings. */
+export declare const DYNAMIC_WIDGET_TYPES: ReadonlySet<WidgetType>;
+/** Widgets that only mean something beside one entry (they read the page being shown). */
+export declare const ENTRY_WIDGET_TYPES: ReadonlySet<WidgetType>;
+export declare function isWidgetType(value: unknown): value is WidgetType;
+/**
+ * Widget types a site's plugins add to the closed vocabulary above (L32 step
+ * 4), as `type` → the schema its settings must satisfy.
+ *
+ * Passed in rather than registered globally: this package validates, it does
+ * not discover. The host loads the plugins, builds the schemas, and hands the
+ * map to the store — the same direction the block registry already runs in.
+ */
+export type ExtraWidgetTypes = ReadonlyMap<string, z.ZodType<Record<string, unknown>>>;
+/**
+ * Validates and normalises a widget's settings: defaults filled in, unknown
+ * keys refused. The one gate every write goes through, so a stored widget
+ * always renders.
+ */
+export declare function validateWidgetSettings(type: unknown, settings: unknown, extra?: ExtraWidgetTypes): Record<string, unknown>;
+//# sourceMappingURL=vocabulary.d.ts.map

package/dist/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../src/vocabulary.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAoCvB,eAAO,MAAM,eAAe;aAE1B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aACJ,KAAK;;;;;;aAML,OAAO;;;;aAIP,KAAK;;;;aACL,KAAK;;;;;aAKL,GAAG;;;;;;aAMH,KAAK;;;;;;;aACL,OAAO;;;;;;;;;aASP,KAAK;;;;;;;;;;aAQL,aAAa;;;;;;;;;aAUb,cAAc;;;;;aAKd,cAAc;;;;;;aAMd,KAAK;;;;;;;;;;aAOL,QAAQ;;;;;aAKR,QAAQ;;;;;;;;;;;;;aAOR,cAAc;;;aACd,MAAM;;;aACN,IAAI;;;aACJ,MAAM;;;;;;;aAIN,IAAI;;;aACJ,GAAG;;;aACH,QAAQ;;;CACA,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,eAAe,CAAA;AACrD,eAAO,MAAM,YAAY,EAAmC,SAAS,UAAU,EAAE,CAAA;AAEjF,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEvF,gGAAgG;AAChG,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,UAAU,CAYvD,CAAA;AAEF,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,UAAU,CAGrD,CAAA;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;AAWtF;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,OAAO,EACjB,KAAK,CAAC,EAAE,gBAAgB,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuCzB"}

package/dist/vocabulary.js

@@ -0,0 +1,196 @@
+import { richTextDocumentSchema } from '@cogenta/blocks';
+import { CogentaError } from '@cogenta/core';
+import { z } from 'zod';
+/**
+ * The widget vocabulary (L30 D3): every kind of widget a site can place in a
+ * widget area, and the settings each one takes.
+ *
+ * Closed on purpose, like contract B's block vocabulary, but distinct from it:
+ * a widget is not a block of a page. It is placed once, in an area the theme
+ * owns, and repeated on every page its visibility rules allow. Several widgets
+ * are also impossible as blocks, because they read the page being shown (the
+ * entries related to it, its table of contents).
+ *
+ * Every setting is data (R3). WordPress's "Custom HTML" widget is the one
+ * deliberately absent: a widget never stores markup.
+ */
+const url = z
+    .string()
+    .trim()
+    .min(1)
+    .max(2048)
+    .refine((value) => /^(https?:\/\/|\/|#|mailto:|tel:)/u.test(value), {
+    message: 'must be an absolute http(s) URL, a site path starting with "/", "#…", mailto: or tel:',
+});
+const shortText = z.string().trim().max(200);
+const longText = z.string().trim().max(2000);
+const identifierLike = z.string().trim().min(1).max(128);
+const count = (max) => z.number().int().min(1).max(max);
+const link = z.strictObject({
+    label: shortText.min(1),
+    href: url,
+    newTab: z.boolean().default(false),
+});
+export const WIDGET_SETTINGS = {
+    // --- Content -------------------------------------------------------------
+    text: z.strictObject({ body: richTextDocumentSchema }),
+    image: z.strictObject({
+        media: identifierLike,
+        alt: shortText.default(''),
+        caption: shortText.default(''),
+        href: url.optional(),
+    }),
+    gallery: z.strictObject({
+        media: z.array(identifierLike).min(1).max(24),
+        columns: z.union([z.literal(2), z.literal(3), z.literal(4)]).default(3),
+    }),
+    embed: z.strictObject({ url, caption: shortText.default('') }),
+    quote: z.strictObject({
+        text: longText.min(1),
+        attribution: shortText.default(''),
+        role: shortText.default(''),
+    }),
+    cta: z.strictObject({
+        heading: shortText.min(1),
+        body: longText.default(''),
+        label: shortText.min(1),
+        href: url,
+    }),
+    links: z.strictObject({ items: z.array(link).min(1).max(30) }),
+    contact: z.strictObject({
+        address: longText.default(''),
+        phone: shortText.default(''),
+        email: shortText.default(''),
+        hours: z
+            .array(z.strictObject({ label: shortText.min(1), value: shortText.min(1) }))
+            .max(14)
+            .default([]),
+    }),
+    about: z.strictObject({
+        media: identifierLike.optional(),
+        heading: shortText.default(''),
+        body: longText.min(1),
+        link: link.optional(),
+    }),
+    // --- Dynamic: read the site at render time -------------------------------
+    recentEntries: z.strictObject({
+        collection: identifierLike,
+        count: count(20).default(5),
+        showDate: z.boolean().default(true),
+        showExcerpt: z.boolean().default(false),
+        showImage: z.boolean().default(false),
+        /** Only entries classified under this term. */
+        taxonomy: identifierLike.optional(),
+        termId: identifierLike.optional(),
+    }),
+    relatedEntries: z.strictObject({
+        count: count(12).default(4),
+        showDate: z.boolean().default(false),
+        showImage: z.boolean().default(true),
+    }),
+    popularEntries: z.strictObject({
+        collection: identifierLike.optional(),
+        count: count(20).default(5),
+        days: z.union([z.literal(7), z.literal(30), z.literal(90), z.literal(365)]).default(30),
+        showImage: z.boolean().default(false),
+    }),
+    terms: z.strictObject({
+        taxonomy: identifierLike,
+        showCounts: z.boolean().default(true),
+        hierarchical: z.boolean().default(true),
+        hideEmpty: z.boolean().default(true),
+        display: z.enum(['list', 'dropdown']).default('list'),
+    }),
+    tagCloud: z.strictObject({
+        taxonomy: identifierLike,
+        maxTerms: count(100).default(30),
+        showCounts: z.boolean().default(false),
+    }),
+    archives: z.strictObject({
+        collection: identifierLike,
+        granularity: z.enum(['month', 'year']).default('month'),
+        showCounts: z.boolean().default(true),
+        display: z.enum(['list', 'dropdown']).default('list'),
+        limit: count(120).default(24),
+    }),
+    recentComments: z.strictObject({ count: count(20).default(5) }),
+    search: z.strictObject({ placeholder: shortText.default('') }),
+    menu: z.strictObject({ menuId: identifierLike }),
+    social: z.strictObject({
+        /** Absent: the site's own `general.socialLinks`. */
+        items: z.array(link).max(12).optional(),
+    }),
+    form: z.strictObject({ form: identifierLike }),
+    toc: z.strictObject({ maxDepth: z.union([z.literal(2), z.literal(3), z.literal(4)]).default(3) }),
+    calendar: z.strictObject({ collection: identifierLike }),
+};
+export const WIDGET_TYPES = Object.keys(WIDGET_SETTINGS);
+/** Widgets whose content comes from the site at render time rather than from their settings. */
+export const DYNAMIC_WIDGET_TYPES = new Set([
+    'recentEntries',
+    'relatedEntries',
+    'popularEntries',
+    'terms',
+    'tagCloud',
+    'archives',
+    'recentComments',
+    'menu',
+    'social',
+    'toc',
+    'calendar',
+]);
+/** Widgets that only mean something beside one entry (they read the page being shown). */
+export const ENTRY_WIDGET_TYPES = new Set([
+    'relatedEntries',
+    'toc',
+]);
+export function isWidgetType(value) {
+    return typeof value === 'string' && Object.hasOwn(WIDGET_SETTINGS, value);
+}
+function invalid(message, details) {
+    return new CogentaError({
+        code: 'WIDGET_INVALID',
+        message,
+        hint: 'Check the widget type and its settings against the widget vocabulary of @cogenta/widgets.',
+        details,
+    });
+}
+/**
+ * Validates and normalises a widget's settings: defaults filled in, unknown
+ * keys refused. The one gate every write goes through, so a stored widget
+ * always renders.
+ */
+export function validateWidgetSettings(type, settings, extra) {
+    if (!isWidgetType(type)) {
+        // A type one of this site's plugins provides: validated against the
+        // schema that plugin declared, and refused the same way as anything else
+        // when the plugin is not installed — a widget nothing can render must not
+        // be storable.
+        const provided = typeof type === 'string' ? extra?.get(type) : undefined;
+        if (provided !== undefined) {
+            const result = provided.safeParse(settings ?? {});
+            if (result.success)
+                return result.data;
+            const problem = result.error.issues[0];
+            throw invalid(`The ${type} widget's settings are not valid${problem?.path.length ? ` at "${problem.path.join('.')}"` : ''}: ${problem?.message ?? 'unknown problem'}.`, { type, issues: result.error.issues.map((item) => item.message) });
+        }
+        throw invalid(`"${String(type)}" is not a widget type.`, {
+            type,
+            known: [...WIDGET_TYPES, ...(extra === undefined ? [] : [...extra.keys()])],
+        });
+    }
+    const parsed = WIDGET_SETTINGS[type].safeParse(settings ?? {});
+    if (!parsed.success) {
+        const issue = parsed.error.issues[0];
+        const path = issue?.path.join('.') ?? '';
+        throw invalid(`The ${type} widget's settings are not valid${path === '' ? '' : ` at "${path}"`}: ${issue?.message ?? 'unknown problem'}.`, { type, path, issues: parsed.error.issues.map((item) => item.message) });
+    }
+    if (type === 'recentEntries') {
+        const value = parsed.data;
+        if ((value.taxonomy === undefined) !== (value.termId === undefined)) {
+            throw invalid('A term filter needs both a taxonomy and a term.', { type });
+        }
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=vocabulary.js.map

package/dist/vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.js","sourceRoot":"","sources":["../src/vocabulary.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@cogenta/widgets",
+  "version": "0.2.3",
+  "description": "Widget areas for Cogenta sites: the widget vocabulary, its validation, visibility rules and storage.",
+  "license": "MPL-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.11.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cogenta-cms/cogenta.git",
+    "directory": "packages/widgets"
+  },
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@cogenta/blocks": "1.1.3",
+    "@cogenta/core": "0.11.0",
+    "@cogenta/schema": "0.7.1"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
+    "test": "vitest run --passWithNoTests",
+    "test:integration": "vitest run --config vitest.integration.config.ts --passWithNoTests"
+  }
+}