@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/workflows/events.d.ts

@@ -0,0 +1,397 @@
+/**
+ * Workflow Event Contracts
+ *
+ * Type definitions for workflow lifecycle events.
+ * These events are emitted by the workflow engine for monitoring, logging,
+ * and triggering other workflows.
+ *
+ * Event Categories:
+ * - Instance lifecycle: started, completed, failed, cancelled
+ * - Step lifecycle: started, completed, failed, skipped
+ * - Runtime events: promoted, sleeping, waiting
+ * - System events: retry, dead_letter, error
+ *
+ * @see plans/active/workflow/README.md
+ */
+import type { StepError } from './instance';
+import type { RuntimeType } from './runtime';
+/**
+ * Base interface for all workflow events.
+ */
+export interface WorkflowEventBase {
+    /** Event type */
+    type: WorkflowEventType;
+    /** Unique event ID */
+    eventId: string;
+    /** Timestamp (ISO 8601) */
+    timestamp: string;
+    /** Workflow ID */
+    workflowId: string;
+    /** Workflow instance ID */
+    instanceId: string;
+    /** Workflow version */
+    workflowVersion: string;
+}
+/**
+ * All workflow event types.
+ */
+export type WorkflowEventType = 'workflow:started' | 'workflow:completed' | 'workflow:failed' | 'workflow:cancelled' | 'workflow:paused' | 'workflow:resumed' | 'step:started' | 'step:completed' | 'step:failed' | 'step:skipped' | 'workflow:promoted' | 'workflow:sleeping' | 'workflow:waiting' | 'workflow:woken' | 'step:retry' | 'workflow:dead_letter' | 'workflow:error';
+/**
+ * Emitted when a workflow instance starts.
+ */
+export interface WorkflowStartedEvent extends WorkflowEventBase {
+    type: 'workflow:started';
+    /** Trigger type that started the workflow */
+    triggerType: string;
+    /** Trigger event data */
+    triggerEvent: Record<string, unknown>;
+    /** Runtime where workflow started */
+    runtime: RuntimeType;
+    /** Initial step */
+    initialStep: string;
+    /** Parent instance ID if spawned */
+    parentInstanceId?: string;
+    /** User/system that triggered */
+    triggeredBy?: string;
+    /** Idempotency key if deduplicated */
+    idempotencyKey?: string;
+}
+/**
+ * Emitted when a workflow instance completes successfully.
+ */
+export interface WorkflowCompletedEvent extends WorkflowEventBase {
+    type: 'workflow:completed';
+    /** Final runtime where workflow completed */
+    runtime: RuntimeType;
+    /** Final step (should be the completion step) */
+    finalStep: string;
+    /** Total execution time in milliseconds */
+    durationMs: number;
+    /** Number of steps executed */
+    stepCount: number;
+    /** Workflow result/output if any */
+    result?: unknown;
+}
+/**
+ * Emitted when a workflow instance fails permanently.
+ */
+export interface WorkflowFailedEvent extends WorkflowEventBase {
+    type: 'workflow:failed';
+    /** Runtime where failure occurred */
+    runtime: RuntimeType;
+    /** Step where failure occurred */
+    failedStep: string;
+    /** Error details */
+    error: StepError;
+    /** Total execution time before failure */
+    durationMs: number;
+    /** Number of steps executed before failure */
+    stepCount: number;
+    /** Whether instance was moved to dead letter queue */
+    movedToDeadLetter: boolean;
+}
+/**
+ * Emitted when a workflow instance is cancelled.
+ */
+export interface WorkflowCancelledEvent extends WorkflowEventBase {
+    type: 'workflow:cancelled';
+    /** Runtime where cancellation happened */
+    runtime: RuntimeType;
+    /** Step at time of cancellation */
+    currentStep: string;
+    /** Cancellation reason */
+    reason: string;
+    /** User/system that cancelled */
+    cancelledBy?: string;
+    /** Whether compensation steps ran */
+    compensated: boolean;
+    /** Total execution time */
+    durationMs: number;
+}
+/**
+ * Emitted when a workflow instance is paused.
+ */
+export interface WorkflowPausedEvent extends WorkflowEventBase {
+    type: 'workflow:paused';
+    /** Runtime where pause happened */
+    runtime: RuntimeType;
+    /** Step at time of pause */
+    currentStep: string;
+    /** Pause reason */
+    reason?: string;
+    /** User/system that paused */
+    pausedBy?: string;
+}
+/**
+ * Emitted when a workflow instance is resumed.
+ */
+export interface WorkflowResumedEvent extends WorkflowEventBase {
+    type: 'workflow:resumed';
+    /** Runtime where resume happened */
+    runtime: RuntimeType;
+    /** Step being resumed */
+    currentStep: string;
+    /** User/system that resumed */
+    resumedBy?: string;
+}
+/**
+ * Emitted when a step starts executing.
+ */
+export interface StepStartedEvent extends WorkflowEventBase {
+    type: 'step:started';
+    /** Step name */
+    stepName: string;
+    /** Runtime where step is running */
+    runtime: RuntimeType;
+    /** Attempt number (1 for first attempt, >1 for retries) */
+    attempt: number;
+    /** Input to the step */
+    input?: Record<string, unknown>;
+}
+/**
+ * Emitted when a step completes successfully.
+ */
+export interface StepCompletedEvent extends WorkflowEventBase {
+    type: 'step:completed';
+    /** Step name */
+    stepName: string;
+    /** Runtime where step completed */
+    runtime: RuntimeType;
+    /** Attempt number */
+    attempt: number;
+    /** Step execution duration in milliseconds */
+    durationMs: number;
+    /** Next step to transition to */
+    nextStep: string | null;
+    /** Step output/result */
+    output?: unknown;
+}
+/**
+ * Emitted when a step fails.
+ */
+export interface StepFailedEvent extends WorkflowEventBase {
+    type: 'step:failed';
+    /** Step name */
+    stepName: string;
+    /** Runtime where step failed */
+    runtime: RuntimeType;
+    /** Attempt number */
+    attempt: number;
+    /** Step execution duration before failure */
+    durationMs: number;
+    /** Error details */
+    error: StepError;
+    /** Whether step will be retried */
+    willRetry: boolean;
+    /** Next retry time if retrying (ISO 8601) */
+    nextRetryAt?: string;
+}
+/**
+ * Emitted when a step is skipped.
+ */
+export interface StepSkippedEvent extends WorkflowEventBase {
+    type: 'step:skipped';
+    /** Step name */
+    stepName: string;
+    /** Runtime */
+    runtime: RuntimeType;
+    /** Reason for skipping */
+    reason: string;
+}
+/**
+ * Emitted when a workflow is promoted from local to cloud runtime.
+ */
+export interface WorkflowPromotedEvent extends WorkflowEventBase {
+    type: 'workflow:promoted';
+    /** Source runtime (always 'local') */
+    fromRuntime: 'local';
+    /** Target runtime (always 'cloud') */
+    toRuntime: 'cloud';
+    /** Step that triggered promotion */
+    promotionStep: string;
+    /** Reason for promotion */
+    promotionReason: PromotionReason;
+    /** State size in bytes */
+    stateSizeBytes: number;
+}
+/**
+ * Reasons for automatic promotion to cloud.
+ */
+export type PromotionReason = 'wait_for' | 'sleep' | 'schedule' | 'explicit';
+/**
+ * Emitted when a workflow starts sleeping.
+ */
+export interface WorkflowSleepingEvent extends WorkflowEventBase {
+    type: 'workflow:sleeping';
+    /** Runtime */
+    runtime: RuntimeType;
+    /** Step that called sleep */
+    sleepStep: string;
+    /** Wake time (ISO 8601) */
+    wakeAt: string;
+    /** Sleep duration in milliseconds */
+    durationMs: number;
+    /** Timer ID */
+    timerId: string;
+}
+/**
+ * Emitted when a workflow starts waiting for events.
+ */
+export interface WorkflowWaitingEvent extends WorkflowEventBase {
+    type: 'workflow:waiting';
+    /** Runtime */
+    runtime: RuntimeType;
+    /** Step that is waiting */
+    waitStep: string;
+    /** Events being waited for */
+    waitingForEvents: string[];
+    /** Timeout time (ISO 8601) */
+    timeoutAt: string;
+    /** Timer ID */
+    timerId: string;
+}
+/**
+ * Emitted when a workflow wakes from sleep or receives awaited event.
+ */
+export interface WorkflowWokenEvent extends WorkflowEventBase {
+    type: 'workflow:woken';
+    /** Runtime */
+    runtime: RuntimeType;
+    /** Step being resumed */
+    resumeStep: string;
+    /** Wake reason */
+    wakeReason: WakeReason;
+    /** Event that woke the workflow (for 'event' reason) */
+    wakeEvent?: WorkflowSignal;
+    /** Time spent sleeping/waiting in milliseconds */
+    waitDurationMs: number;
+}
+/**
+ * Reasons for waking.
+ */
+export type WakeReason = 'sleep_completed' | 'event_received' | 'timeout' | 'manual';
+/**
+ * Signal sent to a waiting workflow.
+ */
+export interface WorkflowSignal {
+    /** Event type */
+    eventType: string;
+    /** Event data */
+    data: Record<string, unknown>;
+    /** Sender instance ID */
+    senderInstanceId?: string;
+    /** Timestamp */
+    timestamp: string;
+}
+/**
+ * Emitted when a step is being retried.
+ */
+export interface StepRetryEvent extends WorkflowEventBase {
+    type: 'step:retry';
+    /** Step name */
+    stepName: string;
+    /** Runtime */
+    runtime: RuntimeType;
+    /** Previous attempt number */
+    previousAttempt: number;
+    /** Next attempt number */
+    nextAttempt: number;
+    /** Max attempts allowed */
+    maxAttempts: number;
+    /** Error from previous attempt */
+    previousError: StepError;
+    /** Delay before retry in milliseconds */
+    delayMs: number;
+    /** Next retry time (ISO 8601) */
+    retryAt: string;
+}
+/**
+ * Emitted when a workflow is moved to dead letter queue.
+ */
+export interface WorkflowDeadLetterEvent extends WorkflowEventBase {
+    type: 'workflow:dead_letter';
+    /** Runtime where failure occurred */
+    runtime: RuntimeType;
+    /** Step where final failure occurred */
+    failedStep: string;
+    /** Final error */
+    error: StepError;
+    /** Total retry attempts across all steps */
+    totalRetries: number;
+    /** Reason for dead letter */
+    reason: DeadLetterReason;
+    /** Time spent before dead letter in milliseconds */
+    totalDurationMs: number;
+}
+/**
+ * Reasons for moving to dead letter queue.
+ */
+export type DeadLetterReason = 'retries_exhausted' | 'non_retryable_error' | 'step_timeout' | 'workflow_timeout' | 'system_error';
+/**
+ * Emitted for general workflow errors (not step failures).
+ */
+export interface WorkflowErrorEvent extends WorkflowEventBase {
+    type: 'workflow:error';
+    /** Runtime */
+    runtime: RuntimeType;
+    /** Error category */
+    errorCategory: ErrorCategory;
+    /** Error message */
+    message: string;
+    /** Error details */
+    details?: Record<string, unknown>;
+    /** Whether workflow can continue */
+    recoverable: boolean;
+}
+/**
+ * Error categories for workflow errors.
+ */
+export type ErrorCategory = 'serialization' | 'promotion' | 'persistence' | 'trigger' | 'timer' | 'internal';
+/**
+ * Union of all workflow events.
+ */
+export type WorkflowEvent = WorkflowStartedEvent | WorkflowCompletedEvent | WorkflowFailedEvent | WorkflowCancelledEvent | WorkflowPausedEvent | WorkflowResumedEvent | StepStartedEvent | StepCompletedEvent | StepFailedEvent | StepSkippedEvent | WorkflowPromotedEvent | WorkflowSleepingEvent | WorkflowWaitingEvent | WorkflowWokenEvent | StepRetryEvent | WorkflowDeadLetterEvent | WorkflowErrorEvent;
+/**
+ * Handler for workflow events.
+ */
+export type WorkflowEventHandler<T extends WorkflowEvent = WorkflowEvent> = (event: T) => void;
+/**
+ * Subscription to workflow events.
+ */
+export interface WorkflowEventSubscription {
+    /** Unsubscribe from events */
+    unsubscribe(): void;
+}
+/**
+ * Event filter for subscriptions.
+ */
+export interface WorkflowEventFilter {
+    /** Filter by event type(s) */
+    eventTypes?: WorkflowEventType[];
+    /** Filter by workflow ID */
+    workflowId?: string;
+    /** Filter by instance ID */
+    instanceId?: string;
+    /** Filter by runtime */
+    runtime?: RuntimeType;
+}
+/**
+ * Interface for workflow event bus.
+ */
+export interface IWorkflowEventBus {
+    /**
+     * Emit a workflow event.
+     */
+    emit(event: WorkflowEvent): void;
+    /**
+     * Subscribe to workflow events.
+     */
+    subscribe(handler: WorkflowEventHandler, filter?: WorkflowEventFilter): WorkflowEventSubscription;
+    /**
+     * Subscribe to a specific event type.
+     */
+    on<T extends WorkflowEventType>(eventType: T, handler: WorkflowEventHandler<Extract<WorkflowEvent, {
+        type: T;
+    }>>): WorkflowEventSubscription;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/workflows/events.d.ts.map

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

package/dist/workflows/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Workflow Contracts - Public Exports
+ *
+ * This module exports all types and utilities for the workflow system.
+ * These contracts define the interface between:
+ * - TypeScript (browser) and Python (cloud) runtimes
+ * - Local (Pyodide) and Cloud (server) execution
+ * - Workflow definitions and runtime implementations
+ *
+ * @see plans/active/workflow/README.md
+ */
+export type { BackoffStrategy, NonRetryableError, ParallelConfig, ParallelDecoratorOptions, RetryConfig, RetryDecoratorOptions, RetryableError, StepDecoratorOptions, StepDefinition, WaitForConfig, WaitForDecoratorOptions, WorkflowDecoratorOptions, WorkflowDefinition, WorkflowError, WorkflowMetadata, } from './definition';
+export type { CellTriggerPayload as InstanceCellTriggerPayload, InstanceError, InstanceErrorType, ManualTriggerPayload as InstanceManualTriggerPayload, InstanceQueryOptions, InstanceQueryResult, RecordTriggerPayload as InstanceRecordTriggerPayload, ScheduleTriggerPayload as InstanceScheduleTriggerPayload, InstanceSortOption, SpawnedTriggerPayload as InstanceSpawnedTriggerPayload, InstanceStatus, InstanceSummary, WebhookTriggerPayload as InstanceWebhookTriggerPayload, JsonSerializable, RetryAttempt, RetryState, StepError, StepHistory, StepStatus, Timer, TimerType, TriggerEventData, WorkflowInstance, WorkflowState, } from './instance';
+export type { Account, AnalyticsAppAPI, AnalyticsEvent, AppRegistry, AxisConfig, BugTrackerAppAPI, CRMAppAPI, Chart, ChartConfig, Company, Contact, CreateCompanyParams, CreateContactParams, CreateDealParams, CreateInvoiceParams, CreateIssueParams, CreateProjectParams, CreateTransactionParams, Dashboard, DashboardWidget, Deal, DealOwner, EmailAction, EmailOptions, EventQuery, FilterConfig, FilterCriteria, FinanceAppAPI, FinancialReport, FindWorkflowsOptions, FunnelResult, FunnelStep, GetDealOptions, HttpClient, HttpRequestOptions, HttpResponse, ImportOptions, Invoice, Issue, LineItem, MetricValue, NotificationService, Payment, Pipeline, PipelineMetrics, PivotConfig, PivotTable, PivotValueConfig, Project, ReconcileParams, ReconcileResult, RecordFilter, RecordSort, RecordsAPI, RelationsAPI, RetentionPeriod, RetentionResult, SecretsManager, Sheet, SlackBlock, SlackOptions, SleepDuration, SortConfig, SpreadsheetAppAPI, TableInfo, TablesAPI, TimeRange, ToastOptions, Transaction, Transfer, UpdateDealParams, UpdateIssueParams, WorkflowCellValue, WorkflowConfig, WorkflowContext, WorkflowInstanceInfo, WorkflowsAPI, } from './context';
+export type { CellFilterCondition, CellTrigger, CellTriggerPayload, FilterOperator, ManualTrigger, ManualTriggerPayload, RecordCreatedTrigger, RecordDeletedTrigger, RecordFilterCondition, RecordTrigger, RecordTriggerBase, RecordTriggerPayload, RecordUpdatedTrigger, RegisteredTrigger, RelationLinkedTrigger, RelationTrigger, RelationTriggerPayload, RelationUnlinkedTrigger, ScheduleTrigger, ScheduleTriggerPayload, SpawnedTrigger, SpawnedTriggerPayload, TriggerConfig, TriggerEvent, TriggerMatch, TriggerPayload, TriggerType, WebhookAuth, WebhookAuthApiKey, WebhookAuthBearer, WebhookAuthHmac, WebhookAuthNone, WebhookMethod, WebhookTrigger, WebhookTriggerPayload, } from './triggers';
+export type { DeadLetterReason, ErrorCategory, IWorkflowEventBus, PromotionReason, StepCompletedEvent, StepFailedEvent, StepRetryEvent, StepSkippedEvent, StepStartedEvent, WakeReason, WorkflowCancelledEvent, WorkflowCompletedEvent, WorkflowDeadLetterEvent, WorkflowErrorEvent, WorkflowEvent, WorkflowEventBase, WorkflowEventFilter, WorkflowEventHandler, WorkflowEventSubscription, WorkflowEventType, WorkflowFailedEvent, WorkflowPausedEvent, WorkflowPromotedEvent, WorkflowResumedEvent, WorkflowSignal, WorkflowSleepingEvent, WorkflowStartedEvent, WorkflowWaitingEvent, WorkflowWokenEvent, } from './events';
+export type { AutoPromotionTrigger, IWorkflowRuntime, PromotionError, PromotionErrorType, PromotionState, PromotionStatus, PyodideConfig, PyodideState, RuntimeCapabilities, RuntimeConfig, RuntimeType, SerializedInstance, SerializedMetadata, SerializedStepHistory, SerializedTimer, StateValidationError, StateValidationResult, StepExecutionResult, } from './runtime';
+export type { IVersionRegistry, MigrationConfig, MigrationContext, MigrationFailure, MigrationFunction, MigrationOperation, MigrationStatus, SemanticVersion, StateMigrationResult, VersionMetadata, VersioningConfig, VersioningStrategy, WorkflowVersion, } from './versioning';
+//# sourceMappingURL=index.d.ts.map

package/dist/workflows/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,wBAAwB,EACxB,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,cAAc,EAEd,aAAa,EACb,uBAAuB,EAEvB,wBAAwB,EAExB,kBAAkB,EAElB,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAMtB,YAAY,EACV,kBAAkB,IAAI,0BAA0B,EAEhD,aAAa,EACb,iBAAiB,EACjB,oBAAoB,IAAI,4BAA4B,EAEpD,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,IAAI,4BAA4B,EACpD,sBAAsB,IAAI,8BAA8B,EACxD,kBAAkB,EAClB,qBAAqB,IAAI,6BAA6B,EACtD,cAAc,EACd,eAAe,EACf,qBAAqB,IAAI,6BAA6B,EACtD,gBAAgB,EAChB,YAAY,EAEZ,UAAU,EACV,SAAS,EAET,WAAW,EACX,UAAU,EAEV,KAAK,EACL,SAAS,EAET,gBAAgB,EAEhB,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC;AAMpB,YAAY,EACV,OAAO,EAEP,eAAe,EACf,cAAc,EAEd,WAAW,EACX,UAAU,EAEV,gBAAgB,EAEhB,SAAS,EACT,KAAK,EACL,WAAW,EACX,OAAO,EACP,OAAO,EACP,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,SAAS,EACT,eAAe,EACf,IAAI,EACJ,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,cAAc,EAEd,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,cAAc,EAEd,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,OAAO,EACP,KAAK,EACL,QAAQ,EACR,WAAW,EAEX,mBAAmB,EACnB,OAAO,EACP,QAAQ,EACR,eAAe,EACf,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,eAAe,EACf,YAAY,EACZ,UAAU,EACV,UAAU,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EAEf,cAAc,EACd,KAAK,EACL,UAAU,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EAEV,iBAAiB,EACjB,SAAS,EAET,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EAEd,eAAe,EACf,oBAAoB,EAEpB,YAAY,GACb,MAAM,WAAW,CAAC;AAMnB,YAAY,EACV,mBAAmB,EAEnB,WAAW,EACX,kBAAkB,EAClB,cAAc,EAEd,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EAErB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EAEpB,iBAAiB,EACjB,qBAAqB,EAErB,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EAEvB,eAAe,EACf,sBAAsB,EAEtB,cAAc,EACd,qBAAqB,EAErB,aAAa,EAEb,YAAY,EACZ,YAAY,EACZ,cAAc,EAEd,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,aAAa,EAEb,cAAc,EACd,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAMpB,YAAY,EACV,gBAAgB,EAChB,aAAa,EAEb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EAEf,cAAc,EACd,gBAAgB,EAEhB,gBAAgB,EAChB,UAAU,EACV,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAElB,aAAa,EAEb,iBAAiB,EACjB,mBAAmB,EAEnB,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EAEnB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EAErB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAMlB,YAAY,EACV,oBAAoB,EAEpB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAElB,cAAc,EACd,eAAe,EACf,aAAa,EAEb,YAAY,EAEZ,mBAAmB,EACnB,aAAa,EAEb,WAAW,EAEX,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAMnB,YAAY,EAEV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EAEjB,kBAAkB,EAClB,eAAe,EAEf,eAAe,EAEf,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAEhB,kBAAkB,EAElB,eAAe,GAChB,MAAM,cAAc,CAAC"}