@formspec/dsl 0.1.0-alpha.2 → 0.1.0-alpha.21

package/dist/validation.js

@@ -1,186 +0,0 @@
-/**
- * Runtime validation for form specifications.
- *
- * Validates:
- * - No duplicate field names at the same scope level
- * - All field references in conditionals point to existing fields
- */
-/**
- * Collects all field names from a list of form elements.
- * Returns a Map of field name to count (for duplicate detection).
- */
-function collectFieldNames(elements, path = "") {
-    const fieldNames = new Map();
-    function visit(elements, currentPath) {
-        for (const element of elements) {
-            switch (element._type) {
-                case "field": {
-                    const field = element;
-                    const fieldPath = currentPath ? `${currentPath}.${field.name}` : field.name;
-                    const existing = fieldNames.get(field.name);
-                    if (existing) {
-                        existing.count++;
-                        existing.paths.push(fieldPath);
-                    }
-                    else {
-                        fieldNames.set(field.name, { count: 1, paths: [fieldPath] });
-                    }
-                    // Recurse into array items and object properties
-                    if (field._field === "array") {
-                        const arrayField = field;
-                        visit(arrayField.items, `${fieldPath}[]`);
-                    }
-                    else if (field._field === "object") {
-                        const objectField = field;
-                        visit(objectField.properties, fieldPath);
-                    }
-                    break;
-                }
-                case "group": {
-                    const group = element;
-                    const groupPath = currentPath ? `${currentPath}.[${group.label}]` : `[${group.label}]`;
-                    visit(group.elements, groupPath);
-                    break;
-                }
-                case "conditional": {
-                    const conditional = element;
-                    const conditionalPath = currentPath
-                        ? `${currentPath}.when(${conditional.field})`
-                        : `when(${conditional.field})`;
-                    visit(conditional.elements, conditionalPath);
-                    break;
-                }
-            }
-        }
-    }
-    visit(elements, path);
-    return fieldNames;
-}
-/**
- * Collects all field references from conditionals.
- * Returns a list of { fieldName, path } for each reference.
- */
-function collectConditionalReferences(elements, path = "") {
-    const references = [];
-    function visit(elements, currentPath) {
-        for (const element of elements) {
-            switch (element._type) {
-                case "field": {
-                    const field = element;
-                    const fieldPath = currentPath ? `${currentPath}.${field.name}` : field.name;
-                    // Recurse into array items and object properties
-                    if (field._field === "array") {
-                        const arrayField = field;
-                        visit(arrayField.items, `${fieldPath}[]`);
-                    }
-                    else if (field._field === "object") {
-                        const objectField = field;
-                        visit(objectField.properties, fieldPath);
-                    }
-                    break;
-                }
-                case "group": {
-                    const group = element;
-                    const groupPath = currentPath ? `${currentPath}.[${group.label}]` : `[${group.label}]`;
-                    visit(group.elements, groupPath);
-                    break;
-                }
-                case "conditional": {
-                    const conditional = element;
-                    const conditionalPath = currentPath
-                        ? `${currentPath}.when(${conditional.field})`
-                        : `when(${conditional.field})`;
-                    // Record this reference
-                    references.push({
-                        fieldName: conditional.field,
-                        path: conditionalPath,
-                    });
-                    // Continue visiting children
-                    visit(conditional.elements, conditionalPath);
-                    break;
-                }
-            }
-        }
-    }
-    visit(elements, path);
-    return references;
-}
-/**
- * Validates a form specification for common issues.
- *
- * Checks for:
- * - Duplicate field names at the root level (warning)
- * - References to non-existent fields in conditionals (error)
- *
- * @example
- * ```typescript
- * const form = formspec(
- *   field.text("name"),
- *   field.text("name"), // Duplicate!
- *   when("nonExistent", "value", // Reference to non-existent field!
- *     field.text("extra"),
- *   ),
- * );
- *
- * const result = validateForm(form.elements);
- * // result.valid === false
- * // result.issues contains duplicate and reference errors
- * ```
- *
- * @param elements - The form elements to validate
- * @returns Validation result with any issues found
- */
-export function validateForm(elements) {
-    const issues = [];
-    // Collect all field names
-    const fieldNames = collectFieldNames(elements);
-    // Check for duplicates at root level
-    for (const [name, info] of fieldNames) {
-        if (info.count > 1 && info.paths[0] !== undefined) {
-            issues.push({
-                severity: "warning",
-                message: `Duplicate field name "${name}" found ${info.count} times at: ${info.paths.join(", ")}`,
-                path: info.paths[0],
-            });
-        }
-    }
-    // Collect conditional references
-    const references = collectConditionalReferences(elements);
-    // Check that all referenced fields exist
-    for (const ref of references) {
-        if (!fieldNames.has(ref.fieldName)) {
-            issues.push({
-                severity: "error",
-                message: `Conditional references non-existent field "${ref.fieldName}"`,
-                path: ref.path,
-            });
-        }
-    }
-    return {
-        valid: issues.every((issue) => issue.severity !== "error"),
-        issues,
-    };
-}
-/**
- * Logs validation issues to the console.
- *
- * @param result - The validation result to log
- * @param formName - Optional name for the form (for better error messages)
- */
-export function logValidationIssues(result, formName) {
-    if (result.issues.length === 0) {
-        return;
-    }
-    const prefix = formName ? `FormSpec "${formName}"` : "FormSpec";
-    for (const issue of result.issues) {
-        const location = issue.path ? ` at ${issue.path}` : "";
-        const message = `${prefix}: ${issue.message}${location}`;
-        if (issue.severity === "error") {
-            console.error(message);
-        }
-        else {
-            console.warn(message);
-        }
-    }
-}
-//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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