- name
- tidyfactor-htmx
- description
- Server-Driven Hypermedia Interactivity engine with Contextual Decision Layer (CDL). Features locally vendored HTMX layered over server-rendered fragments (pairs with PHP, Node, Python). Trigger on commands 'brief', 'init', 'fragments', 'swap', 'triggers', 'forms', 'indicators', 'history', 'assets', 'i18n', or requests to add hypermedia interactions without SPAs.
# TidyFactor HTMX (Server-Driven Hypermedia Interactivity)
A command dispatcher for hypermedia-driven interfaces. This router declares commands and workflows without performing execution directly.
## Commands
| User intent | Command | What it loads |
|---|---|---|
| Strategic Hypermedia Discovery & Brief Resolution | `references/commands/brief.md` | `references/workflows/brief.md` + `references/memory/decision-points.md` + `references/memory/quality-bar.md` |
| Primary deliverable — setup vendored HTMX layer | `references/commands/init.md` | `references/workflows/init.md` + `references/memory/architecture.md` |
| Server-rendered HTML partials & fragment routes | `references/commands/fragments.md` | `references/workflows/fragments.md` + `references/memory/architecture.md` |
| DOM swap strategies (innerHTML, outerHTML, morphdom) | `references/commands/swap.md` | `references/workflows/swap.md` + `references/memory/decision-points.md` |
| Event triggers, polling intervals, SSE, debouncing | `references/commands/triggers.md` | `references/commands/triggers.md` + `references/memory/quality-bar.md` |
| Forms, inline validation errors, CSRF protection | `references/commands/forms.md` | `references/workflows/forms.md` + `references/memory/quality-bar.md` |
| Loading spinners, skeleton shimmers, button disabling | `references/commands/indicators.md` | `references/commands/indicators.md` + `references/memory/quality-bar.md` |
| Browser back-button & URL history synchronization | `references/commands/history.md` | `references/commands/history.md` + `references/memory/decision-points.md` |
| Local vendoring of htmx.min.js & extension scripts | `references/commands/assets.md` | `references/commands/assets.md` + `references/memory/architecture.md` |
| Companion JavaScript hooked to htmx lifecycle events | `references/commands/modules.md` | `references/commands/modules.md` + `references/memory/architecture.md` |
| Fragment translation & dynamic Arabic RTL rendering | `references/commands/i18n.md` | `references/commands/i18n.md` + `references/memory/quality-bar.md` |
Read only the command file that matches the request. Do not load all commands simultaneously.
## Non-Negotiable Invariants
1. **Contextual Decision Layer (CDL)**: Resolve hypermedia baselines via `/brief` or `.tidyfactor/htmx-brief.md` before emitting code.
2. **Zero Third-Party CDN Dependency**: HTMX and all extensions MUST be vendored locally at `js/vendor/htmx.min.js`.
3. **Fragment HTML Only**: Endpoints respond with clean HTML fragments, not JSON and not full `<html>` documents.
4. **CSRF On All Mutations**: Every `hx-post`, `hx-put`, `hx-delete` request MUST include CSRF tokens.
5. **7-Axis Pre-Emit Critique**: All generated components must be evaluated with `/* Pre-emit critique: P5 H5 E5 S5 R5 V5 D5 */`.
Voir sur GitHub