Add locations() helper method

Author: thekid

src/main/php/de/thekid/dialog/import/Description.php

@@ -1,8 +1,18 @@
 <?php namespace de\thekid\dialog\import;
 
+use util\TimeZone;
+
 class Description {
   public function __construct(
     public private(set) array<string, mixed> $meta,
     public private(set) string $content
   ) { }
+
+  public function locations(string|TimeZone $timezone): iterable {
+    $tz= $timezone instanceof TimeZone ? $timezone->name() : $timezone;
+    foreach (isset($this->meta['location']) ? [$this->meta['location']] : $this->meta['locations'] as $location) {
+      $location['timezone']??= $tz;
+      yield $location;
+    }
+  }
 }

src/test/php/de/thekid/dialog/unittest/DescriptionsTest.php

@@ -46,7 +46,24 @@ public function parse_content() {
   public function resolve_timezone($tz, $resolved) {
     Assert::equals(
       ['date' => new Date('2024-12-29 13:19:00', $resolved)],
-      $this->parse("---\ndate: 2024-12-29 13:19:00 {$tz}\n---\nContent")->meta
+      $this->parse("---\ndate: 2024-12-29 13:19:00 {$tz}\n---\n")->meta
+    );
+  }
+
+  #[Test, Values(['Europe/Berlin', 'Asia/Muscat', 'America/New_York'])]
+  public function location_timezone($tz) {
+    $locations= implode("\n", [
+      '  - {name: "Here"}',
+      '  - {name: "Oman", timezone: "Asia/Muscat"}',
+      '  - {name: "日本", timezone: "Asia/Tokyo"}',
+    ]);
+    Assert::equals(
+      [
+        ['name' => 'Here', 'timezone' => $tz],
+        ['name' => 'Oman', 'timezone' => 'Asia/Muscat'],
+        ['name' => '日本', 'timezone' => 'Asia/Tokyo'],
+      ],
+      [...$this->parse("---\nlocations:\n{$locations}\n---\n")->locations($tz)]
     );
   }
 }