@rezi-ui/core 0.1.0-alpha.60 → 0.1.0-alpha.63

package/dist/runtime/widgetMeta/focusContainers.d.ts

@@ -0,0 +1,44 @@
+import type { FocusZoneNavigation } from "../../widgets/types.js";
+import type { RuntimeInstance } from "../commit.js";
+export type FocusContainerKind = "focusZone" | "focusTrap" | "modal";
+export type ContainerInfo = {
+    kind: "zone" | "trap";
+    id: string;
+};
+export declare function recordFocusContainerId(seen: Map<string, FocusContainerKind>, id: string, kind: FocusContainerKind): void;
+/** Collected focus zone metadata. */
+export type CollectedZone = Readonly<{
+    id: string;
+    tabIndex: number;
+    navigation: FocusZoneNavigation;
+    columns: number;
+    wrapAround: boolean;
+    focusableIds: readonly string[];
+    parentZoneId?: string;
+    onEnter?: () => void;
+    onExit?: () => void;
+}>;
+/** Collected focus trap metadata. */
+export type CollectedTrap = Readonly<{
+    id: string;
+    kind?: "focusTrap" | "modal";
+    active: boolean;
+    returnFocusTo: string | null;
+    initialFocus: string | null;
+    focusableIds: readonly string[];
+}>;
+/**
+ * Collect all focus zones from a committed runtime tree.
+ *
+ * - Order: depth-first preorder
+ * - Each zone contains only the focusable ids directly within it (not in nested zones/traps)
+ */
+export declare function collectFocusZones(tree: RuntimeInstance): ReadonlyMap<string, CollectedZone>;
+/**
+ * Collect all focus traps from a committed runtime tree.
+ *
+ * - Order: depth-first preorder
+ * - Each trap contains only the focusable ids directly within it (not in nested zones/traps)
+ */
+export declare function collectFocusTraps(tree: RuntimeInstance): ReadonlyMap<string, CollectedTrap>;
+//# sourceMappingURL=focusContainers.d.ts.map

package/dist/runtime/widgetMeta/focusContainers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusContainers.d.ts","sourceRoot":"","sources":["../../../src/runtime/widgetMeta/focusContainers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;AAErE,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAUlE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,EACrC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,kBAAkB,GACvB,IAAI,CAMN;AAED,qCAAqC;AACrC,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,mBAAmB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC,CAAC;AAEH,qCAAqC;AACrC,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC,CAAC,CAAC;AA0DH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CA0F3F;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAuD3F"}

package/dist/runtime/widgetMeta/focusContainers.js

@@ -0,0 +1,190 @@
+import { ZrUiError } from "../../abi.js";
+import { isEnabledInteractive, isFocusableInteractive } from "./helpers.js";
+function duplicateFocusContainerDetail(id, firstKind, secondKind) {
+    return `Duplicate focus container id "${id}". First: <${firstKind}>, second: <${secondKind}>. Hint: focusZone, focusTrap, and modal ids must be unique across the tree.`;
+}
+export function recordFocusContainerId(seen, id, kind) {
+    const existing = seen.get(id);
+    if (existing !== undefined) {
+        throw new ZrUiError("ZRUI_DUPLICATE_ID", duplicateFocusContainerDetail(id, existing, kind));
+    }
+    seen.set(id, kind);
+}
+/**
+ * Collect focusable ids from a subtree (not traversing into nested zones/traps/modals).
+ */
+function collectFocusableIdsInSubtree(node) {
+    const out = [];
+    const stack = [node];
+    while (stack.length > 0) {
+        const cur = stack.pop();
+        if (!cur)
+            continue;
+        // Don't traverse into nested zones or traps.
+        if (cur.vnode.kind === "focusZone" ||
+            cur.vnode.kind === "focusTrap" ||
+            cur.vnode.kind === "modal") {
+            continue;
+        }
+        const id = isFocusableInteractive(cur.vnode) ? isEnabledInteractive(cur.vnode) : null;
+        if (id !== null)
+            out.push(id);
+        for (let i = cur.children.length - 1; i >= 0; i--) {
+            const c = cur.children[i];
+            if (c)
+                stack.push(c);
+        }
+    }
+    return Object.freeze(out);
+}
+function collectFocusableIdsInTrapSubtree(node) {
+    const out = [];
+    const stack = [node];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (!current)
+            continue;
+        if (current.vnode.kind === "focusTrap" || current.vnode.kind === "modal") {
+            continue;
+        }
+        const id = isFocusableInteractive(current.vnode) ? isEnabledInteractive(current.vnode) : null;
+        if (id !== null)
+            out.push(id);
+        for (let i = current.children.length - 1; i >= 0; i--) {
+            const child = current.children[i];
+            if (child)
+                stack.push(child);
+        }
+    }
+    return Object.freeze(out);
+}
+/**
+ * Collect all focus zones from a committed runtime tree.
+ *
+ * - Order: depth-first preorder
+ * - Each zone contains only the focusable ids directly within it (not in nested zones/traps)
+ */
+export function collectFocusZones(tree) {
+    const m = new Map();
+    const seen = new Map();
+    const stack = [
+        { node: tree, parentZoneId: null },
+    ];
+    while (stack.length > 0) {
+        const item = stack.pop();
+        if (!item)
+            continue;
+        const node = item.node;
+        if (node.vnode.kind === "focusZone") {
+            const props = node.vnode.props;
+            const id = typeof props.id === "string" && props.id.length > 0 ? props.id : null;
+            if (id !== null) {
+                recordFocusContainerId(seen, id, "focusZone");
+                const tabIndex = typeof props.tabIndex === "number" ? props.tabIndex : 0;
+                const navigation = props.navigation === "linear" ||
+                    props.navigation === "grid" ||
+                    props.navigation === "none"
+                    ? props.navigation
+                    : "linear";
+                const columns = typeof props.columns === "number" && props.columns > 0 ? props.columns : 1;
+                const wrapAround = props.wrapAround !== false;
+                const onEnter = typeof props.onEnter === "function" ? props.onEnter : undefined;
+                const onExit = typeof props.onExit === "function" ? props.onExit : undefined;
+                // Collect focusable ids from zone children (not traversing into nested zones/traps)
+                const focusableIds = [];
+                for (const child of node.children) {
+                    if (child.vnode.kind === "focusZone" ||
+                        child.vnode.kind === "focusTrap" ||
+                        child.vnode.kind === "modal") {
+                        continue;
+                    }
+                    const childFocusables = collectFocusableIdsInSubtree(child);
+                    focusableIds.push(...childFocusables);
+                }
+                const zone = {
+                    id,
+                    tabIndex,
+                    navigation,
+                    columns,
+                    wrapAround,
+                    focusableIds: Object.freeze(focusableIds),
+                };
+                if (item.parentZoneId !== null) {
+                    zone.parentZoneId = item.parentZoneId;
+                }
+                if (onEnter !== undefined) {
+                    zone.onEnter = onEnter;
+                }
+                if (onExit !== undefined) {
+                    zone.onExit = onExit;
+                }
+                m.set(id, Object.freeze(zone));
+            }
+        }
+        // Continue traversing children for nested zones
+        let childParentZoneId = item.parentZoneId;
+        if (node.vnode.kind === "focusZone") {
+            const zoneId = node.vnode.props.id;
+            if (typeof zoneId === "string" && zoneId.length > 0) {
+                childParentZoneId = zoneId;
+            }
+        }
+        for (let i = node.children.length - 1; i >= 0; i--) {
+            const c = node.children[i];
+            if (c)
+                stack.push({ node: c, parentZoneId: childParentZoneId ?? null });
+        }
+    }
+    return m;
+}
+/**
+ * Collect all focus traps from a committed runtime tree.
+ *
+ * - Order: depth-first preorder
+ * - Each trap contains only the focusable ids directly within it (not in nested zones/traps)
+ */
+export function collectFocusTraps(tree) {
+    const m = new Map();
+    const seen = new Map();
+    const stack = [tree];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (!node)
+            continue;
+        if (node.vnode.kind === "focusTrap" || node.vnode.kind === "modal") {
+            const props = node.vnode.props;
+            const id = typeof props.id === "string" && props.id.length > 0 ? props.id : null;
+            if (id !== null) {
+                recordFocusContainerId(seen, id, node.vnode.kind);
+                const active = node.vnode.kind === "modal" ? true : props.active === true;
+                const returnFocusTo = typeof props.returnFocusTo === "string" ? props.returnFocusTo : null;
+                const initialFocus = typeof props.initialFocus === "string" ? props.initialFocus : null;
+                // Collect focusable ids from trap children, including nested zones but
+                // excluding nested traps/modals which manage their own focus scope.
+                const focusableIds = [];
+                for (const child of node.children) {
+                    if (child.vnode.kind === "focusTrap" || child.vnode.kind === "modal")
+                        continue;
+                    const childFocusables = collectFocusableIdsInTrapSubtree(child);
+                    focusableIds.push(...childFocusables);
+                }
+                m.set(id, Object.freeze({
+                    id,
+                    kind: node.vnode.kind,
+                    active,
+                    returnFocusTo,
+                    initialFocus,
+                    focusableIds: Object.freeze(focusableIds),
+                }));
+            }
+        }
+        // Continue traversing children for nested traps
+        for (let i = node.children.length - 1; i >= 0; i--) {
+            const c = node.children[i];
+            if (c)
+                stack.push(c);
+        }
+    }
+    return m;
+}
+//# sourceMappingURL=focusContainers.js.map

package/dist/runtime/widgetMeta/focusContainers.js.map

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

package/dist/runtime/widgetMeta/focusInfo.d.ts

@@ -0,0 +1,19 @@
+import type { RuntimeInstance } from "../commit.js";
+/** Structured accessibility/focus semantics for a focusable widget. */
+export type FocusInfo = Readonly<{
+    id: string | null;
+    kind: RuntimeInstance["vnode"]["kind"] | null;
+    accessibleLabel: string | null;
+    visibleLabel: string | null;
+    required: boolean;
+    errors: readonly string[];
+    announcement: string | null;
+}>;
+export type FieldContext = Readonly<{
+    label: string | null;
+    required: boolean;
+    error: string | null;
+}>;
+export declare function readFieldContext(vnode: RuntimeInstance["vnode"]): FieldContext | null;
+export declare function buildFocusInfo(vnode: RuntimeInstance["vnode"], id: string, fieldStack: readonly FieldContext[]): FocusInfo;
+//# sourceMappingURL=focusInfo.d.ts.map

package/dist/runtime/widgetMeta/focusInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusInfo.d.ts","sourceRoot":"","sources":["../../../src/runtime/widgetMeta/focusInfo.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,uEAAuE;AACvE,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;IAC/B,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC,CAAC;AAmHH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,YAAY,GAAG,IAAI,CAYrF;AA8CD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,EAC/B,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,SAAS,YAAY,EAAE,GAClC,SAAS,CAoBX"}

package/dist/runtime/widgetMeta/focusInfo.js

@@ -0,0 +1,172 @@
+import { getSelectDisplayText } from "../../widgets/select.js";
+import { readNonEmptyString } from "./helpers.js";
+const EMPTY_ERRORS = Object.freeze([]);
+function readFocusableVisibleLabel(vnode) {
+    switch (vnode.kind) {
+        case "button":
+            return readNonEmptyString(vnode.props.label);
+        case "link": {
+            const props = vnode.props;
+            return readNonEmptyString(props.label) ?? readNonEmptyString(props.url);
+        }
+        case "slider":
+            return readNonEmptyString(vnode.props.label);
+        case "checkbox":
+            return readNonEmptyString(vnode.props.label);
+        case "select": {
+            const props = vnode.props;
+            const value = typeof props.value === "string" ? props.value : "";
+            const options = Array.isArray(props.options)
+                ? props.options
+                : [];
+            return readNonEmptyString(getSelectDisplayText(value, options, readNonEmptyString(props.placeholder) ?? undefined));
+        }
+        case "radioGroup": {
+            const props = vnode.props;
+            const value = typeof props.value === "string" ? props.value : "";
+            const options = Array.isArray(props.options)
+                ? props.options
+                : [];
+            for (const option of options) {
+                if (typeof option?.value === "string" &&
+                    option.value === value &&
+                    typeof option.label === "string") {
+                    return readNonEmptyString(option.label);
+                }
+            }
+            return null;
+        }
+        case "commandPalette":
+            return readNonEmptyString(vnode.props.placeholder);
+        case "filePicker":
+            return readNonEmptyString(vnode.props.rootPath);
+        case "diffViewer": {
+            const diff = vnode.props.diff;
+            if (diff && typeof diff === "object") {
+                return readNonEmptyString(diff.newPath) ?? readNonEmptyString(diff.oldPath);
+            }
+            return null;
+        }
+        case "toolApprovalDialog": {
+            const request = vnode.props.request;
+            if (request && typeof request === "object") {
+                return readNonEmptyString(request.toolName);
+            }
+            return null;
+        }
+        default:
+            return null;
+    }
+}
+function kindToAnnouncementPrefix(kind) {
+    switch (kind) {
+        case "button":
+            return "Button";
+        case "link":
+            return "Link";
+        case "input":
+            return "Input";
+        case "slider":
+            return "Slider";
+        case "virtualList":
+            return "List";
+        case "table":
+            return "Table";
+        case "tree":
+            return "Tree";
+        case "select":
+            return "Select";
+        case "checkbox":
+            return "Checkbox";
+        case "radioGroup":
+            return "Radio group";
+        case "commandPalette":
+            return "Command palette";
+        case "filePicker":
+            return "File picker";
+        case "fileTreeExplorer":
+            return "File tree explorer";
+        case "codeEditor":
+            return "Code editor";
+        case "diffViewer":
+            return "Diff viewer";
+        case "toolApprovalDialog":
+            return "Tool approval dialog";
+        case "logsConsole":
+            return "Logs console";
+        default:
+            return "Widget";
+    }
+}
+export function readFieldContext(vnode) {
+    if (vnode.kind !== "field")
+        return null;
+    const props = vnode.props;
+    return Object.freeze({
+        label: readNonEmptyString(props.label),
+        required: props.required === true,
+        error: readNonEmptyString(props.error),
+    });
+}
+function resolveFieldLabel(fieldStack) {
+    for (let i = fieldStack.length - 1; i >= 0; i--) {
+        const label = fieldStack[i]?.label;
+        if (label)
+            return label;
+    }
+    return null;
+}
+function resolveFieldRequired(fieldStack) {
+    for (let i = fieldStack.length - 1; i >= 0; i--) {
+        if (fieldStack[i]?.required === true)
+            return true;
+    }
+    return false;
+}
+function resolveFieldErrors(fieldStack) {
+    if (fieldStack.length === 0)
+        return EMPTY_ERRORS;
+    const out = [];
+    const seen = new Set();
+    for (let i = fieldStack.length - 1; i >= 0; i--) {
+        const error = fieldStack[i]?.error;
+        if (!error || seen.has(error))
+            continue;
+        seen.add(error);
+        out.push(error);
+    }
+    return out.length > 0 ? Object.freeze(out) : EMPTY_ERRORS;
+}
+function buildFocusAnnouncement(primary, required, errors) {
+    const parts = [primary];
+    if (required)
+        parts.push("Required");
+    if (errors.length === 1) {
+        const first = errors[0];
+        if (first)
+            parts.push(first);
+    }
+    else if (errors.length > 1) {
+        parts.push(`${String(errors.length)} validation errors`);
+    }
+    return parts.join(" — ");
+}
+export function buildFocusInfo(vnode, id, fieldStack) {
+    const accessibleLabel = readNonEmptyString(vnode.props.accessibleLabel);
+    const widgetLabel = readFocusableVisibleLabel(vnode);
+    const fieldLabel = resolveFieldLabel(fieldStack);
+    const visibleLabel = widgetLabel ?? fieldLabel;
+    const required = resolveFieldRequired(fieldStack);
+    const errors = resolveFieldErrors(fieldStack);
+    const primary = accessibleLabel ?? visibleLabel ?? `${kindToAnnouncementPrefix(vnode.kind)} ${id}`;
+    return Object.freeze({
+        id,
+        kind: vnode.kind,
+        accessibleLabel,
+        visibleLabel,
+        required,
+        errors,
+        announcement: buildFocusAnnouncement(primary, required, errors),
+    });
+}
+//# sourceMappingURL=focusInfo.js.map

package/dist/runtime/widgetMeta/focusInfo.js.map

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

package/dist/runtime/widgetMeta/helpers.d.ts

@@ -0,0 +1,47 @@
+import type { RuntimeInstance } from "../commit.js";
+import type { InstanceId } from "../instance.js";
+/** Extract interactive widget ID from a node with a valid `id` prop. */
+export declare function readInteractiveId(v: RuntimeInstance["vnode"]): string | null;
+export declare function isFocusableInteractive(v: RuntimeInstance["vnode"]): boolean;
+export declare function isEnabledInteractive(v: RuntimeInstance["vnode"]): string | null;
+export declare function readNonEmptyString(v: unknown): string | null;
+/** Metadata for an Input widget instance. */
+export type InputMeta = Readonly<{
+    instanceId: InstanceId;
+    value: string;
+    disabled: boolean;
+    readOnly: boolean;
+    multiline: boolean;
+    rows: number;
+    wordWrap: boolean;
+    onInput?: (value: string, cursor: number) => void;
+    onBlur?: () => void;
+}>;
+/**
+ * Collect focusable ids from a committed runtime tree.
+ *
+ * - Order: depth-first preorder
+ * - Children: left-to-right
+ * - Focusable set: enabled focusable interactive widgets
+ */
+export declare function collectFocusableIds(tree: RuntimeInstance): readonly string[];
+/**
+ * Collect a deterministic enabled map (interactive id -> enabled) from a committed runtime tree.
+ *
+ * Interactive widgets are always included when their `id` is a non-empty string;
+ * enabled is `true` iff `disabled !== true`.
+ */
+export declare function collectEnabledMap(tree: RuntimeInstance): ReadonlyMap<string, boolean>;
+/**
+ * Collect ids that can produce a "press" action (Buttons).
+ *
+ * Includes Buttons with a non-empty string id, regardless of disabled state.
+ */
+export declare function collectPressableIds(tree: RuntimeInstance): ReadonlySet<string>;
+/**
+ * Collect a deterministic map of Input id -> { instanceId, value, disabled } from a committed runtime tree.
+ *
+ * Inputs are included when their `id` is a non-empty string and `value` is a string.
+ */
+export declare function collectInputMetaById(tree: RuntimeInstance): ReadonlyMap<string, InputMeta>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/runtime/widgetMeta/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/runtime/widgetMeta/helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAM5E;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,CAO3E;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAgB/E;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI5D;AAED,6CAA6C;AAC7C,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,MAAM,EAAE,CAkB5E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BrF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC,MAAM,CAAC,CAoB9E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAgE1F"}