simplecadapi 2.0.0b4__tar.gz → 2.0.1b1__tar.gz

{simplecadapi-2.0.0b4 → simplecadapi-2.0.1b1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplecadapi
-Version: 2.0.0b4
+Version: 2.0.1b1
 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
@@ -382,7 +382,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 beta: `simplecadapi==2.0.0b4`.
+Current beta: `simplecadapi==2.0.1b1`.
 
 ## What It Provides
 
@@ -510,6 +510,10 @@ If FreeCAD or FreeCADCmd is available, the same model JSON can be written as an
 scad.translate_model_json_to_fcstd(model_json, "bracket.FCStd")
 ```
 
+Part/Assembly models are written as editable FreeCAD assembly structure: parts are
+`App::Part`, assemblies are `Assembly::AssemblyObject`, and components are links.
+Explicit compound projections remain available for geometry-only STEP export.
+
 ## Examples
 
 Run examples from the source checkout:
@@ -521,6 +525,9 @@ uv run python examples/03_expressions.py
 uv run python examples/05_loft_sweep_revolve.py
 uv run python examples/06_parametric_gear_model.py
 uv run python examples/07_serialization_operation_tree.py
+uv run python examples/08_constrained_sketch.py
+uv run python examples/09_naca0016_blade_freecad.py
+uv run python examples/10_part_assembly.py
 ```
 
 ## Documentation

{simplecadapi-2.0.0b4 → simplecadapi-2.0.1b1}/README.md

@@ -6,7 +6,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 beta: `simplecadapi==2.0.0b4`.
+Current beta: `simplecadapi==2.0.1b1`.
 
 ## What It Provides
 
@@ -134,6 +134,10 @@ If FreeCAD or FreeCADCmd is available, the same model JSON can be written as an
 scad.translate_model_json_to_fcstd(model_json, "bracket.FCStd")
 ```
 
+Part/Assembly models are written as editable FreeCAD assembly structure: parts are
+`App::Part`, assemblies are `Assembly::AssemblyObject`, and components are links.
+Explicit compound projections remain available for geometry-only STEP export.
+
 ## Examples
 
 Run examples from the source checkout:
@@ -145,6 +149,9 @@ uv run python examples/03_expressions.py
 uv run python examples/05_loft_sweep_revolve.py
 uv run python examples/06_parametric_gear_model.py
 uv run python examples/07_serialization_operation_tree.py
+uv run python examples/08_constrained_sketch.py
+uv run python examples/09_naca0016_blade_freecad.py
+uv run python examples/10_part_assembly.py
 ```
 
 ## Documentation

simplecadapi-2.0.1b1/docs/api/Assembly.md

@@ -0,0 +1,17 @@
+# Assembly
+
+## Class Definition
+
+```python
+class Assembly(assembly_id: str, name: Optional[str] = None, components: Tuple[Component, ...] = (), connectors: Tuple[Connector, ...] = (), constraints: Tuple[Constraint, ...] = (), grounded_component_ids: Tuple[str, ...] = ())
+```
+
+*Source: product.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import Assembly`
+
+## Description
+
+Product structure containing placed Part or subassembly components.

simplecadapi-2.0.1b1/docs/api/BSplineFitResult.md

@@ -0,0 +1,21 @@
+# BSplineFitResult
+
+## Class Definition
+
+```python
+class BSplineFitResult(degree: int, control_points: Tuple[PointTuple, ...], knots: Tuple[float, ...], sample_parameters: Tuple[float, ...], max_error: float, rms_error: float, tolerance: float, fairing: float, iterations: int, converged: bool)
+```
+
+*Source: math.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import BSplineFitResult`
+
+## Description
+
+Result from fitting a cubic B-spline to sampled curve points.
+
+The result stores a complete, normalized B-spline definition suitable for
+passing into the exact B-spline edge/wire APIs: cubic degree, control
+points, and a full clamped knot vector.

simplecadapi-2.0.1b1/docs/api/Component.md

@@ -0,0 +1,17 @@
+# Component
+
+## Class Definition
+
+```python
+class Component(component_id: str, item: AssemblyItem, placement: Placement, name: Optional[str] = None)
+```
+
+*Source: product.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import Component`
+
+## Description
+
+Assembly-local instance of a Part or subassembly.

simplecadapi-2.0.1b1/docs/api/Connector.md

@@ -0,0 +1,20 @@
+# Connector
+
+## Class Definition
+
+```python
+class Connector(connector_id: str, geometry_ref: GeometryRef, name: Optional[str] = None)
+```
+
+*Source: product.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import Connector`
+
+## Description
+
+Semantic datum frame anchored to a geometry sub-element (Face/Edge/Vertex).
+
+The connector wraps a QL-selected sub-shape.  The Placement is derived
+from the geometry at solve/translate time, not stored directly.

simplecadapi-2.0.1b1/docs/api/ConnectorRef.md

@@ -0,0 +1,17 @@
+# ConnectorRef
+
+## Class Definition
+
+```python
+class ConnectorRef(component_id: str, connector_id: str)
+```
+
+*Source: product.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import ConnectorRef`
+
+## Description
+
+Reference to a connector through a component instance.

{simplecadapi-2.0.0b4 → simplecadapi-2.0.1b1}/docs/api/Const.md

@@ -3,7 +3,7 @@
 ## Class Definition
 
 ```python
-class Const
+class Const(value: float, expr_id: str = field(default_factory=lambda : _make_expr_id('const')))
 ```
 
 *Source: expr.py*

simplecadapi-2.0.1b1/docs/api/Constraint.md

@@ -0,0 +1,17 @@
+# Constraint
+
+## Class Definition
+
+```python
+class Constraint(constraint_id: str, constraint_kind: ConstraintKind, connector_a: ConnectorRef, connector_b: ConnectorRef, drive_distance: Optional[float] = None, distance_limit: Optional[ScalarLimit] = None, drive_angle_degrees: Optional[float] = None, angle_limit: Optional[ScalarLimit] = None, name: Optional[str] = None)
+```
+
+*Source: product.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import Constraint`
+
+## Description
+
+Connector-to-connector assembly constraint.

simplecadapi-2.0.1b1/docs/api/ConstraintReport.md

@@ -0,0 +1,17 @@
+# ConstraintReport
+
+## Class Definition
+
+```python
+class ConstraintReport(solved: bool, grounded_component_ids: Tuple[str, ...], solved_component_ids: Tuple[str, ...], unsolved_component_ids: Tuple[str, ...], residuals: Tuple[ConstraintResidual, ...])
+```
+
+*Source: product.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import ConstraintReport`
+
+## Description
+
+Assembly constraint inspection report.

simplecadapi-2.0.1b1/docs/api/ConstraintResidual.md

@@ -0,0 +1,17 @@
+# ConstraintResidual
+
+## Class Definition
+
+```python
+class ConstraintResidual(constraint_id: str, translation_error: float, angular_error_degrees: float, within_tolerance: bool)
+```
+
+*Source: product.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import ConstraintResidual`
+
+## Description
+
+Residual for a single assembly constraint.

{simplecadapi-2.0.0b4 → simplecadapi-2.0.1b1}/docs/api/Expr.md

@@ -3,7 +3,7 @@
 ## Class Definition
 
 ```python
-class Expr
+class Expr(op: str, args: Tuple[ScalarExpr, ...], expr_id: str = field(default_factory=lambda : _make_expr_id('expr')))
 ```
 
 *Source: expr.py*

simplecadapi-2.0.1b1/docs/api/GeometryRef.md

@@ -0,0 +1,22 @@
+# GeometryRef
+
+## Class Definition
+
+```python
+class GeometryRef(kind: str, source_node_id: Optional[str], geo_selector: Dict[str, Any], flip: bool = False)
+```
+
+*Source: product.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import GeometryRef`
+
+## Description
+
+Serializable reference to a sub-shape selected via QL.
+
+Wraps the geo_selector fingerprint + source graph node id so the
+exact sub-element (Face/Edge/Vertex) can be re-resolved at translation
+time or during constraint solving. When flip is True, the derived
+placement Z axis is negated.

simplecadapi-2.0.1b1/docs/api/Material.md

@@ -0,0 +1,17 @@
+# Material
+
+## Class Definition
+
+```python
+class Material(material_id: str, name: Optional[str] = None, density: Optional[float] = None, density_unit: Optional[str] = None, color: Optional[Vec3] = None)
+```
+
+*Source: product.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import Material`
+
+## Description
+
+Material definition assigned to a Part through `assign_material_rpart`.

simplecadapi-2.0.1b1/docs/api/Part.md

@@ -0,0 +1,17 @@
+# Part
+
+## Class Definition
+
+```python
+class Part(part_id: str, body: Solid, name: Optional[str] = None, material: Optional[Material] = None, connectors: Tuple[Connector, ...] = ())
+```
+
+*Source: product.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import Part`
+
+## Description
+
+Single-body product item wrapping exactly one Solid.

simplecadapi-2.0.1b1/docs/api/Placement.md

@@ -0,0 +1,17 @@
+# Placement
+
+## Class Definition
+
+```python
+class Placement(origin: Vec3, x_axis: Vec3 = (1.0, 0.0, 0.0), y_axis: Vec3 = (0.0, 1.0, 0.0), z_axis: Vec3 = (0.0, 0.0, 1.0))
+```
+
+*Source: product.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import Placement`
+
+## Description
+
+Right-handed placement mapping child-local coordinates to parent coordinates.

simplecadapi-2.0.1b1/docs/api/README.md

@@ -0,0 +1,203 @@
+# SimpleCAD API Index
+
+This index includes generated docs for the public SimpleCAD API surface, including geometry operations, graph/model JSON workflows, expressions, QL, and export helpers.
+
+## Import Surfaces
+
+- 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`.
+
+## Basic Creation
+
+- [make_angle_arc_redge](make_angle_arc_redge.md) *(from operations.py)* `top-level`
+- [make_angle_arc_rwire](make_angle_arc_rwire.md) *(from operations.py)* `top-level`
+- [make_assembly_rassembly](make_assembly_rassembly.md) *(from operations.py)* `top-level`
+- [make_box_rsolid](make_box_rsolid.md) *(from operations.py)* `top-level`
+- [make_circle_redge](make_circle_redge.md) *(from operations.py)* `top-level`
+- [make_circle_rface](make_circle_rface.md) *(from operations.py)* `top-level`
+- [make_circle_rwire](make_circle_rwire.md) *(from operations.py)* `top-level`
+- [make_compound_from_assembly_rcompound](make_compound_from_assembly_rcompound.md) *(from operations.py)* `top-level`
+- [make_cone_rsolid](make_cone_rsolid.md) *(from operations.py)* `top-level`
+- [make_connector_ref_rconnectorref](make_connector_ref_rconnectorref.md) *(from operations.py)* `top-level`
+- [make_cylinder_rsolid](make_cylinder_rsolid.md) *(from operations.py)* `top-level`
+- [make_edge_connector_rconnector](make_edge_connector_rconnector.md) *(from operations.py)* `top-level`
+- [make_face_connector_rconnector](make_face_connector_rconnector.md) *(from operations.py)* `top-level`
+- [make_face_from_sketch_rface](make_face_from_sketch_rface.md) *(from operations.py)* `top-level`
+- [make_face_from_wire_rface](make_face_from_wire_rface.md) *(from operations.py)* `top-level`
+- [make_helix_redge](make_helix_redge.md) *(from operations.py)* `top-level`
+- [make_helix_rwire](make_helix_rwire.md) *(from operations.py)* `top-level`
+- [make_line_redge](make_line_redge.md) *(from operations.py)* `top-level`
+- [make_material_rmaterial](make_material_rmaterial.md) *(from operations.py)* `top-level`
+- [make_part_rpart](make_part_rpart.md) *(from operations.py)* `top-level`
+- [make_placement_rplacement](make_placement_rplacement.md) *(from operations.py)* `top-level`
+- [make_point_rvertex](make_point_rvertex.md) *(from operations.py)* `top-level`
+- [make_polyline_rwire](make_polyline_rwire.md) *(from operations.py)* `top-level`
+- [make_rectangle_rface](make_rectangle_rface.md) *(from operations.py)* `top-level`
+- [make_rectangle_rwire](make_rectangle_rwire.md) *(from operations.py)* `top-level`
+- [make_scalar_limit_rscalarlimit](make_scalar_limit_rscalarlimit.md) *(from operations.py)* `top-level`
+- [make_segment_redge](make_segment_redge.md) *(from operations.py)* `top-level`
+- [make_segment_rwire](make_segment_rwire.md) *(from operations.py)* `top-level`
+- [make_sketch_rsketch](make_sketch_rsketch.md) *(from operations.py)* `top-level`
+- [make_sphere_rsolid](make_sphere_rsolid.md) *(from operations.py)* `top-level`
+- [make_spline_redge](make_spline_redge.md) *(from operations.py)* `top-level`
+- [make_spline_rwire](make_spline_rwire.md) *(from operations.py)* `top-level`
+- [make_three_point_arc_redge](make_three_point_arc_redge.md) *(from operations.py)* `top-level`
+- [make_three_point_arc_rwire](make_three_point_arc_rwire.md) *(from operations.py)* `top-level`
+- [make_vertex_connector_rconnector](make_vertex_connector_rconnector.md) *(from operations.py)* `top-level`
+- [make_wire_from_edges_rwire](make_wire_from_edges_rwire.md) *(from operations.py)* `top-level`
+- [make_wire_from_sketch_rwire](make_wire_from_sketch_rwire.md) *(from operations.py)* `top-level`
+
+## Transforms
+
+- [mirror_shape](mirror_shape.md) *(from operations.py)* `top-level`
+- [rotate_shape](rotate_shape.md) *(from operations.py)* `top-level`
+- [translate_shape](translate_shape.md) *(from operations.py)* `top-level`
+
+## 3D Operations
+
+- [extrude_rsolid](extrude_rsolid.md) *(from operations.py)* `top-level`
+- [loft_rsolid](loft_rsolid.md) *(from operations.py)* `top-level`
+- [revolve_rsolid](revolve_rsolid.md) *(from operations.py)* `top-level`
+- [sweep_rsolid](sweep_rsolid.md) *(from operations.py)* `top-level`
+
+## Tagging and Selection
+
+- [apply_tag](apply_tag.md) *(from operations.py)* `top-level`
+- [list_tags](list_tags.md) *(from operations.py)* `top-level`
+- [select_edges_by_tag](select_edges_by_tag.md) *(from operations.py)* `top-level`
+- [select_faces_by_tag](select_faces_by_tag.md) *(from operations.py)* `top-level`
+
+## Boolean Operations
+
+- [cut_rsolid](cut_rsolid.md) *(from operations.py)* `top-level`
+- [intersect_rsolid](intersect_rsolid.md) *(from operations.py)* `top-level`
+- [union_rsolid](union_rsolid.md) *(from operations.py)* `top-level`
+
+## Export
+
+- [export_step](export_step.md) *(from operations.py)* `top-level`
+- [export_stl](export_stl.md) *(from operations.py)* `top-level`
+
+## FreeCAD Translation
+
+- [translate_model_json_to_fcstd](translate_model_json_to_fcstd.md) *(from freecad_translator.py)* `top-level`
+- [translate_model_json_to_freecad_script](translate_model_json_to_freecad_script.md) *(from freecad_translator.py)* `top-level`
+
+## Math Helpers
+
+- [BSplineFitResult](BSplineFitResult.md) *(from math.py)* `top-level`
+- [fit_cubic_bspline_control_points](fit_cubic_bspline_control_points.md) *(from math.py)* `top-level`
+
+## Modeling Graph and Replay
+
+- [GraphSession](GraphSession.md) *(from graph.py)* `top-level`
+- [export_graph_json](export_graph_json.md) *(from serializer.py)* `top-level`
+- [export_model_json](export_model_json.md) *(from serializer.py)* `top-level`
+- [export_session_json](export_session_json.md) *(from serializer.py)* `top-level`
+- [import_graph_json](import_graph_json.md) *(from serializer.py)* `top-level`
+- [import_model_json](import_model_json.md) *(from serializer.py)* `top-level`
+- [import_session_json](import_session_json.md) *(from serializer.py)* `top-level`
+- [replay_graph](replay_graph.md) *(from serializer.py)* `top-level`
+- [replay_model_json](replay_model_json.md) *(from serializer.py)* `top-level`
+- [suspend_graph_recording](suspend_graph_recording.md) *(from graph.py)* `top-level`
+
+## Expressions and Parameters
+
+- [Const](Const.md) *(from expr.py)* `top-level`
+- [Expr](Expr.md) *(from expr.py)* `top-level`
+- [ExpressionGraph](ExpressionGraph.md) *(from expr.py)* `top-level`
+- [Var](Var.md) *(from expr.py)* `top-level`
+- [const](const_function.md) *(from expr.py)* `top-level`
+- [var](var_function.md) *(from expr.py)* `top-level`
+
+## Types and Errors
+
+- [SimpleCADError](SimpleCADError.md) *(from errors.py)* `top-level`
+- [Sketch](Sketch.md) *(from sketch.py)* `top-level`
+- [SketchConstraint](SketchConstraint.md) *(from sketch.py)* `top-level`
+- [SketchConstraintDiagnostic](SketchConstraintDiagnostic.md) *(from sketch.py)* `top-level`
+- [SketchRef](SketchRef.md) *(from sketch.py)* `top-level`
+- [SketchSolveResult](SketchSolveResult.md) *(from sketch.py)* `top-level`
+
+## Advanced Features
+
+- [chamfer_rsolid](chamfer_rsolid.md) *(from operations.py)* `top-level`
+- [fillet_rsolid](fillet_rsolid.md) *(from operations.py)* `top-level`
+- [helical_sweep_rsolid](helical_sweep_rsolid.md) *(from operations.py)* `top-level`
+- [shell_rsolid](shell_rsolid.md) *(from operations.py)* `top-level`
+
+## Evolve
+
+- [make_n_hole_flange_rsolid](make_n_hole_flange_rsolid.md) *(from evolve.py)* `top-level`
+- [make_naca_propeller_blade_rsolid](make_naca_propeller_blade_rsolid.md) *(from evolve.py)* `top-level`
+- [make_threaded_rod_rsolid](make_threaded_rod_rsolid.md) *(from evolve.py)* `top-level`
+
+## Other
+
+- [Assembly](Assembly.md) *(from product.py)* `top-level`
+- [Component](Component.md) *(from product.py)* `top-level`
+- [Connector](Connector.md) *(from product.py)* `top-level`
+- [ConnectorRef](ConnectorRef.md) *(from product.py)* `top-level`
+- [Constraint](Constraint.md) *(from product.py)* `top-level`
+- [ConstraintReport](ConstraintReport.md) *(from product.py)* `top-level`
+- [ConstraintResidual](ConstraintResidual.md) *(from product.py)* `top-level`
+- [GeometryRef](GeometryRef.md) *(from product.py)* `top-level`
+- [Material](Material.md) *(from product.py)* `top-level`
+- [Part](Part.md) *(from product.py)* `top-level`
+- [Placement](Placement.md) *(from product.py)* `top-level`
+- [ScalarLimit](ScalarLimit.md) *(from product.py)* `top-level`
+- [SemanticDelta](SemanticDelta.md) *(from topology.py)* `top-level`
+- [SemanticRef](SemanticRef.md) *(from topology.py)* `top-level`
+- [add_circle_rsketch](add_circle_rsketch.md) *(from operations.py)* `top-level`
+- [add_component_rassembly](add_component_rassembly.md) *(from operations.py)* `top-level`
+- [add_connector_rassembly](add_connector_rassembly.md) *(from operations.py)* `top-level`
+- [add_connector_rpart](add_connector_rpart.md) *(from operations.py)* `top-level`
+- [add_fixed_constraint_rassembly](add_fixed_constraint_rassembly.md) *(from operations.py)* `top-level`
+- [add_line_rsketch](add_line_rsketch.md) *(from operations.py)* `top-level`
+- [add_point_rsketch](add_point_rsketch.md) *(from operations.py)* `top-level`
+- [add_prismatic_constraint_rassembly](add_prismatic_constraint_rassembly.md) *(from operations.py)* `top-level`
+- [add_revolute_constraint_rassembly](add_revolute_constraint_rassembly.md) *(from operations.py)* `top-level`
+- [and_](and_.md) *(from ql.py)* `submodule:ql`
+- [assign_material_rpart](assign_material_rpart.md) *(from operations.py)* `top-level`
+- [constrain_angle_rsketch](constrain_angle_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_coincident_rsketch](constrain_coincident_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_collinear_rsketch](constrain_collinear_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_concentric_rsketch](constrain_concentric_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_connect_rsketch](constrain_connect_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_diameter_rsketch](constrain_diameter_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_distance_rsketch](constrain_distance_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_distance_x_rsketch](constrain_distance_x_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_distance_y_rsketch](constrain_distance_y_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_equal_length_rsketch](constrain_equal_length_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_equal_radius_rsketch](constrain_equal_radius_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_fix_rsketch](constrain_fix_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_horizontal_rsketch](constrain_horizontal_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_length_rsketch](constrain_length_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_midpoint_rsketch](constrain_midpoint_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_parallel_rsketch](constrain_parallel_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_perpendicular_rsketch](constrain_perpendicular_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_point_on_rsketch](constrain_point_on_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_radius_rsketch](constrain_radius_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_symmetric_rsketch](constrain_symmetric_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_tangent_rsketch](constrain_tangent_rsketch.md) *(from operations.py)* `top-level`
+- [constrain_vertical_rsketch](constrain_vertical_rsketch.md) *(from operations.py)* `top-level`
+- [geo](geo.md) *(from ql.py)* `submodule:ql`
+- [get_sketch_entity_rsketchref](get_sketch_entity_rsketchref.md) *(from operations.py)* `top-level`
+- [get_sketch_point_rsketchref](get_sketch_point_rsketchref.md) *(from operations.py)* `top-level`
+- [ground_component_rassembly](ground_component_rassembly.md) *(from operations.py)* `top-level`
+- [identity_placement_rplacement](identity_placement_rplacement.md) *(from operations.py)* `top-level`
+- [inspect_assembly_constraints_rconstraintreport](inspect_assembly_constraints_rconstraintreport.md) *(from operations.py)* `top-level`
+- [inspect_sketch_rsketchresult](inspect_sketch_rsketchresult.md) *(from operations.py)* `top-level`
+- [linear_pattern_rsolidlist](linear_pattern_rsolidlist.md) *(from operations.py)* `top-level`
+- [measure_constraint_residual_rconstraintresidual](measure_constraint_residual_rconstraintresidual.md) *(from operations.py)* `top-level`
+- [meta](meta.md) *(from ql.py)* `submodule:ql`
+- [not_](not_.md) *(from ql.py)* `submodule:ql`
+- [or_](or_.md) *(from ql.py)* `submodule:ql`
+- [place_component_rassembly](place_component_rassembly.md) *(from operations.py)* `top-level`
+- [radial_pattern_rsolidlist](radial_pattern_rsolidlist.md) *(from operations.py)* `top-level`
+- [render_screenshot_rpath](render_screenshot_rpath.md) *(from operations.py)* `top-level`
+- [select](select.md) *(from ql.py)* `submodule:ql`
+- [solve_assembly_constraints_rassembly](solve_assembly_constraints_rassembly.md) *(from operations.py)* `top-level`
+- [tag](tag.md) *(from ql.py)* `submodule:ql`
+- [unground_component_rassembly](unground_component_rassembly.md) *(from operations.py)* `top-level`
+- [value](value.md) *(from ql.py)* `submodule:ql`

simplecadapi-2.0.1b1/docs/api/ScalarLimit.md

@@ -0,0 +1,17 @@
+# ScalarLimit
+
+## Class Definition
+
+```python
+class ScalarLimit(lower_value: float, upper_value: float)
+```
+
+*Source: product.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import ScalarLimit`
+
+## Description
+
+Closed scalar range for a constraint drive coordinate.

{simplecadapi-2.0.0b4 → simplecadapi-2.0.1b1}/docs/api/SemanticDelta.md

@@ -3,7 +3,7 @@
 ## Class Definition
 
 ```python
-class SemanticDelta
+class SemanticDelta(created: Tuple[SemanticRef, ...] = (), modified: Tuple[SemanticRef, ...] = (), deleted: Tuple[SemanticRef, ...] = (), metadata: Dict[str, Any] = field(default_factory=dict))
 ```
 
 *Source: topology.py*

{simplecadapi-2.0.0b4 → simplecadapi-2.0.1b1}/docs/api/SemanticRef.md

@@ -3,7 +3,7 @@
 ## Class Definition
 
 ```python
-class SemanticRef
+class SemanticRef(graph_id: str, node_id: str, entity_type: str, entity_id: str)
 ```
 
 *Source: topology.py*

simplecadapi-2.0.1b1/docs/api/Sketch.md

@@ -0,0 +1,24 @@
+# Sketch
+
+## Class Definition
+
+```python
+class Sketch(curves: Iterable[Edge | Wire] | None = None, *, name: Optional[str] = None, plane: Any = 'XY', sketch_id: Optional[str] = None)
+```
+
+*Source: sketch.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import Sketch`
+
+## Description
+
+Declarative constrained sketch container.
+
+Use `make_sketch_rsketch(...)`, `add_point_rsketch(...)`,
+`add_line_rsketch(...)`, `add_circle_rsketch(...)`, and
+`constrain_*_rsketch(...)` as the canonical API for building sketch
+profiles. Public sketch construction APIs are functional and return an
+updated `Sketch` document. The legacy `curves` constructor remains only for
+reading already-built wire/edge containers.

simplecadapi-2.0.1b1/docs/api/SketchConstraint.md

@@ -0,0 +1,17 @@
+# SketchConstraint
+
+## Class Definition
+
+```python
+class SketchConstraint(constraint_id: str, kind: str, targets: Tuple[Dict[str, Any], ...], value: Any = None, driving: bool = True, metadata: Dict[str, Any] = field(default_factory=dict))
+```
+
+*Source: sketch.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import SketchConstraint`
+
+## Description
+
+Serializable constraint inside a declarative sketch.

simplecadapi-2.0.1b1/docs/api/SketchConstraintDiagnostic.md

@@ -0,0 +1,17 @@
+# SketchConstraintDiagnostic
+
+## Class Definition
+
+```python
+class SketchConstraintDiagnostic(constraint_id: Optional[str], severity: str, code: str, message: str, residual: Optional[float] = None)
+```
+
+*Source: sketch.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import SketchConstraintDiagnostic`
+
+## Description
+
+Diagnostic emitted by the sketch solver.

simplecadapi-2.0.1b1/docs/api/SketchRef.md

@@ -0,0 +1,17 @@
+# SketchRef
+
+## Class Definition
+
+```python
+class SketchRef(sketch_id: str, entity_id: str, *, kind: str, subentity: str = 'geometry')
+```
+
+*Source: sketch.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import SketchRef`
+
+## Description
+
+Stable reference to a sketch entity or subentity.

simplecadapi-2.0.1b1/docs/api/SketchSolveResult.md

@@ -0,0 +1,17 @@
+# SketchSolveResult
+
+## Class Definition
+
+```python
+class SketchSolveResult(sketch_id: str, status: str, dof: int, residual_norm: float, iterations: int, solved_points: Dict[str, Tuple[float, float]], solved_scalars: Dict[str, float], diagnostics: Tuple[SketchConstraintDiagnostic, ...] = ())
+```
+
+*Source: sketch.py*
+
+## Import Surface
+
+- top-level: `from simplecadapi import SketchSolveResult`
+
+## Description
+
+Result of solving a declarative sketch.