@elaraai/east-ui 1.0.67 → 1.0.69

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

@@ -1,423 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
- */
-/**
- * `Planner` IR — the UIComponent-free types. A Planner is a discrete
- * `rows × ordered slots` scheduling grid: rows are typed resources, slots are
- * positions on a typed axis, and each cell holds zero or more events in one of
- * three audit states.
- *
- * The axis design follows the `Chart.Spec` style — a typed coordinate variant
- * ({@link PlannerSlotType}) whose arm chooses the scale, so the axis kind is
- * derived from the data ("one axis type per Planner"). Sub-slot buckets are an
- * arbitrary labelled array, never a bare count.
- *
- * `PlannerEventType` / `PlannerRowType` / `PlannerRootType` carry a
- * `UIComponentType` (`event.popover`) and therefore live in `./index.ts`, not
- * here — `types.ts` stays UIComp-free so `component.ts` can import it without a
- * circular dependency.
- *
- * @packageDocumentation
- */
-import { OptionType, StructType, VariantType, StringType, FloatType, IntegerType, BooleanType, DateTimeType, NullType, ArrayType, } from "@elaraai/east";
-import { StatusValueType } from "../../feedback/status/types.js";
-// ============================================================================
-// Axis — typed slot coordinate + scale + buckets + range
-// ============================================================================
-/**
- * A typed slot coordinate. The arm chooses the axis scale the renderer builds,
- * so the scale kind is derived from the data and never declared twice; mixing
- * arms within one Planner is the forbidden "one axis type per Planner" case.
- *
- * @remarks
- * Use `Planner.at.time(date)`, `Planner.at.number(n)`, or
- * `Planner.at.ordinal(label)` to construct slot values rather than building
- * the variant manually. Every event and marker on the same Planner must use
- * the same arm — the renderer enforces the single-axis-kind rule at render
- * time.
- *
- * @property time - A datetime position (calendar slots)
- * @property number - A numeric position (day-of-X, hour-of-Y)
- * @property ordinal - An ordinal label (phase / stage / week-number)
- */
-export const PlannerSlotType = VariantType({
-    time: DateTimeType,
-    number: FloatType,
-    ordinal: StringType,
-});
-/**
- * The axis scale kind, declared once on the axis; must match every slot's arm.
- *
- * @remarks
- * This value is embedded in the serialised `PlannerAxisType` and read by the
- * renderer to choose the correct tick-label formatter. Prefer the
- * `Planner.axis.*` builder helpers over constructing it directly — they set the
- * scale tag automatically from the builder you call.
- *
- * @property time - Datetime axis
- * @property number - Numeric axis
- * @property ordinal - Ordinal axis
- */
-export const PlannerScaleType = VariantType({
-    time: NullType,
-    number: NullType,
-    ordinal: NullType,
-});
-/**
- * The time-axis resolution — the calendar unit of each `time`-axis slot
- * column. The Planner sibling of the Gantt axis `tier`, except that a Planner
- * resolution sets slot *identity* (the column set, event placement, and drag
- * slot keys), not just header labels.
- *
- * @remarks
- * Declared via `Planner.axis.time({ resolution })`; meaningless on `number` /
- * `ordinal` axes. `auto` (or an absent resolution) infers the unit from the
- * axis extent: a pinned `range` spanning ≤ 14 days derives one column per
- * day, anything else keeps one column per month (the pre-resolution
- * behaviour — data-derived extents never infer day columns). The fixed arms
- * force the unit regardless of extent; `hour` is never chosen automatically.
- *
- * @property auto - Infer from the pinned range span (≤ 14 days ⇒ day, else month)
- * @property hour - One column per hour
- * @property day - One column per day
- * @property week - One column per week
- * @property month - One column per calendar month
- * @property quarter - One column per calendar quarter
- * @property year - One column per calendar year
- */
-export const PlannerResolutionType = VariantType({
-    auto: NullType,
-    hour: NullType,
-    day: NullType,
-    week: NullType,
-    month: NullType,
-    quarter: NullType,
-    year: NullType,
-});
-/**
- * One labelled sub-slot bucket inside a column — the explicit name an operator
- * reads (AM/PM, the parts of a day, …). Buckets are an arbitrary labelled
- * array; an empty array means one slot per column.
- *
- * @remarks
- * Pass bucket objects via the `buckets` array in `AxisTimeOptions`,
- * `AxisNumberOptions`, or `AxisOrdinalOptions`. Events reference a bucket by
- * its `key`; the renderer displays the `label` in the column header. When no
- * buckets are specified an event omits the `bucket` field entirely.
- *
- * @property key - The bucket identity an event references
- * @property label - The displayed bucket name
- */
-export const PlannerBucketType = StructType({
-    key: StringType,
-    label: StringType,
-});
-/**
- * An explicit axis domain, typed to the axis's coordinate kind. Supplied to fix
- * the extent instead of deriving it from the data.
- *
- * @remarks
- * When omitted the renderer derives the domain from the union of all event
- * slots, which can produce a shifting viewport as data changes. Supply a range
- * to pin the visible extent regardless of what events are present — useful for
- * keeping a calendar grid stable even when some days have no events. The arm
- * must match the axis scale: a `number` axis requires the `number` arm, a
- * `time` axis the `time` arm, and an `ordinal` axis the `ordinal` arm.
- *
- * @property time - Datetime bounds for a time axis
- * @property number - Numeric bounds for a numeric axis
- * @property ordinal - The ordered category labels for an ordinal axis
- */
-export const PlannerRangeType = VariantType({
-    time: StructType({ min: DateTimeType, max: DateTimeType }),
-    number: StructType({ min: FloatType, max: FloatType }),
-    ordinal: ArrayType(StringType),
-});
-/**
- * The axis declaration — the scale kind, the labelled sub-slot buckets, an
- * optional explicit range, an optional tick-label format, and (time axes
- * only) an optional column grain.
- *
- * @remarks
- * This is the serialised form written into the Planner IR. Consumer code
- * should construct it via `Planner.axis.time(opts)`, `Planner.axis.number(opts)`,
- * or `Planner.axis.ordinal(opts)` rather than by hand — those builders fill
- * `scale` and coerce the `range` variant automatically.
- *
- * @property scale - The axis coordinate kind (see {@link PlannerScaleType})
- * @property buckets - The labelled sub-slot buckets ([] = one slot per column)
- * @property range - Optional explicit domain; else derived from the data
- * @property format - Optional tick-label format pattern
- * @property resolution - Optional time-axis column unit (see {@link PlannerResolutionType}); absent ≡ auto
- */
-export const PlannerAxisType = StructType({
-    scale: PlannerScaleType,
-    buckets: ArrayType(PlannerBucketType),
-    range: OptionType(PlannerRangeType),
-    format: OptionType(StringType),
-    resolution: OptionType(PlannerResolutionType),
-});
-// ============================================================================
-// Event state + conflict marker
-// ============================================================================
-/**
- * The sub-flavour of a `proposed` event. It rides inside the `proposed` arm of
- * {@link PlannerStateType}, so it is only representable while proposed — a
- * committed event can never carry a flavour.
- *
- * @remarks
- * Consumer code passes string literals (`"added"`, `"model"`, `"removed"`) to
- * `Planner.event`'s `state` field rather than constructing this variant
- * directly. The renderer uses the flavour to pick a distinct visual treatment:
- * `added` is highlighted, `model` is rendered italic, and `removed` is struck
- * through to communicate a proposed deletion of an existing committed event.
- *
- * @property added - An operator proposal
- * @property model - A model's suggestion (rendered italic)
- * @property removed - A proposed deletion of a committed event (struck through)
- */
-export const PlannerFlavourType = VariantType({
-    added: NullType,
-    model: NullType,
-    removed: NullType,
-});
-/**
- * The three event states. `committed` is audit-locked and read-only; `proposed`
- * is dirty-patch owned (carrying its flavour); `rejected` is a proposal that was
- * turned down, kept for diff context.
- *
- * @remarks
- * Consumer code passes string literals to `Planner.event`'s `state` field —
- * `"committed"`, `"added"`, `"model"`, `"removed"`, or `"rejected"` — and the
- * builder maps them to the appropriate nested variant. `proposed` is never
- * written directly; use the flavour shorthands instead. `rejected` events are
- * kept in the IR so diff views can show what was declined without re-fetching
- * history.
- *
- * @property committed - Audit-locked, immutable
- * @property proposed - Drafted; the flavour (see {@link PlannerFlavourType}) is nested
- * @property rejected - Reviewed and declined; kept for diff
- */
-export const PlannerStateType = VariantType({
-    committed: NullType,
-    proposed: PlannerFlavourType,
-    rejected: NullType,
-});
-/**
- * A row's review decision — distinct from the event-level {@link PlannerStateType}.
- *
- * @remarks
- * Used only when the Planner's `review` chrome is enabled. `approved` rests
- * pre-approved (its Approve renders as the active state); `pending` awaits an
- * explicit call (a flagged line); `rejected` is an explicit decline.
- *
- * The canonical definition is the shared review contract's
- * `ApprovalStateType` (`contracts/review.ts`) — this structural twin is kept
- * so existing Planner IR and imports round-trip unchanged, and because
- * `component.ts` must reach the variant through a `UIComponentType`-free
- * module. Prefer `ApprovalStateType` in new code.
- *
- * @property approved - Pre-approved / accepted (the resting state for a clean line)
- * @property pending - Undecided — awaits an explicit Approve / Reject
- * @property rejected - Explicitly declined
- */
-export const PlannerApprovalType = VariantType({
-    /** Pre-approved / accepted (the resting state for a clean line). */
-    approved: NullType,
-    /** Undecided — awaits an explicit Approve / Reject. */
-    pending: NullType,
-    /** Explicitly declined. */
-    rejected: NullType,
-});
-/**
- * A status marker placed at a slot — declared parallel to events (in the row's
- * `markers`, not on an event). The renderer rings the cell at `slot`, paints the
- * paired status icon in its corner, and surfaces `message` as a hover tooltip.
- * Reuses the shared {@link StatusValueType} so a cell can be flagged good
- * (`success`) just as readily as bad (`danger` / `warning`). The consumer
- * computes the rule (in East) and emits the markers; the library renders them.
- *
- * @remarks
- * Markers are computed independently of events and passed via the `markers`
- * callback on the Planner root options. A slot can carry a marker and zero
- * events simultaneously — for example, to flag a capacity breach on a day that
- * has no events scheduled yet. The `message` field is intentionally free-form;
- * compute it from the same East expression that determines the status so the
- * tooltip stays in sync with the visual.
- *
- * @property slot - The slot coordinate of the cell the marker rings
- * @property status - The semantic status (success / warning / danger / info / neutral) — drives colour + icon
- * @property message - The marker text surfaced as a hover tooltip
- */
-export const PlannerMarkerType = StructType({
-    slot: PlannerSlotType,
-    status: StatusValueType,
-    message: StringType,
-});
-// ============================================================================
-// Event geometry — stretch + content alignment + animation
-// ============================================================================
-/**
- * Which axis an event tile stretches to fill its cell on. Absent ⇒ the tile is
- * content-sized (intrinsic). Deliberately `stretch` (not `fill`) to avoid
- * confusion with the background-colour fill — it matches the flexbox
- * `alignItems: stretch` vocabulary the renderer already uses.
- *
- * @remarks
- * Pass the string shorthand (`"horizontal"` / `"vertical"` / `"both"`) to
- * `Planner.event`'s `stretch` field. A horizontal stretch fills the cell width,
- * a vertical stretch fills its height (so a single-occupant event paints the
- * whole day cell), and `both` fills both axes. A vertical-stretch tile that
- * shares a cell with others stretches to its flex-line height, not the full
- * cell.
- *
- * @property horizontal - Fill the cell width
- * @property vertical - Fill the cell height
- * @property both - Fill both axes
- */
-export const PlannerStretchType = VariantType({ horizontal: NullType, vertical: NullType, both: NullType });
-/**
- * One alignment position for an event tile's content along a single axis.
- *
- * @remarks
- * Used for both axes of {@link PlannerContentType}. Maps to `justifyContent`
- * (horizontal) / `alignItems` (vertical) inside the tile, and positions a
- * normal-size tile within a taller cell. Defaults to `start` on each axis.
- *
- * @property start - Align to the start (left / top)
- * @property center - Centre
- * @property end - Align to the end (right / bottom)
- */
-export const PlannerContentAlignType = VariantType({ start: NullType, center: NullType, end: NullType });
-/**
- * Where an event tile's content sits inside the tile — a two-axis alignment.
- *
- * @remarks
- * Both axes default to `start` (top-left) when omitted. `horizontal` drives the
- * tile's `justifyContent`; `vertical` its `alignItems`. Meaningful even without
- * `stretch` — it positions a normal-size tile within a taller (e.g. bucketed or
- * mixed) cell.
- *
- * @property horizontal - Horizontal content alignment (→ `justifyContent`)
- * @property vertical - Vertical content alignment (→ `alignItems`)
- */
-export const PlannerContentType = StructType({
-    horizontal: OptionType(PlannerContentAlignType),
-    vertical: OptionType(PlannerContentAlignType),
-});
-/**
- * An event tile's optional attention animation.
- *
- * @remarks
- * Pass `"pulse"` to `Planner.event`'s `animation` field to draw a gentle
- * opacity pulse (the shared `elara-pulse` keyframe); `"none"` (or absent) is
- * static. The pulse honours `prefers-reduced-motion`.
- *
- * @property none - No animation (the default)
- * @property pulse - A gentle opacity pulse
- */
-export const PlannerAnimationType = VariantType({ none: NullType, pulse: NullType });
-// ============================================================================
-// Columns — one flat shape (value + eyebrow)
-// ============================================================================
-/**
- * Horizontal alignment of a left column's content.
- *
- * @remarks
- * Defaults to `start` when omitted. Use `"end"` for numeric columns such as
- * hours or counts so digits align on their decimal point. Pass the string
- * literal directly to the `align` field in a column definition rather than
- * constructing the variant explicitly.
- *
- * @property start - Align to the start (left)
- * @property end - Align to the end (right)
- */
-export const PlannerAlignType = VariantType({ start: NullType, end: NullType });
-/**
- * A left-side column definition — flat and kind-free, the same shape as Table /
- * Gantt. The five spec "column kinds" are authoring patterns built from `value`
- * + `sublabel`, not distinct IR shapes.
- *
- * @remarks
- * Pass column definitions as plain objects in the `columns` array of the
- * Planner root options. Set `frozen: true` on the identity column so it stays
- * visible while the slot grid scrolls horizontally. Derived columns — values
- * computed from the row in East rather than read from a field directly — use
- * the same shape; there is no separate kind for them.
- *
- * @property key - The column identity (and the row's cell key)
- * @property header - The column header text
- * @property width - Optional CSS width
- * @property frozen - Whether the column is pinned sticky-left
- * @property align - Optional horizontal alignment of the cell content
- */
-export const PlannerColumnType = StructType({
-    key: StringType,
-    header: StringType,
-    width: OptionType(StringType),
-    frozen: OptionType(BooleanType),
-    align: OptionType(PlannerAlignType),
-});
-/**
- * The per-row cell content — a `value` and an optional muted `sublabel`
- * (eyebrow). A derived column is just a `value` computed in East; there is no
- * separate kind.
- *
- * @remarks
- * This is the serialised cell shape stored in the row's `cells` map, keyed by
- * the matching `PlannerColumnType.key`. Consumer code produces cell values via
- * the `value` and `sublabel` callbacks on each column definition — the builder
- * assembles this struct from those callbacks automatically.
- *
- * @property value - The cell text (a field or an East-computed value)
- * @property sublabel - The optional muted eyebrow line beneath the value
- */
-export const PlannerCellType = StructType({
-    value: StringType,
-    sublabel: OptionType(StringType),
-});
-// ============================================================================
-// Variant + callback payloads
-// ============================================================================
-/**
- * Which chassis configuration this Planner is.
- *
- * @remarks
- * Set automatically by `Planner.Point(...)` and `Planner.Span(...)` — consumer
- * code never needs to construct this variant directly. The renderer uses it to
- * decide whether to treat events as single-cell tiles (`point`) or as
- * horizontal bars stretching from `slot` to `endSlot` (`span`).
- *
- * @property point - Slot-bound events (each event sits in one slot/bucket)
- * @property span - Multi-slot span events (start → end)
- */
-export const PlannerVariantType = VariantType({
-    point: NullType,
-    span: NullType,
-});
-/**
- * The payload of the `onSelectRow` callback (a row was clicked / selected).
- *
- * @remarks
- * Passed as the sole argument to the `East.function` supplied to `onSelectRow`
- * on the Planner root options. Use `Planner.Types.SelectEvent` to reference
- * this type when declaring that function's parameter list, as shown in the
- * `plannerPoint` example.
- *
- * @property rowIndex - The selected row's index (0-based)
- */
-export const PlannerSelectEventType = StructType({ rowIndex: IntegerType });
-/**
- * The payload of the per-row `review.onApprove` / `review.onReject` callbacks
- * (a row's Approve / Reject was clicked). Mirrors {@link PlannerSelectEventType}.
- *
- * @remarks
- * A structural twin of the shared review contract's `RowRefType`
- * (`contracts/review.ts`), kept for the same round-trip / import-graph
- * reasons as {@link PlannerApprovalType}. Prefer `RowRefType` in new code.
- *
- * @property rowIndex - The row's index (0-based)
- */
-export const PlannerApproveEventType = StructType({ rowIndex: IntegerType });
-//# sourceMappingURL=types.js.map

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

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

package/dist/src/layout/aligned-stack/index.d.ts

@@ -1,101 +0,0 @@
-/**
- * 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, ArrayType, StructType, OptionType } from "@elaraai/east";
-import { UIComponentType } from "../../component.js";
-/**
- * Standalone East type for `AlignedStack` data — mirrors the inline arm in
- * `component.ts` (which spells `children` with the recursion `node`). Used by the
- * renderer for `equalFor` + `ValueTypeOf`.
- *
- * @property children - The stacked lane components
- * @property gutter - The imposed gutter (`auto` | `fixed{left,right}`)
- * @property style - Optional box-model style
- */
-export declare const AlignedStackType: StructType<{
-    children: ArrayType<UIComponentType>;
-    gutter: OptionType<AlignedGutterType>;
-    style: OptionType<AlignedStackStyleType>;
-}>;
-export type AlignedStackType = typeof AlignedStackType;
-import { AlignedStackStyleType, type AlignedStackStyle } from "./types.js";
-import { AlignedGutterType, type PlotGutter } from "../../shared/plot-gutter.js";
-export { AlignedStackStyleType, type AlignedStackStyle } from "./types.js";
-export { PlotGutterType, AlignedGutterType, type PlotGutter } from "../../shared/plot-gutter.js";
-/** Options for {@link createAlignedStack} — the gutter mode plus the box-model style fields (flattened, like `Stack`). */
-export interface AlignedStackOptions extends AlignedStackStyle {
-    /**
-     * The gutter imposed on every child: an explicit `{ left, right }` (px
-     * recommended), or `"auto"` to measure the max gutter the children need.
-     * Omit to impose nothing (children keep their own gutters).
-     */
-    gutter?: PlotGutter | "auto";
-}
-/**
- * Build an `<AlignedStack>` — a vertical stack of axis/lane components (Chart,
- * Trace, Calendar, …) that share one horizontal plot gutter so their data lanes
- * line up on a common x. The gutter is published to the children via context; a
- * child's own `plotGutter` prop still wins over the inherited value (#147).
- *
- * @param children - The stacked lane components
- * @param options - The {@link AlignedStackOptions} (`gutter` + box-model style)
- * @returns An `AlignedStack` {@link UIComponentType} value
- *
- * @example
- * ```ts
- * import { East } from "@elaraai/east";
- * import { AlignedStack, Chart, UIComponentType } from "@elaraai/east-ui";
- *
- * const aligned = East.function([], UIComponentType, ($) =>
- *     AlignedStack.Root([
- *         Chart.Root(Chart.Line(rows, { x: r => r.day, y: r => r.value })),
- *         // …a Trace / Planner on the same day axis…
- *     ], { gutter: { left: "48px", right: "12px" }, gap: "8px" }));
- * ```
- */
-declare function createAlignedStack(children: SubtypeExprOrValue<ArrayType<UIComponentType>>, options?: AlignedStackOptions): ExprType<UIComponentType>;
-/**
- * `AlignedStack` — vertically stacks axis/lane components on a shared plot gutter.
- *
- * @remarks
- * Use `AlignedStack.Root(children, { gutter })`. Types via `.Types`.
- */
-export declare const AlignedStack: {
-    /** Build an AlignedStack (see {@link createAlignedStack}). */
-    readonly Root: typeof createAlignedStack;
-    readonly Types: {
-        /** The AlignedStack data struct. */
-        readonly AlignedStack: StructType<{
-            children: ArrayType<UIComponentType>;
-            gutter: OptionType<AlignedGutterType>;
-            style: OptionType<AlignedStackStyleType>;
-        }>;
-        /** The `{ left, right }` plot-gutter struct. */
-        readonly PlotGutter: StructType<{
-            readonly left: OptionType<import("@elaraai/east").StringType>;
-            readonly right: OptionType<import("@elaraai/east").StringType>;
-        }>;
-        /** The `auto | fixed` gutter mode. */
-        readonly Gutter: import("@elaraai/east").VariantType<{
-            readonly auto: import("@elaraai/east").NullType;
-            readonly fixed: StructType<{
-                readonly left: OptionType<import("@elaraai/east").StringType>;
-                readonly right: OptionType<import("@elaraai/east").StringType>;
-            }>;
-        }>;
-        /** The AlignedStack style struct. */
-        readonly Style: StructType<{
-            readonly gap: OptionType<import("@elaraai/east").StringType>;
-            readonly width: OptionType<import("@elaraai/east").StringType>;
-            readonly height: OptionType<import("@elaraai/east").StringType>;
-            readonly minHeight: OptionType<import("@elaraai/east").StringType>;
-            readonly density: OptionType<import("@elaraai/east").VariantType<{
-                readonly comfortable: import("@elaraai/east").NullType;
-                readonly compact: import("@elaraai/east").NullType;
-                readonly condensed: import("@elaraai/east").NullType;
-            }>>;
-        }>;
-    };
-};
-//# sourceMappingURL=index.d.ts.map

package/dist/src/layout/aligned-stack/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/layout/aligned-stack/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,SAAS,EACT,UAAU,EACV,UAAU,EAIb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAAU,CAAC;IACtC,QAAQ,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;IACrC,MAAM,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC;IACtC,KAAK,EAAE,UAAU,CAAC,qBAAqB,CAAC,CAAC;CAC5C,CAIC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAEH,iBAAiB,EACjB,KAAK,UAAU,EAClB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEjG,0HAA0H;AAC1H,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC1D;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;CAChC;AAaD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,iBAAS,kBAAkB,CACvB,QAAQ,EAAE,kBAAkB,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,EACxD,OAAO,CAAC,EAAE,mBAAmB,GAC9B,QAAQ,CAAC,eAAe,CAAC,CAwB3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY;IACrB,8DAA8D;;;QAG1D,oCAAoC;;sBArG9B,SAAS,CAAC,eAAe,CAAC;oBAC5B,UAAU,CAAC,iBAAiB,CAAC;mBAC9B,UAAU,CAAC,qBAAqB,CAAC;;QAqGpC,gDAAgD;;;;;QAEhD,sCAAsC;;;;;;;;QAEtC,qCAAqC;;;;;;;;;;;;;CAGnC,CAAC"}

package/dist/src/layout/aligned-stack/index.js

@@ -1,105 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
- */
-import { East, ArrayType, StructType, OptionType, variant, some, none, } from "@elaraai/east";
-import { UIComponentType } from "../../component.js";
-import { DensityType } from "../../style/interaction.js";
-/**
- * Standalone East type for `AlignedStack` data — mirrors the inline arm in
- * `component.ts` (which spells `children` with the recursion `node`). Used by the
- * renderer for `equalFor` + `ValueTypeOf`.
- *
- * @property children - The stacked lane components
- * @property gutter - The imposed gutter (`auto` | `fixed{left,right}`)
- * @property style - Optional box-model style
- */
-export const AlignedStackType = StructType({
-    children: ArrayType(UIComponentType),
-    gutter: OptionType(AlignedGutterType),
-    style: OptionType(AlignedStackStyleType),
-});
-import { AlignedStackStyleType } from "./types.js";
-import { PlotGutterType, AlignedGutterType, } from "../../shared/plot-gutter.js";
-export { AlignedStackStyleType } from "./types.js";
-export { PlotGutterType, AlignedGutterType } from "../../shared/plot-gutter.js";
-/** Build the `AlignedGutterType` value (`auto` | `fixed{left,right}`) from the input. */
-function resolveGutter(g) {
-    if (g === undefined)
-        return undefined;
-    if (g === "auto")
-        return East.value(variant("auto", null), AlignedGutterType);
-    const gutter = East.value({
-        left: g.left !== undefined ? some(g.left) : none,
-        right: g.right !== undefined ? some(g.right) : none,
-    }, PlotGutterType);
-    return East.value(variant("fixed", gutter), AlignedGutterType);
-}
-/**
- * Build an `<AlignedStack>` — a vertical stack of axis/lane components (Chart,
- * Trace, Calendar, …) that share one horizontal plot gutter so their data lanes
- * line up on a common x. The gutter is published to the children via context; a
- * child's own `plotGutter` prop still wins over the inherited value (#147).
- *
- * @param children - The stacked lane components
- * @param options - The {@link AlignedStackOptions} (`gutter` + box-model style)
- * @returns An `AlignedStack` {@link UIComponentType} value
- *
- * @example
- * ```ts
- * import { East } from "@elaraai/east";
- * import { AlignedStack, Chart, UIComponentType } from "@elaraai/east-ui";
- *
- * const aligned = East.function([], UIComponentType, ($) =>
- *     AlignedStack.Root([
- *         Chart.Root(Chart.Line(rows, { x: r => r.day, y: r => r.value })),
- *         // …a Trace / Planner on the same day axis…
- *     ], { gutter: { left: "48px", right: "12px" }, gap: "8px" }));
- * ```
- */
-function createAlignedStack(children, options) {
-    const gutter = resolveGutter(options?.gutter);
-    const densityValue = options?.density !== undefined
-        ? (typeof options.density === "string"
-            ? East.value(variant(options.density, null), DensityType)
-            : options.density)
-        : undefined;
-    const hasStyle = options !== undefined &&
-        (options.gap !== undefined || options.width !== undefined ||
-            options.height !== undefined || options.minHeight !== undefined ||
-            options.density !== undefined);
-    return East.value(variant("AlignedStack", {
-        children,
-        gutter: gutter !== undefined ? some(gutter) : none,
-        style: hasStyle
-            ? some(East.value({
-                gap: options.gap !== undefined ? some(options.gap) : none,
-                width: options.width !== undefined ? some(options.width) : none,
-                height: options.height !== undefined ? some(options.height) : none,
-                minHeight: options.minHeight !== undefined ? some(options.minHeight) : none,
-                density: densityValue !== undefined ? some(densityValue) : none,
-            }, AlignedStackStyleType))
-            : none,
-    }), UIComponentType);
-}
-/**
- * `AlignedStack` — vertically stacks axis/lane components on a shared plot gutter.
- *
- * @remarks
- * Use `AlignedStack.Root(children, { gutter })`. Types via `.Types`.
- */
-export const AlignedStack = {
-    /** Build an AlignedStack (see {@link createAlignedStack}). */
-    Root: createAlignedStack,
-    Types: {
-        /** The AlignedStack data struct. */
-        AlignedStack: AlignedStackType,
-        /** The `{ left, right }` plot-gutter struct. */
-        PlotGutter: PlotGutterType,
-        /** The `auto | fixed` gutter mode. */
-        Gutter: AlignedGutterType,
-        /** The AlignedStack style struct. */
-        Style: AlignedStackStyleType,
-    },
-};
-//# sourceMappingURL=index.js.map

package/dist/src/layout/aligned-stack/index.js.map

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