@elaraai/east-ui 1.0.34 → 1.0.35

package/dist/src/layout/dock/index.js

@@ -0,0 +1,150 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { East, ArrayType, BooleanType, FunctionType, NullType, OptionType, StructType, variant, some, none, } from "@elaraai/east";
+import { UIComponentType } from "../../component.js";
+import { DockStyleType, DockOrientationType, DockSideType, DockPersistType, } from "./types.js";
+// Re-export types
+export { DockStyleType, DockOrientationType, DockSideType, DockPersistType, } from "./types.js";
+// ============================================================================
+// DockType — standalone mirror of the inline `Dock` variant
+// ============================================================================
+/**
+ * Concrete struct mirroring the inline `Dock` variant in `component.ts`.
+ * Renderers reference this for `equalFor` / `ValueTypeOf`.
+ *
+ * @property body - The expanded content (UIComps) — kept mounted across collapse by default
+ * @property collapsed - Collapsed state (synced on change; omit for uncontrolled toggling)
+ * @property defaultCollapsed - Uncontrolled initial collapsed state
+ * @property onCollapsedChange - Callback invoked with the new collapsed state
+ * @property style - Presentation + behaviour sub-struct
+ */
+export const DockType = StructType({
+    body: ArrayType(UIComponentType),
+    collapsed: OptionType(BooleanType),
+    defaultCollapsed: OptionType(BooleanType),
+    onCollapsedChange: OptionType(FunctionType([BooleanType], NullType)),
+    style: OptionType(DockStyleType),
+});
+// ============================================================================
+// Dock Factory
+// ============================================================================
+/** Resolve a variant string shorthand (or pass a value/expression through). */
+function orientationValue(v) {
+    return typeof v === "string" ? East.value(variant(v, null), DockOrientationType) : v;
+}
+function sideValue(v) {
+    return typeof v === "string" ? East.value(variant(v, null), DockSideType) : v;
+}
+function persistValue(v) {
+    return typeof v === "string" ? East.value(variant(v, null), DockPersistType) : v;
+}
+/**
+ * Creates a Dock — an inline panel that collapses along one axis to a compact
+ * icon rail and expands back to its full content, without leaving the
+ * document flow (siblings reflow; it never overlays).
+ *
+ * @param children - The expanded content (UIComps)
+ * @param options - Optional collapsed-state / behaviour / presentation fields
+ * @returns An East expression representing the Dock component
+ *
+ * @remarks
+ * The in-flow, collapse-to-rail sibling of `Expandable` (which does the
+ * opposite — a CSS takeover that fills the app container). A Dock stays an
+ * ordinary flex child: collapsed, it shrinks to `railSize` and the freed
+ * space is reclaimed by its siblings — so it can sit beside a drop target (a
+ * `Planner`, a board) and tuck away without covering it. Arbitrarily nestable;
+ * each dock keyed by its own structural storage key. Drive it from state with
+ * `collapsed` + `onCollapsedChange`, or omit both for uncontrolled toggling
+ * (optionally `persist`ed). Distinct from the disclosure `Collapsible`
+ * (trigger + content show/hide) and `Dialog` / `Drawer` (portalled overlays).
+ *
+ * @example
+ * ```ts
+ * import { East } from "@elaraai/east";
+ * import { Box, Dock, Text, UIComponentType } from "@elaraai/east-ui/internal";
+ *
+ * const sidebar = East.function([], UIComponentType, _$ =>
+ *     Dock.Root(
+ *         [Box.Root([Text.Root("Bookings library")], { padding: "3" })],
+ *         { icon: "book", label: "Bookings", expandedSize: "25%" },
+ *     ),
+ * );
+ * ```
+ */
+function createDock(children, options) {
+    const hasStyle = options !== undefined && (options.orientation !== undefined || options.side !== undefined
+        || options.expandedSize !== undefined || options.railSize !== undefined
+        || options.icon !== undefined || options.label !== undefined || options.badge !== undefined
+        || options.persist !== undefined || options.keepMounted !== undefined
+        || options.lazy !== undefined || options.animated !== undefined);
+    const styleValue = hasStyle
+        ? East.value({
+            orientation: options.orientation !== undefined ? some(orientationValue(options.orientation)) : none,
+            side: options.side !== undefined ? some(sideValue(options.side)) : none,
+            expandedSize: options.expandedSize !== undefined ? some(options.expandedSize) : none,
+            railSize: options.railSize !== undefined ? some(options.railSize) : none,
+            icon: options.icon !== undefined ? some(options.icon) : none,
+            label: options.label !== undefined ? some(options.label) : none,
+            badge: options.badge !== undefined ? some(options.badge) : none,
+            persist: options.persist !== undefined ? some(persistValue(options.persist)) : none,
+            keepMounted: options.keepMounted !== undefined ? some(options.keepMounted) : none,
+            lazy: options.lazy !== undefined ? some(options.lazy) : none,
+            animated: options.animated !== undefined ? some(options.animated) : none,
+        }, DockStyleType)
+        : undefined;
+    return East.value(variant("Dock", {
+        body: children,
+        collapsed: options?.collapsed !== undefined ? some(options.collapsed) : none,
+        defaultCollapsed: options?.defaultCollapsed !== undefined ? some(options.defaultCollapsed) : none,
+        onCollapsedChange: options?.onCollapsedChange ? some(options.onCollapsedChange) : none,
+        style: styleValue ? some(styleValue) : none,
+    }), UIComponentType);
+}
+/**
+ * Dock primitive — an inline panel that collapses along an axis to an icon
+ * rail, staying in the document flow.
+ *
+ * @remarks
+ * Use `Dock.Root(children, opts)`. Types are exposed via `Dock.Types`.
+ */
+export const Dock = {
+    /**
+     * Creates a Dock component.
+     *
+     * @param children - The expanded content (UIComps)
+     * @param options - Optional collapsed-state / behaviour / presentation fields
+     * @returns An East expression representing the Dock component
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Box, Dock, Text, UIComponentType } from "@elaraai/east-ui/internal";
+     *
+     * const ex = East.function([], UIComponentType, _$ =>
+     *     Dock.Root(
+     *         [Box.Root([Text.Root("Bookings library")], { padding: "3" })],
+     *         { icon: "book", label: "Bookings", expandedSize: "25%" },
+     *     ),
+     * );
+     * ```
+     */
+    Root: createDock,
+    Types: {
+        /**
+         * The concrete East type for Dock — mirrors the inline `Dock` variant
+         * in `component.ts`.
+         */
+        Dock: DockType,
+        /** Presentation + behaviour config struct for Dock. */
+        Style: DockStyleType,
+        /** Collapse-axis variant (`horizontal` / `vertical`). */
+        Orientation: DockOrientationType,
+        /** Rail-edge variant (`start` / `end`). */
+        Side: DockSideType,
+        /** Persistence variant (`none` / `local` / `session`). */
+        Persist: DockPersistType,
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/src/layout/dock/index.js.map

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

package/dist/src/layout/dock/types.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { type SubtypeExprOrValue, BooleanType, FunctionType, NullType, OptionType, StringType, StructType, VariantType } from "@elaraai/east";
+/**
+ * The axis a {@link DockStyleType} collapses along.
+ *
+ * @property horizontal - Collapses its width to a vertical rail (a sidebar)
+ * @property vertical   - Collapses its height to a horizontal rail (a tray)
+ */
+export declare const DockOrientationType: VariantType<{
+    readonly horizontal: NullType;
+    readonly vertical: NullType;
+}>;
+export type DockOrientationType = typeof DockOrientationType;
+/**
+ * Which edge the collapsed rail pins to — also sets the toggle chevron
+ * direction.
+ *
+ * @property start - Leading edge (left when horizontal, top when vertical)
+ * @property end   - Trailing edge (right when horizontal, bottom when vertical)
+ */
+export declare const DockSideType: VariantType<{
+    readonly start: NullType;
+    readonly end: NullType;
+}>;
+export type DockSideType = typeof DockSideType;
+/**
+ * Where the uncontrolled collapsed state is persisted, keyed by the dock's
+ * structural storage key.
+ *
+ * @property none    - Not persisted (resets on reload)
+ * @property local   - `localStorage` (survives reload + browser restart)
+ * @property session - `sessionStorage` (survives reload, cleared with the tab)
+ */
+export declare const DockPersistType: VariantType<{
+    readonly none: NullType;
+    readonly local: NullType;
+    readonly session: NullType;
+}>;
+export type DockPersistType = typeof DockPersistType;
+/**
+ * Presentation + behaviour configuration for a Dock. Every field optional;
+ * the renderer falls back to a horizontal sidebar that pins to the `start`
+ * edge, `44px` rail, keep-mounted body.
+ *
+ * @property orientation - Axis it collapses along (default `horizontal`)
+ * @property side        - Edge the rail pins to → chevron direction (default `start`)
+ * @property expandedSize - Size ALONG the axis when expanded (px or %, e.g. `"25%"`)
+ * @property railSize    - Size when collapsed — the icon rail (default `44px`)
+ * @property icon        - Font Awesome icon name shown on the rail + header
+ * @property label       - Header title (expanded) + rail tooltip / accessible name (collapsed)
+ * @property badge       - Optional count/label shown on the rail + header
+ * @property persist     - Where the uncontrolled collapsed state is persisted (default `none`)
+ * @property keepMounted - Keep the body mounted while collapsed to preserve its scroll / drag / search state (default `true`)
+ * @property lazy        - Mount the body only on first expand (default `false`)
+ * @property animated    - Smoothly transition the size between rail and expanded (default `false`)
+ */
+export declare const DockStyleType: StructType<{
+    readonly orientation: OptionType<VariantType<{
+        readonly horizontal: NullType;
+        readonly vertical: NullType;
+    }>>;
+    readonly side: OptionType<VariantType<{
+        readonly start: NullType;
+        readonly end: NullType;
+    }>>;
+    readonly expandedSize: OptionType<StringType>;
+    readonly railSize: OptionType<StringType>;
+    readonly icon: OptionType<StringType>;
+    readonly label: OptionType<StringType>;
+    readonly badge: OptionType<StringType>;
+    readonly persist: OptionType<VariantType<{
+        readonly none: NullType;
+        readonly local: NullType;
+        readonly session: NullType;
+    }>>;
+    readonly keepMounted: OptionType<BooleanType>;
+    readonly lazy: OptionType<BooleanType>;
+    readonly animated: OptionType<BooleanType>;
+}>;
+export type DockStyleType = typeof DockStyleType;
+/** String shorthand for {@link DockOrientationType}. */
+export type DockOrientationLiteral = "horizontal" | "vertical";
+/** String shorthand for {@link DockSideType}. */
+export type DockSideLiteral = "start" | "end";
+/** String shorthand for {@link DockPersistType}. */
+export type DockPersistLiteral = "none" | "local" | "session";
+/**
+ * TypeScript style interface for {@link DockStyleType} — the flat config bag.
+ */
+export interface DockStyle {
+    /** Axis it collapses along (default `horizontal`). */
+    orientation?: SubtypeExprOrValue<DockOrientationType> | DockOrientationLiteral;
+    /** Edge the rail pins to → chevron direction (default `start`). */
+    side?: SubtypeExprOrValue<DockSideType> | DockSideLiteral;
+    /** Size along the axis when expanded (px or %, e.g. `"25%"`). */
+    expandedSize?: SubtypeExprOrValue<StringType>;
+    /** Size when collapsed — the icon rail (default `44px`). */
+    railSize?: SubtypeExprOrValue<StringType>;
+    /** Font Awesome icon name shown on the rail + header. */
+    icon?: SubtypeExprOrValue<StringType>;
+    /** Header title (expanded) + rail tooltip / accessible name (collapsed). */
+    label?: SubtypeExprOrValue<StringType>;
+    /** Optional count/label shown on the rail + header. */
+    badge?: SubtypeExprOrValue<StringType>;
+    /** Where the uncontrolled collapsed state is persisted (default `none`). */
+    persist?: SubtypeExprOrValue<DockPersistType> | DockPersistLiteral;
+    /** Keep the body mounted while collapsed to preserve its state (default `true`). */
+    keepMounted?: SubtypeExprOrValue<BooleanType>;
+    /** Mount the body only on first expand (default `false`). */
+    lazy?: SubtypeExprOrValue<BooleanType>;
+    /** Smoothly transition the size between rail and expanded (default `false`). */
+    animated?: SubtypeExprOrValue<BooleanType>;
+}
+/**
+ * Dock options — passed to `Dock.Root(children, opts)`. Extends
+ * {@link DockStyle} with the collapsed-state behaviour fields.
+ */
+export interface DockOptions extends DockStyle {
+    /**
+     * Collapsed state. Synced on change (forms convention), so a
+     * `State.bind`-driven value controls the dock reactively; omit for
+     * uncontrolled toggling via the built-in control.
+     */
+    collapsed?: SubtypeExprOrValue<BooleanType>;
+    /** Uncontrolled initial collapsed state (default `false`). */
+    defaultCollapsed?: SubtypeExprOrValue<BooleanType>;
+    /** Callback invoked with the new collapsed state when the user toggles. */
+    onCollapsedChange?: SubtypeExprOrValue<FunctionType<[BooleanType], NullType>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/layout/dock/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/layout/dock/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,kBAAkB,EACvB,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACd,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;EAG9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAE7D;;;;;;GAMG;AACH,eAAO,MAAM,YAAY;;;EAGvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC;AAE/C;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;;;;EAI1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC;AAErD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;EAYxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAEjD,wDAAwD;AACxD,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG,UAAU,CAAC;AAC/D,iDAAiD;AACjD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,KAAK,CAAC;AAC9C,oDAAoD;AACpD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,sDAAsD;IACtD,WAAW,CAAC,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,GAAG,sBAAsB,CAAC;IAC/E,mEAAmE;IACnE,IAAI,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,GAAG,eAAe,CAAC;IAC1D,iEAAiE;IACjE,YAAY,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC9C,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC1C,yDAAyD;IACzD,IAAI,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACtC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACvC,uDAAuD;IACvD,KAAK,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACvC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,kBAAkB,CAAC,eAAe,CAAC,GAAG,kBAAkB,CAAC;IACnE,oFAAoF;IACpF,WAAW,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC9C,6DAA6D;IAC7D,IAAI,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACvC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC1C;;;;OAIG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC5C,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACnD,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;CACjF"}

package/dist/src/layout/dock/types.js

@@ -0,0 +1,70 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { BooleanType, FunctionType, NullType, OptionType, StringType, StructType, VariantType, } from "@elaraai/east";
+/**
+ * The axis a {@link DockStyleType} collapses along.
+ *
+ * @property horizontal - Collapses its width to a vertical rail (a sidebar)
+ * @property vertical   - Collapses its height to a horizontal rail (a tray)
+ */
+export const DockOrientationType = VariantType({
+    horizontal: NullType,
+    vertical: NullType,
+});
+/**
+ * Which edge the collapsed rail pins to — also sets the toggle chevron
+ * direction.
+ *
+ * @property start - Leading edge (left when horizontal, top when vertical)
+ * @property end   - Trailing edge (right when horizontal, bottom when vertical)
+ */
+export const DockSideType = VariantType({
+    start: NullType,
+    end: NullType,
+});
+/**
+ * Where the uncontrolled collapsed state is persisted, keyed by the dock's
+ * structural storage key.
+ *
+ * @property none    - Not persisted (resets on reload)
+ * @property local   - `localStorage` (survives reload + browser restart)
+ * @property session - `sessionStorage` (survives reload, cleared with the tab)
+ */
+export const DockPersistType = VariantType({
+    none: NullType,
+    local: NullType,
+    session: NullType,
+});
+/**
+ * Presentation + behaviour configuration for a Dock. Every field optional;
+ * the renderer falls back to a horizontal sidebar that pins to the `start`
+ * edge, `44px` rail, keep-mounted body.
+ *
+ * @property orientation - Axis it collapses along (default `horizontal`)
+ * @property side        - Edge the rail pins to → chevron direction (default `start`)
+ * @property expandedSize - Size ALONG the axis when expanded (px or %, e.g. `"25%"`)
+ * @property railSize    - Size when collapsed — the icon rail (default `44px`)
+ * @property icon        - Font Awesome icon name shown on the rail + header
+ * @property label       - Header title (expanded) + rail tooltip / accessible name (collapsed)
+ * @property badge       - Optional count/label shown on the rail + header
+ * @property persist     - Where the uncontrolled collapsed state is persisted (default `none`)
+ * @property keepMounted - Keep the body mounted while collapsed to preserve its scroll / drag / search state (default `true`)
+ * @property lazy        - Mount the body only on first expand (default `false`)
+ * @property animated    - Smoothly transition the size between rail and expanded (default `false`)
+ */
+export const DockStyleType = StructType({
+    orientation: OptionType(DockOrientationType),
+    side: OptionType(DockSideType),
+    expandedSize: OptionType(StringType),
+    railSize: OptionType(StringType),
+    icon: OptionType(StringType),
+    label: OptionType(StringType),
+    badge: OptionType(StringType),
+    persist: OptionType(DockPersistType),
+    keepMounted: OptionType(BooleanType),
+    lazy: OptionType(BooleanType),
+    animated: OptionType(BooleanType),
+});
+//# sourceMappingURL=types.js.map

package/dist/src/layout/dock/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/layout/dock/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEH,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,GACd,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;IAC3C,UAAU,EAAE,QAAQ;IACpB,QAAQ,EAAE,QAAQ;CACrB,CAAC,CAAC;AAGH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;IACpC,KAAK,EAAE,QAAQ;IACf,GAAG,EAAE,QAAQ;CAChB,CAAC,CAAC;AAGH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;IACvC,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE,QAAQ;CACpB,CAAC,CAAC;AAGH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;IACpC,WAAW,EAAE,UAAU,CAAC,mBAAmB,CAAC;IAC5C,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC;IAC9B,YAAY,EAAE,UAAU,CAAC,UAAU,CAAC;IACpC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC;IAChC,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC;IAC5B,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC;IAC7B,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC;IAC7B,OAAO,EAAE,UAAU,CAAC,eAAe,CAAC;IACpC,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC;IACpC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC;IAC7B,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC;CACpC,CAAC,CAAC"}

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

@@ -12,4 +12,5 @@ export { Splitter } from "./splitter/index.js";
 export { Sticky } from "./sticky/index.js";
 export { ScrollArea } from "./scroll-area/index.js";
 export { Expandable } from "./expandable/index.js";
+export { Dock } from "./dock/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/layout/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/layout/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/layout/index.js

@@ -12,4 +12,5 @@ export { Splitter } from "./splitter/index.js";
 export { Sticky } from "./sticky/index.js";
 export { ScrollArea } from "./scroll-area/index.js";
 export { Expandable } from "./expandable/index.js";
+export { Dock } from "./dock/index.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/layout/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/layout/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/overlays/drawer/index.d.ts

@@ -236,6 +236,8 @@ export declare const Drawer: {
             readonly bodyPadding: OptionType<StringType>;
             readonly flush: OptionType<import("@elaraai/east").BooleanType>;
             readonly fillBody: OptionType<import("@elaraai/east").BooleanType>;
+            readonly stacked: OptionType<import("@elaraai/east").BooleanType>;
+            readonly stackIcon: OptionType<StringType>;
         }>;
         /**
          * Size variant type for Drawer component.

package/dist/src/overlays/drawer/index.d.ts.map

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

package/dist/src/overlays/drawer/index.js

@@ -70,7 +70,8 @@ function createDrawer(body, options) {
         : undefined;
     const hasStyle = sizeValue || placementValue || style.contained !== undefined ||
         style.onOpenChange !== undefined || style.onExitComplete !== undefined ||
-        style.bodyPadding !== undefined || style.flush !== undefined || style.fillBody !== undefined;
+        style.bodyPadding !== undefined || style.flush !== undefined || style.fillBody !== undefined ||
+        style.stacked !== undefined || style.stackIcon !== undefined;
     return East.value(variant("Drawer", {
         trigger: trigger,
         body: body,
@@ -87,6 +88,8 @@ function createDrawer(body, options) {
                 bodyPadding: style.bodyPadding !== undefined ? some(style.bodyPadding) : none,
                 flush: style.flush !== undefined ? some(style.flush) : none,
                 fillBody: style.fillBody !== undefined ? some(style.fillBody) : none,
+                stacked: style.stacked !== undefined ? some(style.stacked) : none,
+                stackIcon: style.stackIcon !== undefined ? some(style.stackIcon) : none,
             }, DrawerStyleType))
             : none,
     }), UIComponentType);

package/dist/src/overlays/drawer/index.js.map

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

package/dist/src/overlays/drawer/types.d.ts

@@ -77,6 +77,10 @@ export declare const DrawerStyleType: StructType<{
     readonly flush: OptionType<BooleanType>;
     /** When `true`, body becomes a definite-height flex column so a single child fills + owns its scroll */
     readonly fillBody: OptionType<BooleanType>;
+    /** When `true`, this drawer collapses to a thin vertical rail (icon + rotated title) while a deeper drawer is open on top of it, instead of hiding behind it (#328); clicking the rail pops the stack back to it */
+    readonly stacked: OptionType<BooleanType>;
+    /** Font Awesome icon name shown on the collapsed stack rail (#328); falls back to a chevron */
+    readonly stackIcon: OptionType<StringType>;
 }>;
 export type DrawerStyleType = typeof DrawerStyleType;
 /**
@@ -135,5 +139,9 @@ export interface DrawerStyle {
     flush?: SubtypeExprOrValue<BooleanType>;
     /** When `true`, the body is a definite-height flex column (`minHeight:0`, clipped) so a single `height:100%`/`flex:1` child fills the panel and owns its internal scroll instead of the whole panel scrolling. */
     fillBody?: SubtypeExprOrValue<BooleanType>;
+    /** When `true`, this drawer collapses to a thin vertical rail (icon + rotated title) while a deeper drawer is open on top of it — instead of hiding behind it — so the stack you drilled through stays a visible, navigable spine (#328). Click the rail to pop back to this drawer (closing the deeper ones); Esc pops one level. */
+    stacked?: SubtypeExprOrValue<BooleanType>;
+    /** Font Awesome icon name shown on the collapsed stack rail (#328); falls back to a chevron. */
+    stackIcon?: SubtypeExprOrValue<StringType>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/src/overlays/drawer/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/overlays/drawer/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,kBAAkB,EACvB,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,UAAU,EACV,YAAY,EACf,MAAM,eAAe,CAAC;AAMvB;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc;;;;;;;EAOzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC;AACnD,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAM1E;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;;EAK9B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAC7D,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAMxE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;IAIxB,iDAAiD;;IAEjD,uDAAuD;;IAEvD,iEAAiE;;IAEjE,8EAA8E;;IAE9E,wGAAwG;;EAE1G,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC;AAMrD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,WAAW;IACxB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,kBAAkB,CAAC,cAAc,CAAC,GAAG,iBAAiB,CAAC;IAC9D,qBAAqB;IACrB,SAAS,CAAC,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,GAAG,sBAAsB,CAAC;IAC7E,qCAAqC;IACrC,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC5C,gFAAgF;IAChF,OAAO,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACzC,mBAAmB;IACnB,KAAK,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACvC,yBAAyB;IACzB,WAAW,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC7C,4BAA4B;IAC5B,IAAI,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACvC,yBAAyB;IACzB,WAAW,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC9C,kCAAkC;IAClC,sBAAsB,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACzD,0BAA0B;IAC1B,aAAa,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAChD,sCAAsC;IACtC,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC5C,0BAA0B;IAC1B,aAAa,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAChD,iDAAiD;IACjD,YAAY,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,uDAAuD;IACvD,cAAc,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChE,kEAAkE;IAClE,WAAW,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC7C,kIAAkI;IAClI,KAAK,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACxC,kNAAkN;IAClN,QAAQ,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;CAC9C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/overlays/drawer/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,kBAAkB,EACvB,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,UAAU,EACV,YAAY,EACf,MAAM,eAAe,CAAC;AAMvB;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc;;;;;;;EAOzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC;AACnD,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAM1E;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;;EAK9B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAC7D,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAMxE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;IAIxB,iDAAiD;;IAEjD,uDAAuD;;IAEvD,iEAAiE;;IAEjE,8EAA8E;;IAE9E,wGAAwG;;IAExG,oNAAoN;;IAEpN,+FAA+F;;EAEjG,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC;AAMrD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,WAAW;IACxB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,kBAAkB,CAAC,cAAc,CAAC,GAAG,iBAAiB,CAAC;IAC9D,qBAAqB;IACrB,SAAS,CAAC,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,GAAG,sBAAsB,CAAC;IAC7E,qCAAqC;IACrC,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC5C,gFAAgF;IAChF,OAAO,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACzC,mBAAmB;IACnB,KAAK,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACvC,yBAAyB;IACzB,WAAW,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC7C,4BAA4B;IAC5B,IAAI,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACvC,yBAAyB;IACzB,WAAW,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC9C,kCAAkC;IAClC,sBAAsB,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACzD,0BAA0B;IAC1B,aAAa,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAChD,sCAAsC;IACtC,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC5C,0BAA0B;IAC1B,aAAa,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAChD,iDAAiD;IACjD,YAAY,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,uDAAuD;IACvD,cAAc,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChE,kEAAkE;IAClE,WAAW,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC7C,kIAAkI;IAClI,KAAK,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACxC,kNAAkN;IAClN,QAAQ,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC3C,sUAAsU;IACtU,OAAO,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC1C,gGAAgG;IAChG,SAAS,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;CAC9C"}

package/dist/src/overlays/drawer/types.js

@@ -70,5 +70,9 @@ export const DrawerStyleType = StructType({
     flush: OptionType(BooleanType),
     /** When `true`, body becomes a definite-height flex column so a single child fills + owns its scroll */
     fillBody: OptionType(BooleanType),
+    /** When `true`, this drawer collapses to a thin vertical rail (icon + rotated title) while a deeper drawer is open on top of it, instead of hiding behind it (#328); clicking the rail pops the stack back to it */
+    stacked: OptionType(BooleanType),
+    /** Font Awesome icon name shown on the collapsed stack rail (#328); falls back to a chevron */
+    stackIcon: OptionType(StringType),
 });
 //# sourceMappingURL=types.js.map

package/dist/src/overlays/drawer/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/overlays/drawer/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEH,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,UAAU,EACV,YAAY,GACf,MAAM,eAAe,CAAC;AAEvB,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;IACtC,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,QAAQ;CACjB,CAAC,CAAC;AAKH,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;IAC3C,KAAK,EAAE,QAAQ;IACf,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,QAAQ;IACb,MAAM,EAAE,QAAQ;CACnB,CAAC,CAAC;AAKH,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;IACtC,IAAI,EAAE,UAAU,CAAC,cAAc,CAAC;IAChC,SAAS,EAAE,UAAU,CAAC,mBAAmB,CAAC;IAC1C,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC;IAClC,iDAAiD;IACjD,YAAY,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/D,uDAAuD;IACvD,cAAc,EAAE,UAAU,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACtD,iEAAiE;IACjE,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC;IACnC,8EAA8E;IAC9E,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC;IAC9B,wGAAwG;IACxG,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC;CACpC,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/overlays/drawer/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEH,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,UAAU,EACV,YAAY,GACf,MAAM,eAAe,CAAC;AAEvB,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;IACtC,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,QAAQ;CACjB,CAAC,CAAC;AAKH,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;IAC3C,KAAK,EAAE,QAAQ;IACf,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,QAAQ;IACb,MAAM,EAAE,QAAQ;CACnB,CAAC,CAAC;AAKH,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;IACtC,IAAI,EAAE,UAAU,CAAC,cAAc,CAAC;IAChC,SAAS,EAAE,UAAU,CAAC,mBAAmB,CAAC;IAC1C,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC;IAClC,iDAAiD;IACjD,YAAY,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/D,uDAAuD;IACvD,cAAc,EAAE,UAAU,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACtD,iEAAiE;IACjE,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC;IACnC,8EAA8E;IAC9E,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC;IAC9B,wGAAwG;IACxG,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC;IACjC,oNAAoN;IACpN,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC;IAChC,+FAA+F;IAC/F,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC;CACpC,CAAC,CAAC"}

package/dist/src/runtime/layout/dock.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `<Dock>` tag — see the export's JSDoc.
+ */
+import { Dock as DockFactory } from "../../layout/dock/index.js";
+import { type ContainerProps, type JsxTag } from "../combinators.js";
+/**
+ * An inline panel that collapses along one axis to a compact icon rail and
+ * expands back to its children, without leaving the document flow — siblings
+ * reflow to reclaim the freed space; it never overlays. The in-flow,
+ * collapse-to-rail sibling of `<Expandable>` (which instead fills the app
+ * container). Reach for it when a source panel should tuck away beside the
+ * thing it feeds — a `<Library>` drag-source beside a `<Planner>` drop-target,
+ * a filter rail beside a board — so the board grows while the panel is stowed
+ * and the drop-target is never covered.
+ *
+ * Collapsed, it shrinks to `railSize` and shows the `icon`, a chevron toggle
+ * (pointing away from `side`), and any `badge`; `label` becomes the rail's
+ * accessible name. Expanded, it is `expandedSize` along the axis with a header
+ * (`icon` + `label` + `badge` + collapse chevron) above the children. Drive it
+ * from state with `collapsed` + `onCollapsedChange`, or omit both for
+ * uncontrolled toggling — optionally `persist`ed across reloads. It is an
+ * ordinary flex child: place it in a `<Flex>` / `<HStack>` (horizontal) or
+ * `<VStack>` (vertical) whose sibling is `flex="1" minWidth="0"`. Arbitrarily
+ * nestable. Esc does NOT collapse it (it's inline content, not a modal).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Box, Dock, HStack, Planner, Text, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const board = East.function([], UIComponentType, _$ => (
+ *     <HStack gap="4" width="100%">
+ *         <Dock icon="book" label="Bookings" expandedSize="25%">
+ *             <Box padding="3" background="bg.surface"><Text>Drag source…</Text></Box>
+ *         </Dock>
+ *         <Box flex="1" minWidth="0"><Text>Board / drop target…</Text></Box>
+ *     </HStack>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Dock.Types` — the East data type and config struct. Desugars to
+ * `Dock.Root(children, options)`.
+ */
+export declare const Dock: JsxTag<ContainerProps<typeof DockFactory.Root>> & {
+    Types: typeof DockFactory.Types;
+};
+//# sourceMappingURL=dock.d.ts.map

package/dist/src/runtime/layout/dock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dock.d.ts","sourceRoot":"","sources":["../../../../src/runtime/layout/dock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAa,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,cAAc,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG;IAAE,KAAK,EAAE,OAAO,WAAW,CAAC,KAAK,CAAA;CAC1B,CAAC"}

package/dist/src/runtime/layout/dock.js

@@ -0,0 +1,51 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `<Dock>` tag — see the export's JSDoc.
+ */
+import { Dock as DockFactory } from "../../layout/dock/index.js";
+import { container } from "../combinators.js";
+/**
+ * An inline panel that collapses along one axis to a compact icon rail and
+ * expands back to its children, without leaving the document flow — siblings
+ * reflow to reclaim the freed space; it never overlays. The in-flow,
+ * collapse-to-rail sibling of `<Expandable>` (which instead fills the app
+ * container). Reach for it when a source panel should tuck away beside the
+ * thing it feeds — a `<Library>` drag-source beside a `<Planner>` drop-target,
+ * a filter rail beside a board — so the board grows while the panel is stowed
+ * and the drop-target is never covered.
+ *
+ * Collapsed, it shrinks to `railSize` and shows the `icon`, a chevron toggle
+ * (pointing away from `side`), and any `badge`; `label` becomes the rail's
+ * accessible name. Expanded, it is `expandedSize` along the axis with a header
+ * (`icon` + `label` + `badge` + collapse chevron) above the children. Drive it
+ * from state with `collapsed` + `onCollapsedChange`, or omit both for
+ * uncontrolled toggling — optionally `persist`ed across reloads. It is an
+ * ordinary flex child: place it in a `<Flex>` / `<HStack>` (horizontal) or
+ * `<VStack>` (vertical) whose sibling is `flex="1" minWidth="0"`. Arbitrarily
+ * nestable. Esc does NOT collapse it (it's inline content, not a modal).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Box, Dock, HStack, Planner, Text, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const board = East.function([], UIComponentType, _$ => (
+ *     <HStack gap="4" width="100%">
+ *         <Dock icon="book" label="Bookings" expandedSize="25%">
+ *             <Box padding="3" background="bg.surface"><Text>Drag source…</Text></Box>
+ *         </Dock>
+ *         <Box flex="1" minWidth="0"><Text>Board / drop target…</Text></Box>
+ *     </HStack>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Dock.Types` — the East data type and config struct. Desugars to
+ * `Dock.Root(children, options)`.
+ */
+export const Dock = Object.assign(container(DockFactory.Root), { Types: DockFactory.Types });
+//# sourceMappingURL=dock.js.map