svg-path-commander 2.1.3 → 2.1.5

package/src/process/transformPath.ts

@@ -1,114 +0,0 @@
-import getSVGMatrix from './getSVGMatrix';
-import projection2d from './projection2d';
-import defaultOptions from '../options/options';
-import type { AbsoluteArray, AbsoluteSegment, CSegment, LSegment, PathArray, TransformObjectValues } from '../types';
-import type { TransformObject } from '../interface';
-import iterate from './iterate';
-import parsePathString from '../parser/parsePathString';
-import absolutizeSegment from './absolutizeSegment';
-import arcToCubic from './arcToCubic';
-
-/**
- * Apply a 2D / 3D transformation to a `pathArray` instance.
- *
- * Since *SVGElement* doesn't support 3D transformation, this function
- * creates a 2D projection of the <path> element.
- *
- * @param path the `pathArray` to apply transformation
- * @param transform the transform functions `Object`
- * @returns the resulted `pathArray`
- */
-const transformPath = (pathInput: PathArray | string, transform?: Partial<TransformObject>) => {
-  // last x and y transformed values
-  let x = 0;
-  let y = 0;
-  // new x and y transformed
-  let lx = 0;
-  let ly = 0;
-  // segment params iteration index and length
-  let j = 0;
-  let jj = 0;
-  let pathCommand = 'M';
-  // transform uses it's own set of params
-  const path = parsePathString(pathInput);
-  const transformProps = transform && Object.keys(transform);
-
-  // when used as a static method, invalidate somehow
-  if (!transform || (transformProps && !transformProps.length)) return path.slice(0) as typeof path;
-
-  // transform origin is extremely important
-  if (!transform.origin) {
-    Object.assign(transform, { origin: defaultOptions.origin });
-  }
-  const origin = transform.origin as [number, number, number];
-  const matrixInstance = getSVGMatrix(transform as TransformObjectValues);
-
-  if (matrixInstance.isIdentity) return path.slice(0) as typeof path;
-
-  return iterate<AbsoluteArray>(path, (seg, index, lastX, lastY) => {
-    [pathCommand] = seg;
-    const absCommand = pathCommand.toUpperCase();
-    const isRelative = absCommand !== pathCommand;
-    const absoluteSegment = isRelative
-      ? absolutizeSegment(seg, index, lastX, lastY)
-      : (seg.slice(0) as AbsoluteSegment);
-
-    let result =
-      absCommand === 'A'
-        ? // ? segmentToCubic(absoluteSegment, transformParams)
-          (['C' as string | number].concat(
-            arcToCubic(
-              lastX,
-              lastY,
-              absoluteSegment[1] as number,
-              absoluteSegment[2] as number,
-              absoluteSegment[3] as number,
-              absoluteSegment[4] as number,
-              absoluteSegment[5] as number,
-              absoluteSegment[6] as number,
-              absoluteSegment[7] as number,
-            ),
-          ) as CSegment)
-        : absCommand === 'V'
-        ? (['L', lastX, absoluteSegment[1]] as LSegment)
-        : absCommand === 'H'
-        ? (['L', absoluteSegment[1], lastY] as LSegment)
-        : absoluteSegment;
-
-    // update pathCommand
-    pathCommand = result[0];
-    const isLongArc = pathCommand === 'C' && result.length > 7;
-    const tempSegment = (isLongArc ? result.slice(0, 7) : result.slice(0)) as AbsoluteSegment;
-
-    if (isLongArc) {
-      path.splice(index + 1, 0, ['C' as typeof pathCommand | number].concat(result.slice(7)) as CSegment);
-      result = tempSegment as CSegment;
-    }
-
-    if (pathCommand === 'L') {
-      [lx, ly] = projection2d(matrixInstance, [(result as LSegment)[1], (result as LSegment)[2]], origin);
-
-      /* istanbul ignore else @preserve */
-      if (x !== lx && y !== ly) {
-        result = ['L', lx, ly];
-      } else if (y === ly) {
-        result = ['H', lx];
-      } else if (x === lx) {
-        result = ['V', ly];
-      }
-    } else {
-      for (j = 1, jj = result.length; j < jj; j += 2) {
-        [lx, ly] = projection2d(matrixInstance, [+result[j], +result[j + 1]], origin);
-        result[j] = lx;
-        result[j + 1] = ly;
-      }
-    }
-    // now update x and y
-    x = lx;
-    y = ly;
-
-    return result;
-  });
-};
-
-export default transformPath;

package/src/types.ts

@@ -1,228 +0,0 @@
-import type { LineAttr, CircleAttr, PolyAttr, RectAttr, EllipseAttr, GlyphAttr, TransformObject } from './interface';
-
-export type SpaceNumber =
-  | 0x1680
-  | 0x180e
-  | 0x2000
-  | 0x2001
-  | 0x2002
-  | 0x2003
-  | 0x2004
-  | 0x2005
-  | 0x2006
-  | 0x2007
-  | 0x2008
-  | 0x2009
-  | 0x200a
-  | 0x202f
-  | 0x205f
-  | 0x3000
-  | 0xfeff
-  | 0x0a
-  | 0x0d
-  | 0x2028
-  | 0x2029
-  | 0x20
-  | 0x09
-  | 0x0b
-  | 0x0c
-  | 0xa0
-  | 0x1680;
-
-export type PathCommandNumber = 0x6d | 0x7a | 0x6c | 0x68 | 0x76 | 0x63 | 0x73 | 0x71 | 0x74 | 0x61;
-
-export type DigitNumber = 0x30 | 0x31 | 0x32 | 0x33 | 0x34 | 0x35 | 0x36 | 0x37 | 0x38 | 0x39;
-
-// custom types
-export type MCommand = 'M';
-export type mCommand = 'm';
-
-export type LCommand = 'L';
-export type lCommand = 'l';
-
-export type VCommand = 'V';
-export type vCommand = 'v';
-
-export type HCommand = 'H';
-export type hCommand = 'h';
-
-export type ZCommand = 'Z';
-export type zCommand = 'z';
-
-export type CCommand = 'C';
-export type cCommand = 'c';
-
-export type SCommand = 'S';
-export type sCommand = 's';
-
-export type QCommand = 'Q';
-export type qCommand = 'q';
-
-export type TCommand = 'T';
-export type tCommand = 't';
-
-export type ACommand = 'A';
-export type aCommand = 'a';
-
-export type AbsoluteCommand =
-  | MCommand
-  | LCommand
-  | VCommand
-  | HCommand
-  | ZCommand
-  | CCommand
-  | SCommand
-  | QCommand
-  | TCommand
-  | ACommand;
-
-export type RelativeCommand =
-  | mCommand
-  | lCommand
-  | vCommand
-  | hCommand
-  | zCommand
-  | cCommand
-  | sCommand
-  | qCommand
-  | tCommand
-  | aCommand;
-
-export type PathCommand = AbsoluteCommand | RelativeCommand;
-
-export type MSegment = [MCommand, number, number];
-export type mSegment = [mCommand, number, number];
-export type MoveSegment = MSegment | mSegment;
-
-export type LSegment = [LCommand, number, number];
-export type lSegment = [lCommand, number, number];
-export type LineSegment = LSegment | lSegment;
-
-export type VSegment = [VCommand, number];
-export type vSegment = [vCommand, number];
-export type VertLineSegment = vSegment | VSegment;
-
-export type HSegment = [HCommand, number];
-export type hSegment = [hCommand, number];
-export type HorLineSegment = HSegment | hSegment;
-
-export type ZSegment = [ZCommand];
-export type zSegment = [zCommand];
-export type CloseSegment = ZSegment | zSegment;
-
-export type CSegment = [CCommand, number, number, number, number, number, number];
-export type cSegment = [cCommand, number, number, number, number, number, number];
-export type CubicSegment = CSegment | cSegment;
-
-export type SSegment = [SCommand, number, number, number, number];
-export type sSegment = [sCommand, number, number, number, number];
-export type ShortCubicSegment = SSegment | sSegment;
-
-export type QSegment = [QCommand, number, number, number, number];
-export type qSegment = [qCommand, number, number, number, number];
-export type QuadSegment = QSegment | qSegment;
-
-export type TSegment = [TCommand, number, number];
-export type tSegment = [tCommand, number, number];
-export type ShortQuadSegment = TSegment | tSegment;
-
-export type ASegment = [ACommand, number, number, number, number, number, number, number];
-export type aSegment = [aCommand, number, number, number, number, number, number, number];
-export type ArcSegment = ASegment | aSegment;
-
-export type PathSegment =
-  | MoveSegment
-  | LineSegment
-  | VertLineSegment
-  | HorLineSegment
-  | CloseSegment
-  | CubicSegment
-  | ShortCubicSegment
-  | QuadSegment
-  | ShortQuadSegment
-  | ArcSegment;
-
-export type ShortSegment = VertLineSegment | HorLineSegment | ShortCubicSegment | ShortQuadSegment | CloseSegment;
-
-export type AbsoluteSegment =
-  | MSegment
-  | LSegment
-  | VSegment
-  | HSegment
-  | CSegment
-  | SSegment
-  | QSegment
-  | TSegment
-  | ASegment
-  | ZSegment;
-
-export type RelativeSegment =
-  | mSegment
-  | lSegment
-  | vSegment
-  | hSegment
-  | cSegment
-  | sSegment
-  | qSegment
-  | tSegment
-  | aSegment
-  | zSegment;
-
-export type NormalSegment = MSegment | LSegment | CSegment | QSegment | ASegment | ZSegment;
-
-export type PathArray = [MSegment | mSegment, ...PathSegment[]];
-export type AbsoluteArray = [MSegment, ...AbsoluteSegment[]];
-export type RelativeArray = [MSegment, ...RelativeSegment[]];
-export type NormalArray = [MSegment, ...NormalSegment[]];
-export type CurveArray = [MSegment, ...CSegment[]];
-export type PolygonArray = [MSegment, ...LSegment[], ZSegment];
-export type PolylineArray = [MSegment, ...LSegment[]];
-
-export type ShapeTypes =
-  | SVGPolylineElement
-  | SVGPolygonElement
-  | SVGLineElement
-  | SVGEllipseElement
-  | SVGCircleElement
-  | SVGRectElement;
-
-export type ShapeTags = 'line' | 'polyline' | 'polygon' | 'ellipse' | 'circle' | 'rect' | 'glyph';
-
-export type ShapeOps = LineAttr | PolyAttr | PolyAttr | EllipseAttr | CircleAttr | RectAttr | GlyphAttr;
-
-export type TransformObjectValues = Partial<TransformObject> & { origin: [number, number, number] };
-
-export type Point = {
-  x: number;
-  y: number;
-};
-
-export type PointTuple = [number, number];
-
-export type DerivedPoint = Point & { t: number };
-export type QuadPoints = [Point, Point, Point, Point, Point, Point];
-export type CubicPoints = [Point, Point, Point, Point, Point, Point, Point, Point];
-export type DerivedQuadPoints = [DerivedPoint, DerivedPoint, DerivedPoint, DerivedPoint, DerivedPoint, DerivedPoint];
-export type DerivedCubicPoints = [
-  DerivedPoint,
-  DerivedPoint,
-  DerivedPoint,
-  DerivedPoint,
-  DerivedPoint,
-  DerivedPoint,
-  DerivedPoint,
-  DerivedPoint,
-];
-export type QuadCoordinates = [number, number, number, number, number, number];
-export type CubicCoordinates = [number, number, number, number, number, number, number, number];
-export type ArcCoordinates = [number, number, number, number, number, number, number, number, number];
-export type LineCoordinates = [number, number, number, number];
-
-export type DeriveCallback = (t: number) => Point;
-
-export type IteratorCallback = (
-  segment: PathSegment,
-  index: number,
-  lastX: number,
-  lastY: number,
-) => PathSegment | false | void | undefined;

package/src/util/distanceEpsilon.ts

@@ -1,3 +0,0 @@
-const DISTANCE_EPSILON = 0.00001;
-
-export default DISTANCE_EPSILON;

package/src/util/getClosestPoint.ts

@@ -1,15 +0,0 @@
-import type { PathArray } from '../types';
-import getPropertiesAtPoint from './getPropertiesAtPoint';
-
-/**
- * Returns the point in path closest to a given point.
- *
- * @param pathInput target `pathArray`
- * @param point the given point
- * @returns the best match
- */
-const getClosestPoint = (pathInput: string | PathArray, point: { x: number; y: number }) => {
-  return getPropertiesAtPoint(pathInput, point).closest;
-};
-
-export default getClosestPoint;

package/src/util/getDrawDirection.ts

@@ -1,16 +0,0 @@
-import getPathArea from './getPathArea';
-import pathToCurve from '../convert/pathToCurve';
-import type { PathArray } from '../types';
-
-/**
- * Check if a path is drawn clockwise and returns true if so,
- * false otherwise.
- *
- * @param path the path string or `pathArray`
- * @returns true when clockwise or false if not
- */
-const getDrawDirection = (path: string | PathArray) => {
-  return getPathArea(pathToCurve(path)) >= 0;
-};
-
-export default getDrawDirection;

package/src/util/getPathArea.ts

@@ -1,70 +0,0 @@
-import pathToCurve from '../convert/pathToCurve';
-import type { PointTuple, PathArray } from '../types';
-
-/**
- * Returns the area of a single cubic-bezier segment.
- *
- * http://objectmix.com/graphics/133553-area-closed-bezier-curve.html
- *
- * @param x1 the starting point X
- * @param y1 the starting point Y
- * @param c1x the first control point X
- * @param c1y the first control point Y
- * @param c2x the second control point X
- * @param c2y the second control point Y
- * @param x2 the ending point X
- * @param y2 the ending point Y
- * @returns the area of the cubic-bezier segment
- */
-const getCubicSegArea = (
-  x1: number,
-  y1: number,
-  c1x: number,
-  c1y: number,
-  c2x: number,
-  c2y: number,
-  x2: number,
-  y2: number,
-) => {
-  return (
-    (3 *
-      ((y2 - y1) * (c1x + c2x) -
-        (x2 - x1) * (c1y + c2y) +
-        c1y * (x1 - c2x) -
-        c1x * (y1 - c2y) +
-        y2 * (c2x + x1 / 3) -
-        x2 * (c2y + y1 / 3))) /
-    20
-  );
-};
-
-/**
- * Returns the area of a shape.
- *
- * @author Jürg Lehni & Jonathan Puckey
- *
- * @see https://github.com/paperjs/paper.js/blob/develop/src/path/Path.js
- *
- * @param path the shape `pathArray`
- * @returns the length of the cubic-bezier segment
- */
-const getPathArea = (path: PathArray) => {
-  let x = 0;
-  let y = 0;
-  let len = 0;
-
-  return pathToCurve(path)
-    .map(seg => {
-      switch (seg[0]) {
-        case 'M':
-          [, x, y] = seg;
-          return 0;
-        default:
-          len = getCubicSegArea(x, y, seg[1], seg[2], seg[3], seg[4], seg[5], seg[6]);
-          [x, y] = seg.slice(-2) as PointTuple;
-          return len;
-      }
-    })
-    .reduce((a, b) => a + b, 0);
-};
-export default getPathArea;

package/src/util/getPathBBox.ts

@@ -1,171 +0,0 @@
-import iterate from '../process/iterate';
-import { PathBBox } from '../interface';
-import { LSegment, MSegment, PathArray, PointTuple } from '../types';
-import { getLineBBox } from '../math/lineTools';
-import { getArcBBox } from '../math/arcTools';
-import { getCubicBBox } from '../math/cubicTools';
-import { getQuadBBox } from '../math/quadTools';
-import parsePathString from '../parser/parsePathString';
-import absolutizeSegment from '../process/absolutizeSegment';
-
-const getPathBBox = (pathInput: PathArray | string) => {
-  if (!pathInput) {
-    return {
-      x: 0,
-      y: 0,
-      width: 0,
-      height: 0,
-      x2: 0,
-      y2: 0,
-      cx: 0,
-      cy: 0,
-      cz: 0,
-    };
-  }
-
-  const path = parsePathString(pathInput);
-  let pathCommand = 'M';
-  let mx = 0;
-  let my = 0;
-  const { max, min } = Math;
-  let xMin = Infinity;
-  let yMin = Infinity;
-  let xMax = -Infinity;
-  let yMax = -Infinity;
-  let minX = 0;
-  let minY = 0;
-  let maxX = 0;
-  let maxY = 0;
-  let paramX1 = 0;
-  let paramY1 = 0;
-  let paramX2 = 0;
-  let paramY2 = 0;
-  let paramQX = 0;
-  let paramQY = 0;
-
-  iterate(path, (seg, index, lastX, lastY) => {
-    [pathCommand] = seg;
-    const absCommand = pathCommand.toUpperCase();
-    const isRelative = absCommand !== pathCommand;
-    const absoluteSegment = isRelative ? absolutizeSegment(seg, index, lastX, lastY) : (seg.slice(0) as typeof seg);
-
-    const normalSegment =
-      absCommand === 'V'
-        ? (['L', lastX, absoluteSegment[1]] as LSegment)
-        : absCommand === 'H'
-        ? (['L', absoluteSegment[1], lastY] as LSegment)
-        : absoluteSegment;
-
-    [pathCommand] = normalSegment;
-
-    if (!'TQ'.includes(absCommand)) {
-      // optional but good to be cautious
-      paramQX = 0;
-      paramQY = 0;
-    }
-
-    // this segment is always ZERO
-    /* istanbul ignore else @preserve */
-    if (pathCommand === 'M') {
-      [, mx, my] = normalSegment as MSegment;
-      minX = mx;
-      minY = my;
-      maxX = mx;
-      maxY = my;
-    } else if (pathCommand === 'L') {
-      [minX, minY, maxX, maxY] = getLineBBox(lastX, lastY, normalSegment[1] as number, normalSegment[2] as number);
-    } else if (pathCommand === 'A') {
-      [minX, minY, maxX, maxY] = getArcBBox(
-        lastX,
-        lastY,
-        normalSegment[1] as number,
-        normalSegment[2] as number,
-        normalSegment[3] as number,
-        normalSegment[4] as number,
-        normalSegment[5] as number,
-        normalSegment[6] as number,
-        normalSegment[7] as number,
-      );
-    } else if (pathCommand === 'S') {
-      const cp1x = paramX1 * 2 - paramX2;
-      const cp1y = paramY1 * 2 - paramY2;
-
-      [minX, minY, maxX, maxY] = getCubicBBox(
-        lastX,
-        lastY,
-        cp1x,
-        cp1y,
-        normalSegment[1] as number,
-        normalSegment[2] as number,
-        normalSegment[3] as number,
-        normalSegment[4] as number,
-      );
-    } else if (pathCommand === 'C') {
-      [minX, minY, maxX, maxY] = getCubicBBox(
-        lastX,
-        lastY,
-        normalSegment[1] as number,
-        normalSegment[2] as number,
-        normalSegment[3] as number,
-        normalSegment[4] as number,
-        normalSegment[5] as number,
-        normalSegment[6] as number,
-      );
-    } else if (pathCommand === 'T') {
-      paramQX = paramX1 * 2 - paramQX;
-      paramQY = paramY1 * 2 - paramQY;
-      [minX, minY, maxX, maxY] = getQuadBBox(
-        lastX,
-        lastY,
-        paramQX,
-        paramQY,
-        normalSegment[1] as number,
-        normalSegment[2] as number,
-      );
-    } else if (pathCommand === 'Q') {
-      paramQX = normalSegment[1] as number;
-      paramQY = normalSegment[2] as number;
-      [minX, minY, maxX, maxY] = getQuadBBox(
-        lastX,
-        lastY,
-        normalSegment[1] as number,
-        normalSegment[2] as number,
-        normalSegment[3] as number,
-        normalSegment[4] as number,
-      );
-    } else if (pathCommand === 'Z') {
-      [minX, minY, maxX, maxY] = getLineBBox(lastX, lastY, mx, my);
-    }
-    xMin = min(minX, xMin);
-    yMin = min(minY, yMin);
-    xMax = max(maxX, xMax);
-    yMax = max(maxY, yMax);
-
-    // update params
-    [paramX1, paramY1] = pathCommand === 'Z' ? [mx, my] : (normalSegment.slice(-2) as PointTuple);
-    [paramX2, paramY2] =
-      pathCommand === 'C'
-        ? ([normalSegment[3], normalSegment[4]] as PointTuple)
-        : pathCommand === 'S'
-        ? ([normalSegment[1], normalSegment[2]] as PointTuple)
-        : [paramX1, paramY1];
-  });
-
-  const width = xMax - xMin;
-  const height = yMax - yMin;
-
-  return {
-    width,
-    height,
-    x: xMin,
-    y: yMin,
-    x2: xMax,
-    y2: yMax,
-    cx: xMin + width / 2,
-    cy: yMin + height / 2,
-    // an estimated guess
-    cz: Math.max(width, height) + Math.min(width, height) / 2,
-  } satisfies PathBBox;
-};
-
-export default getPathBBox;