Generador de enumeraciones de TypeScript

Los enumerados de cadena asignan valores de cadena a cada miembro, como Color.Rojo equivale a la cadena ROJO. Los enumerados numéricos asignan números incrementales comenzando desde 0 por defecto, así que Color.Rojo equivale a 0 y Color.Azul equivale a 1. Los enumerados de cadena son mejores para depuración porque los valores son legibles en registros y solicitudes de red. Los enumerados numéricos son ligeramente más compactos y soportan mapeo inverso nativamente, lo que significa que puedes buscar el nombre desde el número. La mayoría de los proyectos modernos de TypeScript prefieren enumerados de cadena por claridad.

Los enums de solo lectura se inyectan completamente durante la compilación. El compilador TypeScript reemplaza cada referencia a un miembro del enum de solo lectura con su valor literal, por lo que no existe ningún objeto del enum en tiempo de ejecución. Esto produce tamaños más pequeños de paquete y mayor rendimiento. Sin embargo, los enums de solo lectura no pueden iterarse (no hay `Object.values`), no soportan mapeo inverso y pueden causar problemas con archivos de declaración en el código de bibliotecas. Usa enums de solo lectura para constantes internas de tu aplicación donde quieras un sobrecarga cero en tiempo de ejecución. Usa enums regulares cuando necesites iterar sobre los valores o al publicar una biblioteca.

Un objeto como `as const` utiliza un objeto plano de JavaScript con una afirmación de `const` para lograr comportamiento similar a enumeraciones. Por ejemplo, `const Color = { Red: 'RED', Blue: 'BLUE' } as const` crea un objeto inmutable donde TypeScript infiere los tipos literales. Este enfoque funciona tanto en TypeScript como en JavaScript, soporta mejor el *tree-shaking* que las enumeraciones y evita algunos casos límite con la transpileración de enumeraciones. El intercambio es una extracción de tipos ligeramente más verbosa: necesitas `type Color = typeof Color[keyof typeof Color]` para obtener el tipo de unión. Muchas equipos prefieren los objetos `as const` sobre las enumeraciones por estas razones prácticas.

Un guardio de tipo es una función que estrecha el tipo de un valor en tiempo real. Para un `enum`, un guardio de tipo verifica si una cadena o número es, efectivamente, un miembro válido del `enum` y comunica al sistema de tipos de TypeScript el resultado. Por ejemplo: ```typescript function isColor(value: string): value is Color { return true solo si el valor coincide con un miembro del enum. } ``` Esto es útil cuando se valida una respuesta de API, entradas en formularios o cualquier dato externo donde necesites confirmar que un valor pertenece a tu `enum` antes de usarlo en código seguro tipado.