jedison 1.20.1 → 1.21.0

package/dist/esm/jedison.js

@@ -350,6 +350,9 @@ function getSchemaContains(schema) {
 function getSchemaDefault(schema) {
   return clone(schema.default);
 }
+function getSchemaDeprecated(schema) {
+  return isBoolean(schema.deprecated) ? clone(schema.deprecated) : void 0;
+}
 function getSchemaDependentRequired(schema) {
   return isObject$1(schema.dependentRequired) ? clone(schema.dependentRequired) : void 0;
 }
@@ -1721,6 +1724,10 @@ class Validator {
   constructor(config = {}) {
     this.refParser = config.refParser;
     this.constraints = config.constraints ?? {};
+    if (isArray(this.constraints)) {
+      console.warn('Jedison: option "constraints" must be an object keyed by constraint name, not an array. Ignoring the value.');
+      this.constraints = {};
+    }
     this.assertFormat = config.assertFormat ? config.assertFormat : false;
     this.translator = config.translator ? config.translator : false;
     this.subErrors = config.subErrors ?? false;
@@ -1906,6 +1913,10 @@ class Instance extends EventEmitter {
   setUI() {
     if (this.jedison.isEditor) {
       const EditorClass = this.jedison.uiResolver.getClass(this.schema);
+      if (!EditorClass) {
+        console.error(`Jedison: no editor could be resolved for the schema at "${this.path}". The field will not be rendered.`, this.schema);
+        return;
+      }
       this.ui = new EditorClass(this);
     }
   }
@@ -2159,6 +2170,15 @@ class Instance extends EventEmitter {
     }
     return this.parent ? this.parent.isReadOnly() : false;
   }
+  /**
+   * Returns true if this instance's own schema is marked deprecated.
+   * Unlike isReadOnly(), this does not cascade to/from the parent: per the
+   * JSON Schema spec, "deprecated" applies only to the exact instance
+   * location it's declared on.
+   */
+  isDeprecated() {
+    return getSchemaDeprecated(this.schema) === true;
+  }
   /**
    * Destroy the instance and it's children
    */
@@ -2186,6 +2206,7 @@ class Editor {
     this.control = null;
     this.disabled = false;
     this.readOnly = this.instance.isReadOnly();
+    this.deprecated = this.instance.isDeprecated();
     this.showingValidationErrors = false;
     this.markdownEnabled = false;
     this.purifyEnabled = false;
@@ -2196,6 +2217,7 @@ class Editor {
     this.build();
     this.setAttributes();
     this.setReadOnlyAttribute();
+    this.setDeprecatedAttribute();
     this.addEventListeners();
     this.setVisibility();
     this.setContainerAttributes();
@@ -2213,6 +2235,15 @@ class Editor {
   }
   static resolves(schema) {
   }
+  /**
+   * Resolution priority used by UiResolver to order candidate editors before
+   * scanning them with resolves(). Higher values are tried first. Editors
+   * that don't override this share the default and keep their relative
+   * declaration order (stable sort).
+   */
+  static priority() {
+    return 0;
+  }
   /**
    * Whether this editor already renders a heading for each of its children
    * (e.g. an accordion toggle or a nav tab label), so a child editor can
@@ -2353,6 +2384,17 @@ class Editor {
       });
     }
   }
+  /**
+   * Marks the control container so integrators can target deprecated fields
+   * via CSS/JS and decide what to do with them (badge, hide, warn, etc.).
+   * Theme-agnostic: operates on the built DOM rather than the theme's
+   * control-building methods, so it applies uniformly across all themes.
+   */
+  setDeprecatedAttribute() {
+    if (this.deprecated) {
+      this.control.container.classList.add("jedi-deprecated");
+    }
+  }
   getIdFromPath(path) {
     const optionId = this.instance.jedison.getOption("id");
     return optionId ? optionId + "-" + pathToAttribute(path) : pathToAttribute(path);
@@ -7064,9 +7106,12 @@ class EditorStringFilepond extends EditorString {
     super.destroy();
   }
 }
+function byPriorityDescending(a, b) {
+  return b.priority() - a.priority();
+}
 class UiResolver {
   constructor(options) {
-    this.customEditors = options.customEditors ?? [];
+    this.customEditors = [...options.customEditors ?? []].sort(byPriorityDescending);
     this.refParser = options.refParser ?? null;
     this.editors = [
       EditorNumberInputNullable,
@@ -7113,17 +7158,25 @@ class UiResolver {
       EditorArrayNav,
       EditorArray,
       EditorNull
-    ];
+    ].sort(byPriorityDescending);
   }
   getClass(schema) {
     for (const editor of this.customEditors) {
-      if (editor.resolves(schema, this.refParser)) {
-        return editor;
+      try {
+        if (editor.resolves(schema, this.refParser)) {
+          return editor;
+        }
+      } catch (e) {
+        console.error(`Editor "${editor.name || "custom editor"}" threw while resolving the schema and will be skipped.`, e);
       }
     }
     for (const editor of this.editors) {
-      if (editor.resolves(schema, this.refParser)) {
-        return editor;
+      try {
+        if (editor.resolves(schema, this.refParser)) {
+          return editor;
+        }
+      } catch (e) {
+        console.error(`Editor "${editor.name || "built-in editor"}" threw while resolving the schema and will be skipped.`, e);
       }
     }
     return null;
@@ -7409,6 +7462,7 @@ class JsonWalker {
     }
   }
 }
+const version = "1.21.0";
 class Jedison extends EventEmitter {
   /**
    * Creates a Jedison instance.
@@ -7449,7 +7503,7 @@ class Jedison extends EventEmitter {
       data: void 0,
       assertFormat: false,
       customEditors: [],
-      constraints: [],
+      constraints: {},
       hiddenInputAttributes: {},
       id: "",
       radiosInline: false,
@@ -7928,6 +7982,7 @@ class Jedison extends EventEmitter {
     });
   }
 }
+Jedison.version = version;
 class RefParser {
   constructor(options = {}) {
     this.options = Object.assign({
@@ -12145,6 +12200,7 @@ const index = {
   ThemeBootstrap5,
   RefParser,
   Create: Jedison,
+  version,
   SchemaGenerator,
   applyOverlay
 };