@thi.ng/hiccup-canvas 3.0.0 → 3.0.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-05-08T18:24:32Z
+- **Last updated**: 2024-05-09T14:25:15Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,12 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+### [3.0.1](https://github.com/thi-ng/umbrella/tree/@thi.ng/hiccup-canvas@3.0.1) (2024-05-09)
+
+#### ♻️ Refactoring
+
+- minor update `draw()` arc handling ([e82077e](https://github.com/thi-ng/umbrella/commit/e82077e))
+
 # [3.0.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/hiccup-canvas@3.0.0) (2024-05-08)
 
 #### 🛑 Breaking changes

package/README.md

@@ -25,8 +25,7 @@
 - [Supported shape types](#supported-shape-types)
   - [Group](#group)
   - [Definition group](#definition-group)
-  - [Circle](#circle)
-  - [Circular arc](#circular-arc)
+  - [Circle / circular arc](#circle--circular-arc)
   - [Ellipse / elliptic arc](#ellipse--elliptic-arc)
   - [Rect](#rect)
   - [Line](#line)
@@ -106,7 +105,7 @@ For Node.js REPL:
 const hc = await import("@thi.ng/hiccup-canvas");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 2.55 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 2.54 KB
 
 ## Dependencies
 
@@ -134,7 +133,7 @@ directory are using this package:
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/hdom-canvas-draw.jpg" width="240"/>              | Interactive pattern drawing demo using transducers                       | [Demo](https://demo.thi.ng/umbrella/hdom-canvas-draw/)      | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/hdom-canvas-draw)      |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/hdom-canvas-particles.jpg" width="240"/>         | 2D Bezier curve-guided particle system                                   | [Demo](https://demo.thi.ng/umbrella/hdom-canvas-particles/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/hdom-canvas-particles) |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/hdom-canvas/hdom-canvas-shapes-results.png" width="240"/> | Various hdom-canvas shape drawing examples & SVG conversion / export     | [Demo](https://demo.thi.ng/umbrella/hdom-canvas-shapes/)    | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/hdom-canvas-shapes)    |
-| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/hiccup-canvas-arcs.png" width="240"/>            | Animated arcs & drawing using hiccup-canvas                              | [Demo](https://demo.thi.ng/umbrella/hiccup-canvas-arcs/)    | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/hiccup-canvas-arcs)    |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/hiccup-canvas-arcs.jpg" width="240"/>            | Animated arcs & drawing using hiccup-canvas                              | [Demo](https://demo.thi.ng/umbrella/hiccup-canvas-arcs/)    | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/hiccup-canvas-arcs)    |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/hiccup-canvas-basics.png" width="240"/>          | Basic hiccup-based canvas drawing                                        | [Demo](https://demo.thi.ng/umbrella/hiccup-canvas-basics/)  | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/hiccup-canvas-basics)  |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/poly-subdiv.jpg" width="240"/>                   | Animated, iterative polygon subdivisions & visualization                 | [Demo](https://demo.thi.ng/umbrella/poly-subdiv/)           | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/poly-subdiv)           |
 
@@ -205,27 +204,21 @@ Attributes defined at group level are inherited by child elements.
 Special group / container for [gradient definitions](#gradients). If
 used, should always come first in a scene tree.
 
-### Circle
+### Circle / circular arc
 
 ```ts
-["circle", attribs, [x, y], radius]
+["circle", attribs, [x, y], radius, startTheta?, endTheta?, ccw?]
 ```
 
-### Circular arc
-
-```ts
-["arc", attribs, [x, y], radius, startAngle, endAngle, anticlockwise?]
-```
-
-Please see [note about SVG support](#svg-paths-with-arc-segments).
+Angles in radians. Please see [note about SVG support](#svg-paths-with-arc-segments).
 
 ### Ellipse / elliptic arc
 
 ```ts
-["ellipse", attribs, [x, y], [rx, ry], axisTheta?, start?, end?, ccw?]
+["ellipse", attribs, [x, y], [rx, ry], axisTheta?, startTheta?, endTheta?, ccw?]
 ```
 
-Please see [note about SVG support](#svg-paths-with-arc-segments).
+Angles in radians. Please see [note about SVG support](#svg-paths-with-arc-segments).
 
 ### Rect
 
@@ -312,7 +305,14 @@ however only the latter segment type is compatible with SVG (circular arcs are
 only supported by the HTML Canvas API). We recommended to use one of the
 available path constructor functions in
 [@thi.ng/geom](https://github.com/thi-ng/umbrella/tree/develop/packages/geom) to
-create paths which ensure SVG compatibility:
+create individual arcs or paths which ensure SVG compatibility:
+
+Arcs:
+
+- [`arc()`](https://docs.thi.ng/umbrella/geom/functions/arc-1.html)
+- [`arcFrom2Points()`](https://docs.thi.ng/umbrella/geom/functions/arcFrom2Points.html)
+
+Paths:
 
 - [`pathFromSvg()`](https://docs.thi.ng/umbrella/geom/functions/pathFromSvg.html)
 - [`pathBuilder()`](https://docs.thi.ng/umbrella/geom/functions/pathBuilder-1.html)

package/draw.js

@@ -96,29 +96,27 @@ const draw = (ctx, shape, pstate = { attribs: {}, edits: [] }) => {
       );
       break;
     case "circle":
-      circularArc(ctx, attribs, shape[2], shape[3]);
-      break;
-    case "ellipse":
-      ellipticArc(
+    case "arc":
+      circularArc(
         ctx,
         attribs,
         shape[2],
         shape[3],
         shape[4],
         shape[5],
-        shape[6],
-        shape[7]
+        shape[6]
       );
       break;
-    case "arc":
-      circularArc(
+    case "ellipse":
+      ellipticArc(
         ctx,
         attribs,
         shape[2],
         shape[3],
         shape[4],
         shape[5],
-        shape[6]
+        shape[6],
+        shape[7]
       );
       break;
     case "text":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/hiccup-canvas",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Hiccup shape tree renderer for vanilla Canvas 2D contexts",
   "type": "module",
   "module": "./index.js",
@@ -131,5 +131,5 @@
     ],
     "year": 2018
   },
-  "gitHead": "df34b4a9e650cc7323575356de207d78933bdcf3\n"
+  "gitHead": "41bd769068da804eeace622ec7db50e4d48f1dc9\n"
 }