@windypro-rourou/dsh-eda 0.1.0 → 0.1.1

package/skill/format/index.md

@@ -0,0 +1,152 @@
+# EasyEDA File Format
+
+## V2.2 File Format
+
+V2.2 file format: [lceda-pro-file-format-v2.2_2022.12.15.zip](https://image.lceda.cn/files/lceda-pro-file-format-v2.2_2022.12.15.zip)
+
+Hint: This is not the latest file format specification, but it contains most of the format details.
+
+## V3 File Format
+
+V3 uses a brand-new source format, completely different from previous formats.
+
+Hint: EasyEDA 3.0 fully redesigned the project format, using the concept of logs for incremental storage of project changes; and switched from the array offset design style in 2.0 to a key-value style, making future format evolution easier, compatibility code development simpler, and readability improved.
+
+V3 file format (example files included in the zip):
+- [lceda-pro-file-format-v3_2025.10.21.zip](https://image.lceda.cn/files/lceda-pro-file-format-v3_2025.10.21.zip)
+- [lceda-pro-file-format-v3_2025.10.21.md](https://image.lceda.cn/files/lceda-pro-file-format-v3_2025.10.21.md)
+- [lceda-pro-file-format-v3_2025.10.21.pdf](https://image.lceda.cn/files/lceda-pro-file-format-v3_2025.10.21.pdf)
+
+### Format Details Documents
+
+- [Project Format](/en/format/project/index/)
+- [Schematic Format](/en/format/schematic/index/)
+- [PCB Format](/en/format/pcb/index/)
+
+### Basic Document Format
+
+#### Document Conventions
+
+-   All project data is stored in a log document. The first line of each change record must be the file header `DOCTYPE` to distinguish different document types. `DOCTYPE` exists as a `block-level element` in the project log.
+-   Each line consists of two valid JSON objects concatenated together. The first object is used by the eventual consistency framework for parsing, and the latter is the `atomic structural object`.
+-   Key names use camelCase, with the first letter of each word capitalized (except the first word), and no underscores or other separators between words.
+-   All primitives must carry a `unique ID` within the file.
+-   `Rotation angle` is positive in the counter-clockwise direction, and angles are always in degrees.
+-   Unless otherwise specified, all coordinates, lengths, and sizes use `0.01 inch` as the unit.
+-   All colors are expressed as `"#RRGGBB"`. To indicate no color (fully transparent), use `""`.
+-   All properties described as `whether XXXX` are encoded with `1` for yes and `0` for no.
+-   Parts not explicitly described in these conventions (such as escaping) follow [RFC 7195 The JavaScript Object Notation (JSON) Data Interchange Format](https://tools.ietf.org/html/rfc7159).
+
+#### Type Categories
+
+- **Common Data**: Includes basic information, creation information, modification information, etc.
+- **Basic Information**: Includes metadata for project config, board, schematic, PCB, panel, symbol, footprint, device, etc.
+- **BLOB True-Color Image**: True-color image data format.
+- **Instance Attribute Override**: Instance attribute override format.
+- **Variant**: Variant data format.
+- **Component Grouping**: Component grouping data format.
+
+#### Document Header
+
+-   All data must begin with a document header to distinguish different document types.
+-   When parsing line by line, encountering a document header means the following data belongs to that document until the next document header is encountered.
+
+```json
+{ "type": "DOCHEAD" }||{ "docType": "SCH_PAGE", "uuid": "UUID", "client": "clientID" }|
+```
+
+1. type: "DOCHEAD", document header identifier.
+2. docType: document type.
+3. uuid: document unique ID, unique within the project.
+4. client: terminal identifier for eventual consistency.
+
+###### docType Document Types
+
+-   Project config `PROJECT_CONFIG`
+-   Board `BOARD`
+-   Schematic `SCH`
+-   Schematic page `SCH_PAGE`
+-   PCB `PCB`
+-   Panel `PANEL`
+-   Symbol `SYMBOL`
+-   Footprint `FOOTPRINT`
+-   Device `DEVICE`
+-   True-color image `BLOB`
+-   Instance attributes `INSTANCE`
+
+#### Data Format
+
+```json
+{ "type": "TYPE", "id": "UUID", "ticket": 1}||{["key": string]: any}|
+```
+
+The identifier `||` splits a record into inner and outer layers:
+
+1. Outer layer data: used by the eventual consistency framework to ensure data consistency.
+    1. type: data type.
+    2. id: unique ID, must be unique within the specific type in the document.
+    3. ticket: logical clock, only used by the eventual consistency framework to ensure data uniqueness.
+2. Inner layer data: primitive atomic data, a `key-value` object. Specific contents are detailed in the corresponding document for each type.
+
+The reason for splitting into inner and outer layers is that in the eventual consistency framework, the specific primitive data does not need to be concerned; only the outer layer data is needed to ensure data uniqueness, reducing unnecessary JSON parsing and saving memory.
+
+```json
+{ "type": "META", "ticket": 1}||{"name": "name"}|
+```
+
+Some data can only retain one record within a document. The `type` field alone can indicate uniqueness, so the `id` field is omitted. The `id` field is only used to distinguish multiple records of the same type.
+
+#### Eventual Consistency
+
+-   In Storage 3.0, adding, deleting, or modifying data adds a record to the log, so multiple records in the log may represent the same data.
+-   The eventual consistency framework decides which record to keep based on the `type`, `id`, and `ticket` fields.
+
+ps: For more details, please refer to the eventual consistency design document. Here we only explain the use of relevant fields.
+
+###### Two records with the same type and id
+
+```json
+{ "type": "TYPE", "id": "UUID", "ticket": 1}||{"data": 1}|
+```
+
+```json
+{ "type": "TYPE", "id": "UUID", "ticket": 2}||{"data": 2}|
+```
+
+The eventual consistency framework compares the `ticket` field and keeps the record with the larger ticket. In the example above, the record with `data` 2 is kept.
+
+###### Same type, same id, and same ticket
+
+```json
+{ "type": "DOCHEAD" }||{ "docType": "SCH_PAGE", "uuid": "UUID", "client": "1" }|
+{ "type": "TYPE", "id": "UUID", "ticket": 1}||{"data": 1}|
+```
+
+```json
+{ "type": "DOCHEAD" }||{ "docType": "SCH_PAGE", "uuid": "UUID", "client": "2" }|
+{ "type": "TYPE", "id": "UUID", "ticket": 1}||{"data": 2}|
+```
+
+Then the `client` field in the document header is compared, and the record with the smaller client identifier is kept. In the example above, the record with `data` 1 is kept.
+
+#### Deletion
+
+##### Atomic Data Deletion
+
+```json
+{ "type": "TYPE", "id": "UUID", "ticket": 1}||""
+```
+
+Deleting data actually means setting the inner layer data to an empty string.
+
+##### Document Deletion
+
+```json
+{ "type": "DELETE_DOC", "ticket": 1}||{"isDelete": true}|
+```
+
+1. type `DELETE_DOC` document deletion identifier.
+2. isDelete whether deleted.
+
+-   Document deletion actually adds a deletion marker and does not directly delete document data from the log, to facilitate undoing document deletion and maintaining data consistency.
+-   All deleted data is retained in the log. If users want to remove deleted data records from the project, they should clone the project. Log snapshots will not clear related deletion records.

package/skill/format/pcb/3d.md

@@ -0,0 +1,166 @@
+# 3D Shell System
+
+## SHELL Shell
+
+```json
+{ "type": "SHELL", "id":"UUID", "ticket": 1 }||
+{
+  "partitionId":null,
+  "groupId":0,
+  "locked":1,
+  "zIndex":0.223,
+  "shellType":"T&B",
+  "shellHeight":50,
+  "pcbHeight":100,
+  "strokeWidth":10,
+  "path":"complex polygon",
+  "attrs":{},
+}|
+```
+
+1. type shell `SHELL`.
+2. id primitive ID, unique within the document.
+3. ticket logical clock.
+4. partitionId partition ID it belongs to, null means no partition. Ignored for footprints.
+5. groupId group ID: 0 no group, non-zero is the group flag, same flag means same group.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. shellType shell type.
+    - `T&B` top & bottom shell.
+    - `DRAWER` drawer.
+    - `CLAM` clamshell.
+9. shellHeight shell height.
+10. pcbHeight PCB height.
+11. strokeWidth \*line width (deprecated).
+12. path see complex polygon.
+13. attrs custom attributes: each 3D shell type has a set of custom shell attributes.
+    - T&B
+        - Thickness: shell thickness.
+        - BottomHeight: bottom shell height.
+        - TopInnerHeight: top shell inner wall height.
+        - TopInnerThickness: top shell inner wall thickness.
+    - DRAWER
+        - Thickness: shell thickness.
+        - Direction: drawer direction.
+            - `1` positive X axis.
+            - `2` negative X axis.
+            - `4` positive Y axis.
+            - `8` negative Y axis.
+
+## CREASE Side Reference Line (Crease)
+
+`CREASE` primitives need to be used with `CONNECT` to associate `SHELL_ENTITY` and `BOSS` to express shell slots.
+
+```json
+{ "type": "CREASE", "id":"UUID", "ticket": 1 }||
+{
+  "partitionId":null,
+  "groupId":0,
+  "locked":1,
+  "zIndex":8.275,
+  "layerId":49,
+  "startX":20,
+  "startY":30,
+  "endX":40,
+  "endY":50,
+  "angle":90,
+}|
+```
+
+1. type crease `CREASE`.
+2. id primitive ID, unique within the document.
+3. ticket logical clock.
+4. partitionId partition ID it belongs to, null means no partition. Ignored for footprints.
+5. groupId group ID: 0 no group, non-zero is the group flag, same flag means same group.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. layerId layer.
+9. startX start X.
+10. startY start Y.
+11. endX end X.
+12. endY end Y.
+13. angle fold angle.
+
+## SHELL_ENTITY Shell Entity Area
+
+A `SHELL_ENTITY` not associated with `CREASE` via `CONNECT` performs vertical fill/cut (slotting) for the top and bottom shells.
+
+```json
+{ "type": "SHELL_ENTITY", "id":"UUID", "ticket": 1 }||
+{
+  "partitionId":null,
+  "groupId":0,
+  "locked":1,
+  "zIndex":0.15,
+  "layerId":50,
+  "booleanOperation":0,
+  "belong":0,
+  "depth":10,
+  "strokeWidth":10,
+  "path":"complex polygon",
+}|
+```
+
+1. type shell entity area `SHELL_ENTITY`.
+2. id primitive ID, unique within the document.
+3. ticket logical clock.
+4. partitionId partition ID it belongs to, null means no partition. Ignored for footprints.
+5. groupId group ID: 0 no group, non-zero is the group flag, same flag means same group.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. layerId layer.
+9. booleanOperation boolean operation: 0 cut, 1 fill.
+10. belong affiliation: 0 auto, 1 top shell, 2 bottom shell, 4 shell border, 8 boss, 16 entity. Can be combined by addition.
+    - top + bottom shells: 3 = 1 + 2
+    - shell border + boss: 12 = 4 + 8
+    - boss + entity: 24 = 8 + 16
+    - shell border + boss + entity: 28 = 4 + 8 + 16
+11. depth depth.
+12. strokeWidth line width.
+13. path see complex polygon.
+
+## BOSS Boss
+
+A `BOSS` associated with `CREASE` via `CONNECT` adds a side boss.
+
+```json
+{ "type": "BOSS", "id":"UUID", "ticket": 1 }||
+{
+  "partitionId":null,
+  "groupId":0,
+  "locked":1,
+  "zIndex":0.8976,
+  "layerId":50,
+  "centerX":100,
+  "centerY":200,
+  "specification":"M2",
+  "depth":100,
+  "thickness":10,
+  "holeDiameter":20,
+  "counterBore":[100, 20],
+  "stiffener":[20, 40, 20, 10],
+}|
+```
+
+1. type boss `BOSS`.
+2. id primitive ID, unique within the document.
+3. ticket logical clock.
+4. partitionId partition ID it belongs to, null means no partition. Ignored for footprints.
+5. groupId group ID: 0 no group, non-zero is the group flag, same flag means same group.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. layerId layer.
+9. centerX center X.
+10. centerY center Y.
+11. specification screw specification: `"M2"`, `"M3"`, etc., or `null` for custom.
+12. depth boss height.
+13. thickness boss wall thickness.
+14. holeDiameter through-hole diameter.
+15. counterBore counterbore parameters, `null` means no counterbore.
+    - screw head height.
+    - screw head diameter.
+16. stiffener rib parameters, `null` means no rib.
+    - rib top width.
+    - rib bottom width.
+    - rib distance from top of boss.
+    - rib thickness.

package/skill/format/pcb/attr.md

@@ -0,0 +1,63 @@
+# ATTR Attribute
+
+Attributes are used to describe properties that the PCB or FOOTPRINT may need to display on the drawing.
+
+```json
+{ "type": "ATTR", "id":"UUID", "ticket": 1 }||
+{
+  "partitionId":null,
+  "groupId":0,
+  "locked":1,
+  "zIndex":0.072,
+  "parentId":"",
+  "layerId":1,
+  "positionX":200,
+  "positionY":150,
+  "key":"DESIGNATOR",
+  "value":"U1",
+  "keyVisible":0,
+  "valueVisible":1,
+  "fontFamily":"SimSun",
+  "fontSize":50,
+  "strokeWidth":10,
+  "bold":0,
+  "italic":0,
+  "origin":5,
+  "angle":15,
+  "reverse":1,
+  "reverseExpansion":0,
+  "mirror":1,
+  "width":100,
+  "height":200,
+  "path":["complex polygon"],
+}|
+```
+
+1. type attribute `ATTR`.
+2. id primitive ID, unique within the document.
+3. ticket logical clock.
+4. partitionId partition ID it belongs to, null means no partition. Ignored for footprints.
+5. groupId group ID: 0 no group, non-zero is the group flag, same flag means same group.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. parentId affiliation ID, left blank means current block-level primitive.
+9. layerId layer.
+10. positionX position X: fixed to `null` for attributes that have never been displayed.
+11. positionY position Y: fixed to `null` for attributes that have never been displayed.
+12. key Key.
+13. value Value.
+14. keyVisible whether to display Key.
+15. valueVisible whether to display Value.
+16. fontFamily font name.
+17. fontSize font size.
+18. strokeWidth stroke width.
+19. bold whether bold.
+20. italic whether italic.
+21. origin alignment mode: `0` top-left, `1` top-center, `2` top-right, `3` middle-left, `4` middle-center, `5` middle-right, `6` bottom-left, `7` bottom-center, `8` bottom-right.
+22. angle rotation angle.
+23. reverse whether reverse expansion.
+24. reverseExpansion reverse expansion size: size of the reverse expansion area, supports negative numbers.
+25. mirror whether mirrored. Generally, when text appears on the bottom layer, this should also be adjusted to `1`.
+26. width height, `null` if none.
+27. height width, `null` if none.
+28. path complex polygon array, `null` if none.

package/skill/format/pcb/common.md

@@ -0,0 +1,306 @@
+# Common Format
+
+This chapter details the format specification of the EasyEDA PCB file. PCB files mainly consist of the following parts:
+
+- **Common Format**: Document header, canvas, layer, physical layer, preferences, etc.
+- **Partition Format**: Partition definitions.
+- **Basic Primitives**: Nets, primitive configurations, groups, silkscreen configurations, associations, attributes, etc.
+- **Pads and Vias**: Pads and vias.
+- **Shape Primitives**: Lines, arcs, polygon systems, polylines, fills, regions, copper pours, images, teardrops, etc.
+- **Binary Objects**: Embedded objects.
+- **3D Shell**: Shells, creases, entities, bosses.
+- **Text System**: Text.
+- **Attributes**: Attributes.
+- **Dimension Tools**: Dimension annotations.
+- **Footprint System**: Component instances.
+- **Panelization**: Panelization parameters.
+- **Design Rules**: Rule templates, rules.
+
+
+
+## Document Header
+
+```json
+{ "type": "DOCHEAD" }||{ "docType": "PCB", "uuid": "UUID", "client": "clientID" }|
+```
+
+```json
+{ "type": "DOCHEAD" }||{ "docType": "FOOTPRINT", "uuid": "UUID", "client": "clientID" }|
+```
+
+-   type: "DOCHEAD", document header identifier.
+-   docType: document type, "PCB" PCB, "FOOTPRINT" footprint.
+-   uuid: document unique ID, unique within the project.
+-   client: terminal identifier for eventual consistency.
+
+## CANVAS Canvas Configuration
+
+```json
+{ "type": "CANVAS", "ticket": 1 }||
+{
+  "originX":0,
+  "originY":0,
+  "unit":"mm",
+  "gridXSize":10,
+  "gridYSize":10,
+  "snapXSize":1,
+  "snapYSize":1,
+  "altSnapXSize":0.1,
+  "altSnapYSize":0.1,
+  "gridType":1,
+  "multiGridType":0,
+  "multiGridRatio":5,
+}|
+```
+
+1. type canvas configuration `CANVAS`.
+2. ticket logical clock.
+3. originX canvas origin X.
+4. originY canvas origin Y.
+5. unit **display** unit (does not affect the unit of data in the format).
+6. gridXSize grid size X.
+7. gridYSize grid size Y.
+8. snapXSize snap size X.
+9. snapYSize snap size Y.
+10. altSnapXSize Alt snap size X.
+11. altSnapYSize Alt snap size Y.
+12. gridType grid type: `0` none, `1` grid, `2` dot.
+13. multiGridType bold grid type: `0` none, `1` grid, `2` dot.
+14. multiGridRatio bold grid ratio: number.
+
+## LAYER Layer Configuration
+
+-   The order in which `SIGNAL`, `PLANE`, and `SUBSTRATE` appear implies their physical stacking order.
+-   The number of `SIGNAL`, `PLANE`, and `SUBSTRATE` layers is unlimited.
+-   The format does not assume a stable relationship between layer number and layer; specific implementation is decided by the tool.
+
+```json
+{ "type": "LAYER","id": 0, "ticket": 1 }||
+{
+  "layerType":"TOP",
+  "layerName":"Top Layer",
+  "status":1,
+  "activeColor":"#FF0000",
+  "activateTransparency":0.5,
+  "inactiveColor":"#880000",
+  "inactiveTransparency":0.3,
+}|
+```
+
+1. type layer `LAYER`.
+2. id layer number, unique.
+3. ticket logical clock.
+4. layerType layer type.
+5. layerName layer alias, must be unique.
+6. status status: `1` used, `2` displayed, `4` locked. Can be combined by addition, e.g.
+    - used and displayed: 3 = 1 + 2
+    - used and locked but not displayed: 5 = 1 + 4
+    - used, displayed, and locked: 7 = 1 + 2 + 4
+7. activeColor active color.
+8. activateTransparency active transparency.
+9. inactiveColor inactive color.
+10. inactiveTransparency inactive transparency.
+
+```json
+["LAYER",2,"BOTTOM","Bottom Layer",1,"#0000ff",1,"#00007f",1]
+["LAYER",3,"TOP_SILK","Top Silkscreen Layer",1,"#ffcc00",1,"#7f6600",1]
+["LAYER",4,"BOT_SILK","Bottom Silkscreen Layer",1,"#66cc33",1,"#336619",1]
+["LAYER",5,"TOP_SOLDER_MASK","Top Solder Mask Layer",1,"#800080",1,"#400040",1]
+["LAYER",6,"BOT_SOLDER_MASK","Bottom Solder Mask Layer",1,"#aa00ff",1,"#55007f",1]
+["LAYER",7,"TOP_PASTE_MASK","Top Paste Mask Layer",1,"#808080",1,"#404040",1]
+["LAYER",8,"BOT_PASTE_MASK","Bottom Paste Mask Layer",1,"#800000",1,"#400000",1]
+["LAYER",9,"TOP_ASSEMBLY","Top Assembly Layer",1,"#33cc99",1,"#19664c",1]
+["LAYER",10,"BOT_ASSEMBLY","Bottom Assembly Layer",1,"#5555ff",1,"#2a2a7f",1]
+["LAYER",11,"OUTLINE","Board Outline Layer",1,"#ff00ff",1,"#7f007f",1]
+["LAYER",12,"MULTI","Multi-Layer",1,"#c0c0c0",1,"#606060",1]
+["LAYER",13,"DOCUMENT","Document Layer",1,"#ffffff",1,"#7f7f7f",1]
+["LAYER",14,"MECHANICAL","Mechanical Layer",1,"#f022f0",1,"#781178",1]
+["LAYER",50,"SUBSTRATE","Dialectric1",3,"#999966",1,"#4c4c33",1]
+["LAYER",15,"SIGNAL","Inner1",3,"#999966",1,"#4c4c33",1]
+["LAYER",52,"SUBSTRATE","Dialectric3",3,"#999966",1,"#4c4c33",1]
+["LAYER",51,"SUBSTRATE","Dialectric2",3,"#999966",1,"#4c4c33",1]
+["LAYER",17,"SIGNAL","Inner2",3,"#008000",1,"#004000",1]
+["LAYER",58,"SUBSTRATE","Dialectric9",3,"#999966",1,"#4c4c33",1]
+["LAYER",16,"SIGNAL","Inner3",3,"#999966",1,"#4c4c33",1]
+["LAYER",53,"SUBSTRATE","Dialectric4",3,"#999966",1,"#4c4c33",1]
+["LAYER",47,"HOLE","Hole Layer",1,"#222222",1,"#111111",1]
+["LAYER",48,"SHELL","3D Shell Layer",1,"#222222",1,"#111111",1]
+["LAYER",49,"TOP_SHELL","Top 3D Shell Layer",1,"#222222",1,"#111111",1]
+["LAYER",50,"BOT_SHELL","Bottom 3D Shell Layer",1,"#222222",1,"#111111",1]
+```
+
+## LAYER_PHYS Layer Physical Properties Configuration
+
+```json
+{ "type": "LAYER_PHYS","id": 0, "ticket": 1 }||
+{
+  "material":"COPPER",
+  "thickness":1,
+  "permittivity":0,
+  "lossTangent":0,
+  "isKeepIsland":0,
+}|
+```
+
+1. type layer physical properties `LAYER_PHYS`.
+2. id layer number.
+3. ticket logical clock.
+4. material layer material.
+5. thickness thickness.
+6. permittivity permittivity.
+7. lossTangent loss tangent.
+8. isKeepIsland whether to keep islands on internal plane layers.
+
+```json
+{ "type": "LAYER_PHYS","id": 2, "ticket": 1 }||
+{
+  "material":"COPPER",
+  "thickness":1,
+  "permittivity":0,
+  "lossTangent":0,
+  "isKeepIsland":0,
+}|
+```
+
+```json
+{ "type": "LAYER_PHYS","id": 15, "ticket": 1 }||
+{
+  "material":"COPPER",
+  "thickness":1,
+  "permittivity":0,
+  "lossTangent":0,
+  "isKeepIsland":1,
+}|
+```
+
+```json
+{ "type": "LAYER_PHYS","id": 50, "ticket": 1 }||
+{
+  "material":"COPPER",
+  "thickness":10,
+  "permittivity":4.5,
+  "lossTangent":0.02,
+  "isKeepIsland":0,
+}|
+```
+
+## ACTIVE_LAYER Active Layer Configuration
+
+```json
+{ "type": "ACTIVE_LAYER", "ticket": 1 }||
+{
+  "layerId":0,
+}|
+```
+
+1. type current active layer `ACTIVE_LAYER`.
+2. ticket logical clock.
+3. layerId layer index.
+
+## SILK_OPTS Silkscreen Configuration
+
+Silkscreen configuration is currently mainly used for colored silkscreen processes.
+
+```json
+{ "type": "SILK_OPTS","id": 3, "ticket": 1 }||
+{
+  "defaultColor":"#ffffff",
+  "baseColor":"#000000",
+}|
+```
+
+1. type silkscreen configuration: SILK_OPTS.
+2. id layer number: only top silkscreen and bottom silkscreen.
+3. ticket logical clock.
+4. defaultColor default color.
+5. baseColor base color.
+
+```json
+{ "type": "SILK_OPTS","id": 4, "ticket": 1 }||
+{
+  "defaultColor":"#020202",
+  "baseColor":"#aaaaaa",
+}|
+```
+
+## PREFERENCE Preferences
+
+```json
+{ "type": "PREFERENCE", "ticket": 1 }||
+{
+  "startTrackWidthFollowLast":0,
+  "lastTrackWidth":10,
+  "startViaSizeFollowLast":0,
+  "lastViaInnerDiameter":39.37,
+  "lastViaDiameter":78.74,
+  "snap":1,
+  "routingMode":2,
+  "routingCorner":"L45",
+  "removeLoop":1,
+  "rotatingObject":0,
+  "trackFollow":0,
+  "stretchTrackMinCorner":1,
+  "preferenceConfig":null,
+  "realTimeUpdateUnusedLayers":0,
+  "unusedPadRange":3,
+  "pushVia":"OPTIMIZA_OPEN",
+  "pathOptimization4BePushed":0,
+  "currentPathOptimization4BePushed":"OPTIMIZA_WEAK",
+  "removeCircuitsContainingVias":1,
+  "removeAntenna":1,
+}|
+```
+
+1. type preferences `PREFERENCE`.
+2. ticket logical clock.
+3. startTrackWidthFollowLast whether starting track width follows last setting.
+4. lastTrackWidth last track width.
+5. startViaSizeFollowLast whether starting via size follows last setting.
+6. lastViaInnerDiameter last via inner diameter.
+7. lastViaDiameter last via outer diameter.
+8. snap whether auto-snap.
+9. routingMode routing mode: `0` none, `1` push, `2` hug, `3` block.
+10. routingCorner routing corner mode.
+    - `"L45"` line 45 degrees.
+    - `"L90"` line 90 degrees.
+    - `"R45"` arc 45 degrees.
+    - `"R90"` arc 90 degrees.
+    - `"L"` free-angle line.
+    - `"R"` free-angle arc.
+11. removeLoop whether routing automatically removes loops.
+12. rotatingObject whether single-object rotation.
+13. trackFollow whether tracks follow footprint movement.
+14. stretchTrackMinCorner stretch track minimum corner ratio (to track width).
+15. preferenceConfig layer stack preference source.
+16. realTimeUpdateUnusedLayers whether to automatically remove unused pads.
+17. unusedPadRange range for removing unused pads.
+    1. all.
+    2. pads only.
+    3. vias only.
+18. pushVia push via.
+19. pathOptimization4BePushed path optimization (single segment / whole segment).
+20. currentPathOptimization4BePushed current track path optimization.
+21. removeCircuitsContainingVias whether to remove loops containing vias.
+22. removeAntenna whether to remove antennas.
+
+## ITEM_ORDER Primitive Order Suggestion
+
+Provides a primitive order suggestion for the PCB. The PCB can arrange primitive order according to this information. This information can only appear once.
+
+```json
+{ "type": "ITEM_ORDER",  "ticket": 1 }||{ "ids":["e2", "e1"] }|
+```
+
+1. type primitive order suggestion: ITEM_ORDER.
+2. ticket logical clock.
+3. ids primitive IDs, two encoding forms:
+    1. Normal ID: form `/^[a-z]+\d+$/i`, e.g. `e1`, `e123`.
+    2. Footprint instance ID: form `/^[a-z]+\d+[a-z]+\d+$/i`, used for silkscreen in footprints, e.g. `e1e5`, `e12e22`.
+
+To explain why it is called a "suggestion": if `e1` is a top-layer primitive and `e2` is a bottom-layer primitive, then
+
+```json
+{ "type": "ITEM_ORDER",  "ticket": 1 }||{ "ids":["e2", "e1"] }|
+```
+
+the default is still `e1` on top, unless some special operation causes the bottom layer to be brought to the front.