@prenta/core 0.118.0

package/dist/fields/component-block.js

@@ -0,0 +1,137 @@
+/**
+ * `componentBlock` field type — validates a stored block instance
+ * against an extracted Manifest. Lives in its own file so the larger
+ * validation rules (per-prop coercion, allow-list enforcement) can grow
+ * without bloating the registry index.
+ *
+ * Stored-value shape:
+ *   { component: 'Hero', props: { title: 'Welcome', alignment: 'center' } }
+ */
+function isPlainObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+function isInlineManifest(m) {
+    if (!isPlainObject(m))
+        return false;
+    if (m.version !== 1)
+        return false;
+    if (typeof m.generatedAt !== 'string')
+        return false;
+    if (!Array.isArray(m.components))
+        return false;
+    // Verify every component entry has the per-component shape we'll
+    // iterate later. Without this, a malformed entry with `props` missing
+    // would crash `validateComponentBlockValue` with a TypeError on
+    // `for (const propSpec of spec.props)`, surfacing as a 500 rather
+    // than a friendly validation error.
+    for (const c of m.components) {
+        if (!isPlainObject(c))
+            return false;
+        if (typeof c.name !== 'string')
+            return false;
+        if (!Array.isArray(c.props))
+            return false;
+    }
+    return true;
+}
+function isStoredBlockValue(v) {
+    // `props` must be a *plain* object — arrays pass the `typeof obj`
+    // check but break the per-prop lookup later.
+    if (!isPlainObject(v))
+        return false;
+    return typeof v.component === 'string' && isPlainObject(v.props);
+}
+/**
+ * Validate a stored block value against the manifest declared on its
+ * field. Returns `true` on success or a human-readable error string.
+ *
+ * Performs structural checks only — the per-prop type validation is
+ * shared with the admin form generator in the next slice (PR #2) and
+ * lives in `@prenta/component-blocks`. Pulling that here would
+ * couple cms-core to the extractor, which we want to keep optional.
+ */
+export function validateComponentBlockValue(value, field) {
+    if (field.type !== 'componentBlock')
+        return true;
+    const blockField = field;
+    if (!isStoredBlockValue(value)) {
+        return 'Component block value must be { component: string; props: object }.';
+    }
+    // Allow inline manifest only; path-based manifests are resolved by
+    // the loader at config-load time and replaced with their inline form
+    // before validation runs. This keeps the validator pure and testable.
+    if (!isInlineManifest(blockField.manifest)) {
+        return 'Component block field has no resolved manifest (was it loaded?).';
+    }
+    const manifest = blockField.manifest;
+    const spec = manifest.components.find((c) => c.name === value.component);
+    if (!spec) {
+        const known = manifest.components.map((c) => c.name).join(', ') || '<none>';
+        return `Unknown component '${value.component}'. Manifest knows: ${known}.`;
+    }
+    if (blockField.allow && !blockField.allow.includes(value.component)) {
+        return `Component '${value.component}' is not in the allow-list for this field.`;
+    }
+    // Validate each prop declared in the manifest. Required props must
+    // have a value; optional props are checked only when supplied.
+    // Per-type coercion (e.g. parseInt for numeric strings) is deferred
+    // to the admin form generator slice; this layer just rejects outright
+    // shape mismatches so bad data never reaches the database.
+    for (const propSpec of spec.props) {
+        const v = value.props[propSpec.name];
+        if (v === undefined || v === null) {
+            if (propSpec.required) {
+                return `Missing required prop '${propSpec.name}' for component '${value.component}'.`;
+            }
+            continue;
+        }
+        const typeCheckError = validatePropTypeShape(v, propSpec.type, propSpec.name);
+        if (typeCheckError)
+            return typeCheckError;
+    }
+    return true;
+}
+/**
+ * Lightweight runtime check that a stored prop value matches its
+ * declared PropType shape. Deliberately permissive — we only flag
+ * outright type mismatches (number vs string) and unknown enum values.
+ * The richer schema-aware validator (with coercion and migration hints)
+ * lives in `@prenta/component-blocks` and is wired in PR #2.
+ */
+function validatePropTypeShape(value, type, propName) {
+    if (!type || typeof type !== 'object')
+        return null;
+    const t = type;
+    switch (t.kind) {
+        case 'string':
+            return typeof value === 'string' ? null : `Prop '${propName}' must be a string.`;
+        case 'number':
+            return typeof value === 'number' ? null : `Prop '${propName}' must be a number.`;
+        case 'boolean':
+            return typeof value === 'boolean' ? null : `Prop '${propName}' must be a boolean.`;
+        case 'enum': {
+            const values = t.values ?? [];
+            return values.includes(value)
+                ? null
+                : `Prop '${propName}' must be one of: ${values.join(', ')}.`;
+        }
+        case 'array':
+            return Array.isArray(value) ? null : `Prop '${propName}' must be an array.`;
+        case 'object':
+            return value !== null && typeof value === 'object' && !Array.isArray(value)
+                ? null
+                : `Prop '${propName}' must be an object.`;
+        default:
+            return null;
+    }
+}
+export const componentBlockFieldType = {
+    type: 'componentBlock',
+    label: 'Component Block',
+    defaultConfig: {
+        type: 'componentBlock',
+        label: 'Component Block',
+    },
+    validate: validateComponentBlockValue,
+};
+//# sourceMappingURL=component-block.js.map

package/dist/fields/component-block.js.map

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

package/dist/fields/index.d.ts

@@ -0,0 +1,19 @@
+import type { FieldDefinition } from '../config/types.js';
+export interface FieldTypeDefinition {
+    type: FieldDefinition['type'];
+    label: string;
+    icon?: string;
+    defaultConfig: Partial<FieldDefinition>;
+    validate?: (value: unknown, field: FieldDefinition) => string | true;
+    serialize?: (value: unknown) => unknown;
+    deserialize?: (value: unknown) => unknown;
+}
+/** Built-in field type definitions keyed by type discriminator. */
+export declare const BUILT_IN_FIELDS: Record<string, FieldTypeDefinition>;
+export declare function getFieldType(type: string): FieldTypeDefinition | undefined;
+export declare function getAllFieldTypes(): FieldTypeDefinition[];
+export { titleField, slugField, pagePathField, excerptField, richContentField, featuredImageField, categoryField, tagsField, publishedDateField, authorField, quoteField, ctaField, seoFields, locationFields, geoFields, priceFields, relationField, relatedDocsField, } from './presets.js';
+export { collectRelationRefs, validateRelations, populateRelations, parsePopulateParam, } from './relations.js';
+export type { RelationLookup, RelationSummary, PopulateOptions } from './relations.js';
+export type { CategoryOption } from './presets.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/fields/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fields/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAGzD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;IACvC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,KAAK,MAAM,GAAG,IAAI,CAAA;IACpE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;IACvC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;CAC1C;AAED,mEAAmE;AACnE,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAmF/D,CAAA;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAE1E;AAED,wBAAgB,gBAAgB,IAAI,mBAAmB,EAAE,CAExD;AAED,OAAO,EACL,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,QAAQ,EACR,SAAS,EACT,cAAc,EACd,SAAS,EACT,WAAW,EACX,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACtF,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA"}

package/dist/fields/index.js

@@ -0,0 +1,95 @@
+import { componentBlockFieldType } from './component-block.js';
+/** Built-in field type definitions keyed by type discriminator. */
+export const BUILT_IN_FIELDS = {
+    text: {
+        type: 'text',
+        label: 'Text',
+        defaultConfig: { type: 'text', label: 'Text' },
+        validate: (value) => typeof value === 'string' || 'Must be a string',
+    },
+    richText: {
+        type: 'richText',
+        label: 'Rich Text',
+        defaultConfig: {
+            type: 'richText',
+            label: 'Rich Text',
+            features: ['bold', 'italic', 'link', 'heading', 'list'],
+        },
+    },
+    number: {
+        type: 'number',
+        label: 'Number',
+        defaultConfig: { type: 'number', label: 'Number' },
+        validate: (value) => typeof value === 'number' || 'Must be a number',
+    },
+    boolean: {
+        type: 'boolean',
+        label: 'Boolean',
+        defaultConfig: { type: 'boolean', label: 'Boolean' },
+    },
+    date: {
+        type: 'date',
+        label: 'Date',
+        defaultConfig: { type: 'date', label: 'Date' },
+    },
+    slug: {
+        type: 'slug',
+        label: 'Slug',
+        defaultConfig: { type: 'slug', label: 'Slug', from: 'title' },
+    },
+    select: {
+        type: 'select',
+        label: 'Select',
+        defaultConfig: { type: 'select', label: 'Select', options: [] },
+    },
+    relationship: {
+        type: 'relationship',
+        label: 'Relationship',
+        defaultConfig: { type: 'relationship', label: 'Relationship', relationTo: '' },
+    },
+    media: {
+        type: 'media',
+        label: 'Media',
+        defaultConfig: { type: 'media', label: 'Media' },
+    },
+    json: {
+        type: 'json',
+        label: 'JSON',
+        defaultConfig: { type: 'json', label: 'JSON' },
+    },
+    color: {
+        type: 'color',
+        label: 'Color',
+        defaultConfig: { type: 'color', label: 'Color', format: 'hex' },
+    },
+    url: {
+        type: 'url',
+        label: 'URL',
+        defaultConfig: { type: 'url', label: 'URL' },
+    },
+    email: {
+        type: 'email',
+        label: 'Email',
+        defaultConfig: { type: 'email', label: 'Email' },
+    },
+    array: {
+        type: 'array',
+        label: 'Array',
+        defaultConfig: { type: 'array', label: 'Array', fields: {} },
+    },
+    blocks: {
+        type: 'blocks',
+        label: 'Blocks',
+        defaultConfig: { type: 'blocks', label: 'Blocks', blocks: [] },
+    },
+    componentBlock: componentBlockFieldType,
+};
+export function getFieldType(type) {
+    return BUILT_IN_FIELDS[type];
+}
+export function getAllFieldTypes() {
+    return Object.values(BUILT_IN_FIELDS);
+}
+export { titleField, slugField, pagePathField, excerptField, richContentField, featuredImageField, categoryField, tagsField, publishedDateField, authorField, quoteField, ctaField, seoFields, locationFields, geoFields, priceFields, relationField, relatedDocsField, } from './presets.js';
+export { collectRelationRefs, validateRelations, populateRelations, parsePopulateParam, } from './relations.js';
+//# sourceMappingURL=index.js.map

package/dist/fields/index.js.map

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

package/dist/fields/presets.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Reusable field bundles for common content patterns.
+ *
+ * Each preset returns a `Record<string, FieldDefinition>` you can spread into
+ * a collection's `fields` map:
+ *
+ * ```ts
+ * import { titleField, slugField, richContentField, seoFields } from
+ *   '@prenta/core'
+ *
+ * defineConfig({
+ *   collections: {
+ *     pages: {
+ *       slug: 'pages',
+ *       labels: { singular: 'Page', plural: 'Pages' },
+ *       fields: {
+ *         ...titleField(),
+ *         ...slugField(),
+ *         ...richContentField(),
+ *         ...seoFields(),
+ *       },
+ *     },
+ *   },
+ * })
+ * ```
+ *
+ * Presets are intentionally additive — call sites can override any single
+ * field by re-declaring it after the spread.
+ */
+import type { FieldDefinition } from '../config/types.js';
+/** Page/post title field — usually the column shown in admin lists. */
+export declare function titleField(opts?: {
+    label?: string;
+    required?: boolean;
+    placeholder?: string;
+}): Record<string, FieldDefinition>;
+/** URL slug. Defaults to deriving from `title`. */
+export declare function slugField(opts?: {
+    from?: string;
+    required?: boolean;
+}): Record<string, FieldDefinition>;
+/**
+ * Explicit URL path for a page. Distinct from `slug`: a `slug` is the
+ * URL-friendly identifier auto-derived from the title, while `path` is the full
+ * route the page renders at (e.g. `/`, `/about`, `/services/seo`), so a site can
+ * model nested or custom routes the slug alone can't express. Optional — the
+ * renderer falls back to `/${slug}` when it's blank.
+ */
+export declare function pagePathField(opts?: {
+    label?: string;
+    required?: boolean;
+}): Record<string, FieldDefinition>;
+/** Short excerpt / dek shown in listings and OG cards. */
+export declare function excerptField(opts?: {
+    label?: string;
+    maxLength?: number;
+}): Record<string, FieldDefinition>;
+/** Long-form rich text content. */
+export declare function richContentField(opts?: {
+    name?: string;
+    label?: string;
+    required?: boolean;
+}): Record<string, FieldDefinition>;
+/** Featured/hero image. */
+export declare function featuredImageField(opts?: {
+    label?: string;
+    required?: boolean;
+}): Record<string, FieldDefinition>;
+/** One option for {@link categoryField} — a plain string becomes `{ label, value }`. */
+export type CategoryOption = string | {
+    label: string;
+    value: string;
+};
+/**
+ * Editorial category. With `options` it becomes a `select` (structured
+ * vocabulary — the editor renders a dropdown instead of free text); without,
+ * it stays a free-text field for back-compat with existing sites.
+ */
+export declare function categoryField(opts?: {
+    label?: string;
+    options?: CategoryOption[];
+    required?: boolean;
+}): Record<string, FieldDefinition>;
+/** Tags (array of plain strings). */
+export declare function tagsField(opts?: {
+    label?: string;
+    maxRows?: number;
+}): Record<string, FieldDefinition>;
+/** Published-at datetime. */
+export declare function publishedDateField(): Record<string, FieldDefinition>;
+/** Author byline — text + optional relationship to a `team` collection. */
+export declare function authorField(opts?: {
+    relationTo?: string;
+    label?: string;
+}): Record<string, FieldDefinition>;
+/** Pull-quote / featured quote, used by case studies and testimonials. */
+export declare function quoteField(opts?: {
+    label?: string;
+    name?: string;
+}): Record<string, FieldDefinition>;
+/** Call-to-action label + URL pair. */
+export declare function ctaField(opts?: {
+    name?: string;
+    label?: string;
+}): Record<string, FieldDefinition>;
+/** SEO meta fields — meta title, description, OG image, canonical, robots. */
+export declare function seoFields(): Record<string, FieldDefinition>;
+/** Address + phone + hours fields for location-style records. */
+export declare function locationFields(): Record<string, FieldDefinition>;
+/** Geo coordinates pair — useful for Schema.org Place / LocalBusiness. */
+export declare function geoFields(): Record<string, FieldDefinition>;
+/** Price + currency pair — used by service / product types. */
+export declare function priceFields(opts?: {
+    currency?: string;
+}): Record<string, FieldDefinition>;
+/**
+ * Single-reference relation preset. Use when a document points at exactly
+ * one other document — e.g. `post → primaryService`, `caseStudy → client`,
+ * `page → location`. The admin renders this with the {@link RelationshipField}
+ * picker.
+ *
+ * @example
+ *   ...relationField('primaryService', { relationTo: 'services', label: 'Primary service' })
+ */
+export declare function relationField(name: string, opts: {
+    relationTo: string | string[];
+    label?: string;
+    required?: boolean;
+    description?: string;
+}): Record<string, FieldDefinition>;
+/**
+ * Many-relation preset. Use when a document can point at zero-or-more
+ * peers — e.g. `post.relatedPosts`, `service.relatedCaseStudies`,
+ * `caseStudy.featuredTeamMembers`. Always renders as a multi-select picker.
+ *
+ * @example
+ *   ...relatedDocsField('relatedPosts', { relationTo: 'posts' })
+ */
+export declare function relatedDocsField(name: string, opts: {
+    relationTo: string | string[];
+    label?: string;
+    description?: string;
+}): Record<string, FieldDefinition>;
+//# sourceMappingURL=presets.d.ts.map

package/dist/fields/presets.d.ts.map

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