@tscircuit/core 0.0.1364 → 0.0.1366

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as circuit_json from 'circuit-json';
 import { PcbTraceError, PcbPlacementError, PcbManualEditConflictWarning, PcbViaClearanceError, LayerRef, AnyCircuitElement, Size, PcbTrace as PcbTrace$1, PcbVia as PcbVia$1, PcbTraceRoutePoint, AnySourceComponent, PcbComponent, SchematicPort, SchematicComponent, PcbSilkscreenGraphic, RouteHintPoint, CircuitJson } from 'circuit-json';
 import * as _tscircuit_props from '@tscircuit/props';
-import { PlatformConfig, traceProps, netProps, AutorouterProp, AutoroutingPhaseProps, subcircuitGroupProps, AutorouterConfig, PcbSx, portProps, SupplierPartNumbers, CadModelProp, SchematicPortArrangement, groupProps, boardProps, subcircuitProps, subpanelProps, capacitorProps, chipProps, pinoutProps, diodeProps, fuseProps, jumperProps, interconnectProps, solderjumperProps, ledProps, powerSourceProps, voltageSourceProps, currentSourceProps, ammeterProps, resistorProps, constraintProps, drcCheckProps, autoroutingPhaseProps, fabricationNoteRectProps, fabricationNotePathProps, fabricationNoteTextProps, fabricationNoteDimensionProps, pcbNoteLineProps, pcbNoteRectProps, pcbNoteTextProps, pcbNotePathProps, pcbNoteDimensionProps, footprintProps, breakoutProps, breakoutPointProps, holeProps, pcbKeepoutProps, netLabelProps, cadmodelProps, cadassemblyProps, platedHoleProps, courtyardCircleProps, courtyardOutlineProps, courtyardRectProps, silkscreenCircleProps, silkscreenPathProps, silkscreenRectProps, silkscreenTextProps, silkscreenLineProps, silkscreenGraphicProps, smtPadProps, fiducialProps, traceHintProps, viaProps, copperPourProps, copperTextProps, cutoutProps, batteryProps, pinHeaderProps, resonatorProps, inductorProps, potentiometerProps, pushButtonProps, crystalProps, transistorProps, mosfetProps, opampProps, OpAmpPinLabels, switchProps, SwitchProps, testpointProps, schematicTextProps, schematicLineProps, schematicRectProps, schematicArcProps, schematicCircleProps, schematicPathProps, schematicBoxProps, schematicSectionProps, schematicTableProps, schematicRowProps, schematicCellProps, symbolProps, analogSimulationProps, voltageProbeProps, spicemodelProps, CapacitorProps, ChipProps, DiodeProps, ResistorProps, ManualEditEvent, ManualEditsFile, ChipConnections, manual_edits_file } from '@tscircuit/props';
+import { PlatformConfig, traceProps, netProps, AutorouterProp, AutoroutingPhaseProps, subcircuitGroupProps, AutorouterConfig, PcbSx, portProps, SupplierPartNumbers, CadModelProp, SchematicPortArrangement, groupProps, boardProps, subcircuitProps, subpanelProps, capacitorProps, chipProps, pinoutProps, diodeProps, fuseProps, jumperProps, interconnectProps, solderjumperProps, ledProps, powerSourceProps, voltageSourceProps, currentSourceProps, ammeterProps, resistorProps, constraintProps, drcCheckProps, autoroutingPhaseProps, fabricationNoteRectProps, fabricationNotePathProps, fabricationNoteTextProps, fabricationNoteDimensionProps, pcbNoteLineProps, pcbNoteRectProps, pcbNoteTextProps, pcbNotePathProps, pcbNoteDimensionProps, footprintProps, breakoutProps, breakoutPointProps, holeProps, pcbKeepoutProps, netLabelProps, cadmodelProps, cadassemblyProps, platedHoleProps, courtyardCircleProps, courtyardOutlineProps, courtyardRectProps, silkscreenCircleProps, silkscreenPathProps, silkscreenRectProps, silkscreenTextProps, silkscreenLineProps, silkscreenGraphicProps, smtPadProps, fiducialProps, traceHintProps, viaProps, copperPourProps, copperTextProps, cutoutProps, batteryProps, pinHeaderProps, resonatorProps, inductorProps, potentiometerProps, pushButtonProps, crystalProps, transistorProps, mosfetProps, opampProps, OpAmpPinLabels, switchProps, SwitchProps, testpointProps, schematicTextProps, schematicLineProps, schematicRectProps, schematicArcProps, schematicCircleProps, schematicPathProps, schematicBoxProps, schematicSectionProps, schematicSheetProps, schematicTableProps, schematicRowProps, schematicCellProps, symbolProps, analogSimulationProps, voltageProbeProps, spicemodelProps, CapacitorProps, ChipProps, DiodeProps, ResistorProps, ManualEditEvent, ManualEditsFile, ChipConnections, manual_edits_file } from '@tscircuit/props';
 export { kicadFootprintStrings } from '@tscircuit/props';
 import * as react from 'react';
 import react__default, { ReactElement } from 'react';
@@ -238,9 +238,9 @@ interface IIsolatedCircuit {
 interface IRootCircuit extends IIsolatedCircuit {
 }
 
-declare const orderedRenderPhases: readonly ["ReactSubtreesRender", "RenderIsolatedSubcircuits", "InflateSubcircuitCircuitJson", "SourceNameDuplicateComponentRemoval", "PcbFootprintStringRender", "FetchPartFootprint", "InitializePortsFromChildren", "CreateNetsFromProps", "AssignFallbackProps", "CreateTracesFromProps", "CreateTracesFromNetLabels", "CreateTraceHintsFromProps", "CreateAutoplacedBreakoutPoints", "SourceGroupRender", "AssignNameToUnnamedComponents", "SourceRender", "SourceComponentPropertyValidation", "SourceParentAttachment", "PortMatching", "OptimizeSelectorCache", "SourceTraceRender", "SourceAddConnectivityMapKey", "SourceDesignRuleChecks", "SimulationRender", "SchematicComponentRender", "SchematicPortRender", "SymbolContainerRender", "SchematicPrimitiveRender", "SchematicSymbolResize", "SchematicComponentSizeCalculation", "SchematicLayout", "SchematicSectionRender", "SchematicTraceRender", "SchematicReplaceNetLabelsWithSymbols", "PanelBoardLayout", "ValidatePcbCoordinates", "PcbComponentRender", "PcbPrimitiveRender", "PcbFootprintLayout", "PcbPortRender", "PcbPortAttachment", "PcbComponentSizeCalculation", "PcbComponentAnchorAlignment", "PcbCalcPlacementResolution", "PcbLayout", "PcbBoardAutoSize", "PanelLayout", "PcbAutoplaceBreakoutPoints", "PcbTraceHintRender", "PcbManualTraceRender", "PcbTraceRender", "PcbRouteNetIslands", "PcbCopperPourRender", "PcbDesignRuleChecks", "SilkscreenOverlapAdjustment", "CadModelRender", "PartsEngineRender", "SupplierFootprintMismatchWarning", "SimulationSpiceEngineRender"];
+declare const orderedRenderPhases: readonly ["ReactSubtreesRender", "RenderIsolatedSubcircuits", "InflateSubcircuitCircuitJson", "SourceNameDuplicateComponentRemoval", "PcbFootprintStringRender", "FetchPartFootprint", "InitializePortsFromChildren", "CreateNetsFromProps", "AssignFallbackProps", "CreateTracesFromProps", "CreateTracesFromNetLabels", "CreateTraceHintsFromProps", "CreateAutoplacedBreakoutPoints", "SourceGroupRender", "AssignNameToUnnamedComponents", "SourceRender", "SourceComponentPropertyValidation", "SourceParentAttachment", "PortMatching", "OptimizeSelectorCache", "SourceTraceRender", "SourceAddConnectivityMapKey", "SourceDesignRuleChecks", "SimulationRender", "SchematicComponentRender", "SchematicPortRender", "SymbolContainerRender", "SchematicPrimitiveRender", "SchematicSymbolResize", "SchematicComponentSizeCalculation", "SchematicLayout", "SchematicSectionRender", "SchematicTraceRender", "SchematicSheetRender", "SchematicReplaceNetLabelsWithSymbols", "PanelBoardLayout", "ValidatePcbCoordinates", "PcbComponentRender", "PcbPrimitiveRender", "PcbFootprintLayout", "PcbPortRender", "PcbPortAttachment", "PcbComponentSizeCalculation", "PcbComponentAnchorAlignment", "PcbCalcPlacementResolution", "PcbLayout", "PcbBoardAutoSize", "PanelLayout", "PcbAutoplaceBreakoutPoints", "PcbTraceHintRender", "PcbManualTraceRender", "PcbTraceRender", "PcbRouteNetIslands", "PcbCopperPourRender", "PcbDesignRuleChecks", "SilkscreenOverlapAdjustment", "CadModelRender", "PartsEngineRender", "SupplierFootprintMismatchWarning", "SimulationSpiceEngineRender"];
 type RenderPhase = (typeof orderedRenderPhases)[number];
-declare const renderPhaseIndexMap: Map<"ReactSubtreesRender" | "RenderIsolatedSubcircuits" | "InflateSubcircuitCircuitJson" | "SourceNameDuplicateComponentRemoval" | "PcbFootprintStringRender" | "FetchPartFootprint" | "InitializePortsFromChildren" | "CreateNetsFromProps" | "AssignFallbackProps" | "CreateTracesFromProps" | "CreateTracesFromNetLabels" | "CreateTraceHintsFromProps" | "CreateAutoplacedBreakoutPoints" | "SourceGroupRender" | "AssignNameToUnnamedComponents" | "SourceRender" | "SourceComponentPropertyValidation" | "SourceParentAttachment" | "PortMatching" | "OptimizeSelectorCache" | "SourceTraceRender" | "SourceAddConnectivityMapKey" | "SourceDesignRuleChecks" | "SimulationRender" | "SchematicComponentRender" | "SchematicPortRender" | "SymbolContainerRender" | "SchematicPrimitiveRender" | "SchematicSymbolResize" | "SchematicComponentSizeCalculation" | "SchematicLayout" | "SchematicSectionRender" | "SchematicTraceRender" | "SchematicReplaceNetLabelsWithSymbols" | "PanelBoardLayout" | "ValidatePcbCoordinates" | "PcbComponentRender" | "PcbPrimitiveRender" | "PcbFootprintLayout" | "PcbPortRender" | "PcbPortAttachment" | "PcbComponentSizeCalculation" | "PcbComponentAnchorAlignment" | "PcbCalcPlacementResolution" | "PcbLayout" | "PcbBoardAutoSize" | "PanelLayout" | "PcbAutoplaceBreakoutPoints" | "PcbTraceHintRender" | "PcbManualTraceRender" | "PcbTraceRender" | "PcbRouteNetIslands" | "PcbCopperPourRender" | "PcbDesignRuleChecks" | "SilkscreenOverlapAdjustment" | "CadModelRender" | "PartsEngineRender" | "SupplierFootprintMismatchWarning" | "SimulationSpiceEngineRender", number>;
+declare const renderPhaseIndexMap: Map<"ReactSubtreesRender" | "RenderIsolatedSubcircuits" | "InflateSubcircuitCircuitJson" | "SourceNameDuplicateComponentRemoval" | "PcbFootprintStringRender" | "FetchPartFootprint" | "InitializePortsFromChildren" | "CreateNetsFromProps" | "AssignFallbackProps" | "CreateTracesFromProps" | "CreateTracesFromNetLabels" | "CreateTraceHintsFromProps" | "CreateAutoplacedBreakoutPoints" | "SourceGroupRender" | "AssignNameToUnnamedComponents" | "SourceRender" | "SourceComponentPropertyValidation" | "SourceParentAttachment" | "PortMatching" | "OptimizeSelectorCache" | "SourceTraceRender" | "SourceAddConnectivityMapKey" | "SourceDesignRuleChecks" | "SimulationRender" | "SchematicComponentRender" | "SchematicPortRender" | "SymbolContainerRender" | "SchematicPrimitiveRender" | "SchematicSymbolResize" | "SchematicComponentSizeCalculation" | "SchematicLayout" | "SchematicSectionRender" | "SchematicTraceRender" | "SchematicSheetRender" | "SchematicReplaceNetLabelsWithSymbols" | "PanelBoardLayout" | "ValidatePcbCoordinates" | "PcbComponentRender" | "PcbPrimitiveRender" | "PcbFootprintLayout" | "PcbPortRender" | "PcbPortAttachment" | "PcbComponentSizeCalculation" | "PcbComponentAnchorAlignment" | "PcbCalcPlacementResolution" | "PcbLayout" | "PcbBoardAutoSize" | "PanelLayout" | "PcbAutoplaceBreakoutPoints" | "PcbTraceHintRender" | "PcbManualTraceRender" | "PcbTraceRender" | "PcbRouteNetIslands" | "PcbCopperPourRender" | "PcbDesignRuleChecks" | "SilkscreenOverlapAdjustment" | "CadModelRender" | "PartsEngineRender" | "SupplierFootprintMismatchWarning" | "SimulationSpiceEngineRender", number>;
 type RenderPhaseFn<K extends RenderPhase = RenderPhase> = `doInitial${K}` | `update${K}` | `remove${K}`;
 type RenderPhaseStates = Record<RenderPhase, {
     initialized: boolean;
@@ -1548,6 +1548,7 @@ declare abstract class PrimitiveComponent<ZodProps extends ZodType = any> extend
     source_group_id: string | null;
     source_component_id: string | null;
     schematic_component_id: string | null;
+    schematic_sheet_id?: string | null;
     pcb_component_id: string | null;
     cad_component_id: string | null;
     _reportedInvalidPcbCalcWarnings: Set<string>;
@@ -1732,6 +1733,7 @@ declare abstract class PrimitiveComponent<ZodProps extends ZodType = any> extend
     doesSelectorMatch(selector: string): boolean;
     getSubcircuit(): ISubcircuit;
     getGroup(): IGroup | null;
+    _resolveSchematicSheetId(): string | undefined;
     doInitialAssignNameToUnnamedComponents(): void;
     doInitialOptimizeSelectorCache(): void;
     /**
@@ -2167,7 +2169,7 @@ declare class NormalComponent<ZodProps extends z.ZodType = any, PortNames extend
     _hasStartedFootprintUrlLoad: boolean;
     _hasStartedSupplierFootprintMismatchWarningCheck: boolean;
     private _invalidFootprintPropMessages;
-    private _invalidPinLabelMessages;
+    _invalidPinLabelMessages: string[];
     /**
      * Set to true to enable automatic silkscreen text adjustment when it overlaps with other components
      */
@@ -2901,6 +2903,7 @@ declare class Board extends Group<typeof boardProps> implements BoardI, Subcircu
             name: zod.ZodOptional<zod.ZodString>;
             children: zod.ZodOptional<zod.ZodAny>;
             schTitle: zod.ZodOptional<zod.ZodString>;
+            schSheetName: zod.ZodOptional<zod.ZodString>;
             key: zod.ZodOptional<zod.ZodAny>;
             showAsSchematicBox: zod.ZodOptional<zod.ZodBoolean>;
             connections: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodOptional<zod.ZodUnion<[zod.ZodUnion<[zod.ZodString, zod.ZodReadonly<zod.ZodArray<zod.ZodString, "many">>]>, zod.ZodArray<zod.ZodString, "many">]>>>>;
@@ -3348,6 +3351,7 @@ declare class Board extends Group<typeof boardProps> implements BoardI, Subcircu
             } | undefined;
             schRelative?: boolean | undefined;
             children?: any;
+            schSheetName?: string | undefined;
             grid?: boolean | undefined;
             flex?: string | boolean | undefined;
             layoutMode?: "none" | "relative" | "grid" | "flex" | "match-adapt" | undefined;
@@ -3683,6 +3687,7 @@ declare class Board extends Group<typeof boardProps> implements BoardI, Subcircu
             } | undefined;
             schRelative?: boolean | undefined;
             children?: any;
+            schSheetName?: string | undefined;
             grid?: boolean | undefined;
             flex?: string | boolean | undefined;
             layoutMode?: "none" | "relative" | "grid" | "flex" | "match-adapt" | undefined;
@@ -4444,6 +4449,7 @@ declare class MountedBoard extends Subcircuit implements BoardI {
             name: zod.ZodOptional<zod.ZodString>;
             children: zod.ZodOptional<zod.ZodAny>;
             schTitle: zod.ZodOptional<zod.ZodString>;
+            schSheetName: zod.ZodOptional<zod.ZodString>;
             key: zod.ZodOptional<zod.ZodAny>;
             showAsSchematicBox: zod.ZodOptional<zod.ZodBoolean>;
             connections: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodOptional<zod.ZodUnion<[zod.ZodUnion<[zod.ZodString, zod.ZodReadonly<zod.ZodArray<zod.ZodString, "many">>]>, zod.ZodArray<zod.ZodString, "many">]>>>>;
@@ -5006,6 +5012,7 @@ declare class MountedBoard extends Subcircuit implements BoardI {
             schRelative?: boolean | undefined;
             children?: any;
             manufacturerPartNumber?: string | undefined;
+            schSheetName?: string | undefined;
             grid?: boolean | undefined;
             flex?: string | boolean | undefined;
             layoutMode?: "none" | "relative" | "grid" | "flex" | "match-adapt" | undefined;
@@ -5364,6 +5371,7 @@ declare class MountedBoard extends Subcircuit implements BoardI {
             schRelative?: boolean | undefined;
             children?: any;
             manufacturerPartNumber?: string | undefined;
+            schSheetName?: string | undefined;
             grid?: boolean | undefined;
             flex?: string | boolean | undefined;
             layoutMode?: "none" | "relative" | "grid" | "flex" | "match-adapt" | undefined;
@@ -6100,6 +6108,7 @@ declare class Subpanel extends Group<typeof subpanelProps> {
             name: zod.ZodOptional<zod.ZodString>;
             children: zod.ZodOptional<zod.ZodAny>;
             schTitle: zod.ZodOptional<zod.ZodString>;
+            schSheetName: zod.ZodOptional<zod.ZodString>;
             key: zod.ZodOptional<zod.ZodAny>;
             showAsSchematicBox: zod.ZodOptional<zod.ZodBoolean>;
             connections: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodOptional<zod.ZodUnion<[zod.ZodUnion<[zod.ZodString, zod.ZodReadonly<zod.ZodArray<zod.ZodString, "many">>]>, zod.ZodArray<zod.ZodString, "many">]>>>>;
@@ -6330,6 +6339,7 @@ declare class Subpanel extends Group<typeof subpanelProps> {
             } | undefined;
             schRelative?: boolean | undefined;
             children?: any;
+            schSheetName?: string | undefined;
             grid?: boolean | undefined;
             flex?: string | boolean | undefined;
             layoutMode?: "none" | "grid" | "pack" | undefined;
@@ -6606,6 +6616,7 @@ declare class Subpanel extends Group<typeof subpanelProps> {
             } | undefined;
             schRelative?: boolean | undefined;
             children?: any;
+            schSheetName?: string | undefined;
             grid?: boolean | undefined;
             flex?: string | boolean | undefined;
             layoutMode?: "none" | "grid" | "pack" | undefined;
@@ -7301,6 +7312,7 @@ declare class Panel extends Subpanel {
             name: zod.ZodOptional<zod.ZodString>;
             children: zod.ZodOptional<zod.ZodAny>;
             schTitle: zod.ZodOptional<zod.ZodString>;
+            schSheetName: zod.ZodOptional<zod.ZodString>;
             key: zod.ZodOptional<zod.ZodAny>;
             showAsSchematicBox: zod.ZodOptional<zod.ZodBoolean>;
             connections: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodOptional<zod.ZodUnion<[zod.ZodUnion<[zod.ZodString, zod.ZodReadonly<zod.ZodArray<zod.ZodString, "many">>]>, zod.ZodArray<zod.ZodString, "many">]>>>>;
@@ -7531,6 +7543,7 @@ declare class Panel extends Subpanel {
             } | undefined;
             schRelative?: boolean | undefined;
             children?: any;
+            schSheetName?: string | undefined;
             grid?: boolean | undefined;
             flex?: string | boolean | undefined;
             layoutMode?: "none" | "grid" | "pack" | undefined;
@@ -7807,6 +7820,7 @@ declare class Panel extends Subpanel {
             } | undefined;
             schRelative?: boolean | undefined;
             children?: any;
+            schSheetName?: string | undefined;
             grid?: boolean | undefined;
             flex?: string | boolean | undefined;
             layoutMode?: "none" | "grid" | "pack" | undefined;
@@ -152797,6 +152811,31 @@ declare class SchematicSection extends PrimitiveComponent<typeof schematicSectio
     doInitialSchematicSectionRender(): void;
 }
 
+declare class SchematicSheet extends PrimitiveComponent<typeof schematicSheetProps> {
+    isSchematicPrimitive: boolean;
+    get config(): {
+        componentName: string;
+        zodProps: zod.ZodObject<{
+            name: zod.ZodString;
+            displayName: zod.ZodString;
+            sheetIndex: zod.ZodOptional<zod.ZodNumber>;
+            children: zod.ZodOptional<zod.ZodAny>;
+        }, "strip", zod.ZodTypeAny, {
+            name: string;
+            displayName: string;
+            children?: any;
+            sheetIndex?: number | undefined;
+        }, {
+            name: string;
+            displayName: string;
+            children?: any;
+            sheetIndex?: number | undefined;
+        }>;
+    };
+    doInitialSourceGroupRender(): void;
+    doInitialSchematicSheetRender(): void;
+}
+
 declare class SchematicTable extends PrimitiveComponent<typeof schematicTableProps> {
     isSchematicPrimitive: boolean;
     schematic_table_id: string | null;
@@ -158980,6 +159019,7 @@ interface TscircuitElements {
     pinout: _tscircuit_props.PinoutProps;
     powersource: _tscircuit_props.PowerSourceProps;
     schematicsection: _tscircuit_props.SchematicSectionProps;
+    schematicsheet: _tscircuit_props.SchematicSheetProps;
     via: _tscircuit_props.ViaProps;
     schematicbox: _tscircuit_props.SchematicBoxProps;
     schematicline: _tscircuit_props.SchematicLineProps;
@@ -159075,4 +159115,4 @@ declare module "react/jsx-runtime" {
     }
 }
 
-export { Ammeter, AnalogSimulation, type AsyncEffect, type AutorouterCompleteEvent, type AutorouterErrorEvent, type AutorouterEvent, type AutorouterProgressEvent, type AutoroutingEndEvent, type AutoroutingErrorEvent, AutoroutingPhase, type AutoroutingProgressEvent, type AutoroutingStartEvent, Battery, Board, Breakout, BreakoutPoint, CadAssembly, CadModel, Capacitor, Chip, Circuit, type ComponentWithPins, Connector, Constraint, CopperPour, CopperText, CourtyardCircle, CourtyardOutline, CourtyardRect, Crystal, CurrentSource, Cutout, type DebugLogOutputEvent, Diode, DrcCheck, FabricationNoteDimension, FabricationNotePath, FabricationNoteRect, FabricationNoteText, Breakout as Fanout, BreakoutPoint as FanoutPoint, Fiducial, Footprint, Fuse, type GenericConnectionsAndSelectorsSel, type GenericLocalAutorouter, Group, Hole, type IIsolatedCircuit, type IRenderable, type IRootCircuit, Inductor, Interconnect, IsolatedCircuit, Jumper, Keepout, Led, type LocalCacheEngine, Mosfet, MountedBoard, Net, NetLabel, NormalComponent, type Obstacle, OpAmp, type PackingEndEvent, type PackingErrorEvent, type PackingStartEvent, Panel, PcbNoteDimension, PcbNoteLine, PcbNotePath, PcbNoteRect, PcbNoteText, PcbTrace, PcbVia, PinHeader, type PinLabelSpec, Pinout, PlatedHole, Port, Potentiometer, PowerSource, PrimitiveComponent, Project, PushButton, type RenderPhase, type RenderPhaseFn, type RenderPhaseFunctions, type RenderPhaseStates, Renderable, Resistor, Resonator, RootCircuit, type RootCircuitEventName, SOLVERS, SchematicArc, SchematicBox, SchematicCell, SchematicCircle, SchematicLine, SchematicPath, SchematicRect, SchematicRow, SchematicSection, SchematicTable, SchematicText, type Sel, SilkscreenCircle, SilkscreenGraphic, SilkscreenLine, SilkscreenPath, SilkscreenRect, SilkscreenText, type SimpleRouteConnection, type SimpleRouteJson, type SimplifiedPcbTrace, SmtPad, SolderJumper, type SolverName, type SolverStartedEvent, SpiceModel, Subcircuit, Subpanel, Switch, SymbolComponent as Symbol, TestPoint, Trace, TraceHint, Transistor, Via, VoltageProbe, VoltageSource, applyEditEvents, applyEditEventsToManualEditsFile, applyPcbEditEventsToManualEditsFile, applySchematicEditEventsToManualEditsFile, createUseComponent, getPhaseTimingsFromRenderEvents, getSimpleRouteJsonFromCircuitJson, normalizePinLabels, orderedRenderPhases, renderPhaseIndexMap, resolveStaticFileImport, sel, unrouteCircuitJson, useCapacitor, useChip, useDiode, useLed, useRenderedCircuit, useResistor };
+export { Ammeter, AnalogSimulation, type AsyncEffect, type AutorouterCompleteEvent, type AutorouterErrorEvent, type AutorouterEvent, type AutorouterProgressEvent, type AutoroutingEndEvent, type AutoroutingErrorEvent, AutoroutingPhase, type AutoroutingProgressEvent, type AutoroutingStartEvent, Battery, Board, Breakout, BreakoutPoint, CadAssembly, CadModel, Capacitor, Chip, Circuit, type ComponentWithPins, Connector, Constraint, CopperPour, CopperText, CourtyardCircle, CourtyardOutline, CourtyardRect, Crystal, CurrentSource, Cutout, type DebugLogOutputEvent, Diode, DrcCheck, FabricationNoteDimension, FabricationNotePath, FabricationNoteRect, FabricationNoteText, Breakout as Fanout, BreakoutPoint as FanoutPoint, Fiducial, Footprint, Fuse, type GenericConnectionsAndSelectorsSel, type GenericLocalAutorouter, Group, Hole, type IIsolatedCircuit, type IRenderable, type IRootCircuit, Inductor, Interconnect, IsolatedCircuit, Jumper, Keepout, Led, type LocalCacheEngine, Mosfet, MountedBoard, Net, NetLabel, NormalComponent, type Obstacle, OpAmp, type PackingEndEvent, type PackingErrorEvent, type PackingStartEvent, Panel, PcbNoteDimension, PcbNoteLine, PcbNotePath, PcbNoteRect, PcbNoteText, PcbTrace, PcbVia, PinHeader, type PinLabelSpec, Pinout, PlatedHole, Port, Potentiometer, PowerSource, PrimitiveComponent, Project, PushButton, type RenderPhase, type RenderPhaseFn, type RenderPhaseFunctions, type RenderPhaseStates, Renderable, Resistor, Resonator, RootCircuit, type RootCircuitEventName, SOLVERS, SchematicArc, SchematicBox, SchematicCell, SchematicCircle, SchematicLine, SchematicPath, SchematicRect, SchematicRow, SchematicSection, SchematicSheet, SchematicTable, SchematicText, type Sel, SilkscreenCircle, SilkscreenGraphic, SilkscreenLine, SilkscreenPath, SilkscreenRect, SilkscreenText, type SimpleRouteConnection, type SimpleRouteJson, type SimplifiedPcbTrace, SmtPad, SolderJumper, type SolverName, type SolverStartedEvent, SpiceModel, Subcircuit, Subpanel, Switch, SymbolComponent as Symbol, TestPoint, Trace, TraceHint, Transistor, Via, VoltageProbe, VoltageSource, applyEditEvents, applyEditEventsToManualEditsFile, applyPcbEditEventsToManualEditsFile, applySchematicEditEventsToManualEditsFile, createUseComponent, getPhaseTimingsFromRenderEvents, getSimpleRouteJsonFromCircuitJson, normalizePinLabels, orderedRenderPhases, renderPhaseIndexMap, resolveStaticFileImport, sel, unrouteCircuitJson, useCapacitor, useChip, useDiode, useLed, useRenderedCircuit, useResistor };

package/dist/index.js

@@ -80,6 +80,7 @@ __export(components_exports, {
   SchematicRect: () => SchematicRect,
   SchematicRow: () => SchematicRow,
   SchematicSection: () => SchematicSection,
+  SchematicSheet: () => SchematicSheet,
   SchematicTable: () => SchematicTable,
   SchematicText: () => SchematicText,
   SilkscreenCircle: () => SilkscreenCircle,
@@ -113,7 +114,6 @@ import {
   pcb_manual_edit_conflict_warning,
   point3 as point32,
   rotation as rotation2,
-  schematic_manual_edit_conflict_warning,
   unknown_error_finding_part as unknown_error_finding_part2
 } from "circuit-json";
 import Debug5 from "debug";
@@ -353,6 +353,7 @@ var orderedRenderPhases = [
   "SchematicLayout",
   "SchematicSectionRender",
   "SchematicTraceRender",
+  "SchematicSheetRender",
   "SchematicReplaceNetLabelsWithSymbols",
   "PanelBoardLayout",
   "ValidatePcbCoordinates",
@@ -397,6 +398,7 @@ var asyncPhaseDependencies = {
   SchematicLayout: ["PcbFootprintStringRender", "FetchPartFootprint"],
   SchematicSectionRender: ["PcbFootprintStringRender", "FetchPartFootprint"],
   SchematicTraceRender: ["PcbFootprintStringRender", "FetchPartFootprint"],
+  SchematicSheetRender: ["PcbFootprintStringRender", "FetchPartFootprint"],
   SchematicReplaceNetLabelsWithSymbols: [
     "PcbFootprintStringRender",
     "FetchPartFootprint"
@@ -1319,6 +1321,7 @@ var PrimitiveComponent2 = class extends Renderable {
   source_group_id = null;
   source_component_id = null;
   schematic_component_id = null;
+  schematic_sheet_id = null;
   pcb_component_id = null;
   cad_component_id = null;
   _reportedInvalidPcbCalcWarnings = /* @__PURE__ */ new Set();
@@ -2000,6 +2003,15 @@ var PrimitiveComponent2 = class extends Renderable {
     if (this.isGroup) return this;
     return this.parent?.getGroup?.() ?? null;
   }
+  _resolveSchematicSheetId() {
+    const schSheetName = this._parsedProps?.schSheetName ?? this.props.schSheetName;
+    if (schSheetName) {
+      const matchingSheet = this.root?.db.schematic_sheet.list().find((sheet) => sheet.name === schSheetName);
+      if (matchingSheet) return matchingSheet.schematic_sheet_id;
+    }
+    if (this.schematic_sheet_id) return this.schematic_sheet_id;
+    return this.parent?._resolveSchematicSheetId?.();
+  }
   doInitialAssignNameToUnnamedComponents() {
     if (!this._parsedProps.name) {
       this.fallbackUnassignedName = this.getSubcircuit().getNextAvailableName(this);
@@ -3808,7 +3820,8 @@ var Trace_doInitialSchematicTraceRender = (trace) => {
         source_trace_id: trace.source_trace_id,
         edges: edges2,
         junctions: junctions2,
-        subcircuit_connectivity_map_key: trace.subcircuit_connectivity_map_key ?? void 0
+        subcircuit_connectivity_map_key: trace.subcircuit_connectivity_map_key ?? void 0,
+        schematic_sheet_id: trace._resolveSchematicSheetId()
       });
       trace.schematic_trace_id = dbTrace2.schematic_trace_id;
       return;
@@ -3824,7 +3837,8 @@ var Trace_doInitialSchematicTraceRender = (trace) => {
           anchor_side: side2,
           text: schematicNetLabelText
         }),
-        anchor_side: side2
+        anchor_side: side2,
+        schematic_sheet_id: trace._resolveSchematicSheetId()
       });
       return;
     }
@@ -3838,7 +3852,8 @@ var Trace_doInitialSchematicTraceRender = (trace) => {
         anchor_side: side,
         text: net._parsedProps.name
       }),
-      anchor_side: side
+      anchor_side: side,
+      schematic_sheet_id: trace._resolveSchematicSheetId()
     });
     return;
   }
@@ -4042,7 +4057,8 @@ var Trace_doInitialSchematicTraceRender = (trace) => {
     source_trace_id: trace.source_trace_id,
     edges,
     junctions,
-    subcircuit_connectivity_map_key: trace.subcircuit_connectivity_map_key ?? void 0
+    subcircuit_connectivity_map_key: trace.subcircuit_connectivity_map_key ?? void 0,
+    schematic_sheet_id: trace._resolveSchematicSheetId()
   });
   trace.schematic_trace_id = dbTrace.schematic_trace_id;
   for (const { port } of connectedPorts) {
@@ -5164,7 +5180,8 @@ function Trace__doInitialSchematicTraceRenderWithDisplayLabel(trace) {
         anchor_side: toSide,
         text: netLabelText
       }),
-      anchor_side: toSide
+      anchor_side: toSide,
+      schematic_sheet_id: trace._resolveSchematicSheetId()
     });
   }
   if (!existingFromNetLabel) {
@@ -5178,7 +5195,8 @@ function Trace__doInitialSchematicTraceRenderWithDisplayLabel(trace) {
         anchor_side: fromSide,
         text: netLabelText
       }),
-      anchor_side: fromSide
+      anchor_side: fromSide,
+      schematic_sheet_id: trace._resolveSchematicSheetId()
     });
   }
 }
@@ -7869,7 +7887,8 @@ var SchematicArc = class extends PrimitiveComponent2 {
       stroke_width: props.strokeWidth ?? SCHEMATIC_COMPONENT_OUTLINE_STROKE_WIDTH,
       color: props.color ?? SCHEMATIC_COMPONENT_OUTLINE_COLOR,
       is_dashed: props.isDashed,
-      subcircuit_id: this.getSubcircuit().subcircuit_id ?? void 0
+      subcircuit_id: this.getSubcircuit().subcircuit_id ?? void 0,
+      schematic_sheet_id: this._resolveSchematicSheetId()
     });
     this.schematic_arc_id = schematic_arc.schematic_arc_id;
   }
@@ -7928,7 +7947,8 @@ var SchematicCircle = class extends PrimitiveComponent2 {
       is_filled: props.isFilled,
       fill_color: props.fillColor,
       is_dashed: props.isDashed,
-      subcircuit_id: this.getSubcircuit().subcircuit_id ?? void 0
+      subcircuit_id: this.getSubcircuit().subcircuit_id ?? void 0,
+      schematic_sheet_id: this._resolveSchematicSheetId()
     });
     this.schematic_circle_id = schematic_circle.schematic_circle_id;
   }
@@ -7986,7 +8006,8 @@ var SchematicLine = class extends PrimitiveComponent2 {
       is_dashed: props.isDashed || props.dashLength !== void 0 || props.dashGap !== void 0,
       dash_length: props.dashLength,
       dash_gap: props.dashGap,
-      subcircuit_id: this.getSubcircuit().subcircuit_id ?? void 0
+      subcircuit_id: this.getSubcircuit().subcircuit_id ?? void 0,
+      schematic_sheet_id: this._resolveSchematicSheetId()
     });
     this.schematic_line_id = schematic_line.schematic_line_id;
   }
@@ -8179,7 +8200,8 @@ var SchematicPath = class extends PrimitiveComponent2 {
           stroke_width: props.strokeWidth,
           dash_length: props.dashLength,
           dash_gap: props.dashGap,
-          subcircuit_id
+          subcircuit_id,
+          schematic_sheet_id: this._resolveSchematicSheetId()
         });
         this.schematic_path_ids.push(schematic_path.schematic_path_id);
       }
@@ -8198,7 +8220,8 @@ var SchematicPath = class extends PrimitiveComponent2 {
         stroke_width: props.strokeWidth,
         dash_length: props.dashLength,
         dash_gap: props.dashGap,
-        subcircuit_id
+        subcircuit_id,
+        schematic_sheet_id: this._resolveSchematicSheetId()
       });
       this.schematic_path_ids.push(schematic_path.schematic_path_id);
     }
@@ -8258,7 +8281,8 @@ var SchematicRect = class extends PrimitiveComponent2 {
       schematic_component_id,
       is_dashed: props.isDashed,
       rotation: props.rotation ?? 0,
-      subcircuit_id: this.getSubcircuit().subcircuit_id ?? void 0
+      subcircuit_id: this.getSubcircuit().subcircuit_id ?? void 0,
+      schematic_sheet_id: this._resolveSchematicSheetId()
     });
     this.schematic_rect_id = schematic_rect.schematic_rect_id;
   }
@@ -8323,7 +8347,8 @@ var SchematicText = class extends PrimitiveComponent2 {
         x: globalPos.x,
         y: globalPos.y
       },
-      rotation: props.schRotation ?? 0
+      rotation: props.schRotation ?? 0,
+      schematic_sheet_id: this._resolveSchematicSheetId()
     });
     this.schematic_text_id = schematic_text.schematic_text_id;
   }
@@ -9915,7 +9940,8 @@ var Port = class extends PrimitiveComponent2 {
       pin_number: props.pinNumber,
       true_ccw_index: localPortInfo?.trueIndex,
       display_pin_label: bestDisplayPinLabel,
-      is_connected: false
+      is_connected: false,
+      schematic_sheet_id: this._resolveSchematicSheetId()
     };
     for (const attributes of this._getMatchingPinAttributes()) {
       if (attributes.requiresPower) {
@@ -9943,7 +9969,8 @@ var Port = class extends PrimitiveComponent2 {
         y2,
         stroke_width: 0.02,
         color: SCHEMATIC_COMPONENT_OUTLINE_COLOR,
-        is_dashed: false
+        is_dashed: false,
+        schematic_sheet_id: this._resolveSchematicSheetId()
       });
       this.schematic_stem_line_id = stemLine.schematic_line_id;
     }
@@ -11432,7 +11459,7 @@ var getNumericSchPinStyle = (pinStyles, pinLabels) => {
 
 // lib/components/base-components/NormalComponent/NormalComponent.ts
 import {
-  isValidElement as isReactElement2,
+  isValidElement as isReactElement3,
   isValidElement
 } from "react";
 import { symbols as symbols2 } from "schematic-symbols";
@@ -12555,6 +12582,79 @@ function NormalComponent_doInitialSupplierFootprintMismatchWarning(component) {
   });
 }
 
+// lib/components/base-components/NormalComponent/NormalComponent_doInitialSchematicComponentRender.ts
+import { schematic_manual_edit_conflict_warning } from "circuit-json";
+import { isValidElement as isReactElement2 } from "react";
+function NormalComponent_doInitialSchematicComponentRender(component) {
+  if (component.root?.schematicDisabled) return;
+  if (component.getCollapsedSchematicBoxAncestor()) return;
+  const { db } = component.root;
+  if (component._invalidPinLabelMessages?.length && component.root?.db) {
+    for (const message of component._invalidPinLabelMessages) {
+      let property_name = "pinLabels";
+      const match = message.match(/^Invalid pin label:\s*([^=]+)=\s*'([^']+)'/);
+      if (match) {
+        const label = match[2];
+        property_name = `pinLabels['${label}']`;
+      }
+      component.root.db.source_property_ignored_warning.insert({
+        source_component_id: component.source_component_id,
+        property_name,
+        message,
+        error_type: "source_property_ignored_warning"
+      });
+    }
+  }
+  if (component._parsedProps.schPinSpacing !== void 0 && component.root?.db) {
+    component.root.db.source_property_ignored_warning.insert({
+      source_component_id: component.source_component_id,
+      property_name: "schPinSpacing",
+      error_type: "source_property_ignored_warning",
+      message: "schPinSpacing is deprecated and will be ignored. Pin spacing is always 0.2."
+    });
+  }
+  const { schematicSymbolName } = component.config;
+  const { _parsedProps: props } = component;
+  const hasSymbolChild = component.children.some(
+    (c) => c.componentName === "Symbol"
+  );
+  if (props.symbol && isReactElement2(props.symbol) || hasSymbolChild) {
+    component._doInitialSchematicComponentRenderWithReactSymbol(props.symbol);
+  } else if (schematicSymbolName) {
+    component._doInitialSchematicComponentRenderWithSymbol();
+  } else {
+    const dimensions = component._getSchematicBoxDimensions();
+    if (dimensions) {
+      component._doInitialSchematicComponentRenderWithSchematicBoxDimensions();
+    }
+  }
+  const manualPlacement = component.getSubcircuit()?._getSchematicManualPlacementForComponent(component);
+  if (component.schematic_component_id && (component.props.schX !== void 0 || component.props.schY !== void 0) && !!manualPlacement) {
+    if (!component.schematic_component_id) {
+      return;
+    }
+    const warning = schematic_manual_edit_conflict_warning.parse({
+      type: "schematic_manual_edit_conflict_warning",
+      schematic_manual_edit_conflict_warning_id: `schematic_manual_edit_conflict_${component.source_component_id}`,
+      message: `${component.getString()} has both manual placement and prop coordinates. schX and schY will be used. Remove schX/schY or clear the manual placement.`,
+      schematic_component_id: component.schematic_component_id,
+      source_component_id: component.source_component_id,
+      subcircuit_id: component.getSubcircuit()?.subcircuit_id
+    });
+    db.schematic_manual_edit_conflict_warning.insert(warning);
+  }
+  const schSheetName = component._parsedProps?.schSheetName ?? component.props.schSheetName;
+  if (schSheetName && component.source_component_id && !component._resolveSchematicSheetId()) {
+    db.source_property_ignored_warning.insert({
+      source_component_id: component.source_component_id,
+      property_name: "schSheetName",
+      error_type: "source_property_ignored_warning",
+      subcircuit_id: component.getSubcircuit()?.subcircuit_id ?? void 0,
+      message: `${component.getString()} references schSheetName "${schSheetName}", which does not match any schematic sheet and will be ignored.`
+    });
+  }
+}
+
 // lib/components/base-components/NormalComponent/utils/canMergePortDefinitions.ts
 var canMergePortDefinitions = (a, b) => {
   const aPinNumber = a._parsedProps.pinNumber;
@@ -13120,65 +13220,7 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
    * You can override this method to do more complicated things.
    */
   doInitialSchematicComponentRender() {
-    if (this.root?.schematicDisabled) return;
-    if (this.getCollapsedSchematicBoxAncestor()) return;
-    const { db } = this.root;
-    if (this._invalidPinLabelMessages?.length && this.root?.db) {
-      for (const message of this._invalidPinLabelMessages) {
-        let property_name = "pinLabels";
-        const match = message.match(
-          /^Invalid pin label:\s*([^=]+)=\s*'([^']+)'/
-        );
-        if (match) {
-          const label = match[2];
-          property_name = `pinLabels['${label}']`;
-        }
-        this.root.db.source_property_ignored_warning.insert({
-          source_component_id: this.source_component_id,
-          property_name,
-          message,
-          error_type: "source_property_ignored_warning"
-        });
-      }
-    }
-    if (this._parsedProps.schPinSpacing !== void 0 && this.root?.db) {
-      this.root.db.source_property_ignored_warning.insert({
-        source_component_id: this.source_component_id,
-        property_name: "schPinSpacing",
-        error_type: "source_property_ignored_warning",
-        message: "schPinSpacing is deprecated and will be ignored. Pin spacing is always 0.2."
-      });
-    }
-    const { schematicSymbolName } = this.config;
-    const { _parsedProps: props } = this;
-    const hasSymbolChild = this.children.some(
-      (c) => c.componentName === "Symbol"
-    );
-    if (props.symbol && isReactElement2(props.symbol) || hasSymbolChild) {
-      this._doInitialSchematicComponentRenderWithReactSymbol(props.symbol);
-    } else if (schematicSymbolName) {
-      this._doInitialSchematicComponentRenderWithSymbol();
-    } else {
-      const dimensions = this._getSchematicBoxDimensions();
-      if (dimensions) {
-        this._doInitialSchematicComponentRenderWithSchematicBoxDimensions();
-      }
-    }
-    const manualPlacement = this.getSubcircuit()?._getSchematicManualPlacementForComponent(this);
-    if (this.schematic_component_id && (this.props.schX !== void 0 || this.props.schY !== void 0) && !!manualPlacement) {
-      if (!this.schematic_component_id) {
-        return;
-      }
-      const warning = schematic_manual_edit_conflict_warning.parse({
-        type: "schematic_manual_edit_conflict_warning",
-        schematic_manual_edit_conflict_warning_id: `schematic_manual_edit_conflict_${this.source_component_id}`,
-        message: `${this.getString()} has both manual placement and prop coordinates. schX and schY will be used. Remove schX/schY or clear the manual placement.`,
-        schematic_component_id: this.schematic_component_id,
-        source_component_id: this.source_component_id,
-        subcircuit_id: this.getSubcircuit()?.subcircuit_id
-      });
-      db.schematic_manual_edit_conflict_warning.insert(warning);
-    }
+    NormalComponent_doInitialSchematicComponentRender(this);
   }
   _getSchematicSymbolDisplayValue() {
     return void 0;
@@ -13209,6 +13251,7 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
         source_component_id: this.source_component_id,
         is_box_with_pins: true,
         symbol_name,
+        schematic_sheet_id: this._resolveSchematicSheetId(),
         symbol_display_value: this._getSchematicSymbolDisplayValue()
       });
       this.schematic_component_id = schematic_component2.schematic_component_id;
@@ -13224,7 +13267,8 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
       size: { width: 0, height: 0 },
       source_component_id: this.source_component_id,
       symbol_display_value: this._getSchematicSymbolDisplayValue(),
-      is_box_with_pins: false
+      is_box_with_pins: false,
+      schematic_sheet_id: this._resolveSchematicSheetId()
     });
     this.schematic_component_id = schematic_component2.schematic_component_id;
   }
@@ -13258,7 +13302,8 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
       // @ts-ignore soup needs to support distance for pin_styles
       pin_styles: underscorifyPinStyles(props.schPinStyle, props.pinLabels),
       port_labels: primaryPortLabels,
-      source_component_id: this.source_component_id
+      source_component_id: this.source_component_id,
+      schematic_sheet_id: this._resolveSchematicSheetId()
     });
     const hasTopOrBottomPins = schPortArrangement?.topSide !== void 0 || schPortArrangement?.bottomSide !== void 0;
     const schematic_box_width = dimensions?.getSize().width;
@@ -13273,7 +13318,8 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
         y: hasTopOrBottomPins ? center.y + (schematic_box_height ?? 0) / 2 + 0.35 : center.y - (schematic_box_height ?? 0) / 2 - 0.13
       },
       color: "#006464",
-      font_size: 0.18
+      font_size: 0.18,
+      schematic_sheet_id: this._resolveSchematicSheetId()
     });
     const component_name_text = db.schematic_text.insert({
       text: props.displayName ?? props.name ?? "",
@@ -13285,7 +13331,8 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
         y: hasTopOrBottomPins ? center.y + (schematic_box_height ?? 0) / 2 + 0.55 : center.y + (schematic_box_height ?? 0) / 2 + 0.13
       },
       color: "#006464",
-      font_size: 0.18
+      font_size: 0.18,
+      schematic_sheet_id: this._resolveSchematicSheetId()
     });
     this.schematic_component_id = schematic_component2.schematic_component_id;
   }
@@ -13603,7 +13650,7 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
   }
   add(componentOrElm) {
     let component;
-    if (isReactElement2(componentOrElm)) {
+    if (isReactElement3(componentOrElm)) {
       const subtree = this._renderReactSubtree(componentOrElm);
       this.reactSubtrees.push(subtree);
       component = subtree.component;
@@ -19267,7 +19314,8 @@ var Group_doInitialSchematicBoxComponentRender = (group) => {
       props.schPinStyle,
       portLabels
     ),
-    port_labels: portLabels
+    port_labels: portLabels,
+    schematic_sheet_id: group._resolveSchematicSheetId()
   });
   group.schematic_component_id = schematicComponent.schematic_component_id;
   if (group.schematic_group_id) {
@@ -19290,7 +19338,8 @@ var Group_doInitialSchematicBoxComponentRender = (group) => {
         y: center.y + size.height / 2 + 0.13
       },
       color: "#006464",
-      font_size: 0.18
+      font_size: 0.18,
+      schematic_sheet_id: group._resolveSchematicSheetId()
     });
   }
 };
@@ -20166,7 +20215,8 @@ function applyTracesFromSolverOutput(args) {
       junctions: junctionsById[t.source_trace_id] ?? [],
       subcircuit_connectivity_map_key: pendingTraces.find(
         (p) => p.source_trace_id === t.source_trace_id
-      )?.subcircuit_connectivity_map_key
+      )?.subcircuit_connectivity_map_key,
+      schematic_sheet_id: group._resolveSchematicSheetId()
     });
   }
 }
@@ -20309,7 +20359,8 @@ function applyNetLabelPlacements(args) {
         source_net_id: sourceNet.source_net_id,
         anchor_position,
         center: center2,
-        anchor_side
+        anchor_side,
+        schematic_sheet_id: group._resolveSchematicSheetId()
       };
       db.schematic_net_label.insert(netLabel2);
       continue;
@@ -20336,7 +20387,8 @@ function applyNetLabelPlacements(args) {
       source_net_id: placementConnKey ?? placement.netId ?? placement.globalConnNetId,
       anchor_position,
       center,
-      anchor_side
+      anchor_side,
+      schematic_sheet_id: group._resolveSchematicSheetId()
     };
     db.schematic_net_label.insert(netLabel);
   }
@@ -20531,7 +20583,8 @@ var insertNetLabelsForPortsMissingTrace = ({
       source_net_id: sourceNet?.source_net_id ?? connKey,
       anchor_position: schPort.center,
       center,
-      anchor_side: side
+      anchor_side: side,
+      schematic_sheet_id: group._resolveSchematicSheetId()
     };
     db.schematic_net_label.insert(netLabel);
   }
@@ -24306,7 +24359,7 @@ import { identity as identity5 } from "transformation-matrix";
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.1363",
+  version: "0.0.1365",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -24355,7 +24408,7 @@ var package_default = {
     "@tscircuit/math-utils": "^0.0.36",
     "@tscircuit/miniflex": "^0.0.4",
     "@tscircuit/ngspice-spice-engine": "^0.0.18",
-    "@tscircuit/props": "^0.0.558",
+    "@tscircuit/props": "^0.0.561",
     "@tscircuit/schematic-match-adapt": "^0.0.18",
     "@tscircuit/schematic-trace-solver": "^0.0.72",
     "@tscircuit/solver-utils": "^0.0.16",
@@ -24369,13 +24422,13 @@ var package_default = {
     "bun-match-svg": "0.0.12",
     "calculate-elbow": "^0.0.12",
     "chokidar-cli": "^3.0.0",
-    "circuit-json": "^0.0.439",
+    "circuit-json": "^0.0.442",
     "circuit-json-to-bpc": "^0.0.13",
     "circuit-json-to-connectivity-map": "^0.0.23",
     "circuit-json-to-gltf": "^0.0.105",
     "circuit-json-to-simple-3d": "^0.0.9",
     "circuit-json-to-spice": "^0.0.40",
-    "circuit-to-svg": "^0.0.360",
+    "circuit-to-svg": "^0.0.364",
     concurrently: "^9.1.2",
     "connectivity-map": "^1.0.0",
     debug: "^4.3.6",
@@ -28598,7 +28651,8 @@ var NetLabel = class extends PrimitiveComponent2 {
       source_net_id: net.source_net_id,
       anchor_position: anchorPos,
       center,
-      anchor_side: anchorSide
+      anchor_side: anchorSide,
+      schematic_sheet_id: this._resolveSchematicSheetId()
     });
     this.source_net_label_id = netLabel.source_net_id;
   }
@@ -28709,7 +28763,8 @@ var NetLabel = class extends PrimitiveComponent2 {
         source_trace_id,
         edges,
         junctions: [],
-        subcircuit_connectivity_map_key
+        subcircuit_connectivity_map_key,
+        schematic_sheet_id: this._resolveSchematicSheetId()
       });
       db.schematic_port.update(port.schematic_port_id, { is_connected: true });
     }
@@ -29458,7 +29513,8 @@ function insertInnerSymbolInSchematicBox(connector, symbol) {
         is_dashed: false,
         fill_color: primitive.fill ? SCHEMATIC_COMPONENT_OUTLINE_COLOR : void 0,
         stroke_width: 0.02,
-        subcircuit_id
+        subcircuit_id,
+        schematic_sheet_id: connector._resolveSchematicSheetId()
       });
     } else if (primitive.type === "circle") {
       db.schematic_circle.insert({
@@ -29470,7 +29526,8 @@ function insertInnerSymbolInSchematicBox(connector, symbol) {
         is_filled: primitive.fill,
         fill_color: primitive.fill ? SCHEMATIC_COMPONENT_OUTLINE_COLOR : void 0,
         is_dashed: false,
-        subcircuit_id
+        subcircuit_id,
+        schematic_sheet_id: connector._resolveSchematicSheetId()
       });
     } else if (primitive.type === "box") {
       const topLeft = transformPoint({ x: primitive.x, y: primitive.y });
@@ -29491,7 +29548,8 @@ function insertInnerSymbolInSchematicBox(connector, symbol) {
         is_filled: false,
         is_dashed: false,
         rotation: 0,
-        subcircuit_id
+        subcircuit_id,
+        schematic_sheet_id: connector._resolveSchematicSheetId()
       });
     }
   }
@@ -30564,7 +30622,8 @@ var SchematicBox = class extends PrimitiveComponent2 {
           x: titleX,
           y: titleY
         },
-        rotation: 0
+        rotation: 0,
+        schematic_sheet_id: this._resolveSchematicSheetId()
       });
     }
   }
@@ -30670,7 +30729,8 @@ var SchematicSection = class _SchematicSection extends PrimitiveComponent2 {
         y2: line.end.y,
         stroke_width: STROKE_WIDTH,
         color: "#000000",
-        is_dashed: false
+        is_dashed: false,
+        schematic_sheet_id: this._resolveSchematicSheetId()
       });
     }
     const hDividers = dividers.filter(
@@ -30698,12 +30758,65 @@ var SchematicSection = class _SchematicSection extends PrimitiveComponent2 {
           x: leftBoundary + LABEL_PADDING,
           y: topBoundary - LABEL_PADDING
         },
-        rotation: 0
+        rotation: 0,
+        schematic_sheet_id: this._resolveSchematicSheetId()
       });
     }
   }
 };
 
+// lib/components/primitive-components/SchematicSheet.ts
+import { schematicSheetProps } from "@tscircuit/props";
+var SchematicSheet = class extends PrimitiveComponent2 {
+  isSchematicPrimitive = true;
+  get config() {
+    return {
+      componentName: "SchematicSheet",
+      zodProps: schematicSheetProps
+    };
+  }
+  doInitialSourceGroupRender() {
+    if (this.root?.schematicDisabled) return;
+    const { db } = this.root;
+    const { _parsedProps: props } = this;
+    const schematicSheet = db.schematic_sheet.insert({
+      name: props.name,
+      display_name: props.displayName,
+      sheet_index: props.sheetIndex,
+      subcircuit_id: this.getSubcircuit().subcircuit_id ?? void 0
+    });
+    this.schematic_sheet_id = schematicSheet.schematic_sheet_id;
+  }
+  doInitialSchematicSheetRender() {
+    if (this.root?.schematicDisabled) return;
+    if (!this.schematic_sheet_id) return;
+    const { db } = this.root;
+    const schematicElements = [
+      ...db.schematic_component.list(),
+      ...db.schematic_port.list(),
+      ...db.schematic_text.list(),
+      ...db.schematic_line.list(),
+      ...db.schematic_rect.list(),
+      ...db.schematic_circle.list(),
+      ...db.schematic_arc.list(),
+      ...db.schematic_path.list()
+    ].filter(
+      (element) => element.schematic_sheet_id === this.schematic_sheet_id
+    );
+    if (schematicElements.length === 0) return;
+    const bounds = getBoundsForSchematic(schematicElements);
+    if (!Number.isFinite(bounds.minX) || !Number.isFinite(bounds.maxX) || !Number.isFinite(bounds.minY) || !Number.isFinite(bounds.maxY)) {
+      return;
+    }
+    db.schematic_sheet.update(this.schematic_sheet_id, {
+      center: {
+        x: (bounds.minX + bounds.maxX) / 2,
+        y: (bounds.minY + bounds.maxY) / 2
+      }
+    });
+  }
+};
+
 // lib/components/primitive-components/SchematicTable.ts
 import { schematicTableProps } from "@tscircuit/props";
 var SchematicTable = class extends PrimitiveComponent2 {
@@ -30784,7 +30897,8 @@ var SchematicTable = class extends PrimitiveComponent2 {
       border_width: props.borderWidth,
       anchor: props.anchor,
       subcircuit_id: this.getSubcircuit()?.subcircuit_id || "",
-      schematic_component_id: this.parent?.schematic_component_id || ""
+      schematic_component_id: this.parent?.schematic_component_id || "",
+      schematic_sheet_id: this._resolveSchematicSheetId()
     });
     this.schematic_table_id = table.schematic_table_id;
     const processedCells = /* @__PURE__ */ new Set();
@@ -31563,6 +31677,7 @@ export {
   SchematicRect,
   SchematicRow,
   SchematicSection,
+  SchematicSheet,
   SchematicTable,
   SchematicText,
   SilkscreenCircle,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tscircuit/core",
   "type": "module",
-  "version": "0.0.1364",
+  "version": "0.0.1366",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -50,7 +50,7 @@
     "@tscircuit/math-utils": "^0.0.36",
     "@tscircuit/miniflex": "^0.0.4",
     "@tscircuit/ngspice-spice-engine": "^0.0.18",
-    "@tscircuit/props": "^0.0.558",
+    "@tscircuit/props": "^0.0.561",
     "@tscircuit/schematic-match-adapt": "^0.0.18",
     "@tscircuit/schematic-trace-solver": "^0.0.72",
     "@tscircuit/solver-utils": "^0.0.16",
@@ -64,13 +64,13 @@
     "bun-match-svg": "0.0.12",
     "calculate-elbow": "^0.0.12",
     "chokidar-cli": "^3.0.0",
-    "circuit-json": "^0.0.439",
+    "circuit-json": "^0.0.442",
     "circuit-json-to-bpc": "^0.0.13",
     "circuit-json-to-connectivity-map": "^0.0.23",
     "circuit-json-to-gltf": "^0.0.105",
     "circuit-json-to-simple-3d": "^0.0.9",
     "circuit-json-to-spice": "^0.0.40",
-    "circuit-to-svg": "^0.0.360",
+    "circuit-to-svg": "^0.0.364",
     "concurrently": "^9.1.2",
     "connectivity-map": "^1.0.0",
     "debug": "^4.3.6",