cutoptim 1.0.0__tar.gz → 1.3.0__tar.gz

{cutoptim-1.0.0 → cutoptim-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cutoptim
-Version: 1.0.0
+Version: 1.3.0
 Summary: Official client for the CutOptim Engine API — cutting optimization (2D panels, 1D linear, timber, true-shape nesting) over HTTPS.
 Project-URL: Homepage, https://cutoptim.com/engine/reference
 Project-URL: Source, https://github.com/cutoptim/engine-python

{cutoptim-1.0.0 → cutoptim-1.3.0}/cutoptim/__init__.py

@@ -9,5 +9,5 @@ Standard library only (urllib, hmac). Types are generated from the OpenAPI docum
 from .client import CutOptim, CutOptimError, is_job_accepted
 from .webhooks import verify_webhook, SIGNATURE_HEADER
 
-__version__ = "1.0.0"
+__version__ = "1.3.0"
 __all__ = ["CutOptim", "CutOptimError", "is_job_accepted", "verify_webhook", "SIGNATURE_HEADER", "__version__"]

{cutoptim-1.0.0 → cutoptim-1.3.0}/cutoptim/types_gen.py

@@ -1,5 +1,5 @@
 # GENERATED by scripts/gen-sdks.ts from the CutOptim Engine API OpenAPI document — DO NOT EDIT.
-# contract 1 · spec sha256 d12a371f3242e7b21df0aa4ecf2df4b2f60f8670bbed7e47bbe3d4cbf08678fb · cutoptim 1.0.0
+# contract 1 · spec sha256 e29a45d3c07667cf676ceb46a7c24ec3203683e50f72ba25f0677ac4af140c71 · cutoptim 1.3.0
 from __future__ import annotations
 
 from typing import Any, Dict, List, Literal, TypedDict, Union
@@ -358,6 +358,33 @@ class Part1D(_Part1DRequired, total=False):
     priority: bool
     material: str
     meta: Dict[str, Any]
+    ends: "MitreEnds"
+    flip: Literal["none", "face", "edge", "any"]
+    depth: float
+    thickness: float
+
+
+class _EndCutRequired(TypedDict):
+    angle: float
+
+
+class EndCut(_EndCutRequired, total=False):
+    """One end cut of a part, in degrees from square (0 = a square end), signed. The part is measured long point to long point (`length` is its overall length). A part whose two end cuts would cross inside its section (shorter than its leads) cannot be made: a 400 `invalid_request` naming `parts[i].ends` says how long it must at least be."""
+    bevel: float
+
+
+class MitreEnds(TypedDict, total=False):
+    """The angled ends of a part, read only with `options.mitrePairing`. Two parts of one section whose facing ends lie in one plane (after a turn `flip` allows) can be cut with ONE saw cut between them: the triangle between the long and the short point is not wasted. Without `mitrePairing` the ends are not used (a warning says so) and the part packs as its `length`."""
+    start: "EndCut"
+    end: "EndCut"
+
+
+class SharedCut(TypedDict):
+    """This part's far end is ONE saw cut shared with the next part on the bar. The next part starts at `pos + length − lead + kerfAlongAxis` computed from the rounded values shown (not one kerf after `pos + length`), and the shared wood is counted once in `yieldPct`."""
+    angle: float
+    bevel: float
+    kerfAlongAxis: float
+    lead: float
 
 
 class _Stock1DRequired(TypedDict):
@@ -386,6 +413,7 @@ class Options1D(TypedDict, total=False):
     minimizeCost: bool
     respectStock: bool
     minOffcut: float
+    mitrePairing: bool
 
 
 class _Optimize1DRequestRequired(TypedDict):
@@ -412,6 +440,8 @@ class PartWood(_PartWoodRequired, total=False):
     priority: bool
     material: str
     meta: Dict[str, Any]
+    ends: "MitreEnds"
+    flip: Literal["none", "face", "edge", "any"]
 
 
 class _StockWoodRequired(TypedDict):
@@ -437,6 +467,7 @@ class OptionsWood(TypedDict, total=False):
     minimizeCost: bool
     respectStock: bool
     minOffcut: float
+    mitrePairing: bool
 
 
 class _OptimizeWoodRequestRequired(TypedDict):
@@ -450,8 +481,7 @@ class OptimizeWoodRequest(_OptimizeWoodRequestRequired, total=False):
     include: List[Literal["cutPlan", "offcuts", "svg", "csv", "dxf", "labels", "planHash", "pdf", "labelsPdf"]]
 
 
-class CutStep(TypedDict):
-    """One blade movement, in physically executable order (parent before children: you cannot crosscut a strip before you have ripped it off)."""
+class _CutStepRequired(TypedDict):
     sheet: int
     step: int
     axis: Literal["h", "v"]
@@ -460,6 +490,12 @@ class CutStep(TypedDict):
     stage: int
 
 
+class CutStep(_CutStepRequired, total=False):
+    """One blade movement, in physically executable order (parent before children: you cannot crosscut a strip before you have ripped it off)."""
+    angle: float
+    bevel: float
+
+
 class _PlacedPart2DRequired(TypedDict):
     name: str
     x: float
@@ -642,6 +678,8 @@ class _PlacedPart1DRequired(TypedDict):
 
 class PlacedPart1D(_PlacedPart1DRequired, total=False):
     meta: Dict[str, Any]
+    sharedCut: "SharedCut"
+    flipped: Literal["face", "edge", "roll"]
 
 
 class _RodRequired(TypedDict):
@@ -657,7 +695,7 @@ class Rod(_RodRequired, total=False):
     meta: Dict[str, Any]
 
 
-class Metrics1D(TypedDict):
+class _Metrics1DRequired(TypedDict):
     rodCount: int
     yieldPct: float
     placed: int
@@ -667,6 +705,10 @@ class Metrics1D(TypedDict):
     toleranceAcceptedCount: int
 
 
+class Metrics1D(_Metrics1DRequired, total=False):
+    sharedCuts: int
+
+
 class Unplaced1D(TypedDict):
     name: str
     length: float
@@ -751,8 +793,7 @@ class WoodUnmatched(_WoodUnmatchedRequired, total=False):
     material: str
 
 
-class MetricsWood(TypedDict):
-    """Job-wide totals across every section."""
+class _MetricsWoodRequired(TypedDict):
     sectionCount: int
     rodCount: int
     yieldPct: float
@@ -763,6 +804,11 @@ class MetricsWood(TypedDict):
     toleranceAcceptedCount: int
 
 
+class MetricsWood(_MetricsWoodRequired, total=False):
+    """Job-wide totals across every section."""
+    sharedCuts: int
+
+
 class _OptimizeWoodResponseRequired(TypedDict):
     engine: Literal["heuristic", "balanced"]
     engineVersion: str

{cutoptim-1.0.0 → cutoptim-1.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cutoptim"
-version = "1.0.0"
+version = "1.3.0"
 description = "Official client for the CutOptim Engine API — cutting optimization (2D panels, 1D linear, timber, true-shape nesting) over HTTPS."
 readme = "README.md"
 license = "MIT"