@react-router/dev 0.0.0-experimental-49eef6a01 → 0.0.0-experimental-a26b992a1

package/dist/vite.d.ts

@@ -0,0 +1,2 @@
+export type { BuildManifest, Preset, ServerBundlesFunction, ReactRouterConfig, } from "./vite/config";
+export { reactRouterVitePlugin as reactRouter } from "./vite/plugin";

package/dist/{cli.js → vite.js}

@@ -1,5 +1,5 @@
 /**
- * @react-router/dev v0.0.0-experimental-49eef6a01
+ * @react-router/dev v0.0.0-experimental-a26b992a1
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -10,11 +10,10 @@
  */
 'use strict';
 
-var index = require('./index');
+Object.defineProperty(exports, '__esModule', { value: true });
 
-index.cli.run().then(() => {
-  process.exit(0);
-}, error => {
-  if (error) console.error(error);
-  process.exit(1);
-});
+var plugin = require('./vite/plugin.js');
+
+
+
+exports.reactRouter = plugin.reactRouterVitePlugin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-router/dev",
-  "version": "0.0.0-experimental-49eef6a01",
+  "version": "0.0.0-experimental-a26b992a1",
   "description": "Dev tools and CLI for React Router",
   "homepage": "https://reactrouter.com",
   "bugs": {
@@ -12,12 +12,18 @@
     "directory": "packages/react-router-dev"
   },
   "license": "MIT",
-  "main": "dist/index.js",
-  "typings": "dist/index.d.ts",
   "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+    "./routes": {
+      "types": "./dist/routes.d.ts",
+      "default": "./dist/routes.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "default": "./dist/vite.js"
+    },
+    "./vite/cloudflare": {
+      "types": "./dist/vite/cloudflare.d.ts",
+      "default": "./dist/vite/cloudflare.js"
     },
     "./package.json": "./package.json"
   },
@@ -37,25 +43,28 @@
     "arg": "^5.0.1",
     "babel-dead-code-elimination": "^1.0.6",
     "chalk": "^4.1.2",
+    "dedent": "^1.5.3",
     "es-module-lexer": "^1.3.1",
     "exit-hook": "2.2.1",
     "fs-extra": "^10.0.0",
     "gunzip-maybe": "^1.4.2",
     "jsesc": "3.0.2",
     "lodash": "^4.17.21",
-    "minimatch": "^9.0.0",
     "picocolors": "^1.0.0",
     "picomatch": "^2.3.1",
     "prettier": "^2.7.1",
     "react-refresh": "^0.14.0",
     "semver": "^7.3.7",
     "set-cookie-parser": "^2.6.0",
-    "@react-router/node": "0.0.0-experimental-49eef6a01"
+    "vite-node": "^1.6.0",
+    "valibot": "^0.41.0",
+    "@react-router/node": "0.0.0-experimental-a26b992a1"
   },
   "devDependencies": {
     "@types/babel__core": "^7.20.5",
     "@types/babel__generator": "^7.6.8",
     "@types/babel__traverse": "^7.20.5",
+    "@types/dedent": "^0.7.0",
     "@types/express": "^4.17.9",
     "@types/fs-extra": "^8.1.2",
     "@types/gunzip-maybe": "^1.4.0",
@@ -75,15 +84,15 @@
     "tiny-invariant": "^1.2.0",
     "vite": "^5.1.0",
     "wrangler": "^3.28.2",
-    "@react-router/serve": "0.0.0-experimental-49eef6a01",
-    "react-router": "^0.0.0-experimental-49eef6a01"
+    "react-router": "^0.0.0-experimental-a26b992a1",
+    "@react-router/serve": "0.0.0-experimental-a26b992a1"
   },
   "peerDependencies": {
     "typescript": "^5.1.0",
     "vite": "^5.1.0",
     "wrangler": "^3.28.2",
-    "@react-router/serve": "^0.0.0-experimental-49eef6a01",
-    "react-router": "^0.0.0-experimental-49eef6a01"
+    "@react-router/serve": "^0.0.0-experimental-a26b992a1",
+    "react-router": "^0.0.0-experimental-a26b992a1"
   },
   "peerDependenciesMeta": {
     "@react-router/serve": {

package/dist/config/findConfig.d.ts

@@ -1 +0,0 @@
-export declare function findConfig(dir: string, basename: string, extensions: string[]): string | undefined;

package/dist/config/findConfig.js

@@ -1,32 +0,0 @@
-/**
- * @react-router/dev v0.0.0-experimental-49eef6a01
- *
- * Copyright (c) Remix Software Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE.md file in the root directory of this source tree.
- *
- * @license MIT
- */
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var path = require('node:path');
-var fse = require('fs-extra');
-
-function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
-
-var path__default = /*#__PURE__*/_interopDefaultLegacy(path);
-var fse__default = /*#__PURE__*/_interopDefaultLegacy(fse);
-
-function findConfig(dir, basename, extensions) {
-  for (let ext of extensions) {
-    let name = basename + ext;
-    let file = path__default["default"].join(dir, name);
-    if (fse__default["default"].existsSync(file)) return file;
-  }
-  return undefined;
-}
-
-exports.findConfig = findConfig;

package/dist/config/flatRoutes.d.ts

@@ -1,14 +0,0 @@
-import type { RouteManifest } from "./routes";
-export declare const routeModuleExts: string[];
-export declare let paramPrefixChar: "$";
-export declare let escapeStart: "[";
-export declare let escapeEnd: "]";
-export declare let optionalStart: "(";
-export declare let optionalEnd: ")";
-export declare function flatRoutes(appDirectory: string, ignoredFilePatterns?: string[], prefix?: string): RouteManifest;
-export declare function flatRoutesUniversal(appDirectory: string, routes: string[], prefix?: string): RouteManifest;
-export declare function getRouteSegments(routeId: string): [string[], string[]];
-export declare function createRoutePath(routeSegments: string[], rawRouteSegments: string[], isIndex?: boolean): string | undefined;
-export declare function getRoutePathConflictErrorMessage(pathname: string, routes: string[]): string;
-export declare function getRouteIdConflictErrorMessage(routeId: string, files: string[]): string;
-export declare function isSegmentSeparator(checkChar: string | undefined): boolean;

package/dist/config/flatRoutes.js

@@ -1,418 +0,0 @@
-/**
- * @react-router/dev v0.0.0-experimental-49eef6a01
- *
- * Copyright (c) Remix Software Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE.md file in the root directory of this source tree.
- *
- * @license MIT
- */
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var fs = require('node:fs');
-var path = require('node:path');
-var minimatch = require('minimatch');
-var routes = require('./routes.js');
-var findConfig = require('./findConfig.js');
-
-function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
-
-var fs__default = /*#__PURE__*/_interopDefaultLegacy(fs);
-var path__default = /*#__PURE__*/_interopDefaultLegacy(path);
-
-const routeModuleExts = [".js", ".jsx", ".ts", ".tsx", ".md", ".mdx"];
-let paramPrefixChar = "$";
-let escapeStart = "[";
-let escapeEnd = "]";
-let optionalStart = "(";
-let optionalEnd = ")";
-const PrefixLookupTrieEndSymbol = Symbol("PrefixLookupTrieEndSymbol");
-class PrefixLookupTrie {
-  root = {
-    [PrefixLookupTrieEndSymbol]: false
-  };
-  add(value) {
-    if (!value) throw new Error("Cannot add empty string to PrefixLookupTrie");
-    let node = this.root;
-    for (let char of value) {
-      if (!node[char]) {
-        node[char] = {
-          [PrefixLookupTrieEndSymbol]: false
-        };
-      }
-      node = node[char];
-    }
-    node[PrefixLookupTrieEndSymbol] = true;
-  }
-  findAndRemove(prefix, filter) {
-    let node = this.root;
-    for (let char of prefix) {
-      if (!node[char]) return [];
-      node = node[char];
-    }
-    return this.#findAndRemoveRecursive([], node, prefix, filter);
-  }
-  #findAndRemoveRecursive(values, node, prefix, filter) {
-    for (let char of Object.keys(node)) {
-      this.#findAndRemoveRecursive(values, node[char], prefix + char, filter);
-    }
-    if (node[PrefixLookupTrieEndSymbol] && filter(prefix)) {
-      node[PrefixLookupTrieEndSymbol] = false;
-      values.push(prefix);
-    }
-    return values;
-  }
-}
-function flatRoutes(appDirectory, ignoredFilePatterns = [], prefix = "routes") {
-  let ignoredFileRegex = Array.from(new Set(["**/.*", ...ignoredFilePatterns])).map(re => minimatch.makeRe(re)).filter(re => !!re);
-  let routesDir = path__default["default"].join(appDirectory, prefix);
-  let rootRoute = findConfig.findConfig(appDirectory, "root", routeModuleExts);
-  if (!rootRoute) {
-    throw new Error(`Could not find a root route module in the app directory: ${appDirectory}`);
-  }
-  if (!fs__default["default"].existsSync(rootRoute)) {
-    throw new Error(`Could not find the routes directory: ${routesDir}. Did you forget to create it?`);
-  }
-  // Only read the routes directory
-  let entries = fs__default["default"].readdirSync(routesDir, {
-    withFileTypes: true,
-    encoding: "utf-8"
-  });
-  let routes$1 = [];
-  for (let entry of entries) {
-    let filepath = routes.normalizeSlashes(path__default["default"].join(routesDir, entry.name));
-    let route = null;
-    // If it's a directory, don't recurse into it, instead just look for a route module
-    if (entry.isDirectory()) {
-      route = findRouteModuleForFolder(appDirectory, filepath, ignoredFileRegex);
-    } else if (entry.isFile()) {
-      route = findRouteModuleForFile(appDirectory, filepath, ignoredFileRegex);
-    }
-    if (route) routes$1.push(route);
-  }
-  let routeManifest = flatRoutesUniversal(appDirectory, routes$1, prefix);
-  return routeManifest;
-}
-function flatRoutesUniversal(appDirectory, routes$1, prefix = "routes") {
-  let urlConflicts = new Map();
-  let routeManifest = {};
-  let prefixLookup = new PrefixLookupTrie();
-  let uniqueRoutes = new Map();
-  let routeIdConflicts = new Map();
-  // id -> file
-  let routeIds = new Map();
-  for (let file of routes$1) {
-    let normalizedFile = routes.normalizeSlashes(file);
-    let routeExt = path__default["default"].extname(normalizedFile);
-    let routeDir = path__default["default"].dirname(normalizedFile);
-    let normalizedApp = routes.normalizeSlashes(appDirectory);
-    let routeId = routeDir === path__default["default"].posix.join(normalizedApp, prefix) ? path__default["default"].posix.relative(normalizedApp, normalizedFile).slice(0, -routeExt.length) : path__default["default"].posix.relative(normalizedApp, routeDir);
-    let conflict = routeIds.get(routeId);
-    if (conflict) {
-      let currentConflicts = routeIdConflicts.get(routeId);
-      if (!currentConflicts) {
-        currentConflicts = [path__default["default"].posix.relative(normalizedApp, conflict)];
-      }
-      currentConflicts.push(path__default["default"].posix.relative(normalizedApp, normalizedFile));
-      routeIdConflicts.set(routeId, currentConflicts);
-      continue;
-    }
-    routeIds.set(routeId, normalizedFile);
-  }
-  let sortedRouteIds = Array.from(routeIds).sort(([a], [b]) => b.length - a.length);
-  for (let [routeId, file] of sortedRouteIds) {
-    let index = routeId.endsWith("_index");
-    let [segments, raw] = getRouteSegments(routeId.slice(prefix.length + 1));
-    let pathname = createRoutePath(segments, raw, index);
-    routeManifest[routeId] = {
-      file: file.slice(appDirectory.length + 1),
-      id: routeId,
-      path: pathname
-    };
-    if (index) routeManifest[routeId].index = true;
-    let childRouteIds = prefixLookup.findAndRemove(routeId, value => {
-      return [".", "/"].includes(value.slice(routeId.length).charAt(0));
-    });
-    prefixLookup.add(routeId);
-    if (childRouteIds.length > 0) {
-      for (let childRouteId of childRouteIds) {
-        routeManifest[childRouteId].parentId = routeId;
-      }
-    }
-  }
-  // path creation
-  let parentChildrenMap = new Map();
-  for (let [routeId] of sortedRouteIds) {
-    let config = routeManifest[routeId];
-    if (!config.parentId) continue;
-    let existingChildren = parentChildrenMap.get(config.parentId) || [];
-    existingChildren.push(config);
-    parentChildrenMap.set(config.parentId, existingChildren);
-  }
-  for (let [routeId] of sortedRouteIds) {
-    let config = routeManifest[routeId];
-    let originalPathname = config.path || "";
-    let pathname = config.path;
-    let parentConfig = config.parentId ? routeManifest[config.parentId] : null;
-    if (parentConfig !== null && parentConfig !== void 0 && parentConfig.path && pathname) {
-      pathname = pathname.slice(parentConfig.path.length).replace(/^\//, "").replace(/\/$/, "");
-    }
-    if (!config.parentId) config.parentId = "root";
-    config.path = pathname || undefined;
-    /**
-     * We do not try to detect path collisions for pathless layout route
-     * files because, by definition, they create the potential for route
-     * collisions _at that level in the tree_.
-     *
-     * Consider example where a user may want multiple pathless layout routes
-     * for different subfolders
-     *
-     *   routes/
-     *     account.tsx
-     *     account._private.tsx
-     *     account._private.orders.tsx
-     *     account._private.profile.tsx
-     *     account._public.tsx
-     *     account._public.login.tsx
-     *     account._public.perks.tsx
-     *
-     * In order to support both a public and private layout for `/account/*`
-     * URLs, we are creating a mutually exclusive set of URLs beneath 2
-     * separate pathless layout routes.  In this case, the route paths for
-     * both account._public.tsx and account._private.tsx is the same
-     * (/account), but we're again not expecting to match at that level.
-     *
-     * By only ignoring this check when the final portion of the filename is
-     * pathless, we will still detect path collisions such as:
-     *
-     *   routes/parent._pathless.foo.tsx
-     *   routes/parent._pathless2.foo.tsx
-     *
-     * and
-     *
-     *   routes/parent._pathless/index.tsx
-     *   routes/parent._pathless2/index.tsx
-     */
-    let lastRouteSegment = config.id.replace(new RegExp(`^${prefix}/`), "").split(".").pop();
-    let isPathlessLayoutRoute = lastRouteSegment && lastRouteSegment.startsWith("_") && lastRouteSegment !== "_index";
-    if (isPathlessLayoutRoute) {
-      continue;
-    }
-    let conflictRouteId = originalPathname + (config.index ? "?index" : "");
-    let conflict = uniqueRoutes.get(conflictRouteId);
-    uniqueRoutes.set(conflictRouteId, config);
-    if (conflict && (originalPathname || config.index)) {
-      let currentConflicts = urlConflicts.get(originalPathname);
-      if (!currentConflicts) currentConflicts = [conflict];
-      currentConflicts.push(config);
-      urlConflicts.set(originalPathname, currentConflicts);
-      continue;
-    }
-  }
-  if (routeIdConflicts.size > 0) {
-    for (let [routeId, files] of routeIdConflicts.entries()) {
-      console.error(getRouteIdConflictErrorMessage(routeId, files));
-    }
-  }
-  // report conflicts
-  if (urlConflicts.size > 0) {
-    for (let [path, routes] of urlConflicts.entries()) {
-      // delete all but the first route from the manifest
-      for (let i = 1; i < routes.length; i++) {
-        delete routeManifest[routes[i].id];
-      }
-      let files = routes.map(r => r.file);
-      console.error(getRoutePathConflictErrorMessage(path, files));
-    }
-  }
-  return routeManifest;
-}
-function findRouteModuleForFile(appDirectory, filepath, ignoredFileRegex) {
-  let relativePath = routes.normalizeSlashes(path__default["default"].relative(appDirectory, filepath));
-  let isIgnored = ignoredFileRegex.some(regex => regex.test(relativePath));
-  if (isIgnored) return null;
-  return filepath;
-}
-function findRouteModuleForFolder(appDirectory, filepath, ignoredFileRegex) {
-  let relativePath = path__default["default"].relative(appDirectory, filepath);
-  let isIgnored = ignoredFileRegex.some(regex => regex.test(relativePath));
-  if (isIgnored) return null;
-  let routeRouteModule = findConfig.findConfig(filepath, "route", routeModuleExts);
-  let routeIndexModule = findConfig.findConfig(filepath, "index", routeModuleExts);
-  // if both a route and index module exist, throw a conflict error
-  // preferring the route module over the index module
-  if (routeRouteModule && routeIndexModule) {
-    let [segments, raw] = getRouteSegments(path__default["default"].relative(appDirectory, filepath));
-    let routePath = createRoutePath(segments, raw, false);
-    console.error(getRoutePathConflictErrorMessage(routePath || "/", [routeRouteModule, routeIndexModule]));
-  }
-  return routeRouteModule || routeIndexModule || null;
-}
-function getRouteSegments(routeId) {
-  let routeSegments = [];
-  let rawRouteSegments = [];
-  let index = 0;
-  let routeSegment = "";
-  let rawRouteSegment = "";
-  let state = "NORMAL";
-  let pushRouteSegment = (segment, rawSegment) => {
-    if (!segment) return;
-    let notSupportedInRR = (segment, char) => {
-      throw new Error(`Route segment "${segment}" for "${routeId}" cannot contain "${char}".\n` + `If this is something you need, upvote this proposal for React Router https://github.com/remix-run/react-router/discussions/9822.`);
-    };
-    if (rawSegment.includes("*")) {
-      return notSupportedInRR(rawSegment, "*");
-    }
-    if (rawSegment.includes(":")) {
-      return notSupportedInRR(rawSegment, ":");
-    }
-    if (rawSegment.includes("/")) {
-      return notSupportedInRR(segment, "/");
-    }
-    routeSegments.push(segment);
-    rawRouteSegments.push(rawSegment);
-  };
-  while (index < routeId.length) {
-    let char = routeId[index];
-    index++; //advance to next char
-    switch (state) {
-      case "NORMAL":
-        {
-          if (isSegmentSeparator(char)) {
-            pushRouteSegment(routeSegment, rawRouteSegment);
-            routeSegment = "";
-            rawRouteSegment = "";
-            state = "NORMAL";
-            break;
-          }
-          if (char === escapeStart) {
-            state = "ESCAPE";
-            rawRouteSegment += char;
-            break;
-          }
-          if (char === optionalStart) {
-            state = "OPTIONAL";
-            rawRouteSegment += char;
-            break;
-          }
-          if (!routeSegment && char == paramPrefixChar) {
-            if (index === routeId.length) {
-              routeSegment += "*";
-              rawRouteSegment += char;
-            } else {
-              routeSegment += ":";
-              rawRouteSegment += char;
-            }
-            break;
-          }
-          routeSegment += char;
-          rawRouteSegment += char;
-          break;
-        }
-      case "ESCAPE":
-        {
-          if (char === escapeEnd) {
-            state = "NORMAL";
-            rawRouteSegment += char;
-            break;
-          }
-          routeSegment += char;
-          rawRouteSegment += char;
-          break;
-        }
-      case "OPTIONAL":
-        {
-          if (char === optionalEnd) {
-            routeSegment += "?";
-            rawRouteSegment += char;
-            state = "NORMAL";
-            break;
-          }
-          if (char === escapeStart) {
-            state = "OPTIONAL_ESCAPE";
-            rawRouteSegment += char;
-            break;
-          }
-          if (!routeSegment && char === paramPrefixChar) {
-            if (index === routeId.length) {
-              routeSegment += "*";
-              rawRouteSegment += char;
-            } else {
-              routeSegment += ":";
-              rawRouteSegment += char;
-            }
-            break;
-          }
-          routeSegment += char;
-          rawRouteSegment += char;
-          break;
-        }
-      case "OPTIONAL_ESCAPE":
-        {
-          if (char === escapeEnd) {
-            state = "OPTIONAL";
-            rawRouteSegment += char;
-            break;
-          }
-          routeSegment += char;
-          rawRouteSegment += char;
-          break;
-        }
-    }
-  }
-  // process remaining segment
-  pushRouteSegment(routeSegment, rawRouteSegment);
-  return [routeSegments, rawRouteSegments];
-}
-function createRoutePath(routeSegments, rawRouteSegments, isIndex) {
-  let result = [];
-  if (isIndex) {
-    routeSegments = routeSegments.slice(0, -1);
-  }
-  for (let index = 0; index < routeSegments.length; index++) {
-    let segment = routeSegments[index];
-    let rawSegment = rawRouteSegments[index];
-    // skip pathless layout segments
-    if (segment.startsWith("_") && rawSegment.startsWith("_")) {
-      continue;
-    }
-    // remove trailing slash
-    if (segment.endsWith("_") && rawSegment.endsWith("_")) {
-      segment = segment.slice(0, -1);
-    }
-    result.push(segment);
-  }
-  return result.length ? result.join("/") : undefined;
-}
-function getRoutePathConflictErrorMessage(pathname, routes) {
-  let [taken, ...others] = routes;
-  if (!pathname.startsWith("/")) {
-    pathname = "/" + pathname;
-  }
-  return `⚠️ Route Path Collision: "${pathname}"\n\n` + `The following routes all define the same URL, only the first one will be used\n\n` + `🟢 ${taken}\n` + others.map(route => `⭕️️ ${route}`).join("\n") + "\n";
-}
-function getRouteIdConflictErrorMessage(routeId, files) {
-  let [taken, ...others] = files;
-  return `⚠️ Route ID Collision: "${routeId}"\n\n` + `The following routes all define the same Route ID, only the first one will be used\n\n` + `🟢 ${taken}\n` + others.map(route => `⭕️️ ${route}`).join("\n") + "\n";
-}
-function isSegmentSeparator(checkChar) {
-  if (!checkChar) return false;
-  return ["/", ".", path__default["default"].win32.sep].includes(checkChar);
-}
-
-exports.createRoutePath = createRoutePath;
-exports.escapeEnd = escapeEnd;
-exports.escapeStart = escapeStart;
-exports.flatRoutes = flatRoutes;
-exports.flatRoutesUniversal = flatRoutesUniversal;
-exports.getRouteIdConflictErrorMessage = getRouteIdConflictErrorMessage;
-exports.getRoutePathConflictErrorMessage = getRoutePathConflictErrorMessage;
-exports.getRouteSegments = getRouteSegments;
-exports.isSegmentSeparator = isSegmentSeparator;
-exports.optionalEnd = optionalEnd;
-exports.optionalStart = optionalStart;
-exports.paramPrefixChar = paramPrefixChar;
-exports.routeModuleExts = routeModuleExts;

package/dist/index.d.ts

@@ -1,4 +0,0 @@
-export * as cli from "./cli/index";
-export type { Manifest as AssetsManifest } from "./manifest";
-export type { BuildManifest, Preset, ServerBundlesFunction, VitePluginConfig, } from "./config";
-export { vitePlugin, cloudflareDevProxyVitePlugin } from "./vite";

package/dist/index.js

@@ -1,23 +0,0 @@
-/**
- * @react-router/dev v0.0.0-experimental-49eef6a01
- *
- * Copyright (c) Remix Software Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE.md file in the root directory of this source tree.
- *
- * @license MIT
- */
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var index = require('./cli/index.js');
-var index$1 = require('./vite/index.js');
-var cloudflareDevProxy = require('./vite/cloudflare-dev-proxy.js');
-
-
-
-exports.cli = index;
-exports.vitePlugin = index$1.vitePlugin;
-exports.cloudflareDevProxyVitePlugin = cloudflareDevProxy.cloudflareDevProxyVitePlugin;

package/dist/vite/define-route.d.ts

@@ -1,5 +0,0 @@
-export declare function transform(code: string, id: string, options?: {
-    ssr?: boolean;
-}): string | import("@babel/generator").GeneratorResult;
-export declare function parseFields(code: string): string[];
-export declare function assertNotImported(code: string): void;