@xenolithengine/graph-render-pixi 0.7.0-beta.0

package/dist/node-renderer.d.ts

@@ -0,0 +1,102 @@
+import { Container, Graphics, type Renderer } from 'pixi.js';
+import type { StateStyle } from '@xenolithengine/graph-theme-xen';
+import type { Node, Pin, TypeRegistry } from '@xenolithengine/graph-core';
+import type { XenTokens } from '@xenolithengine/graph-theme-xen';
+import { type WidgetHit, type CustomWidgetController } from './widget-renderer.js';
+import { type GraphCategoryPalette } from './style.js';
+export type NodeVisualState = 'default' | 'hover' | 'selected' | 'active';
+/** Metadata attached to every pin Graphics so the editor's stage-level pointer handlers can
+ *  identify which pin was hit without reaching into renderer internals. */
+export interface PinHandle {
+    nodeId: string;
+    pinId: string;
+    direction: 'in' | 'out';
+    kind: 'exec' | 'data';
+    type: string;
+}
+/** Read the PinHandle from a PIXI event target (or any DisplayObject). Returns null when the
+ *  target is not a pin Graphics. Editor code uses this on stage `pointerdown` / `pointerover`. */
+export declare function readPinHandle(target: unknown): PinHandle | null;
+export declare function markPinInteractive(g: Graphics, pin: Pin, nodeId: string, cx: number, cy: number, visualRadius: number): void;
+export interface RenderNodeOptions {
+    category?: string;
+    title?: string;
+    state?: NodeVisualState;
+    collapsed?: boolean;
+    /** Skip title ellipsis — used during inline rename so the live (possibly overflowing) title shows
+     *  in full while the user types, matching the comment-rename behaviour. */
+    fullTitle?: boolean;
+    /** Per-node header colour override (from `render.color` in the graph data). Beats category/theme. */
+    color?: string;
+    /** Graph-level category palette (from `categories` in the graph data). Overrides theme tokens. */
+    categoryPalette?: GraphCategoryPalette;
+    /** Active PIXI Renderer — when provided, selection/hover/active glow strokes are baked into
+     *  shared textures keyed by (size × radius × style). Without it, each glow falls back to a
+     *  live BlurFilter (acceptable for unit tests, expensive at scale). */
+    renderer?: Renderer | null;
+    /** Called whenever the view mutates outside the editor's knowledge — currently the internal
+     *  collapse/expand animation, which drives itself on Ticker.shared. The editor uses this to
+     *  mark its render-on-demand loop dirty so animation frames actually paint. */
+    requestRender?: () => void;
+    /** Host-registered custom widget controllers, keyed by the `renderer` name on a `custom` widget. */
+    customWidgets?: ReadonlyMap<string, CustomWidgetController>;
+    /** Custom pin-type descriptors — a pin whose type the theme doesn't know falls back to the
+     *  registered descriptor's colour instead of the generic `any` grey. */
+    types?: TypeRegistry;
+    /** A small glyph drawn in the header to mark a node without relying on colour. `svg` is the inner
+     *  markup of a 24×24 icon (the editor resolves a {@link NodeGlyph} name via its icon registry);
+     *  `side` picks which side of the title it sits on. Positioning/centring is automatic. */
+    glyph?: {
+        svg: string;
+        side: 'left' | 'right';
+    };
+    /** PinIds (string) on this node that currently have at least one edge attached. Drives the
+     *  exec-pin paint (filled gold when connected, outlined white when not). The renderer treats
+     *  an absent set as "nothing connected" — safe default for headless tests. */
+    connectedPinIds?: ReadonlySet<string>;
+    /** Live runtime value flowing into this node's bound pin (used by `'always'` display widgets
+     *  so they show the wire's current value, not the stored default). Editor binds this from the
+     *  host's runtime plugin; tests usually omit it. */
+    pinLiveValue?: (pinKey: string) => unknown;
+}
+export interface NodeView {
+    readonly container: Container;
+    setVisualState(state: NodeVisualState): void;
+    setCollapsed(collapsed: boolean, animated?: boolean): void;
+    isCollapsed(): boolean;
+    /** The collapsed header pill's rect (+ corner radius) in node-local coords. Lets the editor
+     *  occlude DOM widgets behind a collapsed node by its actual rounded pill, not its full size. */
+    readonly collapsedRect?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        r: number;
+    };
+    /** Centre of a pin in the node's local coordinates given the current visual state.
+     *  Edge renderers use this to track pin positions as nodes collapse/expand. */
+    pinLocalPosition(pinId: string): {
+        x: number;
+        y: number;
+    } | null;
+    /** Widget under a node-local point (expanded form only), or null. Absent on views without
+     *  widgets (reroutes, themes that don't draw them). */
+    widgetHit?(localX: number, localY: number): WidgetHit | null;
+    /** Cheaply refresh one widget's visual to a new value (live slider/number drag). */
+    updateWidget?(id: string, value: unknown): void;
+}
+/** Append a pin glyph path to `g`: a right-pointing arrow (exec/control flow), a diamond (e.g. struct
+ *  types), or a circle (data). Shared by both renderers + the expanded/collapsed pin paths. */
+export declare function buildPinShape(g: Graphics, shape: 'circle' | 'diamond' | 'arrow', x: number, y: number, r: number): Graphics;
+/** A header glyph scaled to a `size`×`size` box. `svgInner` is the inner markup of a 24×24 viewBox
+ *  (resolve a name via {@link IconRegistry}); the art is centred within the box, so place its
+ *  top-left at `(x, centerY - size/2)` to centre it on a line. Shared by Xen + Liquid Glass. */
+export declare function makeHeaderIcon(svgInner: string, color: string, size: number): Graphics;
+export declare function makeGlowLayer(style: StateStyle, w: number, h: number, radius: number, renderer: Renderer | null): Container;
+/** Drop the module-level cache — call when switching themes or on editor disposal to free the
+ *  GPU memory the baked glow textures hold. */
+export declare function clearGlowTextureCache(): void;
+/** Drop the shared gradient cache (theme switch / disposal) — releases the gradient textures. */
+export declare function clearGradientCache(): void;
+export declare function renderNode(node: Node, tokens: XenTokens, opts?: RenderNodeOptions): NodeView;
+//# sourceMappingURL=node-renderer.d.ts.map

package/dist/node-renderer.d.ts.map

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