npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@yellowinnovation/node-necs

v1.0.9

Published

Tiny ECS that does one job

Downloads

14

Readme

Not an ECS

NECS is not an ECS.

It take some principles from the ECS pattern but break some of its rules.

In short:

  • Entity, Components and Systems.
  • Components are not pure data, they can have 'code' and can replace systems in some cases.
  • There is an entity tree: each entity can have child entities. That means there is one 'super entity' which own all entities from your world.
  • On calling update() to an entity, all its childs and component will have earlyUpdate() and lateUpdate() called.

It is like the GameObject (entity) and MonoBehaviour (components) from Unity.

Core design principles:

  • Small and easy to read/edit.
  • It does only one small thing.
  • As it is not super-evolved, it may not fit your needs. It will not be efficient for big datasets.
  • Battle tested and production tested.
  • Fail-fast. Every function call is type and error checked and throw errors: no silent error that will blow somewhere sometime.
  • We use lodash but do require only the functions we need and we do not use chains. It drastically lower the memory footprint.
  • Sub-classing components is supported. One limitation: you must not insert many components sharing a common super class (excepted for AComponent). This limitation is not strictly checked in code due to limitations from Javascript. Making components as mixins may fix the limitation on a later update.

Use cases

It fits cases when you need efficient entity hierarchy for small data set, fast prototyping and easy to maintain production code.

Examples

What you could easily implement:

const world = Entity.createWorld();
world.add(SystemComponent); // This entity is now able to run systems
world.systems.add(DrawSystem); // DrawSystem draw each sprites on-screen

const wall = world.createChild('wall'); // Create an entity in your world. It represent nothing yet
wall.add(SpriteComponent, 'wall.png'); // Your entity will now be drawed on-screen using 'wall.png'
wall.sprite.position.x = 10;
wall.sprite.position.y = 10;

const player = world.createChild('player');
player.add(SpriteComponent, 'player.png');

world.update(); // wall and player are now drawn on screen

wall.sprite.visible = false;

world.update(); // only player is now drawn on screen

Documentation

Everything is documented in the code. It is small enough so you can read the documentation there.

You can also access documentation generated from code in doc/doc.md.

Tests

npm run test

Tests are available in the test folder. They are easy to read but boring, take a look if you want to understand better how it works.

License

This work is dual-licensed under Apache 2.0 and GPL 2.0 (or any later version). You can choose between one of them if you use this work.

SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later