rendx-path 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present wei.liang (https://github.com/weiliang0121)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/main.cjs

@@ -0,0 +1,131 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+
+// src/main.ts
+var main_exports = {};
+__export(main_exports, {
+  Path: () => Path
+});
+module.exports = __toCommonJS(main_exports);
+
+// src/path.ts
+var _d;
+var Path = class {
+  constructor() {
+    __privateAdd(this, _d, "");
+  }
+  /** 返回完整路径字符串 */
+  toString() {
+    return __privateGet(this, _d);
+  }
+  /** 清空路径 */
+  clear() {
+    __privateSet(this, _d, "");
+  }
+  // 相对坐标命令
+  h(x) {
+    __privateSet(this, _d, __privateGet(this, _d) + `h${x} `);
+    return this;
+  }
+  v(y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `v${y} `);
+    return this;
+  }
+  l(x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `l${x} ${y} `);
+    return this;
+  }
+  q(x1, y1, x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `q${x1} ${y1} ${x} ${y} `);
+    return this;
+  }
+  c(x1, y1, x2, y2, x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `c${x1} ${y1} ${x2} ${y2} ${x} ${y} `);
+    return this;
+  }
+  a(rx, ry, angle, largeArcFlag, sweepFlag, x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `a${rx} ${ry} ${angle} ${largeArcFlag} ${sweepFlag} ${x} ${y} `);
+    return this;
+  }
+  // 绝对坐标命令
+  M(x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `M${x} ${y} `);
+    return this;
+  }
+  H(x) {
+    __privateSet(this, _d, __privateGet(this, _d) + `H${x} `);
+    return this;
+  }
+  V(y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `V${y} `);
+    return this;
+  }
+  L(x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `L${x} ${y} `);
+    return this;
+  }
+  Q(x1, y1, x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `Q${x1} ${y1} ${x} ${y} `);
+    return this;
+  }
+  /**
+   * 绝对坐标三次贝塞尔曲线
+   * @param x1 - 控制点1 X
+   * @param y1 - 控制点1 Y
+   * @param x2 - 控制点2 X
+   * @param y2 - 控制点2 Y
+   * @param x - 终点 X
+   * @param y - 终点 Y
+   */
+  C(x1, y1, x2, y2, x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `C${x1} ${y1} ${x2} ${y2} ${x} ${y} `);
+    return this;
+  }
+  /**
+   * 绝对坐标椭圆弧
+   * @param rx - X 轴半径
+   * @param ry - Y 轴半径
+   * @param angle - X 轴旋转角度
+   * @param largeArcFlag - 大弧标志 (0|1)
+   * @param sweepFlag - 顺时针标志 (0|1)
+   * @param x - 终点 X
+   * @param y - 终点 Y
+   */
+  A(rx, ry, angle, largeArcFlag, sweepFlag, x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `A${rx} ${ry} ${angle} ${largeArcFlag} ${sweepFlag} ${x} ${y} `);
+    return this;
+  }
+  // 闭合路径
+  Z() {
+    __privateSet(this, _d, __privateGet(this, _d) + "Z ");
+    return this;
+  }
+};
+_d = new WeakMap();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Path
+});

package/dist/main.d.cts

@@ -0,0 +1,60 @@
+/**
+ * SVG 路径命令构建器
+ *
+ * 使用直接字符串拼接（+=）替代 string[] + join，
+ * V8 引擎对 += 使用 cons string（rope）优化，amortized O(1)，
+ * 消除了数组分配、push 和 join 的开销。
+ */
+/**
+ * SVG 路径命令构建器，链式 API 生成 SVG path d 属性。
+ * 内部使用字符串拼接（`+=`）优化性能。
+ *
+ * @example
+ * ```ts
+ * const p = new Path();
+ * p.M(0, 0).L(100, 0).L(100, 100).Z();
+ * p.toString(); // "M0 0 L100 0 L100 100 Z "
+ * ```
+ */
+declare class Path {
+    #private;
+    /** 返回完整路径字符串 */
+    toString(): string;
+    /** 清空路径 */
+    clear(): void;
+    h(x: number): this;
+    v(y: number): this;
+    l(x: number, y: number): this;
+    q(x1: number, y1: number, x: number, y: number): this;
+    c(x1: number, y1: number, x2: number, y2: number, x: number, y: number): this;
+    a(rx: number, ry: number, angle: number, largeArcFlag: number, sweepFlag: number, x: number, y: number): this;
+    M(x: number, y: number): this;
+    H(x: number): this;
+    V(y: number): this;
+    L(x: number, y: number): this;
+    Q(x1: number, y1: number, x: number, y: number): this;
+    /**
+     * 绝对坐标三次贝塞尔曲线
+     * @param x1 - 控制点1 X
+     * @param y1 - 控制点1 Y
+     * @param x2 - 控制点2 X
+     * @param y2 - 控制点2 Y
+     * @param x - 终点 X
+     * @param y - 终点 Y
+     */
+    C(x1: number, y1: number, x2: number, y2: number, x: number, y: number): this;
+    /**
+     * 绝对坐标椭圆弧
+     * @param rx - X 轴半径
+     * @param ry - Y 轴半径
+     * @param angle - X 轴旋转角度
+     * @param largeArcFlag - 大弧标志 (0|1)
+     * @param sweepFlag - 顺时针标志 (0|1)
+     * @param x - 终点 X
+     * @param y - 终点 Y
+     */
+    A(rx: number, ry: number, angle: number, largeArcFlag: number, sweepFlag: number, x: number, y: number): this;
+    Z(): this;
+}
+
+export { Path };

package/dist/main.d.ts

@@ -0,0 +1,60 @@
+/**
+ * SVG 路径命令构建器
+ *
+ * 使用直接字符串拼接（+=）替代 string[] + join，
+ * V8 引擎对 += 使用 cons string（rope）优化，amortized O(1)，
+ * 消除了数组分配、push 和 join 的开销。
+ */
+/**
+ * SVG 路径命令构建器，链式 API 生成 SVG path d 属性。
+ * 内部使用字符串拼接（`+=`）优化性能。
+ *
+ * @example
+ * ```ts
+ * const p = new Path();
+ * p.M(0, 0).L(100, 0).L(100, 100).Z();
+ * p.toString(); // "M0 0 L100 0 L100 100 Z "
+ * ```
+ */
+declare class Path {
+    #private;
+    /** 返回完整路径字符串 */
+    toString(): string;
+    /** 清空路径 */
+    clear(): void;
+    h(x: number): this;
+    v(y: number): this;
+    l(x: number, y: number): this;
+    q(x1: number, y1: number, x: number, y: number): this;
+    c(x1: number, y1: number, x2: number, y2: number, x: number, y: number): this;
+    a(rx: number, ry: number, angle: number, largeArcFlag: number, sweepFlag: number, x: number, y: number): this;
+    M(x: number, y: number): this;
+    H(x: number): this;
+    V(y: number): this;
+    L(x: number, y: number): this;
+    Q(x1: number, y1: number, x: number, y: number): this;
+    /**
+     * 绝对坐标三次贝塞尔曲线
+     * @param x1 - 控制点1 X
+     * @param y1 - 控制点1 Y
+     * @param x2 - 控制点2 X
+     * @param y2 - 控制点2 Y
+     * @param x - 终点 X
+     * @param y - 终点 Y
+     */
+    C(x1: number, y1: number, x2: number, y2: number, x: number, y: number): this;
+    /**
+     * 绝对坐标椭圆弧
+     * @param rx - X 轴半径
+     * @param ry - Y 轴半径
+     * @param angle - X 轴旋转角度
+     * @param largeArcFlag - 大弧标志 (0|1)
+     * @param sweepFlag - 顺时针标志 (0|1)
+     * @param x - 终点 X
+     * @param y - 终点 Y
+     */
+    A(rx: number, ry: number, angle: number, largeArcFlag: number, sweepFlag: number, x: number, y: number): this;
+    Z(): this;
+}
+
+export { Path };

package/dist/main.js

@@ -0,0 +1,105 @@
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+
+// src/path.ts
+var _d;
+var Path = class {
+  constructor() {
+    __privateAdd(this, _d, "");
+  }
+  /** 返回完整路径字符串 */
+  toString() {
+    return __privateGet(this, _d);
+  }
+  /** 清空路径 */
+  clear() {
+    __privateSet(this, _d, "");
+  }
+  // 相对坐标命令
+  h(x) {
+    __privateSet(this, _d, __privateGet(this, _d) + `h${x} `);
+    return this;
+  }
+  v(y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `v${y} `);
+    return this;
+  }
+  l(x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `l${x} ${y} `);
+    return this;
+  }
+  q(x1, y1, x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `q${x1} ${y1} ${x} ${y} `);
+    return this;
+  }
+  c(x1, y1, x2, y2, x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `c${x1} ${y1} ${x2} ${y2} ${x} ${y} `);
+    return this;
+  }
+  a(rx, ry, angle, largeArcFlag, sweepFlag, x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `a${rx} ${ry} ${angle} ${largeArcFlag} ${sweepFlag} ${x} ${y} `);
+    return this;
+  }
+  // 绝对坐标命令
+  M(x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `M${x} ${y} `);
+    return this;
+  }
+  H(x) {
+    __privateSet(this, _d, __privateGet(this, _d) + `H${x} `);
+    return this;
+  }
+  V(y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `V${y} `);
+    return this;
+  }
+  L(x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `L${x} ${y} `);
+    return this;
+  }
+  Q(x1, y1, x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `Q${x1} ${y1} ${x} ${y} `);
+    return this;
+  }
+  /**
+   * 绝对坐标三次贝塞尔曲线
+   * @param x1 - 控制点1 X
+   * @param y1 - 控制点1 Y
+   * @param x2 - 控制点2 X
+   * @param y2 - 控制点2 Y
+   * @param x - 终点 X
+   * @param y - 终点 Y
+   */
+  C(x1, y1, x2, y2, x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `C${x1} ${y1} ${x2} ${y2} ${x} ${y} `);
+    return this;
+  }
+  /**
+   * 绝对坐标椭圆弧
+   * @param rx - X 轴半径
+   * @param ry - Y 轴半径
+   * @param angle - X 轴旋转角度
+   * @param largeArcFlag - 大弧标志 (0|1)
+   * @param sweepFlag - 顺时针标志 (0|1)
+   * @param x - 终点 X
+   * @param y - 终点 Y
+   */
+  A(rx, ry, angle, largeArcFlag, sweepFlag, x, y) {
+    __privateSet(this, _d, __privateGet(this, _d) + `A${rx} ${ry} ${angle} ${largeArcFlag} ${sweepFlag} ${x} ${y} `);
+    return this;
+  }
+  // 闭合路径
+  Z() {
+    __privateSet(this, _d, __privateGet(this, _d) + "Z ");
+    return this;
+  }
+};
+_d = new WeakMap();
+export {
+  Path
+};

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "rendx-path",
+  "version": "0.1.0",
+  "description": "SVG path builder and parser",
+  "license": "MIT",
+  "author": "wei.liang (https://github.com/weiliang0121)",
+  "type": "module",
+  "keywords": [
+    "rendx",
+    "2d",
+    "canvas",
+    "rendering",
+    "visualization",
+    "scene-graph"
+  ],
+  "homepage": "https://weiliang0121.github.io/rendx/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/weiliang0121/rendx.git",
+    "directory": "packages/path"
+  },
+  "main": "dist/main.cjs",
+  "module": "dist/main.js",
+  "types": "dist/main.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/main.d.ts",
+      "import": "./dist/main.js",
+      "require": "./dist/main.cjs"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  }
+}