@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,346 @@
|
|
|
1
|
+
---
|
|
2
|
+
category: guide
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Security — sanity tiers and honest threat model
|
|
6
|
+
|
|
7
|
+
## Sanity tier spectrum
|
|
8
|
+
|
|
9
|
+
`@awacloud/fw` ships three sanity tiers that form a strict progression. Pick the one that matches your app's deployment constraints.
|
|
10
|
+
|
|
11
|
+
| Tier | Module | Kind | Framework-friendly | What it gives you |
|
|
12
|
+
|---|---|---|---|---|
|
|
13
|
+
| `community` | `sanity/community` | ESM, explicit call | Yes | XSS denylist, reduced API surface — tolerates Next/Astro SSR and dev toolbars |
|
|
14
|
+
| `base` | `sanity/base` | ESM, explicit call | Partial | Strict XSS denylist + prototype freeze — breaks frameworks that patch prototypes; Astro disables dev toolbar |
|
|
15
|
+
| `lockdown` | `sanity/lockdown` | ESM, explicit call | No | **Integrity**: tame Function constructors, remove evaluators, transitively freeze all intrinsics (SES-grade) |
|
|
16
|
+
|
|
17
|
+
### Recommended default
|
|
18
|
+
|
|
19
|
+
New applications call `lockdown()` once at startup. In a browser realm it also
|
|
20
|
+
applies the `base` DOM/XSS denylist (step 6, `sanity/lockdown.js:383-397`), so
|
|
21
|
+
`lockdown()` is a **superset** of `applyBase()` — there is no reason to call
|
|
22
|
+
both. Choose `community` or `base` alone only when a host framework patches
|
|
23
|
+
prototypes (Next / Astro dev toolbars), which the frozen intrinsics break.
|
|
24
|
+
|
|
25
|
+
```js
|
|
26
|
+
// main.js — first statements of the app, before any application code.
|
|
27
|
+
import { lockdown } from '@awacloud/fw/sanity/lockdown';
|
|
28
|
+
lockdown();
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
**Zero-bundler caveat.** `bun run prebuild:sanity` emits `base` and `community`
|
|
32
|
+
classic artifacts only (`sanity-base-classic.min.js`,
|
|
33
|
+
`sanity-community-classic.min.js`, plus `sanity.min.js` — a byte-identical
|
|
34
|
+
alias of the base one); the tier list is `['base', 'community']` in
|
|
35
|
+
`tools/fw-bundler/src/bundle/index.js:289`, so **there is no
|
|
36
|
+
`sanity-lockdown-classic.min.js` today**. A static page therefore has two
|
|
37
|
+
options: keep `sanity.min.js` (= `base`) as the classic `<script>` lock, or get
|
|
38
|
+
the default tier from a module script with an import map —
|
|
39
|
+
|
|
40
|
+
```html
|
|
41
|
+
<script type="importmap">
|
|
42
|
+
{ "imports": { "@awacloud/fw/": "/packages/front/fw/src/" }}
|
|
43
|
+
</script>
|
|
44
|
+
<script type="module">
|
|
45
|
+
import { lockdown } from '@awacloud/fw/sanity/lockdown.js'; // .js required in an import map
|
|
46
|
+
lockdown();
|
|
47
|
+
</script>
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
For the confinement half — Workers, capability grants and withholding ambient
|
|
51
|
+
authority — see [Worker confinement](./worker-confinement.md).
|
|
52
|
+
|
|
53
|
+
### Using `community` or `base`
|
|
54
|
+
|
|
55
|
+
Both are **explicit-call ES modules**. Import and call the function:
|
|
56
|
+
|
|
57
|
+
```js
|
|
58
|
+
import { applyBase } from '@awacloud/fw/sanity/base';
|
|
59
|
+
applyBase(); // or import { applyCommunity } from '@awacloud/fw/sanity/community'; applyCommunity();
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
With a bundler plugin the invoking snippet is injected automatically:
|
|
63
|
+
|
|
64
|
+
```js
|
|
65
|
+
fw({ sanity: 'base' }) // or 'community'
|
|
66
|
+
// emits: import { applyBase } from '@awacloud/fw/sanity/base'; applyBase();
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### Zero-bundler deployment
|
|
70
|
+
|
|
71
|
+
For static HTML without a bundler, load the built classic artifact (a pre-built, self-applying form):
|
|
72
|
+
|
|
73
|
+
```html
|
|
74
|
+
<script src="packages/front/fw/dist/build/sanity-base-classic.min.js"></script>
|
|
75
|
+
<script type="module" src="src/main.js"></script>
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### Using `lockdown`
|
|
79
|
+
|
|
80
|
+
`lockdown.js` is an **explicit-call ES module**. A bare import does nothing — you must call `lockdown()`:
|
|
81
|
+
|
|
82
|
+
```js
|
|
83
|
+
import { lockdown } from '@awacloud/fw/sanity/lockdown';
|
|
84
|
+
lockdown(); // call once, before any application code
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
With a bundler plugin the invoking snippet is injected automatically:
|
|
88
|
+
|
|
89
|
+
```js
|
|
90
|
+
fw({ sanity: 'lockdown' })
|
|
91
|
+
// emits: import { lockdown } from '@awacloud/fw/sanity/lockdown'; lockdown();
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
## Integrity vs confinement
|
|
95
|
+
|
|
96
|
+
These are distinct security properties. This table is intentionally blunt.
|
|
97
|
+
|
|
98
|
+
| Property | What it means | Does `lockdown` give you this? |
|
|
99
|
+
|---|---|---|
|
|
100
|
+
| **Integrity** | Intrinsics are tamper-proof; `eval`/`Function` cannot be reconstructed; no prototype poisoning | **Yes** — this is what `lockdown()` does |
|
|
101
|
+
| **Confinement** | Untrusted code cannot read/write outside its assigned scope | **No** |
|
|
102
|
+
|
|
103
|
+
### What `lockdown` gives you (integrity)
|
|
104
|
+
|
|
105
|
+
- **Evaluator-reconstruction escape closed**: `({}).constructor.constructor('code')` and its three async/generator variants all throw.
|
|
106
|
+
- **Ambient evaluators removed**: `globalThis.eval`, `globalThis.Function`, and `WebAssembly.compile*`/`instantiate*` are replaced with throwing shims.
|
|
107
|
+
- **WebAssembly capability-guarded**: Only a holder of the fw wasm capability may compile or instantiate WebAssembly after `lockdown()`. The sole holder is `wasmRuntime`, whose only public entry point selects a build-time-vendored binary BY NAME and fetches its bytes from fw's internal URL space. Caller-supplied bytes have no route. The global `compile`/`instantiate` slots stay poisoned; `validate` and `Memory` are untouched.
|
|
108
|
+
- **Standard intrinsics transitively frozen**: every standard global (`Object`, `Array`, `Function`, `Promise`, …), its `.prototype`, and the hidden intrinsics (`%TypedArray%`, `%IteratorPrototype%`, `%GeneratorFunction%`, …) are `Object.freeze`-d depth-first. Prototype poisoning attacks (e.g. `Array.prototype.push = ...`) fail in strict mode.
|
|
109
|
+
- In a browser realm, `lockdown()` also composes the `base.js` DOM/XSS denylist (`innerHTML`→`innerText` redirect, `document.write`, dangerous element setters, …).
|
|
110
|
+
|
|
111
|
+
### What `lockdown` does NOT give you
|
|
112
|
+
|
|
113
|
+
- **No confinement**: untrusted code running in the same realm after `lockdown()` can still read and write any mutable globals and module-scope variables it can reach. This tier prevents *manipulation of the language substrate* — it does not prevent *information flow between principals*.
|
|
114
|
+
- **`globalThis` stays extensible**: only the named evaluator slots are poisoned; `globalThis` itself is not sealed or frozen. An attacker who can run code before `lockdown()` (or who has a reference to a live evaluator captured before `lockdown()`) is not stopped.
|
|
115
|
+
- **Dynamic `import()` and `<script>` are not closed by property taming**: `import()` is syntax, not a property — it cannot be poisoned by slot replacement. `<script>` injection is a network/DOM vector. Close these with a server-side **Content Security Policy** (`script-src`).
|
|
116
|
+
- **Not a SES permits allowlist**: this is a pragmatic transitive freeze over an enumerated root set, not SES's audited per-property permits allowlist (which whitelists exactly the standard properties and removes the rest). It freezes what is reachable; it does not certify the shape of each intrinsic.
|
|
117
|
+
|
|
118
|
+
## Isolation / confinement: use Workers
|
|
119
|
+
|
|
120
|
+
**Isolation of untrusted code is done by Web Workers**, not by the sanity tiers.
|
|
121
|
+
|
|
122
|
+
Workers run in a **separate realm** (their own JavaScript global) and communicate exclusively via `postMessage` / structured-clone — there is no shared mutable state between the worker and the main thread. This is the only robust confinement boundary the browser provides.
|
|
123
|
+
|
|
124
|
+
`@awacloud/fw`'s serializable-modules-run-in-workers design is the framework's confinement story:
|
|
125
|
+
|
|
126
|
+
- [Worker confinement](./worker-confinement.md) — **the guide**: capability grant via `dependencies`, withholding ambient authority in `workerFw`, applying `lockdown()` inside the worker realm, runnable examples and honest limits.
|
|
127
|
+
- [`docs/notes/worker-confinement-spike.md`](../notes/worker-confinement-spike.md) — the historical spike record (2026-06-15): realm separation, structured-clone boundary, module serialisability constraints, and integration with `workerPool`.
|
|
128
|
+
|
|
129
|
+
A typical deployment combining integrity and isolation:
|
|
130
|
+
|
|
131
|
+
```js
|
|
132
|
+
// main.js — lock down the main realm first
|
|
133
|
+
import { lockdown } from '@awacloud/fw/sanity/lockdown';
|
|
134
|
+
lockdown();
|
|
135
|
+
|
|
136
|
+
// Run untrusted/high-risk computation in a Worker (separate realm)
|
|
137
|
+
import { runtime } from '@awacloud/fw';
|
|
138
|
+
const pool = runtime.resolve('workerPool');
|
|
139
|
+
const result = await pool.run(trustedWorkerModule, untrustedInput);
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
# Security — sanity/base.js
|
|
145
|
+
|
|
146
|
+
> Security lock loaded **before** all application code. Blocks dangerous APIs, redirects unsafe DOM mutations, and freezes native prototypes.
|
|
147
|
+
|
|
148
|
+
## Loading
|
|
149
|
+
|
|
150
|
+
`sanity/base.js` is an **ES module** exporting `applyBase()`. Call it once before all application code:
|
|
151
|
+
|
|
152
|
+
```js
|
|
153
|
+
import { applyBase } from '@awacloud/fw/sanity/base';
|
|
154
|
+
applyBase(); // must be called before all application code
|
|
155
|
+
|
|
156
|
+
import { runtime } from '@awacloud/fw';
|
|
157
|
+
import modules from '@awacloud/fw/core/modules';
|
|
158
|
+
runtime.registerAll(modules);
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
For zero-bundler deployment (standalone HTML with no build step), load the built classic artifact, which self-applies on load:
|
|
162
|
+
|
|
163
|
+
```html
|
|
164
|
+
<script src="packages/front/fw/dist/build/sanity-base-classic.min.js"></script>
|
|
165
|
+
<script type="module" src="src/main.js"></script>
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
The framework (`main.js`) assumes the lock is already active.
|
|
169
|
+
|
|
170
|
+
### Production logs
|
|
171
|
+
|
|
172
|
+
By default, each attempt to access a blocked API displays a detailed `console.warn` (stack trace included) — useful in development, sometimes noisy in production (third-party libs that probe the environment). To silence the logs, build with the `--no-sanity-log` flag:
|
|
173
|
+
|
|
174
|
+
```sh
|
|
175
|
+
fw-bundler bundle all --no-sanity-log
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
The flag patches the `LOG_ATTEMPTS = false` constant in `src/sanity/base.js` at build time (the emitted `dist/build/sanity.min.js` bundle becomes silent). The protection itself remains active — only the `console.warn` messages disappear. There is no runtime toggle (no HTML attribute, no global flag); the opt-out is a build decision.
|
|
179
|
+
|
|
180
|
+
## What is blocked
|
|
181
|
+
|
|
182
|
+
### Blocked `window` APIs
|
|
183
|
+
|
|
184
|
+
These properties are replaced with no-op functions or neutral values:
|
|
185
|
+
|
|
186
|
+
| API | Behaviour after locking |
|
|
187
|
+
|-----|---------------------------------|
|
|
188
|
+
| `eval` | throw `'not allowed'` |
|
|
189
|
+
| `alert`, `confirm`, `prompt` | throw |
|
|
190
|
+
| `Function` | throw |
|
|
191
|
+
| `open`, `opener` | throw |
|
|
192
|
+
| `import()` (dynamic) | throw |
|
|
193
|
+
| `importScripts` | throw (worker contexts) |
|
|
194
|
+
| `Reflect` | throw |
|
|
195
|
+
|
|
196
|
+
### Blocked `document` APIs
|
|
197
|
+
|
|
198
|
+
| API | Behaviour |
|
|
199
|
+
|-----|--------------|
|
|
200
|
+
| `document.write` | throw |
|
|
201
|
+
| `document.writeln` | throw |
|
|
202
|
+
| `document.execCommand`, `evaluate`, `implementation`, `createContextualFragment` | throw |
|
|
203
|
+
| `document.open`, `close` | throw |
|
|
204
|
+
| `document.domain` (set) | throw |
|
|
205
|
+
|
|
206
|
+
### History and navigation
|
|
207
|
+
|
|
208
|
+
| API | Behaviour |
|
|
209
|
+
|-----|--------------|
|
|
210
|
+
| `history.pushState` | throw |
|
|
211
|
+
| `history.replaceState` | throw |
|
|
212
|
+
| `history.go` / `back` / `forward` | throw |
|
|
213
|
+
|
|
214
|
+
### Entropy and timing
|
|
215
|
+
|
|
216
|
+
| API | Behaviour |
|
|
217
|
+
|-----|--------------|
|
|
218
|
+
| `Math.random` | throw `'not allowed: use crypto.getRandomValues instead'` |
|
|
219
|
+
| `crypto.randomUUID` | throw |
|
|
220
|
+
| `performance.now` | throw |
|
|
221
|
+
| `performance.mark` / `measure` / `getEntries` | throw |
|
|
222
|
+
| `Date.now` | rounded to 100 ms (reduces timing precision) |
|
|
223
|
+
|
|
224
|
+
> **Why?** These APIs are classic vectors for client-side entropy extraction for fingerprinting. The framework provides `uuid` (worker-safe, CSPRNG) instead of `Math.random`/`crypto.randomUUID`.
|
|
225
|
+
|
|
226
|
+
## What is redirected (not blocked)
|
|
227
|
+
|
|
228
|
+
HTML mutations via string are **redirected to their text equivalent** — they do not throw but do not inject HTML:
|
|
229
|
+
|
|
230
|
+
| Dangerous API | Redirected to |
|
|
231
|
+
|----------------|---------------|
|
|
232
|
+
| `element.innerHTML = ...` | `element.innerText = ...` |
|
|
233
|
+
| `element.outerHTML = ...` | `element.innerText = ...` |
|
|
234
|
+
| `element.insertAdjacentHTML(...)` | Inserted as text |
|
|
235
|
+
|
|
236
|
+
This protects against accidental XSS injection while allowing existing code to run without errors.
|
|
237
|
+
|
|
238
|
+
## Frozen prototypes
|
|
239
|
+
|
|
240
|
+
Native type prototypes are frozen (`Object.freeze`) to prevent prototype chain modifications:
|
|
241
|
+
|
|
242
|
+
- `Object.prototype`
|
|
243
|
+
- `Array.prototype`
|
|
244
|
+
- `Function.prototype`
|
|
245
|
+
- `String.prototype`
|
|
246
|
+
- `Number.prototype`
|
|
247
|
+
- `Boolean.prototype`
|
|
248
|
+
- `Date.prototype`
|
|
249
|
+
- `RegExp.prototype`
|
|
250
|
+
- `Error.prototype`
|
|
251
|
+
|
|
252
|
+
Any attempt to modify these prototypes fails silently (in non-strict mode) or throws a `TypeError` (in strict mode).
|
|
253
|
+
|
|
254
|
+
## Development impact
|
|
255
|
+
|
|
256
|
+
### What the framework uses instead
|
|
257
|
+
|
|
258
|
+
| Blocked API | Framework alternative |
|
|
259
|
+
|-------------|----------------------|
|
|
260
|
+
| `Math.random` / `crypto.randomUUID` | `runtime.resolve('uuid')` |
|
|
261
|
+
| HTML injection (`innerHTML`) | `parser` → `render` → `template` pipeline |
|
|
262
|
+
| `eval` / `Function(...)` | No equivalent (not needed) |
|
|
263
|
+
|
|
264
|
+
### Compatibility with external libraries
|
|
265
|
+
|
|
266
|
+
Third-party libraries using blocked APIs **will not work** under `sanity/base.js`. The `packages/front/fw/external/` directory is reserved for adapters for external code, but is not enabled by default.
|
|
267
|
+
|
|
268
|
+
### Test environment
|
|
269
|
+
|
|
270
|
+
In isolated unit tests (without a full browser), `sanity/base.js` can be omitted. Integration tests should load it first.
|
|
271
|
+
|
|
272
|
+
## Threat model and **non-guarantees**
|
|
273
|
+
|
|
274
|
+
`sanity/base.js` closes **HTML/JS injection vectors via dynamic JavaScript API**. It does not replace a complete application security policy. This section explicitly lists what sanity does **not** cover — to avoid over-reliance.
|
|
275
|
+
|
|
276
|
+
### Shared security policy: `secPolicy` module
|
|
277
|
+
|
|
278
|
+
All defences above sanity (URL safety, DOM clobbering, dangerous CSS, `on*`, blocked tags) are **centralised** in the [`secPolicy`](../api/dom/rendering/secPolicy.md) module. This is the single source of truth — `template`, `render`, `parser`, `sanitize` and `dom` consume it rather than duplicating regexes and attribute Sets. Typical use case for an app developer:
|
|
279
|
+
|
|
280
|
+
```js
|
|
281
|
+
const sp = runtime.resolve('secPolicy');
|
|
282
|
+
if (!sp.isSafeUrl(userInput)) return; // reject javascript:, vbscript:, data:text, …
|
|
283
|
+
if (sp.isClobberValue('id', userInput)) return; // reject 'cookie', 'domain', …
|
|
284
|
+
if (!sp.isSafeCss(prop, val)) return; // reject expression(), url(javascript:)
|
|
285
|
+
```
|
|
286
|
+
|
|
287
|
+
The sections below list the non-guarantees **of the sanity lock alone**. Framework modules (which inject `secPolicy`) add these protections automatically; direct calls to `dom.attr` / `dom.style` / `setAttribute` bypass them.
|
|
288
|
+
|
|
289
|
+
### `javascript:` / `vbscript:` URLs in attributes
|
|
290
|
+
|
|
291
|
+
Sanity blocks **HTML mutations by string** (`innerHTML`, etc.) but cannot inspect a value passed to `setAttribute('href', 'javascript:…')`. A malicious `href` or `src` attribute created via `element.setAttribute` remains active.
|
|
292
|
+
|
|
293
|
+
**Applied mitigation**: the `template` module filters URL-bearing attributes (`href`, `src`, `action`, `formaction`, `srcset`, `xlink:href`, `data`, `codebase`) via `secPolicy.isSafeUrl` — dangerous schemes and `data:text|application` are removed. `render.toHTML` (SSR path) applies exactly the same rules.
|
|
294
|
+
|
|
295
|
+
**Limitation**: if you call `dom.attr(node, 'href', userInput)` directly (bypassing the `template` pipeline), **no filter is applied**. You must validate via `secPolicy.isSafeUrl(url)`.
|
|
296
|
+
|
|
297
|
+
### DOM clobbering
|
|
298
|
+
|
|
299
|
+
A `name` or `id` attribute that collides with a global property of `document` (`document.cookies`, `document.domain`, …) can overwrite/expose the native property:
|
|
300
|
+
|
|
301
|
+
```html
|
|
302
|
+
<input name="cookies" value="evil">
|
|
303
|
+
<!-- Becomes document.cookies = HTMLInputElement -->
|
|
304
|
+
```
|
|
305
|
+
|
|
306
|
+
**Applied mitigation**: `template` and `render.toHTML` consult `secPolicy.CLOBBER_NAMES` and reject ~30 known values on `id`/`name` attributes. `secPolicy.isClobberValue(attr, value)` is exposed for custom pipelines.
|
|
307
|
+
|
|
308
|
+
### Dangerous CSS
|
|
309
|
+
|
|
310
|
+
`dom.style(node, prop, value)` now filters via `secPolicy.isSafeCss(prop, val)`:
|
|
311
|
+
- `expression(...)` (IE-only, deprecated) → blocked
|
|
312
|
+
- `url(javascript:…)` / `url(vbscript:…)` / `url(data:text|application)` → blocked
|
|
313
|
+
- `behavior` / `-ms-behavior` properties (IE HTC) → blocked
|
|
314
|
+
|
|
315
|
+
Obfuscation by spaces / control characters is neutralised (the test is applied after collapse + lowercase). **However**, user-controlled CSS passed to `dom.style` remains risky — prefer `themeTokens` which controls the entire set of allowed values.
|
|
316
|
+
|
|
317
|
+
### Biometric side-channels
|
|
318
|
+
|
|
319
|
+
The `gesture` and `dnd` modules collect pointer coordinates and timings (`pointerdown`/`pointermove`). Although not blocked by sanity (`Date.now()` remains available), this data can contribute to a biometric fingerprint (typing rhythm, gesture curves). For sensitive apps, disable these modules unless necessary.
|
|
320
|
+
|
|
321
|
+
### User HTML content via the `sanitize` module
|
|
322
|
+
|
|
323
|
+
The standard pipeline (`parser → render → template`) **does not accept** free HTML — only templates compiled by the parser. To ingest user-controlled HTML (comments, rendered Markdown, CMS content), pass through `sanitize.sanitizeHtml(html, allowlist?)` **before** insertion. The pipeline itself has no "render raw HTML" function.
|
|
324
|
+
|
|
325
|
+
### CSP nonce
|
|
326
|
+
|
|
327
|
+
`<style>` and `<script>` tags injected by `template.style(...)` / `template.script(...)` **do not carry a `nonce`** by default. Under a strict CSP (`script-src 'self' 'nonce-XXX'`), these injections will fail. Either relax the CSP via `unsafe-inline`, or wait for a `setNonce` API propagation (see fw P2 roadmap).
|
|
328
|
+
|
|
329
|
+
### External libraries
|
|
330
|
+
|
|
331
|
+
Sanity freezes prototypes and blocks `eval`/`Function`. Most modern libraries (lodash, dayjs, etc.) work, but frameworks **that patch prototypes** (jQuery `$.fn.X`, old versions of Mootools) **will not work**. Test before integrating.
|
|
332
|
+
|
|
333
|
+
---
|
|
334
|
+
|
|
335
|
+
## See also
|
|
336
|
+
|
|
337
|
+
- [sanity/base — API reference](../api/sanity/base.md)
|
|
338
|
+
- [sanity/community — API reference](../api/sanity/community.md)
|
|
339
|
+
- [sanity/lockdown — API reference](../api/sanity/lockdown.md)
|
|
340
|
+
- [Worker confinement](./worker-confinement.md) — the confinement guide: capability grant, ambient-authority withholding, lockdown inside the worker
|
|
341
|
+
- [docs/notes/worker-confinement-spike.md](../notes/worker-confinement-spike.md) — historical spike record on Worker isolation (confinement)
|
|
342
|
+
- [secPolicy](../api/dom/rendering/secPolicy.md) — shared security policy (URL/CSS/clobber/`on*`/tags)
|
|
343
|
+
- [uuid](../api/crypto/utils/uuid.md) — secure identifier generator
|
|
344
|
+
- [parser](../api/dom/rendering/parser.md) — safe alternative to `innerHTML`
|
|
345
|
+
- [sanitize](../api/dom/rendering/sanitize.md) — user-controlled HTML allowlist
|
|
346
|
+
- [template](../api/dom/rendering/template.md) — URL filter applied automatically
|
|
@@ -0,0 +1,190 @@
|
|
|
1
|
+
# Test format
|
|
2
|
+
|
|
3
|
+
Test convention for all framework modules. Runner: **`bun test`**.
|
|
4
|
+
|
|
5
|
+
## Location
|
|
6
|
+
|
|
7
|
+
The test lives **next to** the module it validates:
|
|
8
|
+
|
|
9
|
+
```
|
|
10
|
+
src/io/codec/csv.js
|
|
11
|
+
src/io/codec/csv.test.js
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
No separate `__tests__/` or `tests/` folder — strict co-location.
|
|
15
|
+
|
|
16
|
+
## Minimum skeleton
|
|
17
|
+
|
|
18
|
+
```js
|
|
19
|
+
import { describe, test, expect, beforeEach } from 'bun:test';
|
|
20
|
+
import { myModule } from './myModule.js';
|
|
21
|
+
|
|
22
|
+
describe('myModule module', () => {
|
|
23
|
+
test('should have correct module metadata', () => {
|
|
24
|
+
expect(myModule.name).toBe('myModule');
|
|
25
|
+
expect(myModule.dependencies).toEqual([]); // or ['dep1', 'dep2']
|
|
26
|
+
expect(typeof myModule.factory).toBe('function');
|
|
27
|
+
});
|
|
28
|
+
|
|
29
|
+
describe('factory', () => {
|
|
30
|
+
test('should create instance with expected API', () => {
|
|
31
|
+
const inst = myModule.factory();
|
|
32
|
+
expect(inst).toBeDefined();
|
|
33
|
+
expect(typeof inst.method1).toBe('function');
|
|
34
|
+
// ... all public members
|
|
35
|
+
});
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
describe('method1', () => {
|
|
39
|
+
let inst;
|
|
40
|
+
beforeEach(() => { inst = myModule.factory(); });
|
|
41
|
+
|
|
42
|
+
test('happy path', () => { /* ... */ });
|
|
43
|
+
test('edge case X', () => { /* ... */ });
|
|
44
|
+
test('throws on invalid input', () => {
|
|
45
|
+
expect(() => inst.method1(null)).toThrow();
|
|
46
|
+
});
|
|
47
|
+
});
|
|
48
|
+
});
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## Mandatory sections
|
|
52
|
+
|
|
53
|
+
Every `*.test.js` file must contain **at minimum**:
|
|
54
|
+
|
|
55
|
+
| Block | Role |
|
|
56
|
+
|------|------|
|
|
57
|
+
| `describe('<name> module', ...)` | Root container |
|
|
58
|
+
| Metadata test | Verifies `name`, `dependencies`, `factory` |
|
|
59
|
+
| Factory API test | Verifies that the factory returns all expected members |
|
|
60
|
+
| `describe(<method>)` × N | One per non-trivial public method |
|
|
61
|
+
| Error tests / edge cases | `throw`, empty values, invalid types |
|
|
62
|
+
|
|
63
|
+
If the module does round-trips (codec, serialisation), add:
|
|
64
|
+
|
|
65
|
+
| Block | Role |
|
|
66
|
+
|------|------|
|
|
67
|
+
| `describe('round-trip')` | `decode(encode(x)) === x` over several typical values |
|
|
68
|
+
|
|
69
|
+
## Naming conventions
|
|
70
|
+
|
|
71
|
+
- The root `describe` is `'<name> module'` (not `'<Name>'` nor `'tests <name>'`).
|
|
72
|
+
- Sub-`describe` blocks carry the **exact name of the public method** (e.g. `'parseQuery'`, not `'parsing queries'`).
|
|
73
|
+
- `test` names start with a verb or a fact, without a redundant `should` prefix. Acceptable:
|
|
74
|
+
- `test('returns empty array on empty input', …)`
|
|
75
|
+
- `test('throws on unterminated quoted field', …)`
|
|
76
|
+
- `test('round-trip with custom delimiter', …)`
|
|
77
|
+
|
|
78
|
+
## Dependencies: manual factory wiring
|
|
79
|
+
|
|
80
|
+
Tests instantiate the factory **directly** without going through `runtime.resolve` — they control the dependencies:
|
|
81
|
+
|
|
82
|
+
```js
|
|
83
|
+
import { mime } from './mime.js';
|
|
84
|
+
import { utf8 } from './utf8.js';
|
|
85
|
+
|
|
86
|
+
// Minimal stub for external deps outside the test's scope
|
|
87
|
+
const randomStub = {
|
|
88
|
+
bytes(n) { const out = new Uint8Array(n); crypto.getRandomValues(out); return out; }
|
|
89
|
+
};
|
|
90
|
+
|
|
91
|
+
const codec = mime.factory(utf8.factory(), randomStub);
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
No auto-resolution in tests. This:
|
|
95
|
+
- Guarantees isolation (no runtime cache effect).
|
|
96
|
+
- Explicitly documents dependencies.
|
|
97
|
+
- Allows stubbing where needed.
|
|
98
|
+
|
|
99
|
+
## `beforeEach` rather than `beforeAll`
|
|
100
|
+
|
|
101
|
+
For modules with internal state (codec with buffer, queue with items in progress), use `beforeEach` to start from a fresh instance:
|
|
102
|
+
|
|
103
|
+
```js
|
|
104
|
+
let inst;
|
|
105
|
+
beforeEach(() => { inst = myModule.factory(); });
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
`beforeAll` is reserved for **immutable** expensive setups (e.g. pre-computing a large reference vector).
|
|
109
|
+
|
|
110
|
+
## Test vectors
|
|
111
|
+
|
|
112
|
+
When a standard provides official vectors (RFC, CAVP, Appendix), include them as-is:
|
|
113
|
+
|
|
114
|
+
```js
|
|
115
|
+
describe('RFC 4648 §10 test vectors', () => {
|
|
116
|
+
const vectors = [
|
|
117
|
+
['', ''],
|
|
118
|
+
['f', 'Zg=='],
|
|
119
|
+
['fo', 'Zm8='],
|
|
120
|
+
// ...
|
|
121
|
+
];
|
|
122
|
+
for (const [input, expected] of vectors) {
|
|
123
|
+
test(`encode ${JSON.stringify(input)} → ${expected}`, () => {
|
|
124
|
+
expect(codec.encode(input)).toBe(expected);
|
|
125
|
+
});
|
|
126
|
+
}
|
|
127
|
+
});
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
## What we do **not** test
|
|
131
|
+
|
|
132
|
+
- Private implementation details (internal variables, `_xxx` helpers).
|
|
133
|
+
- Behaviour of the DI runtime (covered by `runtime.test.js`).
|
|
134
|
+
- Code from dependencies (covered by their own tests).
|
|
135
|
+
|
|
136
|
+
## Running
|
|
137
|
+
|
|
138
|
+
```bash
|
|
139
|
+
# One file
|
|
140
|
+
bun test src/io/codec/csv.test.js
|
|
141
|
+
|
|
142
|
+
# A directory
|
|
143
|
+
bun test src/io/codec/
|
|
144
|
+
|
|
145
|
+
# The whole framework
|
|
146
|
+
bun test packages/front/fw/
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
Expected output:
|
|
150
|
+
|
|
151
|
+
```
|
|
152
|
+
552 pass
|
|
153
|
+
0 fail
|
|
154
|
+
1115 expect() calls
|
|
155
|
+
Ran 552 tests across 11 files. [111.00ms]
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
**No test must fail or be skipped** before a module is considered delivered.
|
|
159
|
+
|
|
160
|
+
## Special cases
|
|
161
|
+
|
|
162
|
+
### Worker-safe module tested outside a worker
|
|
163
|
+
|
|
164
|
+
Worker-safe modules can be tested directly in the bun main thread — workers are not instantiated in tests.
|
|
165
|
+
|
|
166
|
+
### DOM module (not worker-safe)
|
|
167
|
+
|
|
168
|
+
Bun exposes a minimal DOM via `happy-dom` or `jsdom`. These modules often require an explicit setup — see the existing `dom`/`events` tests for the pattern.
|
|
169
|
+
|
|
170
|
+
### Crypto / NIST CAVP vectors
|
|
171
|
+
|
|
172
|
+
Keep official vectors as commented hex strings with their reference (`COUNT=0`, archive, CSRC URL). Do not rewrite as binary literals.
|
|
173
|
+
|
|
174
|
+
## Review checklist
|
|
175
|
+
|
|
176
|
+
Before considering a test suite complete:
|
|
177
|
+
|
|
178
|
+
- [ ] Module metadata tested
|
|
179
|
+
- [ ] All public members have at least one `describe`
|
|
180
|
+
- [ ] Error cases / `throw` covered
|
|
181
|
+
- [ ] Round-trip if applicable
|
|
182
|
+
- [ ] Official vectors if a standard is implemented
|
|
183
|
+
- [ ] No `test.skip` / `test.only` left
|
|
184
|
+
- [ ] `bun test <file>` passes at 100%
|
|
185
|
+
|
|
186
|
+
## See also
|
|
187
|
+
|
|
188
|
+
- [Documentation format](./doc-format.md)
|
|
189
|
+
- [Module pattern](./module-pattern.md)
|
|
190
|
+
- [Module creation workflow](./module-creation-workflow.md)
|