@bemedev/mind-flow 0.1.0 → 0.1.1

package/lib/helpers/createContext.d.ts

@@ -1,16 +1,16 @@
 import { createContext as createSolidContext, ParentComponent } from 'solid-js';
-/** Context options type extracted from Solid's `createContext`. */
+/** Context options type extracted from Solid's `createSolidContext`. */
 type Options = Parameters<typeof createSolidContext>[1];
 /**
  * Creates a Solid context provider component and a custom hook to consume it.
  *
- * @template T - The type of the context value.
+ * @template `T` - The type of the context value.
  *
  * @param context - Factory function returning a non-nullable context value of type
  *   `NonNullable<T>`.
  * @param options - Optional context configuration of type {@linkcode Options}.
  *
- * @returns A tuple containing the Provider component of type
+ * @returns A tuple containing the Provider component of interface
  *   {@linkcode ParentComponent}, the accessor hook, and the Solid context object.
  */
 export declare const createContext: <const T>(context: () => NonNullable<T>, options?: Options) => readonly [ParentComponent, () => NonNullable<T>, import('solid-js').Context<NonNullable<T>>];

package/lib/helpers/createContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createContext.d.ts","sourceRoot":"","sources":["../../src/helpers/createContext.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,IAAI,kBAAkB,EAEnC,KAAK,eAAe,EACrB,MAAM,UAAU,CAAC;AAElB,mEAAmE;AACnE,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,CAAC,CAAC,EACnC,SAAS,MAAM,WAAW,CAAC,CAAC,CAAC,EAC7B,UAAU,OAAO,iGAUlB,CAAC"}
+{"version":3,"file":"createContext.d.ts","sourceRoot":"","sources":["../../src/helpers/createContext.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,IAAI,kBAAkB,EAEnC,KAAK,eAAe,EACrB,MAAM,UAAU,CAAC;AAElB,wEAAwE;AACxE,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,CAAC,CAAC,EACnC,SAAS,MAAM,WAAW,CAAC,CAAC,CAAC,EAC7B,UAAU,OAAO,iGAUlB,CAAC"}

package/lib/server.cjs.js

@@ -100,13 +100,13 @@ var CLASSES = [
 /**
 * Creates a Solid context provider component and a custom hook to consume it.
 *
-* @template T - The type of the context value.
+* @template `T` - The type of the context value.
 *
 * @param context - Factory function returning a non-nullable context value of type
 *   `NonNullable<T>`.
 * @param options - Optional context configuration of type {@linkcode Options}.
 *
-* @returns A tuple containing the Provider component of type
+* @returns A tuple containing the Provider component of interface
 *   {@linkcode ParentComponent}, the accessor hook, and the Solid context object.
 */
 var createContext = (context, options) => {
@@ -133,7 +133,7 @@ var point = (0, _bemedev_app_bemedev.type)({
 	input: optional(use(point)),
 	output: use(point)
 }));
-/** Schema definition for edge extremities */
+/** Schema definition for edge extremities. */
 var extremities = (0, _bemedev_app_bemedev.type)({
 	from: "string",
 	to: "string"
@@ -388,7 +388,10 @@ var BOUNDS_CONSTRAINTS = {
 	horizontal: 55,
 	vertical: 40
 };
-/** Default node items provided when no initial configuration is given. */
+/**
+* Default node items of type {@linkcode NodeProps} provided when no initial
+* configuration is given.
+*/
 var DEFAULT_NODES = [{
 	id: "node-0",
 	data: {
@@ -420,6 +423,15 @@ var [Provider, useFlow] = createContext(() => {
 	const newEdge = (0, solid_js.createSignal)();
 	const [boardRef, setBoardRef] = (0, solid_js.createSignal)();
 	const [dimensions, setDimensions] = (0, solid_js.createSignal)({}, { equals: dequal_lite.dequal });
+	/**
+	* Converts client viewport coordinates to board canvas coordinates adjusted for
+	* zoom and scroll.
+	*
+	* @param clientX - Viewport horizontal coordinate.
+	* @param clientY - Viewport vertical coordinate.
+	*
+	* @returns Board coordinate point of type {@linkcode Point}.
+	*/
 	const getBoardPoint = (clientX, clientY) => {
 		const el = boardRef();
 		if (!el) return {
@@ -434,6 +446,16 @@ var [Provider, useFlow] = createContext(() => {
 		};
 	};
 	const [edgesPositions, setEdgesPositions] = (0, solid_js.createSignal)({}, { equals: false });
+	/**
+	* Clamps node coordinates within the visible container boundaries.
+	*
+	* @param x - Desired horizontal X coordinate.
+	* @param y - Desired vertical Y coordinate.
+	* @param nodeWidth - Width of the node element in pixels, defaults to `192`.
+	* @param nodeHeight - Height of the node element in pixels, defaults to `50`.
+	*
+	* @returns Clamped coordinate point of type {@linkcode Point}.
+	*/
 	const clampPosition = (x, y, nodeWidth = 192, nodeHeight = 50) => {
 		const container = boardRef()?.parentElement;
 		if (!container) return {
@@ -935,6 +957,13 @@ var NodesBoard = () => {
 		if (maxScrollY > 0) containerRef.scrollTop = percentY * maxScrollY;
 	}, { defer: true }));
 	const selectedId = (0, _bemedev_app_solidjs.useState)(service, { selector: (s) => s.context?.selected });
+	/**
+	* Determines whether the given element ID matches the currently selected entity.
+	*
+	* @param id - The node or edge identifier to check.
+	*
+	* @returns `true` if the item is currently selected, otherwise `false`.
+	*/
 	const selected = (id) => selectedId() === id;
 	const nodes = (0, _bemedev_app_solidjs.useState)(service, {
 		selector: (s) => {

package/lib/server.es.js

@@ -99,13 +99,13 @@ var CLASSES = [
 /**
 * Creates a Solid context provider component and a custom hook to consume it.
 *
-* @template T - The type of the context value.
+* @template `T` - The type of the context value.
 *
 * @param context - Factory function returning a non-nullable context value of type
 *   `NonNullable<T>`.
 * @param options - Optional context configuration of type {@linkcode Options}.
 *
-* @returns A tuple containing the Provider component of type
+* @returns A tuple containing the Provider component of interface
 *   {@linkcode ParentComponent}, the accessor hook, and the Solid context object.
 */
 var createContext$1 = (context, options) => {
@@ -132,7 +132,7 @@ type(({ optional, use }) => ({
 	input: optional(use(point)),
 	output: use(point)
 }));
-/** Schema definition for edge extremities */
+/** Schema definition for edge extremities. */
 var extremities = type({
 	from: "string",
 	to: "string"
@@ -387,7 +387,10 @@ var BOUNDS_CONSTRAINTS = {
 	horizontal: 55,
 	vertical: 40
 };
-/** Default node items provided when no initial configuration is given. */
+/**
+* Default node items of type {@linkcode NodeProps} provided when no initial
+* configuration is given.
+*/
 var DEFAULT_NODES = [{
 	id: "node-0",
 	data: {
@@ -419,6 +422,15 @@ var [Provider, useFlow] = createContext$1(() => {
 	const newEdge = createSignal();
 	const [boardRef, setBoardRef] = createSignal();
 	const [dimensions, setDimensions] = createSignal({}, { equals: dequal });
+	/**
+	* Converts client viewport coordinates to board canvas coordinates adjusted for
+	* zoom and scroll.
+	*
+	* @param clientX - Viewport horizontal coordinate.
+	* @param clientY - Viewport vertical coordinate.
+	*
+	* @returns Board coordinate point of type {@linkcode Point}.
+	*/
 	const getBoardPoint = (clientX, clientY) => {
 		const el = boardRef();
 		if (!el) return {
@@ -433,6 +445,16 @@ var [Provider, useFlow] = createContext$1(() => {
 		};
 	};
 	const [edgesPositions, setEdgesPositions] = createSignal({}, { equals: false });
+	/**
+	* Clamps node coordinates within the visible container boundaries.
+	*
+	* @param x - Desired horizontal X coordinate.
+	* @param y - Desired vertical Y coordinate.
+	* @param nodeWidth - Width of the node element in pixels, defaults to `192`.
+	* @param nodeHeight - Height of the node element in pixels, defaults to `50`.
+	*
+	* @returns Clamped coordinate point of type {@linkcode Point}.
+	*/
 	const clampPosition = (x, y, nodeWidth = 192, nodeHeight = 50) => {
 		const container = boardRef()?.parentElement;
 		if (!container) return {
@@ -934,6 +956,13 @@ var NodesBoard = () => {
 		if (maxScrollY > 0) containerRef.scrollTop = percentY * maxScrollY;
 	}, { defer: true }));
 	const selectedId = useState(service, { selector: (s) => s.context?.selected });
+	/**
+	* Determines whether the given element ID matches the currently selected entity.
+	*
+	* @param id - The node or edge identifier to check.
+	*
+	* @returns `true` if the item is currently selected, otherwise `false`.
+	*/
 	const selected = (id) => selectedId() === id;
 	const nodes = useState(service, {
 		selector: (s) => {

package/lib/services/main.typings.d.ts

@@ -17,7 +17,7 @@ export declare const nodeOffset: import('@bemedev/typings').inferSh<{
         y: "number";
     };
 }>;
-/** Schema definition for edge extremities */
+/** Schema definition for edge extremities. */
 export declare const extremities: import('@bemedev/typings').inferSh<{
     from: "string";
     to: "string";

package/lib/services/main.typings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.typings.d.ts","sourceRoot":"","sources":["../../src/services/main.typings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,qDAAqD;AACrD,eAAO,MAAM,KAAK;;;EAAqC,CAAC;AAExD,uEAAuE;AACvE,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,KAAK,CAAC,CAAC;AAEzC,oEAAoE;AACpE,eAAO,MAAM,UAAU;;;;;;;;;EAGpB,CAAC;AAEJ,6CAA6C;AAC7C,eAAO,MAAM,WAAW;;;EAAyC,CAAC;AAElE,gEAAgE;AAChE,eAAO,MAAM,QAAQ;;;;;;;;;;EAIlB,CAAC;AAEJ,gEAAgE;AAChE,eAAO,MAAM,QAAQ;;;EAAc,CAAC;AAEpC,+EAA+E;AAC/E,eAAO,MAAM,UAAU;;;;;;;;;;;;EAMpB,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,MAAM;;;;;EAKjB,CAAC;AAEH,yEAAyE;AACzE,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,MAAM,CAAC,CAAC"}
+{"version":3,"file":"main.typings.d.ts","sourceRoot":"","sources":["../../src/services/main.typings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,qDAAqD;AACrD,eAAO,MAAM,KAAK;;;EAAqC,CAAC;AAExD,uEAAuE;AACvE,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,KAAK,CAAC,CAAC;AAEzC,oEAAoE;AACpE,eAAO,MAAM,UAAU;;;;;;;;;EAGpB,CAAC;AAEJ,8CAA8C;AAC9C,eAAO,MAAM,WAAW;;;EAAyC,CAAC;AAElE,gEAAgE;AAChE,eAAO,MAAM,QAAQ;;;;;;;;;;EAIlB,CAAC;AAEJ,gEAAgE;AAChE,eAAO,MAAM,QAAQ;;;EAAc,CAAC;AAEpC,+EAA+E;AAC/E,eAAO,MAAM,UAAU;;;;;;;;;;;;EAMpB,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,MAAM;;;;;EAKjB,CAAC;AAEH,yEAAyE;AACzE,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,MAAM,CAAC,CAAC"}

package/lib/ui/components/FlowChart.context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FlowChart.context.d.ts","sourceRoot":"","sources":["../../../src/ui/components/FlowChart.context.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAQjE,4EAA4E;AAC5E,KAAK,UAAU,GAAG;IAChB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,MAAM,EAAE,KAAK,CAAC;IACd,gEAAgE;IAChE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,qEAAqE;IACrE,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,oEAAoE;IACpE,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB,CAAC;AAEF,uEAAuE;AACvE,KAAK,IAAI,GAAG;IACV,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAO,QAAQ,sCAAE,OAAO;;;;sCAoBK,MAAM,WAAW,MAAM,KAAG,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAiB1D,MAAM,KACN,MAAM,8CAGR,KAAK;CAwQX,CAAC"}
+{"version":3,"file":"FlowChart.context.d.ts","sourceRoot":"","sources":["../../../src/ui/components/FlowChart.context.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAQjE,4EAA4E;AAC5E,KAAK,UAAU,GAAG;IAChB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,MAAM,EAAE,KAAK,CAAC;IACd,gEAAgE;IAChE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,qEAAqE;IACrE,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,oEAAoE;IACpE,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB,CAAC;AAEF,uEAAuE;AACvE,KAAK,IAAI,GAAG;IACV,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAO,QAAQ,sCAAE,OAAO;;;;sCA6BK,MAAM,WAAW,MAAM,KAAG,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCA2B1D,MAAM,KACN,MAAM,8CAGR,KAAK;CAwQX,CAAC"}

package/lib/ui/components/FlowChart.data.d.ts

@@ -56,7 +56,10 @@ export declare const BOUNDS_CONSTRAINTS: {
 export declare const CANVAS_FACTOR = 5;
 /** Multiplier factor used to compute canvas scroll dimensions. */
 export declare const SCROLL_MULTIPLIER = 3;
-/** Default node items provided when no initial configuration is given. */
+/**
+ * Default node items of type {@linkcode NodeProps} provided when no initial
+ * configuration is given.
+ */
 export declare const DEFAULT_NODES: (NodeProps & {
     id: string;
 })[];

package/lib/ui/components/FlowChart.data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FlowChart.data.d.ts","sourceRoot":"","sources":["../../../src/ui/components/FlowChart.data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,mFAAmF;AACnF,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAG1C,mDAAmD;AACnD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,sDAAsD;AACtD,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B,oDAAoD;AACpD,eAAO,MAAM,aAAa,QAAkB,CAAC;AAE7C,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,sDAAsD;AACtD,eAAO,MAAM,eAAe,QAAoC,CAAC;AAEjE,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,QAC4B,CAAC;AAEhE,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,QAA0B,CAAC;AAE9D,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,QAAkB,CAAC;AAEtD,kEAAkE;AAClE,eAAO,MAAM,oBAAoB;;;CAGhC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,oBAAoB;;;CAAgC,CAAC;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,cAAS;;;CAG9C,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,yDAAyD;AACzD,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;CAAmC,CAAC;AAEnE,0EAA0E;AAC1E,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAGnC,0EAA0E;AAC1E,eAAO,MAAM,aAAa,EAAE,CAAC,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,EAOvD,CAAC"}
+{"version":3,"file":"FlowChart.data.d.ts","sourceRoot":"","sources":["../../../src/ui/components/FlowChart.data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,mFAAmF;AACnF,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAG1C,mDAAmD;AACnD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,sDAAsD;AACtD,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B,oDAAoD;AACpD,eAAO,MAAM,aAAa,QAAkB,CAAC;AAE7C,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,sDAAsD;AACtD,eAAO,MAAM,eAAe,QAAoC,CAAC;AAEjE,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,QAC4B,CAAC;AAEhE,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,QAA0B,CAAC;AAE9D,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,QAAkB,CAAC;AAEtD,kEAAkE;AAClE,eAAO,MAAM,oBAAoB;;;CAGhC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,oBAAoB;;;CAAgC,CAAC;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,cAAS;;;CAG9C,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,yDAAyD;AACzD,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;CAAmC,CAAC;AAEnE,0EAA0E;AAC1E,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAGnC;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,CAAC,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,EAOvD,CAAC"}

package/lib/ui/components/NodesBoard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodesBoard.d.ts","sourceRoot":"","sources":["../../../src/ui/components/NodesBoard.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAA6C,MAAM,UAAU,CAAC;AAQhF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,SAkRxB,CAAC"}
+{"version":3,"file":"NodesBoard.d.ts","sourceRoot":"","sources":["../../../src/ui/components/NodesBoard.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAA6C,MAAM,UAAU,CAAC;AAQhF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,SA6RxB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bemedev/mind-flow",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Flow Chart UI library for Solid.js applications",
   "keywords": [
     "diagram",
@@ -65,11 +65,7 @@
     "@bemedev/app": "^1.11.0",
     "@bemedev/app-cli": "^1.11.0",
     "@bemedev/app-solidjs": "^1.11.0",
-    "@bemedev/fsf": "^1.0.1",
-    "@bemedev/rollup-config": "^0.2.2",
-    "@bemedev/vitest-alias": "^0.0.3",
-    "@bemedev/vitest-exclude": "^0.1.1",
-    "@bemedev/vitest-extended": "^1.5.3",
+    "@bemedev/dev-utils": "^1.2.0",
     "@rollup/plugin-babel": "^7.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@size-limit/file": "^13.0.3",
@@ -77,7 +73,6 @@
     "@tailwindcss/vite": "^4.3.3",
     "@types/node": "^26.2.0",
     "@vitest/coverage-v8": "^4.1.11",
-    "babel-preset-solid": "^1.9.15",
     "glob": "^13.0.6",
     "globals": "^17.11.0",
     "husky": "^9.1.7",
@@ -97,7 +92,6 @@
     "vite": "^8.2.1",
     "vite-plugin-dts": "^5.0.3",
     "vite-plugin-solid": "^2.11.14",
-    "vite-tsconfig-paths": "^6.1.1",
     "vitest": "^4.1.11"
   },
   "peerDependencies": {

package/src/helpers/createContext.ts

@@ -4,19 +4,19 @@ import {
   type ParentComponent,
 } from 'solid-js';
 
-/** Context options type extracted from Solid's `createContext`. */
+/** Context options type extracted from Solid's `createSolidContext`. */
 type Options = Parameters<typeof createSolidContext>[1];
 
 /**
  * Creates a Solid context provider component and a custom hook to consume it.
  *
- * @template T - The type of the context value.
+ * @template `T` - The type of the context value.
  *
  * @param context - Factory function returning a non-nullable context value of type
  *   `NonNullable<T>`.
  * @param options - Optional context configuration of type {@linkcode Options}.
  *
- * @returns A tuple containing the Provider component of type
+ * @returns A tuple containing the Provider component of interface
  *   {@linkcode ParentComponent}, the accessor hook, and the Solid context object.
  */
 export const createContext = <const T>(

package/src/services/main.typings.ts

@@ -13,7 +13,7 @@ export const nodeOffset = type(({ optional, use }) => ({
   output: use(point),
 }));
 
-/** Schema definition for edge extremities */
+/** Schema definition for edge extremities. */
 export const extremities = type({ from: 'string', to: 'string' });
 
 /** Schema definition for a serialized flowchart node entity. */

package/src/ui/components/FlowChart.context.ts

@@ -59,6 +59,15 @@ export const [Provider, useFlow] = createContext(
       { equals: dequal },
     );
 
+    /**
+     * Converts client viewport coordinates to board canvas coordinates adjusted for
+     * zoom and scroll.
+     *
+     * @param clientX - Viewport horizontal coordinate.
+     * @param clientY - Viewport vertical coordinate.
+     *
+     * @returns Board coordinate point of type {@linkcode Point}.
+     */
     const getBoardPoint = (clientX: number, clientY: number): Point => {
       const el = boardRef();
       if (!el) return { x: clientX, y: clientY };
@@ -75,6 +84,16 @@ export const [Provider, useFlow] = createContext(
       { equals: false },
     );
 
+    /**
+     * Clamps node coordinates within the visible container boundaries.
+     *
+     * @param x - Desired horizontal X coordinate.
+     * @param y - Desired vertical Y coordinate.
+     * @param nodeWidth - Width of the node element in pixels, defaults to `192`.
+     * @param nodeHeight - Height of the node element in pixels, defaults to `50`.
+     *
+     * @returns Clamped coordinate point of type {@linkcode Point}.
+     */
     const clampPosition = (
       x: number,
       y: number,

package/src/ui/components/FlowChart.data.ts

@@ -72,7 +72,10 @@ export const CANVAS_FACTOR = 5;
 export const SCROLL_MULTIPLIER = 3;
 // #endregion
 
-/** Default node items provided when no initial configuration is given. */
+/**
+ * Default node items of type {@linkcode NodeProps} provided when no initial
+ * configuration is given.
+ */
 export const DEFAULT_NODES: (NodeProps & { id: string })[] = [
   {
     id: 'node-0',

package/src/ui/components/NodesBoard.tsx

@@ -35,6 +35,10 @@ export const NodesBoard: Component = () => {
     zoom: [zoom, setZoom],
   } = useFlow();
 
+  /**
+   * Calculates and saves the normalized scroll percentages across X and Y axes for
+   * preserving viewport alignment on zoom changes.
+   */
   const updateScrollPercentages = () => {
     const maxScrollX = containerRef.scrollWidth - containerRef.clientWidth;
     const maxScrollY = containerRef.scrollHeight - containerRef.clientHeight;
@@ -57,6 +61,13 @@ export const NodesBoard: Component = () => {
 
   const selectedId = useState(service, { selector: s => s.context?.selected });
 
+  /**
+   * Determines whether the given element ID matches the currently selected entity.
+   *
+   * @param id - The node or edge identifier to check.
+   *
+   * @returns `true` if the item is currently selected, otherwise `false`.
+   */
   const selected = (id: string | number) => selectedId() === id;
 
   const nodes = useState(service, {