tiny-essentials 1.24.1 → 1.24.3
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/changelog/1/24/1.md +2 -0
- package/changelog/1/24/2.md +21 -0
- package/changelog/1/24/3.md +6 -0
- package/dist/v1/TinyDragger.min.js +1 -1
- package/dist/v1/TinyEssentials.min.js +1 -1
- package/dist/v1/TinyHtml.min.js +1 -1
- package/dist/v1/TinySmartScroller.min.js +1 -1
- package/dist/v1/TinyUploadClicker.min.js +1 -1
- package/dist/v1/libs/ColorSafeStringify.d.mts +1 -1
- package/dist/v1/libs/TinyColorValidator.d.mts +16 -16
- package/dist/v1/libs/TinyGamepad.d.mts +1 -1
- package/dist/v1/libs/TinyHtml/TinyHtmlIcon.d.mts +1 -1
- package/dist/v1/libs/TinyHtml/TinyHtmlTemplate.d.mts +1 -1
- package/dist/v1/libs/TinyHtml/index.d.mts +1 -1
- package/dist/v1/libs/TinyHtml.cjs +8 -53
- package/dist/v1/libs/TinyHtml.d.mts +71 -119
- package/dist/v1/libs/TinyHtml.mjs +6 -53
- package/dist/v1/libs/TinyInventory.d.mts +1 -1
- package/dist/v1/libs/UltraRandomMsgGen.d.mts +7 -7
- package/docs/v1/Exports.md +133 -0
- package/docs/v1/README.md +2 -0
- package/package.json +203 -23
|
@@ -13,7 +13,7 @@ declare class ColorSafeStringify {
|
|
|
13
13
|
* @type {Record<string, ColorsList>}
|
|
14
14
|
* @static
|
|
15
15
|
*/
|
|
16
|
-
static "__#
|
|
16
|
+
static "__#private@#PRESETS": Record<string, ColorsList>;
|
|
17
17
|
/**
|
|
18
18
|
* Constructs a new instance with an optional base preset or custom override.
|
|
19
19
|
* @param {ColorsList} [defaultColors] - Optional override for the default color scheme.
|
|
@@ -80,22 +80,22 @@ export type ColorTypes = "hex" | "hexa" | "rgb" | "rgba" | "hsl" | "hsla" | "hwb
|
|
|
80
80
|
* @template {string} TinyColorValidatorT
|
|
81
81
|
*/
|
|
82
82
|
declare class TinyColorValidator<TinyColorValidatorT extends string> {
|
|
83
|
-
static "__#
|
|
84
|
-
static "__#
|
|
85
|
-
static "__#
|
|
86
|
-
static "__#
|
|
87
|
-
static "__#
|
|
88
|
-
static "__#
|
|
89
|
-
static "__#
|
|
90
|
-
static "__#
|
|
91
|
-
static "__#
|
|
92
|
-
static "__#
|
|
93
|
-
static "__#
|
|
94
|
-
static "__#
|
|
95
|
-
static "__#
|
|
96
|
-
static "__#
|
|
97
|
-
static "__#
|
|
98
|
-
static "__#
|
|
83
|
+
static "__#private@#HEX_REGEX": RegExp;
|
|
84
|
+
static "__#private@#HEXA_REGEX": RegExp;
|
|
85
|
+
static "__#private@#ALPHA": string;
|
|
86
|
+
static "__#private@#NUM_0_255": string;
|
|
87
|
+
static "__#private@#NUM_0_360": string;
|
|
88
|
+
static "__#private@#NUM_0_100": string;
|
|
89
|
+
static "__#private@#RGB_REGEX": RegExp;
|
|
90
|
+
static "__#private@#RGBA_REGEX": RegExp;
|
|
91
|
+
static "__#private@#HSL_REGEX": RegExp;
|
|
92
|
+
static "__#private@#HSLA_REGEX": RegExp;
|
|
93
|
+
static "__#private@#HWB_REGEX": RegExp;
|
|
94
|
+
static "__#private@#LAB_AB": string;
|
|
95
|
+
static "__#private@#LAB_REGEX": RegExp;
|
|
96
|
+
static "__#private@#LCH_REGEX": RegExp;
|
|
97
|
+
static "__#private@#HTML_COLOR_NAMES": Set<string>;
|
|
98
|
+
static "__#private@#SPECIAL_COLOR_NAMES": Set<string>;
|
|
99
99
|
/**
|
|
100
100
|
* Returns all HTML color names as an array.
|
|
101
101
|
* @returns {string[]}
|
|
@@ -493,7 +493,7 @@ export type ExportedConfig = {
|
|
|
493
493
|
*/
|
|
494
494
|
declare class TinyGamepad {
|
|
495
495
|
/** @type {Record<string, string>} */
|
|
496
|
-
static "__#
|
|
496
|
+
static "__#private@#specialMap": Record<string, string>;
|
|
497
497
|
/**
|
|
498
498
|
* Add or update a special key mapping.
|
|
499
499
|
* @param {string} char - The character to map.
|
|
@@ -8,7 +8,7 @@ export default TinyHtmlIcon;
|
|
|
8
8
|
*/
|
|
9
9
|
declare class TinyHtmlIcon extends TinyHtmlTemplate<HTMLElement> {
|
|
10
10
|
/** @type {string} */
|
|
11
|
-
static "__#
|
|
11
|
+
static "__#private@#defaultTag": string;
|
|
12
12
|
/** @param {string} value */
|
|
13
13
|
static set defaultTag(value: string);
|
|
14
14
|
/** @returns {string} */
|
|
@@ -34,7 +34,7 @@ declare class TinyHtmlTemplate<TinyHtmlT extends Element> extends TinyHtml<TinyH
|
|
|
34
34
|
* @param {ClassSetter} value
|
|
35
35
|
* @returns {Set<string>}
|
|
36
36
|
*/
|
|
37
|
-
static "__#
|
|
37
|
+
static "__#private@#normalizeClasses"(value: ClassSetter): Set<string>;
|
|
38
38
|
/**
|
|
39
39
|
* Creates a new TinyHtmlTemplate instance.
|
|
40
40
|
* @param {TinyHtmlT} tag - The HTML tag name to create (e.g., 'div', 'span').
|
|
@@ -4,7 +4,7 @@ export default TinyHtmlElems;
|
|
|
4
4
|
* @beta
|
|
5
5
|
*/
|
|
6
6
|
declare class TinyHtmlElems {
|
|
7
|
-
static "__#
|
|
7
|
+
static "__#private@#list": (typeof TinyHtmlTemplate | typeof TinyHtmlAnchor | typeof TinyHtmlButton | typeof TinyHtmlCanvas | typeof TinyHtmlDatalist | typeof TinyHtmlEmbed | typeof TinyHtmlForm | typeof TinyHtmlIcon | typeof TinyHtmlIframe | typeof TinyHtmlImage | typeof TinyHtmlInput | typeof TinyHtmlLink | typeof TinyHtmlMedia | typeof TinyHtmlScript | typeof TinyHtmlSelect | typeof TinyHtmlStyle | typeof TinyHtmlTextarea | typeof TinyHtmlResetInput | typeof TinyHtmlNumberInput | typeof TinyHtmlFileInput | typeof TinyHtmlHiddenInput | typeof TinyHtmlImageInput | typeof TinyHtmlAudio | typeof TinyHtmlObject | typeof TinyHtmlSource)[];
|
|
8
8
|
static get list(): (typeof TinyHtmlTemplate | typeof TinyHtmlAnchor | typeof TinyHtmlButton | typeof TinyHtmlCanvas | typeof TinyHtmlDatalist | typeof TinyHtmlEmbed | typeof TinyHtmlForm | typeof TinyHtmlIcon | typeof TinyHtmlIframe | typeof TinyHtmlImage | typeof TinyHtmlInput | typeof TinyHtmlLink | typeof TinyHtmlMedia | typeof TinyHtmlScript | typeof TinyHtmlSelect | typeof TinyHtmlStyle | typeof TinyHtmlTextarea | typeof TinyHtmlResetInput | typeof TinyHtmlNumberInput | typeof TinyHtmlFileInput | typeof TinyHtmlHiddenInput | typeof TinyHtmlImageInput | typeof TinyHtmlAudio | typeof TinyHtmlObject | typeof TinyHtmlSource)[];
|
|
9
9
|
static ButtonInput: typeof TinyHtmlButtonInput;
|
|
10
10
|
static ResetInput: typeof TinyHtmlResetInput;
|
|
@@ -366,6 +366,14 @@ class TinyHtml {
|
|
|
366
366
|
|
|
367
367
|
static Utils = { ...collision };
|
|
368
368
|
|
|
369
|
+
/** @type {number} */
|
|
370
|
+
static #version = 1;
|
|
371
|
+
|
|
372
|
+
/** @returns {number} */
|
|
373
|
+
static get version() {
|
|
374
|
+
return this.#version;
|
|
375
|
+
}
|
|
376
|
+
|
|
369
377
|
/**
|
|
370
378
|
* Controls whether TinyHtml emits detailed debug output to the console.
|
|
371
379
|
* When enabled, helper methods print structured diagnostics for easier troubleshooting.
|
|
@@ -1081,7 +1089,6 @@ class TinyHtml {
|
|
|
1081
1089
|
* @param {string} where - The method name or context calling this.
|
|
1082
1090
|
* @param {number} index - The index of the element to retrieve.
|
|
1083
1091
|
* @returns {ConstructorElValues} - The instance's element.
|
|
1084
|
-
* @readonly
|
|
1085
1092
|
*/
|
|
1086
1093
|
_getElement(where, index) {
|
|
1087
1094
|
if (
|
|
@@ -1101,7 +1108,6 @@ class TinyHtml {
|
|
|
1101
1108
|
*
|
|
1102
1109
|
* @param {string} where - The method name or context calling this.
|
|
1103
1110
|
* @returns {ConstructorElValues[]} - The instance's elements.
|
|
1104
|
-
* @readonly
|
|
1105
1111
|
*/
|
|
1106
1112
|
_getElements(where) {
|
|
1107
1113
|
if (
|
|
@@ -1132,7 +1138,6 @@ class TinyHtml {
|
|
|
1132
1138
|
* @param {string[]} elemName - The list of expected element names for error reporting.
|
|
1133
1139
|
* @returns {any[]} - A flat array of validated elements.
|
|
1134
1140
|
* @throws {Error} - If any element is not an instance of one of the allowed types.
|
|
1135
|
-
* @readonly
|
|
1136
1141
|
*/
|
|
1137
1142
|
static _preElemsTemplate(elems, where, TheTinyElements, elemName) {
|
|
1138
1143
|
/** @param {(TinyElement|EventTarget|null)[]} item */
|
|
@@ -1172,7 +1177,6 @@ class TinyHtml {
|
|
|
1172
1177
|
* @param {string[]} elemName - The list of expected element names for error reporting.
|
|
1173
1178
|
* @returns {any[]} - A flat array of validated elements.
|
|
1174
1179
|
* @throws {Error} - If any element is not an instance of one of the allowed types.
|
|
1175
|
-
* @readonly
|
|
1176
1180
|
*/
|
|
1177
1181
|
_preElemsTemplate(where, TheTinyElements, elemName) {
|
|
1178
1182
|
return TinyHtml._preElemsTemplate(this, where, TheTinyElements, elemName);
|
|
@@ -1188,7 +1192,6 @@ class TinyHtml {
|
|
|
1188
1192
|
* @param {boolean} [canNull=false] - Whether `null` is allowed as a valid value.
|
|
1189
1193
|
* @returns {any} - The validated element or `null` if allowed.
|
|
1190
1194
|
* @throws {Error} - If the element is not valid or if multiple elements are provided.
|
|
1191
|
-
* @readonly
|
|
1192
1195
|
*/
|
|
1193
1196
|
static _preElemTemplate(elems, where, TheTinyElements, elemName, canNull = false) {
|
|
1194
1197
|
/** @param {(TinyElement|EventTarget|null)[]} item */
|
|
@@ -1242,7 +1245,6 @@ class TinyHtml {
|
|
|
1242
1245
|
* @param {boolean} [canNull=false] - Whether `null` is allowed as a valid value.
|
|
1243
1246
|
* @returns {any} - The validated element or `null` if allowed.
|
|
1244
1247
|
* @throws {Error} - If the element is not valid or if multiple elements are provided.
|
|
1245
|
-
* @readonly
|
|
1246
1248
|
*/
|
|
1247
1249
|
_preElemTemplate(where, TheTinyElements, elemName, canNull = false) {
|
|
1248
1250
|
return TinyHtml._preElemTemplate(this, where, TheTinyElements, elemName, canNull);
|
|
@@ -1255,7 +1257,6 @@ class TinyHtml {
|
|
|
1255
1257
|
* @param {TinyElement|TinyElement[]} elems - A single element or array of elements.
|
|
1256
1258
|
* @param {string} where - The method or context name where validation is being called.
|
|
1257
1259
|
* @returns {Element[]} - Always returns an array of elements.
|
|
1258
|
-
* @readonly
|
|
1259
1260
|
*/
|
|
1260
1261
|
static _preElems(elems, where) {
|
|
1261
1262
|
return TinyHtml._preElemsTemplate(elems, where, [Element], ['Element']);
|
|
@@ -1267,7 +1268,6 @@ class TinyHtml {
|
|
|
1267
1268
|
*
|
|
1268
1269
|
* @param {string} where - The method or context name where validation is being called.
|
|
1269
1270
|
* @returns {Element[]} - Always returns an array of elements.
|
|
1270
|
-
* @readonly
|
|
1271
1271
|
*/
|
|
1272
1272
|
_preElems(where) {
|
|
1273
1273
|
return TinyHtml._preElems(this, where);
|
|
@@ -1280,7 +1280,6 @@ class TinyHtml {
|
|
|
1280
1280
|
* @param {TinyElement|TinyElement[]} elems - A single element or array of elements.
|
|
1281
1281
|
* @param {string} where - The method or context name where validation is being called.
|
|
1282
1282
|
* @returns {Element} - Always returns an single element.
|
|
1283
|
-
* @readonly
|
|
1284
1283
|
*/
|
|
1285
1284
|
static _preElem(elems, where) {
|
|
1286
1285
|
return TinyHtml._preElemTemplate(elems, where, [Element], ['Element']);
|
|
@@ -1292,7 +1291,6 @@ class TinyHtml {
|
|
|
1292
1291
|
*
|
|
1293
1292
|
* @param {string} where - The method or context name where validation is being called.
|
|
1294
1293
|
* @returns {Element} - Always returns an single element.
|
|
1295
|
-
* @readonly
|
|
1296
1294
|
*/
|
|
1297
1295
|
_preElem(where) {
|
|
1298
1296
|
return TinyHtml._preElem(this, where);
|
|
@@ -1305,7 +1303,6 @@ class TinyHtml {
|
|
|
1305
1303
|
* @param {TinyNode|TinyNode[]} elems - A single node or array of nodes.
|
|
1306
1304
|
* @param {string} where - The method or context name where validation is being called.
|
|
1307
1305
|
* @returns {Node[]} - Always returns an array of nodes.
|
|
1308
|
-
* @readonly
|
|
1309
1306
|
*/
|
|
1310
1307
|
static _preNodeElems(elems, where) {
|
|
1311
1308
|
return TinyHtml._preElemsTemplate(elems, where, [Node], ['Node']);
|
|
@@ -1317,7 +1314,6 @@ class TinyHtml {
|
|
|
1317
1314
|
*
|
|
1318
1315
|
* @param {string} where - The method or context name where validation is being called.
|
|
1319
1316
|
* @returns {Node[]} - Always returns an array of nodes.
|
|
1320
|
-
* @readonly
|
|
1321
1317
|
*/
|
|
1322
1318
|
_preNodeElems(where) {
|
|
1323
1319
|
return TinyHtml._preNodeElems(this, where);
|
|
@@ -1330,7 +1326,6 @@ class TinyHtml {
|
|
|
1330
1326
|
* @param {TinyNode|TinyNode[]} elems - A single node or array of nodes.
|
|
1331
1327
|
* @param {string} where - The method or context name where validation is being called.
|
|
1332
1328
|
* @returns {Node} - Always returns an single node.
|
|
1333
|
-
* @readonly
|
|
1334
1329
|
*/
|
|
1335
1330
|
static _preNodeElem(elems, where) {
|
|
1336
1331
|
return TinyHtml._preElemTemplate(elems, where, [Node], ['Node']);
|
|
@@ -1342,7 +1337,6 @@ class TinyHtml {
|
|
|
1342
1337
|
*
|
|
1343
1338
|
* @param {string} where - The method or context name where validation is being called.
|
|
1344
1339
|
* @returns {Node} - Always returns an single node.
|
|
1345
|
-
* @readonly
|
|
1346
1340
|
*/
|
|
1347
1341
|
_preNodeElem(where) {
|
|
1348
1342
|
return TinyHtml._preNodeElem(this, where);
|
|
@@ -1355,7 +1349,6 @@ class TinyHtml {
|
|
|
1355
1349
|
* @param {TinyNode|TinyNode[]} elems - A single node or array of nodes.
|
|
1356
1350
|
* @param {string} where - The method or context name where validation is being called.
|
|
1357
1351
|
* @returns {Node|null} - Always returns an single node or null.
|
|
1358
|
-
* @readonly
|
|
1359
1352
|
*/
|
|
1360
1353
|
static _preNodeElemWithNull(elems, where) {
|
|
1361
1354
|
return TinyHtml._preElemTemplate(elems, where, [Node], ['Node'], true);
|
|
@@ -1367,7 +1360,6 @@ class TinyHtml {
|
|
|
1367
1360
|
*
|
|
1368
1361
|
* @param {string} where - The method or context name where validation is being called.
|
|
1369
1362
|
* @returns {Node|null} - Always returns an single node or null.
|
|
1370
|
-
* @readonly
|
|
1371
1363
|
*/
|
|
1372
1364
|
_preNodeElemWithNull(where) {
|
|
1373
1365
|
return TinyHtml._preNodeElemWithNull(this, where);
|
|
@@ -1380,7 +1372,6 @@ class TinyHtml {
|
|
|
1380
1372
|
* @param {TinyElement|TinyElement[]} elems - A single html element or array of html elements.
|
|
1381
1373
|
* @param {string} where - The method or context name where validation is being called.
|
|
1382
1374
|
* @returns {HTMLElement[]} - Always returns an array of html elements.
|
|
1383
|
-
* @readonly
|
|
1384
1375
|
*/
|
|
1385
1376
|
static _preHtmlElems(elems, where) {
|
|
1386
1377
|
return TinyHtml._preElemsTemplate(elems, where, [HTMLElement], ['HTMLElement']);
|
|
@@ -1392,7 +1383,6 @@ class TinyHtml {
|
|
|
1392
1383
|
*
|
|
1393
1384
|
* @param {string} where - The method or context name where validation is being called.
|
|
1394
1385
|
* @returns {HTMLElement[]} - Always returns an array of html elements.
|
|
1395
|
-
* @readonly
|
|
1396
1386
|
*/
|
|
1397
1387
|
_preHtmlElems(where) {
|
|
1398
1388
|
return TinyHtml._preHtmlElems(this, where);
|
|
@@ -1405,7 +1395,6 @@ class TinyHtml {
|
|
|
1405
1395
|
* @param {TinyElement|TinyElement[]} elems - A single html element or array of html elements.
|
|
1406
1396
|
* @param {string} where - The method or context name where validation is being called.
|
|
1407
1397
|
* @returns {HTMLElement} - Always returns an single html element.
|
|
1408
|
-
* @readonly
|
|
1409
1398
|
*/
|
|
1410
1399
|
static _preHtmlElem(elems, where) {
|
|
1411
1400
|
return TinyHtml._preElemTemplate(elems, where, [HTMLElement], ['HTMLElement']);
|
|
@@ -1417,7 +1406,6 @@ class TinyHtml {
|
|
|
1417
1406
|
*
|
|
1418
1407
|
* @param {string} where - The method or context name where validation is being called.
|
|
1419
1408
|
* @returns {HTMLElement} - Always returns an single html element.
|
|
1420
|
-
* @readonly
|
|
1421
1409
|
*/
|
|
1422
1410
|
_preHtmlElem(where) {
|
|
1423
1411
|
return TinyHtml._preHtmlElem(this, where);
|
|
@@ -1430,7 +1418,6 @@ class TinyHtml {
|
|
|
1430
1418
|
* @param {TinyInputElement|TinyInputElement[]} elems - A single event target element or array of html elements.
|
|
1431
1419
|
* @param {string} where - The method or context name where validation is being called.
|
|
1432
1420
|
* @returns {InputElement[]} - Always returns an array of event target elements.
|
|
1433
|
-
* @readonly
|
|
1434
1421
|
*/
|
|
1435
1422
|
static _preInputElems(elems, where) {
|
|
1436
1423
|
return TinyHtml._preElemsTemplate(
|
|
@@ -1447,7 +1434,6 @@ class TinyHtml {
|
|
|
1447
1434
|
*
|
|
1448
1435
|
* @param {string} where - The method or context name where validation is being called.
|
|
1449
1436
|
* @returns {InputElement[]} - Always returns an array of event target elements.
|
|
1450
|
-
* @readonly
|
|
1451
1437
|
*/
|
|
1452
1438
|
_preInputElems(where) {
|
|
1453
1439
|
return TinyHtml._preInputElems(this, where);
|
|
@@ -1460,7 +1446,6 @@ class TinyHtml {
|
|
|
1460
1446
|
* @param {TinyInputElement|TinyInputElement[]} elems - A single event target element or array of html elements.
|
|
1461
1447
|
* @param {string} where - The method or context name where validation is being called.
|
|
1462
1448
|
* @returns {InputElement} - Always returns an single event target element.
|
|
1463
|
-
* @readonly
|
|
1464
1449
|
*/
|
|
1465
1450
|
static _preInputElem(elems, where) {
|
|
1466
1451
|
return TinyHtml._preElemTemplate(
|
|
@@ -1477,7 +1462,6 @@ class TinyHtml {
|
|
|
1477
1462
|
*
|
|
1478
1463
|
* @param {string} where - The method or context name where validation is being called.
|
|
1479
1464
|
* @returns {InputElement} - Always returns an single event target element.
|
|
1480
|
-
* @readonly
|
|
1481
1465
|
*/
|
|
1482
1466
|
_preInputElem(where) {
|
|
1483
1467
|
return TinyHtml._preInputElem(this, where);
|
|
@@ -1490,7 +1474,6 @@ class TinyHtml {
|
|
|
1490
1474
|
* @param {TinyEventTarget|TinyEventTarget[]} elems - A single event target element or array of html elements.
|
|
1491
1475
|
* @param {string} where - The method or context name where validation is being called.
|
|
1492
1476
|
* @returns {EventTarget[]} - Always returns an array of event target elements.
|
|
1493
|
-
* @readonly
|
|
1494
1477
|
*/
|
|
1495
1478
|
static _preEventTargetElems(elems, where) {
|
|
1496
1479
|
return TinyHtml._preElemsTemplate(elems, where, [EventTarget], ['EventTarget']);
|
|
@@ -1502,7 +1485,6 @@ class TinyHtml {
|
|
|
1502
1485
|
*
|
|
1503
1486
|
* @param {string} where - The method or context name where validation is being called.
|
|
1504
1487
|
* @returns {EventTarget[]} - Always returns an array of event target elements.
|
|
1505
|
-
* @readonly
|
|
1506
1488
|
*/
|
|
1507
1489
|
_preEventTargetElems(where) {
|
|
1508
1490
|
return TinyHtml._preEventTargetElems(this, where);
|
|
@@ -1515,7 +1497,6 @@ class TinyHtml {
|
|
|
1515
1497
|
* @param {TinyEventTarget|TinyEventTarget[]} elems - A single event target element or array of html elements.
|
|
1516
1498
|
* @param {string} where - The method or context name where validation is being called.
|
|
1517
1499
|
* @returns {EventTarget} - Always returns an single event target element.
|
|
1518
|
-
* @readonly
|
|
1519
1500
|
*/
|
|
1520
1501
|
static _preEventTargetElem(elems, where) {
|
|
1521
1502
|
return TinyHtml._preElemTemplate(elems, where, [EventTarget], ['EventTarget']);
|
|
@@ -1527,7 +1508,6 @@ class TinyHtml {
|
|
|
1527
1508
|
*
|
|
1528
1509
|
* @param {string} where - The method or context name where validation is being called.
|
|
1529
1510
|
* @returns {EventTarget} - Always returns an single event target element.
|
|
1530
|
-
* @readonly
|
|
1531
1511
|
*/
|
|
1532
1512
|
_preEventTargetElem(where) {
|
|
1533
1513
|
return TinyHtml._preEventTargetElem(this, where);
|
|
@@ -1540,7 +1520,6 @@ class TinyHtml {
|
|
|
1540
1520
|
* @param {TinyElementAndWindow|TinyElementAndWindow[]} elems - A single element/window element or array of html elements.
|
|
1541
1521
|
* @param {string} where - The method or context name where validation is being called.
|
|
1542
1522
|
* @returns {ElementAndWindow[]} - Always returns an array of element/window elements.
|
|
1543
|
-
* @readonly
|
|
1544
1523
|
*/
|
|
1545
1524
|
static _preElemsAndWindow(elems, where) {
|
|
1546
1525
|
return TinyHtml._preElemsTemplate(elems, where, [Element, Window], ['Element', 'Window']);
|
|
@@ -1552,7 +1531,6 @@ class TinyHtml {
|
|
|
1552
1531
|
*
|
|
1553
1532
|
* @param {string} where - The method or context name where validation is being called.
|
|
1554
1533
|
* @returns {ElementAndWindow[]} - Always returns an array of element/window elements.
|
|
1555
|
-
* @readonly
|
|
1556
1534
|
*/
|
|
1557
1535
|
_preElemsAndWindow(where) {
|
|
1558
1536
|
return TinyHtml._preElemsAndWindow(this, where);
|
|
@@ -1565,7 +1543,6 @@ class TinyHtml {
|
|
|
1565
1543
|
* @param {TinyElementAndWindow|TinyElementAndWindow[]} elems - A single element/window element or array of html elements.
|
|
1566
1544
|
* @param {string} where - The method or context name where validation is being called.
|
|
1567
1545
|
* @returns {ElementAndWindow} - Always returns an single element/window element.
|
|
1568
|
-
* @readonly
|
|
1569
1546
|
*/
|
|
1570
1547
|
static _preElemAndWindow(elems, where) {
|
|
1571
1548
|
return TinyHtml._preElemTemplate(elems, where, [Element, Window], ['Element', 'Window']);
|
|
@@ -1577,7 +1554,6 @@ class TinyHtml {
|
|
|
1577
1554
|
*
|
|
1578
1555
|
* @param {string} where - The method or context name where validation is being called.
|
|
1579
1556
|
* @returns {ElementAndWindow} - Always returns an single element/window element.
|
|
1580
|
-
* @readonly
|
|
1581
1557
|
*/
|
|
1582
1558
|
_preElemAndWindow(where) {
|
|
1583
1559
|
return TinyHtml._preElemAndWindow(this, where);
|
|
@@ -1590,7 +1566,6 @@ class TinyHtml {
|
|
|
1590
1566
|
* @param {TinyElementAndWinAndDoc|TinyElementAndWinAndDoc[]} elems - A single element/document/window element or array of html elements.
|
|
1591
1567
|
* @param {string} where - The method or context name where validation is being called.
|
|
1592
1568
|
* @returns {ElementAndWindow[]} - Always returns an array of element/document/window elements.
|
|
1593
|
-
* @readonly
|
|
1594
1569
|
*/
|
|
1595
1570
|
static _preElemsAndWinAndDoc(elems, where) {
|
|
1596
1571
|
const result = TinyHtml._preElemsTemplate(
|
|
@@ -1608,7 +1583,6 @@ class TinyHtml {
|
|
|
1608
1583
|
*
|
|
1609
1584
|
* @param {string} where - The method or context name where validation is being called.
|
|
1610
1585
|
* @returns {ElementAndWindow[]} - Always returns an array of element/document/window elements.
|
|
1611
|
-
* @readonly
|
|
1612
1586
|
*/
|
|
1613
1587
|
_preElemsAndWinAndDoc(where) {
|
|
1614
1588
|
return TinyHtml._preElemsAndWinAndDoc(this, where);
|
|
@@ -1621,7 +1595,6 @@ class TinyHtml {
|
|
|
1621
1595
|
* @param {TinyElementAndWinAndDoc|TinyElementAndWinAndDoc[]} elems - A single element/document/window element or array of html elements.
|
|
1622
1596
|
* @param {string} where - The method or context name where validation is being called.
|
|
1623
1597
|
* @returns {ElementAndWindow} - Always returns an single element/document/window element.
|
|
1624
|
-
* @readonly
|
|
1625
1598
|
*/
|
|
1626
1599
|
static _preElemAndWinAndDoc(elems, where) {
|
|
1627
1600
|
const result = TinyHtml._preElemTemplate(
|
|
@@ -1640,7 +1613,6 @@ class TinyHtml {
|
|
|
1640
1613
|
*
|
|
1641
1614
|
* @param {string} where - The method or context name where validation is being called.
|
|
1642
1615
|
* @returns {ElementAndWindow} - Always returns an single element/document/window element.
|
|
1643
|
-
* @readonly
|
|
1644
1616
|
*/
|
|
1645
1617
|
_preElemAndWinAndDoc(where) {
|
|
1646
1618
|
return TinyHtml._preElemAndWinAndDoc(this, where);
|
|
@@ -1653,7 +1625,6 @@ class TinyHtml {
|
|
|
1653
1625
|
* @param {TinyElementWithDoc|TinyElementWithDoc[]} elems - A single element with document element or array of html elements.
|
|
1654
1626
|
* @param {string} where - The method or context name where validation is being called.
|
|
1655
1627
|
* @returns {ElementWithDoc[]} - Always returns an array of element with document elements.
|
|
1656
|
-
* @readonly
|
|
1657
1628
|
*/
|
|
1658
1629
|
static _preElemsWithDoc(elems, where) {
|
|
1659
1630
|
return TinyHtml._preElemsTemplate(elems, where, [Element, Document], ['Element', 'Document']);
|
|
@@ -1665,7 +1636,6 @@ class TinyHtml {
|
|
|
1665
1636
|
*
|
|
1666
1637
|
* @param {string} where - The method or context name where validation is being called.
|
|
1667
1638
|
* @returns {ElementWithDoc[]} - Always returns an array of element with document elements.
|
|
1668
|
-
* @readonly
|
|
1669
1639
|
*/
|
|
1670
1640
|
_preElemsWithDoc(where) {
|
|
1671
1641
|
return TinyHtml._preElemsWithDoc(this, where);
|
|
@@ -1678,7 +1648,6 @@ class TinyHtml {
|
|
|
1678
1648
|
* @param {TinyElementWithDoc|TinyElementWithDoc[]} elems - A single element/window element or array of html elements.
|
|
1679
1649
|
* @param {string} where - The method or context name where validation is being called.
|
|
1680
1650
|
* @returns {ElementWithDoc} - Always returns an single element/window element.
|
|
1681
|
-
* @readonly
|
|
1682
1651
|
*/
|
|
1683
1652
|
static _preElemWithDoc(elems, where) {
|
|
1684
1653
|
return TinyHtml._preElemTemplate(elems, where, [Element, Document], ['Element', 'Document']);
|
|
@@ -1690,7 +1659,6 @@ class TinyHtml {
|
|
|
1690
1659
|
*
|
|
1691
1660
|
* @param {string} where - The method or context name where validation is being called.
|
|
1692
1661
|
* @returns {ElementWithDoc} - Always returns an single element/window element.
|
|
1693
|
-
* @readonly
|
|
1694
1662
|
*/
|
|
1695
1663
|
_preElemWithDoc(where) {
|
|
1696
1664
|
return TinyHtml._preElemWithDoc(this, where);
|
|
@@ -2014,7 +1982,6 @@ class TinyHtml {
|
|
|
2014
1982
|
* Internal data selectors for accessing public or private data stores.
|
|
2015
1983
|
*
|
|
2016
1984
|
* @type {Record<string, (where: string, elem: TinyElement) => ElementDataStore>}
|
|
2017
|
-
* @readonly
|
|
2018
1985
|
*/
|
|
2019
1986
|
static _dataSelector = {
|
|
2020
1987
|
public: (where, el) => {
|
|
@@ -2162,7 +2129,6 @@ class TinyHtml {
|
|
|
2162
2129
|
* @param {"previousSibling"|"nextSibling"} direction
|
|
2163
2130
|
* @param {string} where
|
|
2164
2131
|
* @returns {ChildNode|null}
|
|
2165
|
-
* @readonly
|
|
2166
2132
|
*/
|
|
2167
2133
|
static _getSibling(el, direction, where) {
|
|
2168
2134
|
/** @type {Node|null} */
|
|
@@ -2178,7 +2144,6 @@ class TinyHtml {
|
|
|
2178
2144
|
* @param {Node|null} start
|
|
2179
2145
|
* @param {Node|null} [exclude]
|
|
2180
2146
|
* @returns {ChildNode[]}
|
|
2181
|
-
* @readonly
|
|
2182
2147
|
*/
|
|
2183
2148
|
static _getSiblings(start, exclude) {
|
|
2184
2149
|
/** @type {Node|null} */
|
|
@@ -2486,7 +2451,6 @@ class TinyHtml {
|
|
|
2486
2451
|
* Normalize and validate nodes before DOM insertion.
|
|
2487
2452
|
* Converts TinyNode-like structures or strings into DOM-compatible nodes.
|
|
2488
2453
|
* @type {(where: string, ...nodes: (AppendCheckerValues|Record<string, AppendCheckerValues>)[]) => (Node | string)[]}
|
|
2489
|
-
* @readonly
|
|
2490
2454
|
*/
|
|
2491
2455
|
static _appendChecker(where, ...nodes) {
|
|
2492
2456
|
/** @type {(string | Node)[]} */
|
|
@@ -6184,7 +6148,6 @@ class TinyHtml {
|
|
|
6184
6148
|
|
|
6185
6149
|
// TITLE: Value Stuff
|
|
6186
6150
|
|
|
6187
|
-
/** @readonly */
|
|
6188
6151
|
static _valHooks = {
|
|
6189
6152
|
option: {
|
|
6190
6153
|
/**
|
|
@@ -6371,7 +6334,6 @@ class TinyHtml {
|
|
|
6371
6334
|
/**
|
|
6372
6335
|
* Maps value types to their corresponding getter functions.
|
|
6373
6336
|
* Each function extracts a value of a specific type from a compatible HTMLInputElement.
|
|
6374
|
-
* @readonly
|
|
6375
6337
|
*/
|
|
6376
6338
|
static _valTypes = {
|
|
6377
6339
|
/**
|
|
@@ -6405,7 +6367,6 @@ class TinyHtml {
|
|
|
6405
6367
|
* @param {string} where - The context/method name using this validation.
|
|
6406
6368
|
* @returns {any} The extracted value, depending on the type.
|
|
6407
6369
|
* @throws {Error} If the element is not an HTMLInputElement or if the type handler is invalid.
|
|
6408
|
-
* @readonly
|
|
6409
6370
|
*/
|
|
6410
6371
|
static _getValByType(elem, type, where) {
|
|
6411
6372
|
if (typeof type !== 'string') throw new TypeError('The "type" must be a string.');
|
|
@@ -6426,7 +6387,6 @@ class TinyHtml {
|
|
|
6426
6387
|
* @param {GetValueTypes} type - The type of value to retrieve ("string", "date", or "number").
|
|
6427
6388
|
* @param {string} where - The context/method name using this validation.
|
|
6428
6389
|
* @returns {any} The raw value retrieved from the element or hook.
|
|
6429
|
-
* @readonly
|
|
6430
6390
|
*/
|
|
6431
6391
|
static _val(el, where, type) {
|
|
6432
6392
|
const elem = TinyHtml._preInputElem(el, where);
|
|
@@ -6447,7 +6407,6 @@ class TinyHtml {
|
|
|
6447
6407
|
* @param {GetValueTypes} type - The type of value to retrieve ("string", "date", or "number").
|
|
6448
6408
|
* @param {string} where - The context/method name using this validation.
|
|
6449
6409
|
* @returns {any} The raw value retrieved from the element or hook.
|
|
6450
|
-
* @readonly
|
|
6451
6410
|
*/
|
|
6452
6411
|
_val(where, type) {
|
|
6453
6412
|
return TinyHtml._val(this, where, type);
|
|
@@ -6504,7 +6463,6 @@ class TinyHtml {
|
|
|
6504
6463
|
* @param {GetValueTypes} type - The type of value to retrieve ("string", "date", or "number").
|
|
6505
6464
|
* @returns {SetValueBase[]} - The validated value as an array.
|
|
6506
6465
|
* @throws {Error} If the returned value is not an array.
|
|
6507
|
-
* @readonly
|
|
6508
6466
|
*/
|
|
6509
6467
|
static _valArr(el, where, type) {
|
|
6510
6468
|
/** @type {SetValueBase[]} */
|
|
@@ -6520,7 +6478,6 @@ class TinyHtml {
|
|
|
6520
6478
|
* @param {GetValueTypes} type - The type of value to retrieve ("string", "date", or "number").
|
|
6521
6479
|
* @returns {SetValueBase[]} - The validated value as an array.
|
|
6522
6480
|
* @throws {Error} If the returned value is not an array.
|
|
6523
|
-
* @readonly
|
|
6524
6481
|
*/
|
|
6525
6482
|
_valArr(where, type) {
|
|
6526
6483
|
return TinyHtml._valArr(this, where, type);
|
|
@@ -7739,7 +7696,6 @@ class TinyHtml {
|
|
|
7739
7696
|
* @param {DOMRect} rect - The base rectangle to be cloned and extended.
|
|
7740
7697
|
* @param {Partial<DOMRect>} extraRect - Additional dimensions to apply to the base rect (e.g., extra padding or offset).
|
|
7741
7698
|
* @returns {DOMRect} - A new DOMRect object with the combined dimensions.
|
|
7742
|
-
* @readonly
|
|
7743
7699
|
*/
|
|
7744
7700
|
static _getCustomRect(rect, extraRect) {
|
|
7745
7701
|
/** @type {DOMRect} */
|
|
@@ -7860,7 +7816,6 @@ class TinyHtml {
|
|
|
7860
7816
|
* @param {Element} elem1 - The element to track collision state for.
|
|
7861
7817
|
* @param {CollisionDirLock} lockDirection - The direction from which the collision was first detected.
|
|
7862
7818
|
* @returns {boolean} Returns `true` if the element is still considered colliding (locked), otherwise `false`.
|
|
7863
|
-
* @readonly
|
|
7864
7819
|
*/
|
|
7865
7820
|
static _isCollWithLock(isColliding, rect1, rect2, elem1, lockDirection) {
|
|
7866
7821
|
const lockMap = __elemCollision[lockDirection];
|