hikoutei 0.3.4 → 0.3.5

package/dist/adapter/sheets/providers/google-sheets-api/model/batchBuilder.js

@@ -0,0 +1,413 @@
+/**
+ * Atomic batch builder for the direct Sheets provider.
+ *
+ * All applicable target mutations (appends, scattered field updates, physical
+ * row deletes) and their receipt writes are combined into ONE
+ * `spreadsheets.batchUpdate`, which is atomic: any invalid request aborts the
+ * whole batch. The builder also owns the transport byte budget: a batch that
+ * would exceed the budget is trimmed to the largest order-preserving effect
+ * prefix, and an effect that alone exceeds the budget becomes a schema_error
+ * result instead of a mutation.
+ */
+import { PRESENCE_KINDS } from "../../../../../shared/state/index.js";
+import { GOOGLE_SHEETS_API_ANCHOR_KEY, GOOGLE_SHEETS_API_DATE_NUMBER_FORMAT_OBJECT, GOOGLE_SHEETS_API_RECEIPT_HEADERS, } from "../constants.js";
+import { invalidProviderState } from "../errors.js";
+import { serializeBatchUpdateRequests } from "../transport/googleSheetsApiTransport.js";
+import { toApiUserEnteredValue } from "./valueNormalization.js";
+import { allocateSheetId } from "./sheetIdAllocator.js";
+/**
+ * Resolves how many leading effects fit in one atomic batch.
+ *
+ * The byte budget is measured on the phase-ordered request list serialized
+ * exactly as the transport sends it (SDK-wrapped request shapes), so the
+ * check is exact for the bytes that would actually hit the wire. When the
+ * very first effect alone exceeds the budget it becomes a schema_error
+ * result and the remaining effects are re-tried, so a single pathological
+ * payload cannot block the rest of the batch.
+ */
+export function resolveApplyBatchBudget(context, plans, options) {
+    const total = plans.length;
+    let cursor = 0;
+    const schemaErrorIndices = [];
+    while (cursor < total) {
+        const fitting = largestFittingPrefix(plans, context, options, cursor, total);
+        if (fitting > cursor) {
+            return {
+                includeCount: fitting,
+                schemaErrorIndices,
+                hasMore: fitting < total,
+            };
+        }
+        schemaErrorIndices.push(cursor);
+        cursor += 1;
+    }
+    return { includeCount: 0, schemaErrorIndices, hasMore: false };
+}
+function largestFittingPrefix(plans, context, options, start, end) {
+    let low = start;
+    let high = end;
+    while (low < high) {
+        const mid = Math.ceil((low + high) / 2);
+        const built = buildApplyBatchRequests(context, plans.slice(start, mid), {
+            updatedAt: options.updatedAt,
+            includeReceipts: options.includeReceipts,
+        });
+        if (built.bytes <= options.maxBatchBytes) {
+            low = mid;
+        }
+        else {
+            high = mid - 1;
+        }
+    }
+    return low;
+}
+/**
+ * Builds one atomic batchUpdate request list for a prefix of the plan.
+ *
+ * Requests are emitted in phase order: receipt-tab creation, append row
+ * inserts/values/anchors, scattered field updates, physical deletes (in
+ * descending row order so an earlier delete never shifts a later target),
+ * then receipt rows. Appended rows are written with their full header cells
+ * (all effects that touched a created row merge into one write); date cells
+ * keep the canonical number format through a separate format-masked request.
+ */
+export function buildApplyBatchRequests(context, plans, options) {
+    const requests = [];
+    const appended = [];
+    const updated = [];
+    const deleted = [];
+    for (const plan of plans) {
+        if (plan.mutation !== undefined)
+            collectMutation(plan.mutation, appended, updated, deleted);
+    }
+    const receipts = collectBatchReceipts(plans, context, options.includeReceipts);
+    let createdReceiptSheetId;
+    if (receipts.length > 0 && context.receiptSheetId.kind === PRESENCE_KINDS.ABSENT) {
+        createdReceiptSheetId = pushReceiptSheetCreation(requests, context);
+    }
+    if (appended.length > 0) {
+        pushAppendWrites(requests, context, appended);
+    }
+    for (const row of updated) {
+        pushUpdateWrites(requests, context, row);
+    }
+    // Descending physical row order: deleting a row never shifts a later target.
+    for (const row of [...deleted].sort((left, right) => right.rowNumber - left.rowNumber)) {
+        requests.push({
+            kind: "deleteDimension",
+            sheetId: context.sheetId,
+            dimension: "ROWS",
+            startIndex: row.rowNumber - 1,
+            endIndex: row.rowNumber,
+        });
+    }
+    if (receipts.length > 0) {
+        pushReceiptWrites(requests, context, receipts, options.updatedAt, createdReceiptSheetId);
+    }
+    return { requests, bytes: measureRequestBytes(requests) };
+}
+/** Measures the serialized batchUpdate body with the transport serializer. */
+export function measureRequestBytes(requests) {
+    return new TextEncoder().encode(serializeBatchUpdateRequests(requests)).byteLength;
+}
+/**
+ * Collects one batch's receipts, deduplicated by effectId (queueReceipt_
+ * semantics): receipts already stored in the sheet belong to replays and are
+ * never rewritten, and a receipt planned twice inside one request (a
+ * same-request effect-id replay) is written once.
+ */
+function collectBatchReceipts(plans, context, includeReceipts) {
+    if (!includeReceipts)
+        return [];
+    const queued = new Set();
+    const receipts = [];
+    for (const plan of plans) {
+        const receipt = plan.receipt;
+        if (receipt === undefined)
+            continue;
+        if (context.receipts.has(receipt.effectId))
+            continue;
+        if (queued.has(receipt.effectId))
+            continue;
+        queued.add(receipt.effectId);
+        receipts.push(receipt);
+    }
+    return receipts;
+}
+/**
+ * Resolves the append row prefix for one fast-append request.
+ *
+ * Unlike regular effects there is no per-row schema_error status, so a single
+ * row that alone exceeds the budget is still included: the API's own limits
+ * reject it deterministically (a proven explicit failure) instead of leaving
+ * the effect in an infinite defer loop.
+ */
+export function resolveAppendBudget(rows, build, maxBatchBytes) {
+    if (rows.length === 0)
+        return { includeCount: 0, hasMore: false };
+    let low = 1;
+    let high = rows.length;
+    // The first row is always included (documented above).
+    while (low < high) {
+        const mid = Math.ceil((low + high) / 2);
+        if (build(mid).bytes <= maxBatchBytes) {
+            low = mid;
+        }
+        else {
+            high = mid - 1;
+        }
+    }
+    return { includeCount: low, hasMore: low < rows.length };
+}
+/** Builds one atomic fast-append batch for a prefix of pending rows. */
+export function buildAppendBatchRequests(context, rows, receipts, options) {
+    const requests = [];
+    const uniqueReceipts = dedupeReceipts(receipts, context);
+    let createdReceiptSheetId;
+    if (uniqueReceipts.length > 0 && context.receiptSheetId.kind === PRESENCE_KINDS.ABSENT) {
+        createdReceiptSheetId = pushReceiptSheetCreation(requests, context);
+    }
+    if (rows.length > 0) {
+        pushAppendWrites(requests, context, rows);
+    }
+    if (uniqueReceipts.length > 0) {
+        pushReceiptWrites(requests, context, uniqueReceipts, options.updatedAt, createdReceiptSheetId);
+    }
+    return { requests, bytes: measureRequestBytes(requests) };
+}
+/** Deduplicates pre-planned receipts by effectId for one append batch. */
+function dedupeReceipts(receipts, context) {
+    const queued = new Set();
+    const unique = [];
+    for (const receipt of receipts) {
+        if (context.receipts.has(receipt.effectId))
+            continue;
+        if (queued.has(receipt.effectId))
+            continue;
+        queued.add(receipt.effectId);
+        unique.push(receipt);
+    }
+    return unique;
+}
+// ---------------------------------------------------------------------------
+// Phase builders
+// ---------------------------------------------------------------------------
+function collectMutation(mutation, appended, updated, deleted) {
+    switch (mutation.kind) {
+        case "append":
+            appended.push(mutation.row);
+            break;
+        case "update":
+            updated.push(mutation.row);
+            break;
+        case "delete":
+            deleted.push(mutation.row);
+            break;
+    }
+}
+/** Inserts the appended rows, writes their values/anchors, formats, checkboxes. */
+function pushAppendWrites(requests, context, rows) {
+    const ordered = [...rows].sort((left, right) => left.rowNumber - right.rowNumber);
+    const first = ordered[0];
+    const last = ordered[ordered.length - 1];
+    if (first === undefined || last === undefined)
+        return;
+    const sheetId = context.sheetId;
+    const startColumn = context.startColumn - 1;
+    const columnCount = context.headers.length;
+    // Reserve the target rows before writing values so a concurrent human
+    // append is shifted rather than overwritten (insertRowsAfter equivalent).
+    requests.push({
+        kind: "insertDimension",
+        sheetId,
+        dimension: "ROWS",
+        startIndex: first.rowNumber - 1,
+        endIndex: first.rowNumber - 1 + ordered.length,
+        inheritFromBefore: false,
+    });
+    const values = ordered.map((row) => context.headers.map((header) => toApiCell(row.cells[header] ?? null)));
+    requests.push({
+        kind: "updateCells",
+        sheetId,
+        startRowIndex: first.rowNumber - 1,
+        startColumnIndex: startColumn,
+        rows: values,
+        fields: "userEnteredValue",
+    });
+    // Developer-metadata anchors keep created rows findable by anchor on the
+    // next apply/probe, matching the Apps Script effect-operation create path.
+    for (const row of ordered) {
+        if (row.anchor.kind === PRESENCE_KINDS.PRESENT) {
+            requests.push({
+                kind: "createDeveloperMetadata",
+                sheetId,
+                rowIndex: row.rowNumber - 1,
+                key: GOOGLE_SHEETS_API_ANCHOR_KEY,
+                value: row.anchor.value,
+            });
+        }
+    }
+    // A column is formatted as dates only when every appended cell in it is a
+    // date or blank (the Apps Script setDateNumberFormats_ rule).
+    context.headers.forEach((header, columnIndex) => {
+        const isDateColumn = ordered.every((row) => {
+            const cell = row.cells[header] ?? null;
+            return cell === null || cell.kind === "date";
+        });
+        if (!isDateColumn)
+            return;
+        requests.push({
+            kind: "updateCells",
+            sheetId,
+            startRowIndex: first.rowNumber - 1,
+            startColumnIndex: startColumn + columnIndex,
+            rows: ordered.map(() => [{ userEnteredFormat: { numberFormat: GOOGLE_SHEETS_API_DATE_NUMBER_FORMAT_OBJECT } }]),
+            fields: "userEnteredFormat.numberFormat",
+        });
+    });
+    for (const checkboxHeader of context.checkboxHeaders) {
+        const columnIndex = context.positions.get(checkboxHeader);
+        if (columnIndex === undefined) {
+            invalidProviderState(`checkbox header is not registered: ${checkboxHeader}`);
+        }
+        requests.push({
+            kind: "setDataValidation",
+            sheetId,
+            startRowIndex: first.rowNumber - 1,
+            endRowIndex: last.rowNumber,
+            startColumnIndex: startColumn + columnIndex,
+            endColumnIndex: startColumn + columnIndex + 1,
+            strict: true,
+        });
+    }
+}
+/**
+ * Writes one updated row's changed field runs.
+ *
+ * Runs are contiguous field spans (the Apps Script writeFieldRun_ grouping),
+ * so the values arrays never need empty placeholder cells that would clear a
+ * neighboring cell. Date cells get the canonical number format through a
+ * separate format-masked request so the value write never resets formats.
+ */
+function pushUpdateWrites(requests, context, row) {
+    const sheetId = context.sheetId;
+    const startColumn = context.startColumn - 1;
+    const changed = Object.entries(row.writeFields)
+        .map(([fieldName, cell]) => {
+        const columnIndex = context.positions.get(fieldName);
+        if (columnIndex === undefined) {
+            invalidProviderState(`effect field is not a registered header: ${fieldName}`);
+        }
+        return { fieldName, columnIndex, cell };
+    })
+        .sort((left, right) => left.columnIndex - right.columnIndex);
+    let runStart = 0;
+    for (let index = 1; index <= changed.length; index += 1) {
+        const previous = changed[index - 1];
+        const current = changed[index];
+        if (previous !== undefined &&
+            (current === undefined || current.columnIndex !== previous.columnIndex + 1)) {
+            pushUpdateRun(requests, sheetId, row, changed.slice(runStart, index), startColumn);
+            runStart = index;
+        }
+    }
+}
+function pushUpdateRun(requests, sheetId, row, run, startColumn) {
+    const first = run[0];
+    if (first === undefined)
+        return;
+    const firstColumn = startColumn + first.columnIndex;
+    const cells = run.map((entry) => toApiCell(entry.cell));
+    requests.push({
+        kind: "updateCells",
+        sheetId,
+        startRowIndex: row.rowNumber - 1,
+        startColumnIndex: firstColumn,
+        rows: [cells],
+        fields: "userEnteredValue",
+    });
+    // Date cells need the canonical format so read-back normalizes the serial
+    // as a date; without it the visible hash would never match.
+    run.forEach((entry, offset) => {
+        if (entry.cell !== null && entry.cell.kind === "date") {
+            requests.push({
+                kind: "updateCells",
+                sheetId,
+                startRowIndex: row.rowNumber - 1,
+                startColumnIndex: firstColumn + offset,
+                rows: [[{ userEnteredFormat: { numberFormat: GOOGLE_SHEETS_API_DATE_NUMBER_FORMAT_OBJECT } }]],
+                fields: "userEnteredFormat.numberFormat",
+            });
+        }
+    });
+}
+/** Creates the hidden receipt tab and its header row in the same batch. */
+function pushReceiptSheetCreation(requests, context) {
+    // A deterministic, collision-free 31-bit positive sheetId (never the old
+    // random pick): the allocator scans the enumeration's existing ids so a
+    // repeated attempt after a lost response picks the same id.
+    const receiptSheetId = allocateSheetId(context.existingSheetIds);
+    requests.push({
+        kind: "addSheet",
+        title: "__typed_sheets_internal_effect_receipts",
+        sheetId: receiptSheetId,
+    });
+    requests.push({
+        kind: "updateSheetProperties",
+        sheetId: receiptSheetId,
+        hidden: true,
+    });
+    requests.push({
+        kind: "updateCells",
+        sheetId: receiptSheetId,
+        startRowIndex: 0,
+        startColumnIndex: 0,
+        rows: [GOOGLE_SHEETS_API_RECEIPT_HEADERS.map((header) => ({
+                userEnteredValue: { stringValue: header },
+            }))],
+        fields: "userEnteredValue",
+    });
+    return receiptSheetId;
+}
+/** Appends receipt rows after the receipt tab's last content row. */
+function pushReceiptWrites(requests, context, receipts, updatedAt, createdReceiptSheetId) {
+    let sheetId;
+    if (createdReceiptSheetId !== undefined) {
+        sheetId = createdReceiptSheetId;
+    }
+    else if (context.receiptSheetId.kind === PRESENCE_KINDS.PRESENT) {
+        sheetId = context.receiptSheetId.value;
+    }
+    else {
+        invalidProviderState("receipt sheet id is unavailable for receipt writes");
+    }
+    const startRow = Math.max(context.receiptLastRow + 1, 2);
+    requests.push({
+        kind: "insertDimension",
+        sheetId,
+        dimension: "ROWS",
+        startIndex: startRow - 1,
+        endIndex: startRow - 1 + receipts.length,
+        inheritFromBefore: false,
+    });
+    requests.push({
+        kind: "updateCells",
+        sheetId,
+        startRowIndex: startRow - 1,
+        startColumnIndex: 0,
+        rows: receipts.map((receipt) => [
+            { userEnteredValue: { stringValue: receipt.effectId } },
+            { userEnteredValue: { stringValue: receipt.payloadHash } },
+            { userEnteredValue: { stringValue: receipt.status } },
+            { userEnteredValue: { stringValue: receipt.visibleHash } },
+            { userEnteredValue: { numberValue: receipt.visibleRevision } },
+            { userEnteredValue: { stringValue: updatedAt } },
+        ]),
+        fields: "userEnteredValue",
+    });
+}
+/** Converts a normalized cell to the API cell shape (dates as serials). */
+function toApiCell(cell) {
+    return toApiUserEnteredValue(cell);
+}
+//# sourceMappingURL=batchBuilder.js.map

package/dist/adapter/sheets/providers/google-sheets-api/model/batchBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchBuilder.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/model/batchBuilder.ts"],"names":[],"mappings":"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"}

package/dist/adapter/sheets/providers/google-sheets-api/model/observation.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Observation model: row-anchor planning and full snapshot building.
+ *
+ * These helpers port the Apps Script observation operation's semantics to
+ * the REST wire shapes: nonblank rows are detected with the checkbox rule,
+ * anchors come from row-level developer metadata, and every cell is
+ * classified merged / error / formula / literal / blank with the same
+ * precedence and the same stableHash evidence as the Apps Script source, so
+ * snapshot hashes are byte-compatible across providers.
+ *
+ * Every untrusted SDK payload is validated by the preflight guards before it
+ * reaches this module; all functions here fail closed on drift (header
+ * mismatch, duplicate anchors, multi-anchor rows) exactly like the Apps
+ * Script source throws.
+ */
+import { type SyncGatewaySnapshotReadMode } from "../../../../../application/sync/gateway/constants.js";
+import type { SyncGatewaySnapshot } from "../../../../../application/sync/gateway/syncGateway.js";
+import type { GoogleSheetsApiTransport } from "../transport/googleSheetsApiTransport.js";
+import { type ParsedGridData, type ParsedMergedCell } from "./preflight.js";
+/** One tab requested by an observation/table-read batch. */
+export interface ObservationGridTarget {
+    readonly sheetName: string;
+    readonly registeredRange: string;
+}
+/** Validated grid plus sheet identity for one observed tab. */
+export interface ObservedTab {
+    readonly sheetId: number;
+    readonly title: string;
+    readonly grid: ParsedGridData;
+    /** Merged regions of this tab (sheet-level `merges` GridRange entries). */
+    readonly merges: readonly ParsedMergedCell[];
+}
+/** Anchor planning inputs shared by ensureRowAnchors and observation. */
+export interface AnchorPlanningTarget {
+    readonly registeredRange: string;
+    readonly headers: readonly string[];
+    readonly checkboxHeaders: readonly string[];
+}
+/** One anchor write planned for a missing anchor. */
+export interface PlannedAnchorWrite {
+    /** 0-based row index for the createDeveloperMetadata request. */
+    readonly rowIndex: number;
+    readonly anchor: string;
+}
+/** Result of one anchor-planning pass over a tab grid. */
+export interface AnchorPlanResult {
+    readonly assigned: number;
+    readonly existing: number;
+    readonly duplicateAnchors: readonly {
+        readonly anchor: string;
+        readonly rowNumbers: readonly number[];
+    }[];
+    readonly planned: readonly PlannedAnchorWrite[];
+}
+/** Full snapshot inputs; the projection and schemaVersion are wire fields. */
+export interface SnapshotBuildTarget extends AnchorPlanningTarget {
+    readonly sheetName: string;
+    readonly projection: string;
+    readonly schemaVersion: number;
+    readonly readMode: SyncGatewaySnapshotReadMode;
+}
+/**
+ * Reads the grids of several registered tabs in ONE `spreadsheets.get`
+ * call. Every requested tab must exist and return grid data; the result is
+ * keyed by tab name. The `fields` mask decides which metadata comes back
+ * (full observation mask or the lighter user_input mask); `timeoutMs`
+ * overrides the transport's per-request timeout for read calls.
+ */
+export declare function readTabGrids(transport: GoogleSheetsApiTransport, spreadsheetId: string, targets: readonly ObservationGridTarget[], fields?: string, timeoutMs?: number): Promise<ReadonlyMap<string, ObservedTab>>;
+/**
+ * Plans anchors for every nonblank data row of one tab grid. Rows with more
+ * than one anchor fail closed; missing anchors get a fresh
+ * `sync-anchor:<uuid>` value; duplicate anchors across rows are reported as
+ * evidence (never rewritten). Blank rows are skipped, matching the Apps
+ * Script ensureAnchorsFromValues_ behavior.
+ */
+export declare function planRowAnchors(tab: ObservedTab, target: AnchorPlanningTarget): AnchorPlanResult;
+/**
+ * Builds one full snapshot from a validated tab grid with EXACT parity to
+ * the Apps Script observation source: per-cell precedence merged -> error ->
+ * formula -> literal/blank, stableHash evidence (including stableHash(null)
+ * for blank cells), and a snapshotHash over the wire-shaped snapshot object
+ * with presence fields serialized as null.
+ */
+export declare function buildSnapshotFromTab(tab: ObservedTab, target: SnapshotBuildTarget): SyncGatewaySnapshot;
+//# sourceMappingURL=observation.d.ts.map

package/dist/adapter/sheets/providers/google-sheets-api/model/observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/model/observation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,sDAAsD,CAAC;AAC9D,OAAO,KAAK,EACV,mBAAmB,EAGpB,MAAM,wDAAwD,CAAC;AAEhE,OAAO,KAAK,EACV,wBAAwB,EAEzB,MAAM,0CAA0C,CAAC;AAMlD,OAAO,EAOL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAEtB,MAAM,gBAAgB,CAAC;AAOxB,4DAA4D;AAC5D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C;AAED,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,SAAS;QAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;KACxC,EAAE,CAAC;IACJ,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACjD;AAED,8EAA8E;AAC9E,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;CAChD;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,wBAAwB,EACnC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,MAAM,GAAE,MAA6C,EACrD,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CA8B3C;AASD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,oBAAoB,GAC3B,gBAAgB,CAsClB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,mBAAmB,GAC1B,mBAAmB,CA8DrB"}