@elaraai/east-ui 1.0.4 → 1.0.5

package/dist/src/collections/matrix/types.js

@@ -2,197 +2,175 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
-import { ArrayType, BooleanType, FloatType, FunctionType, NullType, OptionType, StringType, StructType, VariantType, } from "@elaraai/east";
-import { LabelInputType, SizeType, } from "../../style.js";
-// NOTE: Any Matrix type that references `UIComponentType` (row header,
-// column header, cell tooltip, cell overlay content) lives in
-// `collections/matrix/index.ts`, alongside the factory. This file
-// stays UIComp-free so it can be imported from `component.ts` without
-// a circular dependency.
-// Re-export shared `AlignType` under the historical Matrix name so
-// existing call sites continue to work.
-export { AlignType } from "../../style.js";
+import { FloatType, IntegerType, NullType, OptionType, StringType, StructType, VariantType, } from "@elaraai/east";
+import { LabelInputType, } from "../../style.js";
+import { StatusValueType } from "../../feedback/status/types.js";
+// NOTE: Any Matrix type that references `UIComponentType` (cell free slot,
+// cell popover) lives in `collections/matrix/index.ts`, alongside the factory.
+// This file stays UIComp-free so it can be imported from `component.ts`
+// without a circular dependency.
+// Re-export shared content primitives for ergonomic discovery via Matrix.Types.*.
+export { AlignType, LabelInputType } from "../../style.js";
+export { StatusValueType } from "../../feedback/status/types.js";
 // ============================================================================
-// Cell segment
+// Segment fill — status-leveraged
 // ============================================================================
 /**
- * East StructType for a single horizontal slice of a cell's fill.
+ * The fill of a cell-bar segment. A superset of {@link StatusValueType} (the
+ * semantic statuses, identical to Planner markers / Gantt task status) plus the
+ * three matrix-native fills.
  *
- * @remarks
- * Segments are weighted — the renderer normalizes so `Σ weight = 100%`
- * of the cell's horizontal space. `min` / `max` / `step` are resize
- * constraints honoured by the renderer only when the Matrix has an
- * `onSegmentChange` callback on main (segment handles are shown).
+ * @property brand - Primary utilisation fill (brand teal — the "booked" segment)
+ * @property success - Positive / committed (green)
+ * @property warning - Caution / pending (gold)
+ * @property danger - Negative / at-risk (red)
+ * @property info - Informational (blue)
+ * @property neutral - Muted solid fill
+ * @property slack - Diagonal-hatched remainder (auto-fill slack)
+ * @property free - Transparent track — empty / available capacity
+ */
+export const MatrixFillType = VariantType({
+    brand: NullType,
+    success: NullType,
+    warning: NullType,
+    danger: NullType,
+    info: NullType,
+    neutral: NullType,
+    slack: NullType,
+    free: NullType,
+});
+// ============================================================================
+// Segment — a weighted slice of the cell bar
+// ============================================================================
+/**
+ * East StructType for a single weighted slice of a cell's bar.
  *
- * Per-segment label: when `label` is set, the renderer paints the
- * label's `value` text inside the segment using the shared
- * {@link LabelInputType} alignment + typography fields. The Matrix's
- * `style.segmentLabelColor` / `segmentLabelFontSize` /
- * `segmentLabelFontWeight` / `minLabelSize` act as cascading defaults.
+ * @remarks
+ * Segments are weighted — the renderer normalises so `Σ weight = 100%` of the
+ * cell axis (width when horizontal, height when vertical). `fill` drives the
+ * colour from the theme (no raw hex needed); `color` is an override-only escape
+ * hatch. `min` / `max` / `step` are honoured only when the Matrix carries an
+ * `onSegmentChange` callback (drag-resize handles shown). `label` paints
+ * in-bar text, suppressed under `minLabelSize`.
  *
- * @property category - Category name (matches the legend entry)
- * @property weight - Proportional weight (normalized with sibling segments)
- * @property color - Optional explicit swatch colour
- * @property label - Optional rich label (text + alignment + typography)
- * @property min - Optional minimum weight for resize
- * @property max - Optional maximum weight for resize
- * @property step - Optional snap increment for resize
+ * @property fill - Status-leveraged fill ({@link MatrixFillType})
+ * @property weight - Proportional weight (normalised with sibling segments)
+ * @property label - Optional rich in-bar label (text + alignment + typography)
+ * @property color - Optional explicit colour override (bypasses `fill`)
+ * @property min - Optional minimum weight for drag-resize
+ * @property max - Optional maximum weight for drag-resize
+ * @property step - Optional snap increment for drag-resize
  */
-export const MatrixCellSegmentType = StructType({
-    category: StringType,
+export const MatrixSegmentType = StructType({
+    fill: MatrixFillType,
     weight: FloatType,
-    color: OptionType(StringType),
     label: OptionType(LabelInputType),
+    color: OptionType(StringType),
     min: OptionType(FloatType),
     max: OptionType(FloatType),
     step: OptionType(FloatType),
 });
 // ============================================================================
-// Brush-selection types
+// Marker — a status flag on a cell (the Matrix analogue of Planner.marker)
 // ============================================================================
 /**
- * Rectangular brush-selection coordinate.
+ * The corner a marker's icon / badge sits in.
  *
- * @property row - Row key
- * @property column - Column key
+ * @property tl - Top-left
+ * @property tr - Top-right
+ * @property bl - Bottom-left
+ * @property br - Bottom-right
  */
-export const MatrixBrushCoordType = StructType({
-    row: StringType,
-    column: StringType,
+export const MatrixCornerType = VariantType({
+    tl: NullType,
+    tr: NullType,
+    bl: NullType,
+    br: NullType,
 });
 /**
- * Brush-selection state.
+ * East StructType for a cell status marker — the Matrix analogue of
+ * `Planner.marker`. Reuses the shared {@link StatusValueType}: `status` tints
+ * the cell's emphasis ring and selects the paired corner icon, `message` is the
+ * hover tooltip, and `label` (when set) replaces the status icon with custom
+ * badge text (`"OT"`). `at` chooses the corner the icon/badge sits in.
  *
- * @remarks
- * Controlled-component pattern: `selected` is the source of truth;
- * the renderer reflects it and emits `onChange` when the user drags
- * a new selection on mouse-up.
- *
- * @property enabled - Whether brush selection is active
- * @property selected - Currently-selected cell coordinates
- * @property onChange - Callback fired with the new selected set
+ * @property at - Which corner the marker icon / badge sits in ({@link MatrixCornerType})
+ * @property status - The semantic status — drives the ring tint + paired corner icon
+ * @property message - The marker text surfaced as a hover tooltip
+ * @property label - Optional custom badge text that replaces the status icon
  */
-export const MatrixBrushSelectionType = StructType({
-    enabled: BooleanType,
-    selected: OptionType(ArrayType(MatrixBrushCoordType)),
-    onChange: OptionType(FunctionType([ArrayType(MatrixBrushCoordType)], NullType)),
+export const MatrixMarkerType = StructType({
+    at: MatrixCornerType,
+    status: StatusValueType,
+    message: StringType,
+    label: OptionType(StringType),
 });
 // ============================================================================
-// Legend position
+// Orientation
 // ============================================================================
 /**
- * Legend position — where the legend rail sits relative to the grid.
+ * How a cell's segment bar is laid out.
  *
- * @property top - Above the grid
- * @property bottom - Below the grid (default)
- * @property left - To the left of the grid
- * @property right - To the right of the grid
+ * @property horizontal - Segments flow left-to-right, sized by width
+ * @property vertical - Segments stack bottom-to-top, sized by height (capacity bar)
  */
-export const MatrixLegendPositionType = VariantType({
-    top: NullType,
-    bottom: NullType,
-    left: NullType,
-    right: NullType,
+export const MatrixOrientationType = VariantType({
+    horizontal: NullType,
+    vertical: NullType,
 });
 // ============================================================================
-// Cell orientation
+// Legend entry
 // ============================================================================
 /**
- * Cell orientation — how segments stack inside a cell.
+ * East StructType for one legend swatch — a fill paired with its label.
  *
- * @remarks
- * `horizontal` (default): segments stack left-to-right, each sized by
- * `weight`. `vertical`: segments stack bottom-to-top, so each cell
- * reads like a stacked vertical bar (utilization / capacity
- * dashboards).
- *
- * @property horizontal - Segments flow left-to-right
- * @property vertical - Segments flow bottom-to-top (stacked vertical bar)
+ * @property fill - The segment fill the swatch shows ({@link MatrixFillType})
+ * @property label - The displayed legend label
  */
-export const MatrixCellOrientationType = VariantType({
-    horizontal: NullType,
-    vertical: NullType,
+export const MatrixLegendEntryType = StructType({
+    fill: MatrixFillType,
+    label: StringType,
 });
 // ============================================================================
-// Segment-change callback event (on main — declared here so `component.ts` can reference it)
+// Callback event payloads
 // ============================================================================
 /**
- * Event payload for `onSegmentChange` — fired when a user drags the
- * trailing edge of a segment to a new weight.
+ * Event payload for `onCellClick`.
  *
  * @property row - Row key
  * @property column - Column key
- * @property category - Category of the resized segment
- * @property weight - New weight (post-snap, post-clamp)
  */
-export const MatrixSegmentChangeEventType = StructType({
+export const MatrixCellClickEventType = StructType({
     row: StringType,
     column: StringType,
-    category: StringType,
-    weight: FloatType,
 });
 /**
- * Event payload for `onSegmentClick` — fired when the user clicks a
- * specific segment within a cell.
+ * Event payload for `onSegmentClick`.
  *
  * @property row - Row key
  * @property column - Column key
- * @property category - Category of the clicked segment
+ * @property segmentIndex - Index of the clicked segment within the cell (0-based)
+ * @property fill - Fill of the clicked segment
  */
 export const MatrixSegmentClickEventType = StructType({
     row: StringType,
     column: StringType,
-    category: StringType,
+    segmentIndex: IntegerType,
+    fill: MatrixFillType,
 });
-// ============================================================================
-// Style — visual-only
-// ============================================================================
 /**
- * East StructType holding every visual field for a Matrix.
+ * Event payload for `onSegmentChange` — fired when the user drags a segment
+ * boundary to a new weight.
  *
- * @remarks
- * Visual-only. Content (rows / columns / legend), wiring
- * (brushSelection), and behaviour callbacks live on the main `Matrix`
- * variant in `component.ts`.
- *
- * @property size - Size preset (xs / sm / md / lg)
- * @property showGridLines - Whether to draw grid lines between cells (default false — gutter style)
- * @property gridColor - Explicit grid-line / gutter colour
- * @property headerBackground - Row / column header background
- * @property headerColor - Row / column header text colour
- * @property cellBackground - Default cell background (fallback when no segments)
- * @property cellBorderRadius - Cell corner radius (default `"2px"` for a subtle modern feel)
- * @property rowHeaderWidth - CSS width of the sticky first column
- * @property columnHeaderHeight - CSS height of the column header row
- * @property legendPosition - Position of the legend rail
- * @property emphasisColor - Default ring colour for emphasized cells
- * @property selectedBackground - Background for brush-selected cells
- * @property selectedBorderColor - Ring colour for brush-selected cells
- * @property hoverHighlightColor - Background for cross-highlight on hovered row / column headers
- * @property segmentLabelColor - Default text colour for per-segment labels (default `"white"`); per-segment `label.color` overrides
- * @property segmentLabelFontSize - Default CSS font-size for per-segment labels (default `"0.75rem"`); per-segment `label.fontSize` overrides
- * @property segmentLabelFontWeight - Default CSS font-weight for per-segment labels (default `"600"`); per-segment `label.fontWeight` overrides
- * @property minLabelSize - Minimum rendered segment width (CSS) below which the label is hidden — avoids clipped text on tiny slices. Default `"24px"`.
+ * @property row - Row key
+ * @property column - Column key
+ * @property segmentIndex - Index of the resized segment within the cell (0-based)
+ * @property weight - New weight (post-snap, post-clamp)
  */
-export const MatrixStyleType = StructType({
-    size: OptionType(SizeType),
-    showGridLines: OptionType(BooleanType),
-    gridColor: OptionType(StringType),
-    headerBackground: OptionType(StringType),
-    headerColor: OptionType(StringType),
-    cellBackground: OptionType(StringType),
-    cellBorderRadius: OptionType(StringType),
-    rowHeaderWidth: OptionType(StringType),
-    columnHeaderHeight: OptionType(StringType),
-    legendPosition: OptionType(MatrixLegendPositionType),
-    emphasisColor: OptionType(StringType),
-    selectedBackground: OptionType(StringType),
-    selectedBorderColor: OptionType(StringType),
-    hoverHighlightColor: OptionType(StringType),
-    cellOrientation: OptionType(MatrixCellOrientationType),
-    segmentLabelColor: OptionType(StringType),
-    segmentLabelFontSize: OptionType(StringType),
-    segmentLabelFontWeight: OptionType(StringType),
-    minLabelSize: OptionType(StringType),
+export const MatrixSegmentChangeEventType = StructType({
+    row: StringType,
+    column: StringType,
+    segmentIndex: IntegerType,
+    weight: FloatType,
 });
 //# sourceMappingURL=types.js.map

package/dist/src/collections/matrix/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/collections/matrix/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEH,SAAS,EACT,WAAW,EACX,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EACH,cAAc,EACd,QAAQ,GAEX,MAAM,gBAAgB,CAAC;AAExB,uEAAuE;AACvE,8DAA8D;AAC9D,kEAAkE;AAClE,sEAAsE;AACtE,yBAAyB;AAEzB,mEAAmE;AACnE,wCAAwC;AACxC,OAAO,EAAE,SAAS,EAAqB,MAAM,gBAAgB,CAAC;AAE9D,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAC;IAC5C,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC;IAC7B,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC;IACjC,GAAG,EAAE,UAAU,CAAC,SAAS,CAAC;IAC1B,GAAG,EAAE,UAAU,CAAC,SAAS,CAAC;IAC1B,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC;CAC9B,CAAC,CAAC;AAIH,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;IAC3C,GAAG,EAAE,UAAU;IACf,MAAM,EAAE,UAAU;CACrB,CAAC,CAAC;AAIH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAC;IAC/C,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,UAAU,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IACrD,QAAQ,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;CAClF,CAAC,CAAC;AAIH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAC;IAChD,GAAG,EAAE,QAAQ;IACb,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,QAAQ;CAClB,CAAC,CAAC;AAMH,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAC;IACjD,UAAU,EAAE,QAAQ;IACpB,QAAQ,EAAE,QAAQ;CACrB,CAAC,CAAC;AAMH,+EAA+E;AAC/E,6FAA6F;AAC7F,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,UAAU,CAAC;IACnD,GAAG,EAAE,UAAU;IACf,MAAM,EAAE,UAAU;IAClB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,SAAS;CACpB,CAAC,CAAC;AAIH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CAAC;IAClD,GAAG,EAAE,UAAU;IACf,MAAM,EAAE,UAAU;IAClB,QAAQ,EAAE,UAAU;CACvB,CAAC,CAAC;AAIH,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;IACtC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC;IAC1B,aAAa,EAAE,UAAU,CAAC,WAAW,CAAC;IACtC,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC;IACjC,gBAAgB,EAAE,UAAU,CAAC,UAAU,CAAC;IACxC,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC;IACnC,cAAc,EAAE,UAAU,CAAC,UAAU,CAAC;IACtC,gBAAgB,EAAE,UAAU,CAAC,UAAU,CAAC;IACxC,cAAc,EAAE,UAAU,CAAC,UAAU,CAAC;IACtC,kBAAkB,EAAE,UAAU,CAAC,UAAU,CAAC;IAC1C,cAAc,EAAE,UAAU,CAAC,wBAAwB,CAAC;IACpD,aAAa,EAAE,UAAU,CAAC,UAAU,CAAC;IACrC,kBAAkB,EAAE,UAAU,CAAC,UAAU,CAAC;IAC1C,mBAAmB,EAAE,UAAU,CAAC,UAAU,CAAC;IAC3C,mBAAmB,EAAE,UAAU,CAAC,UAAU,CAAC;IAC3C,eAAe,EAAE,UAAU,CAAC,yBAAyB,CAAC;IACtD,iBAAiB,EAAE,UAAU,CAAC,UAAU,CAAC;IACzC,oBAAoB,EAAE,UAAU,CAAC,UAAU,CAAC;IAC5C,sBAAsB,EAAE,UAAU,CAAC,UAAU,CAAC;IAC9C,YAAY,EAAE,UAAU,CAAC,UAAU,CAAC;CACvC,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/collections/matrix/types.ts"],"names":[],"mappings":"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"}

package/dist/src/collections/pagination/index.d.ts

@@ -2,43 +2,16 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
-import { type ExprType, type SubtypeExprOrValue, FunctionType, IntegerType, NullType, OptionType, StructType } from "@elaraai/east";
+import { type ExprType } from "@elaraai/east";
 import { UIComponentType } from "../../component.js";
-import { PaginationSizeType, PaginationVariantType, PaginationStyleType, type PaginationOptions } from "./types.js";
-export { PaginationSizeType, PaginationVariantType, PaginationStyleType, type PaginationOptions, } from "./types.js";
-/**
- * Standalone East StructType mirror of the inline `Pagination` variant
- * in `component.ts`.
- *
- * @remarks
- * Per the 0 main/style type-shape convention, main carries content
- * (`page` / `pageSize` / `count`) and behaviour (`onPageChange`);
- * `style` carries visual fields only.
- *
- * @property page - Current 0-based page index
- * @property pageSize - Number of items per page
- * @property count - Total item count (drives the page-number range)
- * @property onPageChange - Callback fired when the user picks a new page
- * @property style - Optional visual style sub-struct
- */
-export declare const PaginationType: StructType<{
-    page: IntegerType;
-    pageSize: IntegerType;
-    count: IntegerType;
-    onPageChange: FunctionType<[IntegerType], NullType>;
-    style: OptionType<PaginationStyleType>;
-}>;
-/** Type alias for PaginationType. */
-export type PaginationType = typeof PaginationType;
+import { PaginationSizeType, PaginationVariantType, PaginationStyleType, PaginationType, type PaginationOptions } from "./types.js";
+export { PaginationSizeType, PaginationVariantType, PaginationStyleType, PaginationType, type PaginationOptions, } from "./types.js";
 /**
  * Creates a Pagination component value — a standalone page-navigation
  * control.
  *
- * @param page - Current 0-based page index
- * @param pageSize - Number of items per page
- * @param count - Total item count (drives the page range)
- * @param onPageChange - Callback fired with the new 0-based page index
- * @param options - Optional visual style
+ * @param options - Required `page` / `pageSize` / `count` / `onPageChange`,
+ *   optional visual style fields
  * @returns An East expression of type `UIComponentType`
  *
  * @remarks
@@ -61,12 +34,12 @@ export type PaginationType = typeof PaginationType;
  *         const onChange = $.const(East.function([IntegerType], NullType, ($, next) => {
  *             $(State.write([IntegerType], "page", next));
  *         }));
- *         return Pagination.Root(page, 20n, 500n, onChange, { size: "md" });
+ *         return Pagination.Root({ page, pageSize: 20n, count: 500n, onPageChange: onChange, size: "md" });
  *     }));
  * });
  * ```
  */
-declare function createPagination(page: SubtypeExprOrValue<IntegerType>, pageSize: SubtypeExprOrValue<IntegerType>, count: SubtypeExprOrValue<IntegerType>, onPageChange: SubtypeExprOrValue<FunctionType<[IntegerType], NullType>>, options?: PaginationOptions): ExprType<UIComponentType>;
+declare function createPagination(options: PaginationOptions): ExprType<UIComponentType>;
 interface PaginationNamespace {
     Root: typeof createPagination;
     Types: {
@@ -80,7 +53,7 @@ interface PaginationNamespace {
  * Pagination — standalone page navigation primitive.
  *
  * @remarks
- * Use `Pagination.Root(page, pageSize, count, onPageChange, options?)`.
+ * Use `Pagination.Root({ page, pageSize, count, onPageChange, ... })`.
  * Consumed by Table internally and usable standalone beneath paged
  * collections (BarStrip, etc.).
  */

package/dist/src/collections/pagination/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/collections/pagination/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EAIb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACH,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,iBAAiB,EACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACH,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,iBAAiB,GACzB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,UAAU,CAAC;IACpC,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;IACpD,KAAK,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC;CAC1C,CAMC,CAAC;AAEH,qCAAqC;AACrC,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC;AA8CnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,iBAAS,gBAAgB,CACrB,IAAI,EAAE,kBAAkB,CAAC,WAAW,CAAC,EACrC,QAAQ,EAAE,kBAAkB,CAAC,WAAW,CAAC,EACzC,KAAK,EAAE,kBAAkB,CAAC,WAAW,CAAC,EACtC,YAAY,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC,EACvE,OAAO,CAAC,EAAE,iBAAiB,GAC5B,QAAQ,CAAC,eAAe,CAAC,CAU3B;AAMD,UAAU,mBAAmB;IACzB,IAAI,EAAE,OAAO,gBAAgB,CAAC;IAC9B,KAAK,EAAE;QACH,UAAU,EAAE,OAAO,cAAc,CAAC;QAClC,KAAK,EAAE,OAAO,mBAAmB,CAAC;QAClC,IAAI,EAAE,OAAO,kBAAkB,CAAC;QAChC,OAAO,EAAE,OAAO,qBAAqB,CAAC;KACzC,CAAC;CACL;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,mBAgFxB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/collections/pagination/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EAKhB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACH,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,KAAK,iBAAiB,EACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACH,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,KAAK,iBAAiB,GACzB,MAAM,YAAY,CAAC;AA8CpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,iBAAS,gBAAgB,CACrB,OAAO,EAAE,iBAAiB,GAC3B,QAAQ,CAAC,eAAe,CAAC,CAW3B;AAMD,UAAU,mBAAmB;IACzB,IAAI,EAAE,OAAO,gBAAgB,CAAC;IAC9B,KAAK,EAAE;QACH,UAAU,EAAE,OAAO,cAAc,CAAC;QAClC,KAAK,EAAE,OAAO,mBAAmB,CAAC;QAClC,IAAI,EAAE,OAAO,kBAAkB,CAAC;QAChC,OAAO,EAAE,OAAO,qBAAqB,CAAC;KACzC,CAAC;CACL;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,mBA6ExB,CAAC"}

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

@@ -2,35 +2,10 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
-import { East, FunctionType, IntegerType, NullType, OptionType, StructType, variant, some, none, } from "@elaraai/east";
+import { East, variant, some, none, } from "@elaraai/east";
 import { UIComponentType } from "../../component.js";
-import { PaginationSizeType, PaginationVariantType, PaginationStyleType, } from "./types.js";
-export { PaginationSizeType, PaginationVariantType, PaginationStyleType, } from "./types.js";
-// ============================================================================
-// PaginationType — standalone mirror of the inline variant in component.ts
-// ============================================================================
-/**
- * Standalone East StructType mirror of the inline `Pagination` variant
- * in `component.ts`.
- *
- * @remarks
- * Per the 0 main/style type-shape convention, main carries content
- * (`page` / `pageSize` / `count`) and behaviour (`onPageChange`);
- * `style` carries visual fields only.
- *
- * @property page - Current 0-based page index
- * @property pageSize - Number of items per page
- * @property count - Total item count (drives the page-number range)
- * @property onPageChange - Callback fired when the user picks a new page
- * @property style - Optional visual style sub-struct
- */
-export const PaginationType = StructType({
-    page: IntegerType,
-    pageSize: IntegerType,
-    count: IntegerType,
-    onPageChange: FunctionType([IntegerType], NullType),
-    style: OptionType(PaginationStyleType),
-});
+import { PaginationSizeType, PaginationVariantType, PaginationStyleType, PaginationType, } from "./types.js";
+export { PaginationSizeType, PaginationVariantType, PaginationStyleType, PaginationType, } from "./types.js";
 // ============================================================================
 // Helpers
 // ============================================================================
@@ -75,11 +50,8 @@ function buildPaginationStyle(options) {
  * Creates a Pagination component value — a standalone page-navigation
  * control.
  *
- * @param page - Current 0-based page index
- * @param pageSize - Number of items per page
- * @param count - Total item count (drives the page range)
- * @param onPageChange - Callback fired with the new 0-based page index
- * @param options - Optional visual style
+ * @param options - Required `page` / `pageSize` / `count` / `onPageChange`,
+ *   optional visual style fields
  * @returns An East expression of type `UIComponentType`
  *
  * @remarks
@@ -102,12 +74,13 @@ function buildPaginationStyle(options) {
  *         const onChange = $.const(East.function([IntegerType], NullType, ($, next) => {
  *             $(State.write([IntegerType], "page", next));
  *         }));
- *         return Pagination.Root(page, 20n, 500n, onChange, { size: "md" });
+ *         return Pagination.Root({ page, pageSize: 20n, count: 500n, onPageChange: onChange, size: "md" });
  *     }));
  * });
  * ```
  */
-function createPagination(page, pageSize, count, onPageChange, options) {
+function createPagination(options) {
+    const { page, pageSize, count, onPageChange } = options;
     const styleValue = buildPaginationStyle(options);
     return East.value(variant("Pagination", {
         page,
@@ -121,7 +94,7 @@ function createPagination(page, pageSize, count, onPageChange, options) {
  * Pagination — standalone page navigation primitive.
  *
  * @remarks
- * Use `Pagination.Root(page, pageSize, count, onPageChange, options?)`.
+ * Use `Pagination.Root({ page, pageSize, count, onPageChange, ... })`.
  * Consumed by Table internally and usable standalone beneath paged
  * collections (BarStrip, etc.).
  */
@@ -129,11 +102,8 @@ export const Pagination = {
     /**
      * Creates a Pagination component value.
      *
-     * @param page - Current 0-based page index
-     * @param pageSize - Number of items per page
-     * @param count - Total item count
-     * @param onPageChange - Callback fired with the new 0-based page index
-     * @param options - Optional visual style (size / variant / colour slots / siblings / boundaries)
+     * @param options - Required `page` / `pageSize` / `count` / `onPageChange`,
+     *   optional visual style (size / variant / colour slots / siblings / boundaries)
      * @returns An East expression of type `UIComponentType`
      *
      * @example
@@ -150,7 +120,7 @@ export const Pagination = {
      *         const onChange = $.const(East.function([IntegerType], NullType, ($, next) => {
      *             $(State.write([IntegerType], "page", next));
      *         }));
-     *         return Pagination.Root(page, 20n, 500n, onChange, { size: "md", variant: "outline" });
+     *         return Pagination.Root({ page, pageSize: 20n, count: 500n, onPageChange: onChange, size: "md", variant: "outline" });
      *     }));
      * });
      * ```

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/collections/pagination/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,IAAI,EACJ,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,OAAO,EACP,IAAI,EACJ,IAAI,GACP,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACH,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GAEtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACH,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GAEtB,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAC/E,2EAA2E;AAC3E,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,cAAc,GAMtB,UAAU,CAAC;IACZ,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,WAAW;IACrB,KAAK,EAAE,WAAW;IAClB,YAAY,EAAE,YAAY,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC;IACnD,KAAK,EAAE,UAAU,CAAC,mBAAmB,CAAC;CACzC,CAAC,CAAC;AAKH,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,SAAS,oBAAoB,CAAC,OAAsC;IAChE,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS;WAClC,OAAO,CAAC,OAAO,KAAK,SAAS;WAC7B,OAAO,CAAC,KAAK,KAAK,SAAS;WAC3B,OAAO,CAAC,UAAU,KAAK,SAAS;WAChC,OAAO,CAAC,gBAAgB,KAAK,SAAS;WACtC,OAAO,CAAC,WAAW,KAAK,SAAS;WACjC,OAAO,CAAC,QAAQ,KAAK,SAAS;WAC9B,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC;IACxC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAE9B,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS;QACxC,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;YAC/B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,kBAAkB,CAAC;YAC7D,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACnB,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS;QAC9C,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;YAClC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,qBAAqB,CAAC;YACnE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACtB,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,IAAI,CAAC,KAAK,CAAC;QACd,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI;QACxC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI;QACjD,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;QAC/D,UAAU,EAAE,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;QAC9E,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI;QAChG,WAAW,EAAE,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI;QACjF,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;QACxE,UAAU,EAAE,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;KACjF,EAAE,mBAAmB,CAAC,CAAC;AAC5B,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,SAAS,gBAAgB,CACrB,IAAqC,EACrC,QAAyC,EACzC,KAAsC,EACtC,YAAuE,EACvE,OAA2B;IAE3B,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAEjD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE;QACpC,IAAI;QACJ,QAAQ;QACR,KAAK;QACL,YAAY;QACZ,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;KAC9C,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAgBD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAwB;IAC3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE;QACH;;;;;;;;;;;;;WAaG;QACH,UAAU,EAAE,cAAc;QAC1B;;;;;;;;;;;;;;;WAeG;QACH,KAAK,EAAE,mBAAmB;QAC1B;;;;;;WAMG;QACH,IAAI,EAAE,kBAAkB;QACxB;;;;;WAKG;QACH,OAAO,EAAE,qBAAqB;KACjC;CACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/collections/pagination/index.ts"],"names":[],"mappings":"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"}

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

@@ -2,7 +2,7 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
-import { type SubtypeExprOrValue, IntegerType, NullType, OptionType, StringType, StructType, VariantType } from "@elaraai/east";
+import { type SubtypeExprOrValue, FunctionType, IntegerType, NullType, OptionType, StringType, StructType, VariantType } from "@elaraai/east";
 /**
  * East VariantType for the Pagination visual variant.
  *
@@ -77,6 +77,31 @@ export declare const PaginationStyleType: StructType<{
 }>;
 /** Type alias for PaginationStyleType. */
 export type PaginationStyleType = typeof PaginationStyleType;
+/**
+ * Standalone East StructType mirror of the inline `Pagination` variant
+ * in `component.ts`.
+ *
+ * @remarks
+ * Main carries content (`page` / `pageSize` / `count`) and behaviour
+ * (`onPageChange`); `style` carries visual fields only. Lives in `types.ts`
+ * (a leaf with no `component.ts` import) so `component.ts` can reference it
+ * without a circular dependency.
+ *
+ * @property page - Current 0-based page index
+ * @property pageSize - Number of items per page
+ * @property count - Total item count (drives the page-number range)
+ * @property onPageChange - Callback fired when the user picks a new page
+ * @property style - Optional visual style sub-struct
+ */
+export declare const PaginationType: StructType<{
+    page: IntegerType;
+    pageSize: IntegerType;
+    count: IntegerType;
+    onPageChange: FunctionType<[IntegerType], NullType>;
+    style: OptionType<PaginationStyleType>;
+}>;
+/** Type alias for PaginationType. */
+export type PaginationType = typeof PaginationType;
 /**
  * TypeScript options bag for `Pagination.Root`.
  *
@@ -95,6 +120,14 @@ export type PaginationStyleType = typeof PaginationStyleType;
  * @property boundaries - Number of boundary page triggers shown at the start/end
  */
 export interface PaginationOptions {
+    /** Current 0-based page index — required. */
+    page: SubtypeExprOrValue<IntegerType>;
+    /** Number of items per page — required. */
+    pageSize: SubtypeExprOrValue<IntegerType>;
+    /** Total item count (drives the page range) — required. */
+    count: SubtypeExprOrValue<IntegerType>;
+    /** Callback fired with the new 0-based page index — required. */
+    onPageChange: SubtypeExprOrValue<FunctionType<[IntegerType], NullType>>;
     /** Size preset. Default `"md"`. */
     size?: SubtypeExprOrValue<PaginationSizeType> | PaginationSizeLiteral;
     /** Visual variant. Default `"subtle"`. */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/collections/pagination/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,kBAAkB,EACvB,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACd,MAAM,eAAe,CAAC;AAMvB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB;;;EAGhC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC;AAEjE,4DAA4D;AAC5D,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAM5D;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB;;;;EAI7B,CAAC;AAEH,yCAAyC;AACzC,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC;AAE3D,yDAAyD;AACzD,MAAM,MAAM,qBAAqB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAMvD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;EAS9B,CAAC;AAEH,0CAA0C;AAC1C,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAM7D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,iBAAiB;IAC9B,mCAAmC;IACnC,IAAI,CAAC,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,GAAG,qBAAqB,CAAC;IACtE,0CAA0C;IAC1C,OAAO,CAAC,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,GAAG,wBAAwB,CAAC;IAC/E,gEAAgE;IAChE,KAAK,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACvC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC5C,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAClD,wDAAwD;IACxD,WAAW,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC7C,qEAAqE;IACrE,QAAQ,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC3C,+DAA+D;IAC/D,UAAU,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;CAChD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/collections/pagination/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,kBAAkB,EACvB,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACd,MAAM,eAAe,CAAC;AAMvB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB;;;EAGhC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC;AAEjE,4DAA4D;AAC5D,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAM5D;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB;;;;EAI7B,CAAC;AAEH,yCAAyC;AACzC,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC;AAE3D,yDAAyD;AACzD,MAAM,MAAM,qBAAqB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAMvD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;EAS9B,CAAC;AAEH,0CAA0C;AAC1C,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAM7D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc,EAAE,UAAU,CAAC;IACpC,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;IACpD,KAAK,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC;CAC1C,CAMC,CAAC;AAEH,qCAAqC;AACrC,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC;AAMnD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,iBAAiB;IAC9B,6CAA6C;IAC7C,IAAI,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACtC,2CAA2C;IAC3C,QAAQ,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC1C,2DAA2D;IAC3D,KAAK,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACvC,iEAAiE;IACjE,YAAY,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACxE,mCAAmC;IACnC,IAAI,CAAC,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,GAAG,qBAAqB,CAAC;IACtE,0CAA0C;IAC1C,OAAO,CAAC,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,GAAG,wBAAwB,CAAC;IAC/E,gEAAgE;IAChE,KAAK,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACvC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC5C,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAClD,wDAAwD;IACxD,WAAW,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC7C,qEAAqE;IACrE,QAAQ,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC3C,+DAA+D;IAC/D,UAAU,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;CAChD"}