draftwright 0.4.1__tar.gz → 0.4.3__tar.gz

{draftwright-0.4.1 → draftwright-0.4.3}/.gitignore

@@ -12,4 +12,5 @@ testenv/
 coverage.xml
 coverage*.json
 htmlcov/
+site/
 .DS_Store

{draftwright-0.4.1 → draftwright-0.4.3}/CHANGELOG.md

@@ -2,6 +2,97 @@
 
 ## Unreleased
 
+## v0.4.3 — 2026-08-09
+
+**A trust and validation-throughput patch release.** Whole-part hexagonal stock now receives its
+manufacturing definition, assembly recognition no longer combines evidence across bodies, and
+performance validation is both more stable and faster to run.
+
+### Added
+
+- **Whole-part regular hexagonal stock is recognised independently of an attached boss and
+  dimensioned as `HEX … A/F` plus its axial length** (#1082). In-plane rotation preserves the
+  geometric across-flats size instead of substituting an orientation-dependent bounding-box
+  width. Automatic and declared paths share the same compiler and placement machinery, while
+  completeness lint distinguishes placed, authored-suppressed, dropped, missing, and ambiguous
+  outcomes.
+
+### Fixed
+
+- **Slot and pocket patterns cannot group members from separate assembly bodies** (#1073).
+  Recognition carries solid ownership through grouping and fails closed when ownership is
+  unavailable, preventing plausible-looking phantom patterns across disconnected parts.
+
+- **The annotation-obstacle performance guard uses deterministic work-count evidence instead of
+  a wall-clock threshold** (#1071). The regression test remains load-bearing under mutation but
+  no longer flakes because of machine load or suite ordering.
+
+### Changed
+
+- **The post-merge slow tier distributes individual tests across workers** (#1108), using
+  `pytest-xdist`'s load scheduling after local benchmark evidence showed a material speed-up
+  without weakening fixture coverage. Hosted slow validation remains the single post-merge gate.
+
+## v0.4.2 — 2026-08-09
+
+**The trustworthy manufacturing drawings release.** AP242 PMI is now accounted for from its
+source records through lowering and rendering, imported datum faces retain an auditable topology
+identity, and several drawing paths that previously omitted, invented, or stalled on defining
+geometry now fail closed or produce the required annotation.
+
+### Added
+
+- **AP242 geometric tolerances and datum features survive as source-backed manufacturing
+  requirements** (#62/#675/#1094/#1095/#1099/#1100). The importer recovers range-encoded
+  dimensional tolerances, tolerance characteristics, magnitudes, datum chains, and supported
+  all-around/all-over modifiers. Datum representation-item faces are resolved to imported
+  topology through OCCT's exact transfer relationship rather than geometric resemblance, so the
+  NIST CTC-01 datum definitions `A`, `B`, and `C` lower and render without guessing.
+
+- **PMI completeness lint reconciles every AP242 source record through extraction, projection,
+  lowering, and rendering** (#623). Unsupported or incomplete requirements remain explicit with
+  source-specific outcomes instead of allowing a partial PMI transcription to report clean.
+
+- **Hexagonal and other regular polygonal bosses are recognised and dimensioned by their
+  across-flats size** (#676). Automatic and declared paths share the same feature model, and
+  mutation tests reject incomplete, unequal, non-planar, and ambiguous face sets.
+
+- **Generated `Sheet` scripts preserve references to named source objects where correspondence
+  is proven** (#1041). The `--script` path emits declarations such as
+  `sheet.hole(features.tap)` instead of copying detected numbers; ambiguous, stale, non-shape, or
+  unused mappings fail closed.
+
+- **A curated API reference is published at
+  <https://pzfreo.github.io/draftwright/>** (#846), covering the supported entry points,
+  `Sheet` declaration surface and fluent handles, `Drawing` results, and feature constructors.
+
+### Fixed
+
+- **Recognition no longer combines faces from different solids into phantom slots or pads**
+  (#958). Each physical solid is recognised independently before the results are combined.
+
+- **`Sheet.from_part(...).envelope()` reuses the detected whole-part envelope** (#1000) instead
+  of appending a duplicate feature whose dimensions were then silently deduplicated on the page.
+
+- **Crowded Z-turned step chains recover the independently approved overall height when the
+  chain cannot be placed** (#955), and placed step lengths retain measurement identity for
+  differential audit (#1004).
+
+- **All-over GD&T leaders and complex STEP B-spline paths have bounded, export-safe DXF
+  conversion** (#1097/#1070). All-over scope now reaches the existing export-safe leader
+  representation, while spline conversion reads OCCT knots, poles, and weights through its
+  indexed API instead of expensive sequence wrappers; visible curve geometry is preserved.
+
+### Changed
+
+- **Hosted CI retains every supported Python version and both dependency/kernel generations on
+  macOS and Windows with a smaller compatibility matrix** (#1103). PRs still require lint,
+  coverage, Codecov, and the compatibility gates; the slow standards tier runs once after merge.
+
+- **The pinned wheel fixture now records mutation-gated evidence for a repeating 13-fold radial
+  profile without claiming gear semantics** (#1085). Runtime recognition remains fail-closed
+  until a separate feature contract has independently sufficient evidence.
+
 ## v0.4.1 — 2026-08-07
 
 **The recognition trust release.** Automatic drawings now fail closed on unsupported inner

{draftwright-0.4.1 → draftwright-0.4.3}/PKG-INFO

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: draftwright
-Version: 0.4.1
+Version: 0.4.3
 Summary: Automated technical-drawing generation for build123d
 Project-URL: Homepage, https://github.com/pzfreo/draftwright
 Project-URL: Repository, https://github.com/pzfreo/draftwright
 Project-URL: Issues, https://github.com/pzfreo/draftwright/issues
 Project-URL: Changelog, https://github.com/pzfreo/draftwright/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://pzfreo.github.io/draftwright/
 Author-email: Paul Fremantle <pzfreo@gmail.com>
 License:                     GNU AFFERO GENERAL PUBLIC LICENSE
                                Version 3, 19 November 2007
@@ -682,6 +683,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Scientific/Engineering
 Requires-Python: <3.15,>=3.10
+Requires-Dist: antlr4-python3-runtime<4.10
 Requires-Dist: build123d-drafting-helpers>=0.14.1
 Requires-Dist: build123d<0.11,>=0.9.0; python_full_version < '3.13'
 Requires-Dist: build123d<0.12,>=0.11; python_full_version >= '3.13'
@@ -689,6 +691,7 @@ Requires-Dist: numpy>=1.24
 Requires-Dist: pillow>=10
 Requires-Dist: pypdfium2>=4
 Requires-Dist: reportlab>=4.0
+Requires-Dist: steputils==0.1
 Requires-Dist: svglib>=1.5
 Requires-Dist: typer>=0.12
 Requires-Dist: typing-extensions>=4.5; python_full_version < '3.13'
@@ -705,6 +708,9 @@ Description-Content-Type: text/markdown
 [![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](LICENSE)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 
+**[API reference](https://pzfreo.github.io/draftwright/)** ·
+**[Examples and source](https://github.com/pzfreo/draftwright#readme)**
+
 Automated technical-drawing generation for [build123d](https://github.com/gumyr/build123d).
 Point it at a solid (or a STEP file) and get a fully-annotated multi-view engineering
 drawing — orthographic views, dimensions, section A–A, ISO hatching, title block — ready

{draftwright-0.4.1 → draftwright-0.4.3}/README.md

@@ -9,6 +9,9 @@
 [![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](LICENSE)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 
+**[API reference](https://pzfreo.github.io/draftwright/)** ·
+**[Examples and source](https://github.com/pzfreo/draftwright#readme)**
+
 Automated technical-drawing generation for [build123d](https://github.com/gumyr/build123d).
 Point it at a solid (or a STEP file) and get a fully-annotated multi-view engineering
 drawing — orthographic views, dimensions, section A–A, ISO hatching, title block — ready

{draftwright-0.4.1 → draftwright-0.4.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "draftwright"
-version = "0.4.1"
+version = "0.4.3"
 description = "Automated technical-drawing generation for build123d"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -25,6 +25,11 @@ dependencies = [
     "pillow>=10",
     "pypdfium2>=4",
     "reportlab>=4.0",
+    # Structured ISO 10303-21 access for AP242 facts that OCCT's XCAF transfer drops (#62).
+    # STEPutils 0.1 is the only release; isolate it behind _pmi_part21 and pin its README's
+    # ANTLR compatibility constraint explicitly because the package metadata omits the cap.
+    "steputils==0.1",
+    "antlr4-python3-runtime<4.10",
     "svglib>=1.5",
     "typer>=0.12",
     # PEP 702 @deprecated: stdlib `warnings.deprecated` lands in 3.13; backport for 3.10–3.12.
@@ -53,6 +58,7 @@ Homepage = "https://github.com/pzfreo/draftwright"
 Repository = "https://github.com/pzfreo/draftwright"
 Issues = "https://github.com/pzfreo/draftwright/issues"
 Changelog = "https://github.com/pzfreo/draftwright/blob/main/CHANGELOG.md"
+Documentation = "https://pzfreo.github.io/draftwright/"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/draftwright"]
@@ -144,6 +150,10 @@ select = ["E", "F", "I", "UP"]
 ignore = ["E501"]
 
 [dependency-groups]
+docs = [
+    "mkdocs>=1.6,<2",
+    "mkdocstrings[python]>=0.30,<1",
+]
 dev = [
     "codespell>=2.3.0",
     "hypothesis>=6",

{draftwright-0.4.1 → draftwright-0.4.3}/src/draftwright/__init__.py

@@ -29,8 +29,11 @@ _LAZY = {
     "FeatureInfo": "draftwright.drawing",
     "Sheet": "draftwright.sheet",
     "lint_feature_coverage": "draftwright.linting",
+    "PmiExtractionReport": "draftwright.pmi",
     "PmiRecord": "draftwright.pmi",
+    "PmiSourceEntity": "draftwright.pmi",
     "extract_pmi": "draftwright.pmi",
+    "extract_pmi_report": "draftwright.pmi",
     "choose_scale": "draftwright.compose",
     # A warning category users are told to filter must be importable without reaching into a
     # private module (#1043 review) — and without paying for the CAD kernel. It lives in the
@@ -78,7 +81,13 @@ if TYPE_CHECKING:  # static analysers / IDEs — no runtime import, no kernel co
     from draftwright.compose import choose_scale
     from draftwright.drawing import Drawing, FeatureInfo
     from draftwright.linting import lint_feature_coverage
-    from draftwright.pmi import PmiRecord, extract_pmi
+    from draftwright.pmi import (
+        PmiExtractionReport,
+        PmiRecord,
+        PmiSourceEntity,
+        extract_pmi,
+        extract_pmi_report,
+    )
     from draftwright.sheet import Sheet
 
 
@@ -93,11 +102,14 @@ __all__ = [
     "Drawing",
     "SoftDeprecationWarning",
     "FeatureInfo",
+    "PmiExtractionReport",
     "PmiRecord",
+    "PmiSourceEntity",
     "Sheet",
     "build_drawing",
     "choose_scale",
     "extract_pmi",
+    "extract_pmi_report",
     "lint_feature_coverage",
     "make_drawing",
 ]

{draftwright-0.4.1 → draftwright-0.4.3}/src/draftwright/_core.py

@@ -1015,8 +1015,16 @@ class Analysis:
     tolerance: str
     drawn_by: str
     out: str
-    pmi: list
+    # Canonical AP242 source census + extraction outcomes for a STEP input, including off mode
+    # (which inventories but does not lower records); None for an in-memory Shape. Typed as
+    # object to keep the rank-1 core from importing rank-2 pmi; the compatibility `pmi` property
+    # below is its records projection.
+    pmi_report: object | None
     pmi_mode: str
+    # True when the caller omitted `pmi` and the public default selected off. Kept separate
+    # from the effective mode so the ignored-PMI diagnostic can distinguish that default from
+    # an explicit opt-out without widening the three-mode renderer contract (#623).
+    pmi_defaulted: bool
     # Standing ISO 7200 title-block fields (#766) — defaulted, so they sit after the
     # non-default fields above. Defaults preserve the prior output: revision "A", the rest
     # blank (the TitleBlock helper's own defaults).
@@ -1040,6 +1048,11 @@ class Analysis:
     # back to build_model(a).
     model: object | None = None
 
+    @property
+    def pmi(self) -> list:
+        """Successful PMI records, derived from the canonical extraction report."""
+        return list(getattr(self.pmi_report, "records", ()))
+
 
 _greedy_strip_ys = _greedy_strip_1d