@tscircuit/core 0.0.1944 → 0.0.1946

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as circuit_json from 'circuit-json';
 import { PcbGroup, PcbTraceError, PcbPlacementError, PcbManualEditConflictWarning, PcbViaClearanceError, PcbVia as PcbVia$1, LayerRef, AnyCircuitElement, Size, PcbTrace as PcbTrace$1, PcbTraceRoutePoint, AnySourceComponent, PcbComponent, SchematicPort, SchematicComponent, SimulationVoltageSource, SimulationCurrentSource, PcbSilkscreenGraphic, SourceBus, RouteHintPoint, PcbBoard, SchematicSheet as SchematicSheet$1, SchematicGraphic as SchematicGraphic$1, SimulationExperiment, SimulationParameterSweep, CircuitJson } from 'circuit-json';
 import * as _tscircuit_props from '@tscircuit/props';
-import { PlatformConfig, traceProps, netProps, AutoroutingPhaseProps, AutorouterProp, subcircuitGroupProps, AutorouterConfig, PcbSx, portProps, PinAttributeMap, SupplierPartNumbers, CadModelProp, SchematicPortArrangement, groupProps, platedHoleProps, BoardOutlinePoint, boardProps, subcircuitProps, subpanelProps, capacitorProps, antennaProps, chipProps, pinoutProps, diodeProps, fuseProps, jumperProps, interconnectProps, solderjumperProps, ledProps, powerSourceProps, voltageSourceProps, currentSourceProps, ammeterProps, resistorProps, constraintProps, drcCheckProps, autoroutingPhaseProps, fabricationNoteRectProps, fabricationNotePathProps, fabricationNoteTextProps, fabricationNoteDimensionProps, pcbNoteLineProps, pcbNoteRectProps, pcbNoteTextProps, pcbNotePathProps, pcbNoteDimensionProps, footprintProps, breakoutProps, breakoutPointProps, holeProps, pcbKeepoutProps, netLabelProps, cadmodelProps, cadassemblyProps, courtyardCircleProps, courtyardOutlineProps, courtyardRectProps, silkscreenCircleProps, silkscreenPathProps, silkscreenRectProps, silkscreenTextProps, silkscreenLineProps, silkscreenGraphicProps, smtPadProps, fiducialProps, busProps, differentialPairProps, traceHintProps, viaProps, copperPourProps, copperTextProps, cutoutProps, assemblyDeviceProps, enclosureCutoutApertureProps, enclosureFdmBoxProps, batteryProps, pinHeaderProps, resonatorProps, inductorProps, potentiometerProps, pushButtonProps, crystalProps, CrystalPinLabels, transistorProps, mosfetProps, opampProps, OpAmpPinLabels, switchProps, SwitchProps, testpointProps, schematicTextProps, schematicLineProps, schematicRectProps, schematicArcProps, schematicCircleProps, schematicPathProps, schematicBoxProps, schematicSymbolProps, schematicSectionProps, schematicSheetProps, schematicGraphicProps, schematicTableProps, schematicRowProps, schematicCellProps, symbolProps, analogSimulationProps, analogTransientSimulationProps, analogDcOperatingPointSimulationProps, analogDcSweepSimulationProps, analogAcSweepSimulationProps, analogSweepParameterProps, voltageProbeProps, spicemodelProps, AnalogTransientSimulationProps, AnalogDcSweepSimulationProps, AnalogAcSweepSimulationProps, AnalogSweepParameterProps, AssemblyDevicePropsInput, EnclosureCutoutApertureProps, EnclosureFdmBoxProps, CapacitorProps, ChipProps, DiodeProps, ResistorProps, ManualEditEvent, ManualEditsFile, ChipConnections, manual_edits_file } from '@tscircuit/props';
+import { PlatformConfig, traceProps, netProps, AutoroutingPhaseProps, AutorouterProp, subcircuitGroupProps, AutorouterConfig, PcbSx, portProps, PinAttributeMap, SupplierPartNumbers, CadModelProp, SchematicPortArrangement, groupProps, platedHoleProps, BoardOutlinePoint, boardProps, subcircuitProps, subpanelProps, capacitorProps, antennaProps, chipProps, pinoutProps, diodeProps, fuseProps, jumperProps, interconnectProps, solderjumperProps, ledProps, powerSourceProps, voltageSourceProps, currentSourceProps, ammeterProps, resistorProps, constraintProps, drcCheckProps, autoroutingPhaseProps, fabricationNoteRectProps, fabricationNotePathProps, fabricationNoteTextProps, fabricationNoteDimensionProps, pcbNoteLineProps, pcbNoteRectProps, pcbNoteTextProps, pcbNotePathProps, pcbNoteDimensionProps, footprintProps, breakoutProps, breakoutPointProps, holeProps, pcbKeepoutProps, netLabelProps, cadmodelProps, cadassemblyProps, courtyardCircleProps, courtyardOutlineProps, courtyardRectProps, silkscreenCircleProps, silkscreenPathProps, silkscreenRectProps, silkscreenTextProps, silkscreenLineProps, silkscreenGraphicProps, smtPadProps, fiducialProps, busProps, differentialPairProps, traceHintProps, viaProps, copperPourProps, copperTextProps, cutoutProps, assemblyDeviceProps, assemblyScreenProps, enclosureCutoutApertureProps, enclosureFdmBoxProps, batteryProps, pinHeaderProps, resonatorProps, inductorProps, potentiometerProps, pushButtonProps, crystalProps, CrystalPinLabels, transistorProps, mosfetProps, opampProps, OpAmpPinLabels, switchProps, SwitchProps, testpointProps, schematicTextProps, schematicLineProps, schematicRectProps, schematicArcProps, schematicCircleProps, schematicPathProps, schematicBoxProps, schematicSymbolProps, schematicSectionProps, schematicSheetProps, schematicGraphicProps, schematicTableProps, schematicRowProps, schematicCellProps, symbolProps, analogSimulationProps, analogTransientSimulationProps, analogDcOperatingPointSimulationProps, analogDcSweepSimulationProps, analogAcSweepSimulationProps, analogSweepParameterProps, voltageProbeProps, spicemodelProps, AnalogTransientSimulationProps, AnalogDcSweepSimulationProps, AnalogAcSweepSimulationProps, AnalogSweepParameterProps, AssemblyDevicePropsInput, AssemblyScreenPropsInput, EnclosureCutoutApertureProps, EnclosureFdmBoxProps, CapacitorProps, ChipProps, DiodeProps, ResistorProps, ManualEditEvent, ManualEditsFile, ChipConnections, manual_edits_file } from '@tscircuit/props';
 export { FanoutTracePath, fanoutTracePath, kicadFootprintStrings } from '@tscircuit/props';
 import * as react from 'react';
 import react__default, { ReactElement, ReactNode } from 'react';
@@ -2474,6 +2474,17 @@ declare class NormalComponent<ZodProps extends z.ZodType = any, PortNames extend
     protected _getPcbComponentLayer(): LayerRef;
     _getFootprintOriginalLayer(): LayerRef | undefined;
     protected _getPcbComponentInsertionDirection(componentLayer: LayerRef, rotationDegrees?: number): PcbComponent["insertion_direction"] | undefined;
+    /**
+     * The connector insertion axis as a continuous unit direction in Circuit
+     * JSON's board-world XYZ frame (+Z above the board). This is a direction, not
+     * a position, so it has no units or translation. It receives the same
+     * rotation and layer flip as the footprint's pads.
+     */
+    _getPcbComponentInsertionAxisDirection(componentLayer: LayerRef, rotationDegrees?: number): {
+        x: number;
+        y: number;
+        z: number;
+    } | undefined;
     /**
      * The enclosure aperture's outward axis as a continuous unit direction in
      * board XYZ (+Z above the board). It is a direction, not a point, and receives
@@ -109934,10 +109945,10 @@ declare class Cutout extends PrimitiveComponent<typeof cutoutProps> {
 }
 
 /**
- * An assembly device container is a product-level wrapper (today only `<assembly.device>`)
- * that may sit above a `<board>` without being an electrical group or
- * subcircuit. Components that would otherwise assume "my parent is a
- * subcircuit" use this to opt out.
+ * An assembly-device element is a product-level `<assembly.device>` wrapper or
+ * a semantic subtype such as `<assembly.screen>`. It is not an electrical group
+ * or subcircuit. Components that would otherwise assume "my parent is a
+ * subcircuit" use this marker to opt out.
  */
 interface AssemblyDeviceContainer {
     isAssemblyDeviceContainer: true;
@@ -109960,6 +109971,48 @@ declare class AssemblyDevice extends PrimitiveComponent<typeof assemblyDevicePro
     _computePcbGlobalTransformBeforeLayout(): Matrix;
 }
 
+declare class AssemblyScreen extends PrimitiveComponent<typeof assemblyScreenProps> implements AssemblyDeviceContainer {
+    isAssemblyDeviceContainer: true;
+    get config(): {
+        componentName: string;
+        zodProps: zod.ZodEffects<zod.ZodObject<{
+            name: zod.ZodEffects<zod.ZodString, string, string>;
+            connectsTo: zod.ZodEffects<zod.ZodString, string, string>;
+            width: zod.ZodOptional<zod.ZodEffects<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>, number, string | number>>;
+            height: zod.ZodOptional<zod.ZodEffects<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>, number, string | number>>;
+            cadModel: zod.ZodOptional<zod.ZodEffects<zod.ZodString, string, string>>;
+        }, "strip", zod.ZodTypeAny, {
+            name: string;
+            connectsTo: string;
+            width?: number | undefined;
+            height?: number | undefined;
+            cadModel?: string | undefined;
+        }, {
+            name: string;
+            connectsTo: string;
+            width?: string | number | undefined;
+            height?: string | number | undefined;
+            cadModel?: string | undefined;
+        }>, {
+            name: string;
+            connectsTo: string;
+            width?: number | undefined;
+            height?: number | undefined;
+            cadModel?: string | undefined;
+        }, {
+            name: string;
+            connectsTo: string;
+            width?: string | number | undefined;
+            height?: string | number | undefined;
+            cadModel?: string | undefined;
+        }>;
+    };
+    doInitialAssignNameToUnnamedComponents(): void;
+    doInitialSourceRender(): void;
+    doInitialPcbComponentRender(): void;
+    doInitialCadModelRender(): void;
+}
+
 interface GetFdmEnclosureSolverInputParams {
     board: Board;
     pcbBoard: PcbBoard;
@@ -192031,8 +192084,11 @@ declare const analog: {
 interface AssemblyDeviceJsxProps extends AssemblyDevicePropsInput {
     children?: ReactNode;
 }
+interface AssemblyScreenJsxProps extends AssemblyScreenPropsInput {
+}
 declare const assembly: {
     readonly device: react.FunctionComponent<AssemblyDeviceJsxProps>;
+    readonly screen: react.FunctionComponent<AssemblyScreenJsxProps>;
 };
 
 declare const enclosure: {
@@ -193792,4 +193848,4 @@ declare module "react/jsx-runtime" {
     }
 }
 
-export { Ammeter, AnalogAcSweepSimulation, AnalogAnalysisSimulation, AnalogDcOperatingPointSimulation, AnalogDcSweepSimulation, AnalogSimulation, AnalogSweepParameter, AnalogTransientSimulation, Antenna, AssemblyDevice, type AssemblyDeviceJsxProps, type AsyncEffect, type AutorouterCompleteEvent, type AutorouterErrorEvent, type AutorouterEvent, type AutorouterProgressEvent, type AutoroutingCacheDisabledReason, type AutoroutingCacheStatus, type AutoroutingEndEvent, type AutoroutingErrorEvent, type AutoroutingExecutionMetadata, AutoroutingPhase, type AutoroutingProgressEvent, type AutoroutingStartEvent, Battery, Board, Breakout, BreakoutPoint, Bus, CadAssembly, CadModel, Capacitor, Chip, Circuit, type CircuitJsonMetadata, type ComponentWithPins, Connector, Constraint, CopperPour, CopperText, CourtyardCircle, CourtyardOutline, CourtyardRect, Crystal, CurrentSource, Cutout, type DebugLogOutputEvent, DifferentialPair, Diode, DrcCheck, EnclosureCutoutAperture, EnclosureFdmBox, FabricationNoteDimension, FabricationNotePath, FabricationNoteRect, FabricationNoteText, Breakout as Fanout, BreakoutPoint as FanoutPoint, Fiducial, Footprint, Fuse, type GenericConnectionsAndSelectorsSel, type GenericLocalAutorouter, Group, Hole, type IIsolatedCircuit, type IRenderable, type IRootCircuit, Inductor, Interconnect, IsolatedCircuit, Jumper, Keepout, Led, type LocalCacheEngine, Mosfet, MountedBoard, Net, NetLabel, NormalComponent, type Obstacle, OpAmp, type PackingEndEvent, type PackingErrorEvent, type PackingStartEvent, Panel, type PcbGroupId, PcbNoteDimension, PcbNoteLine, PcbNotePath, PcbNoteRect, PcbNoteText, PcbTrace, PcbVia, PinHeader, type PinLabelSpec, Pinout, PlatedHole, Port, Potentiometer, PowerSource, PrimitiveComponent, Project, PushButton, type RenderPhase, type RenderPhaseFn, type RenderPhaseFunctions, type RenderPhaseStates, Renderable, Resistor, Resonator, RootCircuit, type RootCircuitEventName, SOLVERS, SchematicArc, SchematicBox, SchematicCell, SchematicCircle, SchematicGraphic, SchematicLine, SchematicPath, SchematicRect, SchematicRow, SchematicSection, SchematicSheet, SchematicSymbol, SchematicTable, SchematicText, type Sel, SilkscreenCircle, SilkscreenGraphic, SilkscreenLine, SilkscreenPath, SilkscreenRect, SilkscreenText, type SimpleRouteBounds, type SimpleRouteBus, type SimpleRouteBusTermination, type SimpleRouteConnection, type SimpleRouteDifferentialPair, type SimpleRouteJson, type SimpleRoutePoint, type SimplifiedPcbTrace, type SingleLayerConnectionPoint, SmtPad, SolderJumper, type SolverEndedEvent, type SolverName, type SolverStartedEvent, SpiceModel, type SrjConnectionName, Subcircuit, Subpanel, Switch, SymbolComponent as Symbol, TestPoint, Trace, TraceHint, Transistor, Via, VoltageProbe, VoltageSource, analog, applyEditEvents, applyEditEventsToManualEditsFile, applyPcbEditEventsToManualEditsFile, applySchematicEditEventsToManualEditsFile, assembly, createUseComponent, enclosure, getPhaseTimingsFromRenderEvents, getSimpleRouteJsonFromCircuitJson, normalizePinLabels, orderedRenderPhases, renderPhaseIndexMap, resolveStaticFileImport, sel, unrouteCircuitJson, useCapacitor, useChip, useDiode, useLed, useRenderedCircuit, useResistor };
+export { Ammeter, AnalogAcSweepSimulation, AnalogAnalysisSimulation, AnalogDcOperatingPointSimulation, AnalogDcSweepSimulation, AnalogSimulation, AnalogSweepParameter, AnalogTransientSimulation, Antenna, AssemblyDevice, type AssemblyDeviceJsxProps, AssemblyScreen, type AssemblyScreenJsxProps, type AsyncEffect, type AutorouterCompleteEvent, type AutorouterErrorEvent, type AutorouterEvent, type AutorouterProgressEvent, type AutoroutingCacheDisabledReason, type AutoroutingCacheStatus, type AutoroutingEndEvent, type AutoroutingErrorEvent, type AutoroutingExecutionMetadata, AutoroutingPhase, type AutoroutingProgressEvent, type AutoroutingStartEvent, Battery, Board, Breakout, BreakoutPoint, Bus, CadAssembly, CadModel, Capacitor, Chip, Circuit, type CircuitJsonMetadata, type ComponentWithPins, Connector, Constraint, CopperPour, CopperText, CourtyardCircle, CourtyardOutline, CourtyardRect, Crystal, CurrentSource, Cutout, type DebugLogOutputEvent, DifferentialPair, Diode, DrcCheck, EnclosureCutoutAperture, EnclosureFdmBox, FabricationNoteDimension, FabricationNotePath, FabricationNoteRect, FabricationNoteText, Breakout as Fanout, BreakoutPoint as FanoutPoint, Fiducial, Footprint, Fuse, type GenericConnectionsAndSelectorsSel, type GenericLocalAutorouter, Group, Hole, type IIsolatedCircuit, type IRenderable, type IRootCircuit, Inductor, Interconnect, IsolatedCircuit, Jumper, Keepout, Led, type LocalCacheEngine, Mosfet, MountedBoard, Net, NetLabel, NormalComponent, type Obstacle, OpAmp, type PackingEndEvent, type PackingErrorEvent, type PackingStartEvent, Panel, type PcbGroupId, PcbNoteDimension, PcbNoteLine, PcbNotePath, PcbNoteRect, PcbNoteText, PcbTrace, PcbVia, PinHeader, type PinLabelSpec, Pinout, PlatedHole, Port, Potentiometer, PowerSource, PrimitiveComponent, Project, PushButton, type RenderPhase, type RenderPhaseFn, type RenderPhaseFunctions, type RenderPhaseStates, Renderable, Resistor, Resonator, RootCircuit, type RootCircuitEventName, SOLVERS, SchematicArc, SchematicBox, SchematicCell, SchematicCircle, SchematicGraphic, SchematicLine, SchematicPath, SchematicRect, SchematicRow, SchematicSection, SchematicSheet, SchematicSymbol, SchematicTable, SchematicText, type Sel, SilkscreenCircle, SilkscreenGraphic, SilkscreenLine, SilkscreenPath, SilkscreenRect, SilkscreenText, type SimpleRouteBounds, type SimpleRouteBus, type SimpleRouteBusTermination, type SimpleRouteConnection, type SimpleRouteDifferentialPair, type SimpleRouteJson, type SimpleRoutePoint, type SimplifiedPcbTrace, type SingleLayerConnectionPoint, SmtPad, SolderJumper, type SolverEndedEvent, type SolverName, type SolverStartedEvent, SpiceModel, type SrjConnectionName, Subcircuit, Subpanel, Switch, SymbolComponent as Symbol, TestPoint, Trace, TraceHint, Transistor, Via, VoltageProbe, VoltageSource, analog, applyEditEvents, applyEditEventsToManualEditsFile, applyPcbEditEventsToManualEditsFile, applySchematicEditEventsToManualEditsFile, assembly, createUseComponent, enclosure, getPhaseTimingsFromRenderEvents, getSimpleRouteJsonFromCircuitJson, normalizePinLabels, orderedRenderPhases, renderPhaseIndexMap, resolveStaticFileImport, sel, unrouteCircuitJson, useCapacitor, useChip, useDiode, useLed, useRenderedCircuit, useResistor };

package/dist/index.js

@@ -17,6 +17,7 @@ __export(components_exports, {
   AnalogTransientSimulation: () => AnalogTransientSimulation,
   Antenna: () => Antenna,
   AssemblyDevice: () => AssemblyDevice,
+  AssemblyScreen: () => AssemblyScreen,
   AutoroutingPhase: () => AutoroutingPhase,
   Battery: () => Battery,
   Board: () => Board,
@@ -15849,6 +15850,24 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
       })
     });
   }
+  /**
+   * The connector insertion axis as a continuous unit direction in Circuit
+   * JSON's board-world XYZ frame (+Z above the board). This is a direction, not
+   * a position, so it has no units or translation. It receives the same
+   * rotation and layer flip as the footprint's pads.
+   */
+  _getPcbComponentInsertionAxisDirection(componentLayer, rotationDegrees = this.getGlobalTransformRotation()) {
+    const footprintMetadata = this._getFootprintMetadataForPcbComponent();
+    if (!footprintMetadata?.insertionDirection) return void 0;
+    return transformFootprintInsertionDirectionVector({
+      insertionDirection: footprintMetadata.insertionDirection,
+      rotationDegrees,
+      isFlipped: isFootprintFlipped({
+        componentLayer,
+        originalLayer: footprintMetadata.originalLayer
+      })
+    });
+  }
   /**
    * The enclosure aperture's outward axis as a continuous unit direction in
    * board XYZ (+Z above the board). It is a direction, not a point, and receives
@@ -63442,7 +63461,7 @@ function Group_getRoutingPhasePlans(group) {
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.1943",
+  version: "0.0.1945",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -63478,7 +63497,7 @@ var package_default = {
     "@tscircuit/bga-fanout-solver": "github:tscircuit/bga-fanout-solver#247c835cb8d69b65e53891dcf869731079415b39",
     "@tscircuit/bus-lanes-solver": "github:tscircuit/bus-lanes-solver#0bc8d071241b18a3e7465a878881abe4998f6384",
     "@tscircuit/capacity-autorouter": "^0.0.913",
-    "@tscircuit/checks": "^0.0.203",
+    "@tscircuit/checks": "^0.0.204",
     "@tscircuit/circuit-json-util": "^0.0.114",
     "@tscircuit/common": "^0.0.20",
     "@tscircuit/copper-pour-solver": "^0.0.54",
@@ -75379,6 +75398,172 @@ var AssemblyDevice = class extends PrimitiveComponent2 {
   // changing the authoring element or its assembly-container semantics.
 };
 
+// lib/components/primitive-components/AssemblyScreen.ts
+import { assemblyScreenProps } from "@tscircuit/props";
+
+// lib/components/primitive-components/AssemblyScreen_doInitialCadModelRender.ts
+import { normalizeDegrees as normalizeDegrees8 } from "@tscircuit/math-utils";
+
+// lib/components/primitive-components/get-assembly-screen-target.ts
+import { selectAll as selectAll2 } from "css-select";
+var getAssemblyScreenTarget = (component, connectsTo) => {
+  const rootComponent = component.root?.firstChild;
+  if (!rootComponent) {
+    throw new Error(
+      `Could not resolve assembly.screen "${component.name}" because the circuit has no root component`
+    );
+  }
+  let selectionScope = rootComponent;
+  let ancestor = component.parent;
+  while (ancestor) {
+    if (ancestor.componentName === "AssemblyDevice") {
+      selectionScope = ancestor;
+      break;
+    }
+    ancestor = ancestor.parent;
+  }
+  const matches = selectAll2(
+    preprocessSelector(connectsTo, component),
+    selectionScope,
+    { adapter: cssSelectPrimitiveComponentAdapter }
+  );
+  if (matches.length !== 1) {
+    throw new Error(
+      `assembly.screen "${component.name}" connectsTo selector "${connectsTo}" matched ${matches.length} components; expected exactly one`
+    );
+  }
+  const target = matches[0];
+  if (!target.pcb_component_id) {
+    throw new Error(
+      `assembly.screen "${component.name}" connectsTo selector "${connectsTo}" matched ${target.getString()}, but it has no PCB component`
+    );
+  }
+  return target;
+};
+
+// lib/components/primitive-components/AssemblyScreen_doInitialCadModelRender.ts
+var formatMillimetersForModelprinter = (millimeters) => Number(millimeters.toFixed(6)).toString();
+var getDefaultFlexScreenModel = (component) => {
+  const { width, height } = component._parsedProps;
+  if (width === void 0 || height === void 0) {
+    throw new Error(
+      `assembly.screen "${component.name}" requires both width and height when cadModel is omitted`
+    );
+  }
+  return `flexscreen_w${formatMillimetersForModelprinter(width)}mm_h${formatMillimetersForModelprinter(height)}mm`;
+};
+var AssemblyScreen_doInitialCadModelRender = (component) => {
+  const root = component.root;
+  if (!root || root.pcbDisabled || !component.source_component_id || !component.pcb_component_id) {
+    return;
+  }
+  const { db } = root;
+  const props = component._parsedProps;
+  const target = getAssemblyScreenTarget(component, props.connectsTo);
+  const targetPcbComponent = db.pcb_component.get(target.pcb_component_id);
+  if (!targetPcbComponent) {
+    throw new Error(
+      `assembly.screen "${component.name}" could not read the PCB component selected by "${props.connectsTo}"`
+    );
+  }
+  const board = target._getBoard();
+  if (!board) {
+    throw new Error(
+      `assembly.screen "${component.name}" target "${props.connectsTo}" is not on a board`
+    );
+  }
+  const pcbBoard = board.pcb_board_id ? db.pcb_board.get(board.pcb_board_id) : null;
+  const boardThickness = pcbBoard?.thickness ?? board.boardThickness;
+  const layer = targetPcbComponent.layer === "bottom" ? "bottom" : "top";
+  const isBottomLayer = layer === "bottom";
+  const targetRotation = targetPcbComponent.rotation ?? 0;
+  const insertionAxis = target instanceof NormalComponent3 ? target._getPcbComponentInsertionAxisDirection(layer, targetRotation) : void 0;
+  const insertionAxisLength = insertionAxis ? Math.hypot(insertionAxis.x, insertionAxis.y) : 0;
+  const cableInsertionCenter = targetPcbComponent.cable_insertion_center ?? targetPcbComponent.center;
+  const inferredCableAxis = {
+    x: cableInsertionCenter.x - targetPcbComponent.center.x,
+    y: cableInsertionCenter.y - targetPcbComponent.center.y
+  };
+  const inferredCableAxisLength = Math.hypot(
+    inferredCableAxis.x,
+    inferredCableAxis.y
+  );
+  const screenBoardRotation = normalizeDegrees8(
+    insertionAxis && insertionAxisLength > 1e-9 ? Math.atan2(-insertionAxis.x, insertionAxis.y) * 180 / Math.PI : inferredCableAxisLength > 1e-9 ? Math.atan2(-inferredCableAxis.x, inferredCableAxis.y) * 180 / Math.PI : targetRotation
+  );
+  db.pcb_component.update(component.pcb_component_id, {
+    center: cableInsertionCenter,
+    layer,
+    rotation: screenBoardRotation,
+    subcircuit_id: targetPcbComponent.subcircuit_id
+  });
+  const cadComponent = db.cad_component.insert({
+    position: {
+      x: cableInsertionCenter.x,
+      y: cableInsertionCenter.y,
+      z: isBottomLayer ? -boardThickness / 2 : boardThickness / 2
+    },
+    rotation: {
+      x: 0,
+      y: isBottomLayer ? 180 : 0,
+      z: normalizeDegrees8(
+        isBottomLayer ? -screenBoardRotation : screenBoardRotation
+      )
+    },
+    pcb_component_id: component.pcb_component_id,
+    source_component_id: component.source_component_id,
+    subcircuit_id: targetPcbComponent.subcircuit_id,
+    footprinter_string: props.cadModel ?? getDefaultFlexScreenModel(component),
+    model_unit_to_mm_scale_factor: 1,
+    model_object_fit: "contain_within_bounds",
+    model_origin_position: { x: 0, y: 0, z: 0 },
+    anchor_alignment: "center",
+    show_as_translucent_model: false
+  });
+  component.cad_component_id = cadComponent.cad_component_id;
+};
+
+// lib/components/primitive-components/AssemblyScreen.ts
+var AssemblyScreen = class extends PrimitiveComponent2 {
+  isAssemblyDeviceContainer = true;
+  get config() {
+    return {
+      componentName: "AssemblyScreen",
+      zodProps: assemblyScreenProps
+    };
+  }
+  doInitialAssignNameToUnnamedComponents() {
+    if (this._parsedProps.name) return;
+    throw new Error("assembly.screen requires a non-empty name");
+  }
+  doInitialSourceRender() {
+    const sourceComponent = this.root.db.source_component.insert({
+      ftype: "simple_chip",
+      name: this.name
+    });
+    this.source_component_id = sourceComponent.source_component_id;
+  }
+  doInitialPcbComponentRender() {
+    const root = this.root;
+    if (!root || root.pcbDisabled || !this.source_component_id) return;
+    const pcbComponent = root.db.pcb_component.insert({
+      center: { x: 0, y: 0 },
+      width: 0,
+      height: 0,
+      layer: "top",
+      rotation: 0,
+      source_component_id: this.source_component_id,
+      obstructs_within_bounds: false,
+      do_not_place: true,
+      is_allowed_to_be_off_board: true
+    });
+    this.pcb_component_id = pcbComponent.pcb_component_id;
+  }
+  doInitialCadModelRender() {
+    AssemblyScreen_doInitialCadModelRender(this);
+  }
+};
+
 // lib/components/primitive-components/EnclosureCutoutAperture/EnclosureCutoutAperture.ts
 import { enclosureCutoutApertureProps } from "@tscircuit/props";
 
@@ -77798,7 +77983,8 @@ var analog = {
 
 // lib/namespaced-elements/assembly.ts
 var assembly = {
-  device: createNamespacedElement("assembly.device")
+  device: createNamespacedElement("assembly.device"),
+  screen: createNamespacedElement("assembly.screen")
 };
 
 // lib/namespaced-elements/enclosure.ts
@@ -78038,6 +78224,7 @@ import { kicadFootprintStrings } from "@tscircuit/props";
 extendCatalogue(components_exports);
 extendCatalogue({
   "assembly.device": AssemblyDevice,
+  "assembly.screen": AssemblyScreen,
   Bug: Chip,
   "enclosure.cutoutaperture": EnclosureCutoutAperture,
   "enclosure.fdm.box": EnclosureFdmBox,
@@ -78058,6 +78245,7 @@ export {
   AnalogTransientSimulation,
   Antenna,
   AssemblyDevice,
+  AssemblyScreen,
   AutoroutingPhase,
   Battery,
   Board,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tscircuit/core",
   "type": "module",
-  "version": "0.0.1944",
+  "version": "0.0.1946",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -37,7 +37,7 @@
     "@tscircuit/bga-fanout-solver": "github:tscircuit/bga-fanout-solver#247c835cb8d69b65e53891dcf869731079415b39",
     "@tscircuit/bus-lanes-solver": "github:tscircuit/bus-lanes-solver#0bc8d071241b18a3e7465a878881abe4998f6384",
     "@tscircuit/capacity-autorouter": "^0.0.913",
-    "@tscircuit/checks": "^0.0.203",
+    "@tscircuit/checks": "^0.0.204",
     "@tscircuit/circuit-json-util": "^0.0.114",
     "@tscircuit/common": "^0.0.20",
     "@tscircuit/copper-pour-solver": "^0.0.54",