@slowclap/rezi-core 0.1.0-fork.1

package/dist/keybindings/parser.js

@@ -0,0 +1,296 @@
+/**
+ * packages/core/src/keybindings/parser.ts — Parse keybinding strings to KeySequence.
+ *
+ * Why: Converts human-readable keybinding strings like "ctrl+s" or "g g" into
+ * structured KeySequence objects that can be used for matching. Handles single
+ * keys, modifier combinations, and chord sequences.
+ *
+ * Format examples:
+ *   - Single key: "a", "escape", "f1"
+ *   - With modifiers: "ctrl+s", "shift+a", "ctrl+shift+z"
+ *   - Chords (space-separated): "g g", "ctrl+k ctrl+c"
+ *
+ * @see docs/guide/input-and-focus.md
+ */
+import { KEY_NAME_TO_CODE, MODIFIER_NAMES, charToKeyCode } from "./keyCodes.js";
+const MAX_CHORD_LENGTH = 8;
+/**
+ * Parse a single key part (e.g., "ctrl+s" or just "a").
+ *
+ * @param part - Single key/modifier combination (no spaces)
+ * @returns ParsedKey or error
+ */
+function parseKeyPart(part) {
+    if (part.length === 0) {
+        return {
+            ok: false,
+            error: { code: "EMPTY_SEQUENCE", detail: "empty key part" },
+        };
+    }
+    // Split on "+" to get modifiers and key — preserve original case so that
+    // uppercase letters can be treated as implicit shift (e.g. "J" == "shift+j").
+    const pieces = part.split("+");
+    if (pieces.length === 0) {
+        return {
+            ok: false,
+            error: { code: "EMPTY_SEQUENCE", detail: "empty key part" },
+        };
+    }
+    let shift = false;
+    let ctrl = false;
+    let alt = false;
+    let meta = false;
+    let keyName;
+    const seenModifiers = new Set();
+    // Process each piece - all but last should be modifiers, last is the key
+    for (let i = 0; i < pieces.length; i++) {
+        const piece = pieces[i];
+        if (piece === undefined || piece.length === 0) {
+            return {
+                ok: false,
+                error: { code: "INVALID_KEY", detail: `empty component in "${part}"` },
+            };
+        }
+        const isLast = i === pieces.length - 1;
+        const pieceLower = piece.toLowerCase();
+        if (MODIFIER_NAMES.has(pieceLower)) {
+            // It's a modifier
+            let modifier = null;
+            switch (pieceLower) {
+                case "shift":
+                    modifier = "shift";
+                    shift = true;
+                    break;
+                case "ctrl":
+                case "control":
+                    modifier = "ctrl";
+                    ctrl = true;
+                    break;
+                case "alt":
+                    modifier = "alt";
+                    alt = true;
+                    break;
+                case "meta":
+                case "cmd":
+                case "command":
+                case "win":
+                case "super":
+                    modifier = "meta";
+                    meta = true;
+                    break;
+            }
+            if (modifier === null) {
+                return {
+                    ok: false,
+                    error: {
+                        code: "INVALID_MODIFIER",
+                        detail: `"${piece}" is not a valid modifier in "${part}"`,
+                    },
+                };
+            }
+            if (seenModifiers.has(modifier)) {
+                return {
+                    ok: false,
+                    error: {
+                        code: "INVALID_MODIFIER",
+                        detail: `duplicate modifier "${piece}" in "${part}"`,
+                    },
+                };
+            }
+            seenModifiers.add(modifier);
+            // If this is the last piece and it's a modifier, that's an error
+            if (isLast) {
+                return {
+                    ok: false,
+                    error: {
+                        code: "INVALID_KEY",
+                        detail: `modifier "${piece}" cannot be the final key in "${part}"`,
+                    },
+                };
+            }
+        }
+        else {
+            // It's a key name
+            if (!isLast) {
+                // Non-modifier in non-last position
+                return {
+                    ok: false,
+                    error: {
+                        code: "INVALID_MODIFIER",
+                        detail: `"${piece}" is not a valid modifier in "${part}"`,
+                    },
+                };
+            }
+            keyName = piece;
+        }
+    }
+    if (keyName === undefined) {
+        return {
+            ok: false,
+            error: { code: "INVALID_KEY", detail: `no key found in "${part}"` },
+        };
+    }
+    // Look up the key code
+    let keyCode = null;
+    // First try named keys (case-insensitive)
+    const namedCode = KEY_NAME_TO_CODE.get(keyName.toLowerCase());
+    if (namedCode !== undefined) {
+        keyCode = namedCode;
+    }
+    else if (keyName.length === 1) {
+        const charCode = keyName.charCodeAt(0);
+        // An uppercase letter with no other explicit modifiers implies shift
+        // (e.g. "J" == "shift+j"). When combined with ctrl/alt/meta (e.g. "Ctrl+S"),
+        // the uppercase is just a display convention — do not add implicit shift,
+        // since "Ctrl+S" is universally understood as ctrl+s without shift.
+        if (charCode >= 65 && charCode <= 90 && !ctrl && !alt && !meta) {
+            shift = true;
+        }
+        // Single character - convert to key code
+        keyCode = charToKeyCode(keyName);
+    }
+    if (keyCode === null) {
+        return {
+            ok: false,
+            error: { code: "INVALID_KEY", detail: `unknown key "${keyName}" in "${part}"` },
+        };
+    }
+    const mods = Object.freeze({ shift, ctrl, alt, meta });
+    return {
+        ok: true,
+        value: Object.freeze({ key: keyCode, mods }),
+    };
+}
+/**
+ * Parse a keybinding string into a KeySequence.
+ *
+ * Supports:
+ *   - Single keys: "a", "escape", "f1"
+ *   - With modifiers: "ctrl+s", "shift+a", "ctrl+shift+z"
+ *   - Chord sequences (space-separated): "g g", "ctrl+k ctrl+c"
+ *
+ * Modifier names (case-insensitive):
+ *   - shift
+ *   - ctrl, control
+ *   - alt
+ *   - meta, cmd, command, win, super
+ *
+ * Key names (case-insensitive):
+ *   - Single letters: a-z
+ *   - Digits: 0-9
+ *   - Named keys: escape, enter, tab, backspace, space, etc.
+ *   - Function keys: f1-f12
+ *   - Navigation: up, down, left, right, home, end, pageup, pagedown
+ *   - Editing: insert, delete
+ *
+ * @param input - Keybinding string to parse
+ * @returns ParseKeyResult with KeySequence or error
+ *
+ * @example
+ * ```ts
+ * parseKeySequence("ctrl+s")      // Single key with modifier
+ * parseKeySequence("g g")         // Two-key chord
+ * parseKeySequence("ctrl+k ctrl+c") // Chord with modifiers
+ * ```
+ */
+export function parseKeySequence(input) {
+    const trimmed = input.trim();
+    if (trimmed.length === 0) {
+        return {
+            ok: false,
+            error: { code: "EMPTY_SEQUENCE", detail: "keybinding string is empty" },
+        };
+    }
+    // Split on whitespace for chord sequences
+    const parts = trimmed.split(/\s+/);
+    const keys = [];
+    for (const part of parts) {
+        const result = parseKeyPart(part);
+        if (!result.ok) {
+            return result;
+        }
+        keys.push(result.value);
+    }
+    if (keys.length === 0) {
+        return {
+            ok: false,
+            error: { code: "EMPTY_SEQUENCE", detail: "no keys in sequence" },
+        };
+    }
+    if (keys.length > MAX_CHORD_LENGTH) {
+        return {
+            ok: false,
+            error: {
+                code: "INVALID_KEY",
+                detail: `chord sequence length ${String(keys.length)} exceeds maximum of ${String(MAX_CHORD_LENGTH)}`,
+            },
+        };
+    }
+    return {
+        ok: true,
+        value: Object.freeze({ keys: Object.freeze(keys) }),
+    };
+}
+/**
+ * Check if two ParsedKey objects are equal.
+ *
+ * @param a - First key
+ * @param b - Second key
+ * @returns True if keys and modifiers match
+ */
+export function keysEqual(a, b) {
+    return (a.key === b.key &&
+        a.mods.shift === b.mods.shift &&
+        a.mods.ctrl === b.mods.ctrl &&
+        a.mods.alt === b.mods.alt &&
+        a.mods.meta === b.mods.meta);
+}
+/**
+ * Convert a ParsedKey to a human-readable string (for debugging).
+ *
+ * @param key - ParsedKey to stringify
+ * @returns String representation like "ctrl+a" or "escape"
+ */
+export function keyToString(key) {
+    const parts = [];
+    if (key.mods.ctrl)
+        parts.push("ctrl");
+    if (key.mods.alt)
+        parts.push("alt");
+    if (key.mods.shift)
+        parts.push("shift");
+    if (key.mods.meta)
+        parts.push("meta");
+    // Find key name
+    let keyName;
+    for (const [name, code] of KEY_NAME_TO_CODE) {
+        if (code === key.key) {
+            keyName = name;
+            break;
+        }
+    }
+    if (keyName === undefined) {
+        // Try to convert from ASCII
+        if (key.key >= 65 && key.key <= 90) {
+            keyName = String.fromCharCode(key.key).toLowerCase();
+        }
+        else if (key.key >= 48 && key.key <= 57) {
+            keyName = String.fromCharCode(key.key);
+        }
+        else {
+            keyName = `key${String(key.key)}`;
+        }
+    }
+    parts.push(keyName);
+    return parts.join("+");
+}
+/**
+ * Convert a KeySequence to a human-readable string (for debugging).
+ *
+ * @param seq - KeySequence to stringify
+ * @returns String representation like "g g" or "ctrl+k ctrl+c"
+ */
+export function sequenceToString(seq) {
+    return seq.keys.map(keyToString).join(" ");
+}
+//# sourceMappingURL=parser.js.map

package/dist/keybindings/parser.js.map

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

package/dist/keybindings/types.d.ts

@@ -0,0 +1,133 @@
+/**
+ * packages/core/src/keybindings/types.ts — Keybinding system type definitions.
+ *
+ * Why: Defines the TypeScript representations of key sequences, bindings, and
+ * modal contexts. These types form the contract between the parser, matcher,
+ * and manager components of the keybinding system.
+ *
+ * @see docs/guide/input-and-focus.md
+ */
+/**
+ * Keyboard modifier state.
+ * Matches the ZREV modifier bitmask semantics.
+ */
+export type Modifiers = Readonly<{
+    shift: boolean;
+    ctrl: boolean;
+    alt: boolean;
+    meta: boolean;
+}>;
+/**
+ * A single parsed key with its code and modifiers.
+ * key is the numeric key code (see keyCodes.ts).
+ */
+export type ParsedKey = Readonly<{
+    key: number;
+    mods: Modifiers;
+}>;
+/**
+ * A sequence of keys forming a keybinding.
+ * Single keys have length 1; chord sequences have length > 1.
+ */
+export type KeySequence = Readonly<{
+    keys: readonly ParsedKey[];
+}>;
+/**
+ * Context passed to keybinding handlers.
+ * Provides state access and update capability.
+ *
+ * @typeParam S - Application state type
+ */
+export type KeyContext<S> = Readonly<{
+    /** Current committed application state (read-only) */
+    state: Readonly<S>;
+    /** Schedule a state update (same as app.update()) */
+    update: (updater: S | ((prev: Readonly<S>) => S)) => void;
+    /** Currently focused widget ID, or null if nothing focused */
+    focusedId: string | null;
+}>;
+/**
+ * A keybinding definition.
+ *
+ * @typeParam C - Context type (usually KeyContext<S>)
+ */
+export type KeyBinding<C> = Readonly<{
+    /** Parsed key sequence to match */
+    sequence: KeySequence;
+    /**
+     * Priority for conflict resolution.
+     * Higher priority bindings are checked first.
+     * Default is 0.
+     */
+    priority: number;
+    /** Handler function called when binding matches */
+    handler: (ctx: C) => void;
+    /**
+     * Optional condition function.
+     * When present, binding only matches if when(ctx) returns true.
+     */
+    when?: (ctx: C) => boolean;
+    /** Optional user-facing description for help overlays/introspection. */
+    description?: string;
+}>;
+/**
+ * A mode definition for modal keybindings (e.g., Vim normal/insert).
+ *
+ * @typeParam C - Context type (usually KeyContext<S>)
+ */
+export type ModeDefinition<C> = Readonly<{
+    /** Unique mode name */
+    name: string;
+    /** Bindings active in this mode */
+    bindings: readonly KeyBinding<C>[];
+    /**
+     * Optional parent mode name.
+     * If a binding is not found in this mode, the parent mode is searched.
+     */
+    parent?: string;
+}>;
+/**
+ * Result of chord matching.
+ *
+ * Discriminated union:
+ *   - "matched": Complete sequence matched, execute the binding
+ *   - "pending": Partial match, waiting for more keys
+ *   - "none": No match found
+ */
+export type MatchResult<C> = Readonly<{
+    kind: "matched";
+    binding: KeyBinding<C>;
+}> | Readonly<{
+    kind: "pending";
+}> | Readonly<{
+    kind: "none";
+}>;
+/**
+ * State for tracking in-progress chord sequences.
+ */
+export type ChordState = Readonly<{
+    /** Keys pressed so far in the current chord */
+    pendingKeys: readonly ParsedKey[];
+    /** Timestamp (ms) when chord started (for timeout detection) */
+    startTimeMs: number;
+}>;
+/**
+ * Error returned when parsing a key sequence string fails.
+ */
+export type KeyParseError = Readonly<{
+    /** Error code for programmatic handling */
+    code: "INVALID_KEY" | "EMPTY_SEQUENCE" | "INVALID_MODIFIER";
+    /** Human-readable detail */
+    detail: string;
+}>;
+/**
+ * Result of parsing a key sequence string.
+ */
+export type ParseKeyResult = Readonly<{
+    ok: true;
+    value: KeySequence;
+}> | Readonly<{
+    ok: false;
+    error: KeyParseError;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/keybindings/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/keybindings/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;CAC5B,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,QAAQ,CAAC;IACnC,sDAAsD;IACtD,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,qDAAqD;IACrD,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC;IAC1D,8DAA8D;IAC9D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,QAAQ,CAAC;IACnC,mCAAmC;IACnC,QAAQ,EAAE,WAAW,CAAC;IACtB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC;IAC1B;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC;IAC3B,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,QAAQ,CAAC;IACvC,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,QAAQ,EAAE,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IACrB,QAAQ,CAAC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,GACrD,QAAQ,CAAC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GAC7B,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,+CAA+C;IAC/C,WAAW,EAAE,SAAS,SAAS,EAAE,CAAC;IAClC,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IACnC,2CAA2C;IAC3C,IAAI,EAAE,aAAa,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;IAC5D,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC,GAC1C,QAAQ,CAAC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC,CAAC"}

package/dist/keybindings/types.js

@@ -0,0 +1,11 @@
+/**
+ * packages/core/src/keybindings/types.ts — Keybinding system type definitions.
+ *
+ * Why: Defines the TypeScript representations of key sequences, bindings, and
+ * modal contexts. These types form the contract between the parser, matcher,
+ * and manager components of the keybinding system.
+ *
+ * @see docs/guide/input-and-focus.md
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/keybindings/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/keybindings/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/layout/constraints.d.ts

@@ -0,0 +1,76 @@
+/**
+ * packages/core/src/layout/constraints.ts — Constraint resolution helpers.
+ *
+ * Why: Converts user-facing constraint values (numbers, "auto"/"full")
+ * into concrete cell sizes for a given parent rectangle.
+ */
+import type { ResolvedConstraintValues } from "../constraints/resolver.js";
+import type { Axis, LayoutConstraints, Rect, Size, SizeConstraintAtom } from "./types.js";
+export type ResolvedConstraints = Readonly<{
+    width: number | null;
+    height: number | null;
+    minWidth: number;
+    maxWidth: number;
+    minHeight: number;
+    maxHeight: number;
+    flex: number;
+    flexShrink: number;
+    flexBasis: number | null;
+    aspectRatio: number | null;
+}>;
+export type OverflowMode = "visible" | "hidden" | "scroll";
+export type LayoutOverflowMetadata = Readonly<{
+    scrollX: number;
+    scrollY: number;
+    contentWidth: number;
+    contentHeight: number;
+    viewportWidth: number;
+    viewportHeight: number;
+}>;
+export type ResolvedOverflow = Readonly<{
+    overflow: OverflowMode;
+    metadata: LayoutOverflowMetadata;
+}>;
+type OverflowPropBag = Readonly<{
+    overflow?: unknown;
+    scrollX?: unknown;
+    scrollY?: unknown;
+}>;
+type RectNode = Readonly<{
+    rect: Rect;
+}>;
+/**
+ * Resolve a single size constraint to a concrete cell count relative to `parentSize`.
+ *
+ * - numbers are returned as-is
+ * - "auto" resolves to `NaN` (caller decides meaning)
+ */
+export declare function resolveConstraint(value: SizeConstraintAtom, parentSize: number): number;
+export declare function resolveLayoutConstraints(props: LayoutConstraints, parent: Rect, mainAxis?: Axis, resolved?: ResolvedConstraintValues | null): ResolvedConstraints;
+/**
+ * Resolve absolute positioning offsets against a parent content rect.
+ */
+export declare function resolveAbsolutePosition(props: Readonly<{
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+    width?: unknown;
+    height?: unknown;
+}>, contentRect: Rect, naturalSize: Size): Rect;
+/**
+ * Measure content bounds from laid-out direct children.
+ *
+ * The returned size excludes container padding/border and represents only
+ * the child content footprint measured from the content origin.
+ */
+export declare function measureContentBounds(children: readonly RectNode[], contentOriginX: number, contentOriginY: number): Readonly<{
+    contentWidth: number;
+    contentHeight: number;
+}>;
+/**
+ * Resolve overflow mode and clamp requested scroll offsets to valid ranges.
+ */
+export declare function resolveOverflow(props: OverflowPropBag | null | undefined, viewportWidth: number, viewportHeight: number, contentWidth: number, contentHeight: number): ResolvedOverflow;
+export {};
+//# sourceMappingURL=constraints.d.ts.map

package/dist/layout/constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.d.ts","sourceRoot":"","sources":["../../src/layout/constraints.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAE3E,OAAO,KAAK,EACV,IAAI,EACJ,iBAAiB,EACjB,IAAI,EACJ,IAAI,EAEJ,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3D,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,sBAAsB,CAAC;CAClC,CAAC,CAAC;AAEH,KAAK,eAAe,GAAG,QAAQ,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAAC;AAEH,KAAK,QAAQ,GAAG,QAAQ,CAAC;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC;AAIzC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAQvF;AAwCD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,IAAI,EACZ,QAAQ,GAAE,IAAY,EACtB,QAAQ,CAAC,EAAE,wBAAwB,GAAG,IAAI,GACzC,mBAAmB,CAiCrB;AAiBD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC,EACF,WAAW,EAAE,IAAI,EACjB,WAAW,EAAE,IAAI,GAChB,IAAI,CAwDN;AAcD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,SAAS,QAAQ,EAAE,EAC7B,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,GACrB,QAAQ,CAAC;IACV,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC,CAqBD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EACzC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,gBAAgB,CAsBlB"}