vizcraft 0.2.2 → 1.0.0

package/dist/shapes.d.ts

@@ -1,8 +1,8 @@
-import type { NodeShape, Vec2, VizNode } from './types';
+import type { NodePort, NodeShape, Vec2, VizNode } from './types';
 export type AnchorMode = 'center' | 'boundary';
 export interface ShapeBehavior<K extends NodeShape['kind']> {
     kind: K;
-    tagName: 'circle' | 'rect' | 'polygon';
+    tagName: 'circle' | 'rect' | 'polygon' | 'g' | 'ellipse' | 'path';
     applyGeometry(el: SVGElement, shape: Extract<NodeShape, {
         kind: K;
     }>, pos: Vec2): void;
@@ -14,7 +14,29 @@ export interface ShapeBehavior<K extends NodeShape['kind']> {
     }>): Vec2;
 }
 export declare function effectivePos(node: VizNode): Vec2;
-export declare function getShapeBehavior(shape: NodeShape): ShapeBehavior<"circle"> | ShapeBehavior<"rect"> | ShapeBehavior<"diamond">;
+export declare function getShapeBehavior(shape: NodeShape): ShapeBehavior<"circle"> | ShapeBehavior<"rect"> | ShapeBehavior<"diamond"> | ShapeBehavior<"cylinder"> | ShapeBehavior<"hexagon"> | ShapeBehavior<"ellipse"> | ShapeBehavior<"arc"> | ShapeBehavior<"blockArrow"> | ShapeBehavior<"callout"> | ShapeBehavior<"cloud"> | ShapeBehavior<"cross"> | ShapeBehavior<"cube"> | ShapeBehavior<"path"> | ShapeBehavior<"document"> | ShapeBehavior<"note"> | ShapeBehavior<"parallelogram"> | ShapeBehavior<"star"> | ShapeBehavior<"trapezoid"> | ShapeBehavior<"triangle">;
 export declare function applyShapeGeometry(el: SVGElement, shape: NodeShape, pos: Vec2): void;
 export declare function shapeSvgMarkup(shape: NodeShape, pos: Vec2, attrs: string): string;
 export declare function computeNodeAnchor(node: VizNode, target: Vec2, anchor: AnchorMode): Vec2;
+/**
+ * Return the default (implicit) ports for a node shape.
+ *
+ * Every shape provides at least `top`, `right`, `bottom`, `left`.
+ * Hexagons also include diagonal vertices.
+ * Default ports are **offsets relative to the node center**.
+ */
+export declare function getDefaultPorts(shape: NodeShape): NodePort[];
+/**
+ * Get the effective ports for a node: explicit `node.ports` if set,
+ * otherwise the shape's default ports.
+ */
+export declare function getNodePorts(node: VizNode): NodePort[];
+/**
+ * Find a port on a node by its id. Returns `undefined` if not found.
+ */
+export declare function findPort(node: VizNode, portId: string): NodePort | undefined;
+/**
+ * Resolve a port to an absolute position (node center + port offset).
+ * Returns `undefined` if the port id is not found.
+ */
+export declare function resolvePortPosition(node: VizNode, portId: string): Vec2 | undefined;