@windypro-rourou/dsh-eda 0.1.4 → 0.1.6

package/skill/references/classes/IPCB_PrimitiveComponent.md

@@ -1,2627 +1,2624 @@
-# IPCB\_PrimitiveComponent class
-
-Device primitive
-
-## Signature
-
-```typescript
-class IPCB_PrimitiveComponent implements IPCB_Primitive
-```
-**Implements:** [IPCB\_Primitive](../interfaces/IPCB_Primitive.md)
-
-## Remarks
-
-## Methods
-
-<table><thead><tr><th>
-
-Method
-
-</th><th>
-
-Modifiers
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-[done()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Apply the changes to the primitives to the canvas
-
-</td></tr>
-<tr><td>
-
-[getAllPins()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Get all pads associated with the device
-
-</td></tr>
-<tr><td>
-
-[getState\_AddIntoBom()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: whether to add BOM
-
-</td></tr>
-<tr><td>
-
-[getState\_Component()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: associate library device
-
-</td></tr>
-<tr><td>
-
-[getState\_Designator()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: designator
-
-</td></tr>
-<tr><td>
-
-[getState\_Footprint()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: associate library footprint
-
-</td></tr>
-<tr><td>
-
-[getState\_Layer()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: Layer
-
-</td></tr>
-<tr><td>
-
-[getState\_Manufacturer()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: manufacturer
-
-</td></tr>
-<tr><td>
-
-[getState\_ManufacturerId()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: manufacturer ID
-
-</td></tr>
-<tr><td>
-
-[getState\_Model3D()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: associate library 3D model
-
-</td></tr>
-<tr><td>
-
-[getState\_Name()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: name
-
-</td></tr>
-<tr><td>
-
-[getState\_OtherProperty()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: other parameters
-
-</td></tr>
-<tr><td>
-
-[getState\_Pads()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: pad
-
-</td></tr>
-<tr><td>
-
-[getState\_PrimitiveId()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: primitive ID
-
-</td></tr>
-<tr><td>
-
-[getState\_PrimitiveLock()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: whether it is locked
-
-</td></tr>
-<tr><td>
-
-[getState\_PrimitiveType()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: primitive type
-
-</td></tr>
-<tr><td>
-
-[getState\_Rotation()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: rotation angle
-
-</td></tr>
-<tr><td>
-
-[getState\_Supplier()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: supplier
-
-</td></tr>
-<tr><td>
-
-[getState\_SupplierId()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: supplier ID
-
-</td></tr>
-<tr><td>
-
-[getState\_UniqueId()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: unique ID
-
-</td></tr>
-<tr><td>
-
-[getState\_X()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: X coordinate
-
-</td></tr>
-<tr><td>
-
-[getState\_Y()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Get the property state: Y coordinate
-
-</td></tr>
-<tr><td>
-
-[isAsync()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Query whether the primitive is an async primitive
-
-</td></tr>
-<tr><td>
-
-[reset()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Reset the async primitive to the current canvas state
-
-</td></tr>
-<tr><td>
-
-[setAttribute(key, value, keyVisible, valueVisible)](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Set Property
-
-</td></tr>
-<tr><td>
-
-[setState\_AddIntoBom(addIntoBom)](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Set the property state: whether to add BOM
-
-</td></tr>
-<tr><td>
-
-[setState\_Designator(designator)](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Set the property state: designator
-
-</td></tr>
-<tr><td>
-
-[setState\_Layer(layer)](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Set the property state: Layer
-
-</td></tr>
-<tr><td>
-
-[setState\_Manufacturer(manufacturer)](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Set the property state: manufacturer
-
-</td></tr>
-<tr><td>
-
-[setState\_ManufacturerId(manufacturerId)](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Set the property state: manufacturer ID
-
-</td></tr>
-<tr><td>
-
-[setState\_Name(name)](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Set the property state: name
-
-</td></tr>
-<tr><td>
-
-[setState\_OtherProperty(otherProperty)](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Set the property state: other parameters
-
-</td></tr>
-<tr><td>
-
-[setState\_PrimitiveLock(primitiveLock)](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Set the property state: whether it is locked
-
-</td></tr>
-<tr><td>
-
-[setState\_Rotation(rotation)](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Set the property state: rotation angle
-
-</td></tr>
-<tr><td>
-
-[setState\_Supplier(supplier)](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Set the property state: supplier
-
-</td></tr>
-<tr><td>
-
-[setState\_SupplierId(supplierId)](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Set the property state: supplier ID
-
-</td></tr>
-<tr><td>
-
-[setState\_UniqueId(uniqueId)](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Set the property state: unique ID
-
-</td></tr>
-<tr><td>
-
-[setState\_X(x)](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Set the property state: X coordinate
-
-</td></tr>
-<tr><td>
-
-[setState\_Y(y)](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Set the property state: Y coordinate
-
-</td></tr>
-<tr><td>
-
-[toAsync()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Convert Primitive to Async primitive
-
-</td></tr>
-<tr><td>
-
-[toSync()](./IPCB_PrimitiveComponent.md)
-
-</td><td>
-
-</td><td>
-
-Convert Primitive to Sync primitive
-
-</td></tr>
-</tbody></table>
-
----
-
-## 方法详情
-
-### done
-
-# IPCB\_PrimitiveComponent.done() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Apply the changes to the primitives to the canvas
-
-## Signature
-
-```typescript
-function done(): Promise<IPCB_PrimitiveComponent>;
-```
-
-## Returns
-
-Promise&lt;[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)<!-- -->&gt;
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 记录修改前的位号和旋转角度
-const designatorBefore = comp.getState_Designator();
-const rotationBefore = comp.getState_Rotation();
-
-// 4. 批量修改两个属性，一次 done() 提交
-const asyncComp = comp.toAsync();
-asyncComp.setState_Designator('C101');
-asyncComp.setState_Rotation(90);
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认批量修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('designator:', designatorBefore, '→', refetched[0].getState_Designator());
-console.log('rotation:', rotationBefore, '→', refetched[0].getState_Rotation());
-```
-
-### getallpins
-
-# IPCB\_PrimitiveComponent.getAllPins() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Get all pads associated with the device
-
-## Signature
-
-```typescript
-function getAllPins(): Promise<Array<IPCB_PrimitiveComponentPad>>;
-```
-
-## Returns
-
-Promise&lt;Array&lt;[IPCB\_PrimitiveComponentPad](./IPCB_PrimitiveComponentPad.md)<!-- -->&gt;&gt;
-
-Device pad primitive array
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-const compId = comp.getState_PrimitiveId();
-
-// 2. 获取器件关联的所有焊盘图元
-const pins = await comp.getAllPins();
-
-// 3. 逐个读取焊盘的归属器件和图元 ID
-const pinInfos = pins.map(pin => ({
-	parentMatch: pin.getState_ParentComponentPrimitiveId() === compId,
-	primitiveId: pin.getState_PrimitiveId(),
-}));
-
-// 4. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([compId]);
-
-console.log('pinCount:', pins.length);
-console.log('allBelongToComponent:', pinInfos.every(p => p.parentMatch));
-console.log('firstPinPrimitiveId:', pinInfos[0].primitiveId);
-```
-
-### getstate_addintobom
-
-# IPCB\_PrimitiveComponent.getState\_AddIntoBom() method
-
-Get the property state: whether to add BOM
-
-## Signature
-
-```typescript
-function getState_AddIntoBom(): boolean;
-```
-
-## Returns
-
-boolean
-
-Whether Add to BOM
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取是否加入 BOM
-const addIntoBom = comp.getState_AddIntoBom();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('addIntoBom:', addIntoBom);
-```
-
-### getstate_component
-
-# IPCB\_PrimitiveComponent.getState\_Component() method
-
-Get the property state: associate library device
-
-## Signature
-
-```typescript
-function getState_Component():
-	{ libraryUuid: string; uuid: string; name?: undefined | string } | undefined;
-```
-
-## Returns
-
-{ libraryUuid: string; uuid: string; name?: undefined \| string } \| undefined
-
-Associate library device
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取关联的库器件信息
-const component = comp.getState_Component();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('deviceName:', component.name);
-console.log('deviceUuid:', component.uuid);
-console.log('libraryUuid:', component.libraryUuid);
-```
-
-### getstate_designator
-
-# IPCB\_PrimitiveComponent.getState\_Designator() method
-
-Get the property state: designator
-
-## Signature
-
-```typescript
-function getState_Designator(): string | undefined;
-```
-
-## Returns
-
-string \| undefined
-
-Designator
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件（位号由系统自动分配）
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取位号
-const designator = comp.getState_Designator();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('designator:', designator);
-```
-
-### getstate_footprint
-
-# IPCB\_PrimitiveComponent.getState\_Footprint() method
-
-Get the property state: associate library footprint
-
-## Signature
-
-```typescript
-function getState_Footprint():
-	{ libraryUuid: string; uuid: string; name?: undefined | string } | undefined;
-```
-
-## Returns
-
-{ libraryUuid: string; uuid: string; name?: undefined \| string } \| undefined
-
-Associate library footprint
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取关联的库封装信息
-const footprint = comp.getState_Footprint();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('footprintName:', footprint.name);
-console.log('footprintUuid:', footprint.uuid);
-console.log('libraryUuid:', footprint.libraryUuid);
-```
-
-### getstate_layer
-
-# IPCB\_PrimitiveComponent.getState\_Layer() method
-
-Get the property state: Layer
-
-## Signature
-
-```typescript
-function getState_Layer(): TPCB_LayersOfComponent;
-```
-
-## Returns
-
-[TPCB\_LayersOfComponent](../types/TPCB_LayersOfComponent.md)
-
-Layer
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件（默认贴在顶面）
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取所在面（1=顶面, 2=底面）
-const layer = comp.getState_Layer();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('layer:', layer, layer === 1 ? '(顶面)' : '(底面)');
-```
-
-### getstate_manufacturer
-
-# IPCB\_PrimitiveComponent.getState\_Manufacturer() method
-
-Get the property state: manufacturer
-
-## Signature
-
-```typescript
-function getState_Manufacturer(): string | undefined;
-```
-
-## Returns
-
-string \| undefined
-
-Manufacturer
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取制造商
-const manufacturer = comp.getState_Manufacturer();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('manufacturer:', manufacturer);
-```
-
-### getstate_manufacturerid
-
-# IPCB\_PrimitiveComponent.getState\_ManufacturerId() method
-
-Get the property state: manufacturer ID
-
-## Signature
-
-```typescript
-function getState_ManufacturerId(): string | undefined;
-```
-
-## Returns
-
-string \| undefined
-
-Manufacturer ID
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取制造商编号
-const manufacturerId = comp.getState_ManufacturerId();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('manufacturerId:', manufacturerId);
-```
-
-### getstate_model3d
-
-# IPCB\_PrimitiveComponent.getState\_Model3D() method
-
-Get the property state: associate library 3D model
-
-## Signature
-
-```typescript
-function getState_Model3D():
-	{ libraryUuid: string; uuid: string; name?: undefined | string } | undefined;
-```
-
-## Returns
-
-{ libraryUuid: string; uuid: string; name?: undefined \| string } \| undefined
-
-Associate library 3D model
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取关联的 3D 模型信息（未关联时返回 undefined）
-const model3d = comp.getState_Model3D();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('model3dName:', model3d ? model3d.name : '(未关联 3D 模型)');
-console.log('model3dUuid:', model3d ? model3d.uuid : '(未关联 3D 模型)');
-```
-
-### getstate_name
-
-# IPCB\_PrimitiveComponent.getState\_Name() method
-
-Get the property state: name
-
-## Signature
-
-```typescript
-function getState_Name(): string | undefined;
-```
-
-## Returns
-
-string \| undefined
-
-Name
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取名称
-const name = comp.getState_Name();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('name:', name);
-```
-
-### getstate_otherproperty
-
-# IPCB\_PrimitiveComponent.getState\_OtherProperty() method
-
-Get the property state: other parameters
-
-## Signature
-
-```typescript
-function getState_OtherProperty(): Record<string, string | number | boolean> | undefined;
-```
-
-## Returns
-
-Record&lt;string, string \| number \| boolean&gt; \| undefined
-
-Other parameters
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取其它参数字典
-const otherProperty = comp.getState_OtherProperty();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('propertyCount:', Object.keys(otherProperty).length);
-console.log('value:', otherProperty.Value);
-console.log('description:', otherProperty.Description);
-```
-
-### getstate_pads
-
-# IPCB\_PrimitiveComponent.getState\_Pads() method
-
-Get the property state: pad
-
-## Signature
-
-```typescript
-function getState_Pads():
-	Array<{ primitiveId: string; net: string; padNumber: string }> | undefined;
-```
-
-## Returns
-
-Array&lt;{ primitiveId: string; net: string; padNumber: string }&gt; \| undefined
-
-Pad
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取焊盘摘要数据
-const pads = comp.getState_Pads();
-
-// 3. 摘要出每个焊盘的编号与网络
-const padSummaries = pads.map(pad => ({ padNumber: pad.padNumber, net: pad.net }));
-
-// 4. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('padCount:', pads.length);
-console.log('padSummaries:', JSON.stringify(padSummaries));
-```
-
-### getstate_primitiveid
-
-# IPCB\_PrimitiveComponent.getState\_PrimitiveId() method
-
-Get the property state: primitive ID
-
-## Signature
-
-```typescript
-function getState_PrimitiveId(): string;
-```
-
-## Returns
-
-string
-
-Primitive ID
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取图元 ID
-const primitiveId = comp.getState_PrimitiveId();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([primitiveId]);
-
-console.log('primitiveId:', primitiveId);
-```
-
-### getstate_primitivelock
-
-# IPCB\_PrimitiveComponent.getState\_PrimitiveLock() method
-
-Get the property state: whether it is locked
-
-## Signature
-
-```typescript
-function getState_PrimitiveLock(): boolean;
-```
-
-## Returns
-
-boolean
-
-Whether it is locked
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取锁定状态
-const primitiveLock = comp.getState_PrimitiveLock();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('primitiveLock:', primitiveLock);
-```
-
-### getstate_primitivetype
-
-# IPCB\_PrimitiveComponent.getState\_PrimitiveType() method
-
-Get the property state: primitive type
-
-## Signature
-
-```typescript
-function getState_PrimitiveType(): EPCB_PrimitiveType;
-```
-
-## Returns
-
-[EPCB\_PrimitiveType](../enums/EPCB_PrimitiveType.md)
-
-Primitive type
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取图元类型
-const primitiveType = comp.getState_PrimitiveType();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('primitiveType:', primitiveType);
-```
-
-### getstate_rotation
-
-# IPCB\_PrimitiveComponent.getState\_Rotation() method
-
-Get the property state: rotation angle
-
-## Signature
-
-```typescript
-function getState_Rotation(): number;
-```
-
-## Returns
-
-number
-
-Rotation angle
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件（默认 0 度）
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取旋转角度
-const rotation = comp.getState_Rotation();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('rotation:', rotation);
-```
-
-### getstate_supplier
-
-# IPCB\_PrimitiveComponent.getState\_Supplier() method
-
-Get the property state: supplier
-
-## Signature
-
-```typescript
-function getState_Supplier(): string | undefined;
-```
-
-## Returns
-
-string \| undefined
-
-Supplier
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取供应商
-const supplier = comp.getState_Supplier();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('supplier:', supplier);
-```
-
-### getstate_supplierid
-
-# IPCB\_PrimitiveComponent.getState\_SupplierId() method
-
-Get the property state: supplier ID
-
-## Signature
-
-```typescript
-function getState_SupplierId(): string | undefined;
-```
-
-## Returns
-
-string \| undefined
-
-Supplier ID
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取供应商编号
-const supplierId = comp.getState_SupplierId();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('supplierId:', supplierId);
-```
-
-### getstate_uniqueid
-
-# IPCB\_PrimitiveComponent.getState\_UniqueId() method
-
-Get the property state: unique ID
-
-## Signature
-
-```typescript
-function getState_UniqueId(): string | undefined;
-```
-
-## Returns
-
-string \| undefined
-
-Unique ID
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取唯一 ID
-const uniqueId = comp.getState_UniqueId();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('uniqueId:', JSON.stringify(uniqueId));
-```
-
-### getstate_x
-
-# IPCB\_PrimitiveComponent.getState\_X() method
-
-Get the property state: X coordinate
-
-## Signature
-
-```typescript
-function getState_X(): number;
-```
-
-## Returns
-
-number
-
-X coordinate
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取锚点 X 坐标
-const x = comp.getState_X();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('x:', x);
-```
-
-### getstate_y
-
-# IPCB\_PrimitiveComponent.getState\_Y() method
-
-Get the property state: Y coordinate
-
-## Signature
-
-```typescript
-function getState_Y(): number;
-```
-
-## Returns
-
-number
-
-Y coordinate
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 读取锚点 Y 坐标
-const y = comp.getState_Y();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('y:', y);
-```
-
-### isasync
-
-# IPCB\_PrimitiveComponent.isAsync() method
-
-Query whether the primitive is an async primitive
-
-## Signature
-
-```typescript
-function isAsync(): boolean;
-```
-
-## Returns
-
-boolean
-
-Whether Is async primitive
-
-## Example
-
-```javascript
-// 1. 放置一个测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
-
-// 2. 查询异步状态
-const isAsync = comp.isAsync();
-
-// 3. 清理测试器件
-await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
-
-console.log('isAsync:', isAsync);
-```
-
-### reset
-
-# IPCB\_PrimitiveComponent.reset() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Reset the async primitive to the current canvas state
-
-## Signature
-
-```typescript
-function reset(): Promise<IPCB_PrimitiveComponent>;
-```
-
-## Returns
-
-Promise&lt;[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)<!-- -->&gt;
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件（默认 0 度）
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 记录画布上的原始旋转角度
-const original = comp.getState_Rotation();
-
-// 4. 异步模式下改一个错误值，但不提交，直接 reset() 丢弃
-const asyncComp = comp.toAsync();
-asyncComp.setState_Rotation(270);
-await asyncComp.reset();
-
-// 5. 从画布重新读取，确认值仍是原始值（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('rotation:', original, '→', refetched[0].getState_Rotation(), '(修改已丢弃)');
-```
-
-### setattribute
-
-# IPCB\_PrimitiveComponent.setAttribute() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Set Property
-
-## Signature
-
-```typescript
-function setAttribute(
-	key: string,
-	value?: string | number | boolean,
-	keyVisible?: boolean,
-	valueVisible?: boolean,
-): Promise<IPCB_PrimitiveAttribute>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-key
-
-</td><td>
-
-string
-
-</td><td>
-
-Attribute name. If the device does not have an attribute with this name, the attribute will be added
-
-</td></tr>
-<tr><td>
-
-value
-
-</td><td>
-
-string \| number \| boolean
-
-</td><td>
-
-_(Optional)_ Property value
-
-</td></tr>
-<tr><td>
-
-keyVisible
-
-</td><td>
-
-boolean
-
-</td><td>
-
-_(Optional)_ Attribute name visibility
-
-</td></tr>
-<tr><td>
-
-valueVisible
-
-</td><td>
-
-boolean
-
-</td><td>
-
-_(Optional)_ Attribute value visibility
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;[IPCB\_PrimitiveAttribute](./IPCB_PrimitiveAttribute.md)<!-- -->&gt;
-
-Attribute primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 设置自定义属性（属性名、属性值、名称可见、值可见）
-await comp.setAttribute('嘉立创示例_Tolerance', '1%', true, true);
-
-// 4. 通过属性图元接口确认属性已写入（保留现场供观察）
-const attrIds = await eda.pcb_PrimitiveAttribute.getAllPrimitiveId(compId);
-const attrs = await eda.pcb_PrimitiveAttribute.get(attrIds);
-const added = attrs.find(a => a.getState_Key() === '嘉立创示例_Tolerance');
-
-console.log('attrKey:', added.getState_Key());
-console.log('attrValue:', added.getState_Value());
-```
-
-### setstate_addintobom
-
-# IPCB\_PrimitiveComponent.setState\_AddIntoBom() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Set the property state: whether to add BOM
-
-## Signature
-
-```typescript
-function setState_AddIntoBom(addIntoBom: boolean): IPCB_PrimitiveComponent;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-addIntoBom
-
-</td><td>
-
-boolean
-
-</td><td>
-
-Whether Add to BOM
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 读取修改前的值
-const before = comp.getState_AddIntoBom();
-
-// 4. 异步模式改为不加入 BOM 并提交
-const asyncComp = comp.toAsync();
-asyncComp.setState_AddIntoBom(false);
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('addIntoBom:', before, '→', refetched[0].getState_AddIntoBom());
-```
-
-### setstate_designator
-
-# IPCB\_PrimitiveComponent.setState\_Designator() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Set the property state: designator
-
-## Signature
-
-```typescript
-function setState_Designator(designator: string | undefined): IPCB_PrimitiveComponent;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-designator
-
-</td><td>
-
-string \| undefined
-
-</td><td>
-
-Designator
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件（位号由系统自动分配）
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 读取修改前的位号
-const before = comp.getState_Designator();
-
-// 4. 异步模式改位号并提交
-const asyncComp = comp.toAsync();
-asyncComp.setState_Designator('C101');
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('designator:', before, '→', refetched[0].getState_Designator());
-```
-
-### setstate_layer
-
-# IPCB\_PrimitiveComponent.setState\_Layer() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Set the property state: Layer
-
-## Signature
-
-```typescript
-function setState_Layer(layer: TPCB_LayersOfComponent): IPCB_PrimitiveComponent;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-layer
-
-</td><td>
-
-[TPCB\_LayersOfComponent](../types/TPCB_LayersOfComponent.md)
-
-</td><td>
-
-Layer
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件（默认贴顶面）
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 读取修改前的所在面
-const before = comp.getState_Layer();
-
-// 4. 异步模式翻到底面并提交
-const asyncComp = comp.toAsync();
-asyncComp.setState_Layer(2);
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('layer:', before, '→', refetched[0].getState_Layer());
-```
-
-### setstate_manufacturer
-
-# IPCB\_PrimitiveComponent.setState\_Manufacturer() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Set the property state: manufacturer
-
-## Signature
-
-```typescript
-function setState_Manufacturer(manufacturer: string | undefined): IPCB_PrimitiveComponent;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-manufacturer
-
-</td><td>
-
-string \| undefined
-
-</td><td>
-
-Manufacturer
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 读取修改前的制造商
-const before = comp.getState_Manufacturer();
-
-// 4. 异步模式修改制造商并提交
-const asyncComp = comp.toAsync();
-asyncComp.setState_Manufacturer('嘉立创示例_MFR');
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('manufacturer:', before, '→', refetched[0].getState_Manufacturer());
-```
-
-### setstate_manufacturerid
-
-# IPCB\_PrimitiveComponent.setState\_ManufacturerId() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Set the property state: manufacturer ID
-
-## Signature
-
-```typescript
-function setState_ManufacturerId(manufacturerId: string | undefined): IPCB_PrimitiveComponent;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-manufacturerId
-
-</td><td>
-
-string \| undefined
-
-</td><td>
-
-Manufacturer ID
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 读取修改前的制造商编号
-const before = comp.getState_ManufacturerId();
-
-// 4. 异步模式修改制造商编号并提交
-const asyncComp = comp.toAsync();
-asyncComp.setState_ManufacturerId('MFR-DEMO-001');
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('manufacturerId:', before, '→', refetched[0].getState_ManufacturerId());
-```
-
-### setstate_name
-
-# IPCB\_PrimitiveComponent.setState\_Name() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Set the property state: name
-
-## Signature
-
-```typescript
-function setState_Name(name: string | undefined): IPCB_PrimitiveComponent;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-name
-
-</td><td>
-
-string \| undefined
-
-</td><td>
-
-Name
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 读取修改前的名称（模板表达式）
-const before = comp.getState_Name();
-
-// 4. 异步模式改为固定名称并提交
-const asyncComp = comp.toAsync();
-asyncComp.setState_Name('嘉立创示例_Name');
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('name:', before, '→', refetched[0].getState_Name());
-```
-
-### setstate_otherproperty
-
-# IPCB\_PrimitiveComponent.setState\_OtherProperty() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Set the property state: other parameters
-
-## Signature
-
-```typescript
-function setState_OtherProperty(
-	otherProperty: Record<string, string | number | boolean>,
-): IPCB_PrimitiveComponent;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-otherProperty
-
-</td><td>
-
-Record&lt;string, string \| number \| boolean&gt;
-
-</td><td>
-
-Other parameters
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 读取修改前的参数数量
-const beforeCount = Object.keys(comp.getState_OtherProperty() || {}).length;
-
-// 4. 异步模式写入新的参数字典并提交
-const asyncComp = comp.toAsync();
-asyncComp.setState_OtherProperty({ 嘉立创示例_Custom: 'ABC', Count: 3 });
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认参数已写入（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-const after = refetched[0].getState_OtherProperty();
-
-console.log('propertyCount:', beforeCount, '→', Object.keys(after).length);
-console.log('customValue:', after['嘉立创示例_Custom']);
-```
-
-### setstate_primitivelock
-
-# IPCB\_PrimitiveComponent.setState\_PrimitiveLock() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Set the property state: whether it is locked
-
-## Signature
-
-```typescript
-function setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveComponent;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-primitiveLock
-
-</td><td>
-
-boolean
-
-</td><td>
-
-Whether it is locked
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 读取修改前的锁定状态
-const before = comp.getState_PrimitiveLock();
-
-// 4. 异步模式锁定器件并提交
-const asyncComp = comp.toAsync();
-asyncComp.setState_PrimitiveLock(true);
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('primitiveLock:', before, '→', refetched[0].getState_PrimitiveLock());
-```
-
-### setstate_rotation
-
-# IPCB\_PrimitiveComponent.setState\_Rotation() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Set the property state: rotation angle
-
-## Signature
-
-```typescript
-function setState_Rotation(rotation: number): IPCB_PrimitiveComponent;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-rotation
-
-</td><td>
-
-number
-
-</td><td>
-
-Rotation angle
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件（默认 0 度）
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 读取修改前的旋转角度
-const before = comp.getState_Rotation();
-
-// 4. 异步模式旋转 90 度并提交
-const asyncComp = comp.toAsync();
-asyncComp.setState_Rotation(90);
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('rotation:', before, '→', refetched[0].getState_Rotation());
-```
-
-### setstate_supplier
-
-# IPCB\_PrimitiveComponent.setState\_Supplier() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Set the property state: supplier
-
-## Signature
-
-```typescript
-function setState_Supplier(supplier: string | undefined): IPCB_PrimitiveComponent;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-supplier
-
-</td><td>
-
-string \| undefined
-
-</td><td>
-
-Supplier
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 读取修改前的供应商
-const before = comp.getState_Supplier();
-
-// 4. 异步模式修改供应商并提交
-const asyncComp = comp.toAsync();
-asyncComp.setState_Supplier('嘉立创示例_SUP');
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('supplier:', before, '→', refetched[0].getState_Supplier());
-```
-
-### setstate_supplierid
-
-# IPCB\_PrimitiveComponent.setState\_SupplierId() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Set the property state: supplier ID
-
-## Signature
-
-```typescript
-function setState_SupplierId(supplierId: string | undefined): IPCB_PrimitiveComponent;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-supplierId
-
-</td><td>
-
-string \| undefined
-
-</td><td>
-
-Supplier ID
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 读取修改前的供应商编号
-const before = comp.getState_SupplierId();
-
-// 4. 异步模式修改供应商编号并提交
-const asyncComp = comp.toAsync();
-asyncComp.setState_SupplierId('SUP-DEMO-001');
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('supplierId:', before, '→', refetched[0].getState_SupplierId());
-```
-
-### setstate_uniqueid
-
-# IPCB\_PrimitiveComponent.setState\_UniqueId() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Set the property state: unique ID
-
-## Signature
-
-```typescript
-function setState_UniqueId(uniqueId: string | undefined): IPCB_PrimitiveComponent;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-uniqueId
-
-</td><td>
-
-string \| undefined
-
-</td><td>
-
-Unique ID
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 读取修改前的唯一 ID（默认空字符串）
-const before = comp.getState_UniqueId();
-
-// 4. 异步模式设置分组唯一 ID 并提交
-const asyncComp = comp.toAsync();
-asyncComp.setState_UniqueId('JLC-DEMO-001');
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('uniqueId:', JSON.stringify(before), '→', JSON.stringify(refetched[0].getState_UniqueId()));
-```
-
-### setstate_x
-
-# IPCB\_PrimitiveComponent.setState\_X() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Set the property state: X coordinate
-
-## Signature
-
-```typescript
-function setState_X(x: number): IPCB_PrimitiveComponent;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-x
-
-</td><td>
-
-number
-
-</td><td>
-
-X coordinate
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 读取修改前的锚点 X 坐标
-const before = comp.getState_X();
-
-// 4. 异步模式向右移动 300mil 并提交
-const asyncComp = comp.toAsync();
-asyncComp.setState_X(before + 300);
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('x:', before, '→', refetched[0].getState_X());
-```
-
-### setstate_y
-
-# IPCB\_PrimitiveComponent.setState\_Y() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Set the property state: Y coordinate
-
-## Signature
-
-```typescript
-function setState_Y(y: number): IPCB_PrimitiveComponent;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-y
-
-</td><td>
-
-number
-
-</td><td>
-
-Y coordinate
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 读取修改前的锚点 Y 坐标
-const before = comp.getState_Y();
-
-// 4. 异步模式向上移动 300mil 并提交
-const asyncComp = comp.toAsync();
-asyncComp.setState_Y(before + 300);
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('y:', before, '→', refetched[0].getState_Y());
-```
-
-### toasync
-
-# IPCB\_PrimitiveComponent.toAsync() method
-
-Convert Primitive to Async primitive
-
-## Signature
-
-```typescript
-function toAsync(): IPCB_PrimitiveComponent;
-```
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 转换为异步图元
-const asyncComp = comp.toAsync();
-const isAsyncNow = asyncComp.isAsync();
-
-// 4. 在异步模式下修改位号并提交
-asyncComp.setState_Designator('C102');
-await asyncComp.done();
-
-// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('isAsync:', isAsyncNow);
-console.log('designator:', refetched[0].getState_Designator());
-```
-
-### tosync
-
-# IPCB\_PrimitiveComponent.toSync() method
-
-Convert Primitive to Sync primitive
-
-## Signature
-
-```typescript
-function toSync(): IPCB_PrimitiveComponent;
-```
-
-## Returns
-
-[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
-
-Device primitive object
-
-## Example
-
-```javascript
-// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
-const x = 20000 + Math.floor(Math.random() * 80000);
-const y = 20000 + Math.floor(Math.random() * 80000);
-
-// 2. 放置测试器件
-const devices = await eda.lib_Device.search('C0402');
-const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
-const compId = comp.getState_PrimitiveId();
-
-// 3. 读取修改前的位号
-const before = comp.getState_Designator();
-
-// 4. 转换为同步图元后直接修改，立即生效（无需 done()）
-const syncComp = comp.toSync();
-syncComp.setState_Designator('C103');
-
-// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
-const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
-
-console.log('designator:', before, '→', refetched[0].getState_Designator());
-```
+# IPCB\_PrimitiveComponent class
+
+Device primitive
+
+## Signature
+
+```typescript
+class IPCB_PrimitiveComponent implements IPCB_Primitive
+```
+**Implements:** [IPCB\_Primitive](../interfaces/IPCB_Primitive.md)
+
+## Remarks
+
+## Methods
+
+<table><thead><tr><th>
+
+Method
+
+</th><th>
+
+Modifiers
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[done()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Apply the changes to the primitives to the canvas
+
+</td></tr>
+<tr><td>
+
+[getAllPins()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Get all pads associated with the device
+
+</td></tr>
+<tr><td>
+
+[getState\_AddIntoBom()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: whether to add BOM
+
+</td></tr>
+<tr><td>
+
+[getState\_Component()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: associate library device
+
+</td></tr>
+<tr><td>
+
+[getState\_Designator()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: designator
+
+</td></tr>
+<tr><td>
+
+[getState\_Footprint()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: associate library footprint
+
+</td></tr>
+<tr><td>
+
+[getState\_Layer()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: Layer
+
+</td></tr>
+<tr><td>
+
+[getState\_Manufacturer()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: manufacturer
+
+</td></tr>
+<tr><td>
+
+[getState\_ManufacturerId()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: manufacturer ID
+
+</td></tr>
+<tr><td>
+
+[getState\_Model3D()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: associate library 3D model
+
+</td></tr>
+<tr><td>
+
+[getState\_Name()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: name
+
+</td></tr>
+<tr><td>
+
+[getState\_OtherProperty()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: other parameters
+
+</td></tr>
+<tr><td>
+
+[getState\_Pads()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: pad
+
+</td></tr>
+<tr><td>
+
+[getState\_PrimitiveId()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: primitive ID
+
+</td></tr>
+<tr><td>
+
+[getState\_PrimitiveLock()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: whether it is locked
+
+</td></tr>
+<tr><td>
+
+[getState\_PrimitiveType()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: primitive type
+
+</td></tr>
+<tr><td>
+
+[getState\_Rotation()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: rotation angle
+
+</td></tr>
+<tr><td>
+
+[getState\_Supplier()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: supplier
+
+</td></tr>
+<tr><td>
+
+[getState\_SupplierId()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: supplier ID
+
+</td></tr>
+<tr><td>
+
+[getState\_UniqueId()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: unique ID
+
+</td></tr>
+<tr><td>
+
+[getState\_X()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: X coordinate
+
+</td></tr>
+<tr><td>
+
+[getState\_Y()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: Y coordinate
+
+</td></tr>
+<tr><td>
+
+[isAsync()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Query whether the primitive is an async primitive
+
+</td></tr>
+<tr><td>
+
+[reset()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Reset the async primitive to the current canvas state
+
+</td></tr>
+<tr><td>
+
+[setAttribute(key, value, keyVisible, valueVisible)](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set Property
+
+</td></tr>
+<tr><td>
+
+[setState\_AddIntoBom(addIntoBom)](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: whether to add BOM
+
+</td></tr>
+<tr><td>
+
+[setState\_Designator(designator)](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: designator
+
+</td></tr>
+<tr><td>
+
+[setState\_Layer(layer)](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: Layer
+
+</td></tr>
+<tr><td>
+
+[setState\_Manufacturer(manufacturer)](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: manufacturer
+
+</td></tr>
+<tr><td>
+
+[setState\_ManufacturerId(manufacturerId)](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: manufacturer ID
+
+</td></tr>
+<tr><td>
+
+[setState\_Name(name)](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: name
+
+</td></tr>
+<tr><td>
+
+[setState\_OtherProperty(otherProperty)](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: other parameters
+
+</td></tr>
+<tr><td>
+
+[setState\_PrimitiveLock(primitiveLock)](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: whether it is locked
+
+</td></tr>
+<tr><td>
+
+[setState\_Rotation(rotation)](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: rotation angle
+
+</td></tr>
+<tr><td>
+
+[setState\_Supplier(supplier)](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: supplier
+
+</td></tr>
+<tr><td>
+
+[setState\_SupplierId(supplierId)](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: supplier ID
+
+</td></tr>
+<tr><td>
+
+[setState\_UniqueId(uniqueId)](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: unique ID
+
+</td></tr>
+<tr><td>
+
+[setState\_X(x)](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: X coordinate
+
+</td></tr>
+<tr><td>
+
+[setState\_Y(y)](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: Y coordinate
+
+</td></tr>
+<tr><td>
+
+[toAsync()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Convert Primitive to Async primitive
+
+</td></tr>
+<tr><td>
+
+[toSync()](./IPCB_PrimitiveComponent.md)
+
+</td><td>
+
+</td><td>
+
+Convert Primitive to Sync primitive
+
+</td></tr>
+</tbody></table>
+
+---
+
+## 方法详情
+
+### done
+
+# IPCB\_PrimitiveComponent.done() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Apply the changes to the primitives to the canvas
+
+## Signature
+
+```typescript
+function done(): Promise<IPCB_PrimitiveComponent>;
+```
+
+## Returns
+
+Promise&lt;[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)<!-- -->&gt;
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 记录修改前的位号和旋转角度
+const designatorBefore = comp.getState_Designator();
+const rotationBefore = comp.getState_Rotation();
+
+// 4. 批量修改两个属性，一次 done() 提交
+const asyncComp = comp.toAsync();
+asyncComp.setState_Designator('C101');
+asyncComp.setState_Rotation(90);
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认批量修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('designator:', designatorBefore, '→', refetched[0].getState_Designator());
+console.log('rotation:', rotationBefore, '→', refetched[0].getState_Rotation());
+```
+
+### getallpins
+
+# IPCB\_PrimitiveComponent.getAllPins() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Get all pads associated with the device
+
+## Signature
+
+```typescript
+function getAllPins(): Promise<Array<IPCB_PrimitiveComponentPad>>;
+```
+
+## Returns
+
+Promise&lt;Array&lt;[IPCB\_PrimitiveComponentPad](./IPCB_PrimitiveComponentPad.md)<!-- -->&gt;&gt;
+
+Device pad primitive array
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 获取器件关联的所有焊盘图元
+const pins = await comp.getAllPins();
+
+// 3. 逐个读取焊盘的归属器件和图元 ID
+const pinInfos = pins.map(pin => ({
+	parentMatch: pin.getState_ParentComponentPrimitiveId() === compId,
+	primitiveId: pin.getState_PrimitiveId(),
+}));
+
+// 4. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([compId]);
+
+console.log('pinCount:', pins.length);
+console.log('allBelongToComponent:', pinInfos.every(p => p.parentMatch));
+console.log('firstPinPrimitiveId:', pinInfos[0].primitiveId);
+```
+
+### getstate_addintobom
+
+# IPCB\_PrimitiveComponent.getState\_AddIntoBom() method
+
+Get the property state: whether to add BOM
+
+## Signature
+
+```typescript
+function getState_AddIntoBom(): boolean;
+```
+
+## Returns
+
+boolean
+
+Whether Add to BOM
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取是否加入 BOM
+const addIntoBom = comp.getState_AddIntoBom();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('addIntoBom:', addIntoBom);
+```
+
+### getstate_component
+
+# IPCB\_PrimitiveComponent.getState\_Component() method
+
+Get the property state: associate library device
+
+## Signature
+
+```typescript
+function getState_Component(): { libraryUuid: string; uuid: string; name?: string } | undefined;
+```
+
+## Returns
+
+{ libraryUuid: string; uuid: string; name?: string } \| undefined
+
+Associate library device
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取关联的库器件信息
+const component = comp.getState_Component();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('deviceName:', component.name);
+console.log('deviceUuid:', component.uuid);
+console.log('libraryUuid:', component.libraryUuid);
+```
+
+### getstate_designator
+
+# IPCB\_PrimitiveComponent.getState\_Designator() method
+
+Get the property state: designator
+
+## Signature
+
+```typescript
+function getState_Designator(): string | undefined;
+```
+
+## Returns
+
+string \| undefined
+
+Designator
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（位号由系统自动分配）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取位号
+const designator = comp.getState_Designator();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('designator:', designator);
+```
+
+### getstate_footprint
+
+# IPCB\_PrimitiveComponent.getState\_Footprint() method
+
+Get the property state: associate library footprint
+
+## Signature
+
+```typescript
+function getState_Footprint(): { libraryUuid: string; uuid: string; name?: string } | undefined;
+```
+
+## Returns
+
+{ libraryUuid: string; uuid: string; name?: string } \| undefined
+
+Associate library footprint
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取关联的库封装信息
+const footprint = comp.getState_Footprint();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('footprintName:', footprint.name);
+console.log('footprintUuid:', footprint.uuid);
+console.log('libraryUuid:', footprint.libraryUuid);
+```
+
+### getstate_layer
+
+# IPCB\_PrimitiveComponent.getState\_Layer() method
+
+Get the property state: Layer
+
+## Signature
+
+```typescript
+function getState_Layer(): TPCB_LayersOfComponent;
+```
+
+## Returns
+
+[TPCB\_LayersOfComponent](../types/TPCB_LayersOfComponent.md)
+
+Layer
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（默认贴在顶面）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取所在面（1=顶面, 2=底面）
+const layer = comp.getState_Layer();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('layer:', layer, layer === 1 ? '(顶面)' : '(底面)');
+```
+
+### getstate_manufacturer
+
+# IPCB\_PrimitiveComponent.getState\_Manufacturer() method
+
+Get the property state: manufacturer
+
+## Signature
+
+```typescript
+function getState_Manufacturer(): string | undefined;
+```
+
+## Returns
+
+string \| undefined
+
+Manufacturer
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取制造商
+const manufacturer = comp.getState_Manufacturer();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('manufacturer:', manufacturer);
+```
+
+### getstate_manufacturerid
+
+# IPCB\_PrimitiveComponent.getState\_ManufacturerId() method
+
+Get the property state: manufacturer ID
+
+## Signature
+
+```typescript
+function getState_ManufacturerId(): string | undefined;
+```
+
+## Returns
+
+string \| undefined
+
+Manufacturer ID
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取制造商编号
+const manufacturerId = comp.getState_ManufacturerId();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('manufacturerId:', manufacturerId);
+```
+
+### getstate_model3d
+
+# IPCB\_PrimitiveComponent.getState\_Model3D() method
+
+Get the property state: associate library 3D model
+
+## Signature
+
+```typescript
+function getState_Model3D(): { libraryUuid: string; uuid: string; name?: string } | undefined;
+```
+
+## Returns
+
+{ libraryUuid: string; uuid: string; name?: string } \| undefined
+
+Associate library 3D model
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取关联的 3D 模型信息（未关联时返回 undefined）
+const model3d = comp.getState_Model3D();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('model3dName:', model3d ? model3d.name : '(未关联 3D 模型)');
+console.log('model3dUuid:', model3d ? model3d.uuid : '(未关联 3D 模型)');
+```
+
+### getstate_name
+
+# IPCB\_PrimitiveComponent.getState\_Name() method
+
+Get the property state: name
+
+## Signature
+
+```typescript
+function getState_Name(): string | undefined;
+```
+
+## Returns
+
+string \| undefined
+
+Name
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取名称
+const name = comp.getState_Name();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('name:', name);
+```
+
+### getstate_otherproperty
+
+# IPCB\_PrimitiveComponent.getState\_OtherProperty() method
+
+Get the property state: other parameters
+
+## Signature
+
+```typescript
+function getState_OtherProperty(): Record<string, string | number | boolean> | undefined;
+```
+
+## Returns
+
+Record&lt;string, string \| number \| boolean&gt; \| undefined
+
+Other parameters
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取其它参数字典
+const otherProperty = comp.getState_OtherProperty();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('propertyCount:', Object.keys(otherProperty).length);
+console.log('value:', otherProperty.Value);
+console.log('description:', otherProperty.Description);
+```
+
+### getstate_pads
+
+# IPCB\_PrimitiveComponent.getState\_Pads() method
+
+Get the property state: pad
+
+## Signature
+
+```typescript
+function getState_Pads():
+	Array<{ primitiveId: string; net: string; padNumber: string }> | undefined;
+```
+
+## Returns
+
+Array&lt;{ primitiveId: string; net: string; padNumber: string }&gt; \| undefined
+
+Pad
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取焊盘摘要数据
+const pads = comp.getState_Pads();
+
+// 3. 摘要出每个焊盘的编号与网络
+const padSummaries = pads.map(pad => ({ padNumber: pad.padNumber, net: pad.net }));
+
+// 4. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('padCount:', pads.length);
+console.log('padSummaries:', JSON.stringify(padSummaries));
+```
+
+### getstate_primitiveid
+
+# IPCB\_PrimitiveComponent.getState\_PrimitiveId() method
+
+Get the property state: primitive ID
+
+## Signature
+
+```typescript
+function getState_PrimitiveId(): string;
+```
+
+## Returns
+
+string
+
+Primitive ID
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取图元 ID
+const primitiveId = comp.getState_PrimitiveId();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([primitiveId]);
+
+console.log('primitiveId:', primitiveId);
+```
+
+### getstate_primitivelock
+
+# IPCB\_PrimitiveComponent.getState\_PrimitiveLock() method
+
+Get the property state: whether it is locked
+
+## Signature
+
+```typescript
+function getState_PrimitiveLock(): boolean;
+```
+
+## Returns
+
+boolean
+
+Whether it is locked
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取锁定状态
+const primitiveLock = comp.getState_PrimitiveLock();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('primitiveLock:', primitiveLock);
+```
+
+### getstate_primitivetype
+
+# IPCB\_PrimitiveComponent.getState\_PrimitiveType() method
+
+Get the property state: primitive type
+
+## Signature
+
+```typescript
+function getState_PrimitiveType(): EPCB_PrimitiveType;
+```
+
+## Returns
+
+[EPCB\_PrimitiveType](../enums/EPCB_PrimitiveType.md)
+
+Primitive type
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取图元类型
+const primitiveType = comp.getState_PrimitiveType();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('primitiveType:', primitiveType);
+```
+
+### getstate_rotation
+
+# IPCB\_PrimitiveComponent.getState\_Rotation() method
+
+Get the property state: rotation angle
+
+## Signature
+
+```typescript
+function getState_Rotation(): number;
+```
+
+## Returns
+
+number
+
+Rotation angle
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（默认 0 度）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取旋转角度
+const rotation = comp.getState_Rotation();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('rotation:', rotation);
+```
+
+### getstate_supplier
+
+# IPCB\_PrimitiveComponent.getState\_Supplier() method
+
+Get the property state: supplier
+
+## Signature
+
+```typescript
+function getState_Supplier(): string | undefined;
+```
+
+## Returns
+
+string \| undefined
+
+Supplier
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取供应商
+const supplier = comp.getState_Supplier();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('supplier:', supplier);
+```
+
+### getstate_supplierid
+
+# IPCB\_PrimitiveComponent.getState\_SupplierId() method
+
+Get the property state: supplier ID
+
+## Signature
+
+```typescript
+function getState_SupplierId(): string | undefined;
+```
+
+## Returns
+
+string \| undefined
+
+Supplier ID
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取供应商编号
+const supplierId = comp.getState_SupplierId();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('supplierId:', supplierId);
+```
+
+### getstate_uniqueid
+
+# IPCB\_PrimitiveComponent.getState\_UniqueId() method
+
+Get the property state: unique ID
+
+## Signature
+
+```typescript
+function getState_UniqueId(): string | undefined;
+```
+
+## Returns
+
+string \| undefined
+
+Unique ID
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取唯一 ID
+const uniqueId = comp.getState_UniqueId();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('uniqueId:', JSON.stringify(uniqueId));
+```
+
+### getstate_x
+
+# IPCB\_PrimitiveComponent.getState\_X() method
+
+Get the property state: X coordinate
+
+## Signature
+
+```typescript
+function getState_X(): number;
+```
+
+## Returns
+
+number
+
+X coordinate
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取锚点 X 坐标
+const x = comp.getState_X();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('x:', x);
+```
+
+### getstate_y
+
+# IPCB\_PrimitiveComponent.getState\_Y() method
+
+Get the property state: Y coordinate
+
+## Signature
+
+```typescript
+function getState_Y(): number;
+```
+
+## Returns
+
+number
+
+Y coordinate
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 读取锚点 Y 坐标
+const y = comp.getState_Y();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('y:', y);
+```
+
+### isasync
+
+# IPCB\_PrimitiveComponent.isAsync() method
+
+Query whether the primitive is an async primitive
+
+## Signature
+
+```typescript
+function isAsync(): boolean;
+```
+
+## Returns
+
+boolean
+
+Whether Is async primitive
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, 5000, 5000);
+
+// 2. 查询异步状态
+const isAsync = comp.isAsync();
+
+// 3. 清理测试器件
+await eda.pcb_PrimitiveComponent.delete([comp.getState_PrimitiveId()]);
+
+console.log('isAsync:', isAsync);
+```
+
+### reset
+
+# IPCB\_PrimitiveComponent.reset() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Reset the async primitive to the current canvas state
+
+## Signature
+
+```typescript
+function reset(): Promise<IPCB_PrimitiveComponent>;
+```
+
+## Returns
+
+Promise&lt;[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)<!-- -->&gt;
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件（默认 0 度）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 记录画布上的原始旋转角度
+const original = comp.getState_Rotation();
+
+// 4. 异步模式下改一个错误值，但不提交，直接 reset() 丢弃
+const asyncComp = comp.toAsync();
+asyncComp.setState_Rotation(270);
+await asyncComp.reset();
+
+// 5. 从画布重新读取，确认值仍是原始值（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('rotation:', original, '→', refetched[0].getState_Rotation(), '(修改已丢弃)');
+```
+
+### setattribute
+
+# IPCB\_PrimitiveComponent.setAttribute() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set Property
+
+## Signature
+
+```typescript
+function setAttribute(
+	key: string,
+	value?: string | number | boolean,
+	keyVisible?: boolean,
+	valueVisible?: boolean,
+): Promise<IPCB_PrimitiveAttribute>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+key
+
+</td><td>
+
+string
+
+</td><td>
+
+Attribute name. If the device does not have an attribute with this name, the attribute will be added
+
+</td></tr>
+<tr><td>
+
+value
+
+</td><td>
+
+string \| number \| boolean
+
+</td><td>
+
+_(Optional)_ Property value
+
+</td></tr>
+<tr><td>
+
+keyVisible
+
+</td><td>
+
+boolean
+
+</td><td>
+
+_(Optional)_ Attribute name visibility
+
+</td></tr>
+<tr><td>
+
+valueVisible
+
+</td><td>
+
+boolean
+
+</td><td>
+
+_(Optional)_ Attribute value visibility
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;[IPCB\_PrimitiveAttribute](./IPCB_PrimitiveAttribute.md)<!-- -->&gt;
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 设置自定义属性（属性名、属性值、名称可见、值可见）
+await comp.setAttribute('嘉立创示例_Tolerance', '1%', true, true);
+
+// 4. 通过属性图元接口确认属性已写入（保留现场供观察）
+const attrIds = await eda.pcb_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.pcb_PrimitiveAttribute.get(attrIds);
+const added = attrs.find(a => a.getState_Key() === '嘉立创示例_Tolerance');
+
+console.log('attrKey:', added.getState_Key());
+console.log('attrValue:', added.getState_Value());
+```
+
+### setstate_addintobom
+
+# IPCB\_PrimitiveComponent.setState\_AddIntoBom() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: whether to add BOM
+
+## Signature
+
+```typescript
+function setState_AddIntoBom(addIntoBom: boolean): IPCB_PrimitiveComponent;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+addIntoBom
+
+</td><td>
+
+boolean
+
+</td><td>
+
+Whether Add to BOM
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 读取修改前的值
+const before = comp.getState_AddIntoBom();
+
+// 4. 异步模式改为不加入 BOM 并提交
+const asyncComp = comp.toAsync();
+asyncComp.setState_AddIntoBom(false);
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('addIntoBom:', before, '→', refetched[0].getState_AddIntoBom());
+```
+
+### setstate_designator
+
+# IPCB\_PrimitiveComponent.setState\_Designator() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: designator
+
+## Signature
+
+```typescript
+function setState_Designator(designator: string | undefined): IPCB_PrimitiveComponent;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+designator
+
+</td><td>
+
+string \| undefined
+
+</td><td>
+
+Designator
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件（位号由系统自动分配）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 读取修改前的位号
+const before = comp.getState_Designator();
+
+// 4. 异步模式改位号并提交
+const asyncComp = comp.toAsync();
+asyncComp.setState_Designator('C101');
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('designator:', before, '→', refetched[0].getState_Designator());
+```
+
+### setstate_layer
+
+# IPCB\_PrimitiveComponent.setState\_Layer() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: Layer
+
+## Signature
+
+```typescript
+function setState_Layer(layer: TPCB_LayersOfComponent): IPCB_PrimitiveComponent;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+layer
+
+</td><td>
+
+[TPCB\_LayersOfComponent](../types/TPCB_LayersOfComponent.md)
+
+</td><td>
+
+Layer
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件（默认贴顶面）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 读取修改前的所在面
+const before = comp.getState_Layer();
+
+// 4. 异步模式翻到底面并提交
+const asyncComp = comp.toAsync();
+asyncComp.setState_Layer(2);
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('layer:', before, '→', refetched[0].getState_Layer());
+```
+
+### setstate_manufacturer
+
+# IPCB\_PrimitiveComponent.setState\_Manufacturer() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: manufacturer
+
+## Signature
+
+```typescript
+function setState_Manufacturer(manufacturer: string | undefined): IPCB_PrimitiveComponent;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+manufacturer
+
+</td><td>
+
+string \| undefined
+
+</td><td>
+
+Manufacturer
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 读取修改前的制造商
+const before = comp.getState_Manufacturer();
+
+// 4. 异步模式修改制造商并提交
+const asyncComp = comp.toAsync();
+asyncComp.setState_Manufacturer('嘉立创示例_MFR');
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('manufacturer:', before, '→', refetched[0].getState_Manufacturer());
+```
+
+### setstate_manufacturerid
+
+# IPCB\_PrimitiveComponent.setState\_ManufacturerId() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: manufacturer ID
+
+## Signature
+
+```typescript
+function setState_ManufacturerId(manufacturerId: string | undefined): IPCB_PrimitiveComponent;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+manufacturerId
+
+</td><td>
+
+string \| undefined
+
+</td><td>
+
+Manufacturer ID
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 读取修改前的制造商编号
+const before = comp.getState_ManufacturerId();
+
+// 4. 异步模式修改制造商编号并提交
+const asyncComp = comp.toAsync();
+asyncComp.setState_ManufacturerId('MFR-DEMO-001');
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('manufacturerId:', before, '→', refetched[0].getState_ManufacturerId());
+```
+
+### setstate_name
+
+# IPCB\_PrimitiveComponent.setState\_Name() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: name
+
+## Signature
+
+```typescript
+function setState_Name(name: string | undefined): IPCB_PrimitiveComponent;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+name
+
+</td><td>
+
+string \| undefined
+
+</td><td>
+
+Name
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 读取修改前的名称（模板表达式）
+const before = comp.getState_Name();
+
+// 4. 异步模式改为固定名称并提交
+const asyncComp = comp.toAsync();
+asyncComp.setState_Name('嘉立创示例_Name');
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('name:', before, '→', refetched[0].getState_Name());
+```
+
+### setstate_otherproperty
+
+# IPCB\_PrimitiveComponent.setState\_OtherProperty() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: other parameters
+
+## Signature
+
+```typescript
+function setState_OtherProperty(
+	otherProperty: Record<string, string | number | boolean>,
+): IPCB_PrimitiveComponent;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+otherProperty
+
+</td><td>
+
+Record&lt;string, string \| number \| boolean&gt;
+
+</td><td>
+
+Other parameters
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 读取修改前的参数数量
+const beforeCount = Object.keys(comp.getState_OtherProperty() || {}).length;
+
+// 4. 异步模式写入新的参数字典并提交
+const asyncComp = comp.toAsync();
+asyncComp.setState_OtherProperty({ 嘉立创示例_Custom: 'ABC', Count: 3 });
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认参数已写入（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+const after = refetched[0].getState_OtherProperty();
+
+console.log('propertyCount:', beforeCount, '→', Object.keys(after).length);
+console.log('customValue:', after['嘉立创示例_Custom']);
+```
+
+### setstate_primitivelock
+
+# IPCB\_PrimitiveComponent.setState\_PrimitiveLock() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: whether it is locked
+
+## Signature
+
+```typescript
+function setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveComponent;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+primitiveLock
+
+</td><td>
+
+boolean
+
+</td><td>
+
+Whether it is locked
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 读取修改前的锁定状态
+const before = comp.getState_PrimitiveLock();
+
+// 4. 异步模式锁定器件并提交
+const asyncComp = comp.toAsync();
+asyncComp.setState_PrimitiveLock(true);
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('primitiveLock:', before, '→', refetched[0].getState_PrimitiveLock());
+```
+
+### setstate_rotation
+
+# IPCB\_PrimitiveComponent.setState\_Rotation() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: rotation angle
+
+## Signature
+
+```typescript
+function setState_Rotation(rotation: number): IPCB_PrimitiveComponent;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+rotation
+
+</td><td>
+
+number
+
+</td><td>
+
+Rotation angle
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件（默认 0 度）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 读取修改前的旋转角度
+const before = comp.getState_Rotation();
+
+// 4. 异步模式旋转 90 度并提交
+const asyncComp = comp.toAsync();
+asyncComp.setState_Rotation(90);
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('rotation:', before, '→', refetched[0].getState_Rotation());
+```
+
+### setstate_supplier
+
+# IPCB\_PrimitiveComponent.setState\_Supplier() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: supplier
+
+## Signature
+
+```typescript
+function setState_Supplier(supplier: string | undefined): IPCB_PrimitiveComponent;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+supplier
+
+</td><td>
+
+string \| undefined
+
+</td><td>
+
+Supplier
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 读取修改前的供应商
+const before = comp.getState_Supplier();
+
+// 4. 异步模式修改供应商并提交
+const asyncComp = comp.toAsync();
+asyncComp.setState_Supplier('嘉立创示例_SUP');
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('supplier:', before, '→', refetched[0].getState_Supplier());
+```
+
+### setstate_supplierid
+
+# IPCB\_PrimitiveComponent.setState\_SupplierId() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: supplier ID
+
+## Signature
+
+```typescript
+function setState_SupplierId(supplierId: string | undefined): IPCB_PrimitiveComponent;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+supplierId
+
+</td><td>
+
+string \| undefined
+
+</td><td>
+
+Supplier ID
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 读取修改前的供应商编号
+const before = comp.getState_SupplierId();
+
+// 4. 异步模式修改供应商编号并提交
+const asyncComp = comp.toAsync();
+asyncComp.setState_SupplierId('SUP-DEMO-001');
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('supplierId:', before, '→', refetched[0].getState_SupplierId());
+```
+
+### setstate_uniqueid
+
+# IPCB\_PrimitiveComponent.setState\_UniqueId() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: unique ID
+
+## Signature
+
+```typescript
+function setState_UniqueId(uniqueId: string | undefined): IPCB_PrimitiveComponent;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+uniqueId
+
+</td><td>
+
+string \| undefined
+
+</td><td>
+
+Unique ID
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 读取修改前的唯一 ID（默认空字符串）
+const before = comp.getState_UniqueId();
+
+// 4. 异步模式设置分组唯一 ID 并提交
+const asyncComp = comp.toAsync();
+asyncComp.setState_UniqueId('JLC-DEMO-001');
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('uniqueId:', JSON.stringify(before), '→', JSON.stringify(refetched[0].getState_UniqueId()));
+```
+
+### setstate_x
+
+# IPCB\_PrimitiveComponent.setState\_X() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: X coordinate
+
+## Signature
+
+```typescript
+function setState_X(x: number): IPCB_PrimitiveComponent;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+x
+
+</td><td>
+
+number
+
+</td><td>
+
+X coordinate
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 读取修改前的锚点 X 坐标
+const before = comp.getState_X();
+
+// 4. 异步模式向右移动 300mil 并提交
+const asyncComp = comp.toAsync();
+asyncComp.setState_X(before + 300);
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('x:', before, '→', refetched[0].getState_X());
+```
+
+### setstate_y
+
+# IPCB\_PrimitiveComponent.setState\_Y() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Set the property state: Y coordinate
+
+## Signature
+
+```typescript
+function setState_Y(y: number): IPCB_PrimitiveComponent;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+y
+
+</td><td>
+
+number
+
+</td><td>
+
+Y coordinate
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 读取修改前的锚点 Y 坐标
+const before = comp.getState_Y();
+
+// 4. 异步模式向上移动 300mil 并提交
+const asyncComp = comp.toAsync();
+asyncComp.setState_Y(before + 300);
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('y:', before, '→', refetched[0].getState_Y());
+```
+
+### toasync
+
+# IPCB\_PrimitiveComponent.toAsync() method
+
+Convert Primitive to Async primitive
+
+## Signature
+
+```typescript
+function toAsync(): IPCB_PrimitiveComponent;
+```
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 转换为异步图元
+const asyncComp = comp.toAsync();
+const isAsyncNow = asyncComp.isAsync();
+
+// 4. 在异步模式下修改位号并提交
+asyncComp.setState_Designator('C102');
+await asyncComp.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('isAsync:', isAsyncNow);
+console.log('designator:', refetched[0].getState_Designator());
+```
+
+### tosync
+
+# IPCB\_PrimitiveComponent.toSync() method
+
+Convert Primitive to Sync primitive
+
+## Signature
+
+```typescript
+function toSync(): IPCB_PrimitiveComponent;
+```
+
+## Returns
+
+[IPCB\_PrimitiveComponent](./IPCB_PrimitiveComponent.md)
+
+Device primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 20000 + Math.floor(Math.random() * 80000);
+const y = 20000 + Math.floor(Math.random() * 80000);
+
+// 2. 放置测试器件
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.pcb_PrimitiveComponent.create(devices[0], 1, x, y);
+const compId = comp.getState_PrimitiveId();
+
+// 3. 读取修改前的位号
+const before = comp.getState_Designator();
+
+// 4. 转换为同步图元后直接修改，立即生效（无需 done()）
+const syncComp = comp.toSync();
+syncComp.setState_Designator('C103');
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.pcb_PrimitiveComponent.get([compId]);
+
+console.log('designator:', before, '→', refetched[0].getState_Designator());
+```