@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,91 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: ecc
|
|
3
|
+
category: crypto/pkc
|
|
4
|
+
dependencies: [bitArray, hex, bn, sha256, sha384, sha512, hmac]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# ecc
|
|
11
|
+
|
|
12
|
+
> ECDSA (FIPS 186-5 §6) on P-{224,256,384,521} + K-curves. RFC 6979 deterministic by default.
|
|
13
|
+
|
|
14
|
+
**Module** `ecc` | **Source** `packages/front/fw/src/crypto/pkc/ecc.js` | **Deps** `bitArray`, `hex`, `bn`, `sha256`, `sha384`, `sha512`, `hmac` | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
FIPS 186-5 + RFC 6979 compliant ECDSA (deterministic k via HMAC-DRBG, eliminates leakage from a biased random k). Subgroup check `n·Q == O` active on all `deserialize` calls.
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const ecc = runtime.resolve('ecc');
|
|
22
|
+
// Returns: { curves, publicKey, secretKey, sign, verify, deserialize, _internal }
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## API
|
|
26
|
+
|
|
27
|
+
| Method | Signature | Returns |
|
|
28
|
+
|--------|-----------|---------|
|
|
29
|
+
| `curves` | `{c192, c224, c256, c384, c521, k192, k224, k256, k283, k409, k571}` | Available curves |
|
|
30
|
+
| `secretKey(curve, exponent)` | — | `{exponent, publicKey, sign, verify}` |
|
|
31
|
+
| `publicKey(curve, point)` | — | `{point, verify}` |
|
|
32
|
+
| `sign(hash, opts?)` | `(bitArray, {strict?, hashForK?, deterministic?}) => Object` | `{r, s}` (deterministic by default) |
|
|
33
|
+
| `verify(hash, rs, opts?)` | `(bitArray, {r,s}, {strict?, fakeLegacyVersion?}) => boolean` | Constant-time |
|
|
34
|
+
| `deserialize(bits, curveName)` | — | Public key (subgroup-checked) |
|
|
35
|
+
|
|
36
|
+
### Options
|
|
37
|
+
|
|
38
|
+
- **`strict: true`** (sign / verify): canonicalises low-s + rejects `s > n/2` (SP 800-131A "NIST strict").
|
|
39
|
+
- **`hashForK: hashMod`** (sign): explicitly sets the hash for K derivation (RFC 6979 strict: H_K = H_msg).
|
|
40
|
+
- **`deterministic: false`** (sign): reverts to random k (NOT RECOMMENDED).
|
|
41
|
+
|
|
42
|
+
## Examples
|
|
43
|
+
|
|
44
|
+
### Sign + verify P-256 / SHA-256
|
|
45
|
+
|
|
46
|
+
```js
|
|
47
|
+
const { ecc, sha256 } = fw.runtime.resolveAll(['ecc', 'sha256']);
|
|
48
|
+
|
|
49
|
+
const sk = ecc.secretKey(ecc.curves.c256);
|
|
50
|
+
const pk = sk.publicKey;
|
|
51
|
+
|
|
52
|
+
const hashBa = sha256.hash('message');
|
|
53
|
+
const sig = sk.sign(hashBa); // deterministic RFC 6979
|
|
54
|
+
const ok = pk.verify(hashBa, sig); // true
|
|
55
|
+
|
|
56
|
+
// Strict mode (low-s)
|
|
57
|
+
const sigStrict = sk.sign(hashBa, { strict: true });
|
|
58
|
+
const okStrict = pk.verify(hashBa, sigStrict, { strict: true });
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### Subgroup check (deserialize)
|
|
62
|
+
|
|
63
|
+
```js
|
|
64
|
+
const pkPoint = ecc.deserialize(rawBytes, 'c256'); // false if point is outside the subgroup
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
## Worker Usage
|
|
68
|
+
|
|
69
|
+
```js
|
|
70
|
+
const worker = fw.createWorker(
|
|
71
|
+
function ({ libs, args }) {
|
|
72
|
+
const sk = libs.ecc.secretKey(libs.ecc.curves.c256, args[0]);
|
|
73
|
+
self.postMessage(sk.sign(args[1]));
|
|
74
|
+
},
|
|
75
|
+
{ dependencies: ['ecc'], args: [exponent, hashBa] }
|
|
76
|
+
);
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
## Notes
|
|
80
|
+
|
|
81
|
+
- **Deterministic k RFC 6979**: by default, eliminates any risk of leakage from a reused or biased k.
|
|
82
|
+
- **Scalar mult NOT constant-time**: 4-bit windowed method with pre-computed multiple table — the index is the scalar nibble, observable via cache-timing (Bernstein 2005). Acceptable in a browser without a co-resident adversary; for multi-tenant servers prefer WebCrypto `subtle.*` or X25519/Ed25519.
|
|
83
|
+
- **Subgroup check FIPS 186-5 §A.4.2**: `deserialize` rejects points outside the subgroup of order `n` (~1-3 ms per P-256).
|
|
84
|
+
- **P-521 RFC 6979** byte-exact (fixes the `bn.bitLength() = 528` rounding bug via the `_trueBitLength` helper).
|
|
85
|
+
- **K-curves (Koblitz)**: covered (k192, k224, k256, k283, k409, k571) but deprecated by NIST SP 800-186 — prefer P-curves.
|
|
86
|
+
|
|
87
|
+
## See also
|
|
88
|
+
|
|
89
|
+
- [bn](../utils/bn.md), [hmac](../hash/hmac.md) — underlying primitives
|
|
90
|
+
- [ed25519](./ed25519.md) — faster EdDSA alternative
|
|
91
|
+
- [Conformance ecc.acvp.md](../../../../src/crypto/pkc/ecc.acvp.md)
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: ed25519
|
|
3
|
+
category: crypto/pkc
|
|
4
|
+
dependencies: [sha512, bitArray]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# ed25519
|
|
11
|
+
|
|
12
|
+
> Ed25519 (RFC 8032 / FIPS 186-5 §7.6) — EdDSA pure + ph (preHash) + ctx (context).
|
|
13
|
+
|
|
14
|
+
**Module** `ed25519` | **Source** `packages/front/fw/src/crypto/pkc/ed25519.js` | **Deps** `sha512`, `bitArray` | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
EdDSA over Curve25519 (cofactor 8). Faster than ECDSA, deterministic by construction (no RNG required to sign). Ed448 explicit reject (FIPS 186-5 §7.7 out of scope).
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const ed25519 = runtime.resolve('ed25519');
|
|
22
|
+
// Returns: { keyPair, sign, verify, signPh, verifyPh, signCtx, verifyCtx, ed448 }
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## API
|
|
26
|
+
|
|
27
|
+
| Method | Signature | Returns |
|
|
28
|
+
|--------|-----------|---------|
|
|
29
|
+
| `keyPair(seed)` | `(Uint8Array(32)) => {publicKey, privateKey} \| false` | Derives the pair from the seed; `false` if seed absent or ≠ 32 bytes |
|
|
30
|
+
| `sign(privateKey, msg)` | `(Uint8Array(64), Uint8Array) => Uint8Array(64) \| false` | Pure Ed25519 signature (`privateKey` = seed ‖ pubKey, 64 bytes) |
|
|
31
|
+
| `verify(publicKey, msg, sig)` | `(Uint8Array(32), Uint8Array, Uint8Array(64)) => boolean` | Verifies + rejects s≥L constant-time |
|
|
32
|
+
| `signPh(privateKey, msg, ctx?)` | `(Uint8Array(64), Uint8Array, Uint8Array?) => Uint8Array(64) \| false` | Ed25519ph — pass the **raw message** (SHA-512 applied internally) |
|
|
33
|
+
| `verifyPh(publicKey, msg, sig, ctx?)` | — | `boolean` |
|
|
34
|
+
| `signCtx(privateKey, msg, ctx)` | `(Uint8Array(64), Uint8Array, Uint8Array(1..255)) => Uint8Array(64) \| false` | Ed25519ctx (context required, 1..255 bytes) |
|
|
35
|
+
| `verifyCtx(publicKey, msg, sig, ctx)` | — | `boolean` |
|
|
36
|
+
| `ed448.{keyPair,sign,verify,signPh,verifyPh}` | `() => false` | **NOT-IMPLEMENTED** explicit reject |
|
|
37
|
+
|
|
38
|
+
## Examples
|
|
39
|
+
|
|
40
|
+
### Pure EdDSA
|
|
41
|
+
|
|
42
|
+
```js
|
|
43
|
+
const { ed25519, random } = fw.runtime.resolveAll(['ed25519', 'random']);
|
|
44
|
+
const { privateKey, publicKey } = ed25519.keyPair(random.bytes(32));
|
|
45
|
+
|
|
46
|
+
const msg = new TextEncoder().encode('Hello, EdDSA!');
|
|
47
|
+
const sig = ed25519.sign(privateKey, msg);
|
|
48
|
+
const ok = ed25519.verify(publicKey, msg, sig); // true
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### Ed25519ph (prehash + dom2)
|
|
52
|
+
|
|
53
|
+
```js
|
|
54
|
+
// signPh takes the raw message — SHA-512 is applied internally
|
|
55
|
+
const sig = ed25519.signPh(privateKey, msg);
|
|
56
|
+
const ok = ed25519.verifyPh(publicKey, msg, sig);
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
### Ed25519ctx (context separation)
|
|
60
|
+
|
|
61
|
+
```js
|
|
62
|
+
const ctx = new TextEncoder().encode('app-v1'); // 1..255 bytes required
|
|
63
|
+
const sig = ed25519.signCtx(privateKey, msg, ctx);
|
|
64
|
+
const ok = ed25519.verifyCtx(publicKey, msg, sig, ctx);
|
|
65
|
+
const bad = ed25519.verifyCtx(publicKey, msg, sig, otherCtx); // false
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
### Ed448 rejected
|
|
69
|
+
|
|
70
|
+
```js
|
|
71
|
+
ed25519.ed448.keyPair(); // false + console.warn('NOT-IMPLEMENTED: ed25519: Ed448 ...')
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## Worker Usage
|
|
75
|
+
|
|
76
|
+
```js
|
|
77
|
+
const worker = fw.createWorker(
|
|
78
|
+
function ({ libs, args }) {
|
|
79
|
+
const sig = libs.ed25519.sign(args[0], args[1]);
|
|
80
|
+
self.postMessage(sig);
|
|
81
|
+
},
|
|
82
|
+
{ dependencies: ['ed25519'], args: [privateKey, msg] }
|
|
83
|
+
);
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
## Notes
|
|
87
|
+
|
|
88
|
+
- **Deterministic**: `sign(sk, msg)` does NOT consume any RNG (k derived from sk + msg via SHA-512). Byte-exact reproducible.
|
|
89
|
+
- **s < L check**: `verify` rejects signatures where `s ≥ L` (constant-time, RFC 8032 §5.1.7 step 2) — prevents malleability (s + k·L would otherwise be valid).
|
|
90
|
+
- **`keyPair(seed)` — seed required**: `keyPair()` without argument returns `false` + warn. Use `random.bytes(32)` for generation.
|
|
91
|
+
- **Ed25519ph**: pass the **raw message** — `signPh` applies SHA-512 internally. Do not pre-hash before the call.
|
|
92
|
+
- **Ed448 not implemented** — edwards448 curve + SHAKE-256; create a separate `ed448.js` module if required for CMVP.
|
|
93
|
+
|
|
94
|
+
## See also
|
|
95
|
+
|
|
96
|
+
- [sha512](../hash/sha512.md) — mandatory Ed25519 primitive
|
|
97
|
+
- [x25519](./x25519.md) — companion DH (same curve)
|
|
98
|
+
- [ecc](./ecc.md) — alternative ECDSA
|
|
99
|
+
- [Conformance ed25519.acvp.md](../../../../src/crypto/pkc/ed25519.acvp.md)
|
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: hybridKem
|
|
3
|
+
category: crypto/pkc
|
|
4
|
+
dependencies: [x25519, ml_kem, sha3]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# hybridKem
|
|
11
|
+
|
|
12
|
+
> X-Wing hybrid KEM — X25519 + ML-KEM-768, IETF KAT-verified (draft rev -06).
|
|
13
|
+
|
|
14
|
+
**Module** `hybridKem` | **Source** `packages/front/fw/src/crypto/pkc/hybridKem.js` | **Deps** `x25519`, `ml_kem`, `sha3` | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
X-Wing is a general-purpose **hybrid** Key Encapsulation Mechanism combining the
|
|
17
|
+
classical X25519 Diffie–Hellman KEM with the NIST post-quantum KEM ML-KEM-768, so
|
|
18
|
+
that the shared secret stays secure as long as **either** component resists
|
|
19
|
+
attack (harvest-now-decrypt-later hedge). It is a pure composition over the vetted
|
|
20
|
+
fw primitives [`x25519`](./x25519.md), [`ml_kem`](./ml_kem.md) and
|
|
21
|
+
[`sha3`](../hash/sha3.md) — no novel cryptography.
|
|
22
|
+
|
|
23
|
+
## Resolve
|
|
24
|
+
|
|
25
|
+
```js
|
|
26
|
+
const hybridKem = runtime.resolve('hybridKem');
|
|
27
|
+
// Returns: { xwing }
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
Direct ESM (a ready-to-use `xwing` over default fw primitives, lazily wired):
|
|
31
|
+
|
|
32
|
+
```js
|
|
33
|
+
import { xwing } from '@awacloud/fw/crypto/pkc/hybridKem.js';
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Construction (FROZEN)
|
|
37
|
+
|
|
38
|
+
X-Wing per `draft-connolly-cfrg-xwing-kem` **revision -06** (CFRG) — the revision
|
|
39
|
+
whose Appendix C KAT the in-repo libsodium reference
|
|
40
|
+
(`references/CRYPTO-SRC/libsodium/test/default/kem_xwing.c`, tv0..tv2) encodes.
|
|
41
|
+
|
|
42
|
+
- **Combiner** (draft §5.3, fixed-label variant):
|
|
43
|
+
`ss = SHA3-256( ss_ML-KEM || ss_X25519 || ct_X25519 || pk_X25519 || label )`,
|
|
44
|
+
`label = 5c 2e 2f 2f 5e 5c` (ASCII `\.//^\`). The fixed label pins the scheme
|
|
45
|
+
and binds `ct_X25519 || pk_X25519`, so a component key cannot be reused in
|
|
46
|
+
another combiner without changing the label domain.
|
|
47
|
+
- **Key derivation** (draft §5.1): the secret key is a **32-byte seed**;
|
|
48
|
+
`expanded = SHAKE256(seed, 96)` splits into `mlkem_seed = expanded[0..64)`
|
|
49
|
+
(`d || z` for ML-KEM keygen) and `sk_X25519 = expanded[64..96)`.
|
|
50
|
+
|
|
51
|
+
## Key encoding
|
|
52
|
+
|
|
53
|
+
Fixed-length concatenation — component sizes **are** the scheme identifier, so no
|
|
54
|
+
length prefix is used.
|
|
55
|
+
|
|
56
|
+
| Artefact | Encoding | Size |
|
|
57
|
+
|----------|----------|------|
|
|
58
|
+
| `pk` | `pk_ML-KEM(1184) \| pk_X25519(32)` | 1216 B |
|
|
59
|
+
| `sk` | the X-Wing seed (expand-on-use) | 32 B |
|
|
60
|
+
| `ct` | `ct_ML-KEM(1088) \| ct_X25519(32)` | 1120 B |
|
|
61
|
+
| `ss` | shared secret | 32 B |
|
|
62
|
+
|
|
63
|
+
## API
|
|
64
|
+
|
|
65
|
+
`xwing` — the single X-Wing hybrid KEM instance.
|
|
66
|
+
|
|
67
|
+
| Method | Signature | Returns |
|
|
68
|
+
|--------|-----------|---------|
|
|
69
|
+
| `xwing.lengths` | `{ pk: 1216, sk: 32, ct: 1120, ss: 32 }` | Byte sizes |
|
|
70
|
+
| `xwing.keygen(seed?)` | `(Uint8Array(32)?) => {publicKey, secretKey} \| false` | Keypair; deterministic for a 32-byte seed, random otherwise |
|
|
71
|
+
| `xwing.encapsulate(publicKey, rnd?)` | `(Uint8Array(1216), Uint8Array(64)?) => {cipherText, sharedSecret} \| false` | Encapsulate; `rnd = msg32 \| eskX32`, deterministic when supplied |
|
|
72
|
+
| `xwing.decapsulate(cipherText, secretKey)` | `(Uint8Array(1120), Uint8Array(32)) => Uint8Array(32) \| false` | Shared secret; implicit-reject on a tampered ct, `false` on malformed length |
|
|
73
|
+
|
|
74
|
+
Returns `Uint8Array` everywhere; `false` on invalid input (fw crypto idiom).
|
|
75
|
+
|
|
76
|
+
## Examples
|
|
77
|
+
|
|
78
|
+
### KEM end-to-end
|
|
79
|
+
|
|
80
|
+
```js
|
|
81
|
+
const hybridKem = runtime.resolve('hybridKem');
|
|
82
|
+
const { xwing } = hybridKem;
|
|
83
|
+
|
|
84
|
+
// Receiver
|
|
85
|
+
const { publicKey, secretKey } = xwing.keygen();
|
|
86
|
+
|
|
87
|
+
// Sender (receives publicKey)
|
|
88
|
+
const { cipherText, sharedSecret } = xwing.encapsulate(publicKey);
|
|
89
|
+
|
|
90
|
+
// Receiver (receives cipherText)
|
|
91
|
+
const sharedSecret2 = xwing.decapsulate(cipherText, secretKey);
|
|
92
|
+
// sharedSecret === sharedSecret2 (32 bytes)
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### Deterministic (KAT) form
|
|
96
|
+
|
|
97
|
+
```js
|
|
98
|
+
import { xwing } from '@awacloud/fw/crypto/pkc/hybridKem.js';
|
|
99
|
+
|
|
100
|
+
const { publicKey, secretKey } = xwing.keygen(seed32); // fixed 32-byte seed
|
|
101
|
+
const { cipherText, sharedSecret } = xwing.encapsulate(publicKey, rnd64); // msg32||eskX32
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
## Worker Usage
|
|
105
|
+
|
|
106
|
+
The descriptor factory is a self-contained pure composition (concat +
|
|
107
|
+
SHAKE256/SHA3-256 KDF), so the whole hybrid operation runs inside one Worker call
|
|
108
|
+
with no main-thread round-trips.
|
|
109
|
+
|
|
110
|
+
```js
|
|
111
|
+
const worker = fw.createWorker(['hybridKem']);
|
|
112
|
+
const kp = await worker.call('hybridKem.xwing.keygen');
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
## Constant-time & zeroization posture (honest)
|
|
116
|
+
|
|
117
|
+
- **Timing is NOT a security boundary.** The X25519 ladder and ML-KEM FO selection
|
|
118
|
+
are written branch-lean, but browser JS/WASM cannot guarantee constant time (JIT,
|
|
119
|
+
GC, no `mlock`). Do not rely on this module for side-channel resistance.
|
|
120
|
+
- **Zeroization is best-effort only, never a guarantee.** Transient key expansions
|
|
121
|
+
and component secrets are `.fill(0)`'d after use, but the runtime may retain GC
|
|
122
|
+
copies or JIT-resident intermediates. Treat at-rest secret handling as the
|
|
123
|
+
caller's responsibility.
|
|
124
|
+
|
|
125
|
+
## Positioning & liability
|
|
126
|
+
|
|
127
|
+
awa ships X-Wing as a **certifiable cryptographic component**, not a certified
|
|
128
|
+
product: no ANSSI/FIPS certification of the composite scheme is claimed here. The
|
|
129
|
+
underlying ML-KEM-768 is ACVP-green (`src/crypto/pkc/ml_kem.acvp.md`); X25519 is
|
|
130
|
+
RFC 7748 vector-green. Correctness is anchored to the **official IETF X-Wing KAT**
|
|
131
|
+
(tv0..tv2, full 32-byte shared-secret match), not merely a self-consistent
|
|
132
|
+
round-trip. Rejected-but-noted alternatives (X25519MLKEM768 TLS-concat combiner;
|
|
133
|
+
generic HKDF `Z||T` combiner) are intentionally NOT shipped — X-Wing's fixed label
|
|
134
|
+
is the safer general-purpose default.
|
|
135
|
+
|
|
136
|
+
## Evidence & vectors
|
|
137
|
+
|
|
138
|
+
Correctness is anchored to the **official IETF X-Wing KAT** and locked by a
|
|
139
|
+
deterministic, network-free regeneration proof.
|
|
140
|
+
|
|
141
|
+
| Vector set | Id | Source | What it proves |
|
|
142
|
+
|---|---|---|---|
|
|
143
|
+
| X-Wing IETF KAT | `tv0..tv2` | `src/crypto/pkc/__fixtures__/xwing-ietf-kat.js` (test fixture — repository only, not shipped) — `draft-connolly-cfrg-xwing-kem` rev -06 App. C | Full 32-byte `ss` byte-match + `ek`/`ct` prefixes (not a mere round-trip) |
|
|
144
|
+
|
|
145
|
+
- **Regeneration proof** — `bun packages/front/fw/tools/hybrid-kat-regen.js`
|
|
146
|
+
recomputes `ekPrefix` / `ctPrefix` / full `ss` for tv0..tv2 from the published
|
|
147
|
+
`seed` + `randomness` through the frozen `xwing`, and asserts byte-identity
|
|
148
|
+
(exit 0/1). Wired as a test in
|
|
149
|
+
[`hybrid-kat-regen.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/pkc/hybrid-kat-regen.test.js)
|
|
150
|
+
so CI exercises it every run.
|
|
151
|
+
- **Provenance** — per-file source / revision / SHA-256 in
|
|
152
|
+
[`hybrid-kat.provenance.md`](../../../../src/crypto/pkc/hybrid-kat.provenance.md).
|
|
153
|
+
|
|
154
|
+
### Coverage gaps
|
|
155
|
+
|
|
156
|
+
- **Covered**: X-Wing tv0..tv2 full shared-secret KAT; implicit-reject on a
|
|
157
|
+
tampered ciphertext; malformed-length rejection. The underlying **ML-KEM-768**
|
|
158
|
+
is ACVP-green ([`ml_kem.acvp.md`](../../../../src/crypto/pkc/ml_kem.acvp.md)) and **X25519** is RFC 7748
|
|
159
|
+
vector-green — those greens are **cited, not re-run** here.
|
|
160
|
+
- **Not covered**: there is **no ACVP / CAVP program for X-Wing** (it is a
|
|
161
|
+
draft-stage composite KEM, not a NIST-approved algorithm), so no certified
|
|
162
|
+
test harness exists for the composite; the KAT above is the authoritative
|
|
163
|
+
oracle. Side-channel / constant-time behaviour is out of scope (see below).
|
|
164
|
+
|
|
165
|
+
## Notes
|
|
166
|
+
|
|
167
|
+
- Pinned draft revision **-06**; a future draft that changes the combiner, label,
|
|
168
|
+
or key derivation breaks interop — re-pin and re-verify against fresh vectors.
|
|
169
|
+
- Deterministic for fixed inputs (32-byte seed, 64-byte encaps randomness), which
|
|
170
|
+
is exactly what the KAT exercises; production callers omit them to draw the
|
|
171
|
+
platform CSPRNG.
|
|
172
|
+
|
|
173
|
+
## See also
|
|
174
|
+
|
|
175
|
+
- [`ml_kem`](./ml_kem.md) — the post-quantum KEM leg (ML-KEM-768).
|
|
176
|
+
- [`x25519`](./x25519.md) — the classical Diffie–Hellman leg.
|
|
177
|
+
- [`hybridSign`](./hybridSign.md) — companion composite-signature hybrid (shares
|
|
178
|
+
the positioning & zeroization posture).
|
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: hybridSign
|
|
3
|
+
category: crypto/pkc
|
|
4
|
+
dependencies: [ml_dsa, ed25519, ecc, sha512, sha256, random, utf8]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# hybridSign
|
|
11
|
+
|
|
12
|
+
> Composite PQ/T signatures (LAMPS draft) — ML-DSA-65 ∧ Ed25519 / ECDSA-P-256, AND-verify.
|
|
13
|
+
|
|
14
|
+
**Module** `hybridSign` | **Source** `packages/front/fw/src/crypto/pkc/hybridSign.js` | **Deps** `ml_dsa`, `ed25519`, `ecc`, `sha512`, `sha256`, `random`, `utf8` | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
Composes vetted fw primitives into `draft-ietf-lamps-pq-composite-sigs` composite signatures — no novel cryptography. Both components sign one representative `M'`; verify is the logical AND of both, so no component can be stripped or downgraded.
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const hybridSign = runtime.resolve('hybridSign');
|
|
22
|
+
// Returns: { mldsa65_ed25519, mldsa65_ecdsaP256, _internal }
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Construction (frozen, vector-verified)
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
M' = Prefix || Label || len(ctx) || ctx || SHA-512(M) [draft §5.3]
|
|
29
|
+
Prefix = ASCII "CompositeAlgorithmSignatures2025" (32 B) [draft §5.2]
|
|
30
|
+
Label = the per-variant ASCII label (see table) [draft §11]
|
|
31
|
+
len(ctx) = 1 byte (ctx is 0..255 bytes; default empty)
|
|
32
|
+
|
|
33
|
+
sig_ML-DSA = ML-DSA-65.Sign(M', mldsa_ctx = Label) (FIPS 204 Alg 2)
|
|
34
|
+
sig_trad = Ed25519.Sign(M') (its own ctx unused)
|
|
35
|
+
| ECDSA-P256.Sign(SHA-256(M')) (DER-encoded r,s)
|
|
36
|
+
verify = ML-DSA verify AND trad verify over the reconstructed M'
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
The current draft has **no** per-signature randomizer `r` and uses an ASCII
|
|
40
|
+
`Label` (not a DER-OID Domain). This exact wiring reproduces the official LAMPS
|
|
41
|
+
interop vectors.
|
|
42
|
+
|
|
43
|
+
## Variants
|
|
44
|
+
|
|
45
|
+
| Variant | OID | Label (ASCII) | Composite pk | Composite sig |
|
|
46
|
+
|---------|-----|---------------|--------------|---------------|
|
|
47
|
+
| `mldsa65_ed25519` | `1.3.6.1.5.5.7.6.48` | `COMPSIG-MLDSA65-Ed25519-SHA512` | 1952 + 32 B | 3309 + 64 = 3373 B |
|
|
48
|
+
| `mldsa65_ecdsaP256` | `1.3.6.1.5.5.7.6.45` | `COMPSIG-MLDSA65-ECDSA-P256-SHA512` | 1952 + 65 B | 3309 + DER (variable) |
|
|
49
|
+
|
|
50
|
+
## API
|
|
51
|
+
|
|
52
|
+
| Method | Signature | Returns |
|
|
53
|
+
|--------|-----------|---------|
|
|
54
|
+
| `<variant>.lengths` | object | Component + container byte lengths |
|
|
55
|
+
| `<variant>.keygen()` | `() => {publicKey, secretKey}` | TLV-encoded key pair (independent seeds) |
|
|
56
|
+
| `<variant>.sign(sk, msg, ctx?)` | `(Uint8Array, Uint8Array, Uint8Array?) => Uint8Array \| false` | Composite signature |
|
|
57
|
+
| `<variant>.verify(pk, msg, sig, ctx?)` | `(Uint8Array, Uint8Array, Uint8Array, Uint8Array?) => boolean` | AND of both components |
|
|
58
|
+
|
|
59
|
+
Inputs/outputs are `Uint8Array`; any invalid input returns `false` (sign) or
|
|
60
|
+
`false` (verify). `ctx` is an optional 0..255-byte application context bound
|
|
61
|
+
into `M'`.
|
|
62
|
+
|
|
63
|
+
## Encoding
|
|
64
|
+
|
|
65
|
+
- **Public / secret keys** use a length-prefixed TLV container
|
|
66
|
+
`schemeId(1) || u16(len) || component …` so a parser cannot be tricked into
|
|
67
|
+
re-slicing composite bytes (guards component-splicing). `schemeId` = `0x01`
|
|
68
|
+
(Ed25519) / `0x02` (ECDSA-P256); a wrong id, truncation, or trailing byte is
|
|
69
|
+
rejected.
|
|
70
|
+
- **Ed25519 signature** is fixed slices `mldsaSig(3309) || edSig(64)` — identical
|
|
71
|
+
to the official wire form (no randomizer).
|
|
72
|
+
- **ECDSA-P256 signature** length-prefixes its variable DER component:
|
|
73
|
+
`mldsaSig(3309) || u16(derLen) || DER`.
|
|
74
|
+
|
|
75
|
+
The official LAMPS vectors use a plain component concat; the vendored conformance
|
|
76
|
+
tests re-frame the exact official component bytes into this container and verify
|
|
77
|
+
through the real `verify()` path.
|
|
78
|
+
|
|
79
|
+
## Examples
|
|
80
|
+
|
|
81
|
+
```js
|
|
82
|
+
const hybridSign = runtime.resolve('hybridSign');
|
|
83
|
+
const v = hybridSign.mldsa65_ed25519;
|
|
84
|
+
|
|
85
|
+
const { publicKey, secretKey } = v.keygen();
|
|
86
|
+
const msg = new TextEncoder().encode('hello');
|
|
87
|
+
const sig = v.sign(secretKey, msg);
|
|
88
|
+
v.verify(publicKey, msg, sig); // true
|
|
89
|
+
|
|
90
|
+
// bind an application context
|
|
91
|
+
const ctx = new TextEncoder().encode('app:v1');
|
|
92
|
+
const sigCtx = v.sign(secretKey, msg, ctx);
|
|
93
|
+
v.verify(publicKey, msg, sigCtx, ctx); // true
|
|
94
|
+
v.verify(publicKey, msg, sigCtx); // false — ctx mismatch
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
## Worker Usage
|
|
98
|
+
|
|
99
|
+
The whole composite operation is pure composition (SHA-512 pre-hash, component
|
|
100
|
+
sign/verify, AND) and runs in a single Worker call; the PQ primitive loads as it
|
|
101
|
+
does on the main thread.
|
|
102
|
+
|
|
103
|
+
```js
|
|
104
|
+
const worker = fw.createWorker(['hybridSign']);
|
|
105
|
+
const sig = await worker.call('hybridSign', 'mldsa65_ecdsaP256', 'sign', [sk, msg]);
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
## §6 — Constant-time posture (honest)
|
|
109
|
+
|
|
110
|
+
- Browser JS/WASM **cannot guarantee constant-time**: JIT, GC, and the absence of
|
|
111
|
+
`mlock` mean timing is **not a security boundary**. Treat it as best-effort.
|
|
112
|
+
- The fw `ecc` P-256 scalar path is a 4-bit windowed method (cache-timing
|
|
113
|
+
sensitive on a co-resident adversary). ML-DSA and Ed25519 are written
|
|
114
|
+
branch-lean but are still pure-JS. For adversarial co-tenancy prefer a
|
|
115
|
+
platform constant-time backend.
|
|
116
|
+
- **Zeroization is best-effort only.** `keygen()` `.fill(0)`s transient seeds and
|
|
117
|
+
intermediate scalars, but JS cannot guarantee a wipe (GC copies, JIT-resident
|
|
118
|
+
values). Never rely on it as a security guarantee.
|
|
119
|
+
|
|
120
|
+
## §9 — Limits & non-claims
|
|
121
|
+
|
|
122
|
+
- **Not FIPS-validated as a composite.** The underlying ML-DSA / Ed25519 / ECDSA
|
|
123
|
+
primitives carry their own validation status; the composite wrapper is not
|
|
124
|
+
independently validated.
|
|
125
|
+
- **Vector revision pin.** Conformance is byte-exact against the official
|
|
126
|
+
`draft-ietf-lamps-pq-composite-sigs` interop vectors, now **re-pinned to the
|
|
127
|
+
numbered IETF revision -19** (tag `draft-ietf-lamps-pq-composite-sigs-19`,
|
|
128
|
+
commit `6df63fdc`, re-vendored 2026-07-09). The -19 bytes were fetched and
|
|
129
|
+
confirmed **byte-identical** to the original `main @1bb9f5c6` vendoring for
|
|
130
|
+
every field (PK, both signatures, message, context) of both variants — the WG
|
|
131
|
+
numbered revision **retains** this construction (ASCII `Label`, no `r`). A
|
|
132
|
+
future draft that re-introduces `r` or changes `Label`/`PH` would break interop
|
|
133
|
+
(construction drift → escalate, do not silently re-vendor).
|
|
134
|
+
- **Draft table inconsistency (ECDSA-P256).** The draft's own `labelsTable.md`
|
|
135
|
+
lists the label as `COMPSIG-MLDSA65-P256-SHA512` while `algParams.md` lists
|
|
136
|
+
`COMPSIG-MLDSA65-ECDSA-P256-SHA512`. The committed vectors are authoritative and
|
|
137
|
+
verify **only** with the latter; the module uses the vector-proven label.
|
|
138
|
+
- **Dependency note.** The module depends on `sha256` (ECDSA-P256 inner hash,
|
|
139
|
+
vector-proven) and `random` (Ed25519 keygen seed) in addition to the original design
|
|
140
|
+
sketch — both are load-bearing.
|
|
141
|
+
|
|
142
|
+
## Evidence & vectors
|
|
143
|
+
|
|
144
|
+
Correctness is anchored to the **official LAMPS interop vectors** (byte-exact,
|
|
145
|
+
both variants, empty-ctx + with-ctx) and locked by a deterministic regeneration
|
|
146
|
+
proof.
|
|
147
|
+
|
|
148
|
+
| Vector set | Id | Source | What it proves |
|
|
149
|
+
|---|---|---|---|
|
|
150
|
+
| LAMPS composite (Ed25519) | empty-ctx + with-ctx | `src/crypto/pkc/__fixtures__/composite-mldsa65-ed25519.js` (test fixture — repository only, not shipped) — draft rev **-19** (`6df63fdc`) | ML-DSA sig, Ed25519 sig and composite PK all byte-exact official material through `verify()` |
|
|
151
|
+
| LAMPS composite (ECDSA-P256) | empty-ctx + with-ctx | `src/crypto/pkc/__fixtures__/composite-mldsa65-ecdsaP256.js` (test fixture — repository only, not shipped) — draft rev **-19** (`6df63fdc`) | DER-framed ECDSA composite verifies byte-exact; negative (strip/swap/tamper) rejects |
|
|
152
|
+
| Combiner reproducibility self-KAT | `mldsa65_ed25519`, `mldsa65_ecdsaP256` | `src/crypto/pkc/__fixtures__/composite-kat-regen.js` (test fixture — repository only, not shipped) — generated by the frozen impl | Frozen keygen + deterministic sign reproduce the committed `pk`/`sig` byte-for-byte (drift lock) |
|
|
153
|
+
|
|
154
|
+
- **Regeneration proof** — `bun packages/front/fw/tools/hybrid-kat-regen.js`
|
|
155
|
+
re-derives each composite `pk` + `sig` from a fixed per-variant SHAKE-256 DRBG
|
|
156
|
+
seed through the frozen construction, asserts byte-identity and re-verifies
|
|
157
|
+
each signature (exit 0/1). Wired as a test in
|
|
158
|
+
[`hybrid-kat-regen.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/pkc/hybrid-kat-regen.test.js).
|
|
159
|
+
- **Provenance** — per-file source / revision / SHA-256 in
|
|
160
|
+
[`hybrid-kat.provenance.md`](../../../../src/crypto/pkc/hybrid-kat.provenance.md).
|
|
161
|
+
|
|
162
|
+
### Coverage gaps
|
|
163
|
+
|
|
164
|
+
- **Covered**: both variants' official empty-ctx + with-ctx signatures
|
|
165
|
+
(byte-exact); negative cases (wrong message, ctx-binding mismatch, tampered
|
|
166
|
+
ML-DSA byte, tampered/stripped/swapped trad component, TLV splice-reject,
|
|
167
|
+
malformed DER); the SHA-512 byte-domain KAT; deterministic self-KAT
|
|
168
|
+
reproduction of both variants.
|
|
169
|
+
- **Not covered**: there is **no ACVP / CAVP program for the composite
|
|
170
|
+
constructions** — no certified test harness exists, so the LAMPS interop
|
|
171
|
+
vectors are the authoritative oracle. The underlying **ML-DSA-65** is ACVP-green
|
|
172
|
+
([`ml_dsa.acvp.md`](../../../../src/crypto/pkc/ml_dsa.acvp.md)), **Ed25519** / **ECDSA-P256** carry their
|
|
173
|
+
own RFC/FIPS vector greens — those are **cited, not re-run** here. Side-channel
|
|
174
|
+
/ constant-time resistance is explicitly out of scope (§6).
|
|
175
|
+
|
|
176
|
+
## Notes
|
|
177
|
+
|
|
178
|
+
- Verify is a strict AND (`okMl === true && okTrad === true`); a stripped,
|
|
179
|
+
swapped, or tampered component is rejected — the anti-downgrade property.
|
|
180
|
+
- `keygen()` draws **independent** per-component seeds (ML-DSA and `ecc` self-seed
|
|
181
|
+
via `random`; the Ed25519 32-byte seed comes from `random.bytes`). No component
|
|
182
|
+
key is reused across schemes.
|
|
183
|
+
- Message bytes are hashed through the bitArray domain before `sha512.hash()`
|
|
184
|
+
(SJCL big-endian packing). A raw-byte digest silently passes a round-trip but
|
|
185
|
+
fails the official vectors — only the vectors are evidence of correctness.
|
|
186
|
+
|
|
187
|
+
## See also
|
|
188
|
+
|
|
189
|
+
- [ml_dsa](./ml_dsa.md) — ML-DSA-65 post-quantum component.
|
|
190
|
+
- [ed25519](./ed25519.md) — Ed25519 classical component.
|
|
191
|
+
- [ecc](./ecc.md) — ECDSA-P-256 classical component.
|
|
192
|
+
- [hybridKem](./hybridKem.md) — companion hybrid KEM (X-Wing).
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: ml_dsa
|
|
3
|
+
category: crypto/pkc
|
|
4
|
+
dependencies: [sha3, bitArray, random, sha256, sha384, sha512, sha512_224, sha512_256]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# ml_dsa
|
|
11
|
+
|
|
12
|
+
> ML-DSA (FIPS 204, August 2024) — CRYSTALS-Dilithium post-quantum signatures + HashML-DSA + internal interface.
|
|
13
|
+
|
|
14
|
+
**Module** `ml_dsa` | **Source** `packages/front/fw/src/crypto/pkc/ml_dsa.js` | **Deps** `sha3`, `bitArray`, `random`, `sha256`, `sha384`, `sha512`, `sha512_224`, `sha512_256` | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
NIST post-quantum signatures. 3 paramSets. Variants: pure (default), preHash (HashML-DSA, FIPS 204 §5.4), internal (raw §6.2), externalMu (pre-computed mu).
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const ml_dsa = runtime.resolve('ml_dsa');
|
|
22
|
+
// Returns: { ml_dsa44, ml_dsa65, ml_dsa87, _internal }
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## API
|
|
26
|
+
|
|
27
|
+
| ParamSet | Security | publicKey | secretKey | signature |
|
|
28
|
+
|----------|----------|-----------|-----------|-----------|
|
|
29
|
+
| `ml_dsa44` | NIST PQC Level 2 | 1312 B | 2560 B | 2420 B |
|
|
30
|
+
| `ml_dsa65` | NIST PQC Level 3 | 1952 B | 4032 B | 3309 B |
|
|
31
|
+
| `ml_dsa87` | NIST PQC Level 5 | 2592 B | 4896 B | 4627 B |
|
|
32
|
+
|
|
33
|
+
| Method | Signature | Returns |
|
|
34
|
+
|--------|-----------|---------|
|
|
35
|
+
| `ml_dsa<N>.keygen(seed?)` | `(Uint8Array(32)?) => {publicKey, secretKey}` | Keypair |
|
|
36
|
+
| `ml_dsa<N>.sign(msg, sk, ctx?, rnd?)` | `(Uint8Array, Uint8Array, Uint8Array?, Uint8Array(32)?) => Uint8Array` | Sign external+pure |
|
|
37
|
+
| `ml_dsa<N>.verify(sig, msg, pk, ctx?)` | — | `boolean` |
|
|
38
|
+
| `ml_dsa<N>.signPh(msg, sk, hashAlg, hashMod, ctx?, rnd?)` | — | HashML-DSA (preHash + OID) |
|
|
39
|
+
| `ml_dsa<N>.verifyPh(sig, msg, pk, hashAlg, hashMod, ctx?)` | — | `boolean` |
|
|
40
|
+
| `_internal.signInternal(M, sk, rnd?)` | — | Raw §6.2 (no M' wrapper) |
|
|
41
|
+
| `_internal.verifyInternal(sig, M, pk)` | — | `boolean` raw |
|
|
42
|
+
| `_internal.signWithMu(mu, sk, rnd?)` | — | externalMu (pre-computed mu) |
|
|
43
|
+
| `_internal.verifyWithMu(sig, mu, pk)` | — | `boolean` |
|
|
44
|
+
|
|
45
|
+
### Supported `hashAlg` values (HashML-DSA)
|
|
46
|
+
|
|
47
|
+
12 OIDs: SHA2-{224,256,384,512,512/224,512/256}, SHA3-{224,256,384,512}, SHAKE-128, SHAKE-256.
|
|
48
|
+
|
|
49
|
+
## Examples
|
|
50
|
+
|
|
51
|
+
### Sign + verify (pure, default)
|
|
52
|
+
|
|
53
|
+
```js
|
|
54
|
+
const { ml_dsa } = fw.runtime.resolveAll(['ml_dsa']);
|
|
55
|
+
const { publicKey, secretKey } = ml_dsa.ml_dsa65.keygen();
|
|
56
|
+
|
|
57
|
+
const msg = new TextEncoder().encode('Hello, ML-DSA!');
|
|
58
|
+
const sig = ml_dsa.ml_dsa65.sign(msg, secretKey); // deterministic per default
|
|
59
|
+
const ok = ml_dsa.ml_dsa65.verify(sig, msg, publicKey); // true
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### HashML-DSA (preHash variant)
|
|
63
|
+
|
|
64
|
+
```js
|
|
65
|
+
const sha256 = fw.runtime.resolve('sha256');
|
|
66
|
+
const sig = ml_dsa.ml_dsa65.signPh(msg, secretKey, 'SHA2-256', sha256, ctx);
|
|
67
|
+
const ok = ml_dsa.ml_dsa65.verifyPh(sig, msg, publicKey, 'SHA2-256', sha256, ctx);
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
### Internal interface (raw §6.2)
|
|
71
|
+
|
|
72
|
+
```js
|
|
73
|
+
const sig = ml_dsa.ml_dsa65._internal.signInternal(M, secretKey); // no M' wrapper
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## Worker Usage
|
|
77
|
+
|
|
78
|
+
```js
|
|
79
|
+
// ml_dsa65 sign ≈ 30-100ms ; verify ≈ 5-15ms — delegate sign to a Worker
|
|
80
|
+
const worker = fw.createWorker(
|
|
81
|
+
function ({ libs, args }) {
|
|
82
|
+
self.postMessage(libs.ml_dsa.ml_dsa65.sign(args[0], args[1]));
|
|
83
|
+
},
|
|
84
|
+
{ dependencies: ['ml_dsa'], args: [msg, secretKey] }
|
|
85
|
+
);
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
## Notes
|
|
89
|
+
|
|
90
|
+
- **Deterministic by default**: `rnd=null` → byte-exact reproducible signature.
|
|
91
|
+
- **HashML-DSA OID**: DER prefix embedded in the M' wrapper (FIPS 204 Algorithm 4).
|
|
92
|
+
- **`_internal.*`** test-only — bypasses §5.4 wrappers; do NOT expose to end users (risk of secret sk leakage).
|
|
93
|
+
- **Full ACVP** under `CRYPTO_FULL=1`: 75 keyGen + 45 sigVer + 90 sigGen ext+pure.
|
|
94
|
+
|
|
95
|
+
## See also
|
|
96
|
+
|
|
97
|
+
- [ml_kem](./ml_kem.md), [slh_dsa](./slh_dsa.md) — other PQC modules
|
|
98
|
+
- [sha3](../hash/sha3.md) — mandatory primitive (SHAKE)
|
|
99
|
+
- [Conformance ml_dsa.acvp.md](../../../../src/crypto/pkc/ml_dsa.acvp.md)
|