@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,133 @@
|
|
|
1
|
+
# `sha3.js` — ACVP / NIST conformance
|
|
2
|
+
|
|
3
|
+
## Standards
|
|
4
|
+
|
|
5
|
+
- **Primary**: **FIPS 202** — *SHA-3 Standard: Permutation-Based Hash and
|
|
6
|
+
Extendable-Output Functions*, §6 (SHA-3 family) + §6.2 (SHAKE).
|
|
7
|
+
- **Secondary**: ACVP — draft-celi-acvp-sha3.
|
|
8
|
+
- **ACVP draft**: `references/NIST/ACVP/src/sha3/`
|
|
9
|
+
- **Vectors**:
|
|
10
|
+
- `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/SHA3-{224,256,384,512}-2.0/`
|
|
11
|
+
- `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/SHAKE-{128,256}-FIPS202/`
|
|
12
|
+
|
|
13
|
+
## Implemented algorithm
|
|
14
|
+
|
|
15
|
+
**Keccak-f[1600]** permutation + sponge construction (FIPS 202 §3.4 / §4).
|
|
16
|
+
Internal state: `Uint32Array(50)` (25 64-bit lanes emulated as `(lo, hi)`
|
|
17
|
+
pairs). Domain separation byte `0x06` (SHA-3) or `0x1F` (SHAKE), `pad10*1`
|
|
18
|
+
padding. Capacity = 2 × security level (448, 512, 768, 1024 bits). Worker-
|
|
19
|
+
serializable factory API. Six one-shot functions exposed: `sha3_{224,256,384,512}`
|
|
20
|
+
(fixed digest) and `shake{128,256}(data, outBits)` (XOF, `outBits` must be a multiple of 8).
|
|
21
|
+
|
|
22
|
+
**Iteration A1 (FIPS 140-3 upgrade)**: added four streaming sub-modules
|
|
23
|
+
`sha3_{224,256,384,512}_hash` exposing the `{ name, fn, hash }` contract with
|
|
24
|
+
`fn.prototype.{blockSize, update, finalize}` and clone constructor `new fn(other)`.
|
|
25
|
+
This unlocks HMAC-SHA-3, HKDF-SHA-3, and PBKDF2-HMAC-SHA-3 composition (Phase B
|
|
26
|
+
of the upgrade plan) without breaking the existing one-shot API.
|
|
27
|
+
|
|
28
|
+
## Test coverage
|
|
29
|
+
|
|
30
|
+
### Built-in official vectors
|
|
31
|
+
|
|
32
|
+
| Source | Reference | Test (`describe` / `test`) | Property verified |
|
|
33
|
+
|---|---|---|---|
|
|
34
|
+
| FIPS 202 | digest empty (4 SHA-3 variants) | `empty input` / `SHA3-XXX("")` | byte-exact KAT |
|
|
35
|
+
| FIPS 202 | digest "abc" (4 SHA-3 variants) | `"abc" input` / `SHA3-XXX("abc")` | byte-exact KAT |
|
|
36
|
+
| NIST CAVP | 200 × 0xa3 (1600-bit) | `200 bytes of 0xa3` | byte-exact KAT (covers 1 full absorption + tail) |
|
|
37
|
+
| FIPS 202 | SHAKE empty input (256-bit / 512-bit out) | `SHAKE empty input` | byte-exact XOF |
|
|
38
|
+
| **ACVP-SHA3-224-2.0** | AFT sub-sample (15/163 byte-aligned, 1258 total) | `ACVP SHA3-224-2.0 / AFT vectors` | byte-exact KAT |
|
|
39
|
+
| **ACVP-SHA3-224-2.0** | MCT standard (100 outer × 1000 inner) | `MCT (standard)` | **100/100 byte-exact results** (Iteration H2) |
|
|
40
|
+
| **ACVP-SHA3-256-2.0** | AFT sub-sample (16/151 byte-aligned, 1194 total) | `ACVP SHA3-256-2.0 / AFT vectors` | byte-exact KAT |
|
|
41
|
+
| **ACVP-SHA3-256-2.0** | MCT standard (100 outer × 1000 inner) | `MCT (standard)` | **100/100 byte-exact results** |
|
|
42
|
+
| **ACVP-SHA3-384-2.0** | AFT sub-sample (13/118 byte-aligned, 938 total) | `ACVP SHA3-384-2.0 / AFT vectors` | byte-exact KAT |
|
|
43
|
+
| **ACVP-SHA3-384-2.0** | MCT standard (100 outer × 1000 inner) | `MCT (standard)` | **100/100 byte-exact results** (Iteration H2) |
|
|
44
|
+
| **ACVP-SHA3-512-2.0** | AFT sub-sample (13/86 byte-aligned, 682 total) | `ACVP SHA3-512-2.0 / AFT vectors` | byte-exact KAT |
|
|
45
|
+
| **ACVP-SHA3-512-2.0** | MCT standard (100 outer × 1000 inner) | `MCT (standard)` | **100/100 byte-exact results** (Iteration H2) |
|
|
46
|
+
| **ACVP-SHAKE-128-FIPS202** | AFT sub-sample (29/269 byte-aligned in/out) | `ACVP SHAKE128-FIPS202 / AFT vectors` | byte-exact XOF, variable outLen |
|
|
47
|
+
| **ACVP-SHAKE-256-FIPS202** | AFT sub-sample (6/41 byte-aligned in/out, 237 total) | `ACVP SHAKE256-FIPS202 / AFT vectors` | byte-exact XOF, variable outLen |
|
|
48
|
+
|
|
49
|
+
#### Sub-sampling strategy
|
|
50
|
+
|
|
51
|
+
- **SHA-3 AFT**: one byte-aligned tcId in 32, plus anchors `len ∈ {0, 8, 16,
|
|
52
|
+
24, 56, 96, 256, 512, 1024, 2048, 8192}` when available, plus
|
|
53
|
+
`min(len)` and `max(len)`. Individual cap 32000 bits (except the max-anchor).
|
|
54
|
+
- **SHA-3 MCT**: **standard** FIPS202 algorithm (`MD[0]=SEED ; MSG=MD[i-1]
|
|
55
|
+
; MD[i]=SHA3(MSG)`). 100 outer × 1000 inner. For SHA3-256, **all 100
|
|
56
|
+
results** are verified byte-exact (full path validated); for
|
|
57
|
+
224/384/512, iter 0 and iter 99 are checked (CI cost saving; identical algorithm).
|
|
58
|
+
- **SHAKE AFT**: one tcId in 8 (both input AND outLen byte-aligned), plus
|
|
59
|
+
`min/max(outLen)` and `min(len)`. Input cap 16000 bits.
|
|
60
|
+
- **SHAKE MCT**: **not specified in the FIPS 202 ACVP revision** (see the
|
|
61
|
+
draft-celi-acvp-sha3 spec). Therefore not tested.
|
|
62
|
+
- **LDT (testGroup 3)**: not integrated (`fullLength` up to ~8.5 GiB).
|
|
63
|
+
|
|
64
|
+
### Security properties tested
|
|
65
|
+
|
|
66
|
+
- [x] **Keccak-f[1600] permutation (24 rounds)** — covered by all vectors.
|
|
67
|
+
- [x] **Domain separation 0x06 / 0x1F** — indirect proof: SHA3 and SHAKE
|
|
68
|
+
share the same `_sponge`, only outputs diverge byte-for-byte
|
|
69
|
+
(validated by their respective empty KATs).
|
|
70
|
+
- [x] **`pad10*1` padding** — exercised by the AFT length variations
|
|
71
|
+
(cases where `remaining + 1 < rateBytes` and `remaining = rateBytes - 1`).
|
|
72
|
+
- [x] **Multi-block absorption** — 200×0xa3 KAT (1600 bits = 9 SHA3-256 blocks).
|
|
73
|
+
- [x] **Multi-round squeeze (XOF)** — SHAKE128 vectors with `outLen > rate`
|
|
74
|
+
(SHAKE128 rate = 1344 bits; SHAKE AFT `outLen` spans several blocks).
|
|
75
|
+
- [x] **Long-chain stability** — standard MCT for SHA3-{224,256,384,512}:
|
|
76
|
+
100,000 consecutive hashes per variant validated **byte-exact across all 100
|
|
77
|
+
iters** (Iteration H2; previously only SHA3-256 was fully byte-exact,
|
|
78
|
+
SHA3-{224,384,512} tested only iter0 + iter99). Any drift deviates
|
|
79
|
+
`resultsArray[j]` at any iteration.
|
|
80
|
+
- [x] **XOF outLen guard** — `SHAKE rejects non-byte-aligned output`:
|
|
81
|
+
`console.warn` + `return false`.
|
|
82
|
+
- [ ] **Side-channel resistance** — N/A (hash module with no secret by default;
|
|
83
|
+
HMAC-SHA-3 usage handled by `hmac.js`).
|
|
84
|
+
- [ ] **Bit-level inputs (non-byte-aligned)** — **NOT SUPPORTED** by
|
|
85
|
+
the current implementation (see *Known limitations*).
|
|
86
|
+
- [x] **Streaming API for HMAC/HKDF/PBKDF2** (upgrade plan iteration A1) —
|
|
87
|
+
4 sub-modules `sha3_{224,256,384,512}_hash` exposing `{ name, fn, hash }`
|
|
88
|
+
with `fn.prototype.{blockSize, update, finalize}` and clone constructor
|
|
89
|
+
`new fn(other)`. **40 dedicated tests**: streaming = one-shot (3-chunk,
|
|
90
|
+
byte-by-byte, exact rate boundary), clone independence, idempotent finalize
|
|
91
|
+
(2nd call rejected), update rejected after finalize, empty input, bitArray accepted
|
|
92
|
+
for the HMAC ex-key path.
|
|
93
|
+
|
|
94
|
+
## FIPS 140-3 conformance
|
|
95
|
+
|
|
96
|
+
| Requirement | Status | Evidence |
|
|
97
|
+
|---|---|---|
|
|
98
|
+
| Approved algorithm | ✅ | FIPS 202 §6 + ACVP-SHA3-{224,256,384,512}-2.0 |
|
|
99
|
+
| Validated parameter sizes | ✅ | 4 digestSize + 2 SHAKE variants; variable outLen covered by AFT SHAKE |
|
|
100
|
+
| Power-on KAT / self-test | ✅ | FIPS 202 vectors (empty + "abc" + 200×0xa3) + ACVP AFT executed on every `bun test` |
|
|
101
|
+
| CT comparisons (if secret) | N/A | Hash module with no secret |
|
|
102
|
+
| No `throw` / timing leak | ✅ | Review: `console.warn` + `return false` on the XOF guard |
|
|
103
|
+
|
|
104
|
+
## Known limitations
|
|
105
|
+
|
|
106
|
+
- **Bit-level inputs not supported**: sha3.js does not implement the FIPS
|
|
107
|
+
202 Annex B bit-alignment extension (the ACVP suites enumerate ~85% of
|
|
108
|
+
non-byte-aligned vectors; they are **filtered out** at sub-sampling). If a
|
|
109
|
+
consumer needs to absorb a number of bits not a multiple of 8, the
|
|
110
|
+
module must be extended to adjust the domain padding bits.
|
|
111
|
+
- **Aggressive AFT sub-sampling on the 224/384/512 variants**: low
|
|
112
|
+
percentages (15/163, 13/118, 13/86) because the ACVP suite is dominated by
|
|
113
|
+
non-byte-aligned lengths. The remaining byte-aligned vectors cover the
|
|
114
|
+
critical lengths `[0, 8, 16, 24, 56, 96, 256, 512, 1024, 2048, 8192, max]`.
|
|
115
|
+
- **MCT 224/384/512: iter0 + iter99 assertions only** — the algorithm
|
|
116
|
+
is strictly the same (single MD chain, no seed truncation); a
|
|
117
|
+
drift at any intermediate iter would deviate iter 99. All 100
|
|
118
|
+
outer iters are **executed** in all cases (iter 100 depends on the 99
|
|
119
|
+
preceding ones), only the assertion checkpoints are reduced.
|
|
120
|
+
- **SHAKE MCT not tested**: the FIPS 202 ACVP revision spec does not expose an
|
|
121
|
+
MCT for SHAKE.
|
|
122
|
+
- **LDT not integrated**: multi-GB per tcId, out of CI budget.
|
|
123
|
+
- **SHAKE128: very few tcIds with both input AND outLen byte-aligned**
|
|
124
|
+
in the AFT (29/269; 41/237 for SHAKE256). The multi-block squeeze
|
|
125
|
+
code path remains exercised by these 35 vectors.
|
|
126
|
+
|
|
127
|
+
## Cross references
|
|
128
|
+
|
|
129
|
+
- Module: [`hash/sha3.js`](./sha3.js)
|
|
130
|
+
- Tests: [`hash/sha3.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/hash/sha3.test.js) — 150 tests (110 ACVP/FIPS 202 + 40 streaming API since upgrade plan iteration A1)
|
|
131
|
+
- ACVP draft: `references/NIST/ACVP/src/sha3/`
|
|
132
|
+
- Vectors: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/SHA3-*-2.0/` + `SHAKE-{128,256}-FIPS202/`
|
|
133
|
+
- Overall conformance: [`NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)
|
|
@@ -0,0 +1,391 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @fileoverview SHA-3 family and SHAKE XOFs (FIPS 202).
|
|
7
|
+
*
|
|
8
|
+
* Implements the Keccak-f[1600] permutation and exposes the four SHA-3 fixed-
|
|
9
|
+
* length variants (SHA3-224/256/384/512) plus the two SHAKE extendable-output
|
|
10
|
+
* functions (SHAKE128, SHAKE256) as a single sponge module.
|
|
11
|
+
*
|
|
12
|
+
* The state is held as a Uint32Array(50) of (lo, hi) pairs - Keccak operates
|
|
13
|
+
* on 64-bit lanes but JS lacks native 64-bit integers, so each lane is split
|
|
14
|
+
* into two 32-bit halves and the round transformations are unrolled
|
|
15
|
+
* accordingly. Inputs are absorbed lane-by-lane (rate r = 1600 - capacity)
|
|
16
|
+
* and the squeezing phase emits any number of bytes.
|
|
17
|
+
*
|
|
18
|
+
* Domain separation per FIPS 202 §6.1: SHA-3 appends the byte 0x06 before
|
|
19
|
+
* pad10*1, SHAKE appends 0x1F. Capacity is 2× the security level (e.g. 256
|
|
20
|
+
* bits for SHA3-128-equivalent, 512 bits for SHA3-256).
|
|
21
|
+
*
|
|
22
|
+
*/
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* Streaming SHA-3 / SHAKE hash instance - HMAC/HKDF/PBKDF2 compatible.
|
|
26
|
+
* @typedef {object} Sha3HashInstance
|
|
27
|
+
* @property {number} blockSize Block size in bits.
|
|
28
|
+
* @property {(data: (string|Uint8Array|number[])) => Sha3HashInstance} update
|
|
29
|
+
* @property {() => (number[]|false)} finalize Returns the digest as bitArray, or `false` on misuse.
|
|
30
|
+
*/
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Streaming SHA-3 / SHAKE constructor. The copy form (`new Ctor(other)`) clones
|
|
34
|
+
* inner state for HMAC inner/outer caching.
|
|
35
|
+
* @typedef {{ new (other?: Sha3HashInstance): Sha3HashInstance }} Sha3HashCtor
|
|
36
|
+
*/
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* Submodule shape exposed by `sha3_*_hash` keys, compatible with
|
|
40
|
+
* `hmac.js` / `hkdf.js` / `pbkdf2.js` dependency injection.
|
|
41
|
+
* @typedef {object} Sha3StreamingModule
|
|
42
|
+
* @property {string} name
|
|
43
|
+
* @property {Sha3HashCtor} fn
|
|
44
|
+
* @property {(data: (string|Uint8Array|number[])) => (number[]|false)} hash
|
|
45
|
+
*/
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* One-shot SHA-3 hash function: data in, digest bitArray out.
|
|
49
|
+
* @typedef {(data: (string|Uint8Array|number[])) => number[]} Sha3OneShot
|
|
50
|
+
*/
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* SHAKE extendable-output function: data + requested output bit-length.
|
|
54
|
+
* Returns the digest bitArray, or `false` when `outBits` is invalid.
|
|
55
|
+
* @typedef {(data: (string|Uint8Array|number[]), outBits: number) => (number[]|false)} ShakeXof
|
|
56
|
+
*/
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* Public shape returned by `sha3.factory()`.
|
|
60
|
+
* @typedef {object} Sha3API
|
|
61
|
+
* @property {Sha3OneShot} sha3_224 One-shot SHA3-224 (digest as bitArray).
|
|
62
|
+
* @property {Sha3OneShot} sha3_256 One-shot SHA3-256 (digest as bitArray).
|
|
63
|
+
* @property {Sha3OneShot} sha3_384 One-shot SHA3-384 (digest as bitArray).
|
|
64
|
+
* @property {Sha3OneShot} sha3_512 One-shot SHA3-512 (digest as bitArray).
|
|
65
|
+
* @property {ShakeXof} shake128 SHAKE128 XOF (variable-length output).
|
|
66
|
+
* @property {ShakeXof} shake256 SHAKE256 XOF (variable-length output).
|
|
67
|
+
* @property {Sha3StreamingModule} sha3_224_hash HMAC/HKDF/PBKDF2-compatible module.
|
|
68
|
+
* @property {Sha3StreamingModule} sha3_256_hash HMAC/HKDF/PBKDF2-compatible module.
|
|
69
|
+
* @property {Sha3StreamingModule} sha3_384_hash HMAC/HKDF/PBKDF2-compatible module.
|
|
70
|
+
* @property {Sha3StreamingModule} sha3_512_hash HMAC/HKDF/PBKDF2-compatible module.
|
|
71
|
+
*/
|
|
72
|
+
|
|
73
|
+
import { bitArray } from '../utils/bitArray.js';
|
|
74
|
+
import { utf8 } from '../../io/codec/utf8.js';
|
|
75
|
+
|
|
76
|
+
export const sha3 = {
|
|
77
|
+
name: 'sha3',
|
|
78
|
+
version: '1.0.0',
|
|
79
|
+
type: 'fw.crypto.hash',
|
|
80
|
+
dependencies: ['bitArray', 'utf8'],
|
|
81
|
+
deps: [bitArray, utf8],
|
|
82
|
+
|
|
83
|
+
/** @returns {Sha3API} */
|
|
84
|
+
factory(bitArray, utf8) {
|
|
85
|
+
|
|
86
|
+
// Round constants (split into lo, hi 32-bit halves).
|
|
87
|
+
const _RC_LO = new Uint32Array([
|
|
88
|
+
0x00000001, 0x00008082, 0x0000808a, 0x80008000,
|
|
89
|
+
0x0000808b, 0x80000001, 0x80008081, 0x00008009,
|
|
90
|
+
0x0000008a, 0x00000088, 0x80008009, 0x8000000a,
|
|
91
|
+
0x8000808b, 0x0000008b, 0x00008089, 0x00008003,
|
|
92
|
+
0x00008002, 0x00000080, 0x0000800a, 0x8000000a,
|
|
93
|
+
0x80008081, 0x00008080, 0x80000001, 0x80008008
|
|
94
|
+
]);
|
|
95
|
+
const _RC_HI = new Uint32Array([
|
|
96
|
+
0x00000000, 0x00000000, 0x80000000, 0x80000000,
|
|
97
|
+
0x00000000, 0x00000000, 0x80000000, 0x80000000,
|
|
98
|
+
0x00000000, 0x00000000, 0x00000000, 0x00000000,
|
|
99
|
+
0x00000000, 0x80000000, 0x80000000, 0x80000000,
|
|
100
|
+
0x80000000, 0x80000000, 0x00000000, 0x80000000,
|
|
101
|
+
0x80000000, 0x80000000, 0x00000000, 0x80000000
|
|
102
|
+
]);
|
|
103
|
+
|
|
104
|
+
// ρ rotation offsets (in bits) for each lane, flattened as i = x + 5*y
|
|
105
|
+
// (row-major, x ∈ rows of 5). Values per FIPS 202 Table 2.
|
|
106
|
+
const _R = [
|
|
107
|
+
0, 1, 62, 28, 27,
|
|
108
|
+
36, 44, 6, 55, 20,
|
|
109
|
+
3, 10, 43, 25, 39,
|
|
110
|
+
41, 45, 15, 21, 8,
|
|
111
|
+
18, 2, 61, 56, 14
|
|
112
|
+
];
|
|
113
|
+
|
|
114
|
+
function _keccakF1600(s) {
|
|
115
|
+
const C = new Uint32Array(10);
|
|
116
|
+
const D = new Uint32Array(10);
|
|
117
|
+
const B = new Uint32Array(50);
|
|
118
|
+
|
|
119
|
+
for (let round = 0; round < 24; round++) {
|
|
120
|
+
// θ
|
|
121
|
+
for (let x = 0; x < 5; x++) {
|
|
122
|
+
C[2*x] = s[2*x] ^ s[2*x + 10] ^ s[2*x + 20] ^ s[2*x + 30] ^ s[2*x + 40];
|
|
123
|
+
C[2*x+1] = s[2*x+1] ^ s[2*x + 11] ^ s[2*x + 21] ^ s[2*x + 31] ^ s[2*x + 41];
|
|
124
|
+
}
|
|
125
|
+
for (let x = 0; x < 5; x++) {
|
|
126
|
+
const xm1 = (x + 4) % 5;
|
|
127
|
+
const xp1 = (x + 1) % 5;
|
|
128
|
+
// D[x] = C[x-1] xor rot(C[x+1], 1)
|
|
129
|
+
const lo = C[2*xp1];
|
|
130
|
+
const hi = C[2*xp1 + 1];
|
|
131
|
+
D[2*x] = C[2*xm1] ^ ((lo << 1) | (hi >>> 31));
|
|
132
|
+
D[2*x+1] = C[2*xm1 + 1] ^ ((hi << 1) | (lo >>> 31));
|
|
133
|
+
}
|
|
134
|
+
for (let i = 0; i < 25; i++) {
|
|
135
|
+
const x = i % 5;
|
|
136
|
+
s[2*i] ^= D[2*x];
|
|
137
|
+
s[2*i + 1] ^= D[2*x + 1];
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
// ρ + π
|
|
141
|
+
for (let x = 0; x < 5; x++) {
|
|
142
|
+
for (let y = 0; y < 5; y++) {
|
|
143
|
+
const i = x + 5 * y;
|
|
144
|
+
const ni = y + 5 * ((2 * x + 3 * y) % 5);
|
|
145
|
+
const r = _R[i];
|
|
146
|
+
const lo = s[2*i];
|
|
147
|
+
const hi = s[2*i + 1];
|
|
148
|
+
let nlo, nhi;
|
|
149
|
+
if (r === 0) {
|
|
150
|
+
nlo = lo; nhi = hi;
|
|
151
|
+
} else if (r < 32) {
|
|
152
|
+
nlo = (lo << r) | (hi >>> (32 - r));
|
|
153
|
+
nhi = (hi << r) | (lo >>> (32 - r));
|
|
154
|
+
} else if (r === 32) {
|
|
155
|
+
nlo = hi; nhi = lo;
|
|
156
|
+
} else {
|
|
157
|
+
const r2 = r - 32;
|
|
158
|
+
nlo = (hi << r2) | (lo >>> (32 - r2));
|
|
159
|
+
nhi = (lo << r2) | (hi >>> (32 - r2));
|
|
160
|
+
}
|
|
161
|
+
B[2*ni] = nlo;
|
|
162
|
+
B[2*ni + 1] = nhi;
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
// χ
|
|
167
|
+
for (let y = 0; y < 5; y++) {
|
|
168
|
+
for (let x = 0; x < 5; x++) {
|
|
169
|
+
const i = x + 5 * y;
|
|
170
|
+
const i1 = ((x + 1) % 5) + 5 * y;
|
|
171
|
+
const i2 = ((x + 2) % 5) + 5 * y;
|
|
172
|
+
s[2*i] = B[2*i] ^ ((~B[2*i1]) & B[2*i2]);
|
|
173
|
+
s[2*i + 1] = B[2*i + 1] ^ ((~B[2*i1 + 1]) & B[2*i2 + 1]);
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
// ι
|
|
178
|
+
s[0] ^= _RC_LO[round];
|
|
179
|
+
s[1] ^= _RC_HI[round];
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
function _toBytes(data) {
|
|
184
|
+
if (typeof data === 'string') return utf8.toBytes(data);
|
|
185
|
+
if (data instanceof Uint8Array) return data;
|
|
186
|
+
// assume bitArray
|
|
187
|
+
return bitArray.ba_to_ui8(data);
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
/**
|
|
191
|
+
* XOR a full rate-sized block of bytes into the sponge state and apply
|
|
192
|
+
* Keccak-f[1600]. Helper shared by `_sponge` (one-shot) and the streaming
|
|
193
|
+
* `_absorbInto` (incremental).
|
|
194
|
+
*/
|
|
195
|
+
function _absorbFullBlock(s, block, rateBytes) {
|
|
196
|
+
for (let i = 0; i < rateBytes; i++) {
|
|
197
|
+
const lane = i >>> 3;
|
|
198
|
+
const byteInLane = i & 7;
|
|
199
|
+
const wordIdx = 2 * lane + (byteInLane < 4 ? 0 : 1);
|
|
200
|
+
const shift = (byteInLane & 3) * 8;
|
|
201
|
+
s[wordIdx] ^= (block[i] & 0xff) << shift;
|
|
202
|
+
}
|
|
203
|
+
_keccakF1600(s);
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
/**
|
|
207
|
+
* Sponge construction.
|
|
208
|
+
* @param {Uint8Array} input
|
|
209
|
+
* @param {number} rateBytes Bitrate in bytes (200 - capacity/8).
|
|
210
|
+
* @param {number} domain Domain-separation byte (0x06 SHA-3, 0x1F SHAKE).
|
|
211
|
+
* @param {number} outBytes Desired output length in bytes.
|
|
212
|
+
* @returns {Uint8Array}
|
|
213
|
+
*/
|
|
214
|
+
function _sponge(input, rateBytes, domain, outBytes) {
|
|
215
|
+
const s = new Uint32Array(50);
|
|
216
|
+
const blocks = Math.floor(input.length / rateBytes);
|
|
217
|
+
|
|
218
|
+
// Absorb full blocks.
|
|
219
|
+
for (let b = 0; b < blocks; b++) {
|
|
220
|
+
_absorbFullBlock(s, input.subarray(b * rateBytes, (b + 1) * rateBytes), rateBytes);
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
// Absorb final (possibly partial) block + pad10*1.
|
|
224
|
+
const tail = new Uint8Array(rateBytes);
|
|
225
|
+
const remaining = input.length - blocks * rateBytes;
|
|
226
|
+
tail.set(input.subarray(blocks * rateBytes), 0);
|
|
227
|
+
tail[remaining] = domain;
|
|
228
|
+
tail[rateBytes - 1] |= 0x80;
|
|
229
|
+
_absorbFullBlock(s, tail, rateBytes);
|
|
230
|
+
|
|
231
|
+
// Squeeze.
|
|
232
|
+
const out = new Uint8Array(outBytes);
|
|
233
|
+
let produced = 0;
|
|
234
|
+
while (produced < outBytes) {
|
|
235
|
+
const take = Math.min(rateBytes, outBytes - produced);
|
|
236
|
+
for (let i = 0; i < take; i++) {
|
|
237
|
+
const lane = i >>> 3;
|
|
238
|
+
const byteInLane = i & 7;
|
|
239
|
+
const wordIdx = 2 * lane + (byteInLane < 4 ? 0 : 1);
|
|
240
|
+
const shift = (byteInLane & 3) * 8;
|
|
241
|
+
out[produced + i] = (s[wordIdx] >>> shift) & 0xff;
|
|
242
|
+
}
|
|
243
|
+
produced += take;
|
|
244
|
+
if (produced < outBytes) _keccakF1600(s);
|
|
245
|
+
}
|
|
246
|
+
return out;
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
function _make(outBits, capacityBits, domain) {
|
|
250
|
+
const rateBytes = (1600 - capacityBits) / 8;
|
|
251
|
+
const outBytes = outBits / 8;
|
|
252
|
+
return function (data) {
|
|
253
|
+
return bitArray.ui8_to_ba(_sponge(_toBytes(data), rateBytes, domain, outBytes));
|
|
254
|
+
};
|
|
255
|
+
}
|
|
256
|
+
|
|
257
|
+
function _makeXof(capacityBits, domain) {
|
|
258
|
+
const rateBytes = (1600 - capacityBits) / 8;
|
|
259
|
+
return function (data, outBits) {
|
|
260
|
+
if (outBits < 0 || (outBits & 7) !== 0) {
|
|
261
|
+
console.warn('[crypto] INVALID: sha3: SHAKE output must be a non-negative multiple of 8 bits');
|
|
262
|
+
return false;
|
|
263
|
+
}
|
|
264
|
+
return bitArray.ui8_to_ba(_sponge(_toBytes(data), rateBytes, domain, outBits / 8));
|
|
265
|
+
};
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
// ── Streaming sponge constructor (HMAC/HKDF/PBKDF2-compatible) ─────
|
|
269
|
+
//
|
|
270
|
+
// Exposes the `{ fn, hash, fn.prototype.{blockSize, update, finalize} }`
|
|
271
|
+
// contract that `hash/hmac.js` requires (cf. hmac.js:22-45). One module
|
|
272
|
+
// per SHA-3 variant + per SHAKE rate. Output length is fixed at the
|
|
273
|
+
// standard digest size (FIPS 202) for SHA-3; for SHAKE the streaming
|
|
274
|
+
// wrapper takes `outBits` at construction time.
|
|
275
|
+
//
|
|
276
|
+
// State is fully cloneable via the copy constructor `new H(other)`,
|
|
277
|
+
// which HMAC uses to cache the inner/outer hash state after key
|
|
278
|
+
// absorption (hmac.js:31, 44, 59, 71).
|
|
279
|
+
|
|
280
|
+
/**
|
|
281
|
+
* @returns {Sha3HashCtor}
|
|
282
|
+
*/
|
|
283
|
+
function _makeStreamingHash(outBits, capacityBits, domain) {
|
|
284
|
+
const rateBytes = (1600 - capacityBits) / 8;
|
|
285
|
+
const outBytes = outBits / 8;
|
|
286
|
+
|
|
287
|
+
function H(other) {
|
|
288
|
+
if (other) {
|
|
289
|
+
// Clone constructor - used by HMAC for inner/outer state caching.
|
|
290
|
+
this._state = new Uint32Array(other._state);
|
|
291
|
+
this._buf = new Uint8Array(other._buf);
|
|
292
|
+
this._bufLen = other._bufLen;
|
|
293
|
+
this._finalized = other._finalized;
|
|
294
|
+
} else {
|
|
295
|
+
this._state = new Uint32Array(50);
|
|
296
|
+
this._buf = new Uint8Array(rateBytes);
|
|
297
|
+
this._bufLen = 0;
|
|
298
|
+
this._finalized = false;
|
|
299
|
+
}
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
// Block size in **bits** - `hmac.js:30` reads this as `blockSize / 32`.
|
|
303
|
+
H.prototype.blockSize = rateBytes * 8;
|
|
304
|
+
|
|
305
|
+
H.prototype.update = function (data) {
|
|
306
|
+
if (this._finalized) {
|
|
307
|
+
console.warn('[crypto] INVALID: sha3: update after finalize');
|
|
308
|
+
return this;
|
|
309
|
+
}
|
|
310
|
+
const bytes = _toBytes(data);
|
|
311
|
+
let off = 0;
|
|
312
|
+
while (off < bytes.length) {
|
|
313
|
+
const take = Math.min(rateBytes - this._bufLen, bytes.length - off);
|
|
314
|
+
this._buf.set(bytes.subarray(off, off + take), this._bufLen);
|
|
315
|
+
this._bufLen += take;
|
|
316
|
+
off += take;
|
|
317
|
+
if (this._bufLen === rateBytes) {
|
|
318
|
+
_absorbFullBlock(this._state, this._buf, rateBytes);
|
|
319
|
+
this._bufLen = 0;
|
|
320
|
+
}
|
|
321
|
+
}
|
|
322
|
+
return this;
|
|
323
|
+
};
|
|
324
|
+
|
|
325
|
+
H.prototype.finalize = function () {
|
|
326
|
+
if (this._finalized) {
|
|
327
|
+
console.warn('[crypto] INVALID: sha3: finalize called twice');
|
|
328
|
+
return false;
|
|
329
|
+
}
|
|
330
|
+
// Pad10*1 + domain
|
|
331
|
+
for (let i = this._bufLen; i < rateBytes; i++) this._buf[i] = 0;
|
|
332
|
+
this._buf[this._bufLen] = domain;
|
|
333
|
+
this._buf[rateBytes - 1] |= 0x80;
|
|
334
|
+
_absorbFullBlock(this._state, this._buf, rateBytes);
|
|
335
|
+
this._finalized = true;
|
|
336
|
+
|
|
337
|
+
// Squeeze
|
|
338
|
+
const out = new Uint8Array(outBytes);
|
|
339
|
+
let produced = 0;
|
|
340
|
+
while (produced < outBytes) {
|
|
341
|
+
const take = Math.min(rateBytes, outBytes - produced);
|
|
342
|
+
for (let i = 0; i < take; i++) {
|
|
343
|
+
const lane = i >>> 3;
|
|
344
|
+
const byteInLane = i & 7;
|
|
345
|
+
const wordIdx = 2 * lane + (byteInLane < 4 ? 0 : 1);
|
|
346
|
+
const shift = (byteInLane & 3) * 8;
|
|
347
|
+
out[produced + i] = (this._state[wordIdx] >>> shift) & 0xff;
|
|
348
|
+
}
|
|
349
|
+
produced += take;
|
|
350
|
+
if (produced < outBytes) _keccakF1600(this._state);
|
|
351
|
+
}
|
|
352
|
+
return bitArray.ui8_to_ba(out);
|
|
353
|
+
};
|
|
354
|
+
|
|
355
|
+
return H;
|
|
356
|
+
}
|
|
357
|
+
|
|
358
|
+
// Submodule wrappers exposing `{ name, fn, hash }` shape compatible
|
|
359
|
+
// with hmac.js / hkdf.js / pbkdf2.js dependency injection.
|
|
360
|
+
/** @returns {Sha3StreamingModule} */
|
|
361
|
+
function _streamingModule(name, outBits, capacityBits, domain, oneShot) {
|
|
362
|
+
const fn = _makeStreamingHash(outBits, capacityBits, domain);
|
|
363
|
+
return { name, fn, hash: oneShot };
|
|
364
|
+
}
|
|
365
|
+
|
|
366
|
+
const _sha3_224 = _make(224, 448, 0x06);
|
|
367
|
+
const _sha3_256 = _make(256, 512, 0x06);
|
|
368
|
+
const _sha3_384 = _make(384, 768, 0x06);
|
|
369
|
+
const _sha3_512 = _make(512, 1024, 0x06);
|
|
370
|
+
const _shake128 = _makeXof(256, 0x1F);
|
|
371
|
+
const _shake256 = _makeXof(512, 0x1F);
|
|
372
|
+
|
|
373
|
+
return {
|
|
374
|
+
// Existing one-shot callable API (unchanged).
|
|
375
|
+
sha3_224: _sha3_224,
|
|
376
|
+
sha3_256: _sha3_256,
|
|
377
|
+
sha3_384: _sha3_384,
|
|
378
|
+
sha3_512: _sha3_512,
|
|
379
|
+
shake128: _shake128,
|
|
380
|
+
shake256: _shake256,
|
|
381
|
+
|
|
382
|
+
// NEW: HMAC/HKDF/PBKDF2-compatible Hash modules with `{ fn, hash }`.
|
|
383
|
+
// Each `fn` is a constructor exposing prototype.{blockSize, update, finalize}
|
|
384
|
+
// and a copy constructor `new fn(other)`.
|
|
385
|
+
sha3_224_hash: _streamingModule('sha3_224', 224, 448, 0x06, _sha3_224),
|
|
386
|
+
sha3_256_hash: _streamingModule('sha3_256', 256, 512, 0x06, _sha3_256),
|
|
387
|
+
sha3_384_hash: _streamingModule('sha3_384', 384, 768, 0x06, _sha3_384),
|
|
388
|
+
sha3_512_hash: _streamingModule('sha3_512', 512, 1024, 0x06, _sha3_512)
|
|
389
|
+
};
|
|
390
|
+
}
|
|
391
|
+
};
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
# `sha384.js` — ACVP / NIST conformance
|
|
2
|
+
|
|
3
|
+
## Standards
|
|
4
|
+
|
|
5
|
+
- **Primary**: **FIPS 180-4** — *Secure Hash Standard (SHS)*, §6.5 (SHA-384).
|
|
6
|
+
- **Secondary**: ACVP — draft-celi-acvp-sha.
|
|
7
|
+
- **ACVP draft**: `references/NIST/ACVP/src/draft-celi-acvp-sha.adoc`
|
|
8
|
+
- **Vectors**: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/SHA2-384-1.0/`
|
|
9
|
+
|
|
10
|
+
## Implemented algorithm
|
|
11
|
+
|
|
12
|
+
SHA-384 hash (FIPS 180-4 §6.5). Identical to SHA-512 except for the IV (FIPS 180-4
|
|
13
|
+
§5.3.4) and the final truncation (`h.slice(0, 12)` → 384 bits = 12 32-bit
|
|
14
|
+
words representing 6 64-bit words).
|
|
15
|
+
|
|
16
|
+
**Architecture (post-upgrade audit Finding 1 resolved)**: `factory(sha512)` →
|
|
17
|
+
`{ fn, hash }`. Thin wrapper (~14 useful LOC) over
|
|
18
|
+
`sha512._internal.makeSha(_INIT_384, 12)`. **Previously**: this module
|
|
19
|
+
duplicated the ~120 LOC of the 64-bit compression function "to
|
|
20
|
+
preserve streaming-state independence" — inconsistent with
|
|
21
|
+
sha512_224/256, which already apply this reuse pattern. Compression
|
|
22
|
+
over 1024-bit blocks, 64-bit operations emulated as 32-bit (high/low)
|
|
23
|
+
pairs, inherited from sha512.js.
|
|
24
|
+
|
|
25
|
+
## Test coverage
|
|
26
|
+
|
|
27
|
+
### Built-in official vectors
|
|
28
|
+
|
|
29
|
+
| Source | Reference | Test (`describe` / `test`) | Property verified |
|
|
30
|
+
|---|---|---|---|
|
|
31
|
+
| FIPS 180-4 | digest empty | `FIPS-180 vectors` / `empty string` | byte-exact KAT |
|
|
32
|
+
| FIPS 180-4 App. D | "abc" | `FIPS-180 vectors` / `"abc"` | byte-exact KAT |
|
|
33
|
+
| ACVP-SHA2-384-1.0 | `expectedResults.json` tcId 1-1024 (sub-sample 24) | `ACVP SHA2-384-1.0 / AFT vectors` | byte-exact KAT (lengths 0..65535 bits, INCLUDING non-byte-aligned bit-level) |
|
|
34
|
+
| ACVP-SHA2-384-1.0 | `expectedResults.json` tcId 1025 (standard MCT) | `ACVP SHA2-384-1.0 / MCT (standard)` | 100 outer × 1000 inner — 100 byte-exact `resultsArray` results |
|
|
35
|
+
|
|
36
|
+
#### AFT sub-sampling strategy
|
|
37
|
+
|
|
38
|
+
The SHA2-384 AFT enumerates 1024 messages at lengths `[0..65535]` bits — **892/1024 tests are non-byte-aligned**. Strategy:
|
|
39
|
+
|
|
40
|
+
- **Regular stride**: tcId 1, 33, 65, …, 993, 1024 (one in 32).
|
|
41
|
+
- **Anchors**: `len=0`, `min(len)`, `max(len)=65535`, and the first tcId for each critical short length (1, 7, 9, 13, 100, 511, 1023, 2047 bits).
|
|
42
|
+
- **Volume cap**: tests > 32000 bits filtered out (except the `max(len)` anchor).
|
|
43
|
+
- **Total integrated**: **24 / 1024 AFT + 1 MCT** out of 1025 tests + **1 LDT (1 GiB) gated behind `CRYPTO_FULL=1`** (see LDT line below).
|
|
44
|
+
- **LDT (testGroup 3)**: **Iteration H1** — tcId=1026 (1 GiB of repeated `3d04a3d3c6a52e47`) integrated behind `CRYPTO_FULL=1`.
|
|
45
|
+
|
|
46
|
+
Non-byte-aligned vectors are decoded via `bitArray.clamp(ui8_to_ba(bytes), bitLen)`.
|
|
47
|
+
|
|
48
|
+
### Security properties tested
|
|
49
|
+
|
|
50
|
+
- [x] **80 rounds / 64-bit message schedule** — covered by 24 AFT spread across the length range (the SHA-384 `_block` runs 80 rounds over emulated 64-bit words).
|
|
51
|
+
- [x] **Bit-level inputs (non-byte-aligned)** — covered by the anchors at lengths 1, 7, 9, 13, 100, 511, 1023, 2047 bits.
|
|
52
|
+
- [x] **FIPS 180-4 §5.1.2 padding** — implicitly validated by the varied lengths (`≥ 896 mod 1024` cases forcing an extra block).
|
|
53
|
+
- [x] **Long-chain stability** — standard MCT: 100,000 consecutive hashes (MSG = 1152 bits); any drift deviates `resultsArray[j]`.
|
|
54
|
+
- [x] **Streaming = one-shot** — `chunked update matches one-shot`.
|
|
55
|
+
- [x] **512→384 truncation** — `digest is 384 bits (12 x 32-bit words)` validates the `slice(0, 12)`.
|
|
56
|
+
- [x] **2^53−1-bit limit** — `update` returns `false` + `console.warn` beyond it.
|
|
57
|
+
- [ ] **Side-channel resistance** — N/A (no secret input by default; HMAC usage handled by `hmac.js`).
|
|
58
|
+
|
|
59
|
+
## FIPS 140-3 conformance
|
|
60
|
+
|
|
61
|
+
| Requirement | Status | Evidence |
|
|
62
|
+
|---|---|---|
|
|
63
|
+
| Approved algorithm | ✅ | FIPS 180-4 §6.5 + ACVP-SHA2-384-1.0 |
|
|
64
|
+
| Validated parameter sizes | ✅ | single 384-bit digest; 0..65535-bit input covered by AFT |
|
|
65
|
+
| Power-on KAT / self-test | ✅ | FIPS-180 vectors + 24 AFT executed on every `bun test` |
|
|
66
|
+
| CT comparisons (if secret) | N/A | Hash module with no secret |
|
|
67
|
+
| No `throw` / timing leak | ✅ | Review: `console.warn` + `return false` |
|
|
68
|
+
|
|
69
|
+
## Known limitations
|
|
70
|
+
|
|
71
|
+
- ~~**LDT not integrated**~~ — resolved in **H1**: tcId=1026 (1 GiB) runs under `CRYPTO_FULL=1` byte-exact.
|
|
72
|
+
- **AFT sub-sampling**: 24/1024 (≈ 2.3%). Choice driven by message size (cap 32000 bits + anchor 65535).
|
|
73
|
+
- **"alternate" MCT version** not tested (ACVP provides `"standard"`).
|
|
74
|
+
- **64-bit emulation as 32-bit pairs**: inherited SJCL implementation; the bit-rotation operations are purely deterministic (no data-dependent path on the arithmetic side).
|
|
75
|
+
|
|
76
|
+
## Cross references
|
|
77
|
+
|
|
78
|
+
- Module: [`hash/sha384.js`](./sha384.js)
|
|
79
|
+
- Tests: [`hash/sha384.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/hash/sha384.test.js) — **31 tests** (30 pass + 1 skip LDT — `CRYPTO_FULL=1` to enable; was 5 before the upgrade)
|
|
80
|
+
- ACVP draft: `references/NIST/ACVP/src/draft-celi-acvp-sha.adoc`
|
|
81
|
+
- Vectors: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/SHA2-384-1.0/`
|
|
82
|
+
- Overall conformance: [`NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @fileoverview SHA-384 hash function (FIPS 180-4 §5.3.4 + §6.5).
|
|
7
|
+
*
|
|
8
|
+
* Truncated SHA-512 variant: same compression function as SHA-512
|
|
9
|
+
* (cf. sha512.js) but with a distinct IV and a 384-bit digest taken
|
|
10
|
+
* from the first 12 × 32-bit words of the final SHA-512 state.
|
|
11
|
+
*
|
|
12
|
+
* Block size: 1024 bits (identical to SHA-512, required for HMAC-SHA-384).
|
|
13
|
+
*
|
|
14
|
+
* **Architecture (post-upgrade audit)**: this module is now a thin wrapper
|
|
15
|
+
* over `sha512._internal.makeSha(_INIT_384, 12)` - previously it duplicated
|
|
16
|
+
* the 120 LOC of the compression function. Mirrors the
|
|
17
|
+
* `sha512_224.js` / `sha512_256.js` pattern.
|
|
18
|
+
*
|
|
19
|
+
*/
|
|
20
|
+
|
|
21
|
+
import { sha512 } from './sha512.js';
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* Streaming SHA-384 hasher instance (truncated SHA-512; bitArray = `number[]` of 32-bit words).
|
|
25
|
+
* @typedef {object} Sha384Hasher
|
|
26
|
+
* @property {number} blockSize Block size in bits (1024).
|
|
27
|
+
* @property {number[]} _init IV (16 × 32-bit halves = 8 × 64-bit lanes).
|
|
28
|
+
* @property {number} _outWords Number of 32-bit words retained in the digest (12).
|
|
29
|
+
* @property {number[]} _key Round constants.
|
|
30
|
+
* @property {() => Sha384Hasher} reset Reset internal state; returns `this`.
|
|
31
|
+
* @property {(data: number[]|string) => (Sha384Hasher|false)} update Absorb a bitArray or UTF-8 string; returns `this`, or `false` on > 2^53-1 bit overflow.
|
|
32
|
+
* @property {() => number[]} finalize Pad and emit the 384-bit digest as a bitArray (12 words).
|
|
33
|
+
* @property {(words: ArrayLike<number>) => void} _block Compress one 32-word (1024-bit) block.
|
|
34
|
+
*/
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* Object returned by `sha384.factory()` (delegates to `sha512._internal.makeSha`).
|
|
38
|
+
* @typedef {object} Sha384API
|
|
39
|
+
* @property {new (hash?: Sha384Hasher) => Sha384Hasher} fn Streaming hasher constructor (optional arg clones an existing instance).
|
|
40
|
+
* @property {(data: number[]|string) => number[]} hash One-shot hash; returns the 384-bit digest as a bitArray.
|
|
41
|
+
*/
|
|
42
|
+
|
|
43
|
+
export const sha384 = {
|
|
44
|
+
name: 'sha384',
|
|
45
|
+
version: '1.0.0',
|
|
46
|
+
type: 'fw.crypto.hash',
|
|
47
|
+
dependencies: ['sha512'],
|
|
48
|
+
deps: [sha512],
|
|
49
|
+
|
|
50
|
+
/** @returns {Sha384API} */
|
|
51
|
+
factory(sha512) {
|
|
52
|
+
// FIPS 180-4 §5.3.4 - IV for SHA-384 (8 × 64-bit, 16 × 32-bit halves).
|
|
53
|
+
const _INIT_384 = [
|
|
54
|
+
0xcbbb9d5d, 0xc1059ed8, 0x629a292a, 0x367cd507, 0x9159015a, 0x3070dd17, 0x152fecd8, 0xf70e5939,
|
|
55
|
+
0x67332667, 0xffc00b31, 0x8eb44a87, 0x68581511, 0xdb0c2e0d, 0x64f98fa7, 0x47b5481d, 0xbefa4fa4
|
|
56
|
+
];
|
|
57
|
+
|
|
58
|
+
// outWords = 12 → 12 × 32-bit = 384 bits (FIPS 180-4 §6.5 truncation).
|
|
59
|
+
return sha512._internal.makeSha(_INIT_384, 12);
|
|
60
|
+
}
|
|
61
|
+
};
|