@nizza/core 0.7.1-beta.1 → 0.8.0-beta.2

package/dist/index.mjs

@@ -21358,7 +21358,7 @@ let PT = class bf {
   }
 };
 function BU(t) {
-  return Hr().logger.lazyChild(t);
+  return Hr().baseLogger.lazyChild(t);
 }
 function DT(t, e) {
   return PT.create(
@@ -21512,6 +21512,14 @@ const Rn = class Rn {
     var e;
     (e = this.cfg) != null && e.account && await this.loadAccount(this.cfg.account, !!this.cfg.authToken);
   }
+  /**
+   * Reset account state and related config fields to their initial values.
+   */
+  resetAccount() {
+    this.accountData = void 0, this.statusInternal = "idle", this.currentFetchId = null, this.pds = void 0, this.cfg && (this.cfg.account = void 0, this.cfg.authToken = void 0, this.cfg.productId = null, this.cfg.orderFormId = null), this.logger.debug(
+      "Account state and related config fields have been reset"
+    );
+  }
   /** @returns Current version */
   get version() {
     return Rn.version;
@@ -21548,7 +21556,7 @@ const Rn = class Rn {
     return this.pds;
   }
 };
-Pe(Rn, "version", "10"), Pe(Rn, "instanceRef");
+Pe(Rn, "version", "11"), Pe(Rn, "instanceRef");
 let _f = Rn;
 const Hr = (t) => {
   const e = _f.instance();
@@ -31917,27 +31925,80 @@ Pe(dU, "baseStyles", RF`
     }
   `);
 class fU {
+  /**
+   * @param containerId ID of DOM element to render into
+   * @param renderHandler async function that mounts and returns control methods
+   * @param logger logging utility for debug tracing
+   */
   constructor(e, n, r) {
-    Pe(this, "renderFn");
-    Pe(this, "logger");
-    // Id of the root container, usually a <div>
-    Pe(this, "rootId");
+    // stores handlers for each lifecycle event; ensures uniqueness
+    Pe(this, "_lifecycleHandlers", /* @__PURE__ */ new Map([
+      ["mount", /* @__PURE__ */ new Set()],
+      ["update", /* @__PURE__ */ new Set()],
+      ["unmount", /* @__PURE__ */ new Set()]
+    ]));
+    Pe(this, "_containerId");
+    // ID of root HTML container
+    Pe(this, "_renderHandler");
+    // strategy to mount component
+    Pe(this, "_logger");
+    // logger for debug output
+    /** currently mounted element, null if none */
     Pe(this, "element", null);
-    Pe(this, "unmount");
+    /** update component props or throw if not mounted */
     Pe(this, "updateProps");
-    this.rootId = e, this.renderFn = n, this.logger = r;
+    /** unmount component or throw if not mounted */
+    Pe(this, "unmount");
+    this._containerId = e, this._renderHandler = n, this._logger = r;
   }
+  /**
+   * Mounts or updates the component with given props.
+   * Calls appropriate lifecycle hooks and logs each phase.
+   * @param props data passed to component on render/update
+   */
   async render(e = {}) {
     var n;
     if (this.element)
       this.updateProps(e);
     else {
-      const r = await this.renderFn(this.rootId, e);
-      this.element = (n = r == null ? void 0 : r.element) != null ? n : null, this.updateProps = (i) => r == null ? void 0 : r.updateProps(i), this.unmount = () => {
-        r == null || r.unmount(), this.element = null;
-      };
+      this._logger.debug("mounting component", e);
+      const r = await this._renderHandler(this._containerId, e);
+      this.element = (n = r == null ? void 0 : r.element) != null ? n : null, this.updateProps = (i) => {
+        r == null || r.updateProps(i), this._logger.debug("updating props", i), this._trigger("update", i);
+      }, this.unmount = () => {
+        this._logger.debug("unmounting component"), r == null || r.unmount(), this._trigger("unmount"), this.element = null;
+      }, this._trigger("mount");
     }
   }
+  /**
+   * Registers a callback to run after mounting.
+   * @param callback no-args handler
+   */
+  onMount(e) {
+    return this._lifecycleHandlers.get("mount").add(e), this;
+  }
+  /**
+   * Registers a callback to run after props update.
+   * @param callback receives new props
+   */
+  onUpdate(e) {
+    return this._lifecycleHandlers.get("update").add(e), this;
+  }
+  /**
+   * Registers a callback to run when unmounting.
+   * @param callback no-args handler
+   */
+  onUnmount(e) {
+    return this._lifecycleHandlers.get("unmount").add(e), this;
+  }
+  /**
+   * Internal: triggers all handlers for an event.
+   * @param event lifecycle phase to trigger
+   * @param props optional props for update handlers
+   */
+  _trigger(e, n) {
+    this._lifecycleHandlers.get(e).forEach((i) => i(n));
+  }
 }
 class Ah {
   constructor(e) {