icadkit 0.3.5__tar.gz → 0.3.7__tar.gz

{icadkit-0.3.5 → icadkit-0.3.7}/Cargo.lock

@@ -89,7 +89,7 @@ checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
 
 [[package]]
 name = "icad-core"
-version = "0.3.5"
+version = "0.3.7"
 dependencies = [
  "flate2",
  "parasolid-core",
@@ -99,7 +99,7 @@ dependencies = [
 
 [[package]]
 name = "icad-python"
-version = "0.3.5"
+version = "0.3.7"
 dependencies = [
  "icad-core",
  "parasolid-core",
@@ -142,9 +142,9 @@ checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
 
 [[package]]
 name = "parasolid-core"
-version = "0.3.5"
+version = "0.3.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ea19ba26c4ea0217f3f81dc5a5479239f92d43fc08bd6754d9f9f5ad74cf2c0a"
+checksum = "7ff3cbb9817406ac809cd989e47454deee4af89a30b57b436561b676f98af37e"
 
 [[package]]
 name = "portable-atomic"

{icadkit-0.3.5 → icadkit-0.3.7}/Cargo.toml

@@ -3,13 +3,13 @@ members = ["crates/icad-core", "crates/icad-python"]
 resolver = "3"
 
 [workspace.package]
-version = "0.3.5"
+version = "0.3.7"
 edition = "2024"
 rust-version = "1.88"
 license = "PolyForm-Noncommercial-1.0.0"
 
 [workspace.dependencies]
-parasolid-core = "=0.3.5"
+parasolid-core = "=0.3.7"
 pyo3 = { version = "=0.29.2", features = ["abi3-py310"] }
 flate2 = { version = "1", default-features = false, features = ["rust_backend"] }
 sha2 = "0.10"

{icadkit-0.3.5 → icadkit-0.3.7}/LICENSES/rust-dependencies.txt

@@ -134,7 +134,7 @@ IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
 DEALINGS IN THE SOFTWARE.
 
 
-=== parasolid-core 0.3.5 (MIT AND Apache-2.0) ===
+=== parasolid-core 0.3.7 (MIT AND Apache-2.0) ===
 MIT License
 
 Copyright (c) 2026 parasolid-kit contributors

{icadkit-0.3.5 → icadkit-0.3.7}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: icadkit
-Version: 0.3.5
+Version: 0.3.7
 Classifier: Development Status :: 2 - Pre-Alpha
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Rust
 Classifier: Typing :: Typed
-Requires-Dist: parasolid-kit[occt]==0.2.0 ; extra == 'preview'
+Requires-Dist: parasolid-kit[occt]==0.3.7 ; extra == 'preview'
 Provides-Extra: preview
 License-File: LICENSE
 License-File: COMMERCIAL-LICENSE.md
@@ -32,27 +32,27 @@ 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.5** adds:
-
-- [View inventories and saved 2D geometry](docs/drawing.md) through
-  `read_views()` / `read_drawing()` and the `views` / `drawing` CLI commands.
-  Old originals and registered parts are read directly. Qualified 2D primitives
-  use view-local coordinates; text content is separate from unsupported layout.
-- Catalog-free raw parsing and source B-Rep mapping of
-  [twenty-six further exact iCAD schema keys](docs/support.md#schemas) through
-  `parasolid-core 0.3.5`. SPUN_SURF geometry remains partial; saved-body
-  conversion has separate limits.
-- The [trailing container](docs/trailer.md): per-entity blocks with stored
-  local bounds and the identity of their faces and edges (`read_trailer()`,
-  `icadkit trailer`).
-- [Saved final bodies](docs/saved-bodies.md) bound through saved association
-  records in V8 and by source ID in V7L2–V7L5, and converted with elliptical
-  edges, intersection curves and cone apexes.
-- More [native primitives](docs/native.md): polygon extrusions, extrusions with
-  arc profiles, revolved profiles and signed heights, in V7L6/V7L7 and
-  V8L1/V8L2/V8L3, including internal mirrors.
-- [Saved 3D parameter tables](docs/parameters.md) and explicit
-  [external-reference resolution](docs/references.md).
+Version **0.3.7** adds:
+
+- [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)
@@ -73,7 +73,7 @@ The base reader supports standard GIL-enabled CPython 3.10–3.14. Wheel targets
 are Linux x86_64 (glibc 2.28+), Windows x86_64 and macOS ARM64 (11+):
 
 ```sh
-python -m pip install icadkit==0.3.5
+python -m pip install icadkit
 ```
 
 The native extension bundles `parasolid-core` and has no mandatory Python
@@ -82,7 +82,7 @@ explicit compatible catalog is needed only for schemas absent from the built-in
 profiles. Release files are available on the
 [GitHub releases page](https://github.com/monozukuri-ai/icadkit/releases).
 
-For preview/GLB, install `python -m pip install 'icadkit[preview]==0.3.5'`.
+For preview/GLB, install `python -m pip install 'icadkit[preview]'`.
 The optional OCCT dependency requires glibc 2.31+ on Linux; see
 [preview requirements](docs/preview.md#dependencies-and-validation).
 To build from a source checkout or sdist, install Rust 1.88+ and a C linker,
@@ -111,8 +111,9 @@ Qualified V7L7 part frames use millimetres and are evaluated relative to the
 saved root frame. Qualified standalone primitive owners also expose geometry and saved
 entity appearance. The separate [CSG API](docs/csg.md) and
 `uv run --extra preview icadkit view model.icd --csg` evaluate qualified
-box/cylinder unions, differences and intersections. Unknown programs retain
-diagnostics without substitute geometry.
+unions, differences and intersections of boxes, cylinders, prisms and profile
+extrusions, including saved single-leaf extrusion bodies. Unknown programs
+retain diagnostics without substitute geometry.
 The [saved final body mode](docs/saved-bodies.md), `view --saved-brep`, also
 displays qualified V7L7/V8L3 final bodies and imported solids, including bounded
 spherical, conical and toroidal surfaces. V8L3 resource sharing preserves each

{icadkit-0.3.5 → icadkit-0.3.7}/README.md

@@ -4,27 +4,27 @@ 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.5** adds:
-
-- [View inventories and saved 2D geometry](docs/drawing.md) through
-  `read_views()` / `read_drawing()` and the `views` / `drawing` CLI commands.
-  Old originals and registered parts are read directly. Qualified 2D primitives
-  use view-local coordinates; text content is separate from unsupported layout.
-- Catalog-free raw parsing and source B-Rep mapping of
-  [twenty-six further exact iCAD schema keys](docs/support.md#schemas) through
-  `parasolid-core 0.3.5`. SPUN_SURF geometry remains partial; saved-body
-  conversion has separate limits.
-- The [trailing container](docs/trailer.md): per-entity blocks with stored
-  local bounds and the identity of their faces and edges (`read_trailer()`,
-  `icadkit trailer`).
-- [Saved final bodies](docs/saved-bodies.md) bound through saved association
-  records in V8 and by source ID in V7L2–V7L5, and converted with elliptical
-  edges, intersection curves and cone apexes.
-- More [native primitives](docs/native.md): polygon extrusions, extrusions with
-  arc profiles, revolved profiles and signed heights, in V7L6/V7L7 and
-  V8L1/V8L2/V8L3, including internal mirrors.
-- [Saved 3D parameter tables](docs/parameters.md) and explicit
-  [external-reference resolution](docs/references.md).
+Version **0.3.7** adds:
+
+- [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)
@@ -45,7 +45,7 @@ The base reader supports standard GIL-enabled CPython 3.10–3.14. Wheel targets
 are Linux x86_64 (glibc 2.28+), Windows x86_64 and macOS ARM64 (11+):
 
 ```sh
-python -m pip install icadkit==0.3.5
+python -m pip install icadkit
 ```
 
 The native extension bundles `parasolid-core` and has no mandatory Python
@@ -54,7 +54,7 @@ explicit compatible catalog is needed only for schemas absent from the built-in
 profiles. Release files are available on the
 [GitHub releases page](https://github.com/monozukuri-ai/icadkit/releases).
 
-For preview/GLB, install `python -m pip install 'icadkit[preview]==0.3.5'`.
+For preview/GLB, install `python -m pip install 'icadkit[preview]'`.
 The optional OCCT dependency requires glibc 2.31+ on Linux; see
 [preview requirements](docs/preview.md#dependencies-and-validation).
 To build from a source checkout or sdist, install Rust 1.88+ and a C linker,
@@ -83,8 +83,9 @@ Qualified V7L7 part frames use millimetres and are evaluated relative to the
 saved root frame. Qualified standalone primitive owners also expose geometry and saved
 entity appearance. The separate [CSG API](docs/csg.md) and
 `uv run --extra preview icadkit view model.icd --csg` evaluate qualified
-box/cylinder unions, differences and intersections. Unknown programs retain
-diagnostics without substitute geometry.
+unions, differences and intersections of boxes, cylinders, prisms and profile
+extrusions, including saved single-leaf extrusion bodies. Unknown programs
+retain diagnostics without substitute geometry.
 The [saved final body mode](docs/saved-bodies.md), `view --saved-brep`, also
 displays qualified V7L7/V8L3 final bodies and imported solids, including bounded
 spherical, conical and toroidal surfaces. V8L3 resource sharing preserves each

{icadkit-0.3.5 → icadkit-0.3.7}/THIRD_PARTY_NOTICES.md

@@ -4,8 +4,9 @@ icadkit project material is offered under PolyForm Noncommercial 1.0.0, with sep
 commercial licensing available from UnRobotics Inc.
 See `LICENSE` and `COMMERCIAL-LICENSE.md`.
 
-Binary distributions also contain `parasolid-core 0.3.5` (MIT AND Apache-2.0)
-and PyO3 (MIT OR Apache-2.0, MIT selected). The source metadata declares
+Binary distributions also contain `parasolid-core` (MIT AND Apache-2.0; the
+exact version is listed in `LICENSES/rust-dependencies.txt`) and PyO3 (MIT OR
+Apache-2.0, MIT selected). The source metadata declares
 `PolyForm-Noncommercial-1.0.0`; the combined Python distribution declares
 `PolyForm-Noncommercial-1.0.0 AND MIT AND Apache-2.0`. These expressions describe
 different portions of the package, not a choice to use all icadkit material
@@ -25,9 +26,10 @@ under MIT or Apache-2.0. Third-party components are not relicensed.
   for project-authored material. Their V30 scalar layouts derive from the
   MIT/Apache-2.0 `parasolid-core` profile; see `tests/geometry_fixtures.py`
   for attribution.
-- The optional `preview` extra installs `parasolid-kit[occt] 0.2.0` and its
-  separately distributed OCCT runtime dependencies. These are not bundled in
-  the icadkit wheel. Their own distributions retain their license terms.
+- The optional `preview` extra installs the `parasolid-kit[occt]` release
+  pinned in `pyproject.toml` and its separately distributed OCCT runtime
+  dependencies. These are not bundled in the icadkit wheel. Their own
+  distributions retain their license terms.
   Generated viewer directories copy that package's browser assets and retain
   the included MIT/Zlib notices and the n8ao ISC metadata / CC0-1.0 license-text
   discrepancy. Keep those notices when redistributing generated viewers.

{icadkit-0.3.5 → icadkit-0.3.7}/crates/icad-core/LICENSE

@@ -1,4 +1,4 @@
-Generated by scripts/check_license.py --write-crate-notices.
+Generated by scripts/check_license.py --write.
 Canonical source notices follow; paths refer to the source root.
 
 ===== LICENSE =====
@@ -108,8 +108,9 @@ icadkit project material is offered under PolyForm Noncommercial 1.0.0, with sep
 commercial licensing available from UnRobotics Inc.
 See `LICENSE` and `COMMERCIAL-LICENSE.md`.
 
-Binary distributions also contain `parasolid-core 0.3.5` (MIT AND Apache-2.0)
-and PyO3 (MIT OR Apache-2.0, MIT selected). The source metadata declares
+Binary distributions also contain `parasolid-core` (MIT AND Apache-2.0; the
+exact version is listed in `LICENSES/rust-dependencies.txt`) and PyO3 (MIT OR
+Apache-2.0, MIT selected). The source metadata declares
 `PolyForm-Noncommercial-1.0.0`; the combined Python distribution declares
 `PolyForm-Noncommercial-1.0.0 AND MIT AND Apache-2.0`. These expressions describe
 different portions of the package, not a choice to use all icadkit material
@@ -129,9 +130,10 @@ under MIT or Apache-2.0. Third-party components are not relicensed.
   for project-authored material. Their V30 scalar layouts derive from the
   MIT/Apache-2.0 `parasolid-core` profile; see `tests/geometry_fixtures.py`
   for attribution.
-- The optional `preview` extra installs `parasolid-kit[occt] 0.2.0` and its
-  separately distributed OCCT runtime dependencies. These are not bundled in
-  the icadkit wheel. Their own distributions retain their license terms.
+- The optional `preview` extra installs the `parasolid-kit[occt]` release
+  pinned in `pyproject.toml` and its separately distributed OCCT runtime
+  dependencies. These are not bundled in the icadkit wheel. Their own
+  distributions retain their license terms.
   Generated viewer directories copy that package's browser assets and retain
   the included MIT/Zlib notices and the n8ao ISC metadata / CC0-1.0 license-text
   discrepancy. Keep those notices when redistributing generated viewers.
@@ -582,7 +584,7 @@ IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
 DEALINGS IN THE SOFTWARE.
 
 
-=== parasolid-core 0.3.5 (MIT AND Apache-2.0) ===
+=== parasolid-core 0.3.7 (MIT AND Apache-2.0) ===
 MIT License
 
 Copyright (c) 2026 parasolid-kit contributors

icadkit-0.3.7/crates/icad-core/build.rs

@@ -0,0 +1,49 @@
+//! Records the resolved `parasolid-core` version from the workspace lock file.
+//!
+//! The crate reports which backend release it was compiled with
+//! (`PARASOLID_CORE_VERSION`). Reading it from `Cargo.lock` keeps the manifest
+//! pin the only place in the source that names that version.
+
+use std::env;
+use std::fs;
+use std::path::{Path, PathBuf};
+
+fn main() -> Result<(), String> {
+    let manifest_dir = env::var_os("CARGO_MANIFEST_DIR").ok_or("CARGO_MANIFEST_DIR is not set")?;
+    let lock = PathBuf::from(manifest_dir)
+        .ancestors()
+        .map(|dir| dir.join("Cargo.lock"))
+        .find(|path| path.is_file())
+        .ok_or("no Cargo.lock above the crate directory")?;
+    let version = resolved_version(&lock, "parasolid-core")?;
+    println!("cargo:rerun-if-changed={}", lock.display());
+    println!("cargo:rustc-env=ICAD_PARASOLID_CORE_VERSION={version}");
+    Ok(())
+}
+
+/// The version of `package` in the lock file, which must resolve it exactly once.
+fn resolved_version(lock: &Path, package: &str) -> Result<String, String> {
+    let text = fs::read_to_string(lock)
+        .map_err(|error| format!("cannot read {}: {error}", lock.display()))?;
+    let mut versions = Vec::new();
+    let mut name = None;
+    for line in text.lines().map(str::trim) {
+        if line == "[[package]]" {
+            name = None;
+        } else if let Some(value) = line.strip_prefix("name = ") {
+            name = Some(value.trim_matches('"'));
+        } else if let Some(value) = line.strip_prefix("version = ")
+            && name == Some(package)
+        {
+            versions.push(value.trim_matches('"').to_owned());
+        }
+    }
+    match versions.as_slice() {
+        [version] => Ok(version.clone()),
+        [] => Err(format!("{package} is not resolved in {}", lock.display())),
+        _ => Err(format!(
+            "{package} resolves to several versions in {}",
+            lock.display()
+        )),
+    }
+}

{icadkit-0.3.5 → icadkit-0.3.7}/crates/icad-core/src/document.rs

@@ -592,4 +592,17 @@ impl Document {
         self.limits.resource(range.end - range.start, range.start)?;
         Ok(&self.data[range.start as usize..range.end as usize])
     }
+
+    /// Decode one saved boolean component record in place, without an owner
+    /// context. The caller has already framed the record and checks its saved
+    /// program, result backlink and root frame.
+    pub fn read_component(
+        &self,
+        range: ByteRange,
+    ) -> Result<crate::native::NativeEntityRecord, InspectError> {
+        Ok(crate::native::read_component_entity(
+            self.source_bytes(range)?,
+            range,
+        ))
+    }
 }

{icadkit-0.3.5 → icadkit-0.3.7}/crates/icad-core/src/lib.rs

@@ -38,7 +38,7 @@ pub use resource::{Encoding, ResourceAssociation, ResourceRef};
 pub use schema::SchemaCatalog;
 pub use trailer::{
     TrailerBlock, TrailerBlockData, TrailerEdge, TrailerFace, TrailerIndex, TrailerLimits,
-    TrailerTable, TrailerView,
+    TrailerParameterLine, TrailerSurface, TrailerTable, TrailerView,
 };
 pub use views::{ViewEntry, ViewIndex, ViewLimits, ViewRecord};
 
@@ -47,8 +47,8 @@ use parasolid_core::{BuiltinProfileRegistry, ParseError};
 /// Version of this Rust crate, in Cargo SemVer notation.
 pub const VERSION: &str = env!("CARGO_PKG_VERSION");
 
-/// Exact registry dependency; checked against the manifest and lock in CI.
-pub const PARASOLID_CORE_VERSION: &str = "0.3.5";
+/// Resolved registry version of the backend, read from `Cargo.lock` at build time.
+pub const PARASOLID_CORE_VERSION: &str = env!("ICAD_PARASOLID_CORE_VERSION");
 
 /// Metadata of the compiled Parasolid backend, not ICD format coverage.
 #[derive(Debug, Clone, PartialEq, Eq)]

{icadkit-0.3.5 → icadkit-0.3.7}/crates/icad-core/src/native.rs

@@ -139,6 +139,18 @@ pub(crate) fn read_parametric_entity(bytes: &[u8], byte_range: ByteRange) -> Nat
 }
 
 pub(crate) fn read_entity(bytes: &[u8], byte_range: ByteRange) -> NativeEntityRecord {
+    decode_entity(bytes, byte_range, false)
+}
+
+/// A component record of a saved boolean body: the standalone layout with the
+/// component bit set, an optional explicit-result bit, and a result backlink
+/// where a standalone record stores zero. The caller checks that backlink and
+/// the saved program; nothing here establishes a finished solid.
+pub(crate) fn read_component_entity(bytes: &[u8], byte_range: ByteRange) -> NativeEntityRecord {
+    decode_entity(bytes, byte_range, true)
+}
+
+fn decode_entity(bytes: &[u8], byte_range: ByteRange, component: bool) -> NativeEntityRecord {
     let mut result = undecoded_entity(bytes, byte_range);
     // Layer, saved visibility and palette index are qualified only for these
     // exact native layouts. A Parasolid body has a different attribute layout.
@@ -168,11 +180,18 @@ pub(crate) fn read_entity(bytes: &[u8], byte_range: ByteRange) -> NativeEntityRe
         bytes.len() == length
             && word(bytes, 4) > 0
             && word(bytes, 8) == 0
-            && matches!(word(bytes, 12) & 0x00ffefff, 0x000100c1 | 0x00010081)
+            && if component {
+                // Operands carry the component bit 0x20 and, under an explicit
+                // result marker, bit 0x100. The mirror bit stays separate.
+                word(bytes, 12) & 0x20 != 0
+                    && matches!(word(bytes, 12) & 0x00ffeedf, 0x000100c1 | 0x00010081)
+            } else {
+                matches!(word(bytes, 12) & 0x00ffefff, 0x000100c1 | 0x00010081)
+            }
             && word(bytes, 16) & 0xf0000000 == 0x80000000
             && word(bytes, 20) == 0
             && word(bytes, 24) == marker
-            && word(bytes, 32) == 0
+            && (component || word(bytes, 32) == 0)
             // The upper word is retained as opaque producer metadata.
             && word(bytes, 40) & 0xffff == if kind == "polygon_extrusion" { 0x1b0 } else { 0x180 }
             && word(bytes, 44) == 0
@@ -623,3 +642,75 @@ fn simple_polygon(values: &[f64]) -> bool {
     }
     true
 }
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    /// A closed rectangle profile of five straight elements with a flag trailer.
+    fn record(flags: u32, backlink: u32) -> Vec<u8> {
+        let mut bytes = vec![0_u8; 216];
+        for (at, value) in [
+            (0, 216_u32),
+            (4, 1),
+            (12, 76 << 24 | flags),
+            (16, 0x8000_0003),
+            (24, 0x5944_00c0),
+            (32, backlink),
+            (40, 0x180),
+        ] {
+            bytes[at..at + 4].copy_from_slice(&value.to_le_bytes());
+        }
+        bytes[29] = 0x11;
+        let values: [f64; 20] = [
+            0.0, 0.0, 0.0, 0.0, 0.0, 1.0, 1.0, 0.0, 0.0, 13.0, 0.0, 0.0, 10.0, 0.0, 10.0, 5.0, 0.0,
+            5.0, 0.0, 0.0,
+        ];
+        for (i, value) in values.iter().enumerate() {
+            bytes[48 + 8 * i..56 + 8 * i].copy_from_slice(&value.to_le_bytes());
+        }
+        bytes
+    }
+
+    const RANGE: ByteRange = ByteRange {
+        start: 1000,
+        end: 1216,
+    };
+
+    fn decoded(entity: &NativeEntityRecord) -> Option<(&'static str, usize)> {
+        entity
+            .primitive
+            .as_ref()
+            .map(|p| (p.kind, p.parameters.len()))
+    }
+
+    #[test]
+    fn component_flags_select_the_reader() {
+        let implicit = record(0x100e1, 0);
+        assert!(read_entity(&implicit, RANGE).primitive.is_none());
+        assert_eq!(
+            read_entity(&implicit, RANGE).diagnostics[0].code,
+            "native.layout"
+        );
+        let component = read_component_entity(&implicit, RANGE);
+        assert_eq!(decoded(&component), Some(("profile_extrusion", 29)));
+        assert_eq!(component.source_id, Some(0x8000_0003));
+        assert_eq!(component.is_mirror, Some(false));
+        // An explicit component keeps its result backlink; a standalone record
+        // with the same word, or without the component bit, is not an operand.
+        let explicit = record(0x101e1, 0x8000_0009);
+        assert_eq!(
+            decoded(&read_component_entity(&explicit, RANGE)),
+            Some(("profile_extrusion", 29))
+        );
+        assert!(read_entity(&explicit, RANGE).primitive.is_none());
+        assert!(read_entity(&record(0x100c1, 1), RANGE).primitive.is_none());
+        let standalone = read_component_entity(&record(0x100c1, 0), RANGE);
+        assert!(standalone.primitive.is_none());
+        assert_eq!(standalone.diagnostics[0].code, "native.layout");
+        assert_eq!(
+            decoded(&read_entity(&record(0x100c1, 0), RANGE)),
+            Some(("profile_extrusion", 29))
+        );
+    }
+}