@tscircuit/core 0.0.1022 → 0.0.1024

package/dist/index.js

@@ -41,6 +41,7 @@ __export(components_exports, {
   Keepout: () => Keepout,
   Led: () => Led,
   Mosfet: () => Mosfet,
+  MountedBoard: () => MountedBoard,
   Net: () => Net,
   NetLabel: () => NetLabel,
   NormalComponent: () => NormalComponent3,
@@ -116,6 +117,7 @@ import { DefaultEventPriority } from "react-reconciler/constants.js";
 import Debug from "debug";
 var debug = Debug("tscircuit:renderable");
 var orderedRenderPhases = [
+  "RenderIsolatedSubcircuits",
   "ReactSubtreesRender",
   "InflateSubcircuitCircuitJson",
   "SourceNameDuplicateComponentRemoval",
@@ -171,6 +173,7 @@ var renderPhaseIndexMap = new Map(
   orderedRenderPhases.map((phase, index) => [phase, index])
 );
 var asyncPhaseDependencies = {
+  InflateSubcircuitCircuitJson: ["RenderIsolatedSubcircuits"],
   PcbFootprintLayout: ["PcbFootprintStringRender"],
   PcbComponentSizeCalculation: ["PcbFootprintStringRender"],
   PcbLayout: ["PcbFootprintStringRender"],
@@ -950,7 +953,7 @@ var PrimitiveComponent2 = class extends Renderable {
    * components share the same names) unless you explicitly break out some ports
    */
   get isSubcircuit() {
-    return Boolean(this.props.subcircuit) || this.lowercaseComponentName === "group" && this?.parent?.isRoot;
+    return Boolean(this.props.subcircuit) || this.lowercaseComponentName === "group" && this?.parent?.isRootCircuit;
   }
   get isGroup() {
     return this.lowercaseComponentName === "group";
@@ -10282,7 +10285,7 @@ var TscircuitAutorouter = class {
 import {
   distance as distance8
 } from "circuit-json";
-import Debug13 from "debug";
+import Debug14 from "debug";
 import "zod";
 
 // lib/components/primitive-components/TraceHint.ts
@@ -14648,76 +14651,490 @@ function addPortIdsToTracesAtJumperPads(segments, db) {
   return result;
 }
 
-// lib/components/primitive-components/Group/Group.ts
-var Group6 = class extends NormalComponent3 {
-  pcb_group_id = null;
-  schematic_group_id = null;
-  subcircuit_id = null;
-  _hasStartedAsyncAutorouting = false;
-  _isInflatedFromCircuitJson = false;
-  _normalComponentNameMap = null;
+// lib/IsolatedCircuit.ts
+import { su as su5 } from "@tscircuit/circuit-json-util";
+import Debug13 from "debug";
+import { isValidElement as isValidElement2 } from "react";
+import { identity as identity4 } from "transformation-matrix";
+
+// package.json
+var package_default = {
+  name: "@tscircuit/core",
+  type: "module",
+  version: "0.0.1023",
+  types: "dist/index.d.ts",
+  main: "dist/index.js",
+  module: "dist/index.js",
+  exports: {
+    ".": {
+      import: "./dist/index.js",
+      types: "./dist/index.d.ts"
+    }
+  },
+  files: [
+    "dist"
+  ],
+  repository: {
+    type: "git",
+    url: "https://github.com/tscircuit/core"
+  },
+  scripts: {
+    build: "tsup-node index.ts --format esm --dts",
+    format: "biome format . --write",
+    "measure-bundle": "howfat -r table .",
+    "pkg-pr-new-release": "bunx pkg-pr-new publish --comment=off --peerDeps",
+    "smoke-test:dist": "bun run scripts/smoke-tests/test-dist-simple-circuit.tsx",
+    "build:benchmarking": "bun build --experimental-html ./benchmarking/website/index.html --outdir ./benchmarking-dist",
+    "build:benchmarking:watch": `chokidar "./{benchmarking,lib}/**/*.{ts,tsx}" -c 'bun build --experimental-html ./benchmarking/website/index.html --outdir ./benchmarking-dist'`,
+    "start:benchmarking": 'concurrently "bun run build:benchmarking:watch" "live-server ./benchmarking-dist"',
+    "generate-test-plan": "bun run scripts/generate-test-plan.ts"
+  },
+  devDependencies: {
+    "@biomejs/biome": "^1.8.3",
+    "@resvg/resvg-js": "^2.6.2",
+    "@tscircuit/alphabet": "0.0.18",
+    "@tscircuit/capacity-autorouter": "^0.0.264",
+    "@tscircuit/checks": "^0.0.88",
+    "@tscircuit/circuit-json-util": "^0.0.77",
+    "@tscircuit/common": "^0.0.20",
+    "@tscircuit/copper-pour-solver": "^0.0.20",
+    "@tscircuit/footprinter": "^0.0.288",
+    "@tscircuit/infgrid-ijump-astar": "^0.0.35",
+    "@tscircuit/log-soup": "^1.0.2",
+    "@tscircuit/matchpack": "^0.0.16",
+    "@tscircuit/math-utils": "^0.0.29",
+    "@tscircuit/miniflex": "^0.0.4",
+    "@tscircuit/ngspice-spice-engine": "^0.0.8",
+    "@tscircuit/props": "^0.0.471",
+    "@tscircuit/schematic-match-adapt": "^0.0.16",
+    "@tscircuit/schematic-trace-solver": "^v0.0.45",
+    "@tscircuit/solver-utils": "^0.0.3",
+    "@tscircuit/soup-util": "^0.0.41",
+    "@types/bun": "^1.2.16",
+    "@types/debug": "^4.1.12",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "@types/react-reconciler": "^0.28.9",
+    "bpc-graph": "^0.0.57",
+    "bun-match-svg": "0.0.12",
+    "calculate-elbow": "^0.0.12",
+    "chokidar-cli": "^3.0.0",
+    "circuit-json": "^0.0.378",
+    "circuit-json-to-bpc": "^0.0.13",
+    "circuit-json-to-connectivity-map": "^0.0.23",
+    "circuit-json-to-gltf": "^0.0.62",
+    "circuit-json-to-simple-3d": "^0.0.9",
+    "circuit-json-to-spice": "^0.0.33",
+    "circuit-to-svg": "^0.0.327",
+    concurrently: "^9.1.2",
+    "connectivity-map": "^1.0.0",
+    debug: "^4.3.6",
+    "eecircuit-engine": "^1.5.6",
+    flatbush: "^4.5.0",
+    "graphics-debug": "^0.0.60",
+    howfat: "^0.3.8",
+    "live-server": "^1.2.2",
+    "looks-same": "^9.0.1",
+    minicssgrid: "^0.0.9",
+    "pkg-pr-new": "^0.0.37",
+    poppygl: "^0.0.16",
+    react: "^19.1.0",
+    "react-dom": "^19.1.0",
+    "schematic-symbols": "^0.0.208",
+    spicey: "^0.0.14",
+    "ts-expect": "^1.3.0",
+    tsup: "^8.2.4"
+  },
+  peerDependencies: {
+    "@tscircuit/capacity-autorouter": "*",
+    "@tscircuit/checks": "*",
+    "@tscircuit/circuit-json-util": "*",
+    "@tscircuit/footprinter": "*",
+    "@tscircuit/infgrid-ijump-astar": "*",
+    "@tscircuit/math-utils": "*",
+    "@tscircuit/props": "*",
+    "@tscircuit/schematic-match-adapt": "*",
+    "circuit-json-to-bpc": "*",
+    "bpc-graph": "*",
+    "@tscircuit/matchpack": "*",
+    "circuit-json": "*",
+    "circuit-json-to-connectivity-map": "*",
+    "schematic-symbols": "*",
+    typescript: "^5.0.0"
+  },
+  dependencies: {
+    "@flatten-js/core": "^1.6.2",
+    "@lume/kiwi": "^0.4.3",
+    "calculate-packing": "0.0.68",
+    "css-select": "5.1.0",
+    "format-si-unit": "^0.0.3",
+    nanoid: "^5.0.7",
+    "performance-now": "^2.1.0",
+    "react-reconciler": "^0.32.0",
+    "svg-path-commander": "^2.1.11",
+    "transformation-matrix": "^2.16.1",
+    zod: "^3.25.67"
+  }
+};
+
+// lib/IsolatedCircuit.ts
+var IsolatedCircuit = class {
+  firstChild = null;
+  children;
+  db;
+  root = null;
+  isRootCircuit = false;
+  _schematicDisabledOverride;
+  get schematicDisabled() {
+    if (this._schematicDisabledOverride !== void 0) {
+      return this._schematicDisabledOverride;
+    }
+    if (this.platform?.schematicDisabled !== void 0) {
+      return this.platform.schematicDisabled;
+    }
+    const board = this._getBoard();
+    return board?._parsedProps?.schematicDisabled ?? false;
+  }
+  set schematicDisabled(value) {
+    this._schematicDisabledOverride = value;
+  }
+  pcbDisabled = false;
+  pcbRoutingDisabled = false;
+  _featureMspSchematicTraceRouting = true;
   /**
-   * Returns a cached map of component names to NormalComponent instances within this subcircuit.
-   * The map is built lazily on first access and cached for subsequent calls.
+   * The IsolatedCircuit name is usually set by the platform, it's not required but
+   * if supplied can identify the circuit in certain effects, e.g. it is passed
+   * as the display_name parameter for autorouting effects.
    */
-  getNormalComponentNameMap() {
-    if (this._normalComponentNameMap) {
-      return this._normalComponentNameMap;
-    }
-    const nameMap = /* @__PURE__ */ new Map();
-    const collectNamedComponents = (component) => {
-      if (component._isNormalComponent && component.name) {
-        const componentsWithSameName = nameMap.get(component.name);
-        if (componentsWithSameName) {
-          componentsWithSameName.push(component);
-        } else {
-          nameMap.set(component.name, [component]);
-        }
-      }
-      for (const child of component.children) {
-        if (!child.isSubcircuit) collectNamedComponents(child);
-      }
-    };
-    for (const child of this.children) {
-      if (!child.isSubcircuit) collectNamedComponents(child);
+  name;
+  platform;
+  /**
+   * Optional URL pointing to where this project is hosted or documented.
+   * When provided it is stored in the source_project_metadata.project_url field
+   * of the generated Circuit JSON.
+   */
+  projectUrl;
+  _hasRenderedAtleastOnce = false;
+  _asyncEffectIdsByPhase = /* @__PURE__ */ new Map();
+  _asyncEffectPhaseById = /* @__PURE__ */ new Map();
+  constructor({
+    platform,
+    projectUrl
+  } = {}) {
+    this.children = [];
+    this.db = su5([]);
+    this.platform = platform;
+    this.projectUrl = projectUrl;
+    this.pcbDisabled = platform?.pcbDisabled ?? false;
+    this.root = this;
+  }
+  add(componentOrElm) {
+    let component;
+    if (isValidElement2(componentOrElm)) {
+      component = createInstanceFromReactElement(componentOrElm);
+    } else {
+      component = componentOrElm;
     }
-    this._normalComponentNameMap = nameMap;
-    return nameMap;
+    this.children.push(component);
   }
-  _asyncAutoroutingResult = null;
-  get config() {
-    return {
-      zodProps: groupProps,
-      componentName: "Group"
+  setPlatform(platform) {
+    this.platform = {
+      ...this.platform,
+      ...platform
     };
   }
-  doInitialSourceGroupRender() {
-    const { db } = this.root;
-    const hasExplicitName = typeof this._parsedProps.name === "string" && this._parsedProps.name.length > 0;
-    const source_group = db.source_group.insert({
-      name: this.name,
-      is_subcircuit: this.isSubcircuit,
-      was_automatically_named: !hasExplicitName
-    });
-    this.source_group_id = source_group.source_group_id;
-    if (this.isSubcircuit) {
-      this.subcircuit_id = `subcircuit_${source_group.source_group_id}`;
-      db.source_group.update(source_group.source_group_id, {
-        subcircuit_id: this.subcircuit_id
-      });
+  /**
+   * Get the main board for this Circuit.
+   */
+  _getBoard() {
+    const directBoard = this.children.find((c) => c.componentName === "Board");
+    if (directBoard) {
+      return directBoard;
     }
+    return void 0;
   }
-  doInitialSourceRender() {
-    const { db } = this.root;
-    for (const child of this.children) {
-      db.source_component.update(child.source_component_id, {
-        source_group_id: this.source_group_id
-      });
+  _guessRootComponent() {
+    if (this.firstChild) return;
+    if (this.children.length === 0) {
+      throw new Error(
+        "Not able to guess root component: IsolatedCircuit has no children (use circuit.add(...))"
+      );
     }
-  }
-  doInitialSourceParentAttachment() {
-    const { db } = this.root;
-    const parentGroup = this.parent?.getGroup?.();
+    const panels = this.children.filter(
+      (child) => child.lowercaseComponentName === "panel"
+    );
+    if (panels.length > 1) {
+      throw new Error("Only one <panel> is allowed per circuit");
+    }
+    if (panels.length === 1) {
+      if (this.children.length !== 1) {
+        throw new Error("<panel> must be the root element of the circuit");
+      }
+      this.firstChild = panels[0];
+      return;
+    }
+    if (this.children.length === 1 && this.children[0].isGroup) {
+      this.firstChild = this.children[0];
+      return;
+    }
+    const group = new Group6({ subcircuit: true });
+    group.parent = this;
+    group.addAll(this.children);
+    this.children = [group];
+    this.firstChild = group;
+  }
+  render() {
+    if (!this.firstChild) {
+      this._guessRootComponent();
+    }
+    const { firstChild, db } = this;
+    if (!firstChild) throw new Error("IsolatedCircuit has no root component");
+    firstChild.parent = this;
+    firstChild.runRenderCycle();
+    this._hasRenderedAtleastOnce = true;
+  }
+  async renderUntilSettled() {
+    const existing = this.db.source_project_metadata.list()?.[0];
+    if (!existing) {
+      this.db.source_project_metadata.insert({
+        software_used_string: `@tscircuit/core@${this.getCoreVersion()}`,
+        ...this.projectUrl ? { project_url: this.projectUrl } : {}
+      });
+    }
+    this.render();
+    while (this._hasIncompleteAsyncEffects()) {
+      await new Promise((resolve) => setTimeout(resolve, 100));
+      this.render();
+    }
+    this.emit("renderComplete");
+  }
+  _hasIncompleteAsyncEffects() {
+    if (this._asyncEffectPhaseById.size > 0) return true;
+    return this.children.some((child) => child._hasIncompleteAsyncEffects());
+  }
+  _hasIncompleteAsyncEffectsForPhase(phase) {
+    return (this._asyncEffectIdsByPhase.get(phase)?.size ?? 0) > 0;
+  }
+  getCircuitJson() {
+    if (!this._hasRenderedAtleastOnce) this.render();
+    return this.db.toArray();
+  }
+  toJson() {
+    return this.getCircuitJson();
+  }
+  async getSvg(options) {
+    const circuitToSvg = await import("circuit-to-svg").catch((e) => {
+      throw new Error(
+        `To use circuit.getSvg, you must install the "circuit-to-svg" package.
+
+"${e.message}"`
+      );
+    });
+    if (options.view === "pcb") {
+      return circuitToSvg.convertCircuitJsonToPcbSvg(this.getCircuitJson());
+    }
+    if (options.view === "schematic") {
+      return circuitToSvg.convertCircuitJsonToSchematicSvg(
+        this.getCircuitJson()
+      );
+    }
+    throw new Error(`Invalid view: ${options.view}`);
+  }
+  getCoreVersion() {
+    const [major, minor, patch] = package_default.version.split(".").map(Number);
+    return `${major}.${minor}.${patch + 1}`;
+  }
+  async preview(previewNameOrOpts) {
+    const previewOpts = typeof previewNameOrOpts === "object" ? previewNameOrOpts : { previewName: previewNameOrOpts };
+    throw new Error("project.preview is not yet implemented");
+  }
+  computeSchematicGlobalTransform() {
+    return identity4();
+  }
+  _computePcbGlobalTransformBeforeLayout() {
+    return identity4();
+  }
+  selectAll(selector) {
+    this._guessRootComponent();
+    return this.firstChild?.selectAll(selector) ?? [];
+  }
+  selectOne(selector, opts) {
+    this._guessRootComponent();
+    return this.firstChild?.selectOne(selector, opts) ?? null;
+  }
+  _eventListeners = {};
+  emit(event, ...args) {
+    if (event === "asyncEffect:start") {
+      this._registerAsyncEffectStart(args[0]);
+    } else if (event === "asyncEffect:end") {
+      this._registerAsyncEffectEnd(args[0]);
+    }
+    if (!this._eventListeners[event]) return;
+    for (const listener of this._eventListeners[event]) {
+      listener(...args);
+    }
+  }
+  on(event, listener) {
+    if (!this._eventListeners[event]) {
+      this._eventListeners[event] = [];
+    }
+    this._eventListeners[event].push(listener);
+  }
+  removeListener(event, listener) {
+    if (!this._eventListeners[event]) return;
+    this._eventListeners[event] = this._eventListeners[event].filter(
+      (l) => l !== listener
+    );
+  }
+  enableDebug(debug11) {
+    if (typeof debug11 === "string") {
+      Debug13.enable(debug11);
+    } else if (debug11 === null || debug11 === false) {
+      Debug13.disable();
+    }
+  }
+  getClientOrigin() {
+    if (typeof window !== "undefined" && window.location) {
+      return window.location.origin;
+    }
+    if (typeof self !== "undefined" && self.location) {
+      return self.location.origin;
+    }
+    return "";
+  }
+  _registerAsyncEffectStart(payload) {
+    if (!payload?.asyncEffectId || !payload.phase) return;
+    const { asyncEffectId, phase } = payload;
+    const existingPhase = this._asyncEffectPhaseById.get(asyncEffectId);
+    if (existingPhase && existingPhase !== phase) {
+      this._asyncEffectIdsByPhase.get(existingPhase)?.delete(asyncEffectId);
+    }
+    if (!this._asyncEffectIdsByPhase.has(phase)) {
+      this._asyncEffectIdsByPhase.set(phase, /* @__PURE__ */ new Set());
+    }
+    this._asyncEffectIdsByPhase.get(phase).add(asyncEffectId);
+    this._asyncEffectPhaseById.set(asyncEffectId, phase);
+  }
+  _registerAsyncEffectEnd(payload) {
+    if (!payload?.asyncEffectId) return;
+    const { asyncEffectId } = payload;
+    const phase = this._asyncEffectPhaseById.get(asyncEffectId) ?? payload.phase;
+    if (phase) {
+      const phaseSet = this._asyncEffectIdsByPhase.get(phase);
+      phaseSet?.delete(asyncEffectId);
+      if (phaseSet && phaseSet.size === 0) {
+        this._asyncEffectIdsByPhase.delete(phase);
+      }
+    }
+    this._asyncEffectPhaseById.delete(asyncEffectId);
+  }
+};
+
+// lib/components/primitive-components/Group/Group_doInitialRenderIsolatedSubcircuits.ts
+function Group_doInitialRenderIsolatedSubcircuits(group) {
+  if (!group._isIsolatedSubcircuit) return;
+  if (!group.root) return;
+  const parentRoot = group.root;
+  const isolatedCircuit = new IsolatedCircuit({
+    platform: {
+      ...parentRoot.platform,
+      pcbDisabled: parentRoot.pcbDisabled,
+      schematicDisabled: parentRoot.schematicDisabled
+    }
+  });
+  const childrenSnapshot = [...group.children];
+  for (const child of childrenSnapshot) {
+    isolatedCircuit.add(child);
+  }
+  group._queueAsyncEffect("render-isolated-subcircuit", async () => {
+    await isolatedCircuit.renderUntilSettled();
+    group.children = [];
+    group._normalComponentNameMap = null;
+    group._isolatedCircuitJson = isolatedCircuit.getCircuitJson();
+  });
+}
+
+// lib/components/primitive-components/Group/Group.ts
+var Group6 = class extends NormalComponent3 {
+  pcb_group_id = null;
+  schematic_group_id = null;
+  subcircuit_id = null;
+  _hasStartedAsyncAutorouting = false;
+  _isInflatedFromCircuitJson = false;
+  _isolatedCircuitJson = null;
+  get _isIsolatedSubcircuit() {
+    return Boolean(this._parsedProps._subcircuitCachingEnabled);
+  }
+  _normalComponentNameMap = null;
+  /**
+   * Returns a cached map of component names to NormalComponent instances within this subcircuit.
+   * The map is built lazily on first access and cached for subsequent calls.
+   */
+  getNormalComponentNameMap() {
+    if (this._normalComponentNameMap) {
+      return this._normalComponentNameMap;
+    }
+    const nameMap = /* @__PURE__ */ new Map();
+    const collectNamedComponents = (component) => {
+      if (component._isNormalComponent && component.name) {
+        const componentsWithSameName = nameMap.get(component.name);
+        if (componentsWithSameName) {
+          componentsWithSameName.push(component);
+        } else {
+          nameMap.set(component.name, [component]);
+        }
+      }
+      for (const child of component.children) {
+        if (!child.isSubcircuit) collectNamedComponents(child);
+      }
+    };
+    for (const child of this.children) {
+      if (!child.isSubcircuit) collectNamedComponents(child);
+    }
+    this._normalComponentNameMap = nameMap;
+    return nameMap;
+  }
+  _asyncAutoroutingResult = null;
+  get config() {
+    return {
+      zodProps: groupProps,
+      componentName: "Group"
+    };
+  }
+  runRenderPhaseForChildren(phase) {
+    if (this._isIsolatedSubcircuit && !this._isInflatedFromCircuitJson) return;
+    super.runRenderPhaseForChildren(phase);
+  }
+  doInitialRenderIsolatedSubcircuits() {
+    Group_doInitialRenderIsolatedSubcircuits(this);
+  }
+  doInitialSourceGroupRender() {
+    const { db } = this.root;
+    const hasExplicitName = typeof this._parsedProps.name === "string" && this._parsedProps.name.length > 0;
+    const source_group = db.source_group.insert({
+      name: this.name,
+      is_subcircuit: this.isSubcircuit,
+      was_automatically_named: !hasExplicitName
+    });
+    this.source_group_id = source_group.source_group_id;
+    if (this.isSubcircuit) {
+      this.subcircuit_id = `subcircuit_${source_group.source_group_id}`;
+      db.source_group.update(source_group.source_group_id, {
+        subcircuit_id: this.subcircuit_id
+      });
+    }
+  }
+  doInitialSourceRender() {
+    const { db } = this.root;
+    for (const child of this.children) {
+      db.source_component.update(child.source_component_id, {
+        source_group_id: this.source_group_id
+      });
+    }
+  }
+  doInitialSourceParentAttachment() {
+    const { db } = this.root;
+    const parentGroup = this.parent?.getGroup?.();
     if (parentGroup?.source_group_id) {
       db.source_group.update(this.source_group_id, {
         parent_source_group_id: parentGroup.source_group_id
@@ -14879,14 +15296,14 @@ var Group6 = class extends NormalComponent3 {
     return false;
   }
   _hasTracesToRoute() {
-    const debug11 = Debug13("tscircuit:core:_hasTracesToRoute");
+    const debug11 = Debug14("tscircuit:core:_hasTracesToRoute");
     const traces = this.selectAll("trace");
     debug11(`[${this.getString()}] has ${traces.length} traces to route`);
     return traces.length > 0;
   }
   async _runEffectMakeHttpAutoroutingRequest() {
     const { db } = this.root;
-    const debug11 = Debug13("tscircuit:core:_runEffectMakeHttpAutoroutingRequest");
+    const debug11 = Debug14("tscircuit:core:_runEffectMakeHttpAutoroutingRequest");
     const props = this._parsedProps;
     const autorouterConfig = this._getAutorouterConfig();
     const serverUrl = autorouterConfig.serverUrl;
@@ -15009,7 +15426,7 @@ var Group6 = class extends NormalComponent3 {
   async _runLocalAutorouting() {
     const { db } = this.root;
     const props = this._parsedProps;
-    const debug11 = Debug13("tscircuit:core:_runLocalAutorouting");
+    const debug11 = Debug14("tscircuit:core:_runLocalAutorouting");
     debug11(`[${this.getString()}] starting local autorouting`);
     const autorouterConfig = this._getAutorouterConfig();
     const isLaserPrefabPreset = this._isLaserPrefabAutorouter(autorouterConfig);
@@ -15145,7 +15562,7 @@ var Group6 = class extends NormalComponent3 {
     }
   }
   doInitialPcbTraceRender() {
-    const debug11 = Debug13("tscircuit:core:doInitialPcbTraceRender");
+    const debug11 = Debug14("tscircuit:core:doInitialPcbTraceRender");
     if (!this.isSubcircuit) return;
     if (this.root?.pcbDisabled) return;
     if (this.getInheritedProperty("routingDisabled")) return;
@@ -15167,7 +15584,7 @@ var Group6 = class extends NormalComponent3 {
     Group_doInitialSchematicTraceRender(this);
   }
   updatePcbTraceRender() {
-    const debug11 = Debug13("tscircuit:core:updatePcbTraceRender");
+    const debug11 = Debug14("tscircuit:core:updatePcbTraceRender");
     debug11(`[${this.getString()}] updating...`);
     if (!this.isSubcircuit) return;
     if (this._isInflatedFromCircuitJson) return;
@@ -15599,7 +16016,7 @@ import { cju } from "@tscircuit/circuit-json-util";
 // lib/components/primitive-components/Group/Subcircuit/inflators/inflatePcbBoard.ts
 function inflatePcbBoard(pcbBoard, inflatorContext) {
   const { subcircuit } = inflatorContext;
-  if (subcircuit.lowercaseComponentName === "board") {
+  if (subcircuit.lowercaseComponentName === "board" || subcircuit.lowercaseComponentName === "mountedboard") {
     return;
   }
   if (subcircuit.parent?.lowercaseComponentName === "board") {
@@ -17050,18 +17467,106 @@ var Board = class extends Group6 {
   }
 };
 
-// lib/components/normal-components/Panel.ts
-import { panelProps } from "@tscircuit/props";
-import { distance as distance12 } from "circuit-json";
-
-// lib/components/normal-components/Subpanel.ts
-import { subpanelProps } from "@tscircuit/props";
-import { distance as distance11 } from "circuit-json";
+// lib/components/normal-components/MountedBoard.ts
+import { mountedboardProps } from "@tscircuit/props";
 
-// lib/utils/panels/generate-panel-tabs-and-mouse-bites.ts
-import * as Flatten from "@flatten-js/core";
-import { point as point5, Polygon as Polygon3 } from "@flatten-js/core";
-var DEFAULT_TAB_LENGTH = 5;
+// lib/components/primitive-components/Group/Subcircuit/Subcircuit.ts
+import "@tscircuit/props";
+var Subcircuit = class extends Group6 {
+  constructor(props) {
+    super({
+      ...props,
+      // @ts-ignore
+      subcircuit: true
+    });
+  }
+  /**
+   * During this phase, we inflate the subcircuit circuit json into class
+   * instances
+   *
+   * When subcircuit's define circuitJson, it's basically the same as having
+   * a tree of components. All the data from circuit json has to be converted
+   * into props for the tree of components
+   *
+   * We do this in two phases:
+   * - Create the components
+   * - Create the groups
+   * - Add components to groups in the appropriate hierarchy
+   */
+  doInitialInflateSubcircuitCircuitJson() {
+    const isolatedJson = this._isolatedCircuitJson;
+    if (isolatedJson) {
+      this._isInflatedFromCircuitJson = true;
+      this._isolatedCircuitJson = null;
+      inflateCircuitJson(this, isolatedJson, []);
+      return;
+    }
+    const { circuitJson, children } = this._parsedProps;
+    if (circuitJson) {
+      this._isInflatedFromCircuitJson = true;
+    }
+    inflateCircuitJson(this, circuitJson, children);
+  }
+};
+
+// lib/components/normal-components/MountedBoard.ts
+var MountedBoard = class extends Subcircuit {
+  pcb_board_id = null;
+  constructor(props) {
+    super(props);
+  }
+  get config() {
+    return {
+      componentName: "MountedBoard",
+      zodProps: mountedboardProps
+    };
+  }
+  doInitialPcbComponentRender() {
+    if (this.root?.pcbDisabled) return;
+    const { db } = this.root;
+    const { _parsedProps: props } = this;
+    const globalPos = this._getGlobalPcbPositionBeforeLayout();
+    const pcb_board = db.pcb_board.insert({
+      center: { x: globalPos.x, y: globalPos.y },
+      width: props.width ?? 0,
+      height: props.height ?? 0,
+      is_mounted_to_carrier_board: true
+    });
+    this.pcb_board_id = pcb_board.pcb_board_id;
+  }
+  doInitialPcbBoardAutoSize() {
+    if (!this.pcb_board_id || !this.root) return;
+    const carrierBoardId = this._findCarrierBoardId();
+    if (carrierBoardId) {
+      this.root.db.pcb_board.update(this.pcb_board_id, {
+        carrier_pcb_board_id: carrierBoardId
+      });
+    }
+  }
+  _findCarrierBoardId() {
+    let current = this.parent;
+    while (current) {
+      if (current instanceof Board) {
+        return current.pcb_board_id;
+      }
+      current = current.parent;
+    }
+    return null;
+  }
+};
+
+// lib/components/normal-components/Panel.ts
+import { panelProps } from "@tscircuit/props";
+import { distance as distance12 } from "circuit-json";
+
+// lib/components/normal-components/Subpanel.ts
+import { subpanelProps } from "@tscircuit/props";
+import { distance as distance11 } from "circuit-json";
+
+// lib/utils/panels/generate-panel-tabs-and-mouse-bites.ts
+import * as Flatten from "@flatten-js/core";
+import { point as point5, Polygon as Polygon3 } from "@flatten-js/core";
+var DEFAULT_TAB_LENGTH = 5;
 var DEFAULT_TAB_WIDTH = 2;
 var generateCutoutsAndMousebitesForOutline = (outline, options) => {
   const {
@@ -19233,38 +19738,6 @@ var PcbNoteDimension = class extends PrimitiveComponent2 {
   }
 };
 
-// lib/components/primitive-components/Group/Subcircuit/Subcircuit.ts
-import "@tscircuit/props";
-var Subcircuit = class extends Group6 {
-  constructor(props) {
-    super({
-      ...props,
-      // @ts-ignore
-      subcircuit: true
-    });
-  }
-  /**
-   * During this phase, we inflate the subcircuit circuit json into class
-   * instances
-   *
-   * When subcircuit's define circuitJson, it's basically the same as having
-   * a tree of components. All the data from circuit json has to be converted
-   * into props for the tree of components
-   *
-   * We do this in two phases:
-   * - Create the components
-   * - Create the groups
-   * - Add components to groups in the appropriate hierarchy
-   */
-  doInitialInflateSubcircuitCircuitJson() {
-    const { circuitJson, children } = this._parsedProps;
-    if (circuitJson) {
-      this._isInflatedFromCircuitJson = true;
-    }
-    inflateCircuitJson(this, circuitJson, children);
-  }
-};
-
 // lib/components/primitive-components/Breakout/Breakout.ts
 import "@tscircuit/props";
 var Breakout = class extends Group6 {
@@ -19399,7 +19872,7 @@ var BreakoutPoint = class extends PrimitiveComponent2 {
 import { netLabelProps } from "@tscircuit/props";
 import {
   applyToPoint as applyToPoint17,
-  identity as identity4,
+  identity as identity5,
   translate as translate8
 } from "transformation-matrix";
 import { calculateElbow as calculateElbow2 } from "calculate-elbow";
@@ -19450,7 +19923,7 @@ var NetLabel = class extends PrimitiveComponent2 {
       if (connectedPorts.length > 0) {
         const portPos = connectedPorts[0]._getGlobalSchematicPositionBeforeLayout();
         const parentCenter = applyToPoint17(
-          this.parent?.computeSchematicGlobalTransform?.() ?? identity4(),
+          this.parent?.computeSchematicGlobalTransform?.() ?? identity5(),
           { x: 0, y: 0 }
         );
         return translate8(portPos.x - parentCenter.x, portPos.y - parentCenter.y);
@@ -22256,384 +22729,9 @@ var VoltageProbe = class extends PrimitiveComponent2 {
   }
 };
 
-// lib/IsolatedCircuit.ts
-import { su as su5 } from "@tscircuit/circuit-json-util";
-import Debug14 from "debug";
-import { isValidElement as isValidElement2 } from "react";
-import { identity as identity5 } from "transformation-matrix";
-
-// package.json
-var package_default = {
-  name: "@tscircuit/core",
-  type: "module",
-  version: "0.0.1021",
-  types: "dist/index.d.ts",
-  main: "dist/index.js",
-  module: "dist/index.js",
-  exports: {
-    ".": {
-      import: "./dist/index.js",
-      types: "./dist/index.d.ts"
-    }
-  },
-  files: [
-    "dist"
-  ],
-  repository: {
-    type: "git",
-    url: "https://github.com/tscircuit/core"
-  },
-  scripts: {
-    build: "tsup-node index.ts --format esm --dts",
-    format: "biome format . --write",
-    "measure-bundle": "howfat -r table .",
-    "pkg-pr-new-release": "bunx pkg-pr-new publish --comment=off --peerDeps",
-    "smoke-test:dist": "bun run scripts/smoke-tests/test-dist-simple-circuit.tsx",
-    "build:benchmarking": "bun build --experimental-html ./benchmarking/website/index.html --outdir ./benchmarking-dist",
-    "build:benchmarking:watch": `chokidar "./{benchmarking,lib}/**/*.{ts,tsx}" -c 'bun build --experimental-html ./benchmarking/website/index.html --outdir ./benchmarking-dist'`,
-    "start:benchmarking": 'concurrently "bun run build:benchmarking:watch" "live-server ./benchmarking-dist"',
-    "generate-test-plan": "bun run scripts/generate-test-plan.ts"
-  },
-  devDependencies: {
-    "@biomejs/biome": "^1.8.3",
-    "@resvg/resvg-js": "^2.6.2",
-    "@tscircuit/alphabet": "0.0.18",
-    "@tscircuit/capacity-autorouter": "^0.0.264",
-    "@tscircuit/checks": "^0.0.88",
-    "@tscircuit/circuit-json-util": "^0.0.77",
-    "@tscircuit/common": "^0.0.20",
-    "@tscircuit/copper-pour-solver": "^0.0.20",
-    "@tscircuit/footprinter": "^0.0.288",
-    "@tscircuit/infgrid-ijump-astar": "^0.0.35",
-    "@tscircuit/log-soup": "^1.0.2",
-    "@tscircuit/matchpack": "^0.0.16",
-    "@tscircuit/math-utils": "^0.0.29",
-    "@tscircuit/miniflex": "^0.0.4",
-    "@tscircuit/ngspice-spice-engine": "^0.0.8",
-    "@tscircuit/props": "^0.0.470",
-    "@tscircuit/schematic-match-adapt": "^0.0.16",
-    "@tscircuit/schematic-trace-solver": "^v0.0.45",
-    "@tscircuit/solver-utils": "^0.0.3",
-    "@tscircuit/soup-util": "^0.0.41",
-    "@types/bun": "^1.2.16",
-    "@types/debug": "^4.1.12",
-    "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6",
-    "@types/react-reconciler": "^0.28.9",
-    "bpc-graph": "^0.0.57",
-    "bun-match-svg": "0.0.12",
-    "calculate-elbow": "^0.0.12",
-    "chokidar-cli": "^3.0.0",
-    "circuit-json": "^0.0.376",
-    "circuit-json-to-bpc": "^0.0.13",
-    "circuit-json-to-connectivity-map": "^0.0.23",
-    "circuit-json-to-gltf": "^0.0.62",
-    "circuit-json-to-simple-3d": "^0.0.9",
-    "circuit-json-to-spice": "^0.0.33",
-    "circuit-to-svg": "^0.0.327",
-    concurrently: "^9.1.2",
-    "connectivity-map": "^1.0.0",
-    debug: "^4.3.6",
-    "eecircuit-engine": "^1.5.6",
-    flatbush: "^4.5.0",
-    "graphics-debug": "^0.0.60",
-    howfat: "^0.3.8",
-    "live-server": "^1.2.2",
-    "looks-same": "^9.0.1",
-    minicssgrid: "^0.0.9",
-    "pkg-pr-new": "^0.0.37",
-    poppygl: "^0.0.16",
-    react: "^19.1.0",
-    "react-dom": "^19.1.0",
-    "schematic-symbols": "^0.0.208",
-    spicey: "^0.0.14",
-    "ts-expect": "^1.3.0",
-    tsup: "^8.2.4"
-  },
-  peerDependencies: {
-    "@tscircuit/capacity-autorouter": "*",
-    "@tscircuit/checks": "*",
-    "@tscircuit/circuit-json-util": "*",
-    "@tscircuit/footprinter": "*",
-    "@tscircuit/infgrid-ijump-astar": "*",
-    "@tscircuit/math-utils": "*",
-    "@tscircuit/props": "*",
-    "@tscircuit/schematic-match-adapt": "*",
-    "circuit-json-to-bpc": "*",
-    "bpc-graph": "*",
-    "@tscircuit/matchpack": "*",
-    "circuit-json": "*",
-    "circuit-json-to-connectivity-map": "*",
-    "schematic-symbols": "*",
-    typescript: "^5.0.0"
-  },
-  dependencies: {
-    "@flatten-js/core": "^1.6.2",
-    "@lume/kiwi": "^0.4.3",
-    "calculate-packing": "0.0.68",
-    "css-select": "5.1.0",
-    "format-si-unit": "^0.0.3",
-    nanoid: "^5.0.7",
-    "performance-now": "^2.1.0",
-    "react-reconciler": "^0.32.0",
-    "svg-path-commander": "^2.1.11",
-    "transformation-matrix": "^2.16.1",
-    zod: "^3.25.67"
-  }
-};
-
-// lib/IsolatedCircuit.ts
-var IsolatedCircuit = class {
-  firstChild = null;
-  children;
-  db;
-  root = null;
-  isRoot = false;
-  _schematicDisabledOverride;
-  get schematicDisabled() {
-    if (this._schematicDisabledOverride !== void 0) {
-      return this._schematicDisabledOverride;
-    }
-    const board = this._getBoard();
-    return board?._parsedProps?.schematicDisabled ?? false;
-  }
-  set schematicDisabled(value) {
-    this._schematicDisabledOverride = value;
-  }
-  pcbDisabled = false;
-  pcbRoutingDisabled = false;
-  _featureMspSchematicTraceRouting = true;
-  /**
-   * The IsolatedCircuit name is usually set by the platform, it's not required but
-   * if supplied can identify the circuit in certain effects, e.g. it is passed
-   * as the display_name parameter for autorouting effects.
-   */
-  name;
-  platform;
-  /**
-   * Optional URL pointing to where this project is hosted or documented.
-   * When provided it is stored in the source_project_metadata.project_url field
-   * of the generated Circuit JSON.
-   */
-  projectUrl;
-  _hasRenderedAtleastOnce = false;
-  _asyncEffectIdsByPhase = /* @__PURE__ */ new Map();
-  _asyncEffectPhaseById = /* @__PURE__ */ new Map();
-  constructor({
-    platform,
-    projectUrl
-  } = {}) {
-    this.children = [];
-    this.db = su5([]);
-    this.platform = platform;
-    this.projectUrl = projectUrl;
-    this.pcbDisabled = platform?.pcbDisabled ?? false;
-  }
-  add(componentOrElm) {
-    let component;
-    if (isValidElement2(componentOrElm)) {
-      component = createInstanceFromReactElement(componentOrElm);
-    } else {
-      component = componentOrElm;
-    }
-    this.children.push(component);
-  }
-  setPlatform(platform) {
-    this.platform = {
-      ...this.platform,
-      ...platform
-    };
-  }
-  /**
-   * Get the main board for this Circuit.
-   */
-  _getBoard() {
-    const directBoard = this.children.find((c) => c.componentName === "Board");
-    if (directBoard) {
-      return directBoard;
-    }
-    return void 0;
-  }
-  _guessRootComponent() {
-    if (this.firstChild) return;
-    if (this.children.length === 0) {
-      throw new Error(
-        "Not able to guess root component: IsolatedCircuit has no children (use circuit.add(...))"
-      );
-    }
-    const panels = this.children.filter(
-      (child) => child.lowercaseComponentName === "panel"
-    );
-    if (panels.length > 1) {
-      throw new Error("Only one <panel> is allowed per circuit");
-    }
-    if (panels.length === 1) {
-      if (this.children.length !== 1) {
-        throw new Error("<panel> must be the root element of the circuit");
-      }
-      this.firstChild = panels[0];
-      return;
-    }
-    if (this.children.length === 1 && this.children[0].isGroup) {
-      this.firstChild = this.children[0];
-      return;
-    }
-    const group = new Group6({ subcircuit: true });
-    group.parent = this;
-    group.addAll(this.children);
-    this.children = [group];
-    this.firstChild = group;
-  }
-  render() {
-    if (!this.firstChild) {
-      this._guessRootComponent();
-    }
-    const { firstChild, db } = this;
-    if (!firstChild) throw new Error("IsolatedCircuit has no root component");
-    firstChild.parent = this;
-    firstChild.runRenderCycle();
-    this._hasRenderedAtleastOnce = true;
-  }
-  async renderUntilSettled() {
-    const existing = this.db.source_project_metadata.list()?.[0];
-    if (!existing) {
-      this.db.source_project_metadata.insert({
-        software_used_string: `@tscircuit/core@${this.getCoreVersion()}`,
-        ...this.projectUrl ? { project_url: this.projectUrl } : {}
-      });
-    }
-    this.render();
-    while (this._hasIncompleteAsyncEffects()) {
-      await new Promise((resolve) => setTimeout(resolve, 100));
-      this.render();
-    }
-    this.emit("renderComplete");
-  }
-  _hasIncompleteAsyncEffects() {
-    if (this._asyncEffectPhaseById.size > 0) return true;
-    return this.children.some((child) => child._hasIncompleteAsyncEffects());
-  }
-  _hasIncompleteAsyncEffectsForPhase(phase) {
-    return (this._asyncEffectIdsByPhase.get(phase)?.size ?? 0) > 0;
-  }
-  getCircuitJson() {
-    if (!this._hasRenderedAtleastOnce) this.render();
-    return this.db.toArray();
-  }
-  toJson() {
-    return this.getCircuitJson();
-  }
-  async getSvg(options) {
-    const circuitToSvg = await import("circuit-to-svg").catch((e) => {
-      throw new Error(
-        `To use circuit.getSvg, you must install the "circuit-to-svg" package.
-
-"${e.message}"`
-      );
-    });
-    if (options.view === "pcb") {
-      return circuitToSvg.convertCircuitJsonToPcbSvg(this.getCircuitJson());
-    }
-    if (options.view === "schematic") {
-      return circuitToSvg.convertCircuitJsonToSchematicSvg(
-        this.getCircuitJson()
-      );
-    }
-    throw new Error(`Invalid view: ${options.view}`);
-  }
-  getCoreVersion() {
-    const [major, minor, patch] = package_default.version.split(".").map(Number);
-    return `${major}.${minor}.${patch + 1}`;
-  }
-  async preview(previewNameOrOpts) {
-    const previewOpts = typeof previewNameOrOpts === "object" ? previewNameOrOpts : { previewName: previewNameOrOpts };
-    throw new Error("project.preview is not yet implemented");
-  }
-  computeSchematicGlobalTransform() {
-    return identity5();
-  }
-  _computePcbGlobalTransformBeforeLayout() {
-    return identity5();
-  }
-  selectAll(selector) {
-    this._guessRootComponent();
-    return this.firstChild?.selectAll(selector) ?? [];
-  }
-  selectOne(selector, opts) {
-    this._guessRootComponent();
-    return this.firstChild?.selectOne(selector, opts) ?? null;
-  }
-  _eventListeners = {};
-  emit(event, ...args) {
-    if (event === "asyncEffect:start") {
-      this._registerAsyncEffectStart(args[0]);
-    } else if (event === "asyncEffect:end") {
-      this._registerAsyncEffectEnd(args[0]);
-    }
-    if (!this._eventListeners[event]) return;
-    for (const listener of this._eventListeners[event]) {
-      listener(...args);
-    }
-  }
-  on(event, listener) {
-    if (!this._eventListeners[event]) {
-      this._eventListeners[event] = [];
-    }
-    this._eventListeners[event].push(listener);
-  }
-  removeListener(event, listener) {
-    if (!this._eventListeners[event]) return;
-    this._eventListeners[event] = this._eventListeners[event].filter(
-      (l) => l !== listener
-    );
-  }
-  enableDebug(debug11) {
-    if (typeof debug11 === "string") {
-      Debug14.enable(debug11);
-    } else if (debug11 === null || debug11 === false) {
-      Debug14.disable();
-    }
-  }
-  getClientOrigin() {
-    if (typeof window !== "undefined" && window.location) {
-      return window.location.origin;
-    }
-    if (typeof self !== "undefined" && self.location) {
-      return self.location.origin;
-    }
-    return "";
-  }
-  _registerAsyncEffectStart(payload) {
-    if (!payload?.asyncEffectId || !payload.phase) return;
-    const { asyncEffectId, phase } = payload;
-    const existingPhase = this._asyncEffectPhaseById.get(asyncEffectId);
-    if (existingPhase && existingPhase !== phase) {
-      this._asyncEffectIdsByPhase.get(existingPhase)?.delete(asyncEffectId);
-    }
-    if (!this._asyncEffectIdsByPhase.has(phase)) {
-      this._asyncEffectIdsByPhase.set(phase, /* @__PURE__ */ new Set());
-    }
-    this._asyncEffectIdsByPhase.get(phase).add(asyncEffectId);
-    this._asyncEffectPhaseById.set(asyncEffectId, phase);
-  }
-  _registerAsyncEffectEnd(payload) {
-    if (!payload?.asyncEffectId) return;
-    const { asyncEffectId } = payload;
-    const phase = this._asyncEffectPhaseById.get(asyncEffectId) ?? payload.phase;
-    if (phase) {
-      const phaseSet = this._asyncEffectIdsByPhase.get(phase);
-      phaseSet?.delete(asyncEffectId);
-      if (phaseSet && phaseSet.size === 0) {
-        this._asyncEffectIdsByPhase.delete(phase);
-      }
-    }
-    this._asyncEffectPhaseById.delete(asyncEffectId);
-  }
-};
-
 // lib/RootCircuit.ts
 var RootCircuit = class extends IsolatedCircuit {
-  isRoot = true;
+  isRootCircuit = true;
   constructor({
     platform,
     projectUrl
@@ -22888,6 +22986,7 @@ export {
   Keepout,
   Led,
   Mosfet,
+  MountedBoard,
   Net,
   NetLabel,
   NormalComponent3 as NormalComponent,