@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,111 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: wasmPbkdf2
|
|
3
|
+
category: crypto/wasm
|
|
4
|
+
dependencies: [wasmRuntime]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# wasmPbkdf2
|
|
11
|
+
|
|
12
|
+
> WASM PBKDF2-HMAC-SHA-{256|384|512} (RFC 8018 §5.2): async key derivation over `Uint8Array`, no-throw.
|
|
13
|
+
|
|
14
|
+
**Module** `wasmPbkdf2` | **Source** `packages/front/fw/src/crypto/wasm/pbkdf2.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
PBKDF2 is available in WebCrypto (`crypto.subtle.deriveBits`); this WASM tier is the **Tier-2 fallback** for non-secure-context environments (locked-down workers, `http://` pages) where `crypto.subtle` is absent. At large iteration counts (≥ 600 000) the C23 WASM inner loop also out-performs a pure-JS HMAC chain. For password hashing in new code, prefer [`wasmArgon2`](./argon2.md) (memory-hard, quantum-resistant). For general PBKDF2 in secure contexts, prefer [`webcrypto/pbkdf2`](../webcrypto/pbkdf2.md).
|
|
17
|
+
|
|
18
|
+
The `pbkdf2` target is **scalar-only** (`simd:false` in `targets.json` — PBKDF2's sequential HMAC compression loop has no SIMD parallelism). There is no `pbkdf2.simd.wasm`; `wasmPbkdf2` forces `{ variant: 'scalar' }` to avoid the runtime fetching a non-existent file.
|
|
19
|
+
|
|
20
|
+
## Resolve
|
|
21
|
+
|
|
22
|
+
```js
|
|
23
|
+
const wasmPbkdf2 = runtime.resolve('wasmPbkdf2');
|
|
24
|
+
// Returns: { isAvailable, deriveBits }
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## API
|
|
28
|
+
|
|
29
|
+
| Method | Signature | Returns |
|
|
30
|
+
|--------|-----------|---------|
|
|
31
|
+
| `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present (mirrors `wasmRuntime`) |
|
|
32
|
+
| `deriveBits` | `(password: Uint8Array, salt: Uint8Array, dkLen: number, iterations?: number, hash?: 256\|384\|512) => Promise<Uint8Array\|false>` | `dkLen`-byte derived key, or `false` on any failure |
|
|
33
|
+
|
|
34
|
+
### Parameter constraints
|
|
35
|
+
|
|
36
|
+
| Parameter | Default | Constraint |
|
|
37
|
+
|-----------|---------|-----------|
|
|
38
|
+
| `password` | — | `Uint8Array`; any byte length including `0` (empty password is valid per RFC 8018) |
|
|
39
|
+
| `salt` | — | `Uint8Array`; any byte length (≥ 16 bytes recommended by SP 800-132) |
|
|
40
|
+
| `dkLen` | — | Integer ≥ 1 (bytes) |
|
|
41
|
+
| `iterations` | `600000` | Integer ≥ 1 (OWASP 2023 default for PBKDF2-HMAC-SHA-256) |
|
|
42
|
+
| `hash` | `256` | One of `256` / `384` / `512` (selects HMAC-SHA-2 PRF) |
|
|
43
|
+
|
|
44
|
+
`deriveBits` resolves `false` (never rejects) when:
|
|
45
|
+
|
|
46
|
+
- a parameter is invalid: `password` or `salt` not a `Uint8Array`; `iterations < 1` or non-integer; `dkLen < 1` or non-integer; `hash ∉ {256, 384, 512}` — logged as `[crypto] INVALID: …`;
|
|
47
|
+
- the binary cannot load — `WebAssembly` unavailable, fetch/compile failure, or ABI mismatch — logged as `[crypto] FAIL: …` by `wasmRuntime.load`;
|
|
48
|
+
- the WASM call returns a non-zero status (`WC_EBADPARAM = -1`).
|
|
49
|
+
|
|
50
|
+
## Examples
|
|
51
|
+
|
|
52
|
+
### Basic key derivation (PBKDF2-HMAC-SHA-256)
|
|
53
|
+
|
|
54
|
+
```js
|
|
55
|
+
const wasmPbkdf2 = runtime.resolve('wasmPbkdf2');
|
|
56
|
+
|
|
57
|
+
const password = new TextEncoder().encode('my-passphrase');
|
|
58
|
+
const salt = crypto.getRandomValues(new Uint8Array(16));
|
|
59
|
+
const dk = await wasmPbkdf2.deriveBits(password, salt, 32);
|
|
60
|
+
// dk is a 32-byte Uint8Array, or false on failure.
|
|
61
|
+
if (dk === false) {
|
|
62
|
+
// WASM unavailable — fall back to webcrypto/pbkdf2 or hash/pbkdf2.
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### Explicit iteration count and PRF
|
|
67
|
+
|
|
68
|
+
```js
|
|
69
|
+
// 100 000 iterations, HMAC-SHA-512, 64-byte output.
|
|
70
|
+
const dk = await wasmPbkdf2.deriveBits(password, salt, 64, 100_000, 512);
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### RFC 7914 §11 published vector (c=1, SHA-256)
|
|
74
|
+
|
|
75
|
+
```js
|
|
76
|
+
const pw = new TextEncoder().encode('password');
|
|
77
|
+
const salt = new TextEncoder().encode('salt');
|
|
78
|
+
const dk = await wasmPbkdf2.deriveBits(pw, salt, 32, 1, 256);
|
|
79
|
+
// hex(dk) === '120fb6cffcf8b32c43e7225256c4f837a86548c92ccc35480805987cb70be17b'
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
## Worker Usage
|
|
83
|
+
|
|
84
|
+
```js
|
|
85
|
+
// wasmPbkdf2 is worker-safe: all constants are inside factory() and the
|
|
86
|
+
// binary is fetched by wasmRuntime's package loader via import.meta.url.
|
|
87
|
+
const worker = fw.createWorker(() => {
|
|
88
|
+
const wasmPbkdf2 = runtime.resolve('wasmPbkdf2');
|
|
89
|
+
self.onmessage = async ({ data }) => {
|
|
90
|
+
const { password, salt, dkLen } = data;
|
|
91
|
+
const dk = await wasmPbkdf2.deriveBits(password, salt, dkLen);
|
|
92
|
+
self.postMessage(dk);
|
|
93
|
+
};
|
|
94
|
+
});
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
## Notes
|
|
98
|
+
|
|
99
|
+
- **Default 600 000 iterations** (OWASP 2023 recommendation for PBKDF2-HMAC-SHA-256 password storage). SP 800-132 §5.3 sets the minimum at 1 000.
|
|
100
|
+
- **Scalar-only binary.** PBKDF2's inner loop is sequential HMAC passes — no block-level SIMD parallelism is possible. The scalar WASM binary is still faster than pure-JS at high iteration counts due to the compiled C23 HMAC inner loop.
|
|
101
|
+
- **Supports SHA-256, SHA-384, and SHA-512 PRFs.** SHA-1 and SHA-3 variants are out of scope for this binary (`hash ∉ {256, 384, 512}` → `false`).
|
|
102
|
+
- **Output is copied OUT** of WASM linear memory into a fresh `Uint8Array` (never a view aliasing reused WASM memory).
|
|
103
|
+
- **No-throw contract.** Every failure path resolves to `false` after a `console.error`; the promise never rejects.
|
|
104
|
+
- **Prefer `wasmArgon2` for new password hashing.** Argon2id (memory-hard) provides better resistance to brute-force and GPU attacks than PBKDF2 at equivalent wall-clock cost.
|
|
105
|
+
|
|
106
|
+
## See also
|
|
107
|
+
|
|
108
|
+
- [crypto/webcrypto/pbkdf2](../webcrypto/pbkdf2.md) — the primary WebCrypto PBKDF2 path (prefer in secure contexts)
|
|
109
|
+
- [crypto/hash/pbkdf2](../hash/pbkdf2.md) — the pure-JS PBKDF2 reference (universal default, no WASM)
|
|
110
|
+
- [crypto/wasm/argon2](./argon2.md) — memory-hard password hashing (recommended for new code)
|
|
111
|
+
- [crypto/wasm/runtime](./runtime.md) — the shared WASM loader adapter
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: wasmRsa
|
|
3
|
+
category: crypto/wasm
|
|
4
|
+
dependencies: [wasmRuntime]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# wasmRsa
|
|
11
|
+
|
|
12
|
+
> WASM RSA Tier-2 fallback: OAEP encrypt/decrypt, PSS & PKCS#1-v1.5 sign/verify, keygen. Async, `Uint8Array`, no-throw.
|
|
13
|
+
|
|
14
|
+
**Module** `wasmRsa` | **Source** `packages/front/fw/src/crypto/wasm/rsa.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
RSA over WASM, as an **opt-in Tier-2 fallback** for environments where `crypto.subtle` is unavailable (non-secure context, locked-down workers). In a secure context, prefer [`webcrypto/rsa`](../webcrypto/rsa.md) — the browser runs RSA in hardware-backed native code. This module loads the delivered [`@awacloud/fw-wasm-crypto`](https://www.npmjs.com/package/@awacloud/fw-wasm-crypto) `rsa` binary (vendored BearSSL i31 big-integer core + an EMSA-PSS padding layer) through [`wasmRuntime`](./runtime.md). The `rsa` target ships **scalar only**; the wrapper forces the scalar variant on load.
|
|
17
|
+
|
|
18
|
+
Three schemes are exposed: **RSA-OAEP** (`encrypt`/`decrypt`), **RSA-PSS** and **RSASSA-PKCS#1-v1.5** (`sign`/`verify`). Supported digests are SHA-256/384/512 (default 256); moduli are 2048/3072/4096 bits (default 2048); the public exponent is fixed at 65537. PKCS#1-v1.5 **encryption** is intentionally not exposed (insecure). PEM/DER conversion is out of scope (use the pure-JS asn1/`pem` modules).
|
|
19
|
+
|
|
20
|
+
## Key encoding
|
|
21
|
+
|
|
22
|
+
Keys cross the ABI as the **BearSSL big-integer wire format** — there is no DER parser in the delivered binary:
|
|
23
|
+
|
|
24
|
+
- **public key**: `u16be nLen | n | u16be eLen | e` (minimal big-endian)
|
|
25
|
+
- **private key**: `u32be nBitLen | u16be pLen | p | u16be qLen | q | u16be dpLen | dp | u16be dqLen | dq | u16be iqLen | iq` (CRT parameters; `iq = q⁻¹ mod p`)
|
|
26
|
+
|
|
27
|
+
`generateKey` returns this form; `encrypt`/`decrypt`/`sign`/`verify` consume it. The surface is self-consistent: a key pair from `generateKey` is directly usable by the other members.
|
|
28
|
+
|
|
29
|
+
## Resolve
|
|
30
|
+
|
|
31
|
+
```js
|
|
32
|
+
const wasmRsa = runtime.resolve('wasmRsa');
|
|
33
|
+
// Returns: { isAvailable, generateKey, encrypt, decrypt, sign, verify }
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## API
|
|
37
|
+
|
|
38
|
+
| Method | Signature | Returns |
|
|
39
|
+
|--------|-----------|---------|
|
|
40
|
+
| `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present (mirrors `wasmRuntime`) |
|
|
41
|
+
| `generateKey` | `(scheme: 'OAEP'\|'PSS'\|'PKCS1', modulusBits?: 2048\|3072\|4096, hash?: 256\|384\|512) => Promise<{publicKey: Uint8Array, privateKey: Uint8Array}\|false>` | A key pair (wire format), or `false` |
|
|
42
|
+
| `encrypt` | `(publicKey: Uint8Array, data: Uint8Array, label?: Uint8Array, hash?: 256\|384\|512) => Promise<Uint8Array\|false>` | RSA-OAEP ciphertext (`k` bytes), or `false` |
|
|
43
|
+
| `decrypt` | `(privateKey: Uint8Array, ct: Uint8Array, label?: Uint8Array, hash?: 256\|384\|512) => Promise<Uint8Array\|false>` | The recovered plaintext, or `false` |
|
|
44
|
+
| `sign` | `(privateKey: Uint8Array, data: Uint8Array, scheme: 'PSS'\|'PKCS1', hash?: 256\|384\|512) => Promise<Uint8Array\|false>` | The signature (`k` bytes), or `false` |
|
|
45
|
+
| `verify` | `(publicKey: Uint8Array, signature: Uint8Array, data: Uint8Array, scheme: 'PSS'\|'PKCS1', hash?: 256\|384\|512) => Promise<boolean>` | `true` iff the signature is valid |
|
|
46
|
+
|
|
47
|
+
`sign`/`verify` take the **raw message**: the wrapper digests it with `crypto.subtle` (SHA-256/384/512) before the WASM call. `encrypt` and PSS `sign` are **randomized** (OAEP seed / PSS salt drawn from `crypto.getRandomValues`), so repeated calls produce different outputs that all verify/decrypt correctly.
|
|
48
|
+
|
|
49
|
+
Members resolve `false` (never throw) when:
|
|
50
|
+
|
|
51
|
+
- `scheme`, `hash`, or `modulusBits` is outside the supported set (`[crypto] INVALID: …` logged);
|
|
52
|
+
- a key/ciphertext/signature/data argument has the wrong type or an obviously bad length;
|
|
53
|
+
- the binary cannot load — `WebAssembly` unavailable, fetch/compile failure, or ABI mismatch (`[crypto] FAIL: …` logged by `wasmRuntime.load`);
|
|
54
|
+
- the WASM call returns a non-zero status (bad padding, invalid signature, OAEP unpad failure).
|
|
55
|
+
|
|
56
|
+
`verify` additionally resolves `false` whenever the signature does not validate (tampered signature, tampered message, wrong scheme, wrong hash, or wrong key).
|
|
57
|
+
|
|
58
|
+
## Examples
|
|
59
|
+
|
|
60
|
+
### Generate a key pair, sign with PSS, verify
|
|
61
|
+
|
|
62
|
+
```js
|
|
63
|
+
const enc = new TextEncoder();
|
|
64
|
+
const kp = await wasmRsa.generateKey('PSS', 2048, 256);
|
|
65
|
+
if (kp === false) { /* WASM unavailable — fall back to pure-JS rsa */ }
|
|
66
|
+
|
|
67
|
+
const msg = enc.encode('hello rsa');
|
|
68
|
+
const sig = await wasmRsa.sign(kp.privateKey, msg, 'PSS', 256); // randomized salt
|
|
69
|
+
const ok = await wasmRsa.verify(kp.publicKey, sig, msg, 'PSS', 256); // → true
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### RSA-OAEP encrypt / decrypt
|
|
73
|
+
|
|
74
|
+
```js
|
|
75
|
+
const ct = await wasmRsa.encrypt(kp.publicKey, msg, undefined, 256); // k bytes
|
|
76
|
+
const pt = await wasmRsa.decrypt(kp.privateKey, ct, undefined, 256); // → msg
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
### Legacy PKCS#1-v1.5 signatures (interop only)
|
|
80
|
+
|
|
81
|
+
```js
|
|
82
|
+
// Emits "[crypto] DEPRECATED: … prefer PSS". Use only for interop with
|
|
83
|
+
// systems that mandate RSASSA-PKCS1-v1_5.
|
|
84
|
+
const sig = await wasmRsa.sign(kp.privateKey, msg, 'PKCS1', 256);
|
|
85
|
+
const ok = await wasmRsa.verify(kp.publicKey, sig, msg, 'PKCS1', 256);
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
### Tamper detection
|
|
89
|
+
|
|
90
|
+
```js
|
|
91
|
+
const bad = Uint8Array.from(sig);
|
|
92
|
+
bad[0] ^= 0xff;
|
|
93
|
+
await wasmRsa.verify(kp.publicKey, bad, msg, 'PSS', 256); // → false
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
## Notes
|
|
97
|
+
|
|
98
|
+
- **Prefer WebCrypto in secure contexts.** `crypto.subtle` runs RSA in hardware-backed native code; this WASM tier only wins where `crypto.subtle` is absent. Pure-JS [`rsa`](../pkc/rsa.md) remains the universal default.
|
|
99
|
+
- **Keys are BearSSL wire format, not DER.** See *Key encoding* above. The delivered ABI has no DER/PEM parser; conversion is a separate concern.
|
|
100
|
+
- **PKCS#1-v1.5 signatures are legacy.** `sign(... 'PKCS1' ...)` warns DEPRECATED; prefer PSS for new signatures. PKCS#1-v1.5 **encryption** is not exposed at all (insecure).
|
|
101
|
+
- **Randomized by design.** OAEP encryption and PSS signing draw fresh randomness per call from `crypto.getRandomValues`; outputs are non-deterministic but always verify/decrypt. PKCS#1-v1.5 signatures are deterministic.
|
|
102
|
+
- **NIST-anchored.** The test suite verifies a genuine NIST RSA-SigGen-FIPS186-5 PKCS#1-v1.5 signature byte-for-byte against the delivered binary, plus OAEP/PSS/PKCS1 round-trips on a fixed NIST DecryptionPrimitive key.
|
|
103
|
+
- **Scalar only.** The `rsa` target ships `rsa.scalar.wasm` (no SIMD build); the wrapper passes `{ variant: 'scalar' }` to `wasmRuntime.load`.
|
|
104
|
+
- **Output is copied OUT** of WASM linear memory into fresh `Uint8Array`s (never a view that could alias reused memory).
|
|
105
|
+
- **No-throw contract.** Every failure path resolves to `false` after a `console.error`; nothing rejects.
|
|
106
|
+
|
|
107
|
+
## See also
|
|
108
|
+
|
|
109
|
+
- [crypto/webcrypto/rsa](../webcrypto/rsa.md) — the hardware-backed WebCrypto RSA (preferred in secure contexts)
|
|
110
|
+
- [crypto/pkc/rsa](../pkc/rsa.md) — the pure-JS RSA reference (universal default)
|
|
111
|
+
- [crypto/wasm/ecc](./ecc.md) — WASM elliptic-curve signatures/ECDH, the other classical PKC accelerator
|
|
112
|
+
- [crypto/wasm/runtime](./runtime.md) — the shared WASM loader adapter
|
|
113
|
+
- [crypto/wasm README](./README.md) — the WASM primitive family overview
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: wasmRuntime
|
|
3
|
+
category: crypto/wasm
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# wasmRuntime
|
|
11
|
+
|
|
12
|
+
> Self-contained WASM loader: colocated-asset fetch, SIMD-selecting compile, linear-memory marshalling, the no-throw ABI handshake.
|
|
13
|
+
|
|
14
|
+
**Module** `wasmRuntime` | **Source** `packages/front/fw/src/crypto/wasm/runtime.js` | **Deps** none | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
The keystone every `crypto/wasm/*` wrapper loads its binary through. It is a **self-contained loader** over **colocated `.wasm` assets** committed next to the module (`<wasmModule>.{simd,scalar}.wasm`) — fetched by name exactly like [`io/compress/brotli_dict_words.js`](../../io/compress/brotli_dict_words.md) fetches `brotli_dict.bin`. fw has **no runtime dependency** on any other package: `wasmRuntime` owns the lazy async `WebAssembly.compile`, the runtime simd-vs-scalar variant selection, the zero-import invariant, the `memory`/`alloc`/`free` + `expectedExports` ABI assertions, the no-throw async contract, the linear-memory marshalling helpers, module metadata, and the security invariant.
|
|
17
|
+
|
|
18
|
+
WASM here is portable-**SIMD software** speed, **not** hardware crypto acceleration — there is no AES-NI / SHA-NI exposure. That is WebCrypto's domain (see [`../webcrypto/README.md`](../webcrypto/README.md)). The WASM tier accelerates the algorithms WebCrypto does not cover (SHA-3, BLAKE2b, ChaCha20-Poly1305, CMAC, Argon2, ML-KEM/ML-DSA/SLH-DSA) and serves as a Tier-2 fallback when `crypto.subtle` is absent.
|
|
19
|
+
|
|
20
|
+
## Resolve
|
|
21
|
+
|
|
22
|
+
```js
|
|
23
|
+
const wasmRuntime = runtime.resolve('wasmRuntime');
|
|
24
|
+
// Returns: { isAvailable, hasSimd, load, withBytes, readBytes, run }
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## API
|
|
28
|
+
|
|
29
|
+
| Method | Signature | Returns |
|
|
30
|
+
|--------|-----------|---------|
|
|
31
|
+
| `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present |
|
|
32
|
+
| `hasSimd` | `() => Promise<boolean>` | Whether the host validates a minimal simd128 module (memoized) |
|
|
33
|
+
| `load` | `(wasmModule: string, expectedExports?: string[], opts?: object) => Promise<Handle\|false>` | A handle or `false` — never rejects |
|
|
34
|
+
| `withBytes` | `(loaded: Handle, input: Uint8Array) => { ptr, len, free }` | Copies `input` INTO linear memory; returns ptr/len + a `free()` thunk |
|
|
35
|
+
| `readBytes` | `(loaded: Handle, ptr: number, len: number) => Uint8Array` | Copies `len` bytes OUT of linear memory into a fresh `Uint8Array` |
|
|
36
|
+
| `run` | `(loaded: Handle, fnName: string, args: number[]) => number` | Calls an export, returns its `i32` status; a trap throws to the caller's try/catch |
|
|
37
|
+
|
|
38
|
+
`load` options (`opts`): `variant` (`'simd' | 'scalar'`) forces a variant (default = runtime selection); `fetchBytes(wasmModule, variant) => Promise<Uint8Array>` is a documented **test seam** overriding the colocated fetch. The success handle exposes: `instance`, `memory` (and a `mem` alias), `alloc`, `free`, `exports`, and `variant`.
|
|
39
|
+
|
|
40
|
+
`load` resolves `false` when:
|
|
41
|
+
- `WebAssembly` is unavailable (`[crypto] NOT READY: WebAssembly unavailable` logged)
|
|
42
|
+
- the fetch/compile/instantiate fails, or the zero-import invariant or a `memory`/`alloc`/`free`/`expectedExports` entry is missing (`[crypto] FAIL: wasmRuntime.load: <message>` logged)
|
|
43
|
+
|
|
44
|
+
## Canonical WASM ABI
|
|
45
|
+
|
|
46
|
+
Every colocated `<wasmModule>.<variant>.wasm` is a freestanding wasm32 reactor with **zero imports** that MUST export the ABI triple:
|
|
47
|
+
|
|
48
|
+
- `memory` — exported `WebAssembly.Memory` (linear memory, bump-allocated).
|
|
49
|
+
- `alloc(size: i32) -> i32` — pointer into `memory`, or `0` on allocation failure.
|
|
50
|
+
- `free(ptr: i32) -> void` — release boundary (the shim's bump allocator may no-op; the export MUST still exist).
|
|
51
|
+
|
|
52
|
+
…plus the per-algorithm functions named in the caller's `expectedExports`. Algorithm functions operate on `(ptr, len)` pairs into `memory` and write results to caller-provided output pointers; they return an `i32` status (`0` = OK, non-zero = failure). `load` asserts the triple + `expectedExports` at load time, so ABI drift fails fast as a `load(...) === false`.
|
|
53
|
+
|
|
54
|
+
## Colocated assets & provenance
|
|
55
|
+
|
|
56
|
+
The binaries are **committed assets** next to this module:
|
|
57
|
+
`packages/front/fw/src/crypto/wasm/<wasmModule>.scalar.wasm` (always) and
|
|
58
|
+
`<wasmModule>.simd.wasm` (for the SIMD-capable targets: `sha3`, `blake2b`,
|
|
59
|
+
`chacha20poly1305`, `ml_kem`, `ml_dsa`). They are raw `.wasm` (not base64-embedded)
|
|
60
|
+
so the browser/worker cache can share the asset across page loads — the same
|
|
61
|
+
rationale as `brotli_dict.bin`.
|
|
62
|
+
|
|
63
|
+
`load` resolves `new URL('./<wasmModule>.<variant>.wasm', import.meta.url)` and
|
|
64
|
+
`fetch`es it. The **SIMD win** comes from `load` fetching `<wasmModule>.simd.wasm`
|
|
65
|
+
when `hasSimd()` is true; scalar-only targets (no `.simd.wasm` colocated) must be
|
|
66
|
+
loaded with `{ variant: 'scalar' }`. Wrappers always **load by name** — they never
|
|
67
|
+
import a binary directly.
|
|
68
|
+
|
|
69
|
+
### Variant matrix
|
|
70
|
+
|
|
71
|
+
| Targets | Colocated builds | How to call `load` |
|
|
72
|
+
|---|---|---|
|
|
73
|
+
| `blake2b`, `chacha20poly1305`, `ml_dsa`, `ml_kem`, `sha3` | `.scalar.wasm` + `.simd.wasm` | default — let the runtime select |
|
|
74
|
+
| `aes`, `argon2`, `cmac`, `ecc`, `ed25519`, `hkdf`, `hmac`, `pbkdf2`, `rsa`, `sha2`, `slh_dsa`, `x25519` | `.scalar.wasm` only | **must** pass `{ variant: 'scalar' }` |
|
|
75
|
+
|
|
76
|
+
Variant selection has **no fallback**. With no `variant` option it returns
|
|
77
|
+
`'simd'` whenever the host validates a simd128 module, and the colocated fetch
|
|
78
|
+
for a scalar-only target then fails — `load` resolves `false` per its no-throw
|
|
79
|
+
contract rather than retrying scalar. Passing `{ variant: 'scalar' }` is part of
|
|
80
|
+
a scalar-only wrapper's contract, not an optimisation.
|
|
81
|
+
|
|
82
|
+
### Asset resolution binds to this module's own URL
|
|
83
|
+
|
|
84
|
+
The colocated fetch is `new URL('./<wasmModule>.<variant>.wasm',
|
|
85
|
+
import.meta.url)` evaluated **inside `factory()`**, so the base is wherever
|
|
86
|
+
`runtime.js` itself was loaded from. A build step that inlines a descriptor by
|
|
87
|
+
stringifying its factory (`factory.toString()`) re-binds `import.meta.url` to
|
|
88
|
+
the *generated* file, and every wasm-tier path in that artifact then fails to
|
|
89
|
+
fetch its binary while a tier-audit surface may still report the tier as
|
|
90
|
+
effective. Ship `wasmRuntime` as a real module file, or supply
|
|
91
|
+
`opts.fetchBytes`, when a bundler re-hosts factory source.
|
|
92
|
+
|
|
93
|
+
**Provenance.** The bytes are build artifacts of the `@awacloud/fw-wasm-crypto` package
|
|
94
|
+
(`dist/<wasmModule>.{simd,scalar}.wasm`, emitted by `tools/wasm-crypto build`),
|
|
95
|
+
copied here as vendored source. To refresh: run `wasm-crypto build`
|
|
96
|
+
against `packages/front/fw-wasm-crypto`, then copy the produced `dist/*.wasm` next
|
|
97
|
+
to this module. The matching ABI (export names per target) is recorded in that
|
|
98
|
+
package's `targets.json`.
|
|
99
|
+
|
|
100
|
+
## Security invariant
|
|
101
|
+
|
|
102
|
+
`load` selects a binary by its **module name** — one of the colocated,
|
|
103
|
+
build-vendored binaries. There is **no** public API that accepts caller-supplied
|
|
104
|
+
bytes to compile or instantiate; such an overload would be an `eval`-class
|
|
105
|
+
injection vector. (`opts.fetchBytes` is a documented test seam, not a public
|
|
106
|
+
method.) A module instantiates only the bytes vendored at build time.
|
|
107
|
+
|
|
108
|
+
## Examples
|
|
109
|
+
|
|
110
|
+
### Load a module and round-trip bytes
|
|
111
|
+
|
|
112
|
+
```js
|
|
113
|
+
// expectedExports declares the algo functions this caller binds to.
|
|
114
|
+
const h = await wasmRuntime.load('sha3', ['sha3_256']);
|
|
115
|
+
if (h === false) {
|
|
116
|
+
// WebAssembly unavailable, fetch/compile failure, or ABI mismatch.
|
|
117
|
+
return false;
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
const buf = wasmRuntime.withBytes(h, message); // copy IN
|
|
121
|
+
try {
|
|
122
|
+
const outPtr = h.alloc(32);
|
|
123
|
+
const status = wasmRuntime.run(h, 'sha3_256', [buf.ptr, buf.len, outPtr]);
|
|
124
|
+
if (status !== 0) {
|
|
125
|
+
return false;
|
|
126
|
+
}
|
|
127
|
+
const digest = wasmRuntime.readBytes(h, outPtr, 32); // copy OUT (fresh array)
|
|
128
|
+
h.free(outPtr);
|
|
129
|
+
return digest;
|
|
130
|
+
} finally {
|
|
131
|
+
buf.free(); // always release the input buffer
|
|
132
|
+
}
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
### Feature detection
|
|
136
|
+
|
|
137
|
+
```js
|
|
138
|
+
if (!wasmRuntime.isAvailable()) {
|
|
139
|
+
// Fall back to the pure-JS or WebCrypto tier.
|
|
140
|
+
}
|
|
141
|
+
const fast = await wasmRuntime.hasSimd(); // true ⇒ load() picks the SIMD variant
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
### Worker usage
|
|
145
|
+
|
|
146
|
+
```js
|
|
147
|
+
const worker = fw.createWorker(
|
|
148
|
+
function ({ libs }) {
|
|
149
|
+
// The colocated .wasm is fetched by name (resolved from import.meta.url)
|
|
150
|
+
// inside the worker — no main-thread closure is serialized.
|
|
151
|
+
libs.wasmRuntime.load('blake2b', ['blake2b']).then((h) => {
|
|
152
|
+
self.postMessage(h !== false);
|
|
153
|
+
});
|
|
154
|
+
},
|
|
155
|
+
{ dependencies: ['wasmRuntime'] }
|
|
156
|
+
);
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
## Notes
|
|
160
|
+
|
|
161
|
+
- **No-throw contract**: `load` and `hasSimd` are `async` and resolve to a value or `false`; they never reject. `run` deliberately lets an export trap propagate so the calling wrapper's `try/catch` is the single no-throw boundary.
|
|
162
|
+
- **`readBytes` never aliases**: it copies out of linear memory into a fresh `Uint8Array`. WASM memory may be reused or grow (detaching the buffer) on the next call, so returning a view would be unsound.
|
|
163
|
+
- **`withBytes` ownership**: the caller MUST invoke the returned `free()` (typically in a `finally`). `withBytes` throws `TypeError` on a non-`Uint8Array` input.
|
|
164
|
+
- **Async compile only**: `load` uses `WebAssembly.compile` / `instantiate`; the synchronous `new WebAssembly.Module()` constructor (banned for bodies > 4 KB on the main thread) is never used.
|
|
165
|
+
- **Worker-safe**: pure factory; `WebAssembly` exists in Web Workers; binary bytes are fetched by name (resolved from `import.meta.url`), so `factory.toString()` carries no captured binding.
|
|
166
|
+
- **Software, not hardware**: portable SIMD speeds the software implementations; it exposes no CPU crypto instructions. For HW-backed AES/SHA/ECDSA prefer the WebCrypto tier when `crypto.subtle` is available.
|
|
167
|
+
|
|
168
|
+
## See also
|
|
169
|
+
|
|
170
|
+
- [crypto/wasm README](./README.md) — the WASM primitive family overview
|
|
171
|
+
- [crypto/webcrypto README](../webcrypto/README.md) — the HW-backed `crypto.subtle` tier
|
|
172
|
+
- [crypto README](../README.md) — all three crypto tiers (pure-JS, WebCrypto, WASM)
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: wasmSha2
|
|
3
|
+
category: crypto/wasm
|
|
4
|
+
dependencies: [wasmRuntime]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# wasmSha2
|
|
11
|
+
|
|
12
|
+
> WASM SHA-256/384/512 (FIPS 180-4) — Tier-2 fallback for non-secure contexts.
|
|
13
|
+
|
|
14
|
+
**Module** `wasmSha2` | **Source** `packages/front/fw/src/crypto/wasm/sha2.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
WASM-backed SHA-2 one-shot digests: SHA-256, SHA-384, SHA-512. This is the **Tier-2 fallback** for environments where `crypto.subtle` is unavailable (non-secure-context, locked-down workers). In secure contexts, prefer [`../webcrypto/digest.md`](../webcrypto/digest.md) which is hardware-accelerated. The pure-JS [`../hash/sha256.md`](../hash/sha256.md) / `sha384` / `sha512` modules remain the universal default.
|
|
17
|
+
|
|
18
|
+
The binary ships **scalar-only** (`sha2.scalar.wasm`; `simd: false` in targets.json — SHA-2 SIMD gain is marginal). The `{ variant: 'scalar' }` option is passed explicitly to `wasmRuntime.load` because the package's `selectVariant()` defaults to simd and has no automatic fallback.
|
|
19
|
+
|
|
20
|
+
## Resolve
|
|
21
|
+
|
|
22
|
+
```js
|
|
23
|
+
const wasmSha2 = runtime.resolve('wasmSha2');
|
|
24
|
+
// Returns: { isAvailable, sha256, sha384, sha512 }
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## API
|
|
28
|
+
|
|
29
|
+
| Method | Signature | Returns |
|
|
30
|
+
|--------|-----------|---------|
|
|
31
|
+
| `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present |
|
|
32
|
+
| `sha256` | `(data: Uint8Array) => Promise<Uint8Array\|false>` | 32-byte digest (FIPS 180-4 SHA-256) |
|
|
33
|
+
| `sha384` | `(data: Uint8Array) => Promise<Uint8Array\|false>` | 48-byte digest (FIPS 180-4 SHA-384) |
|
|
34
|
+
| `sha512` | `(data: Uint8Array) => Promise<Uint8Array\|false>` | 64-byte digest (FIPS 180-4 SHA-512) |
|
|
35
|
+
|
|
36
|
+
All digest methods resolve `false` when:
|
|
37
|
+
- `data` is not a `Uint8Array`
|
|
38
|
+
- `WebAssembly` is unavailable
|
|
39
|
+
- The binary fails to load (fetch error, ABI mismatch)
|
|
40
|
+
- The WASM entry returns a non-zero status
|
|
41
|
+
|
|
42
|
+
None of them ever reject.
|
|
43
|
+
|
|
44
|
+
## Examples
|
|
45
|
+
|
|
46
|
+
```js
|
|
47
|
+
const wasmSha2 = runtime.resolve('wasmSha2');
|
|
48
|
+
|
|
49
|
+
// Guard: check availability before use
|
|
50
|
+
if (!wasmSha2.isAvailable()) {
|
|
51
|
+
// Fall back to pure-JS sha256 / sha384 / sha512
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
// One-shot SHA-256 digest
|
|
55
|
+
const enc = new TextEncoder();
|
|
56
|
+
const digest = await wasmSha2.sha256(enc.encode('hello'));
|
|
57
|
+
if (digest === false) {
|
|
58
|
+
// WebAssembly unavailable or binary load failure
|
|
59
|
+
} else {
|
|
60
|
+
console.log(digest); // Uint8Array (32 bytes)
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
// SHA-512
|
|
64
|
+
const digest512 = await wasmSha2.sha512(enc.encode('hello'));
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
## Worker Usage
|
|
68
|
+
|
|
69
|
+
```js
|
|
70
|
+
const worker = fw.createWorker(
|
|
71
|
+
function ({ libs }) {
|
|
72
|
+
// wasmRuntime fetches the colocated .wasm by name inside the worker —
|
|
73
|
+
// no main-thread closure is serialized.
|
|
74
|
+
const enc = new TextEncoder();
|
|
75
|
+
libs.wasmSha2.sha256(enc.encode('hello')).then((d) => {
|
|
76
|
+
self.postMessage(d);
|
|
77
|
+
});
|
|
78
|
+
},
|
|
79
|
+
{ dependencies: ['wasmSha2'] }
|
|
80
|
+
);
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
## Notes
|
|
84
|
+
|
|
85
|
+
- **Prefer WebCrypto in secure contexts**: `webcrypto/digest` is hardware-accelerated for SHA-256/384/512. Use `wasmSha2` only when `crypto.subtle` is unavailable (non-secure-context, locked-down workers, test environments).
|
|
86
|
+
- **Scalar-only**: `sha2.simd.wasm` is not shipped — SHA-2 SIMD gains are marginal. The `{ variant: 'scalar' }` pin is mandatory; a default load would fail on the missing SIMD binary.
|
|
87
|
+
- **No-throw contract**: all methods resolve to `Uint8Array | false`; they never reject. Input validation (`instanceof Uint8Array`) happens before any WASM call.
|
|
88
|
+
- **Output is always a fresh copy**: `readBytes` copies out of WASM linear memory into a new `Uint8Array`. The caller owns the returned buffer.
|
|
89
|
+
- **Implements FIPS 180-4**: SHA-256 (§6.2), SHA-384 (§6.5), SHA-512 (§6.4). SHA-224, SHA-512/224, SHA-512/256 are out of scope — use the pure-JS tier.
|
|
90
|
+
|
|
91
|
+
## See also
|
|
92
|
+
|
|
93
|
+
- [wasmRuntime](./runtime.md) — shared WASM loader adapter
|
|
94
|
+
- [webcrypto/digest](../webcrypto/digest.md) — HW-backed SHA-2 in secure contexts (prefer this)
|
|
95
|
+
- [hash/sha256](../hash/sha256.md) — pure-JS SHA-256 (universal default)
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: wasmSha3
|
|
3
|
+
category: crypto/wasm
|
|
4
|
+
dependencies: [wasmRuntime]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# wasmSha3
|
|
11
|
+
|
|
12
|
+
> WASM-SIMD-accelerated SHA-3 / SHAKE (FIPS 202), async, Uint8Array.
|
|
13
|
+
|
|
14
|
+
**Module** `wasmSha3` | **Source** `packages/front/fw/src/crypto/wasm/sha3.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
WASM-backed wrapper over the `@awacloud/fw-wasm-crypto` `sha3` binary. Exposes
|
|
17
|
+
SHA3-224/256/384/512 (fixed-length digests) and SHAKE128/256 (XOF) as
|
|
18
|
+
async, no-throw primitives over `Uint8Array`. The Keccak permutation is
|
|
19
|
+
**not** in WebCrypto; this module is the WASM-tier primary accelerator for it
|
|
20
|
+
(alongside the pure-JS [`../hash/sha3.md`](../hash/sha3.md) universal default).
|
|
21
|
+
|
|
22
|
+
The binary ships as both `sha3.simd.wasm` and `sha3.scalar.wasm`
|
|
23
|
+
(`"simd": true` in targets.json). `wasmRuntime.load` auto-selects the SIMD
|
|
24
|
+
variant when the host engine validates simd128, otherwise the scalar variant
|
|
25
|
+
— no explicit pin needed.
|
|
26
|
+
|
|
27
|
+
## Resolve
|
|
28
|
+
|
|
29
|
+
```js
|
|
30
|
+
const wasmSha3 = runtime.resolve('wasmSha3');
|
|
31
|
+
// Returns: { isAvailable, sha3_224, sha3_256, sha3_384, sha3_512, shake128, shake256 }
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## API
|
|
35
|
+
|
|
36
|
+
| Method | Signature | Returns |
|
|
37
|
+
|--------|-----------|---------|
|
|
38
|
+
| `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present in this environment |
|
|
39
|
+
| `sha3_224` | `(data: Uint8Array) => Promise<Uint8Array\|false>` | 28-byte SHA3-224 digest, or `false` on failure |
|
|
40
|
+
| `sha3_256` | `(data: Uint8Array) => Promise<Uint8Array\|false>` | 32-byte SHA3-256 digest, or `false` on failure |
|
|
41
|
+
| `sha3_384` | `(data: Uint8Array) => Promise<Uint8Array\|false>` | 48-byte SHA3-384 digest, or `false` on failure |
|
|
42
|
+
| `sha3_512` | `(data: Uint8Array) => Promise<Uint8Array\|false>` | 64-byte SHA3-512 digest, or `false` on failure |
|
|
43
|
+
| `shake128` | `(data: Uint8Array, outLen: number) => Promise<Uint8Array\|false>` | XOF, exactly `outLen` bytes, or `false` on failure |
|
|
44
|
+
| `shake256` | `(data: Uint8Array, outLen: number) => Promise<Uint8Array\|false>` | XOF, exactly `outLen` bytes, or `false` on failure |
|
|
45
|
+
|
|
46
|
+
All operations resolve `false` (never reject) when:
|
|
47
|
+
- `data` is not a `Uint8Array`
|
|
48
|
+
- `outLen ≤ 0` for SHAKE variants
|
|
49
|
+
- the WASM binary fails to load (WebAssembly unavailable, fetch/compile error, or ABI mismatch)
|
|
50
|
+
- the binary returns a non-zero status (invalid `variantId` — an internal guard)
|
|
51
|
+
|
|
52
|
+
### WASM ABI
|
|
53
|
+
|
|
54
|
+
The binary exports a single entry point used for all six variants:
|
|
55
|
+
|
|
56
|
+
```
|
|
57
|
+
sha3(variantId: i32, inPtr: i32, inLen: i32, outPtr: i32, outLen: i32) -> i32
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
`variantId` maps to: `0`=SHA3-224, `1`=SHA3-256, `2`=SHA3-384, `3`=SHA3-512,
|
|
61
|
+
`4`=SHAKE128, `5`=SHAKE256. Return value `0` = OK; `-1` = unknown variantId.
|
|
62
|
+
For fixed-digest SHA3 variants, the shim ignores `outLen` and writes the implied
|
|
63
|
+
digest size. For SHAKE, the caller supplies `outLen` and the shim squeezes exactly
|
|
64
|
+
that many bytes.
|
|
65
|
+
|
|
66
|
+
## Examples
|
|
67
|
+
|
|
68
|
+
### One-shot SHA3-256 digest
|
|
69
|
+
|
|
70
|
+
```js
|
|
71
|
+
const wasmSha3 = runtime.resolve('wasmSha3');
|
|
72
|
+
|
|
73
|
+
const data = new TextEncoder().encode('Hello, world!');
|
|
74
|
+
const digest = await wasmSha3.sha3_256(data);
|
|
75
|
+
if (digest === false) {
|
|
76
|
+
// WebAssembly unavailable or binary load failure — fall back to pure-JS sha3.
|
|
77
|
+
return;
|
|
78
|
+
}
|
|
79
|
+
console.log(digest); // Uint8Array(32)
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### SHAKE128 XOF (variable output length)
|
|
83
|
+
|
|
84
|
+
```js
|
|
85
|
+
const key = await wasmSha3.shake128(seed, 32); // 32-byte key
|
|
86
|
+
const iv = await wasmSha3.shake128(seed, 16); // 16-byte IV (prefix of the 32-byte output)
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
### Feature detection + SIMD reporting
|
|
90
|
+
|
|
91
|
+
```js
|
|
92
|
+
if (!wasmSha3.isAvailable()) {
|
|
93
|
+
// No WebAssembly — use pure-JS sha3.
|
|
94
|
+
}
|
|
95
|
+
const fast = await runtime.resolve('wasmRuntime').hasSimd();
|
|
96
|
+
// fast === true → sha3.simd.wasm loaded (Keccak SIMD permutation)
|
|
97
|
+
// fast === false → sha3.scalar.wasm loaded (identical correctness, less throughput)
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
## Worker Usage
|
|
101
|
+
|
|
102
|
+
```js
|
|
103
|
+
const worker = fw.createWorker(
|
|
104
|
+
function ({ libs }) {
|
|
105
|
+
const data = new Uint8Array(32);
|
|
106
|
+
libs.wasmSha3.sha3_256(data).then((digest) => {
|
|
107
|
+
self.postMessage(digest !== false ? Array.from(digest) : null);
|
|
108
|
+
});
|
|
109
|
+
},
|
|
110
|
+
{ dependencies: ['wasmSha3'] }
|
|
111
|
+
);
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
## Notes
|
|
115
|
+
|
|
116
|
+
- **FIPS 202**: all six variants (SHA3-224/256/384/512, SHAKE128/256) implement FIPS 202 exactly — same domain suffix (SHA3: `0x06`, SHAKE: `0x1F`) and pad10*1 as the pure-JS module.
|
|
117
|
+
- **Not in WebCrypto**: `crypto.subtle` does not expose SHA-3 or Keccak; this module is the framework's primary accelerator for the Keccak family. When WebAssembly is unavailable, fall back to [`../hash/sha3.md`](../hash/sha3.md).
|
|
118
|
+
- **SIMD auto-selection**: the loader fetches `sha3.simd.wasm` when `supportsSimd()` is true (no explicit `{ variant }` pin needed); scalar fallback is automatic.
|
|
119
|
+
- **No-throw contract**: all methods are `async` and resolve to a result or `false`; they never reject. Validation errors are logged to `console.error` with the `[crypto]` prefix.
|
|
120
|
+
- **Output is a fresh copy**: `wasmRuntime.readBytes` copies bytes OUT of linear memory into a new `Uint8Array` — the returned buffer never aliases WASM memory.
|
|
121
|
+
- **Parity with pure-JS**: the WASM and pure-JS modules produce identical byte-for-byte output on the same input (verified by the test suite for all six variants).
|
|
122
|
+
|
|
123
|
+
## See also
|
|
124
|
+
|
|
125
|
+
- [`../hash/sha3.md`](../hash/sha3.md) — pure-JS SHA-3 / SHAKE module (universal default, no async)
|
|
126
|
+
- [`./blake2b.md`](./blake2b.md) — WASM-accelerated BLAKE2b (another non-WebCrypto hash)
|
|
127
|
+
- [`./runtime.md`](./runtime.md) — the shared WASM loader adapter all `crypto/wasm/*` wrappers use
|