fix(pt): add missing portuguese export and fix "e" connector

- Add portuguese to named exports in index.js (Codex review)
- Fix Portuguese join logic to correctly use "e" between higher
  scale groups (milhão/bilhão) and thousands (mil)
- Add comprehensive Portuguese test suite with 8 test cases
- Add toWords test for Portuguese language

Fixes the issue where "um milhão mil" was output instead of
the correct "um milhão e mil" for 1,001,000.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: brianfunk

index.js

@@ -22,7 +22,7 @@
 import { english, spanish, french, german, danish, chinese, hindi, russian, portuguese, LANGUAGES } from './languages/index.js';
 
 // Re-export language functions
-export { spanish, french, german, danish, chinese, hindi, russian };
+export { spanish, french, german, danish, chinese, hindi, russian, portuguese };
 
 // ============================================================================
 // CONSTANTS

languages/pt.js

@@ -117,10 +117,17 @@ const portuguese = (n, opt) => {
   let result = '';
   for (let i = 0; i < parts.length; i++) {
     if (i > 0) {
-      // Use "e" (and) for connecting in Portuguese
+      const prevPart = parts[i - 1];
       const currPart = parts[i];
-      // Add "e" when the current part is less than 100 or ends with 00
-      if (currPart && !currPart.includes('mil') && !currPart.includes('ilhão') && !currPart.includes('ilhões')) {
+
+      // Use "e" (and) for connecting in Portuguese when:
+      // 1. Current part has no scale word (final small numbers)
+      // 2. Previous part has a higher scale (milhão+) and current part has "mil"
+      const prevHasHigherScale = prevPart && (prevPart.includes('ilhão') || prevPart.includes('ilhões'));
+      const currHasMil = currPart && currPart.includes('mil');
+      const currHasNoScale = currPart && !currHasMil && !currPart.includes('ilhão') && !currPart.includes('ilhões');
+
+      if (currHasNoScale || (prevHasHigherScale && currHasMil)) {
         result += ' e ';
       } else {
         result += ' ';

test/index.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import numberstring, { comma, group, ordinal, decimal, currency, roman, parse, negative, fraction, year, telephone, percent, spanish, french, german, danish, chinese, hindi, russian, toWords } from '../index.js';
+import numberstring, { comma, group, ordinal, decimal, currency, roman, parse, negative, fraction, year, telephone, percent, spanish, french, german, danish, chinese, hindi, russian, portuguese, toWords } from '../index.js';
 
 describe('numberstring', () => {
   describe('basic conversions', () => {
@@ -973,6 +973,64 @@ describe('toWords', () => {
     expect(toWords(42, { lang: 'russian' })).toBe('сорок два');
     expect(toWords(42, { lang: 'русский' })).toBe('сорок два');
   });
+
+  it('converts to Portuguese', () => {
+    expect(toWords(42, { lang: 'pt' })).toBe('quarenta e dois');
+    expect(toWords(42, { lang: 'portuguese' })).toBe('quarenta e dois');
+    expect(toWords(42, { lang: 'português' })).toBe('quarenta e dois');
+  });
+});
+
+describe('portuguese', () => {
+  it('converts basic numbers', () => {
+    expect(portuguese(0)).toBe('zero');
+    expect(portuguese(1)).toBe('um');
+    expect(portuguese(10)).toBe('dez');
+    expect(portuguese(15)).toBe('quinze');
+    expect(portuguese(21)).toBe('vinte e um');
+    expect(portuguese(42)).toBe('quarenta e dois');
+  });
+
+  it('converts hundreds', () => {
+    expect(portuguese(100)).toBe('cem');
+    expect(portuguese(101)).toBe('cento e um');
+    expect(portuguese(200)).toBe('duzentos');
+    expect(portuguese(500)).toBe('quinhentos');
+    expect(portuguese(123)).toBe('cento e vinte e três');
+  });
+
+  it('converts thousands', () => {
+    expect(portuguese(1000)).toBe('mil');
+    expect(portuguese(2000)).toBe('dois mil');
+    expect(portuguese(1001)).toBe('mil e um');
+    expect(portuguese(2500)).toBe('dois mil e quinhentos');
+    expect(portuguese(10000)).toBe('dez mil');
+    expect(portuguese(100000)).toBe('cem mil');
+  });
+
+  it('converts millions', () => {
+    expect(portuguese(1000000)).toBe('um milhão');
+    expect(portuguese(2000000)).toBe('dois milhões');
+    expect(portuguese(1500000)).toBe('um milhão e quinhentos mil');
+  });
+
+  it('uses "e" connector between higher scales and thousands', () => {
+    // This is the specific bug fix - "um milhão e mil" not "um milhão mil"
+    expect(portuguese(1001000)).toBe('um milhão e mil');
+    expect(portuguese(2001000)).toBe('dois milhões e mil');
+    expect(portuguese(1002000)).toBe('um milhão e dois mil');
+  });
+
+  it('applies capitalization', () => {
+    expect(portuguese(42, { cap: 'title' })).toBe('Quarenta E Dois');
+    expect(portuguese(42, { cap: 'upper' })).toBe('QUARENTA E DOIS');
+  });
+
+  it('returns false for invalid input', () => {
+    expect(portuguese(-1)).toBe(false);
+    expect(portuguese(NaN)).toBe(false);
+    expect(portuguese('abc')).toBe(false);
+  });
 });
 
 describe('comma', () => {