@wirestate/lit 0.6.1 → 0.7.0-experimental.2

package/esm/development/events/on-event.js

@@ -2,19 +2,22 @@ import { __spreadArray } from 'tslib';
 import { OnEventController } from './on-event-controller.js';
 
 /**
- * Decorator to handle events from the event bus.
+ * Decorator for Lit element methods that handle events from the event bus.
  *
- * @group events
+ * @remarks
+ * The handler is registered when the host connects and unregistered when it disconnects.
+ *
+ * @group Events
  *
  * @param types - Event types to listen for. If omitted, all events will be handled.
- * @returns The decorator function.
+ * @returns A method decorator function.
  *
  * @example
  * ```typescript
  * class MyElement extends LitElement {
  *   @onEvent()
  *   private onMyEvent(event: Event) {
- *     console.log('Event received:', event);
+ *     console.log("Event received:", event);
  *   }
  * }
  * ```
@@ -22,9 +25,9 @@ import { OnEventController } from './on-event-controller.js';
  * @example
  * ```typescript
  * class MyElement extends LitElement {
- *   @onEvent('MY_EVENT_TYPE')
+ *   @onEvent("MY_EVENT_TYPE")
  *   private onMyEvent(event: MyEvent) {
- *     console.log('Event received:', event);
+ *     console.log("Event received:", event);
  *   }
  * }
  * ```
@@ -32,9 +35,9 @@ import { OnEventController } from './on-event-controller.js';
  * @example
  * ```typescript
  * class MyElement extends LitElement {
- *   @onEvent(['MY_EVENT_TYPE_1', 'MY_EVENT_TYPE_2'])
+ *   @onEvent(["MY_EVENT_TYPE_1", "MY_EVENT_TYPE_2"])
  *   private onMyEvent(event: Event) {
- *     console.log('Event received:', event);
+ *     console.log("Event received:", event);
  *   }
  * }
  * ```

package/esm/development/events/on-event.js.map

@@ -1 +1 @@
-{"version":3,"file":"on-event.js","sources":["../../../../../../../../src/wirestate-lit/events/on-event.ts"],"sourcesContent":[null],"names":["onEvent","types","normalized","undefined","Array","isArray","__spreadArray","protoOrTarget","nameOrContext","addInitializer","_this","OnEventController","event","name","constructor","element"],"mappings":";;;AAsBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCG;AACG,SAAUA,OAAOA,CAA0BC,KAA4C,EAAA;EAC3F,IAAMC,UAAU,GACdD,KAAK,KAAKE,SAAS,GAAG,IAAI,GAAGC,KAAK,CAACC,OAAO,CAACJ,KAAK,CAAC,GAAEK,aAAA,CAAA,EAAA,EAAML,KAAkC,EAAA,IAAA,CAAA,GAAI,CAACA,KAAkB,CAAC;AAErH,EAAA,OAAQ,UAACM,aAAqB,EAAEC,aAAwD,EAAA;AACtF,IAAA,IAAI,OAAOA,aAAa,KAAK,QAAQ,EAAE;AACrC;MACAA,aAAa,CAACC,cAAc,CAAC,YAAA;QAAA,IAAAC,KAAA,GAAA,IAAA;QAC3B,IAAIC,iBAAiB,CAAC,IAAuB,EAAET,UAAU,EAAE,UAACU,KAAK,EAAA;UAC/D,OAACF,KAAkB,CAACF,aAAa,CAACK,IAAI,CAAC,CAACD,KAAK,CAAC;AAA9C,QAAA,CAA8C,CAC/C;AACH,MAAA,CAAC,CAAC;AACJ,IAAA,CAAC,MAAM;AACL;AACCL,MAAAA,aAAa,CAACO,WAAsC,CAACL,cAAc,CAAC,UAACM,OAAwB,EAAA;QAC5F,IAAIJ,iBAAiB,CAACI,OAAO,EAAEb,UAAU,EAAE,UAACU,KAAK,EAAA;AAAK,UAAA,OAACG,OAAqB,CAACP,aAAa,CAAC,CAACI,KAAK,CAAC;AAA5C,QAAA,CAA4C,CAAC;AACrG,MAAA,CAAC,CAAC;AACJ,IAAA;EACF,CAAC;AACH;;;;"}
+{"version":3,"file":"on-event.js","sources":["../../../../../../../../src/wirestate-lit/events/on-event.ts"],"sourcesContent":[null],"names":["onEvent","types","normalized","undefined","Array","isArray","__spreadArray","protoOrTarget","nameOrContext","addInitializer","_this","OnEventController","event","name","constructor","element"],"mappings":";;;AAyBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCG;AACG,SAAUA,OAAOA,CAA0BC,KAA4C,EAAA;EAC3F,IAAMC,UAAU,GACdD,KAAK,KAAKE,SAAS,GAAG,IAAI,GAAGC,KAAK,CAACC,OAAO,CAACJ,KAAK,CAAC,GAAEK,aAAA,CAAA,EAAA,EAAML,KAAkC,EAAA,IAAA,CAAA,GAAI,CAACA,KAAkB,CAAC;AAErH,EAAA,OAAQ,UAACM,aAAqB,EAAEC,aAAwD,EAAA;AACtF,IAAA,IAAI,OAAOA,aAAa,KAAK,QAAQ,EAAE;AACrC;MACAA,aAAa,CAACC,cAAc,CAAC,YAAA;QAAA,IAAAC,KAAA,GAAA,IAAA;QAC3B,IAAIC,iBAAiB,CAAC,IAAuB,EAAET,UAAU,EAAE,UAACU,KAAK,EAAA;UAC/D,OAACF,KAAkB,CAACF,aAAa,CAACK,IAAI,CAAC,CAACD,KAAK,CAAC;AAA9C,QAAA,CAA8C,CAC/C;AACH,MAAA,CAAC,CAAC;AACJ,IAAA,CAAC,MAAM;AACL;AACCL,MAAAA,aAAa,CAACO,WAAsC,CAACL,cAAc,CAAC,UAACM,OAAwB,EAAA;QAC5F,IAAIJ,iBAAiB,CAACI,OAAO,EAAEb,UAAU,EAAE,UAACU,KAAK,EAAA;AAAK,UAAA,OAACG,OAAqB,CAACP,aAAa,CAAC,CAACI,KAAK,CAAC;AAA5C,QAAA,CAA4C,CAAC;AACrG,MAAA,CAAC,CAAC;AACJ,IAAA;EACF,CAAC;AACH;;;;"}

package/esm/development/events/use-on-events.js

@@ -2,15 +2,15 @@ import { __spreadArray } from 'tslib';
 import { OnEventController } from './on-event-controller.js';
 
 /**
- * Hook (controller) to handle events from the event bus.
+ * Hook that subscribes to events for the host element's lifetime.
  *
- * @group events
+ * @group Events
  *
- * @param host - the host element
- * @param options - event handling options
- * @param options.handler - event handler function
- * @param options.types - event types to listen for, if null or undefined, all events will be handled
- * @returns events subscription controller
+ * @param host - The host element.
+ * @param options - Event handling options.
+ * @param options.handler - Event handler function.
+ * @param options.types - Event types to listen for, if null or undefined, all events will be handled.
+ * @returns An instance of {@link OnEventController}.
  *
  * @example
  * ```typescript
@@ -25,7 +25,7 @@ import { OnEventController } from './on-event-controller.js';
  * ```typescript
  * class MyElement extends LitElement {
  *   private eventHandler = useOnEvents(this, {
- *     types: [MyEvent],
+ *     types: ["MY_EVENT"],
  *     handler: (event) => console.log(event),
  *   });
  * }

package/esm/development/index.js

@@ -1,5 +1,7 @@
 export { injection } from './consumption/injection.js';
+export { useContainer } from './consumption/use-container.js';
 export { useInjection } from './consumption/use-injection.js';
+export { useScope } from './consumption/use-scope.js';
 export { onCommand } from './commands/on-command.js';
 export { OnCommandController } from './commands/on-command-controller.js';
 export { useOnCommand } from './commands/use-on-command.js';
@@ -9,11 +11,11 @@ export { useOnEvents } from './events/use-on-events.js';
 export { onQuery } from './queries/on-query.js';
 export { OnQueryController } from './queries/on-query-controller.js';
 export { useOnQuery } from './queries/use-on-query.js';
-export { ContainerContext } from './context/ioc-context.js';
-export { iocProvide } from './provision/ioc-provide.js';
-export { IocProviderController } from './provision/ioc-provider-controller.js';
-export { injectablesProvide } from './provision/injectables-provide.js';
-export { InjectablesProviderController } from './provision/injectables-provider-controller.js';
-export { useInjectablesProvider } from './provision/use-injectables-provider.js';
-export { useIocProvision } from './provision/use-ioc-provision.js';
+export { ContainerContext } from './context/container-context.js';
+export { ContainerProvider } from './provision/container-provider.js';
+export { SubContainerProvider } from './provision/sub-container-provider.js';
+export { containerProvide } from './provision/container-provide.js';
+export { subContainerProvide } from './provision/sub-container-provide.js';
+export { useContainerProvision } from './provision/use-container-provision.js';
+export { useSubContainerProvider } from './provision/use-sub-container-provider.js';
 //# sourceMappingURL=index.js.map

package/esm/development/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;"}

package/esm/development/provision/container-provide.js

@@ -0,0 +1,68 @@
+import { ContainerProvider } from './container-provider.js';
+
+/**
+ * Decorator that provides an IoC container to child components.
+ *
+ * @remarks
+ * The container is provided via Lit context.
+ *
+ * - Pass `container` to expose an external container without taking
+ *   ownership.
+ * - Pass `options` to create a managed container during construction,
+ *   activate configured entries on connect, destroy it on disconnect, and
+ *   recreate it on reconnect.
+ *
+ * @group Provision
+ *
+ * @param options - Provisioning options.
+ * @param options.container - External container instance to provide.
+ * @param options.options - Managed container creation options.
+ * @returns An instance of {@link ContainerProviderDecorator}.
+ *
+ * @example
+ * ```typescript
+ * class MyRootElement extends LitElement {
+ *   @containerProvide({
+ *     options: {
+ *       seed: { someData: "value" },
+ *       entries: [LoggerService],
+ *     },
+ *   })
+ *   private containerProvider!: ContainerProvider;
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * class MyRootElement extends LitElement {
+ *   @containerProvide({ container: container })
+ *   private containerProvider!: ContainerProvider;
+ * }
+ * ```
+ */
+function containerProvide(options) {
+  return function (protoOrTarget, nameOrContext) {
+    if (typeof nameOrContext === "object") {
+      // Standard decorators:
+      nameOrContext.addInitializer(function () {
+        protoOrTarget.set.call(this, new ContainerProvider(this, options));
+      });
+    } else {
+      var controller_1;
+      protoOrTarget.constructor.addInitializer(function (element) {
+        controller_1 = new ContainerProvider(element, options);
+      });
+      return {
+        get: function () {
+          return controller_1;
+        },
+        set: function () {},
+        configurable: true,
+        enumerable: true
+      };
+    }
+  };
+}
+
+export { containerProvide };
+//# sourceMappingURL=container-provide.js.map

package/esm/development/provision/container-provide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-provide.js","sources":["../../../../../../../../src/wirestate-lit/provision/container-provide.ts"],"sourcesContent":[null],"names":["containerProvide","options","protoOrTarget","nameOrContext","addInitializer","set","call","ContainerProvider","controller_1","constructor","element","get","configurable","enumerable"],"mappings":";;AA2BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCG;AACG,SAAUA,gBAAgBA,CAC9BC,OAAiC,EAAA;AAEjC,EAAA,OAAQ,UACNC,aAAkF,EAClFC,aAAiG,EAAA;AAEjG,IAAA,IAAI,OAAOA,aAAa,KAAK,QAAQ,EAAE;AACrC;MACAA,aAAa,CAACC,cAAc,CAAC,YAAA;AAC3BF,QAAAA,aAAa,CAACG,GAAG,CAACC,IAAI,CAAC,IAAI,EAAE,IAAIC,iBAAiB,CAAC,IAAoB,EAAEN,OAAO,CAAC,CAAC;AACpF,MAAA,CAAC,CAAC;AACJ,IAAA,CAAC,MAAM;AACL,MAAA,IAAIO,YAAuC;AAE1CN,MAAAA,aAAa,CAACO,WAAsC,CAACL,cAAc,CAAC,UAACM,OAAwB,EAAA;AAC5FF,QAAAA,YAAU,GAAG,IAAID,iBAAiB,CAACG,OAAY,EAAET,OAAO,CAAC;AAC3D,MAAA,CAAC,CAAC;MAEF,OAAO;QACLU,GAAG,EAAA,YAAA;AACD,UAAA,OAAOH,YAAkC;QAC3C,CAAC;AACDH,QAAAA,GAAG,eAAU,CAAC;AACdO,QAAAA,YAAY,EAAE,IAAI;AAClBC,QAAAA,UAAU,EAAE;OACb;AACH,IAAA;EACF,CAAC;AACH;;;;"}

package/esm/development/provision/container-provider.js

@@ -0,0 +1,74 @@
+import { __extends, __assign } from 'tslib';
+import { ContextProvider } from '@lit/context';
+import { WirestateError, createContainer } from '@wirestate/core';
+import { ContainerContext } from '../context/container-context.js';
+import { ERROR_CODE_INVALID_ARGUMENTS } from '../error/error-code.js';
+
+/**
+ * Provider that exposes an IoC container context to the host element and its children.
+ *
+ * @remarks
+ * The provider supports two modes:
+ *
+ * - External mode: `container` is an existing {@link Container}. The
+ *   provider passes it through context and does not alter its lifecycle.
+ * - Managed mode: `options` is {@link CreateContainerOptions}. The provider
+ *   creates a container during construction without eager activation,
+ *   activates configured entries when the host connects, disposes the
+ *   container when the host disconnects, and recreates it on reconnect.
+ *
+ * @group Provision
+ */
+var ContainerProvider = /** @class */function (_super) {
+  __extends(ContainerProvider, _super);
+  /**
+   * @param host - The host element.
+   * @param options - Provisioning options.
+   * @param options.container - External container instance to provide.
+   * @param options.options - Managed container creation options.
+   */
+  function ContainerProvider(host, options) {
+    var _this = this;
+    if (!options.container && !options.options) {
+      throw new WirestateError(ERROR_CODE_INVALID_ARGUMENTS, "ContainerProvider requires a valid container instance or creation options.");
+    } else if (options.container && options.options) {
+      throw new WirestateError(ERROR_CODE_INVALID_ARGUMENTS, "ContainerProvider requires only container or valid options object to be provided.");
+    }
+    _this = _super.call(this, host, {
+      context: ContainerContext,
+      initialValue: options.container ? options.container : createContainer(__assign(__assign({}, options.options), {
+        activate: []
+      }))
+    }) || this;
+    _this.destroyed = false;
+    _this.options = options.options;
+    return _this;
+  }
+  ContainerProvider.prototype.hostConnected = function () {
+    var _a;
+    if (this.options) {
+      if (this.destroyed) {
+        this.value = createContainer(this.options);
+        this.destroyed = false;
+      } else {
+        if ((_a = this.options) === null || _a === void 0 ? void 0 : _a.activate) {
+          for (var _i = 0, _b = this.options.activate; _i < _b.length; _i++) {
+            var entry = _b[_i];
+            this.value.get(entry);
+          }
+        }
+      }
+    }
+    _super.prototype.hostConnected.call(this);
+  };
+  ContainerProvider.prototype.hostDisconnected = function () {
+    if (this.options) {
+      this.value.unbindAll();
+      this.destroyed = true;
+    }
+  };
+  return ContainerProvider;
+}(ContextProvider);
+
+export { ContainerProvider };
+//# sourceMappingURL=container-provider.js.map

package/esm/development/provision/container-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-provider.js","sources":["../../../../../../../../src/wirestate-lit/provision/container-provider.ts"],"sourcesContent":[null],"names":["ContainerProvider","_super","__extends","host","options","_this","container","WirestateError","ERROR_CODE_INVALID_ARGUMENTS","call","context","ContainerContext","initialValue","createContainer","activate","destroyed","prototype","hostConnected","value","_a","_i","_b","length","entry","get","hostDisconnected","unbindAll","ContextProvider"],"mappings":";;;;;;AAyCA;;;;;;;;;;;;;;AAcG;AACH,IAAAA,iBAAA,gBAAA,UAAAC,MAAA,EAAA;AACUC,EAAAA,SAAA,CAAAF,iBAAA,EAAAC,MAAA,CAAA;AAOR;;;;;AAKG;AACH,EAAA,SAAAD,iBAAAA,CAAmBG,IAAO,EAAEC,OAAiC,EAAA;IAA7D,IAAAC,KAAA,GAAA,IAAA;IACE,IAAI,CAACD,OAAO,CAACE,SAAS,IAAI,CAACF,OAAO,CAACA,OAAO,EAAE;AAC1C,MAAA,MAAM,IAAIG,cAAc,CACtBC,4BAA4B,EAC5B,4EAA4E,CAC7E;IACH,CAAC,MAAM,IAAIJ,OAAO,CAACE,SAAS,IAAIF,OAAO,CAACA,OAAO,EAAE;AAC/C,MAAA,MAAM,IAAIG,cAAc,CACtBC,4BAA4B,EAC5B,mFAAmF,CACpF;AACH,IAAA;IAEAH,KAAA,GAAAJ,MAAK,CAAAQ,IAAA,CAAA,IAAA,EAACN,IAAI,EAAE;AACVO,MAAAA,OAAO,EAAEC,gBAAgB;MACzBC,YAAY,EAAER,OAAO,CAACE,SAAS,GAAGF,OAAO,CAACE,SAAS,GAAGO,eAAe,uBAAMT,OAAO,CAACA,OAAO,CAAA,EAAA;AAAEU,QAAAA,QAAQ,EAAE;AAAE,OAAA,CAAA;KACzG,CAAC,IAAA,IAAA;IAxBMT,KAAA,CAAAU,SAAS,GAAY,KAAK;AA0BlCV,IAAAA,KAAI,CAACD,OAAO,GAAGA,OAAO,CAACA,OAAO;;AAQhC,EAAA;AAEOJ,EAAAA,iBAAA,CAAAgB,SAAA,CAAAC,aAAa,GAApB,YAAA;;IACE,IAAI,IAAI,CAACb,OAAO,EAAE;MAChB,IAAI,IAAI,CAACW,SAAS,EAAE;QAKlB,IAAI,CAACG,KAAK,GAAGL,eAAe,CAAC,IAAI,CAACT,OAAO,CAAC;QAC1C,IAAI,CAACW,SAAS,GAAG,KAAK;AACxB,MAAA,CAAC,MAAM;QACL,IAAI,MAAA,IAAI,CAACX,OAAO,MAAA,IAAA,IAAAe,EAAA,KAAA,MAAA,GAAA,MAAA,GAAAA,EAAA,CAAEL,QAAQ,EAAE;UAK1B,KAAoB,IAAAM,EAAA,GAAA,CAAqB,EAArBC,EAAA,GAAA,IAAI,CAACjB,OAAO,CAACU,QAAQ,EAArBM,EAAA,GAAAC,EAAA,CAAAC,MAAqB,EAArBF,EAAA,EAAqB,EAAE;AAAtC,YAAA,IAAMG,KAAK,GAAAF,EAAA,CAAAD,EAAA,CAAA;AACd,YAAA,IAAI,CAACF,KAAK,CAACM,GAAG,CAACD,KAAK,CAAC;AACvB,UAAA;AACF,QAAA;AACF,MAAA;AACF,IAAA;IAEAtB,MAAA,CAAAe,SAAK,CAACC,aAAa,CAAAR,IAAA,CAAA,IAAA,CAAE;EACvB,CAAC;AAEMT,EAAAA,iBAAA,CAAAgB,SAAA,CAAAS,gBAAgB,GAAvB,YAAA;IACE,IAAI,IAAI,CAACrB,OAAO,EAAE;AAKhB,MAAA,IAAI,CAACc,KAAK,CAACQ,SAAS,EAAE;MACtB,IAAI,CAACX,SAAS,GAAG,IAAI;AACvB,IAAA;EACF,CAAC;AACH,EAAA,OAAAf,iBAAC;AAAD,CA7EA,CACU2B,eAAe;;;;"}

package/esm/development/provision/sub-container-provide.js

@@ -0,0 +1,56 @@
+import { SubContainerProvider } from './sub-container-provider.js';
+
+/**
+ * Decorator that provides a managed child container derived from the nearest
+ * parent container context.
+ *
+ * @remarks
+ * The child container is created from the current parent context when the host
+ * connects, destroyed when it disconnects, and recreated when the parent
+ * container changes.
+ *
+ * @group Provision
+ *
+ * @param options - Provisioning options.
+ * @param options.options - Child-container creation options.
+ * @returns An instance of {@link SubContainerProviderDecorator}.
+ *
+ * @example
+ * ```typescript
+ * class MyComponent extends LitElement {
+ *   @subContainerProvide({
+ *     options: {
+ *       entries: [AuthService, UserService],
+ *       activate: [AuthService],
+ *     },
+ *   })
+ *   public containerProvider!: SubContainerProvider<MyComponent>;
+ * }
+ * ```
+ */
+function subContainerProvide(options) {
+  return function (protoOrTarget, nameOrContext) {
+    if (typeof nameOrContext === "object") {
+      // Standard decorators:
+      nameOrContext.addInitializer(function () {
+        protoOrTarget.set.call(this, new SubContainerProvider(this, options));
+      });
+    } else {
+      var provider_1;
+      protoOrTarget.constructor.addInitializer(function (element) {
+        provider_1 = new SubContainerProvider(element, options);
+      });
+      return {
+        get: function () {
+          return provider_1;
+        },
+        set: function () {},
+        configurable: true,
+        enumerable: true
+      };
+    }
+  };
+}
+
+export { subContainerProvide };
+//# sourceMappingURL=sub-container-provide.js.map

package/esm/development/provision/sub-container-provide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-container-provide.js","sources":["../../../../../../../../src/wirestate-lit/provision/sub-container-provide.ts"],"sourcesContent":[null],"names":["subContainerProvide","options","protoOrTarget","nameOrContext","addInitializer","set","call","SubContainerProvider","provider_1","constructor","element","get","configurable","enumerable"],"mappings":";;AA2BA;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BG;AACG,SAAUA,mBAAmBA,CACjCC,OAAoC,EAAA;AAEpC,EAAA,OAAQ,UACNC,aAAmG,EACnGC,aAAkH,EAAA;AAElH,IAAA,IAAI,OAAOA,aAAa,KAAK,QAAQ,EAAE;AACrC;MACAA,aAAa,CAACC,cAAc,CAAC,YAAA;AAC3BF,QAAAA,aAAa,CAACG,GAAG,CAACC,IAAI,CAAC,IAAI,EAAE,IAAIC,oBAAoB,CAAC,IAAuB,EAAEN,OAAO,CAAC,CAAC;AAC1F,MAAA,CAAC,CAAC;AACJ,IAAA,CAAC,MAAM;AACL,MAAA,IAAIO,UAAwC;AAE3CN,MAAAA,aAAa,CAACO,WAAsC,CAACL,cAAc,CAAC,UAACM,OAAwB,EAAA;AAC5FF,QAAAA,UAAQ,GAAG,IAAID,oBAAoB,CAACG,OAAY,EAAET,OAAO,CAAC;AAC5D,MAAA,CAAC,CAAC;MAEF,OAAO;QACLU,GAAG,EAAA,YAAA;AACD,UAAA,OAAOH,UAAmC;QAC5C,CAAC;AACDH,QAAAA,GAAG,eAAU,CAAC;AACdO,QAAAA,YAAY,EAAE,IAAI;AAClBC,QAAAA,UAAU,EAAE;OACb;AACH,IAAA;EACF,CAAC;AACH;;;;"}

package/esm/development/provision/sub-container-provider.js

@@ -0,0 +1,93 @@
+import { __extends, __assign } from 'tslib';
+import { ContextConsumer, ContextProvider } from '@lit/context';
+import { createContainer } from '@wirestate/core';
+import { ContainerContext } from '../context/container-context.js';
+
+/**
+ * Provider that exposes a managed child container for the host element's lifetime.
+ *
+ * @remarks
+ * The provider always owns a child container derived from the nearest parent
+ * {@link ContainerContext}. When connected, it creates a child container using
+ * the latest parent context, provides it to descendants, destroys it when the
+ * host disconnects, and replaces it whenever the parent container changes.
+ *
+ * @group Provision
+ *
+ * @example
+ * ```typescript
+ * class MyComponent extends LitElement {
+ *   private container = new SubContainerProvider(this, {
+ *     options: {
+ *       entries: [AuthService, UserService],
+ *       activate: [AuthService],
+ *       seeds: [[AuthService, { role: "admin" }]],
+ *     },
+ *   });
+ * }
+ * ```
+ */
+var SubContainerProvider = /** @class */function (_super) {
+  __extends(SubContainerProvider, _super);
+  /**
+   * @param host - The host element.
+   * @param options - Provisioning options, including child entries, eager activations, and seeds.
+   */
+  function SubContainerProvider(host, options) {
+    var _this = _super.call(this, host, {
+      context: ContainerContext
+    }) || this;
+    _this.parent = null;
+    _this.destroyed = true;
+    _this.options = options.options;
+    _this.consumer = new ContextConsumer(host, {
+      context: ContainerContext,
+      subscribe: true,
+      callback: function (context) {
+        var previousParent = _this.parent;
+        _this.parent = context;
+        if (host.isConnected) {
+          if (_this.destroyed || !_this.value || previousParent !== context) {
+            _this.destroyContainer();
+            _this.createContainer();
+          }
+        }
+      }
+    });
+    return _this;
+  }
+  SubContainerProvider.prototype.hostConnected = function () {
+    if (this.parent && (this.destroyed || !this.value)) {
+      this.destroyContainer();
+      this.createContainer();
+    }
+    _super.prototype.hostConnected.call(this);
+  };
+  SubContainerProvider.prototype.hostDisconnected = function () {
+    this.destroyContainer();
+  };
+  /**
+   * Replaces the currently provided child container with a new one derived
+   * from the latest parent context.
+   */
+  SubContainerProvider.prototype.createContainer = function () {
+    var container = createContainer(__assign(__assign({}, this.options), {
+      parent: this.parent
+    }));
+    this.destroyed = false;
+    this.value = container;
+  };
+  /**
+   * Destroys the currently provided child container.
+   */
+  SubContainerProvider.prototype.destroyContainer = function () {
+    if (this.value && !this.destroyed) {
+      this.value.unbindAll();
+      this.destroyed = true;
+    }
+  };
+  return SubContainerProvider;
+}(ContextProvider);
+
+export { SubContainerProvider };
+//# sourceMappingURL=sub-container-provider.js.map

package/esm/development/provision/sub-container-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-container-provider.js","sources":["../../../../../../../../src/wirestate-lit/provision/sub-container-provider.ts"],"sourcesContent":[null],"names":["SubContainerProvider","_super","__extends","host","options","_this","call","context","ContainerContext","parent","destroyed","consumer","ContextConsumer","subscribe","callback","previousParent","isConnected","value","destroyContainer","createContainer","prototype","hostConnected","hostDisconnected","container","__assign","unbindAll","ContextProvider"],"mappings":";;;;;AAkDA;;;;;;;;;;;;;;;;;;;;;;;AAuBG;AACH,IAAAA,oBAAA,gBAAA,UAAAC,MAAA,EAAA;AACUC,EAAAA,SAAA,CAAAF,oBAAA,EAAAC,MAAA,CAAA;AASR;;;AAGG;AACH,EAAA,SAAAD,oBAAAA,CAAmBG,IAAO,EAAEC,OAAoC,EAAA;IAC9D,IAAAC,KAAA,GAAAJ,MAAK,CAAAK,IAAA,CAAA,IAAA,EAACH,IAAI,EAAE;AACVI,MAAAA,OAAO,EAAEC;KACV,CAAC,IAAA,IAAA;IAVMH,KAAA,CAAAI,MAAM,GAAqB,IAAI;IAC/BJ,KAAA,CAAAK,SAAS,GAAY,IAAI;AAajCL,IAAAA,KAAI,CAACD,OAAO,GAAGA,OAAO,CAACA,OAAO;AAE9BC,IAAAA,KAAI,CAACM,QAAQ,GAAG,IAAIC,eAAe,CAACT,IAAI,EAAE;AACxCI,MAAAA,OAAO,EAAEC,gBAAgB;AACzBK,MAAAA,SAAS,EAAE,IAAI;AACfC,MAAAA,QAAQ,EAAE,UAACP,OAAkB,EAAA;AAC3B,QAAA,IAAMQ,cAAc,GAAqBV,KAAI,CAACI,MAAM;QAEpDJ,KAAI,CAACI,MAAM,GAAGF,OAAO;QAErB,IAAIJ,IAAI,CAACa,WAAW,EAAE;AAMpB,UAAA,IAAIX,KAAI,CAACK,SAAS,IAAI,CAACL,KAAI,CAACY,KAAK,IAAIF,cAAc,KAAKR,OAAO,EAAE;YAC/DF,KAAI,CAACa,gBAAgB,EAAE;YACvBb,KAAI,CAACc,eAAe,EAAE;AACxB,UAAA;AACF,QAAA;AAMF,MAAA;AACD,KAAA,CAAC;;AACJ,EAAA;AAEOnB,EAAAA,oBAAA,CAAAoB,SAAA,CAAAC,aAAa,GAApB,YAAA;AAOE,IAAA,IAAI,IAAI,CAACZ,MAAM,KAAK,IAAI,CAACC,SAAS,IAAI,CAAC,IAAI,CAACO,KAAK,CAAC,EAAE;MAClD,IAAI,CAACC,gBAAgB,EAAE;MACvB,IAAI,CAACC,eAAe,EAAE;AACxB,IAAA;IAEAlB,MAAA,CAAAmB,SAAK,CAACC,aAAa,CAAAf,IAAA,CAAA,IAAA,CAAE;EACvB,CAAC;AAEMN,EAAAA,oBAAA,CAAAoB,SAAA,CAAAE,gBAAgB,GAAvB,YAAA;IAOE,IAAI,CAACJ,gBAAgB,EAAE;EACzB,CAAC;AAED;;;AAGG;AACOlB,EAAAA,oBAAA,CAAAoB,SAAA,CAAAD,eAAe,GAAzB,YAAA;AACE,IAAA,IAAMI,SAAS,GAAcJ,eAAe,CAAAK,QAAA,CAAAA,QAAA,CAAA,EAAA,EACvC,IAAI,CAACpB,OAAO,CAAA,EAAA;MACfK,MAAM,EAAE,IAAI,CAACA;OACb;IAQF,IAAI,CAACC,SAAS,GAAG,KAAK;IACtB,IAAI,CAACO,KAAK,GAAGM,SAAS;EACxB,CAAC;AAED;;AAEG;AACOvB,EAAAA,oBAAA,CAAAoB,SAAA,CAAAF,gBAAgB,GAA1B,YAAA;IACE,IAAI,IAAI,CAACD,KAAK,IAAI,CAAC,IAAI,CAACP,SAAS,EAAE;AAMjC,MAAA,IAAI,CAACO,KAAK,CAACQ,SAAS,EAAE;MACtB,IAAI,CAACf,SAAS,GAAG,IAAI;AACvB,IAAA;EACF,CAAC;AACH,EAAA,OAAAV,oBAAC;AAAD,CA9GA,CACU0B,eAAe;;;;"}

package/esm/development/provision/use-container-provision.js

@@ -0,0 +1,44 @@
+import { ContainerProvider } from './container-provider.js';
+
+/**
+ * Hook that provides a container to the host element and its children.
+ *
+ * @remarks
+ * Pass `container` to expose an external `Container` without taking
+ * ownership. Pass `options` to create a managed container during
+ * construction, activate configured entries on connect, destroy it on
+ * disconnect, and recreate it on reconnect.
+ *
+ * @group Provision
+ *
+ * @param host - The host element.
+ * @param options - Provisioning options.
+ * @param options.container - External container instance to provide.
+ * @param options.options - Managed container creation options.
+ * @returns An instance of {@link ContainerProvider}.
+ *
+ * @example
+ * ```typescript
+ * class MyRootElement extends LitElement {
+ *   private containerProvider: ContainerProvider = useContainerProvision(this, {
+ *     options: {
+ *       entries: [LoggerService],
+ *       activate: [LoggerService],
+ *     },
+ *   });
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * class MyRootElement extends LitElement {
+ *   private containerProvider: ContainerProvider = useContainerProvision(this, { container: container });
+ * }
+ * ```
+ */
+function useContainerProvision(host, options) {
+  return new ContainerProvider(host, options);
+}
+
+export { useContainerProvision };
+//# sourceMappingURL=use-container-provision.js.map

package/esm/development/provision/use-container-provision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-container-provision.js","sources":["../../../../../../../../src/wirestate-lit/provision/use-container-provision.ts"],"sourcesContent":[null],"names":["useContainerProvision","host","options","ContainerProvider"],"mappings":";;AAWA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCG;AACG,SAAUA,qBAAqBA,CACnCC,IAAO,EACPC,OAAqC,EAAA;AAErC,EAAA,OAAO,IAAIC,iBAAiB,CAACF,IAAI,EAAEC,OAAO,CAAC;AAC7C;;;;"}

package/esm/development/provision/use-sub-container-provider.js

@@ -0,0 +1,34 @@
+import { SubContainerProvider } from './sub-container-provider.js';
+
+/**
+ * Hook that provides a managed child container for the host element's lifetime.
+ *
+ * @remarks
+ * The child container is derived from the current parent
+ * {@link ContainerContext}, recreated when that parent context changes, and
+ * destroyed when the host disconnects.
+ *
+ * @group Provision
+ *
+ * @param host - The host element.
+ * @param options - Provisioning options.
+ * @param options.options - Child-container creation options.
+ * @returns An instance of {@link SubContainerProvider}.
+ *
+ * @example
+ * ```typescript
+ * class MyComponent extends LitElement {
+ *   private containerProvider: SubContainerProvider = useSubContainerProvider(this, {
+ *     options: {
+ *       entries: [AuthService, UserService],
+ *     },
+ *   });
+ * }
+ * ```
+ */
+function useSubContainerProvider(host, options) {
+  return new SubContainerProvider(host, options);
+}
+
+export { useSubContainerProvider };
+//# sourceMappingURL=use-sub-container-provider.js.map

package/esm/development/provision/use-sub-container-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sub-container-provider.js","sources":["../../../../../../../../src/wirestate-lit/provision/use-sub-container-provider.ts"],"sourcesContent":[null],"names":["useSubContainerProvider","host","options","SubContainerProvider"],"mappings":";;AAIA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;AACG,SAAUA,uBAAuBA,CACrCC,IAAO,EACPC,OAAoC,EAAA;AAEpC,EAAA,OAAO,IAAIC,oBAAoB,CAAIF,IAAI,EAAEC,OAAO,CAAC;AACnD;;;;"}

package/esm/development/queries/on-query-controller.js

@@ -1,20 +1,21 @@
 import { ContextConsumer } from '@lit/context';
 import { QueryBus } from '@wirestate/core';
-import { ContainerContext } from '../context/ioc-context.js';
+import { ContainerContext } from '../context/container-context.js';
 
 /**
  * Reactive controller that registers a query handler on the {@link QueryBus} for the host element's lifetime.
  *
+ * @remarks
  * The handler is registered when the host connects and unregistered when it disconnects.
- * When the IoC context is updated (container revision change), the handler is re-registered automatically.
+ * It automatically re-registers if the IoC container is updated.
  *
- * @group queries
+ * @group Queries
  */
 var OnQueryController = /** @class */function () {
   /**
-   * @param host - the host element
-   * @param type - the query type to handle
-   * @param handler - the query handler function
+   * @param host - The host element.
+   * @param type - Unique identifier of the query to handle.
+   * @param handler - The query handler function.
    */
   function OnQueryController(host, type, handler) {
     var _this = this;
@@ -26,8 +27,8 @@ var OnQueryController = /** @class */function () {
     new ContextConsumer(host, {
       context: ContainerContext,
       subscribe: true,
-      callback: function (context) {
-        _this.bus = context.container.get(QueryBus);
+      callback: function (container) {
+        _this.bus = container.get(QueryBus);
         if (host.isConnected) {
           _this.reregister();
         }

package/esm/development/queries/on-query-controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"on-query-controller.js","sources":["../../../../../../../../src/wirestate-lit/queries/on-query-controller.ts"],"sourcesContent":[null],"names":["OnQueryController","host","type","handler","_this","bus","unregister","addController","ContextConsumer","context","ContainerContext","subscribe","callback","container","get","QueryBus","isConnected","reregister","prototype","hostConnected","hostDisconnected","cleanup","register","_a","call"],"mappings":";;;;AAUA;;;;;;;AAOG;AACH,IAAAA,iBAAA,gBAAA,YAAA;AAOE;;;;AAIG;AACH,EAAA,SAAAA,iBAAAA,CAAmBC,IAAqB,EAAEC,IAAe,EAAEC,OAA2B,EAAA;IAAtF,IAAAC,KAAA,GAAA,IAAA;IAXQ,IAAA,CAAAC,GAAG,GAAuB,IAAI;IAC9B,IAAA,CAAAC,UAAU,GAA8B,IAAI;AAWlDL,IAAAA,IAAI,CAACM,aAAa,CAAC,IAAI,CAAC;IAExB,IAAI,CAACL,IAAI,GAAGA,IAAI;IAChB,IAAI,CAACC,OAAO,GAAGA,OAAO;IAItB,IAAIK,eAAe,CAACP,IAAI,EAAE;AACxBQ,MAAAA,OAAO,EAAEC,gBAAgB;AACzBC,MAAAA,SAAS,EAAE,IAAI;AACfC,MAAAA,QAAQ,EAAE,UAACH,OAAO,EAAA;QAChBL,KAAI,CAACC,GAAG,GAAGI,OAAO,CAACI,SAAS,CAACC,GAAG,CAACC,QAAQ,CAAC;QAE1C,IAAId,IAAI,CAACe,WAAW,EAAE;UACpBZ,KAAI,CAACa,UAAU,EAAE;AACnB,QAAA;AACF,MAAA;AACD,KAAA,CAAC;AACJ,EAAA;AAEOjB,EAAAA,iBAAA,CAAAkB,SAAA,CAAAC,aAAa,GAApB,YAAA;IAEE,IAAI,CAACF,UAAU,EAAE;EACnB,CAAC;AAEMjB,EAAAA,iBAAA,CAAAkB,SAAA,CAAAE,gBAAgB,GAAvB,YAAA;IAEE,IAAI,CAACC,OAAO,EAAE;EAChB,CAAC;AAEOrB,EAAAA,iBAAA,CAAAkB,SAAA,CAAAD,UAAU,GAAlB,YAAA;IACE,IAAI,CAACI,OAAO,EAAE;IAEd,IAAI,IAAI,CAAChB,GAAG,EAAE;AAEZ,MAAA,IAAI,CAACC,UAAU,GAAG,IAAI,CAACD,GAAG,CAACiB,QAAQ,CAAC,IAAI,CAACpB,IAAI,EAAE,IAAI,CAACC,OAAO,CAAC;AAC9D,IAAA;EACF,CAAC;AAEOH,EAAAA,iBAAA,CAAAkB,SAAA,CAAAG,OAAO,GAAf,YAAA;;IACE,CAAAE,EAAA,GAAA,IAAI,CAACjB,UAAU,MAAA,IAAA,IAAAiB,EAAA,KAAA,MAAA,GAAA,MAAA,GAAAA,EAAA,CAAAC,IAAA,CAAA,IAAA,CAAI;IACnB,IAAI,CAAClB,UAAU,GAAG,IAAI;EACxB,CAAC;AACH,EAAA,OAAAN,iBAAC;AAAD,CAAC;;;;"}
+{"version":3,"file":"on-query-controller.js","sources":["../../../../../../../../src/wirestate-lit/queries/on-query-controller.ts"],"sourcesContent":[null],"names":["OnQueryController","host","type","handler","_this","bus","unregister","addController","ContextConsumer","context","ContainerContext","subscribe","callback","container","get","QueryBus","isConnected","reregister","prototype","hostConnected","hostDisconnected","cleanup","register","_a","call"],"mappings":";;;;AAUA;;;;;;;;AAQG;AACH,IAAAA,iBAAA,gBAAA,YAAA;AAOE;;;;AAIG;AACH,EAAA,SAAAA,iBAAAA,CAAmBC,IAAqB,EAAEC,IAAe,EAAEC,OAA2B,EAAA;IAAtF,IAAAC,KAAA,GAAA,IAAA;IAXQ,IAAA,CAAAC,GAAG,GAAuB,IAAI;IAC9B,IAAA,CAAAC,UAAU,GAA8B,IAAI;AAWlDL,IAAAA,IAAI,CAACM,aAAa,CAAC,IAAI,CAAC;IAExB,IAAI,CAACL,IAAI,GAAGA,IAAI;IAChB,IAAI,CAACC,OAAO,GAAGA,OAAO;IAItB,IAAIK,eAAe,CAACP,IAAI,EAAE;AACxBQ,MAAAA,OAAO,EAAEC,gBAAgB;AACzBC,MAAAA,SAAS,EAAE,IAAI;AACfC,MAAAA,QAAQ,EAAE,UAACC,SAAS,EAAA;QAClBT,KAAI,CAACC,GAAG,GAAGQ,SAAS,CAACC,GAAG,CAACC,QAAQ,CAAC;QAElC,IAAId,IAAI,CAACe,WAAW,EAAE;UACpBZ,KAAI,CAACa,UAAU,EAAE;AACnB,QAAA;AACF,MAAA;AACD,KAAA,CAAC;AACJ,EAAA;AAEOjB,EAAAA,iBAAA,CAAAkB,SAAA,CAAAC,aAAa,GAApB,YAAA;IAEE,IAAI,CAACF,UAAU,EAAE;EACnB,CAAC;AAEMjB,EAAAA,iBAAA,CAAAkB,SAAA,CAAAE,gBAAgB,GAAvB,YAAA;IAEE,IAAI,CAACC,OAAO,EAAE;EAChB,CAAC;AAEOrB,EAAAA,iBAAA,CAAAkB,SAAA,CAAAD,UAAU,GAAlB,YAAA;IACE,IAAI,CAACI,OAAO,EAAE;IAEd,IAAI,IAAI,CAAChB,GAAG,EAAE;AAEZ,MAAA,IAAI,CAACC,UAAU,GAAG,IAAI,CAACD,GAAG,CAACiB,QAAQ,CAAC,IAAI,CAACpB,IAAI,EAAE,IAAI,CAACC,OAAO,CAAC;AAC9D,IAAA;EACF,CAAC;AAEOH,EAAAA,iBAAA,CAAAkB,SAAA,CAAAG,OAAO,GAAf,YAAA;;IACE,CAAAE,EAAA,GAAA,IAAI,CAACjB,UAAU,MAAA,IAAA,IAAAiB,EAAA,KAAA,MAAA,GAAA,MAAA,GAAAA,EAAA,CAAAC,IAAA,CAAA,IAAA,CAAI;IACnB,IAAI,CAAClB,UAAU,GAAG,IAAI;EACxB,CAAC;AACH,EAAA,OAAAN,iBAAC;AAAD,CAAC;;;;"}

package/esm/development/queries/on-query.js

@@ -1,20 +1,21 @@
 import { OnQueryController } from './on-query-controller.js';
 
 /**
- * Decorator that registers a Lit element method as a query handler for the given type.
+ * Decorator for Lit element methods that handle a specific query.
  *
- * The handler is registered when the host element connects to the DOM and unregistered when it disconnects.
+ * @remarks
+ * The handler is registered when the host connects and unregistered when it disconnects.
  *
- * @group queries
+ * @group Queries
  *
- * @param type - the query type to handle
- * @returns the decorator function
+ * @param type - Unique identifier of the query to handle.
+ * @returns A method decorator function.
  *
  * @example
  * ```typescript
  * class MyElement extends LitElement {
  *   @onQuery("GET_USER_NAME")
- *   public onGetUserName(data: QueryData) {
+ *   private onGetUserName(data: QueryData) {
  *     return "Alice";
  *   }
  * }

package/esm/development/queries/on-query.js.map

@@ -1 +1 @@
-{"version":3,"file":"on-query.js","sources":["../../../../../../../../src/wirestate-lit/queries/on-query.ts"],"sourcesContent":[null],"names":["onQuery","type","protoOrTarget","nameOrContext","addInitializer","_this","OnQueryController","data","name","constructor","element"],"mappings":";;AAwBA;;;;;;;;;;;;;;;;;;;AAmBG;AACG,SAAUA,OAAOA,CAA2BC,IAAe,EAAA;AAC/D,EAAA,OAAQ,UAACC,aAAqB,EAAEC,aAAwD,EAAA;AACtF,IAAA,IAAI,OAAOA,aAAa,KAAK,QAAQ,EAAE;AACrC;MACAA,aAAa,CAACC,cAAc,CAAC,YAAA;QAAA,IAAAC,KAAA,GAAA,IAAA;QAC3B,IAAIC,iBAAiB,CACnB,IAAuB,EACvBL,IAAI,EACJ,UAACM,IAAO,EAAA;UAAK,OAACF,KAAkB,CAACF,aAAa,CAACK,IAAI,CAAC,CAACD,IAAI,CAAoB;AAAhE,QAAA,CAAgE,CAC9E;AACH,MAAA,CAAC,CAAC;AACJ,IAAA,CAAC,MAAM;AACL;AACCL,MAAAA,aAAa,CAACO,WAAsC,CAACL,cAAc,CAAC,UAACM,OAAwB,EAAA;QAC5F,IAAIJ,iBAAiB,CACnBI,OAAO,EACPT,IAAI,EACJ,UAACM,IAAO,EAAA;AAAK,UAAA,OAACG,OAAqB,CAACP,aAAa,CAAC,CAACI,IAAI,CAAoB;AAA9D,QAAA,CAA8D,CAC5E;AACH,MAAA,CAAC,CAAC;AACJ,IAAA;EACF,CAAC;AACH;;;;"}
+{"version":3,"file":"on-query.js","sources":["../../../../../../../../src/wirestate-lit/queries/on-query.ts"],"sourcesContent":[null],"names":["onQuery","type","protoOrTarget","nameOrContext","addInitializer","_this","OnQueryController","data","name","constructor","element"],"mappings":";;AAyBA;;;;;;;;;;;;;;;;;;;;AAoBG;AACG,SAAUA,OAAOA,CAA2BC,IAAe,EAAA;AAC/D,EAAA,OAAQ,UAACC,aAAqB,EAAEC,aAAwD,EAAA;AACtF,IAAA,IAAI,OAAOA,aAAa,KAAK,QAAQ,EAAE;AACrC;MACAA,aAAa,CAACC,cAAc,CAAC,YAAA;QAAA,IAAAC,KAAA,GAAA,IAAA;QAC3B,IAAIC,iBAAiB,CACnB,IAAuB,EACvBL,IAAI,EACJ,UAACM,IAAO,EAAA;UAAK,OAACF,KAAkB,CAACF,aAAa,CAACK,IAAI,CAAC,CAACD,IAAI,CAAoB;AAAhE,QAAA,CAAgE,CAC9E;AACH,MAAA,CAAC,CAAC;AACJ,IAAA,CAAC,MAAM;AACL;AACCL,MAAAA,aAAa,CAACO,WAAsC,CAACL,cAAc,CAAC,UAACM,OAAwB,EAAA;QAC5F,IAAIJ,iBAAiB,CACnBI,OAAO,EACPT,IAAI,EACJ,UAACM,IAAO,EAAA;AAAK,UAAA,OAACG,OAAqB,CAACP,aAAa,CAAC,CAACI,IAAI,CAAoB;AAA9D,QAAA,CAA8D,CAC5E;AACH,MAAA,CAAC,CAAC;AACJ,IAAA;EACF,CAAC;AACH;;;;"}

package/esm/development/queries/use-on-query.js

@@ -1,15 +1,15 @@
 import { OnQueryController } from './on-query-controller.js';
 
 /**
- * Registers a query handler on the {@link QueryBus} for the host element's lifetime.
+ * Hook that registers a query handler for the host element's lifetime.
  *
- * @group queries
+ * @group Queries
  *
- * @param host - the host element
- * @param options - query handling options
- * @param options.type - the query type to handle
- * @param options.handler - the query handler function
- * @returns the query controller instance
+ * @param host - The host element.
+ * @param options - Query handling options.
+ * @param options.type - The query type to handle.
+ * @param options.handler - The query handler function.
+ * @returns An instance of {@link OnQueryController}.
  *
  * @example
  * ```typescript