@reverso/core 0.1.0

package/dist/utils/validation.js

@@ -0,0 +1,245 @@
+/**
+ * Validation schemas and utilities using Zod.
+ */
+import { z } from 'zod';
+import { PATH_SEPARATOR, REPEATER_PLACEHOLDER, VALID_ATTRIBUTES } from '../constants.js';
+/**
+ * All valid field types.
+ */
+export const FIELD_TYPES = [
+    'text',
+    'textarea',
+    'number',
+    'range',
+    'email',
+    'url',
+    'phone',
+    'wysiwyg',
+    'markdown',
+    'code',
+    'blocks',
+    'select',
+    'multiselect',
+    'checkbox',
+    'checkboxgroup',
+    'radio',
+    'boolean',
+    'image',
+    'file',
+    'gallery',
+    'video',
+    'audio',
+    'oembed',
+    'date',
+    'datetime',
+    'time',
+    'relation',
+    'taxonomy',
+    'link',
+    'pagelink',
+    'user',
+    'color',
+    'map',
+    'repeater',
+    'group',
+    'flexible',
+    'message',
+    'tab',
+    'accordion',
+    'buttongroup',
+];
+/**
+ * Zod schema for field type validation.
+ */
+export const fieldTypeSchema = z.enum(FIELD_TYPES);
+/**
+ * Zod schema for field path validation.
+ */
+export const fieldPathSchema = z.string().refine((path) => {
+    const parts = path.split(PATH_SEPARATOR);
+    if (parts.length < 3)
+        return false;
+    // All parts must be non-empty (except $ for repeaters)
+    return parts.every((part) => part === REPEATER_PLACEHOLDER || part.length > 0);
+}, {
+    message: 'Path must have at least 3 parts (page.section.field) and no empty parts',
+});
+/**
+ * Zod schema for field attributes validation.
+ */
+export const fieldAttributesSchema = z.object({
+    type: fieldTypeSchema.optional(),
+    label: z.string().optional(),
+    placeholder: z.string().optional(),
+    required: z.coerce.boolean().optional(),
+    validation: z.string().optional(),
+    options: z.string().optional(),
+    condition: z.string().optional(),
+    default: z.string().optional(),
+    help: z.string().optional(),
+    min: z.coerce.number().optional(),
+    max: z.coerce.number().optional(),
+    step: z.coerce.number().optional(),
+    accept: z.string().optional(),
+    multiple: z.coerce.boolean().optional(),
+    rows: z.coerce.number().optional(),
+    width: z.coerce.number().min(1).max(12).optional(),
+    readonly: z.coerce.boolean().optional(),
+    hidden: z.coerce.boolean().optional(),
+});
+/**
+ * Zod schema for a complete field schema.
+ */
+export const fieldSchema = fieldAttributesSchema.extend({
+    path: fieldPathSchema,
+    type: fieldTypeSchema,
+    file: z.string(),
+    line: z.number().positive(),
+    column: z.number().nonnegative(),
+    element: z.string().optional(),
+    defaultContent: z.string().optional(),
+});
+/**
+ * Validate a field type string.
+ */
+export function isValidFieldType(type) {
+    return FIELD_TYPES.includes(type);
+}
+/**
+ * Validate a field path string.
+ */
+export function isValidFieldPath(path) {
+    return fieldPathSchema.safeParse(path).success;
+}
+/**
+ * Validate field attributes.
+ */
+export function validateFieldAttributes(attrs) {
+    const result = fieldAttributesSchema.safeParse(attrs);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    return {
+        success: false,
+        errors: result.error.issues.map((e) => `${e.path.join('.')}: ${e.message}`),
+    };
+}
+/**
+ * Validate a complete field schema.
+ */
+export function validateFieldSchema(schema) {
+    const result = fieldSchema.safeParse(schema);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    return {
+        success: false,
+        errors: result.error.issues.map((e) => `${e.path.join('.')}: ${e.message}`),
+    };
+}
+/**
+ * Check if an attribute name is a valid data-reverso-* attribute.
+ */
+export function isValidAttribute(name) {
+    return VALID_ATTRIBUTES.includes(name);
+}
+/**
+ * Extract the attribute name from a data-reverso-* attribute.
+ *
+ * @example
+ * ```ts
+ * extractAttributeName('data-reverso-type') // 'type'
+ * extractAttributeName('data-reverso') // null
+ * extractAttributeName('data-other') // null
+ * ```
+ */
+export function extractAttributeName(attr) {
+    if (attr === 'data-reverso') {
+        return null; // This is the path attribute, not a named attribute
+    }
+    if (attr.startsWith('data-reverso-')) {
+        return attr.slice('data-reverso-'.length);
+    }
+    return null;
+}
+/**
+ * Parse options string into array of option objects.
+ *
+ * @example
+ * ```ts
+ * parseOptions('red,green,blue')
+ * // [{ label: 'Red', value: 'red' }, { label: 'Green', value: 'green' }, { label: 'Blue', value: 'blue' }]
+ *
+ * parseOptions('[{"label":"Red","value":"#f00"}]')
+ * // [{ label: 'Red', value: '#f00' }]
+ * ```
+ */
+export function parseOptions(optionsStr) {
+    // Handle empty/whitespace-only strings
+    const trimmed = optionsStr.trim();
+    if (!trimmed) {
+        return [];
+    }
+    // Try JSON first
+    if (trimmed.startsWith('[')) {
+        try {
+            const parsed = JSON.parse(trimmed);
+            return parsed
+                .filter((opt) => opt != null) // Filter out null/undefined
+                .map((opt) => {
+                if (typeof opt === 'string') {
+                    const value = opt.trim();
+                    return { label: formatOptionLabel(value), value };
+                }
+                if (typeof opt === 'object' && opt !== null && 'value' in opt) {
+                    const o = opt;
+                    const value = String(o.value ?? '').trim();
+                    const label = typeof o.label === 'string' && o.label.trim()
+                        ? o.label.trim()
+                        : formatOptionLabel(value);
+                    return { label, value };
+                }
+                // For numbers and other primitives
+                const value = String(opt).trim();
+                return { label: formatOptionLabel(value), value };
+            })
+                .filter((opt) => opt.value !== ''); // Filter out empty values
+        }
+        catch {
+            // Fall through to comma-separated
+        }
+    }
+    // Comma-separated values
+    return trimmed
+        .split(',')
+        .map((opt) => opt.trim())
+        .filter((opt) => opt !== '') // Filter out empty values
+        .map((value) => ({
+        label: formatOptionLabel(value),
+        value,
+    }));
+}
+/**
+ * Format an option value as a label.
+ */
+function formatOptionLabel(value) {
+    return value.replace(/[_-]/g, ' ').replace(/\b\w/g, (char) => char.toUpperCase());
+}
+/**
+ * Parse a condition string (basic format: field=value or field!=value).
+ */
+export function parseCondition(conditionStr) {
+    const operators = ['!=', '>=', '<=', '=', '>', '<'];
+    for (const op of operators) {
+        const index = conditionStr.indexOf(op);
+        if (index !== -1) {
+            return {
+                field: conditionStr.slice(0, index).trim(),
+                operator: op,
+                value: conditionStr.slice(index + op.length).trim(),
+            };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@reverso/core",
+  "version": "0.1.0",
+  "description": "Core types, utilities, and configuration system for Reverso CMS",
+  "homepage": "https://reverso.dev/docs/packages/core",
+  "bugs": {
+    "url": "https://github.com/hogrid/reverso/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src/",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist .turbo"
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hogrid/reverso.git",
+    "directory": "packages/core"
+  },
+  "keywords": [
+    "reverso",
+    "cms",
+    "core",
+    "types"
+  ],
+  "author": "Emerson Nunes <emerson@hogrid.com>",
+  "license": "MIT"
+}