simplecadapi 2.1.3b1__tar.gz → 2.1.4__tar.gz

{simplecadapi-2.1.3b1 → simplecadapi-2.1.4}/.gitignore

@@ -53,6 +53,7 @@ examples/histcad/
 # Research tool scan outputs (generated by tools/research scripts)
 tools/research/out/
 tools/research/histjson/out/
+tools/research/whucad/out/
 tools/research/cadqueryftc/out/
 .venv-cq/
 

{simplecadapi-2.1.3b1 → simplecadapi-2.1.4}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: simplecadapi
-Version: 2.1.3b1
+Version: 2.1.4
 Summary: A simplified OCP-native CAD modeling Python API
-Project-URL: Homepage, https://github.com/NiJingzhe/SimpleCADAPI
-Project-URL: Repository, https://github.com/NiJingzhe/SimpleCADAPI
-Project-URL: Documentation, https://github.com/NiJingzhe/SimpleCADAPI#readme
-Project-URL: Issues, https://github.com/NiJingzhe/SimpleCADAPI/issues
+Project-URL: Homepage, https://github.com/PhySpace/SimpleCADAPI
+Project-URL: Repository, https://github.com/PhySpace/SimpleCADAPI
+Project-URL: Documentation, https://github.com/PhySpace/SimpleCADAPI#readme
+Project-URL: Issues, https://github.com/PhySpace/SimpleCADAPI/issues
 Author-email: 倪旌哲 <nijingzhe@zju.edu.cn>
 Maintainer-email: 倪旌哲 <nijingzhe@zju.edu.cn>
 License: 
@@ -228,8 +228,10 @@ Requires-Python: <3.14,>=3.10
 Requires-Dist: cadquery-ocp>=7.9.3.1
 Requires-Dist: ezdxf>=1.4.4
 Requires-Dist: jsonschema<5.0.0,>=4.25.1
+Requires-Dist: marimo>=0.25.0
 Requires-Dist: numpy>=1.21.0
 Requires-Dist: ocp-gordon<0.3,>=0.2
+Requires-Dist: plotly>=7.1.0
 Requires-Dist: py-slvs==1.0.6
 Requires-Dist: pymupdf>=1.28.2
 Requires-Dist: rfc8785<0.2.0,>=0.1.4
@@ -250,6 +252,8 @@ Provides-Extra: gmsh
 Requires-Dist: gmsh<5,>=4.15; extra == 'gmsh'
 Provides-Extra: inspect
 Requires-Dist: matplotlib>=3.7.0; extra == 'inspect'
+Provides-Extra: whucad
+Requires-Dist: h5py>=3.8; extra == 'whucad'
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -297,9 +301,9 @@ deterministic face tags that survive re-parameterization, and synchronized
 <td>"Formalize the existing legacy L-bracket script through the single-part workflow: rebuild with FTC feature blocks and named parameters; geometric equivalence to the legacy model (volume delta < 0.1%); the <code>interface.*</code> FEM boundary tags must survive untouched — the downstream Gmsh/CalculiX pipeline selects faces by them."</td>
 <td><img src="img/capability/bracket_turntable.gif" width="420" alt="bracket turntable"></td>
 </tr>
-Turntables are rendered by the in-repo [Scene Viewer](viewer/)'s BRep renderer
-(face shading + wide edges); one full turn = 48 deterministic azimuth steps
-driven through `viewer/gif-harness.html`.
+Turntables are rendered by the standalone [sca-web-editor](https://github.com/PhySpace/sca-web-editor)'s
+BRep renderer (face shading + wide edges); one full turn = 48 deterministic
+azimuth steps driven through its `gif-harness.html`.
 
 </table>
 
@@ -425,7 +429,7 @@ in a compact public API for creating solids, applying features, tagging semantic
 intent, querying topology, exporting manufacturing files, and translating recorded
 models into FreeCAD workflows.
 
-Current release: `simplecadapi==2.1.3b1`.
+Current release: `simplecadapi==2.1.3`.
 
 ## What It Provides
 
@@ -468,6 +472,29 @@ For local development from this repository:
 uv sync --group dev
 ```
 
+### Agent Skill
+
+After installing with pip above, install the bundled skill for your agent
+harness:
+
+```bash
+sca skill targets
+# Default location (~/.agents/skills), or select ZCode's explicitly:
+sca skill install --target zcode --skills-dir ~/.zcode/skills
+```
+
+`targets` lists the available harness targets. `install` compiles the bundled
+source and writes it to `<skills-dir>/simplecadapi`; without `--skills-dir`,
+it uses the existing addon configuration/environment resolution, falling back
+to `~/.agents/skills`; `sca init` is not required. The wheel includes the
+uncompiled `docs/skill/` source tree and `skillproj.toml` as package
+resources — compilation happens on install, no repository checkout needed.
+With `uv`, prefix these commands with `uv run`.
+
+`install` fails if the destination already exists. Add `--force` to replace it
+only if it is a directory whose `SKILL.md` declares the matching skill name
+(`simplecadapi`); unrelated directories cannot be overwritten.
+
 ## Quick Start
 
 ```python
@@ -577,9 +604,9 @@ print(cold.cache_report.hit, warm.cache_report.hit)
 Inspect or maintain the cache with stable JSON output:
 
 ```bash
-simplecad-cache status
-simplecad-cache verify
-simplecad-cache prune
+sca cache status
+sca cache verify
+sca cache prune
 ```
 
 See the [persistent cache and product build workflow](docs/skill/references/docs/guides/cache-build-workflow.md)
@@ -608,7 +635,7 @@ Export the standard delivery set (AP242 STEP, binary STL, and OBJ) from a
 validated product package with no wrapper script:
 
 ```bash
-uv run simplecad-export out/mounting_plate.scadpkg --output-dir out/exports
+uv run sca export out/mounting_plate.scadpkg --output-dir out/exports
 ```
 
 Request additional targets explicitly.  FCStd requires `FreeCADCmd` (or an
@@ -616,9 +643,9 @@ explicit `--freecad-cmd` path); `--check` validates the package, output paths,
 and selected target prerequisites without writing files.
 
 ```bash
-uv run simplecad-export out/mounting_plate.scadpkg \
+uv run sca export out/mounting_plate.scadpkg \
   --format fcstd --format mjcf --output-dir out/exports --check
-uv run simplecad-export out/mounting_plate.scadpkg \
+uv run sca export out/mounting_plate.scadpkg \
   --format fcstd --freecad-cmd /path/to/FreeCADCmd --output-dir out/exports
 ```
 STL and OBJ share one direct OpenCASCADE tessellation of the evaluated BREP.
@@ -781,8 +808,8 @@ uv run python examples/ap242_gmsh_volume_mesh/model.py
 uv run --extra fem python examples/ap242_gmsh_volume_mesh/run_calculix.py
 ```
 
-Reverse engineering runs through the browser studio in `viewer/re.html`
-against a target STEP (see `examples/bowl_connector/`).
+Reverse engineering runs through the `Re-mode` workspace in the unified Web
+Editor at `/` against a target STEP (see `examples/bowl_connector/`).
 
 ## Documentation
 
@@ -811,11 +838,14 @@ against a target STEP (see `examples/bowl_connector/`).
 ## Releasing the Agent Skill
 
 The skill source tree lives under `docs/skill/` and stays harness-neutral.
-`tools/skillbuild.py` compiles it per harness target (targets and output
-directories are configured in `skillproj.toml`; the outputs under
-`skills/simplecadapi-*/` are regenerable build artifacts and are not
+`tools/skillbuild.py` wraps the same compiler the `sca skill` CLI uses, for
+maintainer builds in this repository: it compiles per harness target (targets
+and default output directories are configured in `skillproj.toml`; the outputs
+under `skills/simplecadapi-*/` are regenerable build artifacts and are not
 committed). Harness-specific text, when it is ever needed, is marked with
-`<!-- skill:if ... -->` conditional blocks that compile per target.
+`<!-- skill:if ... -->` conditional blocks that compile per target. The wheel
+itself never contains precompiled targets — end users install from the
+bundled source with `sca skill install`.
 
 From a clean checkout, update the project version and documentation, then
 build and validate the release artifacts:
@@ -838,7 +868,8 @@ tar -tzf skills/simplecadapi.tar.gz | head
 ```
 
 Commit only the `docs/skill/` source tree; the release workflow builds the
-harness outputs and uploads the archive to the GitHub release.
+harness outputs and uploads the archive to the GitHub release. Prefer
+`sca skill` for installation from a pip-installed package.
 
 ## Development
 
@@ -859,3 +890,13 @@ The group chat currently has too many members for direct QR-code joining. Scan t
 <p align="center">
   <img src="img/dp个人账号.png.jpg" alt="Teacher Du Peng's personal WeChat QR code" width="420">
 </p>
+
+## Star History
+
+<a href="https://www.star-history.com/?repos=PhySpace%2FSimpleCADAPI&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=PhySpace/SimpleCADAPI&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=PhySpace/SimpleCADAPI&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=PhySpace/SimpleCADAPI&type=date&legend=top-left" />
+ </picture>
+</a>

{simplecadapi-2.1.3b1 → simplecadapi-2.1.4}/README.md

@@ -43,9 +43,9 @@ deterministic face tags that survive re-parameterization, and synchronized
 <td>"Formalize the existing legacy L-bracket script through the single-part workflow: rebuild with FTC feature blocks and named parameters; geometric equivalence to the legacy model (volume delta < 0.1%); the <code>interface.*</code> FEM boundary tags must survive untouched — the downstream Gmsh/CalculiX pipeline selects faces by them."</td>
 <td><img src="img/capability/bracket_turntable.gif" width="420" alt="bracket turntable"></td>
 </tr>
-Turntables are rendered by the in-repo [Scene Viewer](viewer/)'s BRep renderer
-(face shading + wide edges); one full turn = 48 deterministic azimuth steps
-driven through `viewer/gif-harness.html`.
+Turntables are rendered by the standalone [sca-web-editor](https://github.com/PhySpace/sca-web-editor)'s
+BRep renderer (face shading + wide edges); one full turn = 48 deterministic
+azimuth steps driven through its `gif-harness.html`.
 
 </table>
 
@@ -171,7 +171,7 @@ in a compact public API for creating solids, applying features, tagging semantic
 intent, querying topology, exporting manufacturing files, and translating recorded
 models into FreeCAD workflows.
 
-Current release: `simplecadapi==2.1.3b1`.
+Current release: `simplecadapi==2.1.3`.
 
 ## What It Provides
 
@@ -214,6 +214,29 @@ For local development from this repository:
 uv sync --group dev
 ```
 
+### Agent Skill
+
+After installing with pip above, install the bundled skill for your agent
+harness:
+
+```bash
+sca skill targets
+# Default location (~/.agents/skills), or select ZCode's explicitly:
+sca skill install --target zcode --skills-dir ~/.zcode/skills
+```
+
+`targets` lists the available harness targets. `install` compiles the bundled
+source and writes it to `<skills-dir>/simplecadapi`; without `--skills-dir`,
+it uses the existing addon configuration/environment resolution, falling back
+to `~/.agents/skills`; `sca init` is not required. The wheel includes the
+uncompiled `docs/skill/` source tree and `skillproj.toml` as package
+resources — compilation happens on install, no repository checkout needed.
+With `uv`, prefix these commands with `uv run`.
+
+`install` fails if the destination already exists. Add `--force` to replace it
+only if it is a directory whose `SKILL.md` declares the matching skill name
+(`simplecadapi`); unrelated directories cannot be overwritten.
+
 ## Quick Start
 
 ```python
@@ -323,9 +346,9 @@ print(cold.cache_report.hit, warm.cache_report.hit)
 Inspect or maintain the cache with stable JSON output:
 
 ```bash
-simplecad-cache status
-simplecad-cache verify
-simplecad-cache prune
+sca cache status
+sca cache verify
+sca cache prune
 ```
 
 See the [persistent cache and product build workflow](docs/skill/references/docs/guides/cache-build-workflow.md)
@@ -354,7 +377,7 @@ Export the standard delivery set (AP242 STEP, binary STL, and OBJ) from a
 validated product package with no wrapper script:
 
 ```bash
-uv run simplecad-export out/mounting_plate.scadpkg --output-dir out/exports
+uv run sca export out/mounting_plate.scadpkg --output-dir out/exports
 ```
 
 Request additional targets explicitly.  FCStd requires `FreeCADCmd` (or an
@@ -362,9 +385,9 @@ explicit `--freecad-cmd` path); `--check` validates the package, output paths,
 and selected target prerequisites without writing files.
 
 ```bash
-uv run simplecad-export out/mounting_plate.scadpkg \
+uv run sca export out/mounting_plate.scadpkg \
   --format fcstd --format mjcf --output-dir out/exports --check
-uv run simplecad-export out/mounting_plate.scadpkg \
+uv run sca export out/mounting_plate.scadpkg \
   --format fcstd --freecad-cmd /path/to/FreeCADCmd --output-dir out/exports
 ```
 STL and OBJ share one direct OpenCASCADE tessellation of the evaluated BREP.
@@ -527,8 +550,8 @@ uv run python examples/ap242_gmsh_volume_mesh/model.py
 uv run --extra fem python examples/ap242_gmsh_volume_mesh/run_calculix.py
 ```
 
-Reverse engineering runs through the browser studio in `viewer/re.html`
-against a target STEP (see `examples/bowl_connector/`).
+Reverse engineering runs through the `Re-mode` workspace in the unified Web
+Editor at `/` against a target STEP (see `examples/bowl_connector/`).
 
 ## Documentation
 
@@ -557,11 +580,14 @@ against a target STEP (see `examples/bowl_connector/`).
 ## Releasing the Agent Skill
 
 The skill source tree lives under `docs/skill/` and stays harness-neutral.
-`tools/skillbuild.py` compiles it per harness target (targets and output
-directories are configured in `skillproj.toml`; the outputs under
-`skills/simplecadapi-*/` are regenerable build artifacts and are not
+`tools/skillbuild.py` wraps the same compiler the `sca skill` CLI uses, for
+maintainer builds in this repository: it compiles per harness target (targets
+and default output directories are configured in `skillproj.toml`; the outputs
+under `skills/simplecadapi-*/` are regenerable build artifacts and are not
 committed). Harness-specific text, when it is ever needed, is marked with
-`<!-- skill:if ... -->` conditional blocks that compile per target.
+`<!-- skill:if ... -->` conditional blocks that compile per target. The wheel
+itself never contains precompiled targets — end users install from the
+bundled source with `sca skill install`.
 
 From a clean checkout, update the project version and documentation, then
 build and validate the release artifacts:
@@ -584,7 +610,8 @@ tar -tzf skills/simplecadapi.tar.gz | head
 ```
 
 Commit only the `docs/skill/` source tree; the release workflow builds the
-harness outputs and uploads the archive to the GitHub release.
+harness outputs and uploads the archive to the GitHub release. Prefer
+`sca skill` for installation from a pip-installed package.
 
 ## Development
 
@@ -605,3 +632,13 @@ The group chat currently has too many members for direct QR-code joining. Scan t
 <p align="center">
   <img src="img/dp个人账号.png.jpg" alt="Teacher Du Peng's personal WeChat QR code" width="420">
 </p>
+
+## Star History
+
+<a href="https://www.star-history.com/?repos=PhySpace%2FSimpleCADAPI&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=PhySpace/SimpleCADAPI&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=PhySpace/SimpleCADAPI&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=PhySpace/SimpleCADAPI&type=date&legend=top-left" />
+ </picture>
+</a>

{simplecadapi-2.1.3b1 → simplecadapi-2.1.4}/docs/skill/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: simplecadapi
-description: Build, assemble, inspect, reconstruct, and export parametric CAD models with the SimpleCADAPI Python SDK. Use for SimpleCAD geometry modeling, constrained sketches, parts and assemblies, standard gears and bearings, STEP/BREP inspection and reconstruction, durable product packages, model JSON replay, and CAD backend translation.
+description: Build, assemble, inspect, reconstruct, and export parametric CAD models with the SimpleCADAPI Python SDK. Use for SimpleCAD geometry modeling, constrained sketches, parts and assemblies, standard gears and bearings, STEP/BREP inspection and reconstruction, vector-PDF drawing reconstruction, durable product packages, model JSON replay, and CAD backend translation.
 license: Apache-2.0
 metadata:
   project: simplecadapi
-  version: 2.1.3b1
+  version: 2.1.3
   package-name: simplecadapi
-  package-version: 2.1.3b1
+  package-version: 2.1.3
 ---
 
 # SimpleCAD SDK Skill
@@ -60,6 +60,7 @@ Read exactly one workflow first, per the user's goal:
 | Rebuild an editable model from a STEP file | `references/workflows/step-reconstruction.md` |
 | Export/translate a validated package | `references/workflows/export-and-translation.md` |
 | Produce a GB engineering drawing (DXF) from validated geometry | `references/workflows/engineering-drawing.md` |
+| Rebuild a 3D model from a vector-PDF engineering drawing | `references/workflows/drawing-reconstruction.md` |
 
 Do not present route-choice menus when a row already matches: profile,
 strategy, and tool choices inside a route belong to that workflow's
@@ -119,9 +120,9 @@ it and stop that route; never invent an alternative route.
    `@scad.assemble` for assemblies with explicit definitions.
    Neither nests inside an active `GraphSession`. Durable delivery
    is `capture(result, "out/product.scadpkg")` in one call.
-9. `simplecadapi.inspect.brep` is diagnostic-only and rejected
-   inside `GraphSession`; obtain/export geometry first, inspect
-   outside.
+9. `simplecadapi.inspect.brep` and `simplecadapi.inspect.drawing` are
+   diagnostic-only and rejected inside `GraphSession`; obtain/export
+   geometry first, inspect outside.
 10. Standard parts first: before hand-modeling a gear, ring gear,
     rack, cycloidal disc, or bearing, check `scad.std.gear` /
     `scad.std.bearing`.
@@ -178,8 +179,8 @@ print(len(rebuilt))
 ## References
 
 - `references/README.md` — skill layer structure
-- `references/workflows/` — six goal-oriented workflows
-- `references/domains/` — nine capability domains
+- `references/workflows/` — goal-oriented workflows, including drawing reconstruction
+- `references/domains/` — capability domains, including drawing inspection
 - `references/discipline/` — modeling knowledge and invariants
 - `references/SDK_OVERVIEW.md` — package-level map
 - `references/inspect/brep-reverse-engineering.md`

{simplecadapi-2.1.3b1 → simplecadapi-2.1.4}/docs/skill/references/README.md

@@ -33,6 +33,7 @@ whole API index up front.
 | `assembly-and-product` | parts, placements, connectors, constraints, @part/@assemble, cache, `.scadpkg` |
 | `standard-parts` | stdlib gears, ring gears, racks, cycloidal discs, bearings |
 | `step-inspection` | STEP/BREP evidence, comparison, reconstruction evaluation |
+| `drawing-inspection` | vector-PDF coordinates and dimensions, model-section measurements, independent evidence validation |
 | `export-and-translation` | STEP/STL/OBJ/MJCF export, FreeCAD/Fusion/SolidWorks translation |
 | `addon-development` | third-party addon authoring and management: `sca` CLI, `sca-addon.toml` descriptor, runtime probes, addon SKILL.md requirements |
 
@@ -51,6 +52,7 @@ exporters) lives in `scadpkg-format.md`.
 | `single-part-modeling` | one physical part from brief to validated solid — sketch tier by default, std parts first |
 | `assembly-product-build` | multi-part product or mechanism with connectors/constraints and package capture; stdlib gears/bearings live here |
 | `step-reconstruction` | editable rebuild from a target STEP with tiered acceptance |
+| `drawing-reconstruction` | editable rebuild from vector-PDF dimensions with stage checks and independent drawing/model/output acceptance |
 | `export-and-translation` | downstream formats from a validated package |
 
 Each workflow states: goal/scope, task decomposition (required/optional

{simplecadapi-2.1.3b1 → simplecadapi-2.1.4}/docs/skill/references/docs/api/CacheLockTimeout.md

@@ -15,3 +15,5 @@ class CacheLockTimeout
 ## Description
 
 Raised when a cache key remains locked past policy timeout.
+
+Stays catchable as TimeoutError for lock-handling callers.

simplecadapi-2.1.4/docs/skill/references/docs/api/DrawingCalibration.md

@@ -0,0 +1,22 @@
+# DrawingCalibration
+
+## Class Definition
+
+```python
+class DrawingCalibration(pair_count: int, scale_mm_per_pt: float, scales_per_pair: list[float], max_relative_deviation: float, relative_tolerance: float, min_pairs: int, accepted: bool)
+```
+
+*Source: inspect/drawing/calibrate.py*
+
+## Import Surface
+
+- drawing-inspection namespace: `from simplecadapi.inspect import drawing` then `drawing.DrawingCalibration(...)`; unavailable inside GraphSession
+
+## Description
+
+Consensus mm-per-pt scale fitted from independent known dimensions.
+
+``accepted`` requires at least ``min_pairs`` pairs and all per-pair
+scales agreeing within ``relative_tolerance``. A calibration that failed
+must never be used to produce derived numbers: fix the anchor selection
+or the measurement instead.

simplecadapi-2.1.4/docs/skill/references/docs/api/DrawingMeasurements.md

@@ -0,0 +1,22 @@
+# DrawingMeasurements
+
+## Class Definition
+
+```python
+class DrawingMeasurements(measurement_count: int, scale_mm_per_pt: float | None, measurements: list[dict[str, Any]])
+```
+
+*Source: inspect/drawing/calibrate.py*
+
+## Import Surface
+
+- drawing-inspection namespace: `from simplecadapi.inspect import drawing` then `drawing.DrawingMeasurements(...)`; unavailable inside GraphSession
+
+## Description
+
+Point-pair and stroke-length measurements with optional mm conversion.
+
+Every entry keeps its native ``length_pt``; ``length_mm`` is populated
+only when a calibration is supplied. Millimetre values derived here are
+〔推算〕-grade claims: they must be cross-checked against annotated
+dimensions before they harden into facts.

simplecadapi-2.1.4/docs/skill/references/docs/api/DrawingSectionDimensions.md

@@ -0,0 +1,27 @@
+# DrawingSectionDimensions
+
+## Class Definition
+
+```python
+class DrawingSectionDimensions(source: str, plane: dict[str, Any], closed_contour_count: int, open_contour_count: int, measurements: list[dict[str, Any]], metadata: dict[str, Any] = field(default_factory=dict), configuration: dict[str, Any] = field(default_factory=dict), section_validation: dict[str, Any] = field(default_factory=dict), circle_diagnostics: list[dict[str, Any]] = field(default_factory=list))
+```
+
+*Source: inspect/drawing/section.py*
+
+## Import Surface
+
+- drawing-inspection namespace: `from simplecadapi.inspect import drawing` then `drawing.DrawingSectionDimensions(...)`; unavailable inside GraphSession
+
+## Description
+
+Candidate dimensions measured from one model section.
+
+Entries are candidates, not verdicts: the caller picks the ones that
+correspond to ledger rows and passes them back to
+:func:`render_model_section_rpath` with ``dim_id`` / ``nominal`` filled
+in. ``thickness`` candidates arise only from nested contour pairs; wall
+thickness of side-by-side strips shows up as a contour ``extent``.
+``section_validation`` separately reports closure, material topology and
+solid/section/display point checks; ``circle_diagnostics`` includes open
+contours and rejected fits. Neither output turns an uncertain value into
+a verified dimension.

simplecadapi-2.1.4/docs/skill/references/docs/api/DrawingStrokes.md

@@ -0,0 +1,25 @@
+# DrawingStrokes
+
+## Class Definition
+
+```python
+class DrawingStrokes(source: str, page: int, rotation: int, width_pt: float, height_pt: float, total_primitives: int, matched: int, strokes: list[dict[str, Any]], stroke_color_census: dict[str, int], fill_color_census: dict[str, int], metadata: dict[str, Any] = field(default_factory=dict))
+```
+
+*Source: inspect/drawing/geometry.py*
+
+## Import Surface
+
+- drawing-inspection namespace: `from simplecadapi.inspect import drawing` then `drawing.DrawingStrokes(...)`; unavailable inside GraphSession
+
+## Description
+
+Normalized path primitives of one page in display space.
+
+``strokes`` are flattened one entry per path item: ``line`` carries two
+endpoints, ``bezier`` carries all four control points (first and last are
+on-curve), ``quad`` carries the four corners in perimeter order, ``rect``
+carries four corners in perimeter order. ``total_primitives`` counts every item on
+the page; ``matched`` counts the entries that survived the filters. Only
+verified vector coordinates support calibrated measurements; coordinate
+preflight and feature-association checks are still required.

simplecadapi-2.1.4/docs/skill/references/docs/api/DrawingSummary.md

@@ -0,0 +1,23 @@
+# DrawingSummary
+
+## Class Definition
+
+```python
+class DrawingSummary(source: str, page_count: int, route: str, metadata: dict[str, Any], fonts: list[str], pages: list[dict[str, Any]])
+```
+
+*Source: inspect/drawing/summary.py*
+
+## Import Surface
+
+- drawing-inspection namespace: `from simplecadapi.inspect import drawing` then `drawing.DrawingSummary(...)`; unavailable inside GraphSession
+
+## Description
+
+Facts-only health report for one PDF drawing document.
+
+``route`` recommends how the downstream analysis should treat the file:
+``vector`` (mine the text and vector layers), ``raster`` (render-only
+reading), ``mixed`` (both layers present), ``text_only`` (no graphics at
+all), or ``empty`` (nothing extractable). The verdict is counted from
+per-page facts; no geometric or semantic interpretation happens here.

simplecadapi-2.1.4/docs/skill/references/docs/api/DrawingText.md

@@ -0,0 +1,23 @@
+# DrawingText
+
+## Class Definition
+
+```python
+class DrawingText(source: str, page: int, rotation: int, width_pt: float, height_pt: float, words: list[dict[str, Any]], clusters: list[dict[str, Any]], metadata: dict[str, Any] = field(default_factory=dict))
+```
+
+*Source: inspect/drawing/text.py*
+
+## Import Surface
+
+- drawing-inspection namespace: `from simplecadapi.inspect import drawing` then `drawing.DrawingText(...)`; unavailable inside GraphSession
+
+## Description
+
+All text objects of one page plus proximity clusters.
+
+Word and cluster boxes are in display space (matching ``page.rect`` and
+the image after the explicit pt-to-px transform). Clusters are proximity
+combination candidates, not verified tolerance stacks or feature mappings.
+Original word objects and display-space directions are preserved. Metadata
+supplies source hash, zero-based page, rotation, page boxes, units and version.

{simplecadapi-2.1.3b1 → simplecadapi-2.1.4}/docs/skill/references/docs/api/README.md

@@ -7,6 +7,7 @@ This index includes generated docs for the public SimpleCAD API surface, includi
 - Entries marked `top-level` are exported from `simplecadapi` and can be imported with `from simplecadapi import <name>`.
 - Entries marked `submodule` are public through the listed submodule, such as `simplecadapi.ql`.
 - Entries marked `inspection namespace` are available through `simplecadapi.inspect.brep` and cannot run inside `GraphSession`.
+- Entries marked `drawing-inspection namespace` are available through `simplecadapi.inspect.drawing` and cannot run inside `GraphSession`.
 - Entries marked `translator backend` are public only through `simplecadapi.translator.<backend>`.
 - Entries marked `reverse-engineering evaluator` are available through `simplecadapi.inverse_engineer.brep`; their acceptance inputs and reports belong to the trusted harness, not participant code.
 
@@ -111,6 +112,10 @@ This index includes generated docs for the public SimpleCAD API surface, includi
 - [FreeCADTranslator](FreeCADTranslator.md) *(from translator/freecad_translator/translator.py)* `translator backend`
 - [Fusion360Translator](Fusion360Translator.md) *(from translator/fusion360_translator/translator.py)* `translator backend`
 - [SolidWorksTranslator](SolidWorksTranslator.md) *(from translator/solidworks_translator/translator.py)* `translator backend`
+- [export_model_json_to_solidworks_step](export_model_json_to_solidworks_step.md) *(from translator/solidworks_translator/api.py)* `translator backend`
+- [translate_model_json_to_fcstd](translate_model_json_to_fcstd.md) *(from translator/freecad_translator/api.py)* `translator backend`
+- [translate_model_json_to_freecad_script](translate_model_json_to_freecad_script.md) *(from translator/freecad_translator/api.py)* `translator backend`
+- [translate_model_json_to_solidworks_script](translate_model_json_to_solidworks_script.md) *(from translator/solidworks_translator/api.py)* `translator backend`
 - [translate_product_package_to_fcstd](translate_product_package_to_fcstd.md) *(from translator/freecad_translator/api.py)* `translator backend`
 - [translate_product_package_to_freecad_script](translate_product_package_to_freecad_script.md) *(from translator/freecad_translator/api.py)* `translator backend`
 - [translate_product_package_to_fusion360_script](translate_product_package_to_fusion360_script.md) *(from translator/fusion360_translator/api.py)* `translator backend`
@@ -241,6 +246,28 @@ This index includes generated docs for the public SimpleCAD API surface, includi
 - [track_section_contours_rdescriptor](track_section_contours_rdescriptor.md) *(from inspect/brep/section_tracking.py)* `inspection namespace`
 - [validate_step_roundtrip_rdescriptor](validate_step_roundtrip_rdescriptor.md) *(from inspect/brep/persistence.py)* `inspection namespace`
 
+## Drawing Inspection
+
+- [DrawingCalibration](DrawingCalibration.md) *(from inspect/drawing/calibrate.py)* `drawing-inspection namespace`
+- [DrawingMeasurements](DrawingMeasurements.md) *(from inspect/drawing/calibrate.py)* `drawing-inspection namespace`
+- [DrawingSectionDimensions](DrawingSectionDimensions.md) *(from inspect/drawing/section.py)* `drawing-inspection namespace`
+- [DrawingStrokes](DrawingStrokes.md) *(from inspect/drawing/geometry.py)* `drawing-inspection namespace`
+- [DrawingSummary](DrawingSummary.md) *(from inspect/drawing/summary.py)* `drawing-inspection namespace`
+- [DrawingText](DrawingText.md) *(from inspect/drawing/text.py)* `drawing-inspection namespace`
+- [assess_dimension_rverdict](assess_dimension_rverdict.md) *(from inspect/drawing/evidence.py)* `drawing-inspection namespace`
+- [build_section_annotation_rrecord](build_section_annotation_rrecord.md) *(from inspect/drawing/evidence.py)* `drawing-inspection namespace`
+- [calibrate_drawing_scale_rcalibration](calibrate_drawing_scale_rcalibration.md) *(from inspect/drawing/calibrate.py)* `drawing-inspection namespace`
+- [extract_drawing_primitives_rstrokes](extract_drawing_primitives_rstrokes.md) *(from inspect/drawing/geometry.py)* `drawing-inspection namespace`
+- [extract_drawing_text_rwords](extract_drawing_text_rwords.md) *(from inspect/drawing/text.py)* `drawing-inspection namespace`
+- [inspect_drawing_coordinates_rreport](inspect_drawing_coordinates_rreport.md) *(from inspect/drawing/preflight.py)* `drawing-inspection namespace`
+- [inspect_drawing_rsummary](inspect_drawing_rsummary.md) *(from inspect/drawing/summary.py)* `drawing-inspection namespace`
+- [measure_drawing_rmeasurements](measure_drawing_rmeasurements.md) *(from inspect/drawing/calibrate.py)* `drawing-inspection namespace`
+- [measure_model_section_rdimensions](measure_model_section_rdimensions.md) *(from inspect/drawing/section.py)* `drawing-inspection namespace`
+- [render_drawing_view_rpath](render_drawing_view_rpath.md) *(from inspect/drawing/render.py)* `drawing-inspection namespace`
+- [render_model_section_rpath](render_model_section_rpath.md) *(from inspect/drawing/section.py)* `drawing-inspection namespace`
+- [summarize_dimension_coverage_rreport](summarize_dimension_coverage_rreport.md) *(from inspect/drawing/evidence.py)* `drawing-inspection namespace`
+- [validate_section_annotations_rreport](validate_section_annotations_rreport.md) *(from inspect/drawing/evidence.py)* `drawing-inspection namespace`
+
 ## Product Build and Cache
 
 - [AssemblyBuildResult](AssemblyBuildResult.md) *(from build/results.py)* `top-level`
@@ -320,6 +347,7 @@ This index includes generated docs for the public SimpleCAD API surface, includi
 - [add_revolute_constraint_rassembly](add_revolute_constraint_rassembly.md) *(from operators/product.py)* `top-level`
 - [and_](and_.md) *(from ql.py)* `submodule:ql`
 - [assign_material_rpart](assign_material_rpart.md) *(from operators/product.py)* `top-level`
+- [canonical_frame](canonical_frame.md) *(from product/placement.py)* `submodule:product/placement`
 - [capture](capture.md) *(from product/capture.py)* `top-level`
 - [constrain_angle_rsketch](constrain_angle_rsketch.md) *(from operators/sketch.py)* `top-level`
 - [constrain_coincident_rsketch](constrain_coincident_rsketch.md) *(from operators/sketch.py)* `top-level`
@@ -373,6 +401,9 @@ This index includes generated docs for the public SimpleCAD API surface, includi
 - [origin_role](origin_role.md) *(from ql.py)* `submodule:ql`
 - [output_role](output_role.md) *(from ql.py)* `submodule:ql`
 - [place_component_rassembly](place_component_rassembly.md) *(from operators/product.py)* `top-level`
+- [placement_frame_mm](placement_frame_mm.md) *(from product/placement.py)* `submodule:product/placement`
+- [placement_from_canonical](placement_from_canonical.md) *(from product/placement.py)* `submodule:product/placement`
+- [placement_ticks](placement_ticks.md) *(from product/placement.py)* `submodule:product/placement`
 - [radial_pattern_rsolidlist](radial_pattern_rsolidlist.md) *(from operators/transform.py)* `top-level`
 - [render_screenshot_rpath](render_screenshot_rpath.md) *(from operators/features.py)* `top-level`
 - [select](select.md) *(from ql.py)* `submodule:ql`
@@ -386,4 +417,5 @@ This index includes generated docs for the public SimpleCAD API surface, includi
 - [trim_surface_rface](trim_surface_rface.md) *(from operators/geometry.py)* `top-level`
 - [twisted_sweep_rsolid](twisted_sweep_rsolid.md) *(from operators/features.py)* `top-level`
 - [unground_component_rassembly](unground_component_rassembly.md) *(from operators/product.py)* `top-level`
+- [validate_placement_ticks](validate_placement_ticks.md) *(from product/placement.py)* `submodule:product/placement`
 - [value](value.md) *(from ql.py)* `submodule:ql`

{simplecadapi-2.1.3b1 → simplecadapi-2.1.4}/docs/skill/references/docs/api/SolidWorksTranslator.md

@@ -3,7 +3,7 @@
 ## Class Definition
 
 ```python
-class SolidWorksTranslator(document_name: str = 'SimpleCADProduct', *, output_path: str | None = None, visible: bool = False, source_kernel_fallback: bool = False)
+class SolidWorksTranslator(document_name: str = 'SimpleCADModel', *, output_path: Optional[str] = None, visible: bool = False, solidworks_version: str = '2025')
 ```
 
 *Source: translator/solidworks_translator/translator.py*
@@ -14,4 +14,4 @@ class SolidWorksTranslator(document_name: str = 'SimpleCADProduct', *, output_pa
 
 ## Description
 
-Translate one validated `.scadpkg` closure into SolidWorks automation.
+Public, stateless facade for SolidWorks script translation.