Add Lua require mode that adheres to the PUC Lua require behavior.

Cargo.toml

@@ -42,6 +42,7 @@ petgraph = "0.8.3"
 regex = "1.12.3"
 serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0.149"
+serde_with = "3.18.0"
 serde_yaml = "0.9.33"
 toml = "1.1.2"
 tracing = { version = "0.1", optional = true }

site/content/docs/config/index.md

@@ -58,7 +58,6 @@ Any missing field will be replaced with its default value.
 
     // Configure how requires are interpreted
     require_mode: {
-      // Currently, the only supported require mode is `path`
       name: "path",
 
       // When requiring folders, require the file named like this value inside of it

site/content/docs/lua-require-mode/index.md

@@ -0,0 +1,38 @@
+---
+title: Lua Require Mode
+description: How lua (and darklua) understands require calls
+group: Configuration
+order: 6
+---
+
+This require mode is used for lua programs outside of the Luau ecosystem, including PUC lua, luajit, and most other plain lua
+implementations that include a require function.
+For more information, please refer to the documentation for [package.searchpath at lua.org](https://lua.org/manual/5.5/manual.html#pdf-package.searchpath).
+
+## Bundling Support
+
+It can be configured in the **bundle** part of the configuration file. For a quick overview of the bundling configuration, see [the documentation page](../bundle/).
+
+## Configuration
+
+The lua require mode uses the environment variable `LUA_PATH` by default as the search path,
+but it can be configured to either use a different environment variable, just use the default search path, or
+to use a string from the configuration file.
+Lua's require does not support aliases or hierarchy beyond the filesystem, so there is no configuration for them.
+Note that despite lua's require not supporting embedding text, JSON, TOML, and YAML files, you may do so with darklua,
+as long as it is present in the search string.
+
+### Example
+```json5
+{
+  bundle: {
+    require_mode: {
+      name: "lua",
+      env: "DARKLUA_PATH",
+      // Path takes priority over env when provided. In the search string,
+      // order is important.
+      path: "./?.luau;./?/init.luau;./res/?.json;./res/?.toml"
+    }
+  }
+}
+```