regor 1.4.6 → 1.4.8

package/dist/regor.es2022.cjs.js

@@ -206,7 +206,180 @@ var callUnmounted = (context) => {
   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 ComponentHead = class {
    * @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.
@@ -379,7 +558,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`.
@@ -388,7 +567,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
@@ -398,15 +578,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;
+      }
     }
   }
   /**
@@ -442,33 +645,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 = {};
@@ -872,16 +1048,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,
@@ -1449,7 +1615,8 @@ var ComponentBinder = class {
           component,
           capturedContext,
           startOfComponent,
-          endOfComponent
+          endOfComponent,
+          binder.__config.propValidationMode
         );
         const componentCtx2 = useScope(() => {
           return registeredComponent.context(head2) ?? {};
@@ -3863,6 +4030,15 @@ var RegorConfig = class _RegorConfig {
   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 defineComponent = (template, options = {}) => {
   };
 };
 
-// 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();