Initial commit

Author: evaera

.editorconfig

@@ -0,0 +1,14 @@
+root = true
+
+[*]
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+
+[*.json]
+indent_style = space
+indent_size = 2
+
+[*.lua]
+indent_style = tab
+indent_size = 4

.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

.github/workflows/deploy.yml

@@ -0,0 +1,41 @@
+name: Deploy
+
+on:
+  push:
+    branches:
+    - master
+jobs:
+  deploy:
+    name: Deploy
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/[email protected]
+
+      - uses: actions/setup-node@v2
+        with:
+          node-version: "14"
+        name: Setup node
+
+      - run: npm i -g moonwave@latest
+        name: Install moonwave
+
+      - run: moonwave build
+        name: Build website
+
+      - name: Deploy
+        run: |
+          set -ex
+          git config --global user.email "[email protected]"
+          git config --global user.name "DreamcraftPackageUser"
+          REPO="$HOME/docs"
+          PROJECT_NAME="${GITHUB_REPOSITORY/UpliftGames\//}"
+          git clone "https://DreamcraftPackageUser:${GITHUB_TOKEN}@github.com/UpliftGames/docs.git" "$REPO"
+          rm -rf "$REPO/$PROJECT_NAME"
+          cp -r build "$REPO/$PROJECT_NAME"
+          cd "$REPO"
+          git add .
+          git diff-index --quiet HEAD || git commit --message "Deploy docs"
+          git push "https://DreamcraftPackageUser:${GITHUB_TOKEN}@github.com/UpliftGames/docs.git"
+        env:
+          GITHUB_TOKEN: ${{ secrets.DOCS_PAT }}

.gitignore

@@ -0,0 +1,43 @@
+# Compiled Lua sources
+luac.out
+
+# luarocks build files
+*.src.rock
+*.zip
+*.tar.gz
+
+# Object files
+*.o
+*.os
+*.ko
+*.obj
+*.elf
+
+# Precompiled Headers
+*.gch
+*.pch
+
+# Libraries
+*.lib
+*.a
+*.la
+*.lo
+*.def
+*.exp
+
+# Shared objects (inc. Windows DLLs)
+*.dll
+*.so
+*.so.*
+*.dylib
+
+# Executables
+*.exe
+*.out
+*.app
+*.i*86
+*.x86_64
+*.hex
+
+Packages
+roblox.toml

README.md

@@ -0,0 +1,3 @@
+# Matter
+
+An ECS

default.project.json

@@ -0,0 +1,6 @@
+{
+  "name": "matter",
+  "tree": {
+    "$path": "lib"
+  }
+}

lib/Archetype.lua

@@ -0,0 +1,64 @@
+local Llama = require(script.Parent.Parent.Llama)
+
+local valueIds = {}
+local nextValueId = 0
+local compatibilityCache = {}
+
+local function getValueId(value)
+	if valueIds[value] == nil then
+		valueIds[value] = nextValueId
+		nextValueId += 1
+	end
+
+	return valueIds[value]
+end
+
+function archetypeOf(values)
+	local list = Llama.List.map(values, getValueId)
+	table.sort(list)
+
+	return table.concat(list, "_")
+end
+
+function archetypeOfDict(dict)
+	return archetypeOf(Llama.Dictionary.keys(dict))
+end
+
+function areArchetypesCompatible(query, target)
+	local cachedCompatibility = compatibilityCache[query .. "-" .. target]
+	if cachedCompatibility ~= nil then
+		return cachedCompatibility
+	end
+
+	local queryIds = string.split(query, "_")
+	local targetIds = Llama.List.toSet(string.split(target, "_"))
+
+	for _, queryId in ipairs(queryIds) do
+		if targetIds[queryId] == nil then
+			compatibilityCache[query .. "-" .. target] = false
+			return false
+		end
+	end
+
+	compatibilityCache[query .. "-" .. target] = true
+	return true
+end
+
+function getCompatibleArchetypes(query, archetypeMap)
+	local listOfMaps = {}
+
+	for targetArchetype, map in pairs(archetypeMap) do
+		if areArchetypesCompatible(query, targetArchetype) then
+			table.insert(listOfMaps, map)
+		end
+	end
+
+	return listOfMaps
+end
+
+return {
+	archetypeOf = archetypeOf,
+	archetypeOfDict = archetypeOfDict,
+	getCompatibleArchetypes = getCompatibleArchetypes,
+	areArchetypesCompatible = areArchetypesCompatible,
+}

lib/Archetype.spec.lua

@@ -0,0 +1,27 @@
+local Archetype = require(script.Parent.Archetype)
+local component = require(script.Parent).component
+
+return function()
+	describe("Archetype", function()
+		it("should report same sets as same archetype", function()
+			local a = component()
+			local b = component()
+			expect(Archetype.archetypeOf({ a, b })).to.equal(Archetype.archetypeOf({ b, a }))
+		end)
+		it("should identify compatible archetypes", function()
+			local a = component()
+			local b = component()
+			local c = component()
+
+			local archetypeA = Archetype.archetypeOf({ a, b, c })
+			local archetypeB = Archetype.archetypeOf({ a, b })
+			local archetypeC = Archetype.archetypeOf({ b, c })
+
+			expect(Archetype.areArchetypesCompatible(archetypeA, archetypeB)).to.equal(false)
+			expect(Archetype.areArchetypesCompatible(archetypeB, archetypeA)).to.equal(true)
+
+			expect(Archetype.areArchetypesCompatible(archetypeC, archetypeA)).to.equal(true)
+			expect(Archetype.areArchetypesCompatible(archetypeB, archetypeC)).to.equal(false)
+		end)
+	end)
+end

lib/Component.lua

@@ -0,0 +1,25 @@
+local function newComponent(name)
+	name = name or debug.info(2, "s") .. "@" .. debug.info(2, "l")
+
+	local component = {}
+	component.__index = component
+
+	function component.new(data)
+		return setmetatable(data or {}, component)
+	end
+
+	setmetatable(component, {
+		__call = function(_, ...)
+			return component.new(...)
+		end,
+		__tostring = function()
+			return name
+		end,
+	})
+
+	return component
+end
+
+return {
+	newComponent = newComponent,
+}

lib/Component.spec.lua

@@ -0,0 +1,23 @@
+local Component = require(script.Parent.Component)
+local component = Component.newComponent
+
+return function()
+	describe("Component", function()
+		it("should create components", function()
+			local a = component()
+			local b = component()
+
+			expect(getmetatable(a)).to.be.ok()
+
+			expect(getmetatable(a)).to.never.equal(getmetatable(b))
+
+			expect(typeof(a.new)).to.equal("function")
+		end)
+
+		it("should allow calling the table to construct", function()
+			local a = component()
+
+			expect(getmetatable(a())).to.equal(getmetatable(a.new()))
+		end)
+	end)
+end