regor 1.4.6 → 1.4.7

package/dist/regor.es2022.iife.js

@@ -206,7 +206,180 @@ var Regor = (() => {
     context.unmounted?.();
   };
 
+  // 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 {
+    propPath;
+    detail;
+    constructor(propPath, detail) {
+      super(detail);
+      this.name = "PropValidationError";
+      this.propPath = propPath;
+      this.detail = detail;
+    }
+  };
+  var fail = (name, message) => {
+    throw new PropValidationError(name, `${message}.`);
+  };
+  var describeValue = (value) => {
+    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 = value?.constructor?.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) => {
+    const tagName = element.tagName?.toLowerCase?.() || "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 {
     /**
      * Values provided by parent for this component instance.
@@ -294,12 +467,18 @@ var Regor = (() => {
      * @internal
      */
     __element;
-    constructor(props, element, ctx, start, end) {
+    /**
+     * Runtime behavior used when `validateProps(...)` encounters invalid input.
+     * Defaults to `'throw'`.
+     */
+    __propValidationMode;
+    constructor(props, element, ctx, start, end, propValidationMode) {
       this.props = props;
       this.__element = element;
       this.ctx = ctx;
       this.start = start;
       this.end = end;
+      this.__propValidationMode = propValidationMode;
     }
     /**
      * Emits a custom DOM event from the component host element.
@@ -388,7 +567,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
@@ -398,15 +578,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;
+        }
       }
     }
     /**
@@ -442,33 +645,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 = {};
@@ -872,16 +1048,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,
@@ -1449,7 +1615,8 @@ var Regor = (() => {
             component,
             capturedContext,
             startOfComponent,
-            endOfComponent
+            endOfComponent,
+            binder.__config.propValidationMode
           );
           const componentCtx2 = useScope(() => {
             return registeredComponent.context(head2) ?? {};
@@ -3863,6 +4030,15 @@ var Regor = (() => {
     forGrowThreshold = 10;
     globalContext;
     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.
+     */
+    propValidationMode = "throw";
     constructor(globalContext) {
       this.setDirectives("r-");
       if (globalContext) {
@@ -6114,112 +6290,6 @@ var Regor = (() => {
     };
   };
 
-  // src/app/propValidators.ts
-  var fail = (name, message) => {
-    throw new Error(`Invalid prop "${name}": ${message}.`);
-  };
-  var describeValue = (value) => {
-    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 = value?.constructor?.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 {
     byConstructor = /* @__PURE__ */ new Map();