@pacem/pacem-cms 1.0.0-bessel → 1.0.0-binet

package/dist/browser/pacem-cms.min.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-cms v1.0.0-bessel (https://js.pacem.it)
+ * @pacem/pacem-cms v1.0.0-binet (https://js.pacem.it)
  * Pacem (https://pacem.it)
  * Licensed under Apache-2.0
  */

package/dist/bundle/pacem-cms.min.mjs

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-cms v1.0.0-bessel (https://js.pacem.it)
+ * @pacem/pacem-cms v1.0.0-binet (https://js.pacem.it)
  * Pacem (https://pacem.it)
  * Licensed under Apache-2.0
  */

package/dist/bundle/pacem-cms.mjs

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-cms v1.0.0-bessel (https://js.pacem.it)
+ * @pacem/pacem-cms v1.0.0-binet (https://js.pacem.it)
  * Pacem (https://pacem.it)
  * Licensed under Apache-2.0
  */
@@ -774,6 +774,7 @@ var PacemWidgetFetchElement = class PacemWidgetFetchElement2 extends PacemBearer
   get _parameters() {
     return Array.from(this._itemsElement.children).filter((e) => e.localName === PARAMETER_TAGNAME);
   }
+  /** Triggers the request against `endpoint`/`url`, provided all of the endpoint's required parameters are attached and populated; otherwise does nothing. */
   fetch() {
     const fetcher = this._fetcher, parameters = this._parameters || [], endpoint = this.endpoint;
     if (!Utils5.isNull(endpoint)) {
@@ -1020,6 +1021,12 @@ var SwaggerCmsParser = class {
     this._openApi = _openApi;
     this._cachedMetadataUrls = [];
   }
+  /**
+   * Loads the OpenApi manifest at `url` and enriches every endpoint's request/response schemas with their
+   * fetched field metadata (see `_enrichSchemas`).
+   * @param url The OpenApi (swagger) json configuration's url.
+   * @param headers Optional HTTP headers for both the manifest and the per-schema metadata fetches.
+   */
   async load(url, headers) {
     let api = await this._openApi.load(url, headers);
     if (api != null) {
@@ -1043,6 +1050,7 @@ var SwaggerCmsParser = class {
       }
     }
   }
+  /** Removes from `cache` every metadata entry fetched by this parser so far. */
   clearCache() {
     const cache = this.cache, keys = this._cachedMetadataUrls;
     if (cache) {
@@ -1314,9 +1322,11 @@ var WidgetUnregisterEvent = class extends CustomEvent {
   }
 };
 var PacemCompositeWidgetElement = class extends PacemUiWidgetElement {
+  /** Gets the `Element` new items are appended to; defaults to this widget itself. */
   get itemsElement() {
     return this;
   }
+  /** Gets whether `item` is an acceptable child of this container; overridable by subclasses to narrow the accepted item type. */
   validate(item) {
     return item instanceof PacemUiWidgetElement;
   }
@@ -2236,21 +2246,27 @@ var PermissionEditEvent = class extends CustomEvent {
   }
 };
 var Permissible = class {
+  /** Gets whether `claims` grants edit (update) permission on `resource`. */
   static canEdit(claims, resource) {
     return this._canDoSomethingToResource(claims, resource, (p) => p.update);
   }
+  /** Gets whether `claims` grants read permission on `resource`. */
   static canRead(claims, resource) {
     return this._canDoSomethingToResource(claims, resource, (p) => p.read);
   }
+  /** Gets whether `claims` grants add (create) permission on `resource`. */
   static canAdd(claims, resource) {
     return this._canDoSomethingToResource(claims, resource, (p) => p.create);
   }
+  /** Gets whether `claims` grants delete permission on `resource`. */
   static canDelete(claims, resource) {
     return this._canDoSomethingToResource(claims, resource, (p) => p.delete);
   }
+  /** Gets whether `claims` grants translate permission on `resource`. */
   static canTranslate(claims, resource) {
     return this._canDoSomethingToResource(claims, resource, (p) => p.translate);
   }
+  /** Returns whether `claims` satisfies `predicate` for at least one of `resource.permissions`; when `resource.permissions` is empty, access is unrestricted (returns `true`). */
   static _canDoSomethingToResource(claims, resource, predicate) {
     if (Utils12.isNullOrEmpty(claims) || Utils12.isNull(resource)) {
       return false;