Use named route to have a single place of truth

Author: alies-dev

resources/js/components/Card.vue

@@ -65,7 +65,7 @@
         methods: {
             getTime() {
                 Nova.request()
-                    .post('/nova-vendor/worldclock/timezones', {
+                    .post(this.card.refreshRoute, {
                         timezones: this.card.timezones,
                         timeFormat: this.card.timeFormat,
                         nightHours: this.card.nightHours,

routes/api.php

@@ -14,8 +14,4 @@
 |
 */
 
-// Route::get('/endpoint', function (Request $request) {
-//     //
-// });
-
-Route::post('/timezones', [WorldClockController::class, 'timezones']);
+Route::post('/timezones', [WorldClockController::class, 'timezones'])->name('nova.cards.worldClock.refresh');

src/WorldClock.php

@@ -2,14 +2,12 @@
 
 namespace InteractionDesignFoundation\WorldClockCard;
 
-use Illuminate\Support\Carbon;
 use Laravel\Nova\Card;
 
 class WorldClock extends Card
 {
     /**
      * The width of the card (1/3, 1/2, or full).
-     *
      * @var string
      */
     public $width = '1/3';
@@ -27,12 +25,12 @@ public function __construct($component = null)
         $this->withMeta([
             'timezoneDescriptions' => [],
             'nightHours' => [19, 6],
+            'refreshRoute' => route('nova.cards.worldClock.refresh')
         ]);
     }
 
     /**
      * Get the component name for the element.
-     *
      * @return string
      */
     public function component()
@@ -41,23 +39,21 @@ public function component()
     }
 
     /**
-     * @param array $timezones
+     * @param list<string> $timezones
      * @return $this
      */
-    public function timezones(array $timezones)
+    public function timezones(array $timezones): static
     {
         return $this->withMeta([
             'timezones' => $timezones,
         ]);
     }
 
     /**
-     * @see https://www.php.net/manual/en/function.date.php
-     *
-     * @param string $timeFormat
+     * @param string $timeFormat Time, compatiable with date()function, {@see https://www.php.net/manual/en/function.date.php}
      * @return $this
      */
-    public function timeFormat(string $timeFormat)
+    public function timeFormat(string $timeFormat): static
     {
         return $this->withMeta([
             'timeFormat' => $timeFormat,
@@ -66,12 +62,11 @@ public function timeFormat(string $timeFormat)
 
     /**
      * Specify hours range: when a night starts and ends
-     *
      * @param int $nightStart
      * @param int $nightEnd
      * @return $this
      */
-    public function nightRange(int $nightStart, int $nightEnd)
+    public function nightRange(int $nightStart, int $nightEnd): static
     {
         return $this->withMeta([
             'nightHours' => [$nightStart, $nightEnd],
@@ -84,20 +79,15 @@ public function nightRange(int $nightStart, int $nightEnd)
      * @param bool $hideContinents
      * @return $this
      */
-    public function hideContinents(bool $hideContinents = true)
+    public function hideContinents(bool $hideContinents = true): static
     {
         return $this->withMeta([
             'hideContinents' => $hideContinents,
         ]);
     }
 
-    /**
-     * How often to fetch new data from server
-     *
-     * @param int $ms
-     * @return $this
-     */
-    public function updatePeriod(int $ms = 1000)
+    /** How often to fetch new data from server */
+    public function updatePeriod(int $ms = 1000): static
     {
         return $this->withMeta([
             'ms' => $ms,
@@ -106,11 +96,10 @@ public function updatePeriod(int $ms = 1000)
 
     /**
      * Add text description to timezones. Format: ['tzName' => 'Text description']
-     *
-     * @param array $descriptions
+     * @param array<string, string> $descriptions
      * @return $this
      */
-    public function timezoneDescriptions(array $descriptions)
+    public function timezoneDescriptions(array $descriptions): static
     {
         return $this->withMeta([
             'timezoneDescriptions' => $descriptions,