@bitbeater/ecma-utils 2.7.0

package/dist/time.d.ts

@@ -0,0 +1,189 @@
+export declare const MAX_JS_DATE = 8640000000000000;
+/** in millis */
+export declare const millis = 1;
+/** in millis */
+export declare const second: number;
+/** in millis */
+export declare const minute: number;
+/** in millis */
+export declare const hour: number;
+/** in millis */
+export declare const day: number;
+/** in millis */
+export declare const week: number;
+/**
+ * In millis
+ * The average month is 365/12 = 30.42 days in a regular year and 366/12 = 30.50 days in a leap year. The Gregorian (western) solar calendar has 365.2425/12 = 30.436875 days on the average, varying between 28 and 31 days.
+ */
+export declare const solarYear: number;
+/** in millis */
+export declare const month: number;
+/** in millis */
+export declare const year: number;
+/** 366 days */
+export declare const leapYear: number;
+/** 29 days */
+export declare const leapFebruary: number;
+/** in millis */
+export declare const january: number;
+/** in millis */
+export declare const february: number;
+/** in millis */
+export declare const march: number;
+/** in millis */
+export declare const april: number;
+/** in millis */
+export declare const may: number;
+/** in millis */
+export declare const june: number;
+/** in millis */
+export declare const july: number;
+/** in millis */
+export declare const august: number;
+/** in millis */
+export declare const september: number;
+/** in millis */
+export declare const october: number;
+/** in millis */
+export declare const november: number;
+/** in millis */
+export declare const december: number;
+export declare const months: number[];
+export declare const leapMonths: number[];
+export interface Duration {
+    years?: number;
+    months?: number;
+    weeks?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+    milliseconds?: number;
+}
+export interface Interval {
+    start?: Date;
+    end?: Date;
+}
+/**
+ * parse a duration into millisecconds
+ *
+ * @example
+ * ```js
+ * durationToMilliSeconds({seconds:1}) // => 1000
+ * durationToMilliSeconds({minutes:1}) // => 60_000
+ * durationToMilliSeconds({hours:1}) // => 3_600_000
+ * durationToMilliSeconds({minutes:1,seconds:1}) // => 61_000
+ * durationToMilliSeconds({hours:1,minutes:1,seconds:1}) // => 3_661_000
+ * ```
+ */
+export declare function durationToMilliSeconds(duration: Duration): number;
+export declare function millisecondsToDuration(millis: number): Duration;
+/**
+ * parse a duration into millisecconds
+ *
+ * @example
+ * ```js
+ * durationToMilliSeconds({seconds:1}) // => 1
+ * durationToMilliSeconds({minutes:1}) // => 60
+ * durationToMilliSeconds({hours:1}) // => 3_600
+ * durationToMilliSeconds({minutes:1,seconds:1}) // => 61
+ * durationToMilliSeconds({hours:1,minutes:1,seconds:1}) // => 3_661
+ * ```
+ */
+export declare function durationToSeconds(duration: Duration): number;
+/**
+ * check if the duration is larger than the interval
+ */
+export declare function isDurationBiggerThanInterval(interval: Interval, duration: Duration): boolean;
+/**
+ * divide the given interval into smaller intervals, each having the duration equal to the given duration
+ *
+ * @example
+ * ```js
+ * const start=new Date('2000-01-01');
+ * const end=new Date('2000-01-10');
+ *
+ * splitIntervalByDuration({start, end},{days:1});
+ * // [
+ * //   {start:2000-01-01, end:2000-01-02},
+ * //   {start:2000-01-02, end:2000-01-03},
+ * //   {start:2000-01-03, end:2000-01-04},
+ * //   {start:2000-01-04, end:2000-01-05},
+ * //   {start:2000-01-05, end:2000-01-06},
+ * //   {start:2000-01-06, end:2000-01-07},
+ * //   {start:2000-01-07, end:2000-01-08},
+ * //   {start:2000-01-08, end:2000-01-09},
+ * //   {start:2000-01-09, end:2000-01-10},
+ * // ]
+ * ```
+ */
+export declare function splitIntervalByDuration(interval: Interval, duration: Duration): Interval[];
+/**
+ * multiply the given duration
+ *
+ * @example
+ * ```js
+ * const duration={moths:2, days:3, hours:4};
+ *
+ * multiplyDuration(duration:Duration,multiplier:number) // => {moths:4, days:6, hours:8}
+ * ```
+ */
+export declare function multiplyDuration(duration: Duration, multiplier: number): Duration;
+/**
+ * add the given durations
+ *
+ * @example
+ * ```js
+ * const duration1={moths:2, days:3, hours:4};
+ * const duration2={moths:2, days:3, hours:4};
+ * const duration3={moths:2, days:3, hours:4};
+ *
+ * addDurations(duration1,duration2,duration3) // => {moths:6, days:9, hours:12}
+ * ```
+ */
+export declare function addDurations(...durations: Duration[]): Duration;
+export declare function isValidDate(value: any): value is Date;
+/**
+ * Format a date into sql datetime value
+ * @param date
+ * @returns
+ *  * @example
+ * ```js
+ * const date = new Date();
+ * toSqlDate() // => "2017-06-29 17:54:04"
+ *
+ */
+export declare function toSqlDate(date: Date): string;
+/**
+ * Convert an interval to a duration
+ * @param interval
+ * @returns
+ *
+ * @example
+ * ```ts
+ * const interval = { start: new Date('2000-01-01'), end: new Date('2000-01-10') };
+ * const duration = IntervalToDuration(interval);
+ * // { years: 0, months: 0, weeks: 0, days: 9, hours: 0, minutes: 0, seconds: 0, milliseconds: 0 }
+ * ```
+ */
+export declare function intervalToDuration(interval: Interval): Duration;
+/**
+ * Humanize a duration object into a human-readable string.
+ * @example
+ * ```js
+ * const duration = { years: 1, months: 2, days: 3, hours: 4, minutes: 5, seconds: 6 };
+ * humanizeDuration(duration) // => "1 year, 2 months, 3 days, 4 hours, 5 minutes and 6 seconds"
+ * ```
+ *  * @example
+ * ```js
+ * const duration = { seconds: 4000 };
+ * humanizeDuration(duration) // => "1 hour, 6 minutes and 40 seconds"
+ * ```
+ * @param inDuration
+ * @param options
+ * @returns
+ */
+export declare function humanizeDuration(inDuration: Duration, options?: {
+    reduce?: boolean;
+}): string;
+//# sourceMappingURL=time.d.ts.map

package/dist/time.d.ts.map

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

package/dist/time.js

@@ -0,0 +1,308 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.leapMonths = exports.months = exports.december = exports.november = exports.october = exports.september = exports.august = exports.july = exports.june = exports.may = exports.april = exports.march = exports.february = exports.january = exports.leapFebruary = exports.leapYear = exports.year = exports.month = exports.solarYear = exports.week = exports.day = exports.hour = exports.minute = exports.second = exports.millis = exports.MAX_JS_DATE = void 0;
+exports.durationToMilliSeconds = durationToMilliSeconds;
+exports.millisecondsToDuration = millisecondsToDuration;
+exports.durationToSeconds = durationToSeconds;
+exports.isDurationBiggerThanInterval = isDurationBiggerThanInterval;
+exports.splitIntervalByDuration = splitIntervalByDuration;
+exports.multiplyDuration = multiplyDuration;
+exports.addDurations = addDurations;
+exports.isValidDate = isValidDate;
+exports.toSqlDate = toSqlDate;
+exports.intervalToDuration = intervalToDuration;
+exports.humanizeDuration = humanizeDuration;
+exports.MAX_JS_DATE = 8.64e15; // Sat Sep 13 275760 00:00:00 GMT+0000
+/** in millis */
+exports.millis = 1;
+/** in millis */
+exports.second = 1000 * exports.millis;
+/** in millis */
+exports.minute = 60 * exports.second;
+/** in millis */
+exports.hour = 60 * exports.minute;
+/** in millis */
+exports.day = 24 * exports.hour;
+/** in millis */
+exports.week = 7 * exports.day;
+/**
+ * In millis
+ * The average month is 365/12 = 30.42 days in a regular year and 366/12 = 30.50 days in a leap year. The Gregorian (western) solar calendar has 365.2425/12 = 30.436875 days on the average, varying between 28 and 31 days.
+ */
+exports.solarYear = 365.25 * exports.day;
+/** in millis */
+exports.month = exports.solarYear / 12;
+/** in millis */
+exports.year = 365 * exports.day;
+/** 366 days */
+exports.leapYear = 366 * exports.day;
+/** 29 days */
+exports.leapFebruary = 29 * exports.day;
+/** in millis */
+exports.january = 31 * exports.day;
+/** in millis */
+exports.february = 28 * exports.day;
+/** in millis */
+exports.march = 31 * exports.day;
+/** in millis */
+exports.april = 30 * exports.day;
+/** in millis */
+exports.may = 31 * exports.day;
+/** in millis */
+exports.june = 30 * exports.day;
+/** in millis */
+exports.july = 31 * exports.day;
+/** in millis */
+exports.august = 31 * exports.day;
+/** in millis */
+exports.september = 30 * exports.day;
+/** in millis */
+exports.october = 31 * exports.day;
+/** in millis */
+exports.november = 30 * exports.day;
+/** in millis */
+exports.december = 31 * exports.day;
+exports.months = [exports.january, exports.february, exports.march, exports.april, exports.may, exports.june, exports.july, exports.august, exports.september, exports.october, exports.november, exports.december];
+exports.leapMonths = [exports.january, exports.leapFebruary, exports.march, exports.april, exports.may, exports.june, exports.july, exports.august, exports.september, exports.october, exports.november, exports.december];
+/**
+ * parse a duration into millisecconds
+ *
+ * @example
+ * ```js
+ * durationToMilliSeconds({seconds:1}) // => 1000
+ * durationToMilliSeconds({minutes:1}) // => 60_000
+ * durationToMilliSeconds({hours:1}) // => 3_600_000
+ * durationToMilliSeconds({minutes:1,seconds:1}) // => 61_000
+ * durationToMilliSeconds({hours:1,minutes:1,seconds:1}) // => 3_661_000
+ * ```
+ */
+function durationToMilliSeconds(duration) {
+    return (duration?.years || 0) * exports.year + (duration?.months || 0) * exports.month + (duration?.weeks || 0) * exports.week + (duration?.days || 0) * exports.day + (duration?.hours || 0) * exports.hour + (duration?.minutes || 0) * exports.minute + (duration?.seconds || 0) * exports.second + (duration?.milliseconds || 0) * exports.millis;
+}
+function millisecondsToDuration(millis) {
+    const duration = {};
+    duration.years = Math.floor(millis / exports.year);
+    millis %= exports.year;
+    duration.months = Math.floor(millis / exports.month);
+    millis %= exports.month;
+    duration.weeks = Math.floor(millis / exports.week);
+    millis %= exports.week;
+    duration.days = Math.floor(millis / exports.day);
+    millis %= exports.day;
+    duration.hours = Math.floor(millis / exports.hour);
+    millis %= exports.hour;
+    duration.minutes = Math.floor(millis / exports.minute);
+    millis %= exports.minute;
+    duration.seconds = Math.floor(millis / exports.second);
+    millis %= exports.second;
+    duration.milliseconds = millis;
+    return duration;
+}
+/**
+ * parse a duration into millisecconds
+ *
+ * @example
+ * ```js
+ * durationToMilliSeconds({seconds:1}) // => 1
+ * durationToMilliSeconds({minutes:1}) // => 60
+ * durationToMilliSeconds({hours:1}) // => 3_600
+ * durationToMilliSeconds({minutes:1,seconds:1}) // => 61
+ * durationToMilliSeconds({hours:1,minutes:1,seconds:1}) // => 3_661
+ * ```
+ */
+function durationToSeconds(duration) {
+    return durationToMilliSeconds(duration) / exports.second;
+}
+/**
+ * check if the duration is larger than the interval
+ */
+function isDurationBiggerThanInterval(interval, duration) {
+    const intervalSeconds = Math.abs(interval.end.getTime() - interval.start.getTime()) / 1000;
+    const durationSeconds = durationToSeconds(duration);
+    return durationSeconds > intervalSeconds;
+}
+/**
+ * divide the given interval into smaller intervals, each having the duration equal to the given duration
+ *
+ * @example
+ * ```js
+ * const start=new Date('2000-01-01');
+ * const end=new Date('2000-01-10');
+ *
+ * splitIntervalByDuration({start, end},{days:1});
+ * // [
+ * //   {start:2000-01-01, end:2000-01-02},
+ * //   {start:2000-01-02, end:2000-01-03},
+ * //   {start:2000-01-03, end:2000-01-04},
+ * //   {start:2000-01-04, end:2000-01-05},
+ * //   {start:2000-01-05, end:2000-01-06},
+ * //   {start:2000-01-06, end:2000-01-07},
+ * //   {start:2000-01-07, end:2000-01-08},
+ * //   {start:2000-01-08, end:2000-01-09},
+ * //   {start:2000-01-09, end:2000-01-10},
+ * // ]
+ * ```
+ */
+function splitIntervalByDuration(interval, duration) {
+    if (!interval?.start || !interval?.end)
+        return;
+    if (isDurationBiggerThanInterval(interval, duration))
+        return [interval];
+    const intervals = [];
+    var start = interval.start;
+    while (start < interval.end) {
+        let end = new Date(start.getTime() + durationToMilliSeconds(duration));
+        if (end > interval.end)
+            end = interval.end;
+        intervals.push({ start, end });
+        start = end;
+    }
+    return intervals;
+}
+/**
+ * multiply the given duration
+ *
+ * @example
+ * ```js
+ * const duration={moths:2, days:3, hours:4};
+ *
+ * multiplyDuration(duration:Duration,multiplier:number) // => {moths:4, days:6, hours:8}
+ * ```
+ */
+function multiplyDuration(duration, multiplier) {
+    return {
+        years: duration.years * multiplier,
+        months: duration.months * multiplier,
+        weeks: duration.weeks * multiplier,
+        days: duration.days * multiplier,
+        hours: duration.hours * multiplier,
+        minutes: duration.minutes * multiplier,
+        seconds: duration.seconds * multiplier,
+    };
+}
+/**
+ * add the given durations
+ *
+ * @example
+ * ```js
+ * const duration1={moths:2, days:3, hours:4};
+ * const duration2={moths:2, days:3, hours:4};
+ * const duration3={moths:2, days:3, hours:4};
+ *
+ * addDurations(duration1,duration2,duration3) // => {moths:6, days:9, hours:12}
+ * ```
+ */
+function addDurations(...durations) {
+    const retval = {
+        years: 0,
+        months: 0,
+        weeks: 0,
+        days: 0,
+        hours: 0,
+        minutes: 0,
+        seconds: 0,
+    };
+    for (const duration of durations) {
+        retval.years += duration.years || 0;
+        retval.months += duration.months || 0;
+        retval.weeks += duration.weeks || 0;
+        retval.days += duration.days || 0;
+        retval.hours += duration.hours || 0;
+        retval.minutes += duration.minutes || 0;
+        retval.seconds += duration.seconds || 0;
+    }
+    return retval;
+}
+function isValidDate(value) {
+    return value instanceof Date && !isNaN(value.valueOf());
+}
+/**
+ * Format a date into sql datetime value
+ * @param date
+ * @returns
+ *  * @example
+ * ```js
+ * const date = new Date();
+ * toSqlDate() // => "2017-06-29 17:54:04"
+ *
+ */
+function toSqlDate(date) {
+    return date.toISOString().slice(0, 19).replace('T', ' ');
+}
+/**
+ * Convert an interval to a duration
+ * @param interval
+ * @returns
+ *
+ * @example
+ * ```ts
+ * const interval = { start: new Date('2000-01-01'), end: new Date('2000-01-10') };
+ * const duration = IntervalToDuration(interval);
+ * // { years: 0, months: 0, weeks: 0, days: 9, hours: 0, minutes: 0, seconds: 0, milliseconds: 0 }
+ * ```
+ */
+function intervalToDuration(interval) {
+    if (interval.end === undefined) {
+        throw new Error('Invalid interval, end date is missing: ' + JSON.stringify(interval));
+    }
+    if (interval.start === undefined) {
+        throw new Error('Invalid interval, start date is missing: ' + JSON.stringify(interval));
+    }
+    const start = interval.start.getTime();
+    const end = interval.end.getTime();
+    if (start > end) {
+        throw new Error('Invalid interval, end date is before start date: ' + JSON.stringify(interval));
+    }
+    let durationInMs = end - start;
+    const duration = millisecondsToDuration(durationInMs);
+    return duration;
+}
+/**
+ * Humanize a duration object into a human-readable string.
+ * @example
+ * ```js
+ * const duration = { years: 1, months: 2, days: 3, hours: 4, minutes: 5, seconds: 6 };
+ * humanizeDuration(duration) // => "1 year, 2 months, 3 days, 4 hours, 5 minutes and 6 seconds"
+ * ```
+ *  * @example
+ * ```js
+ * const duration = { seconds: 4000 };
+ * humanizeDuration(duration) // => "1 hour, 6 minutes and 40 seconds"
+ * ```
+ * @param inDuration
+ * @param options
+ * @returns
+ */
+function humanizeDuration(inDuration, options) {
+    let duration = { ...inDuration };
+    if (options?.reduce) {
+        duration = millisecondsToDuration(durationToMilliSeconds(duration));
+    }
+    const parts = [];
+    if (duration.years)
+        parts.push(`${duration.years} year${duration.years > 1 ? 's' : ''}`);
+    if (duration.months)
+        parts.push(`${duration.months} month${duration.months > 1 ? 's' : ''}`);
+    if (duration.weeks)
+        parts.push(`${duration.weeks} week${duration.weeks > 1 ? 's' : ''}`);
+    if (duration.days)
+        parts.push(`${duration.days} day${duration.days > 1 ? 's' : ''}`);
+    if (duration.hours)
+        parts.push(`${duration.hours} hour${duration.hours > 1 ? 's' : ''}`);
+    if (duration.minutes)
+        parts.push(`${duration.minutes} minute${duration.minutes > 1 ? 's' : ''}`);
+    if (duration.seconds)
+        parts.push(`${duration.seconds} second${duration.seconds > 1 ? 's' : ''}`);
+    if (duration.milliseconds)
+        parts.push(`${duration.milliseconds} millisecond${duration.milliseconds > 1 ? 's' : ''}`);
+    // handle singular case
+    if (parts.length === 1) {
+        return parts[0];
+    }
+    if (parts.length === 0) {
+        return '0 milliseconds';
+    }
+    const last = parts.pop();
+    return parts.join(', ') + ' and ' + last;
+}
+//# sourceMappingURL=time.js.map

package/dist/time.js.map

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

package/dist/utils/task_duration_tracker.d.ts

@@ -0,0 +1,102 @@
+import { Interval, Duration } from '../time/time';
+/**
+ * @description A utility class to track the duration of multiple tasks and estimate completion times.
+ * - It records the start and end times of each task, calculates elapsed time, estimates remaining time,
+ * - and provides the expected finish time based on the average duration of completed tasks.
+ *
+ * @example
+ * ```ts
+ * // let's assume the date is Jan 1, 2000, 00:00:00
+ * const tracker = new TaskDurationTracker(5); // Initialize tracker for 5 tasks
+ *
+ * for (let i = 0; i < 5; i++) {
+ *   performTask(i); // Lets assume it takes 1 second to perform a task
+ *   tracker.recordTaskEnd(); // Record the end of the task
+ *
+ *   console.log(`Completed ${tracker.getCompletedTasks()} out of ${tracker.tasksCount} tasks.`);
+ *   console.log(`Elapsed Time: ${tracker.getElapsedTime().milliseconds} ms`);
+ *   console.log(`Estimated Completion Time: ${tracker.getEstimatedCompletionTime().milliseconds} ms`);
+ *   console.log(`Expected Finish Time: ${tracker.getExpectedFinishTime()}`);
+ *
+ * }
+ *  // OUTPUT:
+ * // Completed 1 out of 5 tasks.
+ * // Elapsed Time: 1000 ms
+ * // Estimated Completion Time: 4000 ms
+ * // Expected Finish Time: Jan 1, 2000, 00:00:05
+ *
+ * // Completed 2 out of 5 tasks.
+ * // Elapsed Time: 2000 ms
+ * // Estimated Completion Time: 3000 ms
+ * // Expected Finish Time: Jan 1, 2000, 00:00:05
+ *
+ * // Completed 3 out of 5 tasks.
+ * // Elapsed Time: 3000 ms
+ * // Estimated Completion Time: 2000 ms
+ * // Expected Finish Time: Jan 1, 2000, 00:00:05
+ *
+ * // Completed 4 out of 5 tasks.
+ * // Elapsed Time: 4000 ms
+ * // Estimated Completion Time: 1000 ms
+ * // Expected Finish Time: Jan 1, 2000, 00:00:05
+ *
+ * // Completed 5 out of 5 tasks.
+ * // Elapsed Time: 5000 ms
+ * // Estimated Completion Time: 0 ms
+ * // Expected Finish Time: Jan 1, 2000, 00:00:05
+ * ```
+ *
+ * @see {@link Duration}
+ * @see {@link Interval}
+ */
+export declare class TaskDurationTracker {
+    tasksCount: number;
+    private intervals;
+    private creationTime;
+    constructor(tasksCount: number);
+    /**
+     * @description Gets the total elapsed time since the first task started.
+     * @returns the total elapsed time since the first task started.
+     */
+    getElapsedTime(): Duration;
+    /**
+     * @description Estimates the total time taken to complete all tasks.
+     */
+    getEstimatedCompletionTime(): Duration;
+    /**
+     * @description Gets the expected finish time for all tasks.
+     */
+    getExpectedFinishTime(): Date;
+    /**
+     * @description Gets the number of completed tasks.
+     * @returns the number of completed tasks.
+     */
+    getCompletedTasks(): number;
+    /**
+     * @description Gets the number of remaining tasks.
+     * @returns the number of remaining tasks.
+     */
+    getRemainingTasks(): number;
+    /**
+     * @description Gets the mean time taken per task.
+     * @returns the mean time taken per task.
+     */
+    getMeanTimePerTask(): Duration;
+    /**
+     * @description Adds a task interval to the tracker.
+     * @param interval The interval of the task to add.
+     */
+    addCompletedTask(interval: Interval): void;
+    /**
+     * @description Gets the start time of the first task, or the creation time if no tasks have been started.
+     * @returns the start time of the first task, or the creation time if no tasks have been started.
+     */
+    getStartTime(): Date;
+    /**
+     * @description Marks the current task as completed,
+     * - the start time is either the end time of the last task or the TaskDurationTracker creation time,
+     * - the end time is the current time.
+     */
+    recordTaskEnd(): void;
+}
+//# sourceMappingURL=task_duration_tracker.d.ts.map

package/dist/utils/task_duration_tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task_duration_tracker.d.ts","sourceRoot":"","sources":["../../src/utils/task_duration_tracker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAkD,MAAM,cAAc,CAAC;AAElG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,qBAAa,mBAAmB;IAIZ,UAAU,EAAE,MAAM;IAHrC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,YAAY,CAAc;gBAEf,UAAU,EAAE,MAAM;IAErC;;;OAGG;IACH,cAAc,IAAI,QAAQ;IAK1B;;OAEG;IACH,0BAA0B,IAAI,QAAQ;IAOtC;;OAEG;IACH,qBAAqB,IAAI,IAAI;IAK7B;;;OAGG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;;OAGG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;;OAGG;IACH,kBAAkB,IAAI,QAAQ;IAe9B;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAI1C;;;OAGG;IACH,YAAY,IAAI,IAAI;IAIpB;;;;OAIG;IACH,aAAa,IAAI,IAAI;CAMrB"}