@tscircuit/core 0.0.1142 → 0.0.1144

package/dist/index.d.ts

@@ -177,9 +177,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", "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", "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" | "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" | "SimulationSpiceEngineRender", number>;
 type RenderPhaseFn<K extends RenderPhase = RenderPhase> = `doInitial${K}` | `update${K}` | `remove${K}`;
 type RenderPhaseStates = Record<RenderPhase, {
     initialized: boolean;
@@ -720,6 +720,7 @@ declare abstract class PrimitiveComponent<ZodProps extends ZodType = any> extend
     _getSchematicBoxComponentDimensions(): SchematicBoxComponentDimensions | null;
     renderError(message: Parameters<typeof Renderable.prototype.renderError>[0]): void;
     getString(): string;
+    getDisplayName(): string;
     get [Symbol.toStringTag](): string;
 }
 
@@ -1581,6 +1582,7 @@ declare class NormalComponent<ZodProps extends z.ZodType = any, PortNames extend
     _isCadModelChild?: boolean;
     pcb_missing_footprint_error_id?: string;
     _hasStartedFootprintUrlLoad: boolean;
+    private _invalidFootprintPropMessages;
     private _invalidPinLabelMessages;
     /**
      * Set to true to enable automatic silkscreen text adjustment when it overlaps with other components
@@ -1672,6 +1674,8 @@ declare class NormalComponent<ZodProps extends z.ZodType = any, PortNames extend
     getPortsFromFootprint(opts?: {
         additionalAliases?: Record<string, string[]>;
     }): Port[];
+    private _queueInvalidFootprintPropMessage;
+    private _insertInvalidFootprintPropErrors;
     getPortsFromSchematicSymbol(): Port[];
     doInitialCreateNetsFromProps(): void;
     _getNetsFromConnectionsProp(): string[];
@@ -1713,6 +1717,7 @@ declare class NormalComponent<ZodProps extends z.ZodType = any, PortNames extend
     doInitialCreateTracesFromProps(): void;
     _createTracesFromConnectionsProp(): void;
     doInitialSourceDesignRuleChecks(): void;
+    doInitialSourceComponentPropertyValidation(): void;
     doInitialValidatePcbCoordinates(): void;
     doInitialPcbLayout(): void;
     /**

package/dist/index.js

@@ -311,6 +311,7 @@ var orderedRenderPhases = [
   "SourceGroupRender",
   "AssignNameToUnnamedComponents",
   "SourceRender",
+  "SourceComponentPropertyValidation",
   "SourceParentAttachment",
   "PortMatching",
   "OptimizeSelectorCache",
@@ -2098,6 +2099,12 @@ var PrimitiveComponent2 = class extends Renderable {
     }
     return `<${cname}#${this._renderId} />`;
   }
+  getDisplayName() {
+    if (this.name) {
+      return `${this.lowercaseComponentName} "${this.name}"`;
+    }
+    return `${this.lowercaseComponentName} (unnamed)`;
+  }
   get [Symbol.toStringTag]() {
     return this.getString();
   }
@@ -10442,6 +10449,7 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
   _isCadModelChild;
   pcb_missing_footprint_error_id;
   _hasStartedFootprintUrlLoad = false;
+  _invalidFootprintPropMessages = [];
   _invalidPinLabelMessages = [];
   /**
    * Set to true to enable automatic silkscreen text adjustment when it overlaps with other components
@@ -10728,7 +10736,13 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
       if (isHttpUrl(footprint)) return;
       if (isStaticAssetPath(footprint)) return;
       if (parseLibraryFootprintRef(footprint)) return;
-      const fpSoup = fp.string(footprint).soup();
+      let fpCircuitJson;
+      try {
+        fpCircuitJson = fp.string(footprint).soup();
+      } catch (error) {
+        this._queueInvalidFootprintPropMessage(footprint, error);
+        return;
+      }
       const fpComponents = createComponentsFromCircuitJson(
         {
           componentName: this.name ?? this.componentName,
@@ -10737,7 +10751,7 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
           pinLabels,
           pcbPinLabels
         },
-        fpSoup
+        fpCircuitJson
       );
       this.addAll(fpComponents);
     }
@@ -11251,9 +11265,15 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
       if (isHttpUrl(footprint)) return [];
       if (isStaticAssetPath(footprint)) return [];
       if (parseLibraryFootprintRef(footprint)) return [];
-      const fpSoup = fp.string(footprint).soup();
+      let fpCircuitJson;
+      try {
+        fpCircuitJson = fp.string(footprint).soup();
+      } catch (error) {
+        this._queueInvalidFootprintPropMessage(footprint, error);
+        return [];
+      }
       const newPorts2 = [];
-      for (const elm of fpSoup) {
+      for (const elm of fpCircuitJson) {
         if ("port_hints" in elm && elm.port_hints) {
           const newPort = getPortFromHints(elm.port_hints, opts);
           if (!newPort) continue;
@@ -11299,6 +11319,26 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
     }
     return newPorts;
   }
+  _queueInvalidFootprintPropMessage(footprint, error) {
+    const rawErrorMessage = error instanceof Error ? error.message : String(error);
+    const isLikelyMissingLibraryPrefix = footprint.includes("/") && !footprint.includes(":");
+    const helpfulHint = isLikelyMissingLibraryPrefix ? ` If this is a KiCad footprint, use "kicad:${footprint}".` : "";
+    const message = `Invalid footprint prop on ${this.getDisplayName()}: "${footprint}".${helpfulHint} Parser details: ${rawErrorMessage}`;
+    if (!this._invalidFootprintPropMessages.includes(message)) {
+      this._invalidFootprintPropMessages.push(message);
+    }
+  }
+  _insertInvalidFootprintPropErrors() {
+    for (const message of this._invalidFootprintPropMessages) {
+      this.root.db.source_invalid_component_property_error.insert({
+        source_component_id: this.source_component_id || "",
+        property_name: "footprint",
+        message,
+        error_type: "source_invalid_component_property_error"
+      });
+    }
+    this._invalidFootprintPropMessages = [];
+  }
   getPortsFromSchematicSymbol() {
     if (this.root?.schematicDisabled) return [];
     const { config } = this;
@@ -11663,6 +11703,9 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
   doInitialSourceDesignRuleChecks() {
     NormalComponent_doInitialSourceDesignRuleChecks(this);
   }
+  doInitialSourceComponentPropertyValidation() {
+    this._insertInvalidFootprintPropErrors();
+  }
   doInitialValidatePcbCoordinates() {
     super.doInitialValidatePcbCoordinates();
     if (this.root?.pcbDisabled) return;
@@ -19037,7 +19080,7 @@ import { identity as identity5 } from "transformation-matrix";
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.1141",
+  version: "0.0.1143",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -19074,7 +19117,7 @@ var package_default = {
     "@tscircuit/circuit-json-util": "^0.0.90",
     "@tscircuit/common": "^0.0.20",
     "@tscircuit/copper-pour-solver": "^0.0.20",
-    "@tscircuit/footprinter": "^0.0.338",
+    "@tscircuit/footprinter": "^0.0.346",
     "@tscircuit/infer-cable-insertion-point": "^0.0.2",
     "@tscircuit/infgrid-ijump-astar": "^0.0.35",
     "@tscircuit/log-soup": "^1.0.2",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tscircuit/core",
   "type": "module",
-  "version": "0.0.1142",
+  "version": "0.0.1144",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -38,7 +38,7 @@
     "@tscircuit/circuit-json-util": "^0.0.90",
     "@tscircuit/common": "^0.0.20",
     "@tscircuit/copper-pour-solver": "^0.0.20",
-    "@tscircuit/footprinter": "^0.0.338",
+    "@tscircuit/footprinter": "^0.0.346",
     "@tscircuit/infer-cable-insertion-point": "^0.0.2",
     "@tscircuit/infgrid-ijump-astar": "^0.0.35",
     "@tscircuit/log-soup": "^1.0.2",