@tscircuit/core 0.0.182 → 0.0.183

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _tscircuit_props from '@tscircuit/props';
-import { subcircuitGroupProps, traceProps, SupplierPartNumbers, SchematicPortArrangement, groupProps, boardProps, capacitorProps, chipProps, diodeProps, jumperProps, ledProps, powerSourceProps, resistorProps, constraintProps, fabricationNotePathProps, fabricationNoteTextProps, footprintProps, holeProps, pcbKeepoutProps, netAliasProps, platedHoleProps, silkscreenCircleProps, silkscreenPathProps, silkscreenRectProps, silkscreenTextProps, smtPadProps, traceHintProps, viaProps, batteryProps, pinHeaderProps, inductorProps, potentiometerProps, CapacitorProps, ChipProps, ResistorProps } from '@tscircuit/props';
+import { subcircuitGroupProps, traceProps, SupplierPartNumbers, SchematicPortArrangement, groupProps, boardProps, capacitorProps, chipProps, diodeProps, jumperProps, ledProps, powerSourceProps, resistorProps, constraintProps, fabricationNotePathProps, fabricationNoteTextProps, footprintProps, subcircuitProps, holeProps, pcbKeepoutProps, netAliasProps, platedHoleProps, silkscreenCircleProps, silkscreenPathProps, silkscreenRectProps, silkscreenTextProps, smtPadProps, traceHintProps, viaProps, batteryProps, pinHeaderProps, inductorProps, potentiometerProps, CapacitorProps, ChipProps, ResistorProps } from '@tscircuit/props';
 import React, { ReactElement } from 'react';
 import * as zod from 'zod';
 import { z, ZodType } from 'zod';
@@ -291,7 +291,18 @@ declare abstract class PrimitiveComponent<ZodProps extends ZodType = any> extend
         schematicPrimitive?: boolean;
     }): T | null;
     getAvailablePcbLayers(): string[];
+    /**
+     * Returns all descendants
+     *
+     * NOTE: This crosses subcircuit boundaries, you may want to use
+     * getSelectableDescendants instead
+     */
     getDescendants(): PrimitiveComponent[];
+    /**
+     * Returns all descendants that are accessible without crossing a subcircuit
+     * boundary
+     */
+    getSelectableDescendants(): PrimitiveComponent[];
     /**
      * Return the number of pins in this component, this is important for
      * NormalComponents
@@ -876,7 +887,7 @@ declare class Board extends Group<typeof boardProps> {
     get isSubcircuit(): boolean;
     get config(): {
         componentName: string;
-        zodProps: z.ZodObject<z.objectUtil.extendShape<Omit<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+        zodProps: z.ZodObject<z.objectUtil.extendShape<z.objectUtil.extendShape<z.objectUtil.extendShape<{
             pcbX: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
             pcbY: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
             pcbRotation: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
@@ -897,7 +908,6 @@ declare class Board extends Group<typeof boardProps> {
             name: z.ZodOptional<z.ZodString>;
             children: z.ZodOptional<z.ZodAny>;
         }>, {
-            subcircuit: z.ZodLiteral<true>;
             layout: z.ZodOptional<z.ZodType<_tscircuit_layout.LayoutBuilder, z.ZodTypeDef, _tscircuit_layout.LayoutBuilder>>;
             manualEdits: z.ZodOptional<z.ZodType<_tscircuit_layout.ManualEditFile, z.ZodTypeDef, _tscircuit_layout.ManualEditFile>>;
             schAutoLayoutEnabled: z.ZodOptional<z.ZodBoolean>;
@@ -905,7 +915,7 @@ declare class Board extends Group<typeof boardProps> {
             defaultTraceWidth: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
             minTraceWidth: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
             partsEngine: z.ZodOptional<z.ZodType<_tscircuit_props.PartsEngine, z.ZodTypeDef, _tscircuit_props.PartsEngine>>;
-        }>, "subcircuit">, {
+        }>, {
             width: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
             height: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
             outline: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1683,44 +1693,44 @@ declare class Chip<PinLabels extends string = never> extends NormalComponent<typ
                 topPinCount: zod.ZodOptional<zod.ZodNumber>;
                 bottomPinCount: zod.ZodOptional<zod.ZodNumber>;
                 leftSide: zod.ZodOptional<zod.ZodObject<{
-                    pins: zod.ZodUnion<[zod.ZodArray<zod.ZodNumber, "many">, zod.ZodArray<zod.ZodString, "many">]>;
+                    pins: zod.ZodArray<zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>, "many">;
                     direction: zod.ZodUnion<[zod.ZodLiteral<"top-to-bottom">, zod.ZodLiteral<"left-to-right">, zod.ZodLiteral<"bottom-to-top">, zod.ZodLiteral<"right-to-left">]>;
                 }, "strip", zod.ZodTypeAny, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }>>;
                 rightSide: zod.ZodOptional<zod.ZodObject<{
-                    pins: zod.ZodUnion<[zod.ZodArray<zod.ZodNumber, "many">, zod.ZodArray<zod.ZodString, "many">]>;
+                    pins: zod.ZodArray<zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>, "many">;
                     direction: zod.ZodUnion<[zod.ZodLiteral<"top-to-bottom">, zod.ZodLiteral<"left-to-right">, zod.ZodLiteral<"bottom-to-top">, zod.ZodLiteral<"right-to-left">]>;
                 }, "strip", zod.ZodTypeAny, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }>>;
                 topSide: zod.ZodOptional<zod.ZodObject<{
-                    pins: zod.ZodUnion<[zod.ZodArray<zod.ZodNumber, "many">, zod.ZodArray<zod.ZodString, "many">]>;
+                    pins: zod.ZodArray<zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>, "many">;
                     direction: zod.ZodUnion<[zod.ZodLiteral<"top-to-bottom">, zod.ZodLiteral<"left-to-right">, zod.ZodLiteral<"bottom-to-top">, zod.ZodLiteral<"right-to-left">]>;
                 }, "strip", zod.ZodTypeAny, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }>>;
                 bottomSide: zod.ZodOptional<zod.ZodObject<{
-                    pins: zod.ZodUnion<[zod.ZodArray<zod.ZodNumber, "many">, zod.ZodArray<zod.ZodString, "many">]>;
+                    pins: zod.ZodArray<zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>, "many">;
                     direction: zod.ZodUnion<[zod.ZodLiteral<"top-to-bottom">, zod.ZodLiteral<"left-to-right">, zod.ZodLiteral<"bottom-to-top">, zod.ZodLiteral<"right-to-left">]>;
                 }, "strip", zod.ZodTypeAny, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }>>;
             }, "strip", zod.ZodTypeAny, {
                 leftSize?: number | undefined;
@@ -1729,19 +1739,19 @@ declare class Chip<PinLabels extends string = never> extends NormalComponent<typ
                 bottomSize?: number | undefined;
                 leftSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 topSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 rightSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 bottomSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 leftPinCount?: number | undefined;
                 rightPinCount?: number | undefined;
@@ -1754,19 +1764,19 @@ declare class Chip<PinLabels extends string = never> extends NormalComponent<typ
                 bottomSize?: number | undefined;
                 leftSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 topSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 rightSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 bottomSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 leftPinCount?: number | undefined;
                 rightPinCount?: number | undefined;
@@ -1868,19 +1878,19 @@ declare class Chip<PinLabels extends string = never> extends NormalComponent<typ
                 bottomSize?: number | undefined;
                 leftSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 topSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 rightSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 bottomSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 leftPinCount?: number | undefined;
                 rightPinCount?: number | undefined;
@@ -1974,19 +1984,19 @@ declare class Chip<PinLabels extends string = never> extends NormalComponent<typ
                 bottomSize?: number | undefined;
                 leftSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 topSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 rightSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 bottomSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 leftPinCount?: number | undefined;
                 rightPinCount?: number | undefined;
@@ -2677,7 +2687,7 @@ declare class Jumper<PinLabels extends string = never> extends NormalComponent<t
             symbolName: zod.ZodOptional<zod.ZodString>;
         }>, {
             manufacturerPartNumber: zod.ZodOptional<zod.ZodString>;
-            pinLabels: zod.ZodOptional<zod.ZodRecord<zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>, zod.ZodString>>;
+            pinLabels: zod.ZodOptional<zod.ZodRecord<zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>, zod.ZodUnion<[zod.ZodString, zod.ZodArray<zod.ZodString, "many">]>>>;
             schPinStyle: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodObject<{
                 leftMargin: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
                 rightMargin: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
@@ -2708,44 +2718,44 @@ declare class Jumper<PinLabels extends string = never> extends NormalComponent<t
                 topPinCount: zod.ZodOptional<zod.ZodNumber>;
                 bottomPinCount: zod.ZodOptional<zod.ZodNumber>;
                 leftSide: zod.ZodOptional<zod.ZodObject<{
-                    pins: zod.ZodUnion<[zod.ZodArray<zod.ZodNumber, "many">, zod.ZodArray<zod.ZodString, "many">]>;
+                    pins: zod.ZodArray<zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>, "many">;
                     direction: zod.ZodUnion<[zod.ZodLiteral<"top-to-bottom">, zod.ZodLiteral<"left-to-right">, zod.ZodLiteral<"bottom-to-top">, zod.ZodLiteral<"right-to-left">]>;
                 }, "strip", zod.ZodTypeAny, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }>>;
                 rightSide: zod.ZodOptional<zod.ZodObject<{
-                    pins: zod.ZodUnion<[zod.ZodArray<zod.ZodNumber, "many">, zod.ZodArray<zod.ZodString, "many">]>;
+                    pins: zod.ZodArray<zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>, "many">;
                     direction: zod.ZodUnion<[zod.ZodLiteral<"top-to-bottom">, zod.ZodLiteral<"left-to-right">, zod.ZodLiteral<"bottom-to-top">, zod.ZodLiteral<"right-to-left">]>;
                 }, "strip", zod.ZodTypeAny, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }>>;
                 topSide: zod.ZodOptional<zod.ZodObject<{
-                    pins: zod.ZodUnion<[zod.ZodArray<zod.ZodNumber, "many">, zod.ZodArray<zod.ZodString, "many">]>;
+                    pins: zod.ZodArray<zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>, "many">;
                     direction: zod.ZodUnion<[zod.ZodLiteral<"top-to-bottom">, zod.ZodLiteral<"left-to-right">, zod.ZodLiteral<"bottom-to-top">, zod.ZodLiteral<"right-to-left">]>;
                 }, "strip", zod.ZodTypeAny, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }>>;
                 bottomSide: zod.ZodOptional<zod.ZodObject<{
-                    pins: zod.ZodUnion<[zod.ZodArray<zod.ZodNumber, "many">, zod.ZodArray<zod.ZodString, "many">]>;
+                    pins: zod.ZodArray<zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>, "many">;
                     direction: zod.ZodUnion<[zod.ZodLiteral<"top-to-bottom">, zod.ZodLiteral<"left-to-right">, zod.ZodLiteral<"bottom-to-top">, zod.ZodLiteral<"right-to-left">]>;
                 }, "strip", zod.ZodTypeAny, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }, {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 }>>;
             }, "strip", zod.ZodTypeAny, {
                 leftSize?: number | undefined;
@@ -2754,19 +2764,19 @@ declare class Jumper<PinLabels extends string = never> extends NormalComponent<t
                 bottomSize?: number | undefined;
                 leftSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 topSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 rightSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 bottomSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 leftPinCount?: number | undefined;
                 rightPinCount?: number | undefined;
@@ -2779,19 +2789,19 @@ declare class Jumper<PinLabels extends string = never> extends NormalComponent<t
                 bottomSize?: number | undefined;
                 leftSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 topSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 rightSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 bottomSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 leftPinCount?: number | undefined;
                 rightPinCount?: number | undefined;
@@ -2866,7 +2876,7 @@ declare class Jumper<PinLabels extends string = never> extends NormalComponent<t
             children?: any;
             symbolName?: string | undefined;
             manufacturerPartNumber?: string | undefined;
-            pinLabels?: Record<string | number, string> | undefined;
+            pinLabels?: Record<string | number, string | string[]> | undefined;
             schPortArrangement?: {
                 leftSize?: number | undefined;
                 topSize?: number | undefined;
@@ -2874,19 +2884,19 @@ declare class Jumper<PinLabels extends string = never> extends NormalComponent<t
                 bottomSize?: number | undefined;
                 leftSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 topSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 rightSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 bottomSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 leftPinCount?: number | undefined;
                 rightPinCount?: number | undefined;
@@ -2973,7 +2983,7 @@ declare class Jumper<PinLabels extends string = never> extends NormalComponent<t
             children?: any;
             symbolName?: string | undefined;
             manufacturerPartNumber?: string | undefined;
-            pinLabels?: Record<string | number, string> | undefined;
+            pinLabels?: Record<string | number, string | string[]> | undefined;
             schPortArrangement?: {
                 leftSize?: number | undefined;
                 topSize?: number | undefined;
@@ -2981,19 +2991,19 @@ declare class Jumper<PinLabels extends string = never> extends NormalComponent<t
                 bottomSize?: number | undefined;
                 leftSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 topSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 rightSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 bottomSide?: {
                     direction: "top-to-bottom" | "left-to-right" | "bottom-to-top" | "right-to-left";
-                    pins: string[] | number[];
+                    pins: (string | number)[];
                 } | undefined;
                 leftPinCount?: number | undefined;
                 rightPinCount?: number | undefined;
@@ -4500,6 +4510,10 @@ declare class Footprint extends PrimitiveComponent<typeof footprintProps> {
     doInitialPcbFootprintLayout(): void;
 }
 
+declare class Subcircuit extends Group {
+    constructor(props: z.input<typeof subcircuitProps>);
+}
+
 declare class Hole extends PrimitiveComponent<typeof holeProps> {
     pcb_hole_id: string | null;
     isPcbPrimitive: boolean;
@@ -7455,9 +7469,10 @@ declare global {
             constrainedlayout: _tscircuit_props.ConstrainedLayoutProps;
             battery: _tscircuit_props.BatteryProps;
             pinheader: _tscircuit_props.PinHeaderProps;
+            subcircuit: _tscircuit_props.SubcircuitGroupProps;
             jscad: any;
         }
     }
 }
 
-export { Battery, Board, Capacitor, Chip, Circuit, type ComponentWithPins, Constraint, Diode, FabricationNotePath, FabricationNoteText, Footprint, Group, Hole, type IRenderable, Inductor, Jumper, Keepout, Led, Net, NetAlias, NormalComponent, PinHeader, type PinLabelSpec, PlatedHole, Port, Potentiometer, PowerSource, PrimitiveComponent, Project, Renderable, Resistor, SilkscreenCircle, SilkscreenPath, SilkscreenRect, SilkscreenText, SmtPad, Trace, TraceHint, Via, createUseComponent, useCapacitor, useChip, useDiode, useLed, useRenderedCircuit, useResistor };
+export { Battery, Board, Capacitor, Chip, Circuit, type ComponentWithPins, Constraint, Diode, FabricationNotePath, FabricationNoteText, Footprint, Group, Hole, type IRenderable, Inductor, Jumper, Keepout, Led, Net, NetAlias, NormalComponent, PinHeader, type PinLabelSpec, PlatedHole, Port, Potentiometer, PowerSource, PrimitiveComponent, Project, Renderable, Resistor, SilkscreenCircle, SilkscreenPath, SilkscreenRect, SilkscreenText, SmtPad, Subcircuit, Trace, TraceHint, Via, createUseComponent, useCapacitor, useChip, useDiode, useLed, useRenderedCircuit, useResistor };

package/dist/index.js

@@ -38,6 +38,7 @@ __export(components_exports, {
   SilkscreenRect: () => SilkscreenRect,
   SilkscreenText: () => SilkscreenText,
   SmtPad: () => SmtPad,
+  Subcircuit: () => Subcircuit,
   Trace: () => Trace,
   TraceHint: () => TraceHint,
   Via: () => Via
@@ -46,7 +47,7 @@ __export(components_exports, {
 // lib/components/base-components/NormalComponent.ts
 import { fp } from "@tscircuit/footprinter";
 import { point3, rotation } from "circuit-json";
-import Debug2 from "debug";
+import Debug3 from "debug";
 
 // lib/fiber/create-instance-from-react-element.ts
 import ReactReconciler from "react-reconciler";
@@ -472,6 +473,8 @@ import {
   translate
 } from "transformation-matrix";
 import { z as z2 } from "zod";
+import Debug from "debug";
+var debugSelectAll = Debug("tscircuit:primitive-component:selectAll");
 var PrimitiveComponent = class extends Renderable {
   parent = null;
   children;
@@ -826,20 +829,40 @@ var PrimitiveComponent = class extends Renderable {
     return group;
   }
   selectAll(selector) {
+    debugSelectAll(`selectAll: "${selector}"`);
     const parts = selector.trim().split(/\s+/);
-    let results = [this];
+    let currentSearch = parts[0] === ">" ? this.children : this.getSelectableDescendants();
+    let currentResults = [];
     let onlyDirectChildren = false;
+    let iteration = -1;
     for (const part of parts) {
+      iteration++;
+      debugSelectAll(`
+
+iteration: ${iteration}`);
+      debugSelectAll(`part: "${parts[iteration]}"`);
+      debugSelectAll(
+        `currentSearch: [${currentSearch.map((r) => r.getString()).join(",")}]`
+      );
+      debugSelectAll(
+        `currentResults: [${currentResults.map((r) => r.getString()).join(",")}]`
+      );
       if (part === ">") {
         onlyDirectChildren = true;
       } else {
-        results = results.flatMap((component) => {
-          return (onlyDirectChildren ? component.children : component.getDescendants()).filter((descendant) => isMatchingSelector(descendant, part));
+        const newResults = currentSearch.filter(
+          (component) => isMatchingSelector(component, part)
+        );
+        const newSearch = newResults.flatMap((component) => {
+          if (onlyDirectChildren) return component.children;
+          return component.getSelectableDescendants();
         });
+        currentSearch = newSearch;
+        currentResults = newResults;
         onlyDirectChildren = false;
       }
     }
-    return results.filter((component) => component !== this);
+    return currentResults;
   }
   selectOne(selector, options) {
     let type = options?.type?.toLowerCase();
@@ -874,6 +897,12 @@ var PrimitiveComponent = class extends Renderable {
     }
     return [];
   }
+  /**
+   * Returns all descendants
+   *
+   * NOTE: This crosses subcircuit boundaries, you may want to use
+   * getSelectableDescendants instead
+   */
   getDescendants() {
     const descendants = [];
     for (const child of this.children) {
@@ -882,6 +911,22 @@ var PrimitiveComponent = class extends Renderable {
     }
     return descendants;
   }
+  /**
+   * Returns all descendants that are accessible without crossing a subcircuit
+   * boundary
+   */
+  getSelectableDescendants() {
+    const descendants = [];
+    for (const child of this.children) {
+      if (child.isSubcircuit) {
+        descendants.push(child);
+      } else {
+        descendants.push(child);
+        descendants.push(...child.getSelectableDescendants());
+      }
+    }
+    return descendants;
+  }
   /**
    * Return the number of pins in this component, this is important for
    * NormalComponents
@@ -2255,8 +2300,8 @@ import { z as z5 } from "zod";
 // lib/components/primitive-components/Footprint.ts
 import { footprintProps } from "@tscircuit/props";
 import * as kiwi from "@lume/kiwi";
-import Debug from "debug";
-var debug = Debug("tscircuit:core:footprint");
+import Debug2 from "debug";
+var debug = Debug2("tscircuit:core:footprint");
 var Footprint = class extends PrimitiveComponent {
   get config() {
     return {
@@ -2462,7 +2507,7 @@ var Footprint = class extends PrimitiveComponent {
 };
 
 // lib/components/base-components/NormalComponent.ts
-var debug2 = Debug2("tscircuit:core");
+var debug2 = Debug3("tscircuit:core");
 var rotation3 = z5.object({
   x: rotation,
   y: rotation,
@@ -4804,6 +4849,17 @@ var FabricationNoteText = class extends PrimitiveComponent {
   }
 };
 
+// lib/components/primitive-components/Group/Subcircuit.ts
+import "@tscircuit/props";
+var Subcircuit = class extends Group {
+  constructor(props) {
+    super({
+      ...props,
+      subcircuit: true
+    });
+  }
+};
+
 // lib/components/primitive-components/NetAlias.ts
 import { netAliasProps } from "@tscircuit/props";
 var NetAlias = class extends PrimitiveComponent {
@@ -5264,9 +5320,11 @@ var Circuit = class {
     return identity5();
   }
   selectAll(selector) {
+    this._guessRootComponent();
     return this.firstChild?.selectAll(selector) ?? [];
   }
   selectOne(selector, opts) {
+    this._guessRootComponent();
     return this.firstChild?.selectOne(selector, opts) ?? null;
   }
   _eventListeners = { asyncEffectComplete: [] };
@@ -5432,6 +5490,7 @@ export {
   SilkscreenRect,
   SilkscreenText,
   SmtPad,
+  Subcircuit,
   Trace,
   TraceHint,
   Via,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tscircuit/core",
   "type": "module",
-  "version": "0.0.182",
+  "version": "0.0.183",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -40,7 +40,7 @@
     "@tscircuit/footprinter": "^0.0.77",
     "@tscircuit/infgrid-ijump-astar": "^0.0.24",
     "@tscircuit/math-utils": "^0.0.5",
-    "@tscircuit/props": "^0.0.95",
+    "@tscircuit/props": "^0.0.98",
     "@tscircuit/schematic-autolayout": "^0.0.6",
     "@tscircuit/soup-util": "^0.0.40",
     "circuit-json": "^0.0.104",