@elaraai/east-ui 1.0.4 → 1.0.6

package/dist/src/contracts/drag.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { BooleanType, NullType, OptionType, StringType, StructType, VariantType } from "@elaraai/east";
+/**
+ * Reference to an item in a Library (a drag **source**).
+ *
+ * @remarks
+ * Identifies where a dragged card came from: the `id` the Library surface
+ * declared, plus the dragged card's item key. Carried by the `add` case of
+ * {@link DragEventType}.
+ *
+ * @property library - The `id` the source Library declared
+ * @property key - The dragged card's item key within that Library
+ */
+export declare const LibraryRefType: StructType<{
+    /** The `id` the source Library declared */
+    readonly library: StringType;
+    /** The dragged card's item key within that Library */
+    readonly key: StringType;
+}>;
+/**
+ * Type representing Library reference values.
+ */
+export type LibraryRefType = typeof LibraryRefType;
+/**
+ * A cell coordinate on a drag **target** surface.
+ *
+ * @remarks
+ * Names a cell as `surface × row × slot`. When the reference points at an
+ * existing event in that cell (the `from` of a `move` / `remove`, or the
+ * subject of a `resize`), `event` carries the event's key; for an empty
+ * destination cell it is `none`.
+ *
+ * @property surface - The target surface's declared `id`
+ * @property row - The row key
+ * @property slot - The slot (column) key
+ * @property event - The event key when the ref names an existing event
+ */
+export declare const CellRefType: StructType<{
+    /** The target surface's declared `id` */
+    readonly surface: StringType;
+    /** The row key */
+    readonly row: StringType;
+    /** The slot (column) key */
+    readonly slot: StringType;
+    /** The event key when the ref names an existing event */
+    readonly event: OptionType<StringType>;
+}>;
+/**
+ * Type representing cell reference values.
+ */
+export type CellRefType = typeof CellRefType;
+/**
+ * Terminal destination of a `remove` drag.
+ *
+ * @remarks
+ * The two canonical sinks: `trash` (permanent removal) and `source` (drag
+ * back to the originating Library — returns the item to the palette).
+ *
+ * @property trash - Dropped on the trash affordance; permanent removal
+ * @property source - Dragged back to the originating Library
+ */
+export declare const DragSinkType: VariantType<{
+    /** Dropped on the trash affordance; permanent removal */
+    readonly trash: NullType;
+    /** Dragged back to the originating Library */
+    readonly source: NullType;
+}>;
+/**
+ * Type representing drag sink values.
+ */
+export type DragSinkType = typeof DragSinkType;
+/**
+ * String literal form of {@link DragSinkType} tags.
+ */
+export type DragSinkLiteral = "trash" | "source";
+/**
+ * Which boundary of a span event a `resize` drag moved.
+ *
+ * @property start - The leading edge moved
+ * @property end - The trailing edge moved
+ */
+export declare const DragEdgeType: VariantType<{
+    /** The leading edge moved */
+    readonly start: NullType;
+    /** The trailing edge moved */
+    readonly end: NullType;
+}>;
+/**
+ * Type representing drag edge values.
+ */
+export type DragEdgeType = typeof DragEdgeType;
+/**
+ * String literal form of {@link DragEdgeType} tags.
+ */
+export type DragEdgeLiteral = "start" | "end";
+/**
+ * The four drag event kinds — every drag interaction reduces to exactly one.
+ *
+ * @remarks
+ * The shared grammar for every DnD-aware surface. A target surface carries a
+ * single `onDrag` callback of this type; the renderer wires drag-flow between
+ * surfaces by matching their declared roles (a Library `source` connects to
+ * every target that lists it in `sources`), so hosts never wire handlers by
+ * hand. Every event funnels through the host's normal commit pipeline as a
+ * proposed patch — no drop writes state directly.
+ *
+ * - `add` is the only kind that crosses a source/target boundary: an item
+ *   leaving a Library and landing on a target cell. `duplicate` is set when
+ *   the drag was an alt-drag copy.
+ * - `move` is intra-surface only. A cross-row move still arrives as `move`;
+ *   the host derives any swap-proposal representation from
+ *   `from.row ≠ to.row`.
+ * - `remove` takes a {@link DragSinkType} destination: the trash affordance
+ *   or back to the originating Library.
+ * - `resize` exists only for span events with a duration (Gantt /
+ *   Planner.Span); the edge variant says which boundary moved, and the
+ *   destination slot of the moved edge is the `event` ref's `slot`.
+ *
+ * @property add - New item from a sibling Library landing on a target cell
+ * @property move - An event moved within one surface
+ * @property remove - An event dragged off the surface into a sink
+ * @property resize - A span event's edge dragged to a new slot
+ */
+export declare const DragEventType: VariantType<{
+    /** New item from a sibling Library landing on a target cell */
+    readonly add: StructType<{
+        /** Where the dragged card came from */
+        readonly from: StructType<{
+            /** The `id` the source Library declared */
+            readonly library: StringType;
+            /** The dragged card's item key within that Library */
+            readonly key: StringType;
+        }>;
+        /** The destination cell */
+        readonly into: StructType<{
+            /** The target surface's declared `id` */
+            readonly surface: StringType;
+            /** The row key */
+            readonly row: StringType;
+            /** The slot (column) key */
+            readonly slot: StringType;
+            /** The event key when the ref names an existing event */
+            readonly event: OptionType<StringType>;
+        }>;
+        /** Whether the drag was an alt-drag duplicate */
+        readonly duplicate: BooleanType;
+    }>;
+    /** An event moved within one surface */
+    readonly move: StructType<{
+        /** The cell (and event) the drag started from */
+        readonly from: StructType<{
+            /** The target surface's declared `id` */
+            readonly surface: StringType;
+            /** The row key */
+            readonly row: StringType;
+            /** The slot (column) key */
+            readonly slot: StringType;
+            /** The event key when the ref names an existing event */
+            readonly event: OptionType<StringType>;
+        }>;
+        /** The destination cell */
+        readonly to: StructType<{
+            /** The target surface's declared `id` */
+            readonly surface: StringType;
+            /** The row key */
+            readonly row: StringType;
+            /** The slot (column) key */
+            readonly slot: StringType;
+            /** The event key when the ref names an existing event */
+            readonly event: OptionType<StringType>;
+        }>;
+    }>;
+    /** An event dragged off the surface into a sink */
+    readonly remove: StructType<{
+        /** The cell (and event) the drag started from */
+        readonly from: StructType<{
+            /** The target surface's declared `id` */
+            readonly surface: StringType;
+            /** The row key */
+            readonly row: StringType;
+            /** The slot (column) key */
+            readonly slot: StringType;
+            /** The event key when the ref names an existing event */
+            readonly event: OptionType<StringType>;
+        }>;
+        /** The terminal destination */
+        readonly to: VariantType<{
+            /** Dropped on the trash affordance; permanent removal */
+            readonly trash: NullType;
+            /** Dragged back to the originating Library */
+            readonly source: NullType;
+        }>;
+    }>;
+    /** A span event's edge dragged to a new slot */
+    readonly resize: StructType<{
+        /** The event being resized; `slot` is the moved edge's new slot */
+        readonly event: StructType<{
+            /** The target surface's declared `id` */
+            readonly surface: StringType;
+            /** The row key */
+            readonly row: StringType;
+            /** The slot (column) key */
+            readonly slot: StringType;
+            /** The event key when the ref names an existing event */
+            readonly event: OptionType<StringType>;
+        }>;
+        /** Which boundary moved */
+        readonly edge: VariantType<{
+            /** The leading edge moved */
+            readonly start: NullType;
+            /** The trailing edge moved */
+            readonly end: NullType;
+        }>;
+    }>;
+}>;
+/**
+ * Type representing drag event values.
+ */
+export type DragEventType = typeof DragEventType;
+//# sourceMappingURL=drag.d.ts.map

package/dist/src/contracts/drag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag.d.ts","sourceRoot":"","sources":["../../../src/contracts/drag.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACd,MAAM,eAAe,CAAC;AAMvB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc;IACvB,2CAA2C;;IAE3C,sDAAsD;;EAExD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC;AAEnD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW;IACpB,yCAAyC;;IAEzC,kBAAkB;;IAElB,4BAA4B;;IAE5B,yDAAyD;;EAE3D,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC;AAE7C;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY;IACrB,yDAAyD;;IAEzD,8CAA8C;;EAEhD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,YAAY;IACrB,6BAA6B;;IAE7B,8BAA8B;;EAEhC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,KAAK,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,aAAa;IACtB,+DAA+D;;QAE3D,uCAAuC;;YA1H3C,2CAA2C;;YAE3C,sDAAsD;;;QA0HlD,2BAA2B;;YAlG/B,yCAAyC;;YAEzC,kBAAkB;;YAElB,4BAA4B;;YAE5B,yDAAyD;;;QA8FrD,iDAAiD;;;IAGrD,wCAAwC;;QAEpC,iDAAiD;;YAzGrD,yCAAyC;;YAEzC,kBAAkB;;YAElB,4BAA4B;;YAE5B,yDAAyD;;;QAqGrD,2BAA2B;;YA3G/B,yCAAyC;;YAEzC,kBAAkB;;YAElB,4BAA4B;;YAE5B,yDAAyD;;;;IAwGzD,mDAAmD;;QAE/C,iDAAiD;;YAhHrD,yCAAyC;;YAEzC,kBAAkB;;YAElB,4BAA4B;;YAE5B,yDAAyD;;;QA4GrD,+BAA+B;;YAxFnC,yDAAyD;;YAEzD,8CAA8C;;;;IAyF9C,gDAAgD;;QAE5C,mEAAmE;;YAvHvE,yCAAyC;;YAEzC,kBAAkB;;YAElB,4BAA4B;;YAE5B,yDAAyD;;;QAmHrD,2BAA2B;;YAxE/B,6BAA6B;;YAE7B,8BAA8B;;;;EAyEhC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC"}

package/dist/src/contracts/drag.js

@@ -0,0 +1,138 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { BooleanType, NullType, OptionType, StringType, StructType, VariantType, } from "@elaraai/east";
+// ============================================================================
+// Drag & drop grammar — shared contract for DnD-aware surfaces
+// ============================================================================
+/**
+ * Reference to an item in a Library (a drag **source**).
+ *
+ * @remarks
+ * Identifies where a dragged card came from: the `id` the Library surface
+ * declared, plus the dragged card's item key. Carried by the `add` case of
+ * {@link DragEventType}.
+ *
+ * @property library - The `id` the source Library declared
+ * @property key - The dragged card's item key within that Library
+ */
+export const LibraryRefType = StructType({
+    /** The `id` the source Library declared */
+    library: StringType,
+    /** The dragged card's item key within that Library */
+    key: StringType,
+});
+/**
+ * A cell coordinate on a drag **target** surface.
+ *
+ * @remarks
+ * Names a cell as `surface × row × slot`. When the reference points at an
+ * existing event in that cell (the `from` of a `move` / `remove`, or the
+ * subject of a `resize`), `event` carries the event's key; for an empty
+ * destination cell it is `none`.
+ *
+ * @property surface - The target surface's declared `id`
+ * @property row - The row key
+ * @property slot - The slot (column) key
+ * @property event - The event key when the ref names an existing event
+ */
+export const CellRefType = StructType({
+    /** The target surface's declared `id` */
+    surface: StringType,
+    /** The row key */
+    row: StringType,
+    /** The slot (column) key */
+    slot: StringType,
+    /** The event key when the ref names an existing event */
+    event: OptionType(StringType),
+});
+/**
+ * Terminal destination of a `remove` drag.
+ *
+ * @remarks
+ * The two canonical sinks: `trash` (permanent removal) and `source` (drag
+ * back to the originating Library — returns the item to the palette).
+ *
+ * @property trash - Dropped on the trash affordance; permanent removal
+ * @property source - Dragged back to the originating Library
+ */
+export const DragSinkType = VariantType({
+    /** Dropped on the trash affordance; permanent removal */
+    trash: NullType,
+    /** Dragged back to the originating Library */
+    source: NullType,
+});
+/**
+ * Which boundary of a span event a `resize` drag moved.
+ *
+ * @property start - The leading edge moved
+ * @property end - The trailing edge moved
+ */
+export const DragEdgeType = VariantType({
+    /** The leading edge moved */
+    start: NullType,
+    /** The trailing edge moved */
+    end: NullType,
+});
+/**
+ * The four drag event kinds — every drag interaction reduces to exactly one.
+ *
+ * @remarks
+ * The shared grammar for every DnD-aware surface. A target surface carries a
+ * single `onDrag` callback of this type; the renderer wires drag-flow between
+ * surfaces by matching their declared roles (a Library `source` connects to
+ * every target that lists it in `sources`), so hosts never wire handlers by
+ * hand. Every event funnels through the host's normal commit pipeline as a
+ * proposed patch — no drop writes state directly.
+ *
+ * - `add` is the only kind that crosses a source/target boundary: an item
+ *   leaving a Library and landing on a target cell. `duplicate` is set when
+ *   the drag was an alt-drag copy.
+ * - `move` is intra-surface only. A cross-row move still arrives as `move`;
+ *   the host derives any swap-proposal representation from
+ *   `from.row ≠ to.row`.
+ * - `remove` takes a {@link DragSinkType} destination: the trash affordance
+ *   or back to the originating Library.
+ * - `resize` exists only for span events with a duration (Gantt /
+ *   Planner.Span); the edge variant says which boundary moved, and the
+ *   destination slot of the moved edge is the `event` ref's `slot`.
+ *
+ * @property add - New item from a sibling Library landing on a target cell
+ * @property move - An event moved within one surface
+ * @property remove - An event dragged off the surface into a sink
+ * @property resize - A span event's edge dragged to a new slot
+ */
+export const DragEventType = VariantType({
+    /** New item from a sibling Library landing on a target cell */
+    add: StructType({
+        /** Where the dragged card came from */
+        from: LibraryRefType,
+        /** The destination cell */
+        into: CellRefType,
+        /** Whether the drag was an alt-drag duplicate */
+        duplicate: BooleanType,
+    }),
+    /** An event moved within one surface */
+    move: StructType({
+        /** The cell (and event) the drag started from */
+        from: CellRefType,
+        /** The destination cell */
+        to: CellRefType,
+    }),
+    /** An event dragged off the surface into a sink */
+    remove: StructType({
+        /** The cell (and event) the drag started from */
+        from: CellRefType,
+        /** The terminal destination */
+        to: DragSinkType,
+    }),
+    /** A span event's edge dragged to a new slot */
+    resize: StructType({
+        /** The event being resized; `slot` is the moved edge's new slot */
+        event: CellRefType,
+        /** Which boundary moved */
+        edge: DragEdgeType,
+    }),
+});
+//# sourceMappingURL=drag.js.map

package/dist/src/contracts/drag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag.js","sourceRoot":"","sources":["../../../src/contracts/drag.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,GACd,MAAM,eAAe,CAAC;AAEvB,+EAA+E;AAC/E,+DAA+D;AAC/D,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;IACrC,2CAA2C;IAC3C,OAAO,EAAE,UAAU;IACnB,sDAAsD;IACtD,GAAG,EAAE,UAAU;CAClB,CAAC,CAAC;AAOH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;IAClC,yCAAyC;IACzC,OAAO,EAAE,UAAU;IACnB,kBAAkB;IAClB,GAAG,EAAE,UAAU;IACf,4BAA4B;IAC5B,IAAI,EAAE,UAAU;IAChB,yDAAyD;IACzD,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC;CAChC,CAAC,CAAC;AAOH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;IACpC,yDAAyD;IACzD,KAAK,EAAE,QAAQ;IACf,8CAA8C;IAC9C,MAAM,EAAE,QAAQ;CACnB,CAAC,CAAC;AAYH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;IACpC,6BAA6B;IAC7B,KAAK,EAAE,QAAQ;IACf,8BAA8B;IAC9B,GAAG,EAAE,QAAQ;CAChB,CAAC,CAAC;AAYH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;IACrC,+DAA+D;IAC/D,GAAG,EAAE,UAAU,CAAC;QACZ,uCAAuC;QACvC,IAAI,EAAE,cAAc;QACpB,2BAA2B;QAC3B,IAAI,EAAE,WAAW;QACjB,iDAAiD;QACjD,SAAS,EAAE,WAAW;KACzB,CAAC;IACF,wCAAwC;IACxC,IAAI,EAAE,UAAU,CAAC;QACb,iDAAiD;QACjD,IAAI,EAAE,WAAW;QACjB,2BAA2B;QAC3B,EAAE,EAAE,WAAW;KAClB,CAAC;IACF,mDAAmD;IACnD,MAAM,EAAE,UAAU,CAAC;QACf,iDAAiD;QACjD,IAAI,EAAE,WAAW;QACjB,+BAA+B;QAC/B,EAAE,EAAE,YAAY;KACnB,CAAC;IACF,gDAAgD;IAChD,MAAM,EAAE,UAAU,CAAC;QACf,mEAAmE;QACnE,KAAK,EAAE,WAAW;QAClB,2BAA2B;QAC3B,IAAI,EAAE,YAAY;KACrB,CAAC;CACL,CAAC,CAAC"}

package/dist/src/contracts/index.d.ts

@@ -18,4 +18,5 @@
 export { StatusTokenType, type StatusTokenLiteral, HoverIntentType, type HoverIntentLiteral, DensityType, type DensityLiteral, VerbosityType, type VerbosityLiteral, ElevationType, type ElevationLiteral, FocusStyleType, type FocusStyleLiteral, TextStyleType, type TextStyleLiteral, MotionDurationType, type MotionDurationLiteral, MotionEasingType, type MotionEasingLiteral, TransitionType, type TransitionLiteral, } from "../style.js";
 export { StateValueType, type StateValueLiteral, StateValue, } from "./states.js";
 export { SliceAffordanceType, type SliceAffordanceLiteral, SliceAffordance, } from "./slice-affordances.js";
+export { LibraryRefType, CellRefType, DragSinkType, type DragSinkLiteral, DragEdgeType, type DragEdgeLiteral, DragEventType, } from "./drag.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/contracts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EACH,eAAe,EAAE,KAAK,kBAAkB,EACxC,eAAe,EAAE,KAAK,kBAAkB,EACxC,WAAW,EAAE,KAAK,cAAc,EAChC,aAAa,EAAE,KAAK,gBAAgB,EACpC,aAAa,EAAE,KAAK,gBAAgB,EACpC,cAAc,EAAE,KAAK,iBAAiB,EACtC,aAAa,EAAE,KAAK,gBAAgB,EACpC,kBAAkB,EAAE,KAAK,qBAAqB,EAC9C,gBAAgB,EAAE,KAAK,mBAAmB,EAC1C,cAAc,EAAE,KAAK,iBAAiB,GACzC,MAAM,aAAa,CAAC;AAErB,OAAO,EACH,cAAc,EAAE,KAAK,iBAAiB,EAAE,UAAU,GACrD,MAAM,aAAa,CAAC;AAErB,OAAO,EACH,mBAAmB,EAAE,KAAK,sBAAsB,EAAE,eAAe,GACpE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EACH,eAAe,EAAE,KAAK,kBAAkB,EACxC,eAAe,EAAE,KAAK,kBAAkB,EACxC,WAAW,EAAE,KAAK,cAAc,EAChC,aAAa,EAAE,KAAK,gBAAgB,EACpC,aAAa,EAAE,KAAK,gBAAgB,EACpC,cAAc,EAAE,KAAK,iBAAiB,EACtC,aAAa,EAAE,KAAK,gBAAgB,EACpC,kBAAkB,EAAE,KAAK,qBAAqB,EAC9C,gBAAgB,EAAE,KAAK,mBAAmB,EAC1C,cAAc,EAAE,KAAK,iBAAiB,GACzC,MAAM,aAAa,CAAC;AAErB,OAAO,EACH,cAAc,EAAE,KAAK,iBAAiB,EAAE,UAAU,GACrD,MAAM,aAAa,CAAC;AAErB,OAAO,EACH,mBAAmB,EAAE,KAAK,sBAAsB,EAAE,eAAe,GACpE,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACH,cAAc,EACd,WAAW,EACX,YAAY,EAAE,KAAK,eAAe,EAClC,YAAY,EAAE,KAAK,eAAe,EAClC,aAAa,GAChB,MAAM,WAAW,CAAC"}

package/dist/src/contracts/index.js

@@ -18,4 +18,5 @@
 export { StatusTokenType, HoverIntentType, DensityType, VerbosityType, ElevationType, FocusStyleType, TextStyleType, MotionDurationType, MotionEasingType, TransitionType, } from "../style.js";
 export { StateValueType, StateValue, } from "./states.js";
 export { SliceAffordanceType, SliceAffordance, } from "./slice-affordances.js";
+export { LibraryRefType, CellRefType, DragSinkType, DragEdgeType, DragEventType, } from "./drag.js";
 //# sourceMappingURL=index.js.map

package/dist/src/contracts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EACH,eAAe,EACf,eAAe,EACf,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACH,cAAc,EAA0B,UAAU,GACrD,MAAM,aAAa,CAAC;AAErB,OAAO,EACH,mBAAmB,EAA+B,eAAe,GACpE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EACH,eAAe,EACf,eAAe,EACf,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACH,cAAc,EAA0B,UAAU,GACrD,MAAM,aAAa,CAAC;AAErB,OAAO,EACH,mBAAmB,EAA+B,eAAe,GACpE,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACH,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,GAChB,MAAM,WAAW,CAAC"}

package/dist/src/contracts/slice-affordances.d.ts

@@ -9,7 +9,7 @@ import { NullType, VariantType, type ExprType } from "@elaraai/east";
  *
  * @remarks
  * The developer lists which affordances appear (and in what order) via
- * `Slice.Frame.Root(slice, body, { affordances: [...] })`. The renderer mounts
+ * `Slice.Frame.Root(body, { slice, affordances: [...] })`. The renderer mounts
  * the matching `Slice.*` component in compact density and places it by kind:
  *
  * | Affordance | Zone | Compact form |
@@ -28,6 +28,10 @@ import { NullType, VariantType, type ExprType } from "@elaraai/east";
  * @property breakdown - Split-by-dimension chips (left zone)
  * @property range - Time-range pill (right zone)
  * @property cohort - Saved-segment pills (left zone)
+ * @property brush - Drag-a-window gesture writing the slice's range. Hosts
+ *   render it natively: a Chart brushes the plot's continuous x, a Gantt the
+ *   timeline, a standalone `Slice.Rail` the mini brush strip. Hosts with no
+ *   continuous axis reject it at the factory.
  */
 export declare const SliceAffordanceType: VariantType<{
     readonly filter: NullType;
@@ -35,11 +39,12 @@ export declare const SliceAffordanceType: VariantType<{
     readonly breakdown: NullType;
     readonly range: NullType;
     readonly cohort: NullType;
+    readonly brush: NullType;
 }>;
 /** Type representing slice affordance variant values. */
 export type SliceAffordanceType = typeof SliceAffordanceType;
 /** String literal type for slice affordances. */
-export type SliceAffordanceLiteral = "filter" | "search" | "breakdown" | "range" | "cohort";
+export type SliceAffordanceLiteral = "filter" | "search" | "breakdown" | "range" | "cohort" | "brush";
 /**
  * Creates a slice affordance variant expression.
  *
@@ -50,9 +55,9 @@ export type SliceAffordanceLiteral = "filter" | "search" | "breakdown" | "range"
  * ```ts
  * import { SliceAffordance } from "@elaraai/east-ui/contracts";
  *
- * Slice.Frame.Root(slice, body, { affordances: [SliceAffordance("filter"), SliceAffordance("search")] });
+ * Slice.Frame.Root(body, { slice, affordances: [SliceAffordance("filter"), SliceAffordance("search")] });
  * // or, equivalently, the string shorthand:
- * Slice.Frame.Root(slice, body, { affordances: ["filter", "search"] });
+ * Slice.Frame.Root(body, { slice, affordances: ["filter", "search"] });
  * ```
  */
 export declare function SliceAffordance(affordance: SliceAffordanceLiteral): ExprType<SliceAffordanceType>;

package/dist/src/contracts/slice-affordances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slice-affordances.d.ts","sourceRoot":"","sources":["../../../src/contracts/slice-affordances.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,QAAQ,EAAW,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAMpF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,mBAAmB;;;;;;EAM9B,CAAC;AAEH,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAE7D,iDAAiD;AACjD,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5F;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,sBAAsB,GAAG,QAAQ,CAAC,mBAAmB,CAAC,CAEjG"}
+{"version":3,"file":"slice-affordances.d.ts","sourceRoot":"","sources":["../../../src/contracts/slice-affordances.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,QAAQ,EAAW,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAMpF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,mBAAmB;;;;;;;EAO9B,CAAC;AAEH,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAE7D,iDAAiD;AACjD,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtG;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,sBAAsB,GAAG,QAAQ,CAAC,mBAAmB,CAAC,CAEjG"}

package/dist/src/contracts/slice-affordances.js

@@ -12,7 +12,7 @@ import { East, NullType, variant, VariantType } from "@elaraai/east";
  *
  * @remarks
  * The developer lists which affordances appear (and in what order) via
- * `Slice.Frame.Root(slice, body, { affordances: [...] })`. The renderer mounts
+ * `Slice.Frame.Root(body, { slice, affordances: [...] })`. The renderer mounts
  * the matching `Slice.*` component in compact density and places it by kind:
  *
  * | Affordance | Zone | Compact form |
@@ -31,6 +31,10 @@ import { East, NullType, variant, VariantType } from "@elaraai/east";
  * @property breakdown - Split-by-dimension chips (left zone)
  * @property range - Time-range pill (right zone)
  * @property cohort - Saved-segment pills (left zone)
+ * @property brush - Drag-a-window gesture writing the slice's range. Hosts
+ *   render it natively: a Chart brushes the plot's continuous x, a Gantt the
+ *   timeline, a standalone `Slice.Rail` the mini brush strip. Hosts with no
+ *   continuous axis reject it at the factory.
  */
 export const SliceAffordanceType = VariantType({
     filter: NullType,
@@ -38,6 +42,7 @@ export const SliceAffordanceType = VariantType({
     breakdown: NullType,
     range: NullType,
     cohort: NullType,
+    brush: NullType,
 });
 /**
  * Creates a slice affordance variant expression.
@@ -49,9 +54,9 @@ export const SliceAffordanceType = VariantType({
  * ```ts
  * import { SliceAffordance } from "@elaraai/east-ui/contracts";
  *
- * Slice.Frame.Root(slice, body, { affordances: [SliceAffordance("filter"), SliceAffordance("search")] });
+ * Slice.Frame.Root(body, { slice, affordances: [SliceAffordance("filter"), SliceAffordance("search")] });
  * // or, equivalently, the string shorthand:
- * Slice.Frame.Root(slice, body, { affordances: ["filter", "search"] });
+ * Slice.Frame.Root(body, { slice, affordances: ["filter", "search"] });
  * ```
  */
 export function SliceAffordance(affordance) {

package/dist/src/contracts/slice-affordances.js.map

@@ -1 +1 @@
-{"version":3,"file":"slice-affordances.js","sourceRoot":"","sources":["../../../src/contracts/slice-affordances.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAiB,MAAM,eAAe,CAAC;AAEpF,+EAA+E;AAC/E,uDAAuD;AACvD,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;IAC3C,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,QAAQ;IACnB,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;CACnB,CAAC,CAAC;AAQH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkC;IAC9D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,mBAAmB,CAAC,CAAC;AACtE,CAAC"}
+{"version":3,"file":"slice-affordances.js","sourceRoot":"","sources":["../../../src/contracts/slice-affordances.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAiB,MAAM,eAAe,CAAC;AAEpF,+EAA+E;AAC/E,uDAAuD;AACvD,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;IAC3C,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,QAAQ;IACnB,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,QAAQ;CAClB,CAAC,CAAC;AAQH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkC;IAC9D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,mBAAmB,CAAC,CAAC;AACtE,CAAC"}

package/dist/src/disclosure/accordion/index.d.ts

@@ -100,9 +100,9 @@ declare function createAccordionItem(value: SubtypeExprOrValue<StringType>, titl
  * @returns An East expression representing the Accordion component
  *
  * @remarks
- * `multiple` / `collapsible` (config),
- * `value` / `defaultValue` (state), and `onValueChange` (behaviour) are
- * top-level options — visual presentation lives inside `options.style`.
+ * `multiple` / `collapsible` (config), `value` / `defaultValue` (state),
+ * `onValueChange` (behaviour), and the visual style fields all sit in one
+ * flat options bag.
  *
  * @example
  * ```ts
@@ -117,7 +117,7 @@ declare function createAccordionItem(value: SubtypeExprOrValue<StringType>, titl
  *     ], {
  *         multiple: true,
  *         collapsible: true,
- *         style: { variant: "enclosed" },
+ *         variant: "enclosed",
  *     }),
  * );
  *
@@ -132,7 +132,7 @@ declare function createAccordionItem(value: SubtypeExprOrValue<StringType>, titl
  *         return Accordion.Root([
  *             Accordion.Item("a", "Section A", [Text.Root("A")]),
  *             Accordion.Item("b", "Section B", [Text.Root("B")]),
- *         ], { multiple: true, value: expanded, onValueChange, style: { variant: "enclosed" } });
+ *         ], { multiple: true, value: expanded, onValueChange, variant: "enclosed" });
  *     })),
  * );
  * ```
@@ -157,8 +157,8 @@ export declare const Accordion: {
      *
      * @remarks
      * See {@link createAccordionRoot} for full semantics. `multiple` /
-     * `collapsible` / `value` / `defaultValue` / `onValueChange` are top-level
-     * options; `style` holds visual presets and colour slots.
+     * `collapsible` / `value` / `defaultValue` / `onValueChange` sit alongside
+     * the visual style fields (variant / size / colour slots) in one flat bag.
      *
      * @example
      * ```ts
@@ -172,7 +172,7 @@ export declare const Accordion: {
      *     ], {
      *         multiple: true,
      *         collapsible: true,
-     *         style: { variant: "enclosed" },
+     *         variant: "enclosed",
      *     }),
      * );
      * ```

package/dist/src/disclosure/accordion/index.d.ts.map

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

package/dist/src/disclosure/accordion/index.js

@@ -114,9 +114,9 @@ function createAccordionItem(value, title, content, options) {
  * @returns An East expression representing the Accordion component
  *
  * @remarks
- * `multiple` / `collapsible` (config),
- * `value` / `defaultValue` (state), and `onValueChange` (behaviour) are
- * top-level options — visual presentation lives inside `options.style`.
+ * `multiple` / `collapsible` (config), `value` / `defaultValue` (state),
+ * `onValueChange` (behaviour), and the visual style fields all sit in one
+ * flat options bag.
  *
  * @example
  * ```ts
@@ -131,7 +131,7 @@ function createAccordionItem(value, title, content, options) {
  *     ], {
  *         multiple: true,
  *         collapsible: true,
- *         style: { variant: "enclosed" },
+ *         variant: "enclosed",
  *     }),
  * );
  *
@@ -146,13 +146,15 @@ function createAccordionItem(value, title, content, options) {
  *         return Accordion.Root([
  *             Accordion.Item("a", "Section A", [Text.Root("A")]),
  *             Accordion.Item("b", "Section B", [Text.Root("B")]),
- *         ], { multiple: true, value: expanded, onValueChange, style: { variant: "enclosed" } });
+ *         ], { multiple: true, value: expanded, onValueChange, variant: "enclosed" });
  *     })),
  * );
  * ```
  */
 function createAccordionRoot(items, options) {
-    const styleValue = options?.style ? buildAccordionStyle(options.style) : undefined;
+    const { multiple, collapsible, value, defaultValue, onValueChange, ...visual } = options ?? {};
+    const hasVisual = Object.values(visual).some(field => field !== undefined);
+    const styleValue = hasVisual ? buildAccordionStyle(visual) : undefined;
     // The inline `Accordion` variant in `component.ts` defines `items` using
     // the recursive `node` parameter for the trigger/content UIComp fields.
     // TS can't prove `AccordionItemType` (typed with `UIComponentType`) is
@@ -160,11 +162,11 @@ function createAccordionRoot(items, options) {
     // same thing — cast at the variant-construction boundary.
     return East.value(variant("Accordion", {
         items: items,
-        multiple: options?.multiple !== undefined ? some(options.multiple) : none,
-        collapsible: options?.collapsible !== undefined ? some(options.collapsible) : none,
-        value: options?.value !== undefined ? some(options.value) : none,
-        defaultValue: options?.defaultValue !== undefined ? some(options.defaultValue) : none,
-        onValueChange: options?.onValueChange ? some(options.onValueChange) : none,
+        multiple: multiple !== undefined ? some(multiple) : none,
+        collapsible: collapsible !== undefined ? some(collapsible) : none,
+        value: value !== undefined ? some(value) : none,
+        defaultValue: defaultValue !== undefined ? some(defaultValue) : none,
+        onValueChange: onValueChange ? some(onValueChange) : none,
         style: styleValue ? some(styleValue) : none,
     }), UIComponentType);
 }
@@ -211,8 +213,8 @@ export const Accordion = {
      *
      * @remarks
      * See {@link createAccordionRoot} for full semantics. `multiple` /
-     * `collapsible` / `value` / `defaultValue` / `onValueChange` are top-level
-     * options; `style` holds visual presets and colour slots.
+     * `collapsible` / `value` / `defaultValue` / `onValueChange` sit alongside
+     * the visual style fields (variant / size / colour slots) in one flat bag.
      *
      * @example
      * ```ts
@@ -226,7 +228,7 @@ export const Accordion = {
      *     ], {
      *         multiple: true,
      *         collapsible: true,
-     *         style: { variant: "enclosed" },
+     *         variant: "enclosed",
      *     }),
      * );
      * ```