Skip to content

Commit

Permalink
Fix docs titles
Browse files Browse the repository at this point in the history
  • Loading branch information
Ukendio committed Sep 7, 2024
1 parent 9af08c0 commit 1067a17
Show file tree
Hide file tree
Showing 5 changed files with 360 additions and 354 deletions.
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,9 @@ The format is based on [Keep a Changelog][kac], and this project adheres to
[semver]: https://semver.org/spec/v2.0.0.html

## [Unreleased]

## [0.2.10] - 2024-09-07

- `[world]`:
- Improved performance for hooks
- Changed `world:set` to be idempotent when setting tags
Expand All @@ -29,6 +32,7 @@ The format is based on [Keep a Changelog][kac], and this project adheres to
- Changed `world:contains()` to return a `boolean` instead of an entity which may or may not exist
- Fixed `world:has()` to take the correct parameters


## [0.2.2] - 2024-07-07

### Added
Expand Down
100 changes: 50 additions & 50 deletions docs/api/jecs.md
Original file line number Diff line number Diff line change
@@ -1,50 +1,50 @@
# Jecs

Jecs. Just an Entity Component System.

## Properties

### World
```luau
jecs.World: World
```
A world is a container of all ECS data. Games can have multiple worlds but component IDs may conflict between worlds. Ensure to register the same component IDs in the same order for each world.

### Wildcard
```luau
jecs.Wildcard: Entity
```
Builtin component type. This ID is used for wildcard queries.

### Component
```luau
jecs.Component: Entity
```
Builtin component type. Every ID created with [world:component()](world.md#component()) has this type added to it. This is meant for querying every component ID.

### ChildOf
```luau
jecs.ChildOf: Entity
```
Builtin component type. This ID is for creating parent-child hierarchies.

### Rest
```luau
jecs.Rest: Entity
```

## Functions

### pair()
```luau
function jecs.pair(
first: Entity, -- The first element of the pair, referred to as the relationship of the relationship pair.
object: Entity, -- The second element of the pair, referred to as the target of the relationship pair.
): number -- Returns the Id with those two elements
```
::: info

Note that while relationship pairs can be used as components, meaning you can add data with it as an ID, however they cannot be used as entities. Meaning you cannot add components to a pair as the source of a binding.

:::
# Jecs

Jecs. Just an Entity Component System.

# Properties

## World
```luau
jecs.World: World
```
A world is a container of all ECS data. Games can have multiple worlds but component IDs may conflict between worlds. Ensure to register the same component IDs in the same order for each world.

## Wildcard
```luau
jecs.Wildcard: Entity
```
Builtin component type. This ID is used for wildcard queries.

## Component
```luau
jecs.Component: Entity
```
Builtin component type. Every ID created with [world:component()](world.md#component()) has this type added to it. This is meant for querying every component ID.

## ChildOf
```luau
jecs.ChildOf: Entity
```
Builtin component type. This ID is for creating parent-child hierarchies.

## Rest
```luau
jecs.Rest: Entity
```

# Functions

## pair()
```luau
function jecs.pair(
first: Entity, -- The first element of the pair, referred to as the relationship of the relationship pair.
object: Entity, -- The second element of the pair, referred to as the target of the relationship pair.
): number -- Returns the Id with those two elements
```
::: info

Note that while relationship pairs can be used as components, meaning you can add data with it as an ID, however they cannot be used as entities. Meaning you cannot add components to a pair as the source of a binding.

:::
262 changes: 131 additions & 131 deletions docs/api/query.md
Original file line number Diff line number Diff line change
@@ -1,131 +1,131 @@
# Query

A World contains entities which have components. The World is queryable and can be used to get entities with a specific set of components.

## Functions

### drain()
```luau
function query:drain(): Query
```
This function will impede it from being reset when the query is being iterated.

### next()
```luau
function query:next(): Query
```
Get the next result in the query. Drain must have been called beforehand or otherwise it will error.

### with()
```luau
function query:with(
...: Entity -- The IDs to query with
): Query
```
Adds IDs to query with, but will not use their data. This is useful for Tags or generally just data you do not care for.

Example:
::: code-group

```luau [luau]
for id, position in world:query(Position):with(Velocity) do
-- Do something
end
```

```ts [typescript]
for (const [id, position] of world.query(Position).with(Velocity)) {
// Do something
}
```

:::

:::info
Put the IDs inside of `world:query()` instead if you need the data.
:::

### without()

```luau
function query:without(
...: Entity -- The IDs to filter against.
): Query -- Returns the Query
```
Removes entities with the provided IDs from the query.

Example:
::: code-group

```luau [luau]
for _ in world:query(Position):without(Velocity) do
-- Do something
end
```

```ts [typescript]
for (const _ of world.query(Position).without(Velocity)) {
// Do something
}
```

:::

### replace()

```luau
function query:replace(
fn: (entity: Entity, ...: T...) -> U... -- ): () -- The callback that will transform the entities' data
```
This function takes a callback which is given the current queried data of each matching entity. The values returned by the callback will be set as the new data for each given ID on the entity.

Example:
::: code-group

```luau [luau]
world:query(Position, Velocity):replace(function(e, position, velocity)
return position + velocity, velocity * 0.9
end
```

```ts [typescript]
world
.query(Position, Velocity)
.replace((e, position, velocity) =>
$tuple(position.add(velocity), velocity.mul(0.9)),
);
```

:::


### archetypes()
```luau
function query.archetypes(): { Archetype }
```
Returns the matching archetypes of the query.

Example:
::: code-group

```luau [luau]
for i, archetype in world:query(Position, Velocity).archetypes() do
local columns = archetype.columns
local field = archetype.records
local P = field[Position]
local V = field[Velocity]
for row, entity in archetype.entities do
local position = columns[P][row]
local velocity = columns[V][row]
-- Do something
end
end
```

:::

:::info
This function is meant for internal usage. Use this if you want to maximize performance by inlining the iterator.
:::
# Query

A World contains entities which have components. The World is queryable and can be used to get entities with a specific set of components.

# Functions

## drain()
```luau
function query:drain(): Query
```
This function will impede it from being reset when the query is being iterated.

## next()
```luau
function query:next(): Query
```
Get the next result in the query. Drain must have been called beforehand or otherwise it will error.

## with()
```luau
function query:with(
...: Entity -- The IDs to query with
): Query
```
Adds IDs to query with, but will not use their data. This is useful for Tags or generally just data you do not care for.

Example:
::: code-group

```luau [luau]
for id, position in world:query(Position):with(Velocity) do
-- Do something
end
```

```ts [typescript]
for (const [id, position] of world.query(Position).with(Velocity)) {
// Do something
}
```

:::

:::info
Put the IDs inside of `world:query()` instead if you need the data.
:::

## without()

```luau
function query:without(
...: Entity -- The IDs to filter against.
): Query -- Returns the Query
```
Removes entities with the provided IDs from the query.

Example:
::: code-group

```luau [luau]
for _ in world:query(Position):without(Velocity) do
-- Do something
end
```

```ts [typescript]
for (const _ of world.query(Position).without(Velocity)) {
// Do something
}
```

:::

## replace()

```luau
function query:replace(
fn: (entity: Entity, ...: T...) -> U... -- ): () -- The callback that will transform the entities' data
```
This function takes a callback which is given the current queried data of each matching entity. The values returned by the callback will be set as the new data for each given ID on the entity.

Example:
::: code-group

```luau [luau]
world:query(Position, Velocity):replace(function(e, position, velocity)
return position + velocity, velocity * 0.9
end
```

```ts [typescript]
world
.query(Position, Velocity)
.replace((e, position, velocity) =>
$tuple(position.add(velocity), velocity.mul(0.9)),
);
```

:::


## archetypes()
```luau
function query.archetypes(): { Archetype }
```
Returns the matching archetypes of the query.

Example:
::: code-group

```luau [luau]
for i, archetype in world:query(Position, Velocity).archetypes() do
local columns = archetype.columns
local field = archetype.records
local P = field[Position]
local V = field[Velocity]
for row, entity in archetype.entities do
local position = columns[P][row]
local velocity = columns[V][row]
-- Do something
end
end
```

:::

:::info
This function is meant for internal usage. Use this if you want to maximize performance by inlining the iterator.
:::
Loading

0 comments on commit 1067a17

Please sign in to comment.