lilact 0.19.0 → 0.21.0

package/README.md

@@ -29,7 +29,7 @@ If you find Lilact useful, please consider sponsoring. Your support funds ongoin
 
 ## Overview
 
-`Lilact` is a very lightweight implementation of the React API designed to run in the browser. It can be used as a single script that is around `90kb` minified and around `32kb` gzipped and includes its whole API.
+`Lilact` is a very lightweight implementation of the React API designed to run in the browser. It can be used as a single script that is around `90kb` minified and around `32kb` gzipped and includes its whole API. It is tested and works on **Chrome**, **Firefox**, **Edge**, and **Safari**.
 
 `Lilact` is very fast, uses minimal resources, and handles memory very efficiently.
 

package/dist/lilact.development.js

@@ -2076,43 +2076,143 @@ function Portal({ children, view }) {
 Portal.displayName = "Portal";
 var Children = {
   /**
-   * Returns the only child from a children collection.
+   * @param {any} x
+   * @returns {boolean}
+   */
+  _isNil(x) {
+    return x === null || x === void 0;
+  },
+  /**
+   * Recursively flattens nested arrays into `out`, omitting null/undefined.
+   * @param {Array<any>} out
+   * @param {any} input
+   */
+  _flattenInto(out, input) {
+    if (this._isNil(input)) return;
+    if (Array.isArray(input)) {
+      for (const v of input) this._flattenInto(out, v);
+      return;
+    }
+    out.push(input);
+  },
+  /**
+   * Converts an iterable children collection into a flat array,
+   * omitting `null`/`undefined`.
+   *
+   * @param {Iterable<any>} children
+   * @returns {Array<any>}
+   */
+  toArray(children) {
+    const out = [];
+    if (!children) return out;
+    for (const item of children) {
+      this._flattenInto(out, item);
+    }
+    return out;
+  },
+  /**
+   * Returns the number of non-null/undefined children (after flattening).
+   * @param {Iterable<any>} children
+   * @returns {number}
+   */
+  count(children) {
+    return this.toArray(children).length;
+  },
+  /**
+   * Returns the single child from a children collection (after flattening & omitting nil),
+   * or throws if the remaining count is not exactly 1.
    *
-   * @param children - The children to read.
-   * @returns The single child (or null/exception based on the number of children).
+   * @param {Iterable<any>} children
+   * @returns {any}
    */
   only(children) {
-    var _a, _b;
-    children = [...children];
-    let i2 = 0;
-    while (i2 < children.length) {
-      if (((_b = (_a = children[i2]) == null ? void 0 : _a.constructor) == null ? void 0 : _b.name) === "Array") {
-        children.splice(i2, 1, ...children[i2]);
-        i2--;
-      } else if (children[i2] === null || children[i2] === void 0) {
-        children.splice(i2, 1);
-        i2--;
-      }
-      if (i2 > 1) {
-        throw new Error("No child or child is not the only one");
-      }
-      i2++;
+    const arr = this.toArray(children);
+    if (arr.length !== 1) {
+      throw new Error(
+        arr.length === 0 ? "Expected exactly one child, but received none." : "Expected exactly one child, but received more than one."
+      );
     }
-    if (children.length === 1) return children[0];
+    return arr[0];
   },
   /**
-   * Converts component children into a flat array.
+   * Maps over children (after flattening & omitting nil).
    *
-   * @param children - The children to convert.
-   * @returns An array representation of the children.
+   * @param {Iterable<any>} children
+   * @param {(child:any, index:number)=>any} fn
+   * @returns {Array<any>}
    */
-  toArray(children) {
-    var _a;
-    if (children) {
-      if (((_a = children == null ? void 0 : children.constructor) == null ? void 0 : _a.name) === "Array") return [...children];
-      return [children];
+  map(children, fn) {
+    const arr = this.toArray(children);
+    const out = [];
+    for (let i2 = 0; i2 < arr.length; i2++) out.push(fn(arr[i2], i2));
+    return out;
+  },
+  /**
+   * Iterates over children (after flattening & omitting nil).
+   * @param {Iterable<any>} children
+   * @param {(child:any, index:number)=>void} fn
+   */
+  forEach(children, fn) {
+    const arr = this.toArray(children);
+    for (let i2 = 0; i2 < arr.length; i2++) fn(arr[i2], i2);
+  },
+  /**
+   * Finds the first child for which predicate returns true.
+   *
+   * @param {Iterable<any>} children
+   * @param {(child:any, index:number)=>boolean} predicate
+   * @returns {any|undefined}
+   */
+  find(children, predicate) {
+    const arr = this.toArray(children);
+    for (let i2 = 0; i2 < arr.length; i2++) {
+      if (predicate(arr[i2], i2)) return arr[i2];
+    }
+    return void 0;
+  },
+  /**
+   * Finds exactly one matching child.
+   * Throws if matched count is not exactly 1.
+   *
+   * @param {Iterable<any>} children
+   * @param {(child:any, index:number)=>boolean} predicate
+   * @returns {any}
+   */
+  pickOne(children, predicate) {
+    const arr = this.toArray(children);
+    let found;
+    let matches = 0;
+    for (let i2 = 0; i2 < arr.length; i2++) {
+      if (predicate(arr[i2], i2)) {
+        matches++;
+        found = arr[i2];
+        if (matches > 1) break;
+      }
     }
-    return [];
+    if (matches !== 1) {
+      throw new Error(
+        matches === 0 ? "pickOne expected exactly one matching child, but matched none." : "pickOne expected exactly one matching child, but matched multiple."
+      );
+    }
+    return found;
+  },
+  /**
+   * Returns the first non-nil child (after flattening), or undefined.
+   * @param {Iterable<any>} children
+   * @returns {any|undefined}
+   */
+  first(children) {
+    const arr = this.toArray(children);
+    return arr[0];
+  },
+  /**
+   * Returns the last non-nil child (after flattening), or undefined.
+   * @param {Iterable<any>} children
+   * @returns {any|undefined}
+   */
+  last(children) {
+    const arr = this.toArray(children);
+    return arr.length ? arr[arr.length - 1] : void 0;
   }
 };
 var forwardRef = (render2) => {
@@ -2296,7 +2396,7 @@ var ComponentCore = class {
   */
   // TODO: should componentDidUpdate be called after arranging/appending the outlet or before?
   apply(next_props = this.props, next_state = this.next_state || this.state) {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
     let do_rerender = true;
     if (this.outlet && (this == null ? void 0 : this[MEMOIZED])) {
       if (shallowEqual(this.props, next_props, "children") && shallowEqual((_a = this.props) == null ? void 0 : _a.children, next_props == null ? void 0 : next_props.children)) {
@@ -2315,6 +2415,12 @@ var ComponentCore = class {
       if (this.component.constructor.defaultProps) {
         next_props = { ...this.component.constructor.defaultProps, ...next_props };
       }
+      if (((_e = (_d = this == null ? void 0 : this.parent) == null ? void 0 : _d.component) == null ? void 0 : _e.context) || ((_g = (_f = this == null ? void 0 : this.parent) == null ? void 0 : _f.component) == null ? void 0 : _g.getChildContext)) {
+        this.context = { ...this.parent.component.context, ...(_i = (_h = this.parent.component).getChildContext) == null ? void 0 : _i.call(_h) };
+        if (this.component.constructor.contextTypes) {
+          PropTypes.checkPropTypes(this.component.constructor.contextTypes, this.context, "context", this.entity.name);
+        }
+      }
       if (this.component.shouldComponentUpdate && !this.component.shouldComponentUpdate(next_state, next_props, this.context)) return;
       if (typeof this.entity === "string") {
         if (!(this.element instanceof Element)) {
@@ -2366,7 +2472,7 @@ var ComponentCore = class {
       if (this == null ? void 0 : this.portal) {
         this.element = this.portal;
       }
-      if (((_e = (_d = this.outlet) == null ? void 0 : _d.constructor) == null ? void 0 : _e.name) !== "Array") {
+      if (((_k = (_j = this.outlet) == null ? void 0 : _j.constructor) == null ? void 0 : _k.name) !== "Array") {
         this.outlet = [this.outlet];
       }
       this.outlet = [...this.outlet];
@@ -2885,20 +2991,11 @@ var Component = class {
   	componentWillUnmount			 () {}
   	getSnapshotBeforeUpdate			 (prevProps, prevState) {}
   	shouldComponentUpdate			 (nextProps, nextState) {}
+  	getChildContext()
   
   	static getDerivedStateFromError	 (error) {}
   	static getDerivedStateFromProps	 (props, state) {}
-  
-  
-  	*/
-  /* // todo: maybe 
-  	static get contextType() {  }
-  	static set contextType(ctxt) {  } 
-  
-  	static get childContextTypes()  {}
-  	static set childContextTypes(ctxt) {  } 
-  
-  	getChildContext()
+  	static contextType
   	*/
 };
 var HTMLComponent = class extends Component {
@@ -5850,7 +5947,7 @@ function transpileJSX(jsx2, {
 
 // .tmp/src/lilact.jsx
 var Lilact2 = {
-  VERSION: "beta.19",
+  VERSION: "beta.21",
   // Configuration
   defaultTransitionTimeout: 300,
   defaultIsEqual: Object.is,