@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,106 @@
|
|
|
1
|
+
# `cmac.js` — ACVP / NIST conformance
|
|
2
|
+
|
|
3
|
+
## Standards
|
|
4
|
+
|
|
5
|
+
- **Primary**: **NIST SP 800-38B** — *Recommendation for Block Cipher
|
|
6
|
+
Modes of Operation: The CMAC Mode for Authentication*.
|
|
7
|
+
- **Secondary**: **RFC 4493** — *The AES-CMAC Algorithm* (test
|
|
8
|
+
vectors).
|
|
9
|
+
- **ACVP draft**: `references/NIST/ACVP/src/cmac/`
|
|
10
|
+
- **Vectors**: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/CMAC-AES-1.0/`
|
|
11
|
+
|
|
12
|
+
## Implemented algorithm
|
|
13
|
+
|
|
14
|
+
CMAC (SP 800-38B §6.2 / RFC 4493 §2.4): a CBC-MAC variant resistant to
|
|
15
|
+
length extension via two subkeys `K1`, `K2` derived from `L =
|
|
16
|
+
E_K(0^128)` by doubling in GF(2^128) under `p(x) = x^128 + x^7 + x^2 +
|
|
17
|
+
x + 1` (constant `Rb = 0x87`). The final block is XORed with `K1`
|
|
18
|
+
(block-aligned message) or `K2` (final block padded `10*`). Output:
|
|
19
|
+
128-bit tag; truncation is the caller's responsibility. PRF: 128-bit
|
|
20
|
+
block cipher (`encrypt(block)`) — AES is the only one specified by
|
|
21
|
+
NIST. Constant-time verification via `bitArray.equal`.
|
|
22
|
+
|
|
23
|
+
## Test coverage
|
|
24
|
+
|
|
25
|
+
### Integrated official vectors
|
|
26
|
+
|
|
27
|
+
| Source | Reference | Test (`describe` / `test`) | Property verified |
|
|
28
|
+
|---|---|---|---|
|
|
29
|
+
| RFC 4493 §4 | `L`, `K1`, `K2` derivation | `subkey derivation (K1, K2)` | KAT byte-exact subkey derivation |
|
|
30
|
+
| RFC 4493 §4 | Ex. 1 (empty), Ex. 2 (16 B), Ex. 3 (40 B), Ex. 4 (64 B) | `RFC 4493 §4 test vectors` | KAT byte-exact, 4 message cases |
|
|
31
|
+
| **CMAC-AES-1.0** | `gen` 81/216 (27 testGroups × 8 AFT) | `gen (MAC generation)` | KAT byte-exact (AES-128/192/256 × msgLen ∈ {0, 4256, 65536} × macLen ∈ {64, 88, 128}) |
|
|
32
|
+
| **CMAC-AES-1.0** | `ver` 108/540 (27 testGroups × 4 AFT) | `ver (MAC verification)` | Pass/fail labels honored (2 pass + 2 fail per group) |
|
|
33
|
+
|
|
34
|
+
#### AFT sub-sampling strategy
|
|
35
|
+
|
|
36
|
+
ACVP CMAC-AES-1.0 exposes **54 testGroups / 756 tests** organized as:
|
|
37
|
+
|
|
38
|
+
- **27 `gen` groups** (3 keyLen × 3 msgLen × 3 macLen × 8 tcId): for
|
|
39
|
+
each group, take `[first, middle, last]` → 81 vectors.
|
|
40
|
+
- **27 `ver` groups** (same parameters × 20 tcId, of which 15 `pass` + 5 `fail`)
|
|
41
|
+
: for each group, take **2 pass + 2 fail** → 108 vectors; the
|
|
42
|
+
test verifies that `bitArray.equal(expected, provided)` returns the
|
|
43
|
+
expected label.
|
|
44
|
+
- **Truncation**: `bitArray.clamp(tag, macLen)` — covers the 3 specified
|
|
45
|
+
values (64, 88, 128 bits).
|
|
46
|
+
- **Total integrated**: **189 / 756** (≈ 25 %).
|
|
47
|
+
|
|
48
|
+
### Security properties tested
|
|
49
|
+
|
|
50
|
+
- [x] **`K1`, `K2` subkey derivation** — RFC 4493 §4 vector + all
|
|
51
|
+
189 ACVP (each tag depends on the correct subkeys).
|
|
52
|
+
- [x] **GF(2^128) doubling** — `_dbl` exposed (`_internal.dbl`) and validated
|
|
53
|
+
against the RFC 4493 values (`L`, `K1`, `K2`).
|
|
54
|
+
- [x] **Full block vs padded branch** — covered by msgLen ∈ {0
|
|
55
|
+
(padded), 4256 (= 532 bytes, non-aligned mod 16 → padded K2), 65536 (= 8192
|
|
56
|
+
bytes, aligned mod 16 → K1)}.
|
|
57
|
+
- [x] **64/88/128-bit truncation** — 9 macLen combinations tested per
|
|
58
|
+
variant.
|
|
59
|
+
- [x] **AES-128/192/256** — 3 keyLens covered for gen and ver.
|
|
60
|
+
- [x] **Constant-time verify** — `verify` uses `bitArray.equal`
|
|
61
|
+
(accumulated XOR); tests `accepts a correct tag` + `rejects a tampered
|
|
62
|
+
tag` + 27 negative ACVP ver tests.
|
|
63
|
+
- [x] **Empty message** — RFC 4493 Ex. 1 + 9 ACVP `msgLen=0` groups.
|
|
64
|
+
- [ ] **Side-channel on PRF** — delegated to `aes.js`.
|
|
65
|
+
|
|
66
|
+
## FIPS 140-3 conformance
|
|
67
|
+
|
|
68
|
+
| Requirement | Status | Evidence |
|
|
69
|
+
|---|---|---|
|
|
70
|
+
| Approved algorithm | ✅ | SP 800-38B + CMAC-AES-1.0 |
|
|
71
|
+
| Validated parameter sizes | ✅ | AES-128/192/256 × msgLen 0/4256/65536 × macLen 64/88/128 |
|
|
72
|
+
| KAT power-on / self-test | ✅ | RFC 4493 §4 + 189 ACVP executed on every `bun test` |
|
|
73
|
+
| CT comparisons (if secret) | ✅ | `verify` → `bitArray.equal` |
|
|
74
|
+
| No `throw` / timing leak | ✅ | Reviewed: no `throw`; `verify` returns `false` |
|
|
75
|
+
|
|
76
|
+
## Known limitations
|
|
77
|
+
|
|
78
|
+
- **CMAC-TDES not covered**: `CMAC-TDES-1.0` present in `references/NIST/`
|
|
79
|
+
but out of scope. **Iteration D3**: added `_checkBlockSize` which
|
|
80
|
+
rejects any PRF with `blockSize !== 16` (TDES = 8 bytes) with a typed
|
|
81
|
+
`DEPRECATED` warning. Prevents any silent use by a consumer that would
|
|
82
|
+
mistakenly pass a TDES PRF.
|
|
83
|
+
- **25 % sub-sampling**: 567 unplayed vectors (567 of 756) share
|
|
84
|
+
the same code paths. The anchors cover `[first, middle, last]`
|
|
85
|
+
per group and each `(keyLen, msgLen, macLen)` combination has at least
|
|
86
|
+
3 gen + 4 ver integrated.
|
|
87
|
+
- ~~**No explicit guard against invalid macLen**~~ ✅ **Iteration
|
|
88
|
+
D3** — added `truncatedMac(prf, message, tagLen)` and
|
|
89
|
+
`truncatedVerify(prf, message, tag, tagLen)` which enforce
|
|
90
|
+
`tagLen ∈ [32, 128]` (SP 800-38B §6.4). The legacy `mac()` API remains
|
|
91
|
+
unchanged (returns 128 bits) for back-compat; the new functions are
|
|
92
|
+
to be used when the caller wants truncation enforced by the module
|
|
93
|
+
instead of handling it by hand.
|
|
94
|
+
- **No bounded `msgLen` check**: SP 800-38B §6.3 sets `Mlen ≤ 2^64 − 1`
|
|
95
|
+
bits (a natural limit of 8 EiB). No guard in the module; the
|
|
96
|
+
constraint is largely out of reach in JS (`Number.MAX_SAFE_INTEGER`).
|
|
97
|
+
- **Test file volume**: ~1.1 MB (msgLen=65536 × ~63 vectors). If an
|
|
98
|
+
IDE issue arises, sub-sample to 1 vector per `msgLen=65536` group.
|
|
99
|
+
|
|
100
|
+
## Cross-references
|
|
101
|
+
|
|
102
|
+
- Module: [`mode/cmac.js`](./cmac.js)
|
|
103
|
+
- Tests: [`mode/cmac.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/mode/cmac.test.js) — 210 tests (197 baseline + 13 iteration D3: TDES guard + truncatedMac SP 800-38B §6.4 enforcement)
|
|
104
|
+
- ACVP draft: `references/NIST/ACVP/src/cmac/`
|
|
105
|
+
- Vectors: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/CMAC-AES-1.0/`
|
|
106
|
+
- Overall conformance: [`NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @fileoverview AES-CMAC (NIST SP 800-38B / RFC 4493).
|
|
7
|
+
*
|
|
8
|
+
* CMAC is a CBC-MAC variant that resists length-extension and avoids the
|
|
9
|
+
* weaknesses of plain CBC-MAC on variable-length messages. Two subkeys
|
|
10
|
+
* (K1, K2) are derived from `L = E_K(0^128)` via doubling in GF(2^128) under
|
|
11
|
+
* p(x) = x^128 + x^7 + x^2 + x + 1 (constant Rb = 0x87). Each subkey is
|
|
12
|
+
* XORed into the final message block - K1 if the block is complete, K2 if
|
|
13
|
+
* the message was padded with `10*`.
|
|
14
|
+
*
|
|
15
|
+
* The PRF must be a 16-byte block cipher exposing `encrypt(block)` (AES is
|
|
16
|
+
* the canonical choice and the only one specified by NIST). Output length
|
|
17
|
+
* is fixed to 128 bits (truncate at the call site if needed).
|
|
18
|
+
*
|
|
19
|
+
*/
|
|
20
|
+
|
|
21
|
+
import { bitArray } from '../utils/bitArray.js';
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* Object returned by `cmac.factory()`. bitArrays are `number[]` (32-bit words).
|
|
25
|
+
* @typedef {object} CmacAPI
|
|
26
|
+
* @property {(prf: {encrypt: Function}, message: number[]) => (number[]|false)} mac 128-bit CMAC tag, or `false` if the PRF is rejected.
|
|
27
|
+
* @property {(prf: {encrypt: Function}, message: number[], tag: number[]) => boolean} verify Constant-time tag verification.
|
|
28
|
+
* @property {(prf: {encrypt: Function}, message: number[], tagLen: number) => (number[]|false)} truncatedMac Truncated MAC (tagLen 32..128 bits).
|
|
29
|
+
* @property {(prf: {encrypt: Function}, message: number[], tag: number[], tagLen: number) => boolean} truncatedVerify Constant-time truncated verification.
|
|
30
|
+
* @property {{ dbl: (b: number[]) => number[] }} _internal Internal primitive (KAT tests only).
|
|
31
|
+
*/
|
|
32
|
+
|
|
33
|
+
export const cmac = {
|
|
34
|
+
name: 'cmac',
|
|
35
|
+
version: '1.0.0',
|
|
36
|
+
type: 'fw.crypto.mode',
|
|
37
|
+
dependencies: ['bitArray'],
|
|
38
|
+
deps: [bitArray],
|
|
39
|
+
|
|
40
|
+
/** @returns {CmacAPI} */
|
|
41
|
+
factory(bitArray) {
|
|
42
|
+
|
|
43
|
+
const _RB = 0x87;
|
|
44
|
+
|
|
45
|
+
// FIPS 140-3 upgrade plan iteration D3 - TDES rejection.
|
|
46
|
+
// SP 800-131A §2.4 marks Triple-DES as deprecated since 2024 and
|
|
47
|
+
// disallowed for cryptographic protection beyond 2023. SP 800-38B §5.1
|
|
48
|
+
// explicitly requires AES (16-byte block). We reject any PRF that
|
|
49
|
+
// advertises a non-128-bit block size. PRFs without an explicit
|
|
50
|
+
// `blockSize` field are accepted (back-compat with our `aes.fn` which
|
|
51
|
+
// doesn't expose the field - it is always a 128-bit AES block PRF).
|
|
52
|
+
function _checkBlockSize(prf) {
|
|
53
|
+
if (prf.blockSize !== undefined && prf.blockSize !== 16) {
|
|
54
|
+
console.warn('[crypto] DEPRECATED: cmac: non-AES block cipher (e.g. TDES, blockSize=' + prf.blockSize + 'B) is deprecated by SP 800-131A §2.4. SP 800-38B §5.1 requires AES (16-byte blocks).');
|
|
55
|
+
return false;
|
|
56
|
+
}
|
|
57
|
+
return true;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/** Doubling in GF(2^128): x → 2·x mod p(x). Operates on 4-word blocks. */
|
|
61
|
+
function _dbl(b) {
|
|
62
|
+
const msb = (b[0] >>> 31) & 1;
|
|
63
|
+
const out = [
|
|
64
|
+
((b[0] << 1) | (b[1] >>> 31)) | 0,
|
|
65
|
+
((b[1] << 1) | (b[2] >>> 31)) | 0,
|
|
66
|
+
((b[2] << 1) | (b[3] >>> 31)) | 0,
|
|
67
|
+
(b[3] << 1) | 0
|
|
68
|
+
];
|
|
69
|
+
if (msb) out[3] ^= _RB;
|
|
70
|
+
return out;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
function _subkeys(prf) {
|
|
74
|
+
const L = prf.encrypt([0, 0, 0, 0]);
|
|
75
|
+
const K1 = _dbl(L);
|
|
76
|
+
const K2 = _dbl(K1);
|
|
77
|
+
return { K1, K2 };
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* Compute the AES-CMAC tag of `message` under `prf`.
|
|
82
|
+
* @param {{encrypt:Function}} prf 16-byte block PRF (AES).
|
|
83
|
+
* @param {Array} message bitArray of any bit length.
|
|
84
|
+
* @returns {Array|false} 128-bit bitArray tag, or `false` if the PRF
|
|
85
|
+
* is rejected (non-AES block size).
|
|
86
|
+
*/
|
|
87
|
+
function mac(prf, message) {
|
|
88
|
+
if (!_checkBlockSize(prf)) return false;
|
|
89
|
+
const { K1, K2 } = _subkeys(prf);
|
|
90
|
+
|
|
91
|
+
const msgBytes = bitArray.ba_to_ui8(message);
|
|
92
|
+
const n = msgBytes.length;
|
|
93
|
+
const complete = n > 0 && (n % 16) === 0;
|
|
94
|
+
const numBlocks = complete ? n / 16 : Math.floor(n / 16) + 1;
|
|
95
|
+
|
|
96
|
+
// Build the final padded block (with K1 or K2 XOR).
|
|
97
|
+
const last = new Uint8Array(16);
|
|
98
|
+
const lastOff = (numBlocks - 1) * 16;
|
|
99
|
+
const lastLen = n - lastOff;
|
|
100
|
+
last.set(msgBytes.subarray(lastOff, lastOff + lastLen), 0);
|
|
101
|
+
if (!complete) last[lastLen] = 0x80;
|
|
102
|
+
const lastBa = bitArray.ui8_to_ba(last);
|
|
103
|
+
const Ksub = complete ? K1 : K2;
|
|
104
|
+
const M_last = [
|
|
105
|
+
lastBa[0] ^ Ksub[0],
|
|
106
|
+
lastBa[1] ^ Ksub[1],
|
|
107
|
+
lastBa[2] ^ Ksub[2],
|
|
108
|
+
lastBa[3] ^ Ksub[3]
|
|
109
|
+
];
|
|
110
|
+
|
|
111
|
+
// CBC-MAC over blocks 1..n-1, then the modified last block.
|
|
112
|
+
let X = [0, 0, 0, 0];
|
|
113
|
+
for (let b = 0; b < numBlocks - 1; b++) {
|
|
114
|
+
const off = b * 16;
|
|
115
|
+
const blk = bitArray.ui8_to_ba(msgBytes.subarray(off, off + 16));
|
|
116
|
+
X = prf.encrypt([X[0] ^ blk[0], X[1] ^ blk[1], X[2] ^ blk[2], X[3] ^ blk[3]]);
|
|
117
|
+
}
|
|
118
|
+
return prf.encrypt([X[0] ^ M_last[0], X[1] ^ M_last[1], X[2] ^ M_last[2], X[3] ^ M_last[3]]);
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* Constant-time tag verification. Delegates the comparison to
|
|
123
|
+
* `bitArray.equal`, which XORs all words into an accumulator and
|
|
124
|
+
* checks the final value - no early exit on the first differing
|
|
125
|
+
* word.
|
|
126
|
+
*/
|
|
127
|
+
function verify(prf, message, tag) {
|
|
128
|
+
const expected = mac(prf, message);
|
|
129
|
+
if (expected === false) return false;
|
|
130
|
+
return bitArray.equal(expected, tag);
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
// FIPS 140-3 upgrade plan iteration D3 - truncated MAC.
|
|
134
|
+
// SP 800-38B §6.4 (Length of MAC) recommends `Tlen ≥ 32 bits` for
|
|
135
|
+
// applications where forgery probability of `2^-Tlen` is acceptable
|
|
136
|
+
// (smaller Tlen requires a per-application risk analysis). The
|
|
137
|
+
// standard explicitly permits Tlen ∈ [32, 128] in 8-bit increments.
|
|
138
|
+
// `truncatedMac` enforces the 32-bit floor and the 128-bit ceiling.
|
|
139
|
+
function truncatedMac(prf, message, tagLen) {
|
|
140
|
+
if (typeof tagLen !== 'number' || !Number.isInteger(tagLen)) {
|
|
141
|
+
console.warn('[crypto] INVALID: cmac: tagLen must be an integer (bits)');
|
|
142
|
+
return false;
|
|
143
|
+
}
|
|
144
|
+
if (tagLen < 32) {
|
|
145
|
+
console.warn('[crypto] WEAK: cmac: tagLen=' + tagLen + ' below SP 800-38B §6.4 minimum (32 bits) - refused');
|
|
146
|
+
return false;
|
|
147
|
+
}
|
|
148
|
+
if (tagLen > 128) {
|
|
149
|
+
console.warn('[crypto] INVALID: cmac: tagLen=' + tagLen + ' exceeds CMAC output (128 bits)');
|
|
150
|
+
return false;
|
|
151
|
+
}
|
|
152
|
+
const full = mac(prf, message);
|
|
153
|
+
if (full === false) return false;
|
|
154
|
+
return bitArray.clamp(full, tagLen);
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
function truncatedVerify(prf, message, tag, tagLen) {
|
|
158
|
+
const expected = truncatedMac(prf, message, tagLen);
|
|
159
|
+
if (expected === false) return false;
|
|
160
|
+
return bitArray.equal(expected, tag);
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
return {
|
|
164
|
+
mac,
|
|
165
|
+
verify,
|
|
166
|
+
truncatedMac,
|
|
167
|
+
truncatedVerify,
|
|
168
|
+
// Internal primitive - exposed for KAT tests only.
|
|
169
|
+
_internal: { dbl: _dbl }
|
|
170
|
+
};
|
|
171
|
+
}
|
|
172
|
+
};
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
# `ctr.js` — ACVP / NIST conformance
|
|
2
|
+
|
|
3
|
+
## Standards
|
|
4
|
+
|
|
5
|
+
- **Primary**: **NIST SP 800-38A** — *Recommendation for Block Cipher Modes
|
|
6
|
+
of Operation: Methods and Techniques*, §6.5 (CTR) + Appendix B (counter
|
|
7
|
+
generation), Appendix F.5 (test vectors).
|
|
8
|
+
- **Secondary**: FIPS 197 (AES) for the block PRF.
|
|
9
|
+
- **ACVP draft**: `references/NIST/ACVP/src/draft-celi-acvp-symmetric.adoc`
|
|
10
|
+
- **Vectors**: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/ACVP-AES-CTR-1.0/`
|
|
11
|
+
|
|
12
|
+
## Implemented algorithm
|
|
13
|
+
|
|
14
|
+
CTR (SP 800-38A §6.5): keystream `K = AES_K(CTR_0) || AES_K(CTR_1) || ...`
|
|
15
|
+
then `C = P XOR K[:|P|]`. Encrypt = decrypt (involution). Counter
|
|
16
|
+
incremented big-endian over 128 bits (carry propagation from the
|
|
17
|
+
least-significant byte). API: `encrypt(prf, pt, iv)` / `decrypt(prf, ct, iv)`;
|
|
18
|
+
128-bit block PRF; payload of arbitrary length (including non-byte-aligned
|
|
19
|
+
via `bitArray.clamp(d, bitLength)`). Helpers `ui8_increase` (+`pos/16`
|
|
20
|
+
blocks) and `ui8_increase_384` (advancement over the last 16 bytes of a
|
|
21
|
+
48-byte buffer — used by AES-256 KeePass derivation).
|
|
22
|
+
|
|
23
|
+
## Test coverage
|
|
24
|
+
|
|
25
|
+
### Integrated official vectors
|
|
26
|
+
|
|
27
|
+
| Source | Reference | Test (`describe` / `test`) | Property verified |
|
|
28
|
+
|---|---|---|---|
|
|
29
|
+
| NIST SP 800-38A App. F.5.1 | AES-128-CTR (4 blocks / 64 bytes) | `NIST SP 800-38A AES-128-CTR vector F.5.1` | KAT byte-exact + involution encrypt=decrypt |
|
|
30
|
+
| **ACVP-AES-CTR-1.0** | AFT encrypt 39/75 (3 testGroups × AES-128/192/256) | `AFT encrypt` | KAT byte-exact, payloadLen 1..1920 bits incl. non-byte/non-block-aligned |
|
|
31
|
+
| **ACVP-AES-CTR-1.0** | AFT decrypt 39/75 (3 testGroups × AES-128/192/256) | `AFT decrypt` | KAT byte-exact, payloadLen 1..1920 bits |
|
|
32
|
+
|
|
33
|
+
#### AFT sub-sampling strategy
|
|
34
|
+
|
|
35
|
+
ACVP-AES-CTR-1.0 exposes **6 testGroups / 150 AFT** (3 keyLen × 2
|
|
36
|
+
directions × 25 tests). Strategy:
|
|
37
|
+
|
|
38
|
+
- **Regular stride**: one tcId out of 2 (≈ 13/25 per group).
|
|
39
|
+
- **Anchors**: `min/max(payloadLen)` per group (covers the extreme
|
|
40
|
+
cases 1 bit and 1920 bits).
|
|
41
|
+
- **Total integrated**: **78 / 150** (≈ 52 %).
|
|
42
|
+
- **Non-byte-aligned payloadLen**: 52/150 ACVP vectors, **retained** in
|
|
43
|
+
the sample; decoded via `bitArray.clamp(ui8_to_ba(bytes), bitLen)`.
|
|
44
|
+
- **Non-block-aligned payloadLen**: 60/150 vectors (final clamp exercised).
|
|
45
|
+
|
|
46
|
+
**IV note for AFT encrypt**: the ACVP CTR suite enumerates `(key, pt,
|
|
47
|
+
payloadLen)` on the prompt side and leaves the IUT to generate the IV.
|
|
48
|
+
We use the IV reported in `expectedResults.json` (one valid IV among
|
|
49
|
+
many) and verify the CT byte-exact against the same source. The
|
|
50
|
+
`_calculate` logic has no IV generation; it is sourced by the caller.
|
|
51
|
+
|
|
52
|
+
### Security properties tested
|
|
53
|
+
|
|
54
|
+
- [x] **AES-128/192/256 keystream** — covered by 6 ACVP testGroups +
|
|
55
|
+
vector F.5.1.
|
|
56
|
+
- [x] **Big-endian counter + carry** — exercised by vectors with
|
|
57
|
+
`payloadLen > 128` (all ≥ 256 bits go through ≥ 2 increments) +
|
|
58
|
+
`ui8_increase` tests `propagates carry across bytes`, `adds ⌊pos/16⌋`,
|
|
59
|
+
`does not mutate input`.
|
|
60
|
+
- [x] **Encrypt = decrypt (involution)** — `decrypt is identical to encrypt`
|
|
61
|
+
+ AFT decrypt (39 distinct vectors) independently validate the symmetry.
|
|
62
|
+
- [x] **Final truncation (clamp to bitLength)** — 60 non-block-aligned
|
|
63
|
+
ACVP vectors + 52 non-byte-aligned → any leak past the `bl`-th bit
|
|
64
|
+
deviates the hex result.
|
|
65
|
+
- [x] **Invalid-length IV** — `iv must be 128 bits` (rejection `false`).
|
|
66
|
+
- [x] **Empty data** — `empty data returns empty array` (null `payloadLen=0` case).
|
|
67
|
+
- [x] **`ui8_increase` + `ui8_increase_384` helpers** — covered by
|
|
68
|
+
4 dedicated tests.
|
|
69
|
+
- [ ] **Side-channel** — delegated to `aes.js` (CTR introduces no
|
|
70
|
+
additional data-dependent branching; XOR + counter carry are **public**).
|
|
71
|
+
- [ ] **IV reuse (catastrophic under CTR)** — not guarded by the
|
|
72
|
+
module: caller's responsibility (see `gcm.nonceTracker` for reference).
|
|
73
|
+
|
|
74
|
+
## FIPS 140-3 conformance
|
|
75
|
+
|
|
76
|
+
| Requirement | Status | Evidence |
|
|
77
|
+
|---|---|---|
|
|
78
|
+
| Approved algorithm | ✅ | SP 800-38A §6.5 + ACVP-AES-CTR-1.0 |
|
|
79
|
+
| Validated parameter sizes | ✅ | AES-128/192/256, payloadLen 1..1920 bits |
|
|
80
|
+
| KAT power-on / self-test | ✅ | F.5.1 + 78 AFT executed on every `bun test` |
|
|
81
|
+
| CT comparisons (if secret) | N/A | No secret comparison in CTR; CT guaranteed by AES |
|
|
82
|
+
| No `throw` / timing leak | ✅ | Reviewed: `console.warn` + `return false` |
|
|
83
|
+
|
|
84
|
+
## Known limitations
|
|
85
|
+
|
|
86
|
+
- **MCT not specified for CTR by the ACVP**: the official suite is
|
|
87
|
+
limited to AFT (unlike AES-CBC/ECB). Not a coverage gap —
|
|
88
|
+
confirmed by inspecting `ACVP-AES-CTR-1.0/prompt.json` (6 testGroups,
|
|
89
|
+
all `testType=AFT`, no `MCT`). **Iteration D4 of the FIPS 140-3
|
|
90
|
+
upgrade plan**: CBC gets its 6 MCTs, CTR stays AFT-only by construction.
|
|
91
|
+
- **No F.5.2/F.5.3/F.5.4 vector (AES-192/256-CTR)** integrated
|
|
92
|
+
manually — covered indirectly by the ACVP encrypt/decrypt × 192/256.
|
|
93
|
+
- **No anti-IV-reuse guard**: if the same (K, IV) pair is
|
|
94
|
+
used for two messages, the keystream is repeated → `XOR(C1, C2) =
|
|
95
|
+
XOR(P1, P2)` (total leak). To be handled by the caller (the `cbc`
|
|
96
|
+
module has the same property, likewise; only `gcm` provides
|
|
97
|
+
`nonceTracker`).
|
|
98
|
+
- **"Monolithic" 128-bit counter**: SP 800-38A App. B allows separate
|
|
99
|
+
counter schemes (nonce || counter with internal wrap). Our
|
|
100
|
+
implementation increments the full 128 bits; no partial wrap.
|
|
101
|
+
Compatible with ACVP vectors that supply an arbitrary IV but not
|
|
102
|
+
strictly RFC 3686 (where only the low-32 counter increments).
|
|
103
|
+
|
|
104
|
+
## Cross-references
|
|
105
|
+
|
|
106
|
+
- Module: [`mode/ctr.js`](./ctr.js)
|
|
107
|
+
- Tests: [`mode/ctr.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/mode/ctr.test.js) — 87 tests (was 9 before this iteration)
|
|
108
|
+
- ACVP draft: `references/NIST/ACVP/src/draft-celi-acvp-symmetric.adoc`
|
|
109
|
+
- Vectors: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/ACVP-AES-CTR-1.0/`
|
|
110
|
+
- Overall conformance: [`NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @fileoverview AES-CTR mode of operation (NIST SP 800-38A).
|
|
7
|
+
*
|
|
8
|
+
* Counter mode XORs a stream of encrypted IV-derived counter blocks against
|
|
9
|
+
* the plaintext. Encryption and decryption are the same operation. This
|
|
10
|
+
* module operates on 16-byte blocks (PRF block size = 128 bits) and exposes
|
|
11
|
+
* additional `_increase` helpers for callers that maintain their own counter
|
|
12
|
+
* state in `Uint8Array` form (16 or 48 bytes).
|
|
13
|
+
*
|
|
14
|
+
* **Counter wrap behaviour** (NIST SP 800-38A §6.5) - the internal counter
|
|
15
|
+
* is the full 128-bit IV interpreted big-endian. Increment is byte-wise from
|
|
16
|
+
* the low end and silently wraps at 2^128. For a uniformly random 128-bit
|
|
17
|
+
* IV the probability of wrapping during a single message is negligible
|
|
18
|
+
* (would require ≥ 2^128 blocks). Callers that reuse an IV across messages
|
|
19
|
+
* MUST not let the per-message block counts overlap : repeated counter
|
|
20
|
+
* blocks under the same (key, IV) reveal the XOR of plaintexts.
|
|
21
|
+
*
|
|
22
|
+
* **Authentication** - CTR is malleable. Pair with a MAC (encrypt-then-MAC)
|
|
23
|
+
* or use an AEAD construction (`mode/gcm`, `mode/chacha20poly1305`).
|
|
24
|
+
*
|
|
25
|
+
*/
|
|
26
|
+
|
|
27
|
+
import { bitArray } from '../utils/bitArray.js';
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* Object returned by `ctr.factory()`. bitArrays are `number[]` (32-bit words).
|
|
31
|
+
* @typedef {object} CtrAPI
|
|
32
|
+
* @property {(prf: {encrypt: Function}, plaintext: number[], iv: number[]) => (number[]|false)} encrypt Encrypt in CTR mode.
|
|
33
|
+
* @property {(prf: {encrypt: Function}, ciphertext: number[], iv: number[]) => (number[]|false)} decrypt Decrypt in CTR mode (identical to encrypt).
|
|
34
|
+
* @property {(prf: {encrypt: Function}, data: number[], iv: number[]) => (number[]|false)} _calculate Internal CTR core.
|
|
35
|
+
* @property {(ui8a: (Uint8Array|number[]), pos: number) => (Uint8Array|number[])} ui8_increase Advance a 16-byte counter by ⌊pos/16⌋ blocks.
|
|
36
|
+
* @property {(ui8a: (Uint8Array|number[]), pos: number) => (Uint8Array|number[])} ui8_increase_384 As `ui8_increase` over the last 16 bytes of a 48-byte buffer.
|
|
37
|
+
*/
|
|
38
|
+
|
|
39
|
+
export const ctr = {
|
|
40
|
+
name: 'ctr',
|
|
41
|
+
version: '1.0.0',
|
|
42
|
+
type: 'fw.crypto.mode',
|
|
43
|
+
dependencies: ['bitArray'],
|
|
44
|
+
deps: [bitArray],
|
|
45
|
+
|
|
46
|
+
/** @returns {CtrAPI} */
|
|
47
|
+
factory(bitArray) {
|
|
48
|
+
|
|
49
|
+
function _calculate(prf, data, iv) {
|
|
50
|
+
if (bitArray.bitLength(iv) !== 128) {
|
|
51
|
+
console.warn('[crypto] INVALID: ctr: iv must be 128 bits');
|
|
52
|
+
return false;
|
|
53
|
+
}
|
|
54
|
+
const l = data.length;
|
|
55
|
+
if (!l) return [];
|
|
56
|
+
|
|
57
|
+
const c = iv.slice(0);
|
|
58
|
+
const d = data.slice(0);
|
|
59
|
+
const bl = bitArray.bitLength(d);
|
|
60
|
+
for (let i = 0; i < l; i += 4) {
|
|
61
|
+
const e = prf.encrypt(c);
|
|
62
|
+
// PRF block-size guard : ctr assumes a 128-bit (4-word) PRF.
|
|
63
|
+
// A non-conforming PRF would silently corrupt the keystream.
|
|
64
|
+
if (e === false || !e || e.length !== 4) {
|
|
65
|
+
console.warn('[crypto] INVALID: ctr: prf.encrypt must return a 4-word (128-bit) block');
|
|
66
|
+
return false;
|
|
67
|
+
}
|
|
68
|
+
d[i] ^= e[0];
|
|
69
|
+
d[i + 1] ^= e[1];
|
|
70
|
+
d[i + 2] ^= e[2];
|
|
71
|
+
d[i + 3] ^= e[3];
|
|
72
|
+
// Increment the 128-bit counter byte-wise from the low end.
|
|
73
|
+
// Wraps silently at 2^128 (see module-level note).
|
|
74
|
+
for (let carry = 3; carry >= 0; carry--) {
|
|
75
|
+
if (++c[carry]) break;
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
return bitArray.clamp(d, bl);
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* Returns a new 16-byte counter advanced by ⌊pos / 16⌋ blocks.
|
|
83
|
+
* @param {Uint8Array|number[]} ui8a 16-byte IV/counter.
|
|
84
|
+
* @param {number} pos Byte offset into the keystream.
|
|
85
|
+
*/
|
|
86
|
+
function ui8_increase(ui8a, pos) {
|
|
87
|
+
const iv = ui8a.slice(0);
|
|
88
|
+
let inc = (pos >> 4) >> 0;
|
|
89
|
+
let rel = inc + iv[15];
|
|
90
|
+
if (rel > 255) {
|
|
91
|
+
iv[15] = rel & 0xff;
|
|
92
|
+
for (let i = 0; i < 15; i++) {
|
|
93
|
+
inc = rel >> 8;
|
|
94
|
+
rel = inc + iv[14 - i];
|
|
95
|
+
if (rel > 255) {
|
|
96
|
+
iv[14 - i] = rel & 0xff;
|
|
97
|
+
} else {
|
|
98
|
+
iv[14 - i] = rel;
|
|
99
|
+
return iv;
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
return iv;
|
|
103
|
+
}
|
|
104
|
+
iv[15] = rel;
|
|
105
|
+
return iv;
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/**
|
|
109
|
+
* Same as {@link ui8_increase} but operating on the last 16 bytes of a
|
|
110
|
+
* 48-byte buffer (used for AES-256 derivation contexts).
|
|
111
|
+
*
|
|
112
|
+
* Iteration bounds : after handling byte 47 (the LSB) the carry loop
|
|
113
|
+
* walks bytes 46 → 32 (i.e. `i > 31`, 15 iterations) - together with
|
|
114
|
+
* byte 47 this covers the full 16-byte counter region (bytes 32..47)
|
|
115
|
+
* while leaving the high 32-byte derivation prefix untouched.
|
|
116
|
+
*/
|
|
117
|
+
function ui8_increase_384(ui8a, pos) {
|
|
118
|
+
const k_iv = ui8a.slice(0);
|
|
119
|
+
let inc = (pos >> 4) >> 0;
|
|
120
|
+
let rel = inc + k_iv[47];
|
|
121
|
+
if (rel > 255) {
|
|
122
|
+
k_iv[47] = rel & 0xff;
|
|
123
|
+
// Bytes 46..32 inclusive (15 iterations) - the remaining 15
|
|
124
|
+
// bytes of the 16-byte counter region [32..47].
|
|
125
|
+
for (let i = 46; i > 31; i--) {
|
|
126
|
+
inc = rel >> 8;
|
|
127
|
+
rel = inc + k_iv[i];
|
|
128
|
+
if (rel > 255) {
|
|
129
|
+
k_iv[i] = rel & 0xff;
|
|
130
|
+
} else {
|
|
131
|
+
k_iv[i] = rel;
|
|
132
|
+
return k_iv;
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
return k_iv;
|
|
136
|
+
}
|
|
137
|
+
k_iv[47] = rel;
|
|
138
|
+
return k_iv;
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
return {
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* Encrypt in CTR mode.
|
|
145
|
+
*
|
|
146
|
+
* Any extra positional arguments after `iv` are accepted (and
|
|
147
|
+
* ignored) for back-compat with legacy callers (e.g.
|
|
148
|
+
* `aes_modes.ctrApi.encrypt` passed a trailing `''` placeholder).
|
|
149
|
+
* New code should pass exactly `(prf, plaintext, iv)`.
|
|
150
|
+
*
|
|
151
|
+
* @param {{encrypt:Function}} prf 16-byte block PRF (e.g. AES instance).
|
|
152
|
+
* @param {Array} plaintext bitArray plaintext.
|
|
153
|
+
* @param {Array} iv 128-bit bitArray initial counter.
|
|
154
|
+
*/
|
|
155
|
+
encrypt(prf, plaintext, iv /* , ...legacyIgnored */) {
|
|
156
|
+
return _calculate(prf, plaintext, iv);
|
|
157
|
+
},
|
|
158
|
+
|
|
159
|
+
/**
|
|
160
|
+
* Decrypt in CTR mode (identical to encrypt).
|
|
161
|
+
*
|
|
162
|
+
* Extra trailing arguments are ignored (legacy callers). New code
|
|
163
|
+
* should pass exactly `(prf, ciphertext, iv)`.
|
|
164
|
+
*/
|
|
165
|
+
decrypt(prf, ciphertext, iv /* , ...legacyIgnored */) {
|
|
166
|
+
return _calculate(prf, ciphertext, iv);
|
|
167
|
+
},
|
|
168
|
+
|
|
169
|
+
_calculate,
|
|
170
|
+
ui8_increase,
|
|
171
|
+
ui8_increase_384
|
|
172
|
+
};
|
|
173
|
+
}
|
|
174
|
+
};
|