simplecadapi 2.2.6__tar.gz → 2.2.6.post2__tar.gz

{simplecadapi-2.2.6 → simplecadapi-2.2.6.post2}/.gitignore

@@ -89,3 +89,7 @@ sandbox-envs/
 .agents/
 .sharednet/
 design-docs/
+
+# local, not part of the SDK
+examples/workspace/
+phase2-contract-review.md

{simplecadapi-2.2.6 → simplecadapi-2.2.6.post2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplecadapi
-Version: 2.2.6
+Version: 2.2.6.post2
 Summary: A simplified OCP-native CAD modeling Python API
 Project-URL: Homepage, https://github.com/PhySpace/SimpleCADAPI
 Project-URL: Repository, https://github.com/PhySpace/SimpleCADAPI
@@ -413,20 +413,19 @@ the full crank cycle sweeps clean in the same sim ·
 
 ---
 
-## Update Notes (2.2.6)
+## Update Notes (2.2.6.post2)
 
 > Validate generated definitions, assembly constraints, and manufacturing
 > geometry before production use.
 
-- **Switch notebooks without leaving the CLI.** `sca cell open NOTEBOOK` moves the editor
-  and waits for its kernel; the write commands take `--open` to switch and write in one
-  step, and a refused write names the way out.
-- **`sca viewport` answers what the person sees.** The image's path, age and size, copied
-  out with `--out`, instead of reading `.sca-editor/viewport.png` by hand.
-- **Cache entries are signed and verified again.** `cryptography` ships as a dependency,
-  so marimo's cache verification no longer silently degrades to off.
+- **Operators live with their family.** `scale_rsolid`, `transform_rsolid`, `boolean_rsolidlist`,
+  `offset_rsolid`, `draft_rsolid`, `extrude_taper_rsolid`, `extrude_until_rsolid` and
+  `sweep_multisection_rsolid` moved into `operators/transform.py`, `boolean.py` and `features.py`.
+  `from simplecadapi import ...` is unchanged; the old module paths warn and still work.
+- **Every operator's API reference is generated**, and tests fail when one has no doc or the
+  committed docs differ from the generator's output.
 
-Full notes for this version: [`docs/updates/2.2.6.md`](docs/updates/2.2.6.md).
+Full notes for this version: [`docs/updates/2.2.6.post2.md`](docs/updates/2.2.6.post2.md).
 Earlier versions: the [changelog](CHANGELOG.md) and [`docs/updates/`](docs/updates/).
 
 ---
@@ -447,7 +446,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.2.6`.
+Current release: `simplecadapi==2.2.6.post2`.
 
 ## What It Provides
 
@@ -962,6 +961,8 @@ and the [STEP reconstruction workflow](docs/skill/references/workflows/step-reco
 
 ## Documentation
 
+- 2.2.6.post2 update notes: [`docs/updates/2.2.6.post2.md`](docs/updates/2.2.6.post2.md)
+- 2.2.6.post1 update notes: [`docs/updates/2.2.6.post1.md`](docs/updates/2.2.6.post1.md)
 - 2.2.6 update notes: [`docs/updates/2.2.6.md`](docs/updates/2.2.6.md)
 - 2.2.5 update notes: [`docs/updates/2.2.5.md`](docs/updates/2.2.5.md)
 - 2.2.4 update notes: [`docs/updates/2.2.4.md`](docs/updates/2.2.4.md)

{simplecadapi-2.2.6 → simplecadapi-2.2.6.post2}/README.md

@@ -149,20 +149,19 @@ the full crank cycle sweeps clean in the same sim ·
 
 ---
 
-## Update Notes (2.2.6)
+## Update Notes (2.2.6.post2)
 
 > Validate generated definitions, assembly constraints, and manufacturing
 > geometry before production use.
 
-- **Switch notebooks without leaving the CLI.** `sca cell open NOTEBOOK` moves the editor
-  and waits for its kernel; the write commands take `--open` to switch and write in one
-  step, and a refused write names the way out.
-- **`sca viewport` answers what the person sees.** The image's path, age and size, copied
-  out with `--out`, instead of reading `.sca-editor/viewport.png` by hand.
-- **Cache entries are signed and verified again.** `cryptography` ships as a dependency,
-  so marimo's cache verification no longer silently degrades to off.
+- **Operators live with their family.** `scale_rsolid`, `transform_rsolid`, `boolean_rsolidlist`,
+  `offset_rsolid`, `draft_rsolid`, `extrude_taper_rsolid`, `extrude_until_rsolid` and
+  `sweep_multisection_rsolid` moved into `operators/transform.py`, `boolean.py` and `features.py`.
+  `from simplecadapi import ...` is unchanged; the old module paths warn and still work.
+- **Every operator's API reference is generated**, and tests fail when one has no doc or the
+  committed docs differ from the generator's output.
 
-Full notes for this version: [`docs/updates/2.2.6.md`](docs/updates/2.2.6.md).
+Full notes for this version: [`docs/updates/2.2.6.post2.md`](docs/updates/2.2.6.post2.md).
 Earlier versions: the [changelog](CHANGELOG.md) and [`docs/updates/`](docs/updates/).
 
 ---
@@ -183,7 +182,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.2.6`.
+Current release: `simplecadapi==2.2.6.post2`.
 
 ## What It Provides
 
@@ -698,6 +697,8 @@ and the [STEP reconstruction workflow](docs/skill/references/workflows/step-reco
 
 ## Documentation
 
+- 2.2.6.post2 update notes: [`docs/updates/2.2.6.post2.md`](docs/updates/2.2.6.post2.md)
+- 2.2.6.post1 update notes: [`docs/updates/2.2.6.post1.md`](docs/updates/2.2.6.post1.md)
 - 2.2.6 update notes: [`docs/updates/2.2.6.md`](docs/updates/2.2.6.md)
 - 2.2.5 update notes: [`docs/updates/2.2.5.md`](docs/updates/2.2.5.md)
 - 2.2.4 update notes: [`docs/updates/2.2.4.md`](docs/updates/2.2.4.md)

{simplecadapi-2.2.6 → simplecadapi-2.2.6.post2}/docs/skill/SKILL.md

@@ -4,9 +4,9 @@ description: Build, assemble, inspect, reconstruct, and export parametric CAD mo
 license: Apache-2.0
 metadata:
   project: simplecadapi
-  version: 2.2.6
+  version: 2.2.6.post2
   package-name: simplecadapi
-  package-version: 2.2.6
+  package-version: 2.2.6.post2
 ---
 
 # SimpleCAD SDK Skill

simplecadapi-2.2.6.post2/docs/skill/references/docs/api/NotebookRun.md

@@ -0,0 +1,23 @@
+# NotebookRun
+
+## Class Definition
+
+```python
+class NotebookRun(config: NotebookConfig, product: Product | None, values: Mapping[str, Any], cells: tuple[CellReport, ...], dependencies: frozenset[Path])
+```
+
+*Source: runtime/runner.py*
+
+## Import Surface
+
+- notebook runtime: `from simplecadapi.runtime import NotebookRun`
+
+## Description
+
+The outcome of :func:`run_notebook`.
+
+``product`` is the notebook's product and ``definition`` its durable
+definition (``None`` for a partial run — see ``through``/``product``);
+``values`` holds every top-level variable, ``cells`` one report per cell
+in notebook order, and ``dependencies`` the files outside the cells the
+run depends on.

{simplecadapi-2.2.6 → simplecadapi-2.2.6.post2}/docs/skill/references/docs/api/README.md

@@ -77,9 +77,12 @@ This index includes generated docs for the public SimpleCAD API surface, includi
 ## 3D Operations
 
 - [extrude_rsolid](extrude_rsolid.md) *(from operators/features.py)* `top-level`
+- [extrude_taper_rsolid](extrude_taper_rsolid.md) *(from operators/features.py)* `top-level`
+- [extrude_until_rsolid](extrude_until_rsolid.md) *(from operators/features.py)* `top-level`
 - [loft_rshell](loft_rshell.md) *(from operators/geometry.py)* `top-level`
 - [loft_rsolid](loft_rsolid.md) *(from operators/features.py)* `top-level`
 - [revolve_rsolid](revolve_rsolid.md) *(from operators/features.py)* `top-level`
+- [sweep_multisection_rsolid](sweep_multisection_rsolid.md) *(from operators/features.py)* `top-level`
 - [sweep_rsolid](sweep_rsolid.md) *(from operators/features.py)* `top-level`
 
 ## Tagging and Selection
@@ -345,6 +348,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`
+- [boolean_rsolidlist](boolean_rsolidlist.md) *(from operators/boolean.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`
@@ -377,6 +381,7 @@ This index includes generated docs for the public SimpleCAD API surface, includi
 - [constrain_symmetric_rsketch](constrain_symmetric_rsketch.md) *(from operators/sketch.py)* `top-level`
 - [constrain_tangent_rsketch](constrain_tangent_rsketch.md) *(from operators/sketch.py)* `top-level`
 - [constrain_vertical_rsketch](constrain_vertical_rsketch.md) *(from operators/sketch.py)* `top-level`
+- [draft_rsolid](draft_rsolid.md) *(from operators/features.py)* `top-level`
 - [explain_tag](explain_tag.md) *(from operators/selection.py)* `top-level`
 - [fill_holes_rshell](fill_holes_rshell.md) *(from operators/geometry.py)* `top-level`
 - [fit_point_grid_rface](fit_point_grid_rface.md) *(from operators/geometry.py)* `top-level`
@@ -394,6 +399,7 @@ This index includes generated docs for the public SimpleCAD API surface, includi
 - [measure_constraint_residual_rconstraintresidual](measure_constraint_residual_rconstraintresidual.md) *(from operators/product.py)* `top-level`
 - [meta](meta.md) *(from ql.py)* `submodule:ql`
 - [not_](not_.md) *(from ql.py)* `submodule:ql`
+- [offset_rsolid](offset_rsolid.md) *(from operators/features.py)* `top-level`
 - [operation_event](operation_event.md) *(from ql.py)* `submodule:ql`
 - [or_](or_.md) *(from ql.py)* `submodule:ql`
 - [origin_role](origin_role.md) *(from ql.py)* `submodule:ql`
@@ -404,6 +410,7 @@ This index includes generated docs for the public SimpleCAD API surface, includi
 - [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`
+- [scale_rsolid](scale_rsolid.md) *(from operators/transform.py)* `top-level`
 - [select](select.md) *(from ql.py)* `submodule:ql`
 - [set_public_connector_rassembly](set_public_connector_rassembly.md) *(from operators/product.py)* `top-level`
 - [sew_faces_rshell](sew_faces_rshell.md) *(from operators/geometry.py)* `top-level`
@@ -412,6 +419,7 @@ This index includes generated docs for the public SimpleCAD API surface, includi
 - [source_binding](source_binding.md) *(from ql.py)* `submodule:ql`
 - [source_topology](source_topology.md) *(from ql.py)* `submodule:ql`
 - [tag](tag.md) *(from ql.py)* `submodule:ql`
+- [transform_rsolid](transform_rsolid.md) *(from operators/transform.py)* `top-level`
 - [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`

{simplecadapi-2.2.6 → simplecadapi-2.2.6.post2}/docs/skill/references/docs/api/add_bspline_rsketch.md

@@ -17,4 +17,6 @@ def add_bspline_rsketch(sketch: Sketch, entity_id: str, start: Union[SketchRef,
 Add a B-spline curve entity to a sketch.
 
 The start/end point refs link the B-spline into a closed profile
-loop. Control points may be literal 2-D coordinates or point refs.
+loop. A closed curve may reuse one seam ref for both endpoints.
+Control points may be literal 2-D coordinates or point refs. A periodic
+seam links topology without replacing the periodic curve's poles.

simplecadapi-2.2.6.post2/docs/skill/references/docs/api/boolean_rsolidlist.md

@@ -0,0 +1,45 @@
+# boolean_rsolidlist
+
+## API Definition
+
+```python
+def boolean_rsolidlist(left: Sequence[Solid], right: Sequence[Solid], operation: str) -> list[Solid]
+```
+
+*Source: operators/boolean.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import boolean_rsolidlist`
+
+## Description
+
+Apply a set boolean to two body groups, retaining every result solid.
+
+Members of each group are a geometric set. Unlike single-solid booleans,
+a cut or intersection may return several solids or an empty list.
+Topology lineage is partial; the ordered inputs and all output slots are
+recorded so downstream features can replay the same geometry.
+
+## Parameters
+
+### left
+
+- **Description**: The first group of solids.
+
+### right
+
+- **Description**: The second group of solids.
+
+### operation
+
+- **Description**: ``"cut"``, ``"intersect"`` or ``"union"``.
+
+## Returns
+
+The result solids, possibly several or none.
+
+## Raises
+
+- **TypeError**: A group contains something that is not a Solid.
+- **ValueError**: ``operation`` is unknown, or a member is invalid or empty.

simplecadapi-2.2.6.post2/docs/skill/references/docs/api/draft_rsolid.md

@@ -0,0 +1,69 @@
+# draft_rsolid
+
+## API Definition
+
+```python
+def draft_rsolid(solid: Solid, faces_to_draft: Sequence[Face] | ShapeSelector, angle: ScalarLike, plane_origin: Sequence[float] = (0, 0, 0), plane_normal: Sequence[float] = (0, 0, 1)) -> Solid
+```
+
+*Source: operators/features.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import draft_rsolid`
+
+## Description
+
+Draft planar, cylindrical or conical faces by a signed angle in degrees.
+
+The neutral plane fixes the unchanged section: the selected faces lean
+toward or away from it. Its origin and normal are in current
+coordinate-system coordinates. Face selection is checked against the input
+body and retained as graph inputs for strict replay. The input solid is
+preserved, the output must be one valid solid, and a zero angle records an
+unchanged result. Other surface families are explicitly rejected.
+
+The operation is recorded as ``make_draft_rsolid``; the body and selected
+faces are ordered inputs, and the angle, neutral plane and face selection
+nodes are parameters, so model JSON replay is strict.
+
+## Parameters
+
+### solid
+
+- **Description**: The body to draft.
+
+### faces_to_draft
+
+- **Description**: Faces of ``solid``, or a QL selector that picks them.
+
+### angle
+
+- **Description**: Draft angle in degrees, strictly between -90 and 90.
+
+### plane_origin
+
+- **Description**: A point of the neutral plane.
+
+### plane_normal
+
+- **Description**: Normal of the neutral plane; must be nonzero.
+
+## Returns
+
+The drafted solid.
+
+## Raises
+
+- **TypeError**: ``solid`` is not a Solid.
+- **ValueError**: Empty selection, a selection that is not made of faces of ``solid``, an unsupported surface family, a zero plane normal, or a nonfinite or out-of-range angle.
+
+## Examples
+
+```python
+import simplecadapi as scad
+from simplecadapi import ql
+body = scad.make_box_rsolid(10, 10, 10)
+right = ql.faces().where(ql.prop("geom.normal.x", ">", 0.9)).exactly(1)
+drafted = scad.draft_rsolid(body, right, angle=10)
+```

simplecadapi-2.2.6.post2/docs/skill/references/docs/api/extrude_taper_rsolid.md

@@ -0,0 +1,51 @@
+# extrude_taper_rsolid
+
+## API Definition
+
+```python
+def extrude_taper_rsolid(profile: Face, vector: Sequence[float], taper: float, flip_inner: bool = True) -> Solid
+```
+
+*Source: operators/features.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import extrude_taper_rsolid`
+
+## Description
+
+Extrude a planar sketch face by a vector, with a taper in degrees.
+
+The vector is nonzero and in current coordinate-system coordinates. The
+finite taper angle lies strictly between -90 and 90; a positive taper
+shrinks the outer section, and inner loops taper the opposite way when
+``flip_inner`` is true. An analytic draft prism is used where applicable
+and exact offset sections with lofts otherwise. Collapsed loops and invalid
+topology raise errors. The operation is recorded as
+``make_extrude_taper_rsolid`` for replay.
+
+## Parameters
+
+### profile
+
+- **Description**: The planar face to extrude.
+
+### vector
+
+- **Description**: Extrusion vector (nonzero).
+
+### taper
+
+- **Description**: Taper angle in degrees, strictly between -90 and 90.
+
+### flip_inner
+
+- **Description**: Taper inner loops in the opposite direction.
+
+## Returns
+
+The tapered solid.
+
+## Raises
+
+- **ValueError**: A zero vector, an out-of-range taper, a nonplanar profile, collapsed loops or an invalid result.

simplecadapi-2.2.6.post2/docs/skill/references/docs/api/extrude_until_rsolid.md

@@ -0,0 +1,75 @@
+# extrude_until_rsolid
+
+## API Definition
+
+```python
+def extrude_until_rsolid(profile: Face, target: Solid | Sequence[Solid], direction: Sequence[float] = (0, 0, 1), until: str = 'NEXT') -> Solid
+```
+
+*Source: operators/features.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import extrude_until_rsolid`
+
+## Description
+
+Extrude a planar face until a target surface, including curved surfaces.
+
+The direction is interpreted in the current coordinate system and
+normalized before construction. ``until`` selects the termination:
+``NEXT`` (forward, nearest intersecting target surface), ``LAST`` (forward,
+farthest), ``PREVIOUS`` (reverse, nearest) and ``FIRST`` (reverse,
+farthest). The temporary prism is intersected with the target, the target's
+boundary faces are taken from kernel history and sewn into surfaces, and
+the prism is split on the selected one. Bounding boxes only size the
+temporary prism; they do not define the termination surface, and side
+walls parallel to the direction do not join separate near and far limits.
+
+Targets must cover the profile at the requested contact: an uncovered,
+open or disconnected output is rejected, as are a missing contact, an
+invalid mode, a zero or nonfinite direction and an empty target sequence.
+Inputs are preserved. The operation is recorded as
+``make_extrude_until_rsolid``; its ordered inputs are the profile followed
+by every target solid and its parameters keep ``direction``, ``until`` and
+``target_count``, so a changed target is recomputed on replay (no final
+BRep is embedded).
+
+## Parameters
+
+### profile
+
+- **Description**: The planar face to extrude.
+
+### target
+
+- **Description**: A solid, or a sequence of solids, that bounds the extrusion.
+
+### direction
+
+- **Description**: Extrusion direction in current coordinate-system coordinates.
+
+### until
+
+- **Description**: ``"NEXT"``, ``"LAST"``, ``"PREVIOUS"`` or ``"FIRST"``.
+
+## Returns
+
+One valid solid.
+
+## Raises
+
+- **TypeError**: ``profile`` is not a Face, or ``target`` is not a Solid or a sequence of Solid.
+- **ValueError**: No target, no contact, insufficient coverage, a bad mode or direction, or an invalid kernel result.
+
+## Examples
+
+```python
+import simplecadapi as scad
+profile = scad.make_rectangle_rface(2, 2)
+ceiling = scad.make_box_rsolid(10, 10, 2, bottom_face_center=(0, 0, 5))
+near = scad.extrude_until_rsolid(profile, ceiling, until="NEXT")  # volume 20
+far = scad.extrude_until_rsolid(profile, ceiling, until="LAST")  # volume 28
+sphere = scad.make_sphere_rsolid(5, center=(0, 0, 10))
+curved = scad.extrude_until_rsolid(profile, sphere)
+```

simplecadapi-2.2.6.post2/docs/skill/references/docs/api/offset_rsolid.md

@@ -0,0 +1,55 @@
+# offset_rsolid
+
+## API Definition
+
+```python
+def offset_rsolid(solid: Solid, amount: ScalarLike, openings: Sequence[Face] | ShapeSelector = (), *, tolerance: float = 0.0001, kind: str = 'ARC') -> Solid
+```
+
+*Source: operators/features.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import offset_rsolid`
+
+## Description
+
+Offset a solid outward (positive) or inward (negative).
+
+The amount must be finite and nonzero. Faces passed as ``openings`` form an
+open shell; with no openings the result is the closed offset solid. The
+join ``kind`` is ``ARC`` or ``INTERSECTION``. Invalid kernel results raise
+an error. The operation is recorded as ``make_offset_rsolid`` with explicit
+face selections; topology tag lineage is conservatively partial.
+``shell_rsolid`` keeps its own contract (a positive inward wall thickness);
+this one supports both signs.
+
+## Parameters
+
+### solid
+
+- **Description**: The solid to offset.
+
+### amount
+
+- **Description**: Offset distance; positive outward, negative inward.
+
+### openings
+
+- **Description**: Faces of ``solid`` (or a QL selector) left open.
+
+### tolerance
+
+- **Description**: Kernel tolerance of the offset.
+
+### kind
+
+- **Description**: Join type, ``"ARC"`` or ``"INTERSECTION"``.
+
+## Returns
+
+The offset solid.
+
+## Raises
+
+- **ValueError**: ``amount`` is zero or not finite, ``tolerance`` is not finite and positive, ``kind`` is unknown, ``openings`` do not select faces, or the kernel produced an invalid result.

{simplecadapi-2.2.6 → simplecadapi-2.2.6.post2}/docs/skill/references/docs/api/run_notebook.md

@@ -3,7 +3,7 @@
 ## API Definition
 
 ```python
-def run_notebook(path: str | Path, *, id: str | None = None, overrides: Mapping[str, Any] | None = None, cache: bool = True) -> NotebookRun
+def run_notebook(path: str | Path, *, id: str | None = None, overrides: Mapping[str, Any] | None = None, cache: bool = True, through: int | None = None, product: bool = True, timeout: float | None = None) -> NotebookRun
 ```
 
 *Source: runtime/runner.py*
@@ -22,3 +22,9 @@ value with that id, and cells read it with ``notebook_id()``.
 not run (marimo requires such a cell's variables to be overridden all
 together).  ``cache=False`` neither reads nor writes the cell cache.
 Errors raised by a cell propagate unchanged.
+
+*through* runs only the first *through* cells, in notebook order — the
+validation of a stage the tail does not have to exist for.  With
+``product=False`` the run does not look for the notebook's product at
+all.  *timeout* (seconds) fails the run with :class:`TimeoutError` when
+it takes longer; ``None`` (the default) runs unbounded.

simplecadapi-2.2.6.post2/docs/skill/references/docs/api/scale_rsolid.md

@@ -0,0 +1,45 @@
+# scale_rsolid
+
+## API Definition
+
+```python
+def scale_rsolid(solid: Solid, factors: Sequence[float], center: Sequence[float] = (0, 0, 0)) -> Solid
+```
+
+*Source: operators/transform.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import scale_rsolid`
+
+## Description
+
+Scale a solid along the current coordinate system's axes about a center.
+
+The three factors must be finite and nonzero. A uniform scale preserves
+analytic curves and surfaces; a nonuniform scale uses the CAD kernel's
+general affine transform. The source solid stays unchanged. The operation
+is recorded as ``make_scale_rsolid`` for graph replay; topology tag lineage
+is conservatively partial.
+
+## Parameters
+
+### solid
+
+- **Description**: The solid to scale.
+
+### factors
+
+- **Description**: Scale factors along the x, y and z axes of the current coordinate system; finite and nonzero.
+
+### center
+
+- **Description**: The fixed point of the scaling, in current coordinate-system coordinates.
+
+## Returns
+
+The scaled solid.
+
+## Raises
+
+- **ValueError**: A factor is zero or not finite, or the kernel could not scale the solid.

simplecadapi-2.2.6.post2/docs/skill/references/docs/api/sweep_multisection_rsolid.md

@@ -0,0 +1,51 @@
+# sweep_multisection_rsolid
+
+## API Definition
+
+```python
+def sweep_multisection_rsolid(profiles: Sequence[Face | Wire], path: Wire, is_frenet: bool = False, binormal: Sequence[float] | Wire | None = None) -> Solid
+```
+
+*Source: operators/features.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import sweep_multisection_rsolid`
+
+## Description
+
+Sweep through explicit ordered sections along a continuous path.
+
+At least two ordered sections are needed. Face sections supply their outer
+wire, matching build123d's multi-section sweep contract. ``binormal`` is an
+optional direction vector or an auxiliary spine. The kernel must produce
+one valid solid. Every section and the path are recorded as inputs of
+``make_sweep_multisection_rsolid``, so model JSON preserves the
+construction.
+
+## Parameters
+
+### profiles
+
+- **Description**: Ordered section faces or wires (at least two).
+
+### path
+
+- **Description**: The continuous path wire.
+
+### is_frenet
+
+- **Description**: Use the Frenet frame along the path.
+
+### binormal
+
+- **Description**: A direction, or an auxiliary spine wire, that fixes the section orientation.
+
+## Returns
+
+The swept solid.
+
+## Raises
+
+- **TypeError**: A section is neither a Face nor a Wire.
+- **ValueError**: Fewer than two sections, a zero ``binormal`` direction, or the kernel could not make a solid.

simplecadapi-2.2.6.post2/docs/skill/references/docs/api/transform_rsolid.md

@@ -0,0 +1,40 @@
+# transform_rsolid
+
+## API Definition
+
+```python
+def transform_rsolid(solid: Solid, matrix: Sequence[Sequence[float]]) -> Solid
+```
+
+*Source: operators/transform.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import transform_rsolid`
+
+## Description
+
+Apply a finite nonsingular 4x4 affine matrix in the current coordinate system.
+
+The matrix may include shear, reflection and nonuniform scale. Perspective
+matrices and singular maps cannot define a solid and are rejected. The
+input geometry stays unchanged. The operation is recorded as
+``make_transform_rsolid`` for graph replay; topology tag lineage is partial.
+
+## Parameters
+
+### solid
+
+- **Description**: The solid to transform.
+
+### matrix
+
+- **Description**: A 4x4 affine matrix (row-major, last row ``0 0 0 1``), finite and nonsingular, in current coordinate-system coordinates.
+
+## Returns
+
+The transformed solid.
+
+## Raises
+
+- **ValueError**: The matrix is not a finite 4x4 affine matrix, is singular or a perspective map, or the kernel could not transform the solid.