@tscircuit/props 0.0.537 → 0.0.539

package/lib/components/chip.ts

@@ -1,5 +1,6 @@
 import { distance, supplier_name } from "circuit-json"
 import type { Distance } from "lib/common/distance"
+import type { SpicemodelProps } from "lib/components/spicemodel"
 import {
   type CommonComponentProps,
   commonComponentProps,
@@ -19,6 +20,7 @@ import {
 } from "lib/common/schematicPinLabel"
 import { expectTypesMatch } from "lib/typecheck"
 import type { Connections } from "lib/utility-types/connections-and-selectors"
+import type { ReactElement } from "react"
 import { z } from "zod"
 
 export type PinLabelsProp<
@@ -36,6 +38,8 @@ export interface PinCompatibleVariant {
   supplierPartNumber?: SupplierPartNumbers
 }
 
+export type SpicemodelElement = ReactElement<SpicemodelProps>
+
 export interface ChipPropsSU<
   PinLabel extends SchematicPinLabel = SchematicPinLabel,
 > extends CommonComponentProps<PinLabel> {
@@ -67,6 +71,7 @@ export interface ChipPropsSU<
    */
   noConnect?: readonly PinLabel[] | PinLabel[]
   connections?: Connections<PinLabel>
+  spiceModel?: SpicemodelElement
 }
 
 export type ChipProps<PinLabelMap extends PinLabelsProp | string = string> =
@@ -130,6 +135,10 @@ const connectionsProp = z
   .custom<Connections>()
   .pipe(z.record(z.string(), connectionTarget))
 
+const spicemodelElement = z.custom<SpicemodelElement>(
+  (v) => !!v && typeof v === "object" && "type" in v && "props" in v,
+)
+
 export const pinLabelsProp = z.record(
   schematicPinLabel,
   schematicPinLabel
@@ -163,6 +172,7 @@ export const chipProps = commonComponentProps.extend({
   noSchematicRepresentation: z.boolean().optional(),
   noConnect: noConnectProp.optional(),
   connections: connectionsProp.optional(),
+  spiceModel: spicemodelElement.optional(),
 })
 
 /**

package/lib/components/drc-check.ts

@@ -0,0 +1,16 @@
+import { customDrcCheckFn, type CustomDrcCheckFn } from "lib/customDrc"
+import { expectTypesMatch } from "lib/typecheck"
+import { z } from "zod"
+
+export interface DrcCheckProps {
+  name?: string
+  checkFn: CustomDrcCheckFn
+}
+
+export const drcCheckProps = z.object({
+  name: z.string().optional(),
+  checkFn: customDrcCheckFn,
+})
+
+type InferredDrcCheckProps = z.input<typeof drcCheckProps>
+expectTypesMatch<DrcCheckProps, InferredDrcCheckProps>(true)

package/lib/components/spicemodel.ts

@@ -0,0 +1,15 @@
+import { expectTypesMatch } from "lib/typecheck"
+import { z } from "zod"
+
+export interface SpicemodelProps {
+  source: string
+  spicePinMapping?: Record<string, string>
+}
+
+export const spicemodelProps = z.object({
+  source: z.string(),
+  spicePinMapping: z.record(z.string(), z.string()).optional(),
+})
+
+type InferredSpicemodelProps = z.input<typeof spicemodelProps>
+expectTypesMatch<SpicemodelProps, InferredSpicemodelProps>(true)

package/lib/customDrc.ts

@@ -0,0 +1,78 @@
+import type {
+  AnyCircuitElement,
+  CircuitJsonError,
+  PcbComponent,
+  PcbPort,
+  SourceComponentBase,
+  SourceNet,
+  SourcePort,
+} from "circuit-json"
+import { z } from "zod"
+
+type MaybePromise<T> = T | Promise<T>
+type CircuitJsonWarning = Extract<AnyCircuitElement, { warning_type: string }>
+
+export type CustomDrcCheckInput =
+  | Partial<CircuitJsonError>
+  | Partial<CircuitJsonWarning>
+
+export interface SelectionResultComponent {
+  getPort: (name: string) => SelectionResultPort | null
+  getPorts: () => SelectionResultPort[]
+  getPcbComponent: () => PcbComponent | null
+  getSourceComponent: () => SourceComponentBase | null
+}
+
+export interface SelectionResultPort {
+  getPcbPort: () => PcbPort | null
+  getSourcePort: () => SourcePort | null
+}
+
+export interface SelectionResultNet {
+  getSourceNet: () => SourceNet | null
+}
+
+export type SelectionResult =
+  | SelectionResultComponent
+  | SelectionResultPort
+  | SelectionResultNet
+
+export type CustomDrcConnectable =
+  | string
+  | AnyCircuitElement
+  | SelectionResult
+  | null
+  | undefined
+
+export interface CustomDrcSelect {
+  (selector: `net.${string}`): SelectionResultNet | null
+  (selector: `${string}.${string}`): SelectionResultPort | null
+  (selector: string): SelectionResult | null
+}
+
+export interface CustomDrcSelectAll {
+  (selector: `chip${string}`): SelectionResultComponent[]
+  (selector: string): SelectionResult[]
+}
+
+export interface CustomDrcCheckContext {
+  select: CustomDrcSelect
+  selectAll: CustomDrcSelectAll
+  isConnected: (a: CustomDrcConnectable, b: CustomDrcConnectable) => boolean
+  isPulledUp: (a: CustomDrcConnectable) => boolean
+  isPulledDown: (a: CustomDrcConnectable) => boolean
+  getResistanceBetween: (
+    a: CustomDrcConnectable,
+    b: CustomDrcConnectable,
+  ) => number | null
+}
+
+export type CustomDrcCheckFn = (
+  ctx: CustomDrcCheckContext,
+) => MaybePromise<
+  CustomDrcCheckInput | CustomDrcCheckInput[] | null | undefined | void
+>
+
+export const customDrcCheckFn = z.custom<CustomDrcCheckFn>(
+  (value) => typeof value === "function",
+)

package/lib/index.ts

@@ -20,6 +20,7 @@ export * from "./common/schematicSize"
 export * from "./common/kicadFootprintMetadata"
 export * from "./common/kicadSymbolMetadata"
 export * from "./common/kicadPinMetadata"
+export * from "./customDrc"
 
 export * from "./components/board"
 export * from "./components/panel"
@@ -49,6 +50,7 @@ export * from "./components/fiducial"
 export * from "./components/constrainedlayout"
 export * from "./components/constraint"
 export * from "./components/cutout"
+export * from "./components/drc-check"
 export * from "./components/smtpad"
 export * from "./components/solderpaste"
 export * from "./components/hole"
@@ -64,6 +66,7 @@ export * from "./components/push-button"
 export * from "./components/subcircuit"
 export * from "./components/analogsimulation"
 export * from "./components/autoroutingphase"
+export * from "./components/spicemodel"
 export * from "./manual-edits"
 export * from "./components/transistor"
 export * from "./components/mosfet"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tscircuit/props",
-  "version": "0.0.537",
+  "version": "0.0.539",
   "description": "Props for tscircuit builtin component types",
   "main": "dist/index.js",
   "type": "module",
@@ -32,7 +32,7 @@
     "@types/node": "^20.12.11",
     "@types/react": "^18.3.2",
     "ava": "^6.1.3",
-    "circuit-json": "^0.0.425",
+    "circuit-json": "^0.0.428",
     "expect-type": "^1.3.0",
     "glob": "^11.0.0",
     "madge": "^8.0.0",