ts-util-core 2.0.5 → 2.0.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +11 -9
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -3,7 +3,11 @@
|
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
5
|
<p align="center">
|
|
6
|
-
<strong>One
|
|
6
|
+
<strong>One unified framework. Same guardrails. Whether it's your team or your AI Agents writing the code.</strong>
|
|
7
|
+
</p>
|
|
8
|
+
|
|
9
|
+
<p align="center">
|
|
10
|
+
📖 <a href="https://github.com/MattAtAIEra/TS-Util/blob/main/docs/Readme-translations_zh.md">繁體中文</a> · <a href="https://github.com/MattAtAIEra/TS-Util/blob/main/docs/Readme-translations_jp.md">日本語</a> · <a href="https://github.com/MattAtAIEra/TS-Util/blob/main/docs/Readme-translations_ko.md">한국어</a> · <a href="https://github.com/MattAtAIEra/TS-Util/blob/main/docs/Readme-translations_es.md">Español</a> · <a href="https://github.com/MattAtAIEra/TS-Util/blob/main/docs/Readme-translations_de.md">Deutsch</a>
|
|
7
11
|
</p>
|
|
8
12
|
|
|
9
13
|
<p align="center">
|
|
@@ -39,7 +43,7 @@ Code review catches some of it. **Architecture catches all of it.**
|
|
|
39
43
|
|
|
40
44
|
## 2. How It Works
|
|
41
45
|
|
|
42
|
-
TS-Util wraps AJAX, VIEW, validation, formatting, and messaging into **a single enforced
|
|
46
|
+
TS-Util wraps AJAX, VIEW, validation, formatting, and messaging into **a single enforced framework**. When anyone — human or AI — calls `AJAX.request()`, the following happens automatically:
|
|
43
47
|
|
|
44
48
|
```
|
|
45
49
|
AJAX.request({ url, form })
|
|
@@ -61,7 +65,7 @@ await AJAX.request({
|
|
|
61
65
|
});
|
|
62
66
|
|
|
63
67
|
// Everything else — validation, loading state, error events,
|
|
64
|
-
// data serialization — is handled by the
|
|
68
|
+
// data serialization — is handled by the framework.
|
|
65
69
|
```
|
|
66
70
|
|
|
67
71
|
The same principle applies to `VIEW.load()` — every dynamically loaded HTML fragment automatically goes through constraint binding, input formatting, and custom hook execution. No manual initialization. No "forgetting" to set up validation on new content.
|
|
@@ -86,7 +90,7 @@ await VIEW.load(container, { url: '/api/partial-view' });
|
|
|
86
90
|
| Code review debates on style | Architecture enforces the style |
|
|
87
91
|
|
|
88
92
|
- **Eliminates divergence**: Engineers learn one API — no debates over implementation details.
|
|
89
|
-
- **Enforces consistency**: Every request passes through the same
|
|
93
|
+
- **Enforces consistency**: Every request passes through the same framework, ensuring loading overlays aren't missed and validation isn't skipped.
|
|
90
94
|
- **Reduces onboarding cost**: A new team member reads one `AJAX.request()` example and is ready to go, instead of deciphering ten scattered patterns.
|
|
91
95
|
|
|
92
96
|
### For AI Agents
|
|
@@ -95,14 +99,14 @@ await VIEW.load(container, { url: '/api/partial-view' });
|
|
|
95
99
|
|--------|-------|
|
|
96
100
|
| Agent expands 15 lines of fetch + validation + error handling | Agent emits 1 line: `AJAX.request({ url, form })` |
|
|
97
101
|
| Context window burned on boilerplate | Tokens preserved for business logic |
|
|
98
|
-
| Different Agents produce different patterns | All Agents produce identical
|
|
99
|
-
| Must audit every Agent's output for missing steps |
|
|
102
|
+
| Different Agents produce different patterns | All Agents produce identical framework calls |
|
|
103
|
+
| Must audit every Agent's output for missing steps | Framework guarantees completeness — **guardrail by design** |
|
|
100
104
|
| Agent "forgets" loading overlay | Impossible — architecture enforces it |
|
|
101
105
|
|
|
102
106
|
When multiple AI Agents co-produce code, this abstraction layer becomes even more critical:
|
|
103
107
|
|
|
104
108
|
- **Token efficiency**: An Agent only needs to emit `AJAX.request({ url, form })` — one line — instead of expanding the full `fetch` + validation + error handling + loading logic every time. Context window is AI's most precious resource; saving tokens means preserving quality.
|
|
105
|
-
- **Predictable behavior**: Code generated by different Agents flows through the same
|
|
109
|
+
- **Predictable behavior**: Code generated by different Agents flows through the same framework, guaranteeing consistent results. You don't need to audit whether each Agent correctly implemented the loading overlay.
|
|
106
110
|
- **Guardrail effect**: The abstraction layer itself acts as a guardrail. An Agent cannot "forget" to validate a form because `AJAX.request()` does it automatically. Discipline is enforced by architecture, not memory.
|
|
107
111
|
|
|
108
112
|
### The Core Insight
|
|
@@ -111,8 +115,6 @@ When multiple AI Agents co-produce code, this abstraction layer becomes even mor
|
|
|
111
115
|
>
|
|
112
116
|
> That's what TS-Util does — for your team today, and for the AI Agents that will write most of your code tomorrow.
|
|
113
117
|
|
|
114
|
-
📖 Read this in other languages: [繁體中文](https://github.com/MattAtAIEra/TS-Util/blob/main/docs/Readme-translations_zh.md) · [日本語](https://github.com/MattAtAIEra/TS-Util/blob/main/docs/Readme-translations_jp.md) · [한국어](https://github.com/MattAtAIEra/TS-Util/blob/main/docs/Readme-translations_ko.md) · [Español](https://github.com/MattAtAIEra/TS-Util/blob/main/docs/Readme-translations_es.md) · [Deutsch](https://github.com/MattAtAIEra/TS-Util/blob/main/docs/Readme-translations_de.md)
|
|
115
|
-
|
|
116
118
|
---
|
|
117
119
|
|
|
118
120
|
## Quick Start
|