@retikz/core 0.0.1-rc.0

package/dist/lib/types/coordinate/polar.d.ts

@@ -0,0 +1,5 @@
+/** 笛卡尔坐标（对象形式） */
+export type PolarPosition = {
+    radius: number;
+    angle: number;
+};

package/dist/lib/types/distance/index.d.ts

@@ -0,0 +1,8 @@
+export type CssDistanceType = number | string | undefined;
+/** 四个方向的距离 */
+export type DirectionDistance<T = number> = {
+    left: T;
+    right: T;
+    top: T;
+    bottom: T;
+};

package/dist/lib/types/distance/sep.d.ts

@@ -0,0 +1,9 @@
+import { CssDistanceType, DirectionDistance } from '.';
+/** 快捷属性 */
+export type SepShortcutProps<T = CssDistanceType> = {
+    defaultVal: T;
+    x: T;
+    y: T;
+} & DirectionDistance<T>;
+/** 距离的全部属性 */
+export type SepProps<T = CssDistanceType> = T | SepShortcutProps<T>;

package/dist/lib/types/shape/index.cjs

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+var Area = /* @__PURE__ */ ((Area2) => {
+  Area2["INSIDE"] = "inside";
+  Area2["OUTSIDE"] = "outside";
+  Area2["EDGE"] = "edge";
+  return Area2;
+})(Area || {});
+exports.Area = Area;

package/dist/lib/types/shape/index.d.ts

@@ -0,0 +1,8 @@
+/** 几何体范围：内部，外部，边界线上 */
+export declare enum Area {
+    INSIDE = "inside",
+    OUTSIDE = "outside",
+    EDGE = "edge"
+}
+/** 宽高 */
+export type Size = [number, number];

package/dist/lib/types/shape/rect.cjs

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+var RectVertexPoint = /* @__PURE__ */ ((RectVertexPoint2) => {
+  RectVertexPoint2["TL"] = "top_left";
+  RectVertexPoint2["TR"] = "top_right";
+  RectVertexPoint2["BL"] = "bottom_left";
+  RectVertexPoint2["BR"] = "bottom_right";
+  return RectVertexPoint2;
+})(RectVertexPoint || {});
+var RectMidPoint = /* @__PURE__ */ ((RectMidPoint2) => {
+  RectMidPoint2["T"] = "top_mid";
+  RectMidPoint2["B"] = "bottom_mid";
+  RectMidPoint2["L"] = "left_mid";
+  RectMidPoint2["R"] = "right_mid";
+  return RectMidPoint2;
+})(RectMidPoint || {});
+var RectThirdPoint = /* @__PURE__ */ ((RectThirdPoint2) => {
+  RectThirdPoint2["TL"] = "third_top_left";
+  RectThirdPoint2["TR"] = "third_top_right";
+  RectThirdPoint2["BL"] = "third_bottom_left";
+  RectThirdPoint2["BR"] = "third_bottom_right";
+  RectThirdPoint2["LT"] = "third_left_top";
+  RectThirdPoint2["LB"] = "third_left_bottom";
+  RectThirdPoint2["RT"] = "third_right_top";
+  RectThirdPoint2["RB"] = "third_right_bottom";
+  return RectThirdPoint2;
+})(RectThirdPoint || {});
+exports.RectMidPoint = RectMidPoint;
+exports.RectThirdPoint = RectThirdPoint;
+exports.RectVertexPoint = RectVertexPoint;

package/dist/lib/types/shape/rect.d.ts

@@ -0,0 +1,25 @@
+/** 矩形四个顶点 */
+export declare enum RectVertexPoint {
+    TL = "top_left",
+    TR = "top_right",
+    BL = "bottom_left",
+    BR = "bottom_right"
+}
+/** 矩形四个边的中点 */
+export declare enum RectMidPoint {
+    T = "top_mid",
+    B = "bottom_mid",
+    L = "left_mid",
+    R = "right_mid"
+}
+/** 矩形四边的三等分点 */
+export declare enum RectThirdPoint {
+    TL = "third_top_left",
+    TR = "third_top_right",
+    BL = "third_bottom_left",
+    BR = "third_bottom_right",
+    LT = "third_left_top",
+    LB = "third_left_bottom",
+    RT = "third_right_top",
+    RB = "third_right_bottom"
+}

package/dist/lib/types/svg/font.d.ts

@@ -0,0 +1,10 @@
+export type FontWeight = 'normal' | 'bold' | 'bolder' | 'lighter';
+export type FontProps = {
+    fill?: 'currentColor' | string;
+    fillOpacity?: number;
+    fontSize?: string | number;
+    fontWeight?: FontWeight | number;
+    fontStyle?: 'normal' | 'italic' | 'oblique';
+    fontFamily?: string;
+    fontStretch?: 'normal' | 'condensed' | 'semi-condensed' | 'ultra-condensed' | 'extra-condensed' | 'expanded' | 'semi-expanded' | 'extra-expanded' | 'ultra-expanded' | 'inherit' | 'initial' | 'revert' | 'revert-layer' | 'unset' | string;
+};

package/dist/lib/types/svg/stroke.d.ts

@@ -0,0 +1,10 @@
+export type StrokeProps = {
+    stroke?: string;
+    strokeWidth?: number;
+    strokeDasharray?: string;
+    strokeDashoffset?: string;
+    strokeLinecap?: 'butt' | 'round' | 'square' | 'inherit';
+    strokeLinejoin?: "round" | "inherit" | "bevel" | "miter";
+    strokeMiterlimit?: number;
+    strokeOpacity?: number;
+};

package/dist/lib/types/tikz/index.d.ts

@@ -0,0 +1,6 @@
+import { Ref } from 'react';
+export type TikZKey = string;
+export type TikZProps = {
+    name?: TikZKey;
+    ref?: Ref<SVGGElement>;
+};

package/dist/lib/utils/compare.cjs

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const isSameArray = (arr1, arr2) => {
+  if (arr1.length !== arr2.length) return false;
+  const length = arr1.length;
+  for (let i = 0; i < length; i++) {
+    if (arr1[i] !== arr2[i]) return false;
+  }
+  return true;
+};
+const isSameObj = (obj1, obj2) => {
+  if (Object.keys(obj1).length !== Object.keys(obj2).length) return false;
+  const keys = Object.keys(obj1);
+  for (let i = 0; i < keys.length; i++) {
+    if (obj1[keys[i]] !== obj2[keys[i]]) return false;
+  }
+  return true;
+};
+exports.isSameArray = isSameArray;
+exports.isSameObj = isSameObj;

package/dist/lib/utils/compare.d.ts

@@ -0,0 +1,4 @@
+/** 判断两个数组内容是否相同 */
+export declare const isSameArray: (arr1: unknown[], arr2: unknown[]) => boolean;
+/** 判断两个对象是否相同 */
+export declare const isSameObj: (obj1: Record<string, unknown>, obj2: Record<string, unknown>) => boolean;

package/dist/lib/utils/css.cjs

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const convertCssToPx = (dimension, sizeConfig) => {
+  if (dimension === void 0) return 0;
+  if (typeof dimension === "number") return dimension;
+  const match = dimension.match(/^(\d+(?:\.\d+)?)(px|em|rem|%)$/);
+  const { remPx: remSize = 16, emPx: emSize = 16, parentPx: elementSize = 100 } = sizeConfig || {};
+  if (match) {
+    const value = parseFloat(match[1]);
+    const unit = match[2];
+    switch (unit) {
+      case "px":
+        return value;
+      case "em":
+        return value * (emSize || remSize || 16);
+      case "rem":
+        return value * (remSize || 16);
+      case "%":
+        return elementSize ? value / 100 * elementSize : value;
+      default:
+        return 0;
+    }
+  }
+  return parseInt(dimension);
+};
+exports.convertCssToPx = convertCssToPx;

package/dist/lib/utils/css.d.ts

@@ -0,0 +1,6 @@
+/** 将 CSS 长度转换为像素 */
+export declare const convertCssToPx: (dimension?: string | number, sizeConfig?: {
+    remPx?: number;
+    emPx?: number;
+    parentPx?: number;
+}) => number;

package/dist/lib/utils/math.cjs

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const between = (value, range, equal) => {
+  return equal ? value >= range[0] && value <= range[1] : value > range[0] && value < range[1];
+};
+const convertPrecision = (value, precision, deep = true) => {
+  if (precision === false) return value;
+  const innerConvert = (value2) => {
+    if (precision === 0) return Math.round(value2);
+    const realPrecision = 10 ** precision;
+    return Math.round(value2 * realPrecision) / realPrecision;
+  };
+  if (typeof value === "number") return innerConvert(value);
+  if (Array.isArray(value))
+    return value.map((item) => deep ? innerConvert(item) : typeof item === "number" ? innerConvert(item) : item);
+  if (typeof value === "object" && value !== null) {
+    const result = {};
+    for (const [key, item] of Object.entries(value)) {
+      result[key] = deep ? convertPrecision(item, precision) : typeof item === "number" ? innerConvert(item) : item;
+    }
+    return result;
+  }
+  return value;
+};
+exports.between = between;
+exports.convertPrecision = convertPrecision;

package/dist/lib/utils/math.d.ts

@@ -0,0 +1,9 @@
+/** 判断值是否在范围内 */
+export declare const between: (value: number, range: [number, number], equal?: boolean) => boolean;
+/**
+ * 将数值进行精度调整（主要是为了内存优化）
+ * @value 要调整的值
+ * @precision 要调整的精度
+ * @deep 是否进行深度调整
+ *  */
+export declare const convertPrecision: <T>(value: T, precision: number | false, deep?: boolean) => T;

package/dist/lib/utils/string.cjs

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const textWrapParse = (text, breakMark = "\\n") => {
+  const textArray = text.split(breakMark);
+  return textArray;
+};
+exports.textWrapParse = textWrapParse;

package/dist/lib/utils/string.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 文本换行解析器，将文本根据特定字符分割成数组
+ * 默认的换行标识为：\n
+ * @param text 原始文本
+ * @param breakMark 换行标识
+ */
+export declare const textWrapParse: (text: string, breakMark?: string) => string[];

package/dist/lib/utils/style/font.cjs

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const TikZFontSizeMap = {
+  tiny: "5px",
+  script: "8px",
+  footnote: "10px",
+  small: "12px",
+  normal: "16px",
+  large: "18px",
+  Large: "22px",
+  LARGE: "26px",
+  huge: "30px",
+  Huge: "36px"
+};
+const convertFontSize = (fontSize) => {
+  return typeof fontSize === "string" && TikZFontSizeMap.hasOwnProperty(fontSize) ? TikZFontSizeMap[fontSize] : fontSize;
+};
+const convertFontStyle = (fontStyle) => {
+  switch (fontStyle) {
+    case "bold":
+      return { fontWeight: "bold" };
+    case "italic":
+      return { fontStyle: "italic" };
+    case "serif":
+      return { fontFamily: "serif" };
+    case "sans-serif":
+      return { fontFamily: "sans-serif" };
+    default:
+      return {};
+  }
+};
+exports.TikZFontSizeMap = TikZFontSizeMap;
+exports.convertFontSize = convertFontSize;
+exports.convertFontStyle = convertFontStyle;

package/dist/lib/utils/style/font.d.ts

@@ -0,0 +1,17 @@
+import { FontProps } from '../../types/svg/font';
+export declare const TikZFontSizeMap: {
+    tiny: string;
+    script: string;
+    footnote: string;
+    small: string;
+    normal: string;
+    large: string;
+    Large: string;
+    LARGE: string;
+    huge: string;
+    Huge: string;
+};
+export type TikZFontSize = keyof typeof TikZFontSizeMap;
+export declare const convertFontSize: (fontSize?: string | TikZFontSize | number) => string | number | undefined;
+export type FontStyle = 'bold' | 'italic' | 'serif' | 'sans-serif';
+export declare const convertFontStyle: (fontStyle?: FontStyle) => Partial<FontProps>;

package/dist/lib/utils/style/stroke.cjs

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const convertStrokeType = (strokeType, strokeWidth = 1) => {
+  switch (strokeType) {
+    case "solid":
+      return {};
+    case "dashed":
+      return { strokeDasharray: `${strokeWidth * 4} ${strokeWidth * 4}` };
+    case "denselyDashed":
+      return { strokeDasharray: `${strokeWidth * 4} ${strokeWidth * 2}` };
+    case "looselyDashed":
+      return { strokeDasharray: `${strokeWidth * 4} ${strokeWidth * 6}` };
+    case "dotted":
+      return { strokeDasharray: `1 ${strokeWidth * 4}` };
+    case "denselyDotted":
+      return { strokeDasharray: `1 ${strokeWidth * 2}` };
+    case "looselyDotted":
+      return { strokeDasharray: `1 ${strokeWidth * 6}` };
+    case "dashDot":
+      return { strokeDasharray: `${strokeWidth * 4} ${strokeWidth * 4} 1 ${strokeWidth * 4}` };
+    case "denselyDashDot":
+      return { strokeDasharray: `${strokeWidth * 4} ${strokeWidth * 2} 1 ${strokeWidth * 2}` };
+    case "looselyDashDot":
+      return { strokeDasharray: `${strokeWidth * 4} ${strokeWidth * 6} 1 ${strokeWidth * 6}` };
+    case "dashDashDot":
+      return { strokeDasharray: `${strokeWidth * 4} ${strokeWidth * 4} 1 ${strokeWidth * 4} 1 ${strokeWidth * 4}` };
+    case "denselyDashDashDot":
+      return { strokeDasharray: `${strokeWidth * 4} ${strokeWidth * 2} 1 ${strokeWidth * 2} 1 ${strokeWidth * 2}` };
+    case "looselyDashDashDot":
+      return { strokeDasharray: `${strokeWidth * 4} ${strokeWidth * 6} 1 ${strokeWidth * 6} 1 ${strokeWidth * 6}` };
+  }
+};
+const convertStrokeShortcut = (shortcutProps, strokeWidth = 1) => {
+  return convertStrokeType(
+    shortcutProps.dashed ? "dashed" : shortcutProps.denselyDashed ? "denselyDashed" : shortcutProps.looselyDashed ? "looselyDashed" : shortcutProps.dotted ? "dotted" : shortcutProps.denselyDotted ? "denselyDotted" : shortcutProps.looselyDotted ? "looselyDotted" : shortcutProps.dashDot ? "dashDot" : shortcutProps.denselyDashDot ? "denselyDashDot" : shortcutProps.looselyDashDot ? "looselyDashDot" : shortcutProps.dashDashDot ? "dashDashDot" : shortcutProps.denselyDashDashDot ? "denselyDashDashDot" : shortcutProps.looselyDashDashDot ? "looselyDashDashDot" : "solid",
+    strokeWidth || 1
+  );
+};
+exports.convertStrokeShortcut = convertStrokeShortcut;
+exports.convertStrokeType = convertStrokeType;

package/dist/lib/utils/style/stroke.d.ts

@@ -0,0 +1,19 @@
+import { StrokeProps } from '../../types/svg/stroke';
+export type StrokeType = 'solid' | 'dashed' | 'denselyDashed' | 'looselyDashed' | 'dotted' | 'denselyDotted' | 'looselyDotted' | 'dashDot' | 'denselyDashDot' | 'looselyDashDot' | 'dashDashDot' | 'denselyDashDashDot' | 'looselyDashDashDot';
+export type StrokeShortcutProps = {
+    dashed?: boolean;
+    denselyDashed?: boolean;
+    looselyDashed?: boolean;
+    dotted?: boolean;
+    denselyDotted?: boolean;
+    looselyDotted?: boolean;
+    dashDot?: boolean;
+    denselyDashDot?: boolean;
+    looselyDashDot?: boolean;
+    dashDashDot?: boolean;
+    denselyDashDashDot?: boolean;
+    looselyDashDashDot?: boolean;
+};
+/** 将 StrokeType 转换为 svg 原生的属性 */
+export declare const convertStrokeType: (strokeType: StrokeType, strokeWidth?: number) => Partial<StrokeProps>;
+export declare const convertStrokeShortcut: (shortcutProps: StrokeShortcutProps, strokeWidth?: number) => Partial<StrokeProps>;

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@retikz/core",
+  "version": "0.0.1-rc.0",
+  "description": "atomic drawing library implemented using react and d3, inspired by tikz",
+  "type": "module",
+  "keywords": [
+    "react",
+    "tikz",
+    "chart"
+  ],
+  "license": "MIT",
+  "repository": "https://github.com/Pionpill/retikz",
+  "main": "dist/lib/index.js",
+  "module": "dist/es/index.js",
+  "types": "dist/lib/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "LICENSE",
+    "README.md",
+    "dist/**/*"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "peerDependencies": {
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
+  },
+  "dependencies": {
+    "d3-color": "^3.1.0",
+    "d3-shape": "^3.2.0",
+    "react": "^19",
+    "react-dom": "^19"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.15.0",
+    "@types/d3-color": "^3.1.3",
+    "@types/d3-shape": "^3.1.6",
+    "@types/node": "^22.10.7",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "@vitejs/plugin-react": "^4.3.4",
+    "eslint": "^9.15.0",
+    "eslint-plugin-react-hooks": "^5.0.0",
+    "eslint-plugin-react-refresh": "^0.4.14",
+    "globals": "^15.12.0",
+    "typescript": "~5.6.2",
+    "typescript-eslint": "^8.15.0",
+    "vite": "^6.0.1",
+    "vite-plugin-dts": "^4.5.0"
+  }
+}