@graview/react 0.1.0

package/dist/scene-hand.js

@@ -0,0 +1,317 @@
+import { withOverview, withPan, withPin } from "@graview/layout";
+import { useCallback, useEffect, useLayoutEffect, useRef, useState } from "react";
+/**
+ * THE DISTRICT UNDER THE HAND, placed in the scene while it is dragged —
+ * at most once a frame, since pointer events arrive faster than frames are
+ * drawn — and handed back on release to be written into the view once.
+ */
+export function useHeldDistrict() {
+    const [held, setHeld] = useState(null);
+    const placing = useRef(null);
+    const frame = useRef(0);
+    const place = useCallback((next) => {
+        placing.current = next;
+        if (frame.current !== 0)
+            return;
+        frame.current = requestAnimationFrame(() => {
+            frame.current = 0;
+            setHeld(placing.current);
+        });
+    }, []);
+    /** Letting go: where the hand last put it, if it put it anywhere. */
+    const release = useCallback(() => {
+        if (frame.current !== 0)
+            cancelAnimationFrame(frame.current);
+        frame.current = 0;
+        const put = placing.current;
+        placing.current = null;
+        if (put)
+            setHeld(null);
+        return put;
+    }, []);
+    return { held, place, release };
+}
+/**
+ * THE HAND MOVES THE PICTURE; ONLY LETTING GO MOVES THE WORLD.
+ *
+ * While a hand is on it, the offset it has made is painted straight onto
+ * the world's layers as a transform, once per animation frame, outside
+ * React entirely. Letting go writes it into the view as a pan, and the
+ * transform is cleared once that has been committed, so the picture never
+ * jumps back for a frame. `settled` is told when the gesture is over — the
+ * world already where the hand left it, so nothing tweens its way there.
+ *
+ * The GPU path keeps the old road: its stage is a `layoutsubtree` canvas,
+ * and combining that with CSS transforms crashes the renderer. It is not
+ * the default path and it is not the measured one.
+ */
+export function useWorldShift({ stage, pan, setView, settled, }) {
+    const live = useRef({ x: 0, y: 0 });
+    const painting = useRef(0);
+    const settling = useRef(false);
+    const settledLive = useRef(settled);
+    settledLive.current = settled;
+    const layers = useCallback(() => [...(stage.current?.querySelectorAll("[data-graview-world]") ?? [])], [stage]);
+    const paint = useCallback(() => {
+        if (painting.current !== 0)
+            return;
+        painting.current = requestAnimationFrame(() => {
+            painting.current = 0;
+            const { x, y } = live.current;
+            const move = x === 0 && y === 0 ? "" : `translate3d(${x}px, ${y}px, 0)`;
+            for (const layer of layers())
+                layer.style.transform = move;
+        });
+    }, [layers]);
+    const clear = useCallback(() => {
+        settling.current = false;
+        for (const layer of layers())
+            layer.style.transform = "";
+        settledLive.current();
+    }, [layers]);
+    /** Where the hand has taken the picture, against where the view says it is. */
+    const shiftTo = useCallback((wanted, from) => {
+        live.current = { x: wanted.x - from.x, y: wanted.y - from.y };
+        paint();
+    }, [paint]);
+    /** Letting go: the offset becomes the view's own pan. False when there was none. */
+    const settle = useCallback(() => {
+        const { x, y } = live.current;
+        if (x === 0 && y === 0)
+            return false;
+        live.current = { x: 0, y: 0 };
+        settling.current = true;
+        setView((current) => {
+            const at = current.pan ?? { x: 0, y: 0 };
+            return withPan(current, { x: at.x + x, y: at.y + y });
+        });
+        /*
+         * AND IF THE VIEW NEVER ARRIVES, LET GO ANYWAY. A scene whose view is
+         * controlled from outside may decline the change, and then nothing
+         * would clear the transform. LATE ON PURPOSE: a `requestAnimationFrame`
+         * here beat React to the commit, and every release flashed the whole
+         * city back to where the drag had started for one frame.
+         */
+        window.setTimeout(() => {
+            if (settling.current)
+                clear();
+        }, 300);
+        return true;
+    }, [setView, clear]);
+    /*
+     * CLEARED ONLY ONCE THE WORLD HAS ACTUALLY MOVED. Clearing the transform
+     * in the same breath as the state change put the picture back where it
+     * started for one frame, because React had not committed the new pan yet.
+     */
+    useLayoutEffect(() => {
+        if (settling.current)
+            clear();
+    }, [pan, clear]);
+    /** The offset the hand has made so far, not yet in the view. */
+    const offset = useCallback(() => live.current, []);
+    return { shiftTo, settle, settling, offset };
+}
+/** How far a pointer has to travel before a press is a drag: below it, a click is a click. */
+const DRAG_THRESHOLD = 4;
+/**
+ * THE GESTURES THEMSELVES. The threshold is what keeps a click a click:
+ * below it nothing has happened and the pointer-up is an ordinary
+ * selection; above it the gesture owns the pointer and the click that
+ * follows is swallowed.
+ */
+export function useSceneDrag({ view, panned, limit, panWithin, moveByTransform, setView, setDragging, noteMoved, shift, district, }) {
+    /** Set for the click a drag is about to produce, so a drag that ends on a card does not also select it. */
+    const swallow = useRef(false);
+    const gesture = useRef(null);
+    const panFrom = (event) => {
+        const pan = view.pan ?? { x: 0, y: 0 };
+        gesture.current = { kind: "pan", fromX: event.clientX, fromY: event.clientY, baseX: pan.x, baseY: pan.y, moved: false };
+    };
+    const onGroundDown = (event) => {
+        if (event.button !== 0)
+            return;
+        // Only the ground itself. A card, a chip or anything a view drew keeps
+        // whatever meaning it already had.
+        if (event.target.closest("[data-graview-view]"))
+            return;
+        panFrom(event);
+    };
+    const onCardDown = (node, event) => {
+        if (event.button !== 0)
+            return;
+        /*
+         * A PICTURE IS NOT A THING YOU REARRANGE — you look around it. A drag
+         * that starts on a billboard moves the view, unless it started on the
+         * rail, which is the one part of a billboard that means "move the
+         * board". A district's own card keeps its drag, because placing a
+         * district by hand is a real gesture with a dashed kerb to show for it.
+         */
+        if (node.screenOf !== undefined && !event.target.closest("[data-graview-grip]")) {
+            panFrom(event);
+            return;
+        }
+        gesture.current = {
+            kind: "card",
+            id: node.id,
+            fromX: event.clientX,
+            fromY: event.clientY,
+            // Unpanned, because that is the space a pin is stored in.
+            baseX: node.x - panned.x,
+            baseY: node.y - panned.y,
+            moved: false,
+        };
+    };
+    const onDragMove = (event) => {
+        const drag = gesture.current;
+        if (!drag)
+            return;
+        const dx = event.clientX - drag.fromX;
+        const dy = event.clientY - drag.fromY;
+        if (!drag.moved) {
+            if (Math.hypot(dx, dy) < DRAG_THRESHOLD)
+                return;
+            drag.moved = true;
+            setDragging(true);
+            /*
+             * Capture only once it IS a drag. Taken on pointer-down it redirected
+             * the click and double-click that followed to the host, and
+             * double-clicking a task opened the card instead of travelling into it.
+             */
+            event.currentTarget.setPointerCapture(event.pointerId);
+        }
+        if (drag.kind === "pan") {
+            // A little way over a picture that fits, and as far as the city reaches when it is bigger.
+            const wanted = panWithin(limit(), { x: drag.baseX + dx, y: drag.baseY + dy });
+            if (moveByTransform)
+                shift.shiftTo(wanted, view.pan ?? { x: 0, y: 0 });
+            else
+                setView((current) => withPan(current, wanted));
+        }
+        else if (drag.id) {
+            district.place({ id: drag.id, x: drag.baseX + dx, y: drag.baseY + dy });
+        }
+    };
+    const onDragUp = () => {
+        shift.settle();
+        // The district that was under the hand goes into the view, once, where the hand last put it.
+        const put = district.release();
+        if (put)
+            setView((current) => withPin(current, put.id, { x: put.x, y: put.y }));
+        if (gesture.current?.moved) {
+            swallow.current = true;
+            setTimeout(() => (swallow.current = false), 0);
+            // And say a hand moved something, so the bar can offer to put it back.
+            noteMoved();
+        }
+        gesture.current = null;
+        /*
+         * THE COMMIT A HAND MADE IS NOT A TRANSITION EITHER. The drag stays open
+         * until the pan it made has been drawn — the world shift closes it, in
+         * the same commit that moves the cards — or the whole city would fly
+         * from where the drag started to where it ended, after the hand had
+         * already put it there.
+         */
+        if (shift.settling.current)
+            return;
+        setDragging(false);
+    };
+    return { onGroundDown, onCardDown, onDragMove, onDragUp, swallow };
+}
+/**
+ * THE WHEEL AND THE PINCH. `zoomAbout` and `panBy` are filled in by the
+ * scene once it knows its city; the listeners call through them, so they
+ * are attached once rather than on every zoom.
+ */
+export function useWheelAndPinch({ stage, view, setView, }) {
+    /*
+     * PINCH IS ALTITUDE. The camera has one axis, so the universal zoom
+     * gesture maps to it: fingers together rises to the Graview, fingers
+     * apart descends — one discrete step per gesture, with a cooldown so a
+     * long pinch does not bounce. Chromium and Firefox hand a trackpad
+     * pinch over as ctrl+wheel; Safari speaks GestureEvent. Both are
+     * claimed here so the browser's own page zoom never fires on the scene.
+     */
+    const altitude = useRef({ view, charge: 0, coolUntil: 0, lastScale: 1 });
+    altitude.current.view = view;
+    /*
+     * FROM ALTITUDE, PINCH AND CTRL+WHEEL ZOOM THE CITY — continuously, about
+     * the pointer, the way every map does — and the plain wheel pans the
+     * ground. Stepping the altitude once per gesture with a cooldown read as
+     * a zoom that sticks. From the ground, fingers together still rise: the
+     * way up is a gesture, the way down is the picture's own control.
+     */
+    const zoomAbout = useRef(() => { });
+    const panBy = useRef(() => { });
+    useEffect(() => {
+        const element = stage.current;
+        if (!element)
+            return;
+        const step = (rising, stamp) => {
+            const held = altitude.current;
+            if (stamp < held.coolUntil)
+                return;
+            const up = held.view.overview ?? false;
+            if (rising === up)
+                return;
+            held.coolUntil = stamp + 600;
+            held.charge = 0;
+            setView(withOverview(held.view, rising));
+        };
+        const onWheel = (event) => {
+            const held = altitude.current;
+            const up = held.view.overview ?? false;
+            if (event.ctrlKey) {
+                event.preventDefault();
+                if (!up) {
+                    held.charge += event.deltaY;
+                    if (Math.abs(held.charge) < 60)
+                        return;
+                    if (held.charge > 0)
+                        step(true, performance.now());
+                    else
+                        held.charge = 0;
+                    return;
+                }
+                // A mouse notch (a hundred) is a step and a half; a trackpad's few units are a nudge.
+                zoomAbout.current(Math.exp(-event.deltaY * 0.004), event.clientX, event.clientY);
+                return;
+            }
+            if (!up)
+                return;
+            // Over the ground only: a lens, a scroll region or a pane keeps its own wheel.
+            const target = event.target;
+            if (target?.closest("[data-graview-view], .graview-scroll, [data-graview-overlay], .graview-zoom"))
+                return;
+            event.preventDefault();
+            panBy.current(-event.deltaX, -event.deltaY);
+        };
+        const onGestureStart = (event) => {
+            event.preventDefault();
+            altitude.current.lastScale = 1;
+        };
+        const onGesture = (event) => {
+            event.preventDefault();
+            const held = altitude.current;
+            const scale = event.scale ?? 1;
+            if (!(held.view.overview ?? false)) {
+                if (scale < 0.72)
+                    step(true, performance.now());
+                return;
+            }
+            const ratio = scale / (held.lastScale || 1);
+            held.lastScale = scale;
+            const at = event;
+            zoomAbout.current(ratio, at.clientX, at.clientY);
+        };
+        element.addEventListener("wheel", onWheel, { passive: false });
+        element.addEventListener("gesturestart", onGestureStart);
+        element.addEventListener("gesturechange", onGesture);
+        return () => {
+            element.removeEventListener("wheel", onWheel);
+            element.removeEventListener("gesturestart", onGestureStart);
+            element.removeEventListener("gesturechange", onGesture);
+        };
+    }, [setView, stage]);
+    return { zoomAbout, panBy };
+}
+//# sourceMappingURL=scene-hand.js.map

package/dist/scene-hand.js.map

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

package/dist/scene-helpers.d.ts

@@ -0,0 +1,46 @@
+import type { Matrix4 } from "@graview/render";
+import type { SceneNode } from "./scene-root.js";
+/**
+ * What a click on a view selects.
+ *
+ * Selecting a GROUP selects its members, because a group is a view of a set
+ * of nodes rather than a node itself — "select the People block" means the
+ * people. Everything downstream then works unchanged: the affordance layer
+ * sees a selection of real nodes and can say what is true about them.
+ */
+export declare function selectionFor(node: SceneNode, current: readonly string[], additive: boolean): string[];
+/**
+ * WHAT ONE `rem` IS WORTH RIGHT NOW — the reader's own text size, watched.
+ *
+ * The scene's cards hold text sized in `rem` and were laid out in pixels,
+ * so a reader who asked for bigger words got them inside a city that had
+ * not moved: a headline in a glyph. The layout takes this as its unit, so
+ * the picture grows with the words.
+ *
+ * Read from the root rather than from a setting's name, because the scene
+ * has no business knowing what an app called its text-size control — the
+ * root font size is where every such control lands, including the browser's
+ * own, which no app declares at all.
+ */
+export declare function useRootUnit(): number;
+/**
+ * The element's size, tracked. Returns null until it has been measured, so a
+ * first render never lays out against a guess.
+ */
+export declare function useElementSize(ref: {
+    current: HTMLElement | null;
+}): {
+    width: number;
+    height: number;
+} | null;
+/**
+ * A plane's elevation, in the idiom of its scheme.
+ *
+ * Dark separates by luminance, so one soft dark pool is right. Light
+ * separates the way objects on a desk do — a tight contact shadow plus a
+ * long diffuse one — so it gets both, and the further plane casts the
+ * longer, weaker one.
+ */
+export declare function planeShadow(shadow: number, scheme: "light" | "dark"): string;
+export declare function cssTransform(transform: Matrix4): string;
+//# sourceMappingURL=scene-helpers.d.ts.map

package/dist/scene-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-helpers.d.ts","sourceRoot":"","sources":["../src/scene-helpers.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,QAAQ,EAAE,OAAO,GAChB,MAAM,EAAE,CAOV;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAyBpC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE;IAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,GACnC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuB1C;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAO5E;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAGvD"}

package/dist/scene-helpers.js

@@ -0,0 +1,108 @@
+import { useEffect, useState } from "react";
+/**
+ * What a click on a view selects.
+ *
+ * Selecting a GROUP selects its members, because a group is a view of a set
+ * of nodes rather than a node itself — "select the People block" means the
+ * people. Everything downstream then works unchanged: the affordance layer
+ * sees a selection of real nodes and can say what is true about them.
+ */
+export function selectionFor(node, current, additive) {
+    const ids = node.aggregate ? [...node.aggregate.memberIds] : [node.id];
+    if (!additive)
+        return ids;
+    const alreadyIn = ids.every((id) => current.includes(id));
+    return alreadyIn
+        ? current.filter((id) => !ids.includes(id))
+        : [...current, ...ids.filter((id) => !current.includes(id))];
+}
+/**
+ * WHAT ONE `rem` IS WORTH RIGHT NOW — the reader's own text size, watched.
+ *
+ * The scene's cards hold text sized in `rem` and were laid out in pixels,
+ * so a reader who asked for bigger words got them inside a city that had
+ * not moved: a headline in a glyph. The layout takes this as its unit, so
+ * the picture grows with the words.
+ *
+ * Read from the root rather than from a setting's name, because the scene
+ * has no business knowing what an app called its text-size control — the
+ * root font size is where every such control lands, including the browser's
+ * own, which no app declares at all.
+ */
+export function useRootUnit() {
+    const [unit, setUnit] = useState(16);
+    useEffect(() => {
+        if (typeof window === "undefined")
+            return;
+        const root = document.documentElement;
+        const read = () => {
+            const now = parseFloat(getComputedStyle(root).fontSize);
+            if (Number.isFinite(now))
+                setUnit((held) => (Math.abs(held - now) < 0.5 ? held : now));
+        };
+        read();
+        /*
+         * The setting writes the root's own `style`, and a reader changing the
+         * browser's default changes the computed size without touching it — so
+         * both are watched: the attribute for the app's control, and a resize
+         * for the browser's.
+         */
+        const observer = new MutationObserver(read);
+        observer.observe(root, { attributes: true, attributeFilter: ["style"] });
+        window.addEventListener("resize", read);
+        return () => {
+            observer.disconnect();
+            window.removeEventListener("resize", read);
+        };
+    }, []);
+    return unit;
+}
+/**
+ * The element's size, tracked. Returns null until it has been measured, so a
+ * first render never lays out against a guess.
+ */
+export function useElementSize(ref) {
+    const [size, setSize] = useState(null);
+    useEffect(() => {
+        const element = ref.current;
+        if (!element || typeof ResizeObserver === "undefined")
+            return;
+        const observer = new ResizeObserver((entries) => {
+            const box = entries[0]?.contentRect;
+            if (!box || box.width === 0 || box.height === 0)
+                return;
+            // Round to whole pixels: a fractional width would recompute the layout
+            // on every sub-pixel wobble and never settle.
+            setSize((current) => {
+                const next = { width: Math.round(box.width), height: Math.round(box.height) };
+                return current && current.width === next.width && current.height === next.height
+                    ? current
+                    : next;
+            });
+        });
+        observer.observe(element);
+        return () => observer.disconnect();
+    }, [ref]);
+    return size;
+}
+/**
+ * A plane's elevation, in the idiom of its scheme.
+ *
+ * Dark separates by luminance, so one soft dark pool is right. Light
+ * separates the way objects on a desk do — a tight contact shadow plus a
+ * long diffuse one — so it gets both, and the further plane casts the
+ * longer, weaker one.
+ */
+export function planeShadow(shadow, scheme) {
+    if (scheme === "dark") {
+        return `0 ${(10 * shadow).toFixed(1)}px ${(34 * shadow).toFixed(1)}px rgba(0,0,0,${(shadow + 0.12).toFixed(2)})`;
+    }
+    const contact = `0 ${(1 + 2 * shadow).toFixed(1)}px ${(2 + 5 * shadow).toFixed(1)}px rgba(20,30,32,${(0.03 + 0.06 * shadow).toFixed(3)})`;
+    const cast = `0 ${(6 + 26 * shadow).toFixed(1)}px ${(18 + 60 * shadow).toFixed(1)}px -${(10 + 10 * shadow).toFixed(1)}px rgba(20,30,32,${(0.1 + 0.3 * shadow).toFixed(3)})`;
+    return `${contact}, ${cast}`;
+}
+export function cssTransform(transform) {
+    // Column-major 4x4 into CSS matrix3d, which is also column-major.
+    return `matrix3d(${transform.join(",")})`;
+}
+//# sourceMappingURL=scene-helpers.js.map

package/dist/scene-helpers.js.map

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

package/dist/scene-lines.d.ts

@@ -0,0 +1,76 @@
+import type { AnySchema, GraphReader, NodeOfSchema } from "@graview/core";
+import { type InterpolatedLayout } from "@graview/layout";
+import type { ActivityMark } from "./activity.js";
+import type { SceneNode } from "./scene-root.js";
+/**
+ * EVERY LINE IN THE SCENE, measured against the DOM it is drawn over.
+ *
+ * Both line layers measure elements — panels, spans, chips — and anything
+ * measured during a render reads the PREVIOUS commit's geometry. The scene
+ * used to live with that: a tween paints sixty frames so one stale frame
+ * is invisible, and a settle tick after the last one catches the rest. A
+ * cut had no such cover, and a drag left every line one pointer event
+ * behind the card it was tied to.
+ *
+ * So the lines are their own component, and after each commit that could
+ * have moved anything — a new frame, a new selection, a graph edit that
+ * re-flowed a view — they re-render ONCE from a layout effect, before the
+ * browser paints. Only this subtree renders twice; the hosts do not.
+ *
+ * The strands are resolved here rather than inside a layer because two
+ * layers need the same answer: the connector layer draws them, and the
+ * ties layer yields to exactly the relations that already have a line.
+ * Deciding that from the layout alone was the bug: a session's line into
+ * the week was CLAIMED as drawn while it actually rose from the panel's
+ * centre, so selecting the session lit three of its four drills and left
+ * the fourth to a faint line from nowhere.
+ */
+export declare function Lines<S extends AnySchema>({ frame, width, height, scheme, overview, selection, emphasis, stageRef, store, graphNodes, onPickEdge, liveOf, holding, }: {
+    readonly frame: InterpolatedLayout;
+    readonly width: number;
+    readonly height: number;
+    readonly scheme: "light" | "dark";
+    readonly overview: boolean;
+    readonly selection: readonly string[];
+    readonly emphasis: string | null;
+    readonly stageRef: {
+        current: HTMLElement | null;
+    };
+    readonly store: {
+        graph: GraphReader<NodeOfSchema<S>>;
+    };
+    readonly graphNodes: unknown;
+    readonly onPickEdge: (edgeId: string, at?: {
+        x: number;
+        y: number;
+    }) => void;
+    readonly liveOf: (connector: {
+        from: string;
+        to: string;
+    }) => ActivityMark | undefined;
+    /** A card is held by the hand: draw from the layout, measure when it lets go. */
+    readonly holding?: boolean;
+}): import("react").JSX.Element | null;
+/**
+ * What plane 1 is, said in words, over the run of cards it applies to.
+ *
+ * The schema has always carried a description on every edge — "who does the
+ * run", "a nap that must not be interrupted" — and nothing ever showed them.
+ * A row of anonymous cards under the thing you clicked is a puzzle; the same
+ * row under "who does the run" is an answer. Layout groups the neighbourhood
+ * by edge kind, so each caption spans one contiguous run rather than
+ * repeating itself once per card.
+ */
+export declare function RelationCaptions({ nodes, scheme, width: stageWidth, stageRef, moving, holding, }: {
+    readonly nodes: readonly SceneNode[];
+    readonly scheme: "light" | "dark";
+    readonly width: number;
+    readonly stageRef: {
+        current: HTMLElement | null;
+    };
+    /** In flight: captions are measured where the transition lands, not on every frame of it. */
+    readonly moving?: boolean;
+    /** A card is held: nothing the captions stand over moves, so they are not measured again. */
+    readonly holding?: boolean;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=scene-lines.d.ts.map

package/dist/scene-lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-lines.d.ts","sourceRoot":"","sources":["../src/scene-lines.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,KAAK,kBAAkB,EAAoC,MAAM,iBAAiB,CAAC;AAG5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAKlD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,SAAS,EAAE,EACzC,KAAK,EACL,KAAK,EACL,MAAM,EACN,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,UAAU,EACV,UAAU,EACV,MAAM,EACN,OAAe,GAChB,EAAE;IACD,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;KAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC;IACxD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7E,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,YAAY,GAAG,SAAS,CAAC;IACvF,iFAAiF;IACjF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,sCAwHA;AAydD;;;;;;;;;GASG;AAEH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,MAAM,EACN,KAAK,EAAE,UAAU,EACjB,QAAQ,EACR,MAAc,EACd,OAAe,GAChB,EAAE;IACD,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;KAAE,CAAC;IACnD,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,6FAA6F;IAC7F,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,sCAgGA"}