simplecadapi 2.1.3__tar.gz → 2.1.4__tar.gz

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

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: simplecadapi
-Version: 2.1.3
+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
@@ -299,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>
 
@@ -806,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
 
@@ -891,10 +893,10 @@ The group chat currently has too many members for direct QR-code joining. Scan t
 
 ## Star History
 
-<a href="https://www.star-history.com/?repos=nijingzhe%2Fsimplecadapi&type=date&legend=top-left">
+<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=nijingzhe/simplecadapi&type=date&theme=dark&legend=top-left" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=nijingzhe/simplecadapi&type=date&legend=top-left" />
-   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=nijingzhe/simplecadapi&type=date&legend=top-left" />
+   <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.3 → 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>
 
@@ -550,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
 
@@ -635,10 +635,10 @@ The group chat currently has too many members for direct QR-code joining. Scan t
 
 ## Star History
 
-<a href="https://www.star-history.com/?repos=nijingzhe%2Fsimplecadapi&type=date&legend=top-left">
+<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=nijingzhe/simplecadapi&type=date&theme=dark&legend=top-left" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=nijingzhe/simplecadapi&type=date&legend=top-left" />
-   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=nijingzhe/simplecadapi&type=date&legend=top-left" />
+   <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.3 → simplecadapi-2.1.4}/docs/skill/references/workflows/reverse-engineering-studio.md

@@ -1,6 +1,6 @@
 # Workflow: Reverse-Engineering Studio (human-in-the-loop)
 
-Drive the interactive reconstruction studio (`viewer/` re-mode) as the agent
+Drive the interactive reconstruction studio (the standalone [sca-web-editor](https://github.com/PhySpace/sca-web-editor) re-mode) as the agent
 side of a two-actor loop: a human annotates the STEP target in the browser,
 the agent reconstructs from those annotations, and the browser displays the
 artifacts for the next refinement round.
@@ -90,7 +90,7 @@ verification artifacts. Without an operator, stay on the autonomous path
 ## Operation tips (content is markdown, not code)
 
 Each palette entry is a packaged prompt defined by
-`viewer/server/operations/<op_id>.md`: YAML-style frontmatter (`label`,
+`sca_web_editor/operations/<op_id>.md` in the sca-web-editor repo: YAML-style frontmatter (`label`,
 `category`, `api`, `reads`, `doc_refs`) plus the hint text as body. The
 registry loader validates and serves them (`GET /api/operations`) and
 `compose_submission` embeds the tips for every referenced operation.
@@ -106,21 +106,22 @@ registry loader validates and serves them (`GET /api/operations`) and
 
 ## Agent loop
 
-1. Start the studio and hand the URL to the operator:
+1. Start the studio and hand the URL to the operator (all commands run from a
+   checkout of [sca-web-editor](https://github.com/PhySpace/sca-web-editor)):
 
    ```bash
-   uv run python -m viewer.server <case_dir> --daemon
+   uv run python -m sca_web_editor <case_dir> --daemon
    ```
 
-   The detached server binds `127.0.0.1:7170` (lockfile
-   `<case_dir>/.re_server.lock`), builds the scene in the background, and
-   opens `http://127.0.0.1:7170/re.html` (built frontend from `viewer/dist`;
-   during development run `npm run dev` in `viewer/`, which proxies `/api`).
+   The detached server binds `127.0.0.1:7170` and opens
+   `http://127.0.0.1:7170/`, the single Web Editor entry. Choose `Re-mode`
+   in the mode switcher. During development run `npm run dev` in the
+   sca-web-editor repo, which proxies `/api` and `/rpc`.
 
 2. Block on the next submission (stay under the Bash tool timeout):
 
    ```bash
-   uv run python -m viewer.server <case_dir> --wait-only --timeout 590
+   uv run python -m sca_web_editor <case_dir> --wait-only --timeout 590
    ```
 
    Exit 0 = fresh submission; 124 = timeout (re-check `re_work/submission.json`
@@ -159,7 +160,7 @@ registry loader validates and serves them (`GET /api/operations`) and
 6. Loop to step 2 for the next refinement round. Finish with:
 
    ```bash
-   uv run python -m viewer.server <case_dir> --shutdown
+   uv run python -m sca_web_editor <case_dir> --shutdown
    ```
 
 ## Data output

{simplecadapi-2.1.3 → simplecadapi-2.1.4}/docs/updates/2.1.0.md

@@ -69,17 +69,17 @@ multi-feature case reproduces geometry at machine precision (Deep ~85%,
 Fusion ~77% exact-match) and the constraint channel solves ~90% (Deep) /
 ~93% (Fusion) of cases.
 
-## 6. Reverse-engineering studio in the browser
+## 6. Browser reverse-engineering workspace
 
-`viewer/re.html` is a human-in-the-loop reverse-engineering workbench:
-pick faces/edges or lasso a region on the target STEP, annotate with inline
-entity and operation chips, and submit — the server composes a
+The unified Web Editor includes a Re-mode workspace for human-in-the-loop
+reverse engineering: pick faces/edges or lasso a region on the target STEP,
+annotate with inline entity and operation chips, and submit. The server composes
 `submission.json` (annotations + per-entity one-level adjacency context +
-operation tips + snapshot), an agent rebuilds, and the UI streams the
-comparison and evaluation back. The composer is IME-safe (CJK composition
-never submits), the same operation tip can be cited multiple times, and
-user selections are never truncated. The studio UI is built with React 19 +
-Tailwind 4 + shadcn-style components over the imperative three.js kernel.
+operation tips + snapshot), an agent rebuilds, and the UI streams comparison
+and evaluation back. The composer is IME-safe (CJK composition never submits),
+the same operation tip can be cited multiple times, and user selections are
+never truncated. The workspace uses React 19 + Tailwind 4 + shadcn-style
+components over the imperative three.js kernel.
 
 The companion `.scadpkg` browser inspector loads v3 packages with full
 closure-hash validation, so tampered packages are rejected by name.

{simplecadapi-2.1.3 → simplecadapi-2.1.4}/docs/updates/2.1.0.zh-CN.md

@@ -53,13 +53,13 @@ FTC 模型源码：约束无条件翻译，逐条输出冲突审计而不是静
 深多特征案例以机器精度复现几何（Deep ~85%、Fusion ~77% 全等），约束通道约
 90%（Deep）/ 93%（Fusion）可解。
 
-## 6. 浏览器内逆向工作台
+## 6. 浏览器内逆向工作区
 
-`viewer/re.html` 是人在回路的逆向工作台：在目标 STEP 上点面/点边或套索圈选，
-用内联实体与操作 chip 做标注并提交——服务端组装 `submission.json`（标注 +
+统一 Web Editor 包含 Re-mode 工作区：在目标 STEP 上点面/点边或套索圈选，
+用内联实体与操作 chip 做标注并提交。服务端组装 `submission.json`（标注 +
 逐实体一级邻接上下文 + 操作提示 + 截图），agent 重建，UI 回流对比与评审。
-输入框对输入法安全（CJK 组词期永不提交）、同一操作提示可引用多次、用户的
-选择集合永不截断。工作台 UI 用 React 19 + Tailwind 4 + shadcn 风格组件构建，
+输入框对输入法安全（CJK 组词期永不提交）、同一操作提示可引用多次，用户的
+选择集合永不截断。工作区 UI 用 React 19 + Tailwind 4 + shadcn 风格组件构建，
 命令式 three.js 内核保持不变。
 
 配套的 `.scadpkg` 浏览器检查器加载 v3 包并做全闭包哈希校验，被篡改的包会

{simplecadapi-2.1.3 → simplecadapi-2.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "simplecadapi"
-version = "2.1.3"
+version = "2.1.4"
 description = "A simplified OCP-native CAD modeling Python API"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -34,6 +34,8 @@ dependencies = [
     "ocp-gordon>=0.2,<0.3",
     "ezdxf>=1.4.4",
     "pymupdf>=1.28.2",
+    "marimo>=0.25.0",
+    "plotly>=7.1.0",
 ]
 
 [project.optional-dependencies]
@@ -60,10 +62,10 @@ fem = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/NiJingzhe/SimpleCADAPI"
-Repository = "https://github.com/NiJingzhe/SimpleCADAPI"
-Documentation = "https://github.com/NiJingzhe/SimpleCADAPI#readme"
-Issues = "https://github.com/NiJingzhe/SimpleCADAPI/issues"
+Homepage = "https://github.com/PhySpace/SimpleCADAPI"
+Repository = "https://github.com/PhySpace/SimpleCADAPI"
+Documentation = "https://github.com/PhySpace/SimpleCADAPI#readme"
+Issues = "https://github.com/PhySpace/SimpleCADAPI/issues"
 
 [build-system]
 requires = ["hatchling"]
@@ -134,7 +136,7 @@ unresolved-reference = "ignore"
 unresolved-import = "ignore"
 
 [tool.ty.src]
-include = ["src", "test", "tests", "examples", "tools", "viewer/server"]
+include = ["src", "test", "tests", "examples", "tools"]
 exclude = [
     "**/__pycache__/**",
     ".venv/**",

{simplecadapi-2.1.3 → simplecadapi-2.1.4}/src/simplecadapi/artifacts/feature_graph.py

@@ -5,6 +5,8 @@ from __future__ import annotations
 import json
 import os
 import stat
+import threading
+from collections import OrderedDict
 from dataclasses import dataclass, field
 from functools import lru_cache
 from importlib.resources import files
@@ -38,6 +40,11 @@ FEATURE_GRAPH_PROFILE = "simplecad-feature-graph-1"
 FEATURE_GRAPH_MEDIA_TYPE = "application/vnd.simplecad.feature-graph+zip"
 _FEATURE_GRAPH_MANIFEST = "feature-graph.json"
 
+# Content-addressed memo for load_feature_graph_artifact (bounded LRU).
+_LOAD_CACHE: "OrderedDict[str, FeatureGraphArtifact]" = OrderedDict()
+_LOAD_CACHE_LOCK = threading.Lock()
+_LOAD_CACHE_MAX = 32
+
 
 @lru_cache(maxsize=1)
 def _schema() -> Mapping[str, Any]:
@@ -241,6 +248,12 @@ class FeatureGraphArtifact:
     content_hash: str = ""
     blobs: Mapping[str, bytes] = field(default_factory=dict, compare=False, repr=False)
 
+    # Lazily-filled cache for `canonical_bytes` (frozen+slots: bypass both via
+    # object.__setattr__; excluded from init/repr/compare on purpose).
+    _canonical_bytes_memo: bytes | None = field(
+        default=None, init=False, repr=False, compare=False
+    )
+
     schema_version: str = field(default=FEATURE_GRAPH_SCHEMA_VERSION, init=False)
     artifact_kind: str = field(default="feature_graph", init=False)
     profile: str = field(default=FEATURE_GRAPH_PROFILE, init=False)
@@ -448,7 +461,11 @@ class FeatureGraphArtifact:
 
     @property
     def canonical_bytes(self) -> bytes:
-        return canonical_bytes(self.to_dict())
+        """Canonical serialization, memoized per instance (artifacts are
+        closed payloads; the canonical form is deterministic from fields)."""
+        if self._canonical_bytes_memo is None:
+            object.__setattr__(self, "_canonical_bytes_memo", canonical_bytes(self.to_dict()))
+        return self._canonical_bytes_memo
 
     def restore_session(self):
         """Restore a detached GraphSession from the durable payload."""
@@ -744,9 +761,32 @@ def encode_feature_graph_artifact(artifact: FeatureGraphArtifact) -> bytes:
 def load_feature_graph_artifact(
     data: bytes | bytearray | memoryview | str | Path,
 ) -> FeatureGraphArtifact:
-    """Read and fully validate one canonical feature graph archive."""
-
+    """Read and fully validate one canonical feature graph archive.
+
+    Archives are content-addressed, so loads are memoized by SHA-256 of the
+    raw bytes: repeated loads of the same artifact (scene compilation and
+    package validation both re-read definitions) return the same closed
+    instance instead of re-running zip preflight, schema validation, and
+    graph reconstruction. The returned artifact is shared — treat it as
+    read-only (the artifact contract already requires this).
+    """
     raw = Path(data).read_bytes() if isinstance(data, (str, Path)) else bytes(data)
+    key = sha256_bytes(raw)
+    with _LOAD_CACHE_LOCK:
+        cached = _LOAD_CACHE.get(key)
+        if cached is not None:
+            _LOAD_CACHE.move_to_end(key)
+            return cached
+    artifact = _load_feature_graph_artifact(raw)
+    with _LOAD_CACHE_LOCK:
+        _LOAD_CACHE[key] = artifact
+        while len(_LOAD_CACHE) > _LOAD_CACHE_MAX:
+            _LOAD_CACHE.popitem(last=False)
+    return artifact
+
+
+def _load_feature_graph_artifact(raw: bytes) -> FeatureGraphArtifact:
+    """Uncached load: fully validate and reconstruct one feature graph."""
     archive = preflight_zip_bytes(raw, manifest_name=_FEATURE_GRAPH_MANIFEST)
     manifest = parse_canonical_json(archive.members[_FEATURE_GRAPH_MANIFEST])
     if not isinstance(manifest, Mapping):

{simplecadapi-2.1.3 → simplecadapi-2.1.4}/src/simplecadapi/inspect/brep/render.py

@@ -630,17 +630,24 @@ def _write_window_supersampled(window, output: Path, factor: int) -> None:
     """Write through an integer-factor LANCZOS downsample.
 
     vtkPNGWriter needs a real path, so the supersampled frame lands in a
-    temporary sibling file before PIL downsamples it onto ``output``.
+    temporary sibling file before PIL downsamples it onto ``output``. The
+    temp file is created with ``mkstemp`` and its handle closed immediately:
+    vtkPNGWriter opens the same path itself, and Windows denies a second
+    open while a handle is still held (POSIX masks this). The file is
+    unlinked in a ``finally`` so render failures don't leak temp siblings.
     """
+    import os
     import tempfile
 
     from PIL import Image
 
-    with tempfile.NamedTemporaryFile(
+    fd, raw_name = tempfile.mkstemp(
         prefix=f".{output.stem}-ss{factor}x-", suffix=".png", dir=output.parent
-    ) as raw:
-        _write_window(window, Path(raw.name))
-        with Image.open(raw.name) as frame:
+    )
+    os.close(fd)
+    try:
+        _write_window(window, Path(raw_name))
+        with Image.open(raw_name) as frame:
             frame = frame.convert("RGB")
             downsampled = frame.resize(
                 (frame.width // factor, frame.height // factor),
@@ -650,6 +657,11 @@ def _write_window_supersampled(window, output: Path, factor: int) -> None:
                 downsampled.save(output, quality=95)
             else:
                 downsampled.save(output)
+    finally:
+        try:
+            os.unlink(raw_name)
+        except OSError:
+            pass
 
 
 def _prepare_sdk_screenshot(

{simplecadapi-2.1.3 → simplecadapi-2.1.4}/src/simplecadapi/product/packages.py

@@ -385,7 +385,12 @@ def _scene_projection(root: Definition, store: _BlobStore, objects: dict[str, by
     }
 
 
-def build_product_package(value: Any, *, include_scene: bool = True) -> ProductPackage:
+def build_product_package(
+    value: Any,
+    *,
+    include_scene: bool = True,
+    validate: bool = True,
+) -> ProductPackage:
     root = _coerce_definition(value)
     definitions = _definition_closure(root)
     store = _BlobStore()
@@ -415,7 +420,15 @@ def build_product_package(value: Any, *, include_scene: bool = True) -> ProductP
     }
     manifest = {**draft, "content_hash": content_hash(draft, omit=())}
     package = ProductPackage(manifest=manifest, objects=objects, root_definition=root)
-    validate_product_package(package)
+    if validate:
+        # Full decode-and-verify round-trip. Trusted in-process callers
+        # (e.g. the live export path) may skip it; package LOADERS always
+        # validate on their side.
+        validate_product_package(package)
+    else:
+        # Mark trusted-by-construction so encode_product_package does not
+        # silently re-run the same verification we just skipped.
+        _mark_package_validated(package, DEFAULT_ARTIFACT_LIMITS)
     return package
 
 

{simplecadapi-2.1.3 → simplecadapi-2.1.4}/src/simplecadapi/translator/solidworks_translator/analysis.py

@@ -1,7 +1,7 @@
 """Structural graph analysis and recorded geometry selectors.
 
-Translation never replays source solids or measures expected feature results.
-Cross-kernel measurements live in the workspace test harness.
+Translation never replays source solids or measures expected feature results;
+expected values are asserted by the test suite.
 """
 from __future__ import annotations
 import copy