From 56d3a8c5bf7c3e4bd418d30e5b843ab4f2350c76 Mon Sep 17 00:00:00 2001
From: BlackMATov <blackmat@mail.ru>
Date: Sun, 16 Feb 2025 00:58:02 +0700
Subject: [PATCH] empty phase/system builders

---
 README.md   | 10 ++++++++++
 evolved.lua | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 66 insertions(+)

diff --git a/README.md b/README.md
index 8788a5d..793e416 100644
--- a/README.md
+++ b/README.md
@@ -116,4 +116,14 @@ query_builder:exclude :: fragment... -> query_builder
 query_builder:build :: query, boolean
 ```
 
+```
+phase :: phase_builder
+phase_builder:build :: phase, boolean
+```
+
+```
+system :: system_builder
+system_builder:build :: system, boolean
+```
+
 ## [License (MIT)](./LICENSE.md)
diff --git a/evolved.lua b/evolved.lua
index e6fc809..a7ee896 100644
--- a/evolved.lua
+++ b/evolved.lua
@@ -32,6 +32,8 @@ local evolved = {
 ---@alias evolved.entity evolved.id
 ---@alias evolved.fragment evolved.id
 ---@alias evolved.query evolved.id
+---@alias evolved.phase evolved.id
+---@alias evolved.system evolved.id
 
 ---@alias evolved.component any
 ---@alias evolved.component_storage evolved.component[]
@@ -5991,6 +5993,60 @@ end
 ---
 ---
 
+---@class (exact) evolved.__phase_builder
+
+---@class evolved.phase_builder : evolved.__phase_builder
+local evolved_phase_builder = {}
+evolved_phase_builder.__index = evolved_phase_builder
+
+---@return evolved.phase_builder builder
+---@nodiscard
+function evolved.phase()
+    ---@type evolved.__phase_builder
+    local builder = {}
+    ---@cast builder evolved.phase_builder
+    return setmetatable(builder, evolved_phase_builder)
+end
+
+---@return evolved.phase phase
+---@return boolean is_deferred
+function evolved_phase_builder:build()
+    return evolved.id(), false
+end
+
+---
+---
+---
+---
+---
+
+---@class (exact) evolved.__system_builder
+
+---@class evolved.system_builder : evolved.__system_builder
+local evolved_system_builder = {}
+evolved_system_builder.__index = evolved_system_builder
+
+---@return evolved.system_builder builder
+---@nodiscard
+function evolved.system()
+    ---@type evolved.__system_builder
+    local builder = {}
+    ---@cast builder evolved.system_builder
+    return setmetatable(builder, evolved_system_builder)
+end
+
+---@return evolved.system system
+---@return boolean is_deferred
+function evolved_system_builder:build()
+    return evolved.id(), false
+end
+
+---
+---
+---
+---
+---
+
 ---@param chunk evolved.chunk
 ---@return boolean
 local function __update_chunk_caches_trace(chunk)