icadkit 0.3.8__tar.gz → 0.3.9__tar.gz

{icadkit-0.3.8 → icadkit-0.3.9}/Cargo.lock

@@ -89,7 +89,7 @@ checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
 
 [[package]]
 name = "icad-core"
-version = "0.3.8"
+version = "0.3.9"
 dependencies = [
  "flate2",
  "parasolid-core",
@@ -99,7 +99,7 @@ dependencies = [
 
 [[package]]
 name = "icad-python"
-version = "0.3.8"
+version = "0.3.9"
 dependencies = [
  "icad-core",
  "parasolid-core",

{icadkit-0.3.8 → icadkit-0.3.9}/Cargo.toml

@@ -4,7 +4,7 @@ resolver = "3"
 
 [workspace.package]
 # Release version source. Update with: python3 scripts/bump_version.py X.Y.Z
-version = "0.3.8"
+version = "0.3.9"
 edition = "2024"
 rust-version = "1.88"
 license = "PolyForm-Noncommercial-1.0.0"

{icadkit-0.3.8 → icadkit-0.3.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: icadkit
-Version: 0.3.8
+Version: 0.3.9
 Classifier: Development Status :: 2 - Pre-Alpha
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: Implementation :: CPython
@@ -32,31 +32,17 @@ A Rust-based Python reader for **iCAD SX `.icd` files**. Read saved part
 structure, coordinate frames, names and selected attributes; inspect native
 box/cylinder parameters; and extract embedded Parasolid geometry.
 
-Version **0.3.7** added:
+Supported workflows include:
 
-- [Saved final bodies](docs/saved-bodies.md) on rolling-ball blend surfaces
-  and on toroidal faces that reach their axis, through `parasolid-core 0.3.7`
-  and the `preview` extra pinned to `parasolid-kit[occt]==0.3.7`. The local
-  sample rises from 28,896 to 29,386 of 29,703 bound bodies, with the
-  previously converted bodies unchanged.
-- One declaration per backend version (`Cargo.toml`, `pyproject.toml`); the
-  runtime checks of the backend version are gone.
-
-Version 0.3.6 added [saved final bodies](docs/saved-bodies.md) on spun
-surfaces (SPUN_SURF), line/arc profile extrusions as [CSG](docs/csg.md)
-operands and decoded surface and edge items of the
-[trailing container](docs/trailer.md).
-
-Version 0.3.5 added [view inventories and saved 2D geometry](docs/drawing.md),
-twenty-six further catalog-free [schema keys](docs/support.md#schemas), the
-[trailing container](docs/trailer.md), saved final bodies bound through V8
-association records and V7 source IDs, more [native primitives](docs/native.md),
-[saved 3D parameter tables](docs/parameters.md) and explicit
-[external-reference resolution](docs/references.md).
-
-Version 0.3.0 added the [native file viewer](docs/viewer.md), broader
-[part access](docs/parts.md), optional [V7L7 boolean evaluation](docs/csg.md)
-and [saved final body display](docs/saved-bodies.md).
+- [Part access](docs/parts.md), [saved 3D parameter tables](docs/parameters.md)
+  and explicit [external-reference resolution](docs/references.md).
+- [View inventories and saved 2D geometry](docs/drawing.md), plus decoded
+  surface and edge items of the [trailing container](docs/trailer.md).
+- The [native file viewer](docs/viewer.md) for qualified
+  [native primitives](docs/native.md) and their part properties.
+- Optional [V7L7 boolean evaluation](docs/csg.md) and
+  [saved final body display](docs/saved-bodies.md), including qualified spun,
+  rolling-ball blend and toroidal surfaces.
 
 icadkit is experimental. Unsupported geometry remains in the part inventory;
 unknown values and source ranges are preserved. Part frames, native primitive
@@ -96,21 +82,24 @@ from it, and `icadkit.__version__` / the CLI use the installed package metadata.
 With Python 3.11+, Cargo and uv available, update it with one command:
 
 ```sh
-python3 scripts/bump_version.py 0.3.8
-python3 scripts/bump_version.py --check --tag v0.3.8
+python3 scripts/bump_version.py X.Y.Z
+python3 scripts/bump_version.py --check --tag vX.Y.Z
 ```
 
-The version above is an example. The command updates the workspace version,
-synchronizes `Cargo.lock` and `uv.lock`, and checks their consistency. On failure
-it restores all three files. Add `--offline` to use cached dependencies. Stable
+Replace `X.Y.Z` with the intended release number. The command updates the
+workspace version, synchronizes `Cargo.lock` and `uv.lock`, and checks their
+consistency. On failure it restores all three files. Add `--offline` to use
+cached dependencies. Stable
 `X.Y.Z` and development `X.Y.Z-dev.N` versions are supported; Python metadata
 uses `X.Y.Z.devN` for the latter. `--check` does not modify the source or locks.
 CI checks the same rules and requires release tags to match the source version.
 
-The `parasolid-core` and `parasolid-kit` dependency pins have their own versions
-and are updated separately. Historical versions in this README and the
-[changelog](docs/changelog.md) describe when features were introduced; retain
-those numbers and write new release notes when preparing a release.
+Use `icadkit --version` to check the installed package version and `icadkit info`
+to inspect its backend version. The `parasolid-core` and `parasolid-kit`
+dependency pins have their own versions and are updated separately.
+Usage guides describe capabilities without repeating the package version.
+Record version-specific changes in the [changelog](docs/changelog.md); retain
+the release numbers attached to historical notes and validation results.
 
 ## Part structure, frames and attributes
 
@@ -144,14 +133,12 @@ spherical, conical and toroidal surfaces. V8L3 resource sharing preserves each
 occurrence's saved placement. An explicit schema catalog is needed when the
 exact built-in profile lacks a required type. Counted metadata framing also
 extends part inventories while preserving unknown records and diagnostics.
-Version 0.3.0 also preserves bounded binary attributes as raw owned records,
-reads V8L1/V8L2 part inventories without assigning units or geometry, and displays
-native cones/frusta and full ring tori. The updated exact V34 profile in
-`parasolid-core 0.3.1` removes the catalog requirement for qualified toroidal
-resources.
-
-Version 0.3.5 extends qualified millimetre frames and bounded
-native/saved geometry to V7L6/V7L7 and V8L1/V8L2/V8L3, including internal mirrors.
+Bounded binary attributes are preserved as raw owned records. The native viewer
+also displays qualified cones/frusta and full ring tori. The built-in exact V34
+profile covers qualified toroidal resources without an external catalog.
+
+Qualified millimetre frames and bounded native/saved geometry cover
+V7L6/V7L7 and V8L1/V8L2/V8L3, including internal mirrors.
 Signed occurrence orientation is separate from already placed geometry; see
 [mirror semantics](docs/parts.md#coordinate-frames-and-units). Explicit
 [external-reference resolution](docs/references.md) now composes qualified child

{icadkit-0.3.8 → icadkit-0.3.9}/README.md

@@ -4,31 +4,17 @@ A Rust-based Python reader for **iCAD SX `.icd` files**. Read saved part
 structure, coordinate frames, names and selected attributes; inspect native
 box/cylinder parameters; and extract embedded Parasolid geometry.
 
-Version **0.3.7** added:
-
-- [Saved final bodies](docs/saved-bodies.md) on rolling-ball blend surfaces
-  and on toroidal faces that reach their axis, through `parasolid-core 0.3.7`
-  and the `preview` extra pinned to `parasolid-kit[occt]==0.3.7`. The local
-  sample rises from 28,896 to 29,386 of 29,703 bound bodies, with the
-  previously converted bodies unchanged.
-- One declaration per backend version (`Cargo.toml`, `pyproject.toml`); the
-  runtime checks of the backend version are gone.
-
-Version 0.3.6 added [saved final bodies](docs/saved-bodies.md) on spun
-surfaces (SPUN_SURF), line/arc profile extrusions as [CSG](docs/csg.md)
-operands and decoded surface and edge items of the
-[trailing container](docs/trailer.md).
-
-Version 0.3.5 added [view inventories and saved 2D geometry](docs/drawing.md),
-twenty-six further catalog-free [schema keys](docs/support.md#schemas), the
-[trailing container](docs/trailer.md), saved final bodies bound through V8
-association records and V7 source IDs, more [native primitives](docs/native.md),
-[saved 3D parameter tables](docs/parameters.md) and explicit
-[external-reference resolution](docs/references.md).
-
-Version 0.3.0 added the [native file viewer](docs/viewer.md), broader
-[part access](docs/parts.md), optional [V7L7 boolean evaluation](docs/csg.md)
-and [saved final body display](docs/saved-bodies.md).
+Supported workflows include:
+
+- [Part access](docs/parts.md), [saved 3D parameter tables](docs/parameters.md)
+  and explicit [external-reference resolution](docs/references.md).
+- [View inventories and saved 2D geometry](docs/drawing.md), plus decoded
+  surface and edge items of the [trailing container](docs/trailer.md).
+- The [native file viewer](docs/viewer.md) for qualified
+  [native primitives](docs/native.md) and their part properties.
+- Optional [V7L7 boolean evaluation](docs/csg.md) and
+  [saved final body display](docs/saved-bodies.md), including qualified spun,
+  rolling-ball blend and toroidal surfaces.
 
 icadkit is experimental. Unsupported geometry remains in the part inventory;
 unknown values and source ranges are preserved. Part frames, native primitive
@@ -68,21 +54,24 @@ from it, and `icadkit.__version__` / the CLI use the installed package metadata.
 With Python 3.11+, Cargo and uv available, update it with one command:
 
 ```sh
-python3 scripts/bump_version.py 0.3.8
-python3 scripts/bump_version.py --check --tag v0.3.8
+python3 scripts/bump_version.py X.Y.Z
+python3 scripts/bump_version.py --check --tag vX.Y.Z
 ```
 
-The version above is an example. The command updates the workspace version,
-synchronizes `Cargo.lock` and `uv.lock`, and checks their consistency. On failure
-it restores all three files. Add `--offline` to use cached dependencies. Stable
+Replace `X.Y.Z` with the intended release number. The command updates the
+workspace version, synchronizes `Cargo.lock` and `uv.lock`, and checks their
+consistency. On failure it restores all three files. Add `--offline` to use
+cached dependencies. Stable
 `X.Y.Z` and development `X.Y.Z-dev.N` versions are supported; Python metadata
 uses `X.Y.Z.devN` for the latter. `--check` does not modify the source or locks.
 CI checks the same rules and requires release tags to match the source version.
 
-The `parasolid-core` and `parasolid-kit` dependency pins have their own versions
-and are updated separately. Historical versions in this README and the
-[changelog](docs/changelog.md) describe when features were introduced; retain
-those numbers and write new release notes when preparing a release.
+Use `icadkit --version` to check the installed package version and `icadkit info`
+to inspect its backend version. The `parasolid-core` and `parasolid-kit`
+dependency pins have their own versions and are updated separately.
+Usage guides describe capabilities without repeating the package version.
+Record version-specific changes in the [changelog](docs/changelog.md); retain
+the release numbers attached to historical notes and validation results.
 
 ## Part structure, frames and attributes
 
@@ -116,14 +105,12 @@ spherical, conical and toroidal surfaces. V8L3 resource sharing preserves each
 occurrence's saved placement. An explicit schema catalog is needed when the
 exact built-in profile lacks a required type. Counted metadata framing also
 extends part inventories while preserving unknown records and diagnostics.
-Version 0.3.0 also preserves bounded binary attributes as raw owned records,
-reads V8L1/V8L2 part inventories without assigning units or geometry, and displays
-native cones/frusta and full ring tori. The updated exact V34 profile in
-`parasolid-core 0.3.1` removes the catalog requirement for qualified toroidal
-resources.
-
-Version 0.3.5 extends qualified millimetre frames and bounded
-native/saved geometry to V7L6/V7L7 and V8L1/V8L2/V8L3, including internal mirrors.
+Bounded binary attributes are preserved as raw owned records. The native viewer
+also displays qualified cones/frusta and full ring tori. The built-in exact V34
+profile covers qualified toroidal resources without an external catalog.
+
+Qualified millimetre frames and bounded native/saved geometry cover
+V7L6/V7L7 and V8L1/V8L2/V8L3, including internal mirrors.
 Signed occurrence orientation is separate from already placed geometry; see
 [mirror semantics](docs/parts.md#coordinate-frames-and-units). Explicit
 [external-reference resolution](docs/references.md) now composes qualified child

{icadkit-0.3.8 → icadkit-0.3.9}/docs/api.md

@@ -8,8 +8,8 @@ and model boundaries, see [supported capabilities](support.md).
 
 The public Python interface consists of the names in `icadkit.__all__` and
 the documented names in the optional [icadkit.preview module](preview.md).
-Version 0.3.0 also exposes [icadkit.viewer](viewer.md) for native
-qualified analytic primitive display and part/property inspection without optional dependencies.
+The [icadkit.viewer module](viewer.md) displays qualified native analytic
+primitives and provides part/property inspection without optional dependencies.
 `icadkit._core`, native handles and attributes beginning with `_` are private.
 Within a minor release series, existing arguments, result fields, diagnostic codes, coordinate
 semantics and CLI exit codes are preserved. Message wording and human-readable
@@ -20,25 +20,26 @@ Removing existing fields or changing their meanings requires a schema version
 change. A `complete` status always refers to an explicit scope, not the whole
 ICD model.
 
-Version 0.2.0 adds [native part access](parts.md) through
-`Document.read_parts()`, returning `PartIndex`, `Part`, `PartDefinition`,
-`PartReference`, `PartPlacement` and `PartProperty`. Version 0.3.0 adds
-`PartOpaqueAttribute` for retained binary attribute records. It exposes qualified part
-frames and selected stored attributes. Its scope statuses are independent of
+[Native part access](parts.md) uses `Document.read_parts()`, returning
+`PartIndex`, `Part`, `PartDefinition`, `PartReference`, `PartPlacement` and
+`PartProperty`, with `PartOpaqueAttribute` for retained binary attribute records.
+The part API exposes qualified part frames and selected stored attributes.
+Its scope statuses are independent of
 the resource geometry API described below. Saved entities expose
 `NativeEntity`, `NativeAppearance` and `NativePrimitive`; see
 [native parameter and appearance access](native.md).
-Version 0.3.5 adds [saved 3D parameter tables](parameters.md) through
+[Saved 3D parameter tables](parameters.md) are available through
 `Document.read_parameters()`, returning `ParameterIndex`, `SavedParameter`,
 `ParameterCondition` and `ParameterTable`, with `ParameterLimits` for bounded
 allocation. These saved formulas and values are independent of primitive geometry.
-It adds [views and saved 2D entities](drawing.md):
-`Document.read_views()` returns `ViewIndex`, `View` and `ViewEntry`, bounded by
+For [views and saved 2D entities](drawing.md),
+`Document.read_views()` returns `ViewIndex`, `View`, `ViewEntry` and `ViewPlacement`
+(the [sheet placement](drawing.md#view-placement-on-the-sheet) of each 2D view), bounded by
 `ViewLimits`; `Document.read_drawing()` returns `DrawingIndex`, `DrawingEntity`,
 `DrawingPrimitive` and `DrawingText`, with `DrawingLimits`. The `views` and
 `drawing` CLI commands expose classification, scoped status and source ranges.
 These APIs do not combine 2D geometry with the native 3D part API.
-It also adds [explicit assembly resolution](references.md):
+[Explicit assembly resolution](references.md) uses
 `read_assembly()` / `Document.read_assembly()`, `AssemblyLimits`, `ReferenceRequest`,
 `ReferenceResolver`, `AssemblyReference`, `AssemblyDocument`, `AssemblyOccurrence`,
 `AssemblyEntity` and `AssemblyIndex`. `read_parts()` retains its single-file
@@ -103,7 +104,15 @@ returns its byte length. `RecordInfo.payload_range` excludes the eight-byte
 opening tag/length and four-byte closing tag. A valid range does not imply that
 its contents or references have been interpreted.
 
-`Header.raw_version` is not converted to an iCAD product version.
+`Header.raw_version` is not converted to an iCAD product version by the native
+reader. `Header.version_label` (`V8L3`) and `Header.version` (`(8, 3)`) read the
+observed `00 major 00 level` layout of those bytes in either byte order, and
+`None` for any other layout; `icadkit.version_label(raw)` is the same function.
+A label is the version as saved, not a support claim: `icadkit.qualified_versions()`
+returns a `VersionSupport` with the labels each scope has been qualified for
+(`parts`, `views_little`, `views_big`, `drawing_layout`, and `views(byte_order)`),
+so a caller can say that a `V8L4` file is unqualified before any scope reports
+its `*.profile` diagnostic. `icadkit inspect --json` includes `version_label`.
 `raw_name` preserves padding. `name_cp932_candidate` removes trailing spaces
 and NULs, then strictly decodes CP932. Interior NULs remain. A decoding failure
 returns `None` and `header.name_decode_failed`, retaining the original bytes.

{icadkit-0.3.8 → icadkit-0.3.9}/docs/changelog.md

@@ -4,6 +4,23 @@
 
 ### Added
 
+- `View.placement` and `ViewIndex.placements` decode the 264-byte control
+  records of the 2D global view as `ViewPlacement`: the view origin on the
+  sheet (millimetres of the 2D global view), the view scale, the saved record
+  identifier and the 2D view name, in the file byte order. Records are matched
+  to `2d_view` entries by name; `views.placement`, `views.placement_view`,
+  `views.placement_ambiguous` and `views.placement_missing` report deviating
+  records, records without a view, repeated names and views without a record.
+  Geometry stays view-local; see [view placement](drawing.md#view-placement-on-the-sheet).
+  In the installed corpus 817 of 855 2D views have a record and every one
+  agrees with the view header's scale.
+- `Header.version_label` (`V8L3`), `Header.version` (`(8, 3)`),
+  `icadkit.version_label()` and `icadkit.qualified_versions()`
+  (`VersionSupport`) name the saved product version and the versions each
+  scope is qualified for, so an unqualified version such as `V8L4` can be
+  reported before its `*.profile` diagnostics. `icadkit inspect --json` adds
+  `version_label`.
+
 - `Document.to_bytes()` serializes the directory-indexed container with its
   framing recomputed (directory offsets and lengths, `RES`/`V/W` length
   words, the MOD total-word field) while unknown fields, record payloads, the
@@ -90,6 +107,9 @@
   CI checks crate inheritance, dynamic Python metadata, lock versions and
   release tags. Dependency versions and historical release notes remain
   independent of the package version.
+- README and usage guides describe capabilities without repeating the package
+  release number. Version-update examples use placeholders; historical release
+  notes and validation results retain the versions they describe.
 - The authored framing fixtures (`tests/fixture_builders.py`, the public
   corpus) now store the MOD total-word count the way every observed iCAD
   file does, so `corpus/public.jsonl` pins new hashes for the same eight

{icadkit-0.3.8 → icadkit-0.3.9}/docs/csg.md

@@ -1,6 +1,6 @@
 # Bounded V7L7 CSG
 
-Version 0.3.0 reads selected saved V7L7 final-body programs.
+The CSG API reads selected saved V7L7 final-body programs.
 `read_csg()` is dependency-free. `evaluate_csg()` uses the optional `preview`
 extra to evaluate analytic solids with OCCT and generate a display mesh.
 This is partial model support; it does not reconstruct feature history or
@@ -41,12 +41,12 @@ not interpret those feature operations.
 - Saved postfix union, difference and intersection of positive-height boxes and
   cylinders, including the qualified saved checkpoints between operations.
   Multiple independent owners and disconnected solid results are supported.
-- Version 0.3.5 also accepts six-vertex prism operands: a frame, a signed
+- Six-vertex prism operands: a frame, a signed
   height along its Z axis and six XY vertices of a strictly convex profile. A
   negative height moves the base along the axis; the frame stays rigid and the
   profile is used as saved. The operand is exposed as a `polygon_extrusion`
   primitive with `profile_points`. Other profiles are `csg.operand_layout`.
-- Version 0.3.6 also accepts profile extrusion operands: the
+- Profile extrusion operands: the
   variable-length line/arc layout of [native primitives](native.md), with a
   frame, a signed height and a closed profile decoded by the same core rules as
   a standalone record. A negative height moves the base along the axis, as for

{icadkit-0.3.8 → icadkit-0.3.9}/docs/drawing.md

@@ -1,7 +1,7 @@
 # Views and saved 2D entities
 
-Version 0.3.5 adds `Document.read_views()` and `Document.read_drawing()`.
-Both read originals directly, including registered part files. No iCAD process,
+`Document.read_views()` and `Document.read_drawing()` read originals directly,
+including registered part files. No iCAD process,
 resave, optional geometry package or schema catalog is needed.
 
 ```python
@@ -80,6 +80,41 @@ Their numeric links and optional name bytes remain opaque `metadata` with no
 owner or geometry assigned. Local checks traverse the ten previously stopped
 files; this does not qualify legacy assembly or external-reference semantics.
 
+## View placement on the sheet
+
+The 2D global view stores one fixed-length control record per 2D view after
+its entity group: a `0x40000000` marker followed by 264-byte records. The
+reader decodes them as `ViewPlacement` (the `placements` of the `ViewIndex`)
+and attaches each record to the `2d_view` whose name it carries
+(`View.placement`). Nothing is applied to the entities: `read_drawing()` keeps
+view-local millimetres, and a caller composes the sheet by scaling a view's
+geometry by `placement.scale` and translating it to `placement.origin`.
+
+| Field | Record offset | Meaning |
+| --- | --- | --- |
+| `source_id` | `+16` (u32) | The saved record identifier |
+| `origin` | `+40`, `+48` (two doubles) | The view origin on the sheet, in millimetres of the 2D global view; the third double at `+56` is retained raw |
+| `scale` | `+64` (double) | The view scale; it equals the view header's `scale` in every observed file |
+| `raw_name` / `name` | `+136` (8 bytes, CP932) | The 2D view the record belongs to |
+
+Numeric values follow the file byte order. The length word at `+0`, a finite
+origin and a positive scale make a record `complete`; a deviating value keeps
+the record with `views.placement` diagnostics and `status="invalid"`, and an
+invalid scale is reported as `None`. The other words (`+12`, `+24`–`+40`,
+`+72`–`+136` and `+144`–`+264`, including the six floats at `+176` that are not
+a view extent in saved files) retain their bytes without an assigned meaning.
+Records that name no 2D view add `views.placement_view`, several records with
+one name add `views.placement_ambiguous` and map to no view, and a 2D view
+without a record adds `views.placement_missing`; these diagnostics do not
+change the index status, which describes framing only. `DrawingWriter` writes
+the same record for each view it adds.
+
+In the installed corpus (1,449 distinct files), 701 documents have a 2D global
+view (316 big-endian, 385 little-endian), all of them with a placement list:
+818 records are complete, 817 of the 855 2D views have a record and every one
+of those agrees with the view header's scale; 38 views have no record and one
+record names no 2D view.
+
 ## Drawing scope
 
 `DrawingIndex` contains the view inventory and bounded 2D `DrawingEntity` records.
@@ -161,7 +196,7 @@ spacing. Point lists that do not close, unobserved item words or nonpositive
 lengths keep the entity `partial` with `drawing.hatch_boundary` or
 `drawing.hatch_fields`.
 
-Geometry uses **view-local millimetres**. It does not apply paper placement,
+Geometry uses **view-local millimetres**. It does not apply the [view placement](#view-placement-on-the-sheet),
 view rotation, scale or a 3D projection transform. Saved line/circle records in
 a projected view can be read independently of the unimplemented projection
 relationship. Fonts, glyph outlines, tilt and legacy CP932 text runs remain unqualified;

{icadkit-0.3.8 → icadkit-0.3.9}/docs/native.md

@@ -4,13 +4,13 @@ For qualified V7L7 final boolean bodies, use the separate [CSG API](csg.md)
 or `view --csg` with the `preview` extra. The native-primitive scope described
 here keeps operands opaque.
 
-Version **0.2.0** adds saved native entities to `Document.read_parts()`.
+`Document.read_parts()` exposes saved native entities.
 It reads qualified V8L3 boxes and cylinders, and selected stored appearance
 fields. It does not evaluate native B-Rep, CSG, tessellation or a complete scene.
 
-The 0.3.0 [native viewer](viewer.md) can tessellate the supported
+The [native viewer](viewer.md) can tessellate the supported
 box/cylinder/full-sphere/cone/torus parameters for an explicitly partial display with a part tree.
-Version 0.3.5 also decodes qualified V7L6/V7L7/V8L1/V8L2 standalone primitive
+The reader also decodes qualified V7L6/V7L7/V8L1/V8L2 standalone primitive
 owners and saved entity appearance. These profiles require a complete saved hierarchy/index and
 an entire internal owner's list of qualified primitive
 headers. An unknown or CSG record keeps the whole owner's list opaque; primitive
@@ -55,8 +55,8 @@ from that entity to `Document.resources` is inferred.
 
 ## Primitive contract
 
-In version 0.3.0, `NativePrimitive.kind` is `box`, `cylinder`, `sphere`,
-`cone` or `torus`.
+`NativePrimitive.kind` is `box`, `cylinder`, `sphere`, `cone`, `torus`,
+`polygon_extrusion`, `profile_extrusion` or `revolution`.
 The qualified layout retains:
 
 | Field | Box | Cylinder |
@@ -82,8 +82,8 @@ axis of revolution. `radius` and `height` are `None`. Partial sweeps, horn/spind
 tori and unknown extents remain unsupported. These added fields are `None` for
 other primitive kinds. Boxes remain the only kind with non-null box bounds.
 
-The `polygon_extrusion` kind, added in 0.3.5, exposes six distinct XY vertices in
-`profile_points` and a positive `height`. Its qualified 368-byte record stores
+The `polygon_extrusion` kind exposes six distinct XY vertices in `profile_points`
+and a positive `height`. Its qualified 368-byte record stores
 two identical closed straight profiles and a zero trailer. Concave and convex
 simple polygons are accepted in either winding. The viewer triangulates both
 caps and preserves outward winding. Mirrored records with the qualified negative
@@ -232,7 +232,7 @@ Incorrect unit scaling, repeated part transforms and transposed rotation are
 negative controls. CAD files, SDK binaries and vendor catalogs are not distributed;
 public tests use independently authored synthetic records and malformed inputs.
 
-For the 0.3.5 cylinder sign, profile extrusion and revolution layouts,
+For the cylinder sign, profile extrusion and revolution layouts,
 saved SDK observations match volume, area and centroid for 290 negative-height
 cylinders (30 of them mirrored), 83 profile extrusions (19 mirrored) and 133
 revolutions (58 mirrored). In a local sample all 6,638 extrusion records of this
@@ -244,7 +244,7 @@ inputs; the [CSG reader](csg.md) decodes them as operands. A profile extrusion
 that is the only record of a saved single-leaf body is likewise read by the CSG
 reader, with the same profile rules, and not by this inventory.
 
-The v0.3 additions have offline checks against saved/reopened SDK
+Cone/frustum/torus support has offline checks against saved/reopened SDK
 observations for ten cone/frustum/torus files, including oblique and dimension
 holdouts in V7L7/V8L3. Analytic volume, surface area, centroid and stored appearance
 match; this is not a fresh SDK run or native older-product qualification.

{icadkit-0.3.8 → icadkit-0.3.9}/docs/parts.md

@@ -1,6 +1,6 @@
 # Native parts
 
-The big-endian V6L1/V6L2/V7L1 `61000001` profiles added in 0.3.5 provide internal
+The big-endian V6L1/V6L2/V7L1 `61000001` profiles provide internal
 part inventories, names/comments and bounded hierarchy links. Both coordinate
 blocks are retained as raw values; `entity_policy=inventory_only`,
 `coordinate_convention=unqualified` and `source_length_unit=None` prevent
@@ -24,7 +24,6 @@ For qualified V7L7 final boolean bodies, use the separate [CSG API](csg.md)
 or `view --csg` with the `preview` extra. The native-primitive scope described
 here keeps operands opaque.
 
-Added in **0.2.0**.
 Read saved part structure, coordinate frames, names, comments and selected
 extended information without installing iCAD or a geometry schema catalog.
 
@@ -67,7 +66,7 @@ remains `unknown`: no saved discriminator between a normal document and a
 registered library part has been qualified. Names and filename suffixes are not
 used to infer this distinction.
 
-Version 0.3.5 reads observed little-endian V7L2–V7L7 and V8L1–V8L3
+The reader supports observed little-endian V7L2–V7L7 and V8L1–V8L3
 `3DGLOBAL` layouts. Each version has an explicit profile and tag check:
 V7L2–V7L5 require `0x61000001`, V7L6/V7L7 require `0x61000002`, and V8 profiles
 require `0x61000003`. Unknown layouts stop with source ranges and diagnostics.

{icadkit-0.3.8 → icadkit-0.3.9}/docs/preview.md

@@ -1,11 +1,11 @@
 # Resource preview and GLB
 
 For files containing native boxes/cylinders, use the separate
-[native file viewer](viewer.md), added in version 0.3.0.
+[native file viewer](viewer.md).
 It displays the native global frames and part tree without the preview extra.
 
-The preview API, introduced in 0.2.0, renders one selected embedded Parasolid resource and
-write a GLB plus an offline browser viewer. Install the optional dependencies:
+The preview API renders one selected embedded Parasolid resource and writes
+a GLB plus an offline browser viewer. Install the optional dependencies:
 
 ```sh
 python -m pip install 'icadkit[preview]'

{icadkit-0.3.8 → icadkit-0.3.9}/docs/saved-bodies.md

@@ -1,7 +1,7 @@
 # Saved final bodies
 
-Version 0.3.5 supports qualified V7L6/V7L7 and V8L1/V8L2/V8L3 display paths using saved final
-B-Rep solids. This displays the saved result without replaying feature history.
+The saved-body viewer supports qualified V7L6/V7L7 and V8L1/V8L2/V8L3 display
+paths using saved final B-Rep solids. This displays the saved result without replaying feature history.
 It is separate from `--csg` and does not claim support for unknown CSG operations.
 
 ```sh
@@ -102,7 +102,7 @@ containing those surfaces. Faces require explicit boundary loops. A conical
 face that ends in its apex is stored with a loop of one vertex and no edge; the
 adapter closes it with one degenerated boundary edge when that vertex lies at
 the cone's apex. Vertex loops elsewhere, on other surfaces, or as a face's only
-loop remain unsupported (`saved.half_edge`); version 0.3.7 also closes
+loop remain unsupported (`saved.half_edge`); the adapter also closes
 an apple, horn or lemon torus at its axis point the same way, with one
 degenerated edge per axis point. Intersection curves are rebuilt
 by the pinned adapter from their two support surfaces and saved chart points;
@@ -126,17 +126,15 @@ unqualified resource layouts, implicit external-file loading and complete featur
 history remain unsupported. Existing `--csg` evaluation remains separately scoped.
 
 An exact built-in schema profile can still lack a base type required by a
-resource. Such resources need the explicitly matching catalog. Version 0.3.0
-uses `parasolid-core 0.3.1` and exact V34 profile revision 2, which adds
-TORUS (54): qualified trimmed-torus and swept-arc solids no longer require a
-catalog. Other uncompiled types retain a diagnostic when no catalog is supplied.
-Catalogs are not bundled.
-
-Version 0.3.5 uses `parasolid-core 0.3.5`, which also supplies reviewed
-B-Rep mappings for [twenty-six further schema keys](support.md#schemas). This
-removes their catalog requirement within the qualified subsets. Since
-version 0.3.6 the backend maps SPUN_SURF as a surface of revolution; the
-adapter admits spun faces, closing a profile end on the spin axis with one
+resource. Such resources need the explicitly matching catalog. The exact V34
+profile includes TORUS (54): qualified trimmed-torus and swept-arc solids do not
+require a catalog. Other uncompiled types retain a diagnostic when no catalog
+is supplied. Catalogs are not bundled.
+
+The pinned `parasolid-core` backend supplies reviewed B-Rep mappings for
+[the built-in schema keys](support.md#schemas), allowing catalog-free reads
+within their qualified subsets. The backend maps SPUN_SURF as a surface of
+revolution; the adapter admits spun faces, closing a profile end on the spin axis with one
 degenerated edge like a cone apex
 (`degenerated_spun_axis_boundary`), see the
 [roadmap](roadmap.md#version-036-spun-surfaces). Offset surfaces are read but
@@ -196,6 +194,8 @@ unqualified, so bodies under a mirrored owner are not bound there.
 
 ## Local evidence for bindings and conversion
 
+The conversion results below are historical measurements for the named releases.
+
 In a local sample of 305 V8 files with numbered resources, every one of 28,685
 indexed resources is named by an association record and every final marker has
 exactly one; 27,118 marker frames equal their association frames byte for byte,
@@ -205,8 +205,8 @@ bind and 2,670 bodies now bind to a different resource. For every one of 6,059
 evaluated bodies the saved [per-entity box](trailer.md) contains the solid in
 its local frame, and it is tight for 6,040 of them.
 
-Of 29,703 distinct bound resources in the sample, 27,093 convert to valid
-solids. An explicit schema catalog is needed only where no built-in profile
+The version 0.3.5 checks convert 27,093 of the sample's 29,703 distinct bound
+resources to valid solids. An explicit schema catalog is needed only where no built-in profile
 applies: for six of these resources, compared with 27,796 under core 0.3.3.
 Results agree with the catalog path, except that 253 resources whose line trims
 store unset parameters are now mapped; 168 of them convert. The others keep