dotdo 0.0.1 → 0.1.0

package/dist/workflows/compat/temporal/context.js

@@ -0,0 +1,309 @@
+/**
+ * Workflow Context Module
+ *
+ * AsyncLocalStorage-based context management for concurrent workflow execution.
+ * This enables multiple workflows to execute concurrently without global state pollution.
+ */
+import { AsyncLocalStorage } from 'async_hooks';
+import { WaitForEventManager } from '../../WaitForEventManager';
+import { InMemoryStepStorage } from '../../runtime';
+import { createStorageStrategy } from './storage';
+import { setGetCurrentWorkflowFn } from './determinism';
+// ============================================================================
+// ASYNCLOCALSTORAGE
+// ============================================================================
+// AsyncLocalStorage provides execution-scoped context
+// This works in both Node.js and Cloudflare Workers runtime
+const workflowContextStorage = new AsyncLocalStorage();
+// ============================================================================
+// CONTEXT ACCESSORS
+// ============================================================================
+/**
+ * Get the current workflow context from AsyncLocalStorage.
+ * Returns null if not executing within a workflow.
+ */
+export function getCurrentContext() {
+    return workflowContextStorage.getStore() ?? null;
+}
+/**
+ * Get the current workflow state for backward compatibility.
+ * This function bridges the old global state approach with the new context-based approach.
+ */
+export function getCurrentWorkflow() {
+    const ctx = getCurrentContext();
+    return ctx?.workflow ?? null;
+}
+/**
+ * Get the current patch state from context.
+ */
+export function getCurrentPatchState() {
+    const ctx = getCurrentContext();
+    return ctx?.patchState ?? null;
+}
+/**
+ * Set the current patch state within the context.
+ */
+export function setCurrentPatchState(patchState) {
+    const ctx = getCurrentContext();
+    if (ctx) {
+        ctx.patchState = patchState;
+    }
+}
+/**
+ * Execute a workflow function within a context.
+ * This ensures all workflow operations have access to the correct context.
+ */
+export function runWithContext(context, fn) {
+    return workflowContextStorage.run(context, fn);
+}
+/**
+ * Check if code is running within a workflow context.
+ * Useful for conditional behavior based on workflow vs non-workflow execution.
+ */
+export function inWorkflowContext() {
+    return getCurrentWorkflow() !== null;
+}
+// ============================================================================
+// GLOBAL REGISTRIES
+// ============================================================================
+// These are shared lookup tables, not per-execution state
+let globalStorage = new InMemoryStepStorage();
+let globalState = null;
+let globalWaitManager = null;
+let globalNamespace = 'default';
+// Workflow registry - shared across all executions for handle lookups
+const workflows = new Map();
+const workflowFunctions = new Map();
+/**
+ * Get the workflows registry (for client and child workflow access)
+ */
+export function getWorkflowsRegistry() {
+    return workflows;
+}
+/**
+ * Get the workflow functions registry
+ */
+export function getWorkflowFunctionsRegistry() {
+    return workflowFunctions;
+}
+/**
+ * Get the global namespace
+ */
+export function getGlobalNamespace() {
+    return globalNamespace;
+}
+/**
+ * Set the global namespace
+ */
+export function setGlobalNamespace(namespace) {
+    globalNamespace = namespace;
+}
+/**
+ * Get the global storage
+ */
+export function getGlobalStorage() {
+    return globalStorage;
+}
+/**
+ * Get the global wait manager
+ */
+export function getGlobalWaitManager() {
+    return globalWaitManager;
+}
+/**
+ * Get the current storage from context or fallback to global.
+ *
+ * This provides a single source of truth for storage access, consolidating
+ * the pattern of `ctx?.storage ?? globalStorage` that was previously
+ * scattered throughout the codebase.
+ */
+export function getCurrentStorage() {
+    const ctx = getCurrentContext();
+    return ctx?.storage ?? globalStorage;
+}
+/**
+ * Get the storage strategy for the current workflow context.
+ *
+ * This function creates the appropriate storage strategy based on the current context:
+ * - If a WorkflowStep is available, returns CFWorkflowsStorageStrategy (FREE sleeping, durable)
+ * - Otherwise, returns InMemoryStorageStrategy (fallback, BILLABLE sleeping)
+ *
+ * Note: Strategies are created on-demand rather than stored in context to avoid
+ * stale strategy references when WorkflowStep is set/cleared dynamically.
+ */
+export function getCurrentStorageStrategy() {
+    const ctx = getCurrentContext();
+    const step = ctx?.workflowStep ?? null;
+    const storage = getCurrentStorage();
+    return createStorageStrategy(step, storage);
+}
+// ============================================================================
+// CF WORKFLOWS STEP CONTEXT
+// ============================================================================
+/**
+ * Set the WorkflowStep context for the current workflow execution.
+ * Call this at the beginning of a CF Workflows run() method to enable
+ * native step.do() and step.sleep() execution.
+ *
+ * The step is stored in the workflow's AsyncLocalStorage context, ensuring
+ * isolation between concurrent workflow executions.
+ *
+ * @param step - The WorkflowStep from CF Workflows runtime, or null to clear
+ *
+ * @example
+ * ```typescript
+ * async run(event: WorkflowEvent, step: WorkflowStep) {
+ *   setWorkflowStep(step)
+ *   try {
+ *     // Temporal compat layer will use step.sleep() and step.do()
+ *     await sleep('5s')
+ *     await activities.processOrder(event.payload.orderId)
+ *   } finally {
+ *     clearWorkflowStep()
+ *   }
+ * }
+ * ```
+ */
+export function setWorkflowStep(step) {
+    const ctx = getCurrentContext();
+    if (ctx) {
+        ctx.workflowStep = step;
+    }
+}
+/**
+ * Clear the WorkflowStep context for the current workflow.
+ * Call this when exiting the CF Workflows context.
+ */
+export function clearWorkflowStep() {
+    const ctx = getCurrentContext();
+    if (ctx) {
+        ctx.workflowStep = null;
+    }
+}
+/**
+ * Get the current WorkflowStep context, or null if not in a CF Workflows context.
+ * Used internally by sleep() and proxyActivities() to route to native APIs.
+ */
+export function getWorkflowStep() {
+    const ctx = getCurrentContext();
+    return ctx?.workflowStep ?? null;
+}
+// ============================================================================
+// CONFIGURATION
+// ============================================================================
+/**
+ * Configure the Temporal compat layer globals.
+ *
+ * This is the single entry point for backend configuration. The storage
+ * strategy (CFWorkflows vs InMemory) is auto-detected at runtime based on
+ * whether a WorkflowStep context is available.
+ *
+ * ## Configuration Flow
+ *
+ * 1. Set `storage` for durable step persistence
+ * 2. Set `state` for DurableObject state access (required for waitForEvent)
+ * 3. Set `namespace` for workflow isolation
+ *
+ * ## Storage Strategy Selection (Automatic)
+ *
+ * - If WorkflowStep context is available: Uses CFWorkflowsStorageStrategy
+ *   - sleep() uses step.sleep() - FREE (no wall-clock billing)
+ *   - Activities use step.do() - DURABLE (survives restarts)
+ *
+ * - Otherwise: Uses InMemoryStorageStrategy (fallback)
+ *   - sleep() uses setTimeout - BILLABLE (consumes DO time)
+ *   - Activities execute directly - NOT DURABLE
+ *
+ * @example
+ * ```typescript
+ * import { configure } from '@dotdo/temporal'
+ *
+ * // In a Durable Object
+ * configure({
+ *   storage: new DOStepStorage(ctx.storage),
+ *   state: ctx.state,
+ *   namespace: 'production'
+ * })
+ * ```
+ */
+export function configure(opts) {
+    if (opts.storage)
+        globalStorage = opts.storage;
+    if (opts.state) {
+        globalState = opts.state;
+        globalWaitManager = new WaitForEventManager(opts.state);
+    }
+    if (opts.namespace)
+        globalNamespace = opts.namespace;
+}
+// ============================================================================
+// DURATION FORMATTING
+// ============================================================================
+/**
+ * Format a duration in milliseconds to CF Workflows format string.
+ * CF Workflows accepts durations like '5s', '1m', '1h', etc.
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Formatted duration string
+ */
+export function formatDurationForCF(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    if (ms < 60 * 1000) {
+        const seconds = Math.round(ms / 1000);
+        return `${seconds}s`;
+    }
+    if (ms < 60 * 60 * 1000) {
+        const minutes = Math.round(ms / (60 * 1000));
+        return `${minutes}m`;
+    }
+    const hours = Math.round(ms / (60 * 60 * 1000));
+    return `${hours}h`;
+}
+/**
+ * Generate a unique step ID for sleep operations.
+ * Uses per-workflow counter for deterministic IDs across concurrent workflows.
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Unique step ID
+ */
+export function generateSleepStepId(ms) {
+    const ctx = getCurrentContext();
+    if (!ctx?.workflow) {
+        // Fallback for non-workflow context (testing)
+        return `sleep:${formatDurationForCF(ms)}:${Date.now()}`;
+    }
+    ctx.workflow.sleepStepCounter++;
+    return `sleep:${formatDurationForCF(ms)}:${ctx.workflow.sleepStepCounter}`;
+}
+// ============================================================================
+// ID GENERATION
+// ============================================================================
+export function generateWorkflowId() {
+    return `wf_${crypto.randomUUID().replace(/-/g, '')}`;
+}
+export function generateRunId() {
+    return `run_${crypto.randomUUID().replace(/-/g, '')}`;
+}
+export function generateTimerId() {
+    return `timer_${crypto.randomUUID().replace(/-/g, '')}`;
+}
+// ============================================================================
+// STATE RESET
+// ============================================================================
+/**
+ * Reset global registries (for testing)
+ */
+export function resetGlobalState() {
+    workflows.clear();
+    workflowFunctions.clear();
+    globalNamespace = 'default';
+    clearWorkflowStep();
+}
+// ============================================================================
+// INITIALIZATION
+// ============================================================================
+// Wire up the determinism module to access current workflow
+setGetCurrentWorkflowFn(getCurrentWorkflow);
+//# sourceMappingURL=context.js.map

package/dist/workflows/compat/temporal/context.js.map

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

package/dist/workflows/compat/temporal/determinism.js

@@ -0,0 +1,216 @@
+/**
+ * Determinism Enforcement Module
+ *
+ * Runtime detection and prevention of non-deterministic patterns in workflows.
+ * Workflows MUST be deterministic to support replay - given the same inputs
+ * and history, they must produce the same sequence of commands.
+ */
+// Default configuration - warn in development, silent in production
+let determinismConfig = {
+    warnOnNonDeterministic: typeof process !== 'undefined' && process.env?.NODE_ENV !== 'production',
+};
+/**
+ * Configure determinism enforcement settings
+ *
+ * @example
+ * ```typescript
+ * import { configureDeterminism } from '@dotdo/temporal'
+ *
+ * // Disable warnings in tests
+ * configureDeterminism({ warnOnNonDeterministic: false })
+ *
+ * // Enable warnings in production for debugging
+ * configureDeterminism({ warnOnNonDeterministic: true })
+ * ```
+ */
+export function configureDeterminism(config) {
+    determinismConfig = { ...determinismConfig, ...config };
+}
+/**
+ * Get current determinism configuration
+ */
+export function getDeterminismConfig() {
+    return { ...determinismConfig };
+}
+// ============================================================================
+// WARNING CLASS
+// ============================================================================
+/**
+ * Warning class for tracking determinism violations.
+ * These are logged in development mode to help identify potential replay issues.
+ */
+export class WorkflowDeterminismWarning {
+    /** Type of non-deterministic operation detected */
+    type;
+    /** Human-readable message describing the violation */
+    message;
+    /** Stack trace showing where the violation occurred */
+    stack;
+    /** Workflow ID where the violation was detected (if available) */
+    workflowId;
+    /** Suggested alternative to use instead */
+    suggestion;
+    /** Timestamp when the warning was created */
+    timestamp;
+    constructor(type, message, suggestion, workflowId) {
+        this.type = type;
+        this.message = message;
+        this.suggestion = suggestion;
+        this.workflowId = workflowId;
+        this.timestamp = new Date();
+        this.stack = new Error().stack;
+    }
+    /**
+     * Format the warning for console output
+     */
+    toString() {
+        const workflowInfo = this.workflowId ? ` in workflow ${this.workflowId}` : '';
+        return `[WorkflowDeterminismWarning]${workflowInfo}: ${this.message}\n  Suggestion: ${this.suggestion}`;
+    }
+}
+// ============================================================================
+// WARNING TRACKING
+// ============================================================================
+/**
+ * Track warnings for analysis (limited to prevent memory leaks)
+ */
+const MAX_WARNINGS = 100;
+const determinismWarnings = [];
+/**
+ * Get all recorded determinism warnings
+ */
+export function getDeterminismWarnings() {
+    return determinismWarnings;
+}
+/**
+ * Clear all recorded determinism warnings
+ */
+export function clearDeterminismWarnings() {
+    determinismWarnings.length = 0;
+}
+// ============================================================================
+// WARNING FUNCTION
+// ============================================================================
+// Callback to get current workflow - set by context module to avoid circular deps
+let getCurrentWorkflowFn = null;
+/**
+ * Set the function to get current workflow (called by context module)
+ */
+export function setGetCurrentWorkflowFn(fn) {
+    getCurrentWorkflowFn = fn;
+}
+/**
+ * Record a determinism violation warning
+ */
+export function warnNonDeterministic(type, message, suggestion) {
+    // Only warn if enabled and we're in a workflow context
+    const workflow = getCurrentWorkflowFn?.();
+    if (!determinismConfig.warnOnNonDeterministic || !workflow) {
+        return;
+    }
+    const warning = new WorkflowDeterminismWarning(type, message, suggestion, workflow.workflowId);
+    // Store warning (with limit to prevent memory leaks)
+    if (determinismWarnings.length < MAX_WARNINGS) {
+        determinismWarnings.push(warning);
+    }
+    // Log to console in development
+    console.warn(warning.toString());
+}
+// ============================================================================
+// NON-DETERMINISTIC PATTERN DETECTION
+// ============================================================================
+// Store original functions for restoration and proxying
+const originalDateNow = Date.now;
+const originalMathRandom = Math.random;
+const originalFetch = typeof fetch !== 'undefined' ? fetch : undefined;
+const originalSetTimeout = setTimeout;
+const originalSetInterval = setInterval;
+/**
+ * Wrapped Date.now that warns about non-deterministic usage in workflows
+ */
+function wrappedDateNow() {
+    const workflow = getCurrentWorkflowFn?.();
+    if (workflow && determinismConfig.warnOnNonDeterministic) {
+        warnNonDeterministic('Date.now', 'Date.now() is non-deterministic and will return different values on replay', 'Use workflowNow() for deterministic timestamps');
+    }
+    return originalDateNow.call(Date);
+}
+/**
+ * Wrapped Math.random that warns about non-deterministic usage in workflows
+ */
+function wrappedMathRandom() {
+    const workflow = getCurrentWorkflowFn?.();
+    if (workflow && determinismConfig.warnOnNonDeterministic) {
+        warnNonDeterministic('Math.random', 'Math.random() is non-deterministic and will return different values on replay', 'Use random() for deterministic random numbers');
+    }
+    return originalMathRandom.call(Math);
+}
+/**
+ * Wrapped fetch that warns about non-deterministic usage in workflows
+ */
+function wrappedFetch(input, init) {
+    const workflow = getCurrentWorkflowFn?.();
+    if (workflow && determinismConfig.warnOnNonDeterministic) {
+        warnNonDeterministic('fetch', 'fetch() is non-deterministic - network responses can vary between executions', 'Use activities (proxyActivities) for network calls');
+    }
+    return originalFetch(input, init);
+}
+/**
+ * Wrapped setTimeout that warns about non-deterministic usage in workflows
+ */
+function wrappedSetTimeout(callback, ms, ...args) {
+    const workflow = getCurrentWorkflowFn?.();
+    if (workflow && determinismConfig.warnOnNonDeterministic) {
+        warnNonDeterministic('setTimeout', 'setTimeout() is non-deterministic - timing varies between executions', 'Use sleep() or createTimer() for durable delays');
+    }
+    return originalSetTimeout(callback, ms, ...args);
+}
+/**
+ * Wrapped setInterval that warns about non-deterministic usage in workflows
+ */
+function wrappedSetInterval(callback, ms, ...args) {
+    const workflow = getCurrentWorkflowFn?.();
+    if (workflow && determinismConfig.warnOnNonDeterministic) {
+        warnNonDeterministic('setInterval', 'setInterval() is non-deterministic - timing varies between executions', 'Use sleep() in a loop or schedule recurring activities');
+    }
+    return originalSetInterval(callback, ms, ...args);
+}
+// ============================================================================
+// DETECTION ENABLE/DISABLE
+// ============================================================================
+/**
+ * Enable determinism detection by patching global functions.
+ * This is automatically called when the module loads in development mode.
+ *
+ * Note: This patches global objects, which may affect other code.
+ * Use with caution in shared environments.
+ */
+export function enableDeterminismDetection() {
+    // Only patch if we're configured to warn
+    if (!determinismConfig.warnOnNonDeterministic) {
+        return;
+    }
+    // Patch Date.now
+    Date.now = wrappedDateNow;
+    // Patch Math.random
+    Math.random = wrappedMathRandom;
+    // Patch fetch if available
+    if (originalFetch && typeof globalThis !== 'undefined') {
+        ;
+        globalThis.fetch = wrappedFetch;
+    }
+    // Note: setTimeout and setInterval are intentionally not patched by default
+    // as they're used internally by the workflow runtime.
+}
+/**
+ * Disable determinism detection and restore original functions.
+ */
+export function disableDeterminismDetection() {
+    Date.now = originalDateNow;
+    Math.random = originalMathRandom;
+    if (originalFetch && typeof globalThis !== 'undefined') {
+        ;
+        globalThis.fetch = originalFetch;
+    }
+}
+//# sourceMappingURL=determinism.js.map

package/dist/workflows/compat/temporal/determinism.js.map

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

package/dist/workflows/compat/temporal/errors.js

@@ -0,0 +1,128 @@
+/**
+ * Error Classes Module
+ *
+ * Standard error types for workflow failures.
+ */
+// ============================================================================
+// APPLICATION FAILURE
+// ============================================================================
+/**
+ * Application-level failure that can be thrown from workflows or activities.
+ * Use this to signal business logic failures vs infrastructure errors.
+ *
+ * @example
+ * ```typescript
+ * import { ApplicationFailure } from '@dotdo/temporal'
+ *
+ * if (!user.hasPermission('admin')) {
+ *   throw new ApplicationFailure('User does not have admin permission', true)
+ * }
+ * ```
+ */
+export class ApplicationFailure extends Error {
+    nonRetryable;
+    details;
+    type = 'ApplicationFailure';
+    constructor(message, nonRetryable = false, details) {
+        super(message);
+        this.nonRetryable = nonRetryable;
+        this.details = details;
+        this.name = 'ApplicationFailure';
+    }
+    /**
+     * Create a non-retryable application failure
+     */
+    static nonRetryable(message, ...details) {
+        return new ApplicationFailure(message, true, details.length > 0 ? details : undefined);
+    }
+    /**
+     * Create a retryable application failure
+     */
+    static retryable(message, ...details) {
+        return new ApplicationFailure(message, false, details.length > 0 ? details : undefined);
+    }
+}
+// ============================================================================
+// ACTIVITY FAILURE
+// ============================================================================
+/**
+ * Failure thrown when an activity execution fails.
+ * Contains information about the failed activity and the underlying cause.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await activities.processPayment(order)
+ * } catch (error) {
+ *   if (error instanceof ActivityFailure) {
+ *     console.log(`Activity ${error.activityType} failed: ${error.cause?.message}`)
+ *   }
+ * }
+ * ```
+ */
+export class ActivityFailure extends Error {
+    activityType;
+    activityId;
+    cause;
+    type = 'ActivityFailure';
+    constructor(activityType, activityId, cause) {
+        super(`Activity ${activityType} (${activityId}) failed${cause ? `: ${cause.message}` : ''}`);
+        this.activityType = activityType;
+        this.activityId = activityId;
+        this.cause = cause;
+        this.name = 'ActivityFailure';
+    }
+}
+// ============================================================================
+// CHILD WORKFLOW FAILURE
+// ============================================================================
+/**
+ * Failure thrown when a child workflow execution fails.
+ * Contains information about the failed child workflow and the underlying cause.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await executeChild(childWorkflow, { workflowId: 'child-1' })
+ * } catch (error) {
+ *   if (error instanceof ChildWorkflowFailure) {
+ *     console.log(`Child workflow ${error.workflowType} failed: ${error.cause?.message}`)
+ *   }
+ * }
+ * ```
+ */
+export class ChildWorkflowFailure extends Error {
+    workflowType;
+    workflowId;
+    cause;
+    type = 'ChildWorkflowFailure';
+    constructor(workflowType, workflowId, cause) {
+        super(`Child workflow ${workflowType} (${workflowId}) failed${cause ? `: ${cause.message}` : ''}`);
+        this.workflowType = workflowType;
+        this.workflowId = workflowId;
+        this.cause = cause;
+        this.name = 'ChildWorkflowFailure';
+    }
+}
+// ============================================================================
+// TYPE GUARDS
+// ============================================================================
+/**
+ * Check if an error is an ApplicationFailure
+ */
+export function isApplicationFailure(error) {
+    return error instanceof ApplicationFailure;
+}
+/**
+ * Check if an error is an ActivityFailure
+ */
+export function isActivityFailure(error) {
+    return error instanceof ActivityFailure;
+}
+/**
+ * Check if an error is a ChildWorkflowFailure
+ */
+export function isChildWorkflowFailure(error) {
+    return error instanceof ChildWorkflowFailure;
+}
+//# sourceMappingURL=errors.js.map

package/dist/workflows/compat/temporal/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../workflows/compat/temporal/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAKhC;IACA;IALF,IAAI,GAAG,oBAA6B,CAAA;IAE7C,YACE,OAAe,EACN,eAAwB,KAAK,EAC7B,OAAmB;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAA;QAHL,iBAAY,GAAZ,YAAY,CAAiB;QAC7B,YAAO,GAAP,OAAO,CAAY;QAG5B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAe,EAAE,GAAG,OAAkB;QACxD,OAAO,IAAI,kBAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACxF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAe,EAAE,GAAG,OAAkB;QACrD,OAAO,IAAI,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACzF,CAAC;CACF;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAI7B;IACA;IACA;IALF,IAAI,GAAG,iBAA0B,CAAA;IAE1C,YACW,YAAoB,EACpB,UAAkB,EAClB,KAAa;QAEtB,KAAK,CAAC,YAAY,YAAY,KAAK,UAAU,WAAW,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAJnF,iBAAY,GAAZ,YAAY,CAAQ;QACpB,eAAU,GAAV,UAAU,CAAQ;QAClB,UAAK,GAAL,KAAK,CAAQ;QAGtB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;AAED,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAIlC;IACA;IACA;IALF,IAAI,GAAG,sBAA+B,CAAA;IAE/C,YACW,YAAoB,EACpB,UAAkB,EAClB,KAAa;QAEtB,KAAK,CAAC,kBAAkB,YAAY,KAAK,UAAU,WAAW,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAJzF,iBAAY,GAAZ,YAAY,CAAQ;QACpB,eAAU,GAAV,UAAU,CAAQ;QAClB,UAAK,GAAL,KAAK,CAAQ;QAGtB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AAED,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,KAAK,YAAY,kBAAkB,CAAA;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,YAAY,eAAe,CAAA;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,KAAK,YAAY,oBAAoB,CAAA;AAC9C,CAAC"}