Copyright © 2026 Gage Sorrell. Released under the MIT license.

ts-tag

Purpose. Hierarchical tags with type-safety and a simple build step.

Highlights:

• Create tags directly in your modules, and in JSON/YAML files
• Define reusable query functors with a full boolean algebra
• LSP-friendly, with full type-safety

“What are tags?”

This package is inspired by the Unreal Engine's GameplayTags. While their name suggests that their utility lies in video-game–specific work, they are actually a robust and powerful foundation to data-driven design.

Getting Started

Prerequisites

| Package | Version | |--------:|:--------| | NodeJS | >=24 |

Install this package,

npm install --save ts-tag

While not strictly required, it is highly recommended to install the CLI tool,

npm init ts-tag-cli

Then add the default "prebuild" script to your package.json via the following command,

npx ts-tag-cli

Documentation

@TODO Documentation is available here.