@positronic/core 0.0.52 → 0.0.53

package/dist/src/ui/types.js

@@ -0,0 +1,165 @@
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _type_of(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+import { z } from 'zod';
+/**
+ * Infer the DataType from a sample value.
+ */ export function inferDataType(value) {
+    if (value === null) {
+        return {
+            kind: 'primitive',
+            type: 'null'
+        };
+    }
+    if (typeof value === 'string') {
+        return {
+            kind: 'primitive',
+            type: 'string'
+        };
+    }
+    if (typeof value === 'number') {
+        return {
+            kind: 'primitive',
+            type: 'number'
+        };
+    }
+    if (typeof value === 'boolean') {
+        return {
+            kind: 'primitive',
+            type: 'boolean'
+        };
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0) {
+            return {
+                kind: 'array',
+                elementType: {
+                    kind: 'unknown'
+                }
+            };
+        }
+        // Infer from first element
+        return {
+            kind: 'array',
+            elementType: inferDataType(value[0])
+        };
+    }
+    if ((typeof value === "undefined" ? "undefined" : _type_of(value)) === 'object') {
+        var properties = {};
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = Object.entries(value)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var _step_value = _sliced_to_array(_step.value, 2), key = _step_value[0], val = _step_value[1];
+                properties[key] = inferDataType(val);
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+        return {
+            kind: 'object',
+            properties: properties
+        };
+    }
+    return {
+        kind: 'unknown'
+    };
+}
+/**
+ * Type guard to check if a schema is form-compatible at runtime.
+ * Used as a backup validation when TypeScript inference isn't sufficient.
+ */ export function isFormSchema(schema) {
+    if (!_instanceof(schema, z.ZodObject)) {
+        return false;
+    }
+    var shape = schema.shape;
+    for(var key in shape){
+        if (!isFormField(shape[key])) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Type guard to check if a Zod schema is a valid form field.
+ */ function isFormField(schema) {
+    // Check for optional wrapper
+    if (_instanceof(schema, z.ZodOptional)) {
+        return isFormPrimitive(schema.unwrap());
+    }
+    // Check for array wrapper
+    if (_instanceof(schema, z.ZodArray)) {
+        return isFormPrimitive(schema.element);
+    }
+    // Check if it's a primitive directly
+    return isFormPrimitive(schema);
+}
+/**
+ * Type guard to check if a Zod schema is a form primitive.
+ */ function isFormPrimitive(schema) {
+    return _instanceof(schema, z.ZodString) || _instanceof(schema, z.ZodNumber) || _instanceof(schema, z.ZodBoolean) || _instanceof(schema, z.ZodEnum);
+}

package/dist/src/ui/validate-form.js

@@ -0,0 +1,428 @@
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function _array_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(arr);
+}
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _iterable_to_array(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _non_iterable_spread() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+import { z } from 'zod';
+import { inferDataType } from './types.js';
+// ============================================
+// BINDING UTILITIES
+// ============================================
+/**
+ * Check if a value is a binding expression like "{{path}}".
+ */ export function isBinding(value) {
+    return typeof value === 'string' && value.startsWith('{{') && value.endsWith('}}');
+}
+/**
+ * Extract the path from a binding expression.
+ * "{{email.subject}}" -> "email.subject"
+ */ export function extractBindingPath(binding) {
+    return binding.slice(2, -2).trim();
+}
+// ============================================
+// DATA BINDING VALIDATION
+// ============================================
+/**
+ * Components that create loop contexts.
+ * Children of these components can reference the loop variable.
+ */ var LOOP_COMPONENTS = {
+    List: {
+        itemsProp: 'items',
+        asProp: 'as',
+        defaultAs: 'item'
+    }
+};
+/**
+ * Resolve a path like "email.subject" against a DataType.
+ * Returns the type at that path, or null if invalid.
+ */ function resolvePathType(path, rootType, loopContext) {
+    var parts = path.split('.');
+    // Check if the first part is a loop variable
+    var loopVar = loopContext.get(parts[0]);
+    if (loopVar) {
+        if (parts.length === 1) {
+            return loopVar;
+        }
+        return resolvePathInType(parts.slice(1), loopVar);
+    }
+    return resolvePathInType(parts, rootType);
+}
+function resolvePathInType(parts, type) {
+    var current = type;
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = parts[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var part = _step.value;
+            if (current.kind === 'object') {
+                var prop = current.properties[part];
+                if (!prop) {
+                    return null;
+                }
+                current = prop;
+            } else if (current.kind === 'array') {
+                // Accessing array by index
+                if (/^\d+$/.test(part)) {
+                    current = current.elementType;
+                } else {
+                    // Trying to access a property on an array - invalid
+                    return null;
+                }
+            } else {
+                // Trying to access a property on a primitive
+                return null;
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return current;
+}
+/**
+ * Get the loop context for a placement by walking up the parent chain.
+ */ function getLoopContext(placement, placements, dataType) {
+    var context = new Map();
+    var current = placement;
+    while(current && current.parentId){
+        var parent = placements.find(function(p) {
+            return p.id === current.parentId;
+        });
+        if (!parent) break;
+        var loopConfig = LOOP_COMPONENTS[parent.component];
+        if (loopConfig) {
+            var itemsProp = parent.props[loopConfig.itemsProp];
+            var asProp = parent.props[loopConfig.asProp];
+            if (isBinding(itemsProp)) {
+                var itemsPath = extractBindingPath(itemsProp);
+                var itemsType = resolvePathType(itemsPath, dataType, context);
+                if (itemsType && itemsType.kind === 'array') {
+                    var loopVarName = typeof asProp === 'string' ? asProp : loopConfig.defaultAs;
+                    context.set(loopVarName, itemsType.elementType);
+                }
+            }
+        }
+        current = parent;
+    }
+    return context;
+}
+/**
+ * Check if a placement is inside a loop component.
+ */ function isInsideLoop(placement, placements) {
+    var current = placement;
+    while(current && current.parentId){
+        var parent = placements.find(function(p) {
+            return p.id === current.parentId;
+        });
+        if (!parent) break;
+        if (LOOP_COMPONENTS[parent.component]) {
+            return true;
+        }
+        current = parent;
+    }
+    return false;
+}
+/**
+ * Validate all data bindings in placements against the provided data type.
+ */ export function validateDataBindings(placements, data) {
+    var dataType = inferDataType(data);
+    var errors = [];
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = placements[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var placement = _step.value;
+            var loopContext = getLoopContext(placement, placements, dataType);
+            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+            try {
+                for(var _iterator1 = Object.entries(placement.props)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                    var _step_value = _sliced_to_array(_step1.value, 2), propName = _step_value[0], propValue = _step_value[1];
+                    if (isBinding(propValue)) {
+                        var path = extractBindingPath(propValue);
+                        var resolved = resolvePathType(path, dataType, loopContext);
+                        if (resolved === null) {
+                            errors.push({
+                                type: 'invalid-binding',
+                                message: 'Invalid binding "{{'.concat(path, '}}" - path does not exist in data'),
+                                path: "".concat(placement.component, ".").concat(propName)
+                            });
+                        }
+                    }
+                }
+            } catch (err) {
+                _didIteratorError1 = true;
+                _iteratorError1 = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                        _iterator1.return();
+                    }
+                } finally{
+                    if (_didIteratorError1) {
+                        throw _iteratorError1;
+                    }
+                }
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors: errors
+    };
+}
+// ============================================
+// FORM SCHEMA EXTRACTION
+// ============================================
+/**
+ * Components that contribute form fields.
+ * Maps component name -> how to extract field info.
+ */ var FORM_COMPONENTS = {
+    Input: {
+        nameProp: 'name',
+        fieldType: 'string'
+    },
+    TextArea: {
+        nameProp: 'name',
+        fieldType: 'string'
+    },
+    Checkbox: {
+        nameProp: 'name',
+        fieldType: 'boolean'
+    },
+    Select: {
+        nameProp: 'name',
+        fieldType: 'string'
+    },
+    MultiTextInput: {
+        nameProp: 'name',
+        fieldType: 'string[]'
+    },
+    HiddenInput: {
+        nameProp: 'name',
+        fieldType: 'string'
+    }
+};
+/**
+ * Extract form schema from placements.
+ * Finds all form input components and extracts their field info.
+ */ export function extractFormSchema(placements) {
+    var fields = [];
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        var _loop = function() {
+            var placement = _step.value;
+            var formComponent = FORM_COMPONENTS[placement.component];
+            if (formComponent) {
+                var nameProp = placement.props[formComponent.nameProp];
+                if (typeof nameProp === 'string') {
+                    var fieldType = formComponent.fieldType;
+                    // Special handling for Checkbox: if it has a value prop, it returns that string value
+                    if (placement.component === 'Checkbox' && placement.props.value !== undefined) {
+                        fieldType = 'string';
+                    }
+                    var insideLoop = isInsideLoop(placement, placements);
+                    // If inside a loop and it's a single value type, it becomes an array
+                    if (insideLoop && !fieldType.endsWith('[]')) {
+                        fieldType = "".concat(fieldType, "[]");
+                    }
+                    // Check if we already have this field (e.g., multiple checkboxes with same name)
+                    var existing = fields.find(function(f) {
+                        return f.name === nameProp;
+                    });
+                    if (existing) {
+                        // Multiple fields with same name = array
+                        if (!existing.type.endsWith('[]')) {
+                            existing.type = "".concat(existing.type, "[]");
+                        }
+                    } else {
+                        fields.push({
+                            name: nameProp,
+                            type: fieldType,
+                            insideLoop: insideLoop
+                        });
+                    }
+                }
+            }
+        };
+        for(var _iterator = placements[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true)_loop();
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return {
+        fields: fields
+    };
+}
+/**
+ * Validate extracted form schema against a Zod schema.
+ */ export function validateAgainstZod(extracted, zodSchema) {
+    var errors = [];
+    // Get the shape from the Zod schema
+    var shape = zodSchema.shape;
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        var _loop = function() {
+            var _step_value = _sliced_to_array(_step.value, 2), fieldName = _step_value[0], fieldSchema = _step_value[1];
+            var isOptional = _instanceof(fieldSchema, z.ZodOptional);
+            var extractedField = extracted.fields.find(function(f) {
+                return f.name === fieldName;
+            });
+            if (!isOptional && !extractedField) {
+                errors.push({
+                    type: 'form-schema-mismatch',
+                    message: "Missing required field: ".concat(fieldName),
+                    path: fieldName
+                });
+            }
+        };
+        // Check each schema field has a matching form field
+        for(var _iterator = Object.entries(shape)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true)_loop();
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors: errors
+    };
+}
+/**
+ * Create the ValidateForm tool for the UI generation agent.
+ * Validates both form schema and data bindings.
+ */ export function createValidateFormTool(placements, schema, data) {
+    return {
+        description: "Validate the current form structure. Checks that:\n1. Form fields will produce data matching the expected schema\n2. All data bindings (like {{email.subject}}) reference valid paths in the provided data\nCall this after building your form to verify it's correct.",
+        inputSchema: z.object({}),
+        execute: function() {
+            var _errors;
+            var errors = [];
+            // 1. Extract form schema from placements
+            var extracted = extractFormSchema(placements);
+            // 2. Validate against expected Zod schema (if provided)
+            if (schema) {
+                var _errors1;
+                var schemaResult = validateAgainstZod(extracted, schema);
+                (_errors1 = errors).push.apply(_errors1, _to_consumable_array(schemaResult.errors));
+            }
+            // 3. Validate all data bindings
+            var bindingResult = validateDataBindings(placements, data);
+            (_errors = errors).push.apply(_errors, _to_consumable_array(bindingResult.errors));
+            return {
+                valid: errors.length === 0,
+                errors: errors.map(function(e) {
+                    return {
+                        type: e.type,
+                        message: e.message
+                    };
+                }),
+                extractedFields: extracted.fields.map(function(f) {
+                    return {
+                        name: f.name,
+                        type: f.type
+                    };
+                })
+            };
+        }
+    };
+}