@intlayer/docs 5.5.8

package/es/dictionary/condition.md

@@ -0,0 +1,213 @@
+# Contenido Condicional / Condición en Intlayer
+
+## Cómo Funciona la Condición
+
+En Intlayer, el contenido condicional se logra a través de la función `cond`, que asigna condiciones específicas (típicamente valores booleanos) a su contenido correspondiente. Este enfoque permite seleccionar dinámicamente el contenido basado en una condición dada. Cuando se integra con React Intlayer o Next Intlayer, el contenido apropiado se elige automáticamente según la condición proporcionada en tiempo de ejecución.
+
+## Configuración de Contenido Condicional
+
+Para configurar contenido condicional en tu proyecto Intlayer, crea un módulo de contenido que incluya tus definiciones condicionales. A continuación, se muestran ejemplos en varios formatos.
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+import { cond, type Dictionary } from "intlayer";
+
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "mi contenido cuando es verdadero",
+      false: "mi contenido cuando es falso",
+      fallback: "mi contenido cuando la condición falla", // Opcional
+    }),
+  },
+} satisfies Dictionary;
+
+export default myConditionalContent;
+```
+
+```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+import { cond } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "mi contenido cuando es verdadero",
+      false: "mi contenido cuando es falso",
+      fallback: "mi contenido cuando la condición falla", // Opcional
+    }),
+  },
+};
+
+export default myConditionalContent;
+```
+
+```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+const { cond } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "mi contenido cuando es verdadero",
+      false: "mi contenido cuando es falso",
+      fallback: "mi contenido cuando la condición falla", // Opcional
+    }),
+  },
+};
+
+module.exports = myConditionalContent;
+```
+
+```json5 fileName="**/*.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "my_key",
+  "content": {
+    "myCondition": {
+      "nodeType": "condition",
+      "condition": {
+        "true": "mi contenido cuando es verdadero",
+        "false": "mi contenido cuando es falso",
+        "fallback": "mi contenido cuando la condición falla", // Opcional
+      },
+    },
+  },
+}
+```
+
+> Si no se declara un fallback, la última clave declarada se tomará como fallback si la condición no se valida.
+
+## Uso de Contenido Condicional con React Intlayer
+
+Para utilizar contenido condicional dentro de un componente React, importa y usa el hook `useIntlayer` del paquete `react-intlayer`. Este hook obtiene el contenido para la clave especificada y te permite pasar una condición para seleccionar la salida apropiada.
+
+```tsx fileName="**/*.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const ConditionalComponent: FC = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* Salida: mi contenido cuando es verdadero */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* Salida: mi contenido cuando es falso */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* Salida: mi contenido cuando la condición falla */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* Salida: mi contenido cuando la condición falla */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+```javascript fileName="**/*.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const ConditionalComponent = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* Salida: mi contenido cuando es verdadero */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* Salida: mi contenido cuando es falso */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* Salida: mi contenido cuando la condición falla */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* Salida: mi contenido cuando la condición falla */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+```javascript fileName="**/*.cjs" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const ConditionalComponent = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* Salida: mi contenido cuando es verdadero */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* Salida: mi contenido cuando es falso */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* Salida: mi contenido cuando la condición falla */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* Salida: mi contenido cuando la condición falla */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+module.exports = ConditionalComponent;
+```
+
+## Recursos Adicionales
+
+Para obtener información más detallada sobre la configuración y el uso, consulta los siguientes recursos:
+
+- [Documentación de Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/es/intlayer_cli.md)
+- [Documentación de React Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/es/intlayer_with_create_react_app.md)
+- [Documentación de Next Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/es/intlayer_with_nextjs_15.md)
+
+Estos recursos ofrecen más información sobre la configuración y el uso de Intlayer en diversos entornos y frameworks.

package/es/dictionary/content_extention_customization.md

@@ -0,0 +1,81 @@
+# Personalización de Extensiones de Contenido
+
+## Extensiones de Archivos de Contenido
+
+Intlayer permite personalizar las extensiones para los archivos de declaración de contenido. Esta personalización proporciona flexibilidad en la gestión de proyectos a gran escala y ayuda a evitar conflictos con otros módulos.
+
+### Extensiones Predeterminadas
+
+Por defecto, Intlayer supervisa todos los archivos con las siguientes extensiones para declaraciones de contenido:
+
+- `.content.json`
+- `.content.ts`
+- `.content.tsx`
+- `.content.js`
+- `.content.jsx`
+- `.content.mjs`
+- `.content.mjx`
+- `.content.cjs`
+- `.content.cjx`
+
+Estas extensiones predeterminadas son adecuadas para la mayoría de las aplicaciones. Sin embargo, cuando tienes necesidades específicas, puedes definir extensiones personalizadas para optimizar el proceso de construcción y reducir el riesgo de conflictos con otros componentes.
+
+### Personalización de Extensiones de Contenido
+
+Para personalizar las extensiones de archivo que Intlayer utiliza para identificar archivos de declaración de contenido, puedes especificarlas en el archivo de configuración de Intlayer. Este enfoque es beneficioso para proyectos a gran escala donde limitar el alcance del proceso de supervisión mejora el rendimiento de la construcción.
+
+Aquí tienes un ejemplo de cómo definir extensiones de contenido personalizadas en tu configuración:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  content: {
+    fileExtensions: [".my_content.ts", ".my_content.tsx"], // Tus extensiones personalizadas
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  content: {
+    fileExtensions: [".my_content.cjs", ".my_content.cjx"], // Tus extensiones personalizadas
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  content: {
+    fileExtensions: [".my_content.mjs", ".my_content.mjx"], // Tus extensiones personalizadas
+  },
+};
+
+module.exports = config;
+```
+
+En este ejemplo, la configuración especifica dos extensiones personalizadas: `.my_content.ts` y `.my_content.tsx`. Intlayer solo supervisará archivos con estas extensiones para construir diccionarios.
+
+### Beneficios de las Extensiones Personalizadas
+
+- **Rendimiento de Construcción**: Reducir el alcance de los archivos supervisados puede mejorar significativamente el rendimiento de construcción en proyectos grandes.
+- **Evitar Conflictos**: Las extensiones personalizadas ayudan a prevenir conflictos con otros archivos JavaScript o TypeScript en tu proyecto.
+- **Organización**: Las extensiones personalizadas te permiten organizar tus archivos de declaración de contenido según las necesidades de tu proyecto.
+
+### Directrices para Extensiones Personalizadas
+
+Al personalizar las extensiones de archivos de contenido, ten en cuenta las siguientes directrices:
+
+- **Unicidad**: Elige extensiones que sean únicas dentro de tu proyecto para evitar conflictos.
+- **Nombres Consistentes**: Usa convenciones de nombres consistentes para una mejor legibilidad y mantenimiento del código.
+- **Evitar Extensiones Comunes**: Evita usar extensiones comunes como `.ts` o `.js` para prevenir conflictos con otros módulos o bibliotecas.
+
+## Conclusión
+
+Personalizar las extensiones de archivos de contenido en Intlayer es una característica valiosa para optimizar el rendimiento y evitar conflictos en aplicaciones a gran escala. Siguiendo las directrices descritas en esta documentación, puedes gestionar eficazmente tus declaraciones de contenido y garantizar una integración fluida con otras partes de tu proyecto.

package/es/dictionary/enumeration.md

@@ -0,0 +1,221 @@
+# Enumeración / Pluralización
+
+## Cómo funciona la enumeración
+
+En Intlayer, la enumeración se logra a través de la función `enu`, que asigna claves específicas a su contenido correspondiente. Estas claves pueden representar valores numéricos, rangos o identificadores personalizados. Cuando se utiliza con React Intlayer o Next Intlayer, el contenido apropiado se selecciona automáticamente según la configuración regional de la aplicación y las reglas definidas.
+
+## Configuración de la enumeración
+
+Para configurar la enumeración en tu proyecto de Intlayer, necesitas crear un módulo de contenido que incluya definiciones de enumeración. Aquí tienes un ejemplo de una enumeración simple para el número de autos:
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+import { enu, type Dictionary } from "intlayer";
+
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "Menos de menos un auto",
+      "-1": "Menos un auto",
+      "0": "Sin autos",
+      "1": "Un auto",
+      ">5": "Algunos autos",
+      ">19": "Muchos autos",
+      "fallback": "Valor por defecto", // Opcional
+    }),
+  },
+} satisfies Dictionary;
+
+export default carEnumeration;
+```
+
+```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+import { enu } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "Menos de menos un auto",
+      "-1": "Menos un auto",
+      "0": "Sin autos",
+      "1": "Un auto",
+      ">5": "Algunos autos",
+      ">19": "Muchos autos",
+      "fallback": "Valor por defecto", // Opcional
+    }),
+  },
+};
+
+export default carEnumeration;
+```
+
+```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+const { enu } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "Menos de menos un auto",
+      "-1": "Menos un auto",
+      "0": "Sin autos",
+      "1": "Un auto",
+      ">5": "Algunos autos",
+      ">19": "Muchos autos",
+      "fallback": "Valor por defecto", // Opcional
+    }),
+  },
+};
+
+module.exports = carEnumeration;
+```
+
+```json fileName="**/*.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "car_count",
+  "content": {
+    "numberOfCar": {
+      "nodeType": "enumeration",
+      "enumeration": {
+        "<-1": "Menos de menos un auto",
+        "-1": "Menos un auto",
+        "0": "Sin autos",
+        "1": "Un auto",
+        ">5": "Algunos autos",
+        ">19": "Muchos autos",
+        "fallback": "Valor por defecto" // Opcional
+      }
+    }
+  }
+}
+```
+
+En este ejemplo, `enu` asigna varias condiciones a contenido específico. Cuando se utiliza en un componente de React, Intlayer puede elegir automáticamente el contenido apropiado basado en la variable dada.
+
+> El orden de declaración es importante en las enumeraciones de Intlayer. La primera declaración válida es la que se seleccionará. Si se aplican múltiples condiciones, asegúrate de que estén ordenadas correctamente para evitar comportamientos inesperados.
+
+> Si no se declara un valor por defecto, la función devolverá `undefined` si no coincide ninguna clave.
+
+## Uso de enumeración con React Intlayer
+
+Para usar la enumeración en un componente de React, puedes aprovechar el hook `useIntlayer` del paquete `react-intlayer`. Este hook recupera el contenido correcto basado en el ID especificado. Aquí tienes un ejemplo de cómo usarlo:
+
+```tsx fileName="**/*.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const CarComponent: FC = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // Salida: Sin autos
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // Salida: Algunos autos
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // Salida: Muchos autos
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // Salida: Valor por defecto
+        }
+      </p>
+    </div>
+  );
+};
+```
+
+```javascript fileName="**/*.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const CarComponent = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // Salida: Sin autos
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // Salida: Algunos autos
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // Salida: Muchos autos
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // Salida: Valor por defecto
+        }
+      </p>
+    </div>
+  );
+};
+
+export default CarComponent;
+```
+
+```javascript fileName="**/*.cjs" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const CarComponent = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // Salida: Sin autos
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // Salida: Algunos autos
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // Salida: Muchos autos
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // Salida: Valor por defecto
+        }
+      </p>
+    </div>
+  );
+};
+
+module.exports = CarComponent;
+```
+
+En este ejemplo, el componente ajusta dinámicamente su salida según el número de autos. El contenido correcto se elige automáticamente, dependiendo del rango especificado.
+
+## Recursos adicionales
+
+Para obtener información más detallada sobre la configuración y el uso, consulta los siguientes recursos:
+
+- [Documentación de Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/es/intlayer_cli.md)
+- [Documentación de React Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/es/intlayer_with_create_react_app.md)
+- [Documentación de Next Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/es/intlayer_with_nextjs_15.md)
+
+Estos recursos proporcionan más información sobre la configuración y el uso de Intlayer en diferentes entornos y con varios frameworks.