@windypro-rourou/dsh-eda 0.1.0 → 0.1.1

package/skill/format/schematic/obj.md

@@ -0,0 +1,41 @@
+# OBJ Binary Embedded Object
+
+Embedded images and files on the page, which can be downloaded as attachments or displayed directly (decided by EDA, not required by the format).
+
+```json
+{ "type": "OBJ", "id": "UUID", "ticket": 1 }||
+{
+    "partId": "",
+    "groupId": 0,
+    "locked": false,
+    "zIndex": 9.0876,
+    "fileName": "a.txt",
+    "startX": 200,
+    "startY": 300,
+    "width": 10,
+    "height": 20,
+    "rotation": 0,
+	"isMirror": false,
+	"content": "data:text/plain;base64,MTIzNA==",
+}|
+```
+
+1. type binary embedded object identifier: OBJ.
+2. id ID, unique within the file.
+3. ticket logical clock.
+4. partId sub-library ID, exclusive to symbol pages; ignored on schematics.
+5. groupId group ID, cannot be 0, empty by default when none.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. fileName file name.
+9. startX top-left X.
+10. startY top-left Y.
+11. width width.
+12. height height.
+13. rotation rotation angle, around `top-left`.
+14. isMirror whether mirrored.
+15. content binary data, two modes.
+    1. General format, compatible with `Data URLs`: `data:[<mediatype>][;base64],<data>`
+        - e.g. `data:image/png;base64,asdfasdfwer`
+        - e.g. `data:text/html,<html></html>`
+    2. BLOB reference mode, `blob:hashid`.

package/skill/format/schematic/pin.md

@@ -0,0 +1,59 @@
+# PIN Number
+
+![image](/storage/images/cn/format/schematic/pin/pin.png)
+
+As shown in the figure:
+-   The `position X/Y` of all PINs is the endpoint farthest from the black rectangle.
+-   PIN 1 is 0-degree rotation direction, pin style 0.
+-   PIN 2 is 90-degree rotation direction, pin style 1.
+-   PIN 3 is 180-degree rotation direction, pin style 2.
+-   PIN 4 is 270-degree rotation direction, pin style 3.
+
+```json
+{ "type": "PIN", "id": "UUID", "ticket": 1 }||
+{
+    "partId": "",
+    "groupId": 0,
+    "locked": false,
+    "zIndex": 2.8772,
+    "display": true,
+    "electric": 0,
+    "positionX": 350,
+    "positionY": 170,
+    "length": 20,
+    "rotation": 0,
+    "color": "#880000",
+    "pinShape": 3,
+}|
+```
+
+1. type primitive name: PIN.
+2. id ID, unique within the file.
+3. ticket logical clock.
+4. partId sub-library ID, exclusive to symbol pages; ignored on schematics.
+5. groupId group ID, cannot be 0, empty by default when none.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. display whether to display.
+9. electric electrical characteristic: 0 UNKNOWN, 1 INPUT, 2 OUTPUT, 3 BI.
+10. positionX position X.
+11. positionY position Y.
+12. length pin length.
+13. rotation rotation angle: 0, 90, 180, 270.
+14. color pin color.
+15. pinShape pin style: 1 Clock, 2 DOT; supports bitwise OR, e.g. 3 = 1 | 2.
+    Example: `0` no addition, `1` Clock, `2` DOT, `3` Clock & DOT.
+
+```json
+{ "type": "ATTR", "id": "e184", "ticket": 1 }||
+{ "partId": "", "groupId": 0, "locked": true, "zIndex": 0.1, "parentId": "e102", "key":"NAME", "value":"VCC", "keyVisible":true, "valueVisible":true, "positionX":108, "positionY":804.5, "rotation":0, "color":null, "fillColor":null, "fontFamily":null, "fontSize":null, "strikeout":null, "underline":null, "italic":null, "fontWeight":null, "vAlign":0, "hAlign":2,}|
+```
+
+PIN must have the NAME attribute.
+
+```json
+{ "type": "ATTR", "id": "e185", "ticket": 1 }||
+{ "partId": "", "groupId": 0, "locked": true, "zIndex": 0.1, "parentId": "e102", "key":"NUMBER", "value":"1", "keyVisible":true, "valueVisible":true, "positionX":108, "positionY":804.5, "rotation":0, "color":null, "fillColor":null, "fontFamily":null, "fontSize":null, "strikeout":null, "underline":null, "italic":null, "fontWeight":null, "vAlign":0, "hAlign":2,}|
+```
+
+PIN must have the NUMBER attribute.

package/skill/format/schematic/shape.md

@@ -0,0 +1,231 @@
+# Shape Primitives
+
+## RECT Rectangle
+
+A rectangle is defined by two diagonal points, and its rotation is around `point1`.
+
+```json
+{ "type": "RECT", "id": "UUID", "ticket": 1 }||
+{
+    "partId": "",
+    "groupId": 0,
+    "locked": false,
+    "zIndex": 7.35,
+    "dotX1": 340,
+    "dotY1": 210,
+    "dotX2": 100,
+    "dotY2": 200,
+    "radiusX": 40,
+    "radiusY": 30,
+    "rotation": 90,
+    "strokeColor": null,
+    "strokeStyle": 0,
+    "fillColor": "",
+    "strokeWidth": null,
+    "fillStyle": 1,
+}|
+```
+
+1. type primitive name: RECT.
+2. id ID, unique within the file.
+3. ticket logical clock.
+4. partId sub-library ID, exclusive to symbol pages; ignored on schematics.
+5. groupId group ID, cannot be 0, empty by default when none.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. dotX1 point 1 X.
+9. dotY1 point 1 Y.
+10. dotX2 point 2 X.
+11. dotY2 point 2 Y.
+12. radiusX corner radius X: `0` means no rounding.
+13. radiusY corner radius Y: `0` means no rounding.
+14. rotation rotation angle, around `point1`.
+15. strokeColor color, null for default.
+16. strokeStyle style: 0 solid, 1 dashed, 2 dotted, 3 dash-dot.
+17. fillColor fill color: `""` no fill; if filled, start and end points are automatically closed.
+18. strokeWidth width, null for default.
+19. fillStyle fill style: 0 none, 1 solid, 2 grid, 3 horizontal line, 4 vertical line, 5 diamond, 6 left slash, 7 right slash.
+
+## POLY Polygon
+
+```json
+{ "type": "POLY", "id": "UUID", "ticket": 1 }||
+{
+    "partId": "",
+    "groupId": 0,
+    "locked": false,
+    "zIndex": 7.35,
+    "points": [390, 260, 450, 300, 560, 280, 540, 320],
+    "closed": false,
+    "strokeColor": null,
+    "strokeStyle": 0,
+    "fillColor": "",
+    "strokeWidth": null,
+    "fillStyle": 1,
+}|
+```
+
+1. type primitive name: POLY.
+2. id ID, unique within the file.
+3. ticket logical clock.
+4. partId sub-library ID, exclusive to symbol pages; ignored on schematics.
+5. groupId group ID, cannot be 0, empty by default when none.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. points point set coordinates: X Y X Y X Y ...
+9. closed whether to auto-close: if auto-closed, the end point will automatically connect to the start point.
+10. strokeColor color, null for default.
+11. strokeStyle style: 0 solid, 1 dashed, 2 dotted, 3 dash-dot.
+12. fillColor fill color: `""` no fill; if filled, start and end points are automatically closed.
+13. strokeWidth width, null for default.
+14. fillStyle fill style: 0 none, 1 solid, 2 grid, 3 horizontal line, 4 vertical line, 5 diamond, 6 left slash, 7 right slash.
+
+## CIRCLE Circle
+
+```json
+{ "type": "CIRCLE", "id": "UUID", "ticket": 1 }||
+{
+    "partId": "",
+    "groupId": 0,
+    "locked": false,
+    "zIndex": 2.332,
+    "centerX": 430,
+    "centerY": 200,
+    "radius": 21,
+    "strokeColor": null,
+    "strokeStyle": 0,
+    "fillColor": "",
+    "strokeWidth": null,
+    "fillStyle": 1,
+}|
+```
+
+1. type primitive name: CIRCLE.
+2. id ID, unique within the file.
+3. ticket logical clock.
+4. partId sub-library ID, exclusive to symbol pages; ignored on schematics.
+5. groupId group ID, cannot be 0, empty by default when none.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. centerX circle center X.
+9. centerY circle center Y.
+10. radius radius r.
+11. strokeColor color, null for default.
+12. strokeStyle style: 0 solid, 1 dashed, 2 dotted, 3 dash-dot.
+13. fillColor fill color: `""` no fill; if filled, start and end points are automatically closed.
+14. strokeWidth width, null for default.
+15. fillStyle fill style: 0 none, 1 solid, 2 grid, 3 horizontal line, 4 vertical line, 5 diamond, 6 left slash, 7 right slash.
+
+## ARC Arc
+
+```json
+{ "type": "ARC", "id": "UUID", "ticket": 1 }||
+{
+    "partId": "",
+    "groupId": 0,
+    "locked": false,
+    "zIndex": 0.8689,
+    "startX": -10,
+    "startY": 0,
+    "referX": 0,
+    "referY": 10,
+    "endX": 10,
+    "endY": 0,
+    "strokeColor": null,
+    "strokeStyle": 0,
+    "fillColor": "",
+    "strokeWidth": null,
+    "fillStyle": 1,
+}|
+```
+
+1. type primitive name: ARC.
+2. id ID, unique within the file.
+3. ticket logical clock.
+4. partId sub-library ID, exclusive to symbol pages; ignored on schematics.
+5. groupId group ID, cannot be 0, empty by default when none.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. startX start X.
+9. startY start Y.
+10. referX reference X.
+11. referY reference Y.
+12. endX end X.
+13. endY end Y.
+14. strokeColor color, null for default.
+15. strokeStyle style: 0 solid, 1 dashed, 2 dotted, 3 dash-dot.
+16. fillColor fill color: `""` no fill; if filled, start and end points are automatically closed.
+17. strokeWidth width, null for default.
+18. fillStyle fill style: 0 none, 1 solid, 2 grid, 3 horizontal line, 4 vertical line, 5 diamond, 6 left slash, 7 right slash.
+
+## BEZIER Cubic Bezier Curve
+
+```json
+{ "type": "BEZIER", "id": "UUID", "ticket": 1 }||
+{
+    "partId": "",
+    "groupId": 0,
+    "locked": false,
+    "zIndex": 2.1002,
+    "controls": [10, 10, 30, 20, 100, 30, 50, 70],
+    "strokeColor": null,
+    "strokeStyle": 0,
+    "fillColor": "",
+    "strokeWidth": null,
+    "fillStyle": 1,
+}|
+```
+
+1. type primitive name: BEZIER.
+2. id ID, unique within the file.
+3. ticket logical clock.
+4. partId sub-library ID, exclusive to symbol pages; ignored on schematics.
+5. groupId group ID, cannot be 0, empty by default when none.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. controls control points: X1 Y1 X2 Y2 X3 Y3 X4 Y4 ...
+9. strokeColor color, null for default.
+10. strokeStyle style: 0 solid, 1 dashed, 2 dotted, 3 dash-dot.
+11. fillColor fill color: `""` no fill; if filled, start and end points are automatically closed.
+12. strokeWidth width, null for default.
+13. fillStyle fill style: 0 none, 1 solid, 2 grid, 3 horizontal line, 4 vertical line, 5 diamond, 6 left slash, 7 right slash.
+
+## ELLIPSE Ellipse
+
+```json
+{ "type": "ELLIPSE", "id": "UUID", "ticket": 1 }||
+{
+    "partId": "",
+    "groupId": 0,
+    "locked": false,
+    "zIndex": 6.23,
+    "centerX": 670,
+    "centerY": 325,
+    "radiusX": 220,
+    "radiusY": 20,
+    "rotation": 0,
+    "strokeColor": null,
+    "strokeStyle": 0,
+    "fillColor": "",
+    "strokeWidth": null,
+    "fillStyle": 1,
+}|
+```
+
+1. type primitive name: ELLIPSE.
+2. id ID, unique within the file.
+3. ticket logical clock.
+4. partId sub-library ID, exclusive to symbol pages; ignored on schematics.
+5. groupId group ID, cannot be 0, empty by default when none.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. centerX center cx.
+9. centerY center cy.
+10. radiusX horizontal radius rx.
+11. radiusY vertical radius ry.
+12. rotation rotation angle rot.
+13. strokeColor color, null for default.
+14. strokeStyle style: 0 solid, 1 dashed, 2 dotted, 3 dash-dot.
+15. fillColor fill color: `""` no fill; if filled, start and end points are automatically closed.
+16. strokeWidth width, null for default.
+17. fillStyle fill style: 0 none, 1 solid, 2 grid, 3 horizontal line, 4 vertical line, 5 diamond, 6 left slash, 7 right slash.

package/skill/format/schematic/structure.md

@@ -0,0 +1,53 @@
+# Structural Primitives
+
+## PART Sub-Library
+
+`PART` only exists on symbol pages.
+Even single-Part devices must have a `PART`; the sub-library ID is left empty `""`.
+
+```json
+{ "type": "PART","id":"partId", "ticket": 1 }||{"BBOX": [-10, -20, 10, 20]}|
+```
+
+1. type sub-library primitive: PART.
+2. id sub-library ID.
+3. ticket logical clock.
+4. Inner parameters: Key-Value
+    - Reserved `BBOX` is the bounding box that just encloses all primitives under the PART, defined by any two diagonal points.
+      **XTools core logic should not rely on this property.**
+    - Others are editor additional information for data analysis and other functions, optional.
+
+All primitives on the symbol page carry the corresponding sub-library ID to indicate they belong to that sub-library.
+
+```json
+{ "type": "WIRE", "id": "UUID", "ticket": 1 }||
+{
+    "partId": "partId", // symbol primitives carry this sub-library id
+    "groupId": 0,
+    "locked": false,
+    "zIndex": 0.235,
+    "dots": [
+        [310, 550, 400, 550, 400, 460],
+        [480, 460, 400, 460],
+        [400, 330, 400, 460]
+    ],
+    "strokeColor": null,
+    "strokeStyle": 0,
+    "fillColor": "",
+    "strokeWidth": null,
+    "fillStyle": 1,
+}|
+```
+
+## GROUP Group Control
+
+```json
+{ "type": "GROUP", "id": "UUID", "ticket": 1 }||{ "groupId": "1", "parentId": "0", "title": "Logo" }|
+```
+
+1. type group control `GROUP`.
+2. id unique ID.
+3. ticket logical clock.
+4. groupId group ID, cannot be 0.
+5. parentId parent group ID, 0 means no parent.
+6. title group name, empty string `""` if no name.

package/skill/format/schematic/table.md

@@ -0,0 +1,109 @@
+# Table Primitive
+
+## TABLE Table
+
+```json
+{ "type": "TABLE", "id": "UUID", "ticket": 1 }||
+{
+    "partId": "",
+    "groupId": 0,
+    "startX": 30,
+    "startY": 40,
+    "rowSizes": [32, 40, 32, 32, 25],
+    "colSizes": [33, 33, 44, 44, 11],
+    "rowLocked": [0, 0, 1, 0, 0],
+	"colLocked": [0, 1, 0, 0, 0],
+    "rotation": 0,
+}|
+```
+
+1. type table: `TABLE`.
+2. id ID, unique within the file.
+3. ticket logical clock.
+4. partId sub-library ID, exclusive to symbol pages; ignored on schematics.
+5. groupId group ID, cannot be 0, empty by default when none.
+6. startX top-left X.
+7. startY top-left Y.
+8. rowSizes row heights.
+9. colSizes column widths.
+10. rowLocked row lock.
+11. colLocked column lock.
+12. rotation rotation angle.
+
+## TABLE_CELL Table Cell
+
+```json
+{ "type": "TABLE", "id": "UUID", "ticket": 1 }||
+{
+    "tableId": "tableId",
+    "value": "abc\ndef\nghi",
+    "rowIndex": 2,
+    "columnIndex": 5,
+    "rowSpan": 1,
+    "colSpan": 3,
+	"topStyle": {
+        "strokeColor": null,
+	    "strokeStyle": 0,
+	    "fillColor": "",
+	    "strokeWidth": null,
+	    "fillStyle": 1,
+    },
+    "rightStyle": {
+        "strokeColor": null,
+	    "strokeStyle": 0,
+	    "fillColor": "",
+	    "strokeWidth": null,
+	    "fillStyle": 1,
+    },
+    "bottomStyle": {
+        "strokeColor": null,
+	    "strokeStyle": 0,
+	    "fillColor": "",
+	    "strokeWidth": null,
+	    "fillStyle": 1,
+    },
+    "leftStyle": {
+        "strokeColor": null,
+	    "strokeStyle": 0,
+	    "fillColor": "",
+	    "strokeWidth": null,
+	    "fillStyle": 1,
+    },
+    "leftStyle": {
+        "strokeColor": null,
+	    "strokeStyle": 0,
+	    "fillColor": "",
+	    "strokeWidth": null,
+	    "fillStyle": 1,
+    },
+    "fontStyle": {
+        "color": "#fff",
+	    "fillColor": "#fff",
+	    "fontFamily": "SimSun",
+	    "fontSize": 12,
+	    "strikeout": false,
+	    "underline": false,
+	    "italic": false,
+	    "fontWeight": false,
+	    "vAlign": 0 ,
+	    "hAlign": 2,
+    },
+    "lineHeight": 12,
+}|
+```
+
+1. type table cell: `TABLE_CELL`.
+2. id ID, unique within the file.
+3. ticket logical clock.
+4. tableId table ID.
+5. value content.
+6. rowIndex row.
+7. columnIndex column.
+8. rowSpan width (how many columns occupied).
+9. colSpan height (how many rows occupied).
+10. topStyle top border line style.
+11. rightStyle right border line style.
+12. bottomStyle bottom border line style.
+13. leftStyle left border line style.
+14. fontStyle font style.
+15. lineHeight line spacing.

package/skill/format/schematic/text.md

@@ -0,0 +1,47 @@
+# TEXT Text
+
+```json
+{ "type": "TEXT", "id": "UUID", "ticket": 1 }||
+{
+    "partId": "",
+    "groupId": 0,
+    "locked": false,
+    "zIndex": 4.12,
+    "positionX": 109,
+    "positionY": 804.5,
+    "rotation": 0,
+    "value": "any characters doukeyi@!@#$",
+    "color": "#fff",
+    "fillColor": "#fff",
+    "fontFamily": "SimSun",
+    "fontSize": 12,
+    "strikeout": false,
+    "underline": false,
+    "italic": false,
+    "fontWeight": false,
+    "vAlign": 0 ,
+    "hAlign": 2,
+}|
+```
+
+1. type primitive name: TEXT.
+2. id ID, unique within the file.
+3. ticket logical clock.
+4. partId sub-library ID, exclusive to symbol pages; ignored on schematics.
+5. groupId group ID, cannot be 0, empty by default when none.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. positionX text coordinate X.
+9. positionY text coordinate Y.
+10. rotation rotation angle, around text coordinate.
+11. value text content: any characters.
+12. color color.
+13. fillColor background color.
+14. fontFamily font name.
+15. fontSize font size, same unit as coordinates.
+16. strikeout whether to strike out.
+17. underline whether to underline.
+18. italic whether italic.
+19. fontWeight whether bold.
+20. vAlign vertical alignment: 0 top, 1 middle, 2 bottom.
+21. hAlign horizontal alignment: 0 left, 1 center, 2 right.

package/skill/format/schematic/wire.md

@@ -0,0 +1,132 @@
+# Wire Primitives
+
+## WIRE Wire
+
+```json
+{ "type": "WIRE", "id": "UUID", "ticket": 1 }||
+{
+    "partId": "",
+    "groupId": 0,
+    "locked": false,
+    "zIndex": 0.235,
+    "dots": [
+        [310, 550, 400, 550, 400, 460],
+        [480, 460, 400, 460],
+        [400, 330, 400, 460]
+    ],
+    "strokeColor": null,
+    "strokeStyle": 0,
+    "fillColor": "",
+    "strokeWidth": null,
+    "fillStyle": 1,
+}|
+```
+
+1. type primitive name: WIRE.
+2. id unique ID.
+3. ticket logical clock.
+4. partId sub-library ID, exclusive to symbol pages; ignored on schematics.
+5. groupId group ID, cannot be 0, empty by default when none.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. dots coordinates: divided into multiple segments, each segment is a continuous set of X1 Y1 X2 Y2 X3 Y3 ... describing a line.
+9. strokeColor color, null for default.
+10. strokeStyle style: 0 solid, 1 dashed, 2 dotted, 3 dash-dot.
+11. fillColor fill color: `""` no fill; if filled, start and end points are automatically closed.
+12. strokeWidth width, null for default.
+13. fillStyle fill style: 0 none, 1 solid, 2 grid, 3 horizontal line, 4 vertical line, 5 diamond, 6 left slash, 7 right slash.
+
+```json
+{ "type": "ATTR", "id": "e200", "ticket": 1 }||
+{ "partId": "", "groupId": 0, "locked": true, "zIndex": 0.1, "parentId": "e271", "key":"NET", "value":"GND", "keyVisible":true, "valueVisible":true, "positionX":108, "positionY":804.5, "rotation":0, "color":null, "fillColor":null, "fontFamily":null, "fontSize":null, "strikeout":null, "underline":null, "italic":null, "fontWeight":null, "vAlign":0, "hAlign":2,}|
+```
+
+Wires must carry the NET attribute to identify the net name.
+
+## BUS Bus
+
+```json
+{ "type": "BUS", "id": "UUID", "ticket": 1 }||
+{
+    "partId": "",
+    "groupId": 0,
+    "locked": false,
+    "zIndex": 0.235,
+    "dots": [
+        [310, 550, 400, 550, 400, 460],
+        [480, 460, 400, 460],
+        [400, 330, 400, 460]
+    ],
+    "strokeColor": null,
+    "strokeStyle": 0,
+    "fillColor": "",
+    "strokeWidth": null,
+    "fillStyle": 1,
+}|
+```
+
+1. type primitive name: BUS.
+2. id unique ID.
+3. ticket logical clock.
+4. partId sub-library ID, exclusive to symbol pages; ignored on schematics.
+5. groupId group ID, cannot be 0, empty by default when none.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. dots coordinates: divided into multiple segments, each segment is a continuous set of X1 Y1 X2 Y2 X3 Y3 ... describing a line.
+9. strokeColor color, null for default.
+10. strokeStyle style: 0 solid, 1 dashed, 2 dotted, 3 dash-dot.
+11. fillColor fill color: `""` no fill; if filled, start and end points are automatically closed.
+12. strokeWidth width, null for default.
+13. fillStyle fill style: 0 none, 1 solid, 2 grid, 3 horizontal line, 4 vertical line, 5 diamond, 6 left slash, 7 right slash.
+
+```json
+{ "type": "ATTR", "id": "e200", "ticket": 1 }||
+{ "partId": "", "groupId": 0, "locked": true, "zIndex": 0.1, "parentId": "e271", "key":"NET", "value":"A[1:5]", "keyVisible":true, "valueVisible":true, "positionX":108, "positionY":804.5, "rotation":0, "color":null, "fillColor":null, "fontFamily":null, "fontSize":null, "strikeout":null, "underline":null, "italic":null, "fontWeight":null, "vAlign":0, "hAlign":2,}|
+```
+
+Buses must carry the NET attribute to identify the net name.
+
+## BUSENTRY Bus Entry Marker
+
+![image](/storage/images/cn/format/schematic/wire/ripper.png)
+
+As shown in the figure:
+-   Light yellow is `BUS`.
+-   The green rounded rhombus and the PIN-like shape extending to the right are `BUSENTRY`.
+-   Blue is `Wire`.
+-   The endpoint is the coordinate of the endpoint where `WIRE` and `BUSENTRY` (similar to `PIN`) touch on the far right.
+-   Because `WIRE` and `BUS` can connect at any angle, the rotation direction must be specified to match the incoming direction of `WIRE`. In the figure, it is 180 degrees.
+-   `BUSENTRY` has a fixed one-grid length.
+-   The specific shape of `BUSENTRY` is ultimately interpreted by XTools and is not constrained by the format.
+
+```json
+{ "type": "BUSENTRY", "id": "UUID", "ticket": 1 }||
+{
+    "partId": "",
+    "groupId": 0,
+    "locked": false,
+    "zIndex": 0.235,
+    "busGroupId": 4,
+    "order": 4,
+    "pointX": 500,
+    "pointY": 600,
+    "rotation": 90,
+}|
+```
+
+1. type primitive name: BUSENTRY.
+2. id ID, unique within the file.
+3. ticket logical clock.
+4. partId sub-library ID, exclusive to symbol pages; ignored on schematics.
+5. groupId group ID, cannot be 0, empty by default when none.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. busGroupId sequence number: sequence within the affiliated BUS, may repeat.
+   For example, a BUS net of A[2:3]B[7:6] can have a series of BUSENTRYs numbered 0 1 2 3 0 1 2 3 ..., where
+   0 always represents branch A2B7,
+   1 always represents branch A2B6,
+   2 always represents branch A3B7,
+   3 always represents branch A3B6.
+9. pointX endpoint X.
+10. pointY endpoint Y.
+11. rotation rotation angle, around `endpoint`.

package/skill/guide/ancillary-projects/pro-api-sdk.md

@@ -0,0 +1 @@
+<!--@include: @/private/pro-api-sdk/README.en.md{3,}-->

package/skill/guide/ancillary-projects/pro-api-types.md

@@ -0,0 +1,5 @@
+---
+next: false
+---
+
+<!--@include: @/node_modules/@jlceda/pro-api-types/README.en.md{3,}-->