@elaraai/east-ui 1.0.42 → 1.0.44

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

@@ -0,0 +1,292 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { East, Expr, variant, some, none, ArrayType, BooleanType, DateTimeType, FunctionType, IntegerType, NullType, OptionType, StringType, StructType, } from "@elaraai/east";
+import { UIComponentType } from "../../component.js";
+import { mapRows } from "../../shared/reify.js";
+import { DensityType } from "../../style/interaction.js";
+import { SliceBindType, SliceChromeType } from "../../platform/slice/index.js";
+import { SliceAffordanceType } from "../../contracts/slice-affordances.js";
+import { FlowchartLinkKindType, FlowchartOrientationType, FlowchartLinkModeType, FlowchartEvidenceType, FlowchartStateType, FlowchartLinkType, FlowchartLaneType, FlowchartTriggerType, FlowchartFreshnessType, FlowchartLinkCreateEventType, FlowchartLaneRenameEventType, FlowchartStateAddEventType, FlowchartStateEditEventType, FlowchartStateMoveEventType, } from "./types.js";
+// Re-export types
+export { FlowchartLinkKindType, FlowchartOrientationType, FlowchartLinkModeType, FlowchartEvidenceType, FlowchartStateType, FlowchartLinkType, FlowchartLaneType, FlowchartTriggerType, FlowchartFreshnessType, FlowchartLinkCreateEventType, FlowchartLaneRenameEventType, FlowchartStateAddEventType, FlowchartStateEditEventType, FlowchartStateMoveEventType, } from "./types.js";
+/**
+ * East type for the Flowchart root — the resolved mirror of the inline
+ * `Flowchart` struct in `component.ts`. Keep the two spellings in sync
+ * field-for-field.
+ *
+ * @remarks
+ * Per-field docs live on {@link FlowchartConfig}; events and collection
+ * row types are documented in `./types.ts`.
+ */
+export const FlowchartRootType = StructType({
+    states: ArrayType(FlowchartStateType),
+    links: ArrayType(FlowchartLinkType),
+    lanes: ArrayType(FlowchartLaneType),
+    triggers: ArrayType(FlowchartTriggerType),
+    orientation: OptionType(FlowchartOrientationType),
+    freshness: OptionType(FlowchartFreshnessType),
+    minimap: OptionType(BooleanType),
+    legend: OptionType(BooleanType),
+    density: OptionType(DensityType),
+    height: OptionType(StringType),
+    maxHeight: OptionType(StringType),
+    slice: OptionType(SliceChromeType),
+    stateHover: OptionType(FunctionType([StringType], UIComponentType)),
+    linkHover: OptionType(FunctionType([StringType], UIComponentType)),
+    triggerHover: OptionType(FunctionType([StringType], UIComponentType)),
+    onSelectState: OptionType(FunctionType([StringType], NullType)),
+    onSelectLink: OptionType(FunctionType([StringType], NullType)),
+    onSelectTrigger: OptionType(FunctionType([StringType], NullType)),
+    onTracePath: OptionType(FunctionType([StringType], NullType)),
+    linkMode: OptionType(FlowchartLinkModeType),
+    onCreateLink: OptionType(FunctionType([FlowchartLinkCreateEventType], NullType)),
+    onDeleteLink: OptionType(FunctionType([StringType], NullType)),
+    canConnect: OptionType(FunctionType([StringType, StringType], BooleanType)),
+    onAddLane: OptionType(FunctionType([], NullType)),
+    onRenameLane: OptionType(FunctionType([FlowchartLaneRenameEventType], NullType)),
+    onDeleteLane: OptionType(FunctionType([StringType], NullType)),
+    onAddState: OptionType(FunctionType([FlowchartStateAddEventType], NullType)),
+    onEditState: OptionType(FunctionType([FlowchartStateEditEventType], NullType)),
+    onMoveState: OptionType(FunctionType([FlowchartStateMoveEventType], NullType)),
+    readOnly: OptionType(BooleanType),
+});
+// ============================================================================
+// Build
+// ============================================================================
+/** Resolves a kind literal / value into the option envelope. */
+function kindOption(kind) {
+    if (kind === undefined)
+        return East.value(none, OptionType(FlowchartLinkKindType));
+    if (typeof kind === "string")
+        return East.value(some(variant(kind, null)), OptionType(FlowchartLinkKindType));
+    return East.value(some(kind), OptionType(FlowchartLinkKindType));
+}
+function buildRoot(states, links, lanes, config) {
+    const stateMapper = config.state;
+    const resolvedStates = stateMapper === undefined
+        ? East.value(states, ArrayType(FlowchartStateType))
+        : mapRows(East.value(states), FlowchartStateType, (row) => {
+            const r = stateMapper(row);
+            if (r instanceof Expr)
+                return East.value(r, FlowchartStateType);
+            return East.value({
+                key: r.key,
+                label: r.label !== undefined ? some(r.label) : none,
+                lane: r.lane,
+                members: r.members !== undefined ? r.members : none,
+                notes: r.notes !== undefined ? some(r.notes) : none,
+            }, FlowchartStateType);
+        });
+    const linkMapper = config.link;
+    const resolvedLinks = linkMapper === undefined
+        ? East.value(links, ArrayType(FlowchartLinkType))
+        : mapRows(East.value(links), FlowchartLinkType, (row) => {
+            const r = linkMapper(row);
+            if (r instanceof Expr)
+                return East.value(r, FlowchartLinkType);
+            return East.value({
+                key: r.key !== undefined ? some(r.key) : none,
+                from: r.from,
+                to: r.to,
+                kind: kindOption(r.kind),
+                trigger: r.trigger !== undefined ? r.trigger : none,
+                evidence: r.evidence !== undefined
+                    ? some(East.value({
+                        volume: r.evidence.volume !== undefined ? r.evidence.volume : none,
+                        count: r.evidence.count !== undefined ? r.evidence.count : none,
+                        measuredAt: r.evidence.measuredAt !== undefined ? r.evidence.measuredAt : none,
+                        unit: r.evidence.unit !== undefined ? some(r.evidence.unit) : none,
+                    }, FlowchartEvidenceType))
+                    : none,
+            }, FlowchartLinkType);
+        });
+    const laneMapper = config.lane;
+    const resolvedLanes = laneMapper !== undefined
+        ? mapRows(East.value(lanes), FlowchartLaneType, (row) => {
+            const r = laneMapper(row);
+            if (r instanceof Expr)
+                return East.value(r, FlowchartLaneType);
+            return East.value({
+                key: r.key,
+                label: r.label !== undefined ? some(r.label) : none,
+            }, FlowchartLaneType);
+        })
+        : Array.isArray(lanes)
+            ? East.value(lanes.map(l => ({
+                key: l.key,
+                label: l.label !== undefined ? some(l.label) : none,
+            })), ArrayType(FlowchartLaneType))
+            : East.value(lanes, ArrayType(FlowchartLaneType));
+    const triggerMapper = config.trigger;
+    const resolvedTriggers = config.triggers === undefined
+        ? East.value([], ArrayType(FlowchartTriggerType))
+        : triggerMapper === undefined
+            ? East.value(config.triggers, ArrayType(FlowchartTriggerType))
+            : mapRows(East.value(config.triggers), FlowchartTriggerType, (row) => {
+                const r = triggerMapper(row);
+                if (r instanceof Expr)
+                    return East.value(r, FlowchartTriggerType);
+                return East.value({
+                    key: r.key,
+                    label: r.label,
+                    letter: r.letter !== undefined ? some(r.letter) : none,
+                    owner: r.owner !== undefined ? some(r.owner) : none,
+                    queue: r.queue !== undefined ? some(East.value(r.queue, ArrayType(StringType))) : none,
+                    outcomes: r.outcomes !== undefined ? some(r.outcomes) : none,
+                }, FlowchartTriggerType);
+            });
+    if (config.affordances?.includes("brush")) {
+        throw new Error("Flowchart does not support the 'brush' affordance — a flowchart has no continuous 1D axis.");
+    }
+    const sliceChromeValue = config.slice !== undefined
+        ? East.value({
+            slice: config.slice,
+            affordances: East.value((config.affordances ?? ["filter", "search"]).map(a => variant(a, null)), ArrayType(SliceAffordanceType)),
+        }, SliceChromeType)
+        : undefined;
+    return East.value(variant("Flowchart", {
+        states: resolvedStates,
+        links: resolvedLinks,
+        lanes: resolvedLanes,
+        triggers: resolvedTriggers,
+        orientation: config.orientation !== undefined
+            ? some(typeof config.orientation === "string" ? variant(config.orientation, null) : config.orientation)
+            : none,
+        freshness: config.freshness !== undefined
+            ? some(East.value({
+                label: config.freshness.label,
+                date: config.freshness.date !== undefined ? some(config.freshness.date) : none,
+            }, FlowchartFreshnessType))
+            : none,
+        minimap: config.minimap !== undefined ? some(config.minimap) : none,
+        legend: config.legend !== undefined ? some(config.legend) : none,
+        density: config.density !== undefined
+            ? some(typeof config.density === "string" ? East.value(variant(config.density, null), DensityType) : config.density)
+            : none,
+        height: config.height !== undefined ? some(config.height) : none,
+        maxHeight: config.maxHeight !== undefined ? some(config.maxHeight) : none,
+        slice: sliceChromeValue ? some(sliceChromeValue) : none,
+        stateHover: config.stateHover !== undefined ? some(East.value(config.stateHover, FunctionType([StringType], UIComponentType))) : none,
+        linkHover: config.linkHover !== undefined ? some(East.value(config.linkHover, FunctionType([StringType], UIComponentType))) : none,
+        triggerHover: config.triggerHover !== undefined ? some(East.value(config.triggerHover, FunctionType([StringType], UIComponentType))) : none,
+        onSelectState: config.onSelectState !== undefined ? some(config.onSelectState) : none,
+        onSelectLink: config.onSelectLink !== undefined ? some(config.onSelectLink) : none,
+        onSelectTrigger: config.onSelectTrigger !== undefined ? some(config.onSelectTrigger) : none,
+        onTracePath: config.onTracePath !== undefined ? some(config.onTracePath) : none,
+        linkMode: config.linkMode !== undefined
+            ? some(typeof config.linkMode === "string" ? variant(config.linkMode, null) : config.linkMode)
+            : none,
+        onCreateLink: config.onCreateLink !== undefined ? some(config.onCreateLink) : none,
+        onDeleteLink: config.onDeleteLink !== undefined ? some(config.onDeleteLink) : none,
+        canConnect: config.canConnect !== undefined ? some(config.canConnect) : none,
+        onAddLane: config.onAddLane !== undefined ? some(config.onAddLane) : none,
+        onRenameLane: config.onRenameLane !== undefined ? some(config.onRenameLane) : none,
+        onDeleteLane: config.onDeleteLane !== undefined ? some(config.onDeleteLane) : none,
+        onAddState: config.onAddState !== undefined ? some(config.onAddState) : none,
+        onEditState: config.onEditState !== undefined ? some(config.onEditState) : none,
+        onMoveState: config.onMoveState !== undefined ? some(config.onMoveState) : none,
+        readOnly: config.readOnly !== undefined ? some(config.readOnly) : none,
+    }), UIComponentType);
+}
+/**
+ * Creates a Flowchart — a self-contained state-transition flowchart.
+ *
+ * @typeParam S - The states-table input
+ * @typeParam L - The links-table input
+ * @typeParam N - The lanes-table input
+ * @typeParam T - The triggers-table input
+ * @param states - The state rows (nodes)
+ * @param config - The Flowchart configuration ({@link FlowchartConfig}) plus
+ *   the `links` / `lanes` (required) and `triggers` (optional) tables
+ * @returns An East expression of `UIComponentType`
+ *
+ * @example
+ * ```ts
+ * import { East } from "@elaraai/east";
+ * import { Flowchart, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const example = East.function([], UIComponentType, _$ =>
+ *     Flowchart.Root(
+ *         [{ code: "RMI", name: "Raw intake", phase: "prep" },
+ *          { code: "CUT", name: "Cut blanks", phase: "prep" }],
+ *         {
+ *             state: s => ({ key: s.code, label: s.name, lane: s.phase }),
+ *             links: [{ src: "RMI", dst: "CUT" }],
+ *             link: l => ({ from: l.src, to: l.dst }),
+ *             lanes: [{ key: "prep", label: "Prep" }],
+ *         },
+ *     ),
+ * );
+ * ```
+ */
+function createFlowchart(states, config) {
+    const { links, lanes, ...rest } = config;
+    return buildRoot(states, links, lanes, rest);
+}
+// ============================================================================
+// Namespace export
+// ============================================================================
+/**
+ * Flowchart component namespace.
+ *
+ * @remarks
+ * `Flowchart.Root(states, config)` builds the flowchart from up to four
+ * flat tables (states, links, lanes, triggers); closed-set fields in data
+ * (`kind`, `orientation`, `linkMode`) are typed variant values
+ * (`Flowchart.Types.*`).
+ */
+export const Flowchart = {
+    /**
+     * Creates a Flowchart — a self-contained state-transition flowchart.
+     *
+     * @remarks
+     * See {@link FlowchartConfig} for per-field docs. States render as
+     * nodes in ordered phase lanes; links as H/V-routed arrows; triggers
+     * as lettered diamonds. Hover cards, the inspector and the highlight
+     * grammar are built-in surfaces derived from core + declared fields.
+     */
+    Root: createFlowchart,
+    /**
+     * East types for flowchart rows, closed-set fields and events.
+     */
+    Types: {
+        /**
+         * East StructType for the Flowchart component.
+         *
+         * @remarks
+         * See {@link FlowchartRootType} for per-field docs.
+         */
+        Flowchart: FlowchartRootType,
+        /** One state node ({@link FlowchartStateType}). */
+        State: FlowchartStateType,
+        /** One transition ({@link FlowchartLinkType}). */
+        Link: FlowchartLinkType,
+        /** One ordered phase band ({@link FlowchartLaneType}). */
+        Lane: FlowchartLaneType,
+        /** One decision trigger ({@link FlowchartTriggerType}). */
+        Trigger: FlowchartTriggerType,
+        /** Imported link evidence ({@link FlowchartEvidenceType}). */
+        Evidence: FlowchartEvidenceType,
+        /** Link kind — planned | observed ({@link FlowchartLinkKindType}). */
+        Kind: FlowchartLinkKindType,
+        /** Canvas orientation — LR | TD ({@link FlowchartOrientationType}). */
+        Orientation: FlowchartOrientationType,
+        /** Link-authoring mode — draw | connect ({@link FlowchartLinkModeType}). */
+        LinkMode: FlowchartLinkModeType,
+        /** Eyebrow freshness chip ({@link FlowchartFreshnessType}). */
+        Freshness: FlowchartFreshnessType,
+        /** Link-creation event ({@link FlowchartLinkCreateEventType}). */
+        LinkCreateEvent: FlowchartLinkCreateEventType,
+        /** Lane-rename event ({@link FlowchartLaneRenameEventType}). */
+        LaneRenameEvent: FlowchartLaneRenameEventType,
+        /** State-add event ({@link FlowchartStateAddEventType}). */
+        StateAddEvent: FlowchartStateAddEventType,
+        /** State-edit event ({@link FlowchartStateEditEventType}). */
+        StateEditEvent: FlowchartStateEditEventType,
+        /** State-move event ({@link FlowchartStateMoveEventType}). */
+        StateMoveEvent: FlowchartStateMoveEventType,
+    },
+};
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,333 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { ArrayType, DateTimeType, FloatType, IntegerType, NullType, OptionType, StringType, StructType, VariantType } from "@elaraai/east";
+/**
+ * Link kind — the transition's provenance class.
+ *
+ * @remarks
+ * `planned` renders solid; `observed` renders dashed (5/4). A link whose
+ * `from` / `to` reference has no state row is *unresolved* — that is a
+ * derived render class (dashed 4/4 in the negative tone against a ghost
+ * "No state row" node), never an authored kind.
+ *
+ * @property planned - A designed / expected transition (solid stroke)
+ * @property observed - A transition mined from evidence (dashed stroke)
+ */
+export declare const FlowchartLinkKindType: VariantType<{
+    /** A designed / expected transition (solid stroke) */
+    readonly planned: NullType;
+    /** A transition mined from evidence (dashed stroke) */
+    readonly observed: NullType;
+}>;
+/**
+ * Type representing flowchart link kinds.
+ */
+export type FlowchartLinkKindType = typeof FlowchartLinkKindType;
+/**
+ * Canvas orientation — which axis the lane bands run along.
+ *
+ * @remarks
+ * Orientation is VIEW state, not slice state: the eyebrow's orientation
+ * segment toggles it and it never appears as a filter chip. `LR` lays
+ * lanes left→right (links flow rightward); `TD` swaps the axes.
+ *
+ * @property LR - Lanes run left → right
+ * @property TD - Lanes run top → down
+ */
+export declare const FlowchartOrientationType: VariantType<{
+    /** Lanes run left → right */
+    readonly LR: NullType;
+    /** Lanes run top → down */
+    readonly TD: NullType;
+}>;
+/**
+ * Type representing flowchart orientations.
+ */
+export type FlowchartOrientationType = typeof FlowchartOrientationType;
+/**
+ * Link-authoring mode for the drag-to-connect gesture.
+ *
+ * @property draw - Adds locally, form-input style (the renderer appends)
+ * @property connect - Event-only; the host owns the data (plan operations)
+ */
+export declare const FlowchartLinkModeType: VariantType<{
+    /** Adds locally, form-input style (the renderer appends) */
+    readonly draw: NullType;
+    /** Event-only; the host owns the data (plan operations) */
+    readonly connect: NullType;
+}>;
+/**
+ * Type representing flowchart link-authoring modes.
+ */
+export type FlowchartLinkModeType = typeof FlowchartLinkModeType;
+/**
+ * Imported evidence carried by a link — never hand-authored.
+ *
+ * @remarks
+ * Evidence drives derived marks only: stroke weight scales with `volume`
+ * (log scale 1.6 / 2 / 2.5 px, floor 1.4), `volume` + `unit` print as the
+ * paper-filled badge on the longest straight run, and `count` /
+ * `measuredAt` surface in hover cards and the inspector provenance block.
+ *
+ * @property volume - Total measured volume behind the arrow
+ * @property count - Event count behind the arrow (e.g. transfers)
+ * @property measuredAt - When the evidence was measured
+ * @property unit - Volume unit suffix for badges ("kt")
+ */
+export declare const FlowchartEvidenceType: StructType<{
+    /** Total measured volume behind the arrow */
+    readonly volume: OptionType<FloatType>;
+    /** Event count behind the arrow (e.g. transfers) */
+    readonly count: OptionType<IntegerType>;
+    /** When the evidence was measured */
+    readonly measuredAt: OptionType<DateTimeType>;
+    /** Volume unit suffix for badges ("kt") */
+    readonly unit: OptionType<StringType>;
+}>;
+/**
+ * Type representing link evidence.
+ */
+export type FlowchartEvidenceType = typeof FlowchartEvidenceType;
+/**
+ * One state — a node in the flowchart.
+ *
+ * @remarks
+ * The short mono `key` is the node identity everywhere (selection events,
+ * link `from` / `to` refs, trigger queues). A state with `members` set is
+ * a STATE CLASS — one node standing for N interchangeable members (the
+ * `×N` badge). In-place transitions (`from == to` links) collapse to the
+ * `↻ n` badge on the node and never route through handles.
+ *
+ * @property key - Short mono code — the node identity ("RCT")
+ * @property label - Display label under the code
+ * @property lane - The lane (ordered phase) this state belongs to
+ * @property members - State-class member count → the ×N badge
+ * @property notes - Free-text notes surfaced on hover / inspector
+ */
+export declare const FlowchartStateType: StructType<{
+    /** Short mono code — the node identity ("RCT") */
+    readonly key: StringType;
+    /** Display label under the code */
+    readonly label: OptionType<StringType>;
+    /** The lane (ordered phase) this state belongs to */
+    readonly lane: StringType;
+    /** State-class member count → the ×N badge */
+    readonly members: OptionType<IntegerType>;
+    /** Free-text notes surfaced on hover / inspector */
+    readonly notes: OptionType<StringType>;
+}>;
+/**
+ * Type representing flowchart states.
+ */
+export type FlowchartStateType = typeof FlowchartStateType;
+/**
+ * One link — a state transition drawn as an H/V-routed arrow.
+ *
+ * @remarks
+ * `from` / `to` are state keys; a reference with no state row renders the
+ * neg-dashed ghost "No state row" node (derived, counted in the footer).
+ * At most one `trigger` per link — the lettered decision diamond anchored
+ * to the midpoint of the longest straight run.
+ *
+ * @property key - Stable identity (selection / delete events); default derived from endpoints
+ * @property from - Source state key
+ * @property to - Target state key
+ * @property kind - planned (default) | observed
+ * @property trigger - 0..1 decision trigger key → diamond
+ * @property evidence - Imported evidence (weight, badges, provenance)
+ */
+export declare const FlowchartLinkType: StructType<{
+    /** Stable identity (selection / delete events); default derived from endpoints */
+    readonly key: OptionType<StringType>;
+    /** Source state key */
+    readonly from: StringType;
+    /** Target state key */
+    readonly to: StringType;
+    /** planned (default) | observed */
+    readonly kind: OptionType<VariantType<{
+        /** A designed / expected transition (solid stroke) */
+        readonly planned: NullType;
+        /** A transition mined from evidence (dashed stroke) */
+        readonly observed: NullType;
+    }>>;
+    /** 0..1 decision trigger key → diamond */
+    readonly trigger: OptionType<StringType>;
+    /** Imported evidence (weight, badges, provenance) */
+    readonly evidence: OptionType<StructType<{
+        /** Total measured volume behind the arrow */
+        readonly volume: OptionType<FloatType>;
+        /** Event count behind the arrow (e.g. transfers) */
+        readonly count: OptionType<IntegerType>;
+        /** When the evidence was measured */
+        readonly measuredAt: OptionType<DateTimeType>;
+        /** Volume unit suffix for badges ("kt") */
+        readonly unit: OptionType<StringType>;
+    }>>;
+}>;
+/**
+ * Type representing flowchart links.
+ */
+export type FlowchartLinkType = typeof FlowchartLinkType;
+/**
+ * One lane — an ordered phase band.
+ *
+ * @remarks
+ * Lane order is array order; every state names its lane by `key`. The
+ * dashed `+ LANE` affordance renders at the tail of the band row.
+ *
+ * @property key - Lane identity referenced by states
+ * @property label - Band header label (defaults to the key, uppercased)
+ */
+export declare const FlowchartLaneType: StructType<{
+    /** Lane identity referenced by states */
+    readonly key: StringType;
+    /** Band header label (defaults to the key, uppercased) */
+    readonly label: OptionType<StringType>;
+}>;
+/**
+ * Type representing flowchart lanes.
+ */
+export type FlowchartLaneType = typeof FlowchartLaneType;
+/**
+ * One decision trigger — a governed decision seam referenced by links.
+ *
+ * @remarks
+ * Triggers render as diamonds (max one per link) carrying a letter per
+ * TYPE, not per instance. Clicking a diamond highlights every link it
+ * governs (plus queue and outcome nodes).
+ *
+ * @property key - Trigger identity referenced by links
+ * @property label - Decision name ("press")
+ * @property letter - Diamond letter (default: first letter of the label)
+ * @property owner - Owning role / system ("press-scheduler")
+ * @property queue - State keys queued at the decision
+ * @property outcomes - Outcome summary line ("P* (×14 slots)")
+ */
+export declare const FlowchartTriggerType: StructType<{
+    /** Trigger identity referenced by links */
+    readonly key: StringType;
+    /** Decision name ("press") */
+    readonly label: StringType;
+    /** Diamond letter (default: first letter of the label) */
+    readonly letter: OptionType<StringType>;
+    /** Owning role / system ("press-scheduler") */
+    readonly owner: OptionType<StringType>;
+    /** State keys queued at the decision */
+    readonly queue: OptionType<ArrayType<StringType>>;
+    /** Outcome summary line ("P* (×14 slots)") */
+    readonly outcomes: OptionType<StringType>;
+}>;
+/**
+ * Type representing flowchart triggers.
+ */
+export type FlowchartTriggerType = typeof FlowchartTriggerType;
+/**
+ * Eyebrow freshness chip content.
+ *
+ * @property label - Chip label ("evidence-2026.06")
+ * @property date - Optional stamp printed after the label
+ */
+export declare const FlowchartFreshnessType: StructType<{
+    /** Chip label ("evidence-2026.06") */
+    readonly label: StringType;
+    /** Optional stamp printed after the label */
+    readonly date: OptionType<DateTimeType>;
+}>;
+/**
+ * Type representing the freshness chip.
+ */
+export type FlowchartFreshnessType = typeof FlowchartFreshnessType;
+/**
+ * Lane-rename event — a committed inline header edit.
+ *
+ * @property key - The renamed lane's key
+ * @property label - The new label text
+ */
+export declare const FlowchartLaneRenameEventType: StructType<{
+    /** The renamed lane's key */
+    readonly key: StringType;
+    /** The new label text */
+    readonly label: StringType;
+}>;
+/**
+ * Type representing lane-rename events.
+ */
+export type FlowchartLaneRenameEventType = typeof FlowchartLaneRenameEventType;
+/**
+ * State-add event — a committed "+ STATE" ghost editor.
+ *
+ * @property lane - The lane the ghost was committed in
+ * @property key - The typed state code (the node identity)
+ * @property label - The typed label (may be empty)
+ */
+export declare const FlowchartStateAddEventType: StructType<{
+    /** The lane the ghost was committed in */
+    readonly lane: StringType;
+    /** The typed state code (the node identity) */
+    readonly key: StringType;
+    /** The typed label (may be empty) */
+    readonly label: StringType;
+}>;
+/**
+ * Type representing state-add events.
+ */
+export type FlowchartStateAddEventType = typeof FlowchartStateAddEventType;
+/**
+ * State-edit event — a committed inline node editor.
+ *
+ * @property key - The ORIGINAL state key (the identity being edited)
+ * @property code - The possibly-changed code (rekeying is the host's call)
+ * @property label - The new label text
+ */
+export declare const FlowchartStateEditEventType: StructType<{
+    /** The ORIGINAL state key (the identity being edited) */
+    readonly key: StringType;
+    /** The possibly-changed code (rekeying is the host's call) */
+    readonly code: StringType;
+    /** The new label text */
+    readonly label: StringType;
+}>;
+/**
+ * Type representing state-edit events.
+ */
+export type FlowchartStateEditEventType = typeof FlowchartStateEditEventType;
+/**
+ * State-move event — a node dropped on another lane.
+ *
+ * @property key - The moved state's key
+ * @property lane - The target lane's key
+ */
+export declare const FlowchartStateMoveEventType: StructType<{
+    /** The moved state's key */
+    readonly key: StringType;
+    /** The target lane's key */
+    readonly lane: StringType;
+}>;
+/**
+ * Type representing state-move events.
+ */
+export type FlowchartStateMoveEventType = typeof FlowchartStateMoveEventType;
+/**
+ * Link-creation event — a completed drag-to-connect gesture.
+ *
+ * @remarks
+ * Handles are fixed per side, so the payload is purely topological: the
+ * source and target state keys. Vetoed pairs (`canConnect` returning
+ * false) never produce this event.
+ *
+ * @property from - Source state key (the out-handle the drag left)
+ * @property to - Target state key (the node the drag released on)
+ */
+export declare const FlowchartLinkCreateEventType: StructType<{
+    /** Source state key (the out-handle the drag left) */
+    readonly from: StringType;
+    /** Target state key (the node the drag released on) */
+    readonly to: StringType;
+}>;
+/**
+ * Type representing link-creation events.
+ */
+export type FlowchartLinkCreateEventType = typeof FlowchartLinkCreateEventType;
+//# sourceMappingURL=types.d.ts.map

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

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