@windypro-rourou/dsh-eda 0.1.0 → 0.1.2

package/skill/references/classes/IPCB_PrimitiveComponent.md

@@ -0,0 +1,2627 @@
+# 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());
+```