tsci-agent 0.1.0

package/dist/skill/elements/courtyardcircle.md

@@ -0,0 +1,32 @@
+# `<courtyardcircle />`
+
+Draw circular IPC courtyard markings around footprint features.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="20mm" height="20mm">
+    <chip
+      name="U1"
+      footprint={
+        <footprint>
+          <platedhole shape="circle" pcbX={-2.5} pcbY={0} outerDiameter={2.2} holeDiameter={1.1} />
+          <platedhole shape="circle" pcbX={2.5} pcbY={0} outerDiameter={2.2} holeDiameter={1.1} />
+          <courtyardcircle pcbX={0} pcbY={0} radius={4} strokeWidth={0.1} />
+        </footprint>
+      }
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `radius`, `name`, `footprint`, `connections`
+
+## References
+
+- Props: [CourtyardCircleProps](https://github.com/tscircuit/props#courtyardcircleprops-courtyardcircle)
+- Source: [lib/components/courtyard-circle.ts](https://github.com/tscircuit/props/blob/main/lib/components/courtyard-circle.ts)
+- Local docs: [docs/docs/elements/courtyardcircle.mdx](../docs/docs/elements/courtyardcircle.mdx)

package/dist/skill/elements/courtyardoutline.md

@@ -0,0 +1,42 @@
+# `<courtyardoutline />`
+
+Draw custom polygon courtyard boundaries for irregular package geometry.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="30mm" height="24mm">
+    <chip
+      name="U1"
+      footprint={
+        <footprint>
+          <platedhole shape="circle" pcbX={-4} pcbY={-2.5} outerDiameter={2.2} holeDiameter={1.1} />
+          <platedhole shape="circle" pcbX={-4} pcbY={2.5} outerDiameter={2.2} holeDiameter={1.1} />
+          <platedhole shape="circle" pcbX={4} pcbY={-2.5} outerDiameter={2.2} holeDiameter={1.1} />
+          <platedhole shape="circle" pcbX={4} pcbY={2.5} outerDiameter={2.2} holeDiameter={1.1} />
+          <courtyardoutline
+            outline={[
+              { x: -6, y: -5 },
+              { x: 6, y: -5 },
+              { x: 6, y: 5 },
+              { x: 0, y: 7 },
+              { x: -6, y: 5 },
+            ]}
+          />
+        </footprint>
+      }
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `pcbLeftEdgeX`, `pcbRightEdgeX`, `pcbTopEdgeY`, `pcbBottomEdgeY`, `pcbX`, `pcbY`, `pcbOffsetX`, `pcbOffsetY`
+
+## References
+
+- Props: [CourtyardOutlineProps](https://github.com/tscircuit/props#courtyardoutlineprops-courtyardoutline)
+- Source: [lib/components/courtyard-outline.ts](https://github.com/tscircuit/props/blob/main/lib/components/courtyard-outline.ts)
+- Local docs: [docs/docs/elements/courtyardoutline.mdx](../docs/docs/elements/courtyardoutline.mdx)

package/dist/skill/elements/courtyardpill.md

@@ -0,0 +1,29 @@
+# `<courtyardpill />`
+
+Pill-shaped courtyard geometry for a custom footprint.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="20mm" height="20mm">
+    <chip
+      name="U1"
+      footprint={
+        <footprint>
+          <courtyardpill pcbX={0} pcbY={0} width={8} height={3} radius={1.5} />
+        </footprint>
+      }
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `width`, `height`, `radius`, `pcbX`, `pcbY`, `layer`
+
+## References
+
+- Props: [CourtyardPillProps](https://github.com/tscircuit/props#courtyardpillprops-courtyardpill)
+- Source: [lib/components/courtyard-pill.ts](https://github.com/tscircuit/props/blob/main/lib/components/courtyard-pill.ts)

package/dist/skill/elements/courtyardrect.md

@@ -0,0 +1,38 @@
+# `<courtyardrect />`
+
+Draw rectangular IPC courtyard markings around a footprint body.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="26mm" height="20mm">
+    <chip
+      name="U1"
+      footprint={
+        <footprint>
+          <platedhole shape="circle" pcbX={-4} pcbY={0} outerDiameter={2.2} holeDiameter={1.1} />
+          <platedhole shape="circle" pcbX={4} pcbY={0} outerDiameter={2.2} holeDiameter={1.1} />
+          <courtyardrect
+            pcbX={0}
+            pcbY={0}
+            width={12}
+            height={8}
+            strokeWidth={0.1}
+          />
+        </footprint>
+      }
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `width`, `height`, `strokeWidth`, `isFilled`, `hasStroke`, `isStrokeDashed`, `color`, `name`
+
+## References
+
+- Props: [CourtyardRectProps](https://github.com/tscircuit/props#courtyardrectprops-courtyardrect)
+- Source: [lib/components/courtyard-rect.ts](https://github.com/tscircuit/props/blob/main/lib/components/courtyard-rect.ts)
+- Local docs: [docs/docs/elements/courtyardrect.mdx](../docs/docs/elements/courtyardrect.mdx)

package/dist/skill/elements/crystal.md

@@ -0,0 +1,28 @@
+# `<crystal />`
+
+A crystal oscillator provides a stable clock signal essential for timing applications and microcontroller operations.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="50mm" height="50mm">
+    <crystal
+      name="XT1"
+      frequency="16MHz"
+      loadCapacitance="18pF"
+      footprint="hc49"
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `frequency`, `loadCapacitance`, `manufacturerPartNumber`, `mpn`, `pinVariant`, `schOrientation`, `connections`, `name`
+
+## References
+
+- Props: [CrystalProps](https://github.com/tscircuit/props#crystalprops-crystal)
+- Source: [lib/components/crystal.ts](https://github.com/tscircuit/props/blob/main/lib/components/crystal.ts)
+- Local docs: [docs/docs/elements/crystal.mdx](../docs/docs/elements/crystal.mdx)

package/dist/skill/elements/currentsource.md

@@ -0,0 +1,26 @@
+# `<currentsource />`
+
+Current source component for simulation-oriented circuits.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="20mm" height="12mm">
+    <currentsource
+      name="I1"
+      current="1mA"
+      connections={{ pin1: "net.VCC", pin2: "net.GND" }}
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `current`, `frequency`, `peakToPeakCurrent`, `waveShape`, `phase`, `dutyCycle`, `connections`, `name`
+
+## References
+
+- Props: [CurrentSourceProps](https://github.com/tscircuit/props#currentsourceprops-currentsource)
+- Source: [lib/components/currentsource.ts](https://github.com/tscircuit/props/blob/main/lib/components/currentsource.ts)

package/dist/skill/elements/cutout.md

@@ -0,0 +1,35 @@
+# `<cutout />`
+
+Remove material from a board outline to create slots, notches, or other interior shapes.
+
+## Example
+
+```tsx
+export default () => (
+    <board width="30mm" height="20mm">
+      <cutout shape="rect" width="5mm" height="3mm" pcbX="-10mm" pcbY="0mm" />
+      <cutout shape="circle" radius="2mm" pcbX="0mm" pcbY="0mm" />
+      <cutout
+        shape="polygon"
+        points={[
+          { x: 5, y: -2 },
+          { x: 8, y: 0 },
+          { x: 5, y: 2 },
+          { x: 6, y: 0 },
+        ]}
+        pcbX="5mm"
+        pcbY="0mm"
+      />
+    </board>
+  )
+```
+
+## Props
+
+Commonly used: `name`, `shape`, `width`, `height`, `footprint`, `connections`
+
+## References
+
+- Props: [RectCutoutProps](https://github.com/tscircuit/props#rectcutoutprops-cutout)
+- Source: [lib/components/cutout.ts](https://github.com/tscircuit/props/blob/main/lib/components/cutout.ts)
+- Local docs: [docs/docs/elements/cutout.mdx](../docs/docs/elements/cutout.mdx)

package/dist/skill/elements/diode.md

@@ -0,0 +1,23 @@
+# `<diode />`
+
+Diodes are semiconductor devices that allow current to flow primarily in one direction, making them ideal for rectification, signal clipping, and protection against reverse voltage. They are essential in power supply circuits and for protecting sensitive components from voltage spikes.
+
+## Example
+
+```tsx
+export default () => (
+ <board width="10mm" height="10mm">
+  <diode name="D1" footprint="sod123" />
+ </board>
+)
+```
+
+## Props
+
+Commonly used: `connections`, `anode`, `cathode`, `pin1`, `pin2`, `pos`, `neg`, `variant`
+
+## References
+
+- Props: [DiodeProps](https://github.com/tscircuit/props#diodeprops-diode)
+- Source: [lib/components/diode.ts](https://github.com/tscircuit/props/blob/main/lib/components/diode.ts)
+- Local docs: [docs/docs/elements/diode.mdx](../docs/docs/elements/diode.mdx)

package/dist/skill/elements/fabricationnotedimension.md

@@ -0,0 +1,27 @@
+# `<fabricationnotedimension />`
+
+Dimension callout drawn on the fabrication layer.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="20mm" height="15mm">
+    <fabricationnotedimension
+      from={{ x: -4, y: 0 }}
+      to={{ x: 4, y: 0 }}
+      fontSize={1.2}
+      arrowSize={0.8}
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `from`, `to`, `text`, `offset`, `font`, `fontSize`, `color`, `arrowSize`
+
+## References
+
+- Props: [FabricationNoteDimensionProps](https://github.com/tscircuit/props#fabricationnotedimensionprops-fabricationnotedimension)
+- Source: [lib/components/fabrication-note-dimension.ts](https://github.com/tscircuit/props/blob/main/lib/components/fabrication-note-dimension.ts)

package/dist/skill/elements/fabricationnotepath.md

@@ -0,0 +1,29 @@
+# `<fabricationnotepath />`
+
+Polyline/path annotation on the fabrication layer.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="20mm" height="20mm">
+    <fabricationnotepath
+      strokeWidth={0.3}
+      route={[
+        { x: -5, y: 0 },
+        { x: 0, y: 5 },
+        { x: 5, y: 0 },
+      ]}
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `pcbLeftEdgeX`, `pcbRightEdgeX`, `pcbTopEdgeY`, `pcbBottomEdgeY`, `pcbX`, `pcbY`, `pcbOffsetX`, `pcbOffsetY`
+
+## References
+
+- Props: [FabricationNotePathProps](https://github.com/tscircuit/props#fabricationnotepathprops-fabricationnotepath)
+- Source: [lib/components/fabrication-note-path.ts](https://github.com/tscircuit/props/blob/main/lib/components/fabrication-note-path.ts)

package/dist/skill/elements/fabricationnoterect.md

@@ -0,0 +1,40 @@
+# `<fabricationnoterect />`
+
+Highlight fabrication callouts and assembly regions with rectangular annotations on the fabrication layer.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="28mm" height="20mm">
+    <resistor name="R1" resistance="1k" footprint="0603" pcbX={-6} pcbY={-2} />
+    <capacitor name="C1" capacitance="1uF" footprint="0603" pcbX={-2} pcbY={2} />
+    <fabricationnotetext
+      text="Install last"
+      pcbX={5}
+      pcbY={2}
+      anchorAlignment="bottom_left"
+      fontSize="1.4mm"
+    />
+    <fabricationnoterect
+      pcbX={0}
+      pcbY={0}
+      width={18}
+      height={12}
+      strokeWidth={0.3}
+      color="#2563eb"
+      hasStroke
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `width`, `height`, `strokeWidth`, `isFilled`, `hasStroke`, `isStrokeDashed`, `color`, `cornerRadius`
+
+## References
+
+- Props: [FabricationNoteRectProps](https://github.com/tscircuit/props#fabricationnoterectprops-fabricationnoterect)
+- Source: [lib/components/fabrication-note-rect.ts](https://github.com/tscircuit/props/blob/main/lib/components/fabrication-note-rect.ts)
+- Local docs: [docs/docs/footprints/fabricationnoterect.mdx](../docs/docs/footprints/fabricationnoterect.mdx)

package/dist/skill/elements/fabricationnotetext.md

@@ -0,0 +1,32 @@
+# `<fabricationnotetext />`
+
+The `<fabricationnotetext />` element adds fabrication layer callouts and build notes for assemblers.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="24mm" height="18mm">
+    <resistor name="R1" resistance="10k" footprint="0402" pcbX={-5} pcbY={0} />
+    <led name="D1" footprint="0603" pcbX={5} pcbY={0} />
+    <fabricationnotetext
+      text="Install connector last"
+      pcbX={0}
+      pcbY={6}
+      fontSize="1.6mm"
+      anchorAlignment="top_left"
+      color="#d97706"
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `text`, `anchorAlignment`, `font`, `fontSize`, `color`, `name`, `footprint`, `connections`
+
+## References
+
+- Props: [FabricationNoteTextProps](https://github.com/tscircuit/props#fabricationnotetextprops-fabricationnotetext)
+- Source: [lib/components/fabrication-note-text.ts](https://github.com/tscircuit/props/blob/main/lib/components/fabrication-note-text.ts)
+- Local docs: [docs/docs/footprints/fabricationnotetext.mdx](../docs/docs/footprints/fabricationnotetext.mdx)

package/dist/skill/elements/fiducial.md

@@ -0,0 +1,34 @@
+# `<fiducial />`
+
+A reference marker used for optical alignment during automated PCB assembly.
+
+## Example
+
+```tsx
+export default () => (
+    <board width="30mm" height="20mm">
+      <fiducial 
+        padDiameter="1mm" 
+        soldermaskPullback="1mm" 
+        pcbX={-10} 
+        pcbY={-5} 
+      />
+      <fiducial 
+        padDiameter="1mm" 
+        soldermaskPullback="1mm" 
+        pcbX={10} 
+        pcbY={5} 
+      />
+    </board>
+  )
+```
+
+## Props
+
+Commonly used: `soldermaskPullback`, `padDiameter`, `name`, `footprint`, `connections`
+
+## References
+
+- Props: [FiducialProps](https://github.com/tscircuit/props#fiducialprops-fiducial)
+- Source: [lib/components/fiducial.ts](https://github.com/tscircuit/props/blob/main/lib/components/fiducial.ts)
+- Local docs: [docs/docs/elements/fiducial.mdx](../docs/docs/elements/fiducial.mdx)

package/dist/skill/elements/footprint.md

@@ -0,0 +1,95 @@
+# `<footprint />`
+
+Used to define the physical layout and connection points for components on a printed circuit board.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="10mm" height="10mm">
+    <chip
+      name="U1"
+      footprint={
+        <footprint>
+          <platedhole
+            portHints={["4"]}
+            pcbX="3.2499299999998357mm"
+            pcbY="-2.249932000000058mm"
+            outerDiameter="1.9999959999999999mm"
+            holeDiameter="1.3000228mm"
+            shape="circle"
+          />
+          <platedhole
+            portHints={["2"]}
+            pcbX="3.2499299999998357mm"
+            pcbY="2.249932000000058mm"
+            outerDiameter="1.9999959999999999mm"
+            holeDiameter="1.3000228mm"
+            shape="circle"
+          />
+          <platedhole
+            portHints={["1"]}
+            pcbX="-3.2499299999999494mm"
+            pcbY="2.249932000000058mm"
+            outerDiameter="1.9999959999999999mm"
+            holeDiameter="1.3000228mm"
+            shape="circle"
+          />
+          <platedhole
+            portHints={["3"]}
+            pcbX="-3.2499299999999494mm"
+            pcbY="-2.249932000000058mm"
+            outerDiameter="1.9999959999999999mm"
+            holeDiameter="1.3000228mm"
+            shape="circle"
+          />
+          <silkscreenpath
+            route={[
+              { x: -2.2743160000001126, y: -2.999994000000015 },
+              { x: 2.274315999999999, y: -2.999994000000015 },
+            ]}
+          />
+          <silkscreenpath
+            route={[
+              { x: -2.999994000000129, y: 1.0999978000000965 },
+              { x: -2.999994000000129, y: -0.999998000000005 },
+            ]}
+          />
+          <silkscreenpath
+            route={[
+              { x: 3.0999937999998792, y: 1.0279888000000028 },
+              { x: 3.0999937999998792, y: -1.0999977999999828 },
+            ]}
+          />
+          <silkscreenpath
+            route={[
+              { x: -1.99999600000001, y: 2.999994000000015 },
+              { x: 2.274315999999999, y: 2.999994000000015 },
+            ]}
+          />
+        </footprint>
+      }
+      schPortArrangement={{
+        leftSide: {
+          direction: "top-to-bottom",
+          pins: [1, 3],
+        },
+        rightSide: {
+          direction: "bottom-to-top",
+          pins: [4, 2],
+        },
+      }}
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `children`, `originalLayer`, `circuitJson`, `src`, `name`, `footprint`, `connections`
+
+## References
+
+- Props: [FootprintProps](https://github.com/tscircuit/props#footprintprops-footprint)
+- Source: [lib/components/footprint.ts](https://github.com/tscircuit/props/blob/main/lib/components/footprint.ts)
+- Local docs: [docs/docs/elements/footprint.mdx](../docs/docs/elements/footprint.mdx)

package/dist/skill/elements/fuse.md

@@ -0,0 +1,28 @@
+# `<fuse />`
+
+A `<fuse />` is a safety device that protects electrical circuits by interrupting current flow when it exceeds a predetermined threshold. Fuses are essential for preventing damage to components and circuits from overcurrent conditions.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="10mm" height="10mm">
+    <fuse
+      name="F1"
+      footprint="0603"
+      currentRating="2A"
+      voltageRating="32V"
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `currentRating`, `voltageRating`, `schShowRatings`, `schOrientation`, `connections`, `name`, `footprint`
+
+## References
+
+- Props: [FuseProps](https://github.com/tscircuit/props#fuseprops-fuse)
+- Source: [lib/components/fuse.ts](https://github.com/tscircuit/props/blob/main/lib/components/fuse.ts)
+- Local docs: [docs/docs/elements/fuse.mdx](../docs/docs/elements/fuse.mdx)

package/dist/skill/elements/group.md

@@ -0,0 +1,29 @@
+# `<group />`
+
+A group is the basic container element that can contain other elements.
+
+## Example
+
+```tsx
+import { sel } from "tscircuit"
+
+export default () => (
+  <board width="10mm" height="10mm">
+    <resistor name="R1" resistance="1k" schX={-2} />
+    <group schY={-3}>
+      <resistor name="R2" resistance="1k" schX={2} />
+      <trace from={sel.R1.pin2} to={sel.R2.pin1} />
+    </group>
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `layoutMode`, `position`, `grid`, `gridCols`, `gridRows`, `gridTemplateRows`, `gridTemplateColumns`, `gridTemplate`
+
+## References
+
+- Props: [BaseGroupProps](https://github.com/tscircuit/props#basegroupprops-group)
+- Source: [lib/components/group.ts](https://github.com/tscircuit/props/blob/main/lib/components/group.ts)
+- Local docs: [docs/docs/elements/group.mdx](../docs/docs/elements/group.mdx)

package/dist/skill/elements/hole.md

@@ -0,0 +1,23 @@
+# `<hole />`
+
+Used for mounting and does not have conductive properties.
+
+## Example
+
+```tsx
+export default () => (
+    <board width="30mm" height="20mm">
+      <hole diameter="3mm" pcbX={0} pcbY={0} />
+    </board>
+  )
+```
+
+## Props
+
+Commonly used: `name`, `shape`, `diameter`, `radius`, `solderMaskMargin`, `coveredWithSolderMask`, `footprint`, `connections`
+
+## References
+
+- Props: [CircleHoleProps](https://github.com/tscircuit/props#circleholeprops-hole)
+- Source: [lib/components/hole.ts](https://github.com/tscircuit/props/blob/main/lib/components/hole.ts)
+- Local docs: [docs/docs/elements/hole.mdx](../docs/docs/elements/hole.mdx)

package/dist/skill/elements/inductor.md

@@ -0,0 +1,27 @@
+# `<inductor />`
+
+An `<inductor />` stores electrical energy in a magnetic field when current flows through it. Inductors are commonly used in filters, oscillators, power supplies, and RF circuits. They oppose changes in current flow and can smooth out rapid current variations.
+
+## Example
+
+```tsx
+export default () => (
+ <board width="10mm" height="10mm">
+  <inductor
+    name="L1"
+    footprint="0603"
+    inductance="10μH"
+  />
+ </board>
+)
+```
+
+## Props
+
+Commonly used: `inductance`, `maxCurrentRating`, `schOrientation`, `connections`, `name`, `footprint`
+
+## References
+
+- Props: [InductorProps](https://github.com/tscircuit/props#inductorprops-inductor)
+- Source: [lib/components/inductor.ts](https://github.com/tscircuit/props/blob/main/lib/components/inductor.ts)
+- Local docs: [docs/docs/elements/inductor.mdx](../docs/docs/elements/inductor.mdx)

package/dist/skill/elements/jumper.md

@@ -0,0 +1,23 @@
+# `<jumper />`
+
+A simple connector that typically uses a pinrow footprint but can be used for custom layouts as well.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="10mm" height="10mm">
+    <jumper name="J1" footprint="pinrow4" />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `manufacturerPartNumber`, `pinLabels`, `schPinStyle`, `schPinSpacing`, `schWidth`, `schHeight`, `schDirection`, `schPinArrangement`
+
+## References
+
+- Props: [JumperProps](https://github.com/tscircuit/props#jumperprops-jumper)
+- Source: [lib/components/jumper.ts](https://github.com/tscircuit/props/blob/main/lib/components/jumper.ts)
+- Local docs: [docs/docs/elements/jumper.mdx](../docs/docs/elements/jumper.mdx)