@trunkjs/browser-utils 1.0.49 → 1.0.52

package/.ai-usage-info.md

@@ -2,10 +2,11 @@
 
 ## Purpose
 
-Small browser-side helpers for DOM work, timing, events, storage, and custom-element mixins.
+Small browser-side helpers for DOM work, form values, timing, events, storage, and custom-element mixins.
 
 Use this package when you need:
 - small DOM helpers
+- dynamic named form values and element/value entries
 - debounce / wait helpers
 - localStorage / sessionStorage state
 - logging in custom elements
@@ -16,7 +17,7 @@ Do **not** use it for server-only code.
 ## Import
 
 ```ts
-import { create_element, Debouncer, waitForLoad } from '@trunkjs/browser-utils';
+import { create_element, Debouncer, FormDataAccessor, waitForLoad } from '@trunkjs/browser-utils';
 ```
 
 ## Common examples
@@ -153,6 +154,10 @@ Empty slots get the CSS class:
 <slot class="slot-empty"></slot>
 ```
 
+Notes:
+- whitespace-only text nodes are treated as empty
+- HTML comments are treated as empty as well (important for Lit comment markers)
+
 ## Other exports
 
 ```ts

package/CHANGELOG.md

@@ -1,3 +1,33 @@
+## 1.0.52 (2026-08-29)
+
+### 🩹 Fixes
+
+- **browser-utils:** support non-iterable NodeList ([59b4feb](https://github.com/trunkjs/trunkjs-monorepo/commit/59b4feb))
+
+### ❤️ Thank You
+
+- Matthias Leuffen
+
+## Unreleased
+
+## 1.0.51 (2026-08-29)
+
+### ✨ Features
+
+- Add `FormDataAccessor` for dynamic named DOM values, element/value entries, and native `FormData` output.
+
+### 🩹 Fixes
+
+- **browser-utils:** support non-iterable NodeList ([59b4feb](https://github.com/trunkjs/trunkjs-monorepo/commit/59b4feb))
+
+### ❤️ Thank You
+
+- Matthias Leuffen
+
+## 1.0.50 (2026-05-19)
+
+This was a version bump only for browser-utils to align it with other projects, there were no code changes.
+
 ## 1.0.49 (2026-05-18)
 
 This was a version bump only for browser-utils to align it with other projects, there were no code changes.

package/README.md

@@ -4,6 +4,7 @@ A small collection of browser-focused, framework-agnostic utilities that make co
 
 Exports:
 - create_element: Minimal DOM element factory
+- FormDataAccessor: Dynamic named form values and element/value entries
 - Debouncer: Debounce helper with optional max-delay
 - Stopwatch: Lightweight performance timer with lap logging
 - waitFor, waitForDomContentLoaded, waitForLoad, sleep, waitForAnimationEnd: Promise-based event and timing helpers
@@ -22,6 +23,25 @@ import { } from '@trunkjs/browser-utils';
 
 ## Quick start
 
+### `class FormDataAccessor`: Read and write named controls
+
+```ts
+import { FormDataAccessor } from '@trunkjs/browser-utils';
+
+const accessor = new FormDataAccessor(document.querySelector('#profile')!);
+accessor.data = { name: 'Erika', topics: ['docs'] };
+
+console.log(accessor.data);
+console.log(accessor.formData);
+
+accessor.entries.forEach(({ name, value, element }) => {
+  console.log(name, value, element);
+});
+```
+
+The control list is queried again on every access, so later DOM changes are reflected automatically. Use `entries`
+when state such as `validated`, `invalid`, or `disabled` must be applied directly to the original elements.
+
 ### `function create_element()`: Create and append an element
 
 ```ts

package/index.d.ts

@@ -1,6 +1,7 @@
 export * from './lib/breakpoints';
 export * from './lib/create-element';
 export * from './lib/Debouncer';
+export * from './lib/FormDataAccessor';
 export * from './lib/get-error-location';
 export * from './lib/Logger';
 export * from './lib/Stopwatch';