@lushly-dev/fast-element 3.0.1-preview.1 → 3.0.1-preview.2

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.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "metadata": {
3
3
  "toolPackage": "@microsoft/api-extractor",
4
- "toolVersion": "7.58.1",
4
+ "toolVersion": "7.60.1",
5
5
  "schemaVersion": 1011,
6
6
  "oldestForwardsCompatibleVersion": 1001,
7
7
  "tsdocConfig": {
@@ -191,7 +191,7 @@
191
191
  {
192
192
  "kind": "Function",
193
193
  "canonicalReference": "@lushly-dev/fast-element!all:function(1)",
194
- "docComment": "/**\n * A decorator and DI resolver that will resolve an array of all dependencies registered with the specified key.\n *\n * @param key - The key to resolve all dependencies for.\n *\n * @param searchAncestors - [optional] Indicates whether to search ancestor containers.\n *\n * @public\n */\n",
194
+ "docComment": "/**\n * A decorator and DI resolver that will resolve an array of all dependencies\n * registered with the specified key.\n *\n * @param key - The key to resolve all dependencies for.\n *\n * @param searchAncestors - [optional] Indicates whether to search ancestor containers.\n *\n * @public\n */\n",
195
195
  "excerptTokens": [
196
196
  {
197
197
  "kind": "Content",
@@ -480,7 +480,7 @@
480
480
  {
481
481
  "kind": "MethodSignature",
482
482
  "canonicalReference": "@lushly-dev/fast-element!Container#getResolver:member(1)",
483
- "docComment": "/**\n * Gets a resolver for the specified key.\n *\n * @param key - The key to get the resolver for.\n *\n * @param autoRegister - Indicates whether or not to try to auto-register a dependency for the key if one is not explicitly registered.\n */\n",
483
+ "docComment": "/**\n * Gets a resolver for the specified key.\n *\n * @param key - The key to get the resolver for.\n *\n * @param autoRegister - Indicates whether or not to try to auto-register a dependency for\n * the key if one is not explicitly registered.\n */\n",
484
484
  "excerptTokens": [
485
485
  {
486
486
  "kind": "Content",
@@ -1005,7 +1005,7 @@
1005
1005
  {
1006
1006
  "kind": "PropertySignature",
1007
1007
  "canonicalReference": "@lushly-dev/fast-element!ContainerConfiguration#asyncRegistrationLocator:member",
1008
- "docComment": "/**\n * When an asynchronous get request is made to the container, if no resolver is found for the key, this function is called to provide a registration.\n */\n",
1008
+ "docComment": "/**\n * When an asynchronous get request is made to the container, if no\n * resolver is found for the key, this function is called to provide\n * a registration.\n */\n",
1009
1009
  "excerptTokens": [
1010
1010
  {
1011
1011
  "kind": "Content",
@@ -1125,7 +1125,7 @@
1125
1125
  {
1126
1126
  "kind": "PropertySignature",
1127
1127
  "canonicalReference": "@lushly-dev/fast-element!ContainerConfiguration#responsibleForOwnerRequests:member",
1128
- "docComment": "/**\n * Indicates whether this container should resolve dependencies that are directly made by its owner. The default is \"false\" which results in the parent container being used.\n */\n",
1128
+ "docComment": "/**\n * Indicates whether this container should resolve dependencies that are directly made\n * by its owner. The default is \"false\" which results in the parent container being used.\n */\n",
1129
1129
  "excerptTokens": [
1130
1130
  {
1131
1131
  "kind": "Content",
@@ -1614,7 +1614,7 @@
1614
1614
  {
1615
1615
  "kind": "MethodSignature",
1616
1616
  "canonicalReference": "@lushly-dev/fast-element!DOMContainer#handleContextRequests:member(1)",
1617
- "docComment": "/**\n * Instructs this particular Container to handle W3C Community Context requests that propagate to its associated DOM node.\n *\n * @param enable - true to enable context requests handling; false otherwise.\n *\n * @beta\n */\n",
1617
+ "docComment": "/**\n * Instructs this particular Container to handle W3C Community Context requests\n * that propagate to its associated DOM node.\n *\n * @param enable - true to enable context requests handling; false otherwise.\n *\n * @beta\n */\n",
1618
1618
  "excerptTokens": [
1619
1619
  {
1620
1620
  "kind": "Content",
@@ -1821,7 +1821,7 @@
1821
1821
  {
1822
1822
  "kind": "MethodSignature",
1823
1823
  "canonicalReference": "@lushly-dev/fast-element!Factory#constructAsync:member(1)",
1824
- "docComment": "/**\n * Constructs an instance of the factory's object, allowing for async resolution of dependencies.\n *\n * @param container - The container the object is being constructor for.\n *\n * @param dynamicDependencies - Dynamic dependencies supplied to the constructor.\n */\n",
1824
+ "docComment": "/**\n * Constructs an instance of the factory's object, allowing for\n * async resolution of dependencies.\n *\n * @param container - The container the object is being constructor for.\n *\n * @param dynamicDependencies - Dynamic dependencies supplied to the constructor.\n */\n",
1825
1825
  "excerptTokens": [
1826
1826
  {
1827
1827
  "kind": "Content",
@@ -1902,7 +1902,7 @@
1902
1902
  {
1903
1903
  "kind": "MethodSignature",
1904
1904
  "canonicalReference": "@lushly-dev/fast-element!Factory#registerTransformer:member(1)",
1905
- "docComment": "/**\n * Registers a transformer function to alter the object after instantiation but before returning the final constructed instance.\n *\n * @param transformer - The transformer function.\n */\n",
1905
+ "docComment": "/**\n * Registers a transformer function to alter the object after instantiation but before\n * returning the final constructed instance.\n *\n * @param transformer - The transformer function.\n */\n",
1906
1906
  "excerptTokens": [
1907
1907
  {
1908
1908
  "kind": "Content",
@@ -2065,7 +2065,7 @@
2065
2065
  {
2066
2066
  "kind": "Function",
2067
2067
  "canonicalReference": "@lushly-dev/fast-element!inject:function(1)",
2068
- "docComment": "/**\n * A decorator that specifies what to inject into its target.\n *\n * @remarks\n *\n * The decorator can be used to decorate a class, listing all of the classes dependencies. Or it can be used to decorate a constructor paramter, indicating what to inject for that parameter. Or it can be used for a web component property, indicating what that property should resolve to.\n *\n * @param dependencies - The dependencies to inject.\n *\n * @returns The decorator to be applied to the target class.\n *\n * @public\n */\n",
2068
+ "docComment": "/**\n * A decorator that specifies what to inject into its target.\n *\n * @remarks\n *\n * The decorator can be used to decorate a class, listing all of the classes dependencies.\n * Or it can be used to decorate a constructor paramter, indicating what to inject for that\n * parameter.\n * Or it can be used for a web component property, indicating what that property should resolve to.\n *\n * @param dependencies - The dependencies to inject.\n *\n * @returns The decorator to be applied to the target class.\n *\n * @public\n */\n",
2069
2069
  "excerptTokens": [
2070
2070
  {
2071
2071
  "kind": "Content",
@@ -2120,7 +2120,7 @@
2120
2120
  {
2121
2121
  "kind": "TypeAlias",
2122
2122
  "canonicalReference": "@lushly-dev/fast-element!Injectable:type",
2123
- "docComment": "/**\n * A class that declares constructor injected dependencies through a static \"inject\" field array of keys.\n *\n * @public\n */\n",
2123
+ "docComment": "/**\n * A class that declares constructor injected dependencies through\n * a static \"inject\" field array of keys.\n *\n * @public\n */\n",
2124
2124
  "excerptTokens": [
2125
2125
  {
2126
2126
  "kind": "Content",
@@ -2223,7 +2223,7 @@
2223
2223
  {
2224
2224
  "kind": "PropertySignature",
2225
2225
  "canonicalReference": "@lushly-dev/fast-element!InterfaceConfiguration#respectConnection:member",
2226
- "docComment": "/**\n * When true, the dependency will be re-resolved when FASTElement connection changes. If the resolved value changes due to connection change, an observable notification will be emitted for the property, with the previous and next values provided to any subscriber.\n */\n",
2226
+ "docComment": "/**\n * When true, the dependency will be re-resolved when FASTElement connection changes.\n * If the resolved value changes due to connection change, an observable notification\n * will be emitted for the property, with the previous and next values provided to any subscriber.\n */\n",
2227
2227
  "excerptTokens": [
2228
2228
  {
2229
2229
  "kind": "Content",
@@ -2307,7 +2307,7 @@
2307
2307
  {
2308
2308
  "kind": "Function",
2309
2309
  "canonicalReference": "@lushly-dev/fast-element!lazy:function(1)",
2310
- "docComment": "/**\n * A decorator that lazily injects a dependency depending on whether the `Key` is present at the time of function call.\n *\n * @param key - The key to lazily resolve. see {@link DI.createContext} on interactions with interfaces\n *\n * @example\n *\n * You need to make your argument a function that returns the type, for example\n * ```ts\n * class Foo {\n * constructor( @lazy('random') public random: () => number )\n * }\n * const foo = container.get(Foo); // instanceof Foo\n * foo.random(); // throws\n * ```\n *\n * would throw an exception because you haven't registered `'random'` before calling the method.\n *\n * @example\n *\n * This, would give you a new 'Math.random()' number each time.\n * ```ts\n * class Foo {\n * constructor( @lazy('random') public random: () => random )\n * }\n * container.register(Registration.callback('random', Math.random ));\n * container.get(Foo).random(); // some random number\n * container.get(Foo).random(); // another random number\n * ```\n *\n * `@lazy` does not manage the lifecycle of the underlying key. If you want a singleton, you have to register as a `singleton`, `transient` would also behave as you would expect, providing you a new instance each time.\n *\n * @public\n */\n",
2310
+ "docComment": "/**\n * A decorator that lazily injects a dependency depending on whether the `Key` is present at the time of function call.\n *\n * @param key - The key to lazily resolve.\n * see {@link DI.createContext} on interactions with interfaces\n *\n * @example\n *\n * You need to make your argument a function that returns the type, for example\n * ```ts\n * class Foo {\n * constructor( @lazy('random') public random: () => number )\n * }\n * const foo = container.get(Foo); // instanceof Foo\n * foo.random(); // throws\n * ```\n *\n * would throw an exception because you haven't registered `'random'` before calling the method.\n *\n * @example\n *\n * This, would give you a new 'Math.random()' number each time.\n * ```ts\n * class Foo {\n * constructor( @lazy('random') public random: () => random )\n * }\n * container.register(Registration.callback('random', Math.random ));\n * container.get(Foo).random(); // some random number\n * container.get(Foo).random(); // another random number\n * ```\n *\n * `@lazy` does not manage the lifecycle of the underlying key. If you want a singleton, you have to register as a\n * `singleton`, `transient` would also behave as you would expect, providing you a new instance each time.\n *\n * @public\n */\n",
2311
2311
  "excerptTokens": [
2312
2312
  {
2313
2313
  "kind": "Content",
@@ -2348,7 +2348,7 @@
2348
2348
  {
2349
2349
  "kind": "Function",
2350
2350
  "canonicalReference": "@lushly-dev/fast-element!newInstanceForScope:function(1)",
2351
- "docComment": "/**\n * A decorator that indicates that a new instance should be injected scoped to the container that requested the instance.\n *\n * @remarks\n *\n * This creates a resolver with an instance strategy pointing to the new instance, effectively making this a singleton, scoped to the container or DOM's subtree.\n *\n * @param key - The dependency key for the new instance.\n *\n * @public\n */\n",
2351
+ "docComment": "/**\n * A decorator that indicates that a new instance should be injected scoped to the\n * container that requested the instance.\n *\n * @remarks\n *\n * This creates a resolver with an instance strategy pointing to the new instance, effectively\n * making this a singleton, scoped to the container or DOM's subtree.\n *\n * @param key - The dependency key for the new instance.\n *\n * @public\n */\n",
2352
2352
  "excerptTokens": [
2353
2353
  {
2354
2354
  "kind": "Content",
@@ -2430,7 +2430,7 @@
2430
2430
  {
2431
2431
  "kind": "Function",
2432
2432
  "canonicalReference": "@lushly-dev/fast-element!optional:function(1)",
2433
- "docComment": "/**\n * A decorator that allows you to optionally inject a dependency depending on whether the [[`Key`]] is present, for example:\n *\n * @param key - The key to optionally resolve. see {@link DI.createContext} on interactions with interfaces\n *\n * @example\n * ```ts\n * class Foo {\n * constructor( @inject('mystring') public str: string = 'somestring' )\n * }\n * container.get(Foo); // throws\n * ```\n *\n * would fail\n *\n * @example\n * ```ts\n * class Foo {\n * constructor( @optional('mystring') public str: string = 'somestring' )\n * }\n * container.get(Foo).str // somestring\n * ```\n *\n * if you use it without a default it will inject `undefined`, so remember to mark your input type as possibly `undefined`!\n *\n * @public\n */\n",
2433
+ "docComment": "/**\n * A decorator that allows you to optionally inject a dependency depending on whether the [[`Key`]] is present, for example:\n *\n * @param key - The key to optionally resolve.\n * see {@link DI.createContext} on interactions with interfaces\n *\n * @example\n * ```ts\n * class Foo {\n * constructor( @inject('mystring') public str: string = 'somestring' )\n * }\n * container.get(Foo); // throws\n * ```\n *\n * would fail\n *\n * @example\n * ```ts\n * class Foo {\n * constructor( @optional('mystring') public str: string = 'somestring' )\n * }\n * container.get(Foo).str // somestring\n * ```\n *\n * if you use it without a default it will inject `undefined`, so remember to mark your input type as\n * possibly `undefined`!\n *\n * @public\n */\n",
2434
2434
  "excerptTokens": [
2435
2435
  {
2436
2436
  "kind": "Content",
@@ -2581,7 +2581,7 @@
2581
2581
  {
2582
2582
  "kind": "Interface",
2583
2583
  "canonicalReference": "@lushly-dev/fast-element!Registration:interface",
2584
- "docComment": "/**\n * Implemented by objects that wish to register dependencies in the container by creating resolvers.\n *\n * @public\n */\n",
2584
+ "docComment": "/**\n * Implemented by objects that wish to register dependencies in the container\n * by creating resolvers.\n *\n * @public\n */\n",
2585
2585
  "excerptTokens": [
2586
2586
  {
2587
2587
  "kind": "Content",
@@ -2671,7 +2671,7 @@
2671
2671
  {
2672
2672
  "kind": "Variable",
2673
2673
  "canonicalReference": "@lushly-dev/fast-element!Registration:var",
2674
- "docComment": "/**\n * You can use the resulting Registration of any of the factory methods to register with the container.\n *\n * @example\n * ```\n * class Foo {}\n * const container = DI.createContainer();\n * container.register(Registration.instance(Foo, new Foo()));\n * container.get(Foo);\n * ```\n *\n * @public\n */\n",
2674
+ "docComment": "/**\n * You can use the resulting Registration of any of the factory methods\n * to register with the container.\n *\n * @example\n * ```\n * class Foo {}\n * const container = DI.createContainer();\n * container.register(Registration.instance(Foo, new Foo()));\n * container.get(Foo);\n * ```\n *\n * @public\n */\n",
2675
2675
  "excerptTokens": [
2676
2676
  {
2677
2677
  "kind": "Content",
@@ -2903,7 +2903,7 @@
2903
2903
  {
2904
2904
  "kind": "MethodSignature",
2905
2905
  "canonicalReference": "@lushly-dev/fast-element!Registry#register:member(1)",
2906
- "docComment": "/**\n * Registers dependencies in the specified container.\n *\n * @remarks\n *\n * If this registry doubles as a Registration, it should return a Resolver for the registered dependency.\n *\n * @param container - The container to register dependencies in.\n *\n * @param params - Parameters that affect the registration process.\n */\n",
2906
+ "docComment": "/**\n * Registers dependencies in the specified container.\n *\n * @remarks\n *\n * If this registry doubles as a Registration, it should return a Resolver\n * for the registered dependency.\n *\n * @param container - The container to register dependencies in.\n *\n * @param params - Parameters that affect the registration process.\n */\n",
2907
2907
  "excerptTokens": [
2908
2908
  {
2909
2909
  "kind": "Content",
@@ -2973,7 +2973,7 @@
2973
2973
  {
2974
2974
  "kind": "TypeAlias",
2975
2975
  "canonicalReference": "@lushly-dev/fast-element!ResolveCallback:type",
2976
- "docComment": "/**\n * Represents a custom callback for resolving a request from the container. The handler is the container that is invoking the callback. The requestor is the original container that made the request. The handler and the requestor may not be the same if the request has bubbled up to a parent container in the DI hierarchy. The resolver is the instance of the resolver that stores the callback. This is provided in case the callback needs a place or key against which to store state across resolutions.\n *\n * @public\n */\n",
2976
+ "docComment": "/**\n * Represents a custom callback for resolving a request from the container.\n * The handler is the container that is invoking the callback. The requestor\n * is the original container that made the request. The handler and the requestor\n * may not be the same if the request has bubbled up to a parent container in the DI hierarchy.\n * The resolver is the instance of the resolver that stores the callback. This is provided in case\n * the callback needs a place or key against which to store state across resolutions.\n *\n * @public\n */\n",
2977
2977
  "excerptTokens": [
2978
2978
  {
2979
2979
  "kind": "Content",
@@ -3140,7 +3140,7 @@
3140
3140
  {
3141
3141
  "kind": "Interface",
3142
3142
  "canonicalReference": "@lushly-dev/fast-element!Resolver:interface",
3143
- "docComment": "/**\n * Internally, the DI system maps \"keys\" to \"resolvers\". A resolver controls how a dependency is resolved. Resolvers for transient, singleton, etc. are provided out of the box, but you can also implement Resolver yourself and supply custom logic for resolution.\n *\n * @public\n */\n",
3143
+ "docComment": "/**\n * Internally, the DI system maps \"keys\" to \"resolvers\". A resolver controls\n * how a dependency is resolved. Resolvers for transient, singleton, etc. are\n * provided out of the box, but you can also implement Resolver yourself and supply\n * custom logic for resolution.\n *\n * @public\n */\n",
3144
3144
  "excerptTokens": [
3145
3145
  {
3146
3146
  "kind": "Content",
@@ -3205,7 +3205,7 @@
3205
3205
  {
3206
3206
  "kind": "Class",
3207
3207
  "canonicalReference": "@lushly-dev/fast-element!ResolverBuilder:class",
3208
- "docComment": "/**\n * A utility class used that constructs and registers resolvers for a dependency injection container. Supports a standard set of object lifetimes.\n *\n * @public\n */\n",
3208
+ "docComment": "/**\n * A utility class used that constructs and registers resolvers for a dependency\n * injection container. Supports a standard set of object lifetimes.\n *\n * @public\n */\n",
3209
3209
  "excerptTokens": [
3210
3210
  {
3211
3211
  "kind": "Content",
@@ -3338,7 +3338,7 @@
3338
3338
  {
3339
3339
  "kind": "Method",
3340
3340
  "canonicalReference": "@lushly-dev/fast-element!ResolverBuilder#cachedCallback:member(1)",
3341
- "docComment": "/**\n * Creates a resolver that invokes a callback function the first time that a dependency resolution is requested. The returned value is then cached and provided for all subsequent requests.\n *\n * @param value - The callback to call during the first resolution.\n *\n * @returns The resolver.\n */\n",
3341
+ "docComment": "/**\n * Creates a resolver that invokes a callback function the first time that a dependency\n * resolution is requested. The returned value is then cached and provided for all\n * subsequent requests.\n *\n * @param value - The callback to call during the first resolution.\n *\n * @returns The resolver.\n */\n",
3342
3342
  "excerptTokens": [
3343
3343
  {
3344
3344
  "kind": "Content",
@@ -3396,7 +3396,7 @@
3396
3396
  {
3397
3397
  "kind": "Method",
3398
3398
  "canonicalReference": "@lushly-dev/fast-element!ResolverBuilder#callback:member(1)",
3399
- "docComment": "/**\n * Creates a resolver that invokes a callback function for every dependency resolution request, allowing custom logic to return the dependency.\n *\n * @param value - The callback to call during resolution.\n *\n * @returns The resolver.\n */\n",
3399
+ "docComment": "/**\n * Creates a resolver that invokes a callback function for every dependency resolution\n * request, allowing custom logic to return the dependency.\n *\n * @param value - The callback to call during resolution.\n *\n * @returns The resolver.\n */\n",
3400
3400
  "excerptTokens": [
3401
3401
  {
3402
3402
  "kind": "Content",
@@ -4137,7 +4137,7 @@
4137
4137
  {
4138
4138
  "kind": "MethodSignature",
4139
4139
  "canonicalReference": "@lushly-dev/fast-element!ServiceLocator#getAsync:member(1)",
4140
- "docComment": "/**\n * Gets a dependency by key, allowing for asynchronously resolved dependencies.\n *\n * @param key - The key to lookup.\n */\n",
4140
+ "docComment": "/**\n * Gets a dependency by key, allowing for asynchronously\n * resolved dependencies.\n *\n * @param key - The key to lookup.\n */\n",
4141
4141
  "excerptTokens": [
4142
4142
  {
4143
4143
  "kind": "Content",
@@ -4218,7 +4218,7 @@
4218
4218
  {
4219
4219
  "kind": "MethodSignature",
4220
4220
  "canonicalReference": "@lushly-dev/fast-element!ServiceLocator#getAsync:member(2)",
4221
- "docComment": "/**\n * Gets a dependency by key, allowing for asynchronously resolved dependencies.\n *\n * @param key - The key to lookup.\n */\n",
4221
+ "docComment": "/**\n * Gets a dependency by key, allowing for asynchronously\n * resolved dependencies.\n *\n * @param key - The key to lookup.\n */\n",
4222
4222
  "excerptTokens": [
4223
4223
  {
4224
4224
  "kind": "Content",
@@ -4300,7 +4300,7 @@
4300
4300
  {
4301
4301
  "kind": "MethodSignature",
4302
4302
  "canonicalReference": "@lushly-dev/fast-element!ServiceLocator#getAsync:member(3)",
4303
- "docComment": "/**\n * Gets a dependency by key, allowing for asynchronously resolved dependencies.\n *\n * @param key - The key to lookup.\n */\n",
4303
+ "docComment": "/**\n * Gets a dependency by key, allowing for asynchronously\n * resolved dependencies.\n *\n * @param key - The key to lookup.\n */\n",
4304
4304
  "excerptTokens": [
4305
4305
  {
4306
4306
  "kind": "Content",
@@ -4386,7 +4386,7 @@
4386
4386
  {
4387
4387
  "kind": "MethodSignature",
4388
4388
  "canonicalReference": "@lushly-dev/fast-element!ServiceLocator#has:member(1)",
4389
- "docComment": "/**\n * Determines whether the locator has the ability to provide an implementation for the requested key.\n *\n * @param key - The dependency key to lookup.\n *\n * @param searchAncestors - Indicates whether to search the entire hierarchy of service locators.\n */\n",
4389
+ "docComment": "/**\n * Determines whether the locator has the ability to provide an implementation\n * for the requested key.\n *\n * @param key - The dependency key to lookup.\n *\n * @param searchAncestors - Indicates whether to search the entire hierarchy of service locators.\n */\n",
4390
4390
  "excerptTokens": [
4391
4391
  {
4392
4392
  "kind": "Content",
@@ -4514,7 +4514,7 @@
4514
4514
  {
4515
4515
  "kind": "Function",
4516
4516
  "canonicalReference": "@lushly-dev/fast-element!singleton:function(1)",
4517
- "docComment": "/**\n * Registers the decorated class as a singleton dependency; the class will only be created once. Each consecutive time the dependency is resolved, the same instance will be returned.\n *\n * @example\n * ```ts\n * @singleton()\n * class Foo { }\n * ```\n *\n * @public\n */\n",
4517
+ "docComment": "/**\n * Registers the decorated class as a singleton dependency; the class will only be created once. Each\n * consecutive time the dependency is resolved, the same instance will be returned.\n *\n * @example\n * ```ts\n * @singleton()\n * class Foo { }\n * ```\n *\n * @public\n */\n",
4518
4518
  "excerptTokens": [
4519
4519
  {
4520
4520
  "kind": "Content",
@@ -4642,7 +4642,7 @@
4642
4642
  {
4643
4643
  "kind": "Function",
4644
4644
  "canonicalReference": "@lushly-dev/fast-element!singleton:function(3)",
4645
- "docComment": "/**\n * Registers the `target` class as a singleton dependency; the class will only be created once. Each consecutive time the dependency is resolved, the same instance will be returned.\n *\n * @param target - The class / constructor function to register as a singleton.\n *\n * @example\n * ```ts\n * @singleton()\n * class Foo { }\n * ```\n *\n * @public\n */\n",
4645
+ "docComment": "/**\n * Registers the `target` class as a singleton dependency; the class will only be created once. Each\n * consecutive time the dependency is resolved, the same instance will be returned.\n *\n * @param target - The class / constructor function to register as a singleton.\n *\n * @example\n * ```ts\n * @singleton()\n * class Foo { }\n * ```\n *\n * @public\n */\n",
4646
4646
  "excerptTokens": [
4647
4647
  {
4648
4648
  "kind": "Content",
@@ -4736,7 +4736,7 @@
4736
4736
  {
4737
4737
  "kind": "TypeAlias",
4738
4738
  "canonicalReference": "@lushly-dev/fast-element!Transformer_2:type",
4739
- "docComment": "/**\n * Transforms an object after it is created but before it is returned to the requestor.\n *\n * @public\n */\n",
4739
+ "docComment": "/**\n * Transforms an object after it is created but before it is returned\n * to the requestor.\n *\n * @public\n */\n",
4740
4740
  "excerptTokens": [
4741
4741
  {
4742
4742
  "kind": "Content",
@@ -4793,7 +4793,7 @@
4793
4793
  {
4794
4794
  "kind": "Function",
4795
4795
  "canonicalReference": "@lushly-dev/fast-element!transient:function(1)",
4796
- "docComment": "/**\n * Registers the decorated class as a transient dependency; each time the dependency is resolved a new instance will be created.\n *\n * @example\n * ```ts\n * @transient()\n * class Foo { }\n * ```\n *\n * @public\n */\n",
4796
+ "docComment": "/**\n * Registers the decorated class as a transient dependency; each time the dependency is resolved\n * a new instance will be created.\n *\n * @example\n * ```ts\n * @transient()\n * class Foo { }\n * ```\n *\n * @public\n */\n",
4797
4797
  "excerptTokens": [
4798
4798
  {
4799
4799
  "kind": "Content",
@@ -4848,7 +4848,7 @@
4848
4848
  {
4849
4849
  "kind": "Function",
4850
4850
  "canonicalReference": "@lushly-dev/fast-element!transient:function(2)",
4851
- "docComment": "/**\n * Registers the `target` class as a transient dependency; each time the dependency is resolved a new instance will be created.\n *\n * @param target - The class / constructor function to register as transient.\n *\n * @example\n * ```ts\n * @transient()\n * class Foo { }\n * ```\n *\n * @public\n */\n",
4851
+ "docComment": "/**\n * Registers the `target` class as a transient dependency; each time the dependency is resolved\n * a new instance will be created.\n *\n * @param target - The class / constructor function to register as transient.\n *\n * @example\n * ```ts\n * @transient()\n * class Foo { }\n * ```\n *\n * @public\n */\n",
4852
4852
  "excerptTokens": [
4853
4853
  {
4854
4854
  "kind": "Content",
@@ -1,4 +1,4 @@
1
1
  export declare const debugMessages: {
2
- 2000: string;
3
- 2001: string;
2
+ [2000]: string;
3
+ [2001]: string;
4
4
  };
@@ -169,6 +169,8 @@ export type ComparisonOperator = (typeof ComparisonOperator)[keyof typeof Compar
169
169
  * @public
170
170
  */
171
171
  export declare const Operator: {
172
+ readonly AND: "&&";
173
+ readonly OR: "||";
172
174
  readonly ACCESS: "access";
173
175
  readonly EQUALS: "==";
174
176
  readonly GREATER_THAN: ">";
@@ -177,8 +179,6 @@ export declare const Operator: {
177
179
  readonly LESS_THAN_OR_EQUALS: "<=";
178
180
  readonly NOT: "!";
179
181
  readonly NOT_EQUALS: "!=";
180
- readonly AND: "&&";
181
- readonly OR: "||";
182
182
  };
183
183
  /**
184
184
  * Declarative expression operator token.
@@ -15,7 +15,7 @@ export declare class HydrationTargetElementError extends Error {
15
15
  * string for structural errors that do not correspond to a single
16
16
  * binding factory.
17
17
  */
18
- readonly expected?: (HydrationMismatchExpectation | string) | undefined;
18
+ readonly expected?: HydrationMismatchExpectation | string | undefined;
19
19
  /**
20
20
  * Structured description of the server-rendered DOM that was
21
21
  * encountered at the mismatch point.
@@ -45,7 +45,7 @@ export declare class HydrationTargetElementError extends Error {
45
45
  * string for structural errors that do not correspond to a single
46
46
  * binding factory.
47
47
  */
48
- expected?: (HydrationMismatchExpectation | string) | undefined,
48
+ expected?: HydrationMismatchExpectation | string | undefined,
49
49
  /**
50
50
  * Structured description of the server-rendered DOM that was
51
51
  * encountered at the mismatch point.
@@ -92,7 +92,7 @@ export declare class HydrationView<TSource = any, TParent = any> extends Default
92
92
  context: ExecutionContext<any>;
93
93
  source: TSource | null;
94
94
  isBound: boolean;
95
- get hydrationStage(): "unhydrated" | "hydrating" | "hydrated";
95
+ get hydrationStage(): "hydrated" | "hydrating" | "unhydrated";
96
96
  get targets(): ViewBehaviorTargets;
97
97
  get bindingViewBoundaries(): ViewBehaviorBoundaries;
98
98
  readonly sourceLifetime: SourceLifetime;
@@ -1,3 +1,4 @@
1
+ import { noop } from "../interfaces.js";
1
2
  import { ExecutionContext } from "../observation/observable.js";
2
3
  import type { ViewBehavior, ViewBehaviorTargets } from "../templating/html-directive.js";
3
4
  export declare const Fake: Readonly<{
@@ -8,7 +9,7 @@ export declare const Fake: Readonly<{
8
9
  onUnbind(object: any): void;
9
10
  source: TSource;
10
11
  targets: ViewBehaviorTargets;
11
- toJSON: () => undefined;
12
+ toJSON: typeof noop;
12
13
  bind(source: TSource, context?: ExecutionContext<TParent>): void;
13
14
  unbind(): void;
14
15
  };
@@ -5,7 +5,7 @@
5
5
  "toolPackages": [
6
6
  {
7
7
  "packageName": "@microsoft/api-extractor",
8
- "packageVersion": "7.58.1"
8
+ "packageVersion": "7.60.1"
9
9
  }
10
10
  ]
11
11
  }
@@ -34,8 +34,7 @@ class TwoWayObserver {
34
34
  bind(controller) {
35
35
  var _a;
36
36
  if (!this.changeEvent) {
37
- this.changeEvent =
38
- (_a = this.dataBinding.options.changeEvent) !== null && _a !== void 0 ? _a : twoWaySettings.determineChangeEvent(this.directive, this.target);
37
+ this.changeEvent = (_a = this.dataBinding.options.changeEvent) !== null && _a !== void 0 ? _a : twoWaySettings.determineChangeEvent(this.directive, this.target);
39
38
  }
40
39
  if (this.isNotBound) {
41
40
  this.target.addEventListener(this.changeEvent, this);
@@ -50,7 +50,8 @@ import { CommandRegistry } from "../registry.js";
50
50
  * @internal
51
51
  */
52
52
  function isEditableTarget(event) {
53
- var _a, _b;
53
+ var _a;
54
+ var _b;
54
55
  // composedPath()[0] sees through shadow roots, where event.target is retargeted
55
56
  const target = ((_b = (_a = event.composedPath) === null || _a === void 0 ? void 0 : _a.call(event)[0]) !== null && _b !== void 0 ? _b : event.target);
56
57
  if (!target || typeof target.tagName !== "string") {
@@ -160,11 +160,12 @@ class CommandRegistryImpl {
160
160
  * @public
161
161
  */
162
162
  unregister(id, expected) {
163
- var _a, _b, _c;
163
+ var _a, _b;
164
+ var _c;
164
165
  if (expected !== void 0 && this.commands.get(id) !== expected) {
165
166
  // A stale removal of a shadowed registration.
166
167
  const stack = this.shadowed.get(id);
167
- const index = (_a = stack === null || stack === void 0 ? void 0 : stack.indexOf(expected)) !== null && _a !== void 0 ? _a : -1;
168
+ const index = (_c = stack === null || stack === void 0 ? void 0 : stack.indexOf(expected)) !== null && _c !== void 0 ? _c : -1;
168
169
  if (stack !== void 0 && index !== -1) {
169
170
  stack.splice(index, 1);
170
171
  if (stack.length === 0)
@@ -172,9 +173,9 @@ class CommandRegistryImpl {
172
173
  }
173
174
  return;
174
175
  }
175
- const fallback = expected !== void 0 ? (_b = this.shadowed.get(id)) === null || _b === void 0 ? void 0 : _b.pop() : void 0;
176
+ const fallback = expected !== void 0 ? (_a = this.shadowed.get(id)) === null || _a === void 0 ? void 0 : _a.pop() : void 0;
176
177
  if (fallback !== void 0) {
177
- if (((_c = this.shadowed.get(id)) === null || _c === void 0 ? void 0 : _c.length) === 0)
178
+ if (((_b = this.shadowed.get(id)) === null || _b === void 0 ? void 0 : _b.length) === 0)
178
179
  this.shadowed.delete(id);
179
180
  this.commands.set(id, fallback);
180
181
  this.notify([id], []);
@@ -249,7 +250,8 @@ class CommandRegistryImpl {
249
250
  * @internal
250
251
  */
251
252
  run(id, args, options) {
252
- var _a, _b;
253
+ var _a;
254
+ var _b;
253
255
  const cmd = this.commands.get(id);
254
256
  if (!cmd) {
255
257
  return Promise.resolve(failure({
@@ -343,7 +345,8 @@ class CommandRegistryImpl {
343
345
  },
344
346
  }))
345
347
  .then(result => {
346
- var _a, _b;
348
+ var _a;
349
+ var _b;
347
350
  this.emitTelemetry("command.executed", {
348
351
  id,
349
352
  duration: ((_b = (_a = globalThis.performance) === null || _a === void 0 ? void 0 : _a.now()) !== null && _b !== void 0 ? _b : Date.now()) - start,
@@ -412,14 +412,11 @@ export function registerValidationCommands() {
412
412
  // Build plan array with fix suggestions
413
413
  const plan = issues
414
414
  .filter(i => i.fix)
415
- .map((issue, idx) => {
416
- var _a;
417
- return ({
418
- step: idx + 1,
419
- action: issue.fix,
420
- confidence: (_a = issue.fixConfidence) !== null && _a !== void 0 ? _a : 0.8,
421
- });
422
- });
415
+ .map((issue, idx) => { var _a; return ({
416
+ step: idx + 1,
417
+ action: issue.fix,
418
+ confidence: (_a = issue.fixConfidence) !== null && _a !== void 0 ? _a : 0.8,
419
+ }); });
423
420
  if (hasErrors) {
424
421
  return failure({
425
422
  code: "LINT_ERRORS",
@@ -72,14 +72,16 @@ export class ElementController {
72
72
  * The context the expression is evaluated against.
73
73
  */
74
74
  get context() {
75
- var _a, _b;
75
+ var _a;
76
+ var _b;
76
77
  return (_b = (_a = this.view) === null || _a === void 0 ? void 0 : _a.context) !== null && _b !== void 0 ? _b : ExecutionContext.default;
77
78
  }
78
79
  /**
79
80
  * Indicates whether the controller is bound.
80
81
  */
81
82
  get isBound() {
82
- var _a, _b;
83
+ var _a;
84
+ var _b;
83
85
  return (_b = (_a = this.view) === null || _a === void 0 ? void 0 : _a.isBound) !== null && _b !== void 0 ? _b : false;
84
86
  }
85
87
  /**
@@ -105,8 +107,7 @@ export class ElementController {
105
107
  }
106
108
  else if (definition.template) {
107
109
  // 3. Default to the static definition.
108
- this._template =
109
- (_a = definition.template) !== null && _a !== void 0 ? _a : null;
110
+ this._template = (_a = definition.template) !== null && _a !== void 0 ? _a : null;
110
111
  }
111
112
  }
112
113
  return this._template;
@@ -53,7 +53,8 @@ export class HydrationTracker {
53
53
  * Registers an element as pending hydration.
54
54
  */
55
55
  add(element) {
56
- var _a, _b;
56
+ var _a;
57
+ var _b;
57
58
  this.completed = false;
58
59
  if (!this.started) {
59
60
  this.started = true;
@@ -65,7 +65,8 @@ export class AttributeMap {
65
65
  this.config = config;
66
66
  }
67
67
  defineProperties() {
68
- var _a, _b;
68
+ var _a;
69
+ var _b;
69
70
  const propertyNames = this.schema.getRootProperties();
70
71
  const existingAccessorNames = new Set(Observable.getAccessors(this.classPrototype).map(a => a.name));
71
72
  const strategy = (_b = (_a = this.config) === null || _a === void 0 ? void 0 : _a["attribute-name-strategy"]) !== null && _b !== void 0 ? _b : "camelCase";
package/dist/esm/di/di.js CHANGED
@@ -800,7 +800,8 @@ export class ResolverImpl {
800
800
  }
801
801
  }
802
802
  getFactory(container) {
803
- var _a, _b, _c;
803
+ var _a, _b;
804
+ var _c;
804
805
  switch (this.strategy) {
805
806
  case ResolverStrategy.singleton:
806
807
  case ResolverStrategy.transient:
@@ -34,19 +34,13 @@ export const Metadata = Object.freeze({
34
34
  * @param Type - The type to get the metadata for.
35
35
  * @returns The metadata array or a frozen empty array if no metadata is found.
36
36
  */
37
- getDesignParamTypes: (Type) => {
38
- var _a;
39
- return ((_a = Reflect.getOwnMetadata(designParamTypesKey, Type)) !== null && _a !== void 0 ? _a : emptyArray);
40
- },
37
+ getDesignParamTypes: (Type) => { var _a; return ((_a = Reflect.getOwnMetadata(designParamTypesKey, Type)) !== null && _a !== void 0 ? _a : emptyArray); },
41
38
  /**
42
39
  * Gets the "annotation:paramtypes" metadata for the specified type.
43
40
  * @param Type - The type to get the metadata for.
44
41
  * @returns The metadata array or a frozen empty array if no metadata is found.
45
42
  */
46
- getAnnotationParamTypes: (Type) => {
47
- var _a;
48
- return ((_a = Reflect.getOwnMetadata(annotationParamTypesKey, Type)) !== null && _a !== void 0 ? _a : emptyArray);
49
- },
43
+ getAnnotationParamTypes: (Type) => { var _a; return ((_a = Reflect.getOwnMetadata(annotationParamTypesKey, Type)) !== null && _a !== void 0 ? _a : emptyArray); },
50
44
  /**
51
45
  * Gets the "annotation:paramtypes" metadata for the specified type. If none is found,
52
46
  * an empty, mutable metadata array is created and added.
@@ -138,12 +138,10 @@ export class PropertyChangeNotifier {
138
138
  var _a, _b;
139
139
  let subscribers;
140
140
  if (propertyToWatch) {
141
- subscribers =
142
- (_a = this.subscribers[propertyToWatch]) !== null && _a !== void 0 ? _a : (this.subscribers[propertyToWatch] = new SubscriberSet(this.subject));
141
+ subscribers = (_a = this.subscribers[propertyToWatch]) !== null && _a !== void 0 ? _a : (this.subscribers[propertyToWatch] = new SubscriberSet(this.subject));
143
142
  }
144
143
  else {
145
- subscribers =
146
- (_b = this.subjectSubscribers) !== null && _b !== void 0 ? _b : (this.subjectSubscribers = new SubscriberSet(this.subject));
144
+ subscribers = (_b = this.subjectSubscribers) !== null && _b !== void 0 ? _b : (this.subjectSubscribers = new SubscriberSet(this.subject));
147
145
  }
148
146
  subscribers.subscribe(subscriber);
149
147
  }