Линия как
маска, crop
и visual seam.

CONSUMES / PROVIDES

LinePathGeometry                 // canonical line, 2.01+
HostRegion                        // production interface via HostBoundaryAdapter
Compo2.14.PartitionDescriptor?     // canonical 2.14 output, if available
Compo2.14.BoundaryRelation?        // canonical 2.14 output, if available
MaskCropSeamTarget               // explicit intent
GeometryToleranceContext         // owner-provided, if approximate
StylePreset?                     // seam rendering parameters only
Compo0.seed?                     // only for deterministic unresolved ordering

MaskCropSeamResult {
  status,
  applicability,
  confidence,
  mode,
  topology,
  seamPath,
  regions[],
  selectedRegionIds[],
  boundaryContacts[],
  areaFractions[],        // DESCRIPTORS ONLY
  hardViolations[],
  unresolvedInputs[],
  repairHints[],
  provenance,
  audit
}

OWNS_METRICS

Canonical target

MaskCropSeamTarget {
  mode: "mask_boundary|crop_edge|visual_seam",
  topology: "OPEN_SPLIT|CLOSED_LOOP|AUTO",
  keepSide?:
    { type:"ANCHOR_POINT", point:{x,y} } |
    { type:"PATH_RELATIVE", value:"LEFT|RIGHT" } |
    { type:"REGION_ID", value:string },
  extensionPolicy: "NONE|RAY_TO_HOST|TANGENT_TO_HOST",
  binaryOnly: true,
  seamRender?: "INVISIBLE|STROKE|GAP|OVERLAP|FEATHER",
  seamWidth?: number,
  featherWidth?: number
}

Screen coordinate convention

Curves / polylines

Polyline использует собственные vertices без resampling, если topology можно вычислить точно. Curve должна предоставлять exact planar splitting primitive либо owner-provided approximation с confidence. Arc-length sampling допустим только как fallback и не должен менять результат при разумном увеличении sampling density.

CropResult

crop: {
  keepSideResolved: true|false,
  selectorType: "ANCHOR_POINT|PATH_RELATIVE|REGION_ID",
  selectedRegionIds: ["region:A"],
  rejectedRegionIds: ["region:B"],
  clipGeometry: RegionGeometry,
  areaFraction: 0.63,          // descriptor only
  selectionProvenance: "EXPLICIT_TARGET"
}

{
  "module": "Compo 2.22",
  "name": "line_as_mask_crop_visual_seam",
  "version": "1.1-corrective",
  "scope": "derive binary mask/crop/seam operational geometry from canonical line path inside one bounded host region",
  "consumes": [
    "LinePathGeometry",
    "HostRegion via HostBoundaryAdapter",
    "Compo2.14.Compo2.14.PartitionDescriptor? / Compo2.14.BoundaryRelation?",
    "MaskCropSeamTarget",
    "GeometryToleranceContext?",
    "StylePreset?"
  ],
  "provides": [
    "MaskCropSeamResult",
    "line.mask.topology",
    "line.mask.regions[]",
    "line.crop.selectedRegionIds[]",
    "line.seam.operationDescriptor",
    "repairHints[]",
    "audit"
  ],
  "owns_metrics": [],
  "descriptors_only": [
    "boundaryContacts[]",
    "areaFractions[]",
    "topology",
    "selectedRegionIds[]",
    "seamRender",
    "seamWidth",
    "featherWidth"
  ],
  "hard_constraints": [
    "host region must have positive area",
    "source path must contain at least two distinct points",
    "binary open split requires two distinct host-boundary contacts unless explicit extension policy resolves them",
    "binary closed loop must be simple and contained by host",
    "self-intersecting path is invalid when binaryOnly=true",
    "crop_edge requires explicit keepSide selector",
    "source line geometry is immutable"
  ],
  "soft_constraints": [
    "approximate/fallback geometry lowers confidence",
    "anchor on seam requires semantic disambiguation",
    "style seam widths must not mutate source path"
  ],
  "preferences": [
    "ANCHOR_POINT selector preferred when reversal-invariant crop semantics are required",
    "exact planar split preferred over sampled fallback",
    "consume Compo2.14 partition evidence when available rather than duplicating boundary scoring"
  ],
  "overrides_allowed_by": [
    "explicit MaskCropSeamTarget",
    "future image/crop semantic owner",
    "Compo2.23 context override layer",
    "future global composition solver"
  ],
  "initial_heuristics": {},
  "style_preset_values": {
    "seamRender": "INVISIBLE|STROKE|GAP|OVERLAP|FEATHER",
    "seamWidth": "STYLE_PRESET / explicit units",
    "featherWidth": "STYLE_PRESET / explicit units"
  },
  "host_region_policy": {
    "production_contract": "HostBoundaryAdapter",
    "reference_fixture": "RectHostRegion",
    "reference_fixture_only": true,
    "bounding_box_substitution": "FORBIDDEN",
    "missing_adapter_for_non_rect_host": "UNSUPPORTED_OR_UNRESOLVED"
  },
  "topology_policy": {
    "OPEN_SPLIT": "simple open path with two distinct host-boundary contacts",
    "CLOSED_LOOP": "simple contained closed path",
    "SELF_INTERSECTING": "hard invalid for binaryOnly",
    "DEGENERATE": "hard invalid"
  },
  "crop_selector_policy": {
    "ANCHOR_POINT": "reversal-invariant when anchor is not on seam",
    "PATH_RELATIVE": "LEFT/RIGHT swap under path reversal",
    "REGION_ID": "requires external semantic identity",
    "missing": "unresolved_target; never choose by area"
  },
  "metric_policy": {
    "emit_quality_score": false,
    "area_fraction_is_score": false,
    "boundary_score_owner": "Compo2.14",
    "line_system_score_owner": "Compo2.20"
  },
  "candidate_policy": {
    "exploratory_generation_owner": "Compo2.19",
    "derived_region_variants": "deterministic only",
    "rank_unresolved_regions": false
  },
  "correction_policy": {
    "direct_foreign_mutation": "FORBIDDEN",
    "line_change_route": "line owner / Compo2.19 correction request",
    "missing_keep_side_route": "semantic/crop caller",
    "host_change_route": "host owner"
  },
  "deferred_inputs": [
    "global crop choice",
    "image focal-point preservation",
    "global.balance",
    "global.negativeSpace",
    "global.hierarchy",
    "global.eyeFlow",
    "zOrder/blend semantics owned by rendering/global layers"
  ],
  "recompute_when": [
    "source line path changes",
    "host region changes",
    "mask/crop/seam target changes",
    "geometry tolerance context changes",
    "seam render/style parameters change only operation descriptor, not topology unless offset geometry is requested"
  ],
  "tests": [
    "M01_OPEN_SPLIT","M02_AREA_CONSERVATION","M03_SCALE_INVARIANCE","M04_REVERSAL_GEOMETRY",
    "M05_ANCHOR_REVERSAL","M06_PATH_SIDE_REVERSAL","M07_MISSING_KEEP_SIDE","M08_NA",
    "M09_ZERO_PATH","M10_COLLAPSED_HOST","M11_ONE_CONTACT","M12_EXTENSION_IMMUTABLE",
    "M13_SELF_INTERSECTION","M14_CLOSED_LOOP","M15_LOOP_OUTSIDE","M16_ANCHOR_ON_SEAM",
    "M17_DESCRIPTOR_NOT_SCORE","M18_NO_GLOBAL","M19_NO_MUTATION","M20_RENDER_INDEPENDENCE",
    "M21_SEGMENTATION_INVARIANCE","M22_DETERMINISTIC_ORDER","M23_BOUNDARY_OWNER","M24_SCORER_OWNER",
    "M25_CANONICAL_2_14_HANDOFF","M26_HOST_ADAPTER_SCOPE"
  ],
  "finality": "LOCAL_MASK_CROP_SEAM_OPERATION_ONLY",
  "invariants": [
    "ONE_METRIC_ONE_OWNER","N_A_NOT_ZERO","LOCAL_NOT_GLOBAL","GEOMETRY_NOT_INTERPRETATION",
    "DESCRIPTOR_NOT_SCORE","NO_BEAUTYSCORE","NO_FOREIGN_MUTATION","CONTINUATION_NOT_REDESIGN"
  ]
}