@tscircuit/core 0.0.16 → 0.0.17

package/dist/index.js

@@ -12,6 +12,7 @@ __export(components_exports, {
   Chip: () => Chip,
   Footprint: () => Footprint,
   Group: () => Group,
+  Jumper: () => Jumper,
   Led: () => Led,
   Net: () => Net,
   NormalComponent: () => NormalComponent,
@@ -19,6 +20,7 @@ __export(components_exports, {
   PrimitiveComponent: () => PrimitiveComponent,
   Renderable: () => Renderable,
   Resistor: () => Resistor,
+  SilkscreenPath: () => SilkscreenPath,
   SmtPad: () => SmtPad,
   Trace: () => Trace,
   TraceHint: () => TraceHint
@@ -167,6 +169,7 @@ var PrimitiveComponent = class extends Renderable {
   _parsedProps;
   componentName = "";
   lowercaseComponentName = "";
+  externallyAddedAliases;
   source_group_id = null;
   source_component_id = null;
   schematic_component_id = null;
@@ -177,6 +180,7 @@ var PrimitiveComponent = class extends Renderable {
     this.children = [];
     this.childrenPendingRemoval = [];
     this.props = props ?? {};
+    this.externallyAddedAliases = [];
     this._parsedProps = this.config.zodProps.parse(
       props ?? {}
     );
@@ -466,7 +470,8 @@ var Port = class extends PrimitiveComponent {
       /* @__PURE__ */ new Set([
         ...props.aliases ?? [],
         props.name,
-        ...typeof props.pinNumber === "number" ? [`pin${props.pinNumber}`, props.pinNumber.toString()] : []
+        ...typeof props.pinNumber === "number" ? [`pin${props.pinNumber}`, props.pinNumber.toString()] : [],
+        ...this.externallyAddedAliases
       ])
     );
   }
@@ -796,6 +801,34 @@ var SmtPad = class extends PrimitiveComponent {
   }
 };
 
+// lib/components/primitive-components/SilkscreenPath.ts
+import { silkscreenPathProps } from "@tscircuit/props";
+var SilkscreenPath = class extends PrimitiveComponent {
+  pcb_silkscreen_path_id = null;
+  get config() {
+    return {
+      zodProps: silkscreenPathProps
+    };
+  }
+  doInitialPcbPrimitiveRender() {
+    const { db } = this.project;
+    const { _parsedProps: props } = this;
+    const layer = props.layer ?? "top";
+    if (layer !== "top" && layer !== "bottom") {
+      throw new Error(
+        `Invalid layer "${layer}" for SilkscreenPath. Must be "top" or "bottom".`
+      );
+    }
+    const pcb_silkscreen_path = db.pcb_silkscreen_path.insert({
+      pcb_component_id: this.parent?.pcb_component_id,
+      layer,
+      route: props.route,
+      stroke_width: props.strokeWidth ?? 0.1
+    });
+    this.pcb_silkscreen_path_id = pcb_silkscreen_path.pcb_silkscreen_path_id;
+  }
+};
+
 // lib/utils/createComponentsFromSoup.ts
 var createComponentsFromSoup = (soup) => {
   const components = [];
@@ -823,6 +856,14 @@ var createComponentsFromSoup = (soup) => {
           portHints: elm.port_hints
         })
       );
+    } else if (elm.type === "pcb_silkscreen_path") {
+      components.push(
+        new SilkscreenPath({
+          layer: elm.layer,
+          route: elm.route,
+          strokeWidth: elm.stroke_width
+        })
+      );
     }
   }
   return components;
@@ -866,6 +907,20 @@ var NormalComponent = class extends PrimitiveComponent {
     }
     const portsFromFootprint = this.getPortsFromFootprint();
     this.addAll(portsFromFootprint);
+    const pinLabels = this._parsedProps.pinLabels;
+    if (pinLabels) {
+      for (let [pinNumber, label] of Object.entries(pinLabels)) {
+        pinNumber = pinNumber.replace("pin", "");
+        const port = this.selectOne(`port[pinNumber='${pinNumber}']`);
+        if (!port) {
+          throw new Error(
+            `Could not find port for pin number ${pinNumber} in chip ${this.getString()}`
+          );
+        }
+        port.externallyAddedAliases.push(label);
+        port.props.name = label;
+      }
+    }
   }
   _addChildrenFromStringFootprint() {
     const { footprint } = this.props;
@@ -1902,27 +1957,81 @@ var Chip = class extends NormalComponent {
       zodProps: chipProps
     };
   }
-  initPorts() {
-    super.initPorts();
+  doInitialSourceRender() {
+    const { db } = this.project;
     const { _parsedProps: props } = this;
-    if (props.pinLabels) {
-      for (const [pinNumber, label] of Object.entries(props.pinLabels)) {
-        const port = this.selectOne(`port[pinNumber='${pinNumber}']`);
-        if (!port) {
-          throw new Error(
-            `Could not find port for pin number ${pinNumber} in chip ${this.getString()}`
-          );
-        }
-        port.props.aliases.push(port.props.name);
-        port.props.name = label;
-      }
-    }
+    const source_component = db.source_component.insert({
+      ftype: "simple_chip",
+      name: props.name,
+      manufacturer_part_number: props.manufacturerPartNumber,
+      supplier_part_numbers: props.supplierPartNumbers
+    });
+    this.source_component_id = source_component.source_component_id;
+  }
+  doInitialSchematicComponentRender() {
+    const { db } = this.project;
+    const { _parsedProps: props } = this;
+    const ports = this.children.filter((child) => child instanceof Port);
+    const pinSpacing = props.schPinSpacing ?? 0.2;
+    const dimensions = getAllDimensionsForSchematicBox({
+      schWidth: props.schWidth,
+      schHeight: props.schHeight,
+      schPinSpacing: pinSpacing,
+      schPinStyle: props.schPinStyle,
+      pinCount: ports.length,
+      // @ts-ignore there's a subtley in the definition difference with
+      // leftSide/rightSide/topSide/bottomSide in how the direction is defined
+      // that doesn't really matter
+      schPortArrangement: props.schPortArrangement
+    });
+    this.schematicDimensions = dimensions;
+    const schematic_component2 = db.schematic_component.insert({
+      center: { x: props.schX ?? 0, y: props.schY ?? 0 },
+      rotation: props.schRotation ?? 0,
+      size: dimensions.getSize(),
+      port_arrangement: underscorifyPortArrangement(
+        props.schPortArrangement
+      ),
+      pin_spacing: pinSpacing,
+      // @ts-ignore soup needs to support distance for pin_styles
+      pin_styles: underscorifyPinStyles(props.schPinStyle),
+      port_labels: props.pinLabels,
+      source_component_id: this.source_component_id
+    });
+    this.schematic_component_id = schematic_component2.schematic_component_id;
+  }
+  doInitialPcbComponentRender() {
+    const { db } = this.project;
+    const { _parsedProps: props } = this;
+    const pcb_component = db.pcb_component.insert({
+      center: { x: props.pcbX ?? 0, y: props.pcbY ?? 0 },
+      width: 2,
+      // Default width, adjust as needed
+      height: 3,
+      // Default height, adjust as needed
+      layer: props.layer ?? "top",
+      rotation: props.pcbRotation ?? 0,
+      source_component_id: this.source_component_id
+    });
+    this.pcb_component_id = pcb_component.pcb_component_id;
+  }
+};
+
+// lib/components/normal-components/Jumper.ts
+import { jumperProps } from "@tscircuit/props";
+var Jumper = class extends NormalComponent {
+  schematicDimensions = null;
+  get config() {
+    return {
+      zodProps: jumperProps
+    };
   }
   doInitialSourceRender() {
     const { db } = this.project;
     const { _parsedProps: props } = this;
     const source_component = db.source_component.insert({
       ftype: "simple_chip",
+      // TODO unknown or jumper
       name: props.name,
       manufacturer_part_number: props.manufacturerPartNumber,
       supplier_part_numbers: props.supplierPartNumbers
@@ -1943,7 +2052,10 @@ var Chip = class extends NormalComponent {
       // @ts-ignore there's a subtley in the definition difference with
       // leftSide/rightSide/topSide/bottomSide in how the direction is defined
       // that doesn't really matter
-      schPortArrangement: props.schPortArrangement
+      schPortArrangement: {
+        // TODO use schematic direction or schPortArrangement
+        rightSize: ports.length
+      }
     });
     this.schematicDimensions = dimensions;
     const schematic_component2 = db.schematic_component.insert({
@@ -1986,6 +2098,7 @@ var Project = class {
   rootComponent = null;
   children;
   db;
+  _hasRenderedAtleastOnce = false;
   constructor() {
     this.children = [];
     this.db = su([]);
@@ -2029,13 +2142,29 @@ var Project = class {
     if (!rootComponent) throw new Error("Project has no root component");
     rootComponent.setProject(this);
     rootComponent.runRenderCycle();
+    this._hasRenderedAtleastOnce = true;
   }
   getSoup() {
+    if (!this._hasRenderedAtleastOnce) this.render();
     return this.db.toArray();
   }
   getCircuitJson() {
     return this.getSoup();
   }
+  async getSvg(options) {
+    const circuitToSvg = await import("circuit-to-svg").catch((e) => {
+      throw new Error(
+        `To use project.getSvg, you must install the "circuit-to-svg" package.
+
+"${e.message}"`
+      );
+    });
+    return circuitToSvg.circuitJsonToPcbSvg(this.getSoup());
+  }
+  async preview(previewNameOrOpts) {
+    const previewOpts = typeof previewNameOrOpts === "object" ? previewNameOrOpts : { previewName: previewNameOrOpts };
+    throw new Error("project.preview is not yet implemented");
+  }
   computeGlobalSchematicTransform() {
     return identity5();
   }
@@ -2061,6 +2190,7 @@ export {
   Chip,
   Footprint,
   Group,
+  Jumper,
   Led,
   Net,
   NormalComponent,
@@ -2069,6 +2199,7 @@ export {
   Project,
   Renderable,
   Resistor,
+  SilkscreenPath,
   SmtPad,
   Trace,
   TraceHint

package/lib/Project.ts

@@ -11,6 +11,8 @@ export class Project {
   children: PrimitiveComponent[]
   db: SoupUtilObjects
 
+  _hasRenderedAtleastOnce = false
+
   constructor() {
     this.children = []
     this.db = su([])
@@ -64,9 +66,11 @@ export class Project {
     rootComponent.setProject(this)
 
     rootComponent.runRenderCycle()
+    this._hasRenderedAtleastOnce = true
   }
 
   getSoup(): AnySoupElement[] {
+    if (!this._hasRenderedAtleastOnce) this.render()
     return this.db.toArray()
   }
 
@@ -74,6 +78,31 @@ export class Project {
     return this.getSoup()
   }
 
+  async getSvg(options: { view: "pcb"; layer?: string }): Promise<string> {
+    const circuitToSvg = await import("circuit-to-svg").catch((e) => {
+      throw new Error(
+        `To use project.getSvg, you must install the "circuit-to-svg" package.\n\n"${e.message}"`,
+      )
+    })
+
+    return circuitToSvg.circuitJsonToPcbSvg(this.getSoup())
+  }
+
+  async preview(
+    previewNameOrOpts:
+      | string
+      | {
+          previewName: string
+          tscircuitApiKey?: string
+        },
+  ) {
+    const previewOpts =
+      typeof previewNameOrOpts === "object"
+        ? previewNameOrOpts
+        : { previewName: previewNameOrOpts }
+    throw new Error("project.preview is not yet implemented")
+  }
+
   computeGlobalSchematicTransform(): Matrix {
     return identity()
   }

package/lib/components/base-components/NormalComponent.ts

@@ -87,6 +87,22 @@ export class NormalComponent<
     const portsFromFootprint = this.getPortsFromFootprint()
 
     this.addAll(portsFromFootprint)
+
+    const pinLabels: Record<string, string> | undefined =
+      this._parsedProps.pinLabels
+    if (pinLabels) {
+      for (let [pinNumber, label] of Object.entries(pinLabels)) {
+        pinNumber = pinNumber.replace("pin", "")
+        const port = this.selectOne(`port[pinNumber='${pinNumber}']`)
+        if (!port) {
+          throw new Error(
+            `Could not find port for pin number ${pinNumber} in chip ${this.getString()}`,
+          )
+        }
+        port.externallyAddedAliases.push(label)
+        port.props.name = label
+      }
+    }
   }
 
   _addChildrenFromStringFootprint() {

package/lib/components/base-components/PrimitiveComponent.ts

@@ -46,6 +46,8 @@ export abstract class PrimitiveComponent<
   componentName = ""
   lowercaseComponentName = ""
 
+  externallyAddedAliases: string[]
+
   source_group_id: string | null = null
   source_component_id: string | null = null
   schematic_component_id: string | null = null
@@ -57,6 +59,7 @@ export abstract class PrimitiveComponent<
     this.children = []
     this.childrenPendingRemoval = []
     this.props = props ?? {}
+    this.externallyAddedAliases = []
     this._parsedProps = this.config.zodProps.parse(
       props ?? {},
     ) as z.infer<ZodProps>

package/lib/components/index.ts

@@ -13,3 +13,5 @@ export { Trace } from "./primitive-components/Trace"
 export { TraceHint } from "./primitive-components/TraceHint"
 export { Group } from "./primitive-components/Group"
 export { Chip } from "./normal-components/Chip"
+export { Jumper } from "./normal-components/Jumper"
+export { SilkscreenPath } from "./primitive-components/SilkscreenPath"

package/lib/components/normal-components/Chip.ts

@@ -21,25 +21,6 @@ export class Chip<PinLabels extends string = never> extends NormalComponent<
     }
   }
 
-  initPorts() {
-    super.initPorts()
-
-    const { _parsedProps: props } = this
-
-    if (props.pinLabels) {
-      for (const [pinNumber, label] of Object.entries(props.pinLabels)) {
-        const port = this.selectOne(`port[pinNumber='${pinNumber}']`)
-        if (!port) {
-          throw new Error(
-            `Could not find port for pin number ${pinNumber} in chip ${this.getString()}`,
-          )
-        }
-        port.props.aliases.push(port.props.name)
-        port.props.name = label
-      }
-    }
-  }
-
   doInitialSourceRender(): void {
     const { db } = this.project!
     const { _parsedProps: props } = this

package/lib/components/normal-components/Jumper.ts

@@ -0,0 +1,101 @@
+import { NormalComponent } from "lib/components/base-components/NormalComponent"
+import { jumperProps } from "@tscircuit/props"
+import { Port } from "../primitive-components/Port"
+import type { BaseSymbolName } from "lib/utils/constants"
+import {
+  getAllDimensionsForSchematicBox,
+  type SchematicBoxDimensions,
+} from "lib/utils/schematic/getAllDimensionsForSchematicBox"
+import { underscorifyPortArrangement } from "lib/soup/underscorifyPortArrangement"
+import { underscorifyPinStyles } from "lib/soup/underscorifyPinStyles"
+
+export class Jumper<PinLabels extends string = never> extends NormalComponent<
+  typeof jumperProps,
+  PinLabels
+> {
+  schematicDimensions: SchematicBoxDimensions | null = null
+
+  get config() {
+    return {
+      zodProps: jumperProps,
+    }
+  }
+
+  doInitialSourceRender(): void {
+    const { db } = this.project!
+    const { _parsedProps: props } = this
+
+    const source_component = db.source_component.insert({
+      ftype: "simple_chip", // TODO unknown or jumper
+      name: props.name,
+      manufacturer_part_number: props.manufacturerPartNumber,
+      supplier_part_numbers: props.supplierPartNumbers,
+    })
+
+    this.source_component_id = source_component.source_component_id!
+  }
+
+  doInitialSchematicComponentRender() {
+    const { db } = this.project!
+    const { _parsedProps: props } = this
+
+    const ports = this.children.filter((child) => child instanceof Port)
+
+    const pinSpacing = props.schPinSpacing ?? 0.2
+
+    const dimensions = getAllDimensionsForSchematicBox({
+      schWidth: props.schWidth,
+      schHeight: props.schHeight,
+      schPinSpacing: pinSpacing,
+      schPinStyle: props.schPinStyle,
+
+      pinCount: ports.length,
+
+      // @ts-ignore there's a subtley in the definition difference with
+      // leftSide/rightSide/topSide/bottomSide in how the direction is defined
+      // that doesn't really matter
+      schPortArrangement: {
+        // TODO use schematic direction or schPortArrangement
+        rightSize: ports.length,
+      },
+    })
+    this.schematicDimensions = dimensions
+
+    const schematic_component = db.schematic_component.insert({
+      center: { x: props.schX ?? 0, y: props.schY ?? 0 },
+      rotation: props.schRotation ?? 0,
+      size: dimensions.getSize(),
+
+      port_arrangement: underscorifyPortArrangement(
+        props.schPortArrangement as any,
+      ),
+
+      pin_spacing: pinSpacing,
+
+      // @ts-ignore soup needs to support distance for pin_styles
+      pin_styles: underscorifyPinStyles(props.schPinStyle),
+
+      port_labels: props.pinLabels,
+
+      source_component_id: this.source_component_id!,
+    })
+
+    this.schematic_component_id = schematic_component.schematic_component_id
+  }
+
+  doInitialPcbComponentRender() {
+    const { db } = this.project!
+    const { _parsedProps: props } = this
+
+    const pcb_component = db.pcb_component.insert({
+      center: { x: props.pcbX ?? 0, y: props.pcbY ?? 0 },
+      width: 2, // Default width, adjust as needed
+      height: 3, // Default height, adjust as needed
+      layer: props.layer ?? "top",
+      rotation: props.pcbRotation ?? 0,
+      source_component_id: this.source_component_id!,
+    })
+
+    this.pcb_component_id = pcb_component.pcb_component_id
+  }
+}

package/lib/components/primitive-components/Port.ts

@@ -82,6 +82,7 @@ export class Port extends PrimitiveComponent<typeof portProps> {
         ...(typeof props.pinNumber === "number"
           ? [`pin${props.pinNumber}`, props.pinNumber.toString()]
           : []),
+        ...this.externallyAddedAliases,
       ]),
     ) as string[]
   }

package/lib/components/primitive-components/SilkscreenPath.ts

@@ -0,0 +1,35 @@
+import { silkscreenPathProps } from "@tscircuit/props"
+import { PrimitiveComponent } from "../base-components/PrimitiveComponent"
+
+export class SilkscreenPath extends PrimitiveComponent<
+  typeof silkscreenPathProps
+> {
+  pcb_silkscreen_path_id: string | null = null
+
+  get config() {
+    return {
+      zodProps: silkscreenPathProps,
+    }
+  }
+
+  doInitialPcbPrimitiveRender(): void {
+    const { db } = this.project!
+    const { _parsedProps: props } = this
+
+    const layer = props.layer ?? "top"
+    if (layer !== "top" && layer !== "bottom") {
+      throw new Error(
+        `Invalid layer "${layer}" for SilkscreenPath. Must be "top" or "bottom".`,
+      )
+    }
+
+    const pcb_silkscreen_path = db.pcb_silkscreen_path.insert({
+      pcb_component_id: this.parent?.pcb_component_id!,
+      layer,
+      route: props.route,
+      stroke_width: props.strokeWidth ?? 0.1,
+    })
+
+    this.pcb_silkscreen_path_id = pcb_silkscreen_path.pcb_silkscreen_path_id
+  }
+}

package/lib/fiber/intrinsic-jsx.ts

@@ -9,6 +9,7 @@ declare global {
       diode: Props.DiodeProps
       led: Props.LedProps
       board: Props.BoardProps
+      jumper: Props.JumperProps
       bug: Props.ChipProps
       // TODO use ChipProps once it gets merged in @tscircuit/props
       chip: Props.ChipProps

package/lib/utils/createComponentsFromSoup.ts

@@ -1,6 +1,7 @@
 import type { AnySoupElement } from "@tscircuit/soup"
 import type { PrimitiveComponent } from "../components/base-components/PrimitiveComponent"
 import { SmtPad } from "lib/components/primitive-components/SmtPad"
+import { SilkscreenPath } from "lib/components/primitive-components/SilkscreenPath"
 
 export const createComponentsFromSoup = (
   soup: AnySoupElement[],
@@ -30,57 +31,15 @@ export const createComponentsFromSoup = (
           portHints: elm.port_hints,
         }),
       )
+    } else if (elm.type === "pcb_silkscreen_path") {
+      components.push(
+        new SilkscreenPath({
+          layer: elm.layer,
+          route: elm.route,
+          strokeWidth: elm.stroke_width,
+        }),
+      )
     }
   }
   return components
-  //   if (elm.type === "pcb_smtpad") {
-  //     this.add("smtpad", (pb) => pb.setProps(elm))
-  //   } else if (elm.type === "pcb_plated_hole") {
-  //     this.add("platedhole", (pb) => pb.setProps(elm))
-  //   } else if (elm.type === "pcb_hole") {
-  //     this.add("hole", (pb) => pb.setProps(elm))
-  //   } else if (elm.type === "pcb_silkscreen_circle") {
-  //     this.add("silkscreencircle", (pb) =>
-  //       pb.setProps({
-  //         ...elm,
-  //         pcbX: elm.center.x,
-  //         pcbY: elm.center.y,
-  //       })
-  //     )
-  //   } else if (elm.type === "pcb_silkscreen_line") {
-  //     this.add("silkscreenline", (pb) =>
-  //       pb.setProps({
-  //         ...elm,
-  //         strokeWidth: elm.stroke_width,
-  //       })
-  //     )
-  //   } else if (elm.type === "pcb_silkscreen_path") {
-  //     this.add("silkscreenpath", (pb) =>
-  //       pb.setProps({
-  //         ...elm,
-  //         strokeWidth: elm.stroke_width,
-  //       })
-  //     )
-  //   } else if (elm.type === "pcb_silkscreen_rect") {
-  //     this.add("silkscreenrect", (pb) =>
-  //       pb.setProps({
-  //         ...elm,
-  //         pcbX: elm.center.x,
-  //         pcbY: elm.center.y,
-  //         // TODO silkscreen rect isFilled, isOutline etc.
-  //       })
-  //     )
-  //   } else if (elm.type === "pcb_fabrication_note_path") {
-  //     this.add("fabricationnotepath", (pb) => pb.setProps(elm))
-  //   } else if (elm.type === "pcb_fabrication_note_text") {
-  //     this.add("fabricationnotetext", (pb) =>
-  //       pb.setProps({
-  //         ...elm,
-  //         pcbX: elm.anchor_position.x,
-  //         pcbY: elm.anchor_position.y,
-  //         anchorAlignment: elm.anchor_alignment,
-  //         fontSize: elm.font_size,
-  //       })
-  //     )
-  //   }
 }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@tscircuit/core",
   "module": "index.ts",
   "type": "module",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "files": [
@@ -16,11 +16,13 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^1.8.3",
+    "@tscircuit/layout": "^0.0.27",
     "@tscircuit/log-soup": "^1.0.2",
     "@types/bun": "latest",
     "@types/react": "^18.3.3",
     "@types/react-reconciler": "^0.28.8",
-    "circuit-to-svg": "^0.0.3",
+    "bun-match-svg": "0.0.2",
+    "circuit-to-svg": "^0.0.13",
     "howfat": "^0.3.8",
     "looks-same": "^9.0.1",
     "tsup": "^8.2.4"
@@ -30,7 +32,7 @@
   },
   "dependencies": {
     "@tscircuit/infgrid-ijump-astar": "0.0.5",
-    "@tscircuit/props": "^0.0.46",
+    "@tscircuit/props": "^0.0.49",
     "@tscircuit/soup": "^0.0.58",
     "@tscircuit/soup-util": "0.0.18",
     "footprinter": "^0.0.44",