@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,33 @@
|
|
|
1
|
+
# API Reference
|
|
2
|
+
|
|
3
|
+
Complete reference for all framework modules and APIs.
|
|
4
|
+
|
|
5
|
+
| Section | Modules |
|
|
6
|
+
|---------|---------|
|
|
7
|
+
| [Entry points](./core/main.md) | `main` (the `@awacloud/fw` default + named exports — [main](./core/main.md)), [typed](./typed.md) (`@awacloud/fw/typed`: `asTyped`, `createRuntime`) |
|
|
8
|
+
| [Core](./core/README.md) | `runtime`, `logger`, `readyState` (domReady), `worker-helper` (createWorker), `modules` |
|
|
9
|
+
| [IO / Binary](./io/binary/README.md) | `binaryReader`, `binaryWriter` |
|
|
10
|
+
| [IO / Codec](./io/codec/README.md) | `hex`, `b64`, `base32`, `base58`, `utf8`, `buffer`, `cbor`, `msgpack`, `csv`, `url`, `mime`, `xml` |
|
|
11
|
+
| [IO / Compress](./io/compress/README.md) | `lz4`, `lzw`, `bitstream`, `huffman`, `lz77`, `deflate`, `gzip`, `zlib`, `zip`, `brotli`, `brotliShared`, `brotliFrame`, `brotliDict`, `brotliDictWords` |
|
|
12
|
+
| [IO / Calc](./io/calc/README.md) | `crc32`, `adler32`, `easing`, `bigint` |
|
|
13
|
+
| [IO / Utils](./io/utils/README.md) | `eventBus`, `queue`, `bitmap`, `ui8`, `frame`, `valid` |
|
|
14
|
+
| [IO / Timing](./io/timing/README.md) | `rateLimit`, `scheduler` |
|
|
15
|
+
| [IO / Sync](./io/sync/README.md) | `abort`, `mutex`, `semaphore`, `channel`, `atomics`, `cancellable`, `tokenBucket` |
|
|
16
|
+
| [IO / Structures](./io/structures/README.md) | `lruCache`, `heap`, `ringBuffer`, `trie`, `btree`, `treeWalker` |
|
|
17
|
+
| [IO / Time](./io/time/README.md) | `date` |
|
|
18
|
+
| [IO / i18n](./io/i18n/README.md) | `i18n` |
|
|
19
|
+
| [IO / Text](./io/text/README.md) | `ansi`, `semver`, `str`, `unicode`, `htmlEntities` |
|
|
20
|
+
| [IO / Math](./io/math/README.md) | `linalg`, `stats`, `geom`, `interp`, `fixedPoint` |
|
|
21
|
+
| [Crypto](./crypto/README.md) | **73 modules**: `aes`, `chacha20`, hashes (SHA-2/3, BLAKE2b, Poly1305, Argon2), modes (CBC/CTR/GCM/CMAC/KW + ChaCha20-Poly1305), PKC (RSA, ECC, Ed25519, X25519, ML-KEM, ML-DSA, SLH-DSA, hybridKem X-Wing, hybridSign composite), utils (random DRBG, rsaKeygen, bn, bitArray, pad, pem, asn1, asn1Oid, keyformat, jws, aes_modes, aes_ctr, uuid, totp), [WebCrypto](./crypto/webcrypto/README.md) (10 opt-in async `crypto.subtle` wrappers: digest, hmac, pbkdf2, hkdf, aes, aeskw, rsa, ecc, ed25519, x25519), [WASM](./crypto/wasm/README.md) (18 opt-in async WASM-SIMD accelerators over `@awacloud/fw-wasm-crypto`: runtime + argon2, ml_kem, ml_dsa, slh_dsa, sha3, blake2b, chacha20poly1305, cmac + Tier-2 sha2, hmac, pbkdf2, hkdf, aes, rsa, ecc, ed25519, x25519) |
|
|
22
|
+
| [Process](./process/README.md) | `processMessage`, `processRPC`, `workerPool` |
|
|
23
|
+
| [DOM / Rendering](./dom/rendering/README.md) | `parser`, `render`, `sanitize`, `template`, `themeTokens`, `uiSession`, `virtualScroll`, `chart` |
|
|
24
|
+
| [DOM / Query](./dom/query/README.md) | `dnd`, `dom`, `events`, `gesture`, `media` |
|
|
25
|
+
| [DOM / Display](./dom/display/README.md) | `animate`, `fullscreen` |
|
|
26
|
+
| [DOM / FS](./dom/fs/README.md) | `indexedDB`, `storage`, `download`, `fsAccess`, `remoteStore` |
|
|
27
|
+
| [DOM / Net](./dom/net/README.md) | `ajax`, `ws`, `sse`, `webrtc`, `broadcastChannel`, `network` |
|
|
28
|
+
| [DOM / Utils](./dom/utils/README.md) | `entropyCollector`, `clipboard`, `ua`, `permissions`, `notifications`, `focus`, `keybindings`, `leaderElection`, `webauthn` |
|
|
29
|
+
| [DOM / Sensors](./dom/sensors/README.md) | `geolocation`, `battery`, `networkInfo`, `sensors` |
|
|
30
|
+
| [DOM / Lifecycle](./dom/lifecycle/README.md) | `visibility`, `idle`, `wakeLock` |
|
|
31
|
+
| [DOM / SW](./dom/sw/README.md) | `backgroundSync`, `cache`, `push`, `serviceWorker`, `sharedWorker` |
|
|
32
|
+
| [Sanity](./sanity/base.md) | Security lockdown — [base](./sanity/base.md) (ESM, explicit call `applyBase()`, DOM/XSS denylist), [community](./sanity/community.md) (ESM, explicit call `applyCommunity()`, framework-friendly denylist), [lockdown](./sanity/lockdown.md) (ESM, explicit call `lockdown()`, SES-grade integrity + WebAssembly capability seam) · [lockdown.apply](./sanity/lockdown.md) (`@awacloud/fw/sanity/lockdown.apply` — self-applying wrapper, **documented by reference** inside the lockdown page; no separate page by design) · default tier: `lockdown()` (see [guide/security.md](../guide/security.md) § Recommended default) |
|
|
33
|
+
| Integrations | **Mirror boundary — declared.** The 11 `integrations/*` export keys (`./vite`, `./esbuild`, `./rollup`, `./bun`, `./webpack`, `./astro`, `./vitest/shim`, `./jest/shim`, `./next`, `./turbopack`, `./nest`) are bundler/test-runner adapters documented by their own `integrations/<name>/README.md` and by [Integration guide](../guide/integration-bundlers.md); they are not mirrored under `docs/api/` |
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# Core — Framework infrastructure
|
|
2
|
+
|
|
3
|
+
Infrastructure modules not resolvable via `runtime` — they constitute the framework itself.
|
|
4
|
+
|
|
5
|
+
| Component | Export from `fw` | Description |
|
|
6
|
+
|-----------|----------------|-------------|
|
|
7
|
+
| [main](./main.md) | `fw` (default export) | Entry point — instantiates `runtime`, `log`, `createWorker`, `domReady` and exports `ENV` |
|
|
8
|
+
| [ModuleRuntime](./runtime.md) | `fw.runtime` | Module registry + resolution + serialisation |
|
|
9
|
+
| [logger](./logger.md) | `fw.log` | In-memory circular buffer, `console` proxy |
|
|
10
|
+
| [readyState](./readyState.md) | `fw.domReady` | DOM interactive / complete callbacks |
|
|
11
|
+
| [worker-helper](./worker-helper.md) | `fw.createWorker` | Framework-aware Web Worker spawn |
|
|
12
|
+
| [modules](./modules.md) | — | Aggregated entry point — `default export [...]` listing all ~175 fw modules, to pass to `runtime.registerAll(...)` |
|
|
13
|
+
|
|
14
|
+
These components are instantiated in `src/main.js` and exported via the default object.
|
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: logger
|
|
3
|
+
category: core
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: partial
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# logger
|
|
11
|
+
|
|
12
|
+
> Circular in-memory buffer + `console` proxy. Two variants: main thread and worker.
|
|
13
|
+
|
|
14
|
+
**Module** `logger` | **Source** `packages/front/fw/src/core/logger.js` | **Deps** none | **Worker-safe** partial (main: no, worker: yes via `logger.worker`)
|
|
15
|
+
|
|
16
|
+
`fw.log` is the main-thread instance, created automatically in `main.js` if `ENV.LOG = true`. This component is not resolved via `runtime.resolve()` — it is instantiated directly by the framework bootstrap.
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
// Not resolved via runtime — direct access from the fw object:
|
|
22
|
+
import fw from './fw/main.js';
|
|
23
|
+
const log = fw.log;
|
|
24
|
+
// Returns: { get, setLen, clear, __push, subscribe }
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## API
|
|
28
|
+
|
|
29
|
+
### `logger.main(dev)` — main thread variant
|
|
30
|
+
|
|
31
|
+
Creates the main-thread logger and replaces `window.console` with a non-modifiable Proxy.
|
|
32
|
+
|
|
33
|
+
| Param | Type | Description |
|
|
34
|
+
|-------|------|-------------|
|
|
35
|
+
| `dev` | `boolean` | If `true`, also forwards to the native `console` |
|
|
36
|
+
|
|
37
|
+
Returns: `{ get, setLen, clear, __push, subscribe }`
|
|
38
|
+
|
|
39
|
+
### `logger.worker(dev, port)` — worker variant
|
|
40
|
+
|
|
41
|
+
Creates the worker-side logger. Proxies `self.console`, forwards entries via `port.postMessage`. Used internally by `worker-helper.js`. Worker logs appear in `fw.log.get()` on the main thread.
|
|
42
|
+
|
|
43
|
+
| Param | Type | Description |
|
|
44
|
+
|-------|------|-------------|
|
|
45
|
+
| `dev` | `boolean` | If `true`, also forwards to the native worker `console` |
|
|
46
|
+
| `port` | `MessagePort` | Channel to the main thread |
|
|
47
|
+
|
|
48
|
+
Returns: `{ get, setLen, clear, subscribe }`
|
|
49
|
+
|
|
50
|
+
### Common methods
|
|
51
|
+
|
|
52
|
+
| Method | Signature | Returns |
|
|
53
|
+
|---------|-----------|---------|
|
|
54
|
+
| `get()` | `() => LogEntry[]` | Snapshot of the current buffer |
|
|
55
|
+
| `setLen(n)` | `(n: number) => void` | Max buffer size (1–65536, default 1024) |
|
|
56
|
+
| `clear()` | `() => void` | Empties the buffer |
|
|
57
|
+
| `subscribe(fn)` | `(fn: (LogEntry) => void) => () => void` | Registers a single listener; returns `unsubscribe` |
|
|
58
|
+
| `__push(entry)` *(main only)* | `(LogEntry) => void` | Internal use — receives worker logs |
|
|
59
|
+
|
|
60
|
+
### `log.subscribe(fn)`
|
|
61
|
+
|
|
62
|
+
Registers a listener called synchronously after each push.
|
|
63
|
+
|
|
64
|
+
- **Single slot**: if a listener is already active, `subscribe(fn2)` throws `'logger: subscriber already registered'`. Call `unsubscribe()` first.
|
|
65
|
+
- **No replay**: previous entries are not replayed. Combine with `get()` to bootstrap a store.
|
|
66
|
+
- **Silenced errors**: if the listener throws an exception, it is caught silently.
|
|
67
|
+
- **`__push` also notifies** (main only): any addition via `__push` (receiving worker logs) triggers the listener.
|
|
68
|
+
|
|
69
|
+
Returns `unsubscribe: () => void` — idempotent.
|
|
70
|
+
|
|
71
|
+
## Examples
|
|
72
|
+
|
|
73
|
+
### Read and clear the buffer
|
|
74
|
+
|
|
75
|
+
```js
|
|
76
|
+
import fw from './fw/main.js';
|
|
77
|
+
const { log } = fw;
|
|
78
|
+
|
|
79
|
+
const entries = log.get();
|
|
80
|
+
entries.forEach(e => console.log(e.ts, e.lvl, e.data));
|
|
81
|
+
|
|
82
|
+
log.setLen(4096); // max 65536
|
|
83
|
+
log.clear();
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
### Persist each entry to IndexedDB
|
|
87
|
+
|
|
88
|
+
```js
|
|
89
|
+
import fw from './fw/main.js';
|
|
90
|
+
const { log } = fw;
|
|
91
|
+
|
|
92
|
+
// Bootstrap: persist entries already present
|
|
93
|
+
log.get().forEach(entry => idb.put('logs', entry));
|
|
94
|
+
|
|
95
|
+
// Subscribe for future entries
|
|
96
|
+
const unsubscribe = log.subscribe(function (entry) {
|
|
97
|
+
idb.put('logs', entry).catch(function (_) {
|
|
98
|
+
// do not re-log here to avoid a loop
|
|
99
|
+
});
|
|
100
|
+
});
|
|
101
|
+
|
|
102
|
+
// Later
|
|
103
|
+
// unsubscribe();
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
## Worker Usage
|
|
107
|
+
|
|
108
|
+
`logger.worker` is injected automatically into each worker by `worker-helper.js` when `ENV.LOG = true`. Worker logs appear in `fw.log.get()` on the main thread via `log.__push`.
|
|
109
|
+
|
|
110
|
+
```js
|
|
111
|
+
const worker = fw.createWorker(
|
|
112
|
+
function({ libs }) {
|
|
113
|
+
// console.log/warn/error inside the worker are intercepted
|
|
114
|
+
// and forwarded to the main thread automatically
|
|
115
|
+
console.log('from the worker', libs.hex.fromBytes(new Uint8Array([255])));
|
|
116
|
+
},
|
|
117
|
+
{ dependencies: ['hex'] }
|
|
118
|
+
);
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
## Typedef: LogEntry
|
|
122
|
+
|
|
123
|
+
```js
|
|
124
|
+
{
|
|
125
|
+
ts: number, // timestamp Date.now()
|
|
126
|
+
lvl: string, // 'log' | 'info' | 'warn' | 'error' | ...
|
|
127
|
+
data: any[], // logged arguments (serialised on the worker side)
|
|
128
|
+
stack: string // stack trace (formatted as an array of lines)
|
|
129
|
+
}
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
## Notes
|
|
133
|
+
|
|
134
|
+
- `window.console` is replaced by a non-modifiable Proxy (`configurable: false, writable: false`).
|
|
135
|
+
- **Node / worker-shaped realm fallback**: `logger.main(dev)` resolves the
|
|
136
|
+
console holder environment-aware — when `typeof window === 'undefined'` (bare
|
|
137
|
+
Node, or a worker-shaped global with no `window`), it operates on
|
|
138
|
+
`globalThis.console` and **skips the Proxy install entirely**. Node's console
|
|
139
|
+
is non-configurable territory and is never seized; logging works as a plain
|
|
140
|
+
passthrough and `@awacloud/fw`'s entry point (`main.js`, which unconditionally
|
|
141
|
+
calls `logger.main(ENV.DEV)` at import time) can be imported under bare Node
|
|
142
|
+
without throwing. The browser path (`window` defined) is unchanged — same
|
|
143
|
+
non-writable, non-configurable Proxy install as before.
|
|
144
|
+
- Worker logs are serialised (Error, Map, Set, Function, circular → JSON-safe representation via `JSON.stringify` with a custom replacer).
|
|
145
|
+
- `Date.now` in the logger is affected by the granularity imposed by `sanity/base.js` (rounded to 100 ms).
|
|
146
|
+
- `logger.worker` is stringified via `.toString()` before injection into the Worker — the function must remain self-contained (no closure over external variables).
|
|
147
|
+
|
|
148
|
+
## See also
|
|
149
|
+
|
|
150
|
+
- [worker-helper](./worker-helper.md) — automatic logger injection into workers
|
|
151
|
+
- [sanity/base](../sanity/base.md) — impact on `Date.now` temporal resolution
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: main
|
|
3
|
+
category: core
|
|
4
|
+
dependencies: [runtime, logger, readyState, worker-helper]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: false
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# main — the framework entry point
|
|
11
|
+
|
|
12
|
+
> The `@awacloud/fw` package root: instantiates the runtime and its
|
|
13
|
+
> companion singletons and exports them.
|
|
14
|
+
|
|
15
|
+
**Module** `main` | **Source** `packages/front/fw/src/main.js` | **Deps** `runtime`, `logger`, `readyState`, `worker-helper` | **Worker-safe** no (instantiates `createWorker`/`domReady` for the main realm)
|
|
16
|
+
|
|
17
|
+
## Resolve
|
|
18
|
+
|
|
19
|
+
```js
|
|
20
|
+
import fw, { ENV, log, runtime, createWorker, domReady } from '@awacloud/fw';
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Not resolved via `runtime.resolve()` — `main.js` **is** the entry point that
|
|
24
|
+
builds the runtime; there is nothing upstream of it to ask.
|
|
25
|
+
|
|
26
|
+
## Key concepts
|
|
27
|
+
|
|
28
|
+
Five exports, each backed by a distinct fw subsystem:
|
|
29
|
+
|
|
30
|
+
| Export | Type | Built from |
|
|
31
|
+
|---|---|---|
|
|
32
|
+
| `ENV` | `{ DEV: boolean, LOG: boolean }` | `LOG` fixed `true`; `DEV` flips `false → true` inside a `/* dev_only */ … /* !dev_only */` block, stripped at build time |
|
|
33
|
+
| `log` | logger instance \| `false` | `logger.main(ENV.DEV)` when `ENV.LOG` is true, else `false` |
|
|
34
|
+
| `runtime` | `ModuleRuntime` | one `new ModuleRuntime()` instance, shared by the whole realm |
|
|
35
|
+
| `createWorker` | function | `createWorkerRuntime(ENV, runtime, runtimeSource, log, logger.worker.toString())` |
|
|
36
|
+
| `domReady` | readyState instance | `readyState()` |
|
|
37
|
+
|
|
38
|
+
`ENV.DEV` is `false` in a production build (the `dev_only` block removed) and
|
|
39
|
+
`true` in dev, gating `logger.main`'s verbosity.
|
|
40
|
+
|
|
41
|
+
## Registration patterns
|
|
42
|
+
|
|
43
|
+
`main.js` no longer registers any module itself — the app wires its own
|
|
44
|
+
module set. Two idioms, both documented as comment blocks at the foot of
|
|
45
|
+
`src/main.js`:
|
|
46
|
+
|
|
47
|
+
**Inline registration** — hand-pick modules and chain `.register()`:
|
|
48
|
+
|
|
49
|
+
```js
|
|
50
|
+
import { hex } from './io/codec/hex.js';
|
|
51
|
+
import { uid } from './io/utils/uid.js';
|
|
52
|
+
const runtime = new ModuleRuntime()
|
|
53
|
+
.register(hex)
|
|
54
|
+
.register(uid);
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
**Import registration** — register the full catalogue via the generated
|
|
58
|
+
array:
|
|
59
|
+
|
|
60
|
+
```js
|
|
61
|
+
import modules from './core/modules.js';
|
|
62
|
+
fw.runtime.registerAll(modules);
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
## API
|
|
66
|
+
|
|
67
|
+
`main.js` exports five bindings (both named and as the default object); it
|
|
68
|
+
declares no methods of its own — all behavior lives in the modules listed
|
|
69
|
+
above.
|
|
70
|
+
|
|
71
|
+
| Export | Signature | Returns |
|
|
72
|
+
|---|---|---|
|
|
73
|
+
| `ENV` | `{ DEV: boolean, LOG: boolean }` | build/runtime flags |
|
|
74
|
+
| `log` | logger instance \| `false` | in-memory circular log buffer, or `false` when disabled |
|
|
75
|
+
| `runtime` | `ModuleRuntime` | the shared DI registry/resolver |
|
|
76
|
+
| `createWorker` | `(...) => Worker` | framework-aware Web Worker spawn |
|
|
77
|
+
| `domReady` | `{ interactive(cb), complete(cb) }`-shaped | DOM lifecycle callbacks |
|
|
78
|
+
|
|
79
|
+
## Examples
|
|
80
|
+
|
|
81
|
+
```js
|
|
82
|
+
import fw, { runtime } from '@awacloud/fw';
|
|
83
|
+
import modules from '@awacloud/fw/core/modules';
|
|
84
|
+
|
|
85
|
+
runtime.registerAll(modules);
|
|
86
|
+
const hex = runtime.resolve('hex');
|
|
87
|
+
fw.domReady.complete(() => console.log('DOM ready'));
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## Notes
|
|
91
|
+
|
|
92
|
+
- `main.js` performs work at import time (constructs `runtime`, `createWorker`,
|
|
93
|
+
`domReady`) — by design, since it **is** the entry point; this is why
|
|
94
|
+
`worker-safe` is `false` rather than `partial`: importing it from a Worker
|
|
95
|
+
script pulls in main-realm-only construction.
|
|
96
|
+
- `createWorker` and `domReady` are convenience singletons built once; a
|
|
97
|
+
caller needing a second isolated `ModuleRuntime` instantiates
|
|
98
|
+
`ModuleRuntime` directly instead of importing `main.js` again.
|
|
99
|
+
|
|
100
|
+
## See also
|
|
101
|
+
|
|
102
|
+
- [runtime](./runtime.md) — the `ModuleRuntime` class `main.js` instantiates
|
|
103
|
+
- [modules](./modules.md) — the generated module catalogue for `registerAll`
|
|
104
|
+
- [typed](../typed.md) — typed-runtime facade (`@awacloud/fw/typed`)
|
|
105
|
+
- [Getting started](../../guide/getting-started.md)
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: modules
|
|
3
|
+
category: core
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# modules
|
|
11
|
+
|
|
12
|
+
> Aggregated catalogue exported as `default` — flat array of all ~175 fw module descriptors, to pass to `runtime.registerAll(...)`.
|
|
13
|
+
|
|
14
|
+
**Module** `modules` | **Source** `packages/front/fw/src/core/modules.js` | **Deps** none | **Worker-safe** yes (individual descriptors remain worker-safe according to their own status)
|
|
15
|
+
|
|
16
|
+
`src/core/modules.js` is not a module in the runtime sense (no `name`, `factory`, `dependencies`) — it is not resolved via `runtime.resolve()`. Its role is to import each framework module and export the flat array (`export default [...]`) to facilitate batch registration via `runtime.registerAll(...)` (or `runtime.registerAllDeep(...)`).
|
|
17
|
+
|
|
18
|
+
> **Recent change** — this file no longer exposes **named exports**. `import { sanitize } from '@awacloud/fw/core/modules.js'` is broken. For an isolated module, use the direct subpath: e.g. `import { sanitize } from '@awacloud/fw/dom/rendering/sanitize.js'`.
|
|
19
|
+
|
|
20
|
+
## Resolve
|
|
21
|
+
|
|
22
|
+
```js
|
|
23
|
+
// This file is not a runtime module — import its default:
|
|
24
|
+
import modules from '@awacloud/fw/core/modules.js';
|
|
25
|
+
|
|
26
|
+
import fw from '@awacloud/fw';
|
|
27
|
+
fw.runtime.registerAll(modules);
|
|
28
|
+
// (or fw.runtime.registerAllDeep(modules) if you want to traverse the `deps` field)
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## API
|
|
32
|
+
|
|
33
|
+
This file provides no API of its own. Its sole export is an **array** of module descriptors, in a deterministic order.
|
|
34
|
+
|
|
35
|
+
| Export | Description |
|
|
36
|
+
|--------|-------------|
|
|
37
|
+
| `default` | `ModuleDefinition[]` — concatenation of all fw descriptors |
|
|
38
|
+
|
|
39
|
+
### Catalogue (summary by category)
|
|
40
|
+
|
|
41
|
+
| Descriptor | Category | Short description |
|
|
42
|
+
|-------------|-----------|-------------------|
|
|
43
|
+
| `processMessage` | process | Inter-worker message routing |
|
|
44
|
+
| `processRPC` | process | Promise-based RPC over MessageChannel |
|
|
45
|
+
| `workerPool` | process | Homogeneous worker pool |
|
|
46
|
+
| `clock`, `rateLimit`, `scheduler` | io/timing | Timers, rate limiting, scheduling |
|
|
47
|
+
| `sse`, `webrtc`, `broadcastChannel`, `network` | dom/net | Real-time networking |
|
|
48
|
+
| `backgroundSync`, `cache`, `push`, `serviceWorker`, `sharedWorker` | dom/sw | Service Workers |
|
|
49
|
+
| `date` | io/time | Date manipulation |
|
|
50
|
+
| `i18n` | io/i18n | Internationalisation |
|
|
51
|
+
| `ansi`, `htmlEntities`, `semver`, `str`, `unicode` | io/text | Text manipulation |
|
|
52
|
+
| `lruCache`, `heap`, `ringBuffer`, `trie`, `btree`, `treeWalker` | io/structures | Data structures |
|
|
53
|
+
| `abort`, `mutex`, `semaphore`, `channel`, `atomics`, `cancellable`, `tokenBucket` | io/sync | Synchronisation |
|
|
54
|
+
| `binaryReader`, `binaryWriter` | io/binary | Binary read/write |
|
|
55
|
+
| `easing`, `crc32`, `adler32`, `bigint` | io/calc | Calculations |
|
|
56
|
+
| `linalg`, `stats`, `geom`, `interp`, `fixedPoint` | io/math | Mathematics |
|
|
57
|
+
| `geolocation`, `battery`, `networkInfo`, `sensors` | dom/sensors | Sensors |
|
|
58
|
+
| `a11y`, `focus`, `form`, `keybindings`, `leaderElection`, `notifications`, `permissions`, `route`, `webauthn` | dom/utils | DOM utilities |
|
|
59
|
+
| `visibility`, `idle`, `wakeLock` | dom/lifecycle | Page lifecycle |
|
|
60
|
+
| `lz4`, `deflate`, `gzip`, `zlib`, `zip`, `brotli`, ... | io/compress | Compression (12 exports) |
|
|
61
|
+
| `b64`, `base32`, `base58`, `buffer`, `cbor`, `csv`, `hex`, `mime`, `msgpack`, `url`, `utf8`, `xml` | io/codec | Codecs |
|
|
62
|
+
| `errors`, `eventBus`, `bitmap`, `queue`, `signal`, `ui8`, `uuid`, `valid` | io/utils | Miscellaneous utilities |
|
|
63
|
+
| `chart`, `component`, `parser`, `render`, `sanitize`, `secPolicy`, `template`, `themeTokens`, `devtools`, `uiSession`, `uiSessionCore`, `uiSessionDirect`, `uiSessionList`, `virtualScroll` | dom/rendering | UI rendering |
|
|
64
|
+
| `dnd`, `dom`, `events`, `gesture`, `media` | dom/query | DOM query |
|
|
65
|
+
| `animate`, `fullscreen` | dom/display | Display |
|
|
66
|
+
| `download`, `fsAccess`, `indexedDB`, `remoteStore`, `storage` | dom/fs | Files / storage |
|
|
67
|
+
| `ajax`, `ws` | dom/net | Classic networking |
|
|
68
|
+
| `entropyCollector`, `clipboard`, `ua` | dom/utils | Browser utilities |
|
|
69
|
+
| `bitArray`, `asn1`, `asn1Oid`, `pem`, `aes_modes`, `bn`, `pad`, `random`, `aes_ctr` | crypto/utils | Cryptographic utilities |
|
|
70
|
+
| `sha256`, `sha224`, `sha512`, `sha512_224`, `sha512_256`, `sha384`, `hmac`, `pbkdf2`, `hkdf`, `sha3`, `adf`, `poly1305`, `blake2b`, `argon2` | crypto/hash | Hashing |
|
|
71
|
+
| `aes`, `chacha20` | crypto/cipher | Symmetric encryption |
|
|
72
|
+
| `ctr`, `cbc`, `gcm`, `cmac`, `kw`, `chacha20poly1305` | crypto/mode | Cipher modes |
|
|
73
|
+
| `ecc`, `x25519`, `ed25519`, `rsa`, `ml_kem`, `ml_dsa`, `slh_dsa` | crypto/pkc | Asymmetric cryptography |
|
|
74
|
+
| `jws`, `keyformat`, `totp` | crypto/utils | JWS, key formats, TOTP |
|
|
75
|
+
|
|
76
|
+
## Examples
|
|
77
|
+
|
|
78
|
+
### Register all fw modules in one line
|
|
79
|
+
|
|
80
|
+
```js
|
|
81
|
+
import modules from '@awacloud/fw/core/modules.js';
|
|
82
|
+
import fw from '@awacloud/fw';
|
|
83
|
+
|
|
84
|
+
fw.runtime.registerAll(modules);
|
|
85
|
+
// All modules are now resolvable via fw.runtime.resolve(...)
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Or starting from a bare runtime:
|
|
89
|
+
|
|
90
|
+
```js
|
|
91
|
+
import modules from '@awacloud/fw/core/modules.js';
|
|
92
|
+
import { ModuleRuntime } from '@awacloud/fw/core/runtime';
|
|
93
|
+
|
|
94
|
+
const runtime = new ModuleRuntime();
|
|
95
|
+
runtime.registerAll(modules);
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
### Selective imports for tree-shaking
|
|
99
|
+
|
|
100
|
+
The `modules.js` file references **all** descriptors: using `registerAll(modules)` prevents Rollup/esbuild from eliminating those that are never resolved. For a minimal bundle, import each module **by its subpath** and compose manually (ideally via `registerDeep` to pull its transitive dependencies via the JS import graph):
|
|
101
|
+
|
|
102
|
+
```js
|
|
103
|
+
import { ModuleRuntime } from '@awacloud/fw/core/runtime';
|
|
104
|
+
import { sanitize } from '@awacloud/fw/dom/rendering/sanitize.js';
|
|
105
|
+
|
|
106
|
+
const runtime = new ModuleRuntime();
|
|
107
|
+
runtime.registerDeep(sanitize); // pulls parser, render, secPolicy, ... via JS imports
|
|
108
|
+
const s = runtime.resolve('sanitize');
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## Notes
|
|
112
|
+
|
|
113
|
+
- The file only executes static `import` statements (no invocation side-effects), but loads **all** descriptors — tree-shaking cannot remove even one once `registerAll(modules)` is called.
|
|
114
|
+
- Modules commented with `/* dev_only */` are not included in the array in production (sources commented out by `tools/fw-bundler/src/bundle/lib/strip-dev.js`).
|
|
115
|
+
- Each descriptor retains its own `worker-safe` declaration — some (e.g. `dom`, `template`) are not usable inside a Worker.
|
|
116
|
+
- The exact number of descriptors may vary as the framework evolves — refer to the source for the exhaustive list.
|
|
117
|
+
- For an isolated import, **use the canonical subpath** (`@awacloud/fw/dom/rendering/sanitize.js`, `@awacloud/fw/io/codec/hex.js`, …) rather than reintroducing a barrel.
|
|
118
|
+
|
|
119
|
+
## See also
|
|
120
|
+
|
|
121
|
+
- [runtime](./runtime.md) — module registration and resolution
|
|
122
|
+
- [worker-helper](./worker-helper.md) — automatic module serialisation for workers
|
|
123
|
+
- [process/README](../process/README.md) — process modules
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: readyState
|
|
3
|
+
category: core
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: false
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# readyState
|
|
11
|
+
|
|
12
|
+
> DOM ready-state helper: callbacks enqueued for `interactive` (DOMContentLoaded) and `complete` (load).
|
|
13
|
+
|
|
14
|
+
**Module** `readyState` | **Source** `packages/front/fw/src/core/readyState.js` | **Deps** none | **Worker-safe** no
|
|
15
|
+
|
|
16
|
+
This component is not resolved via `runtime.resolve()` — it is instantiated directly by the framework bootstrap and exposed as `fw.domReady`. Not worker-safe: it accesses `document.readyState` and registers `readystatechange` listeners on `document`.
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
// Not resolved via runtime — direct access from the fw object:
|
|
22
|
+
import fw from './fw/main.js';
|
|
23
|
+
const domReady = fw.domReady;
|
|
24
|
+
// Returns: { loaded, complete }
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## API
|
|
28
|
+
|
|
29
|
+
| Method | Signature | Returns |
|
|
30
|
+
|---------|-----------|---------|
|
|
31
|
+
| `loaded` | `(fn: Function, argArray?: any[]) => void` | — (enqueues or executes immediately) |
|
|
32
|
+
| `complete` | `(fn: Function, argArray?: any[]) => void` | — (enqueues or executes immediately) |
|
|
33
|
+
|
|
34
|
+
### `domReady.loaded(fn, argArray?)`
|
|
35
|
+
|
|
36
|
+
Executes `fn` as soon as the DOM is interactive (`document.readyState === 'interactive'`). If the state is already reached, executes immediately (synchronously).
|
|
37
|
+
|
|
38
|
+
| Param | Type | Description |
|
|
39
|
+
|-------|------|-------------|
|
|
40
|
+
| `fn` | `Function` | Callback to execute |
|
|
41
|
+
| `argArray` | `any[]` | Arguments passed to `fn.apply({}, argArray)` (default `[]`) |
|
|
42
|
+
|
|
43
|
+
### `domReady.complete(fn, argArray?)`
|
|
44
|
+
|
|
45
|
+
Executes `fn` when all assets are loaded (`document.readyState === 'complete'`). If the state is already reached, executes immediately.
|
|
46
|
+
|
|
47
|
+
## Examples
|
|
48
|
+
|
|
49
|
+
### DOM interactive — initialise templates
|
|
50
|
+
|
|
51
|
+
```js
|
|
52
|
+
import fw from './fw/main.js';
|
|
53
|
+
|
|
54
|
+
fw.domReady.loaded(() => {
|
|
55
|
+
const tpl = fw.runtime.resolve('template');
|
|
56
|
+
tpl.init('main', { to: '#app' });
|
|
57
|
+
});
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Full page load — with arguments
|
|
61
|
+
|
|
62
|
+
```js
|
|
63
|
+
fw.domReady.complete((msg) => {
|
|
64
|
+
console.log(msg); // 'Page ready'
|
|
65
|
+
}, ['Page ready']);
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
### Combining loaded + complete
|
|
69
|
+
|
|
70
|
+
```js
|
|
71
|
+
fw.domReady.loaded(() => {
|
|
72
|
+
// DOM parsed — initialise rendering
|
|
73
|
+
fw.runtime.resolve('render').mount('#root');
|
|
74
|
+
});
|
|
75
|
+
|
|
76
|
+
fw.domReady.complete(() => {
|
|
77
|
+
// Assets loaded — start heavy resources
|
|
78
|
+
fw.runtime.resolve('indexedDB').open('appdb', 1);
|
|
79
|
+
});
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
## Notes
|
|
83
|
+
|
|
84
|
+
- **Lazy listener**: no `readystatechange` listener is registered until at least one callback has been registered. If the state is already `complete` on the first call, no listener is registered.
|
|
85
|
+
- **Idempotency**: a single `readystatechange` listener is registered, regardless of the number of registered callbacks.
|
|
86
|
+
- **`interactive` skip**: a direct `loading` → `complete` transition (cache navigation) flushes both queues in one iteration.
|
|
87
|
+
- **Execution order**: `loaded` queue flushed before `complete` queue; within a queue, registration order is preserved.
|
|
88
|
+
- **Silenced errors**: exceptions inside callbacks are caught silently (`fn.apply` wrapped in try/catch).
|
|
89
|
+
- **Not worker-safe**: depends on `document.readyState` and the `readystatechange` event, both absent in Worker contexts.
|
|
90
|
+
|
|
91
|
+
## See also
|
|
92
|
+
|
|
93
|
+
- [worker-helper](./worker-helper.md) — spawn framework-aware workers
|
|
94
|
+
- [Getting started guide](../../guide/getting-started.md)
|