edfcore 0.1.0

package/dist/header/dates.js

@@ -0,0 +1,378 @@
+/**
+ * Every date rule in EDF, in one place.
+ *
+ * Layer 2. Sole owner of: the `dd.mm.yy` header startdate, the `hh.mm.ss` clock, the
+ * `dd-MMM-yyyy` subfield date used by the patient birthdate and the recording-identification
+ * `Startdate`, the 1985-2084 two-digit-year rule, the literal `'yy'` post-2084 escape, and the
+ * resolution between the two dates a file can carry.
+ *
+ * A JavaScript `Date` is never constructed. EDF stores local time at the patient with no
+ * timezone, so a `Date` would silently apply the reader's zone — worst exactly at DST
+ * boundaries — and `lib: ["ES2022"]` gives us no reason to reach for one anyway. Month lengths
+ * and leap years are arithmetic, and `'31.02.99'` must never quietly become 3 March.
+ *
+ * Separators and stray spaces are tolerated (`' 2. 8.51'` is in the EDF FAQ). A tolerated
+ * deviation is reported through `conformant` on the parse result rather than as a diagnostic:
+ * the vocabulary in `diagnostics/codes.ts` has no code for a date that parsed but was written
+ * oddly, and inventing one is not this module's call.
+ */
+import { trimEdfField } from '../bytes/latin1.js';
+import { HEADER_FIELDS } from '../constants.js';
+const MONTH_ABBREVIATIONS = [
+    'JAN',
+    'FEB',
+    'MAR',
+    'APR',
+    'MAY',
+    'JUN',
+    'JUL',
+    'AUG',
+    'SEP',
+    'OCT',
+    'NOV',
+    'DEC',
+];
+const DAYS_IN_MONTH = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+const MONTHS_PER_YEAR = 12;
+const FEBRUARY = 2;
+const LEAP_FEBRUARY_DAYS = 29;
+const MAX_HOUR = 23;
+const MAX_MINUTE = 59;
+/** No leap seconds: EDF has no field that could express one, and none is expected. */
+const MAX_SECOND = 59;
+const SECONDS_PER_MINUTE = 60;
+const SECONDS_PER_HOUR = 3600;
+/** 85..99 mean 1985..1999; 00..84 mean 2000..2084. The escape past 2084 is a literal `'yy'`. */
+const TWO_DIGIT_YEAR_PIVOT = 85;
+const TWENTIETH_CENTURY = 1900;
+const TWENTY_FIRST_CENTURY = 2000;
+const DIGIT_ZERO = 0x30;
+const DIGIT_NINE = 0x39;
+/** `'.'`, `':'`, `'-'`, `'/'` and stray spaces all occur in the wild. */
+const DATE_FIELD_SEPARATORS = /[\s.:/-]+/;
+/** Exactly `dd.mm.yy`, including the post-2084 escape in the year position. */
+const CONFORMANT_HEADER_DATE = /^\d{2}\.\d{2}\.(?:\d{2}|yy)$/;
+/** Exactly `hh.mm.ss`. */
+const CONFORMANT_HEADER_TIME = /^\d{2}\.\d{2}\.\d{2}$/;
+/** Exactly `dd-MMM-yyyy`: zero-padded day, uppercase English month, four-digit year. */
+const CONFORMANT_SUBFIELD_DATE = /^\d{2}-[A-Z]{3}-\d{4}$/;
+const YEAR_ESCAPE = /^yy$/i;
+const MIDNIGHT = { hour: 0, minute: 0, second: 0 };
+export function isLeapYear(year) {
+    return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+}
+export function daysInMonth(year, month) {
+    if (month === FEBRUARY && isLeapYear(year))
+        return LEAP_FEBRUARY_DAYS;
+    return DAYS_IN_MONTH[month - 1] ?? 0;
+}
+/** The longest that month can ever be, for validating a day whose year is not yet known. */
+function maxDaysInMonth(month) {
+    if (month === FEBRUARY)
+        return LEAP_FEBRUARY_DAYS;
+    return DAYS_IN_MONTH[month - 1] ?? 0;
+}
+export function isValidCalendarDate(date) {
+    if (!Number.isInteger(date.year) || date.year < 1 || date.year > 9999)
+        return false;
+    if (!Number.isInteger(date.month) || date.month < 1 || date.month > MONTHS_PER_YEAR)
+        return false;
+    if (!Number.isInteger(date.day) || date.day < 1)
+        return false;
+    return date.day <= daysInMonth(date.year, date.month);
+}
+export function calendarDatesEqual(a, b) {
+    return a.year === b.year && a.month === b.month && a.day === b.day;
+}
+/** `'1951-08-02'`. Used in diagnostic messages and by `formatStartTimeNaive`. */
+export function formatCalendarDate(date) {
+    return `${pad(date.year, 4)}-${pad(date.month, 2)}-${pad(date.day, 2)}`;
+}
+/** `'09:00:00'`. */
+export function formatClockTime(clock) {
+    return `${pad(clock.hour, 2)}:${pad(clock.minute, 2)}:${pad(clock.second, 2)}`;
+}
+function pad(value, width) {
+    return String(value).padStart(width, '0');
+}
+/** All digits, `maxLength` of them at most, no sign and no separators. */
+function parseDigits(text, maxLength) {
+    if (text.length === 0 || text.length > maxLength)
+        return undefined;
+    for (let i = 0; i < text.length; i++) {
+        const code = text.charCodeAt(i);
+        if (code < DIGIT_ZERO || code > DIGIT_NINE)
+            return undefined;
+    }
+    return Number(text);
+}
+/**
+ * Split a date or time field into exactly three parts, tolerating any of the separators real
+ * writers emit and any amount of stray space. Returns `undefined` when there are not three.
+ */
+function threeFields(text) {
+    const parts = trimEdfField(text)
+        .split(DATE_FIELD_SEPARATORS)
+        .filter((part) => part.length > 0);
+    if (parts.length !== 3)
+        return undefined;
+    const first = parts[0];
+    const second = parts[1];
+    const third = parts[2];
+    if (first === undefined || second === undefined || third === undefined)
+        return undefined;
+    return [first, second, third];
+}
+export function resolveTwoDigitYear(twoDigitYear) {
+    return twoDigitYear >= TWO_DIGIT_YEAR_PIVOT
+        ? TWENTIETH_CENTURY + twoDigitYear
+        : TWENTY_FIRST_CENTURY + twoDigitYear;
+}
+function unparseableDate(raw, conformant) {
+    return {
+        status: 'unparseable',
+        date: undefined,
+        day: undefined,
+        month: undefined,
+        clippedYear: false,
+        conformant,
+        raw,
+    };
+}
+/**
+ * The `dd.mm.yy` startdate at offset 168.
+ *
+ * A four-digit year is accepted where it fits (`'2.8.1951'`), because a writer that spells the
+ * year out is unambiguous and the two-digit rule would be a downgrade. Three digits are
+ * corruption, not a convention, and are refused.
+ */
+export function parseHeaderStartDate(raw) {
+    const conformant = CONFORMANT_HEADER_DATE.test(raw);
+    const fields = threeFields(raw);
+    if (fields === undefined)
+        return unparseableDate(raw, conformant);
+    const [dayText, monthText, yearText] = fields;
+    const day = parseDigits(dayText, 2);
+    const month = parseDigits(monthText, 2);
+    if (day === undefined || month === undefined)
+        return unparseableDate(raw, conformant);
+    if (month < 1 || month > MONTHS_PER_YEAR)
+        return unparseableDate(raw, conformant);
+    if (YEAR_ESCAPE.test(yearText)) {
+        // The year is genuinely unknown here, so the day can only be checked against the longest
+        // that month ever gets; the real year re-checks it in `resolveStartTime`.
+        if (day < 1 || day > maxDaysInMonth(month))
+            return unparseableDate(raw, conformant);
+        return {
+            status: 'yearEscape',
+            date: undefined,
+            day,
+            month,
+            clippedYear: false,
+            conformant,
+            raw,
+        };
+    }
+    const yearDigits = parseDigits(yearText, 4);
+    if (yearDigits === undefined)
+        return unparseableDate(raw, conformant);
+    if (yearText.length === 3)
+        return unparseableDate(raw, conformant);
+    const clippedYear = yearText.length <= 2;
+    const year = clippedYear ? resolveTwoDigitYear(yearDigits) : yearDigits;
+    const date = { year, month, day };
+    if (!isValidCalendarDate(date))
+        return unparseableDate(raw, conformant);
+    return { status: 'parsed', date, day, month, clippedYear, conformant, raw };
+}
+/** The `hh.mm.ss` starttime at offset 176. Whole seconds only — EDF has no finer field. */
+export function parseHeaderStartTime(raw) {
+    const conformant = CONFORMANT_HEADER_TIME.test(raw);
+    const fields = threeFields(raw);
+    if (fields === undefined)
+        return { clock: undefined, conformant, raw };
+    const [hourText, minuteText, secondText] = fields;
+    const hour = parseDigits(hourText, 2);
+    const minute = parseDigits(minuteText, 2);
+    const second = parseDigits(secondText, 2);
+    if (hour === undefined || minute === undefined || second === undefined) {
+        return { clock: undefined, conformant, raw };
+    }
+    if (hour > MAX_HOUR || minute > MAX_MINUTE || second > MAX_SECOND) {
+        return { clock: undefined, conformant, raw };
+    }
+    return { clock: { hour, minute, second }, conformant, raw };
+}
+/**
+ * The `dd-MMM-yyyy` subfield date — `'02-AUG-1951'` — used by the patient birthdate and the
+ * recording-identification `Startdate`.
+ *
+ * The month is accepted case-insensitively and a two-digit numeric month is accepted too, both
+ * marked non-conformant. The year must be four digits: this field exists precisely to be
+ * unambiguous, so applying the two-digit rule to it would throw away the one thing it is for.
+ */
+export function parseSubfieldDate(text) {
+    const fields = threeFields(text);
+    if (fields === undefined)
+        return { date: undefined, conformant: false };
+    const [dayText, monthText, yearText] = fields;
+    const day = parseDigits(dayText, 2);
+    const year = parseDigits(yearText, 4);
+    if (day === undefined || year === undefined || yearText.length !== 4) {
+        return { date: undefined, conformant: false };
+    }
+    const namedMonth = MONTH_ABBREVIATIONS.indexOf(monthText.toUpperCase()) + 1;
+    const month = namedMonth > 0 ? namedMonth : parseDigits(monthText, 2);
+    if (month === undefined || month < 1 || month > MONTHS_PER_YEAR) {
+        return { date: undefined, conformant: false };
+    }
+    const date = { year, month, day };
+    if (!isValidCalendarDate(date))
+        return { date: undefined, conformant: false };
+    return { date, conformant: CONFORMANT_SUBFIELD_DATE.test(text) && namedMonth > 0 };
+}
+/**
+ * Build the whole `EdfStartTime`, including the cross-field resolution.
+ *
+ * The recording-identification date wins when both exist, because its year is unambiguous —
+ * but a disagreement is always reported and both dates stay on the result, so no winner is
+ * picked silently. `dateSource` says which one `resolvedDate` came from.
+ */
+export function resolveStartTime(input, sink) {
+    const dateParse = parseHeaderStartDate(input.rawStartDate);
+    const timeParse = parseHeaderStartTime(input.rawStartTime);
+    const recordingIdDate = input.recordingIdDate;
+    const dateOffset = HEADER_FIELDS.startDate.offset;
+    if (dateParse.status === 'unparseable') {
+        sink.report({
+            code: 'DATE_UNPARSEABLE',
+            message: `startdate field (8 bytes at offset ${dateOffset}) is ` +
+                `${JSON.stringify(dateParse.raw)}, which is not a real date in dd.mm.yy form: the ` +
+                'day must exist in that month of that year, and the month must be 01..12. EDF ' +
+                'specification, header record bytes 168-175. Next: header.raw.startDate keeps the ' +
+                'text verbatim, and startTime.recordingIdDate is used instead when the EDF+ ' +
+                'recording identification carries a Startdate.',
+            field: 'startDate',
+            byteOffset: dateOffset,
+            byteLength: HEADER_FIELDS.startDate.length,
+            raw: dateParse.raw,
+            expected: 'dd.mm.yy',
+            actual: trimEdfField(dateParse.raw),
+            specReference: 'EDF specification, header record bytes 168-175',
+        });
+    }
+    if (dateParse.clippedYear && dateParse.date !== undefined) {
+        sink.report({
+            code: 'DATE_CLIPPED_TO_1985_2084',
+            message: `startdate field (8 bytes at offset ${dateOffset}) is ` +
+                `${JSON.stringify(dateParse.raw)}: its two-digit year was resolved to ` +
+                `${dateParse.date.year} by the EDF+ rule that 85..99 mean 1985..1999 and 00..84 mean ` +
+                '2000..2084, so the field cannot express a year outside that span. EDF+ additional ' +
+                'specification 2 (1985 is the clipping date). Next: for an unambiguous year read ' +
+                'startTime.recordingIdDate, which the EDF+ recording identification spells out in ' +
+                'four digits.',
+            field: 'startDate',
+            byteOffset: dateOffset,
+            byteLength: HEADER_FIELDS.startDate.length,
+            raw: dateParse.raw,
+            expected: '1985..2084',
+            actual: String(dateParse.date.year),
+            specReference: 'EDF+ additional specification 2 (startdate and starttime)',
+        });
+    }
+    if (dateParse.status === 'yearEscape' && recordingIdDate === undefined) {
+        sink.report({
+            code: 'DATE_UNPARSEABLE',
+            message: `startdate field (8 bytes at offset ${dateOffset}) is ` +
+                `${JSON.stringify(dateParse.raw)}: the literal "yy" is the EDF+ escape for a ` +
+                'recording after 2084, and it requires the year to be given by the Startdate ' +
+                'subfield of the recording identification, which this file does not carry. EDF+ ' +
+                'additional specifications 2 and 4. Next: the recording has no resolvable date; ' +
+                'startTime.clock is still valid.',
+            field: 'startDate',
+            byteOffset: dateOffset,
+            byteLength: HEADER_FIELDS.startDate.length,
+            raw: dateParse.raw,
+            expected: 'a Startdate subfield in the local recording identification',
+            actual: trimEdfField(dateParse.raw),
+            specReference: 'EDF+ additional specifications 2 and 4',
+        });
+    }
+    const headerDate = dateParse.date;
+    const disagrees = recordingIdDate !== undefined &&
+        ((headerDate !== undefined && !calendarDatesEqual(headerDate, recordingIdDate)) ||
+            // Under the escape the header still states a day and a month, and they must match.
+            (dateParse.status === 'yearEscape' &&
+                (dateParse.day !== recordingIdDate.day || dateParse.month !== recordingIdDate.month)));
+    if (disagrees && recordingIdDate !== undefined) {
+        const headerText = headerDate === undefined
+            ? `day ${String(dateParse.day)}, month ${String(dateParse.month)}`
+            : formatCalendarDate(headerDate);
+        sink.report({
+            code: 'DATE_FIELDS_DISAGREE',
+            message: `startdate field (8 bytes at offset ${dateOffset}) is ` +
+                `${JSON.stringify(dateParse.raw)}, i.e. ${headerText}, but the Startdate subfield of ` +
+                `the local recording identification says ${formatCalendarDate(recordingIdDate)}. ` +
+                'EDF+ additional specifications 2 and 4 both define the start of the recording, so ' +
+                'the two must name the same day; when only the year differs the usual cause is that ' +
+                'the dd.mm.yy field cannot express a year outside 1985..2084. Next: both are ' +
+                'exposed as ' +
+                'startTime.headerDate and startTime.recordingIdDate and edfcore picks no silent ' +
+                'winner; resolvedDate is the four-digit recording-identification date, and ' +
+                'dateSource says so.',
+            field: 'startDate',
+            byteOffset: dateOffset,
+            byteLength: HEADER_FIELDS.startDate.length,
+            raw: dateParse.raw,
+            expected: formatCalendarDate(recordingIdDate),
+            actual: headerText,
+            specReference: 'EDF+ additional specifications 2 and 4',
+        });
+    }
+    if (timeParse.clock === undefined) {
+        sink.report({
+            code: 'DATE_UNPARSEABLE',
+            message: `starttime field (8 bytes at offset ${HEADER_FIELDS.startTime.offset}) is ` +
+                `${JSON.stringify(timeParse.raw)}, which is not a clock time in hh.mm.ss form with ` +
+                'hour 00..23, minute 00..59 and second 00..59. EDF specification, header record ' +
+                'bytes 176-183. Next: startTime.clock reports 00:00:00 because the type admits no ' +
+                'absent clock; header.raw.startTime keeps the text verbatim, and every sample offset ' +
+                'is relative to the recording start regardless.',
+            field: 'startTime',
+            byteOffset: HEADER_FIELDS.startTime.offset,
+            byteLength: HEADER_FIELDS.startTime.length,
+            raw: timeParse.raw,
+            expected: 'hh.mm.ss',
+            actual: trimEdfField(timeParse.raw),
+            specReference: 'EDF specification, header record bytes 176-183',
+        });
+    }
+    const clock = timeParse.clock ?? MIDNIGHT;
+    const resolvedDate = recordingIdDate ?? headerDate;
+    const dateSource = recordingIdDate !== undefined
+        ? 'recordingIdField'
+        : headerDate !== undefined
+            ? 'headerField'
+            : 'none';
+    return {
+        headerDate,
+        recordingIdDate,
+        resolvedDate,
+        dateSource,
+        clock,
+        secondsSinceMidnight: clock.hour * SECONDS_PER_HOUR + clock.minute * SECONDS_PER_MINUTE + clock.second,
+    };
+}
+/**
+ * `'1951-08-02T09:00:00.000'` — no zone designator, because EDF has no zone.
+ *
+ * The milliseconds are always `.000`: the header stores whole seconds, and the sub-second start
+ * of an EDF+ recording lives in record 0's timekeeping TAL, not here.
+ */
+export function formatStartTimeNaive(startTime) {
+    const date = startTime.resolvedDate;
+    if (date === undefined)
+        return undefined;
+    return `${formatCalendarDate(date)}T${formatClockTime(startTime.clock)}.000`;
+}
+//# sourceMappingURL=dates.js.map

package/dist/header/dates.js.map

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

package/dist/header/fields.d.ts

@@ -0,0 +1,105 @@
+/**
+ * The ten fixed header fields.
+ *
+ * Layer 2. Sole owner of the 256-byte fixed header: where each field lives, what its bytes say
+ * verbatim, and which diagnostic a field that fails its grammar deserves. It owns no ORDER —
+ * `header/parse.ts` decides that and calls the functions here one field at a time, because the
+ * fixed header has to be read in dependency order rather than in file order (the signal count
+ * has to be trusted before the header-size field is worth reading at all).
+ *
+ * Raw first, always: a numeric field that failed to parse is exactly the case where the caller
+ * needs the bytes as written, so every field is exposed as text before it is interpreted.
+ */
+import { type EdfNumberParse } from '../bytes/numbers.js';
+import { HEADER_FIELDS } from '../constants.js';
+import { type DiagnosticSink } from '../diagnostics/collector.js';
+import type { EdfRawHeaderFields } from '../types.js';
+/** The ten fixed fields. Same keys as `EdfRawHeaderFields`, by construction. */
+export type FixedHeaderFieldName = keyof typeof HEADER_FIELDS;
+/** `'EDF specification, header record bytes 236-243'`. */
+export declare function fixedFieldSpecReference(field: FixedHeaderFieldName): string;
+/** `'number of data records (8 bytes at offset 236)'`. */
+export declare function describeFixedField(field: FixedHeaderFieldName): string;
+/** Every fixed field as the text it holds, padding included and nothing interpreted. */
+export declare function readRawHeaderFields(headerBytes: Uint8Array): EdfRawHeaderFields;
+/**
+ * Report `NON_ASCII_HEADER_FIELD` for every fixed text field carrying a byte outside ASCII
+ * 32..126.
+ *
+ * A warning, never more: the field still decodes truthfully, because edfcore reads header text
+ * as ISO-8859-1 — real equipment writes accented patient names and a bare 0xB5 for micro.
+ */
+export declare function reportNonAsciiHeaderFields(headerBytes: Uint8Array, sink: DiagnosticSink): void;
+/**
+ * Everything a numeric-field diagnostic needs that the parse result does not carry.
+ *
+ * Per-signal fields use this too — `header/signals.ts` supplies its own offsets and wording, so
+ * the comma/malformed/justification decision exists in exactly one place.
+ */
+export interface NumericFieldContext {
+    /** Goes on the diagnostic's `field`. */
+    readonly field: string;
+    /** `'number of data records (8 bytes at offset 236)'` — completes the first sentence. */
+    readonly description: string;
+    readonly byteOffset: number;
+    readonly byteLength: number;
+    /** What the grammar wanted: `'a whole number of data records, or -1 when unknown'`. */
+    readonly expected: string;
+    readonly specReference: string;
+    /** The actionable next step, without a trailing full stop. */
+    readonly nextStep: string;
+    readonly signalIndex?: number;
+}
+/**
+ * The value of a field that edfcore cannot proceed without.
+ *
+ * A comma decimal or a failed grammar throws: these fields decide where bytes are and what they
+ * mean, so a wrong reading would be worse than no reading.
+ */
+export declare function requireNumericField(parse: EdfNumberParse, context: NumericFieldContext, sink: DiagnosticSink): number;
+/**
+ * The value of a field edfcore can survive without, or `NaN` when it could not be read.
+ *
+ * Only for the two fields with an authoritative alternative source — the declared header size,
+ * which always loses to the computed one, and the record count, which is recoverable from the
+ * source length. The caller reports what it did instead; a comma decimal is still fatal.
+ */
+export declare function readNumericField(parse: EdfNumberParse, context: NumericFieldContext, sink: DiagnosticSink): number;
+/**
+ * The signal count at offset 252, validated to 1..9999.
+ *
+ * Fatal on anything else, including a comma, and deliberately reported as
+ * `SIGNAL_COUNT_INVALID` rather than as the generic numeric codes: every per-signal field
+ * address is `256 + ns * blockOffset + i * width`, so an unusable ns makes every byte after the
+ * fixed header unlocatable. It is validated before any ns-sized allocation for the same reason.
+ */
+export declare function parseSignalCount(raw: string, sink: DiagnosticSink): number;
+/**
+ * The declared header size at offset 184, checked against the computed `256 * (ns + 1)`.
+ *
+ * The computed value ALWAYS wins, which is what makes this a warning rather than a fatal
+ * numeric field: a value edfcore never uses cannot make it read the wrong bytes. An unreadable
+ * field is reported the same way and returned as `NaN`, so `header.declaredHeaderByteLength`
+ * never claims a size the file did not state.
+ */
+export declare function checkDeclaredHeaderByteLength(raw: string, computedHeaderByteLength: number, sink: DiagnosticSink): number;
+/**
+ * The record duration at offset 244, in seconds.
+ *
+ * May legitimately be 0 — an EDF+ file whose records carry only annotations does exactly that —
+ * and `ZERO_RECORD_DURATION` says so without refusing the file. A NEGATIVE duration is refused:
+ * it is not a tolerable oddity but a value that would make every record onset, sample time and
+ * sample rate derived from it run backwards. So is a POSITIVE duration that no 100 ns tick count
+ * can express, in either direction — see the comment on that check.
+ */
+export declare function parseRecordDuration(raw: string, sink: DiagnosticSink): number;
+/**
+ * The declared record count at offset 236, verbatim.
+ *
+ * `-1` is the sanctioned "the writer never closed the file" value and is returned as `-1`; an
+ * unreadable field is returned as `NaN`. Both mean the same thing to the caller — the count has
+ * to come from the source length instead — and `header/parse.ts` reports which happened, since
+ * only it knows the source length that resolves it.
+ */
+export declare function parseDeclaredRecordCount(raw: string, sink: DiagnosticSink): number;
+//# sourceMappingURL=fields.d.ts.map

package/dist/header/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/header/fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,KAAK,cAAc,EAAmC,MAAM,qBAAqB,CAAC;AAE3F,OAAO,EAAwB,aAAa,EAAoB,MAAM,iBAAiB,CAAC;AACxF,OAAO,EAAuB,KAAK,cAAc,EAAc,MAAM,6BAA6B,CAAC;AAEnG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,aAAa,CAAC;AAuC9D,0DAA0D;AAC1D,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAG3E;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAGtE;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,UAAU,GAAG,kBAAkB,CAe/E;AA6BD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAyB9F;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yFAAyF;IACzF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAuED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,cAAc,GACnB,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,cAAc,GACnB,MAAM,CAKR;AAmBD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAsB1E;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,MAAM,EACX,wBAAwB,EAAE,MAAM,EAChC,IAAI,EAAE,cAAc,GACnB,MAAM,CAqBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAmE7E;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAOlF"}