@siglo/testing 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Jerico de guzman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,190 @@
-# Temporary Holding Version
+# 09. Testing and Replay
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`@siglo/testing` provides a comprehensive, zero-flake test harness for deterministic execution, step mocking, spy inspection, virtual timers, execution trace snapshots, and production failure replay.
+
+---
+
+## 1. The Workflow Harness
+
+Create a test harness wrapping any workflow:
+
+```typescript
+import { createWorkflowHarness } from '@siglo/testing';
+import { orderWorkflow } from './order.workflow';
+
+const harness = createWorkflowHarness(orderWorkflow, {
+    services: {
+        paymentGateway: mockPaymentGateway
+    }
+});
+
+const result = await harness.run({ orderId: 'ord-100' });
+```
+
+---
+
+## 2. Spies and Assertions
+
+Inspect step calls, attempt counts, inputs, and outputs:
+
+```typescript
+const spy = harness.spyStep('validateOrder');
+
+await harness.run({ orderId: 'ord-100' });
+
+console.log(spy.called);     // true
+console.log(spy.callCount);  // 1
+console.log(spy.firstCall()?.input); // { orderId: 'ord-100' }
+
+// Built-in assertions
+harness.assertStepExecuted('validateOrder', 1);
+harness.assertStepRetried('chargeCard', 2);
+harness.assertStepFailed('riskyStep', /timeout/);
+```
+
+---
+
+## 3. Step Mocking
+
+Replace third-party dependencies or expensive external APIs without modifying workflow code:
+
+```typescript
+harness.mockStep('callStripe', async (param) => {
+    return { chargeId: 'ch_mock_123', status: 'SUCCESS' };
+});
+```
+
+---
+
+## 4. Fake Clock & Virtual Timers
+
+Control virtual timestamps for harness trace records without `setTimeout` delays in tests. Note that `FakeClock` advances its own timestamp counter and `tick()` flushes pending microtasks via `setImmediate`; it does not mock Node's global `Date.now` or `setTimeout`.
+
+```typescript
+import { FakeClock, createWorkflowHarness } from '@siglo/testing';
+
+const clock = new FakeClock(1000);
+const harness = createWorkflowHarness(workflow, { clock });
+
+// Advance virtual clock timestamp
+clock.advanceTime(5000);
+
+// Advance virtual clock and flush microtask loop
+await clock.tick(1000);
+```
+
+---
+
+## 5. Execution Records and Failure Replay
+
+Export sanitized execution records from real executions or staging runs and replay them locally:
+
+```typescript
+// 1. Export sanitized record from execution
+const record = harness.exportExecutionRecord({
+    excludeKeys: ['internalSecret']
+});
+
+// 2. Replay execution against workflow definition
+import { replayExecution } from '@siglo/testing';
+
+const replayResult = await replayExecution(record, orderWorkflow, {
+    substituteFixtures: {
+        // Replace flaky third-party API with recorded response
+        chargeCard: { success: true, txnId: 'txn_999' }
+    }
+});
+
+console.log(replayResult.matched);       // true or false
+console.log(replayResult.discrepancies); // List of mismatches if any
+```
+
+---
+
+## Minimal Example
+
+```typescript
+import { expect } from 'chai';
+import { createWorkflowHarness } from '@siglo/testing';
+import { Step, flow } from '@siglo/core';
+
+const s1 = Step.create('add', (p: { x: number }) => ({ res: p.x + 5 }));
+const wf = flow(s1);
+
+const harness = createWorkflowHarness(wf);
+const res = await harness.run({ x: 10 });
+expect(res.res).to.equal(15);
+harness.assertStepExecuted('add', 1);
+```
+
+---
+
+## Failure Example: Catching Regressions with Replay
+
+```typescript
+import { replayExecution } from '@siglo/testing';
+import { Step, flow } from '@siglo/core';
+
+// Modified workflow with a bug: calculates 10% tax instead of 5%
+const buggyWf = flow(
+    Step.create('calcTax', (p: { amount: number }) => ({ tax: p.amount * 0.10 }))
+);
+
+const recordedBaseline = {
+    input: { amount: 100 },
+    output: { tax: 5 }, // Expected 5 from baseline
+    trace: [],
+    recordedAt: new Date().toISOString()
+};
+
+const result = await replayExecution(recordedBaseline, buggyWf);
+
+if (!result.matched) {
+    console.error('Regression Detected:');
+    for (const diff of result.discrepancies) {
+        console.error(' -', diff);
+    }
+}
+```
+
+---
+
+## Testing Example: Full Mocking & Spying
+
+```typescript
+import { expect } from 'chai';
+import { createWorkflowHarness } from '@siglo/testing';
+import { Step, flow } from '@siglo/core';
+
+const s1 = Step.create('fetchUser', () => ({ user: 'Alice' }));
+const s2 = Step.create('emailUser', (p: any) => ({ sent: true }));
+const wf = flow(s1, s2);
+
+describe('Full Harness Suite', () => {
+    it('mocks step and asserts spy calls', async () => {
+        const harness = createWorkflowHarness(wf);
+        const emailSpy = harness.spyStep('emailUser');
+
+        harness.mockStep('fetchUser', () => ({ user: 'MockedUser' }));
+
+        const result = await harness.run();
+        expect(result.user).to.equal('MockedUser');
+        expect(emailSpy.called).to.be.true;
+        expect(emailSpy.firstCall()?.input.user).to.equal('MockedUser');
+    });
+});
+```
+
+---
+
+## Operational Caveats
+
+1. **Secret Redaction**: Always run `sanitizeExecutionRecord()` before writing execution records to bug reports or test fixtures. Defaults automatically redact passwords, API keys, and credit cards.
+2. **Deterministic Randomness**: If steps generate UUIDs or timestamps, inject a deterministic clock or generator via `param.$services` so replays produce matching records.
+
+---
+
+## API Reference Links
+
+- [TypeScript Reference](../../docs/10-typescript-reference.md)
+- [CLI Reference](../../docs/adapters/cli.md)

package/dist/index.d.ts

@@ -0,0 +1,115 @@
+import { StorageAdapter } from '@siglo/core';
+export interface StepTraceRecord {
+    stepName: string;
+    phase: 'start' | 'retry' | 'complete' | 'fail' | 'skip';
+    timestamp: number;
+    input: any;
+    output?: any;
+    error?: any;
+    attempt?: number;
+}
+export interface ExecutionRecord {
+    workflowVersion?: string | number;
+    input: any;
+    output?: any;
+    error?: any;
+    trace: StepTraceRecord[];
+    recordedAt: string;
+}
+export interface ReplayOptions {
+    substituteFixtures?: Record<string, any>;
+    excludeKeys?: string[];
+}
+export interface ReplayResult {
+    matched: boolean;
+    expectedOutput: any;
+    actualOutput: any;
+    discrepancies: string[];
+}
+export declare class FakeClock {
+    private currentTime;
+    constructor(initialTime?: number);
+    now(): number;
+    advanceTime(ms: number): number;
+    tick(ms?: number): Promise<void>;
+    reset(toTime?: number): void;
+}
+export declare class InMemoryStorageFake implements StorageAdapter {
+    readonly name = "in-memory-fake";
+    private checkpoints;
+    private cache;
+    contextChanges: any[];
+    onContextChange(event: any): Promise<void>;
+    saveCheckpoint(checkpoint: any): Promise<void>;
+    getCheckpoint(key: string): Promise<any>;
+    getCachedStep(key: string): Promise<any>;
+    setCachedStep(key: string, val: any): Promise<void>;
+    clear(): void;
+    getCheckpoints(): Map<string, any>;
+}
+export declare class StepSpy {
+    readonly name: string;
+    readonly calls: Array<{
+        input: any;
+        output?: any;
+        error?: any;
+        timestamp: number;
+    }>;
+    constructor(name: string);
+    get called(): boolean;
+    get callCount(): number;
+    firstCall(): {
+        input: any;
+        output?: any;
+        error?: any;
+        timestamp: number;
+    } | undefined;
+    lastCall(): {
+        input: any;
+        output?: any;
+        error?: any;
+        timestamp: number;
+    } | undefined;
+    record(call: {
+        input: any;
+        output?: any;
+        error?: any;
+        timestamp: number;
+    }): void;
+}
+export declare function sanitizeExecutionRecord(record: ExecutionRecord, options?: {
+    excludeKeys?: string[];
+}): ExecutionRecord;
+export interface HarnessOptions {
+    services?: Record<string, any>;
+    clock?: FakeClock;
+    storage?: InMemoryStorageFake;
+    recordTrace?: boolean;
+}
+export declare class WorkflowHarness {
+    private workflow;
+    private options;
+    private mocks;
+    private spies;
+    private trace;
+    private lastRunResult;
+    clock: FakeClock;
+    storage: InMemoryStorageFake;
+    constructor(workflow: any, options?: HarnessOptions);
+    mockStep(stepName: string, mockImpl: (param: any) => any): this;
+    spyStep(stepName: string): StepSpy;
+    getTrace(): StepTraceRecord[];
+    injectEvent(eventName: string, correlationKey: string, payload?: any): Promise<any>;
+    private wrapWorkflowSteps;
+    run(input?: any, execOptions?: any): Promise<any>;
+    execute(input?: any, execOptions?: any): Promise<any>;
+    assertStepExecuted(stepName: string, times?: number): void;
+    assertStepRetried(stepName: string, minAttempts?: number): void;
+    assertStepFailed(stepName: string, errorPattern?: string | RegExp): void;
+    exportExecutionRecord(options?: {
+        excludeKeys?: string[];
+    }): ExecutionRecord;
+}
+export declare function createWorkflowHarness(workflow: any, options?: HarnessOptions): WorkflowHarness;
+export declare function replayExecution(record: ExecutionRecord, workflow: any, options?: ReplayOptions): Promise<ReplayResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,342 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowHarness = exports.StepSpy = exports.InMemoryStorageFake = exports.FakeClock = void 0;
+exports.sanitizeExecutionRecord = sanitizeExecutionRecord;
+exports.createWorkflowHarness = createWorkflowHarness;
+exports.replayExecution = replayExecution;
+const core_1 = require("@siglo/core");
+class FakeClock {
+    currentTime;
+    constructor(initialTime = Date.now()) {
+        this.currentTime = initialTime;
+    }
+    now() {
+        return this.currentTime;
+    }
+    advanceTime(ms) {
+        this.currentTime += ms;
+        return this.currentTime;
+    }
+    tick(ms = 0) {
+        this.advanceTime(ms);
+        return new Promise(resolve => setImmediate(resolve));
+    }
+    reset(toTime = Date.now()) {
+        this.currentTime = toTime;
+    }
+}
+exports.FakeClock = FakeClock;
+class InMemoryStorageFake {
+    name = 'in-memory-fake';
+    checkpoints = new Map();
+    cache = new Map();
+    contextChanges = [];
+    async onContextChange(event) {
+        this.contextChanges.push(event);
+    }
+    async saveCheckpoint(checkpoint) {
+        const key = checkpoint.stackId || checkpoint.id || 'default';
+        this.checkpoints.set(key, JSON.parse(JSON.stringify(checkpoint)));
+    }
+    async getCheckpoint(key) {
+        const item = this.checkpoints.get(key);
+        return item ? JSON.parse(JSON.stringify(item)) : undefined;
+    }
+    async getCachedStep(key) {
+        return this.cache.get(key);
+    }
+    async setCachedStep(key, val) {
+        this.cache.set(key, val);
+    }
+    clear() {
+        this.checkpoints.clear();
+        this.cache.clear();
+        this.contextChanges = [];
+    }
+    getCheckpoints() {
+        return new Map(this.checkpoints);
+    }
+}
+exports.InMemoryStorageFake = InMemoryStorageFake;
+class StepSpy {
+    name;
+    calls = [];
+    constructor(name) {
+        this.name = name;
+    }
+    get called() {
+        return this.calls.length > 0;
+    }
+    get callCount() {
+        return this.calls.length;
+    }
+    firstCall() {
+        return this.calls[0];
+    }
+    lastCall() {
+        return this.calls[this.calls.length - 1];
+    }
+    record(call) {
+        this.calls.push(call);
+    }
+}
+exports.StepSpy = StepSpy;
+const DEFAULT_SECRET_KEYS = new Set([
+    'password',
+    'token',
+    'secret',
+    'authorization',
+    'apikey',
+    'api_key',
+    'creditcard',
+    'cardnumber',
+    'cvv',
+    'ssn',
+    'privatekey',
+    'private_key'
+]);
+function sanitizeExecutionRecord(record, options = {}) {
+    const customExcludes = new Set((options.excludeKeys || []).map(k => k.toLowerCase()));
+    const sanitizeVal = (val) => {
+        if (!val || typeof val !== 'object') {
+            return val;
+        }
+        if (Array.isArray(val)) {
+            return val.map(sanitizeVal);
+        }
+        const clean = {};
+        for (const [k, v] of Object.entries(val)) {
+            const lowerKey = k.toLowerCase();
+            if (DEFAULT_SECRET_KEYS.has(lowerKey) || customExcludes.has(lowerKey)) {
+                clean[k] = '[REDACTED]';
+            }
+            else {
+                clean[k] = sanitizeVal(v);
+            }
+        }
+        return clean;
+    };
+    return {
+        workflowVersion: record.workflowVersion,
+        recordedAt: record.recordedAt,
+        input: sanitizeVal(record.input),
+        output: sanitizeVal(record.output),
+        error: record.error ? (record.error.message || String(record.error)) : undefined,
+        trace: record.trace.map(t => ({
+            ...t,
+            input: sanitizeVal(t.input),
+            output: sanitizeVal(t.output)
+        }))
+    };
+}
+class WorkflowHarness {
+    workflow;
+    options;
+    mocks = new Map();
+    spies = new Map();
+    trace = [];
+    lastRunResult;
+    clock;
+    storage;
+    constructor(workflow, options = {}) {
+        this.workflow = workflow;
+        this.options = options;
+        this.clock = options.clock || new FakeClock();
+        this.storage = options.storage || new InMemoryStorageFake();
+    }
+    mockStep(stepName, mockImpl) {
+        this.mocks.set(stepName, mockImpl);
+        return this;
+    }
+    spyStep(stepName) {
+        let spy = this.spies.get(stepName);
+        if (!spy) {
+            spy = new StepSpy(stepName);
+            this.spies.set(stepName, spy);
+        }
+        return spy;
+    }
+    getTrace() {
+        return [...this.trace];
+    }
+    async injectEvent(eventName, correlationKey, payload) {
+        const res = await (0, core_1.resumeWorkflow)(this.workflow, correlationKey, payload, { pojo: true });
+        return (0, core_1.toPOJO)(res);
+    }
+    wrapWorkflowSteps() {
+        const rawSteps = (0, core_1.isFlow)(this.workflow) ? this.workflow.steps : [this.workflow];
+        const wrappedSteps = rawSteps.map((origStep) => {
+            const name = origStep.name || origStep.func || 'anonymous';
+            const mockFn = this.mocks.get(name);
+            const spy = this.spies.get(name);
+            const instrumentedAction = async (param) => {
+                const ts = this.clock.now();
+                this.trace.push({
+                    stepName: name,
+                    phase: 'start',
+                    timestamp: ts,
+                    input: (0, core_1.toPOJO)(param),
+                    attempt: param?.$attempt || 1
+                });
+                try {
+                    let out;
+                    if (mockFn) {
+                        out = await mockFn(param);
+                    }
+                    else {
+                        out = await origStep.action(param);
+                    }
+                    if (spy) {
+                        spy.record({ input: (0, core_1.toPOJO)(param), output: out, timestamp: ts });
+                    }
+                    this.trace.push({
+                        stepName: name,
+                        phase: 'complete',
+                        timestamp: this.clock.now(),
+                        input: (0, core_1.toPOJO)(param),
+                        output: out
+                    });
+                    return out;
+                }
+                catch (err) {
+                    if (spy) {
+                        spy.record({ input: (0, core_1.toPOJO)(param), error: err, timestamp: ts });
+                    }
+                    this.trace.push({
+                        stepName: name,
+                        phase: 'fail',
+                        timestamp: this.clock.now(),
+                        input: (0, core_1.toPOJO)(param),
+                        error: err?.message || String(err)
+                    });
+                    throw err;
+                }
+            };
+            const clone = Object.assign(Object.create(Object.getPrototypeOf(origStep)), origStep);
+            clone.action = instrumentedAction;
+            return clone;
+        });
+        return (0, core_1.flow)(...wrappedSteps);
+    }
+    async run(input = {}, execOptions = {}) {
+        (0, core_1.useStorage)(this.storage);
+        const instrumented = this.wrapWorkflowSteps();
+        const mergedServices = {
+            ...(this.options.services || {}),
+            ...(execOptions.services || {})
+        };
+        const result = await instrumented.run(input, {
+            ...execOptions,
+            services: mergedServices,
+            pojo: execOptions.pojo !== false
+        });
+        this.lastRunResult = result;
+        return result;
+    }
+    async execute(input = {}, execOptions = {}) {
+        return this.run(input, execOptions);
+    }
+    assertStepExecuted(stepName, times) {
+        const executions = this.trace.filter(t => t.stepName === stepName && t.phase === 'complete');
+        if (times !== undefined) {
+            if (executions.length !== times) {
+                throw new Error(`Expected step '${stepName}' to be executed ${times} time(s), but was executed ${executions.length} time(s).`);
+            }
+        }
+        else {
+            if (executions.length === 0) {
+                throw new Error(`Expected step '${stepName}' to be executed, but was not found in completed trace.`);
+            }
+        }
+    }
+    assertStepRetried(stepName, minAttempts = 2) {
+        const attempts = this.trace.filter(t => t.stepName === stepName && (t.phase === 'start' || t.phase === 'retry'));
+        if (attempts.length < minAttempts) {
+            throw new Error(`Expected step '${stepName}' to have at least ${minAttempts} attempts, but found ${attempts.length}.`);
+        }
+    }
+    assertStepFailed(stepName, errorPattern) {
+        const failures = this.trace.filter(t => t.stepName === stepName && t.phase === 'fail');
+        if (failures.length === 0) {
+            throw new Error(`Expected step '${stepName}' to fail, but no failure was recorded in trace.`);
+        }
+        if (errorPattern) {
+            const matched = failures.some(f => {
+                const msg = f.error || '';
+                return errorPattern instanceof RegExp ? errorPattern.test(msg) : msg.includes(errorPattern);
+            });
+            if (!matched) {
+                throw new Error(`Step '${stepName}' failed, but error did not match expected pattern '${errorPattern}'.`);
+            }
+        }
+    }
+    exportExecutionRecord(options) {
+        const lastComplete = [...this.trace].reverse().find(t => t.phase === 'complete');
+        const lastFail = [...this.trace].reverse().find(t => t.phase === 'fail');
+        const firstStart = this.trace.find(t => t.phase === 'start');
+        const rawRecord = {
+            workflowVersion: this.workflow?.workflowVersion,
+            input: firstStart?.input || {},
+            output: this.lastRunResult !== undefined ? this.lastRunResult : lastComplete?.output,
+            error: lastFail?.error,
+            trace: this.trace,
+            recordedAt: new Date(this.clock.now()).toISOString()
+        };
+        return sanitizeExecutionRecord(rawRecord, options);
+    }
+}
+exports.WorkflowHarness = WorkflowHarness;
+function createWorkflowHarness(workflow, options = {}) {
+    return new WorkflowHarness(workflow, options);
+}
+function normalizeForComparison(val) {
+    if (!val || typeof val !== 'object')
+        return val;
+    if (Array.isArray(val))
+        return val.map(normalizeForComparison);
+    const clean = {};
+    for (const [k, v] of Object.entries(val)) {
+        if (k === 'stackId' || k === '$stackId' || k === '$stepId' || k === '$steps' || k === '$history') {
+            continue;
+        }
+        clean[k] = normalizeForComparison(v);
+    }
+    return clean;
+}
+async function replayExecution(record, workflow, options = {}) {
+    const harness = createWorkflowHarness(workflow);
+    if (options.substituteFixtures) {
+        for (const [stepName, fixtureOutput] of Object.entries(options.substituteFixtures)) {
+            harness.mockStep(stepName, () => fixtureOutput);
+        }
+    }
+    let actualOutput;
+    let actualError;
+    try {
+        actualOutput = await harness.run(record.input);
+    }
+    catch (err) {
+        actualError = err.message || String(err);
+    }
+    const discrepancies = [];
+    const cleanExpected = normalizeForComparison(record.output ?? null);
+    const cleanActual = normalizeForComparison(actualOutput ?? null);
+    const expectedJson = JSON.stringify(cleanExpected);
+    const actualJson = JSON.stringify(cleanActual);
+    if (expectedJson !== actualJson) {
+        discrepancies.push(`Output mismatch: expected ${expectedJson}, received ${actualJson}`);
+    }
+    if (record.error && !actualError) {
+        discrepancies.push(`Expected execution to fail with error '${record.error}', but succeeded.`);
+    }
+    else if (!record.error && actualError) {
+        discrepancies.push(`Expected execution to succeed, but failed with '${actualError}'.`);
+    }
+    return {
+        matched: discrepancies.length === 0,
+        expectedOutput: record.output,
+        actualOutput,
+        discrepancies
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAqJA,0DAqCC;AAwLD,sDAEC;AAeD,0CA2CC;AA9aD,sCAOqB;AAiCrB,MAAa,SAAS;IACV,WAAW,CAAS;IAE5B,YAAY,cAAsB,IAAI,CAAC,GAAG,EAAE;QACxC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACnC,CAAC;IAED,GAAG;QACC,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED,WAAW,CAAC,EAAU;QAClB,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,KAAa,CAAC;QACf,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,SAAiB,IAAI,CAAC,GAAG,EAAE;QAC7B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;IAC9B,CAAC;CACJ;AAxBD,8BAwBC;AAED,MAAa,mBAAmB;IACnB,IAAI,GAAG,gBAAgB,CAAC;IACzB,WAAW,GAAG,IAAI,GAAG,EAAe,CAAC;IACrC,KAAK,GAAG,IAAI,GAAG,EAAe,CAAC;IAChC,cAAc,GAAU,EAAE,CAAC;IAElC,KAAK,CAAC,eAAe,CAAC,KAAU;QAC5B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,UAAe;QAChC,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,EAAE,IAAI,SAAS,CAAC;QAC7D,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW,EAAE,GAAQ;QACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK;QACD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;IAC7B,CAAC;IAED,cAAc;QACV,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;CACJ;AArCD,kDAqCC;AAED,MAAa,OAAO;IACP,IAAI,CAAS;IACb,KAAK,GAAwE,EAAE,CAAC;IAEzF,YAAY,IAAY;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,SAAS;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,IAAkE;QACrE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACJ;AA3BD,0BA2BC;AAED,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAChC,UAAU;IACV,OAAO;IACP,QAAQ;IACR,eAAe;IACf,QAAQ;IACR,SAAS;IACT,YAAY;IACZ,YAAY;IACZ,KAAK;IACL,KAAK;IACL,YAAY;IACZ,aAAa;CAChB,CAAC,CAAC;AAEH,SAAgB,uBAAuB,CACnC,MAAuB,EACvB,UAAsC,EAAE;IAExC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAEtF,MAAM,WAAW,GAAG,CAAC,GAAQ,EAAO,EAAE;QAClC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,GAAG,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,KAAK,GAAwB,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpE,KAAK,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACJ,KAAK,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC9B,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO;QACH,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;QAChC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;QAClC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QAChF,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1B,GAAG,CAAC;YACJ,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC;YAC3B,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;SAChC,CAAC,CAAC;KACN,CAAC;AACN,CAAC;AASD,MAAa,eAAe;IAChB,QAAQ,CAAM;IACd,OAAO,CAAiB;IACxB,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IAC/C,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;IACnC,KAAK,GAAsB,EAAE,CAAC;IAC9B,aAAa,CAAM;IACpB,KAAK,CAAY;IACjB,OAAO,CAAsB;IAEpC,YAAY,QAAa,EAAE,UAA0B,EAAE;QACnD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,SAAS,EAAE,CAAC;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,mBAAmB,EAAE,CAAC;IAChE,CAAC;IAED,QAAQ,CAAC,QAAgB,EAAE,QAA6B;QACpD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,QAAgB;QACpB,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,GAAG,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;IAED,QAAQ;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,cAAsB,EAAE,OAAa;QACtE,MAAM,GAAG,GAAG,MAAM,IAAA,qBAAc,EAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACzF,OAAO,IAAA,aAAM,EAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAEO,iBAAiB;QACrB,MAAM,QAAQ,GAAG,IAAA,aAAM,EAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/E,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAa,EAAE,EAAE;YAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,IAAI,WAAW,CAAC;YAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAEjC,MAAM,kBAAkB,GAAG,KAAK,EAAE,KAAU,EAAE,EAAE;gBAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;oBACZ,QAAQ,EAAE,IAAI;oBACd,KAAK,EAAE,OAAO;oBACd,SAAS,EAAE,EAAE;oBACb,KAAK,EAAE,IAAA,aAAM,EAAC,KAAK,CAAC;oBACpB,OAAO,EAAE,KAAK,EAAE,QAAQ,IAAI,CAAC;iBAChC,CAAC,CAAC;gBAEH,IAAI,CAAC;oBACD,IAAI,GAAQ,CAAC;oBACb,IAAI,MAAM,EAAE,CAAC;wBACT,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC9B,CAAC;yBAAM,CAAC;wBACJ,GAAG,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACvC,CAAC;oBAED,IAAI,GAAG,EAAE,CAAC;wBACN,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAA,aAAM,EAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;oBACrE,CAAC;oBAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;wBACZ,QAAQ,EAAE,IAAI;wBACd,KAAK,EAAE,UAAU;wBACjB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;wBAC3B,KAAK,EAAE,IAAA,aAAM,EAAC,KAAK,CAAC;wBACpB,MAAM,EAAE,GAAG;qBACd,CAAC,CAAC;oBACH,OAAO,GAAG,CAAC;gBACf,CAAC;gBAAC,OAAO,GAAQ,EAAE,CAAC;oBAChB,IAAI,GAAG,EAAE,CAAC;wBACN,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAA,aAAM,EAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;oBACpE,CAAC;oBACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;wBACZ,QAAQ,EAAE,IAAI;wBACd,KAAK,EAAE,MAAM;wBACb,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;wBAC3B,KAAK,EAAE,IAAA,aAAM,EAAC,KAAK,CAAC;wBACpB,KAAK,EAAE,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC;qBACrC,CAAC,CAAC;oBACH,MAAM,GAAG,CAAC;gBACd,CAAC;YACL,CAAC,CAAC;YAEF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YACtF,KAAK,CAAC,MAAM,GAAG,kBAAkB,CAAC;YAClC,OAAO,KAAK,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,OAAO,IAAA,WAAI,EAAC,GAAG,YAAY,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAa,EAAE,EAAE,cAAmB,EAAE;QAC5C,IAAA,iBAAU,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC9C,MAAM,cAAc,GAAG;YACnB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;YAChC,GAAG,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC;SAClC,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE;YACzC,GAAG,WAAW;YACd,QAAQ,EAAE,cAAc;YACxB,IAAI,EAAE,WAAW,CAAC,IAAI,KAAK,KAAK;SACnC,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;QAC5B,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAa,EAAE,EAAE,cAAmB,EAAE;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACxC,CAAC;IAED,kBAAkB,CAAC,QAAgB,EAAE,KAAc;QAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC;QAC7F,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,IAAI,UAAU,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,oBAAoB,KAAK,8BAA8B,UAAU,CAAC,MAAM,WAAW,CAAC,CAAC;YACnI,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,yDAAyD,CAAC,CAAC;YACzG,CAAC;QACL,CAAC;IACL,CAAC;IAED,iBAAiB,CAAC,QAAgB,EAAE,cAAsB,CAAC;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC;QACjH,IAAI,QAAQ,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,sBAAsB,WAAW,wBAAwB,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3H,CAAC;IACL,CAAC;IAED,gBAAgB,CAAC,QAAgB,EAAE,YAA8B;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;QACvF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,kDAAkD,CAAC,CAAC;QAClG,CAAC;QACD,IAAI,YAAY,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;gBAC9B,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC1B,OAAO,YAAY,YAAY,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YAChG,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,uDAAuD,YAAY,IAAI,CAAC,CAAC;YAC9G,CAAC;QACL,CAAC;IACL,CAAC;IAED,qBAAqB,CAAC,OAAoC;QACtD,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC;QACjF,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;QACzE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC;QAE7D,MAAM,SAAS,GAAoB;YAC/B,eAAe,EAAG,IAAI,CAAC,QAAgB,EAAE,eAAe;YACxD,KAAK,EAAE,UAAU,EAAE,KAAK,IAAI,EAAE;YAC9B,MAAM,EAAE,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,EAAE,MAAM;YACpF,KAAK,EAAE,QAAQ,EAAE,KAAK;YACtB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;SACvD,CAAC;QAEF,OAAO,uBAAuB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;CACJ;AA7KD,0CA6KC;AAED,SAAgB,qBAAqB,CAAC,QAAa,EAAE,UAA0B,EAAE;IAC7E,OAAO,IAAI,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,sBAAsB,CAAC,GAAQ;IACpC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;YAC/F,SAAS;QACb,CAAC;QACD,KAAK,CAAC,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAEM,KAAK,UAAU,eAAe,CACjC,MAAuB,EACvB,QAAa,EACb,UAAyB,EAAE;IAE3B,MAAM,OAAO,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAEhD,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACjF,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IAED,IAAI,YAAiB,CAAC;IACtB,IAAI,WAAgB,CAAC;IACrB,IAAI,CAAC;QACD,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAChB,WAAW,GAAG,GAAG,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,MAAM,aAAa,GAAG,sBAAsB,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,sBAAsB,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAE/C,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;QAC9B,aAAa,CAAC,IAAI,CAAC,6BAA6B,YAAY,cAAc,UAAU,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,aAAa,CAAC,IAAI,CAAC,0CAA0C,MAAM,CAAC,KAAK,mBAAmB,CAAC,CAAC;IAClG,CAAC;SAAM,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,WAAW,EAAE,CAAC;QACtC,aAAa,CAAC,IAAI,CAAC,mDAAmD,WAAW,IAAI,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO;QACH,OAAO,EAAE,aAAa,CAAC,MAAM,KAAK,CAAC;QACnC,cAAc,EAAE,MAAM,CAAC,MAAM;QAC7B,YAAY;QACZ,aAAa;KAChB,CAAC;AACN,CAAC"}

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@siglo/testing",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "Deterministic test utilities, workflow harness, mocks, fake clock, and replay tooling for Siglo",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "test": "npm run build && mocha -r tsx 'src/**/*.test.ts'"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jsoftgem/siglo.git",
+    "directory": "packages/testing"
+  },
+  "author": "Jerico de Guzman",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/jsoftgem/siglo/issues"
+  },
+  "homepage": "https://github.com/jsoftgem/siglo#readme",
+  "dependencies": {
+    "@siglo/core": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/chai": "^5.2.3",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^26.6.5",
+    "chai": "^3.5.0",
+    "mocha": "^12.0.3",
+    "tsx": "^4.23.15",
+    "typescript": "~5.7.0"
+  }
+}