@elaraai/east-ui 1.0.97 → 1.0.98

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

@@ -1,815 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
- */
-/**
- * `Schematic` — a 2D world-coordinate canvas for placing real-world
- * entities (tanks, bays, lines, nodes, cells) in space, plus annotation
- * zones (rooms, walkways) and key-addressed links, all from flat data
- * tables with chart-style field encodings. Interaction is opt-in per
- * channel (selection, camera, zone / link / net editing, item moves,
- * hover cards) — with nothing bound it is a read-only picture; appearance
- * belongs to the linked Library entry; position and live metrics are
- * owned here.
- *
- * @packageDocumentation
- */
-import { East, Expr, variant, some, none, ArrayType, BooleanType, FloatType, FunctionType, NullType, OptionType, StringType, StructType, } from "@elaraai/east";
-import { UIComponentType } from "../../component.js";
-import { mapRows } from "../../shared/reify.js";
-import { StatusTokenType } from "../../style/interaction.js";
-import {} from "../../display/icon/types.js";
-import { localSliceHandle, SliceBindType, SliceChromeType } from "../../platform/slice/index.js";
-import { SliceAffordanceType } from "../../contracts/slice-affordances.js";
-import { SchematicItemType, SchematicZoneType, SchematicLinkType, SchematicPointType, SchematicVertexType, SchematicGeometryType, SchematicZonePatternType, SchematicLinkStyleType, SchematicRouteType, SchematicToneType, SchematicEmphasisType, SchematicSliceEffectType, SchematicLayerType, SchematicSelectionModeType, SchematicRegionType, SchematicSelectionEventType, SchematicViewportEventType, SchematicZoneSelectionEventType, SchematicLinkModeType, SchematicLinkEndpointsType, SchematicLinkCreateEventType, SchematicLinkEditEventType, SchematicNetEndpointsType, SchematicNetType, SchematicItemMoveEventType, } from "./types.js";
-// Re-export types
-export { SchematicItemType, SchematicZoneType, SchematicLinkType, SchematicPointType, SchematicVertexType, SchematicGeometryType, SchematicZonePatternType, SchematicLinkStyleType, SchematicRouteType, SchematicToneType, SchematicEmphasisType, SchematicSliceEffectType, SchematicLayerType, SchematicSelectionModeType, SchematicRegionType, SchematicSelectionEventType, SchematicViewportEventType, SchematicZoneSelectionEventType, SchematicLinkModeType, SchematicLinkEndpointsType, SchematicLinkCreateEventType, SchematicLinkEditEventType, SchematicNetEndpointsType, SchematicNetType, SchematicItemMoveEventType, } from "./types.js";
-/**
- * East type for the Schematic root — the resolved mirror of the inline
- * `Schematic` struct in `component.ts` (which spells the three `*Hover`
- * fields with the recursion `node` where this mirror resolves them to
- * `UIComponentType`). Keep the two spellings in sync field-for-field.
- *
- * @remarks
- * Per-field docs live on {@link SchematicConfig}; events and collection
- * row types are documented in `./types.ts`.
- */
-export const SchematicRootType = StructType({
-    extent: StructType({ width: FloatType, height: FloatType }),
-    items: ArrayType(SchematicItemType),
-    zones: ArrayType(SchematicZoneType),
-    links: ArrayType(SchematicLinkType),
-    nets: ArrayType(SchematicNetType),
-    scaleUnit: OptionType(StringType),
-    grid: OptionType(BooleanType),
-    navigator: OptionType(BooleanType),
-    minimap: OptionType(BooleanType),
-    slice: OptionType(SliceChromeType),
-    sliceEffect: OptionType(SchematicSliceEffectType),
-    layers: OptionType(ArrayType(SchematicLayerType)),
-    height: OptionType(StringType),
-    maxHeight: OptionType(StringType),
-    onSelect: OptionType(FunctionType([StringType], NullType)),
-    selectionMode: OptionType(SchematicSelectionModeType),
-    onSelectionChange: OptionType(FunctionType([SchematicSelectionEventType], NullType)),
-    sliceSelectField: OptionType(StringType),
-    selectZoomFocus: OptionType(BooleanType),
-    onViewportChange: OptionType(FunctionType([SchematicViewportEventType], NullType)),
-    onItemOpen: OptionType(FunctionType([StringType], NullType)),
-    onSelectZone: OptionType(FunctionType([StringType], NullType)),
-    onZoneSelectionChange: OptionType(FunctionType([SchematicZoneSelectionEventType], NullType)),
-    linkMode: OptionType(SchematicLinkModeType),
-    onCreateLink: OptionType(FunctionType([SchematicLinkCreateEventType], NullType)),
-    onSelectLink: OptionType(FunctionType([StringType], NullType)),
-    onEditLink: OptionType(FunctionType([SchematicLinkEditEventType], NullType)),
-    onDeleteLink: OptionType(FunctionType([StringType], NullType)),
-    readOnly: OptionType(BooleanType),
-    readOnlyLinks: OptionType(BooleanType),
-    readOnlyItems: OptionType(BooleanType),
-    onMoveItem: OptionType(FunctionType([SchematicItemMoveEventType], NullType)),
-    itemHover: OptionType(FunctionType([StringType], UIComponentType)),
-    zoneHover: OptionType(FunctionType([StringType], UIComponentType)),
-    linkHover: OptionType(FunctionType([StringType], UIComponentType)),
-    onEditNet: OptionType(FunctionType([SchematicNetEndpointsType], NullType)),
-    canConnect: OptionType(FunctionType([StringType, StringType], BooleanType)),
-});
-function toneValue(tone) {
-    return tone !== undefined ? some(variant(tone, null)) : none;
-}
-/** Wrap an item/zone `tone` colour override into its option — accepts a string
- *  literal shorthand (`"brand"`) or an East tone expression / value. */
-function toneOption(tone) {
-    if (tone === undefined)
-        return none;
-    return typeof tone === "string" ? some(variant(tone, null)) : some(tone);
-}
-/**
- * Builds an `outline` zone pattern value — the dashed boundary with an
- * eyebrow label (rooms, cells).
- *
- * @param config - Optional style configuration (`tone`)
- * @returns A `SchematicZonePatternType` value
- */
-function outline(config) {
-    return variant("outline", { tone: toneValue(config?.tone) });
-}
-/**
- * Builds a `hatch` zone pattern value — the hatched band (walkways,
- * aisles, exclusion strips).
- *
- * @param config - Optional style configuration (`tone`, `spacing`, `angle`)
- * @returns A `SchematicZonePatternType` value
- */
-function hatch(config) {
-    return variant("hatch", {
-        tone: toneValue(config?.tone),
-        spacing: config?.spacing !== undefined ? some(config.spacing) : none,
-        angle: config?.angle !== undefined ? some(config.angle) : none,
-    });
-}
-/**
- * Builds a `solid` link style value — a physical run (pipe, conveyor).
- *
- * @param config - Optional stroke configuration (`tone`, `weight`)
- * @returns A `SchematicLinkStyleType` value
- */
-function solid(config) {
-    return variant("solid", {
-        tone: toneValue(config?.tone),
-        weight: config?.weight !== undefined ? some(config.weight) : none,
-    });
-}
-/**
- * Builds a `dashed` link style value — a routing / logical connection.
- *
- * @param config - Optional stroke configuration (`tone`, `weight`)
- * @returns A `SchematicLinkStyleType` value
- */
-function dashed(config) {
-    return variant("dashed", {
-        tone: toneValue(config?.tone),
-        weight: config?.weight !== undefined ? some(config.weight) : none,
-    });
-}
-/**
- * Normalise {@link SchematicVertices} into an East-coercible array of
- * {@link SchematicVertexType} — plain arrays get `bulge` defaulted to `0`,
- * East expressions pass through unchanged (they must already be vertices).
- */
-function toVertices(vertices) {
-    if (Array.isArray(vertices)) {
-        return vertices.map(v => ({
-            x: v.x,
-            y: v.y,
-            bulge: v.bulge !== undefined ? v.bulge : 0,
-        }));
-    }
-    return vertices;
-}
-/**
- * Builds a `rect` geometry value — the axis-aligned box. For zones this is
- * the `x/y/width/height` bounding box; for items, the point / marker form.
- * Equivalent to omitting `geometry` / `footprint`.
- *
- * @returns A `SchematicGeometryType` value
- */
-function rect() {
-    return East.value(variant("rect", null), SchematicGeometryType);
-}
-/**
- * Builds a `circle` geometry value — a circle centred on the entity anchor
- * (an item's `x/y`, or a zone's bounding-box centre). Models tanks, silos,
- * and round equipment without flattening to a polygon.
- *
- * @param radius - Circle radius in world units
- * @returns A `SchematicGeometryType` value
- */
-function circle(radius) {
-    return East.value(variant("circle", { radius }), SchematicGeometryType);
-}
-/**
- * Builds a `polyline` geometry value — an open, arc-aware polyline in world
- * coordinates, optionally widened into a band (a road / aisle / walkway).
- *
- * @param vertices - Vertices in world coords, in order (each `{ x, y, bulge? }`; `bulge` defaults to `0`)
- * @param config - Optional `width` band in world units
- * @returns A `SchematicGeometryType` value
- */
-function polyline(vertices, config) {
-    return East.value(variant("polyline", {
-        vertices: toVertices(vertices),
-        width: config?.width !== undefined ? some(config.width) : none,
-    }), SchematicGeometryType);
-}
-/**
- * Builds a `polygon` geometry value — a closed, arc-aware polygon in world
- * coordinates (a rotated / L-shaped zone, or an equipment footprint).
- *
- * @param vertices - Boundary vertices in world coords, in order (auto-closed; each `{ x, y, bulge? }`)
- * @returns A `SchematicGeometryType` value
- */
-function polygon(vertices) {
-    return East.value(variant("polygon", { vertices: toVertices(vertices) }), SchematicGeometryType);
-}
-/** Resolve a `sliceEmphasis` prop to its `option<Emphasis>` — a `"halo"` /
- *  `"pulse"` string is sugar for `some(variant(...))`; an East value is already
- *  the option (so it can be reactively `none` to turn the ring OFF). */
-function emphasisOption(emphasis) {
-    if (emphasis === undefined)
-        return none;
-    return typeof emphasis === "string" ? some(variant(emphasis, null)) : emphasis;
-}
-/** Build the East `SchematicLayer` value from the plain JS declaration. */
-function toLayer(l) {
-    return East.value({
-        key: l.key,
-        label: l.label,
-        visible: l.visible !== undefined ? some(l.visible) : none,
-        locked: l.locked !== undefined ? some(l.locked) : none,
-        opacity: l.opacity !== undefined ? some(l.opacity) : none,
-        tone: toneValue(l.tone),
-    }, SchematicLayerType);
-}
-function buildRoot(items, config) {
-    const itemMapper = config.item;
-    const resolvedItems = itemMapper === undefined
-        ? East.value(items, ArrayType(SchematicItemType))
-        : mapRows(East.value(items), SchematicItemType, (row) => {
-            const r = itemMapper(row);
-            if (r instanceof Expr)
-                return East.value(r, SchematicItemType);
-            return East.value({
-                key: r.key,
-                x: r.x,
-                y: r.y,
-                label: r.label,
-                sublabel: r.sublabel !== undefined ? some(r.sublabel) : none,
-                icon: r.icon !== undefined ? some(r.icon) : none,
-                status: r.status !== undefined ? r.status : none,
-                meter: r.meter !== undefined
-                    ? some(East.value({ value: r.meter.value, max: r.meter.max }, StructType({ value: FloatType, max: FloatType })))
-                    : none,
-                metric: r.metric !== undefined ? some(r.metric) : none,
-                width: r.width !== undefined ? some(r.width) : none,
-                footprint: r.footprint !== undefined ? some(r.footprint) : none,
-                tone: toneOption(r.tone),
-                color: r.color !== undefined ? some(r.color) : none,
-                bg: r.bg !== undefined ? some(r.bg) : none,
-                fillOpacity: r.fillOpacity !== undefined ? some(r.fillOpacity) : none,
-                weight: r.weight !== undefined ? some(r.weight) : none,
-                excluded: r.excluded !== undefined ? some(r.excluded) : none,
-                layer: r.layer !== undefined ? some(r.layer) : none,
-            }, SchematicItemType);
-        });
-    const zoneMapper = config.zone;
-    const resolvedZones = config.zones === undefined
-        ? East.value([], ArrayType(SchematicZoneType))
-        : zoneMapper === undefined
-            ? East.value(config.zones, ArrayType(SchematicZoneType))
-            : mapRows(East.value(config.zones), SchematicZoneType, (row) => {
-                const r = zoneMapper(row);
-                if (r instanceof Expr)
-                    return East.value(r, SchematicZoneType);
-                return East.value({
-                    key: r.key,
-                    label: r.label,
-                    x: r.x,
-                    y: r.y,
-                    width: r.width,
-                    height: r.height,
-                    pattern: r.pattern !== undefined
-                        ? r.pattern
-                        : East.value(outline(), SchematicZonePatternType),
-                    geometry: r.geometry !== undefined ? some(r.geometry) : none,
-                    tone: toneOption(r.tone),
-                    color: r.color !== undefined ? some(r.color) : none,
-                    bg: r.bg !== undefined ? some(r.bg) : none,
-                    fillOpacity: r.fillOpacity !== undefined ? some(r.fillOpacity) : none,
-                    weight: r.weight !== undefined ? some(r.weight) : none,
-                    layer: r.layer !== undefined ? some(r.layer) : none,
-                }, SchematicZoneType);
-            });
-    const linkMapper = config.link;
-    const resolvedLinks = config.links === undefined
-        ? East.value([], ArrayType(SchematicLinkType))
-        : linkMapper === undefined
-            ? East.value(config.links, ArrayType(SchematicLinkType))
-            : mapRows(East.value(config.links), SchematicLinkType, (row) => {
-                const r = linkMapper(row);
-                if (r instanceof Expr)
-                    return East.value(r, SchematicLinkType);
-                return East.value({
-                    key: r.key,
-                    from: r.from,
-                    to: r.to,
-                    label: r.label !== undefined ? some(r.label) : none,
-                    metric: r.metric !== undefined ? some(r.metric) : none,
-                    style: r.style !== undefined
-                        ? r.style
-                        : East.value(solid(), SchematicLinkStyleType),
-                    route: r.route !== undefined
-                        ? r.route
-                        : East.value(variant("orthogonal", { corner: none }), SchematicRouteType),
-                    via: r.via !== undefined
-                        ? East.value(r.via, ArrayType(SchematicPointType))
-                        : East.value([], ArrayType(SchematicPointType)),
-                    layer: r.layer !== undefined ? some(r.layer) : none,
-                }, SchematicLinkType);
-            });
-    const netMapper = config.net;
-    const resolvedNets = config.nets === undefined
-        ? East.value([], ArrayType(SchematicNetType))
-        : netMapper === undefined
-            ? East.value(config.nets, ArrayType(SchematicNetType))
-            : mapRows(East.value(config.nets), SchematicNetType, (row) => {
-                const r = netMapper(row);
-                return East.value({
-                    key: r.key,
-                    sources: East.value(r.sources, ArrayType(StringType)),
-                    destinations: East.value(r.destinations, ArrayType(StringType)),
-                    label: r.label !== undefined ? some(r.label) : none,
-                    metric: r.metric !== undefined ? some(r.metric) : none,
-                    style: r.style !== undefined
-                        ? r.style
-                        : East.value(solid(), SchematicLinkStyleType),
-                    route: r.route !== undefined
-                        ? r.route
-                        : East.value(variant("orthogonal", { corner: none }), SchematicRouteType),
-                    via: r.via !== undefined
-                        ? East.value(r.via, ArrayType(SchematicPointType))
-                        : East.value([], ArrayType(SchematicPointType)),
-                    layer: r.layer !== undefined ? some(r.layer) : none,
-                }, SchematicNetType);
-            });
-    if (config.affordances?.includes("brush")) {
-        throw new Error("Schematic does not support the 'brush' affordance — its 2D canvas has no continuous 1D axis.");
-    }
-    const sliceChromeValue = config.slice !== undefined
-        ? East.value({
-            slice: localSliceHandle(config.slice),
-            affordances: East.value((config.affordances ?? ["search"]).map(a => variant(a, null)), ArrayType(SliceAffordanceType)),
-        }, SliceChromeType)
-        : undefined;
-    return East.value(variant("Schematic", {
-        extent: { width: config.extent.width, height: config.extent.height },
-        items: resolvedItems,
-        zones: resolvedZones,
-        links: resolvedLinks,
-        nets: resolvedNets,
-        scaleUnit: config.scaleUnit !== undefined ? some(config.scaleUnit) : none,
-        grid: config.grid !== undefined ? some(config.grid) : none,
-        navigator: config.navigator !== undefined ? some(config.navigator) : none,
-        minimap: config.minimap !== undefined ? some(config.minimap) : none,
-        slice: sliceChromeValue ? some(sliceChromeValue) : none,
-        // Flat slice-effect props → the flat effect struct (each field static or
-        // reactive via its `SubtypeExprOrValue`); `some` only when any is set.
-        sliceEffect: (config.sliceHidden ?? config.sliceOpacity ?? config.sliceDesaturate
-            ?? config.sliceDot ?? config.sliceEmphasis ?? config.sliceFrame ?? config.sliceFrameFit) !== undefined
-            ? some(East.value({
-                hidden: config.sliceHidden !== undefined ? some(config.sliceHidden) : none,
-                opacity: config.sliceOpacity !== undefined ? some(config.sliceOpacity) : none,
-                desaturate: config.sliceDesaturate !== undefined ? some(config.sliceDesaturate) : none,
-                dot: config.sliceDot !== undefined ? some(config.sliceDot) : none,
-                emphasis: emphasisOption(config.sliceEmphasis),
-                frame: config.sliceFrame !== undefined ? some(config.sliceFrame) : none,
-                frameFit: config.sliceFrameFit !== undefined ? some(config.sliceFrameFit) : none,
-            }, SchematicSliceEffectType))
-            : none,
-        layers: config.layers !== undefined
-            ? some(East.value(config.layers.map(toLayer), ArrayType(SchematicLayerType)))
-            : none,
-        height: config.height !== undefined ? some(config.height) : none,
-        maxHeight: config.maxHeight !== undefined ? some(config.maxHeight) : none,
-        onSelect: config.onSelect !== undefined ? some(config.onSelect) : none,
-        selectionMode: config.selectionMode !== undefined
-            ? some(typeof config.selectionMode === "string" ? variant(config.selectionMode, null) : config.selectionMode)
-            : none,
-        onSelectionChange: config.onSelectionChange !== undefined ? some(config.onSelectionChange) : none,
-        sliceSelectField: config.sliceSelectField !== undefined ? some(config.sliceSelectField) : none,
-        selectZoomFocus: config.selectZoomFocus !== undefined ? some(config.selectZoomFocus) : none,
-        onViewportChange: config.onViewportChange !== undefined ? some(config.onViewportChange) : none,
-        onItemOpen: config.onItemOpen !== undefined ? some(config.onItemOpen) : none,
-        onSelectZone: config.onSelectZone !== undefined ? some(config.onSelectZone) : none,
-        onZoneSelectionChange: config.onZoneSelectionChange !== undefined ? some(config.onZoneSelectionChange) : 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,
-        onSelectLink: config.onSelectLink !== undefined ? some(config.onSelectLink) : none,
-        onEditLink: config.onEditLink !== undefined ? some(config.onEditLink) : none,
-        onDeleteLink: config.onDeleteLink !== undefined ? some(config.onDeleteLink) : none,
-        readOnly: config.readOnly !== undefined ? some(config.readOnly) : none,
-        readOnlyLinks: config.readOnlyLinks !== undefined ? some(config.readOnlyLinks) : none,
-        readOnlyItems: config.readOnlyItems !== undefined ? some(config.readOnlyItems) : none,
-        onMoveItem: config.onMoveItem !== undefined ? some(config.onMoveItem) : none,
-        itemHover: config.itemHover !== undefined ? some(East.value(config.itemHover, FunctionType([StringType], UIComponentType))) : none,
-        zoneHover: config.zoneHover !== undefined ? some(East.value(config.zoneHover, FunctionType([StringType], UIComponentType))) : none,
-        linkHover: config.linkHover !== undefined ? some(East.value(config.linkHover, FunctionType([StringType], UIComponentType))) : none,
-        onEditNet: config.onEditNet !== undefined ? some(config.onEditNet) : none,
-        canConnect: config.canConnect !== undefined ? some(config.canConnect) : none,
-    }), UIComponentType);
-}
-/**
- * Creates a Schematic — a read-only 2D world-coordinate canvas.
- *
- * @typeParam I - The items-table input
- * @typeParam Z - The zones-table input
- * @typeParam L - The links-table input
- * @param items - The placed-item rows
- * @param config - The Schematic configuration ({@link SchematicConfig})
- * @returns An East expression of `UIComponentType`
- *
- * @example
- * ```ts
- * import { East, variant } from "@elaraai/east";
- * import { Schematic, UIComponentType } from "@elaraai/east-ui";
- *
- * const example = East.function([], UIComponentType, _$ =>
- *     Schematic.Root(
- *         [{ id: "UNIT-04", x: 3.0, y: 2.0, kind: "unit", fill: 28.8, cap: 40.0 }],
- *         {
- *             extent: { width: 30, height: 12 },
- *             item: e => ({
- *                 key: e.id, x: e.x, y: e.y, label: e.id,
- *                 sublabel: e.kind,
- *                 meter: { value: e.fill, max: e.cap },
- *             }),
- *         },
- *     ),
- * );
- * ```
- */
-function createSchematic(items, config) {
-    return buildRoot(items, config);
-}
-// ============================================================================
-// Namespace export
-// ============================================================================
-/**
- * Schematic component namespace.
- *
- * @remarks
- * `Schematic.Root(items, config)` builds the canvas from up to three flat
- * tables (items, zones, links); closed-set fields in data (`status`,
- * `pattern`, `style`) are typed variant values (`Schematic.Types.*`).
- */
-export const Schematic = {
-    /**
-     * Creates a Schematic — a read-only 2D world-coordinate canvas.
-     *
-     * @typeParam I - The items-table input
-     * @typeParam Z - The zones-table input
-     * @typeParam L - The links-table input
-     * @param items - The placed-item rows
-     * @param config - The Schematic configuration ({@link SchematicConfig})
-     * @returns An East expression of `UIComponentType`
-     *
-     * @remarks
-     * Links address endpoints by item key, so they survive repositioning;
-     * `via` waypoints route around zones. A walkway band is a zone with
-     * `pattern: variant("hatch", null)`.
-     *
-     * @example
-     * ```ts
-     * import { East } from "@elaraai/east";
-     * import { Schematic, UIComponentType } from "@elaraai/east-ui";
-     *
-     * const example = East.function([], UIComponentType, _$ =>
-     *     Schematic.Root(
-     *         [{ id: "UNIT-04", x: 3.0, y: 2.0 }],
-     *         {
-     *             extent: { width: 30, height: 12 },
-     *             item: e => ({ key: e.id, x: e.x, y: e.y, label: e.id }),
-     *         },
-     *     ),
-     * );
-     * ```
-     */
-    Root: createSchematic,
-    /**
-     * Builds an `outline` zone pattern value — the dashed boundary with an
-     * eyebrow label.
-     *
-     * @param config - Optional style configuration (`tone`)
-     * @returns A `SchematicZonePatternType` value
-     *
-     * @example
-     * ```ts
-     * Schematic.outline({ tone: "ink" })
-     * ```
-     */
-    outline,
-    /**
-     * Builds a `hatch` zone pattern value — the hatched band.
-     *
-     * @param config - Optional style configuration (`tone`, `spacing`, `angle`)
-     * @returns A `SchematicZonePatternType` value
-     *
-     * @example
-     * ```ts
-     * Schematic.hatch({ spacing: 10, angle: 45 })
-     * ```
-     */
-    hatch,
-    /**
-     * Builds a `solid` link style value — a physical run.
-     *
-     * @param config - Optional stroke configuration (`tone`, `weight`)
-     * @returns A `SchematicLinkStyleType` value
-     *
-     * @example
-     * ```ts
-     * Schematic.solid({ tone: "brand", weight: 3 })
-     * ```
-     */
-    solid,
-    /**
-     * Builds a `dashed` link style value — a routing / logical connection.
-     *
-     * @param config - Optional stroke configuration (`tone`, `weight`)
-     * @returns A `SchematicLinkStyleType` value
-     *
-     * @example
-     * ```ts
-     * Schematic.dashed({ tone: "muted" })
-     * ```
-     */
-    dashed,
-    /**
-     * Builds a `rect` geometry value — the axis-aligned box (a zone's
-     * `x/y/width/height`, or an item's point / marker form). Equals omitting
-     * `geometry` / `footprint`.
-     *
-     * @returns A `SchematicGeometryType` value
-     *
-     * @example
-     * ```ts
-     * Schematic.rect()
-     * ```
-     */
-    rect,
-    /**
-     * Builds a `circle` geometry value — a circle centred on the entity
-     * anchor (an item's `x/y`, or a zone's bbox centre). Models tanks, silos,
-     * and round equipment.
-     *
-     * @param radius - Circle radius in world units
-     * @returns A `SchematicGeometryType` value
-     *
-     * @example
-     * ```ts
-     * Schematic.circle(2.5)
-     * ```
-     */
-    circle,
-    /**
-     * Builds a `polyline` geometry value — an open, arc-aware polyline in
-     * world coordinates, optionally widened into a band (a road / aisle).
-     * Each vertex's `bulge` curves the edge to the next vertex (0 = straight).
-     *
-     * @param vertices - Vertices in world coords, in order (`{ x, y, bulge? }`)
-     * @param config - Optional `width` band in world units
-     * @returns A `SchematicGeometryType` value
-     *
-     * @example
-     * ```ts
-     * Schematic.polyline([{ x: 0, y: 4 }, { x: 12, y: 4, bulge: 0.42 }, { x: 12, y: 9 }], { width: 1.6 })
-     * ```
-     */
-    polyline,
-    /**
-     * Builds a `polygon` geometry value — a closed, arc-aware polygon in
-     * world coordinates (a rotated / L-shaped zone, or an equipment
-     * footprint). The last vertex's `bulge` curves the closing edge.
-     *
-     * @param vertices - Boundary vertices in world coords, in order (auto-closed; `{ x, y, bulge? }`)
-     * @returns A `SchematicGeometryType` value
-     *
-     * @example
-     * ```ts
-     * Schematic.polygon([{ x: 2, y: 2 }, { x: 7, y: 3 }, { x: 6, y: 8 }, { x: 1, y: 6 }])
-     * ```
-     */
-    polygon,
-    Types: {
-        /**
-         * East StructType for the Schematic component.
-         *
-         * @remarks
-         * See {@link SchematicRootType} for per-field docs.
-         *
-         * @property extent - World-coordinate bounds
-         * @property items - The placed items
-         * @property zones - Annotation zones
-         * @property links - Connections between items
-         * @property scaleUnit - Optional scale-bar unit
-         * @property onSelect - Optional item-click callback
-         */
-        Schematic: SchematicRootType,
-        /**
-         * A resolved placed item.
-         *
-         * @property key - Item identity
-         * @property x - World x of the card centre
-         * @property y - World y of the card centre
-         * @property label - Primary identity line
-         * @property sublabel - Optional muted second line
-         * @property icon - Optional Font Awesome solid icon name
-         * @property status - Optional status dot tone
-         * @property meter - Optional mini utilisation bar
-         * @property metric - Optional live metric text
-         * @property width - Optional world width (wide bar form)
-         * @property footprint - Optional shape footprint (point + icon when absent)
-         */
-        Item: SchematicItemType,
-        /**
-         * A resolved annotation zone.
-         *
-         * @property key - Zone identity
-         * @property label - Eyebrow label
-         * @property x - World x (top-left)
-         * @property y - World y (top-left)
-         * @property width - World width
-         * @property height - World height
-         * @property pattern - Render pattern
-         * @property geometry - Optional shape geometry (rect when absent)
-         */
-        Zone: SchematicZoneType,
-        /**
-         * A resolved link between items.
-         *
-         * @property key - Link identity
-         * @property from - Source item key
-         * @property to - Destination item key
-         * @property style - Render style
-         * @property via - Waypoints, in order
-         */
-        Link: SchematicLinkType,
-        /**
-         * Zone render pattern (`outline` / `hatch`).
-         *
-         * @property outline - Dashed boundary with an eyebrow label
-         * @property hatch - Hatched band
-         */
-        ZonePattern: SchematicZonePatternType,
-        /**
-         * Link render style (`solid` / `dashed`), each carrying stroke config.
-         *
-         * @property solid - A physical run
-         * @property dashed - A routing / logical connection
-         */
-        LinkStyle: SchematicLinkStyleType,
-        /**
-         * Link routing mode (`orthogonal` / `direct`).
-         *
-         * @property orthogonal - Axis-aligned with rounded corners
-         * @property direct - Straight segments between anchors
-         */
-        Route: SchematicRouteType,
-        /**
-         * Theme tone for zone strokes, hatching, and links.
-         *
-         * @property brand - Brand teal
-         * @property ink - Foreground ink
-         * @property muted - Muted foreground
-         * @property success - Status ok
-         * @property warning - Status warn
-         * @property danger - Status bad
-         */
-        Tone: SchematicToneType,
-        /**
-         * Shared shape geometry for zones (`geometry`) and item footprints
-         * (`footprint`).
-         *
-         * @property rect - Axis-aligned box
-         * @property circle - Circle centred on the entity anchor (`radius` in world units)
-         * @property polyline - Open, arc-aware polyline; optional world-space band width
-         * @property polygon - Closed, arc-aware polygon (>= 3 vertices)
-         */
-        Geometry: SchematicGeometryType,
-        /**
-         * A polyline / polygon vertex — a world point plus DXF `bulge`.
-         *
-         * @property x - World x
-         * @property y - World y
-         * @property bulge - DXF bulge for the edge to the next vertex (0 = straight)
-         */
-        Vertex: SchematicVertexType,
-        /**
-         * A named layer — a toggleable group of items / zones / links.
-         *
-         * @property key - Layer identity (entities reference it via `layer`)
-         * @property label - Panel display name
-         * @property visible - Author default visibility
-         * @property locked - Author default lock (non-selectable)
-         * @property opacity - Item dim (0–1)
-         * @property tone - Panel swatch tone
-         */
-        Layer: SchematicLayerType,
-        /**
-         * The flat slice-driven render effect struct (mirrors the `slice*` props).
-         */
-        SliceEffect: SchematicSliceEffectType,
-        /**
-         * Matched-item emphasis (`halo` / `pulse`) — annotate `State` with it to
-         * drive `sliceEmphasis` reactively.
-         */
-        Emphasis: SchematicEmphasisType,
-        /**
-         * Selection cardinality (`single` / `multiple` / `range`) — drive
-         * `selectionMode` reactively or read it back.
-         */
-        SelectionMode: SchematicSelectionModeType,
-        /**
-         * A world-coordinate rectangle swept by a marquee gesture.
-         *
-         * @property minX - Left edge (world units)
-         * @property minY - Top edge (world units)
-         * @property maxX - Right edge (world units)
-         * @property maxY - Bottom edge (world units)
-         */
-        Region: SchematicRegionType,
-        /**
-         * Selection-set change event passed to `onSelectionChange`.
-         *
-         * @property key - The item that triggered the change (some for a tap; none for marquee / clear)
-         * @property selected - Whether `key` is now selected; for bulk changes, whether the set is non-empty
-         * @property selectedKeys - The full selected set after the gesture
-         * @property additive - Whether the gesture added to the prior selection vs replaced it
-         * @property region - The world rectangle a marquee swept (some for a marquee; none otherwise)
-         */
-        SelectionEvent: SchematicSelectionEventType,
-        /**
-         * Viewport-settled event passed to `onViewportChange` — the camera zoom
-         * plus the visible world rectangle, debounced to gesture settle points.
-         *
-         * @property zoom - The settled camera zoom (1 = fully zoomed out)
-         * @property minX - Left edge of the visible world rect
-         * @property minY - Top edge of the visible world rect
-         * @property maxX - Right edge of the visible world rect
-         * @property maxY - Bottom edge of the visible world rect
-         */
-        ViewportEvent: SchematicViewportEventType,
-        /**
-         * Zone selection-set change event passed to `onZoneSelectionChange` —
-         * the selected zones plus the item keys inside them.
-         *
-         * @property key - The zone that triggered the change (some for a tap; none for a clear)
-         * @property selected - Whether `key` is now selected; for bulk changes, whether the set is non-empty
-         * @property selectedKeys - The full selected zone set after the gesture
-         * @property childItemKeys - Item keys inside the selected zones (nested descendants included)
-         * @property additive - Whether the gesture added to the prior selection vs replaced it
-         */
-        ZoneSelectionEvent: SchematicZoneSelectionEventType,
-        /**
-         * Connect-gesture mode (`draw` | `connect`) — `draw` adds a physical
-         * link locally; `connect` is event-only and repeatable.
-         */
-        LinkMode: SchematicLinkModeType,
-        /**
-         * One connection's endpoints — the unit a connect gesture produces.
-         *
-         * @property key - Renderer-generated key for the gesture's connection
-         * @property from - Source item key
-         * @property to - Destination item key
-         */
-        LinkEndpoints: SchematicLinkEndpointsType,
-        /**
-         * Link-creation event passed to `onCreateLink` — the newest link, the
-         * accumulated Shift-session, and the pair's existing links.
-         *
-         * @property link - The newest connection (this drag)
-         * @property links - The full session set, `link` included
-         * @property additive - True when Shift extended an open session
-         * @property existing - Keys of links already joining the newest pair
-         */
-        LinkCreateEvent: SchematicLinkCreateEventType,
-        /**
-         * Link-edit event passed to `onEditLink` — the endpoints AFTER an
-         * endpoint connector re-target.
-         *
-         * @property key - The edited link's key
-         * @property from - Source item key after the edit
-         * @property to - Destination item key after the edit
-         */
-        LinkEditEvent: SchematicLinkEditEventType,
-        /**
-         * A net — a manifold / bus link (many `sources` → many `destinations`,
-         * drawn as a trunk with branches).
-         *
-         * @property key - Net identity
-         * @property sources - Source item keys
-         * @property destinations - Destination item keys
-         * @property label - Optional mid-trunk label
-         * @property metric - Optional mid-trunk metric (muted)
-         * @property style - Stroke style for the whole net
-         * @property route - Trunk routing mode
-         * @property via - Optional trunk waypoints
-         * @property layer - Optional layer membership
-         */
-        Net: SchematicNetType,
-        /**
-         * A connect-session collapsed to net endpoints (stable session `key`)
-         * — carried on every `onCreateLink` for upsert-style handlers.
-         *
-         * @property key - The session key (stable across the session's commits)
-         * @property sources - Distinct source item keys so far
-         * @property destinations - Distinct destination item keys so far
-         */
-        NetEndpoints: SchematicNetEndpointsType,
-        /**
-         * Item-move event passed to `onMoveItem` — the pressed item's final
-         * position, every moved key (group move rides the selection), and the
-         * shared world delta.
-         *
-         * @property key - The pressed item's key
-         * @property x - Final world x
-         * @property y - Final world y
-         * @property keys - Every moved item (`key` included)
-         * @property dx - Shared world x delta
-         * @property dy - Shared world y delta
-         */
-        ItemMoveEvent: SchematicItemMoveEventType,
-    },
-};
-//# sourceMappingURL=index.js.map