regor 1.4.6 → 1.4.8

package/dist/regor.es2019.iife.js

@@ -209,9 +209,184 @@ var Regor = (() => {
     (_b = context.unmounted) == null ? void 0 : _b.call(context);
   };
 
+  // src/log/warnings.ts
+  var warnings = {
+    [8 /* ModelRequiresRef */]: (el) => `Model binding requires a ref at ${el.outerHTML}`,
+    [7 /* ModelNotSupportOnElement */]: (el) => `Model binding is not supported on ${el.tagName} element at ${el.outerHTML}`,
+    [0 /* MissingBindingExpression */]: (name, el) => `${name} binding expression is missing at ${el.outerHTML}`,
+    [1 /* InvalidForExpression */]: (name, forPath, el) => `invalid ${name} expression: ${forPath} at ${el.outerHTML}`,
+    [2 /* BindingRequiresObjectExpressions */]: (name, el) => `${name} requires object expression at ${el.outerHTML}`,
+    [3 /* KeyIsEmpty */]: (name, el) => `${name} binder: key is empty on ${el.outerHTML}.`,
+    [4 /* PropertyAssignmentFailed */]: (key, tag, value, e) => ({
+      msg: `Failed setting prop "${key}" on <${tag.toLowerCase()}>: value ${value} is invalid.`,
+      args: [e]
+    }),
+    [5 /* MissingEventType */]: (name, el) => `${name} binding missing event type at ${el.outerHTML}`,
+    [6 /* ErrorLog */]: (msg, e) => ({ msg, args: [e] })
+  };
+  var warning = (type, ...args) => {
+    const msg = warnings[type];
+    const item = isFunction(msg) ? msg.call(warnings, ...args) : msg;
+    const handler = warningHandler.warning;
+    if (!handler) return;
+    if (isString(item)) handler(item);
+    else handler(item, ...item.args);
+  };
+  var warningHandler = {
+    warning: console.warn
+  };
+
+  // src/reactivity/refSymbols.ts
+  var refSymbol = Symbol("ref");
+  var srefSymbol = Symbol("sref");
+  var rawSymbol = Symbol("raw");
+
+  // src/reactivity/isRef.ts
+  var isRef = (value) => {
+    return value != null && value[srefSymbol] === 1;
+  };
+
+  // src/app/propValidators.ts
+  var PropValidationError = class extends Error {
+    constructor(propPath, detail) {
+      super(detail);
+      __publicField(this, "propPath");
+      __publicField(this, "detail");
+      this.name = "PropValidationError";
+      this.propPath = propPath;
+      this.detail = detail;
+    }
+  };
+  var fail = (name, message) => {
+    throw new PropValidationError(name, `${message}.`);
+  };
+  var describeValue = (value) => {
+    var _a;
+    if (value === null) return "null";
+    if (value === void 0) return "undefined";
+    if (typeof value === "string") return "string";
+    if (typeof value === "number") return "number";
+    if (typeof value === "boolean") return "boolean";
+    if (typeof value === "bigint") return "bigint";
+    if (typeof value === "symbol") return "symbol";
+    if (typeof value === "function") return "function";
+    if (isArray(value)) return "array";
+    if (value instanceof Date) return "Date";
+    if (value instanceof RegExp) return "RegExp";
+    if (value instanceof Map) return "Map";
+    if (value instanceof Set) return "Set";
+    const ctorName = (_a = value == null ? void 0 : value.constructor) == null ? void 0 : _a.name;
+    return ctorName && ctorName !== "Object" ? ctorName : "object";
+  };
+  var formatLiteral = (value) => {
+    if (typeof value === "string") return `"${value}"`;
+    if (typeof value === "number" || typeof value === "boolean") {
+      return String(value);
+    }
+    if (value === null) return "null";
+    if (value === void 0) return "undefined";
+    return describeValue(value);
+  };
+  var isString2 = (value, name) => {
+    if (typeof value !== "string") fail(name, "expected string");
+  };
+  var isNumber = (value, name) => {
+    if (typeof value !== "number") fail(name, "expected number");
+  };
+  var isBoolean = (value, name) => {
+    if (typeof value !== "boolean") fail(name, "expected boolean");
+  };
+  var isClass = (ctor) => {
+    return (value, name) => {
+      if (!(value instanceof ctor)) {
+        fail(name, `expected instance of ${ctor.name || "provided class"}`);
+      }
+    };
+  };
+  var optional = (validator) => {
+    return (value, name, head) => {
+      if (value === void 0) return;
+      validator(value, name, head);
+    };
+  };
+  var nullable = (validator) => {
+    return (value, name, head) => {
+      if (value === null) return;
+      validator(value, name, head);
+    };
+  };
+  var oneOf = (values) => {
+    return (value, name) => {
+      if (values.includes(value)) return;
+      fail(
+        name,
+        `expected one of ${values.map((x) => formatLiteral(x)).join(", ")}`
+      );
+    };
+  };
+  var arrayOf = (validator) => {
+    return (value, name, head) => {
+      if (!isArray(value)) fail(name, "expected array");
+      const items = value;
+      for (let i = 0; i < items.length; ++i) {
+        validator(items[i], `${name}[${i}]`, head);
+      }
+    };
+  };
+  var shape = (schema) => {
+    return (value, name, head) => {
+      if (!isObject(value)) fail(name, "expected object");
+      const record = value;
+      for (const key in schema) {
+        const validator = schema[key];
+        validator(record[key], `${name}.${key}`, head);
+      }
+    };
+  };
+  var refOf = (validator) => {
+    return (value, name, head) => {
+      if (!isRef(value)) fail(name, "expected ref");
+      const refValue = value;
+      validator(refValue(), `${name}.value`, head);
+    };
+  };
+  var pval = {
+    fail,
+    isString: isString2,
+    isNumber,
+    isBoolean,
+    isClass,
+    optional,
+    nullable,
+    oneOf,
+    arrayOf,
+    shape,
+    refOf
+  };
+
   // src/app/ComponentHead.ts
+  var formatComponentValidationError = (element, propName, error) => {
+    var _a, _b;
+    const tagName = ((_b = (_a = element.tagName) == null ? void 0 : _a.toLowerCase) == null ? void 0 : _b.call(_a)) || "unknown";
+    const finalPropName = error instanceof PropValidationError ? error.propPath : propName;
+    const detail = error instanceof PropValidationError ? error.detail : error instanceof Error ? error.message : String(error);
+    if (error instanceof Error) {
+      return new Error(
+        `Invalid prop "${finalPropName}" on <${tagName}>: ${detail}`,
+        {
+          cause: error
+        }
+      );
+    }
+    return new Error(
+      `Invalid prop "${finalPropName}" on <${tagName}>: ${detail}`,
+      {
+        cause: error
+      }
+    );
+  };
   var ComponentHead = class {
-    constructor(props, element, ctx, start, end) {
+    constructor(props, element, ctx, start, end, propValidationMode) {
       /**
        * Values provided by parent for this component instance.
        *
@@ -298,6 +473,11 @@ var Regor = (() => {
        * @internal
        */
       __publicField(this, "__element");
+      /**
+       * Runtime behavior used when `validateProps(...)` encounters invalid input.
+       * Defaults to `'throw'`.
+       */
+      __publicField(this, "__propValidationMode");
       /**
        * Emits a custom DOM event from the component host element.
        *
@@ -321,6 +501,7 @@ var Regor = (() => {
       this.ctx = ctx;
       this.start = start;
       this.end = end;
+      this.__propValidationMode = propValidationMode;
     }
     /**
      * Finds a parent context instance by constructor type from the captured
@@ -383,7 +564,7 @@ var Regor = (() => {
       );
     }
     /**
-     * Validates selected incoming props using assertion-style validators.
+     * Validates selected incoming props at runtime.
      *
      * Only keys listed in `schema` are checked. Validation throws immediately
      * on the first invalid prop and does not mutate `head.props`.
@@ -392,7 +573,8 @@ var Regor = (() => {
      * known prop names while still allowing you to validate only a subset.
      *
      * Validators typically come from `pval`, but custom user validators are also
-     * supported.
+     * supported. Custom validators may throw their own `Error`, though `pval.fail(...)`
+     * is recommended so nested validators can preserve the exact failing prop path.
      *
      * Example:
      * ```ts
@@ -402,15 +584,38 @@ var Regor = (() => {
      * })
      * ```
      *
+     * Example with a custom validator:
+     * ```ts
+     * const isNonEmptyString: PropValidator<string> = (value, name) => {
+     *   if (typeof value !== 'string' || value.trim() === '') {
+     *     pval.fail(name, 'expected non-empty string')
+     *   }
+     * }
+     * ```
+     *
      * @param schema - Validators to apply to selected incoming props.
      */
     validateProps(schema) {
+      if (this.__propValidationMode === "off") return;
       const props = this.props;
       for (const name in schema) {
         const validator = schema[name];
         if (!validator) continue;
         const validateProp = validator;
-        validateProp(props[name], name, this);
+        try {
+          validateProp(props[name], name, this);
+        } catch (error) {
+          const enrichedError = formatComponentValidationError(
+            this.__element,
+            name,
+            error
+          );
+          if (this.__propValidationMode === "warn") {
+            warningHandler.warning(enrichedError.message, enrichedError);
+            continue;
+          }
+          throw enrichedError;
+        }
       }
     }
     /**
@@ -446,33 +651,6 @@ var Regor = (() => {
     getBindData(node).unbinders.push(unbinder);
   };
 
-  // src/log/warnings.ts
-  var warnings = {
-    [8 /* ModelRequiresRef */]: (el) => `Model binding requires a ref at ${el.outerHTML}`,
-    [7 /* ModelNotSupportOnElement */]: (el) => `Model binding is not supported on ${el.tagName} element at ${el.outerHTML}`,
-    [0 /* MissingBindingExpression */]: (name, el) => `${name} binding expression is missing at ${el.outerHTML}`,
-    [1 /* InvalidForExpression */]: (name, forPath, el) => `invalid ${name} expression: ${forPath} at ${el.outerHTML}`,
-    [2 /* BindingRequiresObjectExpressions */]: (name, el) => `${name} requires object expression at ${el.outerHTML}`,
-    [3 /* KeyIsEmpty */]: (name, el) => `${name} binder: key is empty on ${el.outerHTML}.`,
-    [4 /* PropertyAssignmentFailed */]: (key, tag, value, e) => ({
-      msg: `Failed setting prop "${key}" on <${tag.toLowerCase()}>: value ${value} is invalid.`,
-      args: [e]
-    }),
-    [5 /* MissingEventType */]: (name, el) => `${name} binding missing event type at ${el.outerHTML}`,
-    [6 /* ErrorLog */]: (msg, e) => ({ msg, args: [e] })
-  };
-  var warning = (type, ...args) => {
-    const msg = warnings[type];
-    const item = isFunction(msg) ? msg.call(warnings, ...args) : msg;
-    const handler = warningHandler.warning;
-    if (!handler) return;
-    if (isString(item)) handler(item);
-    else handler(item, ...item.args);
-  };
-  var warningHandler = {
-    warning: console.warn
-  };
-
   // src/bind/switch.ts
   var switches = {};
   var switchCounter = {};
@@ -878,16 +1056,6 @@ var Regor = (() => {
     return scopeSymbol2 in value;
   };
 
-  // src/reactivity/refSymbols.ts
-  var refSymbol = Symbol("ref");
-  var srefSymbol = Symbol("sref");
-  var rawSymbol = Symbol("raw");
-
-  // src/reactivity/isRef.ts
-  var isRef = (value) => {
-    return value != null && value[srefSymbol] === 1;
-  };
-
   // src/directives/context.ts
   var contextDirective = {
     collectRefObj: true,
@@ -1460,7 +1628,8 @@ var Regor = (() => {
             component,
             capturedContext,
             startOfComponent,
-            endOfComponent
+            endOfComponent,
+            binder.__config.propValidationMode
           );
           const componentCtx2 = useScope(() => {
             var _a2;
@@ -3888,6 +4057,15 @@ var Regor = (() => {
       __publicField(this, "forGrowThreshold", 10);
       __publicField(this, "globalContext");
       __publicField(this, "useInterpolation", true);
+      /**
+       * Controls how `head.validateProps(...)` behaves when a validator fails.
+       *
+       * - `'throw'` (default): rethrows the validation error immediately.
+       * - `'warn'`: forwards the validation error to `warningHandler.warning(...)`
+       *   and continues.
+       * - `'off'`: skips runtime prop validation entirely.
+       */
+      __publicField(this, "propValidationMode", "throw");
       this.setDirectives("r-");
       if (globalContext) {
         this.globalContext = globalContext;
@@ -6169,113 +6347,6 @@ var Regor = (() => {
     };
   };
 
-  // src/app/propValidators.ts
-  var fail = (name, message) => {
-    throw new Error(`Invalid prop "${name}": ${message}.`);
-  };
-  var describeValue = (value) => {
-    var _a;
-    if (value === null) return "null";
-    if (value === void 0) return "undefined";
-    if (typeof value === "string") return "string";
-    if (typeof value === "number") return "number";
-    if (typeof value === "boolean") return "boolean";
-    if (typeof value === "bigint") return "bigint";
-    if (typeof value === "symbol") return "symbol";
-    if (typeof value === "function") return "function";
-    if (isArray(value)) return "array";
-    if (value instanceof Date) return "Date";
-    if (value instanceof RegExp) return "RegExp";
-    if (value instanceof Map) return "Map";
-    if (value instanceof Set) return "Set";
-    const ctorName = (_a = value == null ? void 0 : value.constructor) == null ? void 0 : _a.name;
-    return ctorName && ctorName !== "Object" ? ctorName : "object";
-  };
-  var formatLiteral = (value) => {
-    if (typeof value === "string") return `"${value}"`;
-    if (typeof value === "number" || typeof value === "boolean") {
-      return String(value);
-    }
-    if (value === null) return "null";
-    if (value === void 0) return "undefined";
-    return describeValue(value);
-  };
-  var isString2 = (value, name) => {
-    if (typeof value !== "string") fail(name, "expected string");
-  };
-  var isNumber = (value, name) => {
-    if (typeof value !== "number") fail(name, "expected number");
-  };
-  var isBoolean = (value, name) => {
-    if (typeof value !== "boolean") fail(name, "expected boolean");
-  };
-  var isClass = (ctor) => {
-    return (value, name) => {
-      if (!(value instanceof ctor)) {
-        fail(name, `expected instance of ${ctor.name || "provided class"}`);
-      }
-    };
-  };
-  var optional = (validator) => {
-    return (value, name, head) => {
-      if (value === void 0) return;
-      validator(value, name, head);
-    };
-  };
-  var nullable = (validator) => {
-    return (value, name, head) => {
-      if (value === null) return;
-      validator(value, name, head);
-    };
-  };
-  var oneOf = (values) => {
-    return (value, name) => {
-      if (values.includes(value)) return;
-      fail(
-        name,
-        `expected one of ${values.map((x) => formatLiteral(x)).join(", ")}`
-      );
-    };
-  };
-  var arrayOf = (validator) => {
-    return (value, name, head) => {
-      if (!isArray(value)) fail(name, "expected array");
-      const items = value;
-      for (let i = 0; i < items.length; ++i) {
-        validator(items[i], `${name}[${i}]`, head);
-      }
-    };
-  };
-  var shape = (schema) => {
-    return (value, name, head) => {
-      if (!isObject(value)) fail(name, "expected object");
-      const record = value;
-      for (const key in schema) {
-        const validator = schema[key];
-        validator(record[key], `${name}.${key}`, head);
-      }
-    };
-  };
-  var refOf = (validator) => {
-    return (value, name, head) => {
-      if (!isRef(value)) fail(name, "expected ref");
-      const refValue = value;
-      validator(refValue(), `${name}.value`, head);
-    };
-  };
-  var pval = {
-    isString: isString2,
-    isNumber,
-    isBoolean,
-    isClass,
-    optional,
-    nullable,
-    oneOf,
-    arrayOf,
-    shape,
-    refOf
-  };
-
   // src/composition/ContextRegistry.ts
   var ContextRegistry = class {
     constructor() {