Tool Utilities - Fit Polyline

local fitPoly = require('editor/toolUtilities/fitPoly')

-- Order unordered components (each has .obj with :getPosition())
local ordered = fitPoly.fitPoly(components)

-- Algorithm:
-- 1. Extract positions from component objects
-- 2. Try every point as starting point (brute force)
-- 3. For each start, greedily build path using scoring:
--    - Base score: 1/(distSq + 0.1) - closer is better
--    - Direction bonus: multiply by (1+dot) if dot > 0.5
--    - Sharp turn penalty: multiply by 0.1 if dot < -0.5
--    - Moderate penalty: multiply by (0.5 + dot*0.5) otherwise
-- 4. Maximum neighbor distance: 50m
-- 5. Evaluate path quality:
--    - Smoothness score (70% weight): rewards direction consistency
--    - Distance score (30% weight): penalizes total distance
--    - Direction reversals (dot < 0): heavy -2.0 penalty
--    - Sharp turns (dot < 0.5): penalty proportional to (1-dot)
--    - Smooth continuation (dot >= 0.5): reward = dot value
-- 6. Select path with highest combined score
-- 7. Append any unvisited points at end

-- Input: array of {obj = SceneObject} with :getPosition()
-- Output: same array reordered for smooth polyline traversal
-- Returns input unchanged if fewer than 2 components

-- Use case: ordering spline control points that were
-- placed without explicit ordering (e.g., from selection)