source_invalid_component_property_error

Diagnostic signature

source_invalid_component_property_error

Emitted in the compiled Circuit JSON when a user-provided component property fails validation or does not match the expected format.

What it means

The `source_invalid_component_property_error` is a specific diagnostic element included within the `circuit-json` intermediate representation generated by the `tscircuit` compiler. Instead of abruptly halting the compilation process or crashing, the compiler embeds this error object into the output array to indicate that a specific property on a schematic or PCB source component could not be resolved. The diagnostic payload contains identifiers for the failing component (`source_component_id`), the name of the rejected parameter (`property_name`), the actual provided input (`property_value`), and optionally a description of the correct structure (`expected_format`).

Why it happens

This diagnostic is triggered when the `tscircuit` evaluation engine encounters a component property that violates its underlying Zod validation schemas. Common triggers include providing an unparseable or unrecognized unit string (e.g., passing `resistance="bad-value"` instead of a recognized metric identifier like `"10k"`), specifying an unknown footprint format, or supplying the wrong scalar data type for a component configuration. Because `tscircuit` normalizes schematic and PCB parameters into strict mathematical units and standardized string layouts, any deviation results in this structural error being appended to the component's generated `circuit-json` records.

Minimal reproduction

export default () => (
  <board width="10mm" height="10mm">
    <resistor name="R1" resistance="invalid_resistance_value" footprint="0402" />
  </board>
);

How to fix it

Update the component property to use a valid, parseable format as expected by the tscircuit evaluation engine.

```tsx
export default () => (
  <board width="10mm" height="10mm">
    <resistor name="R1" resistance="10k" footprint="0402" />
  </board>
);
```

Step 1

• Locate the component and the specific property indicated by the `source_component_id` and `property_name` fields in the diagnostic payload.

Step 2

• Check the emitted `expected_format` string (if present) to understand the required syntactic structure or data type.

Step 3

• Replace the malformed `property_value` with a strictly formatted standard string, such as a proper SI value (e.g., `"10k"`, `"100nF"`) or a recognized footprint name.

Upstream references

circuit-json [email protected] — SourceInvalidComponentPropertyError — retrieved 2026-08-11

source_invalid_component_property_error.ts source declaration