deepclause-sdk 0.2.2 → 0.3.0

package/dist/forms/registry.d.ts

@@ -0,0 +1,119 @@
+/**
+ * The form registry: the host-owned state a form lives in.
+ *
+ * One registry per root session. It owns the spec, the values, a monotonic
+ * revision, and the waiters. `submit`/`close` (a *UI action*) produce a
+ * `FormChange`; `update`/`setIssues` (an *agent edit*) bump the revision for
+ * rendering but never wake a waiter — otherwise the agent's own edit would
+ * resolve its own `await_form`. See `docs/DML_FORMS.md` §7.
+ */
+import { type FormChange, type FormIssue, type FormSpec, type Json, type JsonObject } from './spec.js';
+export type FormOp = 'open' | 'update' | 'close';
+export interface FormEvent {
+    type: 'form';
+    op: FormOp;
+    formId: string;
+    revision: number;
+    spec?: FormSpec;
+    patch?: JsonObject;
+    values?: JsonObject;
+    issues?: FormIssue[];
+    state?: 'open' | 'submitted' | 'cancelled';
+    reason?: string;
+    source?: {
+        name?: string;
+        pid?: string;
+    };
+}
+export interface FormRecord {
+    formId: string;
+    spec: FormSpec;
+    values: JsonObject;
+    issues: FormIssue[];
+    revision: number;
+    /** Revision at which the form was opened; see `awaitingForms()`. */
+    openRevision: number;
+    state: 'open' | 'submitted' | 'cancelled';
+    changed?: string[];
+    source?: {
+        name?: string;
+        pid?: string;
+    };
+}
+export interface OpenOptions {
+    formId?: string;
+    values?: JsonObject;
+    source?: {
+        name?: string;
+        pid?: string;
+    };
+}
+export interface WaitOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface FormRegistryOptions {
+    onEvent?: (event: FormEvent) => void;
+}
+export declare class FormRegistry {
+    private readonly options;
+    private readonly forms;
+    private readonly waiters;
+    private readonly lastChange;
+    /** Per-form cursor: the last revision delivered to (or consumed by) a caller. */
+    private readonly delivered;
+    private counter;
+    constructor(options?: FormRegistryOptions);
+    /** Open (or replace) a form. Returns its id and revision. */
+    open(spec: FormSpec, options?: OpenOptions): {
+        formId: string;
+        revision: number;
+        values: JsonObject;
+    };
+    /** Merge-patch a form (agent edit). Bumps the revision; does not wake waiters. */
+    update(formId: string, patch: JsonObject): {
+        revision: number;
+        values: JsonObject;
+    } | undefined;
+    /** Attach per-field messages (agent edit). An empty list clears them. */
+    setIssues(formId: string, issues: FormIssue[]): {
+        revision: number;
+    } | undefined;
+    /**
+     * A UI action: record it, wake the waiters, and return the change. This is the
+     * only path that produces a change for `wait`.
+     */
+    submit(formId: string, action: string, values?: JsonObject, errors?: FormIssue[]): FormChange | undefined;
+    /** Close a form. Pending waiters resolve with `closed`. */
+    close(formId: string, state?: 'submitted' | 'cancelled', reason?: string): void;
+    /** Resolve every pending waiter (turn abort). */
+    cancelPending(action?: string): void;
+    /**
+     * Wait for a UI change. `since` defaults to the form's delivered cursor (set
+     * at open, advanced per delivery), so a caller need not track revisions and a
+     * submit that raced the wait is still delivered.
+     */
+    wait(formId: string, since?: number, options?: WaitOptions): Promise<FormChange>;
+    get(formId: string): FormRecord | undefined;
+    /**
+     * Forms that are open and left with a **change nobody has read**.
+     *
+     * That is either a form the model put in front of the person and never waited
+     * on (no change delivered since it was opened), or one it changed *after* the
+     * last delivery — showing errors for a rejected value, patching a computed
+     * field — which asks the person for another action nobody is waiting for.
+     *
+     * A conversational turn uses this so it cannot end with a form the person is
+     * still filling in: the submission would have nowhere to go.
+     */
+    awaitingForms(): FormRecord[];
+    list(): FormRecord[];
+    private wake;
+    private settle;
+    private removeWaiter;
+    private emit;
+}
+export declare function mergePatch(target: Json, patch: Json): Json;
+/** Dotted paths that differ between two value trees. */
+export declare function diffPaths(before: JsonObject, after: JsonObject, prefix?: string): string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/forms/registry.d.ts.map

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

package/dist/forms/registry.js

@@ -0,0 +1,256 @@
+/**
+ * The form registry: the host-owned state a form lives in.
+ *
+ * One registry per root session. It owns the spec, the values, a monotonic
+ * revision, and the waiters. `submit`/`close` (a *UI action*) produce a
+ * `FormChange`; `update`/`setIssues` (an *agent edit*) bump the revision for
+ * rendering but never wake a waiter — otherwise the agent's own edit would
+ * resolve its own `await_form`. See `docs/DML_FORMS.md` §7.
+ */
+import { applyDefaults, isPlainObject, } from './spec.js';
+export class FormRegistry {
+    options;
+    forms = new Map();
+    waiters = new Map();
+    lastChange = new Map();
+    /** Per-form cursor: the last revision delivered to (or consumed by) a caller. */
+    delivered = new Map();
+    counter = 0;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /** Open (or replace) a form. Returns its id and revision. */
+    open(spec, options = {}) {
+        const formId = options.formId ?? spec.id ?? `form_${++this.counter}`;
+        const existing = this.forms.get(formId);
+        const revision = (existing?.revision ?? 0) + 1;
+        const values = applyDefaults(spec, options.values ?? existing?.values ?? {});
+        const record = {
+            formId,
+            spec,
+            values,
+            issues: [],
+            revision,
+            openRevision: revision,
+            state: 'open',
+            source: options.source ?? existing?.source,
+        };
+        this.forms.set(formId, record);
+        this.delivered.set(formId, revision);
+        this.emit({ type: 'form', op: 'open', formId, revision, spec, values, issues: [], source: record.source });
+        return { formId, revision, values };
+    }
+    /** Merge-patch a form (agent edit). Bumps the revision; does not wake waiters. */
+    update(formId, patch) {
+        const record = this.forms.get(formId);
+        if (!record)
+            return undefined;
+        record.values = mergePatch(record.values, patch);
+        record.revision += 1;
+        this.emit({ type: 'form', op: 'update', formId, revision: record.revision, patch, values: record.values, issues: record.issues });
+        return { revision: record.revision, values: record.values };
+    }
+    /** Attach per-field messages (agent edit). An empty list clears them. */
+    setIssues(formId, issues) {
+        const record = this.forms.get(formId);
+        if (!record)
+            return undefined;
+        record.issues = issues;
+        record.revision += 1;
+        this.emit({
+            type: 'form',
+            op: 'update',
+            formId,
+            revision: record.revision,
+            values: record.values,
+            issues,
+        });
+        return { revision: record.revision };
+    }
+    /**
+     * A UI action: record it, wake the waiters, and return the change. This is the
+     * only path that produces a change for `wait`.
+     */
+    submit(formId, action, values = {}, errors = []) {
+        const record = this.forms.get(formId);
+        if (!record)
+            return undefined;
+        const previous = record.values;
+        record.values = { ...values };
+        record.revision += 1;
+        const changed = diffPaths(previous, record.values);
+        const change = {
+            formId,
+            revision: record.revision,
+            action,
+            values: record.values,
+            changed,
+            errors,
+        };
+        record.changed = changed;
+        this.lastChange.set(formId, change);
+        this.wake(formId, change);
+        return change;
+    }
+    /** Close a form. Pending waiters resolve with `closed`. */
+    close(formId, state = 'submitted', reason) {
+        const record = this.forms.get(formId);
+        if (!record)
+            return;
+        record.state = state;
+        record.revision += 1;
+        const change = { formId, revision: record.revision, action: 'closed', values: record.values };
+        this.lastChange.set(formId, change);
+        this.emit({ type: 'form', op: 'close', formId, revision: record.revision, state, values: record.values, reason });
+        this.wake(formId, change);
+    }
+    /** Resolve every pending waiter (turn abort). */
+    cancelPending(action = 'cancelled') {
+        for (const [formId, list] of this.waiters) {
+            const record = this.forms.get(formId);
+            const change = {
+                formId,
+                revision: record?.revision ?? 0,
+                action,
+                values: record?.values ?? {},
+            };
+            for (const waiter of list.splice(0))
+                this.settle(waiter, change);
+        }
+    }
+    /**
+     * Wait for a UI change. `since` defaults to the form's delivered cursor (set
+     * at open, advanced per delivery), so a caller need not track revisions and a
+     * submit that raced the wait is still delivered.
+     */
+    wait(formId, since, options = {}) {
+        const record = this.forms.get(formId);
+        if (!record) {
+            return Promise.resolve({ formId, revision: 0, action: 'unavailable', values: {} });
+        }
+        const cursor = since !== undefined && since >= 0 ? since : this.delivered.get(formId) ?? 0;
+        const existing = this.lastChange.get(formId);
+        if (existing && existing.revision > cursor) {
+            this.delivered.set(formId, existing.revision);
+            return Promise.resolve(existing);
+        }
+        if (record.state !== 'open') {
+            return Promise.resolve({ formId, revision: record.revision, action: 'closed', values: record.values });
+        }
+        return new Promise((resolve) => {
+            const waiter = { since: cursor, resolve };
+            if (options.timeoutMs !== undefined && options.timeoutMs > 0) {
+                waiter.timer = setTimeout(() => {
+                    this.removeWaiter(formId, waiter);
+                    this.settle(waiter, { formId, revision: record.revision, action: 'timeout', values: record.values });
+                }, options.timeoutMs);
+                waiter.timer.unref?.();
+            }
+            if (options.signal) {
+                const onAbort = () => {
+                    this.removeWaiter(formId, waiter);
+                    this.settle(waiter, { formId, revision: record.revision, action: 'cancelled', values: record.values });
+                };
+                if (options.signal.aborted) {
+                    onAbort();
+                    return;
+                }
+                waiter.onAbort = onAbort;
+                waiter.signal = options.signal;
+                options.signal.addEventListener('abort', onAbort, { once: true });
+            }
+            const list = this.waiters.get(formId) ?? [];
+            list.push(waiter);
+            this.waiters.set(formId, list);
+        });
+    }
+    get(formId) {
+        return this.forms.get(formId);
+    }
+    /**
+     * Forms that are open and left with a **change nobody has read**.
+     *
+     * That is either a form the model put in front of the person and never waited
+     * on (no change delivered since it was opened), or one it changed *after* the
+     * last delivery — showing errors for a rejected value, patching a computed
+     * field — which asks the person for another action nobody is waiting for.
+     *
+     * A conversational turn uses this so it cannot end with a form the person is
+     * still filling in: the submission would have nowhere to go.
+     */
+    awaitingForms() {
+        return [...this.forms.values()].filter((record) => {
+            if (record.state !== 'open')
+                return false;
+            const delivered = this.delivered.get(record.formId) ?? 0;
+            return delivered <= record.openRevision || record.revision > delivered;
+        });
+    }
+    list() {
+        return [...this.forms.values()];
+    }
+    // -------------------------------------------------------------------------
+    wake(formId, change) {
+        const list = this.waiters.get(formId);
+        if (!list)
+            return;
+        this.delivered.set(formId, change.revision);
+        for (const waiter of list.splice(0))
+            this.settle(waiter, change);
+    }
+    settle(waiter, change) {
+        if (waiter.timer) {
+            clearTimeout(waiter.timer);
+            waiter.timer = undefined;
+        }
+        // Detach the abort hook; a successful wake must not also cancel the waiter.
+        // (Calling `onAbort` here resolved every submitted form as `cancelled`.)
+        if (waiter.signal && waiter.onAbort) {
+            waiter.signal.removeEventListener('abort', waiter.onAbort);
+        }
+        waiter.onAbort = undefined;
+        waiter.resolve(change);
+    }
+    removeWaiter(formId, waiter) {
+        const list = this.waiters.get(formId);
+        if (!list)
+            return;
+        const index = list.indexOf(waiter);
+        if (index >= 0)
+            list.splice(index, 1);
+    }
+    emit(event) {
+        this.options.onEvent?.(event);
+    }
+}
+// ---------------------------------------------------------------------------
+// Merge patch (RFC 7386) and a shallow path diff
+// ---------------------------------------------------------------------------
+export function mergePatch(target, patch) {
+    if (!isPlainObject(patch))
+        return patch;
+    const base = isPlainObject(target) ? { ...target } : {};
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === null)
+            delete base[key];
+        else
+            base[key] = mergePatch(base[key], value);
+    }
+    return base;
+}
+/** Dotted paths that differ between two value trees. */
+export function diffPaths(before, after, prefix = '') {
+    const out = [];
+    const keys = [...new Set([...Object.keys(before), ...Object.keys(after)])].sort();
+    for (const key of keys) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        const a = before[key];
+        const b = after[key];
+        if (isPlainObject(a) && isPlainObject(b))
+            out.push(...diffPaths(a, b, path));
+        else if (JSON.stringify(a) !== JSON.stringify(b))
+            out.push(path);
+    }
+    return out;
+}
+//# sourceMappingURL=registry.js.map

package/dist/forms/registry.js.map

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

package/dist/forms/spec.d.ts

@@ -0,0 +1,193 @@
+/**
+ * The form representation: the declarative spec a harness (or a model) produces,
+ * the values a UI collects, and the two validators.
+ *
+ * Pure functions and types — no runtime, no registry, no events. See
+ * `docs/DML_FORMS.md` §5.
+ */
+export type Json = string | number | boolean | null | Json[] | {
+    [key: string]: Json;
+};
+export type JsonObject = {
+    [key: string]: Json;
+};
+/** Presentation hint only; validation never reads it. */
+export type Widget = 'text' | 'textarea' | 'number' | 'slider' | 'select' | 'radio' | 'multiselect' | 'checkbox' | 'switch' | 'date' | 'time' | 'datetime' | 'file' | 'hidden';
+export type FieldType = 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array' | 'null';
+export interface FieldOption {
+    value: string;
+    title?: string;
+    description?: string;
+}
+interface FieldBase {
+    /** Unique within its parent. The contract: rules and patches address fields by path. */
+    name: string;
+    type: FieldType;
+    required?: boolean;
+    default?: Json;
+    title?: string;
+    description?: string;
+    widget?: Widget;
+}
+export interface StringField extends FieldBase {
+    type: 'string';
+    format?: 'date' | 'time' | 'datetime' | 'email' | 'uri' | 'media';
+    enum?: string[];
+    options?: FieldOption[];
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+}
+export interface NumberField extends FieldBase {
+    type: 'number' | 'integer';
+    minimum?: number;
+    maximum?: number;
+    multipleOf?: number;
+}
+export interface BooleanField extends FieldBase {
+    type: 'boolean';
+}
+export interface ObjectField extends FieldBase {
+    type: 'object';
+    properties: Field[];
+}
+export interface ArrayField extends FieldBase {
+    type: 'array';
+    items: Field;
+    minItems?: number;
+    maxItems?: number;
+}
+export interface NullField extends FieldBase {
+    type: 'null';
+}
+export type Field = StringField | NumberField | BooleanField | ObjectField | ArrayField | NullField;
+export interface LayoutBase {
+    /** Grid columns this node occupies. */
+    span?: number;
+}
+export interface LayoutRow extends LayoutBase {
+    kind: 'row';
+    children: LayoutNode[];
+    gap?: number;
+    align?: 'start' | 'center' | 'end' | 'stretch';
+    wrap?: boolean;
+}
+export interface LayoutColumn extends LayoutBase {
+    kind: 'column';
+    children: LayoutNode[];
+    gap?: number;
+}
+export interface LayoutGrid extends LayoutBase {
+    kind: 'grid';
+    columns: number;
+    gap?: number;
+    children: LayoutNode[];
+}
+export interface LayoutBox extends LayoutBase {
+    kind: 'box';
+    title?: string;
+    description?: string;
+    variant?: 'plain' | 'card' | 'fieldset';
+    children: LayoutNode[];
+}
+export interface LayoutTabs extends LayoutBase {
+    kind: 'tabs';
+    tabs: Array<{
+        title: string;
+        children: LayoutNode[];
+    }>;
+}
+export interface LayoutField extends LayoutBase {
+    kind: 'field';
+    /** Path of a declared field. */
+    field: string;
+    widget?: Widget;
+    label?: string;
+    help?: string;
+}
+export interface LayoutText extends LayoutBase {
+    kind: 'text';
+    text: string;
+    variant?: 'body' | 'caption' | 'heading';
+}
+export interface LayoutDivider extends LayoutBase {
+    kind: 'divider';
+}
+export interface LayoutSpacer extends LayoutBase {
+    kind: 'spacer';
+    size?: number;
+}
+export type LayoutNode = LayoutRow | LayoutColumn | LayoutGrid | LayoutBox | LayoutTabs | LayoutField | LayoutText | LayoutDivider | LayoutSpacer;
+export interface FormAction {
+    name: string;
+    title: string;
+    kind?: 'primary' | 'default' | 'danger' | 'link';
+    confirm?: string;
+    /** Paths to validate before the action is allowed, or `hard`/`all`. */
+    validates?: 'all' | 'hard' | string[];
+}
+export interface FormSpec {
+    version: 1;
+    id?: string;
+    title?: string;
+    description?: string;
+    fields: Field[];
+    layout?: LayoutNode[];
+    initial?: JsonObject;
+    actions?: FormAction[];
+    ui?: {
+        submitOnEnter?: boolean;
+        dense?: boolean;
+    };
+    meta?: JsonObject;
+}
+/** A per-field message, from the host (shape) or the harness (domain). */
+export interface FormIssue {
+    path: string;
+    level: 'error' | 'warning';
+    message: string;
+}
+/** What a UI sends back when the user acts. */
+export interface FormChange {
+    formId: string;
+    /** Monotonic; the race-free cursor. */
+    revision: number;
+    action: string;
+    values: JsonObject;
+    changed?: string[];
+    errors?: FormIssue[];
+}
+export declare const DEFAULT_ACTIONS: FormAction[];
+export declare function actionsOf(spec: FormSpec): FormAction[];
+export interface FieldRef {
+    path: string;
+    field: Field;
+}
+/** Every field, depth-first, with its dotted path (`a.b`, `items[0].c` is the value form). */
+export declare function walkFields(fields: Field[], prefix?: string): FieldRef[];
+/** The declared fields, keyed by path. */
+export declare function fieldMap(spec: FormSpec): Map<string, Field>;
+/** Resolve defaults into a complete value set (deepest-first). Never mutates input. */
+export declare function applyDefaults(spec: FormSpec, values?: JsonObject): JsonObject;
+export declare function isPlainObject(value: unknown): value is JsonObject;
+/**
+ * Accept a spec the way a caller would naturally write one.
+ *
+ * `version` and a field's `type` are boilerplate: a model asked for "a form with
+ * an amount and a reason" should be able to answer `{title: "Refund", fields:
+ * [{name: "amount", type: "number"}, {name: "reason"}]}` and have it work.
+ * A bare string field is shorthand for a `string` field of that name.
+ *
+ * This only fills gaps. Anything genuinely broken (no fields, a duplicate or
+ * illegal name, a layout that references an unknown field) is still reported by
+ * `validateSpec`.
+ */
+export declare function normalizeSpec(raw: unknown): FormSpec;
+/** True when `type` is one this runtime knows. */
+export declare function isFieldType(type: unknown): type is FieldType;
+export declare function validateSpec(spec: FormSpec): FormIssue[];
+export declare function validateValues(spec: FormSpec, values: JsonObject): FormIssue[];
+/** Read a dotted field path out of a value tree. */
+export declare function valueAtPath(values: JsonObject, path: string): Json | undefined;
+export {};
+//# sourceMappingURL=spec.d.ts.map

package/dist/forms/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/forms/spec.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AACvF,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAEjD,yDAAyD;AACzD,MAAM,MAAM,MAAM,GACd,MAAM,GACN,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,aAAa,GACb,UAAU,GACV,QAAQ,GACR,MAAM,GACN,MAAM,GACN,UAAU,GACV,MAAM,GACN,QAAQ,CAAC;AAEb,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAElG,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,SAAS;IACjB,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;IAClE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,KAAK,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,KAAK,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAEpG,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,IAAI,EAAE,KAAK,CAAC;IACZ,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;IACxC,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,IAAI,EAAE,OAAO,CAAC;IACd,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,YAAY,GACZ,UAAU,GACV,SAAS,GACT,UAAU,GACV,WAAW,GACX,UAAU,GACV,aAAa,GACb,YAAY,CAAC;AAEjB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,EAAE,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAClD,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,0EAA0E;AAC1E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,eAAO,MAAM,eAAe,EAAE,UAAU,EAGvC,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,EAAE,CAEtD;AAMD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;CACd;AAED,8FAA8F;AAC9F,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,SAAK,GAAG,QAAQ,EAAE,CAQnE;AAED,0CAA0C;AAC1C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAI3D;AAMD,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAE,UAAe,GAAG,UAAU,CAIjF;AAiBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEjE;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,CAOpD;AAmBD,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,SAAS,CAE5D;AAMD,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,EAAE,CAsBxD;AA+ED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,EAAE,CAM9E;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAQ9E"}