pjc-fields 0.0.63 → 0.0.65

package/fesm2022/pjc-fields.mjs

@@ -2929,13 +2929,69 @@ class PjcUtils {
     }
     /**
      * Converte unidade de medida para extenso, respeitando gênero.
+     * Para quilograma e litro, a parte decimal é convertida para a subunidade
+     * correspondente (grama e mililitro, respectivamente).
      */
     static unidadeMedidaPorExtenso(valor, unidade) {
         const config = configUnidades[unidade];
+        if (unidade === 'quilograma' || unidade === 'litro') {
+            const resultado = PjcUtils.unidadeComSubunidade(valor, unidade, config);
+            if (resultado)
+                return resultado;
+        }
         const textoNumero = PjcUtils.numeroPorExtenso(valor, config.feminino);
         const textoUnidade = valor === 1 ? config.singular : config.plural;
         return `${textoNumero} ${textoUnidade}`;
     }
+    static unidadeComSubunidade(valor, unidade, config) {
+        const inteiros = Math.floor(valor);
+        const decimal = Math.round((valor - inteiros) * 1000);
+        if (decimal === 0)
+            return null;
+        const partes = [];
+        if (inteiros > 0) {
+            const textoInteiros = PjcUtils.numeroPorExtenso(inteiros, config.feminino);
+            const textoUnidade = inteiros === 1 ? config.singular : config.plural;
+            partes.push(`${textoInteiros} ${textoUnidade}`);
+        }
+        const subUnidade = unidade === 'quilograma' ? 'grama' : 'mililitro';
+        const subConfig = configUnidades[subUnidade];
+        const textoDecimal = PjcUtils.numeroPorExtenso(decimal, subConfig.feminino);
+        const textoSubUnidade = decimal === 1 ? subConfig.singular : subConfig.plural;
+        partes.push(`${textoDecimal} ${textoSubUnidade}`);
+        return partes.join(' e ');
+    }
+    /**
+     * Converte múltiplas unidades de massa para extenso em uma única string.
+     * Todos os parâmetros são opcionais. Os valores informados são convertidos
+     * para extenso e concatenados com vírgulas e "e" antes do último item.
+     *
+     * Exemplo:
+     *   PjcUtils.massaPorExtenso({ quilograma: 1, grama: 200, miligrama: 100, centigrama: 500 })
+     *   // => "um quilograma, duzentos gramas, cem miligramas e quinhentos centigramas"
+     */
+    static massaPorExtenso(params) {
+        const mapeamento = [
+            { chave: 'quilograma', unidade: 'quilograma' },
+            { chave: 'grama', unidade: 'grama' },
+            { chave: 'miligrama', unidade: 'miligrama' },
+            { chave: 'centigrama', unidade: 'centigrama' },
+        ];
+        const partes = [];
+        for (const { chave, unidade } of mapeamento) {
+            const valor = params[chave];
+            if (valor != null && valor > 0) {
+                partes.push(PjcUtils.unidadeMedidaPorExtenso(valor, unidade));
+            }
+        }
+        if (partes.length === 0)
+            return '';
+        if (partes.length === 1)
+            return partes[0];
+        // Junta com vírgulas e "e" antes do último item
+        const ultimo = partes.pop();
+        return `${partes.join(', ')} e ${ultimo}`;
+    }
 }
 
 /*