draftwright 0.4.25__tar.gz → 0.4.27__tar.gz

{draftwright-0.4.25 → draftwright-0.4.27}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: draftwright
-Version: 0.4.25
+Version: 0.4.27
 Summary: Automated technical-drawing generation for build123d
 Project-URL: Homepage, https://github.com/pzfreo/draftwright
 Project-URL: Repository, https://github.com/pzfreo/draftwright
@@ -694,6 +694,7 @@ Requires-Dist: pillow>=10
 Requires-Dist: pypdfium2>=4
 Requires-Dist: quiddity==0.2.6
 Requires-Dist: reportlab>=4.0
+Requires-Dist: rich>=10.11
 Requires-Dist: steputils==0.1
 Requires-Dist: svglib>=1.5
 Requires-Dist: typer>=0.12
@@ -736,6 +737,10 @@ annotation placed by the engine.*
 pip install draftwright
 ```
 
+Already using a CAD project environment? Use a [separate drawing environment](docs/reference/isolated-execution.md)
+and pass an exported STEP file between the two. The guide includes interpreter, dependency and
+import checks for local Python and CAD MCP workflows.
+
 ### Command line
 
 Point it at a STEP file — that's the whole workflow:

{draftwright-0.4.25 → draftwright-0.4.27}/README.md

@@ -34,6 +34,10 @@ annotation placed by the engine.*
 pip install draftwright
 ```
 
+Already using a CAD project environment? Use a [separate drawing environment](docs/reference/isolated-execution.md)
+and pass an exported STEP file between the two. The guide includes interpreter, dependency and
+import checks for local Python and CAD MCP workflows.
+
 ### Command line
 
 Point it at a STEP file — that's the whole workflow:

{draftwright-0.4.25 → draftwright-0.4.27}/docs/reference/sheet.md

@@ -9,7 +9,10 @@ with an underscore.
 Use `Sheet(part, projection="first")` or `build_drawing(part, projection="first")`
 for first-angle layout and its matching projection symbol. The CLI equivalent is
 `--projection first`. Explicit `"third"` selects third-angle layout and its symbol;
-omitting `projection` keeps third-angle layout without a symbol.
+omitting `projection` uses third-angle layout and its symbol. Use
+`projection_symbol=False` (CLI: `--no-projection-symbol`) to omit the symbol for an
+embedded illustration; this does not change the projection convention or view layout.
+The visibility choice also survives generated-script replay.
 
 View names retain their physical viewing directions in the working part frame. Changing
 convention changes sheet relationships, not which side of the part a name shows:
@@ -27,6 +30,58 @@ fails before projection; a whole-view pin must preserve the convention's relatio
 
 ## Dimension text style
 
+### Title fields and notes at paper size
+
+Keep title-block values concise and put longer engineering information in a `notes()` block.
+`title_field_overflow` identifies text wider or taller than its title-block cell, even when the
+text remains inside the page. This is a legibility warning, like overlapping annotations;
+text outside the drawable page remains an `annotation_out_of_bounds` error. The full value
+stays rendered; the diagnostic does not truncate it, shrink the font or invent an abbreviation.
+`lint_summary()["passed"]` checks errors only, so inspect warnings and the legibility component
+as well. A title warning does not prevent scale recovery from restoring missing measurements.
+
+<!-- issue-1536-notes-example -->
+```python
+from build123d import Box
+from draftwright import Sheet
+
+sheet = Sheet(
+    Box(30, 20, 10), page="A4", scale=2,
+    title="FRAME - DFM REVIEW", number="REVIEW", material="SEE NOTES",
+    detail_view=False,
+)
+sheet.authored_dimensions()
+envelope = sheet.envelope()
+for parameter in envelope.dimension_ids():
+    sheet.dimension(envelope, parameter)
+sheet.notes([
+    "QUOTATION / DFM REVIEW - NOT RELEASED",
+    "Material: TITANIUM - GRADE TBD",
+    "Hinge fit and pin retention: engineering decision required",
+], prefer="tr")
+drawing = sheet.build()
+for issue in drawing.lint():
+    print(issue.severity, issue.code, issue.message)
+```
+<!-- /issue-1536-notes-example -->
+
+`page` and `scale` control the sheet and model size. The current annotation preset has a fixed
+3 mm nominal paper font size; changing scale does not enlarge notes. `Sheet.notes()` and
+`Sheet.table()` have no font-size option. `text_position` and `text_orientation` below control
+dimension style, not note size. A smaller model scale makes notes larger relative to the part;
+a smaller page changes how much of the page they occupy. Neither changes their printed size.
+For the A2 frame trial, retain A2 and the requested scale unless the full package fits the new
+constraints with its required measurements intact; the small box example is not proof that
+the frame fits A4.
+
+`prefer="tr"` ranks available table positions near the top-right corner. The shared placement
+solve still measures the whole notes block and checks all occupied regions. If it cannot fit,
+`table_dropped` reports the failure. Split long prose into authored lines or choose an appropriate
+page; do not remove engineering content merely to silence a diagnostic. General notes remain
+uncredited text: they do not automatically satisfy missing dimensions or unsupported features.
+
+### Dimension position and reading direction
+
 Position and reading direction are independent drawing-wide settings:
 
 ```python
@@ -74,6 +129,20 @@ resolved wording, machining specifications and placement constraints agree; orig
 owners and measurement identities remain separate. Removing one owner of a shared callout
 rebuilds the survivors through the placement solver.
 
+## Feature schedules
+
+`sheet.schedule([(feature, ("bore.diameter", "location"))], name="holes")` declares a measured
+table through the same IR/compiler as ordinary dimensions. Features may be fluent handles or
+exact owned IR objects. Values, tolerances, units and through/blind wording come from the
+compiler. `location` expands the addressable member coordinates; explicit canonical IDs select
+individual components. Use `prefer="tr"`, `"tl"`, `"br"` or `"bl"` to rank the existing table
+placement candidates.
+
+Schedules establish authored dimension intent. Add `sheet.dimension(...)` declarations when a
+measurement should also appear beside a view. Ordinary `table(...)` text has no measurement
+authority. See [shared drawing documents](document.md#feature-schedules) for an executable
+recipe, verified cell evidence and the document report contract.
+
 ## Grooves on coaxial bodies
 
 When different turned bodies share an axis line, give their steps distinct `profile_group`
@@ -304,17 +373,84 @@ View declarations are semantic constraints. They name projections, relationships
 anchors; the layout solve owns the resulting page positions. Authored views must be paired with
 authored dimensions so a deliberately omitted view cannot strand planner-selected annotations:
 
+This runnable example includes the part, feature declarations, dimension discovery,
+three principal views and section A–A. The bore's location dimensions are deliberately
+omitted, and lint keeps those omissions visible.
+
+<!-- example: authored-section -->
+```python
+from build123d import Box, Cylinder, Pos
+from draftwright import Sheet
+
+bore_tool = Pos(12, 0, 0) * Cylinder(3, 12)
+part = Box(60, 40, 12) - bore_tool
+sheet = Sheet(part, page="A3", scale=1, projection="third")
+sheet.authored_dimensions().authored_views()
+
+envelope = sheet.envelope(part)
+for parameter_id in envelope.dimension_ids():
+    sheet.dimension(envelope, parameter_id)
+bore = sheet.hole(bore_tool)
+print(bore.dimension_ids())  # discover this handle's Sheet measurement IDs
+sheet.dimension(bore, "bore.diameter")
+
+for name in ("front", "plan", "side"):
+    sheet.view(name)
+sheet.section_view("A", through=bore)  # or at=0 for an explicit model-space Y plane
+
+drawing = sheet.build()
+issues = drawing.lint()
+for issue in issues:
+    print(issue.severity, issue.code, issue.message)
+# drawing.export("build/section", formats=("pdf", "svg"))
+```
+
+On a Sheet handle, `dimension_ids()` lists dotted measurement IDs; use
+`sheet.dimension(bore, "bore.diameter")`. On a built Drawing, the second argument to
+`drawing.dimension(envelope_feature, "length", role="width")` is a parameter kind,
+with `role=` distinguishing measurements of the same kind. Hole diameter and depth
+are callout content: use `drawing.callout(bore_feature)` for those, not
+`drawing.dimension(...)`. These are different vocabularies.
+
+#### Augmenting automatic views
+
+`view()` and `section_view()` specify complete authored sets. `add_view()` and
+`add_section_view()` instead augment an explicitly automatic set. Choose the source
+before adding views; an authored set cannot be switched to automatic in place.
+
+This separate, runnable example keeps automatic principal and derived views and
+adds a section at model-space Y=0. Its dimensions are still explicitly authored:
+
+<!-- example: automatic-section -->
 ```python
-s = Sheet(part).authored_dimensions().authored_views()
-front = s.view("front")
-plan = s.view("plan").above(front, gap=4).align_x(front)
-s.view("iso").scale(0.75)
-
-section = s.section_view("A", through=hole)
-detail = s.detail_view("B", around=hole).scale(2)
-dwg = s.build()
+from build123d import Box
+from draftwright import Sheet
+
+part = Box(60, 40, 12)
+sheet = Sheet(part, page="A3", scale=1).authored_dimensions()
+envelope = sheet.envelope(part)
+for parameter_id in envelope.dimension_ids():
+    sheet.dimension(envelope, parameter_id)
+sheet.auto_views()
+sheet.add_section_view("A", at=0)
+drawing = sheet.build()
+issues = drawing.lint()
+for issue in issues:
+    print(issue.severity, issue.code, issue.message)
 ```
 
+`auto_views()` emits `SoftDeprecationWarning`: it remains supported and has no removal
+date. The notice recommends the editable authored surface; it does not mean the
+augmentation example is invalid. Automatic dimensions remain supported too, but they
+cannot be paired with a complete authored view set.
+
+`Sheet.section()` is deprecated with removal targeted at 0.6.0. For an authored
+workflow replace it with `section_view("A", through=feature)` or `section_view("A", at=y)`;
+for automatic augmentation use `auto_views()` followed by `add_section_view(...)`.
+`Drawing.section()` is a separate automatic post-build operation and may add no section
+when the geometry does not warrant one.
+
+
 Rear views are explicitly requested. `s.view("rear")` includes rear in an authored
 view set; `s.auto_views().add_view("rear")` adds it to the automatic baseline.
 Rear looks toward the part from +Y with Z upward, so increasing world X runs left

{draftwright-0.4.25 → draftwright-0.4.27}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "draftwright"
-version = "0.4.25"
+version = "0.4.27"
 description = "Automated technical-drawing generation for build123d"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -38,6 +38,7 @@ dependencies = [
     "antlr4-python3-runtime<4.10",
     "svglib>=1.5",
     "typer>=0.12",
+    "rich>=10.11",
     # PEP 702 @deprecated: stdlib `warnings.deprecated` lands in 3.13; backport for 3.10–3.12.
     "typing_extensions>=4.5 ; python_full_version < '3.13'",
 ]
@@ -90,7 +91,7 @@ timeout = 300
 # (minutes each), deselected by default. `smoke` is a curated, build-light subset
 # (~30 s) for a quick local "did I break something obvious" check — run it with
 # `uv run pytest -m smoke`. The default run is the full fast tier (`-m 'not slow'`,
-# runtime depends on worker count). CI runs one real-part canary before merge,
+# runtime depends on worker count). CI runs bounded real-part canaries before merge,
 # the full slow tier after merge, and the fast tier across its compatibility matrix.
 markers = [
     "slow: end-to-end integration builds, including CTC fixtures (deselected by default)",

{draftwright-0.4.25 → draftwright-0.4.27}/skills/SKILL.md

@@ -29,9 +29,9 @@ verbs existed then, and the dotted parameter ids in Step 2 are new in 0.4.0.)
 everything automatically** (placement is constraint-based; you never compute page
 coordinates). When the first pass isn't perfect, you drive a **build → critique
 → fix** loop (Step "Lint → critique → fix" below), not a hand-layout edit. The
-rationale lives in `docs/adr/`: 0001 (deterministic generation over an editable
-DSL), 0002 (the lint critique → domain-repair loop), 0003 (the constraint-based
-layout engine). Edit through the domain API; treat `Placeable`/page mechanics as
+rationale lives in the five current records in `docs/adr/`: ADR 1 (compiler pipeline),
+ADR 2 (layout and view planning), ADR 3 (recognition), ADR 4 (declared intent), and
+ADR 5 (trust and honest failure). Edit through the domain API; treat `Placeable`/page mechanics as
 internals.
 
 ---
@@ -145,19 +145,26 @@ rather than the bare family role (`"width"`): the bare spelling is deprecated,
 because it is what let a single call silently declare two dimensions.
 
 `place_dim(p1, p2, side, view, …)` still exists for raw page coordinates, but it is
-the **escape hatch of last resort** (ADR 0012) and is deprecated: it bypasses the
+the **escape hatch of last resort** (ADR 4) and is deprecated: it bypasses the
 layout solve, so nothing re-flows around it.
 
-**Add a diameter callout on a hole the auto-pass missed** — find the bore in the
-model IR and hand it to `callout()`. This is what the `feature_not_dimensioned`
-lint suggestion hands you (it emits `dwg.callout(f)` — say *what*, not *where*):
+**Add a callout on a hole the auto-pass missed** — inspect its semantic requirement
+finding first. Equal diameters can belong to different axes, blind depths, threads
+or fits; a diameter-total warning never authorises increasing a callout count.
 
 ```python
-for f in dwg.model().features:
-    if f.kind == "hole" and abs(f.diameter - 4.0) < 0.2:
-        dwg.callout(f)                   # engine picks the view, leader and elbow
+for issue in dwg.lint():
+    if issue.code.startswith("hole_requirement_"):
+        print(issue.message)
+        if issue.suggestion:
+            print(issue.suggestion)
 ```
 
+For a verified missing bore on an automatic model, the suggestion targets the exact
+feature with `dwg.callout(...)` through the shared solve. It applies to that Drawing;
+re-run lint after rebuilding. Authored omissions, unverified ownership and conflicting
+counts require inspection of the declared operation rather than an automatic count edit.
+
 **Free text** at a chosen point is `note()` — a domain verb, not an escape hatch:
 
 ```python
@@ -183,24 +190,56 @@ warn from 0.4.0. See `docs/deprecations.md`.
 `make_drawing(...)` is `build_drawing(...).export(formats=("svg", "dxf"))`, unpacked to a
 tuple — not a bare `.export()`, which is the deprecated shape above.
 
-**Section views** come from the section verb rather than from projecting a view by
-hand. The two entry points are *not* equivalent:
+**Authored section views** use `section_view()` alongside an explicit dimension and
+view set. This complete example declares the bore diameter and overall extents;
+it deliberately leaves the bore's location dimensions unrequested:
 
+<!-- example: authored-section -->
 ```python
+from build123d import Box, Cylinder, Pos
 from draftwright import Sheet
 
-# Sheet.section() FORCES a cut, wherever you point it.
-cut = Sheet.from_part(part, number="DWG-042").section().build()
-"section_aa" in cut.views                 # True
-# section(feature) cuts through that feature; section(at=y) at an explicit Y.
-
-# Drawing.section() adds only the AUTOMATIC A–A, which fires just for qualifying
-# hidden internal geometry (a counterbore, spotface, or blind bottom). It returns
-# the placed annotation names, or [] when no section is warranted — so on a plain
-# through-holed block it does nothing at all.
-dwg.section()
+bore_tool = Pos(12, 0, 0) * Cylinder(3, 12)
+part = Box(60, 40, 12) - bore_tool
+sheet = Sheet(part, page="A3", scale=1, projection="third")
+sheet.authored_dimensions().authored_views()
+
+envelope = sheet.envelope(part)
+for parameter_id in envelope.dimension_ids():
+    sheet.dimension(envelope, parameter_id)
+bore = sheet.hole(bore_tool)
+print(bore.dimension_ids())  # discover this handle's Sheet measurement IDs
+sheet.dimension(bore, "bore.diameter")
+
+for name in ("front", "plan", "side"):
+    sheet.view(name)
+sheet.section_view("A", through=bore)  # or at=0 for an explicit model-space Y plane
+
+drawing = sheet.build()
+issues = drawing.lint()
+for issue in issues:
+    print(issue.severity, issue.code, issue.message)
+# drawing.export("build/section", formats=("pdf", "svg"))
 ```
 
+`dimension_ids()` lists the Sheet handle's dotted IDs: use `"bore.diameter"` here.
+Drawing.dimension instead takes a kind and optional role, such as `"length"` with
+`role="width"` for an envelope. Hole diameter/depth use Drawing.callout, not
+Drawing.dimension. Inspect `issues`: authored omissions
+remain visible, so a successfully built section does not prove a complete drawing.
+
+`view()` and `section_view()` define complete authored principal and derived sets.
+To augment automatic views instead, start a new Sheet, explicitly select
+`auto_views()`, and use `add_section_view("A", through=...)` or `at=...`.
+That mode remains supported; `auto_views()` emits a soft-deprecation notice with
+no removal date. Do not switch an already-authored view set to `auto_views()`.
+See the runnable augmentation example in `docs/reference/sheet.md`.
+
+`Sheet.section()` is deprecated with removal targeted at 0.6.0. Migrate it to the
+method for your view source above. `Drawing.section()` remains the automatic
+post-build section operation: it may return no section when the geometry does not
+warrant one. It does not replace an explicit authored section request.
+
 Arbitrary **auxiliary** views have no public verb: `add_view()` was the way to
 project one and is deprecated, so a custom viewing direction is not currently part
 of the supported surface.
@@ -311,7 +350,7 @@ for i in dwg.lint():
 dwg.repair()
 
 # Pin a deliberate placement so repair won't move it (the constraint solver will
-# honour it too as it lands — ADR 0003):
+# honour it too as it lands — ADR 2):
 dwg.pin(name)             # name from dwg.annotations(); dwg.unpin(name) to release
 ```
 

{draftwright-0.4.25 → draftwright-0.4.27}/src/draftwright/__init__.py

@@ -27,6 +27,9 @@ _LAZY = {
     "ScaleIncompatibilityError": "draftwright.builder",
     "make_drawing": "draftwright.builder",
     "Drawing": "draftwright.drawing",
+    "BuildEvent": "draftwright.progress",
+    "BuildCancelled": "draftwright.progress",
+    "observe_build": "draftwright.progress",
     "FeatureInfo": "draftwright.drawing",
     "ReportUnavailableError": "draftwright.reporting",
     "INSPECTION_SCHEMA": "draftwright.inspection",
@@ -34,6 +37,9 @@ _LAZY = {
     "InspectionUnavailableError": "draftwright.inspection",
     "inspect_step": "draftwright.inspection",
     "Sheet": "draftwright.sheet",
+    "Document": "draftwright.document",
+    "DocumentResult": "draftwright.document",
+    "DocumentBuildError": "draftwright.document",
     "lint_feature_coverage": "draftwright.linting",
     "PmiExtractionReport": "draftwright.pmi",
     "PmiRecord": "draftwright.pmi",
@@ -89,6 +95,7 @@ if TYPE_CHECKING:  # static analysers / IDEs — no runtime import, no kernel co
     from draftwright._warnings import ScaleCompletenessWarning, SoftDeprecationWarning
     from draftwright.builder import ScaleIncompatibilityError, build_drawing, make_drawing
     from draftwright.compose import choose_scale
+    from draftwright.document import Document, DocumentBuildError, DocumentResult
     from draftwright.drawing import Drawing, FeatureInfo
     from draftwright.inspection import (
         INSPECTION_SCHEMA,
@@ -104,6 +111,7 @@ if TYPE_CHECKING:  # static analysers / IDEs — no runtime import, no kernel co
         extract_pmi,
         extract_pmi_report,
     )
+    from draftwright.progress import BuildCancelled, BuildEvent, observe_build
     from draftwright.reporting import ReportUnavailableError
     from draftwright.sheet import Sheet
     from draftwright.view_plan import ViewConstraints, ViewPlanIncomplete, ViewSpec
@@ -117,9 +125,15 @@ def __dir__():
 
 
 __all__ = [
+    "BuildEvent",
+    "BuildCancelled",
+    "observe_build",
     "INSPECTION_SCHEMA",
     "INSPECTION_SCHEMA_VERSION",
     "Drawing",
+    "Document",
+    "DocumentResult",
+    "DocumentBuildError",
     "SoftDeprecationWarning",
     "FeatureInfo",
     "InspectionUnavailableError",

{draftwright-0.4.25 → draftwright-0.4.27}/src/draftwright/_core.py

@@ -20,7 +20,6 @@ import re
 from bisect import bisect_left, bisect_right
 from collections.abc import Callable
 from dataclasses import dataclass
-from decimal import Decimal
 from pathlib import Path
 from types import SimpleNamespace
 from typing import TYPE_CHECKING, Literal
@@ -63,6 +62,7 @@ from draftwright._geometry import (  # noqa: F401
     HoleRef,
     _axis_letter,
     _fmt,
+    _fmt_tolerance,
     _xyz,
 )
 from draftwright.fits import FitClass
@@ -110,6 +110,7 @@ def place_annotation(
     feature=None,
     measurement=None,
     satisfaction=None,
+    cells=(),
 ):
     """The annotation-placement primitive (#817): register *obj* under *name* — replacing any
     prior object of that name (dropped from the render list *items*) so a name maps to one
@@ -126,7 +127,7 @@ def place_annotation(
         items.remove(displaced)
     annotate(obj, name)
     items.append(obj)
-    registry.add(obj, name, view, feature, measurement, satisfaction)
+    registry.add(obj, name, view, feature, measurement, satisfaction, cells=cells)
     return obj
 
 
@@ -357,15 +358,7 @@ def _tol_suffix(tolerance, draft) -> str:
     if isinstance(tolerance, FitClass):
         return tolerance.suffix()
 
-    def magnitude(value):
-        decimal = Decimal(str(value))
-        precision = max(draft.decimal_precision, -int(decimal.as_tuple().exponent))
-        return f"{decimal:.{precision}f}"
-
-    if isinstance(tolerance, (int, float)):
-        return f" ±{magnitude(tolerance)}"
-    lo, hi = tolerance
-    return f" +{magnitude(hi)} -{magnitude(lo)}"
+    return _fmt_tolerance(tolerance, draft.decimal_precision)
 
 
 def _tag_sequence(n):
@@ -1267,9 +1260,10 @@ class Analysis:
     # Draw a sheet border/frame (#767). When True, `margin` is already the reserved content
     # margin (`_content_margin(True)`), so content clears the frame drawn at `_MARGIN`.
     frame: bool = False
-    # Projection-method symbol (#769): "third" / "first" (ISO 5456-2) or None (omit).
+    # Requested convention; None resolves to third-angle. Symbol visibility is independent.
     projection: str | None = None
     projection_convention: str = "third"
+    projection_symbol: bool = True
     text_position: str = "inline"
     text_orientation: str = "aligned"
     # Draw the ISO 5457 zone-grid border ruler (#768). Implies a frame (the ticks sit on it).
@@ -1419,6 +1413,13 @@ def _make_title_block(dwg, a: Analysis):
             )
         )
     tb.pdf_text_specs = tuple(specs)
+    # Keep the exact rendered field inputs for structural cell-overflow checks. Cell geometry
+    # remains owned by TitleBlock.cell_bbox(); it is not copied into a second layout model.
+    tb.title_field_specs = tuple(
+        (field, value, dwg.draft.font_size, PLEX_SANS_CONDENSED)
+        for field, value in fields
+        if value
+    )
     return tb, cell
 
 
@@ -1481,11 +1482,15 @@ def _add_projection_symbol(dwg, a: Analysis):
     just above the drawn title block (deterministic empty space — the block reserves _TB_H but
     draws shorter). Registered ``projection_symbol`` with an ``is_projection_symbol`` identity
     rider. Unlike the page-spanning frame it is NOT lint-exempt: it's a small, well-placed glyph,
-    so lint covers it and a future mispositioning is caught. Gated on ``a.projection``."""
+    so lint covers it and a future mispositioning is caught. Suppressed only by
+    ``projection_symbol=False``."""
+    if not a.projection_symbol:
+        return
+
     from build123d_drafting import ProjectionSymbol
 
     sym = ProjectionSymbol(
-        a.projection,
+        a.projection_convention,
         draft=draft_preset(
             font_size=dwg.draft.font_size,
             decimal_precision=dwg.draft.decimal_precision,
@@ -1496,7 +1501,8 @@ def _add_projection_symbol(dwg, a: Analysis):
     bx, by = (b.min.X + b.max.X) / 2, (b.min.Y + b.max.Y) / 2
     w, h = b.max.X - b.min.X, b.max.Y - b.min.Y
     # Right side of the title-block column, near the top of its reserved band.
-    cx = a.PAGE_W - _TB_CLEAR - w / 2 - 3
+    # Sheet frames reserve an inner content margin; keep furniture inside it too.
+    cx = a.PAGE_W - max(_TB_CLEAR + 3, a.margin) - w / 2
     cy = _TB_CLEAR + _TB_H - h / 2 - 2
     sym = sym.locate(Location((cx - bx, cy - by, 0)))
     sym.is_projection_symbol = True

{draftwright-0.4.25 → draftwright-0.4.27}/src/draftwright/_geometry.py

@@ -588,6 +588,29 @@ def _fmt(v: float, decimals: int | None = None) -> str:
     return str(r) if abs(v - r) < 1e-6 else f"{v:.1f}"
 
 
+def _fmt_tolerance(tolerance, decimal_precision: int = 1) -> str:
+    """Shared numeric tolerance suffix, preserving every authored deviation digit."""
+    if tolerance is None:
+        return ""
+
+    def magnitude(value):
+        decimal = Decimal(str(value))
+        precision = max(decimal_precision, -int(decimal.as_tuple().exponent))
+        return f"{decimal:.{precision}f}"
+
+    if isinstance(tolerance, (int, float)):
+        return f" ±{magnitude(tolerance)}"
+    lo, hi = tolerance
+    return f" +{magnitude(hi)} -{magnitude(lo)}"
+
+
+def _fmt_chamfer(leg_text, leg, other_leg, angle) -> str:
+    """Shared chamfer form: equal 45-degree legs use C, asymmetric legs state the angle."""
+    if abs(leg - other_leg) < 0.05 and abs(angle - 45.0) < 0.5:
+        return f"C{leg_text}"
+    return f"{leg_text} × {_fmt(angle)}°"
+
+
 def _fmt_angle(value, decimals=None, tolerance=None) -> str:
     """Complete angular text shared by footprint sizing and compilation.
 

{draftwright-0.4.25 → draftwright-0.4.27}/src/draftwright/analysis.py

@@ -57,13 +57,16 @@ from draftwright.compose import (
     _build_zones,
     _est_hole_table_sizes,
     _est_planned_bore_callout_width,
+    _est_table_size,
     _layout_geometry,
     _measure_strips,
     choose_scale,
 )
+from draftwright.model.compiled import compile_dimensions
 from draftwright.model.detect import _build_part_model_from_recognition
 from draftwright.model.ir import Datum, GrooveFeature, PartModel, StepFeature, StepLevelFeature
-from draftwright.model.planner import plan_dimensions
+from draftwright.model.planner import annotation_groups, plan_dimensions
+from draftwright.progress import observed_stage
 from draftwright.recognition_cache import _result_from_evidence
 from draftwright.recognition_frame import (
     FramedDetection,
@@ -84,6 +87,7 @@ _log = logging.getLogger(__name__)
 _ScalePick = tuple[float, float, float, float]
 
 
+@observed_stage("recognition")
 def _raw_recognition(
     part,
     *,
@@ -777,6 +781,7 @@ def _analyse(
     company="",
     frame: bool = False,
     projection: str | None = None,
+    projection_symbol: bool = True,
     text_position: str = "inline",
     text_orientation: str = "aligned",
     zones: bool = False,
@@ -787,11 +792,22 @@ def _analyse(
     _include_iso: bool = True,
     _view_constraints=None,
     _framed_recognition: bool = False,
+    _document_input=None,
 ) -> Analysis:
     """Load STEP or use a build123d Shape, analyse geometry, compute layout.
 
     Returns an :class:`Analysis`.
     """
+    if _document_input is not None:
+        if model is None or _framed_recognition:
+            raise ValueError("document members require their sealed raw model")
+        _document_input.validate(
+            step_file, model.features if isinstance(model, PartModel) else model
+        )
+        if _reuse is None:
+            _reuse = _document_input.analysis
+        elif _reuse.part is not _document_input.analysis.part:
+            raise ValueError("document analysis reuse names a foreign working solid")
     convention = projection or "third"
     # The zone-grid ruler (#768) draws its ticks on the frame, so it implies one.
     frame = frame or zones
@@ -1099,6 +1115,11 @@ def _analyse(
         if ownership_builder is not None
         else None
     )
+    if _document_input is not None:
+        # Declared sizing still reads only the member's authored model. Critique receives
+        # the original conversion authority rather than acquiring another recognition run.
+        recognition_evidence = _document_input.analysis.recognition_evidence
+        recognition_ownership = _document_input.analysis.recognition_ownership
     # Dimension feasibility and annotation footprints consume the authored set.
     # Derived-view dependencies still use sizing_model below; omitting an unrelated
     # envelope extent must not force its view back onto an authored sheet.
@@ -1116,6 +1137,12 @@ def _analyse(
         strip_sizing_model,
         planned_views=third_angle_view_names() if _views is None else _views,
     )
+    schedule_tables = (
+        compile_dimensions(strip_sizing_model, groups=sizing_groups).schedules
+        if strip_sizing_model.schedules
+        else ()
+    )
+    sizing_groups = annotation_groups(strip_sizing_model, sizing_groups)
     bore_callout_width = _est_planned_bore_callout_width(
         sizing_groups, _draft_est, font_size=_FONT_SIZE, pad_around_text=_pad_around_text
     )
@@ -1132,7 +1159,17 @@ def _analyse(
     layout_table_sizes = _est_hole_table_sizes(
         sizing_model, bb, font_size=_FONT_SIZE, pad_around_text=_pad_around_text
     )
-    layout_required_tables = tuple(_required_tables)
+    layout_required_tables = tuple(_required_tables) + tuple(
+        (
+            _est_table_size(
+                tuple(tuple(cell.text for cell in row) for row in schedule.rows),
+                font_size=_FONT_SIZE,
+                pad_around_text=_pad_around_text,
+            ),
+            schedule.prefer,
+        )
+        for schedule in schedule_tables
+    )
     planned_iso_scale = _planned_iso_scale(_view_constraints)
 
     # Choose scale/page, iterating so the reserved step corridor matches the
@@ -1406,6 +1443,7 @@ def _analyse(
         company=company,
         frame=frame,
         projection=projection,
+        projection_symbol=projection_symbol,
         text_position=text_position,
         text_orientation=text_orientation,
         projection_convention=convention,