Update Docs and Changelog

Author: ikraamg

trmnl-ha/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Added
+
+- Generic URL mode for capturing any website (not just Home Assistant)
+- PNG compression level control (`compression_level` parameter)
+- Manual black/white level adjustments with `levels_enabled` toggle
+- HA connection diagnostics banner with token preview and status
+- `?refresh=1` query param to force HA connection refresh
+
 ## [0.3.2] - 2025-12-30
 
 ### Changed

trmnl-ha/DOCS.md

@@ -160,6 +160,10 @@ http://localhost:10000/?url=https://status.github.com&viewport=800x480
 | `dithering` | No | flag | Enable advanced dithering for e-ink |
 | `dither_method` | No | `floyd-steinberg`, `ordered`, `none` | Dithering algorithm (default: `floyd-steinberg`) |
 | `palette` | No | `bw`, `gray-4`, `gray-16`, `gray-256` | Color palette for dithering |
+| `compression_level` | No | `1-9` | PNG compression level (default: `9`, max compression) |
+| `levels_enabled` | No | flag | Enable manual black/white level adjustments |
+| `black_level` | No | `0-100` | Black point (requires `levels_enabled`) |
+| `white_level` | No | `0-100` | White point (requires `levels_enabled`) |
 | `format` | No | `png`, `jpeg`, `bmp` | Output format (default: `png`) |
 | `rotate` | No | `90`, `180`, `270` | Rotation in degrees |
 | `theme` | No | string | Home Assistant theme name (HA mode only) |
@@ -257,6 +261,16 @@ For best e-ink results:
 2. Check that the dashboard path is correct
 3. Increase the `wait` parameter if the dashboard has many dynamic elements
 
+### HA Connection Issues
+
+When Home Assistant is not connected, the Web UI displays a diagnostic banner showing:
+
+- **Status**: Why the connection failed (e.g., "Network error", "401 Unauthorized")
+- **URL**: The configured Home Assistant URL
+- **Token**: First 4 characters of your token (masked) for verification
+
+If the connection data seems stale, add `?refresh=1` to the URL to force a fresh connection attempt.
+
 ## Security Considerations
 
 ### Network Isolation

trmnl-ha/ha-trmnl/tests/unit/dithering.test.ts

@@ -37,19 +37,25 @@ describe('Dithering Module', () => {
             return
           }
           stdout.on('data', (chunk: Buffer) => chunks.push(chunk))
-          stdout.on('end', () => { resolve(Buffer.concat(chunks)); })
+          stdout.on('end', () => {
+            resolve(Buffer.concat(chunks))
+          })
           stdout.on('error', reject)
         })
     })
-  })
+  }, 15000)
 
   // ==========================================================================
   // Constants - Test that module exports expected values
   // ==========================================================================
 
   describe('SUPPORTED_METHODS', () => {
     it('exports array of supported dithering methods', () => {
-      expect(SUPPORTED_METHODS).toEqual(['floyd-steinberg', 'ordered', 'threshold'])
+      expect(SUPPORTED_METHODS).toEqual([
+        'floyd-steinberg',
+        'ordered',
+        'threshold',
+      ])
     })
   })
 
@@ -113,7 +119,9 @@ describe('Dithering Module', () => {
 
     it('falls back to defaults when invalid method provided', () => {
       // NOTE: Intentionally testing with invalid input - type assertion required
-      const result = validateDitheringOptions({ method: 'invalid-method' as DitheringMethod })
+      const result = validateDitheringOptions({
+        method: 'invalid-method' as DitheringMethod,
+      })
       expect(result.method).toBe('floyd-steinberg')
     })
 
@@ -406,11 +414,13 @@ describe('Dithering Module', () => {
               return
             }
             stdout.on('data', (chunk: Buffer) => chunks.push(chunk))
-            stdout.on('end', () => { resolve(Buffer.concat(chunks)); })
+            stdout.on('end', () => {
+              resolve(Buffer.concat(chunks))
+            })
             stdout.on('error', reject)
           })
       })
-    })
+    }, 15000)
 
     it('produces 1-bit BW images under 50KB for 800x480', async () => {
       const result = await applyDithering(largeTestImage, {