@cjlapao/ui-kit-vue 0.2.7 → 0.2.9

package/dist/types/common/connectionFlow/anchors.d.ts

@@ -0,0 +1,4 @@
+import type { ConnectionFlowLayoutOptions, LaidOutConnector, LaidOutEdge, LaidOutNode } from "./types";
+/** Allocate one terminal per edge endpoint. Overflow uses the nearest free side;
+ * each route reserves its own lane, including fan-in and fan-out connections. */
+export declare function separateAnchors(nodes: LaidOutNode[], edges: LaidOutEdge[], connectors: Map<string, LaidOutConnector>, options: ConnectionFlowLayoutOptions): void;

package/dist/types/common/connectionFlow/captions.d.ts

@@ -0,0 +1,21 @@
+import { type ConnectionFlowLayoutOptions, type LaidOutConnector, type LaidOutEdge, type LaidOutNode } from "./types";
+/** Conservative glyph advances at the renderer's fixed 10px font size. */
+export declare const captionTextWidth: (text: string) => number;
+export declare function wrapCaption(text: string, width: number): string[];
+/** Captions own real corridor area, not a rectangle painted over the board.
+ * Place labelled routes in order, reserve their bounds, then route unlabelled
+ * paths around them. Previously placed captions never move under a later edge.
+ */
+export declare function layoutCaptions(nodes: LaidOutNode[], edges: LaidOutEdge[], connectors: Map<string, LaidOutConnector>, options: ConnectionFlowLayoutOptions): void;
+/** Per-node seam budgets. A retry reserves the seam on the side of its
+ * target; a normal connector reserves the seam before its destination. */
+export declare function captionSpacing(nodes: readonly import("./types").ConnectionFlowNode[], options: ConnectionFlowLayoutOptions): {
+    before: Map<string, {
+        horizontal: number;
+        vertical: number;
+    }>;
+    after: Map<string, {
+        horizontal: number;
+        vertical: number;
+    }>;
+};

package/dist/types/common/connectionFlow/layout.d.ts

@@ -1,4 +1,4 @@
-import { type ConnectionFlowLayout, type ConnectionFlowLayoutOptions, type ConnectionFlowNode, type ConnectionState, type LaidOutNode } from "./types";
+import { type ConnectionFlowConnection, type ConnectionFlowLayout, type ConnectionFlowLayoutOptions, type ConnectionFlowNode, type ConnectionState, type LaidOutNode } from "./types";
 /**
  * A column on the main track: one `step`/`branch` node, or a stack of
  * consecutive `parallel` ones.
@@ -26,6 +26,8 @@ export declare const buildColumns: (nodes: ConnectionFlowNode[]) => Column[];
 export declare const resolveSkipped: (columns: Column[], autoSkip: boolean) => Set<number>;
 export interface LayoutInput {
     nodes: ConnectionFlowNode[];
+    /** When supplied, draw only these connections, including an empty array. */
+    connections?: readonly ConnectionFlowConnection[];
     options?: Partial<ConnectionFlowLayoutOptions>;
     /** Fallback state for edges that do not declare one. */
     flowState?: ConnectionState;

package/dist/types/common/connectionFlow/router.d.ts

@@ -88,6 +88,11 @@ export interface Route {
     d: string;
 }
 export declare const routePorts: (fromPort: Port, toPort: Port, options: RouteOptions) => Route;
+/** Rebuild an existing corridor after moving a terminal along its side. */
+export declare const routePolyline: (points: {
+    x: number;
+    y: number;
+}[], style: ConnectionFlowEdgeStyle, radius: number) => Route;
 /** Total length of a waypoint list. */
 export declare const routeLength: (points: {
     x: number;
@@ -143,6 +148,8 @@ export interface PathEndpoint {
      * straitjacket — a card in the way always outranks the idiom.
      */
     preferSides?: PortSide[];
+    /** Optional hard constraint for already allocated terminal sides. */
+    sides?: PortSide[];
 }
 /**
  * Shared lane accounting. Every route the engine returns charges its grid
@@ -153,6 +160,8 @@ export interface PathEndpoint {
 export type LaneUse = Map<string, number>;
 export declare const createLaneUse: () => LaneUse;
 export interface PathOptions {
+    /** Require all obstacle interiors to remain clear (caption corridor routing). */
+    strictObstacles?: boolean;
     style: ConnectionFlowEdgeStyle;
     /** How far a line must run out of a port before it may turn. */
     stub?: number;
@@ -174,7 +183,24 @@ export interface PathOptions {
     preferBonus?: number;
     /** Shared across one layout run — see `createLaneUse`. */
     laneUse?: LaneUse;
+    /** Minimum distance between parallel independent lanes. */
+    laneSpacing?: number;
+    /** Existing routes: charge crowding and expose adjacent lanes. */
+    occupied?: readonly (readonly {
+        x: number;
+        y: number;
+    }[])[];
 }
+/** Minimum centre-to-centre lane distance, including room for a 6px hop. */
+export declare const routingLaneSpacing: (clearance: number, cornerRadius: number) => number;
+/** Length of parallel overlap within a lane; perpendicular crossings use bridges. */
+export declare const parallelOverlap: (a: readonly {
+    x: number;
+    y: number;
+}[], b: readonly {
+    x: number;
+    y: number;
+}[], spacing?: number) => number;
 /** Does any segment of this waypoint list pass through the interior of a box? */
 export declare const segmentsCrossBoxes: (points: {
     x: number;
@@ -212,7 +238,7 @@ export interface RoutableEdge {
 /**
  * The crossing pass: compare every pair of routed edges and give the
  * horizontal one of each crossing a hop. Returns the new `d` for the edges
- * that gained hops — every other edge keeps its path byte-identical.
+ * that gained hops or needed a tighter corner to preserve a crossing.
  */
 export declare const routeCrossings: (edges: RoutableEdge[], options?: {
     cornerRadius?: number;

package/dist/types/common/connectionFlow/types.d.ts

@@ -73,6 +73,26 @@ export interface ConnectionFlowConnectorConfig {
     /** Caption rendered along the edge. */
     label?: string;
 }
+/** Explicit topology. Supplying a connections array disables inferred edges. */
+export interface ConnectionFlowConnection extends ConnectionFlowConnectorConfig {
+    id: string;
+    fromId: string;
+    toId: string;
+    /** Overall connection color. Defaults to the source node's tone. */
+    tone?: TrueColor;
+    /** Application-defined category (for example success, failure or condition). */
+    type?: string;
+    /** Supporting text for connection editors and accessible descriptions. */
+    description?: string;
+    /** Application-owned condition, rule or other metadata; never executed by the kit. */
+    data?: unknown;
+    /** Allow edit requests for this connection. @default true */
+    editable?: boolean;
+    /** Allow removal requests for this connection. @default true */
+    deletable?: boolean;
+    fromSide?: PortSide;
+    toSide?: PortSide;
+}
 /**
  * One of a card's two outcomes, as an edge. `success` without a `to` is the
  * implicit next step and draws nothing extra — it only restyles the walk
@@ -134,6 +154,13 @@ export interface ConnectionFlowNodeItem {
 }
 export interface ConnectionFlowNode {
     id: string;
+    /** Optional logical cell for top-level editor nodes. Supply on every top-level
+     * node to align rows across columns. Signed integer indices allow adding to
+     * any side. Placement does not create connections; use explicit connections. */
+    gridPosition?: {
+        column: number;
+        row: number;
+    };
     title?: string;
     subtitle?: string;
     description?: string;
@@ -278,6 +305,7 @@ export interface LaidOutNode {
 }
 export interface LaidOutEdge {
     id: string;
+    ringSize?: ConnectionFlowRingSize;
     fromId: string | null;
     toId: string;
     state: ConnectionState;
@@ -291,6 +319,15 @@ export interface LaidOutEdge {
      * and the line they sit on can never disagree about the route.
      */
     d: string;
+    /** Measured, collision-free caption bounds in layout coordinates. */
+    caption?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        lines: string[];
+        lineHeight: number;
+    };
     sourceTone: TrueColor;
     targetTone: TrueColor;
     /** A bypass arc travels *over* skipped nodes rather than between neighbours. */
@@ -334,14 +371,8 @@ export interface LaidOutEdge {
     /** Set when `kind` is `"branch"`. */
     branchKind?: "success" | "failure";
 }
-/**
- * A terminal where one or more edges meet a node.
- *
- * These are layout output rather than something each edge draws for itself.
- * When three edges fan out of one card they share a single port, and an edge
- * that painted its own endpoints stamped three identical rings on that one
- * spot — which the highlight then dimmed three times over, so a "dimmed"
- * connector came out darker than a lit one.
+/** A distinct terminal for one edge endpoint, allocated on a node border.
+ * Fan-in and fan-out edges retain independent anchors and highlight states.
  */
 export interface LaidOutConnector {
     id: string;
@@ -352,11 +383,11 @@ export interface LaidOutConnector {
     /** Which border of the node it sits on. */
     side: PortSide;
     tone: TrueColor;
-    /** The liveliest state among the edges meeting here. */
+    /** State of the edge attached to this terminal. */
     state: ConnectionState;
     /** Something is flowing through this terminal. */
     active: boolean;
-    /** Edges meeting here, so the path highlight dims a connector with them. */
+    /** The single edge attached here; retained as an array for API compatibility. */
     edgeIds: string[];
     /** Radius of the border's bulge, in px. */
     radius: number;

package/dist/types/vue/src/components/Gantt/Gantt.vue.d.ts

@@ -140,11 +140,11 @@ declare const _default: __VLS_WithSlots<import("vue").DefineComponent<GanttProps
     color: TrueColor;
     variant: GanttVariant;
     corner: GanttCorner;
+    links: GanttLink[];
     padding: GanttPadding;
     resizableColumns: boolean;
     minZoom: number;
     maxZoom: number;
-    links: GanttLink[];
     initialZoom: number;
     snap: GanttSnap;
     showToday: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cjlapao/ui-kit-vue",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cjlapao/ui-kit.git",