npm - w-flow-vue - Versions diffs - 1.0.0 - Mend

w-flow-vue 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (144) hide show

package/.editorconfig +9 -0
package/.eslintignore +3 -0
package/.eslintrc.js +55 -0
package/.jsdoc +25 -0
package/AGENT.md +223 -0
package/LICENSE +21 -0
package/README.md +37 -0
package/SECURITY.md +5 -0
package/babel.config.js +16 -0
package/dist/w-flow-vue.umd.js +15 -0
package/dist/w-flow-vue.umd.js.map +1 -0
package/docs/components_WFlowVue.vue.html +1214 -0
package/docs/examples/app.html +62 -0
package/docs/examples/app.umd.js +20 -0
package/docs/examples/app.umd.js.map +1 -0
package/docs/examples/ex-AppBasic.html +440 -0
package/docs/examples/ex-AppConnectivity.html +131 -0
package/docs/fonts/Montserrat/Montserrat-Bold.eot +0 -0
package/docs/fonts/Montserrat/Montserrat-Bold.ttf +0 -0
package/docs/fonts/Montserrat/Montserrat-Bold.woff +0 -0
package/docs/fonts/Montserrat/Montserrat-Bold.woff2 +0 -0
package/docs/fonts/Montserrat/Montserrat-Regular.eot +0 -0
package/docs/fonts/Montserrat/Montserrat-Regular.ttf +0 -0
package/docs/fonts/Montserrat/Montserrat-Regular.woff +0 -0
package/docs/fonts/Montserrat/Montserrat-Regular.woff2 +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.eot +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.svg +978 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.ttf +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.woff +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.woff2 +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.eot +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.svg +1049 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.ttf +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.woff +0 -0
package/docs/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.woff2 +0 -0
package/docs/global.html +1919 -0
package/docs/index.html +84 -0
package/docs/js_defaults.mjs.html +105 -0
package/docs/js_edge-path.mjs.html +237 -0
package/docs/js_geometry.mjs.html +298 -0
package/docs/js_graph.mjs.html +103 -0
package/docs/js_step-routing.mjs.html +346 -0
package/docs/module-WFlowVue.html +2790 -0
package/docs/scripts/collapse.js +39 -0
package/docs/scripts/commonNav.js +28 -0
package/docs/scripts/linenumber.js +25 -0
package/docs/scripts/nav.js +12 -0
package/docs/scripts/polyfill.js +4 -0
package/docs/scripts/prettify/Apache-License-2.0.txt +202 -0
package/docs/scripts/prettify/lang-css.js +2 -0
package/docs/scripts/prettify/prettify.js +28 -0
package/docs/scripts/search.js +99 -0
package/docs/styles/jsdoc.css +776 -0
package/docs/styles/prettify.css +80 -0
package/jest.config.js +20 -0
package/package.json +80 -0
package/public/index.html +38 -0
package/script.txt +22 -0
package/src/App.vue +326 -0
package/src/AppBasic.vue +125 -0
package/src/AppConnectivity.vue +186 -0
package/src/components/WFlowVue.vue +1142 -0
package/src/components/canvas/BackgroundLayer.vue +78 -0
package/src/components/canvas/FlowCanvas.vue +64 -0
package/src/components/canvas/SelectionBox.vue +36 -0
package/src/components/canvas/ViewportTransform.vue +35 -0
package/src/components/edges/ConnectionLine.vue +65 -0
package/src/components/edges/EdgeMarkerDefs.vue +76 -0
package/src/components/edges/EdgeRenderer.vue +120 -0
package/src/components/edges/EdgeWrapper.vue +379 -0
package/src/components/nodes/DefaultNode.vue +276 -0
package/src/components/nodes/Handle.vue +101 -0
package/src/components/nodes/InputNode.vue +47 -0
package/src/components/nodes/NodeBody.vue +103 -0
package/src/components/nodes/NodeFace.vue +128 -0
package/src/components/nodes/NodeRenderer.vue +95 -0
package/src/components/nodes/NodeWrapper.vue +475 -0
package/src/components/nodes/OutputNode.vue +47 -0
package/src/components/ui/ConnSettingsForm.vue +158 -0
package/src/components/ui/Controls.vue +83 -0
package/src/components/ui/NodeSettingsForm.vue +185 -0
package/src/js/defaults.mjs +33 -0
package/src/js/edge-path.mjs +165 -0
package/src/js/geometry.mjs +226 -0
package/src/js/graph.mjs +31 -0
package/src/js/step-routing.mjs +274 -0
package/src/main.js +22 -0
package/test/WFlowVue-features.test.mjs +760 -0
package/test/WFlowVue.test.mjs +421 -0
package/test/components-canvas.test.mjs +102 -0
package/test/components-edge.test.mjs +147 -0
package/test/components-node.test.mjs +174 -0
package/test/components-ui.test.mjs +69 -0
package/test/defaults.test.mjs +86 -0
package/test/edge-path.test.mjs +102 -0
package/test/generate-routing-snapshots.mjs +77 -0
package/test/generate-visual-baselines.mjs +206 -0
package/test/geometry.test.mjs +236 -0
package/test/graph.test.mjs +72 -0
package/test/jsons/routing-snapshots.json +24994 -0
package/test/pics/_check2.png +0 -0
package/test/pics/_check3.png +0 -0
package/test/pics/_check4.png +0 -0
package/test/pics/_check5.png +0 -0
package/test/pics/_v1.png +0 -0
package/test/pics/_v2.png +0 -0
package/test/pics/_v3.png +0 -0
package/test/pics/_v4.png +0 -0
package/test/pics/_v5.png +0 -0
package/test/pics/_v6.png +0 -0
package/test/pics/_v7.png +0 -0
package/test/pics/vb-edge-hovered.png +0 -0
package/test/pics/vb-edges-normal.png +0 -0
package/test/pics/vb-locked-edge-hovered.png +0 -0
package/test/pics/vb-locked-node-hovered.png +0 -0
package/test/pics/vb-locked-node-selected.png +0 -0
package/test/pics/vb-locked-overview.png +0 -0
package/test/pics/vb-node-1.png +0 -0
package/test/pics/vb-node-10.png +0 -0
package/test/pics/vb-node-11.png +0 -0
package/test/pics/vb-node-12.png +0 -0
package/test/pics/vb-node-2.png +0 -0
package/test/pics/vb-node-3.png +0 -0
package/test/pics/vb-node-4.png +0 -0
package/test/pics/vb-node-5.png +0 -0
package/test/pics/vb-node-6.png +0 -0
package/test/pics/vb-node-7.png +0 -0
package/test/pics/vb-node-8.png +0 -0
package/test/pics/vb-node-9.png +0 -0
package/test/pics/vb-node-hovered.png +0 -0
package/test/pics/vb-node-selected.png +0 -0
package/test/pics/vb-overview.png +0 -0
package/test/step-routing-connectivity.test.mjs +78 -0
package/test/step-routing.test.mjs +88 -0
package/test/visual-regression.test.mjs +274 -0
package/toolg/addVersion.mjs +4 -0
package/toolg/cleanFolder.mjs +4 -0
package/toolg/gDistApp.mjs +34 -0
package/toolg/gDistRollupComps.mjs +22 -0
package/toolg/gDocExams.mjs +47 -0
package/toolg/gExtractHtml.mjs +179 -0
package/toolg/modifyReadme.mjs +4 -0
package/vue.config.js +9 -0
package/vue2/344/271/213foreignObject/345/205/247/346/270/262/346/237/223/345/225/217/351/241/214/350/210/207/344/277/256/346/255/243.md +151 -0

package/docs/global.html ADDED Viewed

@@ -0,0 +1,1919 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>Global - Documentation</title>
+    <script src="scripts/prettify/prettify.js"></script>
+    <script src="scripts/prettify/lang-css.js"></script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="styles/prettify.css">
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc.css">
+    <script src="scripts/nav.js" defer></script>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+</head>
+<body>
+<input type="checkbox" id="nav-trigger" class="nav-trigger" />
+<label for="nav-trigger" class="navicon-button x">
+  <div class="navicon"></div>
+</label>
+<label for="nav-trigger" class="overlay"></label>
+<nav >
+    <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-WFlowVue.html">WFlowVue</a></li></ul><h3>Global</h3><ul><li><a href="global.html#NODE_DEFAULTS">NODE_DEFAULTS</a></li><li><a href="global.html#clampPosition">clampPosition</a></li><li><a href="global.html#generateId">generateId</a></li><li><a href="global.html#getBezierPath">getBezierPath</a></li><li><a href="global.html#getControlOffset">getControlOffset</a></li><li><a href="global.html#getDiamondEdgePoint">getDiamondEdgePoint</a></li><li><a href="global.html#getEllipseEdgePoint">getEllipseEdgePoint</a></li><li><a href="global.html#getHandlePosition">getHandlePosition</a></li><li><a href="global.html#getOverlappingNodes">getOverlappingNodes</a></li><li><a href="global.html#getSmoothStepPath">getSmoothStepPath</a></li><li><a href="global.html#getStepPath">getStepPath</a></li><li><a href="global.html#getStraightPath">getStraightPath</a></li><li><a href="global.html#getTriangleEdgePoint">getTriangleEdgePoint</a></li><li><a href="global.html#isValidConnection">isValidConnection</a></li><li><a href="global.html#labelAtHalfLength">labelAtHalfLength</a></li><li><a href="global.html#lookupRoute">lookupRoute</a></li><li><a href="global.html#rectsOverlap">rectsOverlap</a></li><li><a href="global.html#segmentFallback">segmentFallback</a></li><li><a href="global.html#snapPosition">snapPosition</a></li></ul>
+</nav>
+<div id="main">
+    <h1 class="page-title">Global</h1>
+<section>
+<header>
+        <h2>
+        </h2>
+</header>
+<article>
+        <div class="container-overview">
+<dl class="details">
+</dl>
+        </div>
+        <h3 class="subsection-title">Members</h3>
+<h4 class="name" id="NODE_DEFAULTS"><span class="type-signature type-signature-constant">(constant) </span>NODE_DEFAULTS<span class="type-signature"></span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Default values for node and connection properties.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_defaults.mjs.html">js/defaults.mjs</a>, <a href="js_defaults.mjs.html#line5">line 5</a>
+    </li></ul></dd>
+</dl>
+<div class="description usertext">
+    <p>Default values for node and connection properties.</p>
+</div>
+        <h3 class="subsection-title">Methods</h3>
+    <h4 class="name" id="clampPosition"><span class="type-signature"></span>clampPosition<span class="signature">()</span><span class="type-signature"></span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Clamp a position within a coordinate extent.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_geometry.mjs.html">js/geometry.mjs</a>, <a href="js_geometry.mjs.html#line207">line 207</a>
+    </li></ul></dd>
+</dl>
+    <h4 class="name" id="generateId"><span class="type-signature"></span>generateId<span class="signature">()</span><span class="type-signature"></span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Generate a unique ID.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_graph.mjs.html">js/graph.mjs</a>, <a href="js_graph.mjs.html#line27">line 27</a>
+    </li></ul></dd>
+</dl>
+    <h4 class="name" id="getBezierPath"><span class="type-signature"></span>getBezierPath<span class="signature">()</span><span class="type-signature"> &rarr; {Object}</span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Get bezier curve path.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_edge-path.mjs.html">js/edge-path.mjs</a>, <a href="js_edge-path.mjs.html#line26">line 26</a>
+    </li></ul></dd>
+</dl>
+<h5 class="h5-returns">Returns:</h5>
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+<span class="param-type">Object</span>
+    </dd>
+</dl>
+    <h4 class="name" id="getControlOffset"><span class="type-signature"></span>getControlOffset<span class="signature">()</span><span class="type-signature"></span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Calculate the control point offset for bezier curves based on handle position.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_edge-path.mjs.html">js/edge-path.mjs</a>, <a href="js_edge-path.mjs.html#line12">line 12</a>
+    </li></ul></dd>
+</dl>
+    <h4 class="name" id="getDiamondEdgePoint"><span class="type-signature"></span>getDiamondEdgePoint<span class="signature">()</span><span class="type-signature"></span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Get a point on the diamond edge for same-side handles.
+Each &quot;side&quot; of the diamond is split into two edges meeting at the vertex.
+ratio &lt; 0.5: on the first edge, ratio &gt;= 0.5: on the second edge.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_geometry.mjs.html">js/geometry.mjs</a>, <a href="js_geometry.mjs.html#line51">line 51</a>
+    </li></ul></dd>
+</dl>
+    <h4 class="name" id="getEllipseEdgePoint"><span class="type-signature"></span>getEllipseEdgePoint<span class="signature">()</span><span class="type-signature"></span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Get a point on the ellipse edge for handle positioning.
+Maps ratio (0..1) to a parametric angle based on the side.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_geometry.mjs.html">js/geometry.mjs</a>, <a href="js_geometry.mjs.html#line101">line 101</a>
+    </li></ul></dd>
+</dl>
+    <h4 class="name" id="getHandlePosition"><span class="type-signature"></span>getHandlePosition<span class="signature">()</span><span class="type-signature"></span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Calculate the absolute position of a handle on the canvas.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_geometry.mjs.html">js/geometry.mjs</a>, <a href="js_geometry.mjs.html#line4">line 4</a>
+    </li></ul></dd>
+</dl>
+    <h4 class="name" id="getOverlappingNodes"><span class="type-signature"></span>getOverlappingNodes<span class="signature">()</span><span class="type-signature"></span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Get all nodes that overlap with a given rectangle.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_geometry.mjs.html">js/geometry.mjs</a>, <a href="js_geometry.mjs.html#line177">line 177</a>
+    </li></ul></dd>
+</dl>
+    <h4 class="name" id="getSmoothStepPath"><span class="type-signature"></span>getSmoothStepPath<span class="signature">()</span><span class="type-signature"> &rarr; {Object}</span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Get smooth step (rounded right-angle) path.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_edge-path.mjs.html">js/edge-path.mjs</a>, <a href="js_edge-path.mjs.html#line85">line 85</a>
+    </li></ul></dd>
+</dl>
+<h5 class="h5-returns">Returns:</h5>
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+<span class="param-type">Object</span>
+    </dd>
+</dl>
+    <h4 class="name" id="getStepPath"><span class="type-signature"></span>getStepPath<span class="signature">()</span><span class="type-signature"> &rarr; {Object}</span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Get step (right-angle) path.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_edge-path.mjs.html">js/edge-path.mjs</a>, <a href="js_edge-path.mjs.html#line65">line 65</a>
+    </li></ul></dd>
+</dl>
+<h5 class="h5-returns">Returns:</h5>
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+<span class="param-type">Object</span>
+    </dd>
+</dl>
+    <h4 class="name" id="getStraightPath"><span class="type-signature"></span>getStraightPath<span class="signature">()</span><span class="type-signature"> &rarr; {Object}</span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Get straight line path.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_edge-path.mjs.html">js/edge-path.mjs</a>, <a href="js_edge-path.mjs.html#line54">line 54</a>
+    </li></ul></dd>
+</dl>
+<h5 class="h5-returns">Returns:</h5>
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+<span class="param-type">Object</span>
+    </dd>
+</dl>
+    <h4 class="name" id="getTriangleEdgePoint"><span class="type-signature"></span>getTriangleEdgePoint<span class="signature">()</span><span class="type-signature"></span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Get a point on the triangle edge for handle positioning.
+Supports 4 directions: triangle (up), triangle-right, triangle-down, triangle-left.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_geometry.mjs.html">js/geometry.mjs</a>, <a href="js_geometry.mjs.html#line131">line 131</a>
+    </li></ul></dd>
+</dl>
+    <h4 class="name" id="isValidConnection"><span class="type-signature"></span>isValidConnection<span class="signature">()</span><span class="type-signature"></span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Validate a potential connection.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_graph.mjs.html">js/graph.mjs</a>, <a href="js_graph.mjs.html#line4">line 4</a>
+    </li></ul></dd>
+</dl>
+    <h4 class="name" id="labelAtHalfLength"><span class="type-signature"></span>labelAtHalfLength<span class="signature">()</span><span class="type-signature"></span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Find the point at exactly half the total Manhattan path length.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_edge-path.mjs.html">js/edge-path.mjs</a>, <a href="js_edge-path.mjs.html#line145">line 145</a>
+    </li></ul></dd>
+</dl>
+    <h4 class="name" id="lookupRoute"><span class="type-signature"></span>lookupRoute<span class="signature">()</span><span class="type-signature"></span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>draw.io OrthConnector route generation.
+Uses bit-encoded route patterns + quad rotation + limits clamping.
+Returns waypoint array or null (fallback needed).</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_step-routing.mjs.html">js/step-routing.mjs</a>, <a href="js_step-routing.mjs.html#line96">line 96</a>
+    </li></ul></dd>
+</dl>
+    <h4 class="name" id="rectsOverlap"><span class="type-signature"></span>rectsOverlap<span class="signature">()</span><span class="type-signature"></span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Check if two rectangles overlap.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_geometry.mjs.html">js/geometry.mjs</a>, <a href="js_geometry.mjs.html#line195">line 195</a>
+    </li></ul></dd>
+</dl>
+    <h4 class="name" id="segmentFallback"><span class="type-signature"></span>segmentFallback<span class="signature">()</span><span class="type-signature"></span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>SegmentConnector fallback (draw.io style).
+Used when nodes are too close for OrthConnector (tooShort).</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_step-routing.mjs.html">js/step-routing.mjs</a>, <a href="js_step-routing.mjs.html#line262">line 262</a>
+    </li></ul></dd>
+</dl>
+    <h4 class="name" id="snapPosition"><span class="type-signature"></span>snapPosition<span class="signature">(position, gridSize)</span><span class="type-signature"></span></h4>
+<dl class="details">
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Snap a position to the nearest grid point.</p></li></ul></dd>
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="js_geometry.mjs.html">js/geometry.mjs</a>, <a href="js_geometry.mjs.html#line220">line 220</a>
+    </li></ul></dd>
+</dl>
+    <h5 class="h5-parameters">Parameters:</h5>
+<table class="params">
+    <thead>
+    <tr>
+        <th>Name</th>
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+        <tr>
+                <td class="name"><code>position</code></td>
+            <td class="type">
+<span class="param-type">Object</span>
+            </td>
+            <td class="description last"></td>
+        </tr>
+        <tr>
+                <td class="name"><code>gridSize</code></td>
+            <td class="type">
+<span class="param-type">number</span>
+|
+<span class="param-type">null</span>
+            </td>
+            <td class="description last"><p>Grid cell size (single number for both axes)</p></td>
+        </tr>
+    </tbody>
+</table>
+</article>
+</section>
+</div>
+<br class="clear">
+<footer>
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sun Apr 12 2026 22:18:33 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+</footer>
+<script>prettyPrint();</script>
+<script src="scripts/polyfill.js"></script>
+<script src="scripts/linenumber.js"></script>
+</body>
+</html>