tsci-agent 0.1.0

package/dist/skill/WORKFLOW.md

@@ -0,0 +1,92 @@
+# Recommended workflow
+
+## 1) Start from a known shape
+
+- Prefer a standard template when possible (Arduino Shield, Raspberry Pi HAT, etc.)
+- Otherwise use `<board width height>` with explicit dimensions.
+
+## 2) Establish rails and connectors early
+
+- Decide net names (`net.GND`, `net.VCC`, `net.V3_3`, etc.)
+- Add power entry (USB-C, barrel jack, header) and protection (fuse/TVS) as appropriate.
+- For USB-C, use `<connector standard="usb_c" />` directly (no JLC import needed).
+
+## 3) Search before you model
+
+- Use `tsci search` to find:
+  - JLCPCB components: `tsci search --jlcpcb "STM32F4"`
+  - KiCad footprints: `tsci search --kicad "SOIC8"`
+  - Registry packages: `tsci search --tscircuit "ESP32"`
+
+## 4) Add/import parts
+
+- Prefer `tsci add <author/pkg>` when a reusable module exists.
+- Use `tsci import` when you must bring in a specific component (e.g., supplier part).
+- For JLCPCB parts: first search with `tsci search --jlcpcb "<query>"`, then import with `tsci import "<part number>"`.
+
+## 5) Define pinLabels and pinAttributes first
+
+**This is a critical step for chips and ICs.** Before wiring traces, ensure your components have correct `pinLabels` and `pinAttributes`.
+
+### Getting pin information right
+
+1. **Consult the datasheet** - Look up the component's datasheet to find the correct pin names and functions.
+
+2. **Define pinLabels** - Map physical pin numbers to meaningful names:
+   ```tsx
+   pinLabels={{
+     pin1: "VCC",
+     pin2: "GND",
+     pin3: ["SDA", "I2C_DATA"],
+     pin4: ["SCL", "I2C_CLK"],
+   }}
+   ```
+
+3. **Add pinAttributes** - Specify pin behavior for DRC and schematic clarity:
+   ```tsx
+   pinAttributes={{
+     VCC: { requiresPower: true },
+     EN: { mustBeConnected: true },
+     VOUT: { providesPower: true },
+   }}
+   ```
+
+4. **Verify pin mappings** - Double-check that:
+   - Power pins are marked with `requiresPower` or `providesPower`
+   - Critical control pins have `mustBeConnected: true`
+   - Multi-function pins have all relevant aliases
+
+## 6) Make a minimal, working first draft
+
+- Place core IC + passives
+- Wire nets using `<trace />`
+- Reference pins by label when pinLabels are defined:
+  ```tsx
+  <trace from="U1.VCC" to="net.V3_3" />
+  <trace from="U1.GND" to="net.GND" />
+  ```
+
+## 7) Iterate with `tsci build`
+
+- Run `tsci check netlist` before `tsci check schematic-placement`, `tsci check placement`, and `tsci build` to catch connectivity issues early.
+- Use `tsci check schematic-placement` to validate schematic-side placement before checking PCB placement.
+- Do not finalize unless both `tsci check schematic-placement` and `tsci check placement` pass with no actionable placement violations; if violations exist, fix layout and rerun until clean.
+- Run `tsci build` to validate changes—this is the preferred iteration method for AI-driven development.
+- DRC (Design Rule Check) errors can often be ignored during development; focus on connectivity and component placement first.
+- Fix connectivity errors first, then placement.
+- Run `tsci snapshot` to inspect placement before checking routing.
+- Run `tsci check routing-difficulty` after placement to identify potential areas of congestion.
+- Then address routing issues.
+- Use `tsci dev` only when interactive visual preview is needed (not typical for AI iteration).
+
+## 8) Stabilize and regression-test
+
+- Use `tsci build` in CI or before sharing.
+- Use `tsci snapshot` to generate visuals that help with placement analysis and quick circuit understanding.
+- Use `tsci snapshot --pcb-only` when you want a fast, placement-focused PCB view without schematic snapshots.
+- Use `tsci snapshot --test` in CI/regression checks to prevent overwriting snapshots and catch unexpected visual diffs.
+
+## 9) Export what you need
+
+- `tsci export` for SVG/netlist/DSN/3D/library
+- Fabrication zip (Gerbers/BOM/PnP): use the export UI after `tsci dev`

package/dist/skill/elements/analogsimulation.md

@@ -0,0 +1,32 @@
+# `<analogsimulation />`
+
+Configure and run SPICE simulations for a tscircuit board.
+
+## Example
+
+```tsx
+export default () => (
+  <board routingDisabled>
+    <voltagesource name="V1" voltage="5V" />
+    <resistor name="R1" resistance="1k" />
+
+    <trace from=".V1 > .pin1" to=".R1 > .pin1" />
+    <trace from=".V1 > .pin2" to=".R1 > .pin2" />
+
+    <voltageprobe name="VP_IN" connectsTo=".V1 > .pin1" />
+    <voltageprobe name="VP_OUT" connectsTo=".R1 > .pin1" />
+
+    <analogsimulation duration="10ms" timePerStep="0.1ms" spiceEngine="ngspice" />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `simulationType`, `duration`, `timePerStep`, `spiceEngine`, `name`, `footprint`, `connections`
+
+## References
+
+- Props: [AnalogSimulationProps](https://github.com/tscircuit/props#analogsimulationprops-analogsimulation)
+- Source: [lib/components/analogsimulation.ts](https://github.com/tscircuit/props/blob/main/lib/components/analogsimulation.ts)
+- Local docs: [docs/docs/elements/analogsimulation.mdx](../docs/docs/elements/analogsimulation.mdx)

package/dist/skill/elements/battery.md

@@ -0,0 +1,24 @@
+# `<battery />`
+
+A `<battery />` is a power source that provides electrical energy through electrochemical reactions. Batteries are essential components that supply power to electronic circuits and devices. They have a positive and negative terminal and must be connected with correct polarity.
+
+## Example
+
+```tsx
+export default () => (
+  <battery
+    name="BAT1"
+    capacity="2500mAh"
+  />
+)
+```
+
+## Props
+
+Commonly used: `capacity`, `voltage`, `standard`, `schOrientation`, `name`, `footprint`, `connections`
+
+## References
+
+- Props: [BatteryProps](https://github.com/tscircuit/props#batteryprops-battery)
+- Source: [lib/components/battery.ts](https://github.com/tscircuit/props/blob/main/lib/components/battery.ts)
+- Local docs: [docs/docs/elements/battery.mdx](../docs/docs/elements/battery.mdx)

package/dist/skill/elements/board.md

@@ -0,0 +1,23 @@
+# `<board />`
+
+Root element that contains all chips and traces to create a printed circuit board.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="10mm" height="10mm">
+    <resistor resistance="1k" footprint="0402" name="R1" />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `title`, `material`, `layers`, `borderRadius`, `thickness`, `boardAnchorPosition`, `anchorAlignment`, `boardAnchorAlignment`
+
+## References
+
+- Props: [BoardProps](https://github.com/tscircuit/props#boardprops-board)
+- Source: [lib/components/board.ts](https://github.com/tscircuit/props/blob/main/lib/components/board.ts)
+- Local docs: [docs/docs/elements/board.mdx](../docs/docs/elements/board.mdx)

package/dist/skill/elements/breakout.md

@@ -0,0 +1,68 @@
+# `<breakout />`
+
+A `<breakout />` is similar to a [`<group />`](./group.md) but is meant for situations where you want to guide the autorouter on where connections should exit the group. Inside a breakout you can place [`<breakoutpoint />`](./breakoutpoint.md) elements to define explicit exit locations, or let tscircuit generate breakout points automatically for connections that leave the breakout.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="20mm" height="20mm">
+    <breakout autorouter="auto">
+      <resistor name="R1" resistance="1k" footprint="0402" pcbX={0} pcbY={0} />
+      <capacitor name="C1" capacitance="1uF" footprint="0402" pcbX={2} pcbY={0} />
+      <trace from="R1.2" to="C1.1" />
+      <breakoutpoint connection="R1.1" pcbX={5} pcbY={5} />
+    </breakout>
+  </board>
+)
+```
+
+## Auto-generated breakout points
+
+When traces connect from components inside a `<breakout />` to components outside of it, tscircuit creates the needed breakout points automatically — no manual `<breakoutpoint />` required. This keeps the breakout local to the component cluster while still letting board-level traces reach headers and surrounding parts.
+
+```tsx
+export default () => (
+  <board width="20mm" height="16mm">
+    <breakout name="MCU_BREAKOUT" padding="1mm">
+      <chip
+        name="U1"
+        footprint="qfp16"
+        pinLabels={{ pin1: "GPIO1", pin5: "VCC", pin6: "GND", pin7: "SDA", pin8: "SCL" }}
+        pcbX={0}
+        pcbY={0}
+      />
+      <capacitor name="C1" capacitance="100nF" footprint="0402" pcbX={-3.5} pcbY={2.4} />
+      <trace from="C1.1" to="U1.GPIO1" />
+    </breakout>
+    <pinheader
+      name="J1"
+      pinCount={4}
+      footprint="pinrow4"
+      pinLabels={["VCC", "GND", "SDA", "SCL"]}
+      pcbX={7}
+      pcbY={0}
+      pcbRotation={90}
+    />
+    <trace from="J1.VCC" to="U1.VCC" />
+    <trace from="J1.GND" to="U1.GND" />
+    <trace from="J1.SDA" to="U1.SDA" />
+    <trace from="J1.SCL" to="U1.SCL" />
+  </board>
+)
+```
+
+## Props
+
+`<breakout />` accepts all the layout props of `<group />` plus:
+
+- `padding` — uniform padding around the breakout region
+- `paddingLeft` / `paddingRight` / `paddingTop` / `paddingBottom` — per-side padding
+- `autorouter` — autorouter configuration inherited by children
+
+## References
+
+- Props: [BreakoutProps](https://github.com/tscircuit/props#breakoutprops-breakout)
+- Source: [lib/components/breakout.ts](https://github.com/tscircuit/props/blob/main/lib/components/breakout.ts)
+- Related: [`<breakoutpoint />`](./breakoutpoint.md), [`<group />`](./group.md)
+- Docs: https://docs.tscircuit.com/elements/breakout

package/dist/skill/elements/breakoutpoint.md

@@ -0,0 +1,27 @@
+# `<breakoutpoint />`
+
+A `<breakoutpoint />` defines an explicit location where a connection should exit a [`<breakout />`](./breakout.md). Use it when you want to control exactly where a net escapes the breakout region instead of relying on auto-generated breakout points.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="20mm" height="20mm">
+    <breakout>
+      <resistor name="R1" resistance="1k" footprint="0402" pcbX={0} pcbY={0} />
+      <breakoutpoint connection="R1.1" pcbX={5} pcbY={5} />
+    </breakout>
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `connection` (the pin selector that should exit at this point), `pcbX`, `pcbY`
+
+## References
+
+- Props: [BreakoutPointProps](https://github.com/tscircuit/props#breakoutpointprops-breakoutpoint)
+- Source: [lib/components/breakout-point.ts](https://github.com/tscircuit/props/blob/main/lib/components/breakout-point.ts)
+- Related: [`<breakout />`](./breakout.md)
+- Docs: https://docs.tscircuit.com/elements/breakoutpoint

package/dist/skill/elements/cadassembly.md

@@ -0,0 +1,39 @@
+# `<cadassembly />`
+
+A CAD assembly is a collection of cad models and constraints to "put together" a component.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="10mm" height="10mm">
+    <chip
+      name="J1"
+      cadModel={
+        <cadassembly>
+          <cadmodel
+            positionOffset={{ x: 0, y: -4, z: 0 }}
+            rotationOffset={{ x: 0, y: 0, z: 0 }}
+            modelUrl="https://modelcdn.tscircuit.com/jscad_models/pinrow4.glb"
+          />
+          <cadmodel
+            positionOffset={{ x: 0, y: 4, z: 0 }}
+            rotationOffset={{ x: 0, y: 0, z: 0 }}
+            modelUrl="https://modelcdn.tscircuit.com/jscad_models/pinrow4.glb"
+          />
+        </cadassembly>
+      }
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `originalLayer`, `children`, `name`, `footprint`, `connections`
+
+## References
+
+- Props: [CadAssemblyProps](https://github.com/tscircuit/props#cadassemblyprops-cadassembly)
+- Source: [lib/components/cadassembly.ts](https://github.com/tscircuit/props/blob/main/lib/components/cadassembly.ts)
+- Local docs: [docs/docs/elements/cadassembly.mdx](../docs/docs/elements/cadassembly.mdx)

package/dist/skill/elements/cadmodel.md

@@ -0,0 +1,31 @@
+# `<cadmodel />`
+
+A CAD model is a 3D model of a component that can be used in a CAD assembly.
+
+## Example
+
+```tsx
+export default () => (
+  <board>
+    <chip
+      name="U1"
+      footprint="soic8"
+      cadModel={
+        <cadmodel
+          modelUrl="https://modelcdn.tscircuit.com/jscad_models/soic8.glb"
+        />
+      }
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `modelUrl`, `stepUrl`, `pcbX`, `pcbY`, `pcbLeftEdgeX`, `pcbRightEdgeX`, `pcbTopEdgeY`, `pcbBottomEdgeY`
+
+## References
+
+- Props: [CadModelProps](https://github.com/tscircuit/props#cadmodelprops-cadmodel)
+- Source: [lib/components/cadmodel.ts](https://github.com/tscircuit/props/blob/main/lib/components/cadmodel.ts)
+- Local docs: [docs/docs/elements/cadmodel.mdx](../docs/docs/elements/cadmodel.mdx)

package/dist/skill/elements/capacitor.md

@@ -0,0 +1,28 @@
+# `<capacitor />`
+
+A `<capacitor />` stores electrical energy in an electric field. Capacitors are commonly used for filtering, energy storage, and timing circuits. Unlike resistors, capacitors can be polarized (like electrolytic capacitors) or non-polarized (like ceramic capacitors).
+
+## Example
+
+```tsx
+export default () => (
+ <board width="10mm" height="10mm">
+  <capacitor
+    name="C2"
+    footprint="axial_p5mm"
+    capacitance="10μF"
+    polarized
+  /> 
+</board>
+)
+```
+
+## Props
+
+Commonly used: `capacitance`, `maxVoltageRating`, `schShowRatings`, `polarized`, `decouplingFor`, `decouplingTo`, `bypassFor`, `bypassTo`
+
+## References
+
+- Props: [CapacitorProps](https://github.com/tscircuit/props#capacitorprops-capacitor)
+- Source: [lib/components/capacitor.ts](https://github.com/tscircuit/props/blob/main/lib/components/capacitor.ts)
+- Local docs: [docs/docs/elements/capacitor.mdx](../docs/docs/elements/capacitor.mdx)

package/dist/skill/elements/chip.md

@@ -0,0 +1,44 @@
+# `<chip />`
+
+Used to represent virtually any single-part electronic component. Extremely flexible and supports custom footprints and pin arrangements.
+
+## Example
+
+```tsx
+import type { CommonLayoutProps } from "tscircuit"
+
+interface Props extends CommonLayoutProps {
+  name: string
+}
+
+export const A555Timer = (props: Props) => {
+  return (
+   <board width="10mm" height="10mm">
+    <chip
+      footprint="soic8"
+      pinLabels={{
+        pin1: "VCC",
+        pin2: "DISCH",
+        pin3: "THRES",
+        pin4: "CTRL",
+        pin5: "GND",
+        pin6: "TRIG",
+        pin7: "OUT",
+        pin8: "RESET"
+      }}
+      {...props}
+    />
+  </board>
+  )
+}
+```
+
+## Props
+
+Commonly used: `manufacturerPartNumber`, `pinLabels`, `showPinAliases`, `pcbPinLabels`, `schPinArrangement`, `schPortArrangement`, `pinCompatibleVariants`, `schPinStyle`
+
+## References
+
+- Props: [ChipProps](https://github.com/tscircuit/props#chipprops-chip)
+- Source: [lib/components/chip.ts](https://github.com/tscircuit/props/blob/main/lib/components/chip.ts)
+- Local docs: [docs/docs/elements/chip.mdx](../docs/docs/elements/chip.mdx)

package/dist/skill/elements/connector.md

@@ -0,0 +1,125 @@
+# `<connector />`
+
+A general-purpose connector component for board-to-board, cable, and edge interfaces.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="40mm" height="40mm">
+    <connector
+      name="J1"
+      manufacturerPartNumber="AF_QTZB1_0"
+      pinLabels={{
+        pin1: ["VCC"],
+        pin2: ["D_NEG"],
+        pin3: ["D_POS"],
+        pin4: ["GND"],
+        pin5: ["EH1"],
+        pin6: ["EH2"],
+      }}
+      footprint={
+        <footprint>
+          <hole pcbX="-2.5mm" pcbY="-2.125mm" diameter="1.3mm" />
+          <hole pcbX="2.5mm" pcbY="-2.125mm" diameter="1.3mm" />
+          <smtpad
+            portHints={["pin1"]}
+            pcbX="-3.5mm"
+            pcbY="1.575mm"
+            width="1.1mm"
+            height="3.8mm"
+            shape="rect"
+          />
+          <smtpad
+            portHints={["pin2"]}
+            pcbX="-1mm"
+            pcbY="1.575mm"
+            width="1.1mm"
+            height="3.8mm"
+            shape="rect"
+          />
+          <smtpad
+            portHints={["pin3"]}
+            pcbX="1mm"
+            pcbY="1.575mm"
+            width="1.1mm"
+            height="3.8mm"
+            shape="rect"
+          />
+          <smtpad
+            portHints={["pin4"]}
+            pcbX="3.5mm"
+            pcbY="1.575mm"
+            width="1.1mm"
+            height="3.8mm"
+            shape="rect"
+          />
+          <smtpad
+            portHints={["pin5"]}
+            pcbX="7.15mm"
+            pcbY="-1.475mm"
+            width="1.8mm"
+            height="4mm"
+            shape="rect"
+          />
+          <smtpad
+            portHints={["pin6"]}
+            pcbX="-7.15mm"
+            pcbY="-1.475mm"
+            width="1.8mm"
+            height="4mm"
+            shape="rect"
+          />
+        </footprint>
+      }
+    />
+  </board>
+)
+```
+
+## USB-C standard example
+
+```tsx
+export default () => (
+  <board width="20mm" height="20mm">
+    <connector name="USBC" standard="usb_c" pcbX={0} pcbY={0} />
+  </board>
+)
+```
+
+## Accessible orientation warning
+
+Placement checks can warn when a connector faces away from the nearest board edge:
+
+```text
+J1 is facing x+ but should face x- so the connector is accessible from the board edge
+```
+
+For side-entry connectors, place the connector near the board edge it should face, then use `pcbRotation` if needed so the cable or mating part enters from that edge.
+
+For vertical-entry connectors, such as a battery connector inserted from above, set `insertionDirection="from_above"` on the `<footprint />`. This tells the checker that the connector does not need to face a board edge.
+
+```tsx
+<connector
+  name="J1"
+  pcbX="0"
+  pcbY="0"
+  footprint={
+    <footprint insertionDirection="from_above">
+      {/* pads / holes */}
+    </footprint>
+  }
+/>
+```
+
+Other insertion directions are `from_left`, `from_right`, `from_front`, and `from_back`.
+
+## Props
+
+Commonly used: `standard`, `name`, `footprint`, `connections`
+
+## References
+
+- Props: [ConnectorProps](https://github.com/tscircuit/props#connectorprops-connector)
+- Source: [lib/components/connector.ts](https://github.com/tscircuit/props/blob/main/lib/components/connector.ts)
+- Local docs: [docs/docs/elements/connector.mdx](../docs/docs/elements/connector.mdx)

package/dist/skill/elements/constraint.md

@@ -0,0 +1,73 @@
+# `<constraint />`
+
+The `<constraint />` element is used to enforce geometric relationships between different elements in a PCB footprint. Constraints can set specific distances and alignments, such as center-to-center, edge-to-edge, or ensuring two elements line up along the same axis.
+
+## Example
+
+```tsx
+/**
+ * A switch shaft you can use to connect a pluggable Kailh socket.
+ */
+const KeyswitchSocket = (props: {
+  name: string
+  pcbX?: number
+  pcbY?: number
+  layer?: "top" | "bottom"
+}) => (
+  <chip
+    {...props}
+    cadModel={{
+      objUrl: "/easyeda/C5184526",
+    }}
+    footprint={
+      <footprint>
+        {/* <silkscreentext text={props.name} /> */}
+        <smtpad
+          shape="rect"
+          width="2.55mm"
+          height="2.5mm"
+          portHints={["pin1"]}
+          layer="top"
+        />
+        <smtpad
+          shape="rect"
+          width="2.55mm"
+          height="2.5mm"
+          portHints={["pin2"]}
+          layer="top"
+        />
+        <hole name="H1" diameter="3mm" />
+        <hole name="H2" diameter="3mm" />
+        <constraint xDist="6.35mm" centerToCenter left=".H1" right=".H2" />
+        <constraint yDist="2.54mm" centerToCenter top=".H1" bottom=".H2" />
+        <constraint edgeToEdge xDist="11.3mm" left=".pin1" right=".pin2" />
+        <constraint sameY for={[".pin1", ".H1"]} />
+        <constraint sameY for={[".pin2", ".H2"]} />
+        <constraint
+          edgeToEdge
+          xDist={(11.3 - 6.35 - 3) / 2}
+          left=".pin1"
+          right=".H1"
+        />
+      </footprint>
+    }
+  />
+)
+
+export default () => (
+  <board width="40mm" height="40mm">
+    <KeyswitchSocket name="SW1" pcbX={-10} pcbY={0} layer="top" />
+    <KeyswitchSocket name="SW2" pcbX={10} pcbY={0} layer="bottom" />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `pcb`, `xDist`, `left`, `right`, `edgeToEdge`, `centerToCenter`, `yDist`, `top`
+
+## References
+
+- Props: [ConstraintProps](https://github.com/tscircuit/props#constraintprops-constraint)
+- Source: [lib/components/constraint.ts](https://github.com/tscircuit/props/blob/main/lib/components/constraint.ts)
+- Local docs: [docs/docs/footprints/constraint.mdx](../docs/docs/footprints/constraint.mdx)

package/dist/skill/elements/copperpour.md

@@ -0,0 +1,34 @@
+# `<copperpour />`
+
+The `<copperpour />` element (also known as a groundplane) fills large areas of a layer with copper tied to a specific net, helping with return paths, shielding, and thermal performance.
+
+Local long-form docs currently live in `docs/docs/elements/groundplane.mdx`.
+
+## Example
+
+```tsx
+export default () => (
+  <board
+    width="30mm"
+    height="20mm"
+  >
+    <chip name="U1" footprint="soic8" pcbX={-6} pcbY={0} />
+    <resistor name="R1" resistance="10k" footprint="0402" pcbX={6} pcbY={4} />
+    <capacitor name="C1" capacitance="100nF" footprint="0402" pcbX={6} pcbY={-4} />
+    <trace from=".R1 > .pin2" to="net.GND" />
+    <trace from=".C1 > .pin2" to="net.GND" />
+    <trace from=".U1 > .pin4" to="net.GND" />
+    <copperpour connectsTo="net.GND" layer="top" clearance="0.15mm" />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `name`, `layer`, `connectsTo`, `padMargin`, `traceMargin`, `clearance`, `boardEdgeMargin`, `cutoutMargin`
+
+## References
+
+- Props: [CopperPourProps](https://github.com/tscircuit/props#copperpourprops-copperpour)
+- Source: [lib/components/copper-pour.ts](https://github.com/tscircuit/props/blob/main/lib/components/copper-pour.ts)
+- Local docs: [docs/docs/elements/groundplane.mdx](../docs/docs/elements/groundplane.mdx)

package/dist/skill/elements/coppertext.md

@@ -0,0 +1,28 @@
+# `<coppertext />`
+
+Copper-layer text for labels, logos, and exposed copper markings.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="20mm" height="10mm">
+    <coppertext
+      text="GND"
+      pcbX={0}
+      pcbY={0}
+      layers={["top"]}
+      fontSize="2mm"
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `text`, `anchorAlignment`, `font`, `fontSize`, `layers`, `knockout`, `mirrored`, `pcbX`
+
+## References
+
+- Props: [CopperTextProps](https://github.com/tscircuit/props#coppertextprops-coppertext)
+- Source: [lib/components/copper-text.ts](https://github.com/tscircuit/props/blob/main/lib/components/copper-text.ts)