lilact 0.18.0 → 0.20.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

@@ -1975,6 +1975,7 @@ __export(components_exports, {
   capture_events_set: () => capture_events_set,
   createComponent: () => createComponent2,
   createElement: () => createElement,
+  createPortal: () => createPortal,
   createRoot: () => createRoot,
   current_component: () => current_component,
   effect_timeout: () => effect_timeout,
@@ -2032,6 +2033,7 @@ var misc_exports = {};
 __export(misc_exports, {
   Children: () => Children,
   Fragment: () => Fragment2,
+  Portal: () => Portal,
   deepEqual: () => deepEqual,
   eval_num: () => eval_num,
   findDOMNode: () => findDOMNode,
@@ -2063,49 +2065,154 @@ var findDOMNode = (component) => {
   if (!((_b = (_a = component[CORE]) == null ? void 0 : _a.element) == null ? void 0 : _b.parentNode)) throw new Error("findDOMNode only works on mounted components.");
   return component[CORE].element;
 };
-var Fragment2 = function({ children }) {
+function Fragment2({ children }) {
   return children;
-};
+}
 Fragment2.displayName = "Fragment";
+function Portal({ children, view }) {
+  this[CORE].portal = view;
+  return children;
+}
+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 children - The children to read.
-   * @returns The single child (or null/exception based on the number of children).
+   * @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 {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) => {
@@ -2246,7 +2353,7 @@ var ComponentCache = class {
       arr.slice(arr[IDX]).forEach((ex) => {
         if (ex.cleanup) {
           ex.cleanup();
-        } else if (ex.element) {
+        } else if (ex.element && !ex.portal) {
           ex.element.parentElement.removeChild(ex.element);
         }
       });
@@ -2356,6 +2463,9 @@ var ComponentCore = class {
           renderErrorHandler(this, e);
         }
       }
+      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") {
         this.outlet = [this.outlet];
       }
@@ -2411,7 +2521,7 @@ var ComponentCore = class {
       if (this.component.componentWillUnmount) {
         this.component.componentWillUnmount();
       }
-      if ((_b = this == null ? void 0 : this.element) == null ? void 0 : _b.parentElement) {
+      if (((_b = this == null ? void 0 : this.element) == null ? void 0 : _b.parentElement) && !this.portal) {
         this.element.parentElement.removeChild(this.element);
       }
       if (this.outlet !== void 0) {
@@ -2559,6 +2669,7 @@ var ComponentCore = class {
   }
   appendElement(core) {
     var _a;
+    if (core.portal) return;
     this.scanZombies(core.container, core.element);
     if ((core == null ? void 0 : core.element.parentNode) === null) {
       core.container.element.insertBefore(
@@ -2628,9 +2739,13 @@ function constructFunc(core, parent) {
   } else {
     let entity = core.entity;
     let memoized = false;
-    if (typeof entity === "object" && entity[MEMOIZED]) {
-      memoized = true;
-      entity = entity[MEMOIZED];
+    if (typeof entity === "object") {
+      if (entity[MEMOIZED]) {
+        memoized = entity[MEMOIZED];
+        entity = entity.component;
+      } else {
+        throw new Error("Invalid component.");
+      }
     }
     if (typeof entity === "string") {
       comp = new HTMLComponent(entity, core.props);
@@ -2956,6 +3071,9 @@ function createRoot(element) {
     }
   };
 }
+function createPortal(children, element) {
+  return createComponent2(lilact_default.Portal, { "view": element }, children);
+}
 function render(component, element) {
   if (component[CORE] && (component[CORE].container || component[CORE].parent)) {
     throw new Error("Component is already in use");
@@ -2963,7 +3081,12 @@ function render(component, element) {
   return createRoot(element).render(component);
 }
 function memo(component) {
-  return { [MEMOIZED]: component };
+  if (typeof component === "object") {
+    component[MEMOIZED] = true;
+  } else {
+    component = { component, [MEMOIZED]: true };
+  }
+  return component;
 }
 var createElement = createComponent2;
 var current_component = [];
@@ -5827,7 +5950,7 @@ function transpileJSX(jsx2, {
 
 // .tmp/src/lilact.jsx
 var Lilact2 = {
-  VERSION: "beta.18",
+  VERSION: "beta.20",
   // Configuration
   defaultTransitionTimeout: 300,
   defaultIsEqual: Object.is,
@@ -5879,6 +6002,7 @@ export {
   Lilact2 as Lilact,
   Link,
   NavLink,
+  Portal,
   PropTypes,
   Provider,
   RootComponent,
@@ -5902,6 +6026,7 @@ export {
   createComponent2 as createComponent,
   createContext,
   createElement,
+  createPortal,
   createRoot,
   createSyntheticEvent,
   current_component,