geometrykit 0.5.0__tar.gz → 0.5.1__tar.gz

geometrykit-0.5.1/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: geometrykit
+Version: 0.5.1
+Summary: Geometry primitives and NURBS data model — the geometry substrate for the ifckit family
+Author: Sander Boer
+License-Expression: LGPL-3.0-or-later
+Project-URL: Homepage, https://github.com/maucworks/geometrykit
+Project-URL: Changelog, https://github.com/maucworks/geometrykit/blob/master/CHANGELOG.md
+Keywords: geometry,nurbs,vector,curve,surface,splines
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: COPYING.LESSER
+License-File: COPYING
+Provides-Extra: dev
+Requires-Dist: pytest<10,>=7; extra == "dev"
+Requires-Dist: pytest-cov<8,>=7; extra == "dev"
+Requires-Dist: hypothesis<8,>=6; extra == "dev"
+Dynamic: license-file
+
+# geometrykit
+
+OCC-free NURBS geometry for the ifckit family: value types (`Vec`,
+`Plane`, `Line`, `Arc`, `Polyline`, `Path`, `Curve`, `Surface`), NURBS
+evaluation / tangents / normals / projection, energy-minimising patch
+fills with G1/G2 continuity options, plane × surface sections with
+pcurve tracks, and STEP/OBJ/STL writers. No OCCT, no compiled
+toolchain required to install.
+
+## Install
+
+```bash
+pip install geometrykit   # Python >= 3.9, incl. Rhino 8's CPython 3.9
+```
+
+Binary wheels (`cp39-abi3`) carry the compiled Rust core
+(`geometrykit._rust`) where a platform build exists, and the public
+API routes to it automatically. Platforms without a matching wheel get
+the pure-Python/numpy mirror instead: same API, same results, slower.
+`GEOMETRYKIT_ENGINE=npu` forces the mirror; the default prefers the
+accelerator when importable.
+
+## Quickstart
+
+```python
+from geometrykit import engine
+from geometrykit.geometry import Curve, Surface
+from geometrykit.geometry.primitives import Vec
+
+curves = [
+    Curve.from_tangents(start=Vec(0, 0, 2.4), tan_start=Vec(1, 0, 0),
+                        end=Vec(8, 0, 2.8), tan_end=Vec(1, 0, 0), scale=3.0),
+    Curve.from_tangents(start=Vec(8, 0, 2.8), tan_start=Vec(0, 1, 0),
+                        end=Vec(8, 6, 2.9), tan_end=Vec(0, 1, 0), scale=3.0),
+    Curve.from_tangents(start=Vec(0, 6, 3.2), tan_start=Vec(1, 0, 0),
+                        end=Vec(8, 6, 2.9), tan_end=Vec(1, 0, 0), scale=3.0),
+    Curve.from_tangents(start=Vec(0, 6, 3.2), tan_start=Vec(0, -1, 0),
+                        end=Vec(0, 0, 2.4), tan_end=Vec(0, -1, 0), scale=3.0),
+]
+surface = Surface.patch(curves, fill="energy", nu=16, nv=16, tangency=0.75)
+proj, (u, v) = surface.project(Vec(-1.0, -1.0, 3.0))
+print(engine.engine(), proj, (u, v))
+```
+
+## What is in here
+
+- NURBS evaluation, analytic tangents and normals, closest-point
+  projection (kernel Newton, no OCC).
+- Energy-minimising patch fill over a boundary ring
+  (`Surface.patch(..., fill="energy")`), with tangency strength and
+  optional G2 and adaptive re-fit.
+- Plane × surface sections with parameter tracks, batch level sets,
+  and node-exact diagrid weaving.
+- Writers: STEP (AP214 B-rep), OBJ, STL.
+- `geometrykit-core` on crates.io: the same kernels as a pure-Rust
+  dependency (no bindings, no unsafe code).
+
+Out of scope by design: B-rep booleans and tolerant topology (volumes
+are OCCT's domain); IFC serialisation lives in ifckit.
+
+## Development
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
+.venv/bin/python -m pytest tests/ -q
+GEOMETRYKIT_ENGINE=npu .venv/bin/python -m pytest tests/ -q
+GEOMETRYKIT_ENGINE=rust .venv/bin/python -m pytest tests/ -q
+```
+
+The oracle tier checks the kernel against OCCT and stays local
+(`pythonocc-core` is conda-only; see AGENTS.md). Every suite train
+runs in both engine configurations before a commit lands.
+
+## Licensing
+
+LGPL-3.0-or-later (`COPYING.LESSER`, `COPYING`). Kernel code promoted
+from ifckit's geometry package carries a provenance header recording
+its origin.

geometrykit-0.5.1/README.md

@@ -0,0 +1,78 @@
+# geometrykit
+
+OCC-free NURBS geometry for the ifckit family: value types (`Vec`,
+`Plane`, `Line`, `Arc`, `Polyline`, `Path`, `Curve`, `Surface`), NURBS
+evaluation / tangents / normals / projection, energy-minimising patch
+fills with G1/G2 continuity options, plane × surface sections with
+pcurve tracks, and STEP/OBJ/STL writers. No OCCT, no compiled
+toolchain required to install.
+
+## Install
+
+```bash
+pip install geometrykit   # Python >= 3.9, incl. Rhino 8's CPython 3.9
+```
+
+Binary wheels (`cp39-abi3`) carry the compiled Rust core
+(`geometrykit._rust`) where a platform build exists, and the public
+API routes to it automatically. Platforms without a matching wheel get
+the pure-Python/numpy mirror instead: same API, same results, slower.
+`GEOMETRYKIT_ENGINE=npu` forces the mirror; the default prefers the
+accelerator when importable.
+
+## Quickstart
+
+```python
+from geometrykit import engine
+from geometrykit.geometry import Curve, Surface
+from geometrykit.geometry.primitives import Vec
+
+curves = [
+    Curve.from_tangents(start=Vec(0, 0, 2.4), tan_start=Vec(1, 0, 0),
+                        end=Vec(8, 0, 2.8), tan_end=Vec(1, 0, 0), scale=3.0),
+    Curve.from_tangents(start=Vec(8, 0, 2.8), tan_start=Vec(0, 1, 0),
+                        end=Vec(8, 6, 2.9), tan_end=Vec(0, 1, 0), scale=3.0),
+    Curve.from_tangents(start=Vec(0, 6, 3.2), tan_start=Vec(1, 0, 0),
+                        end=Vec(8, 6, 2.9), tan_end=Vec(1, 0, 0), scale=3.0),
+    Curve.from_tangents(start=Vec(0, 6, 3.2), tan_start=Vec(0, -1, 0),
+                        end=Vec(0, 0, 2.4), tan_end=Vec(0, -1, 0), scale=3.0),
+]
+surface = Surface.patch(curves, fill="energy", nu=16, nv=16, tangency=0.75)
+proj, (u, v) = surface.project(Vec(-1.0, -1.0, 3.0))
+print(engine.engine(), proj, (u, v))
+```
+
+## What is in here
+
+- NURBS evaluation, analytic tangents and normals, closest-point
+  projection (kernel Newton, no OCC).
+- Energy-minimising patch fill over a boundary ring
+  (`Surface.patch(..., fill="energy")`), with tangency strength and
+  optional G2 and adaptive re-fit.
+- Plane × surface sections with parameter tracks, batch level sets,
+  and node-exact diagrid weaving.
+- Writers: STEP (AP214 B-rep), OBJ, STL.
+- `geometrykit-core` on crates.io: the same kernels as a pure-Rust
+  dependency (no bindings, no unsafe code).
+
+Out of scope by design: B-rep booleans and tolerant topology (volumes
+are OCCT's domain); IFC serialisation lives in ifckit.
+
+## Development
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
+.venv/bin/python -m pytest tests/ -q
+GEOMETRYKIT_ENGINE=npu .venv/bin/python -m pytest tests/ -q
+GEOMETRYKIT_ENGINE=rust .venv/bin/python -m pytest tests/ -q
+```
+
+The oracle tier checks the kernel against OCCT and stays local
+(`pythonocc-core` is conda-only; see AGENTS.md). Every suite train
+runs in both engine configurations before a commit lands.
+
+## Licensing
+
+LGPL-3.0-or-later (`COPYING.LESSER`, `COPYING`). Kernel code promoted
+from ifckit's geometry package carries a provenance header recording
+its origin.

{geometrykit-0.5.0 → geometrykit-0.5.1}/pyproject.toml

@@ -12,7 +12,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "geometrykit"
-version = "0.5.0"
+version = "0.5.1"
 description = "Geometry primitives and NURBS data model — the geometry substrate for the ifckit family"
 readme = "README.md"
 requires-python = ">=3.9"

{geometrykit-0.5.0 → geometrykit-0.5.1}/python/geometrykit/__init__.py

@@ -21,7 +21,7 @@ from geometrykit.geometry import (
     Vec,
 )
 
-__version__ = "0.5.0"
+__version__ = "0.5.1"
 
 __all__ = [
     "__version__",

geometrykit-0.5.1/python/geometrykit.egg-info/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: geometrykit
+Version: 0.5.1
+Summary: Geometry primitives and NURBS data model — the geometry substrate for the ifckit family
+Author: Sander Boer
+License-Expression: LGPL-3.0-or-later
+Project-URL: Homepage, https://github.com/maucworks/geometrykit
+Project-URL: Changelog, https://github.com/maucworks/geometrykit/blob/master/CHANGELOG.md
+Keywords: geometry,nurbs,vector,curve,surface,splines
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: COPYING.LESSER
+License-File: COPYING
+Provides-Extra: dev
+Requires-Dist: pytest<10,>=7; extra == "dev"
+Requires-Dist: pytest-cov<8,>=7; extra == "dev"
+Requires-Dist: hypothesis<8,>=6; extra == "dev"
+Dynamic: license-file
+
+# geometrykit
+
+OCC-free NURBS geometry for the ifckit family: value types (`Vec`,
+`Plane`, `Line`, `Arc`, `Polyline`, `Path`, `Curve`, `Surface`), NURBS
+evaluation / tangents / normals / projection, energy-minimising patch
+fills with G1/G2 continuity options, plane × surface sections with
+pcurve tracks, and STEP/OBJ/STL writers. No OCCT, no compiled
+toolchain required to install.
+
+## Install
+
+```bash
+pip install geometrykit   # Python >= 3.9, incl. Rhino 8's CPython 3.9
+```
+
+Binary wheels (`cp39-abi3`) carry the compiled Rust core
+(`geometrykit._rust`) where a platform build exists, and the public
+API routes to it automatically. Platforms without a matching wheel get
+the pure-Python/numpy mirror instead: same API, same results, slower.
+`GEOMETRYKIT_ENGINE=npu` forces the mirror; the default prefers the
+accelerator when importable.
+
+## Quickstart
+
+```python
+from geometrykit import engine
+from geometrykit.geometry import Curve, Surface
+from geometrykit.geometry.primitives import Vec
+
+curves = [
+    Curve.from_tangents(start=Vec(0, 0, 2.4), tan_start=Vec(1, 0, 0),
+                        end=Vec(8, 0, 2.8), tan_end=Vec(1, 0, 0), scale=3.0),
+    Curve.from_tangents(start=Vec(8, 0, 2.8), tan_start=Vec(0, 1, 0),
+                        end=Vec(8, 6, 2.9), tan_end=Vec(0, 1, 0), scale=3.0),
+    Curve.from_tangents(start=Vec(0, 6, 3.2), tan_start=Vec(1, 0, 0),
+                        end=Vec(8, 6, 2.9), tan_end=Vec(1, 0, 0), scale=3.0),
+    Curve.from_tangents(start=Vec(0, 6, 3.2), tan_start=Vec(0, -1, 0),
+                        end=Vec(0, 0, 2.4), tan_end=Vec(0, -1, 0), scale=3.0),
+]
+surface = Surface.patch(curves, fill="energy", nu=16, nv=16, tangency=0.75)
+proj, (u, v) = surface.project(Vec(-1.0, -1.0, 3.0))
+print(engine.engine(), proj, (u, v))
+```
+
+## What is in here
+
+- NURBS evaluation, analytic tangents and normals, closest-point
+  projection (kernel Newton, no OCC).
+- Energy-minimising patch fill over a boundary ring
+  (`Surface.patch(..., fill="energy")`), with tangency strength and
+  optional G2 and adaptive re-fit.
+- Plane × surface sections with parameter tracks, batch level sets,
+  and node-exact diagrid weaving.
+- Writers: STEP (AP214 B-rep), OBJ, STL.
+- `geometrykit-core` on crates.io: the same kernels as a pure-Rust
+  dependency (no bindings, no unsafe code).
+
+Out of scope by design: B-rep booleans and tolerant topology (volumes
+are OCCT's domain); IFC serialisation lives in ifckit.
+
+## Development
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
+.venv/bin/python -m pytest tests/ -q
+GEOMETRYKIT_ENGINE=npu .venv/bin/python -m pytest tests/ -q
+GEOMETRYKIT_ENGINE=rust .venv/bin/python -m pytest tests/ -q
+```
+
+The oracle tier checks the kernel against OCCT and stays local
+(`pythonocc-core` is conda-only; see AGENTS.md). Every suite train
+runs in both engine configurations before a commit lands.
+
+## Licensing
+
+LGPL-3.0-or-later (`COPYING.LESSER`, `COPYING`). Kernel code promoted
+from ifckit's geometry package carries a provenance header recording
+its origin.

geometrykit-0.5.0/PKG-INFO

@@ -1,94 +0,0 @@
-Metadata-Version: 2.4
-Name: geometrykit
-Version: 0.5.0
-Summary: Geometry primitives and NURBS data model — the geometry substrate for the ifckit family
-Author: Sander Boer
-License-Expression: LGPL-3.0-or-later
-Project-URL: Homepage, https://github.com/maucworks/geometrykit
-Project-URL: Changelog, https://github.com/maucworks/geometrykit/blob/master/CHANGELOG.md
-Keywords: geometry,nurbs,vector,curve,surface,splines
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Scientific/Engineering :: Mathematics
-Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: COPYING.LESSER
-License-File: COPYING
-Provides-Extra: dev
-Requires-Dist: pytest<10,>=7; extra == "dev"
-Requires-Dist: pytest-cov<8,>=7; extra == "dev"
-Requires-Dist: hypothesis<8,>=6; extra == "dev"
-Dynamic: license-file
-
-# geometrykit
-
-Geometry primitives and NURBS data model: `Vec`, `Plane`, `Curve`, `Surface`,
-`Path`, and (planned) G1 constrained patches, curve/surface clipping, trim
-pcurves, and a tessellator — the geometry substrate for the ifckit family.
-
-## Status
-
-Source of truth: `github.com/maucworks/geometrykit` — check it out anywhere;
-wheels are built from a checkout root (`python -m build`, `packages.find`
-over this layout). The package itself is unaware of check-out locations.
-
-Releases so far (0.0.1/0.0.2) are a **name claim + placeholder**: the API is not yet
-published, and the package intentionally exports nothing beyond
-`geometrykit.__version__`. Version bumps arrive with the first real
-API (planned v0.1: primitives promoted from `ifckit.geometry`, extracted
-from the A320 configurator corpus with its existing test coverage as oracle
-spec).
-
-## Development
-
-```bash
-python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
-.venv/bin/pytest tests/ -q                       # full suite (plain env)
-
-# oracle tier: the tests that check the kernel against OCCT
-conda env create -f environment.yml              # once
-conda run -n geometrykit-oracle python -m pytest tests/ -q
-# with coverage + the staged ladder:
-conda run -n geometrykit-oracle python -m pytest tests/ --cov -q
-conda run -n geometrykit-oracle python -m coverage json -o /tmp/geometrykit-cov.json
-python scripts/coverage_ladder.py /tmp/geometrykit-cov.json
-# corpus refresh (A320 demos → tests/fixtures/corpus/):
-# where ifckit is importable (its own environment, not the oracle one):
-python scripts/capture_corpus.py
-```
-
-Layers: `tests/geometry/` (ported ifckit geometry suite), `tests/test_contract.py`
-(contract v0), `tests/test_engine_probe.py` + `tests/test_engine_parity.py`
-(runtime split), `tests/oracle/` (OCCT goldens, skipif), `tests/panel/`
-(panelization acceptance, M2 tripwire).
-
-## Roadmap (contract-first, per the kernel plan)
-
-- v0.1 — value-type primitives (`Vec`, `Plane`, `Arc`, `Line`, `Path`,
-  `Curve`, `Surface`); `ifckit.geometry` becomes a re-export facade.
-  Data contract: id + plain arrays (`{kind, degrees, knots, cps}(m,4)`,
-  homogeneous `[w-mu, w-nu, w-rho, w]`).
-- v0.2+ — G1 constrained filling (Gregory corners) over polygonal charts;
-  Bezier-column clipping (plane-surface, closest-point); trims (pcurves);
-  tessellator (curvature-driven).
-- Out of scope by design: B-rep booleans, tolerant topology (the kernel is
-  B-rep-free on purpose; volumes are ifcopenshell/OCCT's domain).
-
-## Licensing
-
-geometrykit is LGPL-3.0-or-later, aligned with ifckit. The kernel carries code
-promoted from ifckit's geometry package; the provenance of every carried
-module is documented in its file header.
-
-## Sibling projects
-
-- `ifckit` — elements/builders/model that bind `geometrykit` to IFC.
-- The associativity engine (name TBD: `modelkit`/`stageskit`) — identity,
-  stage signatures, dirty propagation; geometry-agnostic, stdlib-only.

geometrykit-0.5.0/README.md

@@ -1,65 +0,0 @@
-# geometrykit
-
-Geometry primitives and NURBS data model: `Vec`, `Plane`, `Curve`, `Surface`,
-`Path`, and (planned) G1 constrained patches, curve/surface clipping, trim
-pcurves, and a tessellator — the geometry substrate for the ifckit family.
-
-## Status
-
-Source of truth: `github.com/maucworks/geometrykit` — check it out anywhere;
-wheels are built from a checkout root (`python -m build`, `packages.find`
-over this layout). The package itself is unaware of check-out locations.
-
-Releases so far (0.0.1/0.0.2) are a **name claim + placeholder**: the API is not yet
-published, and the package intentionally exports nothing beyond
-`geometrykit.__version__`. Version bumps arrive with the first real
-API (planned v0.1: primitives promoted from `ifckit.geometry`, extracted
-from the A320 configurator corpus with its existing test coverage as oracle
-spec).
-
-## Development
-
-```bash
-python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
-.venv/bin/pytest tests/ -q                       # full suite (plain env)
-
-# oracle tier: the tests that check the kernel against OCCT
-conda env create -f environment.yml              # once
-conda run -n geometrykit-oracle python -m pytest tests/ -q
-# with coverage + the staged ladder:
-conda run -n geometrykit-oracle python -m pytest tests/ --cov -q
-conda run -n geometrykit-oracle python -m coverage json -o /tmp/geometrykit-cov.json
-python scripts/coverage_ladder.py /tmp/geometrykit-cov.json
-# corpus refresh (A320 demos → tests/fixtures/corpus/):
-# where ifckit is importable (its own environment, not the oracle one):
-python scripts/capture_corpus.py
-```
-
-Layers: `tests/geometry/` (ported ifckit geometry suite), `tests/test_contract.py`
-(contract v0), `tests/test_engine_probe.py` + `tests/test_engine_parity.py`
-(runtime split), `tests/oracle/` (OCCT goldens, skipif), `tests/panel/`
-(panelization acceptance, M2 tripwire).
-
-## Roadmap (contract-first, per the kernel plan)
-
-- v0.1 — value-type primitives (`Vec`, `Plane`, `Arc`, `Line`, `Path`,
-  `Curve`, `Surface`); `ifckit.geometry` becomes a re-export facade.
-  Data contract: id + plain arrays (`{kind, degrees, knots, cps}(m,4)`,
-  homogeneous `[w-mu, w-nu, w-rho, w]`).
-- v0.2+ — G1 constrained filling (Gregory corners) over polygonal charts;
-  Bezier-column clipping (plane-surface, closest-point); trims (pcurves);
-  tessellator (curvature-driven).
-- Out of scope by design: B-rep booleans, tolerant topology (the kernel is
-  B-rep-free on purpose; volumes are ifcopenshell/OCCT's domain).
-
-## Licensing
-
-geometrykit is LGPL-3.0-or-later, aligned with ifckit. The kernel carries code
-promoted from ifckit's geometry package; the provenance of every carried
-module is documented in its file header.
-
-## Sibling projects
-
-- `ifckit` — elements/builders/model that bind `geometrykit` to IFC.
-- The associativity engine (name TBD: `modelkit`/`stageskit`) — identity,
-  stage signatures, dirty propagation; geometry-agnostic, stdlib-only.

geometrykit-0.5.0/python/geometrykit.egg-info/PKG-INFO

@@ -1,94 +0,0 @@
-Metadata-Version: 2.4
-Name: geometrykit
-Version: 0.5.0
-Summary: Geometry primitives and NURBS data model — the geometry substrate for the ifckit family
-Author: Sander Boer
-License-Expression: LGPL-3.0-or-later
-Project-URL: Homepage, https://github.com/maucworks/geometrykit
-Project-URL: Changelog, https://github.com/maucworks/geometrykit/blob/master/CHANGELOG.md
-Keywords: geometry,nurbs,vector,curve,surface,splines
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Scientific/Engineering :: Mathematics
-Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: COPYING.LESSER
-License-File: COPYING
-Provides-Extra: dev
-Requires-Dist: pytest<10,>=7; extra == "dev"
-Requires-Dist: pytest-cov<8,>=7; extra == "dev"
-Requires-Dist: hypothesis<8,>=6; extra == "dev"
-Dynamic: license-file
-
-# geometrykit
-
-Geometry primitives and NURBS data model: `Vec`, `Plane`, `Curve`, `Surface`,
-`Path`, and (planned) G1 constrained patches, curve/surface clipping, trim
-pcurves, and a tessellator — the geometry substrate for the ifckit family.
-
-## Status
-
-Source of truth: `github.com/maucworks/geometrykit` — check it out anywhere;
-wheels are built from a checkout root (`python -m build`, `packages.find`
-over this layout). The package itself is unaware of check-out locations.
-
-Releases so far (0.0.1/0.0.2) are a **name claim + placeholder**: the API is not yet
-published, and the package intentionally exports nothing beyond
-`geometrykit.__version__`. Version bumps arrive with the first real
-API (planned v0.1: primitives promoted from `ifckit.geometry`, extracted
-from the A320 configurator corpus with its existing test coverage as oracle
-spec).
-
-## Development
-
-```bash
-python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
-.venv/bin/pytest tests/ -q                       # full suite (plain env)
-
-# oracle tier: the tests that check the kernel against OCCT
-conda env create -f environment.yml              # once
-conda run -n geometrykit-oracle python -m pytest tests/ -q
-# with coverage + the staged ladder:
-conda run -n geometrykit-oracle python -m pytest tests/ --cov -q
-conda run -n geometrykit-oracle python -m coverage json -o /tmp/geometrykit-cov.json
-python scripts/coverage_ladder.py /tmp/geometrykit-cov.json
-# corpus refresh (A320 demos → tests/fixtures/corpus/):
-# where ifckit is importable (its own environment, not the oracle one):
-python scripts/capture_corpus.py
-```
-
-Layers: `tests/geometry/` (ported ifckit geometry suite), `tests/test_contract.py`
-(contract v0), `tests/test_engine_probe.py` + `tests/test_engine_parity.py`
-(runtime split), `tests/oracle/` (OCCT goldens, skipif), `tests/panel/`
-(panelization acceptance, M2 tripwire).
-
-## Roadmap (contract-first, per the kernel plan)
-
-- v0.1 — value-type primitives (`Vec`, `Plane`, `Arc`, `Line`, `Path`,
-  `Curve`, `Surface`); `ifckit.geometry` becomes a re-export facade.
-  Data contract: id + plain arrays (`{kind, degrees, knots, cps}(m,4)`,
-  homogeneous `[w-mu, w-nu, w-rho, w]`).
-- v0.2+ — G1 constrained filling (Gregory corners) over polygonal charts;
-  Bezier-column clipping (plane-surface, closest-point); trims (pcurves);
-  tessellator (curvature-driven).
-- Out of scope by design: B-rep booleans, tolerant topology (the kernel is
-  B-rep-free on purpose; volumes are ifcopenshell/OCCT's domain).
-
-## Licensing
-
-geometrykit is LGPL-3.0-or-later, aligned with ifckit. The kernel carries code
-promoted from ifckit's geometry package; the provenance of every carried
-module is documented in its file header.
-
-## Sibling projects
-
-- `ifckit` — elements/builders/model that bind `geometrykit` to IFC.
-- The associativity engine (name TBD: `modelkit`/`stageskit`) — identity,
-  stage signatures, dirty propagation; geometry-agnostic, stdlib-only.