@appius-fr/apx 2.7.0 → 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

@@ -102,12 +102,30 @@ APX.toast.use('admin').info('Admin ready');
 - `demo/index.html` (landing)
 - `demo/modules/toast/index.html` (basic and advanced examples with code viewer)
 - `demo/modules/tristate/index.html` (state preview and interactive cycle)
+- `demo/modules/scrollableTable/index.html` (scrollable tbody with colspan/rowspan)
+
+### `scrollableTable` (since 2.7.0)
+
+Makes the **tbody** of a table scrollable while keeping thead and tfoot fixed. Uses CSS Grid with subgrid; column and row sizes can be preserved from the table’s natural layout or overridden (full or hybrid). **Dynamic body height** (2.7.1): `bodyHeightDynamic: { get, useAs, updateOn? }` re-resolves height on resize (and optionally scroll); default `updateOn` uses window resize + ResizeObserver on document (scrollbar appearance), `scroll: false`.
+
+**Documentation:** [`modules/scrollableTable/README.md`](./modules/scrollableTable/README.md)
+
+**Quick Start:**
+```javascript
+APX('table.my-table').scrollableTable({ maxHeight: 300 });
+APX('table.my-table').scrollableTable({ height: '50vh' });
+// dynamic (viewport-based, updates on resize/scrollbar)
+APX('table.my-table').scrollableTable({ bodyHeightDynamic: { get: (t) => window.innerHeight - t.getBoundingClientRect().top - 40, useAs: 'maxHeight' } });
+APX('table.my-table').scrollableTable('refresh');
+```
+
+**Demo page:** `demo/modules/scrollableTable/index.html`
 
 ### `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
@@ -115,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
 
@@ -180,9 +204,10 @@ 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)
 - **`APX.tools`**: Utility functions. See [`modules/tools/README.md`](./modules/tools/README.md)
 - **`APX.isAPXObject(obj)`**: Check if an object is an APX object.
 - **`APX.is_numeric(n)`**: Check if a value is numeric.