@decaf-ts/decoration 0.0.6 → 0.0.8

package/lib/decoration/Decoration.d.ts

@@ -1,6 +1,6 @@
 import { DecorationBuilderBuild, DecorationBuilderEnd, DecorationBuilderMid, DecorationBuilderStart, FlavourResolver, IDecorationBuilder } from "./types";
 /**
- * @description Union type covering supported decorator kinds
+ * @description Union type covering supported decorator kinds.
  * @summary Represents any of the standard TypeScript decorator signatures (class, property, or method), enabling flexible registration and application within the Decoration system.
  * @template T
  * @typeDef DecoratorTypes
@@ -8,7 +8,7 @@ import { DecorationBuilderBuild, DecorationBuilderEnd, DecorationBuilderMid, Dec
  */
 export type DecoratorTypes = ClassDecorator | PropertyDecorator | MethodDecorator;
 /**
- * @description Type definition for a decorator factory function
+ * @description Type definition for a decorator factory function.
  * @summary Represents a function that accepts arbitrary arguments and returns a concrete decorator function to be applied to a target.
  * @template A
  * @typeDef DecoratorFactory
@@ -16,11 +16,11 @@ export type DecoratorTypes = ClassDecorator | PropertyDecorator | MethodDecorato
  */
 export type DecoratorFactory = (...args: any[]) => DecoratorTypes;
 /**
- * @description Argument bundle for a decorator factory
+ * @description Argument bundle for a decorator factory.
  * @summary Object form used to defer decorator creation, carrying both the factory function and its argument list to be invoked later during application.
  * @typeDef DecoratorFactoryArgs
- * @property {DecoratorFactory} decorator The factory function that produces a decorator when invoked
- * @property {any[]} args list of arguments to pass to the decorator factory
+ * @property {DecoratorFactory} decorator Factory function that produces a decorator when invoked.
+ * @property {any[]} args List of arguments to pass to the decorator factory.
  * @memberOf module:decoration
  */
 export type DecoratorFactoryArgs = {
@@ -28,20 +28,17 @@ export type DecoratorFactoryArgs = {
     args: any[];
 };
 /**
- * @description Union that represents either a ready-to-apply decorator or a factory with arguments
+ * @description Union that represents either a ready-to-apply decorator or a factory with arguments.
  * @summary Allows registering decorators in two forms: as direct decorator functions or as deferred factories paired with their argument lists for later instantiation.
  * @typeDef DecoratorData
  * @memberOf module:decoration
  */
 export type DecoratorData = DecoratorTypes | DecoratorFactoryArgs;
 /**
- * @description A decorator management class that handles flavoured decorators
- * @summary The Decoration class provides a builder pattern for creating and managing decorators with different flavours.
- * It supports registering, extending, and applying decorators with context-aware flavour resolution.
- * The class implements a fluent interface for defining, extending, and applying decorators with different flavours,
- * allowing for framework-specific decorator implementations while maintaining a consistent API.
- * @template T Type of the decorator (ClassDecorator | PropertyDecorator | MethodDecorator)
- * @param {string} [flavour] Optional flavour parameter for the decorator context
+ * @description A decorator management class that handles flavoured decorators.
+ * @summary The Decoration class provides a builder pattern for creating and managing decorators with different flavours. It supports registering, extending, and applying decorators with context-aware flavour resolution, allowing framework-specific implementations while maintaining a consistent API.
+ * @template T Type of the decorator (ClassDecorator | PropertyDecorator | MethodDecorator).
+ * @param {string} [flavour=DefaultFlavour] Optional flavour parameter for the decorator context.
  * @class
  * @example
  * ```typescript
@@ -79,64 +76,63 @@ export type DecoratorData = DecoratorTypes | DecoratorFactoryArgs;
 export declare class Decoration implements IDecorationBuilder {
     private flavour;
     /**
-     * @description Static map of registered decorators
-     * @summary Stores all registered decorators organized by key and flavour
+     * @description Static map of registered decorators.
+     * @summary Stores all registered decorators organised by key and flavour.
      */
     private static decorators;
     /**
-     * @description Function to resolve flavour from a target
-     * @summary Resolver function that determines the appropriate flavour for a given target
+     * @description Function to resolve flavour from a target.
+     * @summary Resolver function that determines the appropriate flavour for a given target.
      */
     private static flavourResolver;
     /**
-     * @description Set of decorators for the current context
+     * @description Set of decorators for the current context.
      */
     private decorators?;
     /**
-     * @description Set of additional decorators
+     * @description Set of additional decorators.
      */
     private extras?;
     /**
-     * @description Current decorator key
+     * @description Current decorator key.
      */
     private key?;
     constructor(flavour?: string);
     /**
-     * @description Sets the key for the decoration builder
-     * @summary Initializes a new decoration chain with the specified key
-     * @param {string} key The identifier for the decorator
-     * @return {DecorationBuilderMid} Builder instance for method chaining
+     * @description Sets the key for the decoration builder.
+     * @summary Initialises a new decoration chain with the specified key.
+     * @param {string} key Identifier for the decorator.
+     * @return {DecorationBuilderMid} Builder instance for method chaining.
      */
     for(key: string): DecorationBuilderMid;
     /**
-     * @description Adds decorators to the current context
-     * @summary Internal method to add decorators with addon support
-     * @param {boolean} [addon=false] Whether the decorators are addons
-     * @param decorators Array of decorators
-     * @return {this} Current instance for chaining
+     * @description Adds decorators to the current context.
+     * @summary Internal method to add decorators with addon support.
+     * @param {boolean} [addon=false] Indicates whether the decorators are additive extras.
+     * @param {...DecoratorData} decorators Decorators to register for the configured key.
+     * @return {this} Current instance for chaining.
      */
     private decorate;
     /**
-     * @description Defines the base decorators
-     * @summary Sets the primary decorators for the current context
-     * @param decorators Decorators to define
-     * @return Builder instance for finishing the chain
+     * @description Defines the base decorators.
+     * @summary Sets the primary decorators for the current context.
+     * @param {...DecoratorData} decorators Decorators to define.
+     * @return {DecorationBuilderEnd} Builder instance for finishing the chain (also implements DecorationBuilderBuild).
      */
     define(...decorators: DecoratorData[]): DecorationBuilderEnd & DecorationBuilderBuild;
     /**
-     * @description Extends existing decorators
-     * @summary Adds additional decorators to the current context
-     * @param decorators Additional decorators
-     * @return {DecorationBuilderBuild} Builder instance for building the decorator
+     * @description Extends existing decorators.
+     * @summary Adds additional decorators to the current context.
+     * @param {...DecoratorData} decorators Additional decorators to register as addons.
+     * @return {DecorationBuilderBuild} Builder instance for building the decorator.
      */
     extend(...decorators: DecoratorData[]): DecorationBuilderBuild;
     /**
-     * @description Factory that creates a context-aware decorator for a key/flavour
-     * @summary Produces a decorator function bound to the provided key and flavour. The resulting decorator resolves the actual
-     * decorators to apply at invocation time based on the target's resolved flavour and the registered base and extra decorators.
-     * @param {string} key The decoration key used to look up registered decorators
-     * @param {string} [f=DefaultFlavour] Optional explicit flavour to bind the factory to
-     * @return {function(object, any, TypedPropertyDescriptor<any>): any} A decorator function that applies the resolved decorators
+     * @description Factory that creates a context-aware decorator for a key/flavour.
+     * @summary Produces a decorator function bound to the provided key and flavour. The resulting decorator resolves the actual decorators to apply at invocation time based on the target's resolved flavour and the registered base and extra decorators.
+     * @param {string} key Decoration key used to look up registered decorators.
+     * @param {string} [f=DefaultFlavour] Explicit flavour to bind the factory to.
+     * @return {ClassDecorator|MethodDecorator|PropertyDecorator|ParameterDecorator} Decorator function that applies the resolved decorators.
      * @mermaid
      * sequenceDiagram
      *   participant U as User Code
@@ -159,38 +155,40 @@ export declare class Decoration implements IDecorationBuilder {
         descriptor: TypedPropertyDescriptor<any> | undefined;
     };
     /**
-     * @description Creates the final decorator function
-     * @summary Builds and returns the decorator factory function
-     * @return {function(any, any?, TypedPropertyDescriptor?): any} The generated decorator function
+     * @description Creates the final decorator function.
+     * @summary Builds and returns the decorator factory function.
+     * @return {ClassDecorator|MethodDecorator|PropertyDecorator|ParameterDecorator} Generated decorator function ready for application.
      */
     apply(): (target: any, propertyKey?: any, descriptor?: TypedPropertyDescriptor<any>) => any;
     /**
-     * @description Registers decorators for a specific key and flavour
-     * @summary Internal method to store decorators in the static registry
-     * @param {string} key Decorator key
-     * @param {string} flavour Decorator flavour
-     * @param [decorators] Primary decorators
-     * @param [extras] Additional decorators
+     * @description Registers decorators for a specific key and flavour.
+     * @summary Internal method to store decorators in the static registry.
+     * @param {string} key Decorator key.
+     * @param {string} flavour Decorator flavour.
+     * @param {Set<DecoratorData>} [decorators] Primary decorators registered for the key.
+     * @param {Set<DecoratorData>} [extras] Additional decorators registered as flavour-specific addons.
+     * @return {void}
      */
     private static register;
     /**
-     * @description Sets the global flavour resolver
-     * @summary Configures the function used to determine decorator flavours
-     * @param {FlavourResolver} resolver Function to resolve flavours
+     * @description Sets the global flavour resolver.
+     * @summary Configures the function used to determine decorator flavours.
+     * @param {FlavourResolver} resolver Function to resolve flavours.
+     * @return {void}
      */
     static setFlavourResolver(resolver: FlavourResolver): void;
     /**
-     * @description Convenience static entry to start a decoration builder
+     * @description Convenience static entry to start a decoration builder.
      * @summary Creates a new Decoration instance and initiates the builder chain with the provided key.
-     * @param {string} key The decoration key to configure
-     * @return {DecorationBuilderMid} A builder instance for chaining definitions
+     * @param {string} key Decoration key to configure.
+     * @return {DecorationBuilderMid} Builder instance for chaining definitions.
      */
     static for(key: string): DecorationBuilderMid;
     /**
-     * @description Starts a builder for a specific flavour
+     * @description Starts a builder for a specific flavour.
      * @summary Convenience method to begin a Decoration builder chain bound to the given flavour identifier, allowing registration of flavour-specific decorators.
-     * @param {string} flavour The flavour name to bind to the builder
-     * @return {DecorationBuilderStart} A builder start interface to continue configuration
+     * @param {string} flavour Flavour name to bind to the builder.
+     * @return {DecorationBuilderStart} Builder start interface to continue configuration.
      */
     static flavouredAs(flavour: string): DecorationBuilderStart;
 }

package/lib/decoration/index.cjs

@@ -1,4 +1,8 @@
 "use strict";
+/**
+ * @description Public exports for the decoration builder subsystem
+ * @summary Re-exports the fluent builder class along with its companion types so consumers can import from a single entry point.
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -16,4 +20,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Decoration.cjs"), exports);
 __exportStar(require("./types.cjs"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZGVjb3JhdGlvbi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsbURBQTZCO0FBQzdCLDhDQUF3QiIsInNvdXJjZXNDb250ZW50IjpbImV4cG9ydCAqIGZyb20gXCIuL0RlY29yYXRpb25cIjtcbmV4cG9ydCAqIGZyb20gXCIuL3R5cGVzXCI7XG4iXX0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZGVjb3JhdGlvbi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7OztHQUdHOzs7Ozs7Ozs7Ozs7Ozs7O0FBRUgsbURBQTZCO0FBQzdCLDhDQUF3QiIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQGRlc2NyaXB0aW9uIFB1YmxpYyBleHBvcnRzIGZvciB0aGUgZGVjb3JhdGlvbiBidWlsZGVyIHN1YnN5c3RlbVxuICogQHN1bW1hcnkgUmUtZXhwb3J0cyB0aGUgZmx1ZW50IGJ1aWxkZXIgY2xhc3MgYWxvbmcgd2l0aCBpdHMgY29tcGFuaW9uIHR5cGVzIHNvIGNvbnN1bWVycyBjYW4gaW1wb3J0IGZyb20gYSBzaW5nbGUgZW50cnkgcG9pbnQuXG4gKi9cblxuZXhwb3J0ICogZnJvbSBcIi4vRGVjb3JhdGlvblwiO1xuZXhwb3J0ICogZnJvbSBcIi4vdHlwZXNcIjtcbiJdfQ==

package/lib/decoration/index.d.ts

@@ -1,2 +1,6 @@
+/**
+ * @description Public exports for the decoration builder subsystem
+ * @summary Re-exports the fluent builder class along with its companion types so consumers can import from a single entry point.
+ */
 export * from "./Decoration";
 export * from "./types";

package/lib/decoration/types.cjs

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZGVjb3JhdGlvbi90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgRGVjb3JhdG9yRGF0YSB9IGZyb20gXCIuL0RlY29yYXRpb25cIjtcblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gSW50ZXJmYWNlIGZvciB0aGUgZmluYWwgc3RhZ2Ugb2YgdGhlIGRlY29yYXRpb24gYnVpbGRlciBwYXR0ZXJuXG4gKiBAc3VtbWFyeSBSZXByZXNlbnRzIHRoZSBidWlsZCBzdGFnZSBvZiB0aGUgZGVjb3JhdGlvbiBidWlsZGVyLCBwcm92aWRpbmcgdGhlIGFiaWxpdHkgdG8gYXBwbHlcbiAqIHRoZSBjb25maWd1cmVkIGRlY29yYXRvciB0byBhIHRhcmdldC4gVGhpcyBpcyB0aGUgZmluYWwgc3RhZ2UgaW4gdGhlIGJ1aWxkZXIgY2hhaW4uXG4gKlxuICogQGludGVyZmFjZSBEZWNvcmF0aW9uQnVpbGRlckJ1aWxkXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRGVjb3JhdGlvbkJ1aWxkZXJCdWlsZCB7XG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gQ3JlYXRlcyBhbmQgcmV0dXJucyB0aGUgZGVjb3JhdG9yIGZ1bmN0aW9uXG4gICAqIEBzdW1tYXJ5IEZpbmFsaXplcyB0aGUgYnVpbGRlciBwcm9jZXNzIGFuZCByZXR1cm5zIGEgZGVjb3JhdG9yIGZ1bmN0aW9uIHRoYXQgY2FuIGJlIGFwcGxpZWQgdG8gYSBjbGFzcyxcbiAgICogcHJvcGVydHksIG9yIG1ldGhvZC5cbiAgICpcbiAgICogQHJldHVybnMge2Z1bmN0aW9ufSBBIGRlY29yYXRvciBmdW5jdGlvbiB0aGF0IGNhbiBiZSBhcHBsaWVkIHRvIGEgdGFyZ2V0XG4gICAqL1xuICBhcHBseSgpOiAoXG4gICAgdGFyZ2V0OiBhbnksXG4gICAgcHJvcGVydHlLZXk/OiBhbnksXG4gICAgZGVzY3JpcHRvcj86IFR5cGVkUHJvcGVydHlEZXNjcmlwdG9yPGFueT5cbiAgKSA9PiBhbnk7XG59XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIEludGVyZmFjZSBmb3IgdGhlIGV4dGVuc2lvbiBzdGFnZSBvZiB0aGUgZGVjb3JhdGlvbiBidWlsZGVyIHBhdHRlcm5cbiAqIEBzdW1tYXJ5IFJlcHJlc2VudHMgdGhlIGV4dGVuc2lvbiBzdGFnZSBvZiB0aGUgZGVjb3JhdGlvbiBidWlsZGVyLCBwcm92aWRpbmcgdGhlIGFiaWxpdHkgdG8gYWRkXG4gKiBhZGRpdGlvbmFsIGRlY29yYXRvcnMgdG8gdGhlIGV4aXN0aW5nIGNvbmZpZ3VyYXRpb24uXG4gKlxuICogQGludGVyZmFjZSBEZWNvcmF0aW9uQnVpbGRlckVuZFxuICogQG1lbWJlck9mIG1vZHVsZTpkZWNvcmF0aW9uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRGVjb3JhdGlvbkJ1aWxkZXJFbmQge1xuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIEFkZHMgYWRkaXRpb25hbCBkZWNvcmF0b3JzIHRvIHRoZSBleGlzdGluZyBjb25maWd1cmF0aW9uXG4gICAqIEBzdW1tYXJ5IEV4dGVuZHMgdGhlIGN1cnJlbnQgZGVjb3JhdG9yIGNvbmZpZ3VyYXRpb24gd2l0aCBhZGRpdGlvbmFsIGRlY29yYXRvcnMuXG4gICAqIFRoaXMgaXMgdXNlZnVsIGZvciBhZGRpbmcgYmVoYXZpb3IgdG8gZXhpc3RpbmcgZGVjb3JhdG9ycy5cbiAgICpcbiAgICogQHBhcmFtIHsuLi4oQ2xhc3NEZWNvcmF0b3J8UHJvcGVydHlEZWNvcmF0b3J8TWV0aG9kRGVjb3JhdG9yKX0gZGVjb3JhdG9ycyAtIEFkZGl0aW9uYWwgZGVjb3JhdG9ycyB0byBhZGRcbiAgICogQHJldHVybnMge0RlY29yYXRpb25CdWlsZGVyQnVpbGR9IFRoZSBidWlsZCBzdGFnZSBvZiB0aGUgYnVpbGRlciBwYXR0ZXJuXG4gICAqL1xuICBleHRlbmQoLi4uZGVjb3JhdG9yczogRGVjb3JhdG9yRGF0YVtdKTogRGVjb3JhdGlvbkJ1aWxkZXJCdWlsZDtcbn1cblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gSW50ZXJmYWNlIGZvciB0aGUgbWlkZGxlIHN0YWdlIG9mIHRoZSBkZWNvcmF0aW9uIGJ1aWxkZXIgcGF0dGVyblxuICogQHN1bW1hcnkgUmVwcmVzZW50cyB0aGUgbWlkZGxlIHN0YWdlIG9mIHRoZSBkZWNvcmF0aW9uIGJ1aWxkZXIsIGV4dGVuZGluZyB0aGUgZW5kIHN0YWdlXG4gKiBhbmQgcHJvdmlkaW5nIHRoZSBhYmlsaXR5IHRvIGRlZmluZSB0aGUgcHJpbWFyeSBkZWNvcmF0b3JzIGZvciB0aGUgY29uZmlndXJhdGlvbi5cbiAqXG4gKiBAaW50ZXJmYWNlIERlY29yYXRpb25CdWlsZGVyTWlkXG4gKiBAbWVtYmVyT2YgbW9kdWxlOmRlY29yYXRpb25cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBEZWNvcmF0aW9uQnVpbGRlck1pZCBleHRlbmRzIERlY29yYXRpb25CdWlsZGVyRW5kIHtcbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBEZWZpbmVzIHRoZSBwcmltYXJ5IGRlY29yYXRvcnMgZm9yIHRoZSBjb25maWd1cmF0aW9uXG4gICAqIEBzdW1tYXJ5IFNldHMgdGhlIG1haW4gZGVjb3JhdG9ycyBmb3IgdGhlIGN1cnJlbnQgY29udGV4dC4gVGhpcyBpcyB0eXBpY2FsbHlcbiAgICogY2FsbGVkIGFmdGVyIHNwZWNpZnlpbmcgdGhlIGtleSB3aXRoIHRoZSAnZm9yJyBtZXRob2QuXG4gICAqL1xuICBkZWZpbmUoXG4gICAgLi4uZGVjb3JhdG9yczogRGVjb3JhdG9yRGF0YVtdXG4gICk6IERlY29yYXRpb25CdWlsZGVyRW5kICYgRGVjb3JhdGlvbkJ1aWxkZXJCdWlsZDtcbn1cblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gSW50ZXJmYWNlIGZvciB0aGUgc3RhcnRpbmcgc3RhZ2Ugb2YgdGhlIGRlY29yYXRpb24gYnVpbGRlciBwYXR0ZXJuXG4gKiBAc3VtbWFyeSBSZXByZXNlbnRzIHRoZSBpbml0aWFsIHN0YWdlIG9mIHRoZSBkZWNvcmF0aW9uIGJ1aWxkZXIsIHByb3ZpZGluZyB0aGUgZW50cnkgcG9pbnRcbiAqIGZvciB0aGUgYnVpbGRlciBwYXR0ZXJuIGJ5IHNwZWNpZnlpbmcgdGhlIGtleSBmb3IgdGhlIGRlY29yYXRvci5cbiAqXG4gKiBAaW50ZXJmYWNlIERlY29yYXRpb25CdWlsZGVyU3RhcnRcbiAqIEBtZW1iZXJPZiBtb2R1bGU6ZGVjb3JhdGlvblxuICovXG5leHBvcnQgaW50ZXJmYWNlIERlY29yYXRpb25CdWlsZGVyU3RhcnQge1xuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIFNwZWNpZmllcyB0aGUga2V5IGZvciB0aGUgZGVjb3JhdG9yXG4gICAqIEBzdW1tYXJ5IFNldHMgdGhlIGlkZW50aWZpZXIgZm9yIHRoZSBkZWNvcmF0b3IsIHdoaWNoIGlzIHVzZWQgdG8gcmVnaXN0ZXIgYW5kIHJldHJpZXZlXG4gICAqIHRoZSBkZWNvcmF0b3IgaW4gdGhlIGRlY29yYXRpb24gcmVnaXN0cnkuXG4gICAqXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBpZCAtIFRoZSBpZGVudGlmaWVyIGZvciB0aGUgZGVjb3JhdG9yXG4gICAqIEByZXR1cm4ge0RlY29yYXRpb25CdWlsZGVyTWlkfSBUaGUgbWlkZGxlIHN0YWdlIG9mIHRoZSBidWlsZGVyIHBhdHRlcm5cbiAgICovXG4gIGZvcihpZDogc3RyaW5nKTogRGVjb3JhdGlvbkJ1aWxkZXJNaWQ7XG59XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIENvbXByZWhlbnNpdmUgaW50ZXJmYWNlIGZvciB0aGUgY29tcGxldGUgZGVjb3JhdGlvbiBidWlsZGVyIHBhdHRlcm5cbiAqIEBzdW1tYXJ5IEEgdW5pZmllZCBpbnRlcmZhY2UgdGhhdCBjb21iaW5lcyBhbGwgc3RhZ2VzIG9mIHRoZSBkZWNvcmF0aW9uIGJ1aWxkZXIgcGF0dGVybixcbiAqIHByb3ZpZGluZyBhIGNvbXBsZXRlIEFQSSBmb3IgY3JlYXRpbmcsIGNvbmZpZ3VyaW5nLCBhbmQgYXBwbHlpbmcgZGVjb3JhdG9ycy5cbiAqIFRoaXMgaW50ZXJmYWNlIGlzIGltcGxlbWVudGVkIGJ5IHRoZSBEZWNvcmF0aW9uIGNsYXNzLlxuICpcbiAqIEBpbnRlcmZhY2UgSURlY29yYXRpb25CdWlsZGVyXG4gKiBAbWVtYmVyT2YgbW9kdWxlOmRlY29yYXRpb25cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBJRGVjb3JhdGlvbkJ1aWxkZXJcbiAgZXh0ZW5kcyBEZWNvcmF0aW9uQnVpbGRlclN0YXJ0LFxuICAgIERlY29yYXRpb25CdWlsZGVyTWlkLFxuICAgIERlY29yYXRpb25CdWlsZGVyRW5kLFxuICAgIERlY29yYXRpb25CdWlsZGVyQnVpbGQge31cblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gVHlwZSBkZWZpbml0aW9uIGZvciBhIGZ1bmN0aW9uIHRoYXQgcmVzb2x2ZXMgdGhlIGZsYXZvdXIgZm9yIGEgdGFyZ2V0XG4gKiBAc3VtbWFyeSBEZWZpbmVzIGEgZnVuY3Rpb24gdHlwZSB0aGF0IGRldGVybWluZXMgdGhlIGFwcHJvcHJpYXRlIGZsYXZvdXIgZm9yIGEgZ2l2ZW4gdGFyZ2V0IG9iamVjdC5cbiAqIFRoaXMgaXMgdXNlZCBieSB0aGUgRGVjb3JhdGlvbiBjbGFzcyB0byByZXNvbHZlIHdoaWNoIGZsYXZvdXIgb2YgZGVjb3JhdG9yIHRvIGFwcGx5IGJhc2VkIG9uIHRoZSB0YXJnZXQuXG4gKlxuICogQHR5cGVkZWYge2Z1bmN0aW9uKG9iamVjdCk6IHN0cmluZ30gRmxhdm91clJlc29sdmVyXG4gKlxuICogQHBhcmFtIHtvYmplY3R9IHRhcmdldCAtIFRoZSB0YXJnZXQgb2JqZWN0IHRvIHJlc29sdmUgdGhlIGZsYXZvdXIgZm9yXG4gKiBAcmV0dXJuIHtzdHJpbmd9IFRoZSByZXNvbHZlZCBmbGF2b3VyIGlkZW50aWZpZXJcbiAqIEBtZW1iZXJPZiBtb2R1bGU6ZGVjb3JhdGlvblxuICovXG5leHBvcnQgdHlwZSBGbGF2b3VyUmVzb2x2ZXIgPSAodGFyZ2V0OiBvYmplY3QpID0+IHN0cmluZztcbiJdfQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZGVjb3JhdGlvbi90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgRGVjb3JhdG9yRGF0YSB9IGZyb20gXCIuL0RlY29yYXRpb25cIjtcblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gSW50ZXJmYWNlIGZvciB0aGUgZmluYWwgc3RhZ2Ugb2YgdGhlIGRlY29yYXRpb24gYnVpbGRlciBwYXR0ZXJuLlxuICogQHN1bW1hcnkgUmVwcmVzZW50cyB0aGUgYnVpbGQgc3RhZ2Ugb2YgdGhlIGRlY29yYXRpb24gYnVpbGRlciwgcHJvdmlkaW5nIHRoZSBhYmlsaXR5IHRvIGFwcGx5IHRoZSBjb25maWd1cmVkIGRlY29yYXRvciB0byBhIHRhcmdldC4gVGhpcyBpcyB0aGUgZmluYWwgc3RhZ2UgaW4gdGhlIGJ1aWxkZXIgY2hhaW4uXG4gKiBAaW50ZXJmYWNlIERlY29yYXRpb25CdWlsZGVyQnVpbGRcbiAqIEBtZW1iZXJPZiBtb2R1bGU6ZGVjb3JhdGlvblxuICovXG5leHBvcnQgaW50ZXJmYWNlIERlY29yYXRpb25CdWlsZGVyQnVpbGQge1xuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIENyZWF0ZXMgYW5kIHJldHVybnMgdGhlIGRlY29yYXRvciBmdW5jdGlvbi5cbiAgICogQHN1bW1hcnkgRmluYWxpc2VzIHRoZSBidWlsZGVyIHByb2Nlc3MgYW5kIHJldHVybnMgYSBkZWNvcmF0b3IgZnVuY3Rpb24gdGhhdCBjYW4gYmUgYXBwbGllZCB0byBhIGNsYXNzLCBwcm9wZXJ0eSwgb3IgbWV0aG9kLlxuICAgKiBAcGFyYW0ge2FueX0gdGFyZ2V0IFRhcmdldCBjb25zdHJ1Y3RvciBvciBwcm90b3R5cGUgcmVjZWl2aW5nIHRoZSBkZWNvcmF0b3IuXG4gICAqIEBwYXJhbSB7YW55fSBbcHJvcGVydHlLZXldIFByb3BlcnR5IGtleSB3aGVuIGRlY29yYXRpbmcgYSBjbGFzcyBtZW1iZXIuXG4gICAqIEBwYXJhbSB7VHlwZWRQcm9wZXJ0eURlc2NyaXB0b3I8YW55Pn0gW2Rlc2NyaXB0b3JdIERlc2NyaXB0b3Igc3VwcGxpZWQgZm9yIG1ldGhvZCBvciBhY2Nlc3NvciBkZWNvcmF0aW9uLlxuICAgKiBAcmV0dXJuIHtDbGFzc0RlY29yYXRvcnxNZXRob2REZWNvcmF0b3J8UHJvcGVydHlEZWNvcmF0b3J8UGFyYW1ldGVyRGVjb3JhdG9yfSBEZWNvcmF0b3IgZnVuY3Rpb24gdGhhdCBjYW4gYmUgYXBwbGllZCB0byBhIHRhcmdldC5cbiAgICovXG4gIGFwcGx5KCk6IChcbiAgICB0YXJnZXQ6IGFueSxcbiAgICBwcm9wZXJ0eUtleT86IGFueSxcbiAgICBkZXNjcmlwdG9yPzogVHlwZWRQcm9wZXJ0eURlc2NyaXB0b3I8YW55PlxuICApID0+IGFueTtcbn1cblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gSW50ZXJmYWNlIGZvciB0aGUgZXh0ZW5zaW9uIHN0YWdlIG9mIHRoZSBkZWNvcmF0aW9uIGJ1aWxkZXIgcGF0dGVybi5cbiAqIEBzdW1tYXJ5IFJlcHJlc2VudHMgdGhlIGV4dGVuc2lvbiBzdGFnZSBvZiB0aGUgZGVjb3JhdGlvbiBidWlsZGVyLCBwcm92aWRpbmcgdGhlIGFiaWxpdHkgdG8gYWRkIGFkZGl0aW9uYWwgZGVjb3JhdG9ycyB0byB0aGUgZXhpc3RpbmcgY29uZmlndXJhdGlvbi5cbiAqIEBpbnRlcmZhY2UgRGVjb3JhdGlvbkJ1aWxkZXJFbmRcbiAqIEBtZW1iZXJPZiBtb2R1bGU6ZGVjb3JhdGlvblxuICovXG5leHBvcnQgaW50ZXJmYWNlIERlY29yYXRpb25CdWlsZGVyRW5kIHtcbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBBZGRzIGFkZGl0aW9uYWwgZGVjb3JhdG9ycyB0byB0aGUgZXhpc3RpbmcgY29uZmlndXJhdGlvbi5cbiAgICogQHN1bW1hcnkgRXh0ZW5kcyB0aGUgY3VycmVudCBkZWNvcmF0b3IgY29uZmlndXJhdGlvbiB3aXRoIGFkZGl0aW9uYWwgZGVjb3JhdG9ycywgbWFraW5nIGl0IHVzZWZ1bCBmb3IgYXVnbWVudGluZyBwcmV2aW91c2x5IGRlZmluZWQgYmVoYXZpb3VyLlxuICAgKiBAcGFyYW0gey4uLkRlY29yYXRvckRhdGF9IGRlY29yYXRvcnMgQWRkaXRpb25hbCBkZWNvcmF0b3JzIHRvIGFkZC5cbiAgICogQHJldHVybiB7RGVjb3JhdGlvbkJ1aWxkZXJCdWlsZH0gVGhlIGJ1aWxkIHN0YWdlIG9mIHRoZSBidWlsZGVyIHBhdHRlcm4uXG4gICAqL1xuICBleHRlbmQoLi4uZGVjb3JhdG9yczogRGVjb3JhdG9yRGF0YVtdKTogRGVjb3JhdGlvbkJ1aWxkZXJCdWlsZDtcbn1cblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gSW50ZXJmYWNlIGZvciB0aGUgbWlkZGxlIHN0YWdlIG9mIHRoZSBkZWNvcmF0aW9uIGJ1aWxkZXIgcGF0dGVybi5cbiAqIEBzdW1tYXJ5IFJlcHJlc2VudHMgdGhlIG1pZGRsZSBzdGFnZSBvZiB0aGUgZGVjb3JhdGlvbiBidWlsZGVyLCBleHRlbmRpbmcgdGhlIGVuZCBzdGFnZSBhbmQgcHJvdmlkaW5nIHRoZSBhYmlsaXR5IHRvIGRlZmluZSB0aGUgcHJpbWFyeSBkZWNvcmF0b3JzIGZvciB0aGUgY29uZmlndXJhdGlvbi5cbiAqIEBpbnRlcmZhY2UgRGVjb3JhdGlvbkJ1aWxkZXJNaWRcbiAqIEBtZW1iZXJPZiBtb2R1bGU6ZGVjb3JhdGlvblxuICovXG5leHBvcnQgaW50ZXJmYWNlIERlY29yYXRpb25CdWlsZGVyTWlkIGV4dGVuZHMgRGVjb3JhdGlvbkJ1aWxkZXJFbmQge1xuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIERlZmluZXMgdGhlIHByaW1hcnkgZGVjb3JhdG9ycyBmb3IgdGhlIGNvbmZpZ3VyYXRpb24uXG4gICAqIEBzdW1tYXJ5IFNldHMgdGhlIG1haW4gZGVjb3JhdG9ycyBmb3IgdGhlIGN1cnJlbnQgY29udGV4dCBhZnRlciBzcGVjaWZ5aW5nIHRoZSBrZXkgd2l0aCB0aGUgYGZvcmAgbWV0aG9kLlxuICAgKiBAcGFyYW0gey4uLkRlY29yYXRvckRhdGF9IGRlY29yYXRvcnMgRGVjb3JhdG9ycyB0byBkZWZpbmUgZm9yIHRoZSBjdXJyZW50IGtleSBhbmQgZmxhdm91ci5cbiAgICogQHJldHVybiB7RGVjb3JhdGlvbkJ1aWxkZXJFbmR9IEludGVyZmFjZSByZXByZXNlbnRpbmcgdGhlIHJlbWFpbmluZyBidWlsZGVyIHN0YWdlcyAoYWxzbyBpbXBsZW1lbnRzIERlY29yYXRpb25CdWlsZGVyQnVpbGQpLlxuICAgKi9cbiAgZGVmaW5lKFxuICAgIC4uLmRlY29yYXRvcnM6IERlY29yYXRvckRhdGFbXVxuICApOiBEZWNvcmF0aW9uQnVpbGRlckVuZCAmIERlY29yYXRpb25CdWlsZGVyQnVpbGQ7XG59XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIEludGVyZmFjZSBmb3IgdGhlIHN0YXJ0aW5nIHN0YWdlIG9mIHRoZSBkZWNvcmF0aW9uIGJ1aWxkZXIgcGF0dGVybi5cbiAqIEBzdW1tYXJ5IFJlcHJlc2VudHMgdGhlIGluaXRpYWwgc3RhZ2Ugb2YgdGhlIGRlY29yYXRpb24gYnVpbGRlciwgcHJvdmlkaW5nIHRoZSBlbnRyeSBwb2ludCBmb3IgdGhlIGJ1aWxkZXIgcGF0dGVybiBieSBzcGVjaWZ5aW5nIHRoZSBrZXkgZm9yIHRoZSBkZWNvcmF0b3IuXG4gKiBAaW50ZXJmYWNlIERlY29yYXRpb25CdWlsZGVyU3RhcnRcbiAqIEBtZW1iZXJPZiBtb2R1bGU6ZGVjb3JhdGlvblxuICovXG5leHBvcnQgaW50ZXJmYWNlIERlY29yYXRpb25CdWlsZGVyU3RhcnQge1xuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIFNwZWNpZmllcyB0aGUga2V5IGZvciB0aGUgZGVjb3JhdG9yLlxuICAgKiBAc3VtbWFyeSBTZXRzIHRoZSBpZGVudGlmaWVyIGZvciB0aGUgZGVjb3JhdG9yLCB3aGljaCBpcyB1c2VkIHRvIHJlZ2lzdGVyIGFuZCByZXRyaWV2ZSB0aGUgZGVjb3JhdG9yIGluIHRoZSBkZWNvcmF0aW9uIHJlZ2lzdHJ5LlxuICAgKiBAcGFyYW0ge3N0cmluZ30gaWQgSWRlbnRpZmllciBmb3IgdGhlIGRlY29yYXRvci5cbiAgICogQHJldHVybiB7RGVjb3JhdGlvbkJ1aWxkZXJNaWR9IFRoZSBtaWRkbGUgc3RhZ2Ugb2YgdGhlIGJ1aWxkZXIgcGF0dGVybi5cbiAgICovXG4gIGZvcihpZDogc3RyaW5nKTogRGVjb3JhdGlvbkJ1aWxkZXJNaWQ7XG59XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIENvbXByZWhlbnNpdmUgaW50ZXJmYWNlIGZvciB0aGUgY29tcGxldGUgZGVjb3JhdGlvbiBidWlsZGVyIHBhdHRlcm4uXG4gKiBAc3VtbWFyeSBVbmlmaWVkIGludGVyZmFjZSB0aGF0IGNvbWJpbmVzIGFsbCBzdGFnZXMgb2YgdGhlIGRlY29yYXRpb24gYnVpbGRlciBwYXR0ZXJuLCBwcm92aWRpbmcgYSBjb21wbGV0ZSBBUEkgZm9yIGNyZWF0aW5nLCBjb25maWd1cmluZywgYW5kIGFwcGx5aW5nIGRlY29yYXRvcnMuIFRoaXMgaW50ZXJmYWNlIGlzIGltcGxlbWVudGVkIGJ5IHRoZSBEZWNvcmF0aW9uIGNsYXNzLlxuICogQGludGVyZmFjZSBJRGVjb3JhdGlvbkJ1aWxkZXJcbiAqIEBtZW1iZXJPZiBtb2R1bGU6ZGVjb3JhdGlvblxuICovXG5leHBvcnQgaW50ZXJmYWNlIElEZWNvcmF0aW9uQnVpbGRlclxuICBleHRlbmRzIERlY29yYXRpb25CdWlsZGVyU3RhcnQsXG4gICAgRGVjb3JhdGlvbkJ1aWxkZXJNaWQsXG4gICAgRGVjb3JhdGlvbkJ1aWxkZXJFbmQsXG4gICAgRGVjb3JhdGlvbkJ1aWxkZXJCdWlsZCB7fVxuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBUeXBlIGRlZmluaXRpb24gZm9yIGEgZnVuY3Rpb24gdGhhdCByZXNvbHZlcyB0aGUgZmxhdm91ciBmb3IgYSB0YXJnZXQuXG4gKiBAc3VtbWFyeSBEZWZpbmVzIGEgZnVuY3Rpb24gdHlwZSB0aGF0IGRldGVybWluZXMgdGhlIGFwcHJvcHJpYXRlIGZsYXZvdXIgZm9yIGEgZ2l2ZW4gdGFyZ2V0IG9iamVjdCwgZW5hYmxpbmcgZmxhdm91ci1hd2FyZSBkZWNvcmF0b3Igc2VsZWN0aW9uLlxuICogQHBhcmFtIHtvYmplY3R9IHRhcmdldCBUYXJnZXQgb2JqZWN0IHRvIHJlc29sdmUgdGhlIGZsYXZvdXIgZm9yLlxuICogQHJldHVybiB7c3RyaW5nfSBSZXNvbHZlZCBmbGF2b3VyIGlkZW50aWZpZXIuXG4gKiBAdHlwZURlZiBGbGF2b3VyUmVzb2x2ZXJcbiAqIEBtZW1iZXJPZiBtb2R1bGU6ZGVjb3JhdGlvblxuICovXG5leHBvcnQgdHlwZSBGbGF2b3VyUmVzb2x2ZXIgPSAodGFyZ2V0OiBvYmplY3QpID0+IHN0cmluZztcbiJdfQ==

package/lib/decoration/types.d.ts

@@ -1,95 +1,80 @@
 import { DecoratorData } from "./Decoration";
 /**
- * @description Interface for the final stage of the decoration builder pattern
- * @summary Represents the build stage of the decoration builder, providing the ability to apply
- * the configured decorator to a target. This is the final stage in the builder chain.
- *
+ * @description Interface for the final stage of the decoration builder pattern.
+ * @summary Represents the build stage of the decoration builder, providing the ability to apply the configured decorator to a target. This is the final stage in the builder chain.
  * @interface DecorationBuilderBuild
+ * @memberOf module:decoration
  */
 export interface DecorationBuilderBuild {
     /**
-     * @description Creates and returns the decorator function
-     * @summary Finalizes the builder process and returns a decorator function that can be applied to a class,
-     * property, or method.
-     *
-     * @returns {function} A decorator function that can be applied to a target
+     * @description Creates and returns the decorator function.
+     * @summary Finalises the builder process and returns a decorator function that can be applied to a class, property, or method.
+     * @param {any} target Target constructor or prototype receiving the decorator.
+     * @param {any} [propertyKey] Property key when decorating a class member.
+     * @param {TypedPropertyDescriptor<any>} [descriptor] Descriptor supplied for method or accessor decoration.
+     * @return {ClassDecorator|MethodDecorator|PropertyDecorator|ParameterDecorator} Decorator function that can be applied to a target.
      */
     apply(): (target: any, propertyKey?: any, descriptor?: TypedPropertyDescriptor<any>) => any;
 }
 /**
- * @description Interface for the extension stage of the decoration builder pattern
- * @summary Represents the extension stage of the decoration builder, providing the ability to add
- * additional decorators to the existing configuration.
- *
+ * @description Interface for the extension stage of the decoration builder pattern.
+ * @summary Represents the extension stage of the decoration builder, providing the ability to add additional decorators to the existing configuration.
  * @interface DecorationBuilderEnd
  * @memberOf module:decoration
  */
 export interface DecorationBuilderEnd {
     /**
-     * @description Adds additional decorators to the existing configuration
-     * @summary Extends the current decorator configuration with additional decorators.
-     * This is useful for adding behavior to existing decorators.
-     *
-     * @param {...(ClassDecorator|PropertyDecorator|MethodDecorator)} decorators - Additional decorators to add
-     * @returns {DecorationBuilderBuild} The build stage of the builder pattern
+     * @description Adds additional decorators to the existing configuration.
+     * @summary Extends the current decorator configuration with additional decorators, making it useful for augmenting previously defined behaviour.
+     * @param {...DecoratorData} decorators Additional decorators to add.
+     * @return {DecorationBuilderBuild} The build stage of the builder pattern.
      */
     extend(...decorators: DecoratorData[]): DecorationBuilderBuild;
 }
 /**
- * @description Interface for the middle stage of the decoration builder pattern
- * @summary Represents the middle stage of the decoration builder, extending the end stage
- * and providing the ability to define the primary decorators for the configuration.
- *
+ * @description Interface for the middle stage of the decoration builder pattern.
+ * @summary Represents the middle stage of the decoration builder, extending the end stage and providing the ability to define the primary decorators for the configuration.
  * @interface DecorationBuilderMid
  * @memberOf module:decoration
  */
 export interface DecorationBuilderMid extends DecorationBuilderEnd {
     /**
-     * @description Defines the primary decorators for the configuration
-     * @summary Sets the main decorators for the current context. This is typically
-     * called after specifying the key with the 'for' method.
+     * @description Defines the primary decorators for the configuration.
+     * @summary Sets the main decorators for the current context after specifying the key with the `for` method.
+     * @param {...DecoratorData} decorators Decorators to define for the current key and flavour.
+     * @return {DecorationBuilderEnd} Interface representing the remaining builder stages (also implements DecorationBuilderBuild).
      */
     define(...decorators: DecoratorData[]): DecorationBuilderEnd & DecorationBuilderBuild;
 }
 /**
- * @description Interface for the starting stage of the decoration builder pattern
- * @summary Represents the initial stage of the decoration builder, providing the entry point
- * for the builder pattern by specifying the key for the decorator.
- *
+ * @description Interface for the starting stage of the decoration builder pattern.
+ * @summary Represents the initial stage of the decoration builder, providing the entry point for the builder pattern by specifying the key for the decorator.
  * @interface DecorationBuilderStart
  * @memberOf module:decoration
  */
 export interface DecorationBuilderStart {
     /**
-     * @description Specifies the key for the decorator
-     * @summary Sets the identifier for the decorator, which is used to register and retrieve
-     * the decorator in the decoration registry.
-     *
-     * @param {string} id - The identifier for the decorator
-     * @return {DecorationBuilderMid} The middle stage of the builder pattern
+     * @description Specifies the key for the decorator.
+     * @summary Sets the identifier for the decorator, which is used to register and retrieve the decorator in the decoration registry.
+     * @param {string} id Identifier for the decorator.
+     * @return {DecorationBuilderMid} The middle stage of the builder pattern.
      */
     for(id: string): DecorationBuilderMid;
 }
 /**
- * @description Comprehensive interface for the complete decoration builder pattern
- * @summary A unified interface that combines all stages of the decoration builder pattern,
- * providing a complete API for creating, configuring, and applying decorators.
- * This interface is implemented by the Decoration class.
- *
+ * @description Comprehensive interface for the complete decoration builder pattern.
+ * @summary Unified interface that combines all stages of the decoration builder pattern, providing a complete API for creating, configuring, and applying decorators. This interface is implemented by the Decoration class.
  * @interface IDecorationBuilder
  * @memberOf module:decoration
  */
 export interface IDecorationBuilder extends DecorationBuilderStart, DecorationBuilderMid, DecorationBuilderEnd, DecorationBuilderBuild {
 }
 /**
- * @description Type definition for a function that resolves the flavour for a target
- * @summary Defines a function type that determines the appropriate flavour for a given target object.
- * This is used by the Decoration class to resolve which flavour of decorator to apply based on the target.
- *
- * @typedef {function(object): string} FlavourResolver
- *
- * @param {object} target - The target object to resolve the flavour for
- * @return {string} The resolved flavour identifier
+ * @description Type definition for a function that resolves the flavour for a target.
+ * @summary Defines a function type that determines the appropriate flavour for a given target object, enabling flavour-aware decorator selection.
+ * @param {object} target Target object to resolve the flavour for.
+ * @return {string} Resolved flavour identifier.
+ * @typeDef FlavourResolver
  * @memberOf module:decoration
  */
 export type FlavourResolver = (target: object) => string;