@tscircuit/core 0.0.1103 → 0.0.1104

package/dist/index.d.ts

@@ -174,9 +174,9 @@ interface IIsolatedCircuit {
 interface IRootCircuit extends IIsolatedCircuit {
 }
 
-declare const orderedRenderPhases: readonly ["ReactSubtreesRender", "RenderIsolatedSubcircuits", "InflateSubcircuitCircuitJson", "SourceNameDuplicateComponentRemoval", "PcbFootprintStringRender", "InitializePortsFromChildren", "CreateNetsFromProps", "AssignFallbackProps", "CreateTracesFromProps", "CreateTracesFromNetLabels", "CreateTraceHintsFromProps", "SourceGroupRender", "AssignNameToUnnamedComponents", "SourceRender", "SourceParentAttachment", "PortMatching", "OptimizeSelectorCache", "SourceTraceRender", "SourceAddConnectivityMapKey", "SourceDesignRuleChecks", "SimulationRender", "SchematicComponentRender", "SchematicPortRender", "SymbolContainerRender", "SchematicPrimitiveRender", "SchematicSymbolResize", "SchematicComponentSizeCalculation", "SchematicLayout", "SchematicTraceRender", "SchematicReplaceNetLabelsWithSymbols", "PanelBoardLayout", "PcbComponentRender", "PcbPrimitiveRender", "PcbFootprintLayout", "PcbPortRender", "PcbPortAttachment", "PcbComponentSizeCalculation", "PcbComponentAnchorAlignment", "PcbCalcPlacementResolution", "PcbLayout", "PcbBoardAutoSize", "PanelLayout", "PcbTraceHintRender", "PcbManualTraceRender", "PcbTraceRender", "PcbRouteNetIslands", "PcbCopperPourRender", "PcbDesignRuleChecks", "SilkscreenOverlapAdjustment", "CadModelRender", "PartsEngineRender", "SimulationSpiceEngineRender"];
+declare const orderedRenderPhases: readonly ["ReactSubtreesRender", "RenderIsolatedSubcircuits", "InflateSubcircuitCircuitJson", "SourceNameDuplicateComponentRemoval", "PcbFootprintStringRender", "InitializePortsFromChildren", "CreateNetsFromProps", "AssignFallbackProps", "CreateTracesFromProps", "CreateTracesFromNetLabels", "CreateTraceHintsFromProps", "SourceGroupRender", "AssignNameToUnnamedComponents", "SourceRender", "SourceParentAttachment", "PortMatching", "OptimizeSelectorCache", "SourceTraceRender", "SourceAddConnectivityMapKey", "SourceDesignRuleChecks", "SimulationRender", "SchematicComponentRender", "SchematicPortRender", "SymbolContainerRender", "SchematicPrimitiveRender", "SchematicSymbolResize", "SchematicComponentSizeCalculation", "SchematicLayout", "SchematicTraceRender", "SchematicReplaceNetLabelsWithSymbols", "PanelBoardLayout", "ValidatePcbCoordinates", "PcbComponentRender", "PcbPrimitiveRender", "PcbFootprintLayout", "PcbPortRender", "PcbPortAttachment", "PcbComponentSizeCalculation", "PcbComponentAnchorAlignment", "PcbCalcPlacementResolution", "PcbLayout", "PcbBoardAutoSize", "PanelLayout", "PcbTraceHintRender", "PcbManualTraceRender", "PcbTraceRender", "PcbRouteNetIslands", "PcbCopperPourRender", "PcbDesignRuleChecks", "SilkscreenOverlapAdjustment", "CadModelRender", "PartsEngineRender", "SimulationSpiceEngineRender"];
 type RenderPhase = (typeof orderedRenderPhases)[number];
-declare const renderPhaseIndexMap: Map<"ReactSubtreesRender" | "RenderIsolatedSubcircuits" | "InflateSubcircuitCircuitJson" | "SourceNameDuplicateComponentRemoval" | "PcbFootprintStringRender" | "InitializePortsFromChildren" | "CreateNetsFromProps" | "AssignFallbackProps" | "CreateTracesFromProps" | "CreateTracesFromNetLabels" | "CreateTraceHintsFromProps" | "SourceGroupRender" | "AssignNameToUnnamedComponents" | "SourceRender" | "SourceParentAttachment" | "PortMatching" | "OptimizeSelectorCache" | "SourceTraceRender" | "SourceAddConnectivityMapKey" | "SourceDesignRuleChecks" | "SimulationRender" | "SchematicComponentRender" | "SchematicPortRender" | "SymbolContainerRender" | "SchematicPrimitiveRender" | "SchematicSymbolResize" | "SchematicComponentSizeCalculation" | "SchematicLayout" | "SchematicTraceRender" | "SchematicReplaceNetLabelsWithSymbols" | "PanelBoardLayout" | "PcbComponentRender" | "PcbPrimitiveRender" | "PcbFootprintLayout" | "PcbPortRender" | "PcbPortAttachment" | "PcbComponentSizeCalculation" | "PcbComponentAnchorAlignment" | "PcbCalcPlacementResolution" | "PcbLayout" | "PcbBoardAutoSize" | "PanelLayout" | "PcbTraceHintRender" | "PcbManualTraceRender" | "PcbTraceRender" | "PcbRouteNetIslands" | "PcbCopperPourRender" | "PcbDesignRuleChecks" | "SilkscreenOverlapAdjustment" | "CadModelRender" | "PartsEngineRender" | "SimulationSpiceEngineRender", number>;
+declare const renderPhaseIndexMap: Map<"ReactSubtreesRender" | "RenderIsolatedSubcircuits" | "InflateSubcircuitCircuitJson" | "SourceNameDuplicateComponentRemoval" | "PcbFootprintStringRender" | "InitializePortsFromChildren" | "CreateNetsFromProps" | "AssignFallbackProps" | "CreateTracesFromProps" | "CreateTracesFromNetLabels" | "CreateTraceHintsFromProps" | "SourceGroupRender" | "AssignNameToUnnamedComponents" | "SourceRender" | "SourceParentAttachment" | "PortMatching" | "OptimizeSelectorCache" | "SourceTraceRender" | "SourceAddConnectivityMapKey" | "SourceDesignRuleChecks" | "SimulationRender" | "SchematicComponentRender" | "SchematicPortRender" | "SymbolContainerRender" | "SchematicPrimitiveRender" | "SchematicSymbolResize" | "SchematicComponentSizeCalculation" | "SchematicLayout" | "SchematicTraceRender" | "SchematicReplaceNetLabelsWithSymbols" | "PanelBoardLayout" | "ValidatePcbCoordinates" | "PcbComponentRender" | "PcbPrimitiveRender" | "PcbFootprintLayout" | "PcbPortRender" | "PcbPortAttachment" | "PcbComponentSizeCalculation" | "PcbComponentAnchorAlignment" | "PcbCalcPlacementResolution" | "PcbLayout" | "PcbBoardAutoSize" | "PanelLayout" | "PcbTraceHintRender" | "PcbManualTraceRender" | "PcbTraceRender" | "PcbRouteNetIslands" | "PcbCopperPourRender" | "PcbDesignRuleChecks" | "SilkscreenOverlapAdjustment" | "CadModelRender" | "PartsEngineRender" | "SimulationSpiceEngineRender", number>;
 type RenderPhaseFn<K extends RenderPhase = RenderPhase> = `doInitial${K}` | `update${K}` | `remove${K}`;
 type RenderPhaseStates = Record<RenderPhase, {
     initialized: boolean;
@@ -499,6 +499,7 @@ declare abstract class PrimitiveComponent<ZodProps extends ZodType = any> extend
     pcb_component_id: string | null;
     cad_component_id: string | null;
     _reportedInvalidPcbCalcWarnings: Set<string>;
+    private _reportInvalidComponentPropertyError;
     fallbackUnassignedName?: string;
     constructor(props: z.input<ZodProps>);
     setProps(props: Partial<z.input<ZodProps>>): void;
@@ -507,6 +508,12 @@ declare abstract class PrimitiveComponent<ZodProps extends ZodType = any> extend
         pcbX: number;
         pcbY: number;
     };
+    doInitialValidatePcbCoordinates(): void;
+    protected _validatePcbCoordinateReferences(params: {
+        rawValue: unknown;
+        axis: "pcbX" | "pcbY";
+        propertyNameForError?: string;
+    }): void;
     protected _resolvePcbCoordinate(rawValue: unknown, axis: "pcbX" | "pcbY", options?: {
         allowBoardVariables?: boolean;
         allowComponentVariables?: boolean;
@@ -1685,6 +1692,7 @@ declare class NormalComponent<ZodProps extends z.ZodType = any, PortNames extend
     doInitialCreateTracesFromProps(): void;
     _createTracesFromConnectionsProp(): void;
     doInitialSourceDesignRuleChecks(): void;
+    doInitialValidatePcbCoordinates(): void;
     doInitialPcbLayout(): void;
     /**
      * Get the minimum flex container size for this component on PCB

package/dist/index.js

@@ -327,6 +327,7 @@ var orderedRenderPhases = [
   "SchematicTraceRender",
   "SchematicReplaceNetLabelsWithSymbols",
   "PanelBoardLayout",
+  "ValidatePcbCoordinates",
   "PcbComponentRender",
   "PcbPrimitiveRender",
   "PcbFootprintLayout",
@@ -373,6 +374,7 @@ var asyncPhaseDependencies = {
   PartsEngineRender: ["PcbFootprintStringRender"],
   PcbComponentAnchorAlignment: ["PcbFootprintStringRender"],
   PcbCalcPlacementResolution: ["PcbFootprintStringRender"],
+  ValidatePcbCoordinates: ["PcbFootprintStringRender"],
   SourceTraceRender: ["PcbFootprintStringRender"]
 };
 var globalRenderCounter = 0;
@@ -1200,6 +1202,18 @@ var PrimitiveComponent2 = class extends Renderable {
   pcb_component_id = null;
   cad_component_id = null;
   _reportedInvalidPcbCalcWarnings = /* @__PURE__ */ new Set();
+  _reportInvalidComponentPropertyError(propertyName, message) {
+    if (!this.root || this._reportedInvalidPcbCalcWarnings.has(propertyName)) {
+      return;
+    }
+    this.root.db.source_invalid_component_property_error.insert({
+      source_component_id: this.source_component_id || "",
+      property_name: propertyName,
+      message,
+      error_type: "source_invalid_component_property_error"
+    });
+    this._reportedInvalidPcbCalcWarnings.add(propertyName);
+  }
   fallbackUnassignedName;
   constructor(props) {
     super(props);
@@ -1249,6 +1263,47 @@ var PrimitiveComponent2 = class extends Renderable {
       pcbY: this._resolvePcbCoordinate(this._parsedProps.pcbY, "pcbY")
     };
   }
+  doInitialValidatePcbCoordinates() {
+    if (this.root?.pcbDisabled) return;
+    const rawProps = this.props;
+    const rawPcbX = rawProps.pcbX;
+    const rawPcbY = rawProps.pcbY;
+    this._validatePcbCoordinateReferences({
+      rawValue: rawPcbX,
+      axis: "pcbX",
+      propertyNameForError: "pcbX"
+    });
+    this._validatePcbCoordinateReferences({
+      rawValue: rawPcbY,
+      axis: "pcbY",
+      propertyNameForError: "pcbY"
+    });
+  }
+  _validatePcbCoordinateReferences(params) {
+    const { rawValue, axis, propertyNameForError = axis } = params;
+    if (typeof rawValue !== "string") return;
+    const isNormalComponent = this._isNormalComponent === true;
+    const allowComponentVariables = !isNormalComponent && !this._isInsideFootprint();
+    let calcIdentifiers = [];
+    try {
+      calcIdentifiers = extractCalcIdentifiers(rawValue);
+    } catch {
+      this._reportInvalidComponentPropertyError(
+        propertyNameForError,
+        `Invalid ${propertyNameForError} value for ${this.componentName}: Invalid calc() expression. expression="${rawValue}"`
+      );
+      return;
+    }
+    const includesComponentVariable = calcIdentifiers.some(
+      (identifier) => !identifier.startsWith("board.")
+    );
+    if (includesComponentVariable && !allowComponentVariables) {
+      this._reportInvalidComponentPropertyError(
+        propertyNameForError,
+        `Invalid ${propertyNameForError} value for ${this.componentName}: component-relative calc references are not supported for footprint elements (${this.componentName}); ${propertyNameForError} will be ignored. expression="${rawValue}"`
+      );
+    }
+  }
   _resolvePcbCoordinate(rawValue, axis, options = {}) {
     if (rawValue == null) return 0;
     if (typeof rawValue === "number") return rawValue;
@@ -11140,6 +11195,46 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
   doInitialSourceDesignRuleChecks() {
     NormalComponent_doInitialSourceDesignRuleChecks(this);
   }
+  doInitialValidatePcbCoordinates() {
+    super.doInitialValidatePcbCoordinates();
+    if (this.root?.pcbDisabled) return;
+    const props = this._parsedProps;
+    const rawProps = this.props;
+    const pcbLeftEdgeX = typeof rawProps.pcbLeftEdgeX === "string" ? rawProps.pcbLeftEdgeX : props.pcbLeftEdgeX ?? rawProps.pcbLeftEdgeX;
+    const pcbRightEdgeX = typeof rawProps.pcbRightEdgeX === "string" ? rawProps.pcbRightEdgeX : props.pcbRightEdgeX ?? rawProps.pcbRightEdgeX;
+    const pcbTopEdgeY = typeof rawProps.pcbTopEdgeY === "string" ? rawProps.pcbTopEdgeY : props.pcbTopEdgeY ?? rawProps.pcbTopEdgeY;
+    const pcbBottomEdgeY = typeof rawProps.pcbBottomEdgeY === "string" ? rawProps.pcbBottomEdgeY : props.pcbBottomEdgeY ?? rawProps.pcbBottomEdgeY;
+    const hasExplicitPcbPosition = props.pcbX !== void 0 || props.pcbY !== void 0 || pcbLeftEdgeX !== void 0 || pcbRightEdgeX !== void 0 || pcbTopEdgeY !== void 0 || pcbBottomEdgeY !== void 0;
+    if (!hasExplicitPcbPosition) return;
+    if (pcbLeftEdgeX !== void 0) {
+      this._validatePcbCoordinateReferences({
+        rawValue: pcbLeftEdgeX,
+        axis: "pcbX",
+        propertyNameForError: "pcbLeftEdgeX"
+      });
+    }
+    if (pcbRightEdgeX !== void 0) {
+      this._validatePcbCoordinateReferences({
+        rawValue: pcbRightEdgeX,
+        axis: "pcbX",
+        propertyNameForError: "pcbRightEdgeX"
+      });
+    }
+    if (pcbTopEdgeY !== void 0) {
+      this._validatePcbCoordinateReferences({
+        rawValue: pcbTopEdgeY,
+        axis: "pcbY",
+        propertyNameForError: "pcbTopEdgeY"
+      });
+    }
+    if (pcbBottomEdgeY !== void 0) {
+      this._validatePcbCoordinateReferences({
+        rawValue: pcbBottomEdgeY,
+        axis: "pcbY",
+        propertyNameForError: "pcbBottomEdgeY"
+      });
+    }
+  }
   doInitialPcbLayout() {
     if (this.root?.pcbDisabled) return;
     if (!this.pcb_component_id) return;
@@ -18264,7 +18359,7 @@ import { identity as identity5 } from "transformation-matrix";
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.1102",
+  version: "0.0.1103",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -18296,8 +18391,8 @@ var package_default = {
     "@biomejs/biome": "^1.8.3",
     "@resvg/resvg-js": "^2.6.2",
     "@tscircuit/alphabet": "0.0.18",
+    "@tscircuit/checks": "0.0.108",
     "@tscircuit/capacity-autorouter": "^0.0.326",
-    "@tscircuit/checks": "0.0.107",
     "@tscircuit/circuit-json-util": "^0.0.82",
     "@tscircuit/common": "^0.0.20",
     "@tscircuit/copper-pour-solver": "^0.0.20",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tscircuit/core",
   "type": "module",
-  "version": "0.0.1103",
+  "version": "0.0.1104",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -33,8 +33,8 @@
     "@biomejs/biome": "^1.8.3",
     "@resvg/resvg-js": "^2.6.2",
     "@tscircuit/alphabet": "0.0.18",
+    "@tscircuit/checks": "0.0.108",
     "@tscircuit/capacity-autorouter": "^0.0.326",
-    "@tscircuit/checks": "0.0.107",
     "@tscircuit/circuit-json-util": "^0.0.82",
     "@tscircuit/common": "^0.0.20",
     "@tscircuit/copper-pour-solver": "^0.0.20",