regor 1.4.6 → 1.4.8

package/dist/regor.es2019.cjs.js

@@ -209,9 +209,184 @@ var callUnmounted = (context) => {
   (_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 ComponentHead = class {
      * @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 ComponentHead = class {
     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 ComponentHead = class {
     );
   }
   /**
-   * 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 ComponentHead = class {
    * 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 ComponentHead = class {
    * })
    * ```
    *
+   * 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 addUnbinder = (node, unbinder) => {
   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 isScope = (value) => {
   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 ComponentBinder = class {
           component,
           capturedContext,
           startOfComponent,
-          endOfComponent
+          endOfComponent,
+          binder.__config.propValidationMode
         );
         const componentCtx2 = useScope(() => {
           var _a2;
@@ -3888,6 +4057,15 @@ var _RegorConfig = class _RegorConfig {
     __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 defineComponent = (template, options = {}) => {
   };
 };
 
-// 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() {