TinyFlags — npm (JavaScript)

The npm port of TinyFlags. Authored as JSDoc + // @ts-check ES modules; ships .d.ts for TypeScript consumers. Behavior, validation, and test-coverage requirements are shared across every ecosystem — see ../lib-spec.md.

Package-native AXM recommendation

npm packages recommend extensions via an axm field in package.json:

{
  "axm": {
    "recommendedExtensions": ["@examples/packs/javascript-npm-tinyflags@^0.1.0"]
  }
}

axm discover reads this from node_modules/@agentxm/example-tinyflags/package.json in any consumer project.

Commands

npm install
npm run typecheck   # tsc --noEmit against JSDoc-typed src/
npm test            # node --test
npm run test:coverage
npm run build       # tsc → emits .d.ts to dist/

Companion extensions

Sources live under .axm/extensions/@examples/ and are marked authored in .axm/settings.json. The pack bundles the three skills and the maintainer subagent.

| Type | FQN | Homepage | | -------- | ---------------------------------------------------------- | --------------------------------------------------------------------------- | | Skill | @examples/skills/javascript-npm-tinyflags-add-flag | https://agentxm.ai/@examples/skills/javascript-npm-tinyflags-add-flag | | Skill | @examples/skills/javascript-npm-tinyflags-rollout-review | https://agentxm.ai/@examples/skills/javascript-npm-tinyflags-rollout-review | | Skill | @examples/skills/javascript-npm-tinyflags-cleanup-flag | https://agentxm.ai/@examples/skills/javascript-npm-tinyflags-cleanup-flag | | Subagent | @examples/subagents/javascript-npm-tinyflags-maintainer | https://agentxm.ai/@examples/subagents/javascript-npm-tinyflags-maintainer | | Pack | @examples/packs/javascript-npm-tinyflags | https://agentxm.ai/@examples/packs/javascript-npm-tinyflags |

Each manifest declares pkg:npm/%40agentxm/example-tinyflags as a companion package. The npm fixture is the only port that also demonstrates the optional versionRange (VERS) shape — see ../README.md.

Paired consumer

../javascript-npm-app/ — the pawmatch CLI that consumes this library through realistic flag seams.