@awacloud/fw 0.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/CHANGELOG.md +79 -0
- package/LICENSE +176 -0
- package/NOTICE +12 -0
- package/README.md +355 -0
- package/dist/build/fw.core.pure.meta.json +29 -0
- package/dist/build/fw.core.pure.min.js +26 -0
- package/dist/build/fw.full.pure.meta.json +224 -0
- package/dist/build/fw.full.pure.min.js +60 -0
- package/dist/build/fw.minimal.pure.meta.json +21 -0
- package/dist/build/fw.minimal.pure.min.js +26 -0
- package/dist/build/fw.pack.compress-heavy.pure.meta.json +29 -0
- package/dist/build/fw.pack.compress-heavy.pure.min.js +8 -0
- package/dist/build/fw.pack.crypto-advanced.pure.meta.json +38 -0
- package/dist/build/fw.pack.crypto-advanced.pure.min.js +6 -0
- package/dist/build/fw.pack.crypto-basic.pure.meta.json +29 -0
- package/dist/build/fw.pack.crypto-basic.pure.min.js +6 -0
- package/dist/build/fw.pack.crypto-identity.pure.meta.json +29 -0
- package/dist/build/fw.pack.crypto-identity.pure.min.js +9 -0
- package/dist/build/fw.pack.realtime.pure.meta.json +21 -0
- package/dist/build/fw.pack.realtime.pure.min.js +6 -0
- package/dist/build/fw.pack.sensors.pure.meta.json +21 -0
- package/dist/build/fw.pack.sensors.pure.min.js +6 -0
- package/dist/build/fw.pack.structures-advanced.pure.meta.json +20 -0
- package/dist/build/fw.pack.structures-advanced.pure.min.js +6 -0
- package/dist/build/fw.pack.text-advanced.pure.meta.json +20 -0
- package/dist/build/fw.pack.text-advanced.pure.min.js +6 -0
- package/dist/build/fw.pwa.pure.meta.json +127 -0
- package/dist/build/fw.pwa.pure.min.js +55 -0
- package/dist/build/fw.site-interactive.pure.meta.json +81 -0
- package/dist/build/fw.site-interactive.pure.min.js +52 -0
- package/dist/build/fw.site.pure.meta.json +51 -0
- package/dist/build/fw.site.pure.min.js +35 -0
- package/dist/build/fw.spa.pure.meta.json +108 -0
- package/dist/build/fw.spa.pure.min.js +55 -0
- package/dist/build/io/compress/brotli_dict.bin +432 -0
- package/dist/build/sanity-base-classic.min.js +6 -0
- package/dist/build/sanity-community-classic.min.js +6 -0
- package/dist/build/sanity.min.js +6 -0
- package/dist/types/core/logger.d.ts +71 -0
- package/dist/types/core/logger.d.ts.map +1 -0
- package/dist/types/core/modules.d.ts +3962 -0
- package/dist/types/core/modules.d.ts.map +1 -0
- package/dist/types/core/readyState.d.ts +14 -0
- package/dist/types/core/readyState.d.ts.map +1 -0
- package/dist/types/core/runtime.d.ts +625 -0
- package/dist/types/core/runtime.d.ts.map +1 -0
- package/dist/types/core/worker-helper.d.ts +153 -0
- package/dist/types/core/worker-helper.d.ts.map +1 -0
- package/dist/types/crypto/cipher/aes.d.ts +55 -0
- package/dist/types/crypto/cipher/aes.d.ts.map +1 -0
- package/dist/types/crypto/cipher/chacha20.d.ts +33 -0
- package/dist/types/crypto/cipher/chacha20.d.ts.map +1 -0
- package/dist/types/crypto/hash/adf.d.ts +65 -0
- package/dist/types/crypto/hash/adf.d.ts.map +1 -0
- package/dist/types/crypto/hash/argon2.d.ts +79 -0
- package/dist/types/crypto/hash/argon2.d.ts.map +1 -0
- package/dist/types/crypto/hash/blake2b.d.ts +40 -0
- package/dist/types/crypto/hash/blake2b.d.ts.map +1 -0
- package/dist/types/crypto/hash/hkdf.d.ts +88 -0
- package/dist/types/crypto/hash/hkdf.d.ts.map +1 -0
- package/dist/types/crypto/hash/hmac.d.ts +85 -0
- package/dist/types/crypto/hash/hmac.d.ts.map +1 -0
- package/dist/types/crypto/hash/pbkdf2.d.ts +80 -0
- package/dist/types/crypto/hash/pbkdf2.d.ts.map +1 -0
- package/dist/types/crypto/hash/poly1305.d.ts +31 -0
- package/dist/types/crypto/hash/poly1305.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha224.d.ts +80 -0
- package/dist/types/crypto/hash/sha224.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha256.d.ts +82 -0
- package/dist/types/crypto/hash/sha256.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha3.d.ts +111 -0
- package/dist/types/crypto/hash/sha3.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha384.d.ts +84 -0
- package/dist/types/crypto/hash/sha384.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha512.d.ts +87 -0
- package/dist/types/crypto/hash/sha512.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha512_224.d.ts +84 -0
- package/dist/types/crypto/hash/sha512_224.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha512_256.d.ts +84 -0
- package/dist/types/crypto/hash/sha512_256.d.ts.map +1 -0
- package/dist/types/crypto/mode/cbc.d.ts +38 -0
- package/dist/types/crypto/mode/cbc.d.ts.map +1 -0
- package/dist/types/crypto/mode/chacha20poly1305.d.ts +71 -0
- package/dist/types/crypto/mode/chacha20poly1305.d.ts.map +1 -0
- package/dist/types/crypto/mode/cmac.d.ts +56 -0
- package/dist/types/crypto/mode/cmac.d.ts.map +1 -0
- package/dist/types/crypto/mode/ctr.d.ts +52 -0
- package/dist/types/crypto/mode/ctr.d.ts.map +1 -0
- package/dist/types/crypto/mode/gcm.d.ts +88 -0
- package/dist/types/crypto/mode/gcm.d.ts.map +1 -0
- package/dist/types/crypto/mode/kw.d.ts +60 -0
- package/dist/types/crypto/mode/kw.d.ts.map +1 -0
- package/dist/types/crypto/pkc/ecc.d.ts +284 -0
- package/dist/types/crypto/pkc/ecc.d.ts.map +1 -0
- package/dist/types/crypto/pkc/ed25519.d.ts +107 -0
- package/dist/types/crypto/pkc/ed25519.d.ts.map +1 -0
- package/dist/types/crypto/pkc/hybridKem.d.ts +154 -0
- package/dist/types/crypto/pkc/hybridKem.d.ts.map +1 -0
- package/dist/types/crypto/pkc/hybridSign.d.ts +383 -0
- package/dist/types/crypto/pkc/hybridSign.d.ts.map +1 -0
- package/dist/types/crypto/pkc/ml_dsa.d.ts +174 -0
- package/dist/types/crypto/pkc/ml_dsa.d.ts.map +1 -0
- package/dist/types/crypto/pkc/ml_kem.d.ts +194 -0
- package/dist/types/crypto/pkc/ml_kem.d.ts.map +1 -0
- package/dist/types/crypto/pkc/rsa.d.ts +175 -0
- package/dist/types/crypto/pkc/rsa.d.ts.map +1 -0
- package/dist/types/crypto/pkc/slh_dsa.d.ts +232 -0
- package/dist/types/crypto/pkc/slh_dsa.d.ts.map +1 -0
- package/dist/types/crypto/pkc/x25519.d.ts +37 -0
- package/dist/types/crypto/pkc/x25519.d.ts.map +1 -0
- package/dist/types/crypto/utils/aes_ctr.d.ts +84 -0
- package/dist/types/crypto/utils/aes_ctr.d.ts.map +1 -0
- package/dist/types/crypto/utils/aes_modes.d.ts +128 -0
- package/dist/types/crypto/utils/aes_modes.d.ts.map +1 -0
- package/dist/types/crypto/utils/asn1-oid.d.ts +45 -0
- package/dist/types/crypto/utils/asn1-oid.d.ts.map +1 -0
- package/dist/types/crypto/utils/asn1.d.ts +115 -0
- package/dist/types/crypto/utils/asn1.d.ts.map +1 -0
- package/dist/types/crypto/utils/bitArray.d.ts +75 -0
- package/dist/types/crypto/utils/bitArray.d.ts.map +1 -0
- package/dist/types/crypto/utils/bn.d.ts +214 -0
- package/dist/types/crypto/utils/bn.d.ts.map +1 -0
- package/dist/types/crypto/utils/jws.d.ts +159 -0
- package/dist/types/crypto/utils/jws.d.ts.map +1 -0
- package/dist/types/crypto/utils/keyformat.d.ts +100 -0
- package/dist/types/crypto/utils/keyformat.d.ts.map +1 -0
- package/dist/types/crypto/utils/pad.d.ts +44 -0
- package/dist/types/crypto/utils/pad.d.ts.map +1 -0
- package/dist/types/crypto/utils/pem.d.ts +41 -0
- package/dist/types/crypto/utils/pem.d.ts.map +1 -0
- package/dist/types/crypto/utils/random.d.ts +203 -0
- package/dist/types/crypto/utils/random.d.ts.map +1 -0
- package/dist/types/crypto/utils/rsaKeygen.d.ts +162 -0
- package/dist/types/crypto/utils/rsaKeygen.d.ts.map +1 -0
- package/dist/types/crypto/utils/totp.d.ts +183 -0
- package/dist/types/crypto/utils/totp.d.ts.map +1 -0
- package/dist/types/crypto/utils/uuid.d.ts +29 -0
- package/dist/types/crypto/utils/uuid.d.ts.map +1 -0
- package/dist/types/crypto/wasm/aes.d.ts +59 -0
- package/dist/types/crypto/wasm/aes.d.ts.map +1 -0
- package/dist/types/crypto/wasm/argon2.d.ts +70 -0
- package/dist/types/crypto/wasm/argon2.d.ts.map +1 -0
- package/dist/types/crypto/wasm/blake2b.d.ts +59 -0
- package/dist/types/crypto/wasm/blake2b.d.ts.map +1 -0
- package/dist/types/crypto/wasm/chacha20poly1305.d.ts +43 -0
- package/dist/types/crypto/wasm/chacha20poly1305.d.ts.map +1 -0
- package/dist/types/crypto/wasm/cmac.d.ts +42 -0
- package/dist/types/crypto/wasm/cmac.d.ts.map +1 -0
- package/dist/types/crypto/wasm/ecc.d.ts +56 -0
- package/dist/types/crypto/wasm/ecc.d.ts.map +1 -0
- package/dist/types/crypto/wasm/ed25519.d.ts +52 -0
- package/dist/types/crypto/wasm/ed25519.d.ts.map +1 -0
- package/dist/types/crypto/wasm/hkdf.d.ts +40 -0
- package/dist/types/crypto/wasm/hkdf.d.ts.map +1 -0
- package/dist/types/crypto/wasm/hmac.d.ts +42 -0
- package/dist/types/crypto/wasm/hmac.d.ts.map +1 -0
- package/dist/types/crypto/wasm/ml_dsa.d.ts +48 -0
- package/dist/types/crypto/wasm/ml_dsa.d.ts.map +1 -0
- package/dist/types/crypto/wasm/ml_kem.d.ts +58 -0
- package/dist/types/crypto/wasm/ml_kem.d.ts.map +1 -0
- package/dist/types/crypto/wasm/pbkdf2.d.ts +38 -0
- package/dist/types/crypto/wasm/pbkdf2.d.ts.map +1 -0
- package/dist/types/crypto/wasm/rsa.d.ts +56 -0
- package/dist/types/crypto/wasm/rsa.d.ts.map +1 -0
- package/dist/types/crypto/wasm/runtime.d.ts +99 -0
- package/dist/types/crypto/wasm/runtime.d.ts.map +1 -0
- package/dist/types/crypto/wasm/sha2.d.ts +45 -0
- package/dist/types/crypto/wasm/sha2.d.ts.map +1 -0
- package/dist/types/crypto/wasm/sha3.d.ts +57 -0
- package/dist/types/crypto/wasm/sha3.d.ts.map +1 -0
- package/dist/types/crypto/wasm/slh_dsa.d.ts +62 -0
- package/dist/types/crypto/wasm/slh_dsa.d.ts.map +1 -0
- package/dist/types/crypto/wasm/x25519.d.ts +53 -0
- package/dist/types/crypto/wasm/x25519.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/aes.d.ts +59 -0
- package/dist/types/crypto/webcrypto/aes.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/aeskw.d.ts +40 -0
- package/dist/types/crypto/webcrypto/aeskw.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/digest.d.ts +43 -0
- package/dist/types/crypto/webcrypto/digest.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/ecc.d.ts +51 -0
- package/dist/types/crypto/webcrypto/ecc.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/ed25519.d.ts +43 -0
- package/dist/types/crypto/webcrypto/ed25519.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/hkdf.d.ts +18 -0
- package/dist/types/crypto/webcrypto/hkdf.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/hmac.d.ts +43 -0
- package/dist/types/crypto/webcrypto/hmac.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/pbkdf2.d.ts +18 -0
- package/dist/types/crypto/webcrypto/pbkdf2.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/rsa.d.ts +51 -0
- package/dist/types/crypto/webcrypto/rsa.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/x25519.d.ts +43 -0
- package/dist/types/crypto/webcrypto/x25519.d.ts.map +1 -0
- package/dist/types/dom/display/animate.d.ts +35 -0
- package/dist/types/dom/display/animate.d.ts.map +1 -0
- package/dist/types/dom/display/fullscreen.d.ts +59 -0
- package/dist/types/dom/display/fullscreen.d.ts.map +1 -0
- package/dist/types/dom/fs/download.d.ts +36 -0
- package/dist/types/dom/fs/download.d.ts.map +1 -0
- package/dist/types/dom/fs/fsAccess.d.ts +107 -0
- package/dist/types/dom/fs/fsAccess.d.ts.map +1 -0
- package/dist/types/dom/fs/indexedDB.d.ts +62 -0
- package/dist/types/dom/fs/indexedDB.d.ts.map +1 -0
- package/dist/types/dom/fs/remoteStore.d.ts +64 -0
- package/dist/types/dom/fs/remoteStore.d.ts.map +1 -0
- package/dist/types/dom/fs/storage.d.ts +56 -0
- package/dist/types/dom/fs/storage.d.ts.map +1 -0
- package/dist/types/dom/lifecycle/idle.d.ts +91 -0
- package/dist/types/dom/lifecycle/idle.d.ts.map +1 -0
- package/dist/types/dom/lifecycle/visibility.d.ts +49 -0
- package/dist/types/dom/lifecycle/visibility.d.ts.map +1 -0
- package/dist/types/dom/lifecycle/wakeLock.d.ts +69 -0
- package/dist/types/dom/lifecycle/wakeLock.d.ts.map +1 -0
- package/dist/types/dom/net/ajax.d.ts +27 -0
- package/dist/types/dom/net/ajax.d.ts.map +1 -0
- package/dist/types/dom/net/broadcastChannel.d.ts +51 -0
- package/dist/types/dom/net/broadcastChannel.d.ts.map +1 -0
- package/dist/types/dom/net/network.d.ts +80 -0
- package/dist/types/dom/net/network.d.ts.map +1 -0
- package/dist/types/dom/net/sse.d.ts +72 -0
- package/dist/types/dom/net/sse.d.ts.map +1 -0
- package/dist/types/dom/net/webrtc.d.ts +149 -0
- package/dist/types/dom/net/webrtc.d.ts.map +1 -0
- package/dist/types/dom/net/ws.d.ts +70 -0
- package/dist/types/dom/net/ws.d.ts.map +1 -0
- package/dist/types/dom/query/dnd.d.ts +86 -0
- package/dist/types/dom/query/dnd.d.ts.map +1 -0
- package/dist/types/dom/query/dom.d.ts +194 -0
- package/dist/types/dom/query/dom.d.ts.map +1 -0
- package/dist/types/dom/query/events.d.ts +135 -0
- package/dist/types/dom/query/events.d.ts.map +1 -0
- package/dist/types/dom/query/gesture.d.ts +59 -0
- package/dist/types/dom/query/gesture.d.ts.map +1 -0
- package/dist/types/dom/query/media.d.ts +156 -0
- package/dist/types/dom/query/media.d.ts.map +1 -0
- package/dist/types/dom/rendering/chart.d.ts +143 -0
- package/dist/types/dom/rendering/chart.d.ts.map +1 -0
- package/dist/types/dom/rendering/component.d.ts +92 -0
- package/dist/types/dom/rendering/component.d.ts.map +1 -0
- package/dist/types/dom/rendering/devtools-ui.d.ts +83 -0
- package/dist/types/dom/rendering/devtools-ui.d.ts.map +1 -0
- package/dist/types/dom/rendering/devtools.d.ts +68 -0
- package/dist/types/dom/rendering/devtools.d.ts.map +1 -0
- package/dist/types/dom/rendering/parser.d.ts +216 -0
- package/dist/types/dom/rendering/parser.d.ts.map +1 -0
- package/dist/types/dom/rendering/reactiveBind.d.ts +101 -0
- package/dist/types/dom/rendering/reactiveBind.d.ts.map +1 -0
- package/dist/types/dom/rendering/render.d.ts +121 -0
- package/dist/types/dom/rendering/render.d.ts.map +1 -0
- package/dist/types/dom/rendering/sanitize.d.ts +48 -0
- package/dist/types/dom/rendering/sanitize.d.ts.map +1 -0
- package/dist/types/dom/rendering/secPolicy.d.ts +89 -0
- package/dist/types/dom/rendering/secPolicy.d.ts.map +1 -0
- package/dist/types/dom/rendering/template.d.ts +251 -0
- package/dist/types/dom/rendering/template.d.ts.map +1 -0
- package/dist/types/dom/rendering/themeTokens.d.ts +61 -0
- package/dist/types/dom/rendering/themeTokens.d.ts.map +1 -0
- package/dist/types/dom/rendering/uiSession-core.d.ts +192 -0
- package/dist/types/dom/rendering/uiSession-core.d.ts.map +1 -0
- package/dist/types/dom/rendering/uiSession-direct.d.ts +63 -0
- package/dist/types/dom/rendering/uiSession-direct.d.ts.map +1 -0
- package/dist/types/dom/rendering/uiSession-list.d.ts +205 -0
- package/dist/types/dom/rendering/uiSession-list.d.ts.map +1 -0
- package/dist/types/dom/rendering/uiSession.d.ts +285 -0
- package/dist/types/dom/rendering/uiSession.d.ts.map +1 -0
- package/dist/types/dom/rendering/virtualScroll.d.ts +80 -0
- package/dist/types/dom/rendering/virtualScroll.d.ts.map +1 -0
- package/dist/types/dom/sensors/battery.d.ts +71 -0
- package/dist/types/dom/sensors/battery.d.ts.map +1 -0
- package/dist/types/dom/sensors/geolocation.d.ts +83 -0
- package/dist/types/dom/sensors/geolocation.d.ts.map +1 -0
- package/dist/types/dom/sensors/networkInfo.d.ts +82 -0
- package/dist/types/dom/sensors/networkInfo.d.ts.map +1 -0
- package/dist/types/dom/sensors/sensors.d.ts +191 -0
- package/dist/types/dom/sensors/sensors.d.ts.map +1 -0
- package/dist/types/dom/sw/backgroundSync.d.ts +48 -0
- package/dist/types/dom/sw/backgroundSync.d.ts.map +1 -0
- package/dist/types/dom/sw/cache.d.ts +71 -0
- package/dist/types/dom/sw/cache.d.ts.map +1 -0
- package/dist/types/dom/sw/push.d.ts +77 -0
- package/dist/types/dom/sw/push.d.ts.map +1 -0
- package/dist/types/dom/sw/serviceWorker.d.ts +57 -0
- package/dist/types/dom/sw/serviceWorker.d.ts.map +1 -0
- package/dist/types/dom/sw/sharedWorker.d.ts +81 -0
- package/dist/types/dom/sw/sharedWorker.d.ts.map +1 -0
- package/dist/types/dom/utils/a11y.d.ts +53 -0
- package/dist/types/dom/utils/a11y.d.ts.map +1 -0
- package/dist/types/dom/utils/clipboard.d.ts +44 -0
- package/dist/types/dom/utils/clipboard.d.ts.map +1 -0
- package/dist/types/dom/utils/entropyCollector.d.ts +58 -0
- package/dist/types/dom/utils/entropyCollector.d.ts.map +1 -0
- package/dist/types/dom/utils/focus.d.ts +123 -0
- package/dist/types/dom/utils/focus.d.ts.map +1 -0
- package/dist/types/dom/utils/form.d.ts +227 -0
- package/dist/types/dom/utils/form.d.ts.map +1 -0
- package/dist/types/dom/utils/formKit.d.ts +206 -0
- package/dist/types/dom/utils/formKit.d.ts.map +1 -0
- package/dist/types/dom/utils/keybindings.d.ts +53 -0
- package/dist/types/dom/utils/keybindings.d.ts.map +1 -0
- package/dist/types/dom/utils/leaderElection.d.ts +70 -0
- package/dist/types/dom/utils/leaderElection.d.ts.map +1 -0
- package/dist/types/dom/utils/notifications.d.ts +164 -0
- package/dist/types/dom/utils/notifications.d.ts.map +1 -0
- package/dist/types/dom/utils/permissions.d.ts +35 -0
- package/dist/types/dom/utils/permissions.d.ts.map +1 -0
- package/dist/types/dom/utils/route.d.ts +117 -0
- package/dist/types/dom/utils/route.d.ts.map +1 -0
- package/dist/types/dom/utils/ua.d.ts +35 -0
- package/dist/types/dom/utils/ua.d.ts.map +1 -0
- package/dist/types/dom/utils/webauthn.d.ts +98 -0
- package/dist/types/dom/utils/webauthn.d.ts.map +1 -0
- package/dist/types/io/binary/reader.d.ts +59 -0
- package/dist/types/io/binary/reader.d.ts.map +1 -0
- package/dist/types/io/binary/writer.d.ts +56 -0
- package/dist/types/io/binary/writer.d.ts.map +1 -0
- package/dist/types/io/calc/adler32.d.ts +31 -0
- package/dist/types/io/calc/adler32.d.ts.map +1 -0
- package/dist/types/io/calc/bigint.d.ts +74 -0
- package/dist/types/io/calc/bigint.d.ts.map +1 -0
- package/dist/types/io/calc/crc32.d.ts +36 -0
- package/dist/types/io/calc/crc32.d.ts.map +1 -0
- package/dist/types/io/calc/easing.d.ts +60 -0
- package/dist/types/io/calc/easing.d.ts.map +1 -0
- package/dist/types/io/codec/b64.d.ts +28 -0
- package/dist/types/io/codec/b64.d.ts.map +1 -0
- package/dist/types/io/codec/base32.d.ts +28 -0
- package/dist/types/io/codec/base32.d.ts.map +1 -0
- package/dist/types/io/codec/base58.d.ts +28 -0
- package/dist/types/io/codec/base58.d.ts.map +1 -0
- package/dist/types/io/codec/buffer.d.ts +66 -0
- package/dist/types/io/codec/buffer.d.ts.map +1 -0
- package/dist/types/io/codec/cbor.d.ts +43 -0
- package/dist/types/io/codec/cbor.d.ts.map +1 -0
- package/dist/types/io/codec/csv.d.ts +35 -0
- package/dist/types/io/codec/csv.d.ts.map +1 -0
- package/dist/types/io/codec/hex.d.ts +28 -0
- package/dist/types/io/codec/hex.d.ts.map +1 -0
- package/dist/types/io/codec/mime.d.ts +100 -0
- package/dist/types/io/codec/mime.d.ts.map +1 -0
- package/dist/types/io/codec/msgpack.d.ts +36 -0
- package/dist/types/io/codec/msgpack.d.ts.map +1 -0
- package/dist/types/io/codec/url.d.ts +52 -0
- package/dist/types/io/codec/url.d.ts.map +1 -0
- package/dist/types/io/codec/utf8.d.ts +22 -0
- package/dist/types/io/codec/utf8.d.ts.map +1 -0
- package/dist/types/io/codec/xml.d.ts +91 -0
- package/dist/types/io/codec/xml.d.ts.map +1 -0
- package/dist/types/io/compress/bitstream.d.ts +51 -0
- package/dist/types/io/compress/bitstream.d.ts.map +1 -0
- package/dist/types/io/compress/brotli.d.ts +86 -0
- package/dist/types/io/compress/brotli.d.ts.map +1 -0
- package/dist/types/io/compress/brotli_dict.d.ts +76 -0
- package/dist/types/io/compress/brotli_dict.d.ts.map +1 -0
- package/dist/types/io/compress/brotli_dict_words.d.ts +43 -0
- package/dist/types/io/compress/brotli_dict_words.d.ts.map +1 -0
- package/dist/types/io/compress/brotli_frame.d.ts +166 -0
- package/dist/types/io/compress/brotli_frame.d.ts.map +1 -0
- package/dist/types/io/compress/brotli_shared.d.ts +165 -0
- package/dist/types/io/compress/brotli_shared.d.ts.map +1 -0
- package/dist/types/io/compress/deflate.d.ts +89 -0
- package/dist/types/io/compress/deflate.d.ts.map +1 -0
- package/dist/types/io/compress/gzip.d.ts +100 -0
- package/dist/types/io/compress/gzip.d.ts.map +1 -0
- package/dist/types/io/compress/huffman.d.ts +37 -0
- package/dist/types/io/compress/huffman.d.ts.map +1 -0
- package/dist/types/io/compress/lz4.d.ts +45 -0
- package/dist/types/io/compress/lz4.d.ts.map +1 -0
- package/dist/types/io/compress/lz77.d.ts +66 -0
- package/dist/types/io/compress/lz77.d.ts.map +1 -0
- package/dist/types/io/compress/lzw.d.ts +37 -0
- package/dist/types/io/compress/lzw.d.ts.map +1 -0
- package/dist/types/io/compress/zip.d.ts +112 -0
- package/dist/types/io/compress/zip.d.ts.map +1 -0
- package/dist/types/io/compress/zlib.d.ts +97 -0
- package/dist/types/io/compress/zlib.d.ts.map +1 -0
- package/dist/types/io/i18n/i18n.d.ts +64 -0
- package/dist/types/io/i18n/i18n.d.ts.map +1 -0
- package/dist/types/io/math/fixed-point.d.ts +30 -0
- package/dist/types/io/math/fixed-point.d.ts.map +1 -0
- package/dist/types/io/math/geom.d.ts +125 -0
- package/dist/types/io/math/geom.d.ts.map +1 -0
- package/dist/types/io/math/interp.d.ts +48 -0
- package/dist/types/io/math/interp.d.ts.map +1 -0
- package/dist/types/io/math/linalg.d.ts +117 -0
- package/dist/types/io/math/linalg.d.ts.map +1 -0
- package/dist/types/io/math/stats.d.ts +45 -0
- package/dist/types/io/math/stats.d.ts.map +1 -0
- package/dist/types/io/structures/btree.d.ts +84 -0
- package/dist/types/io/structures/btree.d.ts.map +1 -0
- package/dist/types/io/structures/heap.d.ts +75 -0
- package/dist/types/io/structures/heap.d.ts.map +1 -0
- package/dist/types/io/structures/lruCache.d.ts +88 -0
- package/dist/types/io/structures/lruCache.d.ts.map +1 -0
- package/dist/types/io/structures/ringBuffer.d.ts +82 -0
- package/dist/types/io/structures/ringBuffer.d.ts.map +1 -0
- package/dist/types/io/structures/tree-walker.d.ts +95 -0
- package/dist/types/io/structures/tree-walker.d.ts.map +1 -0
- package/dist/types/io/structures/trie.d.ts +71 -0
- package/dist/types/io/structures/trie.d.ts.map +1 -0
- package/dist/types/io/sync/abort.d.ts +59 -0
- package/dist/types/io/sync/abort.d.ts.map +1 -0
- package/dist/types/io/sync/atomics.d.ts +107 -0
- package/dist/types/io/sync/atomics.d.ts.map +1 -0
- package/dist/types/io/sync/cancellable.d.ts +69 -0
- package/dist/types/io/sync/cancellable.d.ts.map +1 -0
- package/dist/types/io/sync/channel.d.ts +70 -0
- package/dist/types/io/sync/channel.d.ts.map +1 -0
- package/dist/types/io/sync/mutex.d.ts +39 -0
- package/dist/types/io/sync/mutex.d.ts.map +1 -0
- package/dist/types/io/sync/semaphore.d.ts +40 -0
- package/dist/types/io/sync/semaphore.d.ts.map +1 -0
- package/dist/types/io/sync/tokenBucket.d.ts +53 -0
- package/dist/types/io/sync/tokenBucket.d.ts.map +1 -0
- package/dist/types/io/text/ansi.d.ts +125 -0
- package/dist/types/io/text/ansi.d.ts.map +1 -0
- package/dist/types/io/text/html-entities.d.ts +35 -0
- package/dist/types/io/text/html-entities.d.ts.map +1 -0
- package/dist/types/io/text/semver.d.ts +75 -0
- package/dist/types/io/text/semver.d.ts.map +1 -0
- package/dist/types/io/text/str.d.ts +88 -0
- package/dist/types/io/text/str.d.ts.map +1 -0
- package/dist/types/io/text/unicode.d.ts +70 -0
- package/dist/types/io/text/unicode.d.ts.map +1 -0
- package/dist/types/io/time/date.d.ts +73 -0
- package/dist/types/io/time/date.d.ts.map +1 -0
- package/dist/types/io/timing/clock.d.ts +39 -0
- package/dist/types/io/timing/clock.d.ts.map +1 -0
- package/dist/types/io/timing/rateLimit.d.ts +40 -0
- package/dist/types/io/timing/rateLimit.d.ts.map +1 -0
- package/dist/types/io/timing/scheduler.d.ts +122 -0
- package/dist/types/io/timing/scheduler.d.ts.map +1 -0
- package/dist/types/io/utils/bitmap.d.ts +34 -0
- package/dist/types/io/utils/bitmap.d.ts.map +1 -0
- package/dist/types/io/utils/errors.d.ts +94 -0
- package/dist/types/io/utils/errors.d.ts.map +1 -0
- package/dist/types/io/utils/eventBus.d.ts +68 -0
- package/dist/types/io/utils/eventBus.d.ts.map +1 -0
- package/dist/types/io/utils/queue.d.ts +69 -0
- package/dist/types/io/utils/queue.d.ts.map +1 -0
- package/dist/types/io/utils/signal.d.ts +362 -0
- package/dist/types/io/utils/signal.d.ts.map +1 -0
- package/dist/types/io/utils/ui8.d.ts +34 -0
- package/dist/types/io/utils/ui8.d.ts.map +1 -0
- package/dist/types/io/utils/valid.d.ts +130 -0
- package/dist/types/io/utils/valid.d.ts.map +1 -0
- package/dist/types/main.d.ts +25 -0
- package/dist/types/main.d.ts.map +1 -0
- package/dist/types/process/message.d.ts +64 -0
- package/dist/types/process/message.d.ts.map +1 -0
- package/dist/types/process/rpc.d.ts +35 -0
- package/dist/types/process/rpc.d.ts.map +1 -0
- package/dist/types/process/workerPool.d.ts +62 -0
- package/dist/types/process/workerPool.d.ts.map +1 -0
- package/dist/types/sanity/base.d.ts +28 -0
- package/dist/types/sanity/base.d.ts.map +1 -0
- package/dist/types/sanity/community.d.ts +20 -0
- package/dist/types/sanity/community.d.ts.map +1 -0
- package/dist/types/sanity/lockdown-apply.d.ts +7 -0
- package/dist/types/sanity/lockdown-apply.d.ts.map +1 -0
- package/dist/types/sanity/lockdown.d.ts +43 -0
- package/dist/types/sanity/lockdown.d.ts.map +1 -0
- package/dist/types/sanity/wasm-gate.d.ts +128 -0
- package/dist/types/sanity/wasm-gate.d.ts.map +1 -0
- package/docs/README.md +301 -0
- package/docs/api/README.md +33 -0
- package/docs/api/core/README.md +14 -0
- package/docs/api/core/logger.md +151 -0
- package/docs/api/core/main.md +105 -0
- package/docs/api/core/modules.md +123 -0
- package/docs/api/core/readyState.md +94 -0
- package/docs/api/core/runtime.md +499 -0
- package/docs/api/core/worker-helper.md +180 -0
- package/docs/api/crypto/README.md +39 -0
- package/docs/api/crypto/cipher/README.md +24 -0
- package/docs/api/crypto/cipher/aes.md +101 -0
- package/docs/api/crypto/cipher/chacha20.md +85 -0
- package/docs/api/crypto/hash/README.md +49 -0
- package/docs/api/crypto/hash/adf.md +61 -0
- package/docs/api/crypto/hash/argon2.md +92 -0
- package/docs/api/crypto/hash/blake2b.md +88 -0
- package/docs/api/crypto/hash/hkdf.md +82 -0
- package/docs/api/crypto/hash/hmac.md +90 -0
- package/docs/api/crypto/hash/pbkdf2.md +93 -0
- package/docs/api/crypto/hash/poly1305.md +71 -0
- package/docs/api/crypto/hash/sha224.md +61 -0
- package/docs/api/crypto/hash/sha256.md +84 -0
- package/docs/api/crypto/hash/sha3.md +89 -0
- package/docs/api/crypto/hash/sha384.md +58 -0
- package/docs/api/crypto/hash/sha512.md +73 -0
- package/docs/api/crypto/hash/sha512_224.md +59 -0
- package/docs/api/crypto/hash/sha512_256.md +58 -0
- package/docs/api/crypto/mode/README.md +33 -0
- package/docs/api/crypto/mode/cbc.md +69 -0
- package/docs/api/crypto/mode/chacha20poly1305.md +77 -0
- package/docs/api/crypto/mode/cmac.md +79 -0
- package/docs/api/crypto/mode/ctr.md +66 -0
- package/docs/api/crypto/mode/gcm.md +93 -0
- package/docs/api/crypto/mode/kw.md +84 -0
- package/docs/api/crypto/pkc/README.md +48 -0
- package/docs/api/crypto/pkc/ecc.md +91 -0
- package/docs/api/crypto/pkc/ed25519.md +99 -0
- package/docs/api/crypto/pkc/hybridKem.md +178 -0
- package/docs/api/crypto/pkc/hybridSign.md +192 -0
- package/docs/api/crypto/pkc/ml_dsa.md +99 -0
- package/docs/api/crypto/pkc/ml_kem.md +90 -0
- package/docs/api/crypto/pkc/rsa.md +87 -0
- package/docs/api/crypto/pkc/slh_dsa.md +86 -0
- package/docs/api/crypto/pkc/x25519.md +84 -0
- package/docs/api/crypto/utils/README.md +39 -0
- package/docs/api/crypto/utils/aes_ctr.md +71 -0
- package/docs/api/crypto/utils/aes_modes.md +81 -0
- package/docs/api/crypto/utils/asn1-oid.md +130 -0
- package/docs/api/crypto/utils/asn1.md +69 -0
- package/docs/api/crypto/utils/bitArray.md +77 -0
- package/docs/api/crypto/utils/bn.md +67 -0
- package/docs/api/crypto/utils/jws.md +94 -0
- package/docs/api/crypto/utils/keyformat.md +78 -0
- package/docs/api/crypto/utils/pad.md +66 -0
- package/docs/api/crypto/utils/pem.md +63 -0
- package/docs/api/crypto/utils/random.md +103 -0
- package/docs/api/crypto/utils/rsaKeygen.md +118 -0
- package/docs/api/crypto/utils/totp.md +159 -0
- package/docs/api/crypto/utils/uuid.md +98 -0
- package/docs/api/crypto/wasm/README.md +76 -0
- package/docs/api/crypto/wasm/aes.md +128 -0
- package/docs/api/crypto/wasm/argon2.md +110 -0
- package/docs/api/crypto/wasm/blake2b.md +103 -0
- package/docs/api/crypto/wasm/chacha20poly1305.md +120 -0
- package/docs/api/crypto/wasm/cmac.md +119 -0
- package/docs/api/crypto/wasm/ecc.md +114 -0
- package/docs/api/crypto/wasm/ed25519.md +117 -0
- package/docs/api/crypto/wasm/hkdf.md +163 -0
- package/docs/api/crypto/wasm/hmac.md +129 -0
- package/docs/api/crypto/wasm/ml_dsa.md +99 -0
- package/docs/api/crypto/wasm/ml_kem.md +91 -0
- package/docs/api/crypto/wasm/pbkdf2.md +111 -0
- package/docs/api/crypto/wasm/rsa.md +113 -0
- package/docs/api/crypto/wasm/runtime.md +172 -0
- package/docs/api/crypto/wasm/sha2.md +95 -0
- package/docs/api/crypto/wasm/sha3.md +127 -0
- package/docs/api/crypto/wasm/slh_dsa.md +89 -0
- package/docs/api/crypto/wasm/x25519.md +116 -0
- package/docs/api/crypto/webcrypto/README.md +56 -0
- package/docs/api/crypto/webcrypto/aes.md +140 -0
- package/docs/api/crypto/webcrypto/aeskw.md +120 -0
- package/docs/api/crypto/webcrypto/digest.md +103 -0
- package/docs/api/crypto/webcrypto/ecc.md +122 -0
- package/docs/api/crypto/webcrypto/ed25519.md +121 -0
- package/docs/api/crypto/webcrypto/hkdf.md +141 -0
- package/docs/api/crypto/webcrypto/hmac.md +112 -0
- package/docs/api/crypto/webcrypto/pbkdf2.md +140 -0
- package/docs/api/crypto/webcrypto/rsa.md +149 -0
- package/docs/api/crypto/webcrypto/x25519.md +96 -0
- package/docs/api/dom/README.md +117 -0
- package/docs/api/dom/display/README.md +27 -0
- package/docs/api/dom/display/animate.md +113 -0
- package/docs/api/dom/display/fullscreen.md +121 -0
- package/docs/api/dom/fs/README.md +36 -0
- package/docs/api/dom/fs/download.md +108 -0
- package/docs/api/dom/fs/fsAccess.md +200 -0
- package/docs/api/dom/fs/indexedDB.md +219 -0
- package/docs/api/dom/fs/remoteStore.md +158 -0
- package/docs/api/dom/fs/storage.md +197 -0
- package/docs/api/dom/lifecycle/README.md +11 -0
- package/docs/api/dom/lifecycle/idle.md +89 -0
- package/docs/api/dom/lifecycle/visibility.md +73 -0
- package/docs/api/dom/lifecycle/wakeLock.md +94 -0
- package/docs/api/dom/net/README.md +31 -0
- package/docs/api/dom/net/ajax.md +176 -0
- package/docs/api/dom/net/broadcastChannel.md +110 -0
- package/docs/api/dom/net/network.md +137 -0
- package/docs/api/dom/net/sse.md +141 -0
- package/docs/api/dom/net/webrtc.md +158 -0
- package/docs/api/dom/net/ws.md +168 -0
- package/docs/api/dom/query/README.md +30 -0
- package/docs/api/dom/query/dnd.md +137 -0
- package/docs/api/dom/query/dom.md +275 -0
- package/docs/api/dom/query/events.md +211 -0
- package/docs/api/dom/query/gesture.md +137 -0
- package/docs/api/dom/query/media.md +188 -0
- package/docs/api/dom/rendering/README.md +41 -0
- package/docs/api/dom/rendering/chart.md +149 -0
- package/docs/api/dom/rendering/component.md +287 -0
- package/docs/api/dom/rendering/devtools-ui.md +129 -0
- package/docs/api/dom/rendering/devtools.md +157 -0
- package/docs/api/dom/rendering/parser.md +200 -0
- package/docs/api/dom/rendering/reactiveBind.md +234 -0
- package/docs/api/dom/rendering/render.md +219 -0
- package/docs/api/dom/rendering/sanitize.md +97 -0
- package/docs/api/dom/rendering/secPolicy.md +155 -0
- package/docs/api/dom/rendering/template.md +301 -0
- package/docs/api/dom/rendering/themeTokens.md +175 -0
- package/docs/api/dom/rendering/uiSession.md +546 -0
- package/docs/api/dom/rendering/virtualScroll.md +126 -0
- package/docs/api/dom/sensors/README.md +12 -0
- package/docs/api/dom/sensors/battery.md +70 -0
- package/docs/api/dom/sensors/geolocation.md +115 -0
- package/docs/api/dom/sensors/networkInfo.md +73 -0
- package/docs/api/dom/sensors/sensors.md +123 -0
- package/docs/api/dom/sw/README.md +31 -0
- package/docs/api/dom/sw/backgroundSync.md +145 -0
- package/docs/api/dom/sw/cache.md +116 -0
- package/docs/api/dom/sw/push.md +114 -0
- package/docs/api/dom/sw/serviceWorker.md +90 -0
- package/docs/api/dom/sw/sharedWorker.md +131 -0
- package/docs/api/dom/utils/README.md +25 -0
- package/docs/api/dom/utils/a11y.md +143 -0
- package/docs/api/dom/utils/clipboard.md +146 -0
- package/docs/api/dom/utils/entropyCollector.md +175 -0
- package/docs/api/dom/utils/focus.md +140 -0
- package/docs/api/dom/utils/form.md +196 -0
- package/docs/api/dom/utils/formKit.md +181 -0
- package/docs/api/dom/utils/keybindings.md +138 -0
- package/docs/api/dom/utils/leaderElection.md +130 -0
- package/docs/api/dom/utils/notifications.md +106 -0
- package/docs/api/dom/utils/permissions.md +82 -0
- package/docs/api/dom/utils/route.md +112 -0
- package/docs/api/dom/utils/ua.md +119 -0
- package/docs/api/dom/utils/webauthn.md +190 -0
- package/docs/api/io/README.md +20 -0
- package/docs/api/io/binary/README.md +29 -0
- package/docs/api/io/binary/reader.md +126 -0
- package/docs/api/io/binary/writer.md +127 -0
- package/docs/api/io/calc/README.md +22 -0
- package/docs/api/io/calc/adler32.md +75 -0
- package/docs/api/io/calc/bigint.md +105 -0
- package/docs/api/io/calc/crc32.md +74 -0
- package/docs/api/io/calc/easing.md +118 -0
- package/docs/api/io/codec/README.md +35 -0
- package/docs/api/io/codec/b64.md +92 -0
- package/docs/api/io/codec/base32.md +98 -0
- package/docs/api/io/codec/base58.md +104 -0
- package/docs/api/io/codec/buffer.md +144 -0
- package/docs/api/io/codec/cbor.md +179 -0
- package/docs/api/io/codec/csv.md +178 -0
- package/docs/api/io/codec/hex.md +75 -0
- package/docs/api/io/codec/mime.md +156 -0
- package/docs/api/io/codec/msgpack.md +142 -0
- package/docs/api/io/codec/url.md +265 -0
- package/docs/api/io/codec/utf8.md +84 -0
- package/docs/api/io/codec/xml.md +87 -0
- package/docs/api/io/compress/README.md +62 -0
- package/docs/api/io/compress/bitstream.md +131 -0
- package/docs/api/io/compress/brotli.md +232 -0
- package/docs/api/io/compress/brotli_dict.md +119 -0
- package/docs/api/io/compress/brotli_dict_words.md +142 -0
- package/docs/api/io/compress/brotli_frame.md +214 -0
- package/docs/api/io/compress/brotli_shared.md +144 -0
- package/docs/api/io/compress/deflate.md +474 -0
- package/docs/api/io/compress/gzip.md +130 -0
- package/docs/api/io/compress/huffman.md +210 -0
- package/docs/api/io/compress/lz4.md +278 -0
- package/docs/api/io/compress/lz77.md +180 -0
- package/docs/api/io/compress/lzw.md +121 -0
- package/docs/api/io/compress/zip.md +209 -0
- package/docs/api/io/compress/zlib.md +125 -0
- package/docs/api/io/i18n/README.md +23 -0
- package/docs/api/io/i18n/i18n.md +128 -0
- package/docs/api/io/math/README.md +24 -0
- package/docs/api/io/math/fixed-point.md +115 -0
- package/docs/api/io/math/geom.md +144 -0
- package/docs/api/io/math/interp.md +115 -0
- package/docs/api/io/math/linalg.md +138 -0
- package/docs/api/io/math/stats.md +109 -0
- package/docs/api/io/structures/README.md +31 -0
- package/docs/api/io/structures/btree.md +155 -0
- package/docs/api/io/structures/heap.md +166 -0
- package/docs/api/io/structures/lruCache.md +156 -0
- package/docs/api/io/structures/ringBuffer.md +188 -0
- package/docs/api/io/structures/tree-walker.md +132 -0
- package/docs/api/io/structures/trie.md +138 -0
- package/docs/api/io/sync/README.md +29 -0
- package/docs/api/io/sync/abort.md +129 -0
- package/docs/api/io/sync/atomics.md +159 -0
- package/docs/api/io/sync/cancellable.md +176 -0
- package/docs/api/io/sync/channel.md +125 -0
- package/docs/api/io/sync/mutex.md +93 -0
- package/docs/api/io/sync/semaphore.md +106 -0
- package/docs/api/io/sync/tokenBucket.md +139 -0
- package/docs/api/io/text/README.md +23 -0
- package/docs/api/io/text/ansi.md +182 -0
- package/docs/api/io/text/html-entities.md +79 -0
- package/docs/api/io/text/semver.md +158 -0
- package/docs/api/io/text/str.md +129 -0
- package/docs/api/io/text/unicode.md +89 -0
- package/docs/api/io/time/README.md +22 -0
- package/docs/api/io/time/date.md +128 -0
- package/docs/api/io/timing/README.md +32 -0
- package/docs/api/io/timing/clock.md +102 -0
- package/docs/api/io/timing/rateLimit.md +137 -0
- package/docs/api/io/timing/scheduler.md +163 -0
- package/docs/api/io/utils/README.md +30 -0
- package/docs/api/io/utils/bitmap.md +96 -0
- package/docs/api/io/utils/errors.md +165 -0
- package/docs/api/io/utils/eventBus.md +162 -0
- package/docs/api/io/utils/queue.md +141 -0
- package/docs/api/io/utils/signal.md +388 -0
- package/docs/api/io/utils/ui8.md +111 -0
- package/docs/api/io/utils/valid.md +272 -0
- package/docs/api/process/README.md +18 -0
- package/docs/api/process/message.md +166 -0
- package/docs/api/process/rpc.md +161 -0
- package/docs/api/process/workerPool.md +130 -0
- package/docs/api/sanity/base.md +132 -0
- package/docs/api/sanity/community.md +96 -0
- package/docs/api/sanity/lockdown.md +128 -0
- package/docs/api/typed.md +85 -0
- package/docs/dev/README.md +25 -0
- package/docs/dev/provenance.md +80 -0
- package/docs/dev/publishing.md +31 -0
- package/docs/dev/runtime.md +64 -0
- package/docs/dev/testing.md +61 -0
- package/docs/dev/types.md +35 -0
- package/docs/evidence/pqc-hybrid-evidence.md +438 -0
- package/docs/guide/README.md +38 -0
- package/docs/guide/_QUICK_REF.md +341 -0
- package/docs/guide/by-use-case.md +160 -0
- package/docs/guide/doc-format.md +306 -0
- package/docs/guide/gesture-dnd-side-channel.md +119 -0
- package/docs/guide/getting-started.md +134 -0
- package/docs/guide/hmr.md +187 -0
- package/docs/guide/integration-bundlers.md +193 -0
- package/docs/guide/integrations-hmr.md +103 -0
- package/docs/guide/module-creation-workflow.md +342 -0
- package/docs/guide/module-pattern.md +244 -0
- package/docs/guide/rendering-pipeline.md +422 -0
- package/docs/guide/security.md +346 -0
- package/docs/guide/test-format.md +190 -0
- package/docs/guide/tutorial-todo.md +298 -0
- package/docs/guide/typescript.md +215 -0
- package/docs/guide/worker-confinement.md +301 -0
- package/docs/guide/workers.md +168 -0
- package/docs/notes/lz77-deflate-factorization.md +96 -0
- package/docs/notes/worker-confinement-spike.md +302 -0
- package/docs/tools/README.md +56 -0
- package/docs/tools/aot.md +108 -0
- package/docs/tools/audit.md +61 -0
- package/docs/tools/bundler.md +215 -0
- package/docs/tools/codegen.md +64 -0
- package/docs/tools/jsx.md +236 -0
- package/docs/tools/precompilation.md +88 -0
- package/docs/tools/standalone.md +107 -0
- package/fw.config.json +129 -0
- package/integrations/README.md +52 -0
- package/integrations/_shared/catalog.generated.json +207 -0
- package/integrations/_shared/config-resolve.js +201 -0
- package/integrations/_shared/core.js +362 -0
- package/integrations/astro/README.md +96 -0
- package/integrations/astro/index.d.ts +42 -0
- package/integrations/astro/index.js +94 -0
- package/integrations/bun/README.md +62 -0
- package/integrations/bun/index.d.ts +30 -0
- package/integrations/bun/index.js +134 -0
- package/integrations/deno/README.md +55 -0
- package/integrations/deno/deno.json +10 -0
- package/integrations/esbuild/README.md +75 -0
- package/integrations/esbuild/backend.js +147 -0
- package/integrations/esbuild/index.d.ts +32 -0
- package/integrations/esbuild/index.js +147 -0
- package/integrations/eslint/README.md +27 -0
- package/integrations/eslint/no-factory-capture.js +99 -0
- package/integrations/jest/README.md +45 -0
- package/integrations/jest/bun-test-shim.js +43 -0
- package/integrations/nestjs/README.md +68 -0
- package/integrations/nestjs/index.d.ts +38 -0
- package/integrations/nestjs/index.js +99 -0
- package/integrations/nextjs/README.md +149 -0
- package/integrations/nextjs/index.d.ts +30 -0
- package/integrations/nextjs/index.js +98 -0
- package/integrations/nodejs/README.md +46 -0
- package/integrations/nodejs/package.node.example.json +31 -0
- package/integrations/rollup/README.md +65 -0
- package/integrations/rollup/backend.js +132 -0
- package/integrations/rollup/index.d.ts +32 -0
- package/integrations/rollup/index.js +84 -0
- package/integrations/turbopack/README.md +56 -0
- package/integrations/turbopack/index.d.ts +47 -0
- package/integrations/turbopack/index.js +164 -0
- package/integrations/typedoc/README.md +57 -0
- package/integrations/typedoc/categorize.js +121 -0
- package/integrations/typedoc/tsconfig.typedoc.json +14 -0
- package/integrations/typedoc/typedoc.json +19 -0
- package/integrations/vite/README.md +115 -0
- package/integrations/vite/index.d.ts +29 -0
- package/integrations/vite/index.js +182 -0
- package/integrations/vite/package.json +8 -0
- package/integrations/vite/vite-env.d.ts +36 -0
- package/integrations/vitest/README.md +77 -0
- package/integrations/vitest/bun-test-shim.js +92 -0
- package/integrations/vitest/vitest.config.js +41 -0
- package/integrations/webpack/README.md +53 -0
- package/integrations/webpack/index.d.ts +29 -0
- package/integrations/webpack/index.js +182 -0
- package/package.json +303 -0
- package/src/core/logger.js +373 -0
- package/src/core/modules.js +289 -0
- package/src/core/readyState.js +119 -0
- package/src/core/runtime.js +929 -0
- package/src/core/worker-helper.js +261 -0
- package/src/crypto/NIST_CONFORMANCE.md +249 -0
- package/src/crypto/cipher/aes.acvp.md +74 -0
- package/src/crypto/cipher/aes.js +512 -0
- package/src/crypto/cipher/chacha20.acvp.md +117 -0
- package/src/crypto/cipher/chacha20.js +147 -0
- package/src/crypto/hash/adf.acvp.md +144 -0
- package/src/crypto/hash/adf.js +127 -0
- package/src/crypto/hash/argon2.acvp.md +144 -0
- package/src/crypto/hash/argon2.js +517 -0
- package/src/crypto/hash/blake2b.acvp.md +122 -0
- package/src/crypto/hash/blake2b.js +367 -0
- package/src/crypto/hash/hkdf.acvp.md +128 -0
- package/src/crypto/hash/hkdf.js +145 -0
- package/src/crypto/hash/hmac.acvp.md +110 -0
- package/src/crypto/hash/hmac.js +177 -0
- package/src/crypto/hash/pbkdf2.acvp.md +122 -0
- package/src/crypto/hash/pbkdf2.js +120 -0
- package/src/crypto/hash/poly1305.acvp.md +111 -0
- package/src/crypto/hash/poly1305.js +126 -0
- package/src/crypto/hash/sha224.acvp.md +81 -0
- package/src/crypto/hash/sha224.js +60 -0
- package/src/crypto/hash/sha256.acvp.md +75 -0
- package/src/crypto/hash/sha256.js +217 -0
- package/src/crypto/hash/sha3.acvp.md +133 -0
- package/src/crypto/hash/sha3.js +391 -0
- package/src/crypto/hash/sha384.acvp.md +82 -0
- package/src/crypto/hash/sha384.js +61 -0
- package/src/crypto/hash/sha512.acvp.md +84 -0
- package/src/crypto/hash/sha512.js +314 -0
- package/src/crypto/hash/sha512_224.acvp.md +90 -0
- package/src/crypto/hash/sha512_224.js +66 -0
- package/src/crypto/hash/sha512_256.acvp.md +96 -0
- package/src/crypto/hash/sha512_256.js +75 -0
- package/src/crypto/mode/cbc.acvp.md +105 -0
- package/src/crypto/mode/cbc.js +136 -0
- package/src/crypto/mode/chacha20poly1305.acvp.md +116 -0
- package/src/crypto/mode/chacha20poly1305.js +190 -0
- package/src/crypto/mode/cmac.acvp.md +106 -0
- package/src/crypto/mode/cmac.js +172 -0
- package/src/crypto/mode/ctr.acvp.md +110 -0
- package/src/crypto/mode/ctr.js +174 -0
- package/src/crypto/mode/gcm.acvp.md +129 -0
- package/src/crypto/mode/gcm.js +333 -0
- package/src/crypto/mode/kw.acvp.md +145 -0
- package/src/crypto/mode/kw.js +323 -0
- package/src/crypto/pkc/ecc.acvp.md +181 -0
- package/src/crypto/pkc/ecc.js +941 -0
- package/src/crypto/pkc/ed25519.acvp.md +172 -0
- package/src/crypto/pkc/ed25519.js +582 -0
- package/src/crypto/pkc/hybrid-kat.provenance.md +89 -0
- package/src/crypto/pkc/hybridKem.js +255 -0
- package/src/crypto/pkc/hybridSign.js +437 -0
- package/src/crypto/pkc/ml_dsa.acvp.md +146 -0
- package/src/crypto/pkc/ml_dsa.js +984 -0
- package/src/crypto/pkc/ml_kem.acvp.md +117 -0
- package/src/crypto/pkc/ml_kem.js +596 -0
- package/src/crypto/pkc/rsa.acvp.md +187 -0
- package/src/crypto/pkc/rsa.js +470 -0
- package/src/crypto/pkc/slh_dsa.acvp.md +155 -0
- package/src/crypto/pkc/slh_dsa.js +820 -0
- package/src/crypto/pkc/x25519.acvp.md +113 -0
- package/src/crypto/pkc/x25519.js +290 -0
- package/src/crypto/utils/aes_ctr.acvp.md +67 -0
- package/src/crypto/utils/aes_ctr.js +134 -0
- package/src/crypto/utils/aes_modes.acvp.md +66 -0
- package/src/crypto/utils/aes_modes.js +241 -0
- package/src/crypto/utils/asn1-oid.js +369 -0
- package/src/crypto/utils/asn1.js +343 -0
- package/src/crypto/utils/bitArray.js +312 -0
- package/src/crypto/utils/bn.js +825 -0
- package/src/crypto/utils/jws.js +222 -0
- package/src/crypto/utils/keyformat.js +303 -0
- package/src/crypto/utils/pad.js +198 -0
- package/src/crypto/utils/pem.js +90 -0
- package/src/crypto/utils/random.acvp.md +167 -0
- package/src/crypto/utils/random.js +846 -0
- package/src/crypto/utils/rsaKeygen.acvp.md +158 -0
- package/src/crypto/utils/rsaKeygen.js +448 -0
- package/src/crypto/utils/totp.js +409 -0
- package/src/crypto/utils/uuid.acvp.md +137 -0
- package/src/crypto/utils/uuid.js +176 -0
- package/src/crypto/wasm/aes.js +494 -0
- package/src/crypto/wasm/argon2.js +236 -0
- package/src/crypto/wasm/blake2b.js +213 -0
- package/src/crypto/wasm/chacha20poly1305.js +238 -0
- package/src/crypto/wasm/cmac.js +207 -0
- package/src/crypto/wasm/ecc.js +437 -0
- package/src/crypto/wasm/ed25519.js +307 -0
- package/src/crypto/wasm/hkdf.js +183 -0
- package/src/crypto/wasm/hmac.js +215 -0
- package/src/crypto/wasm/ml_dsa.js +375 -0
- package/src/crypto/wasm/ml_kem.js +313 -0
- package/src/crypto/wasm/pbkdf2.js +205 -0
- package/src/crypto/wasm/rsa.js +674 -0
- package/src/crypto/wasm/runtime.js +400 -0
- package/src/crypto/wasm/sha2.js +183 -0
- package/src/crypto/wasm/sha3.js +221 -0
- package/src/crypto/wasm/slh_dsa.js +397 -0
- package/src/crypto/wasm/x25519.js +241 -0
- package/src/crypto/webcrypto/aes.js +370 -0
- package/src/crypto/webcrypto/aeskw.js +185 -0
- package/src/crypto/webcrypto/digest.js +136 -0
- package/src/crypto/webcrypto/ecc.js +371 -0
- package/src/crypto/webcrypto/ed25519.js +248 -0
- package/src/crypto/webcrypto/hkdf.js +132 -0
- package/src/crypto/webcrypto/hmac.js +213 -0
- package/src/crypto/webcrypto/pbkdf2.js +146 -0
- package/src/crypto/webcrypto/rsa.js +415 -0
- package/src/crypto/webcrypto/x25519.js +250 -0
- package/src/dom/display/animate.js +154 -0
- package/src/dom/display/fullscreen.js +305 -0
- package/src/dom/fs/download.js +118 -0
- package/src/dom/fs/fsAccess.js +307 -0
- package/src/dom/fs/indexedDB.js +465 -0
- package/src/dom/fs/remoteStore.js +484 -0
- package/src/dom/fs/storage.js +440 -0
- package/src/dom/lifecycle/idle.js +133 -0
- package/src/dom/lifecycle/visibility.js +140 -0
- package/src/dom/lifecycle/wakeLock.js +187 -0
- package/src/dom/net/ajax.js +303 -0
- package/src/dom/net/broadcastChannel.js +89 -0
- package/src/dom/net/network.js +260 -0
- package/src/dom/net/sse.js +295 -0
- package/src/dom/net/webrtc.js +381 -0
- package/src/dom/net/ws.js +290 -0
- package/src/dom/query/dnd.js +409 -0
- package/src/dom/query/dom.js +831 -0
- package/src/dom/query/events.js +425 -0
- package/src/dom/query/gesture.js +396 -0
- package/src/dom/query/media.js +616 -0
- package/src/dom/rendering/chart.js +663 -0
- package/src/dom/rendering/component.js +469 -0
- package/src/dom/rendering/devtools-ui.js +399 -0
- package/src/dom/rendering/devtools.js +352 -0
- package/src/dom/rendering/parser.js +1055 -0
- package/src/dom/rendering/reactiveBind.js +341 -0
- package/src/dom/rendering/render.js +601 -0
- package/src/dom/rendering/sanitize.js +364 -0
- package/src/dom/rendering/secPolicy.js +281 -0
- package/src/dom/rendering/template.js +1031 -0
- package/src/dom/rendering/themeTokens.js +522 -0
- package/src/dom/rendering/uiSession-core.js +597 -0
- package/src/dom/rendering/uiSession-direct.js +251 -0
- package/src/dom/rendering/uiSession-list.js +751 -0
- package/src/dom/rendering/uiSession.js +145 -0
- package/src/dom/rendering/virtualScroll.js +341 -0
- package/src/dom/sensors/battery.js +153 -0
- package/src/dom/sensors/geolocation.js +156 -0
- package/src/dom/sensors/networkInfo.js +136 -0
- package/src/dom/sensors/sensors.js +340 -0
- package/src/dom/sw/backgroundSync.js +113 -0
- package/src/dom/sw/cache.js +139 -0
- package/src/dom/sw/push.js +181 -0
- package/src/dom/sw/serviceWorker.js +193 -0
- package/src/dom/sw/sharedWorker.js +192 -0
- package/src/dom/utils/a11y.js +244 -0
- package/src/dom/utils/clipboard.js +113 -0
- package/src/dom/utils/entropyCollector.js +344 -0
- package/src/dom/utils/focus.js +421 -0
- package/src/dom/utils/form.js +535 -0
- package/src/dom/utils/formKit.js +427 -0
- package/src/dom/utils/keybindings.js +574 -0
- package/src/dom/utils/leaderElection.js +280 -0
- package/src/dom/utils/notifications.js +218 -0
- package/src/dom/utils/permissions.js +107 -0
- package/src/dom/utils/route.js +482 -0
- package/src/dom/utils/ua.js +109 -0
- package/src/dom/utils/webauthn.js +369 -0
- package/src/external/README.md +15 -0
- package/src/io/binary/reader.js +374 -0
- package/src/io/binary/writer.js +351 -0
- package/src/io/calc/adler32.js +94 -0
- package/src/io/calc/bigint.js +276 -0
- package/src/io/calc/crc32.js +111 -0
- package/src/io/calc/easing.js +514 -0
- package/src/io/codec/b64.js +235 -0
- package/src/io/codec/base32.js +147 -0
- package/src/io/codec/base58.js +167 -0
- package/src/io/codec/buffer.js +630 -0
- package/src/io/codec/cbor.js +550 -0
- package/src/io/codec/csv.js +299 -0
- package/src/io/codec/hex.js +129 -0
- package/src/io/codec/mime.js +398 -0
- package/src/io/codec/msgpack.js +491 -0
- package/src/io/codec/url.js +530 -0
- package/src/io/codec/utf8.js +181 -0
- package/src/io/codec/xml.js +428 -0
- package/src/io/compress/bitstream.js +199 -0
- package/src/io/compress/brotli.js +3073 -0
- package/src/io/compress/brotli_dict.bin +432 -0
- package/src/io/compress/brotli_dict.js +356 -0
- package/src/io/compress/brotli_dict_words.js +157 -0
- package/src/io/compress/brotli_frame.js +420 -0
- package/src/io/compress/brotli_shared.js +715 -0
- package/src/io/compress/deflate.js +1432 -0
- package/src/io/compress/gzip.js +406 -0
- package/src/io/compress/huffman.js +322 -0
- package/src/io/compress/lz4.js +451 -0
- package/src/io/compress/lz77.js +408 -0
- package/src/io/compress/lzw.js +332 -0
- package/src/io/compress/zip.js +815 -0
- package/src/io/compress/zlib.js +340 -0
- package/src/io/i18n/i18n.js +236 -0
- package/src/io/math/fixed-point.js +269 -0
- package/src/io/math/geom.js +350 -0
- package/src/io/math/interp.js +263 -0
- package/src/io/math/linalg.js +472 -0
- package/src/io/math/stats.js +339 -0
- package/src/io/structures/btree.js +357 -0
- package/src/io/structures/heap.js +249 -0
- package/src/io/structures/lruCache.js +219 -0
- package/src/io/structures/ringBuffer.js +208 -0
- package/src/io/structures/tree-walker.js +413 -0
- package/src/io/structures/trie.js +219 -0
- package/src/io/sync/abort.js +196 -0
- package/src/io/sync/atomics.js +342 -0
- package/src/io/sync/cancellable.js +279 -0
- package/src/io/sync/channel.js +301 -0
- package/src/io/sync/mutex.js +148 -0
- package/src/io/sync/semaphore.js +156 -0
- package/src/io/sync/tokenBucket.js +208 -0
- package/src/io/text/ansi.js +536 -0
- package/src/io/text/html-entities.js +143 -0
- package/src/io/text/semver.js +375 -0
- package/src/io/text/str.js +243 -0
- package/src/io/text/unicode.js +188 -0
- package/src/io/time/date.js +355 -0
- package/src/io/timing/clock.js +79 -0
- package/src/io/timing/rateLimit.js +264 -0
- package/src/io/timing/scheduler.js +351 -0
- package/src/io/utils/bitmap.js +94 -0
- package/src/io/utils/errors.js +269 -0
- package/src/io/utils/eventBus.js +315 -0
- package/src/io/utils/queue.js +223 -0
- package/src/io/utils/signal.js +858 -0
- package/src/io/utils/ui8.js +99 -0
- package/src/io/utils/valid.js +556 -0
- package/src/main.js +41 -0
- package/src/polyfill/README.md +9 -0
- package/src/process/message.js +257 -0
- package/src/process/rpc.js +286 -0
- package/src/process/workerPool.js +392 -0
- package/src/sanity/base.js +374 -0
- package/src/sanity/community.js +254 -0
- package/src/sanity/lockdown-apply.js +58 -0
- package/src/sanity/lockdown.js +408 -0
- package/src/sanity/wasm-gate.js +316 -0
- package/src/typed.js +53 -0
- package/third-party/NOTICE-penner-easing +88 -0
- package/third-party/NOTICE-sjcl +50 -0
- package/tools/_lib/cli-help.js +55 -0
- package/tools/rendering/aot/index.js +148 -0
- package/tools/rendering/aot/lib/dom-codegen.js +295 -0
- package/tools/rendering/jsx/index.js +654 -0
- package/tools/rendering/precompilation/index.js +368 -0
- package/types/registry.generated.d.ts +217 -0
- package/types/typed.d.ts +106 -0
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: entropyCollector
|
|
3
|
+
category: dom/utils
|
|
4
|
+
dependencies: ['sensors']
|
|
5
|
+
returns: function
|
|
6
|
+
worker-safe: false
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# entropyCollector
|
|
11
|
+
|
|
12
|
+
> Entropy collection from user interactions — mouse, keyboard, touch, accelerometer via `sensors`. Complement to `entropy` for high-security applications.
|
|
13
|
+
|
|
14
|
+
**Module** `entropyCollector` | **Source** `packages/front/fw/src/dom/utils/entropyCollector.js` | **Deps** `sensors` | **Worker-safe** no
|
|
15
|
+
|
|
16
|
+
## Resolve
|
|
17
|
+
|
|
18
|
+
```js
|
|
19
|
+
const entropyCollector = runtime.resolve('entropyCollector');
|
|
20
|
+
// Returns: function create(onEntropy, opts?) → EntropyCollector
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## API
|
|
24
|
+
|
|
25
|
+
### `entropyCollector(onEntropy, opts?) → EntropyCollector`
|
|
26
|
+
|
|
27
|
+
```js
|
|
28
|
+
const collector = entropyCollector(
|
|
29
|
+
(data, bits, source) => {
|
|
30
|
+
// data : number | number[] — collected value(s)
|
|
31
|
+
// bits : number — estimated entropy in bits
|
|
32
|
+
// source : string — source name ('mouse', 'keyboard', ...)
|
|
33
|
+
mixEntropy(data, bits);
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
target: window // EventTarget — default: window (see note below)
|
|
37
|
+
}
|
|
38
|
+
);
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
### Methods of `EntropyCollector`
|
|
44
|
+
|
|
45
|
+
#### `collector.start(event?) → Promise<{ motionGranted: boolean | null }>`
|
|
46
|
+
|
|
47
|
+
Starts collection. Without an argument, attaches all listeners immediately.
|
|
48
|
+
|
|
49
|
+
```js
|
|
50
|
+
// Simple start
|
|
51
|
+
const { motionGranted } = await collector.start();
|
|
52
|
+
|
|
53
|
+
// From a click handler (recommended on iOS)
|
|
54
|
+
btn.addEventListener('click', async (e) => {
|
|
55
|
+
const { motionGranted } = await collector.start(e);
|
|
56
|
+
// motionGranted : true/false on iOS 13+ (permission requested)
|
|
57
|
+
// null if no permission required
|
|
58
|
+
});
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
No-op if already active.
|
|
62
|
+
|
|
63
|
+
#### `collector.stop() → void`
|
|
64
|
+
|
|
65
|
+
Stops collection and detaches all listeners (DOM and motion). No-op if inactive.
|
|
66
|
+
|
|
67
|
+
#### `collector.requestMotionPermission() → Promise<boolean>`
|
|
68
|
+
|
|
69
|
+
Manually requests motion permission on iOS 13+ via `sensors.requestPermission()`.
|
|
70
|
+
|
|
71
|
+
```js
|
|
72
|
+
const granted = await collector.requestMotionPermission();
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Must be called from a user gesture handler (click, touchstart).
|
|
76
|
+
|
|
77
|
+
#### `collector.isActive → boolean`
|
|
78
|
+
|
|
79
|
+
Getter — `true` if collection is in progress.
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## Entropy sources
|
|
84
|
+
|
|
85
|
+
| Source | Event | Estimated bits | Details |
|
|
86
|
+
|--------|-----------|-------------|---------|
|
|
87
|
+
| Mouse | `mousemove` | 2 | `[clientX, clientY]` — throttled to 1/100 ms |
|
|
88
|
+
| Keyboard | `keydown` | 32* | Timing × crypto supplement |
|
|
89
|
+
| Touch | `touchmove` | 1 | `[clientX, clientY]` of first contact |
|
|
90
|
+
| Accelerometer | `sensors.motion` | 32* | Acceleration via `sensors.motion.watch()` + timing |
|
|
91
|
+
| Timing supplement | (per event) | 32* | XOR with `getRandomValues` |
|
|
92
|
+
|
|
93
|
+
*32 bits with `crypto.getRandomValues` available, ~3 bits otherwise.*
|
|
94
|
+
|
|
95
|
+
DOM listeners (`mousemove`, `keydown`, `touchmove`) are attached with `{ passive: true }` on the provided `target`.
|
|
96
|
+
Accelerometer data is collected via `sensors.motion.watch()` — always on `window` (constraint of the native API).
|
|
97
|
+
|
|
98
|
+
## Internal implementation
|
|
99
|
+
|
|
100
|
+
- A shared `Uint32Array(8)` buffer is allocated once at factory level.
|
|
101
|
+
- `getRandomValues` is called once for every 8 timing events — conserves calls.
|
|
102
|
+
- Timing values are XORed with crypto words to remain unpredictable even if `performance.now` is reduced in precision.
|
|
103
|
+
- Motion permission is delegated to `sensors.requestPermission()`, which covers motion **and** orientation in a single call.
|
|
104
|
+
|
|
105
|
+
## iOS 13+ motion permission
|
|
106
|
+
|
|
107
|
+
On iOS 13+, motion permission is handled by `sensors.requestPermission()`. Passing the native `Event` to `start()` automatically triggers the request:
|
|
108
|
+
|
|
109
|
+
```js
|
|
110
|
+
// Automatic — pass the click Event to start()
|
|
111
|
+
button.addEventListener('click', e => collector.start(e));
|
|
112
|
+
|
|
113
|
+
// Manual — request permission yourself, then start without event
|
|
114
|
+
button.addEventListener('click', async () => {
|
|
115
|
+
await collector.requestMotionPermission();
|
|
116
|
+
collector.start();
|
|
117
|
+
});
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
## Note — `target` and motion events
|
|
121
|
+
|
|
122
|
+
The `target` option only affects DOM listeners (`mousemove`, `keydown`, `touchmove`). Accelerometer data is collected via `sensors.motion.watch()`, which always attaches to `window` internally — aligned with the native constraint: `DeviceMotionEvent` is only delivered to `window`.
|
|
123
|
+
|
|
124
|
+
## Example — entropy accumulation before key generation
|
|
125
|
+
|
|
126
|
+
```js
|
|
127
|
+
const entropyCollector = runtime.resolve('entropyCollector');
|
|
128
|
+
const random = runtime.resolve('random');
|
|
129
|
+
|
|
130
|
+
let pool = [];
|
|
131
|
+
let collected = 0;
|
|
132
|
+
const TARGET_BITS = 256;
|
|
133
|
+
|
|
134
|
+
const collector = entropyCollector((data, bits, source) => {
|
|
135
|
+
const arr = Array.isArray(data) ? data : [data];
|
|
136
|
+
pool.push(...arr);
|
|
137
|
+
collected += bits;
|
|
138
|
+
|
|
139
|
+
if (collected >= TARGET_BITS) {
|
|
140
|
+
collector.stop();
|
|
141
|
+
generateKey();
|
|
142
|
+
}
|
|
143
|
+
});
|
|
144
|
+
|
|
145
|
+
// Start from a click (iOS requires a gesture)
|
|
146
|
+
document.querySelector('#generate').addEventListener('click', async (e) => {
|
|
147
|
+
const { motionGranted } = await collector.start(e);
|
|
148
|
+
if (!motionGranted) {
|
|
149
|
+
console.log('Accelerometer unavailable — other sources active');
|
|
150
|
+
}
|
|
151
|
+
showCollectionUI();
|
|
152
|
+
});
|
|
153
|
+
|
|
154
|
+
function generateKey() {
|
|
155
|
+
// Combine collected entropy with crypto
|
|
156
|
+
const keyBytes = random.bytes(32);
|
|
157
|
+
// Mix with pool to reinforce
|
|
158
|
+
for (let i = 0; i < pool.length && i < keyBytes.length; i++) {
|
|
159
|
+
keyBytes[i] ^= pool[i] & 0xFF;
|
|
160
|
+
}
|
|
161
|
+
return keyBytes;
|
|
162
|
+
}
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
## Notes
|
|
166
|
+
|
|
167
|
+
- On iOS 13+, motion permission is required from a gesture handler — which is why `start(event)` takes the optional event. Permission is delegated to `sensors.requestPermission()`.
|
|
168
|
+
- In the absence of accelerometer support (`sensors.motion.isSupported() === false`), the other sources (mouse, keyboard, touch) remain active.
|
|
169
|
+
- Refactored: replaces direct `devicemotion` listening and the internal `askMotionPermission` helper with `sensors.motion.watch()` and `sensors.requestPermission()`.
|
|
170
|
+
|
|
171
|
+
## See also
|
|
172
|
+
|
|
173
|
+
- [sensors](../sensors/sensors.md) — sensors module (motion, orientation, gyroscope, accelerometer)
|
|
174
|
+
- [random](../../crypto/utils/random.md) — direct cryptographic generator
|
|
175
|
+
- [uuid](../../crypto/utils/uuid.md) — random identifiers
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: focus
|
|
3
|
+
category: dom/utils
|
|
4
|
+
dependencies: [dom, events]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: false
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# focus
|
|
11
|
+
|
|
12
|
+
> Focus trap, tab order, stash/restore, and focus-change notification.
|
|
13
|
+
|
|
14
|
+
**Module** `focus` | **Source** `packages/front/fw/src/dom/utils/focus.js` | **Deps** `dom`, `events` | **Worker-safe** no
|
|
15
|
+
|
|
16
|
+
Focus manager for complex interfaces: Tab loop within a container (modal, dialog), visible non-inert tab-order calculation, keyboard next/previous navigation, active focus capture/restore, and focus-change subscription.
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const focus = runtime.resolve('focus');
|
|
22
|
+
// Returns: { trap, tabOrder, next, previous, stash, current, onChange }
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## API
|
|
26
|
+
|
|
27
|
+
| Method | Signature | Returns |
|
|
28
|
+
|---------|-----------|---------|
|
|
29
|
+
| `trap` | `(el: Element, opts?) => TrapCtrl` | Trap controller |
|
|
30
|
+
| `tabOrder` | `(container: Element) => HTMLElement[]` | Ordered focusable elements |
|
|
31
|
+
| `next` | `(container?: Element) => void` | Focus on the next element |
|
|
32
|
+
| `previous` | `(container?: Element) => void` | Focus on the previous element |
|
|
33
|
+
| `stash` | `() => { restore() }` | Capture + restore of active focus |
|
|
34
|
+
| `current` | `() => Element` | `document.activeElement` |
|
|
35
|
+
| `onChange` | `(fn: (newEl, oldEl) => void) => unsubscribe` | Subscribe to focus changes |
|
|
36
|
+
|
|
37
|
+
### `focus.trap(el, opts?)`
|
|
38
|
+
|
|
39
|
+
Creates a focus trap inside `el`. Returns `{ activate, deactivate, pause, resume, paused }`.
|
|
40
|
+
|
|
41
|
+
- On activation: focuses `opts.initialFocus` (element or CSS selector) or the first focusable element.
|
|
42
|
+
- `Tab` / `Shift+Tab` loops within `el` — captures `keydown` on the container.
|
|
43
|
+
- On deactivation: restores pre-activation focus if `returnFocus: true` (default).
|
|
44
|
+
- `escapeDeactivates: true` → `Escape` automatically calls `deactivate()`.
|
|
45
|
+
- `pause()` / `resume()` temporarily suspends the trap without destroying it.
|
|
46
|
+
|
|
47
|
+
#### Options `trap`
|
|
48
|
+
|
|
49
|
+
| Option | Type | Default | Description |
|
|
50
|
+
|--------|------|--------|-------------|
|
|
51
|
+
| `initialFocus` | `Element \| string` | first focusable | Focus target on activation |
|
|
52
|
+
| `returnFocus` | `boolean` | `true` | Restores pre-activation focus |
|
|
53
|
+
| `escapeDeactivates` | `boolean` | `false` | `Escape` deactivates the trap |
|
|
54
|
+
| `allowOutsideClick` | `boolean` | `false` | Reserved — future use |
|
|
55
|
+
|
|
56
|
+
### `focus.tabOrder(container)`
|
|
57
|
+
|
|
58
|
+
Returns focusable elements in logical order. Inclusion criteria:
|
|
59
|
+
- visible (`offsetParent !== null` or dimensions > 0),
|
|
60
|
+
- not `disabled`,
|
|
61
|
+
- no `inert` ancestor,
|
|
62
|
+
- `tabindex >= 0` or naturally focusable element (`a[href]`, `button`, `input:not([type=hidden])`, `select`, `textarea`, `[contenteditable]`, `[tabindex]`).
|
|
63
|
+
|
|
64
|
+
Order: positive tabindexes sorted ascending, then tabindex 0 / natural elements in DOM order.
|
|
65
|
+
|
|
66
|
+
### `focus.stash()`
|
|
67
|
+
|
|
68
|
+
Captures `document.activeElement` at the time of the call. Returns `{ restore() }`.
|
|
69
|
+
|
|
70
|
+
### `focus.onChange(fn)`
|
|
71
|
+
|
|
72
|
+
Subscribes `fn(newEl, oldEl)` to global `focusin` events. Returns `unsubscribe()`.
|
|
73
|
+
|
|
74
|
+
## Examples
|
|
75
|
+
|
|
76
|
+
### Modal with focus trap
|
|
77
|
+
|
|
78
|
+
```js
|
|
79
|
+
const focus = runtime.resolve('focus');
|
|
80
|
+
|
|
81
|
+
const modal = document.getElementById('my-modal');
|
|
82
|
+
const openBtn = document.getElementById('open-modal');
|
|
83
|
+
|
|
84
|
+
openBtn.addEventListener('click', () => {
|
|
85
|
+
modal.removeAttribute('hidden');
|
|
86
|
+
const trapCtrl = focus.trap(modal, {
|
|
87
|
+
returnFocus: true,
|
|
88
|
+
escapeDeactivates: true
|
|
89
|
+
});
|
|
90
|
+
trapCtrl.activate();
|
|
91
|
+
});
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
### Toolbar navigation (prev / next)
|
|
95
|
+
|
|
96
|
+
```js
|
|
97
|
+
const focus = runtime.resolve('focus');
|
|
98
|
+
const toolbar = document.querySelector('[role="toolbar"]');
|
|
99
|
+
|
|
100
|
+
document.addEventListener('keydown', e => {
|
|
101
|
+
if (e.key === 'ArrowRight') focus.next(toolbar);
|
|
102
|
+
if (e.key === 'ArrowLeft') focus.previous(toolbar);
|
|
103
|
+
});
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
### Stash/restore around a temporary action
|
|
107
|
+
|
|
108
|
+
```js
|
|
109
|
+
const focus = runtime.resolve('focus');
|
|
110
|
+
|
|
111
|
+
const saved = focus.stash();
|
|
112
|
+
// … opens a temporary picker, focus changed …
|
|
113
|
+
saved.restore();
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
### Focus-change notification
|
|
117
|
+
|
|
118
|
+
```js
|
|
119
|
+
const focus = runtime.resolve('focus');
|
|
120
|
+
|
|
121
|
+
const unsub = focus.onChange((newEl, oldEl) => {
|
|
122
|
+
console.log('focus:', oldEl, '→', newEl);
|
|
123
|
+
});
|
|
124
|
+
|
|
125
|
+
// Later:
|
|
126
|
+
unsub();
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
## Notes
|
|
130
|
+
|
|
131
|
+
- The trap listens for `keydown` on the container, not the global `focusin` — does not interfere with other apps.
|
|
132
|
+
- If a programmatic external focus leaves the trap, `focusin` automatically brings focus back to the first element in the container.
|
|
133
|
+
- `tabOrder` recalculates on every call — no cache. Use sparingly in tight loops.
|
|
134
|
+
- `worker-safe: false` — uses `document.activeElement`, `addEventListener`, `focus()`.
|
|
135
|
+
|
|
136
|
+
## See also
|
|
137
|
+
|
|
138
|
+
- [events](../query/events.md) — named event management
|
|
139
|
+
- [dom](../query/dom.md) — consistent DOM API
|
|
140
|
+
- [keybindings](./keybindings.md) — global keyboard shortcuts
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: form
|
|
3
|
+
category: dom/utils
|
|
4
|
+
dependencies: [dom, events]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: false
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# form
|
|
11
|
+
|
|
12
|
+
> Bidirectional input ↔ state binding + complete form state machine (values, dirty, touched, errors, submit).
|
|
13
|
+
|
|
14
|
+
**Module** `form` | **Source** `packages/front/fw/src/dom/utils/form.js` | **Deps** `dom`, `events` | **Worker-safe** no
|
|
15
|
+
|
|
16
|
+
## Resolve
|
|
17
|
+
|
|
18
|
+
```js
|
|
19
|
+
const form = runtime.resolve('form');
|
|
20
|
+
// → { bind, create }
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## API
|
|
24
|
+
|
|
25
|
+
| Method | Signature | Returns |
|
|
26
|
+
|---------|-----------|---------|
|
|
27
|
+
| `bind` | `(name, element, getter, setter, opts?) => { refresh, destroy }` | Bidirectional sync 1 input ↔ 1 source |
|
|
28
|
+
| `create` | `(spec) => FormController` | Complete form state machine (values, validation, submit) |
|
|
29
|
+
|
|
30
|
+
### API levels
|
|
31
|
+
|
|
32
|
+
| Level | API | Usage |
|
|
33
|
+
|---|---|---|
|
|
34
|
+
| Low-level | `form.bind(name, element, getter, setter, opts?)` | Sync 1 input ↔ 1 value source. A good building block for simple cases. |
|
|
35
|
+
| High-level | `form.create(spec)` | Complete form state machine. Values + validation + submit lifecycle. |
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
### `form.bind(name, element, getter, setter, opts?)`
|
|
40
|
+
|
|
41
|
+
Bidirectional sync between an input and an external source.
|
|
42
|
+
|
|
43
|
+
```js
|
|
44
|
+
let userInput = '';
|
|
45
|
+
const handle = form.bind('myInput', inputEl,
|
|
46
|
+
() => userInput,
|
|
47
|
+
(v) => { userInput = v; },
|
|
48
|
+
{ event: 'input' }
|
|
49
|
+
);
|
|
50
|
+
// `inputEl.value` initialised from `userInput`. Each keystroke → setter called.
|
|
51
|
+
|
|
52
|
+
handle.refresh(); // re-sync from getter
|
|
53
|
+
handle.destroy(); // removes the listener (idempotent)
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
| Option | Type | Description |
|
|
57
|
+
|---|---|---|
|
|
58
|
+
| `event` | `string` | DOM source event (`'input'` default, `'change'`, `'blur'`). |
|
|
59
|
+
| `checked` | `boolean` | If true, syncs `element.checked` (checkbox/radio) instead of `element.value`. |
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
### `form.create(spec)`
|
|
64
|
+
|
|
65
|
+
Creates a form state machine. Returns a `controller` with values, errors, touched, dirty, and a complete submit cycle.
|
|
66
|
+
|
|
67
|
+
```js
|
|
68
|
+
const f = form.create({
|
|
69
|
+
fields: {
|
|
70
|
+
email: { required: true, validate: (v) => /@/.test(v) ? null : 'Email invalide' },
|
|
71
|
+
password: { required: true, validate: (v) => v.length >= 8 ? null : '8 char min' },
|
|
72
|
+
remember: { type: 'boolean', default: false },
|
|
73
|
+
},
|
|
74
|
+
validate: (vals) => vals.email === vals.password ? { password: 'Trop simple' } : {},
|
|
75
|
+
onSubmit: async (vals) => {
|
|
76
|
+
await api.login(vals);
|
|
77
|
+
},
|
|
78
|
+
});
|
|
79
|
+
|
|
80
|
+
// Connect to DOM
|
|
81
|
+
f.attach('email', emailInput);
|
|
82
|
+
f.attach('password', passwordInput);
|
|
83
|
+
f.attach('remember', rememberCheckbox);
|
|
84
|
+
|
|
85
|
+
// Reactive state (subscribe to re-render)
|
|
86
|
+
f.subscribe(({ values, errors, touched, isValid, submitting }) => {
|
|
87
|
+
updateUI({ values, errors, touched, isValid, submitting });
|
|
88
|
+
});
|
|
89
|
+
|
|
90
|
+
// Submit
|
|
91
|
+
submitBtn.addEventListener('click', () => f.submit());
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
#### Spec
|
|
95
|
+
|
|
96
|
+
| Field | Type | Description |
|
|
97
|
+
|---|---|---|
|
|
98
|
+
| `fields` | `Object<name, FieldSpec>` | **Required.** Field descriptors. |
|
|
99
|
+
| `validate` | `(values) → {field: err}` | Optional. Cross-field validation. |
|
|
100
|
+
| `onSubmit` | `(values) → void\|Promise` | Optional. Submit handler, async-aware. |
|
|
101
|
+
|
|
102
|
+
**FieldSpec**:
|
|
103
|
+
|
|
104
|
+
| Field | Description |
|
|
105
|
+
|---|---|
|
|
106
|
+
| `default` | Initial value (otherwise `''` or `false` depending on `type`). |
|
|
107
|
+
| `type` | `'boolean'` for checkbox/radio, `'array'` for multi-value fields, otherwise `'string'` by default. |
|
|
108
|
+
| `required` | `true` to reject empty values; custom message via `requiredMessage`. |
|
|
109
|
+
| `validate(value, allValues)` | Returns `null` if OK, an error string otherwise. Can be **async** (returns `Promise<string\|null>`). |
|
|
110
|
+
| `itemValidate(value)` | For `type: 'array'` — per-item validator. |
|
|
111
|
+
|
|
112
|
+
#### Controller (instance)
|
|
113
|
+
|
|
114
|
+
| Member | Description |
|
|
115
|
+
|---|---|
|
|
116
|
+
| `f.values` | Snapshot `{name: value}`. |
|
|
117
|
+
| `f.errors` | Snapshot `{name: errorMsg}` (array of strings for `type: 'array'`). |
|
|
118
|
+
| `f.touched` / `f.dirty` | Boolean snapshots. |
|
|
119
|
+
| `f.validating` | Snapshot `{name: boolean}` — `true` during an in-flight async validation. |
|
|
120
|
+
| `f.isValid` | `false` if `errors` is non-empty **or** if a field is currently being validated async. |
|
|
121
|
+
| `f.submitting` | Boolean — true while `submit()` is in flight. |
|
|
122
|
+
| `f.get(name)` / `f.set(name, val)` | Programmatic read/write of a field. |
|
|
123
|
+
| `f.touch(name)` | Marks as touched (typical: on blur). |
|
|
124
|
+
| `f.attach(name, element, opts?)` | Connects a DOM input to the field. |
|
|
125
|
+
| `f.detach()` | Detaches all inputs (state preserved). |
|
|
126
|
+
| `f.validate()` | Re-validates everything. Returns `Promise<boolean>` (`isValid`). |
|
|
127
|
+
| `f.subscribe(fn)` | Subscribes to changes. Returns `unsubscribe()`. |
|
|
128
|
+
| `f.snapshot()` | Full snapshot `{values, errors, touched, dirty, isValid, submitting, validating}`. |
|
|
129
|
+
| `f.reset(overrides?)` | Reverts to defaults. Touched/dirty cleared. |
|
|
130
|
+
| `f.submit()` | Awaits async validations, then validate → run `onSubmit`. Returns `Promise<boolean>`. |
|
|
131
|
+
| `f.array(name)` | Returns an `ArrayField` controller for a `type: 'array'` field. |
|
|
132
|
+
|
|
133
|
+
#### `ArrayField` (`f.array(name)`)
|
|
134
|
+
|
|
135
|
+
| Member | Description |
|
|
136
|
+
|---|---|
|
|
137
|
+
| `arr.push(value)` | Appends an item. |
|
|
138
|
+
| `arr.remove(index)` | Removes the item at `index`. |
|
|
139
|
+
| `arr.move(from, to)` | Moves the item. |
|
|
140
|
+
| `arr.length` | Current item count. |
|
|
141
|
+
|
|
142
|
+
`snapshot()` deep-clones array values to prevent accidental mutations.
|
|
143
|
+
|
|
144
|
+
### Submit semantics
|
|
145
|
+
|
|
146
|
+
1. Marks all fields as `touched` (to make errors visible).
|
|
147
|
+
2. Re-validates everything (`validateAll()`).
|
|
148
|
+
3. If `isValid === false` → returns `false`. `onSubmit` is not called.
|
|
149
|
+
4. Otherwise: `submitting = true`, calls `await onSubmit(values)`.
|
|
150
|
+
5. `submitting = false` (`finally`, even if `onSubmit` rejects).
|
|
151
|
+
6. Returns `true`.
|
|
152
|
+
|
|
153
|
+
## Examples
|
|
154
|
+
|
|
155
|
+
### Complete with uiSession
|
|
156
|
+
|
|
157
|
+
```js
|
|
158
|
+
const ui = runtime.resolve('uiSession')('app');
|
|
159
|
+
const form = runtime.resolve('form');
|
|
160
|
+
|
|
161
|
+
ui.add([{ id: 'loginForm', block: loginTpl, data: {} }]);
|
|
162
|
+
|
|
163
|
+
const f = form.create({
|
|
164
|
+
fields: {
|
|
165
|
+
username: { required: true, requiredMessage: 'Nom utilisateur requis' },
|
|
166
|
+
password: { required: true, validate: (v) => v.length >= 8 ? null : '≥ 8 chars' },
|
|
167
|
+
},
|
|
168
|
+
onSubmit: async (vals) => { await api.login(vals); },
|
|
169
|
+
});
|
|
170
|
+
|
|
171
|
+
f.attach('username', ui.get('loginForm', 'usernameInput'));
|
|
172
|
+
f.attach('password', ui.get('loginForm', 'passwordInput'));
|
|
173
|
+
|
|
174
|
+
f.subscribe(({ errors, touched, isValid, submitting }) => {
|
|
175
|
+
for (const field of ['username', 'password']) {
|
|
176
|
+
const showErr = touched[field] && errors[field];
|
|
177
|
+
ui.text('loginForm', `${field}Err`, showErr || '');
|
|
178
|
+
}
|
|
179
|
+
ui.attr('loginForm', 'submitBtn', 'disabled', !isValid || submitting ? '' : null);
|
|
180
|
+
});
|
|
181
|
+
|
|
182
|
+
ui.on('loginForm', 'submitBtn', 'click', () => f.submit());
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
## Notes
|
|
186
|
+
|
|
187
|
+
- **No fine-grained reactivity**: `subscribe` re-fires on every mutation. For very large forms, accumulate changes via `requestAnimationFrame` on the consumer side.
|
|
188
|
+
- **Async validation**: `validate(v)` may return a `Promise`. `f.validating[name]` is `true` while waiting. `isValid` returns `false` during any in-flight validation (conservative). `submit()` waits for all async validations to resolve before invoking `onSubmit`.
|
|
189
|
+
- **`f.snapshot()` deep-clones arrays** — mutating returned values has no effect on internal state.
|
|
190
|
+
- **`type: 'boolean'`** and **`type: 'array'`** are the only automatic discriminations; for `number`, `date`, etc., the consumer converts in `validate` or before `set()`.
|
|
191
|
+
|
|
192
|
+
## See also
|
|
193
|
+
|
|
194
|
+
- [dom](../query/dom.md) — `val`/`valGet`/`checked`/`checkedGet` used internally.
|
|
195
|
+
- [events](../query/events.md) — managed listeners for `attach`.
|
|
196
|
+
- [component](../rendering/component.md) — combine form + component for reusable forms.
|
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: formKit
|
|
3
|
+
category: dom/utils
|
|
4
|
+
dependencies: [form, valid, reactiveBind, signal]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: false
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# formKit
|
|
11
|
+
|
|
12
|
+
> Thin ergonomic layer over `form` — RHF-style API with JSON-Schema resolver.
|
|
13
|
+
|
|
14
|
+
**Module** `formKit` | **Source** `packages/front/fw/src/dom/utils/formKit.js` | **Deps** `form`, `valid`, `reactiveBind`, `signal` | **Worker-safe** no
|
|
15
|
+
|
|
16
|
+
`formKit` is a **thin wrapper** around the existing [`form`](./form.md) module.
|
|
17
|
+
It does not reimplement form state, dirty/touched tracking, array handling,
|
|
18
|
+
async validation, or submit — those live entirely in `form`. What it adds is:
|
|
19
|
+
|
|
20
|
+
- A **JSON-Schema resolver** compiled once via [`valid.compile(schema)`](../../io/utils/valid.md).
|
|
21
|
+
- A declarative **`register(name)`** helper returning input props (value + event handlers)
|
|
22
|
+
without calling `form.attach` manually.
|
|
23
|
+
- A **`watch(name?)`** subscription backed by [`signal`](../../io/utils/signal.md) that fires
|
|
24
|
+
only for the requested field, or for any change when no name is given.
|
|
25
|
+
- A **`dispose()`** that tears down all subscriptions and DOM bindings in one call.
|
|
26
|
+
|
|
27
|
+
## Resolve
|
|
28
|
+
|
|
29
|
+
```js
|
|
30
|
+
const formKit = runtime.resolve('formKit');
|
|
31
|
+
// Returns: { create }
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## API
|
|
35
|
+
|
|
36
|
+
### `formKit.create(spec) → FormKitInstance`
|
|
37
|
+
|
|
38
|
+
| Parameter | Type | Description |
|
|
39
|
+
|------------------------|--------|----------------------------------------------------------|
|
|
40
|
+
| `spec.schema` | object | Optional JSON Schema; compiled via `valid.compile(schema)`. |
|
|
41
|
+
| `spec.defaultValues` | object | Initial field values keyed by field name. |
|
|
42
|
+
|
|
43
|
+
Returns a `FormKitInstance`.
|
|
44
|
+
|
|
45
|
+
### `FormKitInstance` methods
|
|
46
|
+
|
|
47
|
+
| Method | Signature | Returns |
|
|
48
|
+
|--------|-----------|---------|
|
|
49
|
+
| `register` | `(name: string) => FieldProps` | Props to spread on an `<input>` (value, onInput, onChange, name). |
|
|
50
|
+
| `watch` | `(name?: string) => WatchHandle` | Subscribe to one field or the whole form. |
|
|
51
|
+
| `reset` | `(values?: object) => void` | Reset to defaults or given values; clears manual errors. |
|
|
52
|
+
| `setValue` | `(name: string, value: *) => void` | Set one field value. |
|
|
53
|
+
| `getValues` | `(name?: string) => * \| object` | Read one field or all values. |
|
|
54
|
+
| `setError` | `(name: string, message: string) => void` | Set a manual error on a field. |
|
|
55
|
+
| `array` | `(name: string) => FormKitArrayAccessor` | RHF-style array-field accessor. |
|
|
56
|
+
| `submit` | `(onValid, onInvalid?) => Promise<void>` | Submit; calls `onValid(values)` or `onInvalid(errors)`. |
|
|
57
|
+
| `form` | `FormController` | Escape hatch: the underlying `form.create()` controller. |
|
|
58
|
+
| `dispose` | `() => void` | Detach all subscriptions and DOM bindings (idempotent). |
|
|
59
|
+
|
|
60
|
+
### `FieldProps` (returned by `register`)
|
|
61
|
+
|
|
62
|
+
| Property | Type | Description |
|
|
63
|
+
|------------|----------|-----------------------------------------------|
|
|
64
|
+
| `name` | string | The field name. |
|
|
65
|
+
| `value` | * | Live getter — current field value. |
|
|
66
|
+
| `onInput` | Function | Handler for the `input` event (text inputs). |
|
|
67
|
+
| `onChange` | Function | Handler for the `change` event (checkboxes). |
|
|
68
|
+
|
|
69
|
+
### `WatchHandle` (returned by `watch`)
|
|
70
|
+
|
|
71
|
+
| Property | Type | Description |
|
|
72
|
+
|---------------|----------|------------------------------------------------------|
|
|
73
|
+
| `value` | * | Current value (field snapshot or full values object).|
|
|
74
|
+
| `subscribe` | Function | Register an additional subscriber; returns unsubscribe.|
|
|
75
|
+
| `unsubscribe` | Function | Detach this watch subscription. |
|
|
76
|
+
|
|
77
|
+
### `FormKitArrayAccessor` (returned by `array`)
|
|
78
|
+
|
|
79
|
+
| Property/Method | Description |
|
|
80
|
+
|-----------------|----------------------------------------------------|
|
|
81
|
+
| `fields` | Defensive copy of the array (alias for `values`). |
|
|
82
|
+
| `values` | Defensive copy of the current array. |
|
|
83
|
+
| `length` | Current array length. |
|
|
84
|
+
| `push(item)` | Append an item; returns its index. |
|
|
85
|
+
| `remove(idx)` | Remove at index; `false` when out of range. |
|
|
86
|
+
| `move(from, to)`| Move item; `false` when out of range. |
|
|
87
|
+
| `set(idx, item)`| Replace at index; `false` when out of range. |
|
|
88
|
+
| `clear()` | Empty the array. |
|
|
89
|
+
| `get(idx)` | Read a single item by index. |
|
|
90
|
+
|
|
91
|
+
## Examples
|
|
92
|
+
|
|
93
|
+
### Register an input
|
|
94
|
+
|
|
95
|
+
```js
|
|
96
|
+
const formKit = runtime.resolve('formKit');
|
|
97
|
+
|
|
98
|
+
const fk = formKit.create({
|
|
99
|
+
schema: {
|
|
100
|
+
type: 'object',
|
|
101
|
+
required: ['email'],
|
|
102
|
+
properties: {
|
|
103
|
+
email: { type: 'string', minLength: 1 },
|
|
104
|
+
username: { type: 'string', minLength: 3 },
|
|
105
|
+
},
|
|
106
|
+
},
|
|
107
|
+
defaultValues: { email: '', username: '' },
|
|
108
|
+
});
|
|
109
|
+
|
|
110
|
+
// --- In a component render callback ---
|
|
111
|
+
|
|
112
|
+
// Spread onto your input element.
|
|
113
|
+
const emailProps = fk.register('email');
|
|
114
|
+
// emailProps = { name: 'email', value: '', onInput: fn, onChange: fn }
|
|
115
|
+
|
|
116
|
+
// Wire the real DOM element (optional — for full two-way DOM sync):
|
|
117
|
+
fk.form.attach('email', document.querySelector('#email'));
|
|
118
|
+
|
|
119
|
+
// Watch a single field for live validation feedback.
|
|
120
|
+
const emailWatch = fk.watch('email');
|
|
121
|
+
emailWatch.subscribe((v) => console.log('email changed to', v));
|
|
122
|
+
|
|
123
|
+
// Submit
|
|
124
|
+
await fk.submit(
|
|
125
|
+
(values) => { /* POST values to the server */ },
|
|
126
|
+
(errors) => { /* display errors[fieldName] */ },
|
|
127
|
+
);
|
|
128
|
+
|
|
129
|
+
// Cleanup on unmount.
|
|
130
|
+
fk.dispose();
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
### Array fields
|
|
134
|
+
|
|
135
|
+
```js
|
|
136
|
+
const fk = formKit.create({
|
|
137
|
+
schema: {
|
|
138
|
+
type: 'object',
|
|
139
|
+
properties: { tags: { type: 'array', items: { type: 'string' } } },
|
|
140
|
+
},
|
|
141
|
+
defaultValues: { tags: [] },
|
|
142
|
+
});
|
|
143
|
+
|
|
144
|
+
const arr = fk.array('tags');
|
|
145
|
+
arr.push('alpha');
|
|
146
|
+
arr.push('beta');
|
|
147
|
+
arr.move(0, 1); // ['beta', 'alpha']
|
|
148
|
+
arr.remove(1); // ['beta']
|
|
149
|
+
console.log(arr.length); // 1
|
|
150
|
+
console.log(arr.fields); // ['beta']
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
### Manual errors (e.g. from server responses)
|
|
154
|
+
|
|
155
|
+
```js
|
|
156
|
+
await fk.submit(async (values) => {
|
|
157
|
+
const resp = await fetch('/api/save', { method: 'POST', body: JSON.stringify(values) });
|
|
158
|
+
if (!resp.ok) {
|
|
159
|
+
const { field, message } = await resp.json();
|
|
160
|
+
fk.setError(field, message); // surfaces in fk.form.errors[field]
|
|
161
|
+
}
|
|
162
|
+
});
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
## Notes
|
|
166
|
+
|
|
167
|
+
- The resolver is `valid.compile(schema)` — no new validation engine. The same
|
|
168
|
+
JSON Schema dialect supported by [`valid`](../../io/utils/valid.md) applies
|
|
169
|
+
(type, required, properties, format, minLength, etc.).
|
|
170
|
+
- `watch` is subscription-based (explicit), not transparent — it does not auto-track
|
|
171
|
+
reads. Use `subscribe` on the returned handle to react to changes.
|
|
172
|
+
- `setError` persists until the field is changed (triggering re-validation) or
|
|
173
|
+
`reset()` is called.
|
|
174
|
+
- `dispose()` is idempotent; calling it multiple times is safe.
|
|
175
|
+
|
|
176
|
+
## See also
|
|
177
|
+
|
|
178
|
+
- [`form`](./form.md) — underlying form state machine (values, dirty, touched, errors, array, submit).
|
|
179
|
+
- [`valid`](../../io/utils/valid.md) — JSON-Schema validator; `valid.compile(schema)` is the resolver.
|
|
180
|
+
- [`reactiveBind`](../../dom/rendering/reactiveBind.md) — signal → DOM binding controller used internally.
|
|
181
|
+
- [`signal`](../../io/utils/signal.md) — reactive signals powering `watch`.
|