@positronic/core 0.0.52 → 0.0.53

package/dist/src/yaml/data-validator.js

@@ -0,0 +1,302 @@
+/**
+ * Data validator for YAML templates.
+ *
+ * Validates that template bindings (like {{email.subject}}) reference
+ * valid paths in the provided data structure.
+ */ 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 _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);
+}
+/**
+ * Infer a DataType from a sample JavaScript 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 element type 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'
+    };
+}
+/**
+ * Resolve a binding path against a data type, considering loop context.
+ *
+ * @param path - The binding path like "email.subject" or "emails"
+ * @param rootType - The root data type
+ * @param loopContext - Map of loop variable names to their types
+ * @returns The resolved DataType or null if path is invalid
+ */ export function resolvePathType(path, rootType, loopContext) {
+    var segments = path.split('.');
+    var firstSegment = segments[0];
+    // Check if first segment is a loop variable
+    if (loopContext.has(firstSegment)) {
+        var current = loopContext.get(firstSegment);
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = segments.slice(1)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var segment = _step.value;
+                if (current.kind !== 'object') {
+                    return null;
+                }
+                if (!(segment in current.properties)) {
+                    return null;
+                }
+                current = current.properties[segment];
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+        return current;
+    }
+    // Otherwise resolve against root type
+    var current1 = rootType;
+    var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+    try {
+        for(var _iterator1 = segments[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+            var segment1 = _step1.value;
+            if (current1.kind !== 'object') {
+                return null;
+            }
+            if (!(segment1 in current1.properties)) {
+                return null;
+            }
+            current1 = current1.properties[segment1];
+        }
+    } catch (err) {
+        _didIteratorError1 = true;
+        _iteratorError1 = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                _iterator1.return();
+            }
+        } finally{
+            if (_didIteratorError1) {
+                throw _iteratorError1;
+            }
+        }
+    }
+    return current1;
+}
+/**
+ * Validate all data bindings in a component tree.
+ *
+ * @param root - The root ComponentNode
+ * @param dataType - The inferred type of the available data
+ * @returns ValidationResult with any errors found
+ */ export function validateDataBindings(root, dataType) {
+    var errors = [];
+    function validateNode(node, loopContext) {
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            // Check all props for bindings
+            for(var _iterator = Object.entries(node.props)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var _step_value = _sliced_to_array(_step.value, 2), propName = _step_value[0], propValue = _step_value[1];
+                if (propValue.type === 'binding') {
+                    var resolved = resolvePathType(propValue.path, dataType, loopContext);
+                    if (resolved === null) {
+                        errors.push({
+                            type: 'invalid-binding',
+                            message: 'Invalid binding path "{{'.concat(propValue.path, '}}" in ').concat(node.component, ".").concat(propName),
+                            path: propValue.path
+                        });
+                    }
+                }
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+        // Handle List/Each components that create loop context
+        if (node.component === 'List' || node.component === 'Each') {
+            var itemsProp = node.props.items;
+            var asProp = node.props.as;
+            if ((itemsProp === null || itemsProp === void 0 ? void 0 : itemsProp.type) === 'binding') {
+                var itemsType = resolvePathType(itemsProp.path, dataType, loopContext);
+                if (itemsType && itemsType.kind === 'array') {
+                    // Create new loop context with the loop variable
+                    var varName = (asProp === null || asProp === void 0 ? void 0 : asProp.type) === 'literal' && typeof asProp.value === 'string' ? asProp.value : 'item';
+                    var newContext = new Map(loopContext);
+                    newContext.set(varName, itemsType.elementType);
+                    var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                    try {
+                        // Validate children with the new context
+                        for(var _iterator1 = node.children[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                            var child = _step1.value;
+                            validateNode(child, newContext);
+                        }
+                    } catch (err) {
+                        _didIteratorError1 = true;
+                        _iteratorError1 = err;
+                    } finally{
+                        try {
+                            if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                                _iterator1.return();
+                            }
+                        } finally{
+                            if (_didIteratorError1) {
+                                throw _iteratorError1;
+                            }
+                        }
+                    }
+                    return;
+                }
+            }
+        }
+        var _iteratorNormalCompletion2 = true, _didIteratorError2 = false, _iteratorError2 = undefined;
+        try {
+            // Validate children with current context
+            for(var _iterator2 = node.children[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true){
+                var child1 = _step2.value;
+                validateNode(child1, loopContext);
+            }
+        } catch (err) {
+            _didIteratorError2 = true;
+            _iteratorError2 = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion2 && _iterator2.return != null) {
+                    _iterator2.return();
+                }
+            } finally{
+                if (_didIteratorError2) {
+                    throw _iteratorError2;
+                }
+            }
+        }
+    }
+    validateNode(root, new Map());
+    return {
+        valid: errors.length === 0,
+        errors: errors
+    };
+}

package/dist/src/yaml/index.js

@@ -0,0 +1,9 @@
+/**
+ * YAML-based UI generation module.
+ *
+ * Provides parsing, validation, and type inference for YAML UI templates.
+ */ export * from './types.js';
+export { parseTemplate, stringifyTemplate } from './parser.js';
+export { inferDataType, resolvePathType, validateDataBindings } from './data-validator.js';
+export { extractFormSchema, fieldsToShape, validateAgainstZod } from './schema-extractor.js';
+export { describeDataShape, inferTypeWithExamples } from './type-inference.js';

package/dist/src/yaml/parser.js

@@ -0,0 +1,224 @@
+/**
+ * YAML parser for UI templates.
+ *
+ * Parses YAML strings into a ComponentNode AST. Uses the {{path}} syntax
+ * to detect binding expressions that will be resolved at render time.
+ */ 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 _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+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 { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+// Regex to match binding expressions like {{path}} or {{item.field}}
+var BINDING_REGEX = /^\{\{(.+)\}\}$/;
+/**
+ * Parse a prop value from YAML into either a binding or literal.
+ */ function parsePropValue(value) {
+    if (typeof value === 'string') {
+        var match = value.match(BINDING_REGEX);
+        if (match) {
+            return {
+                type: 'binding',
+                path: match[1].trim()
+            };
+        }
+        return {
+            type: 'literal',
+            value: value
+        };
+    }
+    if (typeof value === 'number' || typeof value === 'boolean' || value === null) {
+        return {
+            type: 'literal',
+            value: value
+        };
+    }
+    // For arrays or objects that aren't component definitions, treat as literals
+    return {
+        type: 'literal',
+        value: String(value)
+    };
+}
+/**
+ * Parse a single component node from the YAML object.
+ *
+ * YAML format:
+ * ```yaml
+ * Form:
+ *   action: "/submit"
+ *   children:
+ *     - Input:
+ *         name: "email"
+ *         label: "{{labels.email}}"
+ * ```
+ */ function parseComponentNode(obj) {
+    var keys = Object.keys(obj);
+    if (keys.length !== 1) {
+        throw new Error("Component object must have exactly one key (the component name), got: ".concat(keys.join(', ')));
+    }
+    var component = keys[0];
+    var propsOrChildren = obj[component];
+    // Handle case where component has no props (just the name)
+    if (propsOrChildren === null || propsOrChildren === undefined) {
+        return {
+            component: component,
+            props: {},
+            children: []
+        };
+    }
+    if ((typeof propsOrChildren === "undefined" ? "undefined" : _type_of(propsOrChildren)) !== 'object' || Array.isArray(propsOrChildren)) {
+        throw new Error('Component "'.concat(component, '" props must be an object, got: ').concat(typeof propsOrChildren === "undefined" ? "undefined" : _type_of(propsOrChildren)));
+    }
+    var rawProps = propsOrChildren;
+    var props = {};
+    var children = [];
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = Object.entries(rawProps)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var _step_value = _sliced_to_array(_step.value, 2), key = _step_value[0], value = _step_value[1];
+            if (key === 'children') {
+                // Children is an array of component nodes
+                if (!Array.isArray(value)) {
+                    throw new Error('"children" must be an array in component "'.concat(component, '"'));
+                }
+                children = value.map(function(child) {
+                    if ((typeof child === "undefined" ? "undefined" : _type_of(child)) !== 'object' || child === null) {
+                        throw new Error('Child must be a component object in "'.concat(component, '"'));
+                    }
+                    return parseComponentNode(child);
+                });
+            } else {
+                // Regular prop
+                props[key] = parsePropValue(value);
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return {
+        component: component,
+        props: props,
+        children: children
+    };
+}
+/**
+ * Parse a YAML template string into a Template AST.
+ *
+ * @param yamlString - The YAML template to parse
+ * @returns The parsed Template with root ComponentNode
+ * @throws Error if YAML is invalid or doesn't match expected structure
+ */ export function parseTemplate(yamlString) {
+    var parsed = parseYaml(yamlString);
+    if ((typeof parsed === "undefined" ? "undefined" : _type_of(parsed)) !== 'object' || parsed === null) {
+        throw new Error('Template must be a YAML object');
+    }
+    var root = parseComponentNode(parsed);
+    return {
+        root: root
+    };
+}
+/**
+ * Convert a Template back to YAML string (for debugging).
+ */ export function stringifyTemplate(template) {
+    function nodeToObject(node) {
+        var propsObj = {};
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = Object.entries(node.props)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var _step_value = _sliced_to_array(_step.value, 2), key = _step_value[0], propValue = _step_value[1];
+                if (propValue.type === 'binding') {
+                    propsObj[key] = "{{".concat(propValue.path, "}}");
+                } else {
+                    propsObj[key] = propValue.value;
+                }
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+        if (node.children.length > 0) {
+            propsObj.children = node.children.map(nodeToObject);
+        }
+        return _define_property({}, node.component, Object.keys(propsObj).length > 0 ? propsObj : null);
+    }
+    return stringifyYaml(nodeToObject(template.root));
+}