xbintsc 0.3.1 → 0.3.4

package/dist/tests/e2e/harness.js.map

@@ -1 +1 @@
-{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../../tests/e2e/harness.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../../tests/e2e/harness.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xbintsc",
-  "version": "0.3.1",
+  "version": "0.3.4",
   "description": "xbintsc - a TypeScript binary compiler (TypeScript -> LLVM IR -> native binary)",
   "type": "module",
   "license": "MIT",
@@ -38,15 +38,20 @@
     "runtime:clean": "node -e \"require('fs').rmSync('build/runtime-obj',{recursive:true,force:true});require('fs').rmSync('runtime/lib',{recursive:true,force:true})\"",
     "xbintsc": "tsx src/cli/main.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:e2e": "vitest run tests/e2e",
     "coverage": "vitest run --coverage"
   },
   "devDependencies": {
+    "@eslint/js": "^9.39.5",
     "@types/node": "^22.20.4",
+    "@vitest/coverage-v8": "^2.1.9",
+    "eslint": "^9.39.5",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
+    "typescript-eslint": "^8.70.1",
     "vitest": "^2.1.8"
   },
   "engines": {

package/runtime/ext_node/fs/fs_ops.c

@@ -131,11 +131,46 @@ xt_value xt_node_exists(int32_t argc, xt_value *argv) {
 /* readdirSync                                                               */
 /* ------------------------------------------------------------------------- */
 
+/* Defined alongside `statSync` further down; the `Dirent` objects built for
+   `readdirSync(path, { withFileTypes: true })` reuse the same closures. */
+static void xt_fs_define_stat_method(xt_value object, const char *name, unsigned int mode);
+
+/* Build the Node `Dirent`-shaped object (`name` plus stat predicates) for a
+   single directory entry. Types come from `lstat`, matching Node's `d_type`
+   based `Dirent` (a symlink reports `isSymbolicLink()` true). */
+static xt_value xt_node_dirent_result(const char *dir, const char *name) {
+  size_t size = strlen(dir) + strlen(name) + 2;
+  char *full = (char *)malloc(size);
+  unsigned int mode = 0;
+  if (full) {
+    snprintf(full, size, "%s/%s", dir, name);
+    xt_fs_stat_t info;
+    if (xt_fs_lstat_fn(full, &info) == 0) mode = (unsigned int)info.st_mode;
+    free(full);
+  }
+
+  xt_value object = xt_object_new();
+  xt_object_set(object, xt_string_from_cstr("name"), xt_string_from_cstr(name));
+  xt_fs_define_stat_method(object, "isFile", mode);
+  xt_fs_define_stat_method(object, "isDirectory", mode);
+  xt_fs_define_stat_method(object, "isSymbolicLink", mode);
+  xt_fs_define_stat_method(object, "isFIFO", mode);
+  xt_fs_define_stat_method(object, "isSocket", mode);
+  xt_fs_define_stat_method(object, "isBlockDevice", mode);
+  xt_fs_define_stat_method(object, "isCharacterDevice", mode);
+  return object;
+}
+
 xt_value xt_node_read_dir(int32_t argc, xt_value *argv) {
   if (argc < 1) return xt_undefined();
   const char *path = xt_string_data(xt_to_string(argv[0]));
   if (!path) return xt_undefined();
 
+  /* `readdirSync(path, { withFileTypes: true })` yields `Dirent` objects;
+     without the option the result is a plain array of entry names. */
+  int withFileTypes =
+      argc > 1 && XT_IS_OBJECT(argv[1]) && xt_truthy(xt_object_get_cstr(argv[1], "withFileTypes"));
+
   xt_fs_dir dir;
   if (!xt_fs_dir_open(&dir, path)) {
     xt_fs_error("open directory", path);
@@ -159,7 +194,7 @@ xt_value xt_node_read_dir(int32_t argc, xt_value *argv) {
       if (!grown) break;
       items = grown;
     }
-    items[count++] = xt_string_from_cstr(name);
+    items[count++] = withFileTypes ? xt_node_dirent_result(path, name) : xt_string_from_cstr(name);
   }
   xt_fs_dir_close(&dir);
 

package/runtime/rt.h

@@ -107,6 +107,7 @@ xt_value xt_closure_call(xt_value fn, int32_t argc, xt_value *argv);
 xt_value xt_call_with_this(xt_value fn, xt_value thisValue, int32_t argc, xt_value *argv);
 xt_value xt_closure_env(xt_value fn, int32_t index);
 int32_t xt_closure_arity(xt_value fn);
+xt_value xt_function_set_metadata(xt_value fn, xt_value name, int32_t arity);
 xt_value xt_this(void);
 xt_value xt_new(xt_value ctor, int32_t argc, xt_value *argv);
 xt_value xt_instance_of(xt_value value, xt_value ctor);
@@ -169,6 +170,14 @@ xt_value xt_object_entries(xt_value obj);
 xt_value xt_object_assign(int32_t argc, xt_value *argv);
 xt_value xt_object_spread(xt_value target, xt_value source);
 
+/* -- symbols -------------------------------------------------------------- */
+/** Implements `Symbol(description)`. */
+xt_value xt_symbol(int32_t argc, xt_value *argv);
+/** Implements `Symbol.<name>(...)` statics (`for`, `keyFor`). */
+xt_value xt_symbol_static(xt_value name, int32_t argc, xt_value *argv);
+/** Reads a well-known symbol (`Symbol.iterator`, ...). */
+xt_value xt_symbol_get(xt_value name);
+
 /* -- standard library dispatch -------------------------------------------- */
 /** Call `target[name](...)`, falling back to built-in Array/String methods. */
 xt_value xt_call_method(xt_value target, xt_value name, int32_t argc, xt_value *argv);
@@ -229,6 +238,10 @@ xt_value xt_parse_int(int32_t argc, xt_value *argv);
 xt_value xt_parse_float(int32_t argc, xt_value *argv);
 xt_value xt_is_nan(int32_t argc, xt_value *argv);
 xt_value xt_is_finite(int32_t argc, xt_value *argv);
+xt_value xt_encode_uri_component(int32_t argc, xt_value *argv);
+xt_value xt_encode_uri(int32_t argc, xt_value *argv);
+xt_value xt_decode_uri_component(int32_t argc, xt_value *argv);
+xt_value xt_decode_uri(int32_t argc, xt_value *argv);
 xt_value xt_number_ctor(int32_t argc, xt_value *argv);
 xt_value xt_string_ctor(int32_t argc, xt_value *argv);
 xt_value xt_boolean_ctor(int32_t argc, xt_value *argv);
@@ -263,6 +276,10 @@ xt_value xt_iter_value(xt_value value, xt_value index);
 /* -- generic member access ------------------------------------------------ */
 xt_value xt_get(xt_value target, xt_value key);
 xt_value xt_set(xt_value target, xt_value key, xt_value value);
+/* Materialise a first-class runtime method value (`arr.map`) as an unbound
+ * closure that expects the receiver through `this`. Returns `XT_UNDEFINED` when
+ * `name` is not a method of `target`, so it can be used as a property fallback. */
+xt_value xt_method_value(xt_value target, xt_value name);
 
 /* -- boxes (used for captured variables) ---------------------------------- */
 xt_value xt_box_new(xt_value value);

package/runtime/rt_internal.h

@@ -32,6 +32,7 @@
 
 #include "rt.h"
 
+#include <setjmp.h>
 #include <stddef.h>
 #include <stdint.h>
 
@@ -47,6 +48,9 @@
 #define XT_OBJECT_KIND_REGEXP 9
 #define XT_OBJECT_KIND_SYMBOL 10
 #define XT_OBJECT_KIND_BIGINT 11
+#define XT_OBJECT_KIND_ERROR 12
+#define XT_OBJECT_KIND_GENERATOR 13
+#define XT_OBJECT_KIND_ITERATOR 14
 
 /* Common header for every heap object. */
 typedef struct xt_header {
@@ -74,7 +78,8 @@ typedef struct {
 } xt_bigint;
 
 typedef struct {
-  xt_string *key;
+  /* String or Symbol value (see `xt_to_property_key`). */
+  xt_value key;
   xt_value value;
   /* Accessor properties (`get x()` / `set x(v)`) store the functions here;
    * when set, `value` is ignored and property access invokes the getter. */
@@ -98,6 +103,9 @@ typedef struct {
   uint32_t length;
   uint32_t capacity;
   xt_value *items;
+  /* Named (non-index) properties such as `raw` on template strings or
+   * `index`/`input` on RegExp match results, stored in an `xt_object`. */
+  xt_value extra;
 } xt_array;
 
 typedef struct {
@@ -109,6 +117,9 @@ typedef struct {
   xt_string *name;
   xt_object *properties;
   xt_value prototype;
+  /* Set on generator function objects: calling the closure does not run the
+   * body, it creates a suspended generator (see xt_generator.c). */
+  uint8_t is_generator;
 } xt_function;
 
 /* Allocation (xt_alloc.c). */
@@ -121,6 +132,12 @@ int32_t xt_string_length(xt_string *s);
 int xt_string_equals(xt_string *a, xt_string *b);
 int32_t xt_to_int32(xt_value v);
 
+/* ECMAScript number formatting (xt_values.c). */
+void xt_number_to_js_string(double d, char *buffer, size_t size);
+void xt_number_to_exponential(double d, int precision, char *buffer, size_t size);
+void xt_number_to_precision(double d, int precision, char *buffer, size_t size);
+void xt_number_to_fixed(double d, int precision, char *buffer, size_t size);
+
 /* BigInt runtime (xt_bigint.c). */
 int xt_is_bigint(xt_value value);
 double xt_bigint_to_double_value(xt_value value);
@@ -150,7 +167,19 @@ void xt_array_reserve(xt_array *array, uint32_t needed);
 
 /* Object helpers used by the standard library. */
 xt_object *xt_as_object(xt_value value);
-xt_property *xt_object_find_property(xt_object *obj, xt_string *key);
+xt_property *xt_object_find_property(xt_object *obj, xt_value key);
+
+/* Property keys are either strings or symbols. */
+xt_value xt_to_property_key(xt_value key);
+int xt_property_key_equals(xt_value a, xt_value b);
+
+/* Symbols (xt_symbol.c). */
+int xt_is_symbol(xt_value value);
+xt_value xt_symbol_new(xt_value description);
+xt_value xt_symbol_description(xt_value value);
+xt_value xt_symbol_to_string(xt_value value);
+xt_value xt_symbol_well_known(const char *name);
+xt_value xt_object_own_property_symbols(xt_value value);
 
 /* Map / Set / Promise / Date / RegExp live in xt_stdlib.c and xt_promise.c. */
 int xt_is_promise(xt_value value);
@@ -160,13 +189,66 @@ int xt_is_date(xt_value value);
 int xt_is_regexp(xt_value value);
 int xt_regexp_find(xt_value regexp, xt_value input, int32_t start, int32_t *matchStart, int32_t *matchEnd);
 xt_value xt_regexp_exec(xt_value regexp, xt_value input);
+xt_value xt_regexp_match(xt_value input, xt_value regexp);
 xt_value xt_regexp_replace(xt_value value, xt_value regexp, xt_value replacement);
+xt_value xt_regexp_split(xt_value value, xt_value regexp, xt_value limit);
 xt_value xt_regexp_get_property(xt_value regexp, xt_value key);
 int32_t xt_map_size(xt_value value);
 int32_t xt_set_size(xt_value value);
 /* `for...of` iteration: dispatch over arrays, strings, Maps and Sets. */
 xt_value xt_iter_length(xt_value value);
 xt_value xt_iter_value(xt_value value, xt_value index);
+/* Per-step iteration check. Generators pull the next value here; the index is
+ * ignored because the value is cached until `xt_iter_value` reads it. */
+xt_value xt_iter_has(xt_value value, xt_value index);
+/* Resolve the iteration protocol once: returns `value` for the built-in index
+ * protocols, or a wrapper around `value[Symbol.iterator]()` otherwise. */
+xt_value xt_iter_open(xt_value value);
+
+/* Stackful generators (xt_generator.c). */
+int xt_is_generator(xt_value value);
+xt_value xt_generator_new(xt_value function, xt_value thisValue, int32_t argc, xt_value *argv);
+xt_value xt_generator_next(xt_value generator, xt_value sent);
+xt_value xt_generator_return(xt_value generator, xt_value value);
+xt_value xt_generator_throw(xt_value generator, xt_value error);
+xt_value xt_yield(xt_value value);
+xt_value xt_yield_star(xt_value delegate);
+int xt_generator_has_next(xt_value generator);
+xt_value xt_generator_iter_value(xt_value generator);
+
+/* Exception-frame plumbing shared with the generator runtime. The struct is
+ * public so a coroutine can `_setjmp` its own boundary directly (a `setjmp`
+ * must run in the frame it returns to, never in a helper). */
+typedef struct xt_try_frame {
+  jmp_buf buf;
+  struct xt_try_frame *prev;
+  xt_value exception;
+} xt_try_frame;
+/* Call `_setjmp` the way the active `<setjmp.h>` declares it. The two Windows
+ * C runtimes differ:
+ *
+ *  - MSVC/UCRT declares `_setjmp(jmp_buf)` with one visible argument and lets
+ *    clang treat it as a built-in that injects the caller's frame address
+ *    (`@llvm.frameaddress(0)`) as a hidden second argument. Writing the frame
+ *    by hand is a compile error ("too many arguments to function call").
+ *  - MinGW-w64 (the vendored llvm-mingw toolchain) declares
+ *    `_setjmp(jmp_buf, void *frame)` itself, so the frame must be passed
+ *    explicitly -- exactly what its own `setjmp` macro does.
+ *
+ * The generated IR always emits the two-argument form, because it is already
+ * IR and clang will not rewrite it. `_setjmp` (rather than the `setjmp` macro)
+ * is used so it pairs with the plain `longjmp` in `xt_throw`. */
+#if defined(_WIN32) && !defined(__MINGW32__)
+#define xt_try_setjmp(framePtr) _setjmp(((xt_try_frame *)(framePtr))->buf)
+#elif defined(_WIN32) && defined(__aarch64__)
+#define xt_try_setjmp(framePtr) _setjmpex(((xt_try_frame *)(framePtr))->buf, __builtin_sponentry())
+#elif defined(_WIN32)
+#define xt_try_setjmp(framePtr) _setjmp(((xt_try_frame *)(framePtr))->buf, __builtin_frame_address(0))
+#else
+#define xt_try_setjmp(framePtr) _setjmp(((xt_try_frame *)(framePtr))->buf)
+#endif
+void *xt_try_mark(void);
+void xt_try_restore(void *mark);
 
 /* -- collection / date / regexp representations --------------------------- */
 typedef struct {
@@ -201,6 +283,10 @@ xt_value xt_ext_array_method(xt_value target, const char *method, int32_t argc,
 xt_value xt_ext_string_method(xt_value target, const char *method, int32_t argc, xt_value *argv, int *handled);
 xt_value xt_ext_number_method(xt_value target, const char *method, int32_t argc, xt_value *argv, int *handled);
 xt_value xt_ext_object_method(xt_value target, const char *method, int32_t argc, xt_value *argv, int *handled);
+
+/* Error family helpers (xt_stdlib2.c). */
+xt_value xt_error_to_string(xt_value error);
+xt_value xt_aggregate_error_ctor(int32_t argc, xt_value *argv);
 xt_value xt_ext_container_method(xt_value target, const char *method, int32_t argc, xt_value *argv, int *handled);
 xt_value xt_promise_method(xt_value target, const char *method, int32_t argc, xt_value *argv, int *handled);
 

package/runtime/xt_builtins.c

@@ -8,6 +8,7 @@
 #include "rt_internal.h"
 
 #include <math.h>
+#include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
 
@@ -19,7 +20,9 @@ xt_value xt_object_values(xt_value value) {
   xt_value result = xt_array_new(0, NULL);
   if (!XT_IS_OBJECT(value)) return result;
   xt_object *obj = (xt_object *)XT_GET_PTR(value);
-  for (uint32_t i = 0; i < obj->count; i++) xt_array_push(result, obj->properties[i].value);
+  for (uint32_t i = 0; i < obj->count; i++) {
+    if (XT_IS_STRING(obj->properties[i].key)) xt_array_push(result, obj->properties[i].value);
+  }
   return result;
 }
 
@@ -28,8 +31,9 @@ xt_value xt_object_entries(xt_value value) {
   if (!XT_IS_OBJECT(value)) return result;
   xt_object *obj = (xt_object *)XT_GET_PTR(value);
   for (uint32_t i = 0; i < obj->count; i++) {
+    if (!XT_IS_STRING(obj->properties[i].key)) continue;
     xt_value pair = xt_array_new(0, NULL);
-    xt_array_push(pair, XT_FROM_PTR(XT_TAG_STRING, obj->properties[i].key));
+    xt_array_push(pair, obj->properties[i].key);
     xt_array_push(pair, obj->properties[i].value);
     xt_array_push(result, pair);
   }
@@ -44,7 +48,7 @@ xt_value xt_object_assign(int32_t argc, xt_value *argv) {
     if (!XT_IS_OBJECT(argv[i])) continue;
     xt_object *source = (xt_object *)XT_GET_PTR(argv[i]);
     for (uint32_t j = 0; j < source->count; j++) {
-      xt_object_set(target, XT_FROM_PTR(XT_TAG_STRING, source->properties[j].key), source->properties[j].value);
+      xt_object_set(target, source->properties[j].key, source->properties[j].value);
     }
   }
   return target;
@@ -119,6 +123,140 @@ xt_value xt_is_finite(int32_t argc, xt_value *argv) {
   return xt_bool(!isnan(value) && !isinf(value));
 }
 
+/* ------------------------------------------------------------------------- */
+/* URI encoding / decoding (ECMAScript 19.2.6)                               */
+/* ------------------------------------------------------------------------- */
+
+static _Noreturn void xt_throw_uri_error(const char *message) {
+  char buffer[96];
+  snprintf(buffer, sizeof(buffer), "URIError: %s", message);
+  xt_throw(xt_string_from_cstr(buffer));
+  abort();
+}
+
+static int xt_uri_is_kept(const char *allowed, unsigned char c) {
+  return c < 0x80 && c != 0 && strchr(allowed, (int)c) != NULL;
+}
+
+static xt_value xt_uri_encode(xt_value input, const char *allowed) {
+  xt_string *s = xt_as_string(xt_to_string(input));
+  static const char hex[] = "0123456789ABCDEF";
+  char *out = (char *)malloc((size_t)s->length * 3 + 1);
+  if (!out) {
+    fprintf(stderr, "xbintsc: out of memory\n");
+    abort();
+  }
+  size_t written = 0;
+  for (uint32_t i = 0; i < s->length; i++) {
+    unsigned char c = (unsigned char)s->data[i];
+    if (xt_uri_is_kept(allowed, c)) {
+      out[written++] = (char)c;
+    } else {
+      out[written++] = '%';
+      out[written++] = hex[(c >> 4) & 0xF];
+      out[written++] = hex[c & 0xF];
+    }
+  }
+  xt_value result = xt_string_new(out, written);
+  free(out);
+  return result;
+}
+
+static int xt_hex_value(int c) {
+  if (c >= '0' && c <= '9') return c - '0';
+  if (c >= 'A' && c <= 'F') return c - 'A' + 10;
+  if (c >= 'a' && c <= 'f') return c - 'a' + 10;
+  return -1;
+}
+
+/* Decode percent-escapes as UTF-8. When `component` is false (`decodeURI`),
+ * escapes for reserved characters are copied through unchanged. */
+static xt_value xt_uri_decode(xt_value input, int component) {
+  xt_string *s = xt_as_string(xt_to_string(input));
+  char *out = (char *)malloc((size_t)s->length + 1);
+  if (!out) {
+    fprintf(stderr, "xbintsc: out of memory\n");
+    abort();
+  }
+  size_t written = 0;
+  uint32_t i = 0;
+  while (i < s->length) {
+    unsigned char c = (unsigned char)s->data[i];
+    if (c != '%') {
+      out[written++] = (char)c;
+      i++;
+      continue;
+    }
+    if (i + 2 >= s->length) xt_throw_uri_error("URI malformed");
+    int h1 = xt_hex_value((unsigned char)s->data[i + 1]);
+    int h2 = xt_hex_value((unsigned char)s->data[i + 2]);
+    if (h1 < 0 || h2 < 0) xt_throw_uri_error("URI malformed");
+    unsigned char b = (unsigned char)((h1 << 4) | h2);
+    if (b < 0x80) {
+      if (!component && xt_uri_is_kept(";/?:@&=+$,#", b)) {
+        out[written++] = s->data[i];
+        out[written++] = s->data[i + 1];
+        out[written++] = s->data[i + 2];
+      } else {
+        out[written++] = (char)b;
+      }
+      i += 3;
+      continue;
+    }
+    int extra;
+    if (b >= 0xC2 && b <= 0xDF) extra = 1;
+    else if (b >= 0xE0 && b <= 0xEF) extra = 2;
+    else if (b >= 0xF0 && b <= 0xF4) extra = 3;
+    else xt_throw_uri_error("URI malformed");
+    char seq[4];
+    seq[0] = (char)b;
+    for (int k = 1; k <= extra; k++) {
+      uint32_t pos = i + (uint32_t)k * 3;
+      if (pos + 2 >= s->length) xt_throw_uri_error("URI malformed");
+      if (s->data[pos] != '%') xt_throw_uri_error("URI malformed");
+      int c1 = xt_hex_value((unsigned char)s->data[pos + 1]);
+      int c2 = xt_hex_value((unsigned char)s->data[pos + 2]);
+      if (c1 < 0 || c2 < 0) xt_throw_uri_error("URI malformed");
+      unsigned char cb = (unsigned char)((c1 << 4) | c2);
+      if ((cb & 0xC0) != 0x80) xt_throw_uri_error("URI malformed");
+      seq[k] = (char)cb;
+    }
+    uint32_t codePoint;
+    if (extra == 1) codePoint = ((uint32_t)(b & 0x1F) << 6) | ((uint32_t)seq[1] & 0x3F);
+    else if (extra == 2)
+      codePoint = ((uint32_t)(b & 0x0F) << 12) | (((uint32_t)seq[1] & 0x3F) << 6) | ((uint32_t)seq[2] & 0x3F);
+    else
+      codePoint = ((uint32_t)(b & 0x07) << 18) | (((uint32_t)seq[1] & 0x3F) << 12) |
+                  (((uint32_t)seq[2] & 0x3F) << 6) | ((uint32_t)seq[3] & 0x3F);
+    uint32_t minimum = extra == 1 ? 0x80u : (extra == 2 ? 0x800u : 0x10000u);
+    if (codePoint < minimum || codePoint > 0x10FFFF || (codePoint >= 0xD800 && codePoint <= 0xDFFF))
+      xt_throw_uri_error("URI malformed");
+    for (int k = 0; k <= extra; k++) out[written++] = seq[k];
+    i += (uint32_t)(extra + 1) * 3;
+  }
+  xt_value result = xt_string_new(out, written);
+  free(out);
+  return result;
+}
+
+xt_value xt_encode_uri_component(int32_t argc, xt_value *argv) {
+  return xt_uri_encode(xt_arg_at(argc, argv, 0),
+                       "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_.!~*'()");
+}
+
+xt_value xt_encode_uri(int32_t argc, xt_value *argv) {
+  return xt_uri_encode(xt_arg_at(argc, argv, 0),
+                       "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_.!~*'();,/?:@&=+$#");
+}
+
+xt_value xt_decode_uri_component(int32_t argc, xt_value *argv) {
+  return xt_uri_decode(xt_arg_at(argc, argv, 0), /* component */ 1);
+}
+
+xt_value xt_decode_uri(int32_t argc, xt_value *argv) {
+  return xt_uri_decode(xt_arg_at(argc, argv, 0), /* component */ 0);
+}
+
 xt_value xt_number_ctor(int32_t argc, xt_value *argv) {
   if (argc == 0) return xt_number(0);
   return xt_number(xt_to_number(argv[0]));
@@ -126,6 +264,7 @@ xt_value xt_number_ctor(int32_t argc, xt_value *argv) {
 
 xt_value xt_string_ctor(int32_t argc, xt_value *argv) {
   if (argc == 0) return xt_string_from_cstr("");
+  if (xt_is_symbol(argv[0])) return xt_symbol_to_string(argv[0]);
   return xt_to_string(argv[0]);
 }
 
@@ -153,18 +292,29 @@ XT_BUILTIN_TRAMPOLINE(xt_builtin_value_boolean, xt_boolean_ctor)
 XT_BUILTIN_TRAMPOLINE(xt_builtin_value_number, xt_number_ctor)
 XT_BUILTIN_TRAMPOLINE(xt_builtin_value_bigint, xt_bigint_ctor)
 XT_BUILTIN_TRAMPOLINE(xt_builtin_value_string, xt_string_ctor)
+XT_BUILTIN_TRAMPOLINE(xt_builtin_value_symbol, xt_symbol)
 XT_BUILTIN_TRAMPOLINE(xt_builtin_value_parseInt, xt_parse_int)
 XT_BUILTIN_TRAMPOLINE(xt_builtin_value_parseFloat, xt_parse_float)
 XT_BUILTIN_TRAMPOLINE(xt_builtin_value_isNaN, xt_is_nan)
 XT_BUILTIN_TRAMPOLINE(xt_builtin_value_isFinite, xt_is_finite)
+XT_BUILTIN_TRAMPOLINE(xt_builtin_value_encodeURIComponent, xt_encode_uri_component)
+XT_BUILTIN_TRAMPOLINE(xt_builtin_value_encodeURI, xt_encode_uri)
+XT_BUILTIN_TRAMPOLINE(xt_builtin_value_decodeURIComponent, xt_decode_uri_component)
+XT_BUILTIN_TRAMPOLINE(xt_builtin_value_decodeURI, xt_decode_uri)
 
 xt_value xt_in(xt_value key, xt_value value) {
   if (XT_IS_OBJECT(value)) return xt_object_has(value, key);
   if (XT_IS_ARRAY(value)) {
+    if (xt_is_symbol(key)) {
+      xt_array *array = (xt_array *)XT_GET_PTR(value);
+      if (!XT_IS_OBJECT(array->extra)) return XT_FALSE;
+      return xt_object_has_own(array->extra, key);
+    }
     int32_t index = xt_to_int32(key);
     return xt_bool(index >= 0 && (uint32_t)index < xt_as_array(value)->length);
   }
   if (XT_IS_STRING(value)) {
+    if (xt_is_symbol(key)) return XT_FALSE;
     xt_string *s = xt_as_string(value);
     xt_string *k = xt_as_string(xt_to_string(key));
     if (k->length == 6 && memcmp(k->data, "length", 6) == 0) return XT_TRUE;
@@ -177,9 +327,9 @@ xt_value xt_in(xt_value key, xt_value value) {
 xt_value xt_delete(xt_value value, xt_value key) {
   if (XT_IS_OBJECT(value)) {
     xt_object *obj = (xt_object *)XT_GET_PTR(value);
-    xt_string *k = xt_as_string(xt_to_string(key));
+    xt_value k = xt_to_property_key(key);
     for (uint32_t i = 0; i < obj->count; i++) {
-      if (xt_string_equals(obj->properties[i].key, k)) {
+      if (xt_property_key_equals(obj->properties[i].key, k)) {
         for (uint32_t j = i + 1; j < obj->count; j++) obj->properties[j - 1] = obj->properties[j];
         obj->count--;
         break;
@@ -188,7 +338,7 @@ xt_value xt_delete(xt_value value, xt_value key) {
     return XT_TRUE;
   }
   if (XT_IS_ARRAY(value)) {
-    xt_array_set(value, key, XT_UNDEFINED);
+    if (!xt_is_symbol(key)) xt_array_set(value, key, XT_UNDEFINED);
     return XT_TRUE;
   }
   return XT_TRUE;
@@ -216,6 +366,7 @@ xt_value xt_closure_new(void *fn, int32_t env_count, xt_value *env) {
   function->code = (xt_code_fn)fn;
   function->environment_count = env_count;
   function->arity = -1;
+  function->name = NULL;
   function->properties = NULL;
   function->environment = NULL;
   function->prototype = XT_UNDEFINED;
@@ -236,6 +387,9 @@ xt_value xt_call_with_this(xt_value value, xt_value thisValue, int32_t argc, xt_
     return XT_UNDEFINED;
   }
   xt_function *function = (xt_function *)XT_GET_PTR(value);
+  /* Calling a generator function returns a suspended generator instead of
+   * running the body. */
+  if (function->is_generator) return xt_generator_new(value, thisValue, argc, argv);
   /* The closure value itself is threaded through as `env` so the callee can
    * read its captures with xt_closure_env(env, i). */
   return function->code(thisValue, value, argc, argv);
@@ -248,6 +402,11 @@ xt_value xt_function_set_prototype(xt_value value, xt_value proto) {
   return value;
 }
 
+xt_value xt_function_set_generator(xt_value value) {
+  if (XT_IS_FUNCTION(value)) ((xt_function *)XT_GET_PTR(value))->is_generator = 1;
+  return value;
+}
+
 xt_value xt_function_get_prototype(xt_value value) {
   if (XT_IS_FUNCTION(value)) return ((xt_function *)XT_GET_PTR(value))->prototype;
   return XT_UNDEFINED;
@@ -294,3 +453,12 @@ int32_t xt_closure_arity(xt_value value) {
   return ((xt_function *)XT_GET_PTR(value))->arity;
 }
 
+xt_value xt_function_set_metadata(xt_value value, xt_value name, int32_t arity) {
+  if (XT_IS_FUNCTION(value)) {
+    xt_function *function = (xt_function *)XT_GET_PTR(value);
+    function->arity = arity;
+    function->name = XT_IS_STRING(name) ? xt_as_string(name) : NULL;
+  }
+  return value;
+}
+