@mlightcad/common 1.1.1 → 1.1.2

package/lib/AcCmLogUtil.d.ts

@@ -1,5 +1,36 @@
+/**
+ * @fileoverview Logging utilities for the AutoCAD Common library.
+ *
+ * This module provides a centralized logging interface using the loglevel library,
+ * with configurable log levels for development and production environments.
+ *
+ * @module AcCmLogUtil
+ * @version 1.0.0
+ */
 import * as loglevel from 'loglevel';
+/**
+ * Flag indicating whether debug mode is enabled.
+ * When true, sets log level to 'debug'; otherwise sets to 'warn'.
+ *
+ * @constant {boolean}
+ */
 export declare const DEBUG_MODE = true;
+/**
+ * The main logging instance from the loglevel library.
+ * Provides standard logging methods: trace, debug, info, warn, error.
+ *
+ * @constant {loglevel.Logger}
+ *
+ * @example
+ * ```typescript
+ * import { log } from './AcCmLogUtil'
+ *
+ * log.debug('Debug message')
+ * log.info('Info message')
+ * log.warn('Warning message')
+ * log.error('Error message')
+ * ```
+ */
 export declare const log: {
     default: loglevel.RootLogger;
     noConflict(): any;
@@ -24,8 +55,26 @@ export declare const log: {
     rebuild(): void;
 };
 /**
- * Sets log level.
- * Note that, we limit user to set only some of the levels.
+ * Sets the log level for the logging system.
+ *
+ * Valid log levels are: 'trace', 'debug', 'info', 'warn', 'error', 'silent'.
+ * If an invalid level is provided, the level will default to 'error' and an error will be logged.
+ *
+ * @param {string} level - The log level to set.
+ *
+ * @example
+ * ```typescript
+ * import { setLogLevel } from './AcCmLogUtil'
+ *
+ * // Set to debug level for development
+ * setLogLevel('debug')
+ *
+ * // Set to error level for production
+ * setLogLevel('error')
+ *
+ * // Silent all logging
+ * setLogLevel('silent')
+ * ```
  */
 export declare const setLogLevel: (level: string) => void;
 //# sourceMappingURL=AcCmLogUtil.d.ts.map

package/lib/AcCmLogUtil.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcCmLogUtil.d.ts","sourceRoot":"","sources":["../src/AcCmLogUtil.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAA;AAEpC,eAAO,MAAM,UAAU,OAAO,CAAA;AAC9B,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;CAAW,CAAA;AAQ3B;;;GAGG;AACH,eAAO,MAAM,WAAW,UAAW,MAAM,SAOxC,CAAA"}
+{"version":3,"file":"AcCmLogUtil.d.ts","sourceRoot":"","sources":["../src/AcCmLogUtil.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAA;AAEpC;;;;;GAKG;AACH,eAAO,MAAM,UAAU,OAAO,CAAA;AAE9B;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;CAAW,CAAA;AAQ3B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,WAAW,UAAW,MAAM,SAOxC,CAAA"}

package/lib/AcCmLogUtil.js

@@ -1,5 +1,36 @@
+/**
+ * @fileoverview Logging utilities for the AutoCAD Common library.
+ *
+ * This module provides a centralized logging interface using the loglevel library,
+ * with configurable log levels for development and production environments.
+ *
+ * @module AcCmLogUtil
+ * @version 1.0.0
+ */
 import * as loglevel from 'loglevel';
+/**
+ * Flag indicating whether debug mode is enabled.
+ * When true, sets log level to 'debug'; otherwise sets to 'warn'.
+ *
+ * @constant {boolean}
+ */
 export var DEBUG_MODE = true;
+/**
+ * The main logging instance from the loglevel library.
+ * Provides standard logging methods: trace, debug, info, warn, error.
+ *
+ * @constant {loglevel.Logger}
+ *
+ * @example
+ * ```typescript
+ * import { log } from './AcCmLogUtil'
+ *
+ * log.debug('Debug message')
+ * log.info('Info message')
+ * log.warn('Warning message')
+ * log.error('Error message')
+ * ```
+ */
 export var log = loglevel;
 if (DEBUG_MODE) {
     log.setLevel('debug');
@@ -8,8 +39,26 @@ else {
     log.setLevel('warn');
 }
 /**
- * Sets log level.
- * Note that, we limit user to set only some of the levels.
+ * Sets the log level for the logging system.
+ *
+ * Valid log levels are: 'trace', 'debug', 'info', 'warn', 'error', 'silent'.
+ * If an invalid level is provided, the level will default to 'error' and an error will be logged.
+ *
+ * @param {string} level - The log level to set.
+ *
+ * @example
+ * ```typescript
+ * import { setLogLevel } from './AcCmLogUtil'
+ *
+ * // Set to debug level for development
+ * setLogLevel('debug')
+ *
+ * // Set to error level for production
+ * setLogLevel('error')
+ *
+ * // Silent all logging
+ * setLogLevel('silent')
+ * ```
  */
 export var setLogLevel = function (level) {
     try {

package/lib/AcCmLogUtil.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcCmLogUtil.js","sourceRoot":"","sources":["../src/AcCmLogUtil.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAA;AAEpC,MAAM,CAAC,IAAM,UAAU,GAAG,IAAI,CAAA;AAC9B,MAAM,CAAC,IAAM,GAAG,GAAG,QAAQ,CAAA;AAE3B,IAAI,UAAU,EAAE,CAAC;IACf,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;AACvB,CAAC;KAAM,CAAC;IACN,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,IAAM,WAAW,GAAG,UAAC,KAAa;IACvC,IAAI,CAAC;QACH,GAAG,CAAC,QAAQ,CAAC,KAA8B,CAAC,CAAA;IAC9C,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;QACZ,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QACrB,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACf,CAAC;AACH,CAAC,CAAA"}
+{"version":3,"file":"AcCmLogUtil.js","sourceRoot":"","sources":["../src/AcCmLogUtil.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAA;AAEpC;;;;;GAKG;AACH,MAAM,CAAC,IAAM,UAAU,GAAG,IAAI,CAAA;AAE9B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,IAAM,GAAG,GAAG,QAAQ,CAAA;AAE3B,IAAI,UAAU,EAAE,CAAC;IACf,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;AACvB,CAAC;KAAM,CAAC;IACN,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AACtB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,IAAM,WAAW,GAAG,UAAC,KAAa;IACvC,IAAI,CAAC;QACH,GAAG,CAAC,QAAQ,CAAC,KAA8B,CAAC,CAAA;IAC9C,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;QACZ,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QACrB,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACf,CAAC;AACH,CAAC,CAAA"}

package/lib/AcCmObject.d.ts

@@ -1,3 +1,13 @@
+/**
+ * @fileoverview Object model implementation for the AutoCAD Common library.
+ *
+ * This module provides a reactive object model with attribute management,
+ * change tracking, and event notification. Inspired by Backbone.js Model
+ * but with TypeScript support and reduced dependencies.
+ *
+ * @module AcCmObject
+ * @version 1.0.0
+ */
 import { AcCmEventManager } from './AcCmEventManager';
 export type AcCmAttributes = Record<string, any>;
 /**
@@ -50,19 +60,63 @@ export declare class AcCmObject<T extends AcCmAttributes = any> {
      */
     constructor(attributes?: Partial<T>, defaultAttrs?: Partial<T>);
     /**
-     * For strongly-typed access to attributes, use the `get` method only privately in public getter properties.
+     * Gets the value of an attribute.
+     *
+     * For strongly-typed access to attributes, use the `get` method privately in public getter properties.
+     *
+     * @template A - The key type extending string keys of T.
+     * @param {A} key - The attribute key to retrieve.
+     * @returns {T[A] | undefined} The attribute value or undefined if not set.
+     *
      * @example
+     * ```typescript
+     * // Get a single attribute value
+     * const name = obj.get('name')
+     * const visible = obj.get('visible')
+     *
+     * // Check if attribute exists
+     * if (obj.get('name') !== undefined) {
+     *   console.log('Name is set')
+     * }
+     *
+     * // For strongly-typed subclasses
      * get name(): string {
-     *    return super.get("name")
+     *   return super.get("name")
      * }
+     * ```
      */
     get<A extends AcCmStringKey<T>>(key: A): T[A] | undefined;
     /**
-     * For strongly-typed assignment of attributes, use the `set` method only privately in public setter properties.
+     * Sets one or more attributes on the object.
+     *
+     * For strongly-typed assignment of attributes, use the `set` method privately in public setter properties.
+     * Triggers change events unless the `silent` option is specified.
+     *
+     * @template A - The key type extending string keys of T.
+     * @param {A | Partial<T>} key - The attribute key or an object of key-value pairs.
+     * @param {T[A] | AcCmObjectOptions} [val] - The value to set or options when key is an object.
+     * @param {AcCmObjectOptions} [options] - Options for the set operation.
+     * @returns {this} The current instance for method chaining.
+     *
      * @example
+     * ```typescript
+     * // Set a single attribute
+     * obj.set('name', 'MyEntity')
+     *
+     * // Set multiple attributes
+     * obj.set({ name: 'MyEntity', visible: true })
+     *
+     * // Set with options
+     * obj.set('name', 'MyEntity', { silent: true })
+     *
+     * // Unset an attribute
+     * obj.set('name', undefined, { unset: true })
+     *
+     * // For strongly-typed subclasses
      * set name(value: string) {
-     *    super.set("name", value)
+     *   super.set("name", value)
      * }
+     * ```
      */
     set<A extends AcCmStringKey<T>>(key: A, val?: T[A], options?: AcCmObjectOptions): this;
     set(key: Partial<T>, options?: AcCmObjectOptions): this;

package/lib/AcCmObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcCmObject.d.ts","sourceRoot":"","sources":["../src/AcCmObject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAIrD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAEhD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC5B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC5B;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,CAAA;AAE/C;;GAEG;AACH,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,cAAc;IAClE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;IACrB,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mCAAmC,CAAC,CAAC,SAAS,cAAc,CAC3E,SAAQ,0BAA0B,CAAC,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,SAAS,CAAC,EAAE,GAAG,CAAA;CAChB;AAED;;;;;;;;;GASG;AAEH,qBAAa,UAAU,CAAC,CAAC,SAAS,cAAc,GAAG,GAAG;IACpD,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IACtB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IAEnB,SAAgB,MAAM;;;MAGrB;IAED,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,mBAAmB,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAiB;IAEjC;;;;;OAKG;gBACS,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAS9D;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;IAIzD;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,EAC5B,GAAG,EAAE,CAAC,EACN,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EACV,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI;IACP,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAiFvD,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO;IAInC;;;OAGG;IACH,UAAU,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;IAKjC;;;;;;OAMG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAYhD;;OAEG;IACH,QAAQ,CAAC,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS;IAKrE;;OAEG;IACH,kBAAkB,IAAI,OAAO,CAAC,CAAC,CAAC;IAIhC;;OAEG;IACH,KAAK;CAIN"}
+{"version":3,"file":"AcCmObject.d.ts","sourceRoot":"","sources":["../src/AcCmObject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAIrD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAEhD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC5B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC5B;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,CAAA;AAE/C;;GAEG;AACH,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,cAAc;IAClE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;IACrB,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mCAAmC,CAAC,CAAC,SAAS,cAAc,CAC3E,SAAQ,0BAA0B,CAAC,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,SAAS,CAAC,EAAE,GAAG,CAAA;CAChB;AAED;;;;;;;;;GASG;AAEH,qBAAa,UAAU,CAAC,CAAC,SAAS,cAAc,GAAG,GAAG;IACpD,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IACtB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IAEnB,SAAgB,MAAM;;;MAGrB;IAED,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,mBAAmB,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAiB;IAEjC;;;;;OAKG;gBACS,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAS9D;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,GAAG,CAAC,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;IAIzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,GAAG,CAAC,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,EAC5B,GAAG,EAAE,CAAC,EACN,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EACV,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI;IACP,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAiFvD,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO;IAInC;;;OAGG;IACH,UAAU,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;IAKjC;;;;;;OAMG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAYhD;;OAEG;IACH,QAAQ,CAAC,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS;IAKrE;;OAEG;IACH,kBAAkB,IAAI,OAAO,CAAC,CAAC,CAAC;IAIhC;;OAEG;IACH,KAAK;CAIN"}

package/lib/AcCmObject.js

@@ -1,3 +1,13 @@
+/**
+ * @fileoverview Object model implementation for the AutoCAD Common library.
+ *
+ * This module provides a reactive object model with attribute management,
+ * change tracking, and event notification. Inspired by Backbone.js Model
+ * but with TypeScript support and reduced dependencies.
+ *
+ * @module AcCmObject
+ * @version 1.0.0
+ */
 import { AcCmEventManager } from './AcCmEventManager';
 import { clone, defaults, has, isEmpty, isEqual } from './AcCmLodashUtils';
 /**
@@ -34,11 +44,30 @@ var AcCmObject = /** @class */ (function () {
         this.changed = {};
     }
     /**
-     * For strongly-typed access to attributes, use the `get` method only privately in public getter properties.
+     * Gets the value of an attribute.
+     *
+     * For strongly-typed access to attributes, use the `get` method privately in public getter properties.
+     *
+     * @template A - The key type extending string keys of T.
+     * @param {A} key - The attribute key to retrieve.
+     * @returns {T[A] | undefined} The attribute value or undefined if not set.
+     *
      * @example
+     * ```typescript
+     * // Get a single attribute value
+     * const name = obj.get('name')
+     * const visible = obj.get('visible')
+     *
+     * // Check if attribute exists
+     * if (obj.get('name') !== undefined) {
+     *   console.log('Name is set')
+     * }
+     *
+     * // For strongly-typed subclasses
      * get name(): string {
-     *    return super.get("name")
+     *   return super.get("name")
      * }
+     * ```
      */
     AcCmObject.prototype.get = function (key) {
         return this.attributes[key];

package/lib/AcCmObject.js.map

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

package/lib/AcCmPerformanceCollector.d.ts

@@ -1,8 +1,29 @@
+/**
+ * @fileoverview Performance monitoring and collection system for the AutoCAD Common library.
+ *
+ * This module provides a singleton-based performance collector that can store,
+ * retrieve, and format performance metrics for debugging and optimization purposes.
+ *
+ * @module AcCmPerformanceCollector
+ * @version 1.0.0
+ */
 /**
  * A performance entry containing a unique name, associated data,
  * and a method to format the data into a human-readable string.
  *
- * @template T The type of the performance data.
+ * @template T - The type of the performance data.
+ *
+ * @example
+ * ```typescript
+ * // Create a custom performance entry
+ * const loadTimeEntry: AcCmPerformanceEntry<number> = {
+ *   name: 'file-load-time',
+ *   data: 1250, // milliseconds
+ *   format() {
+ *     return `File loaded in ${this.data}ms`
+ *   }
+ * }
+ * ```
  */
 export interface AcCmPerformanceEntry<T> {
     /** Unique name of this performance entry. */

package/lib/AcCmPerformanceCollector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcCmPerformanceCollector.d.ts","sourceRoot":"","sources":["../src/AcCmPerformanceCollector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAA;IAEZ,uCAAuC;IACvC,IAAI,EAAE,CAAC,CAAA;IAEP;;;OAGG;IACH,MAAM,IAAI,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,qBAAa,wBAAwB;IACnC,8BAA8B;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IAEjD,6DAA6D;IAC7D,OAAO,CAAC,OAAO,CAAwD;IAEvE;;OAEG;IACH,OAAO;IAEP;;;OAGG;WACW,WAAW,IAAI,wBAAwB;IAOrD;;;;OAIG;IACI,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,IAAI;IAIvD;;OAEG;IACI,QAAQ,IAAI,IAAI;IAOvB;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;;OAGG;IACI,MAAM,IAAI,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAIhD;;;;OAIG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,SAAS;IAIxE;;;;OAIG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAGrC"}
+{"version":3,"file":"AcCmPerformanceCollector.d.ts","sourceRoot":"","sources":["../src/AcCmPerformanceCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAA;IAEZ,uCAAuC;IACvC,IAAI,EAAE,CAAC,CAAA;IAEP;;;OAGG;IACH,MAAM,IAAI,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,qBAAa,wBAAwB;IACnC,8BAA8B;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IAEjD,6DAA6D;IAC7D,OAAO,CAAC,OAAO,CAAwD;IAEvE;;OAEG;IACH,OAAO;IAEP;;;OAGG;WACW,WAAW,IAAI,wBAAwB;IAOrD;;;;OAIG;IACI,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,IAAI;IAIvD;;OAEG;IACI,QAAQ,IAAI,IAAI;IAOvB;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;;OAGG;IACI,MAAM,IAAI,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAIhD;;;;OAIG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,SAAS;IAIxE;;;;OAIG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAGrC"}

package/lib/AcCmPerformanceCollector.js

@@ -1,3 +1,12 @@
+/**
+ * @fileoverview Performance monitoring and collection system for the AutoCAD Common library.
+ *
+ * This module provides a singleton-based performance collector that can store,
+ * retrieve, and format performance metrics for debugging and optimization purposes.
+ *
+ * @module AcCmPerformanceCollector
+ * @version 1.0.0
+ */
 var __values = (this && this.__values) || function(o) {
     var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
     if (m) return m.call(o);

package/lib/AcCmPerformanceCollector.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcCmPerformanceCollector.js","sourceRoot":"","sources":["../src/AcCmPerformanceCollector.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA;;;GAGG;AACH;IAOE;;OAEG;IACH;QANA,6DAA6D;QACrD,YAAO,GAA+C,IAAI,GAAG,EAAE,CAAA;IAKhD,CAAC;IAExB;;;OAGG;IACW,oCAAW,GAAzB;QACE,IAAI,CAAC,wBAAwB,CAAC,QAAQ,EAAE,CAAC;YACvC,wBAAwB,CAAC,QAAQ,GAAG,IAAI,wBAAwB,EAAE,CAAA;QACpE,CAAC;QACD,OAAO,wBAAwB,CAAC,QAAQ,CAAA;IAC1C,CAAC;IAED;;;;OAIG;IACI,0CAAO,GAAd,UAAkB,KAA8B;QAC9C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACrC,CAAC;IAED;;OAEG;IACI,2CAAQ,GAAf;;;YACE,KAA4B,IAAA,KAAA,SAAA,IAAI,CAAC,OAAO,CAAA,gBAAA,4BAAE,CAAC;gBAAhC,IAAA,KAAA,mBAAa,EAAZ,MAAI,QAAA,EAAE,KAAK,QAAA;gBACrB,OAAO,CAAC,GAAG,CAAC,UAAG,MAAI,MAAG,CAAC,CAAA;gBACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;YAC7B,CAAC;;;;;;;;;IACH,CAAC;IAED;;OAEG;IACI,wCAAK,GAAZ;QACE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;IAED;;;OAGG;IACI,yCAAM,GAAb;QACE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED;;;;OAIG;IACI,2CAAQ,GAAf,UAAgB,IAAY;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED;;;;OAIG;IACI,yCAAM,GAAb,UAAc,IAAY;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;IACH,+BAAC;AAAD,CAAC,AA1ED,IA0EC"}
+{"version":3,"file":"AcCmPerformanceCollector.js","sourceRoot":"","sources":["../src/AcCmPerformanceCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCH;;;GAGG;AACH;IAOE;;OAEG;IACH;QANA,6DAA6D;QACrD,YAAO,GAA+C,IAAI,GAAG,EAAE,CAAA;IAKhD,CAAC;IAExB;;;OAGG;IACW,oCAAW,GAAzB;QACE,IAAI,CAAC,wBAAwB,CAAC,QAAQ,EAAE,CAAC;YACvC,wBAAwB,CAAC,QAAQ,GAAG,IAAI,wBAAwB,EAAE,CAAA;QACpE,CAAC;QACD,OAAO,wBAAwB,CAAC,QAAQ,CAAA;IAC1C,CAAC;IAED;;;;OAIG;IACI,0CAAO,GAAd,UAAkB,KAA8B;QAC9C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACrC,CAAC;IAED;;OAEG;IACI,2CAAQ,GAAf;;;YACE,KAA4B,IAAA,KAAA,SAAA,IAAI,CAAC,OAAO,CAAA,gBAAA,4BAAE,CAAC;gBAAhC,IAAA,KAAA,mBAAa,EAAZ,MAAI,QAAA,EAAE,KAAK,QAAA;gBACrB,OAAO,CAAC,GAAG,CAAC,UAAG,MAAI,MAAG,CAAC,CAAA;gBACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;YAC7B,CAAC;;;;;;;;;IACH,CAAC;IAED;;OAEG;IACI,wCAAK,GAAZ;QACE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;IAED;;;OAGG;IACI,yCAAM,GAAb;QACE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED;;;;OAIG;IACI,2CAAQ,GAAf,UAAgB,IAAY;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED;;;;OAIG;IACI,yCAAM,GAAb,UAAc,IAAY;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;IACH,+BAAC;AAAD,CAAC,AA1ED,IA0EC"}

package/lib/AcCmStringUtil.d.ts

@@ -1,10 +1,43 @@
+/**
+ * @fileoverview String manipulation utilities for the AutoCAD Common library.
+ *
+ * This module provides utility functions for common string operations,
+ * including formatting and conversion utilities.
+ *
+ * @module AcCmStringUtil
+ * @version 1.0.0
+ */
+/**
+ * Utility class providing static methods for string operations and formatting.
+ *
+ * Contains helper functions for data formatting, size conversions, and other
+ * string manipulation tasks commonly needed in AutoCAD file processing.
+ *
+ * @class AcTrStringUtil
+ * @version 1.0.0
+ */
 export declare class AcTrStringUtil {
     /**
-     * Converts a byte count to a human-readable string using KB, MB, or GB.
+     * Converts a byte count to a human-readable string using appropriate size units.
      *
-     * @param bytes - The number of bytes.
-     * @param decimals - Number of decimal places to include (default is 2).
-     * @returns A formatted string with the appropriate unit.
+     * Automatically selects the most appropriate unit (B, KB, MB, GB, TB) based on the size
+     * and formats the result with the specified number of decimal places.
+     *
+     * @param {number} bytes - The number of bytes to format.
+     * @param {number} [decimals=2] - Number of decimal places to include in the result.
+     * @returns {string} A formatted string with the appropriate unit.
+     *
+     * @example
+     * ```typescript
+     * import { AcTrStringUtil } from './AcCmStringUtil'
+     *
+     * // Format different byte sizes
+     * AcTrStringUtil.formatBytes(0)          // "0 B"
+     * AcTrStringUtil.formatBytes(1024)       // "1 KB"
+     * AcTrStringUtil.formatBytes(1024 * 1024) // "1 MB"
+     * AcTrStringUtil.formatBytes(1536, 1)    // "1.5 KB"
+     * AcTrStringUtil.formatBytes(2048000, 0) // "2 MB"
+     * ```
      */
     static formatBytes(bytes: number, decimals?: number): string;
 }

package/lib/AcCmStringUtil.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcCmStringUtil.d.ts","sourceRoot":"","sources":["../src/AcCmStringUtil.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAc;IACzB;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM;CAYxD"}
+{"version":3,"file":"AcCmStringUtil.d.ts","sourceRoot":"","sources":["../src/AcCmStringUtil.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM;CAYxD"}

package/lib/AcCmStringUtil.js

@@ -1,12 +1,45 @@
+/**
+ * @fileoverview String manipulation utilities for the AutoCAD Common library.
+ *
+ * This module provides utility functions for common string operations,
+ * including formatting and conversion utilities.
+ *
+ * @module AcCmStringUtil
+ * @version 1.0.0
+ */
+/**
+ * Utility class providing static methods for string operations and formatting.
+ *
+ * Contains helper functions for data formatting, size conversions, and other
+ * string manipulation tasks commonly needed in AutoCAD file processing.
+ *
+ * @class AcTrStringUtil
+ * @version 1.0.0
+ */
 var AcTrStringUtil = /** @class */ (function () {
     function AcTrStringUtil() {
     }
     /**
-     * Converts a byte count to a human-readable string using KB, MB, or GB.
+     * Converts a byte count to a human-readable string using appropriate size units.
      *
-     * @param bytes - The number of bytes.
-     * @param decimals - Number of decimal places to include (default is 2).
-     * @returns A formatted string with the appropriate unit.
+     * Automatically selects the most appropriate unit (B, KB, MB, GB, TB) based on the size
+     * and formats the result with the specified number of decimal places.
+     *
+     * @param {number} bytes - The number of bytes to format.
+     * @param {number} [decimals=2] - Number of decimal places to include in the result.
+     * @returns {string} A formatted string with the appropriate unit.
+     *
+     * @example
+     * ```typescript
+     * import { AcTrStringUtil } from './AcCmStringUtil'
+     *
+     * // Format different byte sizes
+     * AcTrStringUtil.formatBytes(0)          // "0 B"
+     * AcTrStringUtil.formatBytes(1024)       // "1 KB"
+     * AcTrStringUtil.formatBytes(1024 * 1024) // "1 MB"
+     * AcTrStringUtil.formatBytes(1536, 1)    // "1.5 KB"
+     * AcTrStringUtil.formatBytes(2048000, 0) // "2 MB"
+     * ```
      */
     AcTrStringUtil.formatBytes = function (bytes, decimals) {
         if (decimals === void 0) { decimals = 2; }

package/lib/AcCmStringUtil.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcCmStringUtil.js","sourceRoot":"","sources":["../src/AcCmStringUtil.ts"],"names":[],"mappings":"AAAA;IAAA;IAoBA,CAAC;IAnBC;;;;;;OAMG;IACI,0BAAW,GAAlB,UAAmB,KAAa,EAAE,QAAY;QAAZ,yBAAA,EAAA,YAAY;QAC5C,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,KAAK,CAAA;QAE7B,IAAM,CAAC,GAAG,IAAI,CAAA;QACd,IAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;QAChC,IAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;QAE3C,IAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACnD,IAAM,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAEpC,OAAO,UAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,cAAI,KAAK,CAAC,CAAC,CAAC,CAAE,CAAA;IACvD,CAAC;IACH,qBAAC;AAAD,CAAC,AApBD,IAoBC"}
+{"version":3,"file":"AcCmStringUtil.js","sourceRoot":"","sources":["../src/AcCmStringUtil.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AACH;IAAA;IAmCA,CAAC;IAlCC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,0BAAW,GAAlB,UAAmB,KAAa,EAAE,QAAY;QAAZ,yBAAA,EAAA,YAAY;QAC5C,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,KAAK,CAAA;QAE7B,IAAM,CAAC,GAAG,IAAI,CAAA;QACd,IAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;QAChC,IAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;QAE3C,IAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACnD,IAAM,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAEpC,OAAO,UAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,cAAI,KAAK,CAAC,CAAC,CAAC,CAAE,CAAA;IACvD,CAAC;IACH,qBAAC;AAAD,CAAC,AAnCD,IAmCC"}

package/lib/AcCmTaskScheduler.d.ts

@@ -1,42 +1,111 @@
+/**
+ * @fileoverview Task scheduling and execution system for the AutoCAD Common library.
+ *
+ * This module provides a type-safe task scheduler that can execute a chain of named tasks
+ * in sequence, with progress reporting, error handling, and data flow between tasks.
+ *
+ * @module AcCmTaskScheduler
+ * @version 1.0.0
+ */
 /**
  * Represents a named unit of work with an asynchronous or synchronous execution function.
- * @template TIn Input type
- * @template TOut Output type
+ *
+ * Tasks can be chained together in a scheduler to create complex workflows with
+ * proper data flow and error handling.
+ *
+ * @template TIn - Input type for the task.
+ * @template TOut - Output type for the task.
+ *
+ * @example
+ * ```typescript
+ * class LoadFileTask extends AcCmTask<string, ArrayBuffer> {
+ *   constructor() {
+ *     super('LoadFile')
+ *   }
+ *
+ *   async run(url: string): Promise<ArrayBuffer> {
+ *     const response = await fetch(url)
+ *     return response.arrayBuffer()
+ *   }
+ * }
+ * ```
  */
 export declare class AcCmTask<TIn, TOut> {
     /**
      * Name of the task (for logging/debugging purposes)
      */
     readonly name: string;
+    /**
+     * Creates a new task with the specified name.
+     *
+     * @param {string} name - The name identifier for this task.
+     */
     constructor(name: string);
     /**
-     * Executes the task.
+     * Executes the task with the given input.
+     *
+     * This method must be implemented by subclasses to define the actual work
+     * performed by the task. Can return either a synchronous result or a Promise.
+     *
+     * @param {TIn} _input - The input data for the task.
+     * @returns {TOut | Promise<TOut>} The task result, either synchronous or asynchronous.
+     * @throws {Error} When the method is not implemented by a subclass.
      */
     run(_input: TIn): TOut | Promise<TOut>;
 }
 /**
- * Reports progress after a task completes.
- * @param progress A number between 0 and 1 indicating task completion
- * @param task The task that was just completed
+ * Callback function that reports progress after a task completes.
+ *
+ * @param {number} progress - A number between 0 and 1 indicating task completion.
+ * @param {AcCmTask<unknown, unknown>} task - The task that was just completed.
  */
 type AcCmProgressCallback = (progress: number, task: AcCmTask<unknown, unknown>) => void;
 /**
- * Callback function to handle final output.
+ * Callback function to handle the final output after all tasks complete successfully.
+ *
+ * @template T - The type of the final result.
+ * @param {T} finalResult - The final result from the task chain.
  */
 export type AcCmCompleteCallback<T> = (finalResult: T) => void;
 /**
- * Handles errors during task execution.
- * @param error The error thrown
- * @param taskIndex Index of the failed task
- * @param task The task that failed
+ * Callback function that handles errors during task execution.
+ *
+ * @param {unknown} error - The error that was thrown.
+ * @param {number} taskIndex - Index of the failed task in the task queue.
+ * @param {AcCmTask<unknown, unknown>} task - The task that failed.
  */
 type AcCmErrorCallback = (error: unknown, taskIndex: number, task: AcCmTask<unknown, unknown>) => void;
 /**
- * Type-safe task scheduler that executes a chain of named tasks in order,
- * passing results between them and stopping on the first failure.
+ * Type-safe task scheduler that executes a chain of named tasks in order.
+ *
+ * The scheduler passes results between tasks, reports progress, and stops
+ * execution on the first failure. Supports both synchronous and asynchronous tasks.
+ *
+ * @template TInitial - Initial input type for the first task.
+ * @template TFinal - Final output type from the last task.
+ *
+ * @example
+ * ```typescript
+ * // Create scheduler with string input and object output
+ * const scheduler = new AcCmTaskScheduler<string, ParsedData>()
+ *
+ * // Add tasks
+ * scheduler.addTask(new LoadFileTask())
+ * scheduler.addTask(new ParseDataTask())
+ * scheduler.addTask(new ValidateDataTask())
+ *
+ * // Set callbacks
+ * scheduler.setProgressCallback((progress, task) => {
+ *   console.log(`${task.name}: ${(progress * 100).toFixed(1)}%`)
+ * })
+ *
+ * scheduler.setCompleteCallback((result) => {
+ *   console.log('All tasks completed:', result)
+ * })
  *
- * @template TInitial Initial input type
- * @template TFinal Final output type
+ * // Execute
+ * await scheduler.execute('file.dwg')
+ * ```
  */
 export declare class AcCmTaskScheduler<TInitial, TFinal = TInitial> {
     private tasks;

package/lib/AcCmTaskScheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcCmTaskScheduler.d.ts","sourceRoot":"","sources":["../src/AcCmTaskScheduler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,QAAQ,CAAC,GAAG,EAAE,IAAI;IAC7B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,IAAI,EAAE,MAAM;IAIxB;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAGvC;AAED;;;;GAIG;AACH,KAAK,oBAAoB,GAAG,CAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,KAC7B,IAAI,CAAA;AAET;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,IAAI,CAAA;AAE9D;;;;;GAKG;AACH,KAAK,iBAAiB,GAAG,CACvB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,KAC7B,IAAI,CAAA;AAET;;;;;;GAMG;AACH,qBAAa,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ;IACxD,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,UAAU,CAAyC;IAC3D,OAAO,CAAC,OAAO,CAA8B;IAE7C;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI;IAInD;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIzD;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,CAAC,MAAM,CAAC,GAAG,IAAI;IAIjE;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAInD;;OAEG;IACG,GAAG,CAAC,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CA2BhD"}
+{"version":3,"file":"AcCmTaskScheduler.d.ts","sourceRoot":"","sources":["../src/AcCmTaskScheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,QAAQ,CAAC,GAAG,EAAE,IAAI;IAC7B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;;OAIG;gBACS,IAAI,EAAE,MAAM;IAIxB;;;;;;;;;OASG;IACH,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAGvC;AAED;;;;;GAKG;AACH,KAAK,oBAAoB,GAAG,CAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,KAC7B,IAAI,CAAA;AAET;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,IAAI,CAAA;AAE9D;;;;;;GAMG;AACH,KAAK,iBAAiB,GAAG,CACvB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,KAC7B,IAAI,CAAA;AAET;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ;IACxD,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,UAAU,CAAyC;IAC3D,OAAO,CAAC,OAAO,CAA8B;IAE7C;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI;IAInD;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIzD;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,CAAC,MAAM,CAAC,GAAG,IAAI;IAIjE;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAInD;;OAEG;IACG,GAAG,CAAC,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CA2BhD"}