@elaraai/east-ui 1.0.68 → 1.0.69

package/dist/src/collections/plan/builders.d.ts

@@ -0,0 +1,612 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Plan value builders — shorthand resolvers, the instant sugar
+ * ({@link resolveInstant} / `Plan.at`), the axis declarations (`Plan.axis`,
+ * `.time` / `.number` / `.ordinal`), element value builders (`Plan.run` /
+ * `decision` / `port` / `event` / `marker` / `chip` / `mark`) and cell
+ * builders (`heatCells` / `weightCells` / `segmentCells` / `tableCells`).
+ * Every element is pure data — rich click/hover surfaces resolve through
+ * the ROOT's `popover` / `hover` functions over `PlanElementRefType`
+ * (`Plan Data Interface.md` §3.3), never per-element embeds.
+ *
+ * @packageDocumentation
+ */
+import { type EastType, type ExprType, type SubtypeExprOrValue, ArrayType, BooleanType, DateTimeType, FloatType, IntegerType, OptionType, StringType, StructType } from "@elaraai/east";
+import { TickFormatType } from "../../format/types.js";
+import { IconType, type IconName } from "../../display/icon/types.js";
+import { StatusValueType, type StatusValueLiteral } from "../../feedback/status/types.js";
+import { ColorSchemeType, type ColorSchemeLiteral } from "../../style/scheme.js";
+import { EventStateType, type EventStateLiteral } from "../../contracts/states.js";
+import { type MatrixFillLiteral, MatrixFillType } from "../matrix/types.js";
+import { type PlanAxisOptions, type PlanNumberAxisOptions, type PlanOrdinalAxisOptions, PlanInstantType, type PlanInstantLikeType, type PlanInstantInput, type PlanAxisKindLiteral, type PlanKindOf, type PlanInstantExpr, type PlanRunExpr, type PlanDecisionMarkExpr, type PlanPortExpr, type PlanBucketEventExpr, type PlanCellMarkerExpr, type PlanChipExpr, type PlanEventMarkExpr, type PlanHeatCellsExpr, type PlanTableCellsExpr, type PlanTableSeriesExpr, type PlanAxisExpr, type PlanCellsInput, type PlanTableCellsInput, PlanStretchType, type PlanStretchLiteral, PlanContentAlignType, type PlanContentAlignLiteral, PlanAnimationType, type PlanAnimationLiteral, PlanEventMarkKindType, PlanHeatCellType, PlanWeightCellType, PlanSegmentType, PlanSegmentCellType, PlanTableToneType, type PlanTableToneLiteral, PlanLinkType, PlanLaneType, type PlanRowsValue } from "./types.js";
+/**
+ * Resolves the shared event-lifecycle string shorthands into an
+ * {@link EventStateType} value: `"estimated"`, `"added"`, `"recommended"`,
+ * `"removed"` (the three `proposed` flavours), `"confirmed"`,
+ * `"in-progress"`, `"actual"`, `"rejected"`.
+ *
+ * @param state - An `EventStateType` value/expression or a string shorthand
+ * @returns The resolved `EventStateType` value
+ */
+export declare function resolvePlanEventState(state: SubtypeExprOrValue<EventStateType> | EventStateLiteral): SubtypeExprOrValue<EventStateType>;
+/** Resolve a null-payload variant string shorthand against its East type. */
+export declare function resolveTag<T extends EastType>(v: SubtypeExprOrValue<NoInfer<T>> | string, type: T): ExprType<T>;
+/**
+ * An icon input — a bare Font Awesome solid name (`"rocket"`), a
+ * `{ prefix, name }` pair, or an `IconType` expression (the Banner envelope
+ * precedent). The mounting context pins size and colour; hosts choose the
+ * glyph, never the geometry.
+ */
+export type PlanIconInput = IconName | {
+    prefix: string;
+    name: string;
+} | SubtypeExprOrValue<IconType>;
+/** Resolve a {@link PlanIconInput} into an `IconType` value. */
+export declare function resolveIcon(icon: PlanIconInput): SubtypeExprOrValue<IconType>;
+/** An empty flattened-subtree value — the keyed collection with no rows. */
+export declare function emptyRows(): PlanRowsValue;
+/**
+ * Resolves an instant input into a {@link PlanInstantType} value — the one
+ * place the arm is inferred (#631).
+ *
+ * @remarks
+ * The input is any {@link PlanInstantLikeType} value or expression. JS values
+ * wrap by their type (`Date` ⇒ `time`, `number` / `bigint` ⇒ `number`,
+ * `string` ⇒ `ordinal`); East expressions wrap by their STATIC type
+ * (`DateTimeType` ⇒ `time`, `FloatType` ⇒ `number`, `IntegerType` ⇒ `number`
+ * via `toFloat`, `StringType` ⇒ `ordinal`); a {@link PlanInstantType} value
+ * or expression passes through (subtype-checked by `East.value`). Nothing
+ * here knows the canvas axis — the arm is the INPUT's; the renderer holds it
+ * against the root's declaration.
+ *
+ * @param v - The instant (a value or expression of a {@link PlanInstantLikeType})
+ * @param where - The field being resolved, for the error message
+ * @returns The instant as a `PlanInstantType` expression
+ * @throws {Error} If `v` is an expression of a non-instant type
+ */
+export declare function resolveInstant(v: PlanInstantInput, where: string): ExprType<PlanInstantType>;
+/**
+ * The `Plan.at` builders — one instant per axis kind, explicitly. The
+ * element builders already wrap by type; these are for element RECORDS
+ * written as data (`{ at: Plan.at.time(week(27n)), … }` in a
+ * `Plan.Types.HeatCell` array) and for reading as a declaration. Each
+ * result is BRANDED with its arm ({@link PlanInstantExpr}), so a cell
+ * list built from them carries the kind to the root's compile-time check.
+ */
+export declare const at: {
+    /**
+     * A `time` instant.
+     *
+     * @param v - The UTC instant (a `Date` or `DateTimeType` expression)
+     * @returns A `PlanInstantType` expression with the `time` arm, branded `"time"`
+     */
+    readonly time: (v: SubtypeExprOrValue<DateTimeType>) => PlanInstantExpr<"time">;
+    /**
+     * A `number` instant.
+     *
+     * @param v - The position (a number or `FloatType` expression)
+     * @returns A `PlanInstantType` expression with the `number` arm, branded `"number"`
+     */
+    readonly number: (v: SubtypeExprOrValue<FloatType> | number) => PlanInstantExpr<"number">;
+    /**
+     * An `ordinal` instant.
+     *
+     * @param v - The declared value (a string or `StringType` expression)
+     * @returns A `PlanInstantType` expression with the `ordinal` arm, branded `"ordinal"`
+     */
+    readonly ordinal: (v: SubtypeExprOrValue<StringType>) => PlanInstantExpr<"ordinal">;
+};
+/**
+ * Builds the `time` axis declaration — `Plan.axis({ … })` / `Plan.axis.time`.
+ *
+ * @param options - Window, resolution(s), now instant and tick format ({@link PlanAxisOptions})
+ * @returns An East expression of {@link PlanAxisType} (the `time` arm), branded `"time"` — the root's canvas kind
+ *
+ * @remarks
+ * The window is half-open `[min, max)` in UTC; omit it to follow the bound
+ * slice's datetime range (else fit to the data). `resolutions` lists the
+ * WEEK/DAY-style segment options (omit ⇒ no segment). When the Plan is
+ * slice-bound, slice state supersedes window + resolution after mount — the
+ * slice is the single source of truth.
+ */
+export declare function createTimeAxis(options: PlanAxisOptions): PlanAxisExpr<"time">;
+/**
+ * Builds the `number` axis declaration — `Plan.axis.number({ … })`.
+ *
+ * @param options - Window, step, now position and tick format ({@link PlanNumberAxisOptions})
+ * @returns An East expression of {@link PlanAxisType} (the `number` arm), branded `"number"` — the root's canvas kind
+ * @throws {Error} If a literal `step` is not `> 0`
+ *
+ * @remarks
+ * `[min, max)` ÷ `step` = `n` buckets, edges on whole multiples of `step`
+ * (the `TimeResolution` rule, numerically). Omit the window to follow the
+ * bound slice's `float` / `integer` range (else fit to the data). Element
+ * instants on this canvas are numbers — a `FloatType` / `IntegerType`
+ * accessor or a bare number wraps to the `number` arm.
+ */
+export declare function createNumberAxis(options: PlanNumberAxisOptions): PlanAxisExpr<"number">;
+/**
+ * Builds the `ordinal` axis declaration — `Plan.axis.ordinal({ … })`.
+ *
+ * @param options - The ordered values and the now value ({@link PlanOrdinalAxisOptions})
+ * @returns An East expression of {@link PlanAxisType} (the `ordinal` arm), branded `"ordinal"` — the root's canvas kind
+ * @throws {Error} If a literal `values` list is empty
+ *
+ * @remarks
+ * The declared values ARE the buckets, one each, in order; the window is
+ * the whole list, so there is no slice range to brush and the window keys
+ * idle. Element instants on this canvas are the values — a `StringType`
+ * accessor or a bare string wraps to the `ordinal` arm.
+ */
+export declare function createOrdinalAxis(options: PlanOrdinalAxisOptions): PlanAxisExpr<"ordinal">;
+/**
+ * The `Plan.axis` builder — the `time` shorthand, with the explicit
+ * per-kind builders as members (the Planner's `Planner.axis.time / .number /
+ * .ordinal` names).
+ */
+export interface PlanAxisBuilder {
+    /** The `time` axis (the shorthand — `Plan.axis({ resolution: "week", … })`). */
+    (options: PlanAxisOptions): PlanAxisExpr<"time">;
+    /** The `time` axis, explicitly. */
+    time: typeof createTimeAxis;
+    /** The `number` axis — a numeric window ÷ `step`. */
+    number: typeof createNumberAxis;
+    /** The `ordinal` axis — a declared list of values. */
+    ordinal: typeof createOrdinalAxis;
+}
+/**
+ * Builds the shared axis declaration — `Plan.axis({ … })` is the `time`
+ * shorthand; `Plan.axis.time` / `.number` / `.ordinal` declare each kind.
+ *
+ * @param options - The time-axis options ({@link PlanAxisOptions})
+ * @returns An East expression of {@link PlanAxisType}, branded with its kind
+ */
+export declare const createAxis: PlanAxisBuilder;
+/**
+ * Flat input for {@link Plan.run} — one continuous state-run bar.
+ *
+ * @typeParam S - The `start` input's type — its axis kind brands the result ({@link PlanKindOf})
+ * @typeParam E - The `end` input's type
+ * @property key - Stable run identity (drag refs, link edges)
+ * @property start - Run start (inclusive) — an instant input (a Date / number / string, or a typed expression)
+ * @property end - Run end (exclusive)
+ * @property label - The bar text (`"RUN · B-214"`)
+ * @property quantity - Optional displayed quantity suffix (`"96 t"`)
+ * @property qty - Optional numeric quantity (summed into rollup bands)
+ * @property state - The lifecycle state (string shorthand or `EventStateType`)
+ * @property status - Optional status tint (`"warning"` ⇒ the over-dwell ring)
+ * @property moved - Optional same-status churn counter (`moved ×k`)
+ * @property icon - Optional leading FA glyph (10px, inherits bar text colour)
+ */
+export interface PlanRunInput<S extends PlanInstantInput = PlanInstantInput, E extends PlanInstantInput = PlanInstantInput> {
+    /** Stable run identity (drag refs, link edges). */
+    key: SubtypeExprOrValue<StringType>;
+    /** Run start (inclusive) — wraps to the axis arm by its type (see {@link PlanInstantLikeType}). */
+    start: S;
+    /** Run end (exclusive). */
+    end: E;
+    /** The bar text (`"RUN · B-214"`). */
+    label: SubtypeExprOrValue<StringType>;
+    /** Optional displayed quantity suffix (`"96 t"` — the muted `.q` text). */
+    quantity?: SubtypeExprOrValue<StringType>;
+    /** Optional numeric quantity — summed into parent rollup bands (pair with the span factory's `unit`). */
+    qty?: SubtypeExprOrValue<FloatType>;
+    /** The lifecycle state — a string shorthand or an `EventStateType` value. */
+    state: SubtypeExprOrValue<EventStateType> | EventStateLiteral;
+    /** Optional status tint — `"warning"` draws the `.stuck` over-dwell ring. */
+    status?: SubtypeExprOrValue<StatusValueType> | StatusValueLiteral;
+    /** Optional same-status churn counter (rendered `moved ×k`, never extra bars). */
+    moved?: SubtypeExprOrValue<IntegerType> | number;
+    /** Optional leading FA glyph (10px, inherits the bar text colour). */
+    icon?: PlanIconInput;
+}
+/**
+ * Builds one span run from a flat input. The result is BRANDED with the axis
+ * kind `start` / `end` imply ({@link PlanKindOf}) — a `DateTimeType` accessor
+ * makes a `"time"` run, a `FloatType` one a `"number"` run — so the series and
+ * root can refuse a mismatched kind at compile time; an erased input (an
+ * `Expr<PlanInstantType>`) leaves the run unbranded.
+ *
+ * @typeParam S - The `start` input's type
+ * @typeParam E - The `end` input's type
+ * @param input - The run configuration ({@link PlanRunInput})
+ * @returns An East expression of {@link PlanRunType}, branded with its kind
+ */
+export declare function createRun<S extends PlanInstantInput, E extends PlanInstantInput>(input: PlanRunInput<S, E>): PlanRunExpr<PlanKindOf<S | E>>;
+/**
+ * Flat input for {@link Plan.decision} — a ◇/◆ diamond on a run transition.
+ *
+ * @typeParam A - The `at` input's type — its axis kind brands the result
+ * @property key - Stable decision identity
+ * @property at - The transition instant the diamond sits on
+ * @property applied - `true` fills the diamond (◆)
+ */
+export interface PlanDecisionInput<A extends PlanInstantInput = PlanInstantInput> {
+    /** Stable decision identity. */
+    key: SubtypeExprOrValue<StringType>;
+    /** The transition instant the diamond sits on (see {@link PlanInstantLikeType}). */
+    at: A;
+    /** `true` fills the diamond (◆ applied). */
+    applied: SubtypeExprOrValue<BooleanType> | boolean;
+}
+/**
+ * Builds one decision mark from a flat input, branded with `at`'s kind.
+ *
+ * @typeParam A - The `at` input's type
+ * @param input - The decision configuration ({@link PlanDecisionInput})
+ * @returns An East expression of {@link PlanDecisionMarkType}, branded with its kind
+ */
+export declare function createDecision<A extends PlanInstantInput>(input: PlanDecisionInput<A>): PlanDecisionMarkExpr<PlanKindOf<A>>;
+/**
+ * Flat input for {@link Plan.port} — a quantity in/out glyph on a span row.
+ *
+ * @typeParam A - The `at` input's type — its axis kind brands the result
+ * @property at - The instant the quantity moves
+ * @property label - Optional caption (`"−24 t"`)
+ */
+export interface PlanPortInput<A extends PlanInstantInput = PlanInstantInput> {
+    /** The instant the quantity moves (see {@link PlanInstantLikeType}). */
+    at: A;
+    /** Optional caption (`"−24 t"`). */
+    label?: SubtypeExprOrValue<StringType>;
+}
+/**
+ * Builds one port glyph from a flat input, branded with `at`'s kind.
+ *
+ * @typeParam A - The `at` input's type
+ * @param input - The port configuration ({@link PlanPortInput})
+ * @returns An East expression of {@link PlanPortType}, branded with its kind
+ */
+export declare function createPort<A extends PlanInstantInput>(input: PlanPortInput<A>): PlanPortExpr<PlanKindOf<A>>;
+/**
+ * Flat input for {@link Plan.event} — one bucket-row tile (the full Planner
+ * point-event grammar).
+ *
+ * @typeParam A - The `at` input's type — its axis kind brands the result
+ * @property key - Stable event identity (drag refs)
+ * @property at - The bucket instant
+ * @property lane - The lane key (`[]`-laned rows omit it; in a laned row, omitting takes the full cell)
+ * @property label - Optional tile text; omitted ⇒ the resting ✓ / `plan` chip
+ * @property icon - Optional leading FA glyph (icon-only tile when `label` omitted)
+ * @property state - The lifecycle state (string shorthand or value)
+ * @property tone - Optional semantic tile tint
+ * @property color - Optional raw colour token override
+ * @property colorPalette - Optional brand palette override
+ * @property stretch - Optional fill axis (`"horizontal"` / `"vertical"` / `"both"`)
+ * @property content - Optional two-axis content alignment
+ * @property animation - Optional attention animation (`"pulse"`)
+ */
+export interface PlanBucketEventInput<A extends PlanInstantInput = PlanInstantInput> {
+    /** Stable event identity (drag-grammar cell refs). */
+    key: SubtypeExprOrValue<StringType>;
+    /** The bucket instant (see {@link PlanInstantLikeType}). */
+    at: A;
+    /** The lane key. In a laned row, omitting takes the full cell (the mixed grammar). */
+    lane?: SubtypeExprOrValue<StringType>;
+    /** Optional tile text; omitted ⇒ ✓ (confirmed/actual) or the dashed `plan` chip (proposed). */
+    label?: SubtypeExprOrValue<StringType>;
+    /** Optional leading FA glyph (chip-sized, inherits chip colour; icon-only tile when `label` omitted). */
+    icon?: PlanIconInput;
+    /** The lifecycle state — a string shorthand or an `EventStateType` value. */
+    state: SubtypeExprOrValue<EventStateType> | EventStateLiteral;
+    /** Optional semantic tile tint (keeps the state's border-style). */
+    tone?: SubtypeExprOrValue<StatusValueType> | StatusValueLiteral;
+    /** Optional raw colour token override (`"teal.solid"`). */
+    color?: SubtypeExprOrValue<StringType>;
+    /** Optional brand palette override (`"teal"`, `"purple"`). */
+    colorPalette?: SubtypeExprOrValue<ColorSchemeType> | ColorSchemeLiteral;
+    /** Optional fill axis. */
+    stretch?: SubtypeExprOrValue<PlanStretchType> | PlanStretchLiteral;
+    /** Optional two-axis content alignment (defaults to top-left). */
+    content?: {
+        /** Horizontal content alignment (→ `justifyContent`). */
+        horizontal?: SubtypeExprOrValue<PlanContentAlignType> | PlanContentAlignLiteral;
+        /** Vertical content alignment (→ `alignItems`). */
+        vertical?: SubtypeExprOrValue<PlanContentAlignType> | PlanContentAlignLiteral;
+    };
+    /** Optional attention animation (`"pulse"` honours `prefers-reduced-motion`). */
+    animation?: SubtypeExprOrValue<PlanAnimationType> | PlanAnimationLiteral;
+}
+/**
+ * Builds one bucket event from a flat input, branded with `at`'s kind.
+ *
+ * @typeParam A - The `at` input's type
+ * @param input - The event configuration ({@link PlanBucketEventInput})
+ * @returns An East expression of {@link PlanBucketEventType}, branded with its kind
+ */
+export declare function createBucketEvent<A extends PlanInstantInput>(input: PlanBucketEventInput<A>): PlanBucketEventExpr<PlanKindOf<A>>;
+/**
+ * Flat input for {@link Plan.lane} — one bucket-row sub-slot lane.
+ *
+ * @property key - The lane key (`"am"`) — bucket events reference it via `lane`
+ * @property label - Optional printed caption (`"AM"`); omitted ⇒ an unlabelled strip
+ */
+export interface PlanLaneInput {
+    /** The lane key (`"am"`) — bucket events reference it via `lane`. */
+    key: SubtypeExprOrValue<StringType>;
+    /** Optional printed caption (`"AM"`); omitted ⇒ an unlabelled strip. */
+    label?: SubtypeExprOrValue<StringType>;
+}
+/**
+ * Builds one bucket-row lane from a flat input.
+ *
+ * @param input - The lane configuration ({@link PlanLaneInput})
+ * @returns An East expression of {@link PlanLaneType}
+ */
+export declare function createLane(input: PlanLaneInput): ExprType<PlanLaneType>;
+/**
+ * Flat input for {@link Plan.link} — one run-edge quantity link of the
+ * canvas's link graph (`Plan.Root`'s `links`).
+ *
+ * @property from - The source row key
+ * @property fromRun - The source run key (the ribbon leaves this run's end edge)
+ * @property to - The destination row key
+ * @property toRun - The destination run key (the ribbon lands on this run's start edge)
+ * @property quantity - The moved quantity (drives ribbon share + opacity)
+ * @property label - The printed quantity caption (`"34 t"`)
+ */
+export interface PlanLinkInput {
+    /** The source row key. */
+    from: SubtypeExprOrValue<StringType>;
+    /** The source run key (the ribbon leaves this run's end edge). */
+    fromRun: SubtypeExprOrValue<StringType>;
+    /** The destination row key. */
+    to: SubtypeExprOrValue<StringType>;
+    /** The destination run key (the ribbon lands on this run's start edge). */
+    toRun: SubtypeExprOrValue<StringType>;
+    /** The moved quantity (drives ribbon share + opacity). */
+    quantity: SubtypeExprOrValue<FloatType> | number;
+    /** The printed quantity caption (`"34 t"`). */
+    label: SubtypeExprOrValue<StringType>;
+}
+/**
+ * Builds one link edge from a flat input. Links are root DATA
+ * (`links={transfers.map(($, t) => Plan.link({ … }))}`): the links-focus
+ * control gathers a row's transitive upstream/downstream family over them.
+ *
+ * @param input - The link configuration ({@link PlanLinkInput})
+ * @returns An East expression of {@link PlanLinkType}
+ */
+export declare function createLink(input: PlanLinkInput): ExprType<PlanLinkType>;
+/**
+ * Flat input for {@link Plan.marker} — a bucket-cell status ring.
+ *
+ * @typeParam A - The `at` input's type — its axis kind brands the result
+ * @property at - The bucket instant the marker rings
+ * @property lane - The lane key within the cell
+ * @property status - The semantic status (default `"danger"`)
+ * @property message - The hover-tooltip text
+ */
+export interface PlanCellMarkerInput<A extends PlanInstantInput = PlanInstantInput> {
+    /** The bucket instant the marker rings (see {@link PlanInstantLikeType}). */
+    at: A;
+    /** The lane key within the cell. */
+    lane?: SubtypeExprOrValue<StringType>;
+    /** The semantic status (default `"danger"`). */
+    status?: SubtypeExprOrValue<StatusValueType> | StatusValueLiteral;
+    /** The hover-tooltip text. */
+    message: SubtypeExprOrValue<StringType>;
+}
+/**
+ * Builds one cell marker from a flat input, branded with `at`'s kind.
+ *
+ * @typeParam A - The `at` input's type
+ * @param input - The marker configuration ({@link PlanCellMarkerInput})
+ * @returns An East expression of {@link PlanCellMarkerType}, branded with its kind
+ */
+export declare function createCellMarker<A extends PlanInstantInput>(input: PlanCellMarkerInput<A>): PlanCellMarkerExpr<PlanKindOf<A>>;
+/**
+ * Flat input for {@link Plan.chip} — one cards-row shift chip.
+ *
+ * @typeParam F - The `from` input's type — its axis kind brands the result
+ * @typeParam T - The `to` input's type
+ * @property key - Stable chip identity
+ * @property from - Chip start (inclusive)
+ * @property to - Chip end (exclusive)
+ * @property label - The chip text (`"80h"`, `"+64h"`)
+ * @property state - The lifecycle state (string shorthand or value)
+ * @property icon - Optional leading FA glyph
+ */
+export interface PlanChipInput<F extends PlanInstantInput = PlanInstantInput, T extends PlanInstantInput = PlanInstantInput> {
+    /** Stable chip identity (drag refs). */
+    key: SubtypeExprOrValue<StringType>;
+    /** Chip start (inclusive) — see {@link PlanInstantLikeType}. */
+    from: F;
+    /** Chip end (exclusive). */
+    to: T;
+    /** The chip text (`"80h"`, `"+64h"`). */
+    label: SubtypeExprOrValue<StringType>;
+    /** The lifecycle state — confirmed tint · proposed dashed · removed strikethrough · estimated ghost. */
+    state: SubtypeExprOrValue<EventStateType> | EventStateLiteral;
+    /** Optional leading FA glyph (shift-type etc.). */
+    icon?: PlanIconInput;
+}
+/**
+ * Builds one cards chip from a flat input, branded with the kind `from` /
+ * `to` imply.
+ *
+ * @typeParam F - The `from` input's type
+ * @typeParam T - The `to` input's type
+ * @param input - The chip configuration ({@link PlanChipInput})
+ * @returns An East expression of {@link PlanChipType}, branded with its kind
+ */
+export declare function createChip<F extends PlanInstantInput, T extends PlanInstantInput>(input: PlanChipInput<F, T>): PlanChipExpr<PlanKindOf<F | T>>;
+/**
+ * Flat input for {@link Plan.mark} — one event-row instant mark.
+ *
+ * @typeParam A - The `at` input's type — its axis kind brands the result
+ * @property key - Stable mark identity
+ * @property at - The instant
+ * @property kind - `"milestone"` / `"exception"` / `Plan.markKind.decision(applied)`
+ * @property icon - Optional FA glyph swap (12px, kind-coloured)
+ * @property label - Optional caption (printed when there is room)
+ */
+export interface PlanEventMarkInput<A extends PlanInstantInput = PlanInstantInput> {
+    /** Stable mark identity. */
+    key: SubtypeExprOrValue<StringType>;
+    /** The instant (see {@link PlanInstantLikeType}). */
+    at: A;
+    /** The mark kind — `"milestone"` / `"exception"` string shorthand or a `PlanEventMarkKindType` value (see `Plan.markKind`). */
+    kind: SubtypeExprOrValue<PlanEventMarkKindType> | "milestone" | "exception";
+    /** Optional FA glyph swap (12px, still kind-coloured). */
+    icon?: PlanIconInput;
+    /** Optional caption (printed when there is room). */
+    label?: SubtypeExprOrValue<StringType>;
+}
+/**
+ * Builds one event mark from a flat input, branded with `at`'s kind.
+ *
+ * @typeParam A - The `at` input's type
+ * @param input - The mark configuration ({@link PlanEventMarkInput})
+ * @returns An East expression of {@link PlanEventMarkType}, branded with its kind
+ */
+export declare function createEventMark<A extends PlanInstantInput>(input: PlanEventMarkInput<A>): PlanEventMarkExpr<PlanKindOf<A>>;
+/** The `Plan.markKind` builders — non-null mark kinds. */
+export declare const markKind: {
+    /**
+     * A decision diamond mark — ◇ pending / ◆ applied.
+     *
+     * @param applied - `true` fills the diamond
+     * @returns A `PlanEventMarkKindType` expression with the `decision` arm
+     */
+    readonly decision: (applied: SubtypeExprOrValue<BooleanType> | boolean) => ExprType<PlanEventMarkKindType>;
+};
+/**
+ * Options for {@link Plan.heatCells} — the heat scale + warn threshold.
+ *
+ * @property min - Scale minimum (default: observed)
+ * @property max - Scale maximum (default: observed)
+ * @property warnAt - Warn-ring threshold (≥ it rings the cell)
+ */
+export interface PlanHeatCellsOptions {
+    /** Scale minimum (default: the observed extent). */
+    min?: SubtypeExprOrValue<FloatType> | number;
+    /** Scale maximum (default: the observed extent). */
+    max?: SubtypeExprOrValue<FloatType> | number;
+    /** Warn-ring threshold (≥ it rings the cell). */
+    warnAt?: SubtypeExprOrValue<FloatType> | number;
+}
+/**
+ * Wraps per-bucket heat cells into the `heat` arm of {@link PlanHeatCellsType}.
+ * Literal records whose `at` is a `Plan.at.*` value brand the result with
+ * that kind ({@link PlanCellsInput}); an East array is kind-erased.
+ *
+ * @typeParam K - The kind inferred from the literal records' `at`
+ * @param cells - The cells (`{ at, value, label }` structs; `value: none` ⇒ the no-data hatch)
+ * @param options - Scale + warn threshold ({@link PlanHeatCellsOptions})
+ * @returns A `PlanHeatCellsType` expression, branded with the cells' kind
+ */
+export declare function createHeatCells<K extends PlanAxisKindLiteral = never>(cells: PlanCellsInput<PlanHeatCellType, K>, options?: PlanHeatCellsOptions): PlanHeatCellsExpr<K>;
+/**
+ * Wraps per-bucket weight cells into the `weight` arm of
+ * {@link PlanHeatCellsType} (booked-vs-free bars; planned ⇒ pale). Literal
+ * records with `Plan.at.*` instants brand the result with their kind.
+ *
+ * @typeParam K - The kind inferred from the literal records' `at`
+ * @param cells - The cells (`{ at, fraction, planned }` structs)
+ * @returns A `PlanHeatCellsType` expression, branded with the cells' kind
+ */
+export declare function createWeightCells<K extends PlanAxisKindLiteral = never>(cells: PlanCellsInput<PlanWeightCellType, K>): PlanHeatCellsExpr<K>;
+/**
+ * Wraps per-bucket segment cells into the `segments` arm of
+ * {@link PlanHeatCellsType} (committed / pending / slack compositions).
+ * Literal records with `Plan.at.*` instants brand the result with their kind.
+ *
+ * @typeParam K - The kind inferred from the literal records' `at`
+ * @param cells - The cells (`{ at, segments }` structs — build segments with `Plan.segment`)
+ * @returns A `PlanHeatCellsType` expression, branded with the cells' kind
+ */
+export declare function createSegmentCells<K extends PlanAxisKindLiteral = never>(cells: PlanCellsInput<PlanSegmentCellType, K>): PlanHeatCellsExpr<K>;
+/**
+ * Flat input for {@link Plan.segment} — one weighted slice of a segment cell.
+ *
+ * @property fill - The status-leveraged fill (string shorthand or `MatrixFillType`)
+ * @property weight - The proportional weight
+ * @property label - Optional in-bar text (printed when wide enough)
+ */
+export interface PlanSegmentInput {
+    /** The status-leveraged fill. */
+    fill: SubtypeExprOrValue<MatrixFillType> | MatrixFillLiteral;
+    /** The proportional weight (normalised with siblings). */
+    weight: SubtypeExprOrValue<FloatType> | number;
+    /** Optional in-bar text (printed when the segment is wide enough). */
+    label?: SubtypeExprOrValue<StringType>;
+}
+/**
+ * Builds one segment from a flat input (the Matrix segment vocabulary).
+ *
+ * @param input - The segment configuration ({@link PlanSegmentInput})
+ * @returns An East expression of {@link PlanSegmentType}
+ */
+export declare function createSegment(input: PlanSegmentInput): ExprType<typeof PlanSegmentType>;
+/**
+ * Flat input for {@link Plan.tableSeries} — one value series of a
+ * multi-series table row. Style is declared ONCE here, per position (never
+ * per cell — the wire-lean contract); the cells stay raw values.
+ *
+ * @typeParam K - The cells' axis kind (a `Plan.tableCells` result carries it)
+ * @property cells - The series' cells (a `Plan.tableCells` result / `PlanTableCellType` values)
+ * @property format - Numeral format override for this series (else the row's `format`)
+ * @property tone - Default tone for the series' values (`"muted"` de-emphasises a plan column)
+ * @property strong - Semibold emphasis for this series' values
+ * @property rollup - `true` ⇒ this series feeds declared parent aggregation (default: the first)
+ */
+export interface PlanTableSeriesInput<K extends PlanAxisKindLiteral = never> {
+    /** The series' cells (a `Plan.tableCells` result / `PlanTableCellType` values). */
+    cells: PlanTableCellsInput<K>;
+    /** Numeral format override for THIS series — a `Format.*` spec (else the row's `format`). */
+    format?: SubtypeExprOrValue<TickFormatType>;
+    /** Default tone for the series' values; per-cell tones and the derived neg/em-dash win. */
+    tone?: SubtypeExprOrValue<PlanTableToneType> | PlanTableToneLiteral;
+    /** Semibold emphasis for this series' values. */
+    strong?: SubtypeExprOrValue<BooleanType> | boolean;
+    /** `true` ⇒ this series feeds declared parent aggregation (default: the first series). */
+    rollup?: SubtypeExprOrValue<BooleanType> | boolean;
+}
+/**
+ * Builds one table-row value series (see {@link Plan.table}'s `series`) —
+ * per-position style declared once, raw cells beneath it; the result carries
+ * the cells' axis kind.
+ *
+ * @typeParam K - The cells' axis kind
+ * @param input - The series configuration ({@link PlanTableSeriesInput})
+ * @returns An East expression of {@link PlanTableSeriesType}, branded with the cells' kind
+ */
+export declare function createTableSeries<K extends PlanAxisKindLiteral = never>(input: PlanTableSeriesInput<K>): PlanTableSeriesExpr<K>;
+/**
+ * The raw table-cell record — `{ at, value }`, its `at` any
+ * {@link PlanInstantLikeType} (wrapped to the axis arm by its static type).
+ */
+export type PlanRawTableCellType = StructType<{
+    at: PlanInstantLikeType;
+    value: OptionType<FloatType>;
+}>;
+/**
+ * Builds per-bucket table cells from raw values. The RENDERER prints each
+ * value through the row's `format` (a `Format.*` spec — the shared
+ * `TickFormatType`), tones negatives `neg` and renders `none` as the muted
+ * em-dash; build `PlanTableCellType` values directly for explicit `text` /
+ * `tone` overrides.
+ *
+ * @remarks
+ * The `at` of each raw cell wraps to the axis arm by its type — a
+ * `DateTimeType` field to `time`, a numeric field to `number`, a string
+ * field to `ordinal`, a {@link PlanInstantType} field as is — so a
+ * `{ at: DateTimeType, value }` dataset keeps compiling unchanged.
+ *
+ * Literal records brand the result with the kind their `at` implies
+ * ({@link PlanKindOf}); an East array is kind-erased.
+ *
+ * @typeParam A - The literal records' `at` type
+ * @param cells - The raw cells (`{ at, value }` records; `value` an `Option<Float>`)
+ * @returns An `ArrayType(PlanTableCellType)` expression, branded with the cells' kind
+ * @throws {Error} If an East array's element `at` is not an instant-typed field
+ */
+export declare function createTableCells<A extends PlanInstantInput = never>(cells: {
+    at: A;
+    value: SubtypeExprOrValue<OptionType<FloatType>>;
+}[] | SubtypeExprOrValue<ArrayType<PlanRawTableCellType>>): PlanTableCellsExpr<PlanKindOf<A>>;
+//# sourceMappingURL=builders.d.ts.map

package/dist/src/collections/plan/builders.d.ts.map

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