@tscircuit/core 0.0.1203 → 0.0.1205

package/dist/index.d.ts

@@ -188,9 +188,9 @@ interface IIsolatedCircuit {
 interface IRootCircuit extends IIsolatedCircuit {
 }
 
-declare const orderedRenderPhases: readonly ["ReactSubtreesRender", "RenderIsolatedSubcircuits", "InflateSubcircuitCircuitJson", "SourceNameDuplicateComponentRemoval", "PcbFootprintStringRender", "FetchPartFootprint", "InitializePortsFromChildren", "CreateNetsFromProps", "AssignFallbackProps", "CreateTracesFromProps", "CreateTracesFromNetLabels", "CreateTraceHintsFromProps", "SourceGroupRender", "AssignNameToUnnamedComponents", "SourceRender", "SourceComponentPropertyValidation", "SourceParentAttachment", "PortMatching", "OptimizeSelectorCache", "SourceTraceRender", "SourceAddConnectivityMapKey", "SourceDesignRuleChecks", "SimulationRender", "SchematicComponentRender", "SchematicPortRender", "SymbolContainerRender", "SchematicPrimitiveRender", "SchematicSymbolResize", "SchematicComponentSizeCalculation", "SchematicLayout", "SchematicTraceRender", "SchematicReplaceNetLabelsWithSymbols", "PanelBoardLayout", "ValidatePcbCoordinates", "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", "FetchPartFootprint", "InitializePortsFromChildren", "CreateNetsFromProps", "AssignFallbackProps", "CreateTracesFromProps", "CreateTracesFromNetLabels", "CreateTraceHintsFromProps", "SourceGroupRender", "AssignNameToUnnamedComponents", "SourceRender", "SourceComponentPropertyValidation", "SourceParentAttachment", "PortMatching", "OptimizeSelectorCache", "SourceTraceRender", "SourceAddConnectivityMapKey", "SourceDesignRuleChecks", "SimulationRender", "SchematicComponentRender", "SchematicPortRender", "SymbolContainerRender", "SchematicPrimitiveRender", "SchematicSymbolResize", "SchematicComponentSizeCalculation", "SchematicLayout", "SchematicTraceRender", "SchematicReplaceNetLabelsWithSymbols", "PanelBoardLayout", "ValidatePcbCoordinates", "PcbComponentRender", "PcbPrimitiveRender", "PcbFootprintLayout", "PcbPortRender", "PcbPortAttachment", "PcbComponentSizeCalculation", "PcbComponentAnchorAlignment", "PcbCalcPlacementResolution", "PcbLayout", "PcbBoardAutoSize", "PanelLayout", "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" | "SourceGroupRender" | "AssignNameToUnnamedComponents" | "SourceRender" | "SourceComponentPropertyValidation" | "SourceParentAttachment" | "PortMatching" | "OptimizeSelectorCache" | "SourceTraceRender" | "SourceAddConnectivityMapKey" | "SourceDesignRuleChecks" | "SimulationRender" | "SchematicComponentRender" | "SchematicPortRender" | "SymbolContainerRender" | "SchematicPrimitiveRender" | "SchematicSymbolResize" | "SchematicComponentSizeCalculation" | "SchematicLayout" | "SchematicTraceRender" | "SchematicReplaceNetLabelsWithSymbols" | "PanelBoardLayout" | "ValidatePcbCoordinates" | "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" | "FetchPartFootprint" | "InitializePortsFromChildren" | "CreateNetsFromProps" | "AssignFallbackProps" | "CreateTracesFromProps" | "CreateTracesFromNetLabels" | "CreateTraceHintsFromProps" | "SourceGroupRender" | "AssignNameToUnnamedComponents" | "SourceRender" | "SourceComponentPropertyValidation" | "SourceParentAttachment" | "PortMatching" | "OptimizeSelectorCache" | "SourceTraceRender" | "SourceAddConnectivityMapKey" | "SourceDesignRuleChecks" | "SimulationRender" | "SchematicComponentRender" | "SchematicPortRender" | "SymbolContainerRender" | "SchematicPrimitiveRender" | "SchematicSymbolResize" | "SchematicComponentSizeCalculation" | "SchematicLayout" | "SchematicTraceRender" | "SchematicReplaceNetLabelsWithSymbols" | "PanelBoardLayout" | "ValidatePcbCoordinates" | "PcbComponentRender" | "PcbPrimitiveRender" | "PcbFootprintLayout" | "PcbPortRender" | "PcbPortAttachment" | "PcbComponentSizeCalculation" | "PcbComponentAnchorAlignment" | "PcbCalcPlacementResolution" | "PcbLayout" | "PcbBoardAutoSize" | "PanelLayout" | "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;
@@ -1523,6 +1523,12 @@ declare abstract class PrimitiveComponent<ZodProps extends ZodType = any> extend
      * like Symbol in the hierarchy.
      */
     getParentNormalComponent(): any | null;
+    /**
+     * Returns the nearest ancestor group that should be collapsed into a single
+     * schematic box. Schematic render phases use this to suppress internal
+     * schematic elements while still allowing direct group ports to render.
+     */
+    getCollapsedSchematicBoxAncestor(): PrimitiveComponent | null;
     /**
      * Replaces text like {NAME}, {REF}, and {REFERENCE} with the
      * reference designator (name) of the parent NormalComponent.
@@ -1888,6 +1894,7 @@ declare class NormalComponent<ZodProps extends z.ZodType = any, PortNames extend
     _inferredInternallyConnectedPinNames: string[][];
     pcb_missing_footprint_error_id?: string;
     _hasStartedFootprintUrlLoad: boolean;
+    _hasStartedSupplierFootprintMismatchWarningCheck: boolean;
     private _invalidFootprintPropMessages;
     private _invalidPinLabelMessages;
     /**
@@ -2023,6 +2030,8 @@ declare class NormalComponent<ZodProps extends z.ZodType = any, PortNames extend
     protected _getSupplierPartNumbers(partsEngine: any, source_component: any, footprinterString: string | undefined): Promise<any>;
     doInitialPartsEngineRender(): void;
     updatePartsEngineRender(): void;
+    doInitialSupplierFootprintMismatchWarning(): void;
+    updateSupplierFootprintMismatchWarning(): void;
     doInitialAssignFallbackProps(): void;
     doInitialCreateTracesFromProps(): void;
     _createTracesFromConnectionsProp(): void;
@@ -2088,6 +2097,11 @@ declare class Group<Props extends z.ZodType<any, any, any> = typeof groupProps>
         zodProps: Props;
         componentName: string;
     };
+    private _ensureSchematicBoxPortsFromConnections;
+    doInitialInitializePortsFromChildren(): void;
+    updateInitializePortsFromChildren(): void;
+    _getPrimaryPinCount(): number;
+    _getPinLabelsFromPorts(): Record<string, string>;
     doInitialSourceGroupRender(): void;
     doInitialSourceRender(): void;
     doInitialSourceParentAttachment(): void;

package/dist/index.js

@@ -105,7 +105,7 @@ import {
   point3 as point32,
   rotation as rotation2,
   schematic_manual_edit_conflict_warning,
-  unknown_error_finding_part
+  unknown_error_finding_part as unknown_error_finding_part2
 } from "circuit-json";
 import Debug5 from "debug";
 
@@ -353,6 +353,7 @@ var orderedRenderPhases = [
   "SilkscreenOverlapAdjustment",
   "CadModelRender",
   "PartsEngineRender",
+  "SupplierFootprintMismatchWarning",
   "SimulationSpiceEngineRender"
 ];
 var renderPhaseIndexMap = new Map(
@@ -399,6 +400,11 @@ var asyncPhaseDependencies = {
   ],
   CadModelRender: ["PcbFootprintStringRender", "FetchPartFootprint"],
   PartsEngineRender: ["PcbFootprintStringRender", "FetchPartFootprint"],
+  SupplierFootprintMismatchWarning: [
+    "PcbFootprintStringRender",
+    "FetchPartFootprint",
+    "PartsEngineRender"
+  ],
   PcbComponentAnchorAlignment: [
     "PcbFootprintStringRender",
     "FetchPartFootprint"
@@ -1581,6 +1587,21 @@ var PrimitiveComponent2 = class extends Renderable {
     }
     return null;
   }
+  /**
+   * Returns the nearest ancestor group that should be collapsed into a single
+   * schematic box. Schematic render phases use this to suppress internal
+   * schematic elements while still allowing direct group ports to render.
+   */
+  getCollapsedSchematicBoxAncestor() {
+    let current = this.parent;
+    while (current) {
+      if (current.componentName === "Group" && current._parsedProps?.showAsSchematicBox) {
+        return current;
+      }
+      current = current.parent;
+    }
+    return null;
+  }
   /**
    * Replaces text like {NAME}, {REF}, and {REFERENCE} with the
    * reference designator (name) of the parent NormalComponent.
@@ -2724,8 +2745,8 @@ var getObstaclesFromCircuitJson = (soup, connMap) => {
           height: element.height,
           rotation: element.ccw_rotation
         };
-        const singleRect = getAxisAlignedRectFromRotatedRect(rotatedRect);
-        const rect = singleRect ?? rotatedRect;
+        const axisAlignedRect = getAxisAlignedRectFromRotatedRect(rotatedRect);
+        const rect = axisAlignedRect ?? rotatedRect;
         obstacles.push({
           type: "rect",
           layers: [element.layer],
@@ -3556,6 +3577,7 @@ var Trace_doInitialSchematicTraceRender = (trace) => {
   if (trace.root?._featureMspSchematicTraceRouting) return;
   if (trace._couldNotFindPort) return;
   if (trace.root?.schematicDisabled) return;
+  if (trace.getCollapsedSchematicBoxAncestor()) return;
   const { db } = trace.root;
   const { _parsedProps: props, parent } = trace;
   if (!parent) throw new Error("Trace has no parent");
@@ -8989,9 +9011,9 @@ var Port = class extends PrimitiveComponent2 {
       return false;
     }
     const parentBoxDim = parentNormalComponent?._getSchematicBoxDimensions();
-    if (parentBoxDim && this.props.pinNumber !== void 0) {
+    if (parentBoxDim && this._parsedProps.pinNumber !== void 0) {
       const localPortPosition = parentBoxDim.getPortPositionByPinNumber(
-        this.props.pinNumber
+        this._parsedProps.pinNumber
       );
       if (localPortPosition) return true;
     }
@@ -9023,9 +9045,9 @@ var Port = class extends PrimitiveComponent2 {
       return applyToPoint16(transform, schematicSymbolPortDef);
     }
     const parentBoxDim = parentNormalComponent?._getSchematicBoxDimensions();
-    if (parentBoxDim && this.props.pinNumber !== void 0) {
+    if (parentBoxDim && this._parsedProps.pinNumber !== void 0) {
       const localPortPosition = parentBoxDim.getPortPositionByPinNumber(
-        this.props.pinNumber
+        this._parsedProps.pinNumber
       );
       if (!localPortPosition) {
         throw new Error(
@@ -9328,6 +9350,8 @@ var Port = class extends PrimitiveComponent2 {
     return void 0;
   }
   doInitialSchematicPortRender() {
+    const collapsedAncestor = this.getCollapsedSchematicBoxAncestor();
+    if (collapsedAncestor && this.parent !== collapsedAncestor) return;
     const { db } = this.root;
     const { _parsedProps: props } = this;
     const { schX, schY } = props;
@@ -10786,6 +10810,133 @@ var shouldCheckPortForMissingTrace = (component, port) => {
   return true;
 };
 
+// lib/components/base-components/NormalComponent/NormalComponent_doInitialSupplierFootprintMismatchWarning.ts
+import { getBoundsOfPcbElements } from "@tscircuit/circuit-json-util";
+import {
+  supplierProps
+} from "@tscircuit/props";
+import {
+  supplier_footprint_mismatch_warning,
+  unknown_error_finding_part
+} from "circuit-json";
+var SUPPLIER_FOOTPRINT_IOU_WARNING_THRESHOLD = 0.8;
+var supplierNames = supplierProps.shape.supplierPartNumbers.unwrap().keySchema.options;
+var isCopperElement = (elm) => elm.type === "pcb_smtpad" || elm.type === "pcb_plated_hole";
+var isValidBounds = (bounds) => Number.isFinite(bounds.minX) && Number.isFinite(bounds.minY) && Number.isFinite(bounds.maxX) && Number.isFinite(bounds.maxY) && bounds.maxX > bounds.minX && bounds.maxY > bounds.minY;
+var getCopperBounds = (elements) => {
+  const copperElements = elements.filter(isCopperElement);
+  if (copperElements.length === 0) return null;
+  const bounds = getBoundsOfPcbElements(copperElements);
+  if (!isValidBounds(bounds)) return null;
+  return bounds;
+};
+var getBoundsSize = (bounds) => ({
+  width: bounds.maxX - bounds.minX,
+  height: bounds.maxY - bounds.minY
+});
+var getCenteredBoundsIou = (boundsA, boundsB, opts) => {
+  const sizeA = getBoundsSize(boundsA);
+  const sizeB = getBoundsSize(boundsB);
+  const bWidth = opts?.rotateB ? sizeB.height : sizeB.width;
+  const bHeight = opts?.rotateB ? sizeB.width : sizeB.height;
+  const intersectionWidth = Math.min(sizeA.width, bWidth);
+  const intersectionHeight = Math.min(sizeA.height, bHeight);
+  const intersectionArea = intersectionWidth * intersectionHeight;
+  const unionArea = sizeA.width * sizeA.height + bWidth * bHeight - intersectionArea;
+  if (unionArea <= 0) return 0;
+  return intersectionArea / unionArea;
+};
+var getBestBoundsIou = (localBounds, supplierBounds) => Math.max(
+  getCenteredBoundsIou(localBounds, supplierBounds),
+  getCenteredBoundsIou(localBounds, supplierBounds, { rotateB: true })
+);
+var getSupplierPartCandidates = (supplierPartNumbers) => {
+  if (!supplierPartNumbers) return [];
+  const candidates = [];
+  for (const supplierName of supplierNames) {
+    const partNumbers = supplierPartNumbers[supplierName];
+    if (!Array.isArray(partNumbers)) continue;
+    for (const supplierPartNumber of partNumbers) {
+      if (!supplierPartNumber) continue;
+      candidates.push({ supplierName, supplierPartNumber });
+    }
+  }
+  return candidates;
+};
+function NormalComponent_doInitialSupplierFootprintMismatchWarning(component) {
+  if (component.root?.pcbDisabled) return;
+  if (component.props.doNotPlace) return;
+  if (component.props.footprint === void 0) return;
+  if (component.getInheritedProperty("bomDisabled")) return;
+  if (component.getInheritedProperty("partsEngineDisabled")) return;
+  const partsEngine = component.getInheritedProperty("partsEngine");
+  if (!partsEngine?.fetchPartCircuitJson) return;
+  const { db } = component.root;
+  const sourceComponent = db.source_component.get(
+    component.source_component_id
+  );
+  if (!sourceComponent?.supplier_part_numbers) return;
+  if (!component.pcb_component_id) return;
+  if (component._hasStartedSupplierFootprintMismatchWarningCheck) return;
+  const supplierPartCandidates = getSupplierPartCandidates(
+    sourceComponent.supplier_part_numbers
+  );
+  if (supplierPartCandidates.length === 0) return;
+  const localCopperElements = [
+    ...db.pcb_smtpad.list({ pcb_component_id: component.pcb_component_id }),
+    ...db.pcb_plated_hole.list({
+      pcb_component_id: component.pcb_component_id
+    })
+  ];
+  const localBounds = getCopperBounds(localCopperElements);
+  if (!localBounds) return;
+  component._hasStartedSupplierFootprintMismatchWarningCheck = true;
+  component._queueAsyncEffect("check-supplier-footprint-mismatch", async () => {
+    const { db: db2 } = component.root;
+    const fetchPartCircuitJson = partsEngine.fetchPartCircuitJson;
+    for (const supplierPartCandidate of supplierPartCandidates) {
+      const { supplierName, supplierPartNumber } = supplierPartCandidate;
+      try {
+        const supplierCircuitJson = await Promise.resolve(
+          fetchPartCircuitJson({ supplierPartNumber })
+        ) ?? null;
+        if (!supplierCircuitJson?.length) continue;
+        const supplierBounds = getCopperBounds(supplierCircuitJson);
+        if (!supplierBounds) continue;
+        const footprintCopperIou = getBestBoundsIou(localBounds, supplierBounds);
+        if (footprintCopperIou >= SUPPLIER_FOOTPRINT_IOU_WARNING_THRESHOLD) {
+          return;
+        }
+        const footprintLabel = typeof component.props.footprint === "string" ? `"${component.props.footprint}"` : "the provided footprint";
+        const roundedIou = Number(footprintCopperIou.toFixed(4));
+        const warning = supplier_footprint_mismatch_warning.parse({
+          type: "supplier_footprint_mismatch_warning",
+          message: `${component.getString()} footprint ${footprintLabel} does not match supplier footprint ${supplierName}:${supplierPartNumber} (copper IoU ${roundedIou}).`,
+          source_component_id: component.source_component_id,
+          pcb_component_id: component.pcb_component_id,
+          pcb_group_id: component.getGroup()?.pcb_group_id ?? void 0,
+          subcircuit_id: component.getSubcircuit()?.subcircuit_id ?? void 0,
+          supplier_name: supplierName,
+          supplier_part_number: supplierPartNumber,
+          footprint_copper_intersection_over_union: roundedIou
+        });
+        db2.supplier_footprint_mismatch_warning.insert(warning);
+        return;
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorObj = unknown_error_finding_part.parse({
+          type: "unknown_error_finding_part",
+          message: `Failed to fetch supplier footprint for ${component.getString()} (${supplierName}:${supplierPartNumber}): ${errorMessage}`,
+          source_component_id: component.source_component_id,
+          subcircuit_id: component.getSubcircuit()?.subcircuit_id
+        });
+        db2.unknown_error_finding_part.insert(errorObj);
+        return;
+      }
+    }
+  });
+}
+
 // lib/components/base-components/NormalComponent/utils/canMergePortDefinitions.ts
 var canMergePortDefinitions = (a, b) => {
   const aPinNumber = a._parsedProps.pinNumber;
@@ -10967,6 +11118,7 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
   _inferredInternallyConnectedPinNames = [];
   pcb_missing_footprint_error_id;
   _hasStartedFootprintUrlLoad = false;
+  _hasStartedSupplierFootprintMismatchWarningCheck = false;
   _invalidFootprintPropMessages = [];
   _invalidPinLabelMessages = [];
   /**
@@ -11354,6 +11506,7 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
    */
   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) {
@@ -12026,7 +12179,9 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
   }
   _getSchematicBoxDimensions() {
     if (this.getSchematicSymbol()) return null;
-    if (!this.config.shouldRenderAsSchematicBox) return null;
+    if (!this.config.shouldRenderAsSchematicBox && !this._parsedProps?.showAsSchematicBox) {
+      return null;
+    }
     const { _parsedProps: props } = this;
     const pinCount = this._getPrimaryPinCount();
     const pinSpacing = props.schPinSpacing ?? 0.2;
@@ -12221,7 +12376,7 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
         this._markDirty("PartsEngineRender");
       }).catch((error) => {
         this._asyncSupplierPartNumbers = {};
-        const errorObj = unknown_error_finding_part.parse({
+        const errorObj = unknown_error_finding_part2.parse({
           type: "unknown_error_finding_part",
           message: `Failed to fetch supplier part numbers for ${this.getString()}: ${error.message}`,
           source_component_id: this.source_component_id,
@@ -12247,6 +12402,12 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
       return;
     }
   }
+  doInitialSupplierFootprintMismatchWarning() {
+    NormalComponent_doInitialSupplierFootprintMismatchWarning(this);
+  }
+  updateSupplierFootprintMismatchWarning() {
+    this.doInitialSupplierFootprintMismatchWarning();
+  }
   doInitialAssignFallbackProps() {
     const { _parsedProps: props } = this;
     if (props.connections && !this.name) {
@@ -14268,7 +14429,7 @@ var TraceHint = class extends PrimitiveComponent2 {
 };
 
 // lib/components/primitive-components/Group/Group_doInitialPcbCalcPlacementResolution.ts
-import { getBoundsOfPcbElements } from "@tscircuit/circuit-json-util";
+import { getBoundsOfPcbElements as getBoundsOfPcbElements2 } from "@tscircuit/circuit-json-util";
 var SUPPORTED_COMPONENT_FIELDS = /* @__PURE__ */ new Set([
   "x",
   "y",
@@ -14555,7 +14716,7 @@ function updateVarsForNamedComponent(component, vars) {
   });
   const padElementsByReference = collectPadElementsByReference(component);
   for (const [referencePath, elements] of padElementsByReference.entries()) {
-    const bounds = getBoundsOfPcbElements(elements);
+    const bounds = getBoundsOfPcbElements2(elements);
     const minX = bounds.minX;
     const maxX = bounds.maxX;
     const minY = bounds.minY;
@@ -16148,6 +16309,15 @@ function isTreeChildExplicitlyPositioned(treeChild, group) {
   }
   return false;
 }
+function getTreeChildChipId(child, index) {
+  if (child.nodeType === "component" && child.sourceComponent) {
+    return child.sourceComponent.name || `chip_${index}`;
+  }
+  if (child.nodeType === "group" && child.sourceGroup) {
+    return child.sourceGroup.name || `group_${index}`;
+  }
+  return null;
+}
 function convertTreeToInputProblem(tree, db, group) {
   const problem = {
     chipMap: {},
@@ -16178,7 +16348,7 @@ function convertTreeToInputProblem(tree, db, group) {
       debug6(`[${group.name}] - Group: ${child.sourceGroup?.name}`);
     }
     if (child.nodeType === "component" && child.sourceComponent) {
-      const chipId = child.sourceComponent.name || `chip_${index}`;
+      const chipId = getTreeChildChipId(child, index);
       const schematicComponent = db.schematic_component.getWhere({
         source_component_id: child.sourceComponent.source_component_id
       });
@@ -16240,7 +16410,7 @@ function convertTreeToInputProblem(tree, db, group) {
         };
       }
     } else if (child.nodeType === "group" && child.sourceGroup) {
-      const groupId = child.sourceGroup.name || `group_${index}`;
+      const groupId = getTreeChildChipId(child, index);
       debug6(`[${group.name}] Processing nested group: ${groupId}`);
       const schematicGroup = db.schematic_group?.getWhere?.({
         source_group_id: child.sourceGroup.source_group_id
@@ -16336,14 +16506,7 @@ function convertTreeToInputProblem(tree, db, group) {
     for (const pinId of chip.pins) {
       const pinNumber = pinId.split(".").pop();
       const treeNode = tree.childNodes.find((child) => {
-        if (child.nodeType === "component" && child.sourceComponent) {
-          return child.sourceComponent.name === chipId;
-        }
-        if (child.nodeType === "group" && child.sourceGroup) {
-          const expectedChipId = `group_${tree.childNodes.indexOf(child)}`;
-          return expectedChipId === chipId;
-        }
-        return false;
+        return getTreeChildChipId(child, tree.childNodes.indexOf(child)) === chipId;
       });
       if (treeNode?.nodeType === "group" && treeNode.sourceGroup) {
         const schematicGroup = db.schematic_group?.getWhere?.({
@@ -16428,14 +16591,10 @@ function convertTreeToInputProblem(tree, db, group) {
                 if (sourcePort && String(sourcePort.pin_number || sourcePort.name) === String(pinNumber)) {
                   const chipId = pinId.split(".")[0];
                   const treeNode = tree.childNodes.find((child) => {
-                    if (child.nodeType === "component" && child.sourceComponent) {
-                      return child.sourceComponent.name === chipId;
-                    }
-                    if (child.nodeType === "group" && child.sourceGroup) {
-                      const expectedChipId = `group_${tree.childNodes.indexOf(child)}`;
-                      return expectedChipId === chipId;
-                    }
-                    return false;
+                    return getTreeChildChipId(
+                      child,
+                      tree.childNodes.indexOf(child)
+                    ) === chipId;
                   });
                   if (treeNode?.nodeType === "component" && treeNode.sourceComponent) {
                     const portBelongsToComponent = db.source_port.list({
@@ -16556,23 +16715,13 @@ function Group_doInitialSchematicLayoutMatchPack(group) {
       `Processing placement for chip: ${chipId} at (${placement.x}, ${placement.y})`
     );
     const treeNode = tree.childNodes.find((child) => {
-      if (child.nodeType === "component" && child.sourceComponent) {
-        const matches = child.sourceComponent.name === chipId;
-        debug6(
-          `  Checking component ${child.sourceComponent.name}: matches=${matches}`
-        );
-        return matches;
-      }
-      if (child.nodeType === "group" && child.sourceGroup) {
-        const groupName = child.sourceGroup.name;
-        const expectedChipId = `group_${tree.childNodes.indexOf(child)}`;
-        const matches = expectedChipId === chipId;
-        debug6(
-          `  Checking group ${groupName} (expected chipId: ${expectedChipId}): matches=${matches}`
-        );
-        return matches;
-      }
-      return false;
+      const expectedChipId = getTreeChildChipId(
+        child,
+        tree.childNodes.indexOf(child)
+      );
+      const matches = expectedChipId === chipId;
+      debug6(`  Checking child ${expectedChipId}: matches=${matches}`);
+      return matches;
     });
     if (!treeNode) {
       debug6(`Warning: No tree node found for chip: ${chipId}`);
@@ -16581,7 +16730,7 @@ function Group_doInitialSchematicLayoutMatchPack(group) {
         tree.childNodes.map((child, idx) => ({
           type: child.nodeType,
           name: child.nodeType === "component" ? child.sourceComponent?.name : child.sourceGroup?.name,
-          expectedChipId: child.nodeType === "group" ? `group_${idx}` : child.sourceComponent?.name
+          expectedChipId: getTreeChildChipId(child, idx)
         }))
       );
       continue;
@@ -16738,6 +16887,110 @@ function Group_doInitialSchematicLayoutMatchPack(group) {
   debug6("Matchpack layout completed successfully");
 }
 
+// lib/components/primitive-components/Group/Group_doInitialSchematicBoxComponentRender.ts
+var parsePinNumberFromPortName = (name) => {
+  if (!name) return null;
+  const match = name.match(/^pin(\d+)$/i) ?? name.match(/^(\d+)$/);
+  if (!match) return null;
+  const pinNumber = Number(match[1]);
+  return Number.isFinite(pinNumber) && pinNumber > 0 ? pinNumber : null;
+};
+var getDirectGroupPorts = (group) => {
+  return group.children.filter((child) => {
+    return child.componentName === "Port";
+  });
+};
+var normalizeGroupSchematicBoxPorts = (group) => {
+  const { db } = group.root;
+  const ports = getDirectGroupPorts(group);
+  for (const port of ports) {
+    if (port._parsedProps.pinNumber !== void 0) continue;
+    const pinNumber = parsePinNumberFromPortName(port._parsedProps.name);
+    if (pinNumber === null) continue;
+    port._parsedProps.pinNumber = pinNumber;
+  }
+  const usedPinNumbers = new Set(
+    ports.map((port) => port._parsedProps.pinNumber).filter((pinNumber) => pinNumber !== void 0)
+  );
+  let nextPinNumber = 1;
+  for (const port of ports) {
+    if (port._parsedProps.pinNumber === void 0) {
+      while (usedPinNumbers.has(nextPinNumber)) nextPinNumber++;
+      port._parsedProps.pinNumber = nextPinNumber;
+      usedPinNumbers.add(nextPinNumber);
+    }
+    if (port.source_port_id) {
+      db.source_port.update(port.source_port_id, {
+        pin_number: port._parsedProps.pinNumber,
+        port_hints: port.getNameAndAliases()
+      });
+    }
+  }
+};
+var getGroupSchematicBoxPinLabels = (group) => {
+  const pinLabels = {};
+  for (const port of getDirectGroupPorts(group)) {
+    const pinNumber = port._parsedProps.pinNumber;
+    const name = port._parsedProps.name;
+    if (pinNumber === void 0 || !name) continue;
+    if (name === `pin${pinNumber}` || name === String(pinNumber)) continue;
+    pinLabels[`pin${pinNumber}`] = name;
+  }
+  return pinLabels;
+};
+var Group_doInitialSchematicBoxComponentRender = (group) => {
+  if (group.root?.schematicDisabled) return;
+  const { db } = group.root;
+  const props = group._parsedProps;
+  normalizeGroupSchematicBoxPorts(group);
+  const dimensions = group._getSchematicBoxDimensions();
+  if (!dimensions) return;
+  const center = group._getGlobalSchematicPositionBeforeLayout();
+  const size = dimensions.getSize();
+  const portLabels = group._getPinLabelsFromPorts();
+  const schPortArrangement = group._getSchematicPortArrangement();
+  const schematicComponent = db.schematic_component.insert({
+    center,
+    size,
+    source_group_id: group.source_group_id,
+    schematic_group_id: group.schematic_group_id ?? void 0,
+    subcircuit_id: group.subcircuit_id ?? group.getSubcircuit()?.subcircuit_id ?? void 0,
+    is_schematic_group: true,
+    is_box_with_pins: true,
+    port_arrangement: underscorifyPortArrangement(schPortArrangement),
+    pin_spacing: props.schPinSpacing ?? 0.2,
+    pin_styles: underscorifyPinStyles(
+      props.schPinStyle,
+      portLabels
+    ),
+    port_labels: portLabels
+  });
+  group.schematic_component_id = schematicComponent.schematic_component_id;
+  if (group.schematic_group_id) {
+    db.schematic_group.update(group.schematic_group_id, {
+      center,
+      width: size.width,
+      height: size.height,
+      schematic_component_ids: [schematicComponent.schematic_component_id]
+    });
+  }
+  const title = props.schTitle ?? props.name;
+  if (title) {
+    db.schematic_text.insert({
+      text: title,
+      schematic_component_id: schematicComponent.schematic_component_id,
+      anchor: "left",
+      rotation: 0,
+      position: {
+        x: center.x - size.width / 2,
+        y: center.y + size.height / 2 + 0.13
+      },
+      color: "#006464",
+      font_size: 0.18
+    });
+  }
+};
+
 // lib/components/primitive-components/Group/Group_doInitialSchematicTraceRender/Group_doInitialSchematicTraceRender.ts
 import { SchematicTracePipelineSolver as SchematicTracePipelineSolver4 } from "@tscircuit/schematic-trace-solver";
 import Debug11 from "debug";
@@ -18425,6 +18678,48 @@ var Group6 = class extends NormalComponent3 {
       componentName: "Group"
     };
   }
+  _ensureSchematicBoxPortsFromConnections() {
+    if (!this._parsedProps?.showAsSchematicBox) return;
+    if (!this._parsedProps?.connections) return;
+    for (const [pinName, target] of Object.entries(
+      this._parsedProps.connections
+    )) {
+      const existingPort = this.children.find(
+        (child) => child.componentName === "Port" && child.isMatchingAnyOf([pinName])
+      );
+      if (existingPort) continue;
+      const pinNumberMatch = pinName.match(/^pin(\d+)$/i) ?? pinName.match(/^(\d+)$/);
+      const pinNumber = pinNumberMatch ? Number(pinNumberMatch[1]) : void 0;
+      this.add(
+        new Port({
+          name: pinName,
+          pinNumber,
+          connectsTo: target
+        })
+      );
+    }
+  }
+  doInitialInitializePortsFromChildren() {
+    super.doInitialInitializePortsFromChildren();
+    this._ensureSchematicBoxPortsFromConnections();
+  }
+  updateInitializePortsFromChildren() {
+    super.updateInitializePortsFromChildren();
+    this._ensureSchematicBoxPortsFromConnections();
+  }
+  _getPrimaryPinCount() {
+    const superPinCount = super._getPrimaryPinCount();
+    if (!this._parsedProps?.showAsSchematicBox) return superPinCount;
+    const directPortPinNumbers = this.children.filter((child) => child.componentName === "Port").map((port) => port._parsedProps.pinNumber).filter((pinNumber) => pinNumber !== void 0);
+    if (directPortPinNumbers.length === 0) return superPinCount;
+    return Math.max(superPinCount, ...directPortPinNumbers);
+  }
+  _getPinLabelsFromPorts() {
+    if (!this._parsedProps?.showAsSchematicBox) {
+      return super._getPinLabelsFromPorts();
+    }
+    return getGroupSchematicBoxPinLabels(this);
+  }
   doInitialSourceGroupRender() {
     const { db } = this.root;
     const hasExplicitName = typeof this._parsedProps.name === "string" && this._parsedProps.name.length > 0;
@@ -18931,6 +19226,7 @@ var Group6 = class extends NormalComponent3 {
     this._startAsyncAutorouting();
   }
   doInitialSchematicTraceRender() {
+    if (this._parsedProps.showAsSchematicBox) return;
     Group_doInitialSchematicTraceRender(this);
   }
   updatePcbTraceRender() {
@@ -19056,7 +19352,11 @@ var Group6 = class extends NormalComponent3 {
       show_as_schematic_box: props.showAsSchematicBox ?? false
     });
     this.schematic_group_id = schematic_group.schematic_group_id;
+    if (props.showAsSchematicBox) {
+      Group_doInitialSchematicBoxComponentRender(this);
+    }
     for (const child of this.children) {
+      if (child._parsedProps?.showAsSchematicBox) continue;
       if (child.schematic_component_id) {
         db.schematic_component.update(child.schematic_component_id, {
           schematic_group_id: schematic_group.schematic_group_id
@@ -19091,6 +19391,10 @@ var Group6 = class extends NormalComponent3 {
     return "relative";
   }
   doInitialSchematicLayout() {
+    if (this._parsedProps.showAsSchematicBox) {
+      this._insertSchematicBorder();
+      return;
+    }
     const schematicLayoutMode = this._getSchematicLayoutMode();
     if (schematicLayoutMode === "match-adapt") {
       this._doInitialSchematicLayoutMatchpack();
@@ -20074,7 +20378,7 @@ import { identity as identity5 } from "transformation-matrix";
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.1202",
+  version: "0.0.1204",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -20134,7 +20438,7 @@ var package_default = {
     "bun-match-svg": "0.0.12",
     "calculate-elbow": "^0.0.12",
     "chokidar-cli": "^3.0.0",
-    "circuit-json": "^0.0.419",
+    "circuit-json": "^0.0.421",
     "circuit-json-to-bpc": "^0.0.13",
     "circuit-json-to-connectivity-map": "^0.0.23",
     "circuit-json-to-gltf": "^0.0.96",
@@ -23228,6 +23532,7 @@ var NetLabel = class extends PrimitiveComponent2 {
   }
   doInitialSchematicPrimitiveRender() {
     if (this.root?.schematicDisabled) return;
+    if (this.getCollapsedSchematicBoxAncestor()) return;
     const { db } = this.root;
     const { _parsedProps: props } = this;
     const anchorPos = this._getGlobalSchematicPositionBeforeLayout();
@@ -23286,6 +23591,7 @@ var NetLabel = class extends PrimitiveComponent2 {
   doInitialSchematicTraceRender() {
     if (!this.root?._featureMspSchematicTraceRouting) return;
     if (this.root?.schematicDisabled) return;
+    if (this.getCollapsedSchematicBoxAncestor()) return;
     const { db } = this.root;
     const connectsTo = this._resolveConnectsTo();
     if (!connectsTo || connectsTo.length === 0) return;
@@ -23890,7 +24196,7 @@ import { guessCableInsertCenter } from "@tscircuit/infer-cable-insertion-point";
 import {
   connectorProps
 } from "@tscircuit/props";
-import { unknown_error_finding_part as unknown_error_finding_part2 } from "circuit-json";
+import { unknown_error_finding_part as unknown_error_finding_part3 } from "circuit-json";
 
 // lib/utils/connectors/convertCircuitJsonToUsbCStandardCircuitJson.ts
 var STANDARD_USB_C_PIN_LABELS = [
@@ -24137,7 +24443,7 @@ var Connector = class extends Chip {
   }
   _insertStandardConnectorCircuitJsonError(standard, message) {
     const { db } = this.root;
-    const errorObj = unknown_error_finding_part2.parse({
+    const errorObj = unknown_error_finding_part3.parse({
       type: "unknown_error_finding_part",
       message: `Failed to fetch circuit JSON for ${this.getString()} (standard="${standard}"): ${message}`,
       source_component_id: this.source_component_id ?? void 0,
@@ -24949,6 +25255,7 @@ var SchematicText = class extends PrimitiveComponent2 {
   }
   doInitialSchematicPrimitiveRender() {
     if (this.root?.schematicDisabled) return;
+    if (this.getCollapsedSchematicBoxAncestor()) return;
     const { db } = this.root;
     const { _parsedProps: props } = this;
     const globalPos = this._getGlobalSchematicPositionBeforeLayout();
@@ -24998,6 +25305,7 @@ var SchematicLine = class extends PrimitiveComponent2 {
   schematic_line_id;
   doInitialSchematicPrimitiveRender() {
     if (this.root?.schematicDisabled) return;
+    if (this.getCollapsedSchematicBoxAncestor()) return;
     const { db } = this.root;
     const { _parsedProps: props } = this;
     const globalPos = this._getGlobalSchematicPositionBeforeLayout();
@@ -25051,6 +25359,7 @@ var SchematicRect = class extends PrimitiveComponent2 {
   schematic_rect_id;
   doInitialSchematicPrimitiveRender() {
     if (this.root?.schematicDisabled) return;
+    if (this.getCollapsedSchematicBoxAncestor()) return;
     const { db } = this.root;
     const { _parsedProps: props } = this;
     const globalPos = this._getGlobalSchematicPositionBeforeLayout();
@@ -25119,6 +25428,7 @@ var SchematicArc = class extends PrimitiveComponent2 {
   schematic_arc_id;
   doInitialSchematicPrimitiveRender() {
     if (this.root?.schematicDisabled) return;
+    if (this.getCollapsedSchematicBoxAncestor()) return;
     const { db } = this.root;
     const { _parsedProps: props } = this;
     const globalPos = this._getGlobalSchematicPositionBeforeLayout();
@@ -25178,6 +25488,7 @@ var SchematicCircle = class extends PrimitiveComponent2 {
   schematic_circle_id;
   doInitialSchematicPrimitiveRender() {
     if (this.root?.schematicDisabled) return;
+    if (this.getCollapsedSchematicBoxAncestor()) return;
     const { db } = this.root;
     const { _parsedProps: props } = this;
     const globalPos = this._getGlobalSchematicPositionBeforeLayout();
@@ -25366,6 +25677,7 @@ var SchematicPath = class extends PrimitiveComponent2 {
   }
   doInitialSchematicPrimitiveRender() {
     if (this.root?.schematicDisabled) return;
+    if (this.getCollapsedSchematicBoxAncestor()) return;
     const { db } = this.root;
     const { _parsedProps: props } = this;
     const globalPos = this._getGlobalSchematicPositionBeforeLayout();
@@ -25517,6 +25829,7 @@ var SchematicBox = class extends PrimitiveComponent2 {
   }
   doInitialSchematicPrimitiveRender() {
     if (this.root?.schematicDisabled) return;
+    if (this.getCollapsedSchematicBoxAncestor()) return;
     const { db } = this.root;
     const { _parsedProps: props } = this;
     const basePadding = 0.6;
@@ -25638,6 +25951,7 @@ var SchematicTable = class extends PrimitiveComponent2 {
   }
   doInitialSchematicPrimitiveRender() {
     if (this.root?.schematicDisabled) return;
+    if (this.getCollapsedSchematicBoxAncestor()) return;
     const { db } = this.root;
     const { _parsedProps: props } = this;
     const rows = this.children.filter(

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tscircuit/core",
   "type": "module",
-  "version": "0.0.1203",
+  "version": "0.0.1205",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -61,7 +61,7 @@
     "bun-match-svg": "0.0.12",
     "calculate-elbow": "^0.0.12",
     "chokidar-cli": "^3.0.0",
-    "circuit-json": "^0.0.419",
+    "circuit-json": "^0.0.421",
     "circuit-json-to-bpc": "^0.0.13",
     "circuit-json-to-connectivity-map": "^0.0.23",
     "circuit-json-to-gltf": "^0.0.96",