@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,113 @@
|
|
|
1
|
+
# `x25519.js` — RFC interop conformance
|
|
2
|
+
|
|
3
|
+
> **STATUS: RFC interop — outside NIST/CAVP validation.**
|
|
4
|
+
> X25519 is not a FIPS 140-3 approved algorithm (NIST/SP 800-186
|
|
5
|
+
> retains ECDH P-{224,256,384,521}; Curve25519 / X25519 remains
|
|
6
|
+
> outside the scope of FIPS-validated modules despite being widely
|
|
7
|
+
> deployed in TLS 1.3, Noise, Signal, OpenSSH, WireGuard). No ACVP
|
|
8
|
+
> vector published by NIST. Coverage is exclusively RFC 7748 + Wycheproof.
|
|
9
|
+
|
|
10
|
+
## Standards
|
|
11
|
+
|
|
12
|
+
- **Primary**: **RFC 7748** — *Elliptic Curves for Security* (January
|
|
13
|
+
2016), §5 Curve25519 / §5.2 test vectors, §6 Diffie-Hellman, §7
|
|
14
|
+
security considerations.
|
|
15
|
+
- **Secondary**: Bernstein 2006 — *Curve25519: new Diffie-Hellman
|
|
16
|
+
speed records*. Wycheproof X25519 (Project Wycheproof, Google).
|
|
17
|
+
- **No NIST ACVP vector** — Curve25519/X25519 is not among the
|
|
18
|
+
curves approved by SP 800-186.
|
|
19
|
+
|
|
20
|
+
## Implemented algorithm
|
|
21
|
+
|
|
22
|
+
`x25519.factory()` exposes Curve25519 ECDH (variable-base and fixed-base).
|
|
23
|
+
Montgomery-ladder implementation (TweetNaCl-derived, 16 limbs of Float64
|
|
24
|
+
with carry propagation). Public API (`Uint8Array`):
|
|
25
|
+
|
|
26
|
+
- `scalarMult(scalar, u)` → 32 bytes (shared secret) or `false` if
|
|
27
|
+
size ≠ 32 bytes. Performs the RFC 7748 §5 clamping
|
|
28
|
+
(`scalar[0] &= 248; scalar[31] &= 127; scalar[31] |= 64`) and masks
|
|
29
|
+
the MSB of `u` (§5 last paragraph).
|
|
30
|
+
- `scalarMultBase(scalar)` → `scalarMult(scalar, [9, 0, ..., 0])`.
|
|
31
|
+
|
|
32
|
+
No explicit validation of low-order points: the product
|
|
33
|
+
`scalarMult(scalar, low_order_u)` returns `0...0`. The caller must
|
|
34
|
+
check for an all-zero tag if a contributory property is
|
|
35
|
+
required (cf. RFC 7748 §6.1, §7).
|
|
36
|
+
|
|
37
|
+
## Test coverage
|
|
38
|
+
|
|
39
|
+
### Integrated official vectors
|
|
40
|
+
|
|
41
|
+
| Source | Reference | Test (`describe` / `test`) | Property verified |
|
|
42
|
+
|---|---|---|---|
|
|
43
|
+
| RFC 7748 §5.2 | Test vector 1 | `§5.2 test vector 1` | `scalarMult(k, u) == k×u` byte-exact |
|
|
44
|
+
| RFC 7748 §5.2 | Test vector 2 | `§5.2 test vector 2` | same |
|
|
45
|
+
| RFC 7748 §5.2 | Iterative — 1 iteration | `§5.2 iterative — after 1 iteration` | K₁ == 422c8e7a... |
|
|
46
|
+
| RFC 7748 §5.2 | Iterative — 1000 iterations | `§5.2 iterative — after 1000 iterations` | K₁₀₀₀ == 684cf59b... |
|
|
47
|
+
| RFC 7748 §5.2 | Iterative — 1,000,000 (`CRYPTO_FULL`-gated) | `§5.2 iterative — after 1,000,000 iterations` | K₁ₘ == 7c3911e0... (skipped by default, ~10 min) |
|
|
48
|
+
| RFC 7748 §6.1 | Alice/Bob DH agreement | `§6.1 ECDH agreement matches` | pubA, pubB, shared byte-exact + symmetry |
|
|
49
|
+
| RFC 7748 §5 | clamping (low-3 + high-2 bits) | `clamping — bit-flips ... are absorbed` | 4 mutations within the clamped bits produce the same output |
|
|
50
|
+
| RFC 7748 §5 | high-bit u-coord ignored | `§5 high bit of u is ignored on input` | identical output with/without MSB(u) set |
|
|
51
|
+
| Curve25519 spec / Wycheproof | u=0 | `low-order point u=0 → 0` | all-zero shared secret |
|
|
52
|
+
| Curve25519 spec / Wycheproof | u=1 (order-2) | `low-order point u=1 → 0` | all-zero shared secret |
|
|
53
|
+
| Curve25519 spec / Wycheproof | u=p-1 (order-2) | `low-order point u=p-1 → 0` | all-zero shared secret |
|
|
54
|
+
| Stress | 5 random DH pairs | `ECDH symmetry on 5 random scalar pairs` | DH symmetry + non-triviality |
|
|
55
|
+
| Pre-existing | size rejection | `rejects non-32-byte scalar` | `false` on a 31-byte scalar |
|
|
56
|
+
| Added | u size rejection | `rejects non-32-byte u` | `false` on a 31-byte u |
|
|
57
|
+
|
|
58
|
+
### Security properties tested
|
|
59
|
+
|
|
60
|
+
- [x] **RFC 7748 §5.1.5 clamping** — 4 bit-flip vectors absorbed
|
|
61
|
+
(low-3 of byte 0, high-2 of byte 31).
|
|
62
|
+
- [x] **MSB masking of u** — identical output with MSB(u)=1 or 0.
|
|
63
|
+
- [x] **Deterministic propagation** — iterative 1 and 1000 byte-exact;
|
|
64
|
+
iterative 1M gated by CRYPTO_FULL.
|
|
65
|
+
- [x] **Low-order u detection** — 3 vectors (u=0, u=1, u=p-1); all
|
|
66
|
+
return an all-zero shared secret (the caller must check).
|
|
67
|
+
- [x] **ECDH symmetry** — 5 random pairs `aB == bA`.
|
|
68
|
+
- [x] **Length validation** — early return false on scalar/u ≠ 32 bytes.
|
|
69
|
+
- [x] **No `throw`** — `console.warn` + `return false` (review
|
|
70
|
+
lines 154-162 x25519.js).
|
|
71
|
+
- [x] **Explicit rejection of low-order pk** — **Iteration G5**: helper
|
|
72
|
+
`isLowOrderPoint(u)` exposed. Compares `u` (canonicalized via `& 0x7f`
|
|
73
|
+
on byte 31 per RFC 7748 §5) constant-time against 7 documented
|
|
74
|
+
low-order u-coords (Bernstein 2006 + Wycheproof + libsodium). Lets
|
|
75
|
+
the caller filter *before* `scalarMult` instead of testing `output
|
|
76
|
+
=== 0…0` afterwards. 13 new tests (7 LOPs detected + high-bit
|
|
77
|
+
variant + 2 valid pk + base point + cross-check `scalarMult(scalar, lop) === 0`
|
|
78
|
+
across the 7 + length edge cases).
|
|
79
|
+
- [ ] **Strict constant-time** — `_M`/`_S` Float64 + carry, `_sel25519`
|
|
80
|
+
is CT but `_pow2523` uses a fixed addition chain. Acceptable for
|
|
81
|
+
RFC 7748 §A.1's interactive ECDH context; **P3** for CMVP-like
|
|
82
|
+
SCA audit.
|
|
83
|
+
|
|
84
|
+
## FIPS 140-3 conformance
|
|
85
|
+
|
|
86
|
+
| Requirement | Status | Evidence |
|
|
87
|
+
|---|---|---|
|
|
88
|
+
| Approved algorithm | ❌ N/A | Curve25519 / X25519 outside SP 800-186 |
|
|
89
|
+
| RFC 7748 conformance | ✅ | 5 §5.2 vectors + §6.1 + §5 clamping/masking byte-exact |
|
|
90
|
+
| Iterative RFC 7748 | ✅ partial | 1 + 1000 iterations covered; 1M under CRYPTO_FULL |
|
|
91
|
+
| Low-order pk detection | ✅ (opt-in helper) | **Iteration G5**: `isLowOrderPoint(u)` constant-time against 7 documented LOPs; caller-side rejection before `scalarMult` |
|
|
92
|
+
| No `throw` | ✅ | `console.warn` + return false |
|
|
93
|
+
|
|
94
|
+
## Known limitations
|
|
95
|
+
|
|
96
|
+
- **Outside NIST scope** — no ACVP equivalent. Validation = RFC
|
|
97
|
+
7748 + Wycheproof + the Curve25519 spec (Bernstein).
|
|
98
|
+
- **1,000,000 iter**: the RFC 7748 §5.2 checkpoint only runs under
|
|
99
|
+
`CRYPTO_FULL=1` (~10 min).
|
|
100
|
+
- ~~**No automatic rejection of low-order u**~~ — partially resolved in
|
|
101
|
+
G5: `isLowOrderPoint(u)` is available caller-side. `scalarMult` still
|
|
102
|
+
accepts LOPs (RFC 7748 backward compatibility); the caller decides
|
|
103
|
+
whether to reject. Preferable on the authenticated side (TLS 1.3
|
|
104
|
+
(EC)DHE + signature also covers the risk).
|
|
105
|
+
- **TweetNaCl-derived, not formally CT**: see P3 above.
|
|
106
|
+
|
|
107
|
+
## Cross-references
|
|
108
|
+
|
|
109
|
+
- Module: [`pkc/x25519.js`](./x25519.js)
|
|
110
|
+
- Tests: [`pkc/x25519.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/pkc/x25519.test.js) — **27 tests** (26 pass + 1 skip CRYPTO_FULL — RFC 7748 §5.2 1M iterations; including the 13 added in G5: `isLowOrderPoint` detection of 7 LOPs + high-bit variant + 2 valid pk + base point + cross-check `scalarMult(scalar, lop) === 0` + edge cases; was 5 before the upgrade)
|
|
111
|
+
- RFC 7748: [`https://datatracker.ietf.org/doc/html/rfc7748`](https://datatracker.ietf.org/doc/html/rfc7748)
|
|
112
|
+
- Sibling Ed25519 module: [`./ed25519.acvp.md`](./ed25519.acvp.md)
|
|
113
|
+
- Global conformance: [`../NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)
|
|
@@ -0,0 +1,290 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @fileoverview X25519 - Diffie-Hellman over Curve25519 (RFC 7748).
|
|
7
|
+
*
|
|
8
|
+
* Implements the Montgomery ladder for the curve y² = x³ + 486662x² + x
|
|
9
|
+
* over the prime field GF(2^255 − 19). Field elements are represented as
|
|
10
|
+
* Float64Array(16) of 16-bit limbs (TweetNaCl-derived (public domain; see
|
|
11
|
+
* docs/dev/provenance.md)) which gives exact 32-bit products in JS doubles
|
|
12
|
+
* and avoids 53-bit precision pitfalls during reduction.
|
|
13
|
+
*
|
|
14
|
+
* Public API takes raw Uint8Array (32 bytes for both scalar and u-coord)
|
|
15
|
+
* matching the wire format defined by RFC 7748 §5. The standard scalar
|
|
16
|
+
* clamping (clear low 3 bits, clear high bit, set bit 254) is applied
|
|
17
|
+
* automatically per §5 step 2.
|
|
18
|
+
*
|
|
19
|
+
*/
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* Public API returned by `x25519.factory()`.
|
|
23
|
+
* @typedef {object} X25519API
|
|
24
|
+
* @property {(scalar: Uint8Array, u: Uint8Array) => (Uint8Array|false)} scalarMult Compute scalarmult(scalar, u); 32-byte output or false.
|
|
25
|
+
* @property {(scalar: Uint8Array) => (Uint8Array|false)} scalarMultBase scalarmult against the base point u=9.
|
|
26
|
+
* @property {(u: Uint8Array) => boolean} isLowOrderPoint True iff `u` is a documented low-order point (or malformed length).
|
|
27
|
+
* @property {{ lowOrderPoints: Uint8Array[] }} _internal Embedded low-order point table.
|
|
28
|
+
*/
|
|
29
|
+
|
|
30
|
+
export const x25519 = {
|
|
31
|
+
name: 'x25519',
|
|
32
|
+
version: '1.0.0',
|
|
33
|
+
type: 'fw.crypto.pkc',
|
|
34
|
+
dependencies: [],
|
|
35
|
+
|
|
36
|
+
/** @returns {X25519API} */
|
|
37
|
+
factory() {
|
|
38
|
+
|
|
39
|
+
// Standard curve constant a24 = (486662 - 2) / 4 = 121665.
|
|
40
|
+
const _121665 = new Float64Array(16);
|
|
41
|
+
_121665[0] = 0xDB41; _121665[1] = 1;
|
|
42
|
+
|
|
43
|
+
function _gf(init) {
|
|
44
|
+
const r = new Float64Array(16);
|
|
45
|
+
if (init) for (let i = 0; i < init.length; i++) r[i] = init[i];
|
|
46
|
+
return r;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
function _car25519(o) {
|
|
50
|
+
for (let i = 0; i < 16; i++) {
|
|
51
|
+
o[i] += 65536;
|
|
52
|
+
const c = Math.floor(o[i] / 65536);
|
|
53
|
+
o[(i + 1) * (i < 15 ? 1 : 0)] += c - 1 + 37 * (c - 1) * (i === 15 ? 1 : 0);
|
|
54
|
+
o[i] -= c * 65536;
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
// Constant-time conditional swap (TweetNaCl `sel25519`). The mask `c`
|
|
59
|
+
// is derived from `b` via bitwise arithmetic only - no data-dependent
|
|
60
|
+
// branch - so every iteration performs identical memory writes
|
|
61
|
+
// regardless of whether the swap actually happens. This is the
|
|
62
|
+
// primitive that keeps the Montgomery ladder side-channel free.
|
|
63
|
+
function _sel25519(p, q, b) {
|
|
64
|
+
const c = ~(b - 1);
|
|
65
|
+
for (let i = 0; i < 16; i++) {
|
|
66
|
+
const t = c & (p[i] ^ q[i]);
|
|
67
|
+
p[i] ^= t;
|
|
68
|
+
q[i] ^= t;
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
function _pack25519(o, n) {
|
|
73
|
+
const m = _gf(), t = _gf();
|
|
74
|
+
for (let i = 0; i < 16; i++) t[i] = n[i];
|
|
75
|
+
_car25519(t); _car25519(t); _car25519(t);
|
|
76
|
+
for (let j = 0; j < 2; j++) {
|
|
77
|
+
m[0] = t[0] - 0xffed;
|
|
78
|
+
for (let i = 1; i < 15; i++) {
|
|
79
|
+
m[i] = t[i] - 0xffff - ((m[i - 1] >> 16) & 1);
|
|
80
|
+
m[i - 1] &= 0xffff;
|
|
81
|
+
}
|
|
82
|
+
m[15] = t[15] - 0x7fff - ((m[14] >> 16) & 1);
|
|
83
|
+
const b = (m[15] >> 16) & 1;
|
|
84
|
+
m[14] &= 0xffff;
|
|
85
|
+
_sel25519(t, m, 1 - b);
|
|
86
|
+
}
|
|
87
|
+
for (let i = 0; i < 16; i++) {
|
|
88
|
+
o[2 * i] = t[i] & 0xff;
|
|
89
|
+
o[2 * i + 1] = t[i] >> 8;
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
function _unpack25519(o, n) {
|
|
94
|
+
for (let i = 0; i < 16; i++) o[i] = n[2 * i] + (n[2 * i + 1] << 8);
|
|
95
|
+
o[15] &= 0x7fff;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
function _A(o, a, b) { for (let i = 0; i < 16; i++) o[i] = a[i] + b[i]; }
|
|
99
|
+
function _Z(o, a, b) { for (let i = 0; i < 16; i++) o[i] = a[i] - b[i]; }
|
|
100
|
+
|
|
101
|
+
function _M(o, a, b) {
|
|
102
|
+
const t = new Float64Array(31);
|
|
103
|
+
for (let i = 0; i < 16; i++) {
|
|
104
|
+
for (let j = 0; j < 16; j++) {
|
|
105
|
+
t[i + j] += a[i] * b[j];
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
for (let i = 0; i < 15; i++) t[i] += 38 * t[i + 16];
|
|
109
|
+
for (let i = 0; i < 16; i++) o[i] = t[i];
|
|
110
|
+
_car25519(o); _car25519(o);
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
function _S(o, a) { _M(o, a, a); }
|
|
114
|
+
|
|
115
|
+
function _inv25519(o, i) {
|
|
116
|
+
const c = _gf();
|
|
117
|
+
for (let a = 0; a < 16; a++) c[a] = i[a];
|
|
118
|
+
for (let a = 253; a >= 0; a--) {
|
|
119
|
+
_S(c, c);
|
|
120
|
+
if (a !== 2 && a !== 4) _M(c, c, i);
|
|
121
|
+
}
|
|
122
|
+
for (let a = 0; a < 16; a++) o[a] = c[a];
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
function _scalarmult(q, n, p) {
|
|
126
|
+
const z = new Uint8Array(32);
|
|
127
|
+
const x = _gf(), a = _gf(), b = _gf(), c = _gf(), d = _gf(), e = _gf(), f = _gf();
|
|
128
|
+
for (let i = 0; i < 31; i++) z[i] = n[i];
|
|
129
|
+
z[31] = (n[31] & 127) | 64;
|
|
130
|
+
z[0] &= 248;
|
|
131
|
+
_unpack25519(x, p);
|
|
132
|
+
for (let i = 0; i < 16; i++) { b[i] = x[i]; d[i] = a[i] = c[i] = 0; }
|
|
133
|
+
a[0] = d[0] = 1;
|
|
134
|
+
for (let i = 254; i >= 0; --i) {
|
|
135
|
+
const r = (z[i >>> 3] >>> (i & 7)) & 1;
|
|
136
|
+
_sel25519(a, b, r);
|
|
137
|
+
_sel25519(c, d, r);
|
|
138
|
+
_A(e, a, c);
|
|
139
|
+
_Z(a, a, c);
|
|
140
|
+
_A(c, b, d);
|
|
141
|
+
_Z(b, b, d);
|
|
142
|
+
_S(d, e);
|
|
143
|
+
_S(f, a);
|
|
144
|
+
_M(a, c, a);
|
|
145
|
+
_M(c, b, e);
|
|
146
|
+
_A(e, a, c);
|
|
147
|
+
_Z(a, a, c);
|
|
148
|
+
_S(b, a);
|
|
149
|
+
_Z(c, d, f);
|
|
150
|
+
_M(a, c, _121665);
|
|
151
|
+
_A(a, a, d);
|
|
152
|
+
_M(c, c, a);
|
|
153
|
+
_M(a, d, f);
|
|
154
|
+
_M(d, b, x);
|
|
155
|
+
_S(b, e);
|
|
156
|
+
_sel25519(a, b, r);
|
|
157
|
+
_sel25519(c, d, r);
|
|
158
|
+
}
|
|
159
|
+
_inv25519(c, c);
|
|
160
|
+
_M(a, a, c);
|
|
161
|
+
_pack25519(q, a);
|
|
162
|
+
return 0;
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
const _BASE = new Uint8Array(32);
|
|
166
|
+
_BASE[0] = 9;
|
|
167
|
+
|
|
168
|
+
/**
|
|
169
|
+
* Compute scalarmult(scalar, u).
|
|
170
|
+
* @param {Uint8Array} scalar 32-byte scalar (will be clamped).
|
|
171
|
+
* @param {Uint8Array} u 32-byte u-coordinate.
|
|
172
|
+
* @returns {Uint8Array|false} 32-byte shared secret / output u-coordinate, or false on invalid input.
|
|
173
|
+
*/
|
|
174
|
+
function scalarMult(scalar, u) {
|
|
175
|
+
if (!(scalar instanceof Uint8Array) || scalar.length !== 32) {
|
|
176
|
+
console.warn('[crypto] INVALID: x25519: scalar must be 32 bytes');
|
|
177
|
+
return false;
|
|
178
|
+
}
|
|
179
|
+
if (!(u instanceof Uint8Array) || u.length !== 32) {
|
|
180
|
+
console.warn('[crypto] INVALID: x25519: u must be 32 bytes');
|
|
181
|
+
return false;
|
|
182
|
+
}
|
|
183
|
+
const out = new Uint8Array(32);
|
|
184
|
+
_scalarmult(out, scalar, u);
|
|
185
|
+
return out;
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
/** scalarmult of `scalar` against the standard base point u=9. */
|
|
189
|
+
function scalarMultBase(scalar) {
|
|
190
|
+
return scalarMult(scalar, _BASE);
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
// ── Iteration G5 - Low-order point detection helper ──────────────
|
|
194
|
+
//
|
|
195
|
+
// Curve25519 has cofactor 8; some u-coords generate a subgroup
|
|
196
|
+
// of small order (1, 2, 4, 8). If Alice uses such a u
|
|
197
|
+
// as Bob's public key, the product `scalarMult(scalar, u)` is
|
|
198
|
+
// **always zero** or takes one of a few predictable values -
|
|
199
|
+
// which allows an active attacker (substituting the public key
|
|
200
|
+
// in a Diffie-Hellman exchange) to force a known shared secret.
|
|
201
|
+
//
|
|
202
|
+
// RFC 7748 §6.1 recommends either (a) accepting small-order
|
|
203
|
+
// points and letting the `result === 00…00` check filter downstream,
|
|
204
|
+
// or (b) explicitly rejecting before `scalarMult`. This helper offers
|
|
205
|
+
// option (b), explicit on the caller side.
|
|
206
|
+
//
|
|
207
|
+
// List: 7 unique u-coordinates documented (Bernstein 2006,
|
|
208
|
+
// Wycheproof project, libsodium `crypto_scalarmult_curve25519_ref10`
|
|
209
|
+
// table `crypto_scalarmult_curve25519_ref10_is_canonical`).
|
|
210
|
+
//
|
|
211
|
+
// - 0x00…00 : order-4 point (≈ point at infinity)
|
|
212
|
+
// - 0x01…00 : order-1 point (trivial generator)
|
|
213
|
+
// - 0xe0eb7a…85a800 : order 8 (on the main curve)
|
|
214
|
+
// - 0x5f9c95…1f1157 : order 8 (on the twist)
|
|
215
|
+
// - 0xec…7f, 0xed…7f, 0xee…7f : equivalents mod p of the three above.
|
|
216
|
+
//
|
|
217
|
+
// Constant-time comparison to avoid timing leak on `u` (even
|
|
218
|
+
// if `u` is public, the pattern remains best practice).
|
|
219
|
+
const _LOW_ORDER_POINTS = [
|
|
220
|
+
// 7 unique low-order u-coordinates on Curve25519 (cofactor 8).
|
|
221
|
+
new Uint8Array([
|
|
222
|
+
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
|
|
223
|
+
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
|
|
224
|
+
]),
|
|
225
|
+
new Uint8Array([
|
|
226
|
+
0x01,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
|
|
227
|
+
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
|
|
228
|
+
]),
|
|
229
|
+
new Uint8Array([
|
|
230
|
+
0xe0,0xeb,0x7a,0x7c,0x3b,0x41,0xb8,0xae,0x16,0x56,0xe3,0xfa,0xf1,0x9f,0xc4,0x6a,
|
|
231
|
+
0xda,0x09,0x8d,0xeb,0x9c,0x32,0xb1,0xfd,0x86,0x62,0x05,0x16,0x5f,0x49,0xb8,0x00,
|
|
232
|
+
]),
|
|
233
|
+
new Uint8Array([
|
|
234
|
+
0x5f,0x9c,0x95,0xbc,0xa3,0x50,0x8c,0x24,0xb1,0xd0,0xb1,0x55,0x9c,0x83,0xef,0x5b,
|
|
235
|
+
0x04,0x44,0x5c,0xc4,0x58,0x1c,0x8e,0x86,0xd8,0x22,0x4e,0xdd,0xd0,0x9f,0x11,0x57,
|
|
236
|
+
]),
|
|
237
|
+
new Uint8Array([
|
|
238
|
+
0xec,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,
|
|
239
|
+
0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0x7f,
|
|
240
|
+
]),
|
|
241
|
+
new Uint8Array([
|
|
242
|
+
0xed,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,
|
|
243
|
+
0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0x7f,
|
|
244
|
+
]),
|
|
245
|
+
new Uint8Array([
|
|
246
|
+
0xee,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,
|
|
247
|
+
0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0x7f,
|
|
248
|
+
]),
|
|
249
|
+
];
|
|
250
|
+
|
|
251
|
+
/**
|
|
252
|
+
* Test whether `u` is one of the documented low-order u-coordinates
|
|
253
|
+
* on Curve25519 (cofactor-8 subgroup elements). RFC 7748 §6.1.
|
|
254
|
+
*
|
|
255
|
+
* Constant-time comparison vs the embedded table.
|
|
256
|
+
*
|
|
257
|
+
* @param {Uint8Array} u 32-byte u-coordinate.
|
|
258
|
+
* @returns {boolean} true iff `u` is low-order (or a malformed length).
|
|
259
|
+
*/
|
|
260
|
+
function isLowOrderPoint(u) {
|
|
261
|
+
if (!(u instanceof Uint8Array) || u.length !== 32) {
|
|
262
|
+
console.warn('[crypto] INVALID: x25519: u must be 32 bytes');
|
|
263
|
+
return false;
|
|
264
|
+
}
|
|
265
|
+
// Mask the high bit per RFC 7748 §5 (`u_255 = 0`) to canonicalise.
|
|
266
|
+
const norm = new Uint8Array(u);
|
|
267
|
+
norm[31] &= 0x7f;
|
|
268
|
+
// Constant-time : OR-accumulate `(norm == lop)` over all entries.
|
|
269
|
+
// We aggregate `equal_i` into a flag then return `flag !== 0`.
|
|
270
|
+
let anyMatch = 0;
|
|
271
|
+
for (let p = 0; p < _LOW_ORDER_POINTS.length; p++) {
|
|
272
|
+
const lop = _LOW_ORDER_POINTS[p];
|
|
273
|
+
let diff = 0;
|
|
274
|
+
for (let i = 0; i < 32; i++) diff |= (norm[i] ^ lop[i]);
|
|
275
|
+
// diff === 0 ⇒ match. Convert to {0, 1} branchless :
|
|
276
|
+
// ((diff - 1) >>> 31) returns 1 only when diff === 0.
|
|
277
|
+
anyMatch |= ((diff - 1) >>> 31) & 1;
|
|
278
|
+
}
|
|
279
|
+
return anyMatch === 1;
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
return {
|
|
283
|
+
scalarMult,
|
|
284
|
+
scalarMultBase,
|
|
285
|
+
// Iteration G5 - opt-in defensive helper.
|
|
286
|
+
isLowOrderPoint,
|
|
287
|
+
_internal: { lowOrderPoints: _LOW_ORDER_POINTS }
|
|
288
|
+
};
|
|
289
|
+
}
|
|
290
|
+
};
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# `aes_ctr.js` — ACVP / NIST conformance
|
|
2
|
+
|
|
3
|
+
> **Legacy convenience wrapper** for Uint8Array ↔ AES-CTR with PKCS#7 padding
|
|
4
|
+
> handled internally. Keeps a historical object API (`new _Encrypt(key, iv)` →
|
|
5
|
+
> `pad/strip/raw/ba_*` methods). **All FIPS / SP
|
|
6
|
+
> 800-38A conformance is delegated to `mode/ctr.js`.** Prefer
|
|
7
|
+
> [`utils/aes_modes.js`](aes_modes.js) (`aes_modes.ctr.{encrypt,decrypt}`) for
|
|
8
|
+
> any new code.
|
|
9
|
+
|
|
10
|
+
## Status (Iteration I1)
|
|
11
|
+
|
|
12
|
+
**`@deprecated` (soft)** — no export removed, no runtime warn added
|
|
13
|
+
so as not to break existing consumers. The doc header of
|
|
14
|
+
`aes_ctr.js` redirects to `aes_modes.ctr`.
|
|
15
|
+
|
|
16
|
+
## Standards (delegated)
|
|
17
|
+
|
|
18
|
+
- **FIPS 197** — AES block (cf. [`cipher/aes.acvp.md`](../cipher/aes.acvp.md)).
|
|
19
|
+
- **SP 800-38A §6.5** (CTR) — cf. [`mode/ctr.acvp.md`](../mode/ctr.acvp.md).
|
|
20
|
+
- **PKCS #7 padding** — cf. [`utils/pad.js`](pad.js) (PKCS#7 RFC 5652 §6.3).
|
|
21
|
+
|
|
22
|
+
## Implemented algorithm
|
|
23
|
+
|
|
24
|
+
`aes_ctr.factory(bitArray, aes, ctr, pad)` exposes:
|
|
25
|
+
|
|
26
|
+
- `ui8(key, iv)` → instance with:
|
|
27
|
+
- `pad(plaintext)` — encrypt + PKCS#7 pad → CT
|
|
28
|
+
- `strip(ciphertext)` — decrypt + PKCS#7 strip → PT
|
|
29
|
+
- `raw(data)` — XOR keystream without padding (CTR is an involution)
|
|
30
|
+
- `update(iv)` — change the initial counter (rare)
|
|
31
|
+
- `ba_raw / ba_update` — bitArray variants (internal, avoids
|
|
32
|
+
Uint8Array→bitArray marshalling on the hot path)
|
|
33
|
+
|
|
34
|
+
## Test coverage
|
|
35
|
+
|
|
36
|
+
`aes_ctr.test.js` covers round-trip + cross-check against raw
|
|
37
|
+
`mode/ctr.js`. No KAT re-validation — fully delegated to
|
|
38
|
+
[`mode/ctr.acvp.md`](../mode/ctr.acvp.md) (ACVP-AES-CTR-1.0).
|
|
39
|
+
|
|
40
|
+
## FIPS 140-3 conformance (delegated)
|
|
41
|
+
|
|
42
|
+
| Requirement | Status | Reference |
|
|
43
|
+
|---|---|---|
|
|
44
|
+
| Approved algorithm | ✅ | cipher/aes + mode/ctr |
|
|
45
|
+
| Byte-exact ACVP vectors | ✅ | delegated |
|
|
46
|
+
| No `throw` | ✅ | delegated (consumes `false` returns without propagating) |
|
|
47
|
+
| AEAD authenticity | ❌ N/A | **CTR is malleable** — no authentication; requires encrypt-then-MAC or switching to `aes_modes.gcm` |
|
|
48
|
+
|
|
49
|
+
## Known limitations
|
|
50
|
+
|
|
51
|
+
- **Non-uniform legacy API** vs. `aes_modes` (3 separate calls instead
|
|
52
|
+
of a simple `encrypt(key, iv, pt)`). Kept for back-compat.
|
|
53
|
+
- **PKCS #7 padding in CTR**: semantically odd (CTR does not need
|
|
54
|
+
padding) — a usage holdover where padding signaled the message
|
|
55
|
+
length. For new code, prefer `aes_modes.ctr.encrypt` (no
|
|
56
|
+
padding, length transmitted out-of-band) or `aes_modes.gcm` (AEAD).
|
|
57
|
+
- **No nonce-uniqueness protection**: see `mode/ctr.acvp.md` —
|
|
58
|
+
a (key, IV) collision → keystream recovery → plaintext leak.
|
|
59
|
+
The caller must guarantee uniqueness.
|
|
60
|
+
|
|
61
|
+
## Cross-references
|
|
62
|
+
|
|
63
|
+
- [`mode/ctr.acvp.md`](../mode/ctr.acvp.md) — algorithm + ACVP vectors.
|
|
64
|
+
- [`utils/aes_modes.acvp.md`](aes_modes.acvp.md) — recommended wrapper for
|
|
65
|
+
new code (uniform API across all modes).
|
|
66
|
+
- **I1** iteration of the FIPS 140-3 upgrade plan: legacy status
|
|
67
|
+
clarification + redirection to `aes_modes`.
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @fileoverview AES-CTR convenience wrapper that combines `aes`, `ctr` and
|
|
7
|
+
* PKCS#7 padding for byte-array (Uint8Array) input/output.
|
|
8
|
+
*
|
|
9
|
+
* @deprecated Iteration I1 of the FIPS 140-3 upgrade plan: this module is
|
|
10
|
+
* kept for back-compat only; new code MUST use `utils/aes_modes.js`
|
|
11
|
+
* (`aes_modes.ctr.{encrypt,decrypt}`) which provides a uniform Uint8Array
|
|
12
|
+
* API across every mode (CBC/CTR/GCM/KW/KWP). See `aes_ctr.acvp.md` for
|
|
13
|
+
* details. Planned removal once consumers have migrated.
|
|
14
|
+
*
|
|
15
|
+
* Note: AES-CTR is malleable; this wrapper provides confidentiality only.
|
|
16
|
+
* If you need authenticated encryption, layer an HMAC over the ciphertext
|
|
17
|
+
* (encrypt-then-MAC) or switch to an AEAD construction (`aes_modes.gcm`).
|
|
18
|
+
*
|
|
19
|
+
*/
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* Public shape of an AES-CTR instance returned by `ui8()`.
|
|
23
|
+
* @typedef {object} AesCtrInstance
|
|
24
|
+
* @property {(iv: Uint8Array) => void} update Replace the IV (Uint8Array form).
|
|
25
|
+
* @property {(arr: Uint8Array) => (Uint8Array|false)} pad PKCS#7-pad then CTR-encrypt.
|
|
26
|
+
* @property {(arr: Uint8Array) => (Uint8Array|false)} strip CTR-decrypt then strip PKCS#7 padding.
|
|
27
|
+
* @property {(arr: Uint8Array) => (Uint8Array|false)} raw Raw CTR encrypt/decrypt (no padding).
|
|
28
|
+
* @property {(ba_iv: number[]) => void} ba_update Replace the IV (bitArray form).
|
|
29
|
+
* @property {(b_arr: number[]) => (number[]|false)} ba_raw Raw CTR over bitArray input/output.
|
|
30
|
+
*/
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Public surface of `aes_ctr.factory(...)`.
|
|
34
|
+
* @typedef {object} AesCtrApi
|
|
35
|
+
* @property {(key: Uint8Array, iv: Uint8Array) => AesCtrInstance} ui8 Build an instance from Uint8Array key/IV.
|
|
36
|
+
*/
|
|
37
|
+
|
|
38
|
+
import { bitArray } from './bitArray.js';
|
|
39
|
+
import { aes } from '../cipher/aes.js';
|
|
40
|
+
import { ctr } from '../mode/ctr.js';
|
|
41
|
+
import { pad } from './pad.js';
|
|
42
|
+
|
|
43
|
+
export const aes_ctr = {
|
|
44
|
+
name: 'aes_ctr',
|
|
45
|
+
version: '1.0.0',
|
|
46
|
+
type: 'fw.crypto.utils',
|
|
47
|
+
dependencies: ['bitArray', 'aes', 'ctr', 'pad'],
|
|
48
|
+
deps: [bitArray, aes, ctr, pad],
|
|
49
|
+
|
|
50
|
+
/** @returns {AesCtrApi} */
|
|
51
|
+
factory(bitArray, aes, ctr, pad) {
|
|
52
|
+
|
|
53
|
+
const _Encrypt = function (k, iv) {
|
|
54
|
+
this.k = bitArray.ui8_to_ba(k);
|
|
55
|
+
this.iv = bitArray.ui8_to_ba(iv);
|
|
56
|
+
this.cipher = aes.fn(this.k, false);
|
|
57
|
+
if (this.cipher === false) {
|
|
58
|
+
console.warn('[crypto] INVALID: aes_ctr: invalid key - cipher init failed');
|
|
59
|
+
this._dead = true;
|
|
60
|
+
}
|
|
61
|
+
};
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* Replace the counter / IV used by this instance (Uint8Array form).
|
|
65
|
+
* @param {Uint8Array} iv
|
|
66
|
+
*/
|
|
67
|
+
_Encrypt.prototype.update = function (iv) {
|
|
68
|
+
this.iv = bitArray.ui8_to_ba(iv);
|
|
69
|
+
};
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* Encrypt arbitrary-length plaintext with PKCS#7 padding applied
|
|
73
|
+
* before CTR-mode encryption.
|
|
74
|
+
* @param {Uint8Array} arr
|
|
75
|
+
* @returns {Uint8Array|false}
|
|
76
|
+
*/
|
|
77
|
+
_Encrypt.prototype.pad = function (arr) {
|
|
78
|
+
if (this._dead) return false;
|
|
79
|
+
const padded = pad.pad(arr);
|
|
80
|
+
if (padded === false) return false;
|
|
81
|
+
return bitArray.ba_to_ui8(
|
|
82
|
+
ctr.encrypt(this.cipher, bitArray.ui8_to_ba(padded), this.iv, '')
|
|
83
|
+
);
|
|
84
|
+
};
|
|
85
|
+
|
|
86
|
+
/**
|
|
87
|
+
* Decrypt CTR-ciphertext and strip PKCS#7 padding.
|
|
88
|
+
* @param {Uint8Array} arr
|
|
89
|
+
* @returns {Uint8Array|false}
|
|
90
|
+
*/
|
|
91
|
+
_Encrypt.prototype.strip = function (arr) {
|
|
92
|
+
if (this._dead) return false;
|
|
93
|
+
return pad.strip(bitArray.ba_to_ui8(
|
|
94
|
+
ctr.encrypt(this.cipher, bitArray.ui8_to_ba(arr), this.iv, '')
|
|
95
|
+
));
|
|
96
|
+
};
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* Raw CTR encrypt/decrypt with no padding (CTR is its own inverse).
|
|
100
|
+
* @param {Uint8Array} arr
|
|
101
|
+
* @returns {Uint8Array|false}
|
|
102
|
+
*/
|
|
103
|
+
_Encrypt.prototype.raw = function (arr) {
|
|
104
|
+
if (this._dead) return false;
|
|
105
|
+
return bitArray.ba_to_ui8(
|
|
106
|
+
ctr.encrypt(this.cipher, bitArray.ui8_to_ba(arr), this.iv, '')
|
|
107
|
+
);
|
|
108
|
+
};
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* Replace the counter / IV used by this instance (bitArray form).
|
|
112
|
+
* @param {number[]} ba_iv
|
|
113
|
+
*/
|
|
114
|
+
_Encrypt.prototype.ba_update = function (ba_iv) {
|
|
115
|
+
this.iv = ba_iv;
|
|
116
|
+
};
|
|
117
|
+
|
|
118
|
+
/**
|
|
119
|
+
* Raw CTR encrypt/decrypt on bitArray-form input/output.
|
|
120
|
+
* @param {number[]} b_arr
|
|
121
|
+
* @returns {number[]|false}
|
|
122
|
+
*/
|
|
123
|
+
_Encrypt.prototype.ba_raw = function (b_arr) {
|
|
124
|
+
if (this._dead) return false;
|
|
125
|
+
return ctr.encrypt(this.cipher, b_arr, this.iv, '');
|
|
126
|
+
};
|
|
127
|
+
|
|
128
|
+
return {
|
|
129
|
+
ui8(key, iv) {
|
|
130
|
+
return new _Encrypt(key, iv);
|
|
131
|
+
}
|
|
132
|
+
};
|
|
133
|
+
}
|
|
134
|
+
};
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# `aes_modes.js` — ACVP / NIST conformance
|
|
2
|
+
|
|
3
|
+
> **Convenience wrapper** Uint8Array → Uint8Array aggregating the standard
|
|
4
|
+
> AES modes (CBC / CTR / GCM / KW / KWP). **All FIPS / SP 800
|
|
5
|
+
> conformance is delegated to the underlying modules**; this file contains
|
|
6
|
+
> no algorithmic logic of its own.
|
|
7
|
+
|
|
8
|
+
## Standards (delegated)
|
|
9
|
+
|
|
10
|
+
- **FIPS 197** — AES block (cf. [`cipher/aes.acvp.md`](../cipher/aes.acvp.md)).
|
|
11
|
+
- **SP 800-38A** §6.2 (CBC) + §6.5 (CTR) — cf. [`mode/cbc.acvp.md`](../mode/cbc.acvp.md), [`mode/ctr.acvp.md`](../mode/ctr.acvp.md).
|
|
12
|
+
- **SP 800-38D** (GCM) — cf. [`mode/gcm.acvp.md`](../mode/gcm.acvp.md).
|
|
13
|
+
- **SP 800-38F** (KW, KWP) — cf. [`mode/kw.acvp.md`](../mode/kw.acvp.md).
|
|
14
|
+
|
|
15
|
+
## Implemented algorithm
|
|
16
|
+
|
|
17
|
+
`aes_modes.factory(bitArray, aes, cbc, ctr, gcm, kw, pad)` exposes a
|
|
18
|
+
namespace per mode (`cbc`, `ctr`, `gcm`, `kw`, `kwp`) with a
|
|
19
|
+
Uint8Array-only API:
|
|
20
|
+
|
|
21
|
+
- `cbc.encrypt(key, iv, plaintext)` → PKCS#7-padded CT / `false`
|
|
22
|
+
- `cbc.decrypt(key, iv, ciphertext)` → unpadded PT / `false`
|
|
23
|
+
- `ctr.encrypt/decrypt(key, iv, data)` → stream XOR, no padding
|
|
24
|
+
- `gcm.encrypt(key, iv, plaintext, aad?, tagLen?)` → `{ct, tag}`
|
|
25
|
+
- `gcm.decrypt(key, iv, ciphertext, tag, aad?)` → PT / `false`
|
|
26
|
+
- `kw.wrap/unwrap(kek, key)` → SP 800-38F §6.2
|
|
27
|
+
- `kwp.wrap/unwrap(kek, key)` → SP 800-38F §6.3
|
|
28
|
+
|
|
29
|
+
The goal is to spare external framework consumers (workers, business
|
|
30
|
+
modules) from having to handle the internal SJCL `bitArray`
|
|
31
|
+
representation. This layer only does
|
|
32
|
+
`Uint8Array ↔ bitArray` marshalling before calling the modes.
|
|
33
|
+
|
|
34
|
+
## Test coverage
|
|
35
|
+
|
|
36
|
+
`aes_modes.test.js` covers:
|
|
37
|
+
|
|
38
|
+
- Round-trip encrypt/decrypt across the 5 namespaces × {AES-128, AES-192, AES-256}.
|
|
39
|
+
- Verifies warning propagation on invalid key/IV.
|
|
40
|
+
- No KAT re-validation — already fully covered by the
|
|
41
|
+
`mode/*.test.js` suites (1,600+ ACVP vectors).
|
|
42
|
+
|
|
43
|
+
## FIPS 140-3 conformance (delegated)
|
|
44
|
+
|
|
45
|
+
| Requirement | Status | Reference |
|
|
46
|
+
|---|---|---|
|
|
47
|
+
| Approved algorithm | ✅ | cipher/aes + mode/{cbc,ctr,gcm,kw} |
|
|
48
|
+
| Byte-exact ACVP vectors | ✅ | delegated |
|
|
49
|
+
| No `throw` | ✅ | `console.warn` + `return false` |
|
|
50
|
+
| Stable Uint8Array API | ✅ | in scope for this module |
|
|
51
|
+
|
|
52
|
+
## Known limitations
|
|
53
|
+
|
|
54
|
+
- **No mechanism of its own**: everything relies on the modes. If a
|
|
55
|
+
mode has a bug, this wrapper inherits it.
|
|
56
|
+
- **No GCM nonce-uniqueness protection**: delegated — the caller
|
|
57
|
+
must use `gcm.nonceTracker(prf)` to enable in-process
|
|
58
|
+
detection (cf. [mode/gcm.acvp.md](../mode/gcm.acvp.md)).
|
|
59
|
+
|
|
60
|
+
## Cross-references
|
|
61
|
+
|
|
62
|
+
- [`cipher/aes.acvp.md`](../cipher/aes.acvp.md), [`mode/cbc.acvp.md`](../mode/cbc.acvp.md),
|
|
63
|
+
[`mode/ctr.acvp.md`](../mode/ctr.acvp.md), [`mode/gcm.acvp.md`](../mode/gcm.acvp.md),
|
|
64
|
+
[`mode/kw.acvp.md`](../mode/kw.acvp.md).
|
|
65
|
+
- **I1** iteration of the FIPS 140-3 upgrade plan: clarifies the
|
|
66
|
+
*convenience wrapper, FIPS coverage delegated* status.
|