tsci-agent 0.1.0

package/dist/skill/elements/resistor.md

@@ -0,0 +1,27 @@
+# `<resistor />`
+
+A `<resistor />` is an extremely common element of electronic designs. It limits the flow of electricity and is critical to making sure digital signals are properly "pulled up" or "pulled down" to set their default value as `1` or `0`
+
+## Example
+
+```tsx
+export default () => (
+ <board width="10mm" height="10mm">
+    <resistor
+      name="R1"
+      footprint="0402"
+      resistance="1k"
+    />
+ </board>
+)
+```
+
+## Props
+
+Commonly used: `resistance`, `tolerance`, `pullupFor`, `pullupTo`, `pulldownFor`, `pulldownTo`, `schOrientation`, `schSize`
+
+## References
+
+- Props: [ResistorProps](https://github.com/tscircuit/props#resistorprops-resistor)
+- Source: [lib/components/resistor.ts](https://github.com/tscircuit/props/blob/main/lib/components/resistor.ts)
+- Local docs: [docs/docs/elements/resistor.mdx](../docs/docs/elements/resistor.mdx)

package/dist/skill/elements/resonator.md

@@ -0,0 +1,28 @@
+# `<resonator />`
+
+Provides a stable frequency reference for circuits, often used in clock or timing applications.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="10mm" height="10mm">
+    <resonator
+      name="X1"
+      frequency="16MHz"
+      loadCapacitance="5pF"
+      footprint="hc49"
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `frequency`, `loadCapacitance`, `pinVariant`, `name`, `footprint`, `connections`
+
+## References
+
+- Props: [ResonatorProps](https://github.com/tscircuit/props#resonatorprops-resonator)
+- Source: [lib/components/resonator.ts](https://github.com/tscircuit/props/blob/main/lib/components/resonator.ts)
+- Local docs: [docs/docs/elements/resonator.mdx](../docs/docs/elements/resonator.mdx)

package/dist/skill/elements/schematicarc.md

@@ -0,0 +1,39 @@
+# `<schematicarc />`
+
+Draw circular arcs within custom schematic symbols.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="10mm" height="10mm">
+    <chip
+      name="U1"
+      symbol={
+        <symbol>
+          <schematicarc
+            center={{ x: 0, y: 0 }}
+            radius={1}
+            startAngleDegrees={0}
+            endAngleDegrees={180}
+            strokeWidth={0.05}
+          />
+          <schematicline x1={-1} y1={0} x2={1} y2={0} strokeWidth={0.05} />
+          <port name="pin1" direction="left" schX={-1} schY={0} />
+          <port name="pin2" direction="right" schX={1} schY={0} />
+        </symbol>
+      }
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `center`, `radius`, `startAngleDegrees`, `endAngleDegrees`, `direction`, `strokeWidth`, `color`, `isDashed`
+
+## References
+
+- Props: [SchematicArcProps](https://github.com/tscircuit/props#schematicarcprops-schematicarc)
+- Source: [lib/components/schematic-arc.ts](https://github.com/tscircuit/props/blob/main/lib/components/schematic-arc.ts)
+- Local docs: [docs/docs/elements/schematicarc.mdx](../docs/docs/elements/schematicarc.mdx)

package/dist/skill/elements/schematicbox.md

@@ -0,0 +1,22 @@
+# `<schematicbox />`
+
+Schematic-space box for grouping or callouts.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="20mm" height="12mm">
+    <schematicbox schX={0} schY={0} width="18mm" height="10mm" title="Power" />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `schX`, `schY`, `width`, `height`, `overlay`, `padding`, `paddingLeft`, `paddingRight`
+
+## References
+
+- Props: [SchematicBoxProps](https://github.com/tscircuit/props#schematicboxprops-schematicbox)
+- Source: [lib/components/schematic-box.ts](https://github.com/tscircuit/props/blob/main/lib/components/schematic-box.ts)

package/dist/skill/elements/schematiccell.md

@@ -0,0 +1,26 @@
+# `<schematiccell />`
+
+A single cell inside `<schematictable />`.
+
+## Example
+
+```tsx
+export default () => (
+  <schematictable schX={0} schY={0}>
+    <schematicrow height={0.6}>
+      <schematiccell text="R1" />
+      <schematiccell text="10k" horizontalAlign="center" />
+    </schematicrow>
+  </schematictable>
+)
+```
+
+## Props
+
+Commonly used: `children`, `horizontalAlign`, `verticalAlign`, `fontSize`, `rowSpan`, `colSpan`, `width`, `text`
+
+## References
+
+- Props: [SchematicCellProps](https://github.com/tscircuit/props#schematiccellprops-schematiccell)
+- Source: [lib/components/schematic-cell.ts](https://github.com/tscircuit/props/blob/main/lib/components/schematic-cell.ts)
+- Local docs: [docs/docs/elements/schematictable.mdx](../docs/docs/elements/schematictable.mdx)

package/dist/skill/elements/schematiccircle.md

@@ -0,0 +1,36 @@
+# `<schematiccircle />`
+
+Draw circles within custom schematic symbols.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="10mm" height="10mm">
+    <chip
+      name="U1"
+      symbol={
+        <symbol>
+          <schematiccircle
+            center={{ x: 0, y: 0 }}
+            radius={1}
+            isFilled={false}
+          />
+          <port name="pin1" direction="left" schX={-1} schY={0} />
+          <port name="pin2" direction="right" schX={1} schY={0} />
+        </symbol>
+      }
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `center`, `radius`, `strokeWidth`, `color`, `isFilled`, `fillColor`, `isDashed`, `name`
+
+## References
+
+- Props: [SchematicCircleProps](https://github.com/tscircuit/props#schematiccircleprops-schematiccircle)
+- Source: [lib/components/schematic-circle.ts](https://github.com/tscircuit/props/blob/main/lib/components/schematic-circle.ts)
+- Local docs: [docs/docs/elements/schematiccircle.mdx](../docs/docs/elements/schematiccircle.mdx)

package/dist/skill/elements/schematicline.md

@@ -0,0 +1,39 @@
+# `<schematicline />`
+
+Draw straight lines within custom schematic symbols.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="10mm" height="10mm">
+    <chip
+      name="U1"
+      symbol={
+        <symbol>
+          <schematicrect
+            schX={0}
+            schY={0}
+            width={2}
+            height={1.5}
+            isFilled={false}
+          />
+          <schematicline x1={-1} y1={0} x2={1} y2={0} strokeWidth={0.04} />
+          <port name="in" direction="left" schX={-1} schY={0} />
+          <port name="out" direction="right" schX={1} schY={0} />
+        </symbol>
+      }
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `x1`, `y1`, `x2`, `y2`, `strokeWidth`, `color`, `isDashed`, `name`
+
+## References
+
+- Props: [SchematicLineProps](https://github.com/tscircuit/props#schematiclineprops-schematicline)
+- Source: [lib/components/schematic-line.ts](https://github.com/tscircuit/props/blob/main/lib/components/schematic-line.ts)
+- Local docs: [docs/docs/elements/schematicline.mdx](../docs/docs/elements/schematicline.mdx)

package/dist/skill/elements/schematicpath.md

@@ -0,0 +1,40 @@
+# `<schematicpath />`
+
+Draw connected line segments within custom schematic symbols.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="12mm" height="10mm">
+    <chip
+      name="U1"
+      symbol={
+        <symbol>
+          <schematicpath
+            strokeWidth={0.05}
+            points={[
+              { x: -1, y: -0.6 },
+              { x: -0.3, y: 0.6 },
+              { x: 0.4, y: -0.6 },
+              { x: 1.1, y: 0.6 },
+            ]}
+          />
+          <port name="in" direction="left" schX={-1.5} schY={0} />
+          <port name="out" direction="right" schX={1.5} schY={0} />
+        </symbol>
+      }
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `points`, `svgPath`, `strokeWidth`, `strokeColor`, `isFilled`, `fillColor`, `name`, `footprint`
+
+## References
+
+- Props: [SchematicPathProps](https://github.com/tscircuit/props#schematicpathprops-schematicpath)
+- Source: [lib/components/schematic-path.ts](https://github.com/tscircuit/props/blob/main/lib/components/schematic-path.ts)
+- Local docs: [docs/docs/elements/schematicpath.mdx](../docs/docs/elements/schematicpath.mdx)

package/dist/skill/elements/schematicrect.md

@@ -0,0 +1,38 @@
+# `<schematicrect />`
+
+Draw rectangles and boxes within custom schematic symbols.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="10mm" height="10mm">
+    <chip
+      name="U1"
+      symbol={
+        <symbol>
+          <schematicrect
+            schX={0}
+            schY={0}
+            width={2}
+            height={1.5}
+            isFilled={false}
+          />
+          <port name="pin1" direction="left" schX={-1} schY={0} />
+          <port name="pin2" direction="right" schX={1} schY={0} />
+        </symbol>
+      }
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `schX`, `schY`, `width`, `height`, `rotation`, `strokeWidth`, `color`, `isFilled`
+
+## References
+
+- Props: [SchematicRectProps](https://github.com/tscircuit/props#schematicrectprops-schematicrect)
+- Source: [lib/components/schematic-rect.ts](https://github.com/tscircuit/props/blob/main/lib/components/schematic-rect.ts)
+- Local docs: [docs/docs/elements/schematicrect.mdx](../docs/docs/elements/schematicrect.mdx)

package/dist/skill/elements/schematicrow.md

@@ -0,0 +1,26 @@
+# `<schematicrow />`
+
+A row inside `<schematictable />`.
+
+## Example
+
+```tsx
+export default () => (
+  <schematictable schX={0} schY={0}>
+    <schematicrow height={0.6}>
+      <schematiccell text="R1" />
+      <schematiccell text="10k" />
+    </schematicrow>
+  </schematictable>
+)
+```
+
+## Props
+
+Commonly used: `children`, `height`, `schX`, `schY`
+
+## References
+
+- Props: [SchematicRowProps](https://github.com/tscircuit/props#schematicrowprops-schematicrow)
+- Source: [lib/components/schematic-row.ts](https://github.com/tscircuit/props/blob/main/lib/components/schematic-row.ts)
+- Local docs: [docs/docs/elements/schematictable.mdx](../docs/docs/elements/schematictable.mdx)

package/dist/skill/elements/schematicsection.md

@@ -0,0 +1,91 @@
+# `<schematicsection />`
+
+Groups components into a named section on the schematic (e.g. "Power", "Digital").
+
+Use `schSectionName` on any component to assign it to a section, then declare the section with `<schematicsection />`.
+
+> **No auto-layout.** `<schematicsection />` does NOT move components. You must manually place all components in the section in close proximity using `schX`/`schY` so the section renders as a coherent group.
+
+## Placement rule
+
+Pick a cluster origin (e.g. `schX={0} schY={0}`) and place all section members nearby. Components scattered across the schematic will still be tagged to the section but will look disconnected.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="40mm" height="20mm">
+    <schematicsection name="Power" displayName="Power Supply" />
+    <schematicsection name="IO" displayName="Input / Output" />
+
+    {/* Power section — cluster around schX=0 */}
+    <capacitor
+      name="C1"
+      capacitance="100nF"
+      footprint="0402"
+      schSectionName="Power"
+      schX={0}
+      schY={0}
+    />
+    <capacitor
+      name="C2"
+      capacitance="10uF"
+      footprint="0805"
+      schSectionName="Power"
+      schX={2}
+      schY={0}
+    />
+    <resistor
+      name="R1"
+      resistance="10k"
+      footprint="0402"
+      schSectionName="Power"
+      schX={4}
+      schY={0}
+    />
+
+    {/* IO section — cluster around schX=12, well separated from Power */}
+    <pushbutton
+      name="BTN1"
+      footprint="button_4pin"
+      schSectionName="IO"
+      schX={12}
+      schY={0}
+    />
+    <resistor
+      name="R2"
+      resistance="1k"
+      footprint="0402"
+      schSectionName="IO"
+      schX={14}
+      schY={0}
+    />
+  </board>
+)
+```
+
+## Props
+
+| Prop | Type | Required | Description |
+|------|------|----------|-------------|
+| `name` | `string` | yes | Unique identifier for the section |
+| `displayName` | `string` | no | Human-readable label shown on schematic |
+
+## Assigning components to a section
+
+Any component that accepts `CommonComponentProps` has `schSectionName`. Set it to the `name` of a `<schematicsection />`.
+
+```tsx
+<resistor name="R1" resistance="10k" footprint="0402" schSectionName="Power" schX={0} schY={0} />
+```
+
+## Layout guidance
+
+- Keep section members within ~4–6 schematic units of each other.
+- Separate different sections by at least 6–8 units so section boundaries are visually clear.
+- Arrange members in a row or grid — do not leave large schX/schY gaps between them.
+
+## References
+
+- Props: [SchematicSectionProps](https://github.com/tscircuit/props#schematicsectionprops-schematicsection)
+- Source: [lib/components/schematic-section.ts](https://github.com/tscircuit/props/blob/main/lib/components/schematic-section.ts)

package/dist/skill/elements/schematictable.md

@@ -0,0 +1,48 @@
+# `<schematictable />`
+
+Draw tables within schematics.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="20mm" height="20mm">
+    <schematictable
+      schX={0}
+      schY={0}
+      borderWidth={0.05}
+      fontSize={0.3}
+      cellPadding={0.15}
+    >
+      <schematicrow height={0.6}>
+        <schematiccell text="Component" />
+        <schematiccell text="Value" horizontalAlign="center" />
+        <schematiccell text="Package" />
+      </schematicrow>
+      <schematicrow height={0.6}>
+        <schematiccell text="R1" />
+        <schematiccell text="10k" horizontalAlign="center" />
+        <schematiccell text="0805" />
+      </schematicrow>
+      <schematicrow height={0.6}>
+        <schematiccell text="C1" />
+        <schematiccell text="100nF" horizontalAlign="center" />
+        <schematiccell text="0402" />
+      </schematicrow>
+      <schematicrow height={0.6}>
+        <schematiccell text="U1" colSpan={3} horizontalAlign="center" text="ATmega328P" />
+      </schematicrow>
+    </schematictable>
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `schX`, `schY`, `children`, `cellPadding`, `borderWidth`, `anchor`, `fontSize`, `name`
+
+## References
+
+- Props: [SchematicTableProps](https://github.com/tscircuit/props#schematictableprops-schematictable)
+- Source: [lib/components/schematic-table.ts](https://github.com/tscircuit/props/blob/main/lib/components/schematic-table.ts)
+- Local docs: [docs/docs/elements/schematictable.mdx](../docs/docs/elements/schematictable.mdx)

package/dist/skill/elements/schematictext.md

@@ -0,0 +1,23 @@
+# `<schematictext />`
+
+The `<schematictext />` element places text directly on the schematic.
+
+## Example
+
+```tsx
+export default () => (
+    <board width="10mm" height="10mm">
+      <schematictext text="Hello" schX={2} schY={3} color="red" anchor="center" />
+    </board>
+  )
+```
+
+## Props
+
+Commonly used: `schX`, `schY`, `text`, `fontSize`, `anchor`, `color`, `schRotation`, `name`
+
+## References
+
+- Props: [SchematicTextProps](https://github.com/tscircuit/props#schematictextprops-schematictext)
+- Source: [lib/components/schematic-text.ts](https://github.com/tscircuit/props/blob/main/lib/components/schematic-text.ts)
+- Local docs: [docs/docs/elements/schematictext.mdx](../docs/docs/elements/schematictext.mdx)

package/dist/skill/elements/silkscreencircle.md

@@ -0,0 +1,27 @@
+# `<silkscreencircle />`
+
+Silkscreen circles are often used to indicate "pin1" on a chip.
+
+## Example
+
+```tsx
+export default () => (
+<board width="5mm" height="5mm">
+  <group>
+    <footprint>
+      <silkscreencircle pcbX={0} pcbY={0} radius={1} />
+    </footprint>
+  </group>
+</board>
+)
+```
+
+## Props
+
+Commonly used: `isFilled`, `isOutline`, `strokeWidth`, `radius`, `name`, `footprint`, `connections`
+
+## References
+
+- Props: [SilkscreenCircleProps](https://github.com/tscircuit/props#silkscreencircleprops-silkscreencircle)
+- Source: [lib/components/silkscreen-circle.ts](https://github.com/tscircuit/props/blob/main/lib/components/silkscreen-circle.ts)
+- Local docs: [docs/docs/footprints/silkscreencircle.mdx](../docs/docs/footprints/silkscreencircle.mdx)

package/dist/skill/elements/silkscreenline.md

@@ -0,0 +1,31 @@
+# `<silkscreenline />`
+
+The `<silkscreenline />` element creates a line on the silkscreen layer within a footprint.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="50mm" height="50mm">
+    <footprint>
+      <silkscreenline 
+        x1="-20mm" 
+        y1="0mm" 
+        x2="20mm" 
+        y2="0mm"
+        strokeWidth="0.1mm"
+      />
+    </footprint>
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `pcbX`, `pcbY`, `pcbOffsetX`, `pcbOffsetY`, `pcbRotation`, `strokeWidth`, `x1`, `y1`
+
+## References
+
+- Props: [SilkscreenLineProps](https://github.com/tscircuit/props#silkscreenlineprops-silkscreenline)
+- Source: [lib/components/silkscreen-line.ts](https://github.com/tscircuit/props/blob/main/lib/components/silkscreen-line.ts)
+- Local docs: [docs/docs/footprints/silkscreenline.mdx](../docs/docs/footprints/silkscreenline.mdx)

package/dist/skill/elements/silkscreenpath.md

@@ -0,0 +1,70 @@
+# `<silkscreenpath />`
+
+The `<silkscreenpath />` element is used to define a custom drawn path on the silkscreen layer.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="100mm" height="100mm">
+    <chip name="U1" footprint={
+      <footprint>
+        <silkscreenpath 
+          strokeWidth="0.5mm"
+          route={[
+              { x: "0mm", y: "20mm" },
+              { x: "-1.53mm", y: "19.88mm" },
+              { x: "-3.04mm", y: "19.52mm" },
+              { x: "-4.50mm", y: "18.93mm" },
+              { x: "-5.88mm", y: "18.09mm" },
+              { x: "-7.16mm", y: "17.04mm" },
+              { x: "-8.32mm", y: "15.78mm" },
+              { x: "-9.33mm", y: "14.33mm" },
+              { x: "-10.17mm", y: "12.72mm" },
+              { x: "-10.82mm", y: "10.98mm" },
+              { x: "-11.27mm", y: "9.13mm" },
+              { x: "-11.52mm", y: "7.23mm" },
+              { x: "-11.55mm", y: "5.29mm" },
+              { x: "-11.37mm", y: "3.36mm" },
+              { x: "-10.98mm", y: "1.47mm" },
+              { x: "-10.39mm", y: "0mm" },
+              
+              { x: "10.39mm", y: "0mm" },
+              { x: "39.61mm", y: "0mm" },
+              
+              { x: "39.61mm", y: "0mm" },
+              { x: "41.08mm", y: "0.12mm" },
+              { x: "42.59mm", y: "0.48mm" },
+              { x: "44.05mm", y: "1.07mm" },
+              { x: "45.43mm", y: "1.91mm" },
+              { x: "46.71mm", y: "2.96mm" },
+              { x: "47.87mm", y: "4.22mm" },
+              { x: "48.88mm", y: "5.67mm" },
+              { x: "49.72mm", y: "7.28mm" },
+              { x: "50.37mm", y: "9.02mm" },
+              { x: "50.82mm", y: "10.87mm" },
+              { x: "51.07mm", y: "12.77mm" },
+              { x: "51.10mm", y: "14.71mm" },
+              { x: "50.92mm", y: "16.64mm" },
+              { x: "50.53mm", y: "18.53mm" },
+              { x: "49.94mm", y: "20mm" },
+              
+              { x: "49.94mm", y: "20mm" },
+              { x: "0mm", y: "20mm" }
+          ]}
+        />
+      </footprint>
+    } pcbX={-15} />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `pcbLeftEdgeX`, `pcbRightEdgeX`, `pcbTopEdgeY`, `pcbBottomEdgeY`, `pcbX`, `pcbY`, `pcbOffsetX`, `pcbOffsetY`
+
+## References
+
+- Props: [SilkscreenPathProps](https://github.com/tscircuit/props#silkscreenpathprops-silkscreenpath)
+- Source: [lib/components/silkscreen-path.ts](https://github.com/tscircuit/props/blob/main/lib/components/silkscreen-path.ts)
+- Local docs: [docs/docs/footprints/silkscreenpath.mdx](../docs/docs/footprints/silkscreenpath.mdx)

package/dist/skill/elements/silkscreenrect.md

@@ -0,0 +1,25 @@
+# `<silkscreenrect />`
+
+Silkscreen rectangles can be used to encapsulate a rectangular area around a chip.
+
+## Example
+
+```tsx
+export default () => (
+<board width="5mm" height="5mm">
+   <footprint>
+     <silkscreenrect pcbX={0} pcbY={0} width={1} height={1} />
+   </footprint>
+ </board>
+ )
+```
+
+## Props
+
+Commonly used: `filled`, `stroke`, `strokeWidth`, `width`, `height`, `cornerRadius`, `name`, `footprint`
+
+## References
+
+- Props: [SilkscreenRectProps](https://github.com/tscircuit/props#silkscreenrectprops-silkscreenrect)
+- Source: [lib/components/silkscreen-rect.ts](https://github.com/tscircuit/props/blob/main/lib/components/silkscreen-rect.ts)
+- Local docs: [docs/docs/footprints/silkscreenrect.mdx](../docs/docs/footprints/silkscreenrect.mdx)

package/dist/skill/elements/silkscreentext.md

@@ -0,0 +1,23 @@
+# `<silkscreentext />`
+
+The `<silkscreentext />` element is used to add text to the silkscreen layer within a PCB footprint.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="10mm" height="10mm">
+    <silkscreentext text="Hello, World!" fontSize="1mm" />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `text`, `anchorAlignment`, `font`, `fontSize`, `isKnockout`, `knockoutPadding`, `knockoutPaddingLeft`, `knockoutPaddingRight`
+
+## References
+
+- Props: [SilkscreenTextProps](https://github.com/tscircuit/props#silkscreentextprops-silkscreentext)
+- Source: [lib/components/silkscreen-text.ts](https://github.com/tscircuit/props/blob/main/lib/components/silkscreen-text.ts)
+- Local docs: [docs/docs/footprints/silkscreentext.mdx](../docs/docs/footprints/silkscreentext.mdx)