proto-ikons-wc 0.0.84 → 0.0.85

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.
@@ -2,7 +2,7 @@
2
2
 
3
3
  Object.defineProperty(exports, '__esModule', { value: true });
4
4
 
5
- const index = require('./index-5d33f0ae.js');
5
+ const index = require('./index-5cc2712a.js');
6
6
 
7
7
  const acuraIkonCss = "";
8
8
 
@@ -136,6 +136,14 @@ const h = (nodeName, vnodeData, ...children) => {
136
136
  }
137
137
  return vnode;
138
138
  };
139
+ /**
140
+ * A utility function for creating a virtual DOM node from a tag and some
141
+ * possible text content.
142
+ *
143
+ * @param tag the tag for this element
144
+ * @param text possible text content for the node
145
+ * @returns a newly-minted virtual DOM node
146
+ */
139
147
  const newVNode = (tag, text) => {
140
148
  const vnode = {
141
149
  $flags$: 0,
@@ -150,6 +158,12 @@ const newVNode = (tag, text) => {
150
158
  return vnode;
151
159
  };
152
160
  const Host = {};
161
+ /**
162
+ * Check whether a given node is a Host node or not
163
+ *
164
+ * @param node the virtual DOM node to check
165
+ * @returns whether it's a Host node or not
166
+ */
153
167
  const isHost = (node) => node && node.$tag$ === Host;
154
168
  /**
155
169
  * Parse a new property value for a given property type.
@@ -432,6 +446,21 @@ const createElm = (oldParentVNode, newParentVNode, childIndex, parentElm) => {
432
446
  }
433
447
  return elm;
434
448
  };
449
+ /**
450
+ * Create DOM nodes corresponding to a list of {@link d.Vnode} objects and
451
+ * add them to the DOM in the appropriate place.
452
+ *
453
+ * @param parentElm the DOM node which should be used as a parent for the new
454
+ * DOM nodes
455
+ * @param before a child of the `parentElm` which the new children should be
456
+ * inserted before (optional)
457
+ * @param parentVNode the parent virtual DOM node
458
+ * @param vnodes the new child virtual DOM nodes to produce DOM nodes for
459
+ * @param startIdx the index in the child virtual DOM nodes at which to start
460
+ * creating DOM nodes (inclusive)
461
+ * @param endIdx the index in the child virtual DOM nodes at which to stop
462
+ * creating DOM nodes (inclusive)
463
+ */
435
464
  const addVnodes = (parentElm, before, parentVNode, vnodes, startIdx, endIdx) => {
436
465
  let containerElm = (parentElm);
437
466
  let childNode;
@@ -445,6 +474,19 @@ const addVnodes = (parentElm, before, parentVNode, vnodes, startIdx, endIdx) =>
445
474
  }
446
475
  }
447
476
  };
477
+ /**
478
+ * Remove the DOM elements corresponding to a list of {@link d.VNode} objects.
479
+ * This can be used to, for instance, clean up after a list of children which
480
+ * should no longer be shown.
481
+ *
482
+ * This function also handles some of Stencil's slot relocation logic.
483
+ *
484
+ * @param vnodes a list of virtual DOM nodes to remove
485
+ * @param startIdx the index at which to start removing nodes (inclusive)
486
+ * @param endIdx the index at which to stop removing nodes (inclusive)
487
+ * @param vnode a VNode
488
+ * @param elm an element
489
+ */
448
490
  const removeVnodes = (vnodes, startIdx, endIdx, vnode, elm) => {
449
491
  for (; startIdx <= endIdx; ++startIdx) {
450
492
  if ((vnode = vnodes[startIdx])) {
@@ -636,7 +678,8 @@ const updateChildren = (parentElm, oldCh, newVNode, newCh) => {
636
678
  *
637
679
  * So, in other words, if `key` attrs are not set on VNodes which may be
638
680
  * changing order within a `children` array or something along those lines then
639
- * we could obtain a false positive and then have to do needless re-rendering.
681
+ * we could obtain a false negative and then have to do needless re-rendering
682
+ * (i.e. we'd say two VNodes aren't equal when in fact they should be).
640
683
  *
641
684
  * @param leftVNode the first VNode to check
642
685
  * @param rightVNode the second VNode to check
@@ -706,6 +749,18 @@ const patch = (oldVNode, newVNode) => {
706
749
  elm.data = text;
707
750
  }
708
751
  };
752
+ /**
753
+ * The main entry point for Stencil's virtual DOM-based rendering engine
754
+ *
755
+ * Given a {@link d.HostRef} container and some virtual DOM nodes, this
756
+ * function will handle creating a virtual DOM tree with a single root, patching
757
+ * the current virtual DOM tree onto an old one (if any), dealing with slot
758
+ * relocation, and reflecting attributes.
759
+ *
760
+ * @param hostRef data needed to root and render the virtual DOM tree, such as
761
+ * the DOM node into which it should be rendered.
762
+ * @param renderFnResults the virtual DOM nodes to be rendered
763
+ */
709
764
  const renderVdom = (hostRef, renderFnResults) => {
710
765
  const hostElm = hostRef.$hostElement$;
711
766
  const oldVNode = hostRef.$vnode$ || newVNode(null, null);
@@ -2,10 +2,10 @@
2
2
 
3
3
  Object.defineProperty(exports, '__esModule', { value: true });
4
4
 
5
- const index = require('./index-5d33f0ae.js');
5
+ const index = require('./index-5cc2712a.js');
6
6
 
7
7
  /*
8
- Stencil Client Patch Esm v2.22.1 | MIT Licensed | https://stenciljs.com
8
+ Stencil Client Patch Esm v2.22.2 | MIT Licensed | https://stenciljs.com
9
9
  */
10
10
  const patchEsm = () => {
11
11
  return index.promiseResolve();
@@ -2,10 +2,10 @@
2
2
 
3
3
  Object.defineProperty(exports, '__esModule', { value: true });
4
4
 
5
- const index = require('./index-5d33f0ae.js');
5
+ const index = require('./index-5cc2712a.js');
6
6
 
7
7
  /*
8
- Stencil Client Patch Browser v2.22.1 | MIT Licensed | https://stenciljs.com
8
+ Stencil Client Patch Browser v2.22.2 | MIT Licensed | https://stenciljs.com
9
9
  */
10
10
  const patchBrowser = () => {
11
11
  const importMeta = (typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('proto-ikons-wc.cjs.js', document.baseURI).href));
@@ -122,7 +122,7 @@
122
122
  ],
123
123
  "compiler": {
124
124
  "name": "@stencil/core",
125
- "version": "2.22.1",
125
+ "version": "2.22.2",
126
126
  "typescriptVersion": "4.9.4"
127
127
  },
128
128
  "collections": [],
@@ -1,4 +1,4 @@
1
- import { r as registerInstance, h } from './index-c27f5881.js';
1
+ import { r as registerInstance, h } from './index-5b3a9445.js';
2
2
 
3
3
  const acuraIkonCss = "";
4
4
 
@@ -114,6 +114,14 @@ const h = (nodeName, vnodeData, ...children) => {
114
114
  }
115
115
  return vnode;
116
116
  };
117
+ /**
118
+ * A utility function for creating a virtual DOM node from a tag and some
119
+ * possible text content.
120
+ *
121
+ * @param tag the tag for this element
122
+ * @param text possible text content for the node
123
+ * @returns a newly-minted virtual DOM node
124
+ */
117
125
  const newVNode = (tag, text) => {
118
126
  const vnode = {
119
127
  $flags$: 0,
@@ -128,6 +136,12 @@ const newVNode = (tag, text) => {
128
136
  return vnode;
129
137
  };
130
138
  const Host = {};
139
+ /**
140
+ * Check whether a given node is a Host node or not
141
+ *
142
+ * @param node the virtual DOM node to check
143
+ * @returns whether it's a Host node or not
144
+ */
131
145
  const isHost = (node) => node && node.$tag$ === Host;
132
146
  /**
133
147
  * Parse a new property value for a given property type.
@@ -410,6 +424,21 @@ const createElm = (oldParentVNode, newParentVNode, childIndex, parentElm) => {
410
424
  }
411
425
  return elm;
412
426
  };
427
+ /**
428
+ * Create DOM nodes corresponding to a list of {@link d.Vnode} objects and
429
+ * add them to the DOM in the appropriate place.
430
+ *
431
+ * @param parentElm the DOM node which should be used as a parent for the new
432
+ * DOM nodes
433
+ * @param before a child of the `parentElm` which the new children should be
434
+ * inserted before (optional)
435
+ * @param parentVNode the parent virtual DOM node
436
+ * @param vnodes the new child virtual DOM nodes to produce DOM nodes for
437
+ * @param startIdx the index in the child virtual DOM nodes at which to start
438
+ * creating DOM nodes (inclusive)
439
+ * @param endIdx the index in the child virtual DOM nodes at which to stop
440
+ * creating DOM nodes (inclusive)
441
+ */
413
442
  const addVnodes = (parentElm, before, parentVNode, vnodes, startIdx, endIdx) => {
414
443
  let containerElm = (parentElm);
415
444
  let childNode;
@@ -423,6 +452,19 @@ const addVnodes = (parentElm, before, parentVNode, vnodes, startIdx, endIdx) =>
423
452
  }
424
453
  }
425
454
  };
455
+ /**
456
+ * Remove the DOM elements corresponding to a list of {@link d.VNode} objects.
457
+ * This can be used to, for instance, clean up after a list of children which
458
+ * should no longer be shown.
459
+ *
460
+ * This function also handles some of Stencil's slot relocation logic.
461
+ *
462
+ * @param vnodes a list of virtual DOM nodes to remove
463
+ * @param startIdx the index at which to start removing nodes (inclusive)
464
+ * @param endIdx the index at which to stop removing nodes (inclusive)
465
+ * @param vnode a VNode
466
+ * @param elm an element
467
+ */
426
468
  const removeVnodes = (vnodes, startIdx, endIdx, vnode, elm) => {
427
469
  for (; startIdx <= endIdx; ++startIdx) {
428
470
  if ((vnode = vnodes[startIdx])) {
@@ -614,7 +656,8 @@ const updateChildren = (parentElm, oldCh, newVNode, newCh) => {
614
656
  *
615
657
  * So, in other words, if `key` attrs are not set on VNodes which may be
616
658
  * changing order within a `children` array or something along those lines then
617
- * we could obtain a false positive and then have to do needless re-rendering.
659
+ * we could obtain a false negative and then have to do needless re-rendering
660
+ * (i.e. we'd say two VNodes aren't equal when in fact they should be).
618
661
  *
619
662
  * @param leftVNode the first VNode to check
620
663
  * @param rightVNode the second VNode to check
@@ -684,6 +727,18 @@ const patch = (oldVNode, newVNode) => {
684
727
  elm.data = text;
685
728
  }
686
729
  };
730
+ /**
731
+ * The main entry point for Stencil's virtual DOM-based rendering engine
732
+ *
733
+ * Given a {@link d.HostRef} container and some virtual DOM nodes, this
734
+ * function will handle creating a virtual DOM tree with a single root, patching
735
+ * the current virtual DOM tree onto an old one (if any), dealing with slot
736
+ * relocation, and reflecting attributes.
737
+ *
738
+ * @param hostRef data needed to root and render the virtual DOM tree, such as
739
+ * the DOM node into which it should be rendered.
740
+ * @param renderFnResults the virtual DOM nodes to be rendered
741
+ */
687
742
  const renderVdom = (hostRef, renderFnResults) => {
688
743
  const hostElm = hostRef.$hostElement$;
689
744
  const oldVNode = hostRef.$vnode$ || newVNode(null, null);
@@ -1,8 +1,8 @@
1
- import { p as promiseResolve, b as bootstrapLazy } from './index-c27f5881.js';
2
- export { s as setNonce } from './index-c27f5881.js';
1
+ import { p as promiseResolve, b as bootstrapLazy } from './index-5b3a9445.js';
2
+ export { s as setNonce } from './index-5b3a9445.js';
3
3
 
4
4
  /*
5
- Stencil Client Patch Esm v2.22.1 | MIT Licensed | https://stenciljs.com
5
+ Stencil Client Patch Esm v2.22.2 | MIT Licensed | https://stenciljs.com
6
6
  */
7
7
  const patchEsm = () => {
8
8
  return promiseResolve();
@@ -1,8 +1,8 @@
1
- import { p as promiseResolve, b as bootstrapLazy } from './index-c27f5881.js';
2
- export { s as setNonce } from './index-c27f5881.js';
1
+ import { p as promiseResolve, b as bootstrapLazy } from './index-5b3a9445.js';
2
+ export { s as setNonce } from './index-5b3a9445.js';
3
3
 
4
4
  /*
5
- Stencil Client Patch Browser v2.22.1 | MIT Licensed | https://stenciljs.com
5
+ Stencil Client Patch Browser v2.22.2 | MIT Licensed | https://stenciljs.com
6
6
  */
7
7
  const patchBrowser = () => {
8
8
  const importMeta = import.meta.url;