@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,145 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @fileoverview High-level session facade that coordinates `parser`, `render`,
|
|
7
|
+
* `template`, and `dom` to provide a unified, stateful interface for building
|
|
8
|
+
* and updating a section of the UI.
|
|
9
|
+
*
|
|
10
|
+
* A `UISession` is created per UI scope (page, panel, component) via the
|
|
11
|
+
* factory function returned by this module. It encapsulates the attach-slot
|
|
12
|
+
* map and the logical-ID map so callers never need to manage raw element IDs
|
|
13
|
+
* directly.
|
|
14
|
+
*
|
|
15
|
+
* Implementation is split across topic-focused fw modules for readability :
|
|
16
|
+
* - `uiSessionCore` : lifecycle, lookup, mount/unmount, portals.
|
|
17
|
+
* - `uiSessionDirect` : `text` / `attr` / `on` / `bind` mutators.
|
|
18
|
+
* - `uiSessionList` : `UIList` class + `list()` factory.
|
|
19
|
+
*
|
|
20
|
+
* Each is a standalone fw module whose factory is serializable (worker-safe).
|
|
21
|
+
* This file glues them onto a single `UISession` prototype via the strict
|
|
22
|
+
* dependency-injection pattern.
|
|
23
|
+
*
|
|
24
|
+
*/
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* @typedef {Object} RenderItem
|
|
28
|
+
* @property {import('./parser').ElmNode[]} [template] - Pre-resolved elm template array.
|
|
29
|
+
* @property {import('./parser').ParseResult} [block] - Raw parse result; `template` is
|
|
30
|
+
* derived from it using the `attach.name` slot when available.
|
|
31
|
+
* @property {Object | Object[]} [data] - Variable bindings. An array
|
|
32
|
+
* triggers loop (iterate) rendering.
|
|
33
|
+
* @property {string} [id] - Logical block identifier.
|
|
34
|
+
* @property {{ elm: string, name: string }} [attach] - Attach descriptor.
|
|
35
|
+
* @property {boolean} [prepend] - Insert root before existing children.
|
|
36
|
+
*/
|
|
37
|
+
|
|
38
|
+
import { uiSessionCore } from './uiSession-core.js';
|
|
39
|
+
import { uiSessionDirect } from './uiSession-direct.js';
|
|
40
|
+
import { uiSessionList } from './uiSession-list.js';
|
|
41
|
+
|
|
42
|
+
/**
|
|
43
|
+
* Stateful session managing one named template context. Composed from the
|
|
44
|
+
* core (lifecycle/lookup/mutation), direct (text/attr/on/bind) and list
|
|
45
|
+
* mixins. Chainable mutators return the session itself.
|
|
46
|
+
*
|
|
47
|
+
* @typedef {object} UISessionInstance
|
|
48
|
+
* @property {(htmlString: string) => object} parse Shortcut for `parser.fromHTML`.
|
|
49
|
+
* @property {(blockId: string, logicalId?: string) => (Element|null)} get Resolve a block root or descendant to a live DOM node.
|
|
50
|
+
* @property {(blockId: string, logicalId: string, selector: string) => (Element|null)} query First selector match inside the addressed node.
|
|
51
|
+
* @property {(blockId: string, logicalId: string, selector: string) => (NodeList|Array)} queryAll All selector matches inside the addressed node.
|
|
52
|
+
* @property {(blockId: string) => IterableIterator<[string, Element]>} iterate Yield `[logicalId, element]` pairs for a block.
|
|
53
|
+
* @property {(blockId: string, logicalId?: string) => boolean} exists Whether a block (or descendant) is registered.
|
|
54
|
+
* @property {(items: Array, opts?: object) => UISessionInstance} hydrate Adopt SSR DOM; returns the session.
|
|
55
|
+
* @property {(items: Array) => UISessionInstance} add Render and append items; returns the session.
|
|
56
|
+
* @property {(items: Array) => UISessionInstance} append Alias for `add`; returns the session.
|
|
57
|
+
* @property {(items: Array) => UISessionInstance} prepend Render items before existing children; returns the session.
|
|
58
|
+
* @property {(blockId: string, slotName: (string|null), factory: (element: Element, blockId: string) => object) => (object|null)} mount Resolve an element, call `factory`, adopt the controller.
|
|
59
|
+
* @property {(blockId: string, resource: (Function|object)) => (Function|object)} adopt Register a cleanup resource.
|
|
60
|
+
* @property {(blockId: string, fn?: Function) => UISessionInstance} onUnmount Set/clear an unmount hook; returns the session.
|
|
61
|
+
* @property {(blockId: string, fn?: Function) => UISessionInstance} onMount Set/fire a mount hook; returns the session.
|
|
62
|
+
* @property {(name: string) => UISessionInstance} off Remove a managed listener by name; returns the session.
|
|
63
|
+
* @property {(blockId: string, logicalId?: string) => UISessionInstance} remove Remove a descendant element; returns the session.
|
|
64
|
+
* @property {(blockId?: string, logicalId?: string) => UISessionInstance} clear Clear all / a block / a descendant; returns the session.
|
|
65
|
+
* @property {(blockId: string, logicalId: string, targetBlockId: string, targetLogicalId: string) => UISessionInstance} move Move a node under a new parent; returns the session.
|
|
66
|
+
* @property {(blockId: string, items: Array) => UISessionInstance} replace Clear a block then add items; returns the session.
|
|
67
|
+
* @property {(name: string, opts?: object) => UISessionInstance} portal Open/return an out-of-tree portal session.
|
|
68
|
+
* @property {(name: string) => UISessionInstance} closePortal Close a portal; returns the session.
|
|
69
|
+
* @property {(blockId: string, logicalIdOrValue: string, maybeValue?: string) => UISessionInstance} text Set `textContent` on a block root or descendant; returns the session.
|
|
70
|
+
* @property {(blockId: string, logicalIdOrName: string, nameOrValue?: string, value?: *) => UISessionInstance} attr Set/remove an attribute; returns the session.
|
|
71
|
+
* @property {(blockId: string, logicalIdOrType: string, typeOrFn?: *, fnOrName?: *, nameOrOptions?: *, options?: *) => (string|null)} on Register a managed listener; returns the listener name or `null`.
|
|
72
|
+
* @property {(sig: object, blockId: string, logicalIdOrTarget?: string, targetOrOpts?: *, maybeOpts?: object) => (() => void)} bind Subscribe a signal to a DOM surface; returns an unsubscribe function.
|
|
73
|
+
* @property {(parentBlockId: string, slotName: string, options: object) => object} list Get or create the keyed `UIList` for a slot.
|
|
74
|
+
*/
|
|
75
|
+
|
|
76
|
+
export const uiSession = {
|
|
77
|
+
name: 'uiSession',
|
|
78
|
+
version: '1.0.0',
|
|
79
|
+
type: 'fw.dom.rendering',
|
|
80
|
+
dependencies: [
|
|
81
|
+
'uiSessionCore', 'uiSessionDirect', 'uiSessionList',
|
|
82
|
+
],
|
|
83
|
+
deps: [uiSessionCore, uiSessionDirect, uiSessionList],
|
|
84
|
+
|
|
85
|
+
/** @returns {(containerName: string) => UISessionInstance} */
|
|
86
|
+
factory(core, direct, list) {
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* Stateful session that manages a named render context and exposes a
|
|
90
|
+
* fluent, block-oriented API. All mutating methods return `this`
|
|
91
|
+
* for chaining.
|
|
92
|
+
*/
|
|
93
|
+
class UISession {
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* Create a session bound to an existing named template context.
|
|
97
|
+
* The `container` must already have been initialised via `template.init`.
|
|
98
|
+
*
|
|
99
|
+
* @param {string} container - Name of the template context to manage.
|
|
100
|
+
*/
|
|
101
|
+
constructor(container) {
|
|
102
|
+
this._container = container;
|
|
103
|
+
this._attach = new Map();
|
|
104
|
+
this._map = new Map();
|
|
105
|
+
// listeners: blockId → logicalId → Set<listenerName>
|
|
106
|
+
this._listeners = new Map();
|
|
107
|
+
this._lseq = 0;
|
|
108
|
+
// lists: parentBlockId → slotName → UIList (idempotent registry).
|
|
109
|
+
this._lists = new Map();
|
|
110
|
+
// unmount hooks: blockId → fn() (single hook per block).
|
|
111
|
+
this._unmount = new Map();
|
|
112
|
+
// mount hooks: blockId → fn() - fires once when block becomes
|
|
113
|
+
// mounted, then removed.
|
|
114
|
+
this._mount = new Map();
|
|
115
|
+
// parent tracking: parentBlockId → Set<childBlockId>.
|
|
116
|
+
this._children = new Map();
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
// Install method mixins on the prototype. The three helper modules
|
|
121
|
+
// each return `{ methods }` (plus optional `UIList`, `resolveTemplate`)
|
|
122
|
+
// and never collide on method names.
|
|
123
|
+
Object.assign(
|
|
124
|
+
UISession.prototype,
|
|
125
|
+
core.methods,
|
|
126
|
+
direct.methods,
|
|
127
|
+
list.methods,
|
|
128
|
+
);
|
|
129
|
+
|
|
130
|
+
/**
|
|
131
|
+
* Factory function - create a new {@link UISession} bound to the named
|
|
132
|
+
* template context `container`.
|
|
133
|
+
*
|
|
134
|
+
* @param {string} container - Name of an existing template context
|
|
135
|
+
* (created via `template.init`).
|
|
136
|
+
* @returns {UISessionInstance} A new session instance ready for use.
|
|
137
|
+
*/
|
|
138
|
+
return /** @type {(containerName: string) => UISessionInstance} */ (function(container) {
|
|
139
|
+
// `UISession.prototype` is composed via Object.assign of the three
|
|
140
|
+
// mixins above, so tsc sees the bare class (no methods). Cast the
|
|
141
|
+
// instance to the full `UISessionInstance` typedef (real runtime shape).
|
|
142
|
+
return /** @type {UISessionInstance} */ (/** @type {any} */ (new UISession(container)));
|
|
143
|
+
});
|
|
144
|
+
},
|
|
145
|
+
};
|
|
@@ -0,0 +1,341 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @description
|
|
7
|
+
* Virtualised list for rendering collections of 10^4 to 10^6 items without
|
|
8
|
+
* prohibitive memory / CPU cost. Only visible items plus a configurable
|
|
9
|
+
* overscan are materialised in the DOM.
|
|
10
|
+
*
|
|
11
|
+
* Two modes :
|
|
12
|
+
* - `fixed` (MVP, default) : fixed `itemHeight` in px - O(1) range computation,
|
|
13
|
+
* no DOM measurement.
|
|
14
|
+
* - `variable` : heights measured on the fly and cached in a `Map<idx, height>`.
|
|
15
|
+
* Heights are only re-measured when a previously-unseen index is rendered ;
|
|
16
|
+
* `setTotal` invalidates the cache beyond the given index.
|
|
17
|
+
*
|
|
18
|
+
* DOM structure :
|
|
19
|
+
* ```
|
|
20
|
+
* container (overflow: auto)
|
|
21
|
+
* ├─ spacer (height = total * itemHeight in fixed mode)
|
|
22
|
+
* └─ layer (position: absolute; top: scrollTop-adjusted)
|
|
23
|
+
* └─ rendered items (overscan included)
|
|
24
|
+
* ```
|
|
25
|
+
*
|
|
26
|
+
* `renderItem(idx)` may return an `HTMLElement` or an elm-array compatible
|
|
27
|
+
* with `dom` / `template`.
|
|
28
|
+
*
|
|
29
|
+
* Out of scope for MVP : node recycling, sticky headers, horizontal axes.
|
|
30
|
+
*
|
|
31
|
+
* The scroll listener is bound directly on the container via `addEventListener`
|
|
32
|
+
* (single owner, lifecycle handled by `dispose()`) - no dependency on the
|
|
33
|
+
* `events` registry.
|
|
34
|
+
*
|
|
35
|
+
* @example
|
|
36
|
+
* const vs = runtime.resolve('virtualScroll');
|
|
37
|
+
* const list = vs.create({
|
|
38
|
+
* container: document.getElementById('list'),
|
|
39
|
+
* itemHeight: 32,
|
|
40
|
+
* total: 50000,
|
|
41
|
+
* renderItem(idx) {
|
|
42
|
+
* const li = document.createElement('li');
|
|
43
|
+
* li.textContent = `Item ${idx}`;
|
|
44
|
+
* return li;
|
|
45
|
+
* }
|
|
46
|
+
* });
|
|
47
|
+
* list.scrollTo(1000);
|
|
48
|
+
* list.dispose();
|
|
49
|
+
*/
|
|
50
|
+
import { dom } from '../query/dom.js';
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* A virtualised-list instance returned by `create()`.
|
|
54
|
+
* @typedef {object} VirtualScrollInstance
|
|
55
|
+
* @property {() => void} refresh - Re-render the visible range after a data/total change.
|
|
56
|
+
* @property {(n: number) => void} setTotal - Update the total item count and refresh.
|
|
57
|
+
* @property {(idx: number, scrollOpts?: {align?: 'start'|'center'|'end'|'auto'}) => void} scrollTo - Programmatically scroll to an index.
|
|
58
|
+
* @property {() => {start: number, end: number}} visibleRange - Return the currently visible index range.
|
|
59
|
+
* @property {(idx: number) => number} measure - Return the (measured or estimated) height of an item.
|
|
60
|
+
* @property {() => void} dispose - Detach listeners and clear the layer.
|
|
61
|
+
*/
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* Virtualised-list surface returned by `factory()`.
|
|
65
|
+
* @typedef {object} VirtualScrollAPI
|
|
66
|
+
* @property {(opts: {container: Element, itemHeight: number, total: number, renderItem: (idx: number) => (Element|Array), overscan?: number, mode?: 'fixed'|'variable'}) => VirtualScrollInstance} create - Create a virtualised-list instance.
|
|
67
|
+
*/
|
|
68
|
+
|
|
69
|
+
export const virtualScroll = {
|
|
70
|
+
name: 'virtualScroll',
|
|
71
|
+
version: '1.1.0',
|
|
72
|
+
type: 'fw.dom.rendering',
|
|
73
|
+
dependencies: ['dom'],
|
|
74
|
+
deps: [dom],
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* @param {Object} dom - Resolved `dom` module instance.
|
|
78
|
+
* @returns {VirtualScrollAPI}
|
|
79
|
+
*/
|
|
80
|
+
factory(dom) {
|
|
81
|
+
|
|
82
|
+
/**
|
|
83
|
+
* Create a virtualised-list instance.
|
|
84
|
+
*
|
|
85
|
+
* @param {Object} opts
|
|
86
|
+
* @param {Element} opts.container - Scrollable element (overflow: auto).
|
|
87
|
+
* @param {number} opts.itemHeight - Item height in px (fixed mode).
|
|
88
|
+
* @param {number} opts.total - Total item count.
|
|
89
|
+
* @param {Function} opts.renderItem - `(idx) → HTMLElement | ElmNode[]`
|
|
90
|
+
* @param {number} [opts.overscan=3] - Extra items rendered above/below the viewport.
|
|
91
|
+
* @param {'fixed'|'variable'} [opts.mode='fixed'] - Height computation mode.
|
|
92
|
+
* @returns {{ refresh, setTotal, scrollTo, visibleRange, measure, dispose }}
|
|
93
|
+
*/
|
|
94
|
+
function create(opts) {
|
|
95
|
+
const {
|
|
96
|
+
container,
|
|
97
|
+
renderItem
|
|
98
|
+
} = opts;
|
|
99
|
+
|
|
100
|
+
let itemHeight = opts.itemHeight;
|
|
101
|
+
let total = opts.total;
|
|
102
|
+
const overscan = (opts.overscan !== undefined) ? opts.overscan : 3;
|
|
103
|
+
const mode = opts.mode || 'fixed';
|
|
104
|
+
|
|
105
|
+
// Per-index height cache for variable mode.
|
|
106
|
+
const heightCache = new Map();
|
|
107
|
+
const DEFAULT_VARIABLE_HEIGHT = itemHeight || 40;
|
|
108
|
+
|
|
109
|
+
// ── DOM structure ───────────────────────────────────────────────
|
|
110
|
+
const spacer = document.createElement('div');
|
|
111
|
+
spacer.style.position = 'relative';
|
|
112
|
+
|
|
113
|
+
const layer = document.createElement('div');
|
|
114
|
+
layer.style.position = 'absolute';
|
|
115
|
+
layer.style.top = '0';
|
|
116
|
+
layer.style.left = '0';
|
|
117
|
+
layer.style.width = '100%';
|
|
118
|
+
|
|
119
|
+
// @ts-ignore - element.style exists on HTMLElement; typed as Element here
|
|
120
|
+
container.style.position = 'relative';
|
|
121
|
+
// @ts-ignore - element.style exists on HTMLElement; typed as Element here
|
|
122
|
+
container.style.overflow = 'auto';
|
|
123
|
+
container.appendChild(spacer);
|
|
124
|
+
container.appendChild(layer);
|
|
125
|
+
|
|
126
|
+
// ── Helpers ─────────────────────────────────────────────────────
|
|
127
|
+
|
|
128
|
+
function _totalHeight() {
|
|
129
|
+
if (mode === 'fixed') {
|
|
130
|
+
return total * itemHeight;
|
|
131
|
+
}
|
|
132
|
+
// Variable mode : estimated sum (partial cache + default).
|
|
133
|
+
let h = 0;
|
|
134
|
+
for (let i = 0; i < total; i++) {
|
|
135
|
+
h += heightCache.has(i) ? heightCache.get(i) : DEFAULT_VARIABLE_HEIGHT;
|
|
136
|
+
}
|
|
137
|
+
return h;
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
function _offsetForIndex(idx) {
|
|
141
|
+
if (mode === 'fixed') {
|
|
142
|
+
return idx * itemHeight;
|
|
143
|
+
}
|
|
144
|
+
let h = 0;
|
|
145
|
+
for (let i = 0; i < idx; i++) {
|
|
146
|
+
h += heightCache.has(i) ? heightCache.get(i) : DEFAULT_VARIABLE_HEIGHT;
|
|
147
|
+
}
|
|
148
|
+
return h;
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
function _indexAtOffset(offset) {
|
|
152
|
+
if (mode === 'fixed') {
|
|
153
|
+
return Math.floor(offset / itemHeight);
|
|
154
|
+
}
|
|
155
|
+
let h = 0;
|
|
156
|
+
for (let i = 0; i < total; i++) {
|
|
157
|
+
const ih = heightCache.has(i) ? heightCache.get(i) : DEFAULT_VARIABLE_HEIGHT;
|
|
158
|
+
h += ih;
|
|
159
|
+
if (h > offset) return i;
|
|
160
|
+
}
|
|
161
|
+
return total - 1;
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
function _containerHeight() {
|
|
165
|
+
const rect = container.getBoundingClientRect();
|
|
166
|
+
return rect.height || container.clientHeight || 0;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
function _computeRange() {
|
|
170
|
+
const scrollTop = container.scrollTop || 0;
|
|
171
|
+
const viewportH = _containerHeight();
|
|
172
|
+
const start = Math.max(0, _indexAtOffset(scrollTop) - overscan);
|
|
173
|
+
const endIdx = _indexAtOffset(scrollTop + viewportH);
|
|
174
|
+
const end = Math.min(total - 1, endIdx + overscan);
|
|
175
|
+
return { start, end };
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
function _renderItem(idx) {
|
|
179
|
+
const result = renderItem(idx);
|
|
180
|
+
if (result instanceof Element) {
|
|
181
|
+
return result;
|
|
182
|
+
}
|
|
183
|
+
// elm-array: use dom.create when available, otherwise minimal fallback
|
|
184
|
+
if (Array.isArray(result)) {
|
|
185
|
+
if (dom && typeof dom.create === 'function') {
|
|
186
|
+
return dom.create(result);
|
|
187
|
+
}
|
|
188
|
+
// Fallback : first array element if it is already an Element.
|
|
189
|
+
if (result.length > 0 && result[0] instanceof Element) {
|
|
190
|
+
return result[0];
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
// Generic fallback.
|
|
194
|
+
const span = document.createElement('span');
|
|
195
|
+
span.textContent = String(idx);
|
|
196
|
+
return span;
|
|
197
|
+
}
|
|
198
|
+
|
|
199
|
+
// ── Render ──────────────────────────────────────────────────────
|
|
200
|
+
|
|
201
|
+
let _lastStart = -1;
|
|
202
|
+
let _lastEnd = -1;
|
|
203
|
+
|
|
204
|
+
function _doRender() {
|
|
205
|
+
const { start, end } = _computeRange();
|
|
206
|
+
if (start === _lastStart && end === _lastEnd) return;
|
|
207
|
+
_lastStart = start;
|
|
208
|
+
_lastEnd = end;
|
|
209
|
+
|
|
210
|
+
// Update the spacer height
|
|
211
|
+
spacer.style.height = _totalHeight() + 'px';
|
|
212
|
+
|
|
213
|
+
// Position the layer at the offset of the first visible item
|
|
214
|
+
const layerTop = _offsetForIndex(start);
|
|
215
|
+
layer.style.top = layerTop + 'px';
|
|
216
|
+
|
|
217
|
+
// Clear + re-render
|
|
218
|
+
layer.textContent = '';
|
|
219
|
+
for (let i = start; i <= end; i++) {
|
|
220
|
+
const el = _renderItem(i);
|
|
221
|
+
layer.appendChild(el);
|
|
222
|
+
// Variable mode : only measure when the height is not
|
|
223
|
+
// already cached. Re-measurement on every render is the
|
|
224
|
+
// primary perf cost of variable mode ; caching by index
|
|
225
|
+
// keeps the steady-state scroll free of reflows.
|
|
226
|
+
if (mode === 'variable' && !heightCache.has(i)) {
|
|
227
|
+
const measured = el.getBoundingClientRect().height;
|
|
228
|
+
if (measured > 0) heightCache.set(i, measured);
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
// ── Scroll listener (passive) ─────────────────────────────────
|
|
234
|
+
// Self-contained widget - direct addEventListener is sufficient ;
|
|
235
|
+
// the matching removal happens in `dispose()`. No `events`
|
|
236
|
+
// registry involvement.
|
|
237
|
+
|
|
238
|
+
function _onScroll() {
|
|
239
|
+
_doRender();
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
container.addEventListener('scroll', _onScroll, { passive: true });
|
|
243
|
+
|
|
244
|
+
// Initial render
|
|
245
|
+
_doRender();
|
|
246
|
+
|
|
247
|
+
// ── Public API ───────────────────────────────────────────────────
|
|
248
|
+
|
|
249
|
+
/**
|
|
250
|
+
* Re-render the visible range (after a change in `total` or data).
|
|
251
|
+
*/
|
|
252
|
+
function refresh() {
|
|
253
|
+
_lastStart = -1;
|
|
254
|
+
_lastEnd = -1;
|
|
255
|
+
_doRender();
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
/**
|
|
259
|
+
* Update the total item count and refresh.
|
|
260
|
+
* @param {number} n - New total.
|
|
261
|
+
*/
|
|
262
|
+
function setTotal(n) {
|
|
263
|
+
total = n;
|
|
264
|
+
// Variable mode : invalidate cache entries beyond the new total.
|
|
265
|
+
if (mode === 'variable') {
|
|
266
|
+
for (const k of heightCache.keys()) {
|
|
267
|
+
if (k >= n) heightCache.delete(k);
|
|
268
|
+
}
|
|
269
|
+
}
|
|
270
|
+
refresh();
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
/**
|
|
274
|
+
* Programmatic scroll to an index.
|
|
275
|
+
* @param {number} idx
|
|
276
|
+
* @param {{ align?: 'start'|'center'|'end'|'auto' }} [scrollOpts]
|
|
277
|
+
*/
|
|
278
|
+
function scrollTo(idx, scrollOpts) {
|
|
279
|
+
const align = (scrollOpts && scrollOpts.align) || 'start';
|
|
280
|
+
const offset = _offsetForIndex(idx);
|
|
281
|
+
const viewportH = _containerHeight();
|
|
282
|
+
let targetScroll;
|
|
283
|
+
|
|
284
|
+
if (align === 'start' || align === 'auto') {
|
|
285
|
+
targetScroll = offset;
|
|
286
|
+
} else if (align === 'end') {
|
|
287
|
+
const ih = mode === 'fixed' ? itemHeight
|
|
288
|
+
: (heightCache.get(idx) || DEFAULT_VARIABLE_HEIGHT);
|
|
289
|
+
targetScroll = offset + ih - viewportH;
|
|
290
|
+
} else if (align === 'center') {
|
|
291
|
+
const ih = mode === 'fixed' ? itemHeight
|
|
292
|
+
: (heightCache.get(idx) || DEFAULT_VARIABLE_HEIGHT);
|
|
293
|
+
targetScroll = offset - (viewportH / 2) + (ih / 2);
|
|
294
|
+
} else {
|
|
295
|
+
targetScroll = offset;
|
|
296
|
+
}
|
|
297
|
+
|
|
298
|
+
container.scrollTop = Math.max(0, targetScroll);
|
|
299
|
+
_doRender();
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
/**
|
|
303
|
+
* Return the currently visible index range.
|
|
304
|
+
* @returns {{ start: number, end: number }}
|
|
305
|
+
*/
|
|
306
|
+
function visibleRange() {
|
|
307
|
+
return _computeRange();
|
|
308
|
+
}
|
|
309
|
+
|
|
310
|
+
/**
|
|
311
|
+
* Return the measured height of an item (variable mode).
|
|
312
|
+
* In fixed mode returns `itemHeight`. In variable mode returns
|
|
313
|
+
* the cached measurement when present, otherwise the default
|
|
314
|
+
* estimate (caller cannot tell the two apart - wrap with `has`
|
|
315
|
+
* when needed).
|
|
316
|
+
* @param {number} idx
|
|
317
|
+
* @returns {number}
|
|
318
|
+
*/
|
|
319
|
+
function measure(idx) {
|
|
320
|
+
if (mode === 'fixed') return itemHeight;
|
|
321
|
+
return heightCache.has(idx) ? heightCache.get(idx) : DEFAULT_VARIABLE_HEIGHT;
|
|
322
|
+
}
|
|
323
|
+
|
|
324
|
+
/**
|
|
325
|
+
* Detach listeners and clear the layer.
|
|
326
|
+
*/
|
|
327
|
+
function dispose() {
|
|
328
|
+
// @ts-ignore - passive option is standard; TS keyof ElementEventMap too narrow
|
|
329
|
+
container.removeEventListener('scroll', _onScroll, { passive: true });
|
|
330
|
+
layer.textContent = '';
|
|
331
|
+
if (spacer.parentNode === container) container.removeChild(spacer);
|
|
332
|
+
if (layer.parentNode === container) container.removeChild(layer);
|
|
333
|
+
heightCache.clear();
|
|
334
|
+
}
|
|
335
|
+
|
|
336
|
+
return { refresh, setTotal, scrollTo, visibleRange, measure, dispose };
|
|
337
|
+
}
|
|
338
|
+
|
|
339
|
+
return { create };
|
|
340
|
+
}
|
|
341
|
+
};
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @fileoverview Battery sensor factory.
|
|
7
|
+
*
|
|
8
|
+
* Wraps `navigator.getBattery()` with a normalized snapshot and a
|
|
9
|
+
* change-watcher that aggregates the four standard `BatteryManager`
|
|
10
|
+
* events (`levelchange`, `chargingchange`, `chargingtimechange`,
|
|
11
|
+
* `dischargingtimechange`).
|
|
12
|
+
*
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* Normalized battery snapshot.
|
|
17
|
+
*
|
|
18
|
+
* Note: unlike geolocation/networkInfo readings, this payload does
|
|
19
|
+
* not include a `timestamp` field - `BatteryManager` is a stateful
|
|
20
|
+
* object and changes fire as events rather than as discrete samples.
|
|
21
|
+
*
|
|
22
|
+
* @typedef {Object} BatteryStatus
|
|
23
|
+
* @property {number} level - Charge level in `[0, 1]`.
|
|
24
|
+
* @property {boolean} charging - `true` while charging.
|
|
25
|
+
* @property {number} chargingTime - Seconds until fully charged, or `Infinity`.
|
|
26
|
+
* @property {number} dischargingTime - Seconds until empty, or `Infinity`.
|
|
27
|
+
*/
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* Watch callback. On success invoked with `(status)`. If `getBattery()`
|
|
31
|
+
* rejects after the watch has started, invoked with `(null, err)` for
|
|
32
|
+
* parity with the geolocation watch contract.
|
|
33
|
+
*
|
|
34
|
+
* @callback BatteryWatchCallback
|
|
35
|
+
* @param {BatteryStatus|null} status
|
|
36
|
+
* @param {Error} [err]
|
|
37
|
+
* @returns {void}
|
|
38
|
+
*/
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* @typedef {Object} BatteryManager
|
|
43
|
+
* @property {boolean} charging
|
|
44
|
+
* @property {number} chargingTime
|
|
45
|
+
* @property {number} dischargingTime
|
|
46
|
+
* @property {number} level
|
|
47
|
+
* @property {function(string, function): void} addEventListener
|
|
48
|
+
* @property {function(string, function): void} removeEventListener
|
|
49
|
+
*/
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
* Object returned by `battery.factory()`.
|
|
53
|
+
*
|
|
54
|
+
* @typedef {Object} BatteryAPI
|
|
55
|
+
* @property {() => boolean} isSupported `true` if the Battery Status API is available.
|
|
56
|
+
* @property {() => Promise<BatteryStatus>} current Resolve the current battery snapshot.
|
|
57
|
+
* @property {(callback: BatteryWatchCallback) => (() => void)} watch Subscribe to battery changes; returns a dispose function.
|
|
58
|
+
*/
|
|
59
|
+
|
|
60
|
+
export const battery = {
|
|
61
|
+
name: 'battery',
|
|
62
|
+
version: '1.0.0',
|
|
63
|
+
type: 'fw.dom.sensors',
|
|
64
|
+
dependencies: [],
|
|
65
|
+
worker: false,
|
|
66
|
+
|
|
67
|
+
/** @returns {BatteryAPI} */
|
|
68
|
+
factory() {
|
|
69
|
+
/**
|
|
70
|
+
* Reports whether the Battery Status API is available on `navigator`.
|
|
71
|
+
*
|
|
72
|
+
* @returns {boolean}
|
|
73
|
+
*/
|
|
74
|
+
function isSupported() {
|
|
75
|
+
return 'getBattery' in navigator;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* Normalize a native `BatteryManager` into a {@link BatteryStatus}.
|
|
80
|
+
*
|
|
81
|
+
* @private
|
|
82
|
+
// @ts-ignore - vendor/experimental API not yet in TS lib types
|
|
83
|
+
* @param {BatteryManager} mgr
|
|
84
|
+
* @returns {BatteryStatus}
|
|
85
|
+
*/
|
|
86
|
+
function _normalize(mgr) {
|
|
87
|
+
return {
|
|
88
|
+
level: mgr.level,
|
|
89
|
+
charging: mgr.charging,
|
|
90
|
+
chargingTime: mgr.chargingTime,
|
|
91
|
+
dischargingTime: mgr.dischargingTime,
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* Resolve the current battery snapshot.
|
|
97
|
+
*
|
|
98
|
+
* @returns {Promise<BatteryStatus>}
|
|
99
|
+
* @throws {Error} `'battery: unsupported'` if the API is absent.
|
|
100
|
+
*/
|
|
101
|
+
async function current() {
|
|
102
|
+
if (!isSupported()) throw new Error('battery: unsupported');
|
|
103
|
+
// @ts-ignore - vendor/experimental API not yet in TS lib types
|
|
104
|
+
const mgr = await navigator.getBattery();
|
|
105
|
+
return _normalize(mgr);
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/**
|
|
109
|
+
* Subscribe to battery status changes.
|
|
110
|
+
*
|
|
111
|
+
* Fires the callback once initially with the current snapshot,
|
|
112
|
+
* then on every `levelchange`/`chargingchange`/`chargingtimechange`/
|
|
113
|
+
* `dischargingtimechange` event.
|
|
114
|
+
*
|
|
115
|
+
* If `navigator.getBattery()` rejects after the watch starts (rare
|
|
116
|
+
* but possible in restricted contexts), the callback is invoked
|
|
117
|
+
* with `(null, err)` to mirror the geolocation watch contract.
|
|
118
|
+
*
|
|
119
|
+
* @param {BatteryWatchCallback} callback
|
|
120
|
+
* @returns {() => void} Dispose function - removes all listeners.
|
|
121
|
+
* @throws {Error} `'battery: unsupported'` if the API is absent.
|
|
122
|
+
*/
|
|
123
|
+
function watch(callback) {
|
|
124
|
+
if (!isSupported()) throw new Error('battery: unsupported');
|
|
125
|
+
|
|
126
|
+
let mgr = null;
|
|
127
|
+
let stopped = false;
|
|
128
|
+
|
|
129
|
+
const EVENTS = ['levelchange', 'chargingchange', 'chargingtimechange', 'dischargingtimechange'];
|
|
130
|
+
|
|
131
|
+
function handler() {
|
|
132
|
+
if (!stopped) callback(_normalize(mgr));
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
// @ts-ignore - vendor/experimental API not yet in TS lib types
|
|
136
|
+
navigator.getBattery().then(m => {
|
|
137
|
+
if (stopped) return;
|
|
138
|
+
mgr = m;
|
|
139
|
+
EVENTS.forEach(ev => mgr.addEventListener(ev, handler));
|
|
140
|
+
callback(_normalize(mgr));
|
|
141
|
+
}).catch(err => {
|
|
142
|
+
if (!stopped) callback(null, err);
|
|
143
|
+
});
|
|
144
|
+
|
|
145
|
+
return function stop() {
|
|
146
|
+
stopped = true;
|
|
147
|
+
if (mgr) EVENTS.forEach(ev => mgr.removeEventListener(ev, handler));
|
|
148
|
+
};
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
return { isSupported, current, watch };
|
|
152
|
+
},
|
|
153
|
+
};
|