@suchipi/quickjs 0.1.1 → 0.2.1

package/README.md

@@ -56,10 +56,12 @@ Fork of the fantastic QuickJS engine by Fabrice Bellard, with the following chan
 - `os.{WUNTRACED,WEXITSTATUS,WTERMSIG,WSTOPSIG,WIFEXITED,WIFSIGNALED,WIFSTOPPED,WIFCONTINUED}` added, for working with `os.waitpid`.
 - `os.{S_IRWXU,S_IRUSR,S_IWUSR,S_IXUSR,S_IRWXG,S_IRGRP,S_IWGRP,S_IXGRP,S_IRWXO,S_IROTH,S_IWOTH,S_IXOTH}` added, for working with file modes.
 - `"b"` mode flag is now allowed in `std.fdopen`.
+- `std.strftime` is now available (wrapper for libc `strftime`).
 - `setTimeout` and `clearTimeout` are now available as globals.
 - `setInterval` and `clearInterval` are now available as globals.
 - `String.cooked` is now available (no-op template tag, like the proposed [String.cooked](https://github.com/tc39/proposal-string-cooked)).
 - `String.dedent` is now available (template tag function, like the proposed [String.dedent](https://github.com/tc39/proposal-string-dedent)).
+- Added `std.getuid`, `std.geteuid`, `std.getgid`, and `std.getegid` (wrappers for the libc functions of the same names).
 
 ## Changes to the `qjs` repl:
 
@@ -67,6 +69,7 @@ Fork of the fantastic QuickJS engine by Fabrice Bellard, with the following chan
 - The last error is accessible via the `_error` global
 - If a thrown error has additional properties added onto it, those are printed along with the thrown error
 - Ctrl+W deletes words backwards from the cursor position
+- Blocking the main thread is allowed
 
 ## New binary: `qjsbootstrap`:
 
@@ -83,6 +86,10 @@ You can use this to create distributable binaries that run JS code without needi
 
 > Note: On FreeBSD, `qjsbootstrap` requires procfs. You can mount it with `mount -t procfs proc /proc`. I started some work to use libprocstat instead, but haven't completed it yet.
 
+## New binary: `quickjs-run`:
+
+Barebones binary for running files, without any of the arg parsing logic from qjs. Good for testing some unusual cases, or writing programs with custom argv parsing logic.
+
 ## New module: "quickjs:bytecode"
 
 A Module that exposes QuickJS's value <-> bytecode (de)serialization APIs to JavaScript code. Generated bytecode can be combined with `qjsbootstrap-bytecode` in the same way that source code strings can be combined with `qjsbootstrap`.
@@ -91,6 +98,10 @@ A Module that exposes QuickJS's value <-> bytecode (de)serialization APIs to Jav
 
 A Module that allows JS code to create new JS Contexts (Realms). You can create new Contexts and run code inside them. Contexts can have certain features disabled (like eval) for security purposes. You can share values between Contexts. Contexts are destroyed when they get garbage-collected.
 
+## New module: "quickjs:pointer"
+
+A barebones Module that exports a JS class which can be used to represent an opaque pointer. C modules can use the `js_new_pointer` function provided by this module to pass opaque pointer handles to users without needing to make their own wrapper class for stuff. This is mostly just useful in order to have a codified convention for how FFI libraries and such should represent foreign pointers.
+
 ## New library: `quickjs-utils`
 
 Helper structs, functions, and macros that make it easier to work with QuickJS objects in C code.

package/build/{aarch64-unknown-linux-musl/dts → dts}/quickjs-libc.d.ts

@@ -293,6 +293,38 @@ declare module "quickjs:std" {
   /** Return an object containing the environment variables as key-value pairs. */
   export function getenviron(): { [key: string]: string | undefined };
 
+  /**
+   * Return the real user ID of the calling process.
+   *
+   * This function throws an error on windows, because windows doesn't support
+   * the same uid/gid paradigm as Unix-like operating systems.
+   */
+  export function getuid(): number;
+
+  /**
+   * Return the effective user ID of the calling process.
+   *
+   * This function throws an error on windows, because windows doesn't support
+   * the same uid/gid paradigm as Unix-like operating systems.
+   */
+  export function geteuid(): number;
+
+  /**
+   * Return the real group ID of the calling process.
+   *
+   * This function throws an error on windows, because windows doesn't support
+   * the same uid/gid paradigm as Unix-like operating systems.
+   */
+  export function getgid(): number;
+
+  /**
+   * Return the effective group ID of the calling process.
+   *
+   * This function throws an error on windows, because windows doesn't support
+   * the same uid/gid paradigm as Unix-like operating systems.
+   */
+  export function getegid(): number;
+
   interface UrlGet {
     /**
      * Download `url` using the `curl` command line utility. Returns string
@@ -410,6 +442,20 @@ declare module "quickjs:std" {
    * - octal (0o prefix) and hexadecimal (0x prefix) numbers
    */
   export function parseExtJSON(str: string): any;
+
+  /**
+   * A wrapper around the standard C [strftime](https://en.cppreference.com/w/c/chrono/strftime).
+   * Formats a time/date into a format as specified by the user.
+   *
+   * @param maxBytes - The number of bytes to allocate for the string that will be returned
+   * @param format - Format string, using `%`-prefixed sequences as found in [this table](https://en.cppreference.com/w/c/chrono/strftime#Format_string).
+   * @param time - The Date object (or unix timestamp, in ms) to render.
+   */
+  export function strftime(
+    maxBytes: number,
+    format: string,
+    time: Date | number
+  ): string;
 }
 
 declare module "quickjs:os" {
@@ -1246,6 +1292,10 @@ interface RequireFunction {
 
 declare var require: RequireFunction;
 
+interface ImportMeta {
+  require: RequireFunction;
+}
+
 declare var setTimeout: typeof import("quickjs:os").setTimeout;
 declare var clearTimeout: typeof import("quickjs:os").clearTimeout;
 

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

@@ -0,0 +1,14 @@
+declare module "quickjs:pointer" {
+  /**
+   * An opaque pointer value which can be passed around by JS
+   */
+  export class Pointer {
+    static NULL: Pointer;
+
+    /** Returns a boolean indicating whether the provided value is a `Pointer` object. */
+    static isPointer(value: any): boolean;
+
+    /** For debug logging purposes only; format can vary from platform to platform and is not guaranteed to be present or consistent. */
+    _info?: string;
+  }
+}

package/build/x86_64-pc-windows-static/extras/fib.so

@@ -0,0 +1 @@
+Skipping shared library build: /opt/quickjs/src/shared-library-modules/example-fib/fib.c -

package/build/x86_64-pc-windows-static/extras/point.so

@@ -0,0 +1 @@
+Skipping shared library build: /opt/quickjs/src/shared-library-modules/example-point/point.c -

package/npm/index.js

@@ -1,5 +1,4 @@
 const path = require("path");
-const child_process = require("child_process");
 
 exports.buildArtifactsLocation = function buildArtifactsLocation() {
   return path.resolve(__dirname, "..", "build");
@@ -53,9 +52,3 @@ exports.identifyCurrentPlatform = function identifyCurrentPlatform() {
     }
   }
 };
-
-function runShell(cmd) {
-  return child_process
-    .spawnSync(cmd, { shell: true, encoding: "utf-8" })
-    .stdout.trim();
-}

package/package.json

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

package/tsconfig.json

@@ -1,17 +1,26 @@
 {
   "files": [
     "./src/quickjs/quickjs.d.ts",
+    "./src/inspect/inspect.d.ts",
     "./src/quickjs-libc/quickjs-libc.d.ts",
     "./src/quickjs-libbytecode/quickjs-libbytecode.d.ts",
     "./src/quickjs-libcontext/quickjs-libcontext.d.ts",
-],
+    "./src/quickjs-libpointer/quickjs-libpointer.d.ts"
+  ],
   "include": ["./**/*.js", "./**/*.ts"],
-  "exclude": ["oldtests/**/*", "build/**/*", "examples/**/*"],
+  "exclude": [
+    "tests/oldtests/**/*",
+    "build/**/*",
+    "examples/**/*",
+    "meta/microbench.js"
+  ],
   "compilerOptions": {
     "allowJs": true,
     "checkJs": true,
     "noEmit": true,
     "lib": ["ES2020"],
+    "module": "ES2020",
+    "moduleResolution": "node",
     "strictNullChecks": true,
     "esModuleInterop": true,
     "types": ["jest"]