@tscircuit/core 0.0.402 → 0.0.404

package/dist/index.js

@@ -292,253 +292,7 @@ var extendCatalogue = (objects) => {
 };
 
 // lib/fiber/create-instance-from-react-element.ts
-import { identity } from "transformation-matrix";
-function prepare(object, state) {
-  const instance = object;
-  instance.__tsci = {
-    ...state
-  };
-  return object;
-}
-var hostConfig = {
-  supportsMutation: true,
-  createInstance(type, props) {
-    const target = catalogue[type];
-    if (!target) {
-      if (Object.keys(catalogue).length === 0) {
-        throw new Error(
-          "No components registered in catalogue, did you forget to import lib/register-catalogue in your test file?"
-        );
-      }
-      throw new Error(
-        `Unsupported component type (not registered in @tscircuit/core catalogue): "${type}" See CREATING_NEW_COMPONENTS.md`
-      );
-    }
-    const instance = prepare(new target(props), {});
-    return instance;
-  },
-  createTextInstance() {
-    return {};
-  },
-  appendInitialChild(parentInstance, child) {
-    parentInstance.add(child);
-  },
-  appendChild(parentInstance, child) {
-    parentInstance.add(child);
-  },
-  appendChildToContainer(container, child) {
-    container.add(child);
-  },
-  finalizeInitialChildren() {
-    return false;
-  },
-  prepareUpdate() {
-    return null;
-  },
-  shouldSetTextContent() {
-    return false;
-  },
-  getRootHostContext() {
-    return {};
-  },
-  getChildHostContext() {
-    return {};
-  },
-  prepareForCommit() {
-    return null;
-  },
-  resetAfterCommit() {
-  },
-  commitMount() {
-  },
-  commitUpdate() {
-  },
-  removeChild() {
-  },
-  clearContainer() {
-  },
-  supportsPersistence: false,
-  getPublicInstance(instance) {
-    return instance;
-  },
-  preparePortalMount(containerInfo) {
-    throw new Error("Function not implemented.");
-  },
-  scheduleTimeout(fn, delay) {
-    throw new Error("Function not implemented.");
-  },
-  cancelTimeout(id) {
-    throw new Error("Function not implemented.");
-  },
-  noTimeout: void 0,
-  isPrimaryRenderer: false,
-  getInstanceFromNode(node) {
-    throw new Error("Function not implemented.");
-  },
-  beforeActiveInstanceBlur() {
-    throw new Error("Function not implemented.");
-  },
-  afterActiveInstanceBlur() {
-    throw new Error("Function not implemented.");
-  },
-  prepareScopeUpdate: (scopeInstance, instance) => {
-    throw new Error("Function not implemented.");
-  },
-  getInstanceFromScope: (scopeInstance) => {
-    throw new Error("Function not implemented.");
-  },
-  detachDeletedInstance: (node) => {
-    throw new Error("Function not implemented.");
-  },
-  // https://github.com/pmndrs/react-three-fiber/pull/2360#discussion_r916356874
-  getCurrentEventPriority: () => DefaultEventPriority,
-  // @ts-expect-error
-  // https://github.com/diegomura/react-pdf/blob/fabecc56727dfb6d590a3fa1e11f50250ecbbea1/packages/reconciler/src/reconciler-31.js#L57
-  getCurrentUpdatePriority: () => DefaultEventPriority,
-  resolveUpdatePriority: () => DefaultEventPriority,
-  setCurrentUpdatePriority: () => {
-  },
-  maySuspendCommit: () => false,
-  supportsHydration: false
-};
-var reconciler;
-if (React.version.startsWith("19.")) {
-  reconciler = ReactReconciler(hostConfig);
-} else {
-  reconciler = ReactReconciler18(hostConfig);
-}
-var createInstanceFromReactElement = (reactElm) => {
-  const rootContainer = {
-    children: [],
-    props: {
-      name: "$root"
-    },
-    add(instance) {
-      instance.parent = this;
-      this.children.push(instance);
-    },
-    computePcbGlobalTransform() {
-      return identity();
-    }
-  };
-  const containerErrors = [];
-  const container = reconciler.createContainer(
-    // TODO Replace with store like react-three-fiber
-    // https://github.com/pmndrs/react-three-fiber/blob/a457290856f57741bf8beef4f6ff9dbf4879c0a5/packages/fiber/src/core/index.tsx#L172
-    // https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/store.ts#L168
-    rootContainer,
-    0,
-    null,
-    false,
-    null,
-    "tsci",
-    (error) => {
-      console.log("Error in createContainer");
-      console.error(error);
-      containerErrors.push(error);
-    },
-    null
-  );
-  if (React.version.startsWith("19.")) {
-    reconciler.updateContainerSync(reactElm, container, null, () => {
-    });
-    reconciler.flushSyncWork();
-  } else {
-    reconciler.updateContainer(reactElm, container, null, () => {
-    });
-  }
-  if (containerErrors.length > 0) {
-    throw containerErrors[0];
-  }
-  const rootInstance = reconciler.getPublicRootInstance(
-    container
-  );
-  if (rootInstance) return rootInstance;
-  return rootContainer.children[0];
-};
-
-// lib/soup/underscorifyPinStyles.ts
-import "circuit-json";
-import "zod";
-
-// lib/utils/schematic/parsePinNumberFromLabelsOrThrow.ts
-var parsePinNumberFromLabelsOrThrow = (pinNumberOrLabel, pinLabels) => {
-  if (typeof pinNumberOrLabel === "number") {
-    return pinNumberOrLabel;
-  }
-  if (pinNumberOrLabel.startsWith("pin")) {
-    const pinNumber = Number(pinNumberOrLabel.slice(3));
-    return pinNumber;
-  }
-  if (!pinLabels) {
-    throw new Error(
-      `No pin labels provided and pin number or label is not a number: "${pinNumberOrLabel}"`
-    );
-  }
-  for (const pinNumberKey in pinLabels) {
-    const aliases = Array.isArray(pinLabels[pinNumberKey]) ? pinLabels[pinNumberKey] : [pinLabels[pinNumberKey]];
-    if (aliases.includes(pinNumberOrLabel)) {
-      return Number(pinNumberKey.replace("pin", ""));
-    }
-  }
-  throw new Error(
-    `No pin labels provided and pin number or label is not a number: "${pinNumberOrLabel}"`
-  );
-};
-
-// lib/soup/underscorifyPinStyles.ts
-var underscorifyPinStyles = (pinStyles, pinLabels) => {
-  if (!pinStyles) return void 0;
-  const underscorePinStyles = {};
-  const mergedStyles = {};
-  for (const [pinNameOrLabel, pinStyle] of Object.entries(pinStyles)) {
-    const pinNumber = parsePinNumberFromLabelsOrThrow(pinNameOrLabel, pinLabels);
-    mergedStyles[pinNumber] = {
-      ...mergedStyles[pinNumber],
-      ...pinStyle
-    };
-  }
-  for (const [pinNumber, pinStyle] of Object.entries(mergedStyles)) {
-    const pinKey = `pin${pinNumber}`;
-    underscorePinStyles[pinKey] = {
-      bottom_margin: pinStyle.bottomMargin,
-      left_margin: pinStyle.leftMargin,
-      right_margin: pinStyle.rightMargin,
-      top_margin: pinStyle.topMargin
-    };
-  }
-  return underscorePinStyles;
-};
-
-// lib/soup/underscorifyPortArrangement.ts
-var underscorifyPortArrangement = (portArrangement) => {
-  if (!portArrangement) return void 0;
-  if ("leftSide" in portArrangement || "rightSide" in portArrangement || "topSide" in portArrangement || "bottomSide" in portArrangement) {
-    return {
-      left_side: portArrangement.leftSide,
-      right_side: portArrangement.rightSide,
-      top_side: portArrangement.topSide,
-      bottom_side: portArrangement.bottomSide
-    };
-  }
-  if ("leftPinCount" in portArrangement || "rightPinCount" in portArrangement || "topPinCount" in portArrangement || "bottomPinCount" in portArrangement) {
-    return {
-      left_size: portArrangement.leftPinCount,
-      right_size: portArrangement.rightPinCount,
-      top_size: portArrangement.topPinCount,
-      bottom_size: portArrangement.bottomPinCount
-    };
-  }
-  if ("leftSize" in portArrangement || "rightSize" in portArrangement || "topSize" in portArrangement || "bottomSize" in portArrangement) {
-    return {
-      left_size: portArrangement.leftSize,
-      right_size: portArrangement.rightSize,
-      top_size: portArrangement.topSize,
-      bottom_size: portArrangement.bottomSize
-    };
-  }
-  return void 0;
-};
+import { identity as identity2 } from "transformation-matrix";
 
 // lib/components/base-components/PrimitiveComponent/PrimitiveComponent.ts
 import "debug";
@@ -605,11 +359,11 @@ import {
   applyToPoint,
   compose,
   flipY,
-  identity as identity2,
+  identity,
   rotate,
   translate
 } from "transformation-matrix";
-import { z as z2 } from "zod";
+import { z } from "zod";
 import { selectOne, selectAll } from "css-select";
 
 // lib/components/base-components/PrimitiveComponent/cssSelectPrimitiveComponentAdapter.ts
@@ -733,7 +487,7 @@ var PrimitiveComponent2 = class extends Renderable {
   get config() {
     return {
       componentName: "",
-      zodProps: z2.object({}).passthrough()
+      zodProps: z.object({}).passthrough()
     };
   }
   props;
@@ -843,7 +597,7 @@ var PrimitiveComponent2 = class extends Renderable {
     const manualPlacement = this.getSubcircuit()._getPcbManualPlacementForComponent(this);
     if (manualPlacement && this.props.pcbX === void 0 && this.props.pcbY === void 0) {
       return compose(
-        this.parent?._computePcbGlobalTransformBeforeLayout() ?? identity2(),
+        this.parent?._computePcbGlobalTransformBeforeLayout() ?? identity(),
         compose(
           translate(manualPlacement.x, manualPlacement.y),
           rotate((props.pcbRotation ?? 0) * Math.PI / 180)
@@ -862,7 +616,7 @@ var PrimitiveComponent2 = class extends Renderable {
             translate(-containerCenter.x, -containerCenter.y)
           );
           return compose(
-            this.parent?._computePcbGlobalTransformBeforeLayout() ?? identity2(),
+            this.parent?._computePcbGlobalTransformBeforeLayout() ?? identity(),
             flipY(),
             this.computePcbPropsTransform()
           );
@@ -870,7 +624,7 @@ var PrimitiveComponent2 = class extends Renderable {
       }
     }
     return compose(
-      this.parent?._computePcbGlobalTransformBeforeLayout() ?? identity2(),
+      this.parent?._computePcbGlobalTransformBeforeLayout() ?? identity(),
       this.computePcbPropsTransform()
     );
   }
@@ -935,7 +689,7 @@ var PrimitiveComponent2 = class extends Renderable {
     const manualPlacementTransform = this._getSchematicGlobalManualPlacementTransform(this);
     if (manualPlacementTransform) return manualPlacementTransform;
     return compose(
-      this.parent?.computeSchematicGlobalTransform?.() ?? identity2(),
+      this.parent?.computeSchematicGlobalTransform?.() ?? identity(),
       this.computeSchematicPropsTransform()
     );
   }
@@ -1044,7 +798,7 @@ var PrimitiveComponent2 = class extends Renderable {
       if (isMatchingSelector(component, position.selector) || component.props.name === position.selector) {
         if (position.relative_to === "group_center") {
           return compose(
-            this.parent?._computePcbGlobalTransformBeforeLayout() ?? identity2(),
+            this.parent?._computePcbGlobalTransformBeforeLayout() ?? identity(),
             translate(position.center.x, position.center.y)
           );
         }
@@ -1194,152 +948,447 @@ var PrimitiveComponent2 = class extends Renderable {
       this._cachedSelectAllQueries.set(selectorRaw, result);
       return result;
     }
-    const [firstpart, ...rest] = selector.split(" ");
-    const subcircuit = selectOne(firstpart, this, {
-      adapter: cssSelectPrimitiveComponentAdapterOnlySubcircuits
+    const [firstpart, ...rest] = selector.split(" ");
+    const subcircuit = selectOne(firstpart, this, {
+      adapter: cssSelectPrimitiveComponentAdapterOnlySubcircuits
+    });
+    if (!subcircuit) return [];
+    const result2 = subcircuit.selectAll(rest.join(" "));
+    this._cachedSelectAllQueries.set(selectorRaw, result2);
+    return result2;
+  }
+  _cachedSelectOneQueries = /* @__PURE__ */ new Map();
+  selectOne(selectorRaw, options) {
+    if (this._cachedSelectOneQueries.has(selectorRaw)) {
+      return this._cachedSelectOneQueries.get(selectorRaw);
+    }
+    const selector = preprocessSelector(selectorRaw);
+    if (options?.port) {
+      options.type = "port";
+    }
+    let result = null;
+    if (options?.type) {
+      const allMatching = selectAll(
+        selector,
+        this,
+        cssSelectOptionsInsideSubcircuit
+      );
+      result = allMatching.find(
+        (n) => n.lowercaseComponentName === options.type
+      );
+    }
+    result ??= selectOne(
+      selector,
+      this,
+      cssSelectOptionsInsideSubcircuit
+    );
+    if (result) {
+      this._cachedSelectOneQueries.set(selectorRaw, result);
+      return result;
+    }
+    const [firstpart, ...rest] = selector.split(" ");
+    const subcircuit = selectOne(firstpart, this, {
+      adapter: cssSelectPrimitiveComponentAdapterOnlySubcircuits
+    });
+    if (!subcircuit) return null;
+    result = subcircuit.selectOne(rest.join(" "), options);
+    this._cachedSelectOneQueries.set(selectorRaw, result);
+    return result;
+  }
+  getAvailablePcbLayers() {
+    if (this.isPcbPrimitive) {
+      const { maybeFlipLayer } = this._getPcbPrimitiveFlippedHelpers();
+      if ("layer" in this._parsedProps || this.componentName === "SmtPad") {
+        const layer = maybeFlipLayer(this._parsedProps.layer ?? "top");
+        return [layer];
+      }
+      if ("layers" in this._parsedProps) {
+        return this._parsedProps.layers;
+      }
+      if (this.componentName === "PlatedHole") {
+        return this.root?._getBoard()?.allLayers ?? ["top", "bottom"];
+      }
+      return [];
+    }
+    return [];
+  }
+  /**
+   * Returns all descendants
+   *
+   * NOTE: This crosses subcircuit boundaries, you may want to use
+   * getSelectableDescendants instead
+   */
+  getDescendants() {
+    const descendants = [];
+    for (const child of this.children) {
+      descendants.push(child);
+      descendants.push(...child.getDescendants());
+    }
+    return descendants;
+  }
+  /**
+   * Returns all descendants that are accessible without crossing a subcircuit
+   * boundary
+   */
+  getSelectableDescendants() {
+    const descendants = [];
+    for (const child of this.children) {
+      if (child.isSubcircuit) {
+        descendants.push(child);
+      } else {
+        descendants.push(child);
+        descendants.push(...child.getSelectableDescendants());
+      }
+    }
+    return descendants;
+  }
+  /**
+   * Return the number of pins in this component, this is important for
+   * NormalComponents
+   */
+  _getPinCount() {
+    return 0;
+  }
+  /**
+   * If this component represents a SchematicBox (like a Chip), return the
+   * dimensions of the box, which allows computing the position of ports etc.
+   */
+  _getSchematicBoxDimensions() {
+    return null;
+  }
+  // TODO we shouldn't need to override this, errors can be rendered and handled
+  // by the Renderable class, however, the Renderable class currently doesn't
+  // have access to the database or cleanup
+  renderError(message) {
+    if (typeof message === "string") {
+      return super.renderError(message);
+    }
+    this.root?.db.pcb_placement_error.insert(message);
+  }
+  getString() {
+    const { lowercaseComponentName: cname, _parsedProps: props, parent } = this;
+    if (props?.pinNumber !== void 0 && parent?.props?.name && props?.name) {
+      return `<${cname}#${this._renderId}(pin:${props.pinNumber} .${parent?.props.name}>.${props.name}) />`;
+    }
+    if (parent?.props?.name && props?.name) {
+      return `<${cname}#${this._renderId}(.${parent?.props.name}>.${props?.name}) />`;
+    }
+    if (props?.from && props?.to) {
+      return `<${cname}#${this._renderId}(from:${props.from} to:${props?.to}) />`;
+    }
+    if (props?.name) {
+      return `<${cname}#${this._renderId} name=".${props?.name}" />`;
+    }
+    if (props?.portHints) {
+      return `<${cname}#${this._renderId}(${props.portHints.map((ph) => `.${ph}`).join(", ")}) />`;
+    }
+    return `<${cname}#${this._renderId} />`;
+  }
+  get [Symbol.toStringTag]() {
+    return this.getString();
+  }
+  [Symbol.for("nodejs.util.inspect.custom")]() {
+    return this.getString();
+  }
+};
+
+// lib/components/primitive-components/ErrorPlaceholder.ts
+import { z as z2 } from "zod";
+var ErrorPlaceholderComponent = class extends PrimitiveComponent2 {
+  constructor(props, error) {
+    super(props);
+    this._parsedProps = {
+      ...props,
+      error,
+      type: props.type || "unknown",
+      component_name: props.name,
+      error_type: "source_failed_to_create_component_error",
+      message: error instanceof Error ? error.message : String(error),
+      pcb_center: {
+        x: props.pcbX || 0,
+        y: props.pcbY || 0
+      },
+      schematic_center: {
+        x: props.schX || 0,
+        y: props.schY || 0
+      }
+    };
+  }
+  get config() {
+    return {
+      componentName: "ErrorPlaceholder",
+      zodProps: z2.object({}).passthrough()
+    };
+  }
+  doInitialSourceRender() {
+    if (this.root?.db) {
+      this.root.db.source_failed_to_create_component_error.insert({
+        component_name: this._parsedProps.component_name,
+        message: this._parsedProps.message,
+        pcb_center: this._parsedProps.pcb_center,
+        schematic_center: this._parsedProps.schematic_center
+      });
+    }
+  }
+};
+function createErrorPlaceholderComponent(props, error) {
+  return new ErrorPlaceholderComponent(props, error);
+}
+
+// lib/fiber/create-instance-from-react-element.ts
+function prepare(object, state) {
+  const instance = object;
+  instance.__tsci = {
+    ...state
+  };
+  return object;
+}
+var hostConfig = {
+  supportsMutation: true,
+  createInstance(type, props) {
+    const target = catalogue[type];
+    if (!target) {
+      if (Object.keys(catalogue).length === 0) {
+        throw new Error(
+          "No components registered in catalogue, did you forget to import lib/register-catalogue in your test file?"
+        );
+      }
+      throw new Error(
+        `Unsupported component type (not registered in @tscircuit/core catalogue): "${type}" See CREATING_NEW_COMPONENTS.md`
+      );
+    }
+    try {
+      const instance = prepare(new target(props), {});
+      return instance;
+    } catch (error) {
+      return createErrorPlaceholderComponent(props, error);
+    }
+  },
+  createTextInstance() {
+    return {};
+  },
+  appendInitialChild(parentInstance, child) {
+    parentInstance.add(child);
+  },
+  appendChild(parentInstance, child) {
+    parentInstance.add(child);
+  },
+  appendChildToContainer(container, child) {
+    container.add(child);
+  },
+  finalizeInitialChildren() {
+    return false;
+  },
+  prepareUpdate() {
+    return null;
+  },
+  shouldSetTextContent() {
+    return false;
+  },
+  getRootHostContext() {
+    return {};
+  },
+  getChildHostContext() {
+    return {};
+  },
+  prepareForCommit() {
+    return null;
+  },
+  resetAfterCommit() {
+  },
+  commitMount() {
+  },
+  commitUpdate() {
+  },
+  removeChild() {
+  },
+  clearContainer() {
+  },
+  supportsPersistence: false,
+  getPublicInstance(instance) {
+    return instance;
+  },
+  preparePortalMount(containerInfo) {
+    throw new Error("Function not implemented.");
+  },
+  scheduleTimeout(fn, delay) {
+    throw new Error("Function not implemented.");
+  },
+  cancelTimeout(id) {
+    throw new Error("Function not implemented.");
+  },
+  noTimeout: void 0,
+  isPrimaryRenderer: false,
+  getInstanceFromNode(node) {
+    throw new Error("Function not implemented.");
+  },
+  beforeActiveInstanceBlur() {
+    throw new Error("Function not implemented.");
+  },
+  afterActiveInstanceBlur() {
+    throw new Error("Function not implemented.");
+  },
+  prepareScopeUpdate: (scopeInstance, instance) => {
+    throw new Error("Function not implemented.");
+  },
+  getInstanceFromScope: (scopeInstance) => {
+    throw new Error("Function not implemented.");
+  },
+  detachDeletedInstance: (node) => {
+    throw new Error("Function not implemented.");
+  },
+  // https://github.com/pmndrs/react-three-fiber/pull/2360#discussion_r916356874
+  getCurrentEventPriority: () => DefaultEventPriority,
+  // @ts-expect-error
+  // https://github.com/diegomura/react-pdf/blob/fabecc56727dfb6d590a3fa1e11f50250ecbbea1/packages/reconciler/src/reconciler-31.js#L57
+  getCurrentUpdatePriority: () => DefaultEventPriority,
+  resolveUpdatePriority: () => DefaultEventPriority,
+  setCurrentUpdatePriority: () => {
+  },
+  maySuspendCommit: () => false,
+  supportsHydration: false
+};
+var reconciler;
+if (React.version.startsWith("19.")) {
+  reconciler = ReactReconciler(hostConfig);
+} else {
+  reconciler = ReactReconciler18(hostConfig);
+}
+var createInstanceFromReactElement = (reactElm) => {
+  const rootContainer = {
+    children: [],
+    props: {
+      name: "$root"
+    },
+    add(instance) {
+      instance.parent = this;
+      this.children.push(instance);
+    },
+    computePcbGlobalTransform() {
+      return identity2();
+    }
+  };
+  const containerErrors = [];
+  const container = reconciler.createContainer(
+    // TODO Replace with store like react-three-fiber
+    // https://github.com/pmndrs/react-three-fiber/blob/a457290856f57741bf8beef4f6ff9dbf4879c0a5/packages/fiber/src/core/index.tsx#L172
+    // https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/store.ts#L168
+    rootContainer,
+    0,
+    null,
+    false,
+    null,
+    "tsci",
+    (error) => {
+      console.log("Error in createContainer");
+      console.error(error);
+      containerErrors.push(error);
+    },
+    null
+  );
+  if (React.version.startsWith("19.")) {
+    reconciler.updateContainerSync(reactElm, container, null, () => {
     });
-    if (!subcircuit) return [];
-    const result2 = subcircuit.selectAll(rest.join(" "));
-    this._cachedSelectAllQueries.set(selectorRaw, result2);
-    return result2;
-  }
-  _cachedSelectOneQueries = /* @__PURE__ */ new Map();
-  selectOne(selectorRaw, options) {
-    if (this._cachedSelectOneQueries.has(selectorRaw)) {
-      return this._cachedSelectOneQueries.get(selectorRaw);
-    }
-    const selector = preprocessSelector(selectorRaw);
-    if (options?.port) {
-      options.type = "port";
-    }
-    let result = null;
-    if (options?.type) {
-      const allMatching = selectAll(
-        selector,
-        this,
-        cssSelectOptionsInsideSubcircuit
-      );
-      result = allMatching.find(
-        (n) => n.lowercaseComponentName === options.type
-      );
-    }
-    result ??= selectOne(
-      selector,
-      this,
-      cssSelectOptionsInsideSubcircuit
-    );
-    if (result) {
-      this._cachedSelectOneQueries.set(selectorRaw, result);
-      return result;
-    }
-    const [firstpart, ...rest] = selector.split(" ");
-    const subcircuit = selectOne(firstpart, this, {
-      adapter: cssSelectPrimitiveComponentAdapterOnlySubcircuits
+    reconciler.flushSyncWork();
+  } else {
+    reconciler.updateContainer(reactElm, container, null, () => {
     });
-    if (!subcircuit) return null;
-    result = subcircuit.selectOne(rest.join(" "), options);
-    this._cachedSelectOneQueries.set(selectorRaw, result);
-    return result;
-  }
-  getAvailablePcbLayers() {
-    if (this.isPcbPrimitive) {
-      const { maybeFlipLayer } = this._getPcbPrimitiveFlippedHelpers();
-      if ("layer" in this._parsedProps || this.componentName === "SmtPad") {
-        const layer = maybeFlipLayer(this._parsedProps.layer ?? "top");
-        return [layer];
-      }
-      if ("layers" in this._parsedProps) {
-        return this._parsedProps.layers;
-      }
-      if (this.componentName === "PlatedHole") {
-        return this.root?._getBoard()?.allLayers ?? ["top", "bottom"];
-      }
-      return [];
-    }
-    return [];
   }
-  /**
-   * Returns all descendants
-   *
-   * NOTE: This crosses subcircuit boundaries, you may want to use
-   * getSelectableDescendants instead
-   */
-  getDescendants() {
-    const descendants = [];
-    for (const child of this.children) {
-      descendants.push(child);
-      descendants.push(...child.getDescendants());
-    }
-    return descendants;
+  if (containerErrors.length > 0) {
+    throw containerErrors[0];
   }
-  /**
-   * Returns all descendants that are accessible without crossing a subcircuit
-   * boundary
-   */
-  getSelectableDescendants() {
-    const descendants = [];
-    for (const child of this.children) {
-      if (child.isSubcircuit) {
-        descendants.push(child);
-      } else {
-        descendants.push(child);
-        descendants.push(...child.getSelectableDescendants());
-      }
-    }
-    return descendants;
+  const rootInstance = reconciler.getPublicRootInstance(
+    container
+  );
+  if (rootInstance) return rootInstance;
+  return rootContainer.children[0];
+};
+
+// lib/soup/underscorifyPinStyles.ts
+import "circuit-json";
+import "zod";
+
+// lib/utils/schematic/parsePinNumberFromLabelsOrThrow.ts
+var parsePinNumberFromLabelsOrThrow = (pinNumberOrLabel, pinLabels) => {
+  if (typeof pinNumberOrLabel === "number") {
+    return pinNumberOrLabel;
   }
-  /**
-   * Return the number of pins in this component, this is important for
-   * NormalComponents
-   */
-  _getPinCount() {
-    return 0;
+  if (pinNumberOrLabel.startsWith("pin")) {
+    const pinNumber = Number(pinNumberOrLabel.slice(3));
+    return pinNumber;
   }
-  /**
-   * If this component represents a SchematicBox (like a Chip), return the
-   * dimensions of the box, which allows computing the position of ports etc.
-   */
-  _getSchematicBoxDimensions() {
-    return null;
+  if (!pinLabels) {
+    throw new Error(
+      `No pin labels provided and pin number or label is not a number: "${pinNumberOrLabel}"`
+    );
   }
-  // TODO we shouldn't need to override this, errors can be rendered and handled
-  // by the Renderable class, however, the Renderable class currently doesn't
-  // have access to the database or cleanup
-  renderError(message) {
-    if (typeof message === "string") {
-      return super.renderError(message);
+  for (const pinNumberKey in pinLabels) {
+    const aliases = Array.isArray(pinLabels[pinNumberKey]) ? pinLabels[pinNumberKey] : [pinLabels[pinNumberKey]];
+    if (aliases.includes(pinNumberOrLabel)) {
+      return Number(pinNumberKey.replace("pin", ""));
     }
-    this.root?.db.pcb_placement_error.insert(message);
   }
-  getString() {
-    const { lowercaseComponentName: cname, _parsedProps: props, parent } = this;
-    if (props?.pinNumber !== void 0 && parent?.props?.name && props?.name) {
-      return `<${cname}#${this._renderId}(pin:${props.pinNumber} .${parent?.props.name}>.${props.name}) />`;
-    }
-    if (parent?.props?.name && props?.name) {
-      return `<${cname}#${this._renderId}(.${parent?.props.name}>.${props?.name}) />`;
-    }
-    if (props?.from && props?.to) {
-      return `<${cname}#${this._renderId}(from:${props.from} to:${props?.to}) />`;
-    }
-    if (props?.name) {
-      return `<${cname}#${this._renderId} name=".${props?.name}" />`;
-    }
-    if (props?.portHints) {
-      return `<${cname}#${this._renderId}(${props.portHints.map((ph) => `.${ph}`).join(", ")}) />`;
-    }
-    return `<${cname}#${this._renderId} />`;
+  throw new Error(
+    `No pin labels provided and pin number or label is not a number: "${pinNumberOrLabel}"`
+  );
+};
+
+// lib/soup/underscorifyPinStyles.ts
+var underscorifyPinStyles = (pinStyles, pinLabels) => {
+  if (!pinStyles) return void 0;
+  const underscorePinStyles = {};
+  const mergedStyles = {};
+  for (const [pinNameOrLabel, pinStyle] of Object.entries(pinStyles)) {
+    const pinNumber = parsePinNumberFromLabelsOrThrow(pinNameOrLabel, pinLabels);
+    mergedStyles[pinNumber] = {
+      ...mergedStyles[pinNumber],
+      ...pinStyle
+    };
   }
-  get [Symbol.toStringTag]() {
-    return this.getString();
+  for (const [pinNumber, pinStyle] of Object.entries(mergedStyles)) {
+    const pinKey = `pin${pinNumber}`;
+    underscorePinStyles[pinKey] = {
+      bottom_margin: pinStyle.bottomMargin,
+      left_margin: pinStyle.leftMargin,
+      right_margin: pinStyle.rightMargin,
+      top_margin: pinStyle.topMargin
+    };
   }
-  [Symbol.for("nodejs.util.inspect.custom")]() {
-    return this.getString();
+  return underscorePinStyles;
+};
+
+// lib/soup/underscorifyPortArrangement.ts
+var underscorifyPortArrangement = (portArrangement) => {
+  if (!portArrangement) return void 0;
+  if ("leftSide" in portArrangement || "rightSide" in portArrangement || "topSide" in portArrangement || "bottomSide" in portArrangement) {
+    return {
+      left_side: portArrangement.leftSide,
+      right_side: portArrangement.rightSide,
+      top_side: portArrangement.topSide,
+      bottom_side: portArrangement.bottomSide
+    };
+  }
+  if ("leftPinCount" in portArrangement || "rightPinCount" in portArrangement || "topPinCount" in portArrangement || "bottomPinCount" in portArrangement) {
+    return {
+      left_size: portArrangement.leftPinCount,
+      right_size: portArrangement.rightPinCount,
+      top_size: portArrangement.topPinCount,
+      bottom_size: portArrangement.bottomPinCount
+    };
   }
+  if ("leftSize" in portArrangement || "rightSize" in portArrangement || "topSize" in portArrangement || "bottomSize" in portArrangement) {
+    return {
+      left_size: portArrangement.leftSize,
+      right_size: portArrangement.rightSize,
+      top_size: portArrangement.topSize,
+      bottom_size: portArrangement.bottomSize
+    };
+  }
+  return void 0;
 };
 
 // lib/components/primitive-components/Net.ts
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 
 // lib/utils/pairs.ts
 function pairs(arr) {
@@ -1352,8 +1401,8 @@ function pairs(arr) {
 
 // lib/components/primitive-components/Net.ts
 import { autoroute } from "@tscircuit/infgrid-ijump-astar";
-var netProps = z3.object({
-  name: z3.string()
+var netProps = z4.object({
+  name: z4.string()
 });
 var Net = class extends PrimitiveComponent2 {
   source_net_id;
@@ -1826,14 +1875,14 @@ var SilkscreenPath = class extends PrimitiveComponent2 {
 };
 
 // lib/components/primitive-components/PcbTrace.ts
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 import { pcb_trace_route_point } from "circuit-json";
 import { applyToPoint as applyToPoint3 } from "transformation-matrix";
-var pcbTraceProps = z4.object({
-  route: z4.array(pcb_trace_route_point),
+var pcbTraceProps = z5.object({
+  route: z5.array(pcb_trace_route_point),
   // If this primitive PcbTrace needs to be associated with a source_trace_id
   // it can be added as a prop here. For footprints, it's often not needed.
-  source_trace_id: z4.string().optional()
+  source_trace_id: z5.string().optional()
 });
 var PcbTrace = class extends PrimitiveComponent2 {
   pcb_trace_id = null;
@@ -2403,7 +2452,7 @@ function getRelativeDirection(pointA, pointB) {
 // lib/components/primitive-components/Port/Port.ts
 import "schematic-symbols";
 import { applyToPoint as applyToPoint4, compose as compose3, translate as translate3 } from "transformation-matrix";
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 
 // lib/components/primitive-components/Port/areAllPcbPrimitivesOverlapping.ts
 var areAllPcbPrimitivesOverlapping = (pcbPrimitives) => {
@@ -2453,10 +2502,10 @@ var getCenterOfPcbPrimitives = (pcbPrimitives) => {
 };
 
 // lib/components/primitive-components/Port/Port.ts
-var portProps = z5.object({
-  name: z5.string().optional(),
-  pinNumber: z5.number().optional(),
-  aliases: z5.array(z5.string()).optional()
+var portProps = z6.object({
+  name: z6.string().optional(),
+  pinNumber: z6.number().optional(),
+  aliases: z6.array(z6.string()).optional()
 });
 var Port = class extends PrimitiveComponent2 {
   source_port_id = null;
@@ -3104,7 +3153,7 @@ import {
   isValidElement
 } from "react";
 import { symbols as symbols2 } from "schematic-symbols";
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 
 // lib/components/primitive-components/Footprint.ts
 import { footprintProps } from "@tscircuit/props";
@@ -4927,7 +4976,7 @@ searched component ${targetComponent.getString()}, which has ports: ${targetComp
 
 // lib/components/base-components/NormalComponent/NormalComponent.ts
 var debug3 = Debug4("tscircuit:core");
-var rotation3 = z7.object({
+var rotation3 = z8.object({
   x: rotation,
   y: rotation,
   z: rotation
@@ -7195,12 +7244,25 @@ var Jumper = class extends NormalComponent {
       pcb_component_id: this.pcb_component_id
     });
     const pinLabelToPortId = {};
-    for (const port of pcb_ports) {
-      const match = port.source_port_id && port.source_port_id.match(/(\d+)$/);
-      if (match) {
-        const label = (parseInt(match[1], 10) + 1).toString();
-        pinLabelToPortId[label] = port.pcb_port_id;
+    for (let i = 0; i < pcb_ports.length; i++) {
+      const port = pcb_ports[i];
+      const sourcePort = db.source_port.get(port.source_port_id);
+      let pinLabel = "";
+      if (typeof sourcePort?.pin_number === "number") {
+        pinLabel = sourcePort.pin_number.toString();
+      } else if (Array.isArray(sourcePort?.port_hints)) {
+        let matchedHint = sourcePort.port_hints.find(
+          (h) => /^(pin)?\d+$/.test(h)
+        );
+        if (matchedHint) {
+          if (/^pin\d+$/.test(matchedHint)) {
+            pinLabel = matchedHint.replace(/^pin/, "");
+          } else {
+            pinLabel = matchedHint;
+          }
+        }
       }
+      pinLabelToPortId[pinLabel] = port.pcb_port_id;
     }
     const traces = db.pcb_trace.list();
     const updatePortId = (portId) => {
@@ -8174,7 +8236,7 @@ import { identity as identity4 } from "transformation-matrix";
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.401",
+  version: "0.0.403",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -8197,7 +8259,7 @@ var package_default = {
   },
   devDependencies: {
     "@biomejs/biome": "^1.8.3",
-    "@tscircuit/footprinter": "^0.0.156",
+    "@tscircuit/footprinter": "^0.0.159",
     "@tscircuit/import-snippet": "^0.0.4",
     "@tscircuit/layout": "^0.0.28",
     "@tscircuit/log-soup": "^1.0.2",