@vielzeug/forge 2.3.1 → 3.1.0
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 +17 -16
- package/dist/_field.cjs +1 -1
- package/dist/_field.cjs.map +1 -1
- package/dist/_field.d.ts +13 -10
- package/dist/_field.d.ts.map +1 -1
- package/dist/_field.js +33 -33
- package/dist/_field.js.map +1 -1
- package/dist/_notify.cjs +1 -1
- package/dist/_notify.cjs.map +1 -1
- package/dist/_notify.d.ts +6 -5
- package/dist/_notify.d.ts.map +1 -1
- package/dist/_notify.js +22 -8
- package/dist/_notify.js.map +1 -1
- package/dist/core/path.cjs +1 -1
- package/dist/core/path.cjs.map +1 -1
- package/dist/core/path.d.ts +23 -12
- package/dist/core/path.d.ts.map +1 -1
- package/dist/core/path.js +172 -114
- package/dist/core/path.js.map +1 -1
- package/dist/dom.cjs +1 -1
- package/dist/dom.cjs.map +1 -1
- package/dist/dom.d.ts +5 -6
- package/dist/dom.d.ts.map +1 -1
- package/dist/dom.js +7 -7
- package/dist/dom.js.map +1 -1
- package/dist/errors.cjs +1 -1
- package/dist/errors.cjs.map +1 -1
- package/dist/errors.d.ts +6 -1
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +10 -2
- package/dist/errors.js.map +1 -1
- package/dist/forge.cjs +1 -1
- package/dist/forge.cjs.map +1 -1
- package/dist/forge.iife.js +1 -1
- package/dist/forge.iife.js.map +1 -1
- package/dist/forge.js +1 -1
- package/dist/forge.js.map +1 -1
- package/dist/form-data.cjs +1 -1
- package/dist/form-data.cjs.map +1 -1
- package/dist/form-data.d.ts +2 -2
- package/dist/form-data.d.ts.map +1 -1
- package/dist/form-data.js +23 -16
- package/dist/form-data.js.map +1 -1
- package/dist/form.cjs +1 -1
- package/dist/form.cjs.map +1 -1
- package/dist/form.d.ts +1 -1
- package/dist/form.d.ts.map +1 -1
- package/dist/form.js +136 -86
- package/dist/form.js.map +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.d.ts +4 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/persist.cjs +2 -0
- package/dist/persist.cjs.map +1 -0
- package/dist/persist.d.ts +18 -0
- package/dist/persist.d.ts.map +1 -0
- package/dist/persist.js +19 -0
- package/dist/persist.js.map +1 -0
- package/dist/plain.cjs +2 -0
- package/dist/plain.cjs.map +1 -0
- package/dist/plain.d.ts +21 -0
- package/dist/plain.d.ts.map +1 -0
- package/dist/plain.js +9 -0
- package/dist/plain.js.map +1 -0
- package/dist/schema.cjs +2 -0
- package/dist/schema.cjs.map +1 -0
- package/dist/schema.d.ts +22 -0
- package/dist/schema.d.ts.map +1 -0
- package/dist/schema.js +26 -0
- package/dist/schema.js.map +1 -0
- package/dist/types.d.ts +28 -20
- package/dist/types.d.ts.map +1 -1
- package/package.json +26 -34
- package/dist/spell.cjs +0 -2
- package/dist/spell.cjs.map +0 -1
- package/dist/spell.d.ts +0 -5
- package/dist/spell.d.ts.map +0 -1
- package/dist/spell.js +0 -48
- package/dist/spell.js.map +0 -1
- package/dist/vault.cjs +0 -2
- package/dist/vault.cjs.map +0 -1
- package/dist/vault.d.ts +0 -10
- package/dist/vault.d.ts.map +0 -1
- package/dist/vault.js +0 -14
- package/dist/vault.js.map +0 -1
package/dist/core/path.js
CHANGED
|
@@ -1,162 +1,220 @@
|
|
|
1
1
|
import { ForgeConfigError as e } from "../errors.js";
|
|
2
|
+
import { isPlainObject as t } from "@vielzeug/arsenal";
|
|
2
3
|
//#region src/core/path.ts
|
|
3
|
-
var
|
|
4
|
+
var n = /* @__PURE__ */ new Set([
|
|
4
5
|
"__proto__",
|
|
5
6
|
"constructor",
|
|
6
7
|
"prototype"
|
|
7
8
|
]);
|
|
8
|
-
function n(e) {
|
|
9
|
-
return !e || t.has(e);
|
|
10
|
-
}
|
|
11
9
|
function r(e) {
|
|
12
|
-
|
|
13
|
-
let t = Object.getPrototypeOf(e);
|
|
14
|
-
return t === Object.prototype || t === null;
|
|
10
|
+
return !e || n.has(e);
|
|
15
11
|
}
|
|
16
12
|
function i(t) {
|
|
17
|
-
if (
|
|
18
|
-
}
|
|
19
|
-
function a(
|
|
20
|
-
|
|
21
|
-
}
|
|
22
|
-
function o(
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
return
|
|
27
|
-
}
|
|
28
|
-
function
|
|
29
|
-
let
|
|
30
|
-
for (let
|
|
31
|
-
|
|
32
|
-
|
|
13
|
+
if (r(t)) throw new e(`Invalid field key '${t}'.`);
|
|
14
|
+
}
|
|
15
|
+
function a(t) {
|
|
16
|
+
if (!Number.isSafeInteger(t) || t < 0) throw new e(`Invalid array index ${t}.`);
|
|
17
|
+
}
|
|
18
|
+
function o(e) {
|
|
19
|
+
return Object.prototype.toString.call(e);
|
|
20
|
+
}
|
|
21
|
+
function s(e) {
|
|
22
|
+
return o(e) === "[object Blob]" || o(e) === "[object File]";
|
|
23
|
+
}
|
|
24
|
+
function c(e) {
|
|
25
|
+
let t = "";
|
|
26
|
+
for (let n of e) t += typeof n == "number" ? `[${n}]` : t ? `.${n}` : n;
|
|
27
|
+
return t;
|
|
28
|
+
}
|
|
29
|
+
function l(e) {
|
|
30
|
+
return e.length > 0 ? ` at '${c(e)}'` : "";
|
|
31
|
+
}
|
|
32
|
+
function u(t) {
|
|
33
|
+
throw new e(`Form values must contain only finite JSON primitives, plain objects, arrays, Date, File, or Blob${l(t)}.`);
|
|
34
|
+
}
|
|
35
|
+
function d(n, r = /* @__PURE__ */ new Set(), a = []) {
|
|
36
|
+
if (n == null || typeof n == "string" || typeof n == "boolean") return n;
|
|
37
|
+
if (typeof n == "number") return Number.isFinite(n) ? n : u(a);
|
|
38
|
+
if (typeof n != "object") return u(a);
|
|
39
|
+
let c = n;
|
|
40
|
+
if (o(n) === "[object Date]" && typeof c.getTime == "function") {
|
|
41
|
+
let e = c.getTime();
|
|
42
|
+
return Number.isFinite(e) ? Object.freeze(new Date(e)) : u(a);
|
|
43
|
+
}
|
|
44
|
+
if (s(n)) return n;
|
|
45
|
+
if (r.has(n)) throw new e(`Form values must not contain circular references${l(a)}.`);
|
|
46
|
+
r.add(n);
|
|
47
|
+
try {
|
|
48
|
+
if (Array.isArray(n)) {
|
|
49
|
+
let t = [];
|
|
50
|
+
for (let i = 0; i < n.length; i++) {
|
|
51
|
+
a.push(i);
|
|
52
|
+
try {
|
|
53
|
+
if (!Object.hasOwn(n, i)) throw new e(`Form arrays must not contain empty slots${l(a)}.`);
|
|
54
|
+
t.push(d(n[i], r, a));
|
|
55
|
+
} finally {
|
|
56
|
+
a.pop();
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
return Object.freeze(t);
|
|
60
|
+
}
|
|
61
|
+
if (!t(n)) return u(a);
|
|
62
|
+
let o = Object.entries(n).map(([e, t]) => {
|
|
63
|
+
i(e), a.push(e);
|
|
64
|
+
try {
|
|
65
|
+
return [e, d(t, r, a)];
|
|
66
|
+
} finally {
|
|
67
|
+
a.pop();
|
|
68
|
+
}
|
|
69
|
+
});
|
|
70
|
+
return Object.freeze(Object.fromEntries(o));
|
|
71
|
+
} finally {
|
|
72
|
+
r.delete(n);
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
function f(e, t = /* @__PURE__ */ new WeakSet()) {
|
|
76
|
+
if (e == null || typeof e == "string" || typeof e == "boolean") return e;
|
|
77
|
+
if (typeof e == "number") return Number.isFinite(e) ? e : void 0;
|
|
78
|
+
if (typeof e != "object") return;
|
|
79
|
+
let n = e, i = e;
|
|
80
|
+
if (o(n) === "[object Date]" && typeof i.getTime == "function") {
|
|
81
|
+
let e = i.getTime();
|
|
82
|
+
return Number.isFinite(e) ? new Date(e) : void 0;
|
|
83
|
+
}
|
|
84
|
+
if (s(n)) return e;
|
|
85
|
+
if (!t.has(n)) {
|
|
86
|
+
t.add(n);
|
|
87
|
+
try {
|
|
88
|
+
if (Array.isArray(e)) {
|
|
89
|
+
let n = [];
|
|
90
|
+
for (let r = 0; r < e.length; r++) Object.hasOwn(e, r) && n.push(f(e[r], t));
|
|
91
|
+
return n;
|
|
92
|
+
}
|
|
93
|
+
let i = {};
|
|
94
|
+
for (let [e, a] of Object.entries(n)) r(e) || (i[e] = f(a, t));
|
|
95
|
+
return i;
|
|
96
|
+
} finally {
|
|
97
|
+
t.delete(n);
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
function p(e, n) {
|
|
102
|
+
let r = e;
|
|
103
|
+
for (let e of n) if (typeof e == "number") {
|
|
104
|
+
if (!Array.isArray(r) || !Number.isSafeInteger(e) || e < 0 || e >= r.length || !Object.hasOwn(r, e)) return;
|
|
105
|
+
r = r[e];
|
|
33
106
|
} else {
|
|
34
|
-
if (!r
|
|
35
|
-
|
|
107
|
+
if (!t(r) || !Object.hasOwn(r, e)) return;
|
|
108
|
+
r = r[e];
|
|
36
109
|
}
|
|
37
|
-
return
|
|
110
|
+
return r;
|
|
38
111
|
}
|
|
39
|
-
function
|
|
40
|
-
let
|
|
41
|
-
for (let e of
|
|
42
|
-
if (!Array.isArray(
|
|
43
|
-
|
|
112
|
+
function m(e, n) {
|
|
113
|
+
let r = e;
|
|
114
|
+
for (let e of n) if (typeof e == "number") {
|
|
115
|
+
if (!Array.isArray(r) || !Number.isSafeInteger(e) || e < 0 || e >= r.length || !Object.hasOwn(r, e)) return !1;
|
|
116
|
+
r = r[e];
|
|
44
117
|
} else {
|
|
45
|
-
if (!r
|
|
46
|
-
|
|
118
|
+
if (!t(r) || !Object.hasOwn(r, e)) return !1;
|
|
119
|
+
r = r[e];
|
|
47
120
|
}
|
|
48
121
|
return !0;
|
|
49
122
|
}
|
|
50
|
-
function
|
|
51
|
-
let [
|
|
52
|
-
if (typeof
|
|
53
|
-
if (!Array.isArray(
|
|
54
|
-
if (
|
|
55
|
-
if (
|
|
56
|
-
let e = [...
|
|
57
|
-
return e[
|
|
123
|
+
function h(n, r, o, s = []) {
|
|
124
|
+
let [c, ...l] = r;
|
|
125
|
+
if (typeof c == "number") {
|
|
126
|
+
if (a(c), !Array.isArray(n)) throw new e(`Cannot index ${c} because the current value is not an array.`);
|
|
127
|
+
if (c < 0 || c >= n.length) throw new e(`Index ${c} is out of range for array of length ${n.length}.`);
|
|
128
|
+
if (l.length === 0) {
|
|
129
|
+
let e = [...n];
|
|
130
|
+
return e[c] = d(o, /* @__PURE__ */ new Set(), [...s, c]), Object.freeze(e);
|
|
58
131
|
}
|
|
59
|
-
let
|
|
60
|
-
return
|
|
132
|
+
let t = [...n];
|
|
133
|
+
return t[c] = h(n[c], l, o, [...s, c]), Object.freeze(t);
|
|
61
134
|
}
|
|
62
|
-
if (i(
|
|
63
|
-
if (
|
|
64
|
-
...
|
|
65
|
-
[
|
|
135
|
+
if (i(c), !t(n)) throw new e(`Cannot select '${c}' because the current value is not an object.`);
|
|
136
|
+
if (l.length === 0) return Object.freeze({
|
|
137
|
+
...n,
|
|
138
|
+
[c]: d(o, /* @__PURE__ */ new Set(), [...s, c])
|
|
66
139
|
});
|
|
67
|
-
let u =
|
|
68
|
-
if (u !== void 0 && !
|
|
69
|
-
let
|
|
140
|
+
let u = n[c];
|
|
141
|
+
if (u !== void 0 && !t(u) && !Array.isArray(u)) throw new e(`Cannot select '${c}' because it is not an object or array.`);
|
|
142
|
+
let f = u ?? {};
|
|
70
143
|
return Object.freeze({
|
|
71
|
-
...
|
|
72
|
-
[
|
|
144
|
+
...n,
|
|
145
|
+
[c]: h(f, l, o, [...s, c])
|
|
73
146
|
});
|
|
74
147
|
}
|
|
75
|
-
function
|
|
76
|
-
let [i, ...
|
|
148
|
+
function g(e, n, r) {
|
|
149
|
+
let [i, ...o] = r;
|
|
77
150
|
if (typeof i == "number") {
|
|
78
|
-
if (!Array.isArray(e) || !Array.isArray(
|
|
79
|
-
if (
|
|
80
|
-
let
|
|
81
|
-
return
|
|
151
|
+
if (a(i), !Array.isArray(e) || !Array.isArray(n) || i >= n.length || i >= e.length) return e;
|
|
152
|
+
if (o.length === 0) {
|
|
153
|
+
let t = [...e];
|
|
154
|
+
return t[i] = n[i], Object.freeze(t);
|
|
82
155
|
}
|
|
83
|
-
let
|
|
84
|
-
return
|
|
156
|
+
let t = [...e];
|
|
157
|
+
return t[i] = g(e[i], n[i], o), Object.freeze(t);
|
|
85
158
|
}
|
|
86
|
-
if (!
|
|
87
|
-
if (
|
|
88
|
-
if (Object.hasOwn(
|
|
159
|
+
if (!t(e)) return e;
|
|
160
|
+
if (o.length === 0) {
|
|
161
|
+
if (Object.hasOwn(n, i)) return Object.freeze({
|
|
89
162
|
...e,
|
|
90
|
-
[i]:
|
|
163
|
+
[i]: n[i]
|
|
91
164
|
});
|
|
92
|
-
let { [i]:
|
|
165
|
+
let { [i]: t, ...r } = e;
|
|
93
166
|
return Object.freeze(r);
|
|
94
167
|
}
|
|
95
|
-
let
|
|
96
|
-
if (!
|
|
97
|
-
if (Object.hasOwn(
|
|
168
|
+
let s = n[i];
|
|
169
|
+
if (!t(s) && !Array.isArray(s)) {
|
|
170
|
+
if (Object.hasOwn(n, i)) return Object.freeze({
|
|
98
171
|
...e,
|
|
99
|
-
[i]:
|
|
172
|
+
[i]: s
|
|
100
173
|
});
|
|
101
|
-
let { [i]:
|
|
174
|
+
let { [i]: t, ...r } = e;
|
|
102
175
|
return Object.freeze(r);
|
|
103
176
|
}
|
|
104
|
-
let
|
|
177
|
+
let c = e[i], l = t(c) || Array.isArray(c) ? c : {};
|
|
105
178
|
return Object.freeze({
|
|
106
179
|
...e,
|
|
107
|
-
[i]:
|
|
180
|
+
[i]: g(l, s, o)
|
|
108
181
|
});
|
|
109
182
|
}
|
|
110
|
-
function
|
|
111
|
-
let [i, ...
|
|
112
|
-
|
|
183
|
+
function _(e, n, r) {
|
|
184
|
+
let [i, ...o] = n;
|
|
185
|
+
typeof i == "number" && a(i);
|
|
186
|
+
let s = String(i), c = { ...e };
|
|
187
|
+
if (o.length === 0) r ? c[s] = !0 : delete c[s];
|
|
113
188
|
else {
|
|
114
|
-
let
|
|
115
|
-
Object.keys(
|
|
189
|
+
let n = _(t(e[s]) ? e[s] : {}, o, r);
|
|
190
|
+
Object.keys(n).length === 0 ? delete c[s] : c[s] = n;
|
|
116
191
|
}
|
|
117
|
-
return Object.freeze(
|
|
118
|
-
}
|
|
119
|
-
function
|
|
120
|
-
let
|
|
121
|
-
for (let e of
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
n
|
|
192
|
+
return Object.freeze(c);
|
|
193
|
+
}
|
|
194
|
+
function v(e, n) {
|
|
195
|
+
let r = e;
|
|
196
|
+
for (let e of n) {
|
|
197
|
+
if (typeof e == "number" && (!Number.isSafeInteger(e) || e < 0)) return !1;
|
|
198
|
+
let n = String(e);
|
|
199
|
+
if (!t(r) || !Object.hasOwn(r, n)) return !1;
|
|
200
|
+
r = r[n];
|
|
125
201
|
}
|
|
126
|
-
return
|
|
202
|
+
return r === !0;
|
|
127
203
|
}
|
|
128
|
-
function
|
|
129
|
-
return Array.isArray(e) ? Object.freeze(Object.fromEntries(e.map((e,
|
|
204
|
+
function y(e) {
|
|
205
|
+
return Array.isArray(e) ? Object.freeze(Object.fromEntries(e.map((e, n) => [String(n), t(e) || Array.isArray(e) ? y(e) : !0]))) : t(e) ? Object.freeze(Object.fromEntries(Object.entries(e).map(([e, n]) => [e, t(n) || Array.isArray(n) ? y(n) : !0]))) : {};
|
|
130
206
|
}
|
|
131
|
-
function
|
|
132
|
-
|
|
133
|
-
|
|
207
|
+
function b(e, t) {
|
|
208
|
+
if (e.length !== t.length) return !1;
|
|
209
|
+
for (let n = 0; n < e.length; n++) if (e[n] !== t[n]) return !1;
|
|
210
|
+
return !0;
|
|
134
211
|
}
|
|
135
|
-
function
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
let t = Array.isArray(e) ? [...e] : [];
|
|
139
|
-
return o.length === 0 ? t[a] === void 0 && (t[a] = i) : t[a] = h(t[a], o, i), t;
|
|
140
|
-
}
|
|
141
|
-
if (n(a)) return e ?? {};
|
|
142
|
-
let s = r(e) ? { ...e } : {};
|
|
143
|
-
return o.length === 0 ? s[a] === void 0 && (s[a] = i) : s[a] = h(s[a], o, i), s;
|
|
144
|
-
}
|
|
145
|
-
function g(e, t, n) {
|
|
146
|
-
let i = h(e, t, n);
|
|
147
|
-
return r(i) ? i : e;
|
|
148
|
-
}
|
|
149
|
-
function _(e) {
|
|
150
|
-
if (typeof e == "string") return e;
|
|
151
|
-
if (Array.isArray(e)) {
|
|
152
|
-
let t = e.map((e) => _(e));
|
|
153
|
-
return t.every((e) => e === void 0) ? void 0 : Object.freeze(t);
|
|
212
|
+
function x(e, t) {
|
|
213
|
+
if (e) {
|
|
214
|
+
for (let n of e) if (b(n.path, t)) return n.message;
|
|
154
215
|
}
|
|
155
|
-
if (!r(e)) return;
|
|
156
|
-
let t = Object.entries(e).map(([e, t]) => [e, _(t)]).filter(([, e]) => e !== void 0);
|
|
157
|
-
return t.length === 0 ? void 0 : Object.freeze(Object.fromEntries(t));
|
|
158
216
|
}
|
|
159
217
|
//#endregion
|
|
160
|
-
export { i as assertSafeKey, c as hasAtPath,
|
|
218
|
+
export { a as assertArrayIndex, i as assertSafeKey, x as findIssue, c as formatValuePath, m as hasAtPath, d as immutable, t as isRecord, r as isUnsafeKey, b as pathEquals, p as readAtPath, v as readMeta, g as resetAtPath, f as toPlainValues, y as touchAll, h as writeAtPath, _ as writeMeta };
|
|
161
219
|
|
|
162
220
|
//# sourceMappingURL=path.js.map
|
package/dist/core/path.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"path.js","names":[],"sources":["../../src/core/path.ts"],"sourcesContent":["import { ForgeConfigError } from '../errors';\n\nconst unsafeKeys = new Set(['__proto__', 'constructor', 'prototype']);\n\nexport function isUnsafeKey(key: string): boolean {\n return !key || unsafeKeys.has(key);\n}\n\ntype ErrorNode = string | ErrorTree | ErrorArray;\nexport interface ErrorTree {\n readonly [key: string]: ErrorNode;\n}\ntype ErrorArray = ErrorNode[];\ntype MutableErrorTree = Record<string, ErrorNode>;\ntype RecordValue = Record<string, unknown>;\ntype TreeValue = RecordValue | readonly unknown[];\ntype MetaTree = true | MetaNode;\ninterface MetaNode {\n readonly [key: string]: MetaTree;\n}\nexport type MetaRoot = MetaNode;\n\nexport function isRecord(value: unknown): value is RecordValue {\n if (value === null || typeof value !== 'object' || Array.isArray(value)) return false;\n\n const prototype = Object.getPrototypeOf(value);\n\n return prototype === Object.prototype || prototype === null;\n}\n\nexport function assertSafeKey(key: string): void {\n if (isUnsafeKey(key)) throw new ForgeConfigError(`Invalid field key '${key}'.`);\n}\n\nfunction isAtomicLeaf(value: unknown): boolean {\n return (\n (typeof Blob !== 'undefined' && value instanceof Blob) ||\n (typeof File !== 'undefined' && value instanceof File) ||\n value instanceof Date\n );\n}\n\nexport function immutable<T>(value: T): T {\n if (Array.isArray(value)) return Object.freeze(value.map(immutable)) as T;\n\n if (value === null || typeof value !== 'object' || isAtomicLeaf(value)) return value;\n\n if (!isRecord(value)) {\n throw new ForgeConfigError(\n 'Form values must contain only plain objects, arrays, Date, File, Blob, or primitive values.',\n );\n }\n\n return Object.freeze(Object.fromEntries(Object.entries(value).map(([key, child]) => [key, immutable(child)]))) as T;\n}\n\nexport function readAtPath<T>(value: unknown, path: readonly (string | number)[]): T | undefined {\n let current: unknown = value;\n\n for (const key of path) {\n if (typeof key === 'number') {\n if (!Array.isArray(current) || key < 0 || key >= current.length) return undefined;\n\n current = current[key];\n } else {\n if (!isRecord(current) || !Object.hasOwn(current, key)) return undefined;\n\n current = current[key];\n }\n }\n\n return current as T | undefined;\n}\n\nexport function hasAtPath(value: unknown, path: readonly (string | number)[]): boolean {\n let current: unknown = value;\n\n for (const key of path) {\n if (typeof key === 'number') {\n if (!Array.isArray(current) || key < 0 || key >= current.length) return false;\n\n current = current[key];\n } else {\n if (!isRecord(current) || !Object.hasOwn(current, key)) return false;\n\n current = current[key];\n }\n }\n\n return true;\n}\n\nexport function writeAtPath<T extends TreeValue>(value: T, path: readonly (string | number)[], next: unknown): T {\n const [key, ...rest] = path;\n\n if (typeof key === 'number') {\n if (!Array.isArray(value)) {\n throw new ForgeConfigError(`Cannot index ${key} because the current value is not an array.`);\n }\n\n if (key < 0 || key >= value.length) {\n throw new ForgeConfigError(`Index ${key} is out of range for array of length ${value.length}.`);\n }\n\n if (rest.length === 0) {\n const copy = [...value];\n\n copy[key] = immutable(next);\n\n return Object.freeze(copy) as T;\n }\n\n const copy = [...value];\n\n copy[key] = writeAtPath(value[key] as TreeValue, rest, next);\n\n return Object.freeze(copy) as T;\n }\n\n assertSafeKey(key);\n\n if (!isRecord(value)) {\n throw new ForgeConfigError(`Cannot select '${key}' because the current value is not an object.`);\n }\n\n if (rest.length === 0) return Object.freeze({ ...value, [key]: immutable(next) }) as T;\n\n const child = value[key];\n\n if (child !== undefined && !isRecord(child) && !Array.isArray(child)) {\n throw new ForgeConfigError(`Cannot select '${key}' because it is not an object or array.`);\n }\n\n const childTree = (child ?? {}) as TreeValue;\n\n return Object.freeze({ ...value, [key]: writeAtPath(childTree, rest, next) }) as T;\n}\n\nexport function resetAtPath<T extends TreeValue>(value: T, baseline: T, path: readonly (string | number)[]): T {\n const [key, ...rest] = path;\n\n if (typeof key === 'number') {\n if (!Array.isArray(value)) return value;\n if (!Array.isArray(baseline) || key >= baseline.length || key >= value.length) return value;\n\n if (rest.length === 0) {\n const copy = [...value];\n\n copy[key] = baseline[key];\n\n return Object.freeze(copy) as T;\n }\n\n const copy = [...value];\n\n copy[key] = resetAtPath(value[key] as TreeValue, baseline[key] as TreeValue, rest);\n\n return Object.freeze(copy) as T;\n }\n\n if (!isRecord(value)) return value;\n\n if (rest.length === 0) {\n if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: (baseline as RecordValue)[key] }) as T;\n\n const { [key]: _removed, ...next } = value;\n\n return Object.freeze(next) as T;\n }\n\n const baselineChild = (baseline as RecordValue)[key];\n\n if (!isRecord(baselineChild) && !Array.isArray(baselineChild)) {\n if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: baselineChild }) as T;\n\n const { [key]: _removed, ...next } = value;\n\n return Object.freeze(next) as T;\n }\n\n const currentChild = value[key];\n const childTree = (isRecord(currentChild) || Array.isArray(currentChild) ? currentChild : {}) as TreeValue;\n\n return Object.freeze({ ...value, [key]: resetAtPath(childTree, baselineChild as TreeValue, rest) }) as T;\n}\n\nexport function writeMeta(meta: MetaRoot, path: readonly (string | number)[], next: boolean): MetaRoot {\n const [key, ...rest] = path;\n const stringKey = String(key);\n const copy: Record<string, MetaTree> = { ...meta };\n\n if (rest.length === 0) {\n if (next) copy[stringKey] = true;\n else delete copy[stringKey];\n } else {\n const child = isRecord(meta[stringKey]) ? (meta[stringKey] as MetaRoot) : {};\n const updated = writeMeta(child, rest, next);\n\n if (Object.keys(updated).length === 0) delete copy[stringKey];\n else copy[stringKey] = updated;\n }\n\n return Object.freeze(copy);\n}\n\nexport function readMeta(meta: MetaRoot, path: readonly (string | number)[]): boolean {\n let current: MetaTree | undefined = meta;\n\n for (const key of path) {\n const stringKey = String(key);\n\n if (!isRecord(current) || !Object.hasOwn(current, stringKey)) return false;\n\n current = current[stringKey] as MetaTree;\n }\n\n return current === true;\n}\n\nexport function touchAll(value: unknown): MetaRoot {\n if (Array.isArray(value)) {\n return Object.freeze(\n Object.fromEntries(\n value.map((child, i) => [\n String(i),\n isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n ]),\n ),\n );\n }\n\n if (!isRecord(value)) return {};\n\n return Object.freeze(\n Object.fromEntries(\n Object.entries(value).map(([key, child]) => [\n key,\n isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n ]),\n ),\n );\n}\n\nexport function readError(errors: unknown, path: readonly (string | number)[]): string | undefined {\n const error = readAtPath(errors, path);\n\n return typeof error === 'string' ? error : undefined;\n}\n\nfunction writeErrorNode(\n node: ErrorTree | ErrorArray | undefined,\n path: readonly (string | number)[],\n message: string,\n): ErrorTree | ErrorArray {\n const [key, ...rest] = path;\n\n if (typeof key === 'number') {\n const arr: ErrorNode[] = Array.isArray(node) ? [...node] : [];\n\n if (rest.length === 0) {\n if (arr[key] === undefined) arr[key] = message;\n } else {\n arr[key] = writeErrorNode(arr[key] as ErrorTree | ErrorArray | undefined, rest, message);\n }\n\n return arr;\n }\n\n if (isUnsafeKey(key)) return node ?? {};\n\n const record: MutableErrorTree = isRecord(node) ? { ...node } : {};\n\n if (rest.length === 0) {\n if (record[key] === undefined) record[key] = message;\n } else {\n record[key] = writeErrorNode(record[key] as ErrorTree | ErrorArray | undefined, rest, message);\n }\n\n return record;\n}\n\nexport function writeError(tree: ErrorTree, path: readonly (string | number)[], message: string): ErrorTree {\n const result = writeErrorNode(tree, path, message);\n\n return isRecord(result) ? result : tree;\n}\n\nexport function normalizeErrors<T>(errors: T): T | undefined {\n if (typeof errors === 'string') return errors;\n\n if (Array.isArray(errors)) {\n const normalized = errors.map((item) => normalizeErrors(item));\n\n if (normalized.every((value) => value === undefined)) return undefined;\n\n return Object.freeze(normalized) as T;\n }\n\n if (!isRecord(errors)) return undefined;\n\n const entries = Object.entries(errors)\n .map(([key, value]) => [key, normalizeErrors(value)] as const)\n .filter(([, value]) => value !== undefined);\n\n return entries.length === 0 ? undefined : (Object.freeze(Object.fromEntries(entries)) as T);\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"path.js","names":[],"sources":["../../src/core/path.ts"],"sourcesContent":["import { isPlainObject as isRecord } from '@vielzeug/arsenal';\n\nimport { ForgeConfigError } from '../errors.js';\nimport type { ValidationIssue } from '../types.js';\n\nconst unsafeKeys = new Set(['__proto__', 'constructor', 'prototype']);\n\nexport { isRecord };\n\nexport function isUnsafeKey(key: string): boolean {\n return !key || unsafeKeys.has(key);\n}\n\ntype RecordValue = Record<string, unknown>;\ntype TreeValue = RecordValue | readonly unknown[];\ntype MetaTree = true | MetaNode;\ninterface MetaNode {\n readonly [key: string]: MetaTree;\n}\nexport type MetaRoot = MetaNode;\n\nexport function assertSafeKey(key: string): void {\n if (isUnsafeKey(key)) throw new ForgeConfigError(`Invalid field key '${key}'.`);\n}\n\nexport function assertArrayIndex(index: number): void {\n if (!Number.isSafeInteger(index) || index < 0) throw new ForgeConfigError(`Invalid array index ${index}.`);\n}\n\nfunction tag(value: object): string {\n return Object.prototype.toString.call(value);\n}\n\nfunction isBlobLeaf(value: object): boolean {\n return tag(value) === '[object Blob]' || tag(value) === '[object File]';\n}\n\n/** Formats a value path as `list[0].name` for error messages. */\nexport function formatValuePath(path: readonly (string | number)[]): string {\n let out = '';\n for (const segment of path) {\n if (typeof segment === 'number') out += `[${segment}]`;\n else out += out ? `.${segment}` : segment;\n }\n return out;\n}\n\nfunction pathSuffix(path: readonly (string | number)[]): string {\n return path.length > 0 ? ` at '${formatValuePath(path)}'` : '';\n}\n\nfunction invalidValue(path: readonly (string | number)[]): never {\n throw new ForgeConfigError(\n `Form values must contain only finite JSON primitives, plain objects, arrays, Date, File, or Blob${pathSuffix(path)}.`,\n );\n}\n\nexport function immutable<T>(value: T, ancestors = new Set<object>(), path: (string | number)[] = []): T {\n if (value === null || value === undefined || typeof value === 'string' || typeof value === 'boolean') return value;\n if (typeof value === 'number') return Number.isFinite(value) ? value : invalidValue(path);\n if (typeof value !== 'object') return invalidValue(path);\n\n const date = value as unknown as Date;\n if (tag(value) === '[object Date]' && typeof date.getTime === 'function') {\n const time = date.getTime();\n if (!Number.isFinite(time)) return invalidValue(path);\n return Object.freeze(new Date(time)) as T;\n }\n\n if (isBlobLeaf(value)) return value;\n if (ancestors.has(value))\n throw new ForgeConfigError(`Form values must not contain circular references${pathSuffix(path)}.`);\n\n ancestors.add(value);\n try {\n if (Array.isArray(value)) {\n const copy: unknown[] = [];\n for (let index = 0; index < value.length; index++) {\n path.push(index);\n try {\n if (!Object.hasOwn(value, index))\n throw new ForgeConfigError(`Form arrays must not contain empty slots${pathSuffix(path)}.`);\n copy.push(immutable(value[index], ancestors, path));\n } finally {\n path.pop();\n }\n }\n return Object.freeze(copy) as T;\n }\n\n if (!isRecord(value)) return invalidValue(path);\n const entries = Object.entries(value).map(([key, child]) => {\n assertSafeKey(key);\n path.push(key);\n try {\n return [key, immutable(child, ancestors, path)] as const;\n } finally {\n path.pop();\n }\n });\n return Object.freeze(Object.fromEntries(entries)) as T;\n } finally {\n ancestors.delete(value);\n }\n}\n\n/**\n * Deeply converts a value into the plain shape `immutable()` accepts: primitives pass\n * through, `Date` is cloned, `File`/`Blob` keep identity, arrays map, and class instances\n * flatten to their own enumerable entries. Use as the `normalize` option of `createForm`\n * to hold domain-model classes in form state.\n *\n * Lossy conversions, applied instead of the error `immutable()` would throw: `Map`, `Set`,\n * and other keyless built-ins flatten to `{}` (their entries live on the prototype); sparse\n * array slots are dropped, which shifts later indexes; `NaN`, `Infinity`, functions, and\n * circular branches become `undefined`. Normalize model classes, not arbitrary graphs.\n */\nexport function toPlainValues<T>(value: T, seen = new WeakSet<object>()): T {\n if (value === null || value === undefined || typeof value === 'string' || typeof value === 'boolean') return value;\n if (typeof value === 'number') return Number.isFinite(value) ? value : (undefined as T);\n if (typeof value !== 'object') return undefined as T;\n\n const object = value as unknown as object;\n const date = value as unknown as Date;\n if (tag(object) === '[object Date]' && typeof date.getTime === 'function') {\n const time = date.getTime();\n return (Number.isFinite(time) ? new Date(time) : undefined) as T;\n }\n if (isBlobLeaf(object)) return value;\n if (seen.has(object)) return undefined as T;\n\n seen.add(object);\n try {\n if (Array.isArray(value)) {\n const copy: unknown[] = [];\n for (let index = 0; index < value.length; index++) {\n if (Object.hasOwn(value, index)) copy.push(toPlainValues(value[index], seen));\n }\n return copy as T;\n }\n\n // Plain objects and class instances both flatten to own enumerable entries;\n // unsafe keys are dropped so the result always passes immutable()'s key checks.\n const copy: RecordValue = {};\n for (const [key, child] of Object.entries(object)) {\n if (isUnsafeKey(key)) continue;\n copy[key] = toPlainValues(child, seen);\n }\n return copy as T;\n } finally {\n seen.delete(object);\n }\n}\n\nexport function readAtPath<T>(value: unknown, path: readonly (string | number)[]): T | undefined {\n let current: unknown = value;\n\n for (const key of path) {\n if (typeof key === 'number') {\n if (\n !Array.isArray(current) ||\n !Number.isSafeInteger(key) ||\n key < 0 ||\n key >= current.length ||\n !Object.hasOwn(current, key)\n )\n return undefined;\n\n current = current[key];\n } else {\n if (!isRecord(current) || !Object.hasOwn(current, key)) return undefined;\n\n current = current[key];\n }\n }\n\n return current as T | undefined;\n}\n\nexport function hasAtPath(value: unknown, path: readonly (string | number)[]): boolean {\n let current: unknown = value;\n\n for (const key of path) {\n if (typeof key === 'number') {\n if (\n !Array.isArray(current) ||\n !Number.isSafeInteger(key) ||\n key < 0 ||\n key >= current.length ||\n !Object.hasOwn(current, key)\n )\n return false;\n\n current = current[key];\n } else {\n if (!isRecord(current) || !Object.hasOwn(current, key)) return false;\n\n current = current[key];\n }\n }\n\n return true;\n}\n\nexport function writeAtPath<T extends TreeValue>(\n value: T,\n path: readonly (string | number)[],\n next: unknown,\n fullPath: readonly (string | number)[] = [],\n): T {\n const [key, ...rest] = path;\n\n if (typeof key === 'number') {\n assertArrayIndex(key);\n if (!Array.isArray(value)) {\n throw new ForgeConfigError(`Cannot index ${key} because the current value is not an array.`);\n }\n\n if (key < 0 || key >= value.length) {\n throw new ForgeConfigError(`Index ${key} is out of range for array of length ${value.length}.`);\n }\n\n if (rest.length === 0) {\n const copy = [...value];\n\n copy[key] = immutable(next, new Set<object>(), [...fullPath, key]);\n\n return Object.freeze(copy) as T;\n }\n\n const copy = [...value];\n\n copy[key] = writeAtPath(value[key] as TreeValue, rest, next, [...fullPath, key]);\n\n return Object.freeze(copy) as T;\n }\n\n assertSafeKey(key);\n\n if (!isRecord(value)) {\n throw new ForgeConfigError(`Cannot select '${key}' because the current value is not an object.`);\n }\n\n if (rest.length === 0)\n return Object.freeze({ ...value, [key]: immutable(next, new Set<object>(), [...fullPath, key]) }) as T;\n\n const child = value[key];\n\n if (child !== undefined && !isRecord(child) && !Array.isArray(child)) {\n throw new ForgeConfigError(`Cannot select '${key}' because it is not an object or array.`);\n }\n\n const childTree = (child ?? {}) as TreeValue;\n\n return Object.freeze({ ...value, [key]: writeAtPath(childTree, rest, next, [...fullPath, key]) }) as T;\n}\n\nexport function resetAtPath<T extends TreeValue>(value: T, baseline: T, path: readonly (string | number)[]): T {\n const [key, ...rest] = path;\n\n if (typeof key === 'number') {\n assertArrayIndex(key);\n if (!Array.isArray(value)) return value;\n if (!Array.isArray(baseline) || key >= baseline.length || key >= value.length) return value;\n\n if (rest.length === 0) {\n const copy = [...value];\n\n copy[key] = baseline[key];\n\n return Object.freeze(copy) as T;\n }\n\n const copy = [...value];\n\n copy[key] = resetAtPath(value[key] as TreeValue, baseline[key] as TreeValue, rest);\n\n return Object.freeze(copy) as T;\n }\n\n if (!isRecord(value)) return value;\n\n if (rest.length === 0) {\n if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: (baseline as RecordValue)[key] }) as T;\n\n const { [key]: _removed, ...next } = value;\n\n return Object.freeze(next) as T;\n }\n\n const baselineChild = (baseline as RecordValue)[key];\n\n if (!isRecord(baselineChild) && !Array.isArray(baselineChild)) {\n if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: baselineChild }) as T;\n\n const { [key]: _removed, ...next } = value;\n\n return Object.freeze(next) as T;\n }\n\n const currentChild = value[key];\n const childTree = (isRecord(currentChild) || Array.isArray(currentChild) ? currentChild : {}) as TreeValue;\n\n return Object.freeze({ ...value, [key]: resetAtPath(childTree, baselineChild as TreeValue, rest) }) as T;\n}\n\nexport function writeMeta(meta: MetaRoot, path: readonly (string | number)[], next: boolean): MetaRoot {\n const [key, ...rest] = path;\n if (typeof key === 'number') assertArrayIndex(key);\n const stringKey = String(key);\n const copy: Record<string, MetaTree> = { ...meta };\n\n if (rest.length === 0) {\n if (next) copy[stringKey] = true;\n else delete copy[stringKey];\n } else {\n const child = isRecord(meta[stringKey]) ? (meta[stringKey] as MetaRoot) : {};\n const updated = writeMeta(child, rest, next);\n\n if (Object.keys(updated).length === 0) delete copy[stringKey];\n else copy[stringKey] = updated;\n }\n\n return Object.freeze(copy);\n}\n\nexport function readMeta(meta: MetaRoot, path: readonly (string | number)[]): boolean {\n let current: MetaTree | undefined = meta;\n\n for (const key of path) {\n if (typeof key === 'number' && (!Number.isSafeInteger(key) || key < 0)) return false;\n const stringKey = String(key);\n\n if (!isRecord(current) || !Object.hasOwn(current, stringKey)) return false;\n\n current = current[stringKey] as MetaTree;\n }\n\n return current === true;\n}\n\nexport function touchAll(value: unknown): MetaRoot {\n if (Array.isArray(value)) {\n return Object.freeze(\n Object.fromEntries(\n value.map((child, i) => [\n String(i),\n isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n ]),\n ),\n );\n }\n\n if (!isRecord(value)) return {};\n\n return Object.freeze(\n Object.fromEntries(\n Object.entries(value).map(([key, child]) => [\n key,\n isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n ]),\n ),\n );\n}\n\nexport function pathEquals(a: readonly (string | number)[], b: readonly (string | number)[]): boolean {\n if (a.length !== b.length) return false;\n\n for (let i = 0; i < a.length; i++) {\n if (a[i] !== b[i]) return false;\n }\n\n return true;\n}\n\n/** Derives a single field's error message from the flat issue list. */\nexport function findIssue(\n issues: readonly ValidationIssue[] | undefined,\n path: readonly (string | number)[],\n): string | undefined {\n if (!issues) return undefined;\n\n for (const issue of issues) {\n if (pathEquals(issue.path, path)) return issue.message;\n }\n\n return undefined;\n}\n"],"mappings":"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"}
|
package/dist/dom.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e,t,n){let r=n.event??`input`,i=!1,a=()=>{i=!0;try{t.set(n.read(e))}finally{i=!1}},
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e,t,n){let r=n.event??`input`,i=!1,a=!1,o=t.value,s=()=>{i=!0;try{t.set(n.read(e))}finally{i=!1}},c=()=>t.touch(),l=n.write?t.subscribe(({value:t})=>{if(i){a=!0,o=t;return}a&&Object.is(t,o)||(a=!0,o=t,n.write?.(e,t))},{immediate:!0}):()=>void 0;return e.addEventListener(r,s),e.addEventListener(`blur`,c),()=>{e.removeEventListener(r,s),e.removeEventListener(`blur`,c),l()}}exports.bindField=e;
|
|
2
2
|
//# sourceMappingURL=dom.cjs.map
|
package/dist/dom.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dom.cjs","names":[],"sources":["../src/dom.ts"],"sourcesContent":["import type { Field,
|
|
1
|
+
{"version":3,"file":"dom.cjs","names":[],"sources":["../src/dom.ts"],"sourcesContent":["import type { Field, FieldState } from './types.js';\n\nexport type FieldBindingOptions<Element extends HTMLElement, Value> = Readonly<{\n event?: keyof HTMLElementEventMap;\n read(element: Element): Value;\n write?: (element: Element, value: FieldState<Value>['value']) => void;\n}>;\n\nexport function bindField<Element extends HTMLElement, Value>(\n element: Element,\n field: Field<Value>,\n options: FieldBindingOptions<Element, Value>,\n): () => void {\n const event = options.event ?? 'input';\n let updatingFromElement = false;\n let hasRendered = false;\n let rendered = field.value;\n\n const onInput = (): void => {\n updatingFromElement = true;\n try {\n field.set(options.read(element));\n } finally {\n updatingFromElement = false;\n }\n };\n const onBlur = (): void => field.touch();\n const unsubscribe = options.write\n ? field.subscribe(\n ({ value }) => {\n if (updatingFromElement) {\n hasRendered = true;\n rendered = value;\n return;\n }\n if (hasRendered && Object.is(value, rendered)) return;\n hasRendered = true;\n rendered = value;\n options.write?.(element, value);\n },\n { immediate: true },\n )\n : () => undefined;\n\n element.addEventListener(event, onInput);\n element.addEventListener('blur', onBlur);\n\n return () => {\n element.removeEventListener(event, onInput);\n element.removeEventListener('blur', onBlur);\n unsubscribe();\n };\n}\n"],"mappings":"mEAQA,SAAgB,EACd,EACA,EACA,EACY,CACZ,IAAM,EAAQ,EAAQ,OAAS,QAC3B,EAAsB,GACtB,EAAc,GACd,EAAW,EAAM,MAEf,MAAsB,CAC1B,EAAsB,GACtB,GAAI,CACF,EAAM,IAAI,EAAQ,KAAK,CAAO,CAAC,CACjC,QAAU,CACR,EAAsB,EACxB,CACF,EACM,MAAqB,EAAM,MAAM,EACjC,EAAc,EAAQ,MACxB,EAAM,WACH,CAAE,WAAY,CACb,GAAI,EAAqB,CACvB,EAAc,GACd,EAAW,EACX,MACF,CACI,GAAe,OAAO,GAAG,EAAO,CAAQ,IAC5C,EAAc,GACd,EAAW,EACX,EAAQ,QAAQ,EAAS,CAAK,EAChC,EACA,CAAE,UAAW,EAAK,CACpB,MACM,IAAA,GAKV,OAHA,EAAQ,iBAAiB,EAAO,CAAO,EACvC,EAAQ,iBAAiB,OAAQ,CAAM,MAE1B,CACX,EAAQ,oBAAoB,EAAO,CAAO,EAC1C,EAAQ,oBAAoB,OAAQ,CAAM,EAC1C,EAAY,CACd,CACF"}
|
package/dist/dom.d.ts
CHANGED
|
@@ -1,9 +1,8 @@
|
|
|
1
|
-
import type { Field,
|
|
2
|
-
export type FieldBindingOptions<Element extends HTMLElement,
|
|
1
|
+
import type { Field, FieldState } from './types.js';
|
|
2
|
+
export type FieldBindingOptions<Element extends HTMLElement, Value> = Readonly<{
|
|
3
3
|
event?: keyof HTMLElementEventMap;
|
|
4
|
-
read(element: Element):
|
|
5
|
-
write?: (element: Element, value:
|
|
4
|
+
read(element: Element): Value;
|
|
5
|
+
write?: (element: Element, value: FieldState<Value>['value']) => void;
|
|
6
6
|
}>;
|
|
7
|
-
|
|
8
|
-
export declare function bindField<Element extends HTMLElement, V>(element: Element, field: Field<V>, options: FieldBindingOptions<Element, V>): () => void;
|
|
7
|
+
export declare function bindField<Element extends HTMLElement, Value>(element: Element, field: Field<Value>, options: FieldBindingOptions<Element, Value>): () => void;
|
|
9
8
|
//# sourceMappingURL=dom.d.ts.map
|
package/dist/dom.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,
|
|
1
|
+
{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,MAAM,mBAAmB,CAAC,OAAO,SAAS,WAAW,EAAE,KAAK,IAAI,QAAQ,CAAC;IAC7E,KAAK,CAAC,EAAE,MAAM,mBAAmB,CAAC;IAClC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,CAAC;IAC9B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CACvE,CAAC,CAAC;AAEH,wBAAgB,SAAS,CAAC,OAAO,SAAS,WAAW,EAAE,KAAK,EAC1D,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EACnB,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,GAC3C,MAAM,IAAI,CAwCZ"}
|
package/dist/dom.js
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
1
|
//#region src/dom.ts
|
|
2
2
|
function e(e, t, n) {
|
|
3
|
-
let r = n.event ?? "input", i = !1, a = () => {
|
|
3
|
+
let r = n.event ?? "input", i = !1, a = !1, o = t.value, s = () => {
|
|
4
4
|
i = !0;
|
|
5
5
|
try {
|
|
6
6
|
t.set(n.read(e));
|
|
7
7
|
} finally {
|
|
8
8
|
i = !1;
|
|
9
9
|
}
|
|
10
|
-
},
|
|
10
|
+
}, c = () => t.touch(), l = n.write ? t.subscribe(({ value: t }) => {
|
|
11
11
|
if (i) {
|
|
12
|
-
|
|
12
|
+
a = !0, o = t;
|
|
13
13
|
return;
|
|
14
14
|
}
|
|
15
|
-
|
|
16
|
-
}, { immediate: !0 }) : () =>
|
|
17
|
-
return e.addEventListener(r,
|
|
18
|
-
e.removeEventListener(r,
|
|
15
|
+
a && Object.is(t, o) || (a = !0, o = t, n.write?.(e, t));
|
|
16
|
+
}, { immediate: !0 }) : () => void 0;
|
|
17
|
+
return e.addEventListener(r, s), e.addEventListener("blur", c), () => {
|
|
18
|
+
e.removeEventListener(r, s), e.removeEventListener("blur", c), l();
|
|
19
19
|
};
|
|
20
20
|
}
|
|
21
21
|
//#endregion
|
package/dist/dom.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dom.js","names":[],"sources":["../src/dom.ts"],"sourcesContent":["import type { Field,
|
|
1
|
+
{"version":3,"file":"dom.js","names":[],"sources":["../src/dom.ts"],"sourcesContent":["import type { Field, FieldState } from './types.js';\n\nexport type FieldBindingOptions<Element extends HTMLElement, Value> = Readonly<{\n event?: keyof HTMLElementEventMap;\n read(element: Element): Value;\n write?: (element: Element, value: FieldState<Value>['value']) => void;\n}>;\n\nexport function bindField<Element extends HTMLElement, Value>(\n element: Element,\n field: Field<Value>,\n options: FieldBindingOptions<Element, Value>,\n): () => void {\n const event = options.event ?? 'input';\n let updatingFromElement = false;\n let hasRendered = false;\n let rendered = field.value;\n\n const onInput = (): void => {\n updatingFromElement = true;\n try {\n field.set(options.read(element));\n } finally {\n updatingFromElement = false;\n }\n };\n const onBlur = (): void => field.touch();\n const unsubscribe = options.write\n ? field.subscribe(\n ({ value }) => {\n if (updatingFromElement) {\n hasRendered = true;\n rendered = value;\n return;\n }\n if (hasRendered && Object.is(value, rendered)) return;\n hasRendered = true;\n rendered = value;\n options.write?.(element, value);\n },\n { immediate: true },\n )\n : () => undefined;\n\n element.addEventListener(event, onInput);\n element.addEventListener('blur', onBlur);\n\n return () => {\n element.removeEventListener(event, onInput);\n element.removeEventListener('blur', onBlur);\n unsubscribe();\n };\n}\n"],"mappings":";AAQA,SAAgB,EACd,GACA,GACA,GACY;CACZ,IAAM,IAAQ,EAAQ,SAAS,SAC3B,IAAsB,IACtB,IAAc,IACd,IAAW,EAAM,OAEf,UAAsB;EAC1B,IAAsB;EACtB,IAAI;GACF,EAAM,IAAI,EAAQ,KAAK,CAAO,CAAC;EACjC,UAAU;GACR,IAAsB;EACxB;CACF,GACM,UAAqB,EAAM,MAAM,GACjC,IAAc,EAAQ,QACxB,EAAM,WACH,EAAE,eAAY;EACb,IAAI,GAAqB;GAEvB,AADA,IAAc,IACd,IAAW;GACX;EACF;EACI,KAAe,OAAO,GAAG,GAAO,CAAQ,MAC5C,IAAc,IACd,IAAW,GACX,EAAQ,QAAQ,GAAS,CAAK;CAChC,GACA,EAAE,WAAW,GAAK,CACpB,UACM,KAAA;CAKV,OAHA,EAAQ,iBAAiB,GAAO,CAAO,GACvC,EAAQ,iBAAiB,QAAQ,CAAM,SAE1B;EAGX,AAFA,EAAQ,oBAAoB,GAAO,CAAO,GAC1C,EAAQ,oBAAoB,QAAQ,CAAM,GAC1C,EAAY;CACd;AACF"}
|
package/dist/errors.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
var e=class extends Error{constructor(e,t){super(e,t),this.name=new.target.
|
|
1
|
+
var e=class extends Error{static errorName=`ForgeError`;constructor(e,t){super(e,t),this.name=new.target.errorName,Object.setPrototypeOf(this,new.target.prototype)}},t=class extends e{static errorName=`ForgeDisposedError`;constructor(e){super(e?`Cannot call ${e}() on a disposed form`:`Cannot modify a disposed form`)}},n=class extends e{static errorName=`ForgeConfigError`},r=class extends e{static errorName=`ForgeSubmitError`},i=class extends e{static errorName=`ForgeValidationError`};exports.ForgeConfigError=n,exports.ForgeDisposedError=t,exports.ForgeError=e,exports.ForgeSubmitError=r,exports.ForgeValidationError=i;
|
|
2
2
|
//# sourceMappingURL=errors.cjs.map
|
package/dist/errors.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */\nexport class ForgeError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.
|
|
1
|
+
{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */\nexport class ForgeError extends Error {\n protected static readonly errorName: string = 'ForgeError';\n\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = (new.target as typeof ForgeError).errorName;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when any method is called on a disposed form. */\nexport class ForgeDisposedError extends ForgeError {\n protected static override readonly errorName = 'ForgeDisposedError';\n\n /** @param op The public method name that was called (e.g. `'set'`) — included in the\n * message so a stack trace tells you *what* to guard, not just *that* it's disposed. */\n constructor(op?: string) {\n super(op ? `Cannot call ${op}() on a disposed form` : 'Cannot modify a disposed form');\n }\n}\n\n/** Thrown when form configuration or value structure is invalid. */\nexport class ForgeConfigError extends ForgeError {\n protected static override readonly errorName = 'ForgeConfigError';\n}\n\n/** Thrown when `submit()` is called while a submission is already in progress. */\nexport class ForgeSubmitError extends ForgeError {\n protected static override readonly errorName = 'ForgeSubmitError';\n}\n\n/** Wraps unexpected exceptions from a form validator without converting validation failures into exceptions. */\nexport class ForgeValidationError extends ForgeError {\n protected static override readonly errorName = 'ForgeValidationError';\n}\n"],"mappings":"AACA,IAAa,EAAb,cAAgC,KAAM,CACpC,OAA0B,UAAoB,aAE9C,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAQ,WAAiC,UAC9C,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAGa,EAAb,cAAwC,CAAW,CACjD,OAAmC,UAAY,qBAI/C,YAAY,EAAa,CACvB,MAAM,EAAK,eAAe,EAAG,uBAAyB,+BAA+B,CACvF,CACF,EAGa,EAAb,cAAsC,CAAW,CAC/C,OAAmC,UAAY,kBACjD,EAGa,EAAb,cAAsC,CAAW,CAC/C,OAAmC,UAAY,kBACjD,EAGa,EAAb,cAA0C,CAAW,CACnD,OAAmC,UAAY,sBACjD"}
|
package/dist/errors.d.ts
CHANGED
|
@@ -1,20 +1,25 @@
|
|
|
1
1
|
/** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */
|
|
2
2
|
export declare class ForgeError extends Error {
|
|
3
|
+
protected static readonly errorName: string;
|
|
3
4
|
constructor(message: string, opts?: ErrorOptions);
|
|
4
5
|
}
|
|
5
6
|
/** Thrown when any method is called on a disposed form. */
|
|
6
7
|
export declare class ForgeDisposedError extends ForgeError {
|
|
8
|
+
protected static readonly errorName = "ForgeDisposedError";
|
|
7
9
|
/** @param op The public method name that was called (e.g. `'set'`) — included in the
|
|
8
10
|
* message so a stack trace tells you *what* to guard, not just *that* it's disposed. */
|
|
9
11
|
constructor(op?: string);
|
|
10
12
|
}
|
|
11
|
-
/** Thrown when
|
|
13
|
+
/** Thrown when form configuration or value structure is invalid. */
|
|
12
14
|
export declare class ForgeConfigError extends ForgeError {
|
|
15
|
+
protected static readonly errorName = "ForgeConfigError";
|
|
13
16
|
}
|
|
14
17
|
/** Thrown when `submit()` is called while a submission is already in progress. */
|
|
15
18
|
export declare class ForgeSubmitError extends ForgeError {
|
|
19
|
+
protected static readonly errorName = "ForgeSubmitError";
|
|
16
20
|
}
|
|
17
21
|
/** Wraps unexpected exceptions from a form validator without converting validation failures into exceptions. */
|
|
18
22
|
export declare class ForgeValidationError extends ForgeError {
|
|
23
|
+
protected static readonly errorName = "ForgeValidationError";
|
|
19
24
|
}
|
|
20
25
|
//# sourceMappingURL=errors.d.ts.map
|
package/dist/errors.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,qBAAa,UAAW,SAAQ,KAAK;
|
|
1
|
+
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAgB;gBAE/C,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;CAKjD;AAED,2DAA2D;AAC3D,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,0BAAmC,SAAS,wBAAwB;IAEpE;4FACwF;gBAC5E,EAAE,CAAC,EAAE,MAAM;CAGxB;AAED,oEAAoE;AACpE,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,0BAAmC,SAAS,sBAAsB;CACnE;AAED,kFAAkF;AAClF,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,0BAAmC,SAAS,sBAAsB;CACnE;AAED,gHAAgH;AAChH,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,0BAAmC,SAAS,0BAA0B;CACvE"}
|
package/dist/errors.js
CHANGED
|
@@ -1,13 +1,21 @@
|
|
|
1
1
|
//#region src/errors.ts
|
|
2
2
|
var e = class extends Error {
|
|
3
|
+
static errorName = "ForgeError";
|
|
3
4
|
constructor(e, t) {
|
|
4
|
-
super(e, t), this.name = new.target.
|
|
5
|
+
super(e, t), this.name = new.target.errorName, Object.setPrototypeOf(this, new.target.prototype);
|
|
5
6
|
}
|
|
6
7
|
}, t = class extends e {
|
|
8
|
+
static errorName = "ForgeDisposedError";
|
|
7
9
|
constructor(e) {
|
|
8
10
|
super(e ? `Cannot call ${e}() on a disposed form` : "Cannot modify a disposed form");
|
|
9
11
|
}
|
|
10
|
-
}, n = class extends e {
|
|
12
|
+
}, n = class extends e {
|
|
13
|
+
static errorName = "ForgeConfigError";
|
|
14
|
+
}, r = class extends e {
|
|
15
|
+
static errorName = "ForgeSubmitError";
|
|
16
|
+
}, i = class extends e {
|
|
17
|
+
static errorName = "ForgeValidationError";
|
|
18
|
+
};
|
|
11
19
|
//#endregion
|
|
12
20
|
export { n as ForgeConfigError, t as ForgeDisposedError, e as ForgeError, r as ForgeSubmitError, i as ForgeValidationError };
|
|
13
21
|
|
package/dist/errors.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */\nexport class ForgeError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.
|
|
1
|
+
{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */\nexport class ForgeError extends Error {\n protected static readonly errorName: string = 'ForgeError';\n\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = (new.target as typeof ForgeError).errorName;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when any method is called on a disposed form. */\nexport class ForgeDisposedError extends ForgeError {\n protected static override readonly errorName = 'ForgeDisposedError';\n\n /** @param op The public method name that was called (e.g. `'set'`) — included in the\n * message so a stack trace tells you *what* to guard, not just *that* it's disposed. */\n constructor(op?: string) {\n super(op ? `Cannot call ${op}() on a disposed form` : 'Cannot modify a disposed form');\n }\n}\n\n/** Thrown when form configuration or value structure is invalid. */\nexport class ForgeConfigError extends ForgeError {\n protected static override readonly errorName = 'ForgeConfigError';\n}\n\n/** Thrown when `submit()` is called while a submission is already in progress. */\nexport class ForgeSubmitError extends ForgeError {\n protected static override readonly errorName = 'ForgeSubmitError';\n}\n\n/** Wraps unexpected exceptions from a form validator without converting validation failures into exceptions. */\nexport class ForgeValidationError extends ForgeError {\n protected static override readonly errorName = 'ForgeValidationError';\n}\n"],"mappings":";AACA,IAAa,IAAb,cAAgC,MAAM;CACpC,OAA0B,YAAoB;CAE9C,YAAY,GAAiB,GAAqB;EAGhD,AAFA,MAAM,GAAS,CAAI,GACnB,KAAK,OAAQ,WAAiC,WAC9C,OAAO,eAAe,MAAM,WAAW,SAAS;CAClD;AACF,GAGa,IAAb,cAAwC,EAAW;CACjD,OAAmC,YAAY;CAI/C,YAAY,GAAa;EACvB,MAAM,IAAK,eAAe,EAAG,yBAAyB,+BAA+B;CACvF;AACF,GAGa,IAAb,cAAsC,EAAW;CAC/C,OAAmC,YAAY;AACjD,GAGa,IAAb,cAAsC,EAAW;CAC/C,OAAmC,YAAY;AACjD,GAGa,IAAb,cAA0C,EAAW;CACnD,OAAmC,YAAY;AACjD"}
|