@tscircuit/core 0.0.1037 → 0.0.1039

package/dist/index.d.ts

@@ -172,9 +172,9 @@ interface IIsolatedCircuit {
 interface IRootCircuit extends IIsolatedCircuit {
 }
 
-declare const orderedRenderPhases: readonly ["ReactSubtreesRender", "InflateSubcircuitCircuitJson", "SourceNameDuplicateComponentRemoval", "PcbFootprintStringRender", "InitializePortsFromChildren", "CreateNetsFromProps", "AssignFallbackProps", "CreateTracesFromProps", "CreateTracesFromNetLabels", "CreateTraceHintsFromProps", "SourceGroupRender", "AssignNameToUnnamedComponents", "SourceRender", "SourceParentAttachment", "PortMatching", "OptimizeSelectorCache", "SourceTraceRender", "SourceAddConnectivityMapKey", "SourceDesignRuleChecks", "SimulationRender", "SchematicComponentRender", "SchematicPortRender", "SymbolContainerRender", "SchematicPrimitiveRender", "SchematicSymbolResize", "SchematicComponentSizeCalculation", "SchematicLayout", "SchematicTraceRender", "SchematicReplaceNetLabelsWithSymbols", "PanelBoardLayout", "PcbComponentRender", "PcbPrimitiveRender", "PcbFootprintLayout", "PcbPortRender", "PcbPortAttachment", "PcbComponentSizeCalculation", "PcbComponentAnchorAlignment", "PcbCalcPlacementResolution", "PcbLayout", "PcbBoardAutoSize", "PanelLayout", "PcbTraceHintRender", "PcbManualTraceRender", "PcbTraceRender", "PcbRouteNetIslands", "PcbCopperPourRender", "PcbDesignRuleChecks", "SilkscreenOverlapAdjustment", "CadModelRender", "PartsEngineRender", "SimulationSpiceEngineRender"];
+declare const orderedRenderPhases: readonly ["ReactSubtreesRender", "RenderIsolatedSubcircuits", "InflateSubcircuitCircuitJson", "SourceNameDuplicateComponentRemoval", "PcbFootprintStringRender", "InitializePortsFromChildren", "CreateNetsFromProps", "AssignFallbackProps", "CreateTracesFromProps", "CreateTracesFromNetLabels", "CreateTraceHintsFromProps", "SourceGroupRender", "AssignNameToUnnamedComponents", "SourceRender", "SourceParentAttachment", "PortMatching", "OptimizeSelectorCache", "SourceTraceRender", "SourceAddConnectivityMapKey", "SourceDesignRuleChecks", "SimulationRender", "SchematicComponentRender", "SchematicPortRender", "SymbolContainerRender", "SchematicPrimitiveRender", "SchematicSymbolResize", "SchematicComponentSizeCalculation", "SchematicLayout", "SchematicTraceRender", "SchematicReplaceNetLabelsWithSymbols", "PanelBoardLayout", "PcbComponentRender", "PcbPrimitiveRender", "PcbFootprintLayout", "PcbPortRender", "PcbPortAttachment", "PcbComponentSizeCalculation", "PcbComponentAnchorAlignment", "PcbCalcPlacementResolution", "PcbLayout", "PcbBoardAutoSize", "PanelLayout", "PcbTraceHintRender", "PcbManualTraceRender", "PcbTraceRender", "PcbRouteNetIslands", "PcbCopperPourRender", "PcbDesignRuleChecks", "SilkscreenOverlapAdjustment", "CadModelRender", "PartsEngineRender", "SimulationSpiceEngineRender"];
 type RenderPhase = (typeof orderedRenderPhases)[number];
-declare const renderPhaseIndexMap: Map<"ReactSubtreesRender" | "InflateSubcircuitCircuitJson" | "SourceNameDuplicateComponentRemoval" | "PcbFootprintStringRender" | "InitializePortsFromChildren" | "CreateNetsFromProps" | "AssignFallbackProps" | "CreateTracesFromProps" | "CreateTracesFromNetLabels" | "CreateTraceHintsFromProps" | "SourceGroupRender" | "AssignNameToUnnamedComponents" | "SourceRender" | "SourceParentAttachment" | "PortMatching" | "OptimizeSelectorCache" | "SourceTraceRender" | "SourceAddConnectivityMapKey" | "SourceDesignRuleChecks" | "SimulationRender" | "SchematicComponentRender" | "SchematicPortRender" | "SymbolContainerRender" | "SchematicPrimitiveRender" | "SchematicSymbolResize" | "SchematicComponentSizeCalculation" | "SchematicLayout" | "SchematicTraceRender" | "SchematicReplaceNetLabelsWithSymbols" | "PanelBoardLayout" | "PcbComponentRender" | "PcbPrimitiveRender" | "PcbFootprintLayout" | "PcbPortRender" | "PcbPortAttachment" | "PcbComponentSizeCalculation" | "PcbComponentAnchorAlignment" | "PcbCalcPlacementResolution" | "PcbLayout" | "PcbBoardAutoSize" | "PanelLayout" | "PcbTraceHintRender" | "PcbManualTraceRender" | "PcbTraceRender" | "PcbRouteNetIslands" | "PcbCopperPourRender" | "PcbDesignRuleChecks" | "SilkscreenOverlapAdjustment" | "CadModelRender" | "PartsEngineRender" | "SimulationSpiceEngineRender", number>;
+declare const renderPhaseIndexMap: Map<"ReactSubtreesRender" | "RenderIsolatedSubcircuits" | "InflateSubcircuitCircuitJson" | "SourceNameDuplicateComponentRemoval" | "PcbFootprintStringRender" | "InitializePortsFromChildren" | "CreateNetsFromProps" | "AssignFallbackProps" | "CreateTracesFromProps" | "CreateTracesFromNetLabels" | "CreateTraceHintsFromProps" | "SourceGroupRender" | "AssignNameToUnnamedComponents" | "SourceRender" | "SourceParentAttachment" | "PortMatching" | "OptimizeSelectorCache" | "SourceTraceRender" | "SourceAddConnectivityMapKey" | "SourceDesignRuleChecks" | "SimulationRender" | "SchematicComponentRender" | "SchematicPortRender" | "SymbolContainerRender" | "SchematicPrimitiveRender" | "SchematicSymbolResize" | "SchematicComponentSizeCalculation" | "SchematicLayout" | "SchematicTraceRender" | "SchematicReplaceNetLabelsWithSymbols" | "PanelBoardLayout" | "PcbComponentRender" | "PcbPrimitiveRender" | "PcbFootprintLayout" | "PcbPortRender" | "PcbPortAttachment" | "PcbComponentSizeCalculation" | "PcbComponentAnchorAlignment" | "PcbCalcPlacementResolution" | "PcbLayout" | "PcbBoardAutoSize" | "PanelLayout" | "PcbTraceHintRender" | "PcbManualTraceRender" | "PcbTraceRender" | "PcbRouteNetIslands" | "PcbCopperPourRender" | "PcbDesignRuleChecks" | "SilkscreenOverlapAdjustment" | "CadModelRender" | "PartsEngineRender" | "SimulationSpiceEngineRender", number>;
 type RenderPhaseFn<K extends RenderPhase = RenderPhase> = `doInitial${K}` | `update${K}` | `remove${K}`;
 type RenderPhaseStates = Record<RenderPhase, {
     initialized: boolean;
@@ -290,6 +290,12 @@ declare class IsolatedCircuit {
     db: CircuitJsonUtilObjects;
     root: IsolatedCircuit | null;
     isRootCircuit: boolean;
+    /**
+     * Optional cache for isolated subcircuit circuit JSON, keyed by prop hash.
+     * This is passed down from the RootCircuit when creating isolated circuits
+     * for subcircuit rendering.
+     */
+    cachedSubcircuits?: Map<string, AnyCircuitElement[]>;
     private _schematicDisabledOverride;
     get schematicDisabled(): boolean;
     set schematicDisabled(value: boolean);
@@ -312,9 +318,10 @@ declare class IsolatedCircuit {
     _hasRenderedAtleastOnce: boolean;
     private _asyncEffectIdsByPhase;
     private _asyncEffectPhaseById;
-    constructor({ platform, projectUrl, }?: {
+    constructor({ platform, projectUrl, cachedSubcircuits, }?: {
         platform?: PlatformConfig;
         projectUrl?: string;
+        cachedSubcircuits?: Map<string, AnyCircuitElement[]>;
     });
     add(componentOrElm: PrimitiveComponent | ReactElement): void;
     setPlatform(platform: Partial<PlatformConfig>): void;
@@ -1317,6 +1324,7 @@ declare class Trace extends PrimitiveComponent<typeof traceProps> implements Tra
 declare const portProps: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     pinNumber: z.ZodOptional<z.ZodNumber>;
+    schStemLength: z.ZodOptional<z.ZodNumber>;
     aliases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     layer: z.ZodOptional<z.ZodString>;
     layers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -1329,6 +1337,7 @@ declare const portProps: z.ZodObject<{
     layers?: string[] | undefined;
     name?: string | undefined;
     pinNumber?: number | undefined;
+    schStemLength?: number | undefined;
     aliases?: string[] | undefined;
     schX?: number | undefined;
     schY?: number | undefined;
@@ -1339,6 +1348,7 @@ declare const portProps: z.ZodObject<{
     layers?: string[] | undefined;
     name?: string | undefined;
     pinNumber?: number | undefined;
+    schStemLength?: number | undefined;
     aliases?: string[] | undefined;
     schX?: number | undefined;
     schY?: number | undefined;
@@ -1358,6 +1368,7 @@ declare class Port extends PrimitiveComponent<typeof portProps> {
         zodProps: z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
             pinNumber: z.ZodOptional<z.ZodNumber>;
+            schStemLength: z.ZodOptional<z.ZodNumber>;
             aliases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             layer: z.ZodOptional<z.ZodString>;
             layers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -1370,6 +1381,7 @@ declare class Port extends PrimitiveComponent<typeof portProps> {
             layers?: string[] | undefined;
             name?: string | undefined;
             pinNumber?: number | undefined;
+            schStemLength?: number | undefined;
             aliases?: string[] | undefined;
             schX?: number | undefined;
             schY?: number | undefined;
@@ -1380,6 +1392,7 @@ declare class Port extends PrimitiveComponent<typeof portProps> {
             layers?: string[] | undefined;
             name?: string | undefined;
             pinNumber?: number | undefined;
+            schStemLength?: number | undefined;
             aliases?: string[] | undefined;
             schX?: number | undefined;
             schY?: number | undefined;
@@ -1664,7 +1677,6 @@ declare class Group<Props extends z.ZodType<any, any, any> = typeof groupProps>
     _hasStartedAsyncAutorouting: boolean;
     _isInflatedFromCircuitJson: boolean;
     _isolatedCircuitJson: AnyCircuitElement[] | null;
-    _isolatedCircuit: IsolatedCircuit | null;
     get _isIsolatedSubcircuit(): boolean;
     _normalComponentNameMap: Map<string, NormalComponent[]> | null;
     /**
@@ -1697,7 +1709,6 @@ declare class Group<Props extends z.ZodType<any, any, any> = typeof groupProps>
         zodProps: Props;
         componentName: string;
     };
-    runRenderCycle(): void;
     doInitialSourceGroupRender(): void;
     doInitialSourceRender(): void;
     doInitialSourceParentAttachment(): void;
@@ -3272,6 +3283,22 @@ declare class Board extends Group<typeof boardProps> implements BoardI, Subcircu
 
 declare class Subcircuit extends Group<typeof subcircuitProps> implements SubcircuitI {
     constructor(props: z.input<typeof subcircuitProps>);
+    /**
+     * Computes a hash of this subcircuit's props and children for caching.
+     * Position/identity props are excluded so identical subcircuits at
+     * different locations share the same hash.
+     */
+    getSubcircuitPropHash(): string;
+    /**
+     * Render this subcircuit in isolation if _subcircuitCachingEnabled is set.
+     * This phase runs before InflateSubcircuitCircuitJson to prepare the
+     * isolated circuit JSON that will be inflated.
+     *
+     * The rendering is synchronous - it loops until all async effects in the
+     * isolated circuit are complete, ensuring the cache is populated before
+     * processing the next subcircuit with potentially the same props.
+     */
+    doInitialRenderIsolatedSubcircuits(): void;
     /**
      * During this phase, we inflate the subcircuit circuit json into class
      * instances