@appius-fr/apx 2.7.1 → 2.8.0

package/APX.mjs

@@ -3,8 +3,7 @@ import augmentWithTristate from './modules/tristate/tristate.mjs';
 import augmentWithScrollableTable from './modules/scrollableTable/scrollableTable.mjs';
 import dialog from './modules/dialog/dialog.mjs';
 import toast from './modules/toast/toast.mjs';
-import { loadCss } from './modules/common.mjs';
-import { augmentWithPack, tools } from './modules/tools/exports.mjs';
+import { augmentWithPack, tools, loadCss } from './modules/tools/exports.mjs';
 
 /**
  * Creates an APX object that wraps one or more HTML elements.

package/README.md

@@ -123,9 +123,9 @@ APX('table.my-table').scrollableTable('refresh');
 
 ### `tools` (since 2.6.0)
 
-The `tools` module provides utility functions for common web development tasks. Currently includes form handling utilities with more tools planned for future releases.
+The `tools` module provides utility functions for common web development tasks: form handling (form-packer), dynamic CSS loading (`loadCss`), scrollbar measurement (`getScrollbarSize`), and more planned for future releases. Since 2.8.0, `loadCss` lives in tools (upgraded; idempotent, rejects on failure, optional options) and `getScrollbarSize` was added.
 
-**Documentation:** [`modules/tools/README.md`](./modules/tools/README.md)
+**Documentation:** [`modules/tools/README.md`](./modules/tools/README.md) · **Changelog:** [`modules/tools/CHANGELOG.md`](./modules/tools/CHANGELOG.md)
 
 **Quick Start:**
 ```javascript
@@ -133,20 +133,26 @@ The `tools` module provides utility functions for common web development tasks.
 const data = APX('form#myForm').pack();
 // or
 const data = APX.tools.packFormToJSON(document.querySelector('#myForm'));
+
+// Load CSS (idempotent; since 2.8.0 also APX.tools.loadCss)
+await APX.loadCss('/path/to/styles.css');
+
+// Scrollbar size in pixels (cached; since 2.8.0)
+const scrollbarWidth = APX.tools.getScrollbarSize();
 ```
 
-**Sub-modules:**
+**Sub-modules / utilities:**
 - **`form-packer`**: Convert HTML forms to JSON with support for nested objects, arrays, and complex structures.
   - Documentation: [`modules/tools/form-packer/README.md`](./modules/tools/form-packer/README.md)
+- **`loadCss`** (since 2.8.0 in tools): Dynamic CSS loading; also available as `APX.loadCss`. See [`modules/tools/README.md`](./modules/tools/README.md).
+- **`getScrollbarSize`** (since 2.8.0): Scrollbar size in pixels; `APX.tools.getScrollbarSize()`.
 
 **Demo page:**
 - `demo/modules/tools/index.html` (interactive form examples and validation)
 
 ### Utilities
 
-- **`loadCss`**: Dynamically load CSS files into your document.
-
-Documentation: [`modules/common.mjs`](./modules/common.mjs)
+- **`loadCss`**: Dynamically load CSS files (since 2.8.0: idempotent, rejects on failure, optional `options`). Use `APX.loadCss(url)` or `APX.tools.loadCss(url, options?)`. See [`modules/tools/README.md`](./modules/tools/README.md).
 
 ## Usage
 
@@ -198,7 +204,7 @@ const apx7 = APX(() => APX('.example'));
 
 ### Utilities
 
-- **`APX.loadCss()`**: Dynamically load CSS files.
+- **`APX.loadCss(url, options?)`**: Dynamically load CSS files (since 2.8.0: idempotent, rejects on failure; optional `options`: `id`, `media`, `before`). Also `APX.tools.loadCss()`.
 - **`APX.dialog()`**: Manage and display dialogs. See [`modules/dialog/README.md`](./modules/dialog/README.md)
 - **`APX.toast`**: Toast notification system. See [`modules/toast/README.md`](./modules/toast/README.md)
 - **`APX('table').scrollableTable(options)`**: Scrollable tbody with fixed thead/tfoot. See [`modules/scrollableTable/README.md`](./modules/scrollableTable/README.md)