@graview/react 0.1.0

package/dist/scene-root.d.ts

@@ -0,0 +1,71 @@
+import type { AnySchema } from "@graview/core";
+import { type InterpolatedLayout, type LayoutNode, type LayoutOptions } from "@graview/layout";
+import { type CSSProperties, type ReactNode } from "react";
+import { railInset } from "./rails.js";
+export { railInset };
+export interface SceneProps {
+    readonly options?: LayoutOptions;
+    /**
+     * `gpu` composites through @graview/render; `dom` positions views with CSS
+     * transforms. `auto` picks gpu when the platform supports it.
+     *
+     * The DOM path is not a toy: the plane model is affine by design, so a CSS
+     * transform reproduces the geometry exactly. What it cannot do is per-plane
+     * blur and falloff — which is precisely the thing that justified the GPU
+     * pipeline, and precisely what is safe to lose when it is unavailable.
+     */
+    readonly renderer?: "gpu" | "dom" | "auto";
+    /**
+     * Wires a renderer to the canvas. Called whenever the layout changes, with
+     * the canvas and the current picture; return a cleanup.
+     *
+     * The binding stays out of the renderer's business deliberately: it hands
+     * over the canvas and what layout decided, and the renderer decides pixels.
+     */
+    readonly attachRenderer?: (scene: {
+        canvas: HTMLCanvasElement;
+        /**
+         * The picture as it is RIGHT NOW, which mid-transition is between two
+         * view states. Planes may be fractional and nodes may be part-faded.
+         */
+        layout: InterpolatedLayout;
+        /**
+         * Views whose CONTENT changed, so a cached texture must be retaken.
+         *
+         * Position and size changes the renderer can see for itself; a count
+         * inside an aggregate changing is invisible to it, and `glyph` fidelity
+         * would otherwise show the old number for ever.
+         */
+        dirty: ReadonlySet<string>;
+        /** The DOM host for a view id — what the capture API is given. */
+        hostOf(id: string): HTMLElement | null;
+    }) => (() => void) | void;
+    readonly className?: string;
+    readonly style?: CSSProperties;
+    /** Animate between view states. Off in tests and SSR. */
+    readonly animate?: boolean;
+    /** Rendered over the scene — an affordance surface, a header, a legend. */
+    readonly children?: ReactNode;
+}
+/**
+ * A node as the scene draws it: a laid-out node, possibly mid-transition, so
+ * its plane is fractional and it may be fading in or out.
+ */
+export type SceneNode = Omit<LayoutNode, "plane"> & {
+    readonly plane: number;
+    readonly opacity?: number;
+};
+/**
+ * The spatial scene: one `<canvas layoutsubtree>` with the views as its
+ * IMMEDIATE children.
+ *
+ * That flatness is a platform constraint, not a style: capture rejects
+ * anything deeper than a direct child of the canvas. Nesting happens inside a
+ * view, never between views.
+ */
+/**
+ * How far a pointer must travel before it is a drag rather than a click.
+ * Below this nothing has moved and the gesture is an ordinary selection.
+ */
+export declare function Scene<S extends AnySchema>({ options, renderer, attachRenderer, className, style, animate, children, }: SceneProps): import("react").JSX.Element;
+//# sourceMappingURL=scene-root.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scene-root.d.ts","sourceRoot":"","sources":["../src/scene-root.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAaL,KAAK,kBAAkB,EAEvB,KAAK,UAAU,EACf,KAAK,aAAa,EAMnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAML,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAgBf,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,CAAC;AAKrB,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC3C;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAChC,MAAM,EAAE,iBAAiB,CAAC;QAC1B;;;WAGG;QACH,MAAM,EAAE,kBAAkB,CAAC;QAC3B;;;;;;WAMG;QACH,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAC3B,kEAAkE;QAClE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;KACxC,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;GAOG;AACH;;;GAGG;AAEH,wBAAgB,KAAK,CAAC,CAAC,SAAS,SAAS,EAAE,EACzC,OAAO,EACP,QAAiB,EACjB,cAAc,EACd,SAAS,EACT,KAAK,EACL,OAAc,EACd,QAAQ,GACT,EAAE,UAAU,+BAw+BZ"}