@suchipi/quickjs 0.4.0 → 0.4.2

package/.gitmodules

@@ -0,0 +1,6 @@
+[submodule "src/run-test262/test262"]
+	path = src/run-test262/test262
+	url = https://github.com/tc39/test262.git
+[submodule "src/run-test262/test262o"]
+	path = src/run-test262/test262o
+	url = https://github.com/tc39/test262.git

package/build/dts/quickjs-libc.d.ts

@@ -1044,111 +1044,6 @@ declare module "quickjs:os" {
   export function chmod(path: string, mode: number): void;
 }
 
-/**
- * Options for {@link inspect}.
- */
-declare interface InspectOptions {
-  /** Whether to display non-enumerable properties. Defaults to false. */
-  all?: boolean;
-
-  /** Whether to invoke getter functions. Defaults to false. */
-  followGetters?: boolean;
-
-  /** Whether to display the indexes of iterable entries. Defaults to false. */
-  indexes?: boolean;
-
-  /** Hide object details after 𝑁 recursions. Defaults to Infinity. */
-  maxDepth?: number;
-
-  /** If true, don't identify well-known symbols as `@@…`. Defaults to false. */
-  noAmp?: boolean;
-
-  /** If true, don't format byte-arrays as hexadecimal. Defaults to false. */
-  noHex?: boolean;
-
-  /** If true, don't display function source code. Defaults to false. */
-  noSource?: boolean;
-
-  /** Whether to show `__proto__` properties if possible. Defaults to false. */
-  proto?: boolean;
-
-  /** Whether to sort properties alphabetically. When false, properties are sorted by creation order. Defaults to false. */
-  sort?: boolean;
-
-  /** Options that control whether and how ANSI terminal escape sequences for colours should be added to the output. Defaults to false, meaning no colours. */
-  colours?: boolean | 256 | 8 | InspectColours;
-
-  /** Prefix string to use for indentation. Defaults to '\t'. */
-  indent?: string;
-}
-
-declare interface InspectColours {
-  off?: string | number;
-  red?: string | number;
-  grey?: string | number;
-  green?: string | number;
-  darkGreen?: string | number;
-  punct?: string | number;
-  keys?: string | number;
-  keyEscape?: string | number;
-  typeColour?: string | number;
-  primitive?: string | number;
-  escape?: string | number;
-  date?: string | number;
-  hexBorder?: string | number;
-  hexValue?: string | number;
-  hexOffset?: string | number;
-  reference?: string | number;
-  srcBorder?: string | number;
-  srcRowNum?: string | number;
-  srcRowText?: string | number;
-  nul?: string | number;
-  nulProt?: string | number;
-  undef?: string | number;
-  noExts?: string | number;
-  frozen?: string | number;
-  sealed?: string | number;
-  regex?: string | number;
-  string?: string | number;
-  symbol?: string | number;
-  symbolFade?: string | number;
-  braces?: string | number;
-  quotes?: string | number;
-  empty?: string | number;
-  dot?: string | number;
-}
-
-declare interface InspectFunction {
-  /**
-   * Generate a human-readable representation of a value.
-   *
-   * @param value - Value to inspect
-   * @param options - Additional settings for refining output
-   * @returns A string representation of `value`.
-   */
-  (value: any, options?: InspectOptions): string;
-
-  /**
-   * Generate a human-readable representation of a value.
-   *
-   * @param value - Value to inspect
-   * @param key - The value's corresponding member name
-   * @param options - Additional settings for refining output
-   * @returns A string representation of `value`.
-   */
-  (value: any, key?: string | symbol, options?: InspectOptions): string;
-}
-
-/**
- * Generate a human-readable representation of a value.
- *
- * @param value - Value to inspect
- * @param key - The value's corresponding member name
- * @param options - Additional settings for refining output
- * @returns A string representation of `value`.
- */
-declare var inspect: InspectFunction;
-
 declare var setTimeout: typeof import("quickjs:os").setTimeout;
 declare var clearTimeout: typeof import("quickjs:os").clearTimeout;
 

package/build/dts/quickjs-modulesys.d.ts

@@ -0,0 +1,180 @@
+/**
+ * A global which lets you configure the module loader (import/export/require).
+ * You can use these properties to add support for importing new filetypes.
+ *
+ * This global can also be used to identify whether an object is a module
+ * namespace record.
+ */
+interface ModuleGlobal {
+  /**
+   * Returns true if `target` is a module namespace object.
+   */
+  [Symbol.hasInstance](target: any): target is {
+    [key: string | number | symbol]: any;
+  };
+
+  /**
+   * A list of filetype extensions that may be omitted from an import specifier
+   * string.
+   *
+   * Defaults to `[".js"]`. You can add more strings to this array to
+   * make the engine search for additional files when resolving a
+   * require/import.
+   *
+   * See the doc comment on {@link require} for more information.
+   *
+   * NOTE: If you add a new extension to this array, you will likely also want
+   * to add to {@link Module.compilers}.
+   */
+  searchExtensions: Array<string>;
+
+  /**
+   * User-defined functions which will handle getting the JavaScript code
+   * associated with a module.
+   *
+   * The key for each property in this object should be a file extension
+   * string with a leading dot, eg `".jsx"`. The value for each property should
+   * be a function which receives (1) the filepath to a module, and (2) that
+   * file's content as a UTF-8 string, and the function should return a string
+   * containing JavaScript code that corresponds to that module. In most cases,
+   * these functions will compile the contents of the file from one format into JavaScript.
+   *
+   * The function does not have to use the second 'content' argument it
+   * receives (ie. when loading binary files).
+   *
+   * By adding to this object, you can make it possible to import non-js
+   * filetypes; compile-to-JS languages like JSX, TypeScript, and CoffeeScript
+   * can be compiled at import time, and asset files like .txt files or .png
+   * files can be converted into an appropriate data structure at import time.
+   *
+   * As an example, to make it possible to import .txt files, you might do:
+   * ```js
+   * import * as std from "std";
+   *
+   * Module.compilers[".txt"] = (filename, content) => {
+   *   return `export default ${JSON.stringify(content)}`;
+   * }
+   * ```
+   * (leveraging `JSON.stringify`'s ability to escape quotes).
+   *
+   * Then, later in your code, you can do:
+   * ```js
+   * import names from "./names.txt";
+   * ```
+   *
+   * And `names` will be a string containing the contents of names.txt.
+   *
+   * NOTE: When adding to this object, you may also wish to add to
+   * {@link Module.searchExtensions}.
+   */
+  compilers: {
+    [extensionWithDot: string]: (filename: string, content: string) => string;
+  };
+
+  /**
+   * Create a virtual built-in module whose exports consist of the own
+   * enumerable properties of `obj`.
+   */
+  define(name: string, obj: { [key: string]: any }): void;
+
+  /**
+   * Resolves a require/import request from `fromFile` into a canonicalized path.
+   *
+   * To change native module resolution behavior, replace this function with
+   * your own implementation. Note that you must handle
+   * `Module.searchExtensions` yourself in your replacement implementation.
+   */
+  resolve(name: string, fromFile: string): string;
+
+  /**
+   * Reads the contents of the given resolved module name into a string.
+   *
+   * To change native module loading behavior, replace this function with your
+   * own implementation. Note that you must handle `Module.compilers` yourself
+   * in your replacement implementation.
+   */
+  read(modulePath: string): string;
+}
+
+// global added by QJMS_AddModuleGlobal
+declare var Module: ModuleGlobal;
+
+interface RequireFunction {
+  /**
+   * Synchronously import a module.
+   *
+   * `source` will be resolved relative to the calling file.
+   *
+   * If `source` does not have a file extension, and a file without an extension
+   * cannot be found, the engine will check for files with the extensions in
+   * {@link Module.searchExtensions}, and use one of those if present. This
+   * behavior also happens when using normal `import` statements.
+   *
+   * For example, if you write:
+   *
+   * ```js
+   * import something from "./somewhere";
+   * ```
+   *
+   * but there's no file named `somewhere` in the same directory as the file
+   * where that import appears, and `Module.searchExtensions` is the default
+   * value:
+   *
+   * ```js
+   * [".js"]
+   * ```
+   *
+   * then the engine will look for `somewhere.js`. If that doesn't exist, the
+   * engine will look for `somewhere/index.js`. If *that* doesn't exist, an error
+   * will be thrown.
+   *
+   * If you add more extensions to `Module.searchExtensions`, then the engine
+   * will use those, too. It will search in the same order as the strings appear
+   * in the `Module.searchExtensions` array.
+   */
+  (source: string): any;
+
+  /**
+   * Resolves the normalized path to a modules, relative to the calling file.
+   */
+  resolve: (source: string) => string;
+}
+
+// global added by QJMS_AddRequireGlobal
+declare var require: RequireFunction;
+
+// gets set per-module by QJMS_SetModuleImportMeta
+interface ImportMeta {
+  /**
+   * A URL representing the current module.
+   *
+   * Usually starts with `file://`.
+   */
+  url: string;
+
+  /**
+   * Whether the current module is the "main" module, meaning that it is the
+   * entrypoint file that's been loaded, or, in other terms, the first
+   * user-authored module that's been loaded.
+   */
+  main: boolean;
+
+  /**
+   * Equivalent to `globalThis.require`. Provided for compatibility with tools
+   * that can leverage a CommonJS require function via `import.meta.require`.
+   */
+  require: RequireFunction;
+
+  /**
+   * Resolves a module specifier based on the current module's path.
+   *
+   * Equivalent to `globalThis.require.resolve`.
+   *
+   * Behaves similarly to [the browser import.meta.resolve](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/import.meta/resolve),
+   * but it does not ensure that the returned string is a valid URL, because it
+   * delegates directly to {@link Module.resolve} to resolve the name. If you
+   * want this to return URL strings, change `Module.resolve` and `Module.read`
+   * to work with URL strings.
+   */
+  resolve: RequireFunction["resolve"];
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@suchipi/quickjs",
   "description": "Suchipi's QuickJS Fork",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "main": "./npm/index.js",
   "bin": {
     "qjs": "npm/cli/qjs.js",

package/tsconfig.json

@@ -12,7 +12,9 @@
     "tests/oldtests/**/*",
     "build/**/*",
     "examples/**/*",
-    "meta/microbench.js"
+    "meta/microbench.js",
+    "src/run-test262/test262",
+    "src/run-test262/test262o"
   ],
   "compilerOptions": {
     "allowJs": true,