@nativescript/ios 9.1.0-alpha.20 → 9.1.0-alpha.21

package/framework/__PROJECT_NAME__.xcodeproj/project.pbxproj

@@ -505,7 +505,7 @@
 			repositoryURL = "https://github.com/NativeScript/ios-spm.git";
 			requirement = {
 				kind = exactVersion;
-				version = "9.1.0-alpha.20";
+				version = "9.1.0-alpha.21";
 			};
 		};
 /* End XCRemoteSwiftPackageReference section */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nativescript/ios",
   "description": "NativeScript Runtime for iOS",
-  "version": "9.1.0-alpha.20",
+  "version": "9.1.0-alpha.21",
   "keywords": [
     "NativeScript",
     "iOS",

package/types/index.d.ts

@@ -19,9 +19,12 @@
 // packages must reference them, not redeclare the modules — two
 // `declare module` blocks for the same specifier conflict.
 //
-// The `node:util` compatibility shim is deliberately not declared here:
-// programs that include @types/node already have a `node:util` declaration,
-// and a second one would clash with it.
+// The `node:` compatibility shims (`node:util`, `node:module`, `node:url`) are
+// deliberately not declared here: programs that include @types/node already
+// have declarations for those specifiers, and a second one would clash with
+// them. A shim exposing less than Node does is a runtime concern, documented
+// in docs/ns-builtin-modules.md, not something to restate in types that would
+// then conflict.
 
 /// <reference path="./ns-module.d.ts" />
 /// <reference path="./ns-runtime.d.ts" />

package/types/ns-module.d.ts

@@ -4,9 +4,25 @@ declare module "ns:module" {
    * absolute URL. Consulted inside the engine's synchronous module resolver,
    * which is why it must be handed to the runtime ahead of time rather than
    * resolved on demand.
+   *
+   * A key ending in `/` maps a whole subtree and its target must end in `/`
+   * too; longest match wins. The map is validated in full before it is
+   * installed — an invalid map throws a `TypeError` out of
+   * {@link configureLoader} and leaves the previously installed map in place.
    */
   export interface ImportMap {
-    imports: Record<string, string>;
+    imports?: Record<string, string>;
+    /**
+     * Per-referrer overrides. Each key is matched as a plain prefix of the
+     * importing module's canonical registry key — an absolute `http(s)` URL
+     * for a served module, or a canonical absolute path for a file — which is
+     * this runtime's analogue of the web's resolved referrer URL. End a scope
+     * key with `/` to keep it on a directory boundary.
+     *
+     * Resolution consults the most specific matching scope first, then less
+     * specific ones, then {@link ImportMap.imports}.
+     */
+    scopes?: Record<string, Record<string, string>>;
   }
 
   /**
@@ -36,9 +52,14 @@ declare module "ns:module" {
   /**
    * Loader policy, installed before the dev session imports anything. Every
    * section is optional; each present section replaces its native state
-   * wholesale.
+   * wholesale (an empty array included — `undefined` counts as absent).
+   *
+   * The policy applies to the isolate that calls `configureLoader`. A worker
+   * inherits a copy of its parent's policy taken at spawn; a worker already
+   * running does not observe a later reconfiguration.
    */
   export interface LoaderConfig {
+    /** Replaces the whole map. */
     importMap?: ImportMap;
     /** URL substrings identifying modules that are always re-fetched, never cached. */
     volatilePatterns?: string[];
@@ -48,6 +69,12 @@ declare module "ns:module" {
   /**
    * Installs loader policy — the sole channel by which server/framework URL
    * policy enters the runtime's module loader.
+   *
+   * Throws `TypeError` on a missing or non-object config, an unknown top-level
+   * key, a section of the wrong type, or a non-string inside a section's array
+   * — the message names the offending section, key or index. The whole config
+   * is validated before any of it is installed, so a rejected call leaves every
+   * section exactly as it was.
    */
   export function configureLoader(config: LoaderConfig): void;
 
@@ -55,6 +82,9 @@ declare module "ns:module" {
    * Evicts the given URLs (canonicalized) from the module registry and marks
    * them bust-next-fetch, so the next network fetch bypasses every HTTP
    * cache layer.
+   *
+   * Throws `TypeError` if `urls` is not an array or holds a non-string, naming
+   * the offending index.
    */
   export function invalidateModules(urls: string[]): void;
 
@@ -65,10 +95,67 @@ declare module "ns:module" {
   export function getLoadedModuleUrls(): string[];
 
   /**
-   * Flips the dev-boot-complete signal (defaults to `true`); disarms
-   * cold-boot-only behaviors.
+   * A `require` that resolves against the directory of `filenameOrURL` — a
+   * trailing slash names the directory itself. Accepts an absolute path
+   * string, a `file:` URL string, or a URL object; anything else throws a
+   * `TypeError`, and an `http(s)` base is refused because `require()` of a
+   * dev-served module is not supported (import those instead).
+   *
+   * ES module graphs load under Node's `require(esm)` rule: a graph
+   * containing top-level await is refused before it evaluates.
+   *
+   * The returned `require` takes a string specifier and throws a `TypeError`
+   * with Node's `ERR_INVALID_ARG_TYPE` wording on anything else.
+   *
+   * `require.resolve`, `require.cache` and `require.main` are not
+   * implemented and are absent from the returned function.
+   */
+  export function createRequire(
+    filenameOrURL: string | URL,
+  ): (specifier: string) => any;
+
+  /** Evaluation-settle options for {@link createPumpingRequire}. */
+  export interface PumpingRequireOptions {
+    /**
+     * How long the graph may take to settle, in seconds. Positive and finite.
+     * Defaults to 60. Governs the evaluation-settle phase only — the graph
+     * walk's fetch deadline is separate and unaffected.
+     */
+    deadlineSeconds?: number;
+    /**
+     * What an expired deadline means. `"throw"` (default) fails the require;
+     * `"return-pending"` returns the namespace with evaluation still in
+     * flight, which a caller must discard rather than read.
+     */
+    onTimeout?: "throw" | "return-pending";
+    /**
+     * Also give the Cocoa runloop a slice per pump iteration. Only sane while
+     * boot owns the runloop — mid-app it re-enters arbitrary runloop sources
+     * underneath JS frames. Defaults to `false`.
+     */
+    pumpRunLoop?: boolean;
+  }
+
+  /**
+   * Like {@link createRequire}, except an ES module graph containing
+   * top-level await is evaluated — by driving V8's nestable tasks and
+   * microtasks until it settles — rather than refused. The Cocoa runloop is
+   * never advanced, so a graph awaiting a native transport still cannot
+   * settle here and fails on the deadline instead of returning a
+   * half-initialized namespace.
+   *
+   * Callable only from a task context. The loop cannot be pumped
+   * re-entrantly — V8 ignores a microtask checkpoint while the isolate is
+   * already draining the microtask queue — and a top-level await resumes
+   * through a promise reaction, which is a microtask. Requiring such a graph
+   * from after an `await` or inside a `.then` callback throws immediately,
+   * before evaluation, so `import()` can still load it. A synchronous graph
+   * needs no pumping and stays legal from anywhere.
    */
-  export function setDevBootComplete(value?: boolean): void;
+  export function createPumpingRequire(
+    filenameOrURL: string | URL,
+    options?: PumpingRequireOptions,
+  ): (specifier: string) => any;
 
   // Debug builds additionally carry `canonicalizeHttpUrlKey(url)`, a pure
   // test diagnostic; release builds omit the member entirely. It is

package/types/ns-runtime.d.ts

@@ -22,17 +22,15 @@ declare module "ns:runtime" {
   export interface RuntimeConfig {
     releasedObjectPolicy: ReleasedObjectPolicy;
     /**
-     * Verbose script/module-loading diagnostics. Boot default is the
-     * `logScriptLoading` value from nativescript.config / package.json
-     * (`false` when absent). Process-wide; main-isolate writes only.
+     * The enabled debug-trace categories, as a comma-separated list — the
+     * whole set is replaced on every write, so `""` disables tracing.
+     * `getConfig` returns the canonical list of what is currently on.
+     * Unknown names are ignored with one warning line.
+     *
+     * Also settable before boot through the `NS_DEBUG` environment variable.
+     * Available in release builds too. Process-wide; main-isolate writes only.
      */
-    logScriptLoading: boolean;
-    /**
-     * One log line per HTTP fetch URL (high volume). Boot default is the
-     * `httpFetchUrlLog` value from nativescript.config / package.json
-     * (`false` when absent). Process-wide; main-isolate writes only.
-     */
-    httpFetchUrlLog: boolean;
+    debug: string;
   }
 
   /**