luanti_lsp_api/api/minetest/jobs.lua

---@meta
---Timing
---------

-- Returned by `minetest.after`.
---@class mt.Job
local job = {}

-- Cancels the job function from being called.
function job:cancel() end

-- Call the function `func` after `time` seconds, may be fractional.
---@param time number
---@param func function
---@param ... unknown Arguments that will be passed to `func`.
---@return mt.Job
function minetest.after(time, func, ...) end

---Async environment
--------------------

-- Queue the function `func` to be ran in an async environment.
--
-- Note that there are multiple persistent workers and any of them may end up
-- running a given job.
--
-- The engine will scale the amount of worker threads automatically.
--
-- When `func` returns, the callback is called (in the normal environment)
-- with all of the return values as arguments.
--
-- **List of APIs available in an async environment:**
--
-- Classes:
--
-- - `ItemStack`
-- - `PerlinNoise`
-- - `PerlinNoiseMap`
-- - `PseudoRandom`
-- - `PcgRandom`
-- - `SecureRandom`
-- - `VoxelArea`
-- - `VoxelManip`
--   - only if transferred into environment; can't read/write to map
-- - `Settings`
--
-- Class instances that can be transferred between environments:
--
-- - `ItemStack`
-- - `PerlinNoise`
-- - `PerlinNoiseMap`
-- - `VoxelManip`
--
-- Functions:
--
-- - Standalone helpers such as logging, filesystem, encoding, hashing or
--   compression APIs
-- - `minetest.request_insecure_environment` (same restrictions apply)
--
-- Variables:
--
-- - `minetest.settings`
-- - `minetest.registered_items`, `registered_nodes`, `registered_tools`,
--   `registered_craftitems` and `registered_aliases`
--   - with all functions and userdata values replaced by `true`, calling any
--     callbacks here is obviously not possible
---@param func function
---@param callback fun(...: any): any
---@param ... unknown Variable number of arguments that are passed to `func`.
function minetest.handle_async(func, callback, ...) end

-- Register a path to a Lua file to be imported
-- when an async environment is initialized.
--
-- You can use this to preload code which you can then call later
-- using `minetest.handle_async()`.
---@param path string
function minetest.register_async_dofile(path) end