@elaraai/east-ui 1.0.28 → 1.0.29

package/dist/src/collections/board/index.js

@@ -0,0 +1,282 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `Board` — the single-day assignment board: an areas × shifts grid where
+ * each cell holds multiple people as chips under the shared event-state
+ * grammar (committed / proposed / rejected, with the `model` flavour
+ * rendering as a dashed ghost). Takes the flat tables a dataset naturally
+ * provides — areas, shifts, people, and assignments — each with a
+ * chart-style field encoding; the factory joins assignments to people by
+ * person key and groups them into cells by `area × shift`. Optional
+ * `requirements` add per-cell coverage (`n/required` numerals, open-slot
+ * placeholders, under / over tones).
+ *
+ * Declares the drag & drop **target** role: `id` + `sources` connect it to
+ * sibling Libraries, and every completed drag (add / move / remove) funnels
+ * through one `onDrag` callback as a `DragEventType` value. The component
+ * renders no built-in user-facing copy — every string it shows arrives as
+ * data or a prop.
+ *
+ * @packageDocumentation
+ */
+import { East, Expr, variant, some, none, ArrayType, StringType, StructType, } from "@elaraai/east";
+import { UIComponentType } from "../../component.js";
+import { mapRows } from "../../shared/reify.js";
+import { DensityType } from "../../style/interaction.js";
+import {} from "../../contracts/drag.js";
+import { PlannerStateType } from "../planner/types.js";
+import { BoardModeType, BoardEntityType, BoardAssignmentType, BoardRequirementType, BoardRootType, } from "./types.js";
+// Re-export types
+export { BoardModeType, BoardEntityType, BoardAssignmentType, BoardRequirementType, BoardRootType, } from "./types.js";
+function resolveEntities(rows, mapper) {
+    if (mapper === undefined) {
+        return East.value(rows, ArrayType(BoardEntityType));
+    }
+    return mapRows(East.value(rows), BoardEntityType, (row) => {
+        const r = mapper(row);
+        if (r instanceof Expr)
+            return East.value(r, BoardEntityType);
+        return East.value({
+            key: r.key,
+            label: r.label,
+            sublabel: r.sublabel !== undefined ? some(r.sublabel) : none,
+        }, BoardEntityType);
+    });
+}
+function buildRoot(areas, shifts, people, assignments, config) {
+    const assignmentMapper = config.assignment;
+    const resolvedAssignments = assignmentMapper === undefined
+        ? East.value(assignments, ArrayType(BoardAssignmentType))
+        : mapRows(East.value(assignments), BoardAssignmentType, (row) => {
+            const r = assignmentMapper(row);
+            if (r instanceof Expr)
+                return East.value(r, BoardAssignmentType);
+            return East.value({
+                key: r.key,
+                person: r.person,
+                area: r.area,
+                shift: r.shift,
+                state: r.state,
+            }, BoardAssignmentType);
+        });
+    const requirementMapper = config.requirement;
+    const resolvedRequirements = config.requirements === undefined
+        ? none
+        : some(requirementMapper === undefined
+            ? East.value(config.requirements, ArrayType(BoardRequirementType))
+            : mapRows(East.value(config.requirements), BoardRequirementType, (row) => {
+                const r = requirementMapper(row);
+                if (r instanceof Expr)
+                    return East.value(r, BoardRequirementType);
+                return East.value({
+                    area: r.area,
+                    shift: r.shift,
+                    required: r.required,
+                }, BoardRequirementType);
+            }));
+    const mode = config.mode !== undefined
+        ? (typeof config.mode === "string" ? East.value(variant(config.mode, null), BoardModeType) : config.mode)
+        : East.value(variant("published", null), BoardModeType);
+    const density = config.density !== undefined
+        ? some(typeof config.density === "string" ? East.value(variant(config.density, null), DensityType) : config.density)
+        : none;
+    const maxVisible = config.maxVisible !== undefined
+        ? some(typeof config.maxVisible === "number" ? BigInt(config.maxVisible) : config.maxVisible)
+        : none;
+    return East.value(variant("Board", {
+        id: config.id,
+        sources: East.value(config.sources ?? [], ArrayType(StringType)),
+        mode,
+        areaHeader: config.areaHeader !== undefined ? some(config.areaHeader) : none,
+        areaWidth: config.areaWidth !== undefined ? some(config.areaWidth) : none,
+        areas: resolveEntities(areas, config.area),
+        shifts: resolveEntities(shifts, config.shift),
+        people: resolveEntities(people, config.person),
+        assignments: resolvedAssignments,
+        requirements: resolvedRequirements,
+        density,
+        maxVisible,
+        summary: config.summary !== undefined ? some(config.summary) : none,
+        canAssign: config.canAssign !== undefined ? some(config.canAssign) : none,
+        onDrag: config.onDrag !== undefined ? some(config.onDrag) : none,
+        onSelect: config.onSelect !== undefined ? some(config.onSelect) : none,
+        onAccept: config.onAccept !== undefined ? some(config.onAccept) : none,
+        onAddAt: config.onAddAt !== undefined ? some(config.onAddAt) : none,
+    }), UIComponentType);
+}
+/**
+ * Creates a Board — single-day areas × shifts assignment scheduling.
+ *
+ * @typeParam A - The areas-table input
+ * @typeParam S - The shifts-table input
+ * @typeParam P - The people-table input
+ * @typeParam X - The assignments-table input
+ * @param areas - The area rows (one grid row each)
+ * @param shifts - The shift rows (one grid column each, in order)
+ * @param people - The people rows (chip faces, joined by the encoded person key)
+ * @param assignments - The assignment rows (grouped into cells by area × shift)
+ * @param config - The Board configuration ({@link BoardConfig})
+ * @returns An East expression of `UIComponentType`
+ *
+ * @example
+ * ```ts
+ * import { East, variant } from "@elaraai/east";
+ * import { Board, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const example = East.function([], UIComponentType, _$ =>
+ *     Board.Root(
+ *         [{ id: "icu", name: "ICU" }],
+ *         [{ id: "am", name: "AM" }],
+ *         [{ id: "patel", name: "Patel, R." }],
+ *         [{ id: "x1", personId: "patel", areaId: "icu", shiftId: "am", state: variant("committed", null) }],
+ *         {
+ *             id: "board-tue",
+ *             sources: ["people"],
+ *             mode: "edit",
+ *             area: a => ({ key: a.id, label: a.name }),
+ *             shift: s => ({ key: s.id, label: s.name }),
+ *             person: p => ({ key: p.id, label: p.name }),
+ *             assignment: x => ({ key: x.id, person: x.personId, area: x.areaId,
+ *                                 shift: x.shiftId, state: x.state }),
+ *         },
+ *     ),
+ * );
+ * ```
+ */
+function createBoard(areas, shifts, people, assignments, config) {
+    return buildRoot(areas, shifts, people, assignments, config);
+}
+// ============================================================================
+// Namespace export
+// ============================================================================
+/**
+ * Board component namespace.
+ *
+ * @remarks
+ * `Board.Root(areas, shifts, people, assignments, config)` builds the
+ * single-day grid from the flat tables; assignment states reuse the Planner
+ * event-state grammar (`Board.Types.State`), so data carries typed
+ * `variant(...)` values.
+ */
+export const Board = {
+    /**
+     * Creates a Board — single-day areas × shifts assignment scheduling with
+     * the drag & drop target role.
+     *
+     * @typeParam A - The areas-table input
+     * @typeParam S - The shifts-table input
+     * @typeParam P - The people-table input
+     * @typeParam X - The assignments-table input
+     * @param areas - The area rows (one grid row each)
+     * @param shifts - The shift rows (one grid column each, in order)
+     * @param people - The people rows (chip faces, joined by the encoded person key)
+     * @param assignments - The assignment rows (grouped into cells by area × shift)
+     * @param config - The Board configuration ({@link BoardConfig})
+     * @returns An East expression of `UIComponentType`
+     *
+     * @remarks
+     * Published mode renders committed assignments only, pointer-immutable;
+     * edit mode enables drag handles on proposed assignments, open-slot /
+     * empty-cell add, and ghost acceptance. Dropping a person onto a cell
+     * that already holds them is a no-op (the duplicate-person guard); the
+     * same person in different cells is legal — host policy. Cross-area
+     * moves arrive as plain `move` events — the host derives any swap
+     * representation from `from.row ≠ to.row`.
+     *
+     * @example
+     * ```ts
+     * import { East, variant } from "@elaraai/east";
+     * import { Board, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, _$ =>
+     *     Board.Root(
+     *         [{ id: "icu", name: "ICU" }],
+     *         [{ id: "am", name: "AM" }],
+     *         [{ id: "patel", name: "Patel, R." }],
+     *         [{ id: "x1", personId: "patel", areaId: "icu", shiftId: "am", state: variant("committed", null) }],
+     *         {
+     *             id: "board-tue",
+     *             area: a => ({ key: a.id, label: a.name }),
+     *             shift: s => ({ key: s.id, label: s.name }),
+     *             person: p => ({ key: p.id, label: p.name }),
+     *             assignment: x => ({ key: x.id, person: x.personId, area: x.areaId,
+     *                                 shift: x.shiftId, state: x.state }),
+     *         },
+     *     ),
+     * );
+     * ```
+     */
+    Root: createBoard,
+    Types: {
+        /**
+         * East StructType for the Board component.
+         *
+         * @remarks
+         * Flat resolved tables; the renderer groups assignments into cells
+         * by `area × shift` and joins each to `people` by person key. See
+         * {@link BoardRootType} for per-field docs.
+         *
+         * @property id - DnD target identity
+         * @property sources - Library ids accepted for `add` drags
+         * @property mode - `published` or `edit`
+         * @property areaHeader - Optional frozen area column header
+         * @property areas - The grid rows
+         * @property shifts - The grid columns, in order
+         * @property people - The chip directory (faces)
+         * @property assignments - The person chips
+         * @property requirements - Optional per-cell coverage
+         * @property density - Optional density
+         * @property maxVisible - Optional per-cell chip cap
+         * @property summary - Optional status-strip text
+         * @property onDrag - Drag funnel
+         * @property onSelect - Assignment / cell click callback
+         * @property onAccept - Ghost acceptance callback
+         * @property onAddAt - Open-slot / empty-cell click callback
+         */
+        Board: BoardRootType,
+        /**
+         * Board render mode (`published` / `edit`).
+         *
+         * @property published - Committed-only, pointer-immutable
+         * @property edit - Operator + model proposals are interactive
+         */
+        Mode: BoardModeType,
+        /**
+         * A resolved board entity — area row, shift column, or person face.
+         *
+         * @property key - Entity identity — the key assignments reference
+         * @property label - Display name
+         * @property sublabel - Optional muted second line
+         */
+        Entity: BoardEntityType,
+        /**
+         * A resolved assignment — one person chip in one (area, shift) cell.
+         *
+         * @property key - Stable assignment identity
+         * @property person - The person key (joined for the chip face)
+         * @property area - The area key (the grid row)
+         * @property shift - The shift key (the grid column)
+         * @property state - The audit state
+         */
+        Assignment: BoardAssignmentType,
+        /**
+         * A resolved coverage requirement for one (area, shift) cell.
+         *
+         * @property area - The area key
+         * @property shift - The shift key
+         * @property required - Required headcount for the cell
+         */
+        Requirement: BoardRequirementType,
+        /**
+         * The shared event-state grammar (committed / proposed / rejected).
+         *
+         * @property committed - A published assignment
+         * @property proposed - A proposal (`added` / `model` / `removed`)
+         * @property rejected - A rejected proposal
+         */
+        State: PlannerStateType,
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/src/collections/board/index.js.map

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

package/dist/src/collections/board/types.d.ts

@@ -0,0 +1,308 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { ArrayType, BooleanType, FunctionType, IntegerType, NullType, OptionType, StringType, StructType, VariantType } from "@elaraai/east";
+/**
+ * Board render mode.
+ *
+ * @remarks
+ * Published boards render committed assignments only, with no grips and no
+ * pointer interaction; edit mode enables drag handles, open-slot / empty-cell
+ * add, and ghost acceptance.
+ *
+ * @property published - Committed-only, pointer-immutable
+ * @property edit - Operator + model proposals are interactive
+ */
+export declare const BoardModeType: VariantType<{
+    /** Committed-only, pointer-immutable */
+    readonly published: NullType;
+    /** Operator + model proposals are interactive */
+    readonly edit: NullType;
+}>;
+/**
+ * Type representing board mode values.
+ */
+export type BoardModeType = typeof BoardModeType;
+/**
+ * String literal form of {@link BoardModeType} tags.
+ */
+export type BoardModeLiteral = "published" | "edit";
+/**
+ * A resolved board entity — an area row, a shift column, or a person face.
+ *
+ * @remarks
+ * One generic `key` / `label` / `sublabel` shape serves all three board
+ * tables: `areas` (rows), `shifts` (columns; `sublabel` typically the time
+ * window), and `people` (the chip directory assignments join by person key).
+ *
+ * @property key - Entity identity — the key assignments reference
+ * @property label - Display name
+ * @property sublabel - Optional muted second line (e.g. wing, time window, role)
+ */
+export declare const BoardEntityType: StructType<{
+    /** Entity identity — the key assignments reference */
+    readonly key: StringType;
+    /** Display name */
+    readonly label: StringType;
+    /** Optional muted second line (e.g. wing, time window, role) */
+    readonly sublabel: OptionType<StringType>;
+}>;
+/**
+ * Type representing resolved board entities.
+ */
+export type BoardEntityType = typeof BoardEntityType;
+/**
+ * A resolved assignment — one person chip in one (area, shift) cell.
+ *
+ * @remarks
+ * Carries no display label: the chip face comes from joining `person` to the
+ * board's `people` table by key.
+ *
+ * @property key - Stable assignment identity — referenced by drag-grammar cell refs
+ * @property person - The person key (joined to `people` for the chip face)
+ * @property area - The area key (the grid row)
+ * @property shift - The shift key (the grid column)
+ * @property state - The audit state (committed / proposed / rejected)
+ */
+export declare const BoardAssignmentType: StructType<{
+    /** Stable assignment identity — referenced by drag-grammar cell refs */
+    readonly key: StringType;
+    /** The person key (joined to `people` for the chip face) */
+    readonly person: StringType;
+    /** The area key (the grid row) */
+    readonly area: StringType;
+    /** The shift key (the grid column) */
+    readonly shift: StringType;
+    /** The audit state (committed / proposed / rejected) */
+    readonly state: VariantType<{
+        readonly committed: NullType;
+        readonly proposed: VariantType<{
+            readonly added: NullType;
+            readonly model: NullType;
+            readonly removed: NullType;
+        }>;
+        readonly rejected: NullType;
+    }>;
+}>;
+/**
+ * Type representing resolved assignments.
+ */
+export type BoardAssignmentType = typeof BoardAssignmentType;
+/**
+ * A resolved coverage requirement for one (area, shift) cell.
+ *
+ * @property area - The area key
+ * @property shift - The shift key
+ * @property required - Required headcount for the cell
+ */
+export declare const BoardRequirementType: StructType<{
+    /** The area key */
+    readonly area: StringType;
+    /** The shift key */
+    readonly shift: StringType;
+    /** Required headcount for the cell */
+    readonly required: IntegerType;
+}>;
+/**
+ * Type representing resolved coverage requirements.
+ */
+export type BoardRequirementType = typeof BoardRequirementType;
+/**
+ * East StructType for the Board component.
+ *
+ * @remarks
+ * Flat resolved tables — the renderer groups assignments into cells by
+ * `area × shift` and joins each to `people` by person key for the chip face.
+ * Assignment states reuse the Planner event-state grammar
+ * ({@link PlannerStateType}); the `model` flavour renders as the dashed
+ * ghost with the acceptance affordance. The component renders no built-in
+ * user-facing copy: every string it shows arrives as data or a prop, and its
+ * own chrome is numerals, glyphs and tones.
+ *
+ * @property id - DnD target identity
+ * @property sources - Library ids accepted for `add` drags
+ * @property mode - `published` (committed-only, immutable) or `edit`
+ * @property areaHeader - Optional frozen area column header (none = blank)
+ * @property areaWidth - Optional CSS width for the frozen area column
+ * @property areas - The grid rows
+ * @property shifts - The grid columns (this day's shift types, in order)
+ * @property people - The chip directory (faces), joined by person key
+ * @property assignments - The person chips (grouped into cells by area × shift)
+ * @property requirements - Optional per-cell coverage (none = no coverage chrome)
+ * @property density - Optional density
+ * @property maxVisible - Optional per-cell chip cap before the `+N` overflow
+ * @property summary - Optional status-strip text (open / proposed counts)
+ * @property canAssign - Optional assignability predicate `(person, area, shift) => Boolean`
+ * @property onDrag - Drag funnel — add / move / remove events
+ * @property onSelect - Assignment / cell click callback
+ * @property onAccept - Ghost-assignment acceptance callback
+ * @property onAddAt - Open-slot / empty-cell click callback (edit mode)
+ */
+export declare const BoardRootType: StructType<{
+    /** DnD target identity */
+    readonly id: StringType;
+    /** Library ids accepted for `add` drags */
+    readonly sources: ArrayType<StringType>;
+    /** `published` (committed-only, immutable) or `edit` */
+    readonly mode: VariantType<{
+        /** Committed-only, pointer-immutable */
+        readonly published: NullType;
+        /** Operator + model proposals are interactive */
+        readonly edit: NullType;
+    }>;
+    /** Optional frozen area column header (none = blank) */
+    readonly areaHeader: OptionType<StringType>;
+    /** Optional CSS width for the frozen area column (none = the Planner-consistent 150px) */
+    readonly areaWidth: OptionType<StringType>;
+    /** The grid rows */
+    readonly areas: ArrayType<StructType<{
+        /** Entity identity — the key assignments reference */
+        readonly key: StringType;
+        /** Display name */
+        readonly label: StringType;
+        /** Optional muted second line (e.g. wing, time window, role) */
+        readonly sublabel: OptionType<StringType>;
+    }>>;
+    /** The grid columns (this day's shift types, in order) */
+    readonly shifts: ArrayType<StructType<{
+        /** Entity identity — the key assignments reference */
+        readonly key: StringType;
+        /** Display name */
+        readonly label: StringType;
+        /** Optional muted second line (e.g. wing, time window, role) */
+        readonly sublabel: OptionType<StringType>;
+    }>>;
+    /** The chip directory (faces), joined by person key */
+    readonly people: ArrayType<StructType<{
+        /** Entity identity — the key assignments reference */
+        readonly key: StringType;
+        /** Display name */
+        readonly label: StringType;
+        /** Optional muted second line (e.g. wing, time window, role) */
+        readonly sublabel: OptionType<StringType>;
+    }>>;
+    /** The person chips (grouped into cells by area × shift) */
+    readonly assignments: ArrayType<StructType<{
+        /** Stable assignment identity — referenced by drag-grammar cell refs */
+        readonly key: StringType;
+        /** The person key (joined to `people` for the chip face) */
+        readonly person: StringType;
+        /** The area key (the grid row) */
+        readonly area: StringType;
+        /** The shift key (the grid column) */
+        readonly shift: StringType;
+        /** The audit state (committed / proposed / rejected) */
+        readonly state: VariantType<{
+            readonly committed: NullType;
+            readonly proposed: VariantType<{
+                readonly added: NullType;
+                readonly model: NullType;
+                readonly removed: NullType;
+            }>;
+            readonly rejected: NullType;
+        }>;
+    }>>;
+    /** Optional per-cell coverage (none = no coverage chrome) */
+    readonly requirements: OptionType<ArrayType<StructType<{
+        /** The area key */
+        readonly area: StringType;
+        /** The shift key */
+        readonly shift: StringType;
+        /** Required headcount for the cell */
+        readonly required: IntegerType;
+    }>>>;
+    /** Optional density */
+    readonly density: OptionType<VariantType<{
+        readonly comfortable: NullType;
+        readonly compact: NullType;
+        readonly condensed: NullType;
+    }>>;
+    /** Optional per-cell chip cap before the `+N` overflow */
+    readonly maxVisible: OptionType<IntegerType>;
+    /** Optional status-strip text (open / proposed counts) */
+    readonly summary: OptionType<StringType>;
+    /** Optional assignability predicate `(person, area, shift) => Boolean` — a
+     * `false` verdict renders the invalid-drop treatment and vetoes the drop */
+    readonly canAssign: OptionType<FunctionType<[StringType, StringType, StringType], BooleanType>>;
+    /** Drag funnel — add / move / remove events */
+    readonly onDrag: OptionType<FunctionType<[VariantType<{
+        readonly add: StructType<{
+            readonly from: StructType<{
+                readonly library: StringType;
+                readonly key: StringType;
+            }>;
+            readonly into: StructType<{
+                readonly surface: StringType;
+                readonly row: StringType;
+                readonly slot: StringType;
+                readonly event: OptionType<StringType>;
+            }>;
+            readonly duplicate: BooleanType;
+        }>;
+        readonly move: StructType<{
+            readonly from: StructType<{
+                readonly surface: StringType;
+                readonly row: StringType;
+                readonly slot: StringType;
+                readonly event: OptionType<StringType>;
+            }>;
+            readonly to: StructType<{
+                readonly surface: StringType;
+                readonly row: StringType;
+                readonly slot: StringType;
+                readonly event: OptionType<StringType>;
+            }>;
+        }>;
+        readonly remove: StructType<{
+            readonly from: StructType<{
+                readonly surface: StringType;
+                readonly row: StringType;
+                readonly slot: StringType;
+                readonly event: OptionType<StringType>;
+            }>;
+            readonly to: VariantType<{
+                readonly trash: NullType;
+                readonly source: NullType;
+            }>;
+        }>;
+        readonly resize: StructType<{
+            readonly event: StructType<{
+                readonly surface: StringType;
+                readonly row: StringType;
+                readonly slot: StringType;
+                readonly event: OptionType<StringType>;
+            }>;
+            readonly edge: VariantType<{
+                readonly start: NullType;
+                readonly end: NullType;
+            }>;
+        }>;
+    }>], NullType>>;
+    /** Assignment / cell click callback */
+    readonly onSelect: OptionType<FunctionType<[StructType<{
+        readonly surface: StringType;
+        readonly row: StringType;
+        readonly slot: StringType;
+        readonly event: OptionType<StringType>;
+    }>], NullType>>;
+    /** Ghost-assignment acceptance callback */
+    readonly onAccept: OptionType<FunctionType<[StructType<{
+        readonly surface: StringType;
+        readonly row: StringType;
+        readonly slot: StringType;
+        readonly event: OptionType<StringType>;
+    }>], NullType>>;
+    /** Open-slot / empty-cell click callback (edit mode) */
+    readonly onAddAt: OptionType<FunctionType<[StructType<{
+        readonly surface: StringType;
+        readonly row: StringType;
+        readonly slot: StringType;
+        readonly event: OptionType<StringType>;
+    }>], NullType>>;
+}>;
+/**
+ * Type representing the Board component.
+ */
+export type BoardRootType = typeof BoardRootType;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/collections/board/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/collections/board/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACd,MAAM,eAAe,CAAC;AAMvB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa;IACtB,wCAAwC;;IAExC,iDAAiD;;EAEnD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,MAAM,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe;IACxB,sDAAsD;;IAEtD,mBAAmB;;IAEnB,gEAAgE;;EAElE,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB;IAC5B,wEAAwE;;IAExE,4DAA4D;;IAE5D,kCAAkC;;IAElC,sCAAsC;;IAEtC,wDAAwD;;;;;;;;;;EAE1D,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAE7D;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB;IAC7B,mBAAmB;;IAEnB,oBAAoB;;IAEpB,sCAAsC;;EAExC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,aAAa;IACtB,0BAA0B;;IAE1B,2CAA2C;;IAE3C,wDAAwD;;QAlIxD,wCAAwC;;QAExC,iDAAiD;;;IAkIjD,wDAAwD;;IAExD,0FAA0F;;IAE1F,oBAAoB;;QA3GpB,sDAAsD;;QAEtD,mBAAmB;;QAEnB,gEAAgE;;;IAyGhE,0DAA0D;;QA7G1D,sDAAsD;;QAEtD,mBAAmB;;QAEnB,gEAAgE;;;IA2GhE,uDAAuD;;QA/GvD,sDAAsD;;QAEtD,mBAAmB;;QAEnB,gEAAgE;;;IA6GhE,4DAA4D;;QAtF5D,wEAAwE;;QAExE,4DAA4D;;QAE5D,kCAAkC;;QAElC,sCAAsC;;QAEtC,wDAAwD;;;;;;;;;;;IAgFxD,6DAA6D;;QA/D7D,mBAAmB;;QAEnB,oBAAoB;;QAEpB,sCAAsC;;;IA6DtC,uBAAuB;;;;;;IAEvB,0DAA0D;;IAE1D,0DAA0D;;IAE1D;gFAC4E;;IAE5E,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE/C,uCAAuC;;;;;;;IAEvC,2CAA2C;;;;;;;IAE3C,wDAAwD;;;;;;;EAE1D,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC"}