@revealui/contracts 1.0.0

package/dist/cms/extensibility.js

@@ -0,0 +1,313 @@
+/**
+ * Extensibility Contracts
+ *
+ * Contracts for extending the CMS type system with:
+ * - Custom field types (from plugins)
+ * - Plugin field extensions
+ * - Custom validation rules
+ *
+ * @module @revealui/contracts/core/contracts/extensibility
+ */
+import { z } from 'zod/v4';
+// Global registry instance
+const customFieldTypeRegistry = {};
+/**
+ * Register a custom field type
+ *
+ * Call this from plugins to add new field types.
+ *
+ * @example
+ * ```typescript
+ * // In your plugin
+ * registerCustomFieldType('color-picker', {
+ *   description: 'A color picker field',
+ *   defaultValue: '#000000',
+ *   validate: (value) => {
+ *     if (typeof value !== 'string') return 'Color must be a string';
+ *     if (!/^#[0-9a-f]{6}$/i.test(value)) return 'Invalid hex color';
+ *     return true;
+ *   },
+ * });
+ * ```
+ */
+export function registerCustomFieldType(typeName, config) {
+    // Silently overwrite existing types - last registration wins
+    customFieldTypeRegistry[typeName] = config;
+}
+/**
+ * Get a registered custom field type
+ */
+export function getCustomFieldType(typeName) {
+    return customFieldTypeRegistry[typeName];
+}
+/**
+ * Get all registered custom field types
+ */
+export function getCustomFieldTypes() {
+    return { ...customFieldTypeRegistry };
+}
+/**
+ * Unregister a custom field type (mainly for testing)
+ */
+export function unregisterCustomFieldType(typeName) {
+    Reflect.deleteProperty(customFieldTypeRegistry, typeName);
+}
+/**
+ * Clear all custom field types (mainly for testing)
+ */
+export function clearCustomFieldTypes() {
+    for (const key of Object.keys(customFieldTypeRegistry)) {
+        Reflect.deleteProperty(customFieldTypeRegistry, key);
+    }
+}
+/**
+ * Built-in field types in RevealUI CMS
+ */
+export const BUILTIN_FIELD_TYPES = [
+    'text',
+    'textarea',
+    'number',
+    'email',
+    'password',
+    'code',
+    'date',
+    'checkbox',
+    'select',
+    'radio',
+    'relationship',
+    'upload',
+    'array',
+    'blocks',
+    'group',
+    'row',
+    'collapsible',
+    'tabs',
+    'richText',
+    'json',
+    'point',
+    'ui',
+];
+/**
+ * Check if a field type is valid (built-in or custom)
+ */
+export function isValidFieldType(type) {
+    return BUILTIN_FIELD_TYPES.includes(type) || type in customFieldTypeRegistry;
+}
+/**
+ * Get all valid field types (built-in + custom)
+ */
+export function getValidFieldTypes() {
+    return [...BUILTIN_FIELD_TYPES, ...Object.keys(customFieldTypeRegistry)];
+}
+/**
+ * Extended field type schema that includes custom types
+ *
+ * Use this schema when validating field configs that may include
+ * custom field types from plugins.
+ */
+export const ExtendedFieldTypeSchema = z.string().refine((type) => isValidFieldType(type), {
+    message: `Invalid field type. Valid types: ${getValidFieldTypes().join(', ')}`,
+});
+// Registry of plugin extensions
+const pluginExtensions = [];
+/**
+ * Register a plugin field extension
+ *
+ * @example
+ * ```typescript
+ * registerPluginExtension({
+ *   pluginName: 'seo-plugin',
+ *   globalFields: [
+ *     { name: 'metaTitle', type: 'text', admin: { position: 'sidebar' } },
+ *     { name: 'metaDescription', type: 'textarea' },
+ *   ],
+ *   collectionFields: {
+ *     posts: [
+ *       { name: 'canonicalUrl', type: 'text' },
+ *     ],
+ *   },
+ * });
+ * ```
+ */
+export function registerPluginExtension(extension) {
+    // Register any custom field types from this plugin
+    if (extension.customFieldTypes) {
+        for (const { name, config } of extension.customFieldTypes) {
+            registerCustomFieldType(name, config);
+        }
+    }
+    pluginExtensions.push(extension);
+    // Sort by priority
+    pluginExtensions.sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
+}
+/**
+ * Get all registered plugin extensions
+ */
+export function getPluginExtensions() {
+    return [...pluginExtensions];
+}
+/**
+ * Clear all plugin extensions (mainly for testing)
+ */
+export function clearPluginExtensions() {
+    pluginExtensions.length = 0;
+}
+/**
+ * Apply plugin field extensions to a collection config
+ *
+ * This is called during config finalization to add plugin-provided fields.
+ *
+ * @param config - The base collection config
+ * @returns The config with plugin fields added
+ */
+export function applyPluginExtensions(config) {
+    let result = { ...config, fields: [...config.fields] };
+    const { slug } = config;
+    for (const extension of pluginExtensions) {
+        // Add global fields
+        if (extension.globalFields) {
+            result = {
+                ...result,
+                fields: [...result.fields, ...extension.globalFields],
+            };
+        }
+        // Add collection-specific fields
+        if (extension.collectionFields && slug in extension.collectionFields) {
+            const collectionSpecificFields = extension.collectionFields[slug];
+            if (collectionSpecificFields) {
+                result = {
+                    ...result,
+                    fields: [...result.fields, ...collectionSpecificFields],
+                };
+            }
+        }
+        // Apply beforeFinalize hook
+        if (extension.beforeFinalize) {
+            result = extension.beforeFinalize(result);
+        }
+    }
+    return result;
+}
+// Global validation rules registry
+const validationRules = {};
+/**
+ * Register a custom validation rule
+ *
+ * @example
+ * ```typescript
+ * registerValidationRule({
+ *   name: 'slug-format',
+ *   validate: (value) => {
+ *     if (typeof value !== 'string') return 'Must be a string';
+ *     if (!/^[a-z0-9-]+$/.test(value)) {
+ *       return 'Slug must contain only lowercase letters, numbers, and hyphens';
+ *     }
+ *     return true;
+ *   },
+ *   description: 'Validates URL-safe slug format',
+ * });
+ * ```
+ */
+export function registerValidationRule(rule) {
+    validationRules[rule.name] = rule;
+}
+/**
+ * Get a validation rule by name
+ */
+export function getValidationRule(name) {
+    return validationRules[name];
+}
+/**
+ * Get all registered validation rules
+ */
+export function getValidationRules() {
+    return { ...validationRules };
+}
+/**
+ * Run a validation rule against a value
+ */
+export function runValidationRule(ruleName, value, options) {
+    const rule = validationRules[ruleName];
+    if (!rule) {
+        return `Unknown validation rule: ${ruleName}`;
+    }
+    return rule.validate(value, options);
+}
+// ============================================
+// TYPE EXTENSION UTILITIES
+// ============================================
+/**
+ * Merge field arrays, handling conflicts by name
+ *
+ * Later fields override earlier fields with the same name.
+ */
+export function mergeFields(base, additions) {
+    const fieldMap = new Map();
+    // Add base fields
+    for (const field of base) {
+        const { name } = field;
+        if (name) {
+            fieldMap.set(name, field);
+        }
+    }
+    // Override/add additional fields
+    for (const field of additions) {
+        const { name } = field;
+        if (name) {
+            fieldMap.set(name, field);
+        }
+    }
+    // Rebuild array, preserving order of base with additions at end
+    const result = [];
+    const addedNames = new Set();
+    for (const field of base) {
+        const { name } = field;
+        if (name) {
+            const mappedField = fieldMap.get(name);
+            if (mappedField) {
+                result.push(mappedField);
+                addedNames.add(name);
+                continue;
+            }
+        }
+        result.push(field);
+    }
+    // Add any new fields not in base
+    for (const field of additions) {
+        const { name } = field;
+        if (name && !addedNames.has(name)) {
+            result.push(field);
+        }
+    }
+    return result;
+}
+/**
+ * Deep merge two collection configs
+ */
+export function mergeCollectionConfigs(base, overrides) {
+    const baseAccess = base.access ?? {};
+    const baseHooks = base.hooks ?? {};
+    const baseAdmin = base.admin ?? {};
+    const result = {
+        ...base,
+        ...overrides,
+        fields: overrides.fields ? mergeFields(base.fields, overrides.fields) : base.fields,
+    };
+    if (overrides.access) {
+        result.access = { ...baseAccess, ...overrides.access };
+    }
+    if (overrides.hooks) {
+        result.hooks = {
+            ...baseHooks,
+            ...overrides.hooks,
+            // Merge hook arrays
+            beforeChange: [...(baseHooks.beforeChange ?? []), ...(overrides.hooks.beforeChange ?? [])],
+            afterChange: [...(baseHooks.afterChange ?? []), ...(overrides.hooks.afterChange ?? [])],
+        };
+    }
+    if (overrides.admin) {
+        result.admin = { ...baseAdmin, ...overrides.admin };
+    }
+    return result;
+}
+//# sourceMappingURL=extensibility.js.map

package/dist/cms/extensibility.js.map

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

package/dist/cms/field.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Field Contract
+ *
+ * Unified contract for Field configurations that combines:
+ * - TypeScript types (compile-time)
+ * - Zod schemas (runtime validation)
+ * - Validation functions
+ * - Type guards
+ *
+ * This is the single source of truth for Field definitions.
+ *
+ * @module @revealui/contracts/core/contracts/field
+ */
+import { type Contract, type ContractType } from '../foundation/contract.js';
+import type { Field } from './config.js';
+import { type FieldStructure } from './structure.js';
+/**
+ * Field Contract
+ *
+ * This contract validates Field configurations at runtime
+ * and provides TypeScript types at compile time.
+ */
+export declare const FieldContract: Contract<FieldStructure>;
+/**
+ * Type for Field configuration
+ * Extracted from the FieldContract
+ */
+export type FieldContractType = ContractType<typeof FieldContract>;
+/**
+ * Validate a field configuration
+ */
+export declare function validateField(data: unknown): ReturnType<typeof FieldContract.validate>;
+/**
+ * Type guard for field configurations
+ */
+export declare function isFieldConfig(data: unknown): data is FieldContractType;
+/**
+ * Parse field configuration (throws on validation failure)
+ */
+export declare function parseField(data: unknown): FieldContractType;
+/**
+ * Type guard for text fields
+ */
+export declare function isTextField(field: Field): boolean;
+/**
+ * Type guard for number fields
+ */
+export declare function isNumberField(field: Field): boolean;
+/**
+ * Type guard for relationship fields
+ */
+export declare function isRelationshipField(field: Field): boolean;
+/**
+ * Type guard for array fields
+ */
+export declare function isArrayField(field: Field): boolean;
+/**
+ * Type guard for group fields
+ */
+export declare function isGroupField(field: Field): boolean;
+/**
+ * Type guard for layout fields (row, tabs, collapsible)
+ */
+export declare function isLayoutField(field: Field): boolean;
+/**
+ * Check if a field has nested fields
+ */
+export declare function hasNestedFields(field: Field): boolean;
+//# sourceMappingURL=field.d.ts.map

package/dist/cms/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/cms/field.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAkB,MAAM,2BAA2B,CAAA;AAC5F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,KAAK,cAAc,EAAwB,MAAM,gBAAgB,CAAA;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,cAAc,CAOjD,CAAA;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,CAAA;AAElE;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,QAAQ,CAAC,CAEtF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,iBAAiB,CAEtE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAE3D;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAKrD"}

package/dist/cms/field.js

@@ -0,0 +1,94 @@
+/**
+ * Field Contract
+ *
+ * Unified contract for Field configurations that combines:
+ * - TypeScript types (compile-time)
+ * - Zod schemas (runtime validation)
+ * - Validation functions
+ * - Type guards
+ *
+ * This is the single source of truth for Field definitions.
+ *
+ * @module @revealui/contracts/core/contracts/field
+ */
+import { createContract } from '../foundation/contract.js';
+import { FieldStructureSchema } from './structure.js';
+/**
+ * Field Contract
+ *
+ * This contract validates Field configurations at runtime
+ * and provides TypeScript types at compile time.
+ */
+export const FieldContract = createContract({
+    name: 'Field',
+    version: '1.0.0',
+    schema: FieldStructureSchema,
+    description: 'Field configuration contract',
+    docsUrl: 'https://revealui.dev/docs/api-reference/fields',
+    tags: ['field', 'config', 'cms'],
+});
+/**
+ * Validate a field configuration
+ */
+export function validateField(data) {
+    return FieldContract.validate(data);
+}
+/**
+ * Type guard for field configurations
+ */
+export function isFieldConfig(data) {
+    return FieldContract.isType(data);
+}
+/**
+ * Parse field configuration (throws on validation failure)
+ */
+export function parseField(data) {
+    return FieldContract.parse(data);
+}
+// =============================================================================
+// Type Guards
+// =============================================================================
+/**
+ * Type guard for text fields
+ */
+export function isTextField(field) {
+    return field.type === 'text';
+}
+/**
+ * Type guard for number fields
+ */
+export function isNumberField(field) {
+    return field.type === 'number';
+}
+/**
+ * Type guard for relationship fields
+ */
+export function isRelationshipField(field) {
+    return field.type === 'relationship';
+}
+/**
+ * Type guard for array fields
+ */
+export function isArrayField(field) {
+    return field.type === 'array';
+}
+/**
+ * Type guard for group fields
+ */
+export function isGroupField(field) {
+    return field.type === 'group';
+}
+/**
+ * Type guard for layout fields (row, tabs, collapsible)
+ */
+export function isLayoutField(field) {
+    return ['row', 'tabs', 'collapsible'].includes(field.type);
+}
+/**
+ * Check if a field has nested fields
+ */
+export function hasNestedFields(field) {
+    return (['array', 'group', 'row', 'collapsible'].includes(field.type) ||
+        (field.type === 'tabs' && !!field.tabs));
+}
+//# sourceMappingURL=field.js.map

package/dist/cms/field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.js","sourceRoot":"","sources":["../../src/cms/field.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAoC,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE5F,OAAO,EAAuB,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAE1E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAA6B,cAAc,CAAC;IACpE,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,oBAAoB;IAC5B,WAAW,EAAE,8BAA8B;IAC3C,OAAO,EAAE,gDAAgD;IACzD,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC;CACjC,CAAC,CAAA;AAQF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,OAAO,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,OAAO,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAClC,CAAC;AAED,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAA;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAY;IACxC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAA;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAY;IAC9C,OAAO,KAAK,CAAC,IAAI,KAAK,cAAc,CAAA;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAA;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAA;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAY;IACxC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAY;IAC1C,OAAO,CACL,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7D,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CACxC,CAAA;AACH,CAAC"}