Merge branch 'release/v0.1.1' into main

CHANGELOG.md

@@ -1,2 +1,5 @@
+## v0.1.1 (2022-11-28)
+* Imported time and number plugins from Dictum
+
 ## v0.1.0 (2022-11-28)
 * Built initial locale and timezone management

composer.json

@@ -10,6 +10,8 @@
     }],
     "require": {
         "php": "^8.0",
+        "ext-intl": "*",
+
         "decodelabs/exceptional": "^0.4.3",
         "decodelabs/glitch-support": "^0.4.3",
         "decodelabs/veneer": "^0.10.16"

src/Cosmos/Context.php

@@ -12,6 +12,7 @@
 use DateTimeZone as Timezone;
 use DecodeLabs\Veneer;
 use DecodeLabs\Veneer\Plugin;
+use IntlTimeZone;
 use Locale as SysLocale;
 
 class Context
@@ -62,6 +63,30 @@ public function getLocale(): Locale
         return $this->locale;
     }
 
+    /**
+     * Normalize locale
+     */
+    public function normalizeLocale(
+        string|Locale|null $locale = null
+    ): Locale {
+        if ($locale === null) {
+            $locale = $this->getLocale();
+        } elseif (is_string($locale)) {
+            $locale = new Locale($locale);
+        }
+
+        return $locale;
+    }
+
+    /**
+     * Normalize locale
+     */
+    public function normalizeLocaleString(
+        string|Locale|null $locale = null
+    ): string {
+        return (string)$this->normalizeLocale($locale);
+    }
+
 
 
     /**
@@ -73,11 +98,61 @@ public function setTimezone(
         string|Timezone $timezone
     ): static {
         if (!$timezone instanceof Timezone) {
-            $timezone = new Timezone($timezone);
+            $timezone = $this->createTimezone($timezone);
         }
 
         $this->timezone = $timezone;
 
         return $this;
     }
+
+    /**
+     * Get timezone
+     */
+    public function getTimezone(): Timezone
+    {
+        return $this->timezone;
+    }
+
+    /**
+     * Normalize timezone
+     */
+    public function normalizeTimezone(
+        string|Timezone|null $timezone
+    ): Timezone {
+        if ($timezone === null) {
+            $timezone = $this->getTimezone();
+        } elseif (is_string($timezone)) {
+            $timezone = $this->createTimezone($timezone);
+        }
+
+        return $timezone;
+    }
+
+    /**
+     * Normalize timezone
+     */
+    public function normalizeTimezoneString(
+        string|Timezone|null $timezone
+    ): string {
+        return $this->normalizeTimezone($timezone)->getName();
+    }
+
+    /**
+     * Parse and create DateTimeZone
+     */
+    protected function createTimezone(string $timezone): Timezone
+    {
+        if (preg_match('/^[a-z]{3}$/', $timezone)) {
+            $timezone = strtoupper($timezone);
+        } elseif (preg_match('|^([a-z\-]+)/([a-z\-]+)$|', $timezone, $matches)) {
+            $timezone = ucfirst($matches[1]) . '/' . ucfirst($matches[2]);
+        }
+
+        if (false !== ($canon = IntlTimeZone::getCanonicalID($timezone))) {
+            $timezone = $canon;
+        }
+
+        return new Timezone($timezone);
+    }
 }

src/Cosmos/Extension/Number.php

@@ -0,0 +1,123 @@
+<?php
+
+/**
+ * @package Cosmos
+ * @license http://opensource.org/licenses/MIT
+ */
+
+declare(strict_types=1);
+
+namespace DecodeLabs\Cosmos\Extension;
+
+use DecodeLabs\Cosmos\Locale;
+
+/**
+ * @template TReturn
+ */
+interface Number
+{
+    /**
+     * @phpstan-return ($value is null ? null : TReturn)
+     */
+    public function format(
+        int|float|string|null $value,
+        ?string $unit = null,
+        string|Locale|null $locale = null
+    ): mixed;
+
+    /**
+     * @phpstan-return ($value is null ? null : TReturn)
+     */
+    public function pattern(
+        int|float|string|null $value,
+        string $pattern,
+        string|Locale|null $locale = null
+    ): mixed;
+
+    /**
+     * @phpstan-return ($value is null ? null : TReturn)
+     */
+    public function decimal(
+        int|float|string|null $value,
+        ?int $precision = null,
+        string|Locale|null $locale = null
+    ): mixed;
+
+    /**
+     * @phpstan-return ($value is null ? null : TReturn)
+     */
+    public function currency(
+        int|float|string|null $value,
+        ?string $code,
+        ?bool $rounded = null,
+        string|Locale|null $locale = null
+    ): mixed;
+
+    /**
+     * @phpstan-return ($value is null ? null : TReturn)
+     */
+    public function percent(
+        int|float|string|null $value,
+        float $total = 100.0,
+        int $decimals = 0,
+        string|Locale|null $locale = null
+    ): mixed;
+
+    /**
+     * @phpstan-return ($value is null ? null : TReturn)
+     */
+    public function scientific(
+        int|float|string|null $value,
+        string|Locale|null $locale = null
+    ): mixed;
+
+    /**
+     * @phpstan-return ($value is null ? null : TReturn)
+     */
+    public function spellout(
+        int|float|string|null $value,
+        string|Locale|null $locale = null
+    ): mixed;
+
+    /**
+     * @phpstan-return ($value is null ? null : TReturn)
+     */
+    public function ordinal(
+        int|float|string|null $value,
+        string|Locale|null $locale = null
+    ): mixed;
+
+    /**
+     * @phpstan-return ($diff is null ? null : TReturn)
+     */
+    public function diff(
+        int|float|string|null $diff,
+        ?bool $invert = false,
+        string|Locale|null $locale = null
+    ): mixed;
+
+    /**
+     * @phpstan-return ($bytes is null ? null : TReturn)
+     */
+    public function fileSize(
+        ?int $bytes,
+        string|Locale|null $locale = null
+    ): mixed;
+
+    /**
+     * @phpstan-return ($bytes is null ? null : TReturn)
+     */
+    public function fileSizeDec(
+        ?int $bytes,
+        string|Locale|null $locale = null
+    ): mixed;
+
+    /**
+     * @phpstan-return ($counter is null ? null : TReturn)
+     */
+    public function counter(
+        int|float|string|null $counter,
+        bool $allowZero = false,
+        string|Locale|null $locale = null
+    ): mixed;
+}