@jlcpcb/core 0.1.0

package/src/converter/svg-arc.ts

@@ -0,0 +1,179 @@
+/**
+ * SVG Arc to Center Parameterization
+ *
+ * Converts SVG arc endpoint parameters to center point format used by KiCad.
+ * Based on SVG specification: https://www.w3.org/TR/SVG/implnote.html#ArcConversionEndpointToCenter
+ */
+
+export interface ArcEndpointParams {
+  x1: number;      // Start point X
+  y1: number;      // Start point Y
+  rx: number;      // X radius
+  ry: number;      // Y radius
+  phi: number;     // X-axis rotation in degrees
+  largeArc: boolean;  // Large arc flag
+  sweep: boolean;     // Sweep flag (clockwise)
+  x2: number;      // End point X
+  y2: number;      // End point Y
+}
+
+export interface ArcCenterParams {
+  cx: number;         // Center X
+  cy: number;         // Center Y
+  rx: number;         // Corrected X radius
+  ry: number;         // Corrected Y radius
+  startAngle: number; // Start angle in radians
+  endAngle: number;   // End angle in radians
+  deltaAngle: number; // Arc sweep in radians (negative = clockwise)
+}
+
+/**
+ * Convert SVG arc endpoint parameterization to center parameterization
+ * Algorithm from SVG spec Appendix B.2.4
+ */
+export function svgArcToCenter(params: ArcEndpointParams): ArcCenterParams | null {
+  const { x1, y1, x2, y2, largeArc, sweep } = params;
+  let { rx, ry, phi } = params;
+
+  // Convert rotation to radians
+  const phiRad = (phi * Math.PI) / 180;
+  const cosPhi = Math.cos(phiRad);
+  const sinPhi = Math.sin(phiRad);
+
+  // Step 1: Compute (x1', y1') - midpoint in rotated coordinates
+  const dx = (x1 - x2) / 2;
+  const dy = (y1 - y2) / 2;
+  const x1p = cosPhi * dx + sinPhi * dy;
+  const y1p = -sinPhi * dx + cosPhi * dy;
+
+  // Ensure radii are positive
+  rx = Math.abs(rx);
+  ry = Math.abs(ry);
+
+  // Check for degenerate cases
+  if (rx === 0 || ry === 0) {
+    return null; // Line, not an arc
+  }
+
+  // Step 2: Correct out-of-range radii
+  // Ensure radii are large enough
+  const lambda = (x1p * x1p) / (rx * rx) + (y1p * y1p) / (ry * ry);
+  if (lambda > 1) {
+    const sqrtLambda = Math.sqrt(lambda);
+    rx = sqrtLambda * rx;
+    ry = sqrtLambda * ry;
+  }
+
+  // Step 3: Compute (cx', cy') - center in rotated coordinates
+  const rx2 = rx * rx;
+  const ry2 = ry * ry;
+  const x1p2 = x1p * x1p;
+  const y1p2 = y1p * y1p;
+
+  let sq = (rx2 * ry2 - rx2 * y1p2 - ry2 * x1p2) / (rx2 * y1p2 + ry2 * x1p2);
+  if (sq < 0) sq = 0; // Numerical precision fix
+
+  let coef = Math.sqrt(sq);
+  if (largeArc === sweep) {
+    coef = -coef;
+  }
+
+  const cxp = coef * ((rx * y1p) / ry);
+  const cyp = coef * (-(ry * x1p) / rx);
+
+  // Step 4: Compute (cx, cy) from (cx', cy')
+  const cx = cosPhi * cxp - sinPhi * cyp + (x1 + x2) / 2;
+  const cy = sinPhi * cxp + cosPhi * cyp + (y1 + y2) / 2;
+
+  // Step 5: Compute start angle and delta angle
+  const ux = (x1p - cxp) / rx;
+  const uy = (y1p - cyp) / ry;
+  const vx = (-x1p - cxp) / rx;
+  const vy = (-y1p - cyp) / ry;
+
+  // Angle between two vectors
+  const vectorAngle = (ux: number, uy: number, vx: number, vy: number): number => {
+    const dot = ux * vx + uy * vy;
+    const len = Math.sqrt(ux * ux + uy * uy) * Math.sqrt(vx * vx + vy * vy);
+    let angle = Math.acos(Math.max(-1, Math.min(1, dot / len))); // Clamp for numerical stability
+    if (ux * vy - uy * vx < 0) {
+      angle = -angle;
+    }
+    return angle;
+  };
+
+  // Start angle (angle from positive x-axis to start point vector)
+  const startAngle = vectorAngle(1, 0, ux, uy);
+
+  // Delta angle (sweep)
+  let deltaAngle = vectorAngle(ux, uy, vx, vy);
+
+  // Adjust delta based on sweep flag
+  if (!sweep && deltaAngle > 0) {
+    deltaAngle -= 2 * Math.PI;
+  } else if (sweep && deltaAngle < 0) {
+    deltaAngle += 2 * Math.PI;
+  }
+
+  const endAngle = startAngle + deltaAngle;
+
+  return {
+    cx,
+    cy,
+    rx,
+    ry,
+    startAngle,
+    endAngle,
+    deltaAngle,
+  };
+}
+
+/**
+ * Parse SVG arc path and extract parameters
+ * Format: "M x1 y1 A rx ry rotation largeArc sweep x2 y2"
+ */
+export function parseSvgArcPath(path: string): ArcEndpointParams | null {
+  try {
+    // Normalize path - handle both space and comma separators
+    const normalized = path.replace(/,/g, ' ').replace(/\s+/g, ' ').trim();
+
+    // Match M x y A rx ry rotation largeArc sweep x y
+    const match = normalized.match(
+      /M\s*(-?[\d.]+)\s+(-?[\d.]+)\s*A\s*(-?[\d.]+)\s+(-?[\d.]+)\s+(-?[\d.]+)\s+([01])\s+([01])\s+(-?[\d.]+)\s+(-?[\d.]+)/i
+    );
+
+    if (!match) {
+      return null;
+    }
+
+    return {
+      x1: parseFloat(match[1]),
+      y1: parseFloat(match[2]),
+      rx: parseFloat(match[3]),
+      ry: parseFloat(match[4]),
+      phi: parseFloat(match[5]),
+      largeArc: match[6] === '1',
+      sweep: match[7] === '1',
+      x2: parseFloat(match[8]),
+      y2: parseFloat(match[9]),
+    };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Convert radians to degrees
+ */
+export function radToDeg(rad: number): number {
+  return (rad * 180) / Math.PI;
+}
+
+/**
+ * Normalize angle to 0-360 range
+ */
+export function normalizeAngle(degrees: number): number {
+  while (degrees < 0) degrees += 360;
+  while (degrees >= 360) degrees -= 360;
+  return degrees;
+}

package/src/converter/symbol-templates.ts

@@ -0,0 +1,214 @@
+/**
+ * Symbol Templates for Passive Components
+ * Fixed layouts that produce clean, consistent symbols like CDFER's JLCPCB-Kicad-Library
+ */
+
+export interface SymbolTemplate {
+  /** Pin length in mm */
+  pinLength: number;
+  /** Y-distance between pins for 2-pin components (total, not from center) */
+  pinSpacing: number;
+  /** KiCad S-expression for body graphics */
+  bodyGraphics: string;
+  /** Reference designator position */
+  refPosition: { x: number; y: number; angle: number };
+  /** Value property position */
+  valuePosition: { x: number; y: number; angle: number };
+}
+
+/**
+ * Resistor template - Rectangular body
+ * Based on CDFER: Body 2.032mm × 5.08mm, pins at ±3.81mm
+ */
+const RESISTOR_TEMPLATE: SymbolTemplate = {
+  pinLength: 2.54,
+  pinSpacing: 7.62,  // pins at y = ±3.81mm
+  bodyGraphics: `\t\t\t(rectangle
+\t\t\t\t(start -1.016 2.54)
+\t\t\t\t(end 1.016 -2.54)
+\t\t\t\t(stroke
+\t\t\t\t\t(width 0.254)
+\t\t\t\t\t(type default)
+\t\t\t\t)
+\t\t\t\t(fill
+\t\t\t\t\t(type background)
+\t\t\t\t)
+\t\t\t)`,
+  refPosition: { x: 2.54, y: 0, angle: 90 },
+  valuePosition: { x: -1.778, y: 0, angle: 90 },
+};
+
+/**
+ * Capacitor template - Two parallel plates
+ * Based on CDFER: Plates at ±0.635mm, pins at ±2.54mm
+ */
+const CAPACITOR_TEMPLATE: SymbolTemplate = {
+  pinLength: 2.54,
+  pinSpacing: 5.08,  // pins at y = ±2.54mm
+  bodyGraphics: `\t\t\t(polyline
+\t\t\t\t(pts
+\t\t\t\t\t(xy -1.27 0.635)
+\t\t\t\t\t(xy 1.27 0.635)
+\t\t\t\t)
+\t\t\t\t(stroke
+\t\t\t\t\t(width 0.254)
+\t\t\t\t\t(type default)
+\t\t\t\t)
+\t\t\t\t(fill
+\t\t\t\t\t(type none)
+\t\t\t\t)
+\t\t\t)
+\t\t\t(polyline
+\t\t\t\t(pts
+\t\t\t\t\t(xy -1.27 -0.635)
+\t\t\t\t\t(xy 1.27 -0.635)
+\t\t\t\t)
+\t\t\t\t(stroke
+\t\t\t\t\t(width 0.254)
+\t\t\t\t\t(type default)
+\t\t\t\t)
+\t\t\t\t(fill
+\t\t\t\t\t(type none)
+\t\t\t\t)
+\t\t\t)`,
+  refPosition: { x: 2.54, y: 0, angle: 0 },
+  valuePosition: { x: -2.54, y: 0, angle: 0 },
+};
+
+/**
+ * Inductor template - 4 semicircular arcs (standard coil symbol)
+ * Arcs arranged vertically, bulging to the right
+ */
+const INDUCTOR_TEMPLATE: SymbolTemplate = {
+  pinLength: 2.54,
+  pinSpacing: 7.62,  // pins at y = ±3.81mm
+  bodyGraphics: `\t\t\t(arc
+\t\t\t\t(start 0 2.54)
+\t\t\t\t(mid 0.635 1.905)
+\t\t\t\t(end 0 1.27)
+\t\t\t\t(stroke
+\t\t\t\t\t(width 0.254)
+\t\t\t\t\t(type default)
+\t\t\t\t)
+\t\t\t\t(fill
+\t\t\t\t\t(type none)
+\t\t\t\t)
+\t\t\t)
+\t\t\t(arc
+\t\t\t\t(start 0 1.27)
+\t\t\t\t(mid 0.635 0.635)
+\t\t\t\t(end 0 0)
+\t\t\t\t(stroke
+\t\t\t\t\t(width 0.254)
+\t\t\t\t\t(type default)
+\t\t\t\t)
+\t\t\t\t(fill
+\t\t\t\t\t(type none)
+\t\t\t\t)
+\t\t\t)
+\t\t\t(arc
+\t\t\t\t(start 0 0)
+\t\t\t\t(mid 0.635 -0.635)
+\t\t\t\t(end 0 -1.27)
+\t\t\t\t(stroke
+\t\t\t\t\t(width 0.254)
+\t\t\t\t\t(type default)
+\t\t\t\t)
+\t\t\t\t(fill
+\t\t\t\t\t(type none)
+\t\t\t\t)
+\t\t\t)
+\t\t\t(arc
+\t\t\t\t(start 0 -1.27)
+\t\t\t\t(mid 0.635 -1.905)
+\t\t\t\t(end 0 -2.54)
+\t\t\t\t(stroke
+\t\t\t\t\t(width 0.254)
+\t\t\t\t\t(type default)
+\t\t\t\t)
+\t\t\t\t(fill
+\t\t\t\t\t(type none)
+\t\t\t\t)
+\t\t\t)`,
+  refPosition: { x: 2.54, y: 0, angle: 90 },
+  valuePosition: { x: -1.778, y: 0, angle: 90 },
+};
+
+/**
+ * Diode template - Triangle with cathode bar
+ * Based on CDFER: Triangle 2.54mm wide, pins at ±5.08mm
+ */
+const DIODE_TEMPLATE: SymbolTemplate = {
+  pinLength: 3.81,
+  pinSpacing: 10.16,  // pins at y = ±5.08mm
+  bodyGraphics: `\t\t\t(polyline
+\t\t\t\t(pts
+\t\t\t\t\t(xy -1.27 1.27)
+\t\t\t\t\t(xy 0 -1.27)
+\t\t\t\t\t(xy 1.27 1.27)
+\t\t\t\t\t(xy -1.27 1.27)
+\t\t\t\t)
+\t\t\t\t(stroke
+\t\t\t\t\t(width 0.254)
+\t\t\t\t\t(type default)
+\t\t\t\t)
+\t\t\t\t(fill
+\t\t\t\t\t(type none)
+\t\t\t\t)
+\t\t\t)
+\t\t\t(polyline
+\t\t\t\t(pts
+\t\t\t\t\t(xy -1.27 -1.27)
+\t\t\t\t\t(xy 1.27 -1.27)
+\t\t\t\t)
+\t\t\t\t(stroke
+\t\t\t\t\t(width 0.254)
+\t\t\t\t\t(type default)
+\t\t\t\t)
+\t\t\t\t(fill
+\t\t\t\t\t(type none)
+\t\t\t\t)
+\t\t\t)`,
+  refPosition: { x: 2.54, y: 0, angle: 0 },
+  valuePosition: { x: -2.54, y: 0, angle: 0 },
+};
+
+/**
+ * LED template - Triangle with light rays
+ */
+const LED_TEMPLATE: SymbolTemplate = {
+  ...DIODE_TEMPLATE,
+  // Same as diode but could add light rays in future
+  bodyGraphics: DIODE_TEMPLATE.bodyGraphics,
+};
+
+/**
+ * Get symbol template for a component prefix
+ * Returns null for components that should use EasyEDA-derived layout
+ */
+export function getSymbolTemplate(prefix: string): SymbolTemplate | null {
+  const p = prefix.toUpperCase();
+
+  switch (p) {
+    case 'R':
+      return RESISTOR_TEMPLATE;
+    case 'C':
+      return CAPACITOR_TEMPLATE;
+    case 'L':
+      return INDUCTOR_TEMPLATE;
+    case 'D':
+      return DIODE_TEMPLATE;
+    case 'LED':
+      return LED_TEMPLATE;
+    default:
+      // No template - use EasyEDA-derived layout for ICs, transistors, etc.
+      return null;
+  }
+}
+
+/**
+ * Check if a component should use a fixed template
+ */
+export function hasFixedTemplate(prefix: string): boolean {
+  return getSymbolTemplate(prefix) !== null;
+}