feat(schemas): add GeoJSON styling properties schemas

[IanMayo]

Summary

• Add standardized styling schemas (PointProperties, LineProperties, PolygonProperties, TrackStyle) following Leaflet Path options naming conventions
• Update all feature schemas with required style property (TrackFeature, ReferenceLocation, 6 annotation types)
• Remove deprecated color attribute from all feature schemas
• Add 45 golden fixtures (24 valid, 21 invalid) for comprehensive validation testing

Changes

Phase 1: Setup

• Added PointShapeEnum, LineCapEnum, LineJoinEnum to common.yaml
• Created styling.yaml module with all styling schemas
• Updated debrief.yaml to import styling module

Phase 2: Foundation - Styling Schemas

• Defined PointProperties schema with shape, radius, fill, stroke properties
• Defined LineProperties schema with stroke, color, weight, opacity, dash pattern properties
• Defined PolygonProperties schema combining fill and stroke properties
• Defined TrackStyle composite schema with line (LineProperties) and point (PointProperties)
• Created 13 styling fixtures (valid + invalid)

Phase 3: TrackFeature Styling

• Updated TrackProperties with required style: TrackStyle property
• Removed deprecated color attribute
• Updated track feature fixtures with style property

Phase 4: All Feature Schemas

• Updated ReferenceLocationProperties with style: PointProperties
• Updated all 6 annotation Properties classes with appropriate style schemas:
  • NarrativeEntry, TextAnnotation → PointProperties
  • CircleAnnotation, RectangleAnnotation → PolygonProperties
  • LineAnnotation, VectorAnnotation → LineProperties
• Updated all feature fixtures with style property

Phase 5: Round-Trip Tests

• Added styling schemas to ROUNDTRIP_ENTITY_MAP in test_roundtrip.py
• Verified data preservation across Python → JSON → Python serialization

Phase 6: Tactical Styling

• Added tactical styling fixtures (dashed lines, triangle markers)
• Verified CSS color format support (hex, rgb, rgba, hsl, named)

Evidence

Test Results

Test File	Tests	Status
test_golden.py	48	PASSED
test_roundtrip.py	56	PASSED
test_schema_compare.py	15	PASSED

======================= 119 passed, 6 warnings =======================

6 warnings are expected due to known LinkML nested array limitation with GeoJSON coordinates.

Fixture Coverage

Schema	Valid Fixtures	Invalid Fixtures
PointProperties	4	3
LineProperties	4	3
PolygonProperties	3	3
TrackStyle	2	1

Usage Example

from debrief_schemas import TrackStyle, LineProperties, PointProperties

track_style = TrackStyle(
    line=LineProperties(
        stroke=True,
        color="#0066CC",
        weight=2,
        opacity=1.0,
        line_cap="round",
        line_join="round"
    ),
    point=PointProperties(
        shape="circle",
        radius=4,
        fill=True,
        fill_color="#0066CC",
        fill_opacity=1.0,
        stroke=True,
        color="#FFFFFF",
        weight=1,
        opacity=1.0
    )
)

Test Plan

• All 119 tests pass (golden fixtures, round-trip, schema comparison)
• Valid fixtures pass Pydantic validation
• Invalid fixtures correctly fail validation with expected errors
• Round-trip serialization preserves all styling data
• Generated Pydantic models, JSON Schema, and TypeScript types are valid
• All 3 point shapes (circle, square, triangle) validate correctly
• CSS color formats (hex, rgb, rgba, hsl, named) validate correctly
• Dash array patterns validate as strings

Related

• Spec: specs/014-geojson-styling-schemas/spec.md
• Tasks: specs/014-geojson-styling-schemas/tasks.md
• Evidence: specs/014-geojson-styling-schemas/evidence/

🤖 Generated with Claude Code