hikoutei 0.2.0

package/dist/application/sync/outbound/effects/SyncEffectWorkerTransitions.js.map

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

package/dist/application/sync/outbound/projection/ProjectionEffectFactory.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Deterministic outbox payload builders for all v1 Sheet projections.
+ *
+ * The public repository never exposes insert/update/delete mechanics here.
+ * These helpers translate a writer-approved canonical/candidate/resolution
+ * decision into one immutable effect payload; the effect worker later performs
+ * the remote compare-and-set through the gateway.
+ */
+import { type Applicability, type EffectTargetKind, type NormalizedCell, type Presence } from "../../../../domain/index.js";
+import { SYNC_GATEWAY_PROJECTIONS } from "../../gateway/constants.js";
+import { type SyncEffectKind, type SyncProjection } from "../../gateway/syncGateway.js";
+import type { NewEffect } from "../../../../infrastructure/storage/index.js";
+/** Common immutable coordinates of a writer-approved projection effect. */
+export interface ProjectionEffectInput {
+    readonly effectId: string;
+    readonly effectKind: SyncEffectKind;
+    readonly commitId: string;
+    readonly logicalSheetId: string;
+    readonly physicalSheetId: string;
+    readonly sheetName: string;
+    readonly registeredRange: string;
+    readonly projection: SyncProjection;
+    readonly schemaVersion: number;
+    readonly targetKind: EffectTargetKind;
+    readonly targetId: string;
+    readonly rowBindingId: Presence<string>;
+    readonly conflictId: Presence<string>;
+    readonly targetAnchor: string;
+    readonly fields: Readonly<Record<string, NormalizedCell>>;
+    readonly createIfMissing: boolean;
+    readonly expectedVisibleRevision: number;
+    readonly expectedVisibleHash: string;
+    readonly expectedCandidateHash?: Applicability<string>;
+    readonly repairGuardHash?: Presence<string>;
+    readonly sourceQuarantineId?: Presence<string>;
+    readonly targetEntityRevision?: Applicability<number>;
+    readonly targetFieldRevisionHash?: Applicability<string>;
+    readonly targetCanonicalCommitId?: Applicability<string>;
+    readonly streamSequence: number;
+}
+/** Input for a System_State projection effect. */
+export type SystemProjectionEffectInput = Omit<ProjectionEffectInput, "effectKind">;
+/** Input for a User_Input candidate reconciliation effect. */
+export type CandidateReconcileEffectInput = Omit<ProjectionEffectInput, "effectKind" | "projection"> & {
+    readonly projection?: typeof SYNC_GATEWAY_PROJECTIONS.USER_INPUT;
+};
+/** Input for a guarded physical deletion from a User_Input projection. */
+export type UserInputDeleteEffectInput = Omit<ProjectionEffectInput, "effectKind" | "projection"> & {
+    readonly projection?: typeof SYNC_GATEWAY_PROJECTIONS.USER_INPUT;
+};
+/** Shared input for effects projected to the Sync_Conflicts control sheet. */
+export type ResolutionEffectInput = Omit<ProjectionEffectInput, "effectKind" | "projection" | "targetKind"> & {
+    readonly projection?: typeof SYNC_GATEWAY_PROJECTIONS.SYNC_CONFLICTS;
+};
+/** Builds an immutable outbox row, including stable payload/dedupe identities. */
+export declare function createProjectionEffect(input: ProjectionEffectInput): NewEffect;
+/** Creates a canonical System_State projection effect. */
+export declare function createSystemProjectionEffect(input: SystemProjectionEffectInput): NewEffect;
+/** Creates a baseline-CAS User_Input reconcile that cannot overwrite a candidate. */
+export declare function createCandidateReconcileEffect(input: CandidateReconcileEffectInput): NewEffect;
+/**
+ * Creates a full-row, candidate-preserving deletion for one User_Input row.
+ *
+ * The payload must represent the exact current visible row. The gateway can
+ * therefore remove only the anchored row that the canonical delete observed,
+ * while the worker blocks the effect if an unresolved user candidate exists.
+ */
+export declare function createUserInputDeleteEffect(input: UserInputDeleteEffectInput): NewEffect;
+/** Creates a guard-specific repair effect; caller must preserve the quarantine link. */
+export declare function createSystemRepairEffect(input: Omit<ProjectionEffectInput, "effectKind">): NewEffect;
+/** Creates the system-owned Sync_Conflicts control-row projection effect. */
+export declare function createResolutionProjectionEffect(input: ResolutionEffectInput): NewEffect;
+/**
+ * Creates a guarded deletion for one resolved system-owned conflict row.
+ *
+ * The payload carries the full currently visible conflict row as the expected
+ * state. The gateway therefore deletes only the exact anchored row that the
+ * resolver observed; it never deletes by mutable sheet row number.
+ */
+export declare function createResolutionDeleteEffect(input: ResolutionEffectInput): NewEffect;
+//# sourceMappingURL=ProjectionEffectFactory.d.ts.map

package/dist/application/sync/outbound/projection/ProjectionEffectFactory.d.ts.map

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

package/dist/application/sync/outbound/projection/ProjectionEffectFactory.js

@@ -0,0 +1,245 @@
+/**
+ * Deterministic outbox payload builders for all v1 Sheet projections.
+ *
+ * The public repository never exposes insert/update/delete mechanics here.
+ * These helpers translate a writer-approved canonical/candidate/resolution
+ * decision into one immutable effect payload; the effect worker later performs
+ * the remote compare-and-set through the gateway.
+ */
+import { EMPTY_ARRAY_LENGTH_ZERO, EMPTY_STRING_LENGTH_ZERO, NON_NEGATIVE_SAFE_INTEGER_MINIMUM, POSITIVE_SAFE_INTEGER_MINIMUM, stableHash, } from "../../../../domain/index.js";
+import { APPLICABILITY_KINDS, PRESENCE_KINDS, } from "../../../../shared/state/index.js";
+import { SYNC_GATEWAY_EFFECT_KINDS, SYNC_GATEWAY_PROJECTIONS, } from "../../gateway/constants.js";
+import { computeSyncVisibleHash, serializeSyncProjectionEffectPayload, } from "../../gateway/syncGateway.js";
+import { STORAGE_ERROR_CODES, StorageError, } from "../../../../infrastructure/storage/errors.js";
+const PROJECTION_EFFECT_KINDS = {
+    SYSTEM_PROJECTION: "system_projection",
+    CANDIDATE_RECONCILE: "candidate_reconcile",
+    SYSTEM_REPAIR: "system_repair",
+    RESOLUTION_PROJECTION: "resolution_projection",
+    RESOLUTION_DELETE: SYNC_GATEWAY_EFFECT_KINDS.RESOLUTION_DELETE,
+    USER_INPUT_DELETE: SYNC_GATEWAY_EFFECT_KINDS.USER_INPUT_DELETE,
+};
+const PROJECTION_TARGET_KINDS = {
+    ENTITY: "entity",
+    ROW_BINDING: "row_binding",
+    PROJECTION_ROW: "projection_row",
+    CONFLICT: "conflict",
+};
+const EMPTY_VISIBLE_HASH = "";
+/** Builds an immutable outbox row, including stable payload/dedupe identities. */
+export function createProjectionEffect(input) {
+    validateInput(input);
+    const targetVisibleHash = computeSyncVisibleHash(input.fields);
+    if (isProjectionDeletionEffect(input.effectKind) && targetVisibleHash !== input.expectedVisibleHash) {
+        throwEffectError("projection deletion requires the full current visible hash");
+    }
+    const expectedCandidateHash = input.expectedCandidateHash ?? notApplicableValue();
+    const targetEntityRevision = input.targetEntityRevision ?? notApplicableValue();
+    const targetFieldRevisionHash = input.targetFieldRevisionHash ?? notApplicableValue();
+    const targetCanonicalCommitId = input.targetCanonicalCommitId ?? applicableValue(input.commitId);
+    const repairGuardHash = input.repairGuardHash ?? absentValue();
+    const sourceQuarantineId = input.sourceQuarantineId ?? absentValue();
+    const payloadJson = serializeSyncProjectionEffectPayload({
+        sheetName: input.sheetName,
+        registeredRange: input.registeredRange,
+        schemaVersion: input.schemaVersion,
+        targetAnchor: input.targetAnchor,
+        fields: input.fields,
+        targetVisibleHash,
+        createIfMissing: input.createIfMissing,
+        expectedCandidateHash,
+    });
+    const payloadHash = stableHash({ payloadJson });
+    return {
+        effectId: input.effectId,
+        effectKind: input.effectKind,
+        commitId: input.commitId,
+        logicalSheetId: input.logicalSheetId,
+        physicalSheetId: input.physicalSheetId,
+        projection: input.projection,
+        rowBindingId: input.rowBindingId,
+        conflictId: input.conflictId,
+        targetKind: input.targetKind,
+        targetId: input.targetId,
+        targetEntityRevision,
+        targetFieldRevisionHash,
+        targetCanonicalCommitId,
+        expectedVisibleRevision: input.expectedVisibleRevision,
+        expectedVisibleHash: input.expectedVisibleHash,
+        repairGuardHash,
+        sourceQuarantineId,
+        payloadJson,
+        payloadHash,
+        effectDedupeKey: stableHash({
+            effectKind: input.effectKind,
+            logicalSheetId: input.logicalSheetId,
+            physicalSheetId: input.physicalSheetId,
+            projection: input.projection,
+            targetKind: input.targetKind,
+            targetId: input.targetId,
+            targetCanonicalCommitId: stableApplicabilityValue(targetCanonicalCommitId),
+            payloadHash,
+        }),
+        streamSequence: input.streamSequence,
+    };
+}
+/** Creates a canonical System_State projection effect. */
+export function createSystemProjectionEffect(input) {
+    if (input.projection !== SYNC_GATEWAY_PROJECTIONS.SYSTEM_STATE) {
+        throwEffectError("system projection must target system_state");
+    }
+    return createProjectionEffect({
+        ...input,
+        effectKind: PROJECTION_EFFECT_KINDS.SYSTEM_PROJECTION,
+    });
+}
+/** Creates a baseline-CAS User_Input reconcile that cannot overwrite a candidate. */
+export function createCandidateReconcileEffect(input) {
+    return createProjectionEffect({
+        ...input,
+        projection: SYNC_GATEWAY_PROJECTIONS.USER_INPUT,
+        effectKind: PROJECTION_EFFECT_KINDS.CANDIDATE_RECONCILE,
+    });
+}
+/**
+ * Creates a full-row, candidate-preserving deletion for one User_Input row.
+ *
+ * The payload must represent the exact current visible row. The gateway can
+ * therefore remove only the anchored row that the canonical delete observed,
+ * while the worker blocks the effect if an unresolved user candidate exists.
+ */
+export function createUserInputDeleteEffect(input) {
+    return createProjectionEffect({
+        ...input,
+        projection: SYNC_GATEWAY_PROJECTIONS.USER_INPUT,
+        effectKind: PROJECTION_EFFECT_KINDS.USER_INPUT_DELETE,
+    });
+}
+/** Creates a guard-specific repair effect; caller must preserve the quarantine link. */
+export function createSystemRepairEffect(input) {
+    requireNonEmptyPresence(input.repairGuardHash, "system repair requires a non-empty repairGuardHash");
+    requireNonEmptyPresence(input.sourceQuarantineId, "system repair requires a sourceQuarantineId");
+    return createProjectionEffect({
+        ...input,
+        effectKind: PROJECTION_EFFECT_KINDS.SYSTEM_REPAIR,
+    });
+}
+/** Creates the system-owned Sync_Conflicts control-row projection effect. */
+export function createResolutionProjectionEffect(input) {
+    requireConflictTarget(input.conflictId, input.targetId, "resolution projection must target exactly one conflict ID");
+    return createProjectionEffect({
+        ...input,
+        projection: SYNC_GATEWAY_PROJECTIONS.SYNC_CONFLICTS,
+        targetKind: PROJECTION_TARGET_KINDS.CONFLICT,
+        effectKind: PROJECTION_EFFECT_KINDS.RESOLUTION_PROJECTION,
+    });
+}
+/**
+ * Creates a guarded deletion for one resolved system-owned conflict row.
+ *
+ * The payload carries the full currently visible conflict row as the expected
+ * state. The gateway therefore deletes only the exact anchored row that the
+ * resolver observed; it never deletes by mutable sheet row number.
+ */
+export function createResolutionDeleteEffect(input) {
+    requireConflictTarget(input.conflictId, input.targetId, "resolution deletion must target exactly one conflict ID");
+    return createProjectionEffect({
+        ...input,
+        projection: SYNC_GATEWAY_PROJECTIONS.SYNC_CONFLICTS,
+        targetKind: PROJECTION_TARGET_KINDS.CONFLICT,
+        effectKind: PROJECTION_EFFECT_KINDS.RESOLUTION_DELETE,
+    });
+}
+function validateInput(input) {
+    for (const [label, value] of [
+        ["effect ID", input.effectId],
+        ["commit ID", input.commitId],
+        ["logical sheet ID", input.logicalSheetId],
+        ["physical sheet ID", input.physicalSheetId],
+        ["sheet name", input.sheetName],
+        ["registered range", input.registeredRange],
+        ["target ID", input.targetId],
+        ["target anchor", input.targetAnchor],
+    ]) {
+        requireNonEmptyText(value, label);
+    }
+    if (!Number.isSafeInteger(input.schemaVersion) ||
+        input.schemaVersion < POSITIVE_SAFE_INTEGER_MINIMUM ||
+        !Number.isSafeInteger(input.expectedVisibleRevision) ||
+        input.expectedVisibleRevision < NON_NEGATIVE_SAFE_INTEGER_MINIMUM ||
+        !Number.isSafeInteger(input.streamSequence) ||
+        input.streamSequence < POSITIVE_SAFE_INTEGER_MINIMUM) {
+        throwEffectError("projection effect has an invalid schema, visible revision, or stream sequence");
+    }
+    if (input.createIfMissing) {
+        if (input.expectedVisibleRevision !== NON_NEGATIVE_SAFE_INTEGER_MINIMUM ||
+            input.expectedVisibleHash !== EMPTY_VISIBLE_HASH) {
+            throwEffectError("new projection rows require an empty visible baseline");
+        }
+    }
+    else if (input.expectedVisibleHash.length === EMPTY_STRING_LENGTH_ZERO) {
+        throwEffectError("existing projection effects require an expected visible hash");
+    }
+    if (Object.keys(input.fields).length === EMPTY_ARRAY_LENGTH_ZERO) {
+        throwEffectError("projection effect must contain fields");
+    }
+    if (input.effectKind === PROJECTION_EFFECT_KINDS.CANDIDATE_RECONCILE &&
+        input.projection !== SYNC_GATEWAY_PROJECTIONS.USER_INPUT) {
+        throwEffectError("candidate reconcile must target user_input");
+    }
+    if ((input.effectKind === PROJECTION_EFFECT_KINDS.RESOLUTION_PROJECTION ||
+        input.effectKind === PROJECTION_EFFECT_KINDS.RESOLUTION_DELETE) &&
+        input.projection !== SYNC_GATEWAY_PROJECTIONS.SYNC_CONFLICTS) {
+        throwEffectError("resolution projection must target sync_conflicts");
+    }
+    if (isProjectionDeletionEffect(input.effectKind) &&
+        (input.createIfMissing || input.expectedVisibleRevision < POSITIVE_SAFE_INTEGER_MINIMUM)) {
+        throwEffectError("projection deletion requires an existing visible row");
+    }
+    if (input.effectKind === PROJECTION_EFFECT_KINDS.USER_INPUT_DELETE &&
+        (input.projection !== SYNC_GATEWAY_PROJECTIONS.USER_INPUT ||
+            input.targetKind !== PROJECTION_TARGET_KINDS.PROJECTION_ROW)) {
+        throwEffectError("user input deletion must target one User_Input projection row");
+    }
+    if (input.rowBindingId.kind === PRESENCE_KINDS.ABSENT &&
+        input.targetKind !== PROJECTION_TARGET_KINDS.CONFLICT) {
+        throwEffectError("non-conflict projection effect requires a row binding ID");
+    }
+}
+function requireNonEmptyText(value, label) {
+    if (value.length === EMPTY_STRING_LENGTH_ZERO) {
+        throwEffectError(`${label} is required`);
+    }
+}
+function requireNonEmptyPresence(value, message) {
+    if (value?.kind !== PRESENCE_KINDS.PRESENT || value.value.length === EMPTY_STRING_LENGTH_ZERO) {
+        throwEffectError(message);
+    }
+    return value.value;
+}
+function requireConflictTarget(conflictId, targetId, message) {
+    const value = requireNonEmptyPresence(conflictId, message);
+    if (targetId !== value)
+        throwEffectError(message);
+    return value;
+}
+function applicableValue(value) {
+    return { kind: APPLICABILITY_KINDS.APPLICABLE, value };
+}
+function notApplicableValue() {
+    return { kind: APPLICABILITY_KINDS.NOT_APPLICABLE };
+}
+function absentValue() {
+    return { kind: PRESENCE_KINDS.ABSENT };
+}
+function stableApplicabilityValue(value) {
+    return value.kind === APPLICABILITY_KINDS.APPLICABLE ? value.value : null;
+}
+function isProjectionDeletionEffect(effectKind) {
+    return effectKind === PROJECTION_EFFECT_KINDS.RESOLUTION_DELETE ||
+        effectKind === PROJECTION_EFFECT_KINDS.USER_INPUT_DELETE;
+}
+function throwEffectError(message) {
+    throw new StorageError(STORAGE_ERROR_CODES.INVALID_EFFECT_OPTIONS, message);
+}
+//# sourceMappingURL=ProjectionEffectFactory.js.map

package/dist/application/sync/outbound/projection/ProjectionEffectFactory.js.map

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

package/dist/application/sync/outbound/reconciliation/ReconciliationScanner.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Periodic reconciliation scanner for the System_State projection.
+ *
+ * SQLite is the canonical state; the Sheet is a projection that may drift when
+ * the fast-append path skips per-effect CAS, when a spreadsheet owner edits a
+ * protected tab, or when a response is lost. This scanner compares the durable
+ * desired state against one gateway snapshot per scan and, for every drift, it
+ * enqueues a normal system_projection effect on the existing outbox. The effect
+ * worker then applies the correction through the same slow path (with CAS) used
+ * by regular writes, so reconciliation never writes to the Sheet directly.
+ *
+ * Scope is intentionally limited to System_State in v1: that projection is
+ * protected and hidden, so the canonical state is always authoritative and a
+ * drift is always a repair target. User_Input reconciliation remains the
+ * responsibility of the candidate/conflict pipeline.
+ */
+import type { SqlStorageAdapter } from "../../../../adapter/persistence/contracts/sql.js";
+import { type SyncSheetGateway } from "../../gateway/syncGateway.js";
+/** Builder used by the scanner to produce fresh effect/commit identifiers. */
+export type ReconciliationIdFactory = () => string;
+/** Construction options for a single reconciliation scan. */
+export interface RunReconciliationScanOptions {
+    readonly storage: SqlStorageAdapter;
+    readonly gateway: SyncSheetGateway;
+    /** Physical sheet id of the System_State projection to reconcile. */
+    readonly physicalSheetId: string;
+    /** Logical sheet id owning the entity row bindings. */
+    readonly logicalSheetId: string;
+    /**
+     * Schema-declared field list for the System_State projection. The scanner
+     * reads exactly these fields per row and ignores anything else in the Sheet.
+     */
+    readonly systemFields: readonly string[];
+    /**
+     * Field name that encodes a tombstone (soft delete) on the System_State
+     * projection. Defaults to `_deleted`; tombstoned rows are dropped from the
+     * desired state and re-created if the Sheet still exposes them.
+     */
+    readonly tombstoneField?: string;
+    /** Schema version shared by every System_State effect produced here. */
+    readonly schemaVersion: number;
+    /** Reconciler writer identity. */
+    readonly writerId: string;
+    /** Injectable clock and id source for deterministic tests. */
+    readonly now?: () => number;
+    readonly createId?: ReconciliationIdFactory;
+    /** Override the reconciler lease role or duration. */
+    readonly writerRole?: string;
+    readonly leaseDurationMs?: number;
+    /** Observability hook invoked once after the scan settles. */
+    readonly onReport?: (report: ReconciliationScanReport) => void;
+}
+/** Observable outcome of one reconciliation scan. */
+export interface ReconciliationScanReport {
+    readonly physicalSheetId: string;
+    readonly snapshotRowsScanned: number;
+    readonly desiredRowsScanned: number;
+    readonly matchedRows: number;
+    readonly driftedRows: number;
+    readonly missingRows: number;
+    readonly extraRows: number;
+    readonly effectsEnqueued: number;
+    readonly fenceClaimed: boolean;
+}
+/**
+ * Runs one reconciliation scan and enqueues correction effects for drift.
+ *
+ * The scan never writes to the Sheet. It only reads a snapshot and inserts
+ * effects into the durable outbox; the existing effect worker applies them.
+ */
+export declare function runReconciliationScan(options: RunReconciliationScanOptions): Promise<ReconciliationScanReport>;
+export declare const RECONCILIATION_DEFAULTS: {
+    readonly ROLE: "typed-sheets-reconciler";
+    readonly LEASE_MS: 60000;
+    readonly TOMBSTONE_FIELD: "_deleted";
+};
+//# sourceMappingURL=ReconciliationScanner.d.ts.map

package/dist/application/sync/outbound/reconciliation/ReconciliationScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReconciliationScanner.d.ts","sourceRoot":"","sources":["../../../../../src/application/sync/outbound/reconciliation/ReconciliationScanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAuBH,OAAO,KAAK,EAAe,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACvG,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,8BAA8B,CAAC;AAWtC,8EAA8E;AAC9E,MAAM,MAAM,uBAAuB,GAAG,MAAM,MAAM,CAAC;AAEnD,6DAA6D;AAC7D,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,qEAAqE;IACrE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,uDAAuD;IACvD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IAC5C,sDAAsD;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAC;CAChE;AAED,qDAAqD;AACrD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAoED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,wBAAwB,CAAC,CAkCnC;AA2iBD,eAAO,MAAM,uBAAuB;;;;CAI1B,CAAC"}