@tscircuit/props 0.0.604 → 0.0.606

package/README.md

@@ -393,6 +393,8 @@ export interface BoardProps extends Omit<
   bottomSilkscreenColor?: BoardColor;
   /** Whether the board should be assembled on both sides */
   doubleSidedAssembly?: boolean;
+  /** Whether vias may be placed inside PCB pads */
+  isViaInPadAllowed?: boolean;
   /** Whether this board should be omitted from the schematic view */
   schematicDisabled?: boolean;
 }

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as zod from 'zod';
 import { z } from 'zod';
 import * as react from 'react';
 import { ReactElement, ReactNode } from 'react';
-import { LayerRef, AnyCircuitElement, LayerRefInput, SourceNet, PcbPort, SourcePort, PcbComponent, SourceComponentBase, CircuitJsonError, Point as Point$1, RouteHintPoint, PcbTrace, AnySourceComponent, VisibleLayer, RouteHintPointInput } from 'circuit-json';
+import { LayerRef, AnyCircuitElement, LayerRefInput, SourceNet, PcbPort, SourcePort, PcbComponent, SourceComponentBase, CircuitJsonError, Point as Point$1, RouteHintPoint, PcbTrace, AnySourceComponent, InsertionDirectionInput, VisibleLayer, RouteHintPointInput } from 'circuit-json';
 
 declare const direction: z.ZodEnum<["up", "down", "left", "right"]>;
 type Direction = "up" | "down" | "left" | "right";
@@ -24705,6 +24705,8 @@ interface BoardProps extends Omit<SubcircuitGroupProps, "subcircuit" | "connecti
     bottomSilkscreenColor?: BoardColor;
     /** Whether the board should be assembled on both sides */
     doubleSidedAssembly?: boolean;
+    /** Whether vias may be placed inside PCB pads */
+    isViaInPadAllowed?: boolean;
     /** Whether this board should be omitted from the schematic view */
     schematicDisabled?: boolean;
 }
@@ -25498,6 +25500,7 @@ declare const boardProps: z.ZodObject<Omit<{
     topSilkscreenColor: z.ZodOptional<z.ZodType<BoardColor, z.ZodTypeDef, BoardColor>>;
     bottomSilkscreenColor: z.ZodOptional<z.ZodType<BoardColor, z.ZodTypeDef, BoardColor>>;
     doubleSidedAssembly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    isViaInPadAllowed: z.ZodOptional<z.ZodBoolean>;
     schematicDisabled: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     layers: 1 | 2 | 4 | 6 | 8 | 10;
@@ -25834,6 +25837,7 @@ declare const boardProps: z.ZodObject<Omit<{
     silkscreenColor?: BoardColor | undefined;
     topSilkscreenColor?: BoardColor | undefined;
     bottomSilkscreenColor?: BoardColor | undefined;
+    isViaInPadAllowed?: boolean | undefined;
     schematicDisabled?: boolean | undefined;
 }, {
     symbol?: SymbolProp | undefined;
@@ -26174,6 +26178,7 @@ declare const boardProps: z.ZodObject<Omit<{
     topSilkscreenColor?: BoardColor | undefined;
     bottomSilkscreenColor?: BoardColor | undefined;
     doubleSidedAssembly?: boolean | undefined;
+    isViaInPadAllowed?: boolean | undefined;
     schematicDisabled?: boolean | undefined;
 }>;
 
@@ -90143,6 +90148,7 @@ declare const stampboardProps: z.ZodObject<Omit<{
     topSilkscreenColor: z.ZodOptional<z.ZodType<BoardColor, z.ZodTypeDef, BoardColor>>;
     bottomSilkscreenColor: z.ZodOptional<z.ZodType<BoardColor, z.ZodTypeDef, BoardColor>>;
     doubleSidedAssembly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    isViaInPadAllowed: z.ZodOptional<z.ZodBoolean>;
     schematicDisabled: z.ZodOptional<z.ZodBoolean>;
 } & {
     leftPinCount: z.ZodOptional<z.ZodNumber>;
@@ -90494,6 +90500,7 @@ declare const stampboardProps: z.ZodObject<Omit<{
     silkscreenColor?: BoardColor | undefined;
     topSilkscreenColor?: BoardColor | undefined;
     bottomSilkscreenColor?: BoardColor | undefined;
+    isViaInPadAllowed?: boolean | undefined;
     schematicDisabled?: boolean | undefined;
     leftPins?: string[] | undefined;
     rightPins?: string[] | undefined;
@@ -90844,6 +90851,7 @@ declare const stampboardProps: z.ZodObject<Omit<{
     topSilkscreenColor?: BoardColor | undefined;
     bottomSilkscreenColor?: BoardColor | undefined;
     doubleSidedAssembly?: boolean | undefined;
+    isViaInPadAllowed?: boolean | undefined;
     schematicDisabled?: boolean | undefined;
     leftPins?: string[] | undefined;
     rightPins?: string[] | undefined;
@@ -104982,8 +104990,18 @@ declare const differentialPairProps: z.ZodObject<{
     maxLengthSkew?: number | undefined;
 }>;
 
-type FootprintInsertionDirection = "from_above" | "from_left" | "from_right" | "from_front" | "from_back";
-declare const footprintInsertionDirection: z.ZodEnum<["from_above", "from_left", "from_right", "from_front", "from_back"]>;
+/**
+ * Direction a cable or mating part is attached from, named for the side of the
+ * footprint it approaches from.
+ *
+ * Aliased to Circuit JSON's input union so the two cannot drift apart. Both the
+ * named spellings and their Cartesian equivalents are accepted here, as are the
+ * deprecated `from_front` (now `from_top`) and `from_back` (now `from_bottom`).
+ * Core normalizes them to the six named values before writing
+ * `pcb_component.insertion_direction`.
+ */
+type FootprintInsertionDirection = InsertionDirectionInput;
+declare const footprintInsertionDirection: z.ZodEnum<["from_left", "from_right", "from_top", "from_bottom", "from_above", "from_below", "from_x_neg", "from_x_pos", "from_y_pos", "from_y_neg", "from_z_pos", "from_z_neg", "from_front", "from_back"]>;
 interface FootprintProps {
     children?: any;
     name?: string;
@@ -105007,8 +105025,21 @@ interface FootprintProps {
      */
     src?: FootprintProp;
     /**
-     * Direction a cable or mating part is inserted into this footprint in its
-     * unrotated orientation.
+     * Direction a cable or mating part is attached from, in the footprint's own
+     * frame -- the same frame its pads are drawn in. Directions are named for the
+     * footprint as drawn in the 2D PCB view: `from_top` is +Y, `from_bottom` -Y,
+     * `from_left` -X, `from_right` +X, `from_above` +Z and `from_below` -Z.
+     * Cartesian spellings such as `from_y_pos` are also accepted.
+     *
+     * This names a side, not a motion. A receptacle on the +Y edge is `from_top`
+     * because that is the side the plug comes from, even though the plug itself
+     * moves in -Y as it seats.
+     *
+     * This is a property of the part, so it is authored without regard to where
+     * the part is placed. Rotating or flipping the component rotates this with it,
+     * and `pcb_component.insertion_direction` reports the result in board
+     * coordinates. The two frames coincide for an unrotated top-layer part, which
+     * makes the distinction easy to miss.
      */
     insertionDirection?: FootprintInsertionDirection;
 }
@@ -105026,14 +105057,14 @@ declare const footprintProps: z.ZodObject<{
     }>>>;
     circuitJson: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
     src: z.ZodOptional<z.ZodType<FootprintProp, z.ZodTypeDef, FootprintProp>>;
-    insertionDirection: z.ZodOptional<z.ZodEnum<["from_above", "from_left", "from_right", "from_front", "from_back"]>>;
+    insertionDirection: z.ZodOptional<z.ZodEnum<["from_left", "from_right", "from_top", "from_bottom", "from_above", "from_below", "from_x_neg", "from_x_pos", "from_y_pos", "from_y_neg", "from_z_pos", "from_z_neg", "from_front", "from_back"]>>;
 }, "strip", z.ZodTypeAny, {
     name?: string | undefined;
     children?: any;
     circuitJson?: any[] | undefined;
     originalLayer?: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | undefined;
     src?: FootprintProp | undefined;
-    insertionDirection?: "from_above" | "from_left" | "from_right" | "from_front" | "from_back" | undefined;
+    insertionDirection?: "from_left" | "from_right" | "from_top" | "from_bottom" | "from_above" | "from_below" | "from_x_neg" | "from_x_pos" | "from_y_pos" | "from_y_neg" | "from_z_pos" | "from_z_neg" | "from_front" | "from_back" | undefined;
 }, {
     name?: string | undefined;
     children?: any;
@@ -105042,7 +105073,7 @@ declare const footprintProps: z.ZodObject<{
         name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8";
     } | undefined;
     src?: FootprintProp | undefined;
-    insertionDirection?: "from_above" | "from_left" | "from_right" | "from_front" | "from_back" | undefined;
+    insertionDirection?: "from_left" | "from_right" | "from_top" | "from_bottom" | "from_above" | "from_below" | "from_x_neg" | "from_x_pos" | "from_y_pos" | "from_y_neg" | "from_z_pos" | "from_z_neg" | "from_front" | "from_back" | undefined;
 }>;
 type FootprintPropsInput = z.input<typeof footprintProps>;
 

package/dist/index.js

@@ -16565,6 +16565,9 @@ var boardProps = subcircuitGroupProps.omit({ connections: true }).extend({
   topSilkscreenColor: boardColor.optional(),
   bottomSilkscreenColor: boardColor.optional(),
   doubleSidedAssembly: z42.boolean().optional().default(false),
+  isViaInPadAllowed: z42.boolean().optional().describe(
+    "Allows intentional via-in-pad designs to pass DRC. Omitted or false keeps via-in-pad disallowed."
+  ),
   schematicDisabled: z42.boolean().optional()
 });
 expectTypesMatch(true);
@@ -17402,12 +17405,24 @@ var differentialPairProps = z72.object({
 expectTypesMatch(true);
 
 // lib/components/footprint.ts
-import { layer_ref as layer_ref6 } from "circuit-json";
+import {
+  layer_ref as layer_ref6
+} from "circuit-json";
 import { z as z73 } from "zod";
 var footprintInsertionDirection = z73.enum([
-  "from_above",
   "from_left",
   "from_right",
+  "from_top",
+  "from_bottom",
+  "from_above",
+  "from_below",
+  "from_x_neg",
+  "from_x_pos",
+  "from_y_pos",
+  "from_y_neg",
+  "from_z_pos",
+  "from_z_neg",
+  // Deprecated, accepted so existing sources keep type-checking.
   "from_front",
   "from_back"
 ]);
@@ -17419,7 +17434,7 @@ var footprintProps = z73.object({
   circuitJson: z73.array(z73.any()).optional(),
   src: footprintProp.describe("Can be a footprint or kicad string").optional(),
   insertionDirection: footprintInsertionDirection.optional().describe(
-    "Direction a cable or mating part is inserted into this footprint in its unrotated orientation."
+    "Direction a cable or mating part is attached from, named for the side of the footprint it approaches from, in its unrotated orientation."
   )
 });
 expectTypesMatch(true);