@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,117 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: wasmEd25519
|
|
3
|
+
category: crypto/wasm
|
|
4
|
+
dependencies: [wasmRuntime]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# wasmEd25519
|
|
11
|
+
|
|
12
|
+
> WASM Ed25519 (RFC 8032) — Tier-2 fallback for Ed25519 when `crypto.subtle` lacks it.
|
|
13
|
+
|
|
14
|
+
**Module** `wasmEd25519` | **Source** `packages/front/fw/src/crypto/wasm/ed25519.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
WASM-backed Ed25519 digital signatures (RFC 8032): keygen, sign, and verify. The binary is the libsodium ref10 closure framed by the `@awacloud/fw-wasm-crypto` package's arena allocator, SHA-512 seam, and staged-entropy RNG seam. Signatures are deterministic (RFC 8032 §5.1 — no nonce randomness).
|
|
17
|
+
|
|
18
|
+
This is the **Tier-2 fallback** for environments where `crypto.subtle` is unavailable (non-secure-context, locked-down workers). In secure contexts prefer [`../webcrypto/ed25519.md`](../webcrypto/ed25519.md), which is hardware-accelerated. The pure-JS [`../pkc/ed25519.md`](../pkc/ed25519.md) remains the universal default.
|
|
19
|
+
|
|
20
|
+
The binary ships **scalar-only** (`ed25519.scalar.wasm`; `simd: false` in targets.json; ref10 has no simd128 lane). The `{ variant: 'scalar' }` option is passed explicitly to `wasmRuntime.load` because the runtime's `selectVariant()` defaults to simd and has no automatic fallback.
|
|
21
|
+
|
|
22
|
+
## Resolve
|
|
23
|
+
|
|
24
|
+
```js
|
|
25
|
+
const wasmEd25519 = runtime.resolve('wasmEd25519');
|
|
26
|
+
// Returns: { isAvailable, keygen, sign, verify }
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## API
|
|
30
|
+
|
|
31
|
+
| Method | Signature | Returns |
|
|
32
|
+
|--------|-----------|---------|
|
|
33
|
+
| `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present |
|
|
34
|
+
| `keygen` | `(seed?: Uint8Array) => Promise<{publicKey: Uint8Array, privateKey: Uint8Array}\|false>` | Fresh Ed25519 key pair |
|
|
35
|
+
| `sign` | `(privateKey: Uint8Array, message: Uint8Array) => Promise<Uint8Array\|false>` | 64-byte detached signature |
|
|
36
|
+
| `verify` | `(publicKey: Uint8Array, signature: Uint8Array, message: Uint8Array) => Promise<boolean>` | `true` / `false` (no-throw) |
|
|
37
|
+
|
|
38
|
+
### Encodings
|
|
39
|
+
|
|
40
|
+
| Item | Encoding | Length |
|
|
41
|
+
|------|----------|--------|
|
|
42
|
+
| `seed` | raw 32-byte secret (optional; drawn from `crypto.getRandomValues` if omitted) | 32 bytes |
|
|
43
|
+
| `publicKey` | compressed Ed25519 point (RFC 8032 encoding) | 32 bytes |
|
|
44
|
+
| `privateKey` | expanded sk = **seed ‖ publicKey** — identical to `pkc/ed25519` format | 64 bytes |
|
|
45
|
+
| `signature` | detached Ed25519 signature **R ‖ s** | 64 bytes |
|
|
46
|
+
|
|
47
|
+
The `privateKey` encoding is the libsodium "expanded sk" (seed concatenated with the compressed public key), which matches the pure-JS `pkc/ed25519` module exactly, enabling full cross-tier signature interoperability.
|
|
48
|
+
|
|
49
|
+
All methods resolve `false` (or `verify` → `false`) when:
|
|
50
|
+
- a key / seed / signature has the wrong byte length, or an argument is not a `Uint8Array`
|
|
51
|
+
- `WebAssembly` is unavailable, or the binary fails to load (fetch error, ABI mismatch)
|
|
52
|
+
- the WASM entry returns a non-zero status (`verify` also returns `false` on a non-matching signature)
|
|
53
|
+
|
|
54
|
+
None of them ever reject.
|
|
55
|
+
|
|
56
|
+
## Examples
|
|
57
|
+
|
|
58
|
+
```js
|
|
59
|
+
const wasmEd25519 = runtime.resolve('wasmEd25519');
|
|
60
|
+
|
|
61
|
+
if (!wasmEd25519.isAvailable()) {
|
|
62
|
+
// Fall back to webcrypto/ed25519 (secure contexts) or pure-JS pkc/ed25519.
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
// Generate a key pair (random seed drawn internally).
|
|
66
|
+
const { publicKey, privateKey } = await wasmEd25519.keygen();
|
|
67
|
+
|
|
68
|
+
// Sign and verify.
|
|
69
|
+
const enc = new TextEncoder();
|
|
70
|
+
const msg = enc.encode('hello');
|
|
71
|
+
|
|
72
|
+
const sig = await wasmEd25519.sign(privateKey, msg); // 64-byte R||s
|
|
73
|
+
const ok = await wasmEd25519.verify(publicKey, sig, msg);
|
|
74
|
+
// ok === true
|
|
75
|
+
|
|
76
|
+
// Deterministic keygen from a fixed seed (RFC 8032 §7.1 TEST 1).
|
|
77
|
+
function hexToBytes(h) {
|
|
78
|
+
const o = new Uint8Array(h.length / 2);
|
|
79
|
+
for (let i = 0; i < o.length; i++) o[i] = parseInt(h.slice(i * 2, i * 2 + 2), 16);
|
|
80
|
+
return o;
|
|
81
|
+
}
|
|
82
|
+
const seed = hexToBytes('9d61b19deffd5a60ba844af492ec2cc44449c5697b326919703bac031cae7f60');
|
|
83
|
+
const kp = await wasmEd25519.keygen(seed);
|
|
84
|
+
// kp.publicKey === d75a980182b10ab7d54bfed3c964073a0ee172f3daa62325af021a68f707511a
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
## Worker Usage
|
|
88
|
+
|
|
89
|
+
```js
|
|
90
|
+
const worker = fw.createWorker(
|
|
91
|
+
function ({ libs }) {
|
|
92
|
+
// wasmRuntime fetches the colocated .wasm by name inside the worker —
|
|
93
|
+
// no main-thread closure is serialized.
|
|
94
|
+
libs.wasmEd25519.keygen().then((kp) => {
|
|
95
|
+
self.postMessage(kp !== false);
|
|
96
|
+
});
|
|
97
|
+
},
|
|
98
|
+
{ dependencies: ['wasmEd25519'] }
|
|
99
|
+
);
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
## Notes
|
|
103
|
+
|
|
104
|
+
- **Prefer WebCrypto in secure contexts**: `webcrypto/ed25519` is hardware-accelerated where `crypto.subtle` supports Ed25519 (Chrome 113+, Firefox 130+, Safari 17+). Use `wasmEd25519` only when `crypto.subtle` is unavailable or Ed25519 is not yet in the browser's `subtle`.
|
|
105
|
+
- **RFC 8032 compliance**: signatures are standard Ed25519 (RFC 8032 §5.1 / FIPS 186-5 §7.6) — interoperable with OpenSSL, libsodium, and all compliant implementations.
|
|
106
|
+
- **Cross-tier interoperability**: the 64-byte `privateKey` format (seed ‖ publicKey) is identical between `wasmEd25519` and `pkc/ed25519`. A key pair generated in one tier can be used directly in the other for both signing and verification.
|
|
107
|
+
- **Scalar-only**: `ed25519.simd.wasm` is not shipped (ref10 has no simd128 lane). The `{ variant: 'scalar' }` pin is mandatory; a default load would fail on the missing SIMD binary.
|
|
108
|
+
- **No-throw contract**: all methods resolve to a value or `false`; they never reject. Input validation (lengths, `instanceof Uint8Array`) happens before any WASM call.
|
|
109
|
+
- **Output is always a fresh copy**: `readBytes` copies out of WASM linear memory into a new `Uint8Array`. The caller owns the returned buffer.
|
|
110
|
+
- **RNG seam not used for keygen**: the binary exports `rng_stage`/`rng_reset` (the ABI triple), but `ed25519_keypair` is SEED-EXPLICIT (`crypto_sign_ed25519_seed_keypair`) — it does not use the rng seam. The seed is always supplied by the JS layer (from the caller or from `crypto.getRandomValues`).
|
|
111
|
+
|
|
112
|
+
## See also
|
|
113
|
+
|
|
114
|
+
- [wasmRuntime](./runtime.md) — shared WASM loader adapter
|
|
115
|
+
- [webcrypto/ed25519](../webcrypto/ed25519.md) — HW-backed Ed25519 in secure contexts (prefer this)
|
|
116
|
+
- [pkc/ed25519](../pkc/ed25519.md) — pure-JS Ed25519 (universal default; same key format)
|
|
117
|
+
- [wasm/x25519](./x25519.md) — WASM X25519 key agreement (Curve25519)
|
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: wasmHkdf
|
|
3
|
+
category: crypto/wasm
|
|
4
|
+
dependencies: [wasmRuntime]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# wasmHkdf
|
|
11
|
+
|
|
12
|
+
> WASM HKDF (RFC 5869), Tier-2 fallback, async, Uint8Array.
|
|
13
|
+
|
|
14
|
+
**Module** `wasmHkdf` | **Source** `packages/front/fw/src/crypto/wasm/hkdf.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
WASM-backed wrapper over the `@awacloud/fw-wasm-crypto` `hkdf` binary. Exposes
|
|
17
|
+
combined HKDF extract+expand (RFC 5869) over HMAC-SHA-256/384/512 as an
|
|
18
|
+
async, no-throw primitive over `Uint8Array`. This is the **Tier-2 fallback**
|
|
19
|
+
for environments where `crypto.subtle` is unavailable (non-secure contexts,
|
|
20
|
+
locked-down workers). In secure contexts, prefer
|
|
21
|
+
[`../webcrypto/hkdf.md`](../webcrypto/hkdf.md).
|
|
22
|
+
|
|
23
|
+
The binary ships as `hkdf.scalar.wasm` ONLY (`"simd": false` in
|
|
24
|
+
targets.json). The load explicitly passes `{ variant: 'scalar' }` because
|
|
25
|
+
`selectVariant` defaults to `simd` with no automatic fallback (no
|
|
26
|
+
`hkdf.simd.wasm` exists in dist).
|
|
27
|
+
|
|
28
|
+
## Resolve
|
|
29
|
+
|
|
30
|
+
```js
|
|
31
|
+
const wasmHkdf = runtime.resolve('wasmHkdf');
|
|
32
|
+
// Returns: { isAvailable, deriveBits }
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
## API
|
|
36
|
+
|
|
37
|
+
| Method | Signature | Returns |
|
|
38
|
+
|--------|-----------|---------|
|
|
39
|
+
| `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present in this environment |
|
|
40
|
+
| `deriveBits` | `(ikm, salt, info, dkLen, hash?) => Promise<Uint8Array\|false>` | `dkLen` bytes of OKM, or `false` on failure |
|
|
41
|
+
|
|
42
|
+
### `deriveBits(ikm, salt, info, dkLen, hash?)`
|
|
43
|
+
|
|
44
|
+
Performs the complete RFC 5869 HKDF extract-then-expand in a single call.
|
|
45
|
+
|
|
46
|
+
| Parameter | Type | Description |
|
|
47
|
+
|-----------|------|-------------|
|
|
48
|
+
| `ikm` | `Uint8Array` | Input keying material. |
|
|
49
|
+
| `salt` | `Uint8Array` | Optional salt; an empty `Uint8Array` is valid (the shim substitutes `HashLen` zero bytes per RFC 5869 §2.2). |
|
|
50
|
+
| `info` | `Uint8Array` | Optional context/application info; an empty `Uint8Array` is valid. |
|
|
51
|
+
| `dkLen` | `number` | Desired output length in **bytes**; must be ≥ 1 and ≤ 255 × hashLen. |
|
|
52
|
+
| `hash` | `256\|384\|512` | Underlying SHA-2 hash strength (default: `256`). |
|
|
53
|
+
|
|
54
|
+
Returns `false` (never rejects) when:
|
|
55
|
+
- any of `ikm`, `salt`, or `info` is not a `Uint8Array`
|
|
56
|
+
- `hash` is not `256`, `384`, or `512`
|
|
57
|
+
- `dkLen < 1` or `dkLen > 255 × hashLen`
|
|
58
|
+
- the WASM binary fails to load (WebAssembly unavailable, fetch/compile error, ABI mismatch)
|
|
59
|
+
- the binary returns a non-zero status (internal error)
|
|
60
|
+
|
|
61
|
+
### Hash lengths
|
|
62
|
+
|
|
63
|
+
| `hash` | `hashLen` | Max `dkLen` |
|
|
64
|
+
|--------|-----------|-------------|
|
|
65
|
+
| `256` | 32 bytes | 8160 bytes |
|
|
66
|
+
| `384` | 48 bytes | 12240 bytes |
|
|
67
|
+
| `512` | 64 bytes | 16320 bytes |
|
|
68
|
+
|
|
69
|
+
### WASM ABI
|
|
70
|
+
|
|
71
|
+
The binary exports a single entry point:
|
|
72
|
+
|
|
73
|
+
```
|
|
74
|
+
hkdf(hashId, ikmPtr, ikmLen, saltPtr, saltLen,
|
|
75
|
+
infoPtr, infoLen, outPtr, outLen) -> i32
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
`hashId` maps to: `256` → HMAC-SHA-256, `384` → HMAC-SHA-384,
|
|
79
|
+
`512` → HMAC-SHA-512. Return `0` = OK; `-1` (WC_EBADPARAM) = bad `hashId`,
|
|
80
|
+
`outLen ≤ 0`, or `outLen > 255×HashLen`; `-2` (WC_EFAIL) = expand error.
|
|
81
|
+
Zero-length `ikmLen`/`saltLen`/`infoLen` are valid.
|
|
82
|
+
|
|
83
|
+
## Examples
|
|
84
|
+
|
|
85
|
+
### One-shot key derivation (HKDF-SHA-256)
|
|
86
|
+
|
|
87
|
+
```js
|
|
88
|
+
const wasmHkdf = runtime.resolve('wasmHkdf');
|
|
89
|
+
|
|
90
|
+
const ikm = crypto.getRandomValues(new Uint8Array(32));
|
|
91
|
+
const salt = new Uint8Array(32); // or a random salt
|
|
92
|
+
const info = new TextEncoder().encode('my-app/v1/aes-key');
|
|
93
|
+
|
|
94
|
+
const key = await wasmHkdf.deriveBits(ikm, salt, info, 32);
|
|
95
|
+
if (key === false) {
|
|
96
|
+
// WebAssembly unavailable — fall back to webcrypto/hkdf or hash/hkdf.
|
|
97
|
+
return;
|
|
98
|
+
}
|
|
99
|
+
console.log(key); // Uint8Array(32)
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
### With HMAC-SHA-512
|
|
103
|
+
|
|
104
|
+
```js
|
|
105
|
+
const okm = await wasmHkdf.deriveBits(ikm, salt, info, 64, 512);
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
### Empty salt (RFC 5869 §2.2)
|
|
109
|
+
|
|
110
|
+
```js
|
|
111
|
+
// Zero-length salt is valid — the shim uses HashLen zero bytes internally.
|
|
112
|
+
const okm = await wasmHkdf.deriveBits(ikm, new Uint8Array(0), info, 32);
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
### Feature detection
|
|
116
|
+
|
|
117
|
+
```js
|
|
118
|
+
if (!wasmHkdf.isAvailable()) {
|
|
119
|
+
// No WebAssembly — use webcrypto/hkdf or hash/hkdf.
|
|
120
|
+
}
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
## Worker Usage
|
|
124
|
+
|
|
125
|
+
```js
|
|
126
|
+
const worker = fw.createWorker(
|
|
127
|
+
function ({ libs }) {
|
|
128
|
+
const ikm = new Uint8Array(32);
|
|
129
|
+
const salt = new Uint8Array(16);
|
|
130
|
+
const info = new Uint8Array(0);
|
|
131
|
+
libs.wasmHkdf.deriveBits(ikm, salt, info, 32).then((key) => {
|
|
132
|
+
self.postMessage(key !== false ? Array.from(key) : null);
|
|
133
|
+
});
|
|
134
|
+
},
|
|
135
|
+
{ dependencies: ['wasmHkdf'] }
|
|
136
|
+
);
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
## Notes
|
|
140
|
+
|
|
141
|
+
- **Combined extract+expand**: `deriveBits` runs the full RFC 5869 pipeline
|
|
142
|
+
(HKDF-Extract then HKDF-Expand) in one call. Separate extract/expand
|
|
143
|
+
stages are not exposed; use [`../hash/hkdf.md`](../hash/hkdf.md) if you
|
|
144
|
+
need them.
|
|
145
|
+
- **Scalar-only**: unlike most `crypto/wasm/` modules there is no SIMD
|
|
146
|
+
variant. `{ variant: 'scalar' }` is pinned at load time.
|
|
147
|
+
- **No-throw contract**: all methods are `async` and resolve to a result
|
|
148
|
+
or `false`; they never reject. Validation errors and load failures are
|
|
149
|
+
logged to `console.error` with the `[crypto]` prefix.
|
|
150
|
+
- **Output is a fresh copy**: `wasmRuntime.readBytes` copies bytes OUT of
|
|
151
|
+
linear memory into a new `Uint8Array` — the returned buffer never aliases
|
|
152
|
+
WASM memory.
|
|
153
|
+
- **Parity with pure-JS**: the WASM module produces byte-for-byte identical
|
|
154
|
+
output to the pure-JS [`../hash/hkdf.md`](../hash/hkdf.md) module for the
|
|
155
|
+
same RFC 5869 vectors (verified by the test suite).
|
|
156
|
+
- **SHA-1 not supported**: only `hashId` 256/384/512 are accepted. RFC 5869
|
|
157
|
+
Appendix A test cases A.4–A.7 (SHA-1) are not applicable.
|
|
158
|
+
|
|
159
|
+
## See also
|
|
160
|
+
|
|
161
|
+
- [`../webcrypto/hkdf.md`](../webcrypto/hkdf.md) — WebCrypto HKDF (preferred in secure contexts)
|
|
162
|
+
- [`../hash/hkdf.md`](../hash/hkdf.md) — pure-JS HKDF module (universal default, synchronous, bitArray)
|
|
163
|
+
- [`./runtime.md`](./runtime.md) — the shared WASM loader adapter all `crypto/wasm/*` wrappers use
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: wasmHmac
|
|
3
|
+
category: crypto/wasm
|
|
4
|
+
dependencies: [wasmRuntime]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# wasmHmac
|
|
11
|
+
|
|
12
|
+
> WASM-loaded HMAC-SHA-256/384/512 (FIPS 198-1 / RFC 2104): MAC compute and constant-time verify. Async, `Uint8Array`, no-throw.
|
|
13
|
+
|
|
14
|
+
**Module** `wasmHmac` | **Source** `packages/front/fw/src/crypto/wasm/hmac.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
HMAC is covered by WebCrypto (`crypto.subtle.sign('HMAC', …)`); this WASM tier is the **non-secure-context fallback** for environments where `crypto.subtle` is absent (locked-down workers, non-secure origins). Prefer [`webcrypto/hmac`](../webcrypto/hmac.md) in secure contexts and the pure-JS [`hmac`](../hash/hmac.md) as the universal default.
|
|
17
|
+
|
|
18
|
+
This wrapper loads the delivered [`@awacloud/fw-wasm-crypto`](https://www.npmjs.com/package/@awacloud/fw-wasm-crypto) `hmac` binary — own C23 HMAC framing (`csrc/hmac/hmac.c`) over the own SHA-2 core (`csrc/sha2/sha2.c`) — through [`wasmRuntime`](./runtime.md) and exposes an async surface for MAC computation and constant-time verification.
|
|
19
|
+
|
|
20
|
+
The `hmac` target is **scalar-only** (`simd:false` in `targets.json` — SHA-2 + HMAC get marginal gain from simd128). There is no `hmac.simd.wasm`; `wasmHmac` forces `{ variant: 'scalar' }` when loading.
|
|
21
|
+
|
|
22
|
+
## Resolve
|
|
23
|
+
|
|
24
|
+
```js
|
|
25
|
+
const wasmHmac = runtime.resolve('wasmHmac');
|
|
26
|
+
// Returns: { isAvailable, mac, verify }
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## API
|
|
30
|
+
|
|
31
|
+
| Method | Signature | Returns |
|
|
32
|
+
|--------|-----------|---------|
|
|
33
|
+
| `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present (mirrors `wasmRuntime`) |
|
|
34
|
+
| `mac` | `(key: Uint8Array, data: Uint8Array, hash?: 256\|384\|512) => Promise<Uint8Array\|false>` | The HMAC tag (32/48/64 bytes), or `false` |
|
|
35
|
+
| `verify` | `(key: Uint8Array, tag: Uint8Array, data: Uint8Array, hash?: 256\|384\|512) => Promise<boolean>` | Recompute tag then **constant-time** compare against `tag` |
|
|
36
|
+
|
|
37
|
+
### Parameter constraints
|
|
38
|
+
|
|
39
|
+
| Parameter | Constraint |
|
|
40
|
+
|-----------|-----------|
|
|
41
|
+
| `key` | `Uint8Array`, any byte length (if > block size, hashed first per RFC 2104) |
|
|
42
|
+
| `data` | `Uint8Array`, any byte length including `0` |
|
|
43
|
+
| `hash` | `256` (default) \| `384` \| `512`; selects HMAC-SHA-256 / 384 / 512 |
|
|
44
|
+
| `tag` (verify) | `Uint8Array`, length must equal digest size (32/48/64 bytes) |
|
|
45
|
+
|
|
46
|
+
`mac`/`verify` resolve `false` (never throw) when:
|
|
47
|
+
|
|
48
|
+
- a parameter is invalid (`[crypto] INVALID: …` logged): `key`/`data` not a `Uint8Array`, `hash ∉ {256, 384, 512}`;
|
|
49
|
+
- the binary cannot load — `WebAssembly` unavailable, fetch/compile failure, or ABI mismatch (`[crypto] FAIL: …` logged by `wasmRuntime.load`);
|
|
50
|
+
- the WASM call returns a non-zero status (unknown `hashId`).
|
|
51
|
+
|
|
52
|
+
`verify` additionally returns `false` when `tag` is not a `Uint8Array` or when the constant-time comparison fails.
|
|
53
|
+
|
|
54
|
+
## Examples
|
|
55
|
+
|
|
56
|
+
### Compute HMAC-SHA-256
|
|
57
|
+
|
|
58
|
+
```js
|
|
59
|
+
const key = crypto.getRandomValues(new Uint8Array(32));
|
|
60
|
+
const data = new TextEncoder().encode('authenticated payload');
|
|
61
|
+
const tag = await wasmHmac.mac(key, data, 256);
|
|
62
|
+
if (tag === false) {
|
|
63
|
+
// WASM unavailable or bad params — fall back to webcrypto/hmac or pure-JS hmac.
|
|
64
|
+
}
|
|
65
|
+
// tag is a 32-byte Uint8Array.
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
### Compute HMAC-SHA-512
|
|
69
|
+
|
|
70
|
+
```js
|
|
71
|
+
const tag512 = await wasmHmac.mac(key, data, 512);
|
|
72
|
+
// tag512 is a 64-byte Uint8Array.
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
### Constant-time verify
|
|
76
|
+
|
|
77
|
+
```js
|
|
78
|
+
const ok = await wasmHmac.verify(key, storedTag, data, 256);
|
|
79
|
+
// true only if the recomputed HMAC-SHA-256 tag matches storedTag byte-for-byte.
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### RFC 4231 Test Case 1 (HMAC-SHA-256)
|
|
83
|
+
|
|
84
|
+
```js
|
|
85
|
+
const key = new Uint8Array(20).fill(0x0b);
|
|
86
|
+
const data = new TextEncoder().encode('Hi There');
|
|
87
|
+
const tag = await wasmHmac.mac(key, data, 256);
|
|
88
|
+
// hex(tag) === 'b0344c61d8db38535ca8afceaf0bf12b881dc200c9833da726e9376c2e32cff7'
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
### Default hash is SHA-256
|
|
92
|
+
|
|
93
|
+
```js
|
|
94
|
+
// These two calls are equivalent:
|
|
95
|
+
const a = await wasmHmac.mac(key, data);
|
|
96
|
+
const b = await wasmHmac.mac(key, data, 256);
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
## Worker Usage
|
|
100
|
+
|
|
101
|
+
```js
|
|
102
|
+
// wasmHmac is worker-safe: all constants are inside factory() and the
|
|
103
|
+
// binary is fetched by wasmRuntime's package loader via import.meta.url.
|
|
104
|
+
const worker = fw.createWorker(() => {
|
|
105
|
+
const wasmHmac = runtime.resolve('wasmHmac');
|
|
106
|
+
self.onmessage = async ({ data }) => {
|
|
107
|
+
const { key, message } = data;
|
|
108
|
+
const tag = await wasmHmac.mac(key, message, 256);
|
|
109
|
+
self.postMessage(tag);
|
|
110
|
+
};
|
|
111
|
+
});
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
## Notes
|
|
115
|
+
|
|
116
|
+
- **WebCrypto covers HMAC.** Use [`webcrypto/hmac`](../webcrypto/hmac.md) in secure contexts; this WASM tier is for non-secure-context fallback only.
|
|
117
|
+
- **Scalar-only binary.** The SHA-2 core has marginal simd128 gain; `wasmHmac` forces `{ variant: 'scalar' }` because there is no `hmac.simd.wasm`.
|
|
118
|
+
- **Key hashing.** If `key.length` exceeds the SHA-2 block size (64 bytes for SHA-256; 128 bytes for SHA-384/512), the WASM shim hashes the key first per RFC 2104 §2.
|
|
119
|
+
- **Empty key and empty data are valid.** A zero-length key is zero-padded to the block size; a zero-length message is a well-specified HMAC input.
|
|
120
|
+
- **Constant-time verify.** The byte comparison scans the full tag length without early exit; a length mismatch returns `false` immediately (tag length is not secret).
|
|
121
|
+
- **Output is copied OUT** of WASM linear memory into a fresh `Uint8Array` (never a view that could alias reused memory).
|
|
122
|
+
- **No-throw contract.** Every failure path resolves to `false` after a `console.error`; nothing rejects.
|
|
123
|
+
- **RFC 4231 KAT.** The WASM binary is validated against the NIST ACVP HMAC-SHA2-{256,384,512}-2.0 corpus; RFC 4231 literals are also verified.
|
|
124
|
+
|
|
125
|
+
## See also
|
|
126
|
+
|
|
127
|
+
- [crypto/webcrypto/hmac](../webcrypto/hmac.md) — the WebCrypto HMAC wrapper (preferred in secure contexts)
|
|
128
|
+
- [crypto/hash/hmac](../hash/hmac.md) — the pure-JS HMAC reference (universal default, bitArray API)
|
|
129
|
+
- [crypto/wasm/runtime](./runtime.md) — the shared WASM loader adapter
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: wasmMlDsa
|
|
3
|
+
category: crypto/wasm
|
|
4
|
+
dependencies: [wasmRuntime]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# wasmMlDsa
|
|
11
|
+
|
|
12
|
+
> WASM-loaded ML-DSA (FIPS 204): post-quantum lattice signatures (44/65/87). Async, `Uint8Array`, no-throw.
|
|
13
|
+
|
|
14
|
+
**Module** `wasmMlDsa` | **Source** `packages/front/fw/src/crypto/wasm/ml_dsa.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
ML-DSA (Module-Lattice-based Digital Signature Algorithm, a.k.a. CRYSTALS-Dilithium) is the NIST FIPS 204 post-quantum signature scheme. It is **not** in WebCrypto, so this WASM tier — or the pure-JS [`ml_dsa`](../pkc/ml_dsa.md) — is the only path. This module loads the delivered [`@awacloud/fw-wasm-crypto`](https://www.npmjs.com/package/@awacloud/fw-wasm-crypto) `ml_dsa` binary (PQClean ml-dsa-{44,65,87}) through [`wasmRuntime`](./runtime.md) and exposes an async surface that mirrors the pure-JS module's pure-ML-DSA keygen/sign/verify, faster.
|
|
17
|
+
|
|
18
|
+
Three parameter sets are exposed via a `paramSet` argument: **44** (NIST level 2), **65** (level 3, the default), **87** (level 5). Only the **pure** FIPS-204 interface (external, no pre-hash) is exposed — HashML-DSA (pre-hash) and the internal/externalMu interfaces are out of scope (the pure-JS module covers them). Keygen and signing draw their FIPS-204 randomness from `crypto.getRandomValues`; signing is **hedged** (a fresh 32-byte `rnd` per call).
|
|
19
|
+
|
|
20
|
+
## Resolve
|
|
21
|
+
|
|
22
|
+
```js
|
|
23
|
+
const wasmMlDsa = runtime.resolve('wasmMlDsa');
|
|
24
|
+
// Returns: { isAvailable, keygen, sign, verify }
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## API
|
|
28
|
+
|
|
29
|
+
| Method | Signature | Returns |
|
|
30
|
+
|--------|-----------|---------|
|
|
31
|
+
| `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present (mirrors `wasmRuntime`) |
|
|
32
|
+
| `keygen` | `(paramSet?: 44\|65\|87) => Promise<{publicKey: Uint8Array, secretKey: Uint8Array}\|false>` | A fresh random key pair, or `false` |
|
|
33
|
+
| `sign` | `(secretKey: Uint8Array, message: Uint8Array, ctx?: Uint8Array, paramSet?: 44\|65\|87) => Promise<Uint8Array\|false>` | The signature (hedged), or `false` |
|
|
34
|
+
| `verify` | `(publicKey: Uint8Array, signature: Uint8Array, message: Uint8Array, ctx?: Uint8Array, paramSet?: 44\|65\|87) => Promise<boolean>` | `true` iff the signature is valid |
|
|
35
|
+
|
|
36
|
+
### Sizes per parameter set (bytes)
|
|
37
|
+
|
|
38
|
+
| `paramSet` | publicKey | secretKey | signature |
|
|
39
|
+
|-----------|-----------|-----------|-----------|
|
|
40
|
+
| `44` | 1312 | 2560 | 2420 |
|
|
41
|
+
| `65` (default) | 1952 | 4032 | 3309 |
|
|
42
|
+
| `87` | 2592 | 4896 | 4627 |
|
|
43
|
+
|
|
44
|
+
`keygen`/`sign` resolve `false` (never throw) when:
|
|
45
|
+
|
|
46
|
+
- `paramSet ∉ {44, 65, 87}` (`[crypto] INVALID: …` logged);
|
|
47
|
+
- `secretKey` is not a `Uint8Array` of the parameter set's length, `message` is not a `Uint8Array`, or `ctx` is not a `Uint8Array` ≤ 255 bytes;
|
|
48
|
+
- the binary cannot load — `WebAssembly` unavailable, fetch/compile failure, or ABI mismatch (`[crypto] FAIL: …` logged by `wasmRuntime.load`);
|
|
49
|
+
- the WASM call returns a non-zero status.
|
|
50
|
+
|
|
51
|
+
`verify` resolves `false` on the same invalid-input conditions and whenever the signature does not validate (tampered signature, tampered message, wrong `ctx`, or wrong key).
|
|
52
|
+
|
|
53
|
+
## Examples
|
|
54
|
+
|
|
55
|
+
### Generate a key pair, sign, verify
|
|
56
|
+
|
|
57
|
+
```js
|
|
58
|
+
const enc = new TextEncoder();
|
|
59
|
+
const kp = await wasmMlDsa.keygen(65); // default level 3
|
|
60
|
+
if (kp === false) { /* WASM unavailable — fall back to pure-JS ml_dsa */ }
|
|
61
|
+
|
|
62
|
+
const msg = enc.encode('hello post-quantum');
|
|
63
|
+
const sig = await wasmMlDsa.sign(kp.secretKey, msg); // hedged
|
|
64
|
+
const ok = await wasmMlDsa.verify(kp.publicKey, sig, msg); // → true
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
### Domain-separate with a context string
|
|
68
|
+
|
|
69
|
+
```js
|
|
70
|
+
const ctx = enc.encode('my-app:v1');
|
|
71
|
+
const sig = await wasmMlDsa.sign(kp.secretKey, msg, ctx, 87); // level 5
|
|
72
|
+
// Verification must supply the SAME ctx, or it returns false.
|
|
73
|
+
const ok = await wasmMlDsa.verify(kp.publicKey, sig, msg, ctx, 87);
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### Tamper detection
|
|
77
|
+
|
|
78
|
+
```js
|
|
79
|
+
const bad = Uint8Array.from(sig);
|
|
80
|
+
bad[0] ^= 0xff;
|
|
81
|
+
await wasmMlDsa.verify(kp.publicKey, bad, msg); // → false
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## Notes
|
|
85
|
+
|
|
86
|
+
- **FIPS 204 (August 2024).** Implements pure ML-DSA (external interface, no pre-hash). The byte-for-byte FIPS-204 ACVP / Wycheproof KAT (ML-DSA-65, deterministic) is verified in the test suite against the delivered binary.
|
|
87
|
+
- **Not in WebCrypto.** `crypto.subtle` has no ML-DSA; this WASM tier or the pure-JS [`ml_dsa`](../pkc/ml_dsa.md) is the only path. Parity: both reproduce the same FIPS-204 KAT signature.
|
|
88
|
+
- **Hedged signing.** Each `sign` call stages a fresh 32-byte `rnd` from `crypto.getRandomValues`, so signatures are non-deterministic by design (FIPS 204 §5.4 hedged mode). Verification is deterministic.
|
|
89
|
+
- **SIMD where it helps.** The `ml_dsa` target ships both `simd` and `scalar` builds; `wasmRuntime` picks the SIMD variant when the host validates simd128, else scalar — both produce identical, KAT-conformant signatures.
|
|
90
|
+
- **Output is copied OUT** of WASM linear memory into fresh `Uint8Array`s (never a view that could alias reused memory).
|
|
91
|
+
- **No-throw contract.** Every failure path resolves to `false` after a `console.error`; nothing rejects.
|
|
92
|
+
|
|
93
|
+
## See also
|
|
94
|
+
|
|
95
|
+
- [crypto/pkc/ml_dsa](../pkc/ml_dsa.md) — the pure-JS ML-DSA reference (same FIPS 204 algorithm, universal default, + HashML-DSA / internal interfaces)
|
|
96
|
+
- [crypto/wasm/ml_kem](./ml_kem.md) — ML-KEM (FIPS 203), the post-quantum KEM companion
|
|
97
|
+
- [crypto/wasm/slh_dsa](./slh_dsa.md) — SLH-DSA (FIPS 205), the hash-based post-quantum signature alternative
|
|
98
|
+
- [crypto/wasm/runtime](./runtime.md) — the shared WASM loader adapter
|
|
99
|
+
- [crypto/wasm README](./README.md) — the WASM primitive family overview
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: wasmMlKem
|
|
3
|
+
category: crypto/wasm
|
|
4
|
+
returns: object
|
|
5
|
+
worker-safe: true
|
|
6
|
+
status: complete
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# wasmMlKem
|
|
10
|
+
|
|
11
|
+
> WASM-SIMD ML-KEM (FIPS 203) post-quantum key encapsulation — 512 / 768 / 1024.
|
|
12
|
+
|
|
13
|
+
**Module** `wasmMlKem` | **Source** `packages/front/fw/src/crypto/wasm/ml_kem.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
|
|
14
|
+
|
|
15
|
+
Opt-in WASM accelerator for the pure-JS [`ml_kem`](../pkc/ml_kem.md) module. A thin async wrapper over the `@awacloud/fw-wasm-crypto` `ml_kem` binary, loaded **by name** through [`wasmRuntime`](./runtime.md) — there is no fw-local `ml_kem.wasm.js`; the bytes ship in the package's `dist/ml_kem.{simd,scalar}.wasm`. The large lattice / NTT inner loops are where WASM-SIMD beats pure JS, so this is the primary accelerator for ML-KEM.
|
|
16
|
+
|
|
17
|
+
Post-quantum KEM — **not** part of WebCrypto. Use it to replace ECDH where quantum resistance is required (hybrid PQ + classical recommended).
|
|
18
|
+
|
|
19
|
+
## Resolve
|
|
20
|
+
|
|
21
|
+
```js
|
|
22
|
+
const wasmMlKem = runtime.resolve('wasmMlKem');
|
|
23
|
+
// Returns: { isAvailable, keygen, encaps, decaps }
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## API
|
|
27
|
+
|
|
28
|
+
| ParamSet | Security (PQ) | publicKey (ek) | secretKey (dk) | ciphertext | sharedSecret |
|
|
29
|
+
|----------|---------------|----------------|----------------|------------|--------------|
|
|
30
|
+
| `512` | NIST PQC Level 1 (≈ AES-128) | 800 B | 1632 B | 768 B | 32 B |
|
|
31
|
+
| `768` (default) | NIST PQC Level 3 (≈ AES-192) | 1184 B | 2400 B | 1088 B | 32 B |
|
|
32
|
+
| `1024` | NIST PQC Level 5 (≈ AES-256) | 1568 B | 3168 B | 1568 B | 32 B |
|
|
33
|
+
|
|
34
|
+
| Method | Signature | Returns |
|
|
35
|
+
|--------|-----------|---------|
|
|
36
|
+
| `isAvailable` | `() => boolean` | `true` when the WASM runtime is present |
|
|
37
|
+
| `keygen` | `(paramSet?: 512\|768\|1024) => Promise<{publicKey, secretKey}\|false>` | ML-KEM.KeyGen (CSPRNG); `false` on bad param set / failure |
|
|
38
|
+
| `encaps` | `(publicKey: Uint8Array, paramSet?) => Promise<{ciphertext, sharedSecret}\|false>` | ML-KEM.Encaps; `false` on bad param set / key length |
|
|
39
|
+
| `decaps` | `(secretKey: Uint8Array, ciphertext: Uint8Array, paramSet?) => Promise<Uint8Array\|false>` | 32-byte shared secret (implicit reject); `false` on bad param set / length |
|
|
40
|
+
|
|
41
|
+
`paramSet` defaults to `768`. All inputs and outputs are `Uint8Array`.
|
|
42
|
+
|
|
43
|
+
## Examples
|
|
44
|
+
|
|
45
|
+
### KEM end-to-end
|
|
46
|
+
|
|
47
|
+
```js
|
|
48
|
+
// Receiver
|
|
49
|
+
const { publicKey, secretKey } = await wasmMlKem.keygen(768);
|
|
50
|
+
if (publicKey === undefined) { /* keygen returned false — fall back */ }
|
|
51
|
+
|
|
52
|
+
// Sender (has publicKey)
|
|
53
|
+
const enc = await wasmMlKem.encaps(publicKey, 768);
|
|
54
|
+
// enc.ciphertext → wire ; enc.sharedSecret → symmetric key
|
|
55
|
+
|
|
56
|
+
// Receiver (has ciphertext)
|
|
57
|
+
const sharedSecret = await wasmMlKem.decaps(secretKey, enc.ciphertext, 768);
|
|
58
|
+
// sharedSecret equals enc.sharedSecret (32 bytes)
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### Hybrid PQ + classical (TLS-style)
|
|
62
|
+
|
|
63
|
+
```js
|
|
64
|
+
const Z = await wasmMlKem.decaps(secretKey, ciphertext, 768); // post-quantum
|
|
65
|
+
const T = ecdh.derive(...); // classical ECDH
|
|
66
|
+
const ikm = bitArray.concat(Z, T); // SP 800-56C Cr2
|
|
67
|
+
const okm = hkdf.derive(salt, ikm, info, 256);
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
### Feature detection / fallback
|
|
71
|
+
|
|
72
|
+
```js
|
|
73
|
+
if (!wasmMlKem.isAvailable()) {
|
|
74
|
+
// WebAssembly unavailable — use the pure-JS ml_kem (crypto/pkc) tier.
|
|
75
|
+
}
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Notes
|
|
79
|
+
|
|
80
|
+
- **FIPS 203** (CRYSTALS-Kyber), August 2024 final. Validated byte-for-byte against the published ML-KEM-768 KAT (and the pure-JS `ml_kem` module — both deterministic for a fixed seed, so they agree exactly).
|
|
81
|
+
- **Post-quantum**; **not** in WebCrypto. The WASM tier is the accelerator for the algorithms `crypto.subtle` does not cover.
|
|
82
|
+
- **Implicit reject** (FIPS 203 §6.3): `decaps` of a tampered ciphertext returns a pseudo-random 32-byte secret — **not** `false`. The caller must not branch on this; only a higher-level protocol detects the mismatch (the secrets simply will not agree).
|
|
83
|
+
- **No-throw**: every method is `async` and resolves to its result or `false`; it never rejects. `false` means an invalid param set, a wrong key/ciphertext length, an unavailable binary, or an internal failure.
|
|
84
|
+
- **Entropy**: `keygen` / `encaps` stage fresh `crypto.getRandomValues` bytes into the binary's derandomized seam (64 bytes `d || z` for keygen, 32 bytes `m` for encaps) before each call; `decaps` consumes none.
|
|
85
|
+
- **Software, not hardware**: portable SIMD speeds the software implementation; it exposes no CPU crypto instructions.
|
|
86
|
+
|
|
87
|
+
## See also
|
|
88
|
+
|
|
89
|
+
- [crypto/pkc/ml_kem](../pkc/ml_kem.md) — the pure-JS ML-KEM (universal default)
|
|
90
|
+
- [crypto/wasm/ml_dsa](./ml_dsa.md) — WASM ML-DSA post-quantum signatures
|
|
91
|
+
- [crypto/wasm/runtime](./runtime.md) — the shared WASM loader adapter
|