senrecep/tsentials/tsentials-enums

npm install tsentials

import { defineEnum } from 'tsentials/enums';
import type { EnumMember, EnumDefinition, EnumParseOptions, EnumNaming } from 'tsentials/enums';

const Status = defineEnum('Status', {
  Pending: {},                       // wire name 'pending' (default naming snake_case_lower), value 0
  Active: 'on',                      // string = explicit wire name, value 1
  Disabled: { aliases: ['off'] },    // extra accepted input, value 2
  Unknown: { fallback: true },       // used in data mode for unknown input
});
type Status = EnumMember<typeof Status>;   // 'Pending' | 'Active' | 'Disabled' | 'Unknown'

Status.parse('on');                       // success('Active'); also 'ACTIVE', 'Active' (case-insensitive)
Status.parse('off');                      // success('Disabled') via alias
Status.parse('2');                        // success('Disabled') — numeric text accepted
Status.parse('nope');                     // failure 'Enum.InvalidValue' (Validation, lists allowed values)
Status.parse('nope', { mode: 'data' });   // success('Unknown') — data mode uses the fallback member
Status.parse('x', { path: 'status' });    // path is included in the error
Status.parseNumber(1);                    // success('Active')

Status.format('Active');            // 'on'
Status.format('Active', 'number');  // '1'
Status.numberOf('Disabled');        // 2
Status.is('Active');                // type guard: value is Status
Status.keys;                        // member names
Status.wireNames;                   // wire names
Status.members;                     // EnumMemberInfo[] (name, wireName, value, aliases, ...)
Status.infoOf('Active');