@pacem/pacem-scaffolding 1.0.0-bessel → 1.0.0-dirac

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/dist/browser/pacem-scaffolding.js +420 -38
  2. package/dist/browser/pacem-scaffolding.js.map +1 -1
  3. package/dist/browser/pacem-scaffolding.min.js +2 -2
  4. package/dist/bundle/pacem-scaffolding.min.mjs +91 -91
  5. package/dist/bundle/pacem-scaffolding.mjs +329 -200
  6. package/dist/bundle/pacem-scaffolding.mjs.map +3 -3
  7. package/dist/docs/pacem-scaffolding.json +34788 -0
  8. package/dist/esm/calendar-picker.js +6 -1
  9. package/dist/esm/char-counter.js +3 -1
  10. package/dist/esm/checkbox-list.js +2 -1
  11. package/dist/esm/checkbox.js +3 -1
  12. package/dist/esm/childform.js +1 -1
  13. package/dist/esm/contenteditable.js +4 -1
  14. package/dist/esm/datetime-picker.js +8 -1
  15. package/dist/esm/form.js +65 -1
  16. package/dist/esm/formfield.js +9 -1
  17. package/dist/esm/geolocate.js +2 -1
  18. package/dist/esm/hierarchy.js +6 -1
  19. package/dist/esm/index-components-scaffolding.js +1 -1
  20. package/dist/esm/index-components.js +1 -1
  21. package/dist/esm/index-iife.js +1 -1
  22. package/dist/esm/index-root.js +1 -1
  23. package/dist/esm/index-scaffolding.js +1 -1
  24. package/dist/esm/index.js +1 -1
  25. package/dist/esm/input-chars.js +4 -1
  26. package/dist/esm/input-color.js +3 -2
  27. package/dist/esm/input-email.js +13 -7
  28. package/dist/esm/input-file.js +20 -3
  29. package/dist/esm/input-hidden.js +7 -4
  30. package/dist/esm/input-image.js +13 -1
  31. package/dist/esm/input-number.js +5 -2
  32. package/dist/esm/input-password.js +6 -2
  33. package/dist/esm/input-search.js +7 -4
  34. package/dist/esm/input-tel.js +13 -7
  35. package/dist/esm/input-text.js +6 -3
  36. package/dist/esm/input-url.js +13 -7
  37. package/dist/esm/input.js +26 -1
  38. package/dist/esm/l10n.js +2 -1
  39. package/dist/esm/latlng.js +4 -1
  40. package/dist/esm/namevalue-list.js +3 -1
  41. package/dist/esm/property-picker.js +2 -1
  42. package/dist/esm/radio-list.js +2 -1
  43. package/dist/esm/radio.js +2 -1
  44. package/dist/esm/select.js +6 -2
  45. package/dist/esm/slider.js +2 -1
  46. package/dist/esm/snapshot.js +5 -1
  47. package/dist/esm/suggest.js +2 -1
  48. package/dist/esm/tags.js +3 -1
  49. package/dist/esm/textarea-markdown.js +15 -9
  50. package/dist/esm/textarea.js +13 -5
  51. package/dist/esm/types-components.js +53 -2
  52. package/dist/esm/types.js +3 -1
  53. package/dist/esm/validators.js +25 -1
  54. package/package.json +2 -1
  55. package/typings/index.d.ts +626 -14
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -9,21 +9,24 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
9
9
  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
10
10
  return c > 3 && r && Object.defineProperty(target, key, r), r;
11
11
  };
12
- import { P, CustomElement, Defaults, ViewChild } from '@pacem/pacem-core';
12
+ import { P, CustomElement, Defaults, ViewChild, Utils } from '@pacem/pacem-core';
13
13
  import { PacemTextualInputElement } from './input';
14
14
  //namespace Pacem.Components.Scaffolding {
15
+ /** {@link PacemTextualInputElement} wrapping an `<input type="hidden">`, for values that must round-trip without a visible UI. */
15
16
  let PacemHiddenInputElement = class PacemHiddenInputElement extends PacemTextualInputElement {
16
17
  constructor() {
17
18
  super();
18
19
  }
19
20
  toggleReadonlyView(readonly) { }
20
21
  get inputFields() {
21
- return [this.input];
22
+ return Utils.isNull(this._input)
23
+ ? []
24
+ : [this._input];
22
25
  }
23
26
  };
24
27
  __decorate([
25
28
  ViewChild('input[type=hidden]')
26
- ], PacemHiddenInputElement.prototype, "input", void 0);
29
+ ], PacemHiddenInputElement.prototype, "_input", void 0);
27
30
  PacemHiddenInputElement = __decorate([
28
31
  CustomElement({ tagName: P + '-input-hidden', template: '<input type="hidden" />', shadow: Defaults.USE_SHADOW_ROOT })
29
32
  ], PacemHiddenInputElement);
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -15,18 +15,26 @@ import { PacemBaseElement } from './types-components';
15
15
  import { FileUploadEventName } from './input-file';
16
16
  import { SnapshotStep } from './snapshot';
17
17
  //namespace Pacem.Components.Scaffolding {
18
+ /** A single image entry (full-size and thumbnail sources) offered as a pick candidate by {@link PacemEditImageElement}. */
18
19
  export class Picture {
19
20
  }
21
+ /** Name of the {@link ImageFetchRequestEvent} dispatched by {@link PacemEditImageElement}/{@link PacemImageInputElement} to request a page of pictures. */
20
22
  export const ImageFetchRequestEventName = 'imagefetchrequest';
23
+ /** Dispatched to request a page of {@link Picture}s (e.g. on scroll, or when the search hint changes); handlers are expected to respond by setting `imageSet`. */
21
24
  export class ImageFetchRequestEvent extends CustomTypedEvent {
22
25
  constructor(args) {
23
26
  super(ImageFetchRequestEventName, args, { bubbles: true /*, scoped: false */ });
24
27
  }
25
28
  }
29
+ /**
30
+ * Picture-picker panel: lets the user search/browse a fetched {@link imageSet}, upload a new full-size/thumbnail pair, or take a
31
+ * snapshot, resolving `value` to the chosen picture's source. Hosted inside a dialog by {@link PacemImageInputElement}.
32
+ */
26
33
  let PacemEditImageElement = class PacemEditImageElement extends Components.PacemElement {
27
34
  constructor() {
28
35
  super(...arguments);
29
36
  this._index = 0;
37
+ /** Gets or sets the search hint typed by the user, triggering a fresh {@link ImageFetchRequestEvent} when it changes. */
30
38
  this.hint = '';
31
39
  }
32
40
  _uploaderPropertyChangedCallback(evt) {
@@ -198,6 +206,10 @@ PacemEditImageElement = __decorate([
198
206
  })
199
207
  ], PacemEditImageElement);
200
208
  export { PacemEditImageElement };
209
+ /**
210
+ * {@link PacemBaseElement}-based field showing an image preview with edit/clear buttons; editing opens a dialog hosting a
211
+ * {@link PacemEditImageElement} to pick/upload/snapshot a new picture, while `value` also accepts a directly-typed URL.
212
+ */
201
213
  let PacemImageInputElement = class PacemImageInputElement extends PacemBaseElement {
202
214
  constructor() {
203
215
  super(...arguments);
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -12,13 +12,16 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
12
12
  import { P, PCSS, CustomElement, Watch, Defaults, ViewChild, PropertyConverters, Utils } from '@pacem/pacem-core';
13
13
  import { PacemOrdinalInputElement } from './input';
14
14
  //namespace Pacem.Components.Scaffolding {
15
+ /** {@link PacemOrdinalInputElement} for an `<input type="number">`, formatting its read-only view value via {@link format}. */
15
16
  let PacemNumberInputElement = class PacemNumberInputElement extends PacemOrdinalInputElement {
16
17
  toggleReadonlyView(readonly) {
17
18
  this._span.hidden = !readonly;
18
19
  this._input.hidden = readonly;
19
20
  }
20
21
  get inputFields() {
21
- return [this._input];
22
+ return Utils.isNull(this._input)
23
+ ? []
24
+ : [this._input];
22
25
  }
23
26
  getViewValue(val) {
24
27
  return this.value != null ? this._format(this.value) : undefined;
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -13,6 +13,7 @@ import { P, PCSS, CustomElement, avoidHandler, Defaults, ViewChild, Utils } from
13
13
  import { PacemTextualInputElement } from './input';
14
14
  import { CHAR_COUNTER_CHILD } from './char-counter';
15
15
  //namespace Pacem.Components.Scaffolding {
16
+ /** {@link PacemTextualInputElement} for an `<input type="password">`, with a toggle to reveal/hide the entered text and a masked read-only view. */
16
17
  let PacemPasswordInputElement = class PacemPasswordInputElement extends PacemTextualInputElement {
17
18
  constructor() {
18
19
  super();
@@ -24,7 +25,9 @@ let PacemPasswordInputElement = class PacemPasswordInputElement extends PacemTex
24
25
  };
25
26
  }
26
27
  get inputFields() {
27
- return [this._input];
28
+ return Utils.isNull(this._input)
29
+ ? []
30
+ : [this._input];
28
31
  }
29
32
  viewActivatedCallback() {
30
33
  super.viewActivatedCallback();
@@ -40,6 +43,7 @@ let PacemPasswordInputElement = class PacemPasswordInputElement extends PacemTex
40
43
  this._toggler.removeEventListener('mousedown', this._togglerMousedownHandler, false);
41
44
  }
42
45
  }
46
+ /** Toggles the native input between `password` (masked) and `text` (revealed) type. */
43
47
  toggleVisibility() {
44
48
  const current = this._input.type;
45
49
  this._input.type = current === 'password' ? 'text' : 'password';
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -9,15 +9,18 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
9
9
  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
10
10
  return c > 3 && r && Object.defineProperty(target, key, r), r;
11
11
  };
12
- import { P, PCSS, CustomElement, Defaults, ViewChild } from '@pacem/pacem-core';
12
+ import { P, PCSS, CustomElement, Utils, Defaults, ViewChild } from '@pacem/pacem-core';
13
13
  import { PacemTextualInputElement } from './input';
14
14
  //namespace Pacem.Components.Scaffolding {
15
+ /** A `<p-input-search>` field: a {@link PacemTextualInputElement} backed by a native `<input type="search">`. */
15
16
  let PacemSearchInputElement = class PacemSearchInputElement extends PacemTextualInputElement {
16
17
  constructor() {
17
18
  super();
18
19
  }
19
20
  get inputFields() {
20
- return [this.input];
21
+ return Utils.isNull(this._input)
22
+ ? []
23
+ : [this._input];
21
24
  }
22
25
  toggleReadonlyView(readonly) {
23
26
  // no readonly view provided.
@@ -25,7 +28,7 @@ let PacemSearchInputElement = class PacemSearchInputElement extends PacemTextual
25
28
  };
26
29
  __decorate([
27
30
  ViewChild('input[type=search]')
28
- ], PacemSearchInputElement.prototype, "input", void 0);
31
+ ], PacemSearchInputElement.prototype, "_input", void 0);
29
32
  PacemSearchInputElement = __decorate([
30
33
  CustomElement({ tagName: P + '-input-search', template: '<input type="search" class="' + PCSS + '-input" />', shadow: Defaults.USE_SHADOW_ROOT })
31
34
  ], PacemSearchInputElement);
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -9,27 +9,33 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
9
9
  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
10
10
  return c > 3 && r && Object.defineProperty(target, key, r), r;
11
11
  };
12
- import { P, PCSS, CustomElement, Defaults, ViewChild } from '@pacem/pacem-core';
12
+ import { P, PCSS, CustomElement, Utils, Defaults, ViewChild } from '@pacem/pacem-core';
13
13
  import { PacemTextualInputElement } from './input';
14
14
  //namespace Pacem.Components.Scaffolding {
15
+ /** A `<p-input-tel>` field: a {@link PacemTextualInputElement} backed by a native `<input type="tel">`, whose readonly view renders as a clickable `tel:` link. */
15
16
  let PacemTelInputElement = class PacemTelInputElement extends PacemTextualInputElement {
16
17
  constructor() {
17
18
  super();
18
19
  }
19
20
  toggleReadonlyView(readonly) {
20
- this.input.hidden = readonly;
21
- this.anchor.hidden = !readonly;
21
+ const input = this._input, anchor = this._anchor;
22
+ if (!Utils.isNull(input))
23
+ input.hidden = readonly;
24
+ if (!Utils.isNull(anchor))
25
+ anchor.hidden = !readonly;
22
26
  }
23
27
  get inputFields() {
24
- return [this.input];
28
+ return Utils.isNull(this._input)
29
+ ? []
30
+ : [this._input];
25
31
  }
26
32
  };
27
33
  __decorate([
28
34
  ViewChild('input[type=tel]')
29
- ], PacemTelInputElement.prototype, "input", void 0);
35
+ ], PacemTelInputElement.prototype, "_input", void 0);
30
36
  __decorate([
31
37
  ViewChild(P + '-a')
32
- ], PacemTelInputElement.prototype, "anchor", void 0);
38
+ ], PacemTelInputElement.prototype, "_anchor", void 0);
33
39
  PacemTelInputElement = __decorate([
34
40
  CustomElement({ tagName: P + '-input-tel', template: `<input type="tel" class="${PCSS}-input" /><${P}-a class="${PCSS}-readonly" disabled="{{ $pacem.isNullOrEmpty(:host.value) }}" href="{{ 'tel:'+ :host.value }}"><${P}-text text="{{ :host.viewValue }}"></${P}-text></${P}-a>`, shadow: Defaults.USE_SHADOW_ROOT })
35
41
  ], PacemTelInputElement);
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -9,10 +9,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
9
9
  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
10
10
  return c > 3 && r && Object.defineProperty(target, key, r), r;
11
11
  };
12
- import { P, PCSS, CustomElement, Defaults, ViewChild } from '@pacem/pacem-core';
12
+ import { P, PCSS, CustomElement, Utils, Defaults, ViewChild } from '@pacem/pacem-core';
13
13
  import { PacemTextualInputElement } from './input';
14
14
  import { CHAR_COUNTER_CHILD } from './char-counter';
15
15
  //namespace Pacem.Components.Scaffolding {
16
+ /** A `<p-input-text>` field: a {@link PacemTextualInputElement} backed by a native `<input type="text">`, with an optional character counter. */
16
17
  let PacemTextInputElement = class PacemTextInputElement extends PacemTextualInputElement {
17
18
  constructor() {
18
19
  super();
@@ -22,7 +23,9 @@ let PacemTextInputElement = class PacemTextInputElement extends PacemTextualInpu
22
23
  this._input.hidden = readonly;
23
24
  }
24
25
  get inputFields() {
25
- return [this._input];
26
+ return Utils.isNull(this._input)
27
+ ? []
28
+ : [this._input];
26
29
  }
27
30
  };
28
31
  __decorate([
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -9,28 +9,34 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
9
9
  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
10
10
  return c > 3 && r && Object.defineProperty(target, key, r), r;
11
11
  };
12
- import { P, PCSS, CustomElement, Defaults, ViewChild } from '@pacem/pacem-core';
12
+ import { P, PCSS, CustomElement, Utils, Defaults, ViewChild } from '@pacem/pacem-core';
13
13
  import { PacemTextualInputElement } from './input';
14
14
  import { CHAR_COUNTER_CHILD } from './char-counter';
15
15
  //namespace Pacem.Components.Scaffolding {
16
+ /** A `<p-input-url>` field: a {@link PacemTextualInputElement} backed by a native `<input type="url">`, whose readonly view renders as a clickable link opening in a new tab. */
16
17
  let PacemUrlInputElement = class PacemUrlInputElement extends PacemTextualInputElement {
17
18
  constructor() {
18
19
  super();
19
20
  }
20
21
  toggleReadonlyView(readonly) {
21
- this.input.hidden = readonly;
22
- this.anchor.hidden = !readonly;
22
+ const input = this._input, anchor = this._anchor;
23
+ if (!Utils.isNull(input))
24
+ input.hidden = readonly;
25
+ if (!Utils.isNull(anchor))
26
+ anchor.hidden = !readonly;
23
27
  }
24
28
  get inputFields() {
25
- return [this.input];
29
+ return Utils.isNull(this._input)
30
+ ? []
31
+ : [this._input];
26
32
  }
27
33
  };
28
34
  __decorate([
29
35
  ViewChild('input[type=url]')
30
- ], PacemUrlInputElement.prototype, "input", void 0);
36
+ ], PacemUrlInputElement.prototype, "_input", void 0);
31
37
  __decorate([
32
38
  ViewChild(P + '-a')
33
- ], PacemUrlInputElement.prototype, "anchor", void 0);
39
+ ], PacemUrlInputElement.prototype, "_anchor", void 0);
34
40
  PacemUrlInputElement = __decorate([
35
41
  CustomElement({ tagName: P + '-input-url', template: `<input type="url" class="${PCSS}-input" />${CHAR_COUNTER_CHILD}<${P}-a class="${PCSS}-readonly" disabled="{{ $pacem.isNullOrEmpty(:host.value) }}" href="{{ :host.value }}" target="_blank"><${P}-text text="{{ :host.viewValue }}"></${P}-text></${P}-a>`, shadow: Defaults.USE_SHADOW_ROOT })
36
42
  ], PacemUrlInputElement);
package/dist/esm/input.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -12,16 +12,30 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
12
12
  import { PropertyConverters, Utils, Watch, CustomElementUtils } from '@pacem/pacem-core';
13
13
  import { PacemBaseElement } from './types-components';
14
14
  //namespace Pacem.Components.Scaffolding {
15
+ /** When a {@link PacemBaseInputElement} propagates its native input's value to the `value` property: on every keystroke (`Input`), or only once the field loses focus (`Blur`). */
15
16
  export var ChangePolicy;
16
17
  (function (ChangePolicy) {
17
18
  ChangePolicy["Input"] = "input";
18
19
  ChangePolicy["Blur"] = "blur";
19
20
  })(ChangePolicy || (ChangePolicy = {}));
21
+ /** Attached-property key used to mark a native `<input>`/`<textarea>` as already wired up, so re-registration doesn't double-attach listeners (see {@link PacemBaseInputElement#registerInputFields}). */
20
22
  const INPUT_FIELD_ACTIVATED_PROP = 'pacem:scaffolding:input_field';
23
+ /**
24
+ * Base class for fields backed by one or more native `<input>`/`<textarea>` elements ({@link inputField}):
25
+ * wires `input`/`focus` listeners onto them, applies `changePolicy`/`debounce` to decide when the native
26
+ * value is read back into {@link PacemModelElement#value} (via {@link getValue}), and optionally
27
+ * auto-selects the field's content on focus.
28
+ *
29
+ * Extended by {@link PacemOrdinalInputElement} (numeric/date-like inputs) and
30
+ * {@link PacemTextualInputElement} (text-like inputs); further specialized by the concrete `input-*.ts`
31
+ * elements in this package (e.g. text, number, date, password, ...).
32
+ */
21
33
  export class PacemBaseInputElement extends PacemBaseElement {
22
34
  constructor() {
23
35
  super(...arguments);
36
+ /** Gets or sets how long to wait, after the native input changes, before propagating the value: `false` (default, propagate on the next animation frame), `true` (propagate via `requestAnimationFrame`), or a number of milliseconds to debounce by. */
24
37
  this.debounce = false;
38
+ /** Gets or sets when the native input's value gets read back into {@link PacemModelElement#value}: on every `input` event, or only on `blur`. Defaults to {@link ChangePolicy.Input}. */
25
39
  this.changePolicy = ChangePolicy.Input;
26
40
  this._focusHandler = (evt) => {
27
41
  if (!this.autoselect) {
@@ -52,6 +66,7 @@ export class PacemBaseInputElement extends PacemBaseElement {
52
66
  this.inputField.value = Utils.isNullOrEmpty(val) ? '' : val;
53
67
  }
54
68
  }
69
+ /** @readonly Gets the first (usually only) native input element among {@link PacemBaseElement#inputFields}. */
55
70
  get inputField() {
56
71
  return this.inputFields[0];
57
72
  }
@@ -156,6 +171,11 @@ __decorate([
156
171
  __decorate([
157
172
  Watch({ emit: false, converter: PropertyConverters.Boolean })
158
173
  ], PacemBaseInputElement.prototype, "autoselect", void 0);
174
+ /**
175
+ * Base class for numeric/ordinal native inputs (e.g. `number`, `range`, `date`-like fields): adds
176
+ * `min`/`max`/`step`, mirrored onto the native input's own attributes, and parses its `value` attribute as
177
+ * a float.
178
+ */
159
179
  export class PacemOrdinalInputElement extends PacemBaseInputElement {
160
180
  convertValueAttributeToProperty(attr) {
161
181
  return parseFloat(attr);
@@ -188,6 +208,11 @@ __decorate([
188
208
  }
189
209
  })
190
210
  ], PacemOrdinalInputElement.prototype, "step", void 0);
211
+ /**
212
+ * Base class for text-like native inputs (e.g. `text`, `password`, `textarea` fields): adds
213
+ * `pattern`/`minlength`/`maxlength`, mirrored onto the native input's own attributes, and treats an empty
214
+ * string `value` as `null`.
215
+ */
191
216
  export class PacemTextualInputElement extends PacemBaseInputElement {
192
217
  convertValueAttributeToProperty(attr) {
193
218
  return attr;
package/dist/esm/l10n.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -15,6 +15,7 @@ const DefaultFormLocalizationOptions = {
15
15
  validator: (validatorType, validatorTypeIndex, prop, dictionary) => dictionary['validator_' + validatorType + '_' + prop] ?? dictionary['validator_' + validatorType + validatorTypeIndex + '_' + prop],
16
16
  commandTooltip: (commandName, dictionary) => dictionary['command_tooltip_' + commandName]
17
17
  };
18
+ /** Namespace-like static helper for localizing form {@link TypeMetadata} (labels, watermarks, descriptions, validator error messages, command tooltips) against a translation dictionary. */
18
19
  export class Forms {
19
20
  /**
20
21
  * Localizes the metadata of a form **in place** using a translation dictionary.
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -13,11 +13,14 @@ import { P, PCSS, ViewChild, CustomElement, Watch, Utils, PropertyConverters, De
13
13
  import { Components as ComponentsMaps } from '@pacem/pacem-maps';
14
14
  import { PacemBaseElement } from './types-components';
15
15
  //namespace Pacem.Components.Scaffolding {
16
+ /** Default tile-layer URL template used by {@link PacemLatLngElement} when {@link LatLngOptions.tiles} isn't set (currently empty, i.e. the map adapter's own default applies). */
16
17
  export const DEFAULT_TILES = "";
18
+ /** Default map attribution string used by {@link PacemLatLngElement} when {@link LatLngOptions.attribution} isn't set (currently empty, i.e. the map adapter's own default applies). */
17
19
  export const DEFAULT_ATTRIBUTION = "";
18
20
  //const TILES = `//api.mapbox.com/styles/v1/cmerighi/ciwz1gib7002l2prvgpi724nk/tiles/256/{z}/{x}/{y}?access_token=pk.eyJ1IjoiY21lcmlnaGkiLCJhIjoiY2lsZHIxdGJmMDAxOHc4bHowamxpZ2Z2OCJ9.7I7ndF-rAkx_1Sqi0bw3Ew`;
19
21
  //const ATTRIBUTION = `Map data &copy; <a href="http://openstreetmap.org">OpenStreetMap</a> contributors, <a href="http://creativecommons.org/licenses/by-sa/2.0/">CC-BY-SA</a>, Imagery © <a href="http://mapbox.com">Mapbox</a>`
20
22
  const REVERSE_GEOCODE_URL = 'https://nominatim.openstreetmap.org/reverse';
23
+ /** A `<p-latlng>` field: a {@link PacemBaseElement} coordinate picker combining paired lat/lng number inputs with an interactive, draggable-marker map (Leaflet/OSM, Azure Maps or Google Maps) and reverse-geocoded address preview. */
21
24
  let PacemLatLngElement = class PacemLatLngElement extends PacemBaseElement {
22
25
  convertValueAttributeToProperty(attr) {
23
26
  const regexArray = /^\s*([+-]?\d+\.?\d+)[,\s]\s*([+-]?\d+\.?\d+)\s*$/.exec(attr);
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -20,10 +20,12 @@ function isEmpty(nvp) {
20
20
  function pullEmpty() {
21
21
  return { name: '', value: '' };
22
22
  }
23
+ /** A `<p-namevalue-list>` field: a {@link PacemBaseElement} editor for a repeatable list of name/value string pairs, whose `value` is either an array of {@link NameValuePair}s or, when {@link PacemNameValueListElement#dictionary} is set, a plain `{ [name]: value }` object. */
23
24
  let PacemNameValueListElement = class PacemNameValueListElement extends PacemBaseElement {
24
25
  constructor() {
25
26
  super(...arguments);
26
27
  this.inputFields = [];
28
+ /** Internal editable rows, mirrored to/from `value` depending on {@link dictionary}. */
27
29
  this._bag = [];
28
30
  }
29
31
  toggleReadonlyView(readonly) {
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -12,6 +12,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
12
12
  import { P, ViewChild, CustomElement, Watch, Utils, PropertyConverters, Defaults, CustomElementUtils } from '@pacem/pacem-core';
13
13
  import { PacemBaseElement } from './types-components';
14
14
  //namespace Pacem.Components.Scaffolding {
15
+ /** A `<p-property-picker>` field: a {@link PacemBaseElement} wrapping a {@link PacemSelectElement} whose datasource is auto-populated with the (recursively flattened) watched property names of a `target` element. */
15
16
  let PacemPropertyPickerElement = class PacemPropertyPickerElement extends PacemBaseElement {
16
17
  get inputFields() {
17
18
  return [this._select];
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -12,6 +12,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
12
12
  import { CustomElement, Defaults, P, PCSS, PropertyChangeEventName, Utils, ViewChild } from '@pacem/pacem-core';
13
13
  import { PacemDataSourceElement } from './types-components';
14
14
  //namespace Pacem.Components.Scaffolding {
15
+ /** A `<p-radio-list>` field: a {@link PacemDataSourceElement} rendering the datasource as a group of mutually-exclusive `<p-radio>` buttons. */
15
16
  let PacemRadioListElement = class PacemRadioListElement extends PacemDataSourceElement {
16
17
  acceptValue(val) {
17
18
  // no need to implement
package/dist/esm/radio.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -12,6 +12,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
12
12
  import { P, PCSS, ViewChild, CustomElement, Watch, Utils, PropertyConverters, Defaults } from '@pacem/pacem-core';
13
13
  import { PacemBaseElement } from './types-components';
14
14
  //namespace Pacem.Components.Scaffolding {
15
+ /** A `<p-radio>` field: a {@link PacemBaseElement} wrapping a single native `<input type="radio">` with a caption label; its `value` is the radio's native value when {@link selected}, otherwise `undefined`. Used standalone or as the item template driven by {@link PacemRadioListElement}. */
15
16
  let PacemRadioElement = class PacemRadioElement extends PacemBaseElement {
16
17
  convertValueAttributeToProperty(attr) {
17
18
  return attr;
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -12,9 +12,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
12
12
  import { Components, PropertyConverters, Utils, P, PCSS, CustomElement, Watch, Defaults, ViewChild } from '@pacem/pacem-core';
13
13
  import { PacemDataSourceElement } from './types-components';
14
14
  //namespace Pacem.Components.Scaffolding {
15
+ /** A `<p-select>` field: a {@link PacemDataSourceElement} rendering the datasource as a native `<select>` dropdown. */
15
16
  let PacemSelectElement = class PacemSelectElement extends PacemDataSourceElement {
16
17
  constructor() {
17
18
  super(...arguments);
19
+ /** Gets or sets whether an extra, empty/placeholder `<option>` is prepended to the rendered choices. Defaults to `true`. */
18
20
  this.emptyOption = true;
19
21
  }
20
22
  toggleReadonlyView(readonly) {
@@ -24,7 +26,9 @@ let PacemSelectElement = class PacemSelectElement extends PacemDataSourceElement
24
26
  // no actual need to be idem-potent...
25
27
  // (take care in future)
26
28
  get inputFields() {
27
- return [this._select];
29
+ return Utils.isNull(this._select)
30
+ ? []
31
+ : [this._select];
28
32
  }
29
33
  _manageDom(evt) {
30
34
  const args = evt.detail, item = args.item;
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -14,6 +14,7 @@ import { P, PCSS, ViewChild, CustomElement, Watch, Utils, PropertyConverters, De
14
14
  import { PacemBaseElement } from './types-components';
15
15
  //namespace Pacem.Components.Scaffolding {
16
16
  // TODO: exploit 202x features like https://developer.mozilla.org/en-US/docs/Web/CSS/offset-path or https://developer.chrome.com/blog/anchor-positioning-api
17
+ /** A `<p-slider>` field: a {@link PacemBaseElement} numeric range control with a draggable thumb, keyboard support, and an optional tooltip-style thumb label; its `value` is a number between `min` and `max`. */
17
18
  let PacemSliderElement = class PacemSliderElement extends PacemBaseElement {
18
19
  constructor() {
19
20
  super(...arguments);
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -13,6 +13,7 @@ import { P, PCSS, CustomElement, Watch, Defaults, ViewChild, CustomEventUtils, P
13
13
  import { PacemBaseElement } from './types-components';
14
14
  //namespace Pacem.Components.Scaffolding {
15
15
  const getUserMediaFunctions = Utils.getUserMediaFunctions();
16
+ /** The current stage of {@link PacemSnapshotElement}'s capture workflow: idle/upload-or-camera choice, live webcam preview, or reviewing the captured image before confirming. */
16
17
  export var SnapshotStep;
17
18
  (function (SnapshotStep) {
18
19
  SnapshotStep["Start"] = "start";
@@ -24,14 +25,17 @@ class ConfirmSnapshotEvent extends CustomUIEvent {
24
25
  super('confirmsnapshot', { buffer });
25
26
  }
26
27
  }
28
+ /** A `<p-snapshot>` field: a {@link PacemBaseElement} image-capture control that lets the user upload a file or, when a webcam is available, take a live snapshot (with an optional 3s timer); its `value` is the resulting data-URL string. */
27
29
  let PacemSnapshotElement = class PacemSnapshotElement extends PacemBaseElement {
28
30
  constructor() {
29
31
  super(...arguments);
30
32
  this._resizeHandler = (evt) => {
31
33
  this._renderValue();
32
34
  };
35
+ /** Gets or sets the current step of the capture workflow. Defaults to {@link SnapshotStep.Start}. */
33
36
  this.step = SnapshotStep.Start;
34
37
  /*const*/ this._canUseWebcam = getUserMediaFunctions.length > 0;
38
+ /** Seconds left before the timed shutter fires; `0` outside of a timed countdown. */
35
39
  this._countdown = 0;
36
40
  this._webcamInitialized = false;
37
41
  this._grabberChangeHandler = (e) => {
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -20,6 +20,7 @@ class SuggestionSelectEvent extends CustomTypedEvent {
20
20
  }
21
21
  const BALLOON_POPUP_DELAY = 100;
22
22
  const BALLOON_POPOUT_DELAY = 0;
23
+ /** A `<p-suggest>` field: a {@link PacemDataSourceElement} autocomplete/typeahead text input, backed by a native `<input type="text">` and a dropdown balloon of filtered, highlighted suggestions; optionally accepts free-typed values not present in the datasource. */
23
24
  let PacemSuggestElement = class PacemSuggestElement extends PacemDataSourceElement {
24
25
  constructor() {
25
26
  super(...arguments);
package/dist/esm/tags.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * @pacem/pacem-scaffolding v1.0.0-bessel (https://js.pacem.it)
2
+ * @pacem/pacem-scaffolding v1.0.0-dirac (https://js.pacem.it)
3
3
  * Pacem (https://pacem.it)
4
4
  * Licensed under Apache-2.0
5
5
  */
@@ -22,6 +22,7 @@ class TagAddEvent extends CustomTypedEvent {
22
22
  super('tagadd', { value: value });
23
23
  }
24
24
  }
25
+ /** A single `<p-tag>` chip: displays a label and a remove button, dispatching a `remove` event (after an out-transition) when dismissed. Rendered by {@link PacemTagsElement} for each item in its `value`. */
25
26
  let PacemTagElement = class PacemTagElement extends Components.PacemElement {
26
27
  propertyChangedCallback(name, old, val, first) {
27
28
  super.propertyChangedCallback(name, old, val, first);
@@ -61,6 +62,7 @@ PacemTagElement = __decorate([
61
62
  })
62
63
  ], PacemTagElement);
63
64
  export { PacemTagElement };
65
+ /** A `<p-tags>` field: a {@link PacemDataSourceElement} editor rendering `value` as a list of removable {@link PacemTagElement} chips, plus a {@link PacemSuggestElement} for picking (or, when {@link allowNew} is set, typing) new tags to add. */
64
66
  let PacemTagsElement = class PacemTagsElement extends PacemDataSourceElement {
65
67
  constructor() {
66
68
  super(true);