@mxpicture/gcp-functions-common 2.1.34 → 2.1.36

package/dist/annotation/anno.property.d.ts

@@ -4,16 +4,47 @@ import type { DecoPropertyBase, DecoPropertyRaw } from "../types/types.deco.prop
  * Maps a single raw decorator property into an {@link AnnotationsProperty}.
  *
  * @remarks
- * When the property data references a {@link Decorator} (i.e. it is a nested
- * object), the decorator's annotations are recursively extracted and attached
- * as the `sub` field. The returned object is a deep clone.
+ * - When the property is a nested object, the referenced {@link Decorator}'s
+ *   annotations are recursively extracted and attached as the `sub` field.
+ * - For enum properties, the enum's name is derived via {@link buildEnumName}
+ *   and the latest entries are pulled from the global {@link enumRegistry}.
+ * - The returned object is a deep clone, so mutations don't affect the input.
  *
  * @typeParam T - The specific decorator property data shape.
+ * @param headName - The owning decorator's name; used to build enum names.
  * @param propertyKey - The name of the property being mapped.
  * @param prop - The raw decorator property containing common metadata and typed data.
  * @returns A deep-cloned {@link AnnotationsProperty} enriched with resolved type and sub-annotations.
  */
 export declare const mapAnnotationsProperty: <T extends DecoPropertyBase>(headName: string, propertyKey: string, prop: DecoPropertyRaw<T>) => AnnotationsProperty<T>;
+/**
+ * Comparator for {@link AnnotationsProperty} values that sorts by item order ascending.
+ *
+ * @remarks
+ * Suitable for use with `Array.prototype.sort`. The order value is resolved by
+ * {@link extractPropertyItemOrder}, which understands both plain numeric `order`
+ * and the kind-parameterised `{ item }` variant.
+ *
+ * @typeParam A - The first property type to compare.
+ * @typeParam B - The second property type to compare.
+ * @param a - The first property.
+ * @param b - The second property.
+ * @returns A negative number when `a` sorts before `b`, positive when after, `0` when equal.
+ */
 export declare const compareProperty: <A extends AnnotationsProperty<DecoPropertyBase>, B extends AnnotationsProperty<DecoPropertyBase>>(a: A, b: B) => number;
+/**
+ * Extracts the numeric item-order value from an annotation property.
+ *
+ * @remarks
+ * Handles three shapes for the `common.order` field:
+ * - missing / `undefined` → returns `0`.
+ * - plain `number` → returned directly.
+ * - `{ item, facet }` object → returns `item` when numeric, else `0`.
+ *
+ * @typeParam BASE - The property data shape.
+ * @typeParam PROP - The annotation property type wrapping `BASE`.
+ * @param prop - The annotation property to inspect.
+ * @returns The resolved item-order value.
+ */
 export declare const extractPropertyItemOrder: <BASE extends DecoPropertyBase, PROP extends AnnotationsProperty<BASE>>(prop: PROP) => number;
 //# sourceMappingURL=anno.property.d.ts.map

package/dist/annotation/anno.property.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anno.property.d.ts","sourceRoot":"","sources":["../../src/annotation/anno.property.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAChB,MAAM,iCAAiC,CAAC;AAKzC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,gBAAgB,EAC/D,UAAU,MAAM,EAChB,aAAa,MAAM,EACnB,MAAM,eAAe,CAAC,CAAC,CAAC,KACvB,mBAAmB,CAAC,CAAC,CAqBvB,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,CAAC,SAAS,mBAAmB,CAAC,gBAAgB,CAAC,EAC/C,CAAC,SAAS,mBAAmB,CAAC,gBAAgB,CAAC,EAE/C,GAAG,CAAC,EACJ,GAAG,CAAC,WACwD,CAAC;AAE/D,eAAO,MAAM,wBAAwB,GACnC,IAAI,SAAS,gBAAgB,EAC7B,IAAI,SAAS,mBAAmB,CAAC,IAAI,CAAC,EAEtC,MAAM,IAAI,KACT,MAKF,CAAC"}
+{"version":3,"file":"anno.property.d.ts","sourceRoot":"","sources":["../../src/annotation/anno.property.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAChB,MAAM,iCAAiC,CAAC;AAKzC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,gBAAgB,EAC/D,UAAU,MAAM,EAChB,aAAa,MAAM,EACnB,MAAM,eAAe,CAAC,CAAC,CAAC,KACvB,mBAAmB,CAAC,CAAC,CAqBvB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,GAC1B,CAAC,SAAS,mBAAmB,CAAC,gBAAgB,CAAC,EAC/C,CAAC,SAAS,mBAAmB,CAAC,gBAAgB,CAAC,EAE/C,GAAG,CAAC,EACJ,GAAG,CAAC,WACwD,CAAC;AAE/D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,GACnC,IAAI,SAAS,gBAAgB,EAC7B,IAAI,SAAS,mBAAmB,CAAC,IAAI,CAAC,EAEtC,MAAM,IAAI,KACT,MAKF,CAAC"}

package/dist/annotation/anno.property.js

@@ -7,11 +7,14 @@ const isDecoObjectData = (data) => data.type === DecoPropertyType.object && "dec
  * Maps a single raw decorator property into an {@link AnnotationsProperty}.
  *
  * @remarks
- * When the property data references a {@link Decorator} (i.e. it is a nested
- * object), the decorator's annotations are recursively extracted and attached
- * as the `sub` field. The returned object is a deep clone.
+ * - When the property is a nested object, the referenced {@link Decorator}'s
+ *   annotations are recursively extracted and attached as the `sub` field.
+ * - For enum properties, the enum's name is derived via {@link buildEnumName}
+ *   and the latest entries are pulled from the global {@link enumRegistry}.
+ * - The returned object is a deep clone, so mutations don't affect the input.
  *
  * @typeParam T - The specific decorator property data shape.
+ * @param headName - The owning decorator's name; used to build enum names.
  * @param propertyKey - The name of the property being mapped.
  * @param prop - The raw decorator property containing common metadata and typed data.
  * @returns A deep-cloned {@link AnnotationsProperty} enriched with resolved type and sub-annotations.
@@ -36,7 +39,35 @@ export const mapAnnotationsProperty = (headName, propertyKey, prop) => {
         sub: sub?.extractAnnotations(),
     });
 };
+/**
+ * Comparator for {@link AnnotationsProperty} values that sorts by item order ascending.
+ *
+ * @remarks
+ * Suitable for use with `Array.prototype.sort`. The order value is resolved by
+ * {@link extractPropertyItemOrder}, which understands both plain numeric `order`
+ * and the kind-parameterised `{ item }` variant.
+ *
+ * @typeParam A - The first property type to compare.
+ * @typeParam B - The second property type to compare.
+ * @param a - The first property.
+ * @param b - The second property.
+ * @returns A negative number when `a` sorts before `b`, positive when after, `0` when equal.
+ */
 export const compareProperty = (a, b) => extractPropertyItemOrder(a) - extractPropertyItemOrder(b);
+/**
+ * Extracts the numeric item-order value from an annotation property.
+ *
+ * @remarks
+ * Handles three shapes for the `common.order` field:
+ * - missing / `undefined` → returns `0`.
+ * - plain `number` → returned directly.
+ * - `{ item, facet }` object → returns `item` when numeric, else `0`.
+ *
+ * @typeParam BASE - The property data shape.
+ * @typeParam PROP - The annotation property type wrapping `BASE`.
+ * @param prop - The annotation property to inspect.
+ * @returns The resolved item-order value.
+ */
 export const extractPropertyItemOrder = (prop) => {
     if (prop.common.order === undefined)
         return 0;

package/dist/annotation/anno.property.js.map

@@ -1 +1 @@
-{"version":3,"file":"anno.property.js","sourceRoot":"","sources":["../../src/annotation/anno.property.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE5E,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAOzD,MAAM,gBAAgB,GAAG,CAAC,IAAsB,EAA0B,EAAE,CAC1E,IAAI,CAAC,IAAI,KAAK,gBAAgB,CAAC,MAAM,IAAI,MAAM,IAAI,IAAI,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,QAAgB,EAChB,WAAmB,EACnB,IAAwB,EACA,EAAE;IAC1B,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,MAAM,GAAG,GAAG,OAAO,YAAY,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAE1D,IAAI,YAAY,GAAG,GAAG,EAAE,IAAI,CAAC;IAE7B,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,gBAAgB,CAAC,IAAI,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,YAAY,GAAG,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACjD,IAAI,IAAI,IAAI,GAAG;YAAE,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,YAAY;QAAE,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAEjD,OAAO,eAAe,CAAC;QACrB,GAAG,IAAI;QACP,WAAW;QACX,YAAY;QACZ,GAAG,EAAE,GAAG,EAAE,kBAAkB,EAAE;KAC/B,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAI7B,CAAI,EACJ,CAAI,EACJ,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAItC,IAAU,EACF,EAAE;IACV,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAC9C,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IACpE,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;IAC9E,OAAO,CAAC,CAAC;AACX,CAAC,CAAC"}
+{"version":3,"file":"anno.property.js","sourceRoot":"","sources":["../../src/annotation/anno.property.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE5E,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAOzD,MAAM,gBAAgB,GAAG,CAAC,IAAsB,EAA0B,EAAE,CAC1E,IAAI,CAAC,IAAI,KAAK,gBAAgB,CAAC,MAAM,IAAI,MAAM,IAAI,IAAI,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,QAAgB,EAChB,WAAmB,EACnB,IAAwB,EACA,EAAE;IAC1B,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,MAAM,GAAG,GAAG,OAAO,YAAY,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAE1D,IAAI,YAAY,GAAG,GAAG,EAAE,IAAI,CAAC;IAE7B,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,gBAAgB,CAAC,IAAI,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,YAAY,GAAG,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACjD,IAAI,IAAI,IAAI,GAAG;YAAE,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,YAAY;QAAE,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAEjD,OAAO,eAAe,CAAC;QACrB,GAAG,IAAI;QACP,WAAW;QACX,YAAY;QACZ,GAAG,EAAE,GAAG,EAAE,kBAAkB,EAAE;KAC/B,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAI7B,CAAI,EACJ,CAAI,EACJ,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAC;AAE/D;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAItC,IAAU,EACF,EAAE;IACV,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAC9C,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IACpE,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;IAC9E,OAAO,CAAC,CAAC;AACX,CAAC,CAAC"}

package/dist/decorator/DecoDate.d.ts

@@ -8,7 +8,9 @@ import { DecoProperty } from "./DecoProperty.js";
 export interface DecoDateData extends DecoPropertyBase {
     /** The date format to use for serialization. */
     dateFormat: DecoDateFormat;
+    /** Initial date strategy (e.g. `now`, `today`, `date1970`); `null` when no default applies. */
     dateType: DecoDateType | null;
+    /** Day offset added to the initial date computed from {@link DecoDateData.dateType}. */
     dateOffsetDays: number;
 }
 /**
@@ -27,9 +29,10 @@ export declare class DecoDate extends DecoProperty<DecoDateData> {
     /** Creates a new date property builder defaulting to timestamp format. */
     constructor();
     /**
-     * Sets the default date value.
+     * Sets the default date strategy and optional day offset.
      *
-     * @param val - The default value.
+     * @param type - The initial-date strategy (e.g. `now`, `today`, `date1970`).
+     * @param offsetDays - Number of days to add to the computed initial date. Defaults to `0`.
      * @returns This instance for chaining.
      */
     default(type: DecoDateType, offsetDays?: number): this;

package/dist/decorator/DecoDate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DecoDate.d.ts","sourceRoot":"","sources":["../../src/decorator/DecoDate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAoB,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,gDAAgD;IAChD,UAAU,EAAE,cAAc,CAAC;IAC3B,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,gBAAuB,CAAC;AAE7C;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,YAAY,CAAC,YAAY,CAAC;IACtD,0EAA0E;;IAU1E;;;;;OAKG;IACI,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,GAAE,MAAU,GAAG,IAAI;IAMhE;;;;;OAKG;IACI,MAAM,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;CAIhD"}
+{"version":3,"file":"DecoDate.d.ts","sourceRoot":"","sources":["../../src/decorator/DecoDate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAoB,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,gDAAgD;IAChD,UAAU,EAAE,cAAc,CAAC;IAC3B,+FAA+F;IAC/F,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,wFAAwF;IACxF,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,gBAAuB,CAAC;AAE7C;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,YAAY,CAAC,YAAY,CAAC;IACtD,0EAA0E;;IAU1E;;;;;;OAMG;IACI,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,GAAE,MAAU,GAAG,IAAI;IAMhE;;;;;OAKG;IACI,MAAM,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;CAIhD"}

package/dist/decorator/DecoDate.js

@@ -23,9 +23,10 @@ export class DecoDate extends DecoProperty {
         });
     }
     /**
-     * Sets the default date value.
+     * Sets the default date strategy and optional day offset.
      *
-     * @param val - The default value.
+     * @param type - The initial-date strategy (e.g. `now`, `today`, `date1970`).
+     * @param offsetDays - Number of days to add to the computed initial date. Defaults to `0`.
      * @returns This instance for chaining.
      */
     default(type, offsetDays = 0) {

package/dist/decorator/DecoDate.js.map

@@ -1 +1 @@
-{"version":3,"file":"DecoDate.js","sourceRoot":"","sources":["../../src/decorator/DecoDate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAYjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,YAA0B;IACtD,0EAA0E;IAC1E;QACE,KAAK,CAAC;YACJ,IAAI,EAAE,gBAAgB,CAAC,IAAI;YAC3B,UAAU,EAAE,cAAc,CAAC,SAAS;YACpC,QAAQ,EAAE,IAAI;YACd,cAAc,EAAE,CAAC;SAClB,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,OAAO,CAAC,IAAkB,EAAE,aAAqB,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,UAA0B;QACtC,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"DecoDate.js","sourceRoot":"","sources":["../../src/decorator/DecoDate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAcjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,YAA0B;IACtD,0EAA0E;IAC1E;QACE,KAAK,CAAC;YACJ,IAAI,EAAE,gBAAgB,CAAC,IAAI;YAC3B,UAAU,EAAE,cAAc,CAAC,SAAS;YACpC,QAAQ,EAAE,IAAI;YACd,cAAc,EAAE,CAAC;SAClB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACI,OAAO,CAAC,IAAkB,EAAE,aAAqB,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,UAA0B;QACtC,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/decorator/DecoEnum.d.ts

@@ -2,11 +2,14 @@ import type { DecoPropertyBase } from "../types/types.deco.property.js";
 import type { EnumRegistryKeys } from "../types/types.enum.registry.js";
 import { DecoProperty } from "./DecoProperty.js";
 /**
- * Configuration data for a enum-type decorator property.
+ * Configuration data for an enum-type decorator property.
  */
 export interface DecoEnumData extends DecoPropertyBase {
+    /** Map of enum key to human-readable label. */
     keys: EnumRegistryKeys;
+    /** When set, the generated enum is named after this decorator basename instead of the current one. */
     linkBasename?: string;
+    /** When set, the generated enum is named after this property key instead of the current one. */
     linkKey?: string;
 }
 /**
@@ -25,12 +28,25 @@ export declare class DecoEnum extends DecoProperty<DecoEnumData> {
     /** Creates a new enum property builder with default settings. */
     constructor();
     /**
-     * Sets the enum values.
+     * Registers a single enum entry.
      *
-     * @param values - The enum values.
+     * @param key - The programmatic enum key.
+     * @param text - The human-readable label for the key.
      * @returns This instance for chaining.
      */
     key(key: string, text: string): this;
+    /**
+     * Links this property to an enum generated for a different property.
+     *
+     * @remarks
+     * Used when two properties should share a single generated enum. The
+     * resulting enum is named after `basename` + `key` instead of the current
+     * decorator and property names — see {@link buildEnumName}.
+     *
+     * @param basename - The decorator basename to inherit the enum from.
+     * @param key - The property key on that decorator to inherit the enum from.
+     * @returns This instance for chaining.
+     */
     link(basename: string, key: string): this;
 }
 //# sourceMappingURL=DecoEnum.d.ts.map

package/dist/decorator/DecoEnum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DecoEnum.d.ts","sourceRoot":"","sources":["../../src/decorator/DecoEnum.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,IAAI,EAAE,gBAAgB,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,gBAAuB,CAAC;AAE7C;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,YAAY,CAAC,YAAY,CAAC;IACtD,iEAAiE;;IAKjE;;;;;OAKG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAKpC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAKjD"}
+{"version":3,"file":"DecoEnum.d.ts","sourceRoot":"","sources":["../../src/decorator/DecoEnum.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,+CAA+C;IAC/C,IAAI,EAAE,gBAAgB,CAAC;IACvB,sGAAsG;IACtG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,gBAAuB,CAAC;AAE7C;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,YAAY,CAAC,YAAY,CAAC;IACtD,iEAAiE;;IAKjE;;;;;;OAMG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3C;;;;;;;;;;;OAWG;IACI,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAKjD"}

package/dist/decorator/DecoEnum.js

@@ -18,15 +18,28 @@ export class DecoEnum extends DecoProperty {
         super({ type: DecoPropertyType.enum, keys: {} });
     }
     /**
-     * Sets the enum values.
+     * Registers a single enum entry.
      *
-     * @param values - The enum values.
+     * @param key - The programmatic enum key.
+     * @param text - The human-readable label for the key.
      * @returns This instance for chaining.
      */
     key(key, text) {
         this.data.keys[key] = text;
         return this;
     }
+    /**
+     * Links this property to an enum generated for a different property.
+     *
+     * @remarks
+     * Used when two properties should share a single generated enum. The
+     * resulting enum is named after `basename` + `key` instead of the current
+     * decorator and property names — see {@link buildEnumName}.
+     *
+     * @param basename - The decorator basename to inherit the enum from.
+     * @param key - The property key on that decorator to inherit the enum from.
+     * @returns This instance for chaining.
+     */
     link(basename, key) {
         this.data.linkBasename = basename;
         this.data.linkKey = key;

package/dist/decorator/DecoEnum.js.map

@@ -1 +1 @@
-{"version":3,"file":"DecoEnum.js","sourceRoot":"","sources":["../../src/decorator/DecoEnum.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,YAA0B;IACtD,iEAAiE;IACjE;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAC,GAAW,EAAE,IAAY;QAClC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,IAAI,CAAC,QAAgB,EAAE,GAAW;QACvC,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"DecoEnum.js","sourceRoot":"","sources":["../../src/decorator/DecoEnum.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAcjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,YAA0B;IACtD,iEAAiE;IACjE;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;OAMG;IACI,GAAG,CAAC,GAAW,EAAE,IAAY;QAClC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;OAWG;IACI,IAAI,CAAC,QAAgB,EAAE,GAAW;QACvC,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/decorator/DecoProperty.d.ts

@@ -1,5 +1,5 @@
 import type { DecoParamsKind } from "../types/types.deco.common.js";
-import type { DecoPropertyBase, DecoPropertyCommon, DecoPropertyRaw } from "../types/types.deco.property.js";
+import type { DecoPropertyBase, DecoPropertyCommon, DecoPropertyRaw, DecoVirtualDirection } from "../types/types.deco.property.js";
 import type { AnnotationsProperty } from "../types/types.annotation.js";
 /** A record mapping property names to their {@link DecoProperty} instances. */
 export type DecoProperties = Record<string, DecoProperty<DecoPropertyBase>>;
@@ -98,12 +98,16 @@ export declare class DecoProperty<T extends DecoPropertyBase> {
      */
     filterable(val?: boolean): this;
     /**
-     * Marks this property as virtual in table views.
+     * Marks this property as virtual (non-stored) in the given direction.
      *
-     * @param val - Whether the property is virtual. Defaults to `true`.
+     * - `'output'` (default) — computed on read, never sent by clients.
+     * - `'input'` — validated on input, stripped before storage.
+     * - `'both'` — both directions.
+     *
+     * @param direction - The direction of the virtual field. Defaults to `'output'`.
      * @returns This instance for chaining.
      */
-    virtual(val?: boolean): this;
+    virtual(direction?: DecoVirtualDirection): this;
     /**
      * Marks this property for triggering side effects.
      *

package/dist/decorator/DecoProperty.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DecoProperty.d.ts","sourceRoot":"","sources":["../../src/decorator/DecoProperty.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EAChB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAGxE,+EAA+E;AAC/E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAE5E,iEAAiE;AACjE,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,gBAAgB;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CACvB;AAED,gEAAgE;AAChE,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,CAAC;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,cAAc,KACvB,mBAC6D,CAAC;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,mBAAmB,KACzB,cAIF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,gBAAgB;IAClD,SAAS,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACrC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAElB;;;;;OAKG;gBACgB,QAAQ,EAAE,CAAC;IAK9B;;;;;OAKG;IACI,MAAM,CAAC,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,CAAA;KAAE,GAAG,IAAI;IAUjE;;;;;OAKG;IACI,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI;IAK/C;;;;;OAKG;IACI,WAAW,CAAC,GAAG,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI;IAKrD;;;;;OAKG;IACI,QAAQ,CAAC,GAAG,GAAE,OAAc,GAAG,IAAI;IAK1C;;;;;OAKG;IACI,QAAQ,CAAC,GAAG,GAAE,OAAc,GAAG,IAAI;IAK1C;;;;;OAKG;IACI,QAAQ,CAAC,GAAG,GAAE,OAAc,GAAG,IAAI;IAK1C;;;;;OAKG;IACI,UAAU,CAAC,GAAG,GAAE,OAAc,GAAG,IAAI;IAK5C;;;;;OAKG;IACI,OAAO,CAAC,GAAG,GAAE,OAAc,GAAG,IAAI;IAKzC;;;;;OAKG;IACI,WAAW,CAAC,GAAG,GAAE,OAAc,GAAG,IAAI;IAK7C;;;;;OAKG;IACI,MAAM,CAAC,GAAG,GAAE,cAAc,CAAC,OAAO,CAAQ,GAAG,IAAI;IAKxD;;;;;OAKG;IACI,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK/B;;;;;OAKG;IACI,WAAW,CAAC,GAAG,GAAE,OAAc,GAAG,IAAI;IAK7C;;;;;OAKG;IACI,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI;IAK/C;;;;OAIG;IACI,UAAU,IAAI,eAAe,CAAC,CAAC,CAAC;IAOvC;;;;;OAKG;IACI,kBAAkB,CACvB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,mBAAmB,CAAC,CAAC,CAAC;CAG1B"}
+{"version":3,"file":"DecoProperty.d.ts","sourceRoot":"","sources":["../../src/decorator/DecoProperty.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAGxE,+EAA+E;AAC/E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAE5E,iEAAiE;AACjE,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,gBAAgB;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CACvB;AAED,gEAAgE;AAChE,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,CAAC;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,cAAc,KACvB,mBAC6D,CAAC;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,mBAAmB,KACzB,cAIF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,gBAAgB;IAClD,SAAS,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACrC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAElB;;;;;OAKG;gBACgB,QAAQ,EAAE,CAAC;IAK9B;;;;;OAKG;IACI,MAAM,CAAC,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,CAAA;KAAE,GAAG,IAAI;IAUjE;;;;;OAKG;IACI,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI;IAK/C;;;;;OAKG;IACI,WAAW,CAAC,GAAG,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI;IAKrD;;;;;OAKG;IACI,QAAQ,CAAC,GAAG,GAAE,OAAc,GAAG,IAAI;IAK1C;;;;;OAKG;IACI,QAAQ,CAAC,GAAG,GAAE,OAAc,GAAG,IAAI;IAK1C;;;;;OAKG;IACI,QAAQ,CAAC,GAAG,GAAE,OAAc,GAAG,IAAI;IAK1C;;;;;OAKG;IACI,UAAU,CAAC,GAAG,GAAE,OAAc,GAAG,IAAI;IAK5C;;;;;;;;;OASG;IACI,OAAO,CAAC,SAAS,GAAE,oBAA+B,GAAG,IAAI;IAKhE;;;;;OAKG;IACI,WAAW,CAAC,GAAG,GAAE,OAAc,GAAG,IAAI;IAK7C;;;;;OAKG;IACI,MAAM,CAAC,GAAG,GAAE,cAAc,CAAC,OAAO,CAAQ,GAAG,IAAI;IAKxD;;;;;OAKG;IACI,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK/B;;;;;OAKG;IACI,WAAW,CAAC,GAAG,GAAE,OAAc,GAAG,IAAI;IAK7C;;;;;OAKG;IACI,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI;IAK/C;;;;OAIG;IACI,UAAU,IAAI,eAAe,CAAC,CAAC,CAAC;IAOvC;;;;;OAKG;IACI,kBAAkB,CACvB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,mBAAmB,CAAC,CAAC,CAAC;CAG1B"}

package/dist/decorator/DecoProperty.js

@@ -118,13 +118,17 @@ export class DecoProperty {
         return this;
     }
     /**
-     * Marks this property as virtual in table views.
+     * Marks this property as virtual (non-stored) in the given direction.
      *
-     * @param val - Whether the property is virtual. Defaults to `true`.
+     * - `'output'` (default) — computed on read, never sent by clients.
+     * - `'input'` — validated on input, stripped before storage.
+     * - `'both'` — both directions.
+     *
+     * @param direction - The direction of the virtual field. Defaults to `'output'`.
      * @returns This instance for chaining.
      */
-    virtual(val = true) {
-        this.common.virtual = val;
+    virtual(direction = "output") {
+        this.common.virtual = direction;
         return this;
     }
     /**

package/dist/decorator/DecoProperty.js.map

@@ -1 +1 @@
-{"version":3,"file":"DecoProperty.js","sourceRoot":"","sources":["../../src/decorator/DecoProperty.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAcxE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,QAAwB,EACH,EAAE,CACvB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,KAA0B,EACV,EAAE;IAClB,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,KAAK;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACtD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,YAAY;IACb,MAAM,CAAqB;IAC3B,IAAI,CAAI;IAElB;;;;;OAKG;IACH,YAAmB,QAAW;QAC5B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,QAAQ,EAAO,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,CAA4C;QACxD,IAAI,CAAC,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAEtD,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAC5B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,GAA2B;QACtC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,WAAW,CAAC,GAA2B;QAC5C,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,QAAQ,CAAC,MAAe,IAAI;QACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,QAAQ,CAAC,MAAe,IAAI;QACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,QAAQ,CAAC,MAAe,IAAI;QACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,UAAU,CAAC,MAAe,IAAI;QACnC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,OAAO,CAAC,MAAe,IAAI;QAChC,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,WAAW,CAAC,MAAe,IAAI;QACpC,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAA+B,IAAI;QAC/C,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,GAAW;QACtB,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,WAAW,CAAC,MAAe,IAAI;QACpC,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,GAA2B;QACtC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACI,UAAU;QACf,OAAO,eAAe,CAAC;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,kBAAkB,CACvB,QAAgB,EAChB,WAAmB;QAEnB,OAAO,sBAAsB,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF"}
+{"version":3,"file":"DecoProperty.js","sourceRoot":"","sources":["../../src/decorator/DecoProperty.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAcxE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,QAAwB,EACH,EAAE,CACvB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,KAA0B,EACV,EAAE;IAClB,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,KAAK;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACtD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,YAAY;IACb,MAAM,CAAqB;IAC3B,IAAI,CAAI;IAElB;;;;;OAKG;IACH,YAAmB,QAAW;QAC5B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,QAAQ,EAAO,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,CAA4C;QACxD,IAAI,CAAC,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAEtD,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAC5B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,GAA2B;QACtC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,WAAW,CAAC,GAA2B;QAC5C,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,QAAQ,CAAC,MAAe,IAAI;QACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,QAAQ,CAAC,MAAe,IAAI;QACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,QAAQ,CAAC,MAAe,IAAI;QACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,UAAU,CAAC,MAAe,IAAI;QACnC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;OASG;IACI,OAAO,CAAC,YAAkC,QAAQ;QACvD,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,SAAS,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,WAAW,CAAC,MAAe,IAAI;QACpC,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAA+B,IAAI;QAC/C,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,GAAW;QACtB,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,WAAW,CAAC,MAAe,IAAI;QACpC,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,GAA2B;QACtC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACI,UAAU;QACf,OAAO,eAAe,CAAC;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,kBAAkB,CACvB,QAAgB,EAChB,WAAmB;QAEnB,OAAO,sBAAsB,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/dist/decorator/Decorator.d.ts

@@ -121,7 +121,27 @@ export declare class Decorator {
      * @returns This instance for chaining.
      */
     standalone(standalone?: boolean): this;
+    /**
+     * Registers (or merges) enum entries under a given enum name.
+     *
+     * @remarks
+     * If an item with the same `name` already exists on this decorator, the new
+     * entries are merged into it without overwriting existing keys.
+     *
+     * @param name - The fully-qualified enum name (typically built via {@link buildEnumName}).
+     * @param entries - Map of enum key to human-readable label.
+     * @returns This instance for chaining.
+     */
     registerEnumByName(name: string, entries: DecoEnumEntries): this;
+    /**
+     * Convenience wrapper around {@link Decorator.registerEnumByName} that derives
+     * the enum name from a header name and property key via {@link buildEnumName}.
+     *
+     * @param headName - The decorator basename component.
+     * @param enumName - The property key component.
+     * @param entries - Map of enum key to human-readable label.
+     * @returns This instance for chaining.
+     */
     registerEnum(headName: string, enumName: string, entries: DecoEnumEntries): this;
     /**
      * Extracts a deep-cloned snapshot of the decorator's raw data.

package/dist/decorator/Decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Decorator.d.ts","sourceRoot":"","sources":["../../src/decorator/Decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACX,MAAM,+BAA+B,CAAC;AASvC,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGxE;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,UAAU,CAAC,EAAE,cAAc,CAAC;IAG5B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GACzB,UAAU,MAAM,MAChB,MAAM,MAAM,KAAG,SACe,CAAC;AAElC,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEnD;;;;;;GAMG;AACH,qBAAa,SAAS;aAUF,IAAI,EAAE,MAAM;IAT9B,SAAS,CAAC,IAAI,EAAE,aAAa,CAAC;IAE9B;;;;;OAKG;gBAEe,IAAI,EAAE,MAAM,EAC5B,aAAa,EAAE,MAAM;IAevB;;;;;OAKG;IACI,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK/B;;;;;OAKG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKnC;;;;;OAKG;IACI,UAAU,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;IAOnD;;;;;OAKG;IACI,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAOvC;;;;OAIG;IACI,UAAU,IAAI,IAAI;IAIzB;;;;OAIG;IACI,gBAAgB,IAAI,IAAI;IAI/B;;;;;OAKG;IACI,IAAI,CAAC,IAAI,GAAE,OAAc,GAAG,IAAI;IAKvC;;;;;;;;;OASG;IACI,UAAU,CAAC,UAAU,GAAE,OAAc,GAAG,IAAI;IAK5C,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAgBhE,YAAY,CACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,GACvB,IAAI;IAIP;;;;OAIG;IACI,UAAU,IAAI,aAAa;IAQlC;;;;;;;;OAQG;IACI,kBAAkB,IAAI,iBAAiB;CAiB/C"}
+{"version":3,"file":"Decorator.d.ts","sourceRoot":"","sources":["../../src/decorator/Decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACX,MAAM,+BAA+B,CAAC;AASvC,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGxE;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,UAAU,CAAC,EAAE,cAAc,CAAC;IAG5B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GACzB,UAAU,MAAM,MAChB,MAAM,MAAM,KAAG,SACe,CAAC;AAElC,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEnD;;;;;;GAMG;AACH,qBAAa,SAAS;aAUF,IAAI,EAAE,MAAM;IAT9B,SAAS,CAAC,IAAI,EAAE,aAAa,CAAC;IAE9B;;;;;OAKG;gBAEe,IAAI,EAAE,MAAM,EAC5B,aAAa,EAAE,MAAM;IAevB;;;;;OAKG;IACI,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK/B;;;;;OAKG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKnC;;;;;OAKG;IACI,UAAU,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;IAOnD;;;;;OAKG;IACI,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAOvC;;;;OAIG;IACI,UAAU,IAAI,IAAI;IAIzB;;;;OAIG;IACI,gBAAgB,IAAI,IAAI;IAI/B;;;;;OAKG;IACI,IAAI,CAAC,IAAI,GAAE,OAAc,GAAG,IAAI;IAKvC;;;;;;;;;OASG;IACI,UAAU,CAAC,UAAU,GAAE,OAAc,GAAG,IAAI;IAKnD;;;;;;;;;;OAUG;IACI,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAgBvE;;;;;;;;OAQG;IACI,YAAY,CACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,GACvB,IAAI;IAIP;;;;OAIG;IACI,UAAU,IAAI,aAAa;IAQlC;;;;;;;;OAQG;IACI,kBAAkB,IAAI,iBAAiB;CAiB/C"}

package/dist/decorator/Decorator.js

@@ -126,6 +126,17 @@ export class Decorator {
         this.data.standalone = standalone;
         return this;
     }
+    /**
+     * Registers (or merges) enum entries under a given enum name.
+     *
+     * @remarks
+     * If an item with the same `name` already exists on this decorator, the new
+     * entries are merged into it without overwriting existing keys.
+     *
+     * @param name - The fully-qualified enum name (typically built via {@link buildEnumName}).
+     * @param entries - Map of enum key to human-readable label.
+     * @returns This instance for chaining.
+     */
     registerEnumByName(name, entries) {
         let item = this.data.registryItems.find((item) => item.name === name);
         if (!item) {
@@ -139,6 +150,15 @@ export class Decorator {
                 item.keys[key] = text;
         return this;
     }
+    /**
+     * Convenience wrapper around {@link Decorator.registerEnumByName} that derives
+     * the enum name from a header name and property key via {@link buildEnumName}.
+     *
+     * @param headName - The decorator basename component.
+     * @param enumName - The property key component.
+     * @param entries - Map of enum key to human-readable label.
+     * @returns This instance for chaining.
+     */
     registerEnum(headName, enumName, entries) {
         return this.registerEnumByName(buildEnumName(headName, enumName), entries);
     }

package/dist/decorator/Decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"Decorator.js","sourceRoot":"","sources":["../../src/decorator/Decorator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Decorator.js","sourceRoot":"","sources":["../../src/decorator/Decorator.ts"],"names":[],"mappings":"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"}

package/dist/decorator/deco.browser.d.ts

@@ -1,10 +1,26 @@
 /**
- * node:path basename for browser
+ * Browser-safe equivalent of `node:path` `basename`.
  *
- * @param path
- * @param suffix An optional suffix to remove
- * @returns basename
+ * @remarks
+ * Always splits on `/` regardless of platform, so it produces correct output in
+ * both Node and the browser. An optional `suffix` (typically a file extension)
+ * is stripped from the end of the result when present.
+ *
+ * @param path - The path to extract the basename from.
+ * @param suffix - Optional suffix to strip from the result (e.g. `".ts"`).
+ * @returns The final path segment, with `suffix` removed when applicable.
  */
 export declare const browserBasename: (path: string, suffix?: string) => string;
+/**
+ * Browser-safe equivalent of `node:path` `dirname`.
+ *
+ * @remarks
+ * Returns everything before the final path segment. Trailing slashes on `path`
+ * are ignored. A leading slash is preserved so absolute POSIX-style paths
+ * remain absolute.
+ *
+ * @param _path - The path whose directory portion should be returned.
+ * @returns The directory portion of `_path`.
+ */
 export declare const browserDirname: (_path: string) => string;
 //# sourceMappingURL=deco.browser.d.ts.map

package/dist/decorator/deco.browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deco.browser.d.ts","sourceRoot":"","sources":["../../src/decorator/deco.browser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,KAAG,MAK/D,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAO9C,CAAC"}
+{"version":3,"file":"deco.browser.d.ts","sourceRoot":"","sources":["../../src/decorator/deco.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,KAAG,MAK/D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAO9C,CAAC"}

package/dist/decorator/deco.browser.js

@@ -1,9 +1,14 @@
 /**
- * node:path basename for browser
+ * Browser-safe equivalent of `node:path` `basename`.
  *
- * @param path
- * @param suffix An optional suffix to remove
- * @returns basename
+ * @remarks
+ * Always splits on `/` regardless of platform, so it produces correct output in
+ * both Node and the browser. An optional `suffix` (typically a file extension)
+ * is stripped from the end of the result when present.
+ *
+ * @param path - The path to extract the basename from.
+ * @param suffix - Optional suffix to strip from the result (e.g. `".ts"`).
+ * @returns The final path segment, with `suffix` removed when applicable.
  */
 export const browserBasename = (path, suffix) => {
     const name = path.split("/").pop();
@@ -11,6 +16,17 @@ export const browserBasename = (path, suffix) => {
         ? name.slice(0, -suffix.length)
         : name;
 };
+/**
+ * Browser-safe equivalent of `node:path` `dirname`.
+ *
+ * @remarks
+ * Returns everything before the final path segment. Trailing slashes on `path`
+ * are ignored. A leading slash is preserved so absolute POSIX-style paths
+ * remain absolute.
+ *
+ * @param _path - The path whose directory portion should be returned.
+ * @returns The directory portion of `_path`.
+ */
 export const browserDirname = (_path) => {
     const isRoot = _path.startsWith("/");
     const path = _path.replace(/\/+$/, "");

package/dist/decorator/deco.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"deco.browser.js","sourceRoot":"","sources":["../../src/decorator/deco.browser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,MAAe,EAAU,EAAE;IACvE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC;IACpC,OAAO,MAAM,IAAI,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC;QACrC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;QAC/B,CAAC,CAAC,IAAI,CAAC;AACX,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAU,EAAE;IACtD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,KAAK,CAAC,GAAG,EAAE,CAAC;IACZ,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AACnE,CAAC,CAAC"}
+{"version":3,"file":"deco.browser.js","sourceRoot":"","sources":["../../src/decorator/deco.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,MAAe,EAAU,EAAE;IACvE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC;IACpC,OAAO,MAAM,IAAI,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC;QACrC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;QAC/B,CAAC,CAAC,IAAI,CAAC;AACX,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAU,EAAE;IACtD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,KAAK,CAAC,GAAG,EAAE,CAAC;IACZ,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AACnE,CAAC,CAAC"}