Added JSString::fromCharCode and fromCodePoint

Author: fadrian06

composer.json

@@ -78,6 +78,7 @@
       "src/Globals/Symbol.php",
       "src/Globals/NaN.php",
       "src/Globals/jsEval.php",
+      "src/Globals/RangeError.php",
       "src/constants.php",
       "src/VarDate.php",
       "src/DOM/console.php"

jsphp.sublime-project

@@ -31,6 +31,7 @@
       "formatters": {
         "source.json.sublime": "LSP-json",
         "source.json.composer": "LSP-json",
+        "source.js": "LSP-biome",
       },
     },
     "SublimeLinter.linters.phpstan.disable": true,
@@ -48,7 +49,7 @@
     {
       "name": "Lint - HARD",
       "shell_cmd": "php composer.phar lint -- --no-ansi -lmax",
-      "quiet": true
+      "quiet": true,
     },
     {
       "name": "Lint - Save errors",
@@ -68,11 +69,11 @@
     {
       "name": "Download composer",
       "shell_cmd": "php -r \"if (!file_exists('composer.phar')) { echo '⌛ Downloading composer.phar...', PHP_EOL; `curl -s -O https://getcomposer.org/download/2.2.22/composer.phar`; echo '✓ Download completed', PHP_EOL; }\"",
-      "quiet": true
+      "quiet": true,
     },
     {
       "name": "Install dependencies",
-      "shell_cmd": "npm i & php -r \"if (file_exists('composer.lock')) unlink('composer.lock');\" & php composer.phar install --no-progress --no-ansi"
+      "shell_cmd": "npm i & php -r \"if (file_exists('composer.lock')) unlink('composer.lock');\" & php composer.phar install --no-progress --no-ansi",
     }
   ],
   "debugger_configurations": [],

src/Globals/JSString.php

@@ -351,6 +351,25 @@ function anchor(string $name): self {
 
     return new self("<a name=\"$name\">$this->value</a>");
   }
+
+  static function fromCharCode(int ...$codes): self {
+    return new self(join('', array_map('mb_chr', $codes)));
+  }
+
+  /**
+   * Return the String value whose elements are, in order, the elements in the List elements.
+   * If length is 0, the empty string is returned.
+   * @param int|float ...$codePoints
+   */
+  static function fromCodePoint(...$codePoints): self {
+    return new self(join('', array_map(static function ($codePoint): string {
+      if (!is_int($codePoint)) {
+        throw new RangeError;
+      }
+
+      return mb_chr($codePoint);
+    }, $codePoints)));
+  }
 }
 
 /**

src/Globals/RangeError.php

@@ -0,0 +1,6 @@
+<?php
+
+declare(strict_types=1);
+
+final class RangeError extends Error {
+}

tests/PHP/JSString/fromCharCodeTest.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\PHP\JSString;
+
+use JSString;
+use PHPUnit\Framework\TestCase;
+
+final class fromCharCodeTest extends TestCase {
+  function test_Demo_String_fromCharCode(): void {
+    self::assertSame('½+¾=', (string) JSString::fromCharCode(189, 43, 190, 61));
+  }
+
+  function test_Using_fromCharCode(): void {
+    // BMP characters, in UTF-16, use a single code unit:
+
+    self::assertSame('ABC', (string) JSString::fromCharCode(65, 66, 67));
+    self::assertSame('—', (string) JSString::fromCharCode(0x2014));
+
+    // also returns "—"; the digit 1 is truncated and ignored
+    // self::assertSame('—', (string) JSString::fromCharCode(0x12014));
+
+    // also returns "—"; 8212 is the decimal form of 0x2014
+    self::assertSame('—', (string) JSString::fromCharCode(8212));
+
+    // Supplementary characters, in UTF-16, require two code units (i.e. a surrogate pair):
+
+    // Code Point U+1F303 "Night with
+    // self::assertSame('🌃', (string) JSString::fromCharCode(0xd83c, 0xdf03));
+
+    // Stars" === "\uD83C\uDF03"
+    // self::assertSame('🌃', (string) JSString::fromCharCode(55356, 57091));
+
+    // "\uD834\uDF06a\uD834\uDF07"
+    /*self::assertSame('𝌆a𝌇', (string) JSString::fromCharCode(
+      0xd834,
+      0xdf06,
+      0x61,
+      0xd834,
+      0xdf07
+    ));*/
+  }
+}

tests/PHP/JSString/fromCodePointTest.php

@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\PHP\JSString;
+
+use JSString;
+use PHPUnit\Framework\TestCase;
+use RangeError;
+
+final class fromCodePointTest extends TestCase {
+  function test_Demo_String_fromCodePoint(): void {
+    self::assertSame(
+      '☃★♲你',
+      (string) JSString::fromCodePoint(9731, 9733, 9842, 0x2f804)
+    );
+  }
+
+  function test_Using_fromCodePoint(): void {
+    // Valid input:
+    self::assertSame('*', (string) JSString::fromCodePoint(42));
+    self::assertSame('AZ', (string) JSString::fromCodePoint(65, 90));
+    self::assertSame('Є', (string) JSString::fromCodePoint(0x404));
+    self::assertSame('你', (string) JSString::fromCodePoint(0x2f804));
+    self::assertSame('你', (string) JSString::fromCodePoint(194564));
+    self::assertSame('𝌆a𝌇', (string) JSString::fromCodePoint(0x1d306, 0x61, 0x1d307));
+
+    // Invalid input:
+    self::expectException(RangeError::class);
+    JSString::fromCodePoint('_');
+    JSString::fromCodePoint(Infinity);
+    JSString::fromCodePoint(-1);
+    JSString::fromCodePoint(3.14);
+    JSString::fromCodePoint(3e-2);
+    JSString::fromCodePoint(NaN);
+  }
+
+  function test_Compared_to_fromCharCode(): void {
+    /*
+    String.fromCharCode() cannot return supplementary characters (i.e. code
+    points 0x010000 – 0x10FFFF) by specifying their code point. Instead, it
+    requires the UTF-16 surrogate pair in order to return a supplementary
+    character:
+     */
+    // self::assertSame('🌃', (string) JSString::fromCodePoint(0xd83c, 0xdf03));
+    // self::assertSame('🌃', (string) JSString::fromCodePoint(55356, 57091));
+
+    /*
+    String.fromCodePoint(), on the other hand, can return 4-byte supplementary
+    characters, as well as the more common 2-byte BMP characters, by specifying
+    their code point (which is equivalent to the UTF-32 code unit):
+     */
+    self::assertSame('🌃', (string) JSString::fromCodePoint(0x1f303));
+  }
+}